# Qipu Knowledge Store Primer

Store: <STORE_PATH>

## About Qipu

Qipu is a Zettelkasten-inspired knowledge management system for capturing research notes and navigating knowledge via links, tags, and Maps of Content.

## Getting Started

Your knowledge store is empty. Start by capturing your first insights:

  qipu capture --title "..."     Quick capture from stdin
  qipu create <title>             Create a new note
  qipu create <title> --type moc   Create a Map of Content

## Quick Reference

  qipu list              List notes
  qipu search <query>    Search notes by title and body
  qipu show <id>         Display a note
  qipu create <title>    Create a new note
  qipu capture           Create note from stdin
  qipu link tree <id>    Show traversal tree from a note
  qipu link path A B     Find path between notes
  qipu context           Build context bundle for LLM

## Session Protocol

**Before ending session:**
1. Capture any new insights: `qipu capture --title "..."`
2. Link new notes to existing knowledge: `qipu link add <new> <existing> --type <type>`
3. Commit changes: `git add .qipu && git commit -m "knowledge: ..."`

**Why this matters:** Knowledge not committed is knowledge lost. The graph only grows if you save your work.

## Ontology

Mode: default

### Note Types
  fleeting
  literature
  moc
  permanent

### Link Types
  alias-of -> has-alias
  answered-by -> answers
  answers -> answered-by
  contradicted-by -> contradicts
  contradicts -> contradicted-by
  derived-from -> derived-to
  derived-to -> derived-from
  follows -> precedes
  has-alias -> alias-of
  has-part -> part-of
  part-of -> has-part
  precedes -> follows
  refined-by -> refines
  refines -> refined-by
  related -> related
  same-as -> same-as
  supported-by -> supports
  supports -> supported-by

Use `qipu context --note <id>` to fetch full note content.
