kirograph 0.14.0 → 0.15.0

package/README.md

@@ -80,6 +80,29 @@ Enable via `kirograph install` or directly in `.kirograph/config.json`:
 
 See the [Architecture Analysis](#architecture-analysis-opt-in-1) section below for full details.
 
+### Memory (opt-in)
+
+When `enableMemory: true` is set, KiroGraph stores persistent observations across sessions — decisions, errors, patterns, and architecture notes. Observations are:
+
+- **Compressed** with the caveman grammar (if caveman mode is enabled) — deterministic, no LLM tokens spent
+- **Linked to code symbols** — identifiers in observation text are matched against the graph and stored as stable `qualified_name` references
+- **Embedded** with the configured semantic engine — enabling natural-language search over past observations
+- **Deduplicated** — SHA-256 content hash prevents storing the same observation twice
+
+Memory surfaces automatically in `kirograph_context` and `kirograph_impact` results when relevant observations are linked to the symbols being queried. The agent can also search memory directly via `kirograph_mem_search` or store new observations via `kirograph_mem_store`.
+
+Zero LLM tokens on write. ~150-350 tokens per search (vs ~2000-5000 tokens to re-discover context by reading files).
+
+Enable via `kirograph install` or directly in `.kirograph/config.json`:
+
+```json
+{
+  "enableMemory": true
+}
+```
+
+See the [Memory](#memory-requires-enablememory-true) section below for full details.
+
 ## Installation
 
 ### From npm (not yet available on npm registry)
@@ -179,7 +202,7 @@ kg install
 └───────────────────────────────────────────┘
 ```
 
-Kiro hooks mark the index dirty on every file save or create, then flush on agent idle, batching changes efficiently with no overhead during active editing.
+A single Kiro hook triggers on `agentStop` and asks the agent to sync the index if any source files were changed during the session. No per-file hooks, no background watcher — zero overhead during active editing.
 
 ## Using with Kiro
 
@@ -201,37 +224,36 @@ Registers the KiroGraph MCP server. Used by both the IDE and the CLI agent:
         "kirograph_status", "kirograph_files", "kirograph_dead_code",
         "kirograph_circular_deps", "kirograph_path", "kirograph_type_hierarchy",
         "kirograph_architecture", "kirograph_coupling", "kirograph_package",
-        "kirograph_hotspots", "kirograph_surprising", "kirograph_diff"
+        "kirograph_hotspots", "kirograph_surprising", "kirograph_diff",
+        "kirograph_exec", "kirograph_gain"
+        "kirograph_mem_search", "kirograph_mem_store",
+        "kirograph_mem_timeline", "kirograph_mem_status"
       ]
     }
   }
 }
 ```
 
-### IDE Auto-Sync Hooks (`.kiro/hooks/`)
-
-Four hooks keep the index fresh automatically in the Kiro IDE:
+### IDE Hooks (`.kiro/hooks/`)
 
-| Hook | Event | Action |
-|------|-------|--------|
-| `kirograph-mark-dirty-on-save.json` | `fileEdited` | `kirograph mark-dirty` |
-| `kirograph-mark-dirty-on-create.json` | `fileCreated` | `kirograph mark-dirty` |
-| `kirograph-sync-on-delete.json` | `fileDeleted` | `kirograph sync-if-dirty` |
-| `kirograph-sync-if-dirty.json` | `agentStop` | `kirograph sync-if-dirty --quiet` |
+Up to two hooks are installed (`.kiro.hook` extension):
 
-File changes are batched: saves and creates write a dirty marker; the actual sync runs when the agent stops. Deletes sync immediately. This means no overhead during active editing.
+| Hook file | Event | Type | Behavior |
+|-----------|-------|------|----------|
+| `kirograph-sync-if-dirty.kiro.hook` | `agentStop` | `runCommand` | Runs `kirograph sync --quiet` when the agent stops, syncing any file changes from the session. The sync command skips unchanged files via content hashing, so it's fast even when nothing changed. |
+| `kirograph-compress-hint.kiro.hook` | `preToolUse` (shell) | `askAgent` | Reminds the agent to use `kirograph_exec` for commands that benefit from token compression (git, gh, test, lint, build, docker, aws, grep). Only installed when shell compression is enabled. |
 
-Hooks fire for: `.ts`, `.tsx`, `.js`, `.jsx`, `.py`, `.go`, `.rs`, `.java`, `.cs`, `.rb`, `.php`, `.swift`, `.kt`, `.dart`, `.ex`, `.exs`
+The sync hook replaces the previous per-file approach (mark-dirty-on-save, mark-dirty-on-create, sync-on-delete). A single `agentStop` hook handles all file changes in one pass with zero overhead during active editing.
 
 ### CLI Agent Config (`.kiro/agents/kirograph.json`)
 
-A custom agent for Kiro CLI that wires up the MCP server, inlines the steering instructions as a prompt, and handles sync in the CLI's own hook format. The CLI has no file-watch events, so syncing is handled at session boundaries instead:
+A custom agent for Kiro CLI that wires up the MCP server, references the steering file as a resource, and handles sync in the CLI's own hook format. The CLI has no file-watch events, so syncing is handled at session boundaries:
 
-| Hook | Event | Action |
-|------|-------|--------|
-| `agentSpawn` | Agent starts | `kirograph sync-if-dirty --quiet` (catches edits made between sessions) |
-| `userPromptSubmit` | Each prompt | `kirograph sync-if-dirty --quiet` (keeps graph fresh within a session) |
-| `stop` | End of each turn | `kirograph sync-if-dirty --quiet` (deferred flush, mirrors IDE `agentStop`) |
+| Event | Action |
+|-------|--------|
+| `agentSpawn` | `kirograph sync-if-dirty --quiet` (catches edits made between sessions) |
+| `userPromptSubmit` | `kirograph sync-if-dirty --quiet` (keeps graph fresh within a session) |
+| `stop` | `kirograph sync-if-dirty --quiet` (deferred flush, mirrors IDE `agentStop`) |
 
 Use it with:
 
@@ -531,6 +553,50 @@ Show token savings statistics from compressed command outputs.
 
 Returns total commands, original/compressed token counts, savings percentage, breakdown by command family, and recent command history.
 
+### `kirograph_mem_search` *(requires `enableMemory: true`)*
+
+Search project memory for past decisions, errors, patterns, and context.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `query` | string | required | Natural language search query |
+| `kind` | string | - | Filter: `decision`, `error`, `pattern`, `architecture`, `summary`, `note` |
+| `limit` | number | 10 | Max results |
+| `sessionId` | string | - | Filter to specific session |
+| `projectPath` | string | cwd | Project root path |
+
+**How it works:** Hybrid search combining FTS5 keyword matching and vector cosine similarity (using the configured semantic engine). Results are ranked by a blended score (configurable via `memorySearchAlpha`). Falls back to FTS-only if embeddings are disabled or model mismatch is detected.
+
+### `kirograph_mem_store` *(requires `enableMemory: true`)*
+
+Store an observation in project memory. Content is automatically compressed (if caveman mode is on) and linked to relevant code symbols.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `content` | string | required | Observation text |
+| `kind` | string | `note` | `decision`, `error`, `pattern`, `architecture`, `summary`, `note` |
+| `projectPath` | string | cwd | Project root path |
+
+**How it works:** Strips `<private>` blocks → applies caveman compression (if enabled) → computes SHA-256 hash for deduplication → stores in `mem_observations` → detects symbol identifiers and creates `mem_links` → embeds with the configured model. Zero LLM tokens consumed.
+
+### `kirograph_mem_timeline` *(requires `enableMemory: true`)*
+
+List recent sessions and their observations chronologically.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `limit` | number | 5 | Number of sessions to show |
+| `sessionId` | string | - | Show observations for a specific session |
+| `projectPath` | string | cwd | Project root path |
+
+### `kirograph_mem_status` *(requires `enableMemory: true`)*
+
+Memory subsystem health: session count, observations, embedding coverage, model mismatch detection.
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `projectPath` | string | cwd | Project root path |
+
 ## CLI Reference
 
 ### Setup
@@ -809,6 +875,8 @@ The `kirograph_gain` MCP tool exposes the same stats to the agent.
 | `kirograph_dead_code` | Not feasible manually (read every file) | 5× output, min 15,000 |
 | `kirograph_hotspots` | Not feasible manually (count edges for every symbol) | 5× output, min 15,000 |
 | `kirograph_architecture` | Not feasible manually | 4× output, min 7,500 |
+| `kirograph_mem_search` | Re-read 3-5 files to recall past decisions + grep | ~5,800 tokens |
+| `kirograph_mem_timeline` | Ask user or re-read session history | ~2,300 tokens |
 
 Constants used: 1,500 tokens per average source file (~200 lines), 800 tokens per grep result set, 2,000 tokens per directory listing. These are conservative estimates; in practice agents often read more files, retry failed searches, and explore dead ends.
 
@@ -930,6 +998,46 @@ kirograph path --format json          # JSON output
 
 The command resolves symbol names using the same fuzzy search as `kirograph query`, preferring real symbol kinds (class, function, method…) over import/file nodes. The result shows each hop with file and line.
 
+### Memory *(requires `enableMemory: true`)*
+
+Persistent cross-session observations — search, store, and manage project memory from the CLI.
+
+```bash
+# Search (mirrors kirograph_mem_search)
+kirograph mem search "payment retry"              # hybrid FTS + vector search
+kirograph mem search "auth bug" --kind error      # filter by kind
+kirograph mem search "refactor" --limit 5         # limit results
+kirograph mem search "token" --format json        # JSON output
+
+# Store (mirrors kirograph_mem_store)
+kirograph mem store "decided to use idempotency keys for payments"
+kirograph mem store "auth bug: token refresh missing" --kind error
+kirograph mem store --kind decision < decision.txt   # pipe from stdin
+
+# Timeline (mirrors kirograph_mem_timeline)
+kirograph mem timeline                    # last 5 sessions
+kirograph mem timeline --limit 10         # more sessions
+kirograph mem timeline --session <id>     # specific session
+kirograph mem timeline --format json
+
+# Status (mirrors kirograph_mem_status)
+kirograph mem status                      # health dashboard
+
+# Maintenance
+kirograph mem prune --older-than 90d      # cleanup old observations
+kirograph mem export --format jsonl       # machine-readable export (importable)
+kirograph mem export --format md          # human-readable export
+kirograph mem import backup.jsonl         # restore from backup (deduplicates)
+kirograph mem reembed                     # re-embed after model change
+kirograph mem reembed --batch 50          # control batch size
+kirograph mem lint                        # find stale links, model mismatch
+kirograph mem lint --fix                  # auto-repair issues
+```
+
+**How observations are stored:** Text → strip `<private>` blocks → caveman compress (if enabled) → SHA-256 dedup check → store → detect symbol identifiers → link to graph → embed. Zero LLM tokens.
+
+**How observations surface:** `kirograph_context` and `kirograph_impact` automatically include relevant memory observations (max 3, above relevance threshold 0.3) when memory is enabled. No extra tool call needed.
+
 ### Graph Export
 
 Export the full graph as an interactive dashboard. three files served from a local directory, no server required, works offline.
@@ -1062,7 +1170,7 @@ By default, KiroGraph uses exact name lookup and full-text search. Enable semant
 }
 ```
 
-This generates vector embeddings for all functions, methods, classes, interfaces, type aliases, components, and modules using a local embedding model (downloaded automatically to `~/.kirograph/models/` on first use). Embeddings are kept in sync automatically via Kiro hooks. on every file save, create, or delete.
+This generates vector embeddings for all functions, methods, classes, interfaces, type aliases, components, and modules using a local embedding model (downloaded automatically to `~/.kirograph/models/` on first use). Embeddings are kept in sync automatically via the Kiro `agentStop` hook, which syncs the index (including embeddings) whenever files change during a session.
 
 Run `kirograph install` to be guided through model and engine selection interactively with arrow-key menus, or set the fields manually in `.kirograph/config.json`.
 

package/dist/bin/commands/help.js

@@ -92,6 +92,7 @@ function printColoredHelp() {
         { name: "compression", args: "[level]", desc: "Set shell compression level (off | normal | aggressive | ultra)" },
         { name: "exec", args: "<command...>", desc: "Run a shell command with token-optimized output", opts: ["-l, --level <l>  normal | aggressive | ultra", "-t, --timeout <s> Timeout in seconds (default 60)", "--raw         Show raw + compressed for comparison", "--json        Output as JSON"] },
         { name: "gain", desc: "Show token savings from compressed command outputs", opts: ["--graph       ASCII graph (last 30 days)", "--history     Recent command history", "--daily       Day-by-day breakdown", "--period <p>  session | today | week | all"] },
+        { name: "mem", args: "<command>", desc: "Persistent memory (search, store, timeline, status, prune, lint, reembed)" },
         { name: "serve", desc: "Start the MCP server", opts: ["--mcp        Run as MCP stdio server", "--path <p>   Project path"] },
         { name: "dashboard", desc: "Manage the Qdrant or Typesense dashboard server", opts: ["start [path]  Start server and open dashboard", "stop [path]   Stop the running server"] }
       ]
@@ -193,6 +194,8 @@ ${c.bold}${c.paleLavender}USAGE${c.reset}`);
         ["kirograph exec --level ultra npm test", "Run tests with ultra compression"],
         ["kirograph exec --raw cargo build", "Show raw vs compressed comparison"],
         ["kirograph gain --graph", "Show token savings graph"],
+        ['kirograph mem search "auth decision"', "Search memory for past decisions"],
+        ['kirograph mem store "use idempotency keys" --kind decision', "Store a decision"],
         ["kirograph serve --mcp", "Start the MCP server"]
       ]
     }

package/dist/bin/commands/help.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/commands/help.ts"],
-  "sourcesContent": ["import { Command } from 'commander';\nimport { printBanner } from '../banner';\n\ntype CommandEntry = { name: string; args?: string; desc: string; opts?: string[] };\ntype Group = { title: string; commands: CommandEntry[] };\n\nexport function printColoredHelp(): void {\n  const c = {\n    reset:        '\\x1b[0m',\n    bold:         '\\x1b[1m',\n    dim:          '\\x1b[2m',\n    violet:       '\\x1b[38;5;99m',\n    purple:       '\\x1b[38;5;135m',\n    lavender:     '\\x1b[38;5;141m',\n    paleLavender: '\\x1b[38;5;183m',\n    gray:         '\\x1b[90m',\n    brown:        '\\x1b[38;5;130m',\n  };\n\n  const groups: Group[] = [\n    {\n      title: '\uD83D\uDD27 Workspace Setup',\n      commands: [\n        { name: 'install',       desc: 'Wire up MCP/instructions for an agent workspace', opts: ['--target <t>  kiro | claude | codex'] },\n        { name: 'init',          args: '[path]', desc: 'Initialize KiroGraph in a project', opts: ['-i, --index  Index immediately after init'] },\n        { name: 'uninit',        args: '[path]', desc: 'Remove KiroGraph from a project',   opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n        { name: 'uninstall',     args: '[path]', desc: 'Alias for uninit',                  opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCE6 Indexing',\n      commands: [\n        { name: 'index',         args: '[path]', desc: 'Full re-index of a project',             opts: ['--force     Force re-index all files'] },\n        { name: 'sync',          args: '[path]', desc: 'Incremental sync of changed files',       opts: ['--files <f> Specific files to sync'] },\n        { name: 'sync-if-dirty', args: '[path]', desc: 'Sync only if a dirty marker is present', opts: ['-q, --quiet  Suppress output'] },\n        { name: 'mark-dirty',    args: '[path]', desc: 'Write a dirty marker for deferred sync' },\n        { name: 'unlock',        args: '[path]', desc: 'Force-release a stale lock file' },\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & Exploration',\n      commands: [\n        { name: 'status',   args: '[path]',    desc: 'Show index statistics and health' },\n        { name: 'query',    args: '<search>',  desc: 'Search for symbols by name',          opts: ['--kind <k>      Filter by kind', '--limit <n>     Max results (default 10)'] },\n        { name: 'context',  args: '<task>',    desc: 'Build relevant code context for a task', opts: ['--max-nodes <n>  Max symbols (default 20)', '--no-code        Exclude code snippets', '--format <fmt>   markdown | json'] },\n        { name: 'files',    args: '[path]',    desc: 'Show project file structure from the index', opts: ['--format <fmt>   tree | flat | grouped', '--filter <path>  Filter by directory prefix', '--pattern <glob> Filter by glob', '--max-depth <n>  Limit tree depth', '--json           Output as JSON'] },\n        { name: 'path',     args: '<from> <to>', desc: 'Find the shortest path between two symbols',         opts: ['--format <fmt>   table | json'] },\n        { name: 'export build', args: '[path]', desc: 'Generate the interactive graph dashboard (.kirograph/export/)', opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'export start', args: '[path]', desc: 'Generate and open the dashboard in the browser',               opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'affected', args: '[files...]', desc: 'Find test files affected by changed source files', opts: ['--stdin          Read file list from stdin', '-d, --depth <n>  Max traversal depth (default 5)', '-f, --filter <g> Custom test file glob', '-j, --json       Output as JSON', '-q, --quiet      File paths only'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph Insights',\n      commands: [\n        { name: 'hotspots',   args: '[path]', desc: 'Find most-connected symbols by edge degree',          opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'surprising', args: '[path]', desc: 'Find non-obvious cross-file connections',             opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'dead-code',  args: '[path]', desc: 'Find unexported symbols with no incoming references', opts: ['--limit <n>    Max results (default 50)', '--format <f>  table | json'] },\n        { name: 'snapshot',   desc:           'Save or list graph snapshots for structural diffing',       opts: ['save [label]  Save current graph state', 'list          List saved snapshots', 'diff [label]  Diff current graph vs a snapshot  --format summary|full|json'] },\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture Analysis',\n      commands: [\n        { name: 'architecture', args: '[path]', desc: 'Show package graph and layer map',          opts: ['--packages     Show packages only', '--layers       Show layers only', '--format <f>   json'] },\n        { name: 'coupling',     args: '[path]', desc: 'Show coupling metrics per package',         opts: ['--sort <s>     instability | ca | ce | name', '--package <n>  Detail view for one package', '--format <f>   json'] },\n        { name: 'package',      args: '<name>', desc: 'Inspect a package: deps, files, metrics',  opts: ['--no-files     Omit file list', '--format <f>   json'] },\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent & Configuration',\n      commands: [\n        { name: 'caveman', args: '[mode]', desc: 'Set agent communication style (off | lite | full | ultra)' },\n        { name: 'compression', args: '[level]', desc: 'Set shell compression level (off | normal | aggressive | ultra)' },\n        { name: 'exec', args: '<command...>', desc: 'Run a shell command with token-optimized output', opts: ['-l, --level <l>  normal | aggressive | ultra', '-t, --timeout <s> Timeout in seconds (default 60)', '--raw         Show raw + compressed for comparison', '--json        Output as JSON'] },\n        { name: 'gain', desc: 'Show token savings from compressed command outputs', opts: ['--graph       ASCII graph (last 30 days)', '--history     Recent command history', '--daily       Day-by-day breakdown', '--period <p>  session | today | week | all'] },\n        { name: 'serve',   desc: 'Start the MCP server', opts: ['--mcp        Run as MCP stdio server', '--path <p>   Project path'] },\n        { name: 'dashboard', desc: 'Manage the Qdrant or Typesense dashboard server', opts: ['start [path]  Start server and open dashboard', 'stop [path]   Stop the running server'] },\n      ],\n    },\n  ];\n\n  console.log(`\\n${c.bold}${c.paleLavender}USAGE${c.reset}`);\n  console.log(`  ${c.lavender}kirograph${c.reset} ${c.gray}<command>${c.reset} ${c.dim}[options]${c.reset}\\n`);\n\n  // Compute max name+args width across ALL groups for alignment\n  const allCmds = groups.flatMap(g => g.commands);\n  const nameWidth = Math.max(...allCmds.map(cmd => (cmd.name + (cmd.args ? ' ' + cmd.args : '')).length)) + 2;\n\n  for (const group of groups) {\n    console.log(`${c.bold}${c.paleLavender}${group.title.toUpperCase()}${c.reset}\\n`);\n    for (const cmd of group.commands) {\n      const signature = cmd.name + (cmd.args ? ' ' + cmd.args : '');\n      const isCaveman = cmd.name === 'caveman';\n      const nameColor = isCaveman ? c.brown : c.lavender;\n      const prefix = isCaveman ? '\uD83E\uDEA8 ' : '  ';\n      const namePart = `${nameColor}${cmd.name}${c.reset}${cmd.args ? ' ' + c.dim + cmd.args + c.reset : ''}`;\n      const pad = ' '.repeat(Math.max(0, nameWidth - signature.length));\n      console.log(`${prefix}${namePart}${pad}${c.gray}${cmd.desc}${c.reset}`);\n      if (isCaveman) {\n        // desc starts at: emoji prefix (3 display cols: \uD83E\uDEA8 + space) + nameWidth\n        const inspiredPad = ' '.repeat(3 + nameWidth);\n        console.log(`${inspiredPad}${c.dim}Inspired by Caveman , original idea by github.com/JuliusBrussee/caveman${c.reset}`);\n        console.log();\n      }\n      if (cmd.opts) {\n        for (const opt of cmd.opts) {\n          const [flag, ...rest] = opt.split(/  +/);\n          const optPad = ' '.repeat(nameWidth + 2);\n          console.log(`  ${optPad}${c.purple}${flag}${c.reset}${rest.length ? '  ' + c.dim + rest.join('  ') + c.reset : ''}`);\n        }\n        console.log();\n      }\n    }\n    if (!groups[groups.length - 1].commands.includes(group.commands[group.commands.length - 1])) {\n      // extra spacing between groups handled by opts blank line; add one if no opts\n      const lastHasOpts = group.commands[group.commands.length - 1].opts;\n      if (!lastHasOpts) console.log();\n    }\n  }\n\n  console.log(`${c.bold}${c.paleLavender}GLOBAL FLAGS${c.reset}\\n`);\n  console.log(`  ${c.purple}-h, --help${c.reset}     ${c.gray}Show this help${c.reset}`);\n  console.log(`  ${c.purple}-V, --version${c.reset}  ${c.gray}Show version number${c.reset}\\n`);\n\n  console.log(`${c.bold}${c.paleLavender}EXAMPLES${c.reset}\\n`);\n\n  const exampleGroups: Array<{ title: string; examples: [string, string][] }> = [\n    {\n      title: '\uD83D\uDD27 Setup & indexing',\n      examples: [\n        ['kirograph install',                              'Wire up Kiro MCP + hooks + steering for the current workspace'],\n        ['kirograph install --target claude',              'Wire up Claude Code MCP + project memory'],\n        ['kirograph install --target codex',               'Install Codex project instructions and print MCP config'],\n        ['kirograph init --index',                         'Init and immediately index the project'],\n        ['kirograph sync',                                 'Incremental sync of changed files'],\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & exploration',\n      examples: [\n        ['kirograph query useState',                       'Find all symbols named useState'],\n        ['kirograph context \"add dark mode\"',              'Get relevant code context for a task'],\n        ['kirograph files --format grouped',               'Show files grouped by directory'],\n        ['kirograph path LoginController DatabasePool',     'Find how two symbols are connected'],\n        ['kirograph affected src/auth.ts',                 'Find tests affected by a change'],\n        ['git diff --name-only | kirograph affected --stdin', 'Affected tests from a git diff'],\n        ['kirograph export start',                         'Open the interactive graph dashboard in the browser'],\n        ['kirograph export build -o /tmp/graph',           'Export the dashboard to a custom directory'],\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph insights',\n      examples: [\n        ['kirograph hotspots --limit 10',                  'Top 10 most-connected symbols'],\n        ['kirograph surprising',                           'Find unexpected cross-module connections'],\n        ['kirograph dead-code',                            'Find unreferenced unexported symbols'],\n        ['kirograph snapshot save pre-refactor',           'Save a named snapshot before a refactor'],\n        ['kirograph snapshot diff pre-refactor',           'Diff current graph vs the named snapshot'],\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture',\n      examples: [\n        ['kirograph architecture --packages',              'List all detected packages'],\n        ['kirograph coupling --sort instability',          'Show packages ranked by instability'],\n        ['kirograph package src/auth',                     'Inspect the auth package'],\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent',\n      examples: [\n        ['kirograph caveman full',                         'Enable full caveman mode for the agent'],\n        ['kirograph caveman off',                          'Disable caveman mode'],\n        ['kirograph compression aggressive',              'Set compression to aggressive level'],\n        ['kirograph compression off',                      'Disable compression hook (tool still available)'],\n        ['kirograph exec git status',                      'Run git status with compression'],\n        ['kirograph exec --level ultra npm test',          'Run tests with ultra compression'],\n        ['kirograph exec --raw cargo build',               'Show raw vs compressed comparison'],\n        ['kirograph gain --graph',                         'Show token savings graph'],\n        ['kirograph serve --mcp',                          'Start the MCP server'],\n      ],\n    },\n  ];\n\n  for (const eg of exampleGroups) {\n    console.log(`  ${c.dim}${eg.title}${c.reset}`);\n    for (const [ex, desc] of eg.examples) {\n      console.log(`  ${c.violet}$${c.reset} ${c.lavender}${ex}${c.reset}`);\n      console.log(`    ${c.dim}${desc}${c.reset}`);\n    }\n    console.log();\n  }\n}\n\nexport function register(program: Command): void {\n  program.configureHelp({ formatHelp: () => '' });\n  program.addHelpText('afterAll', '');\n  program.helpInformation = () => {\n    printBanner();\n    printColoredHelp();\n    return '';\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command } from 'commander';\nimport { printBanner } from '../banner';\n\ntype CommandEntry = { name: string; args?: string; desc: string; opts?: string[] };\ntype Group = { title: string; commands: CommandEntry[] };\n\nexport function printColoredHelp(): void {\n  const c = {\n    reset:        '\\x1b[0m',\n    bold:         '\\x1b[1m',\n    dim:          '\\x1b[2m',\n    violet:       '\\x1b[38;5;99m',\n    purple:       '\\x1b[38;5;135m',\n    lavender:     '\\x1b[38;5;141m',\n    paleLavender: '\\x1b[38;5;183m',\n    gray:         '\\x1b[90m',\n    brown:        '\\x1b[38;5;130m',\n  };\n\n  const groups: Group[] = [\n    {\n      title: '\uD83D\uDD27 Workspace Setup',\n      commands: [\n        { name: 'install',       desc: 'Wire up MCP/instructions for an agent workspace', opts: ['--target <t>  kiro | claude | codex'] },\n        { name: 'init',          args: '[path]', desc: 'Initialize KiroGraph in a project', opts: ['-i, --index  Index immediately after init'] },\n        { name: 'uninit',        args: '[path]', desc: 'Remove KiroGraph from a project',   opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n        { name: 'uninstall',     args: '[path]', desc: 'Alias for uninit',                  opts: ['--force      Skip confirmation', '--target <t>  kiro | claude | codex | all'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCE6 Indexing',\n      commands: [\n        { name: 'index',         args: '[path]', desc: 'Full re-index of a project',             opts: ['--force     Force re-index all files'] },\n        { name: 'sync',          args: '[path]', desc: 'Incremental sync of changed files',       opts: ['--files <f> Specific files to sync'] },\n        { name: 'sync-if-dirty', args: '[path]', desc: 'Sync only if a dirty marker is present', opts: ['-q, --quiet  Suppress output'] },\n        { name: 'mark-dirty',    args: '[path]', desc: 'Write a dirty marker for deferred sync' },\n        { name: 'unlock',        args: '[path]', desc: 'Force-release a stale lock file' },\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & Exploration',\n      commands: [\n        { name: 'status',   args: '[path]',    desc: 'Show index statistics and health' },\n        { name: 'query',    args: '<search>',  desc: 'Search for symbols by name',          opts: ['--kind <k>      Filter by kind', '--limit <n>     Max results (default 10)'] },\n        { name: 'context',  args: '<task>',    desc: 'Build relevant code context for a task', opts: ['--max-nodes <n>  Max symbols (default 20)', '--no-code        Exclude code snippets', '--format <fmt>   markdown | json'] },\n        { name: 'files',    args: '[path]',    desc: 'Show project file structure from the index', opts: ['--format <fmt>   tree | flat | grouped', '--filter <path>  Filter by directory prefix', '--pattern <glob> Filter by glob', '--max-depth <n>  Limit tree depth', '--json           Output as JSON'] },\n        { name: 'path',     args: '<from> <to>', desc: 'Find the shortest path between two symbols',         opts: ['--format <fmt>   table | json'] },\n        { name: 'export build', args: '[path]', desc: 'Generate the interactive graph dashboard (.kirograph/export/)', opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'export start', args: '[path]', desc: 'Generate and open the dashboard in the browser',               opts: ['-o, --output <dir>  Custom output directory', '--include-contains  Include structural contains edges'] },\n        { name: 'affected', args: '[files...]', desc: 'Find test files affected by changed source files', opts: ['--stdin          Read file list from stdin', '-d, --depth <n>  Max traversal depth (default 5)', '-f, --filter <g> Custom test file glob', '-j, --json       Output as JSON', '-q, --quiet      File paths only'] },\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph Insights',\n      commands: [\n        { name: 'hotspots',   args: '[path]', desc: 'Find most-connected symbols by edge degree',          opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'surprising', args: '[path]', desc: 'Find non-obvious cross-file connections',             opts: ['--limit <n>    Max results (default 20)', '--format <f>  table | json'] },\n        { name: 'dead-code',  args: '[path]', desc: 'Find unexported symbols with no incoming references', opts: ['--limit <n>    Max results (default 50)', '--format <f>  table | json'] },\n        { name: 'snapshot',   desc:           'Save or list graph snapshots for structural diffing',       opts: ['save [label]  Save current graph state', 'list          List saved snapshots', 'diff [label]  Diff current graph vs a snapshot  --format summary|full|json'] },\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture Analysis',\n      commands: [\n        { name: 'architecture', args: '[path]', desc: 'Show package graph and layer map',          opts: ['--packages     Show packages only', '--layers       Show layers only', '--format <f>   json'] },\n        { name: 'coupling',     args: '[path]', desc: 'Show coupling metrics per package',         opts: ['--sort <s>     instability | ca | ce | name', '--package <n>  Detail view for one package', '--format <f>   json'] },\n        { name: 'package',      args: '<name>', desc: 'Inspect a package: deps, files, metrics',  opts: ['--no-files     Omit file list', '--format <f>   json'] },\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent & Configuration',\n      commands: [\n        { name: 'caveman', args: '[mode]', desc: 'Set agent communication style (off | lite | full | ultra)' },\n        { name: 'compression', args: '[level]', desc: 'Set shell compression level (off | normal | aggressive | ultra)' },\n        { name: 'exec', args: '<command...>', desc: 'Run a shell command with token-optimized output', opts: ['-l, --level <l>  normal | aggressive | ultra', '-t, --timeout <s> Timeout in seconds (default 60)', '--raw         Show raw + compressed for comparison', '--json        Output as JSON'] },\n        { name: 'gain', desc: 'Show token savings from compressed command outputs', opts: ['--graph       ASCII graph (last 30 days)', '--history     Recent command history', '--daily       Day-by-day breakdown', '--period <p>  session | today | week | all'] },\n        { name: 'mem', args: '<command>', desc: 'Persistent memory (search, store, timeline, status, prune, lint, reembed)' },\n        { name: 'serve',   desc: 'Start the MCP server', opts: ['--mcp        Run as MCP stdio server', '--path <p>   Project path'] },\n        { name: 'dashboard', desc: 'Manage the Qdrant or Typesense dashboard server', opts: ['start [path]  Start server and open dashboard', 'stop [path]   Stop the running server'] },\n      ],\n    },\n  ];\n\n  console.log(`\\n${c.bold}${c.paleLavender}USAGE${c.reset}`);\n  console.log(`  ${c.lavender}kirograph${c.reset} ${c.gray}<command>${c.reset} ${c.dim}[options]${c.reset}\\n`);\n\n  // Compute max name+args width across ALL groups for alignment\n  const allCmds = groups.flatMap(g => g.commands);\n  const nameWidth = Math.max(...allCmds.map(cmd => (cmd.name + (cmd.args ? ' ' + cmd.args : '')).length)) + 2;\n\n  for (const group of groups) {\n    console.log(`${c.bold}${c.paleLavender}${group.title.toUpperCase()}${c.reset}\\n`);\n    for (const cmd of group.commands) {\n      const signature = cmd.name + (cmd.args ? ' ' + cmd.args : '');\n      const isCaveman = cmd.name === 'caveman';\n      const nameColor = isCaveman ? c.brown : c.lavender;\n      const prefix = isCaveman ? '\uD83E\uDEA8 ' : '  ';\n      const namePart = `${nameColor}${cmd.name}${c.reset}${cmd.args ? ' ' + c.dim + cmd.args + c.reset : ''}`;\n      const pad = ' '.repeat(Math.max(0, nameWidth - signature.length));\n      console.log(`${prefix}${namePart}${pad}${c.gray}${cmd.desc}${c.reset}`);\n      if (isCaveman) {\n        // desc starts at: emoji prefix (3 display cols: \uD83E\uDEA8 + space) + nameWidth\n        const inspiredPad = ' '.repeat(3 + nameWidth);\n        console.log(`${inspiredPad}${c.dim}Inspired by Caveman , original idea by github.com/JuliusBrussee/caveman${c.reset}`);\n        console.log();\n      }\n      if (cmd.opts) {\n        for (const opt of cmd.opts) {\n          const [flag, ...rest] = opt.split(/  +/);\n          const optPad = ' '.repeat(nameWidth + 2);\n          console.log(`  ${optPad}${c.purple}${flag}${c.reset}${rest.length ? '  ' + c.dim + rest.join('  ') + c.reset : ''}`);\n        }\n        console.log();\n      }\n    }\n    if (!groups[groups.length - 1].commands.includes(group.commands[group.commands.length - 1])) {\n      // extra spacing between groups handled by opts blank line; add one if no opts\n      const lastHasOpts = group.commands[group.commands.length - 1].opts;\n      if (!lastHasOpts) console.log();\n    }\n  }\n\n  console.log(`${c.bold}${c.paleLavender}GLOBAL FLAGS${c.reset}\\n`);\n  console.log(`  ${c.purple}-h, --help${c.reset}     ${c.gray}Show this help${c.reset}`);\n  console.log(`  ${c.purple}-V, --version${c.reset}  ${c.gray}Show version number${c.reset}\\n`);\n\n  console.log(`${c.bold}${c.paleLavender}EXAMPLES${c.reset}\\n`);\n\n  const exampleGroups: Array<{ title: string; examples: [string, string][] }> = [\n    {\n      title: '\uD83D\uDD27 Setup & indexing',\n      examples: [\n        ['kirograph install',                              'Wire up Kiro MCP + hooks + steering for the current workspace'],\n        ['kirograph install --target claude',              'Wire up Claude Code MCP + project memory'],\n        ['kirograph install --target codex',               'Install Codex project instructions and print MCP config'],\n        ['kirograph init --index',                         'Init and immediately index the project'],\n        ['kirograph sync',                                 'Incremental sync of changed files'],\n      ],\n    },\n    {\n      title: '\uD83D\uDD0D Search & exploration',\n      examples: [\n        ['kirograph query useState',                       'Find all symbols named useState'],\n        ['kirograph context \"add dark mode\"',              'Get relevant code context for a task'],\n        ['kirograph files --format grouped',               'Show files grouped by directory'],\n        ['kirograph path LoginController DatabasePool',     'Find how two symbols are connected'],\n        ['kirograph affected src/auth.ts',                 'Find tests affected by a change'],\n        ['git diff --name-only | kirograph affected --stdin', 'Affected tests from a git diff'],\n        ['kirograph export start',                         'Open the interactive graph dashboard in the browser'],\n        ['kirograph export build -o /tmp/graph',           'Export the dashboard to a custom directory'],\n      ],\n    },\n    {\n      title: '\uD83D\uDCCA Graph insights',\n      examples: [\n        ['kirograph hotspots --limit 10',                  'Top 10 most-connected symbols'],\n        ['kirograph surprising',                           'Find unexpected cross-module connections'],\n        ['kirograph dead-code',                            'Find unreferenced unexported symbols'],\n        ['kirograph snapshot save pre-refactor',           'Save a named snapshot before a refactor'],\n        ['kirograph snapshot diff pre-refactor',           'Diff current graph vs the named snapshot'],\n      ],\n    },\n    {\n      title: '\uD83C\uDFDB\uFE0F Architecture',\n      examples: [\n        ['kirograph architecture --packages',              'List all detected packages'],\n        ['kirograph coupling --sort instability',          'Show packages ranked by instability'],\n        ['kirograph package src/auth',                     'Inspect the auth package'],\n      ],\n    },\n    {\n      title: '\u2699\uFE0F Agent',\n      examples: [\n        ['kirograph caveman full',                         'Enable full caveman mode for the agent'],\n        ['kirograph caveman off',                          'Disable caveman mode'],\n        ['kirograph compression aggressive',              'Set compression to aggressive level'],\n        ['kirograph compression off',                      'Disable compression hook (tool still available)'],\n        ['kirograph exec git status',                      'Run git status with compression'],\n        ['kirograph exec --level ultra npm test',          'Run tests with ultra compression'],\n        ['kirograph exec --raw cargo build',               'Show raw vs compressed comparison'],\n        ['kirograph gain --graph',                         'Show token savings graph'],\n        ['kirograph mem search \"auth decision\"',            'Search memory for past decisions'],\n        ['kirograph mem store \"use idempotency keys\" --kind decision', 'Store a decision'],\n        ['kirograph serve --mcp',                          'Start the MCP server'],\n      ],\n    },\n  ];\n\n  for (const eg of exampleGroups) {\n    console.log(`  ${c.dim}${eg.title}${c.reset}`);\n    for (const [ex, desc] of eg.examples) {\n      console.log(`  ${c.violet}$${c.reset} ${c.lavender}${ex}${c.reset}`);\n      console.log(`    ${c.dim}${desc}${c.reset}`);\n    }\n    console.log();\n  }\n}\n\nexport function register(program: Command): void {\n  program.configureHelp({ formatHelp: () => '' });\n  program.addHelpText('afterAll', '');\n  program.helpInformation = () => {\n    printBanner();\n    printColoredHelp();\n    return '';\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }