An experimental per-project “intent graph” that grows as you have agent conversations.

This repo stores the graph fully locally using Qdrant Local (on-disk) under .intent-graph/qdrant/ and provides a small CLI to:

• start a conversation traversal (a chain)
• append inferred (intent, state) nodes (with fuzzy deduping under the same parent+state)
• record methods (generalizable processes)
• fork chains when multiple next-intents are recorded in the same moment (unordered)
• export a Mermaid diagram for visualization

• Every recorded step is an intent with a state: positive, neutral, or negative.
  • Here, state means the valence of choosing to take that intent (good/neutral/bad choice).
• Any state can branch into multiple next intents (unordered).
• The leaf of a traversal is a method: a reusable process, not a one-off exact result.

Install dependencies:

python3 -m pip install -r requirements.txt

Initialize the local database (creates .intent-graph/qdrant/ if missing):

python3 scripts/intent_graph.py init

Start a new chain (root can have a state):

python3 scripts/intent_graph.py chain start --intent "debug failing tests" --state neutral

Or record the entire traversal in one command (recommended):

python3 scripts/intent_graph.py record \
  --root-intent "debug failing tests" --root-state neutral \
  --step positive:"reproduce locally" \
  --step neutral:"inspect logs|check recent merges|bisect" \
  --method "narrow the failure, isolate the cause, apply the minimal stable fix (e.g. pin/upgrade), then re-run to confirm" \
  --summary "Investigated failing tests; explored multiple options; resolved by pinning." \
  --viz-output .intent-graph/intent_graph.mmd

Add steps (single child continues the chain):

python3 scripts/intent_graph.py add --state positive --intent "reproduce locally"

Add multiple next-intents (this forks chains):

python3 scripts/intent_graph.py add --state neutral   --intent "inspect logs"   --intent "check recent merges"   --intent "bisect"

Resolve (records method on the chain’s current node and closes the chain):

python3 scripts/intent_graph.py resolve --method "reproduce, isolate variables, identify root cause, apply minimal fix, verify with reruns"

Add a short per-chain summary (recommended; not a transcript):

python3 scripts/intent_graph.py chain summarize --summary "One-paragraph summary of what happened"

Continue from an existing intent/path:

python3 scripts/intent_graph.py node find --query "auth"
python3 scripts/intent_graph.py chain start --from-node-id "<node_id_from_search>"

Export Mermaid visualization (Intent → State → Intent):

python3 scripts/intent_graph.py viz --output .intent-graph/intent_graph.mmd

• .intent-graph/qdrant/: local database files (ignored by git)
• .intent-graph/current_chain.txt: convenience pointer to active chain (ignored by git)
• scripts/intent_graph.py: CLI