kirograph 0.14.1 → 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": []
 }

package/dist/bin/commands/uninit.js

@@ -34,8 +34,10 @@ __export(uninit_exports, {
 module.exports = __toCommonJS(uninit_exports);
 var path = __toESM(require("path"));
 var fs = __toESM(require("fs"));
+var readline = __toESM(require("readline"));
 var import_banner = require("../banner");
 var import_ui = require("../ui");
+var import_prompts = require("../installer/prompts");
 const UNINIT_FAREWELLS = [
   "Oh. So it's come to this.",
   "We're sorry to see you go. (Are we? Yes. We are.)",
@@ -49,14 +51,6 @@ const UNINIT_FAREWELLS = [
   "See you on the other side of `kirograph install`."
 ];
 const UNINIT_TARGETS = ["kiro", "claude", "codex", "all"];
-async function confirm(question) {
-  const readline = await import("readline");
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => rl.question(question, (ans) => {
-    rl.close();
-    resolve(ans.toLowerCase() === "y");
-  }));
-}
 async function runUninit(projectPath, opts) {
   const target = path.resolve(projectPath ?? process.cwd());
   const integration = (opts.target ?? "kiro").toLowerCase();
@@ -77,10 +71,11 @@ async function runUninit(projectPath, opts) {
     console.log(`  ${import_ui.violet}${import_ui.bold}${farewell}${import_ui.reset}`);
     console.log(`
   ${import_ui.dim}This can remove ${integration} integration files and, separately, the shared .kirograph/ data.${import_ui.reset}`);
-    console.log(`  ${import_ui.dim}Your source code is untouched.${import_ui.reset}
-`);
-    removeIntegration = await confirm(`  ${import_ui.violet}Remove ${integration} integration files?${import_ui.reset} ${import_ui.dim}(y/N)${import_ui.reset} `);
-    removeGraph = await confirm(`  ${import_ui.violet}Remove shared .kirograph/ data too?${import_ui.reset} ${import_ui.dim}(y/N)${import_ui.reset} `);
+    console.log(`  ${import_ui.dim}Your source code is untouched.${import_ui.reset}`);
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    removeIntegration = await (0, import_prompts.askToggle)(rl, `Remove ${integration} integration files?`, "Removes hooks, steering, MCP config, and agent instructions for this target.", false);
+    removeGraph = await (0, import_prompts.askToggle)(rl, "Remove shared .kirograph/ data too?", "Deletes the graph database, snapshots, and all indexed data. Cannot be undone.", false);
+    rl.close();
     if (!removeIntegration && !removeGraph) {
       console.log(`
   ${import_ui.dim}Cancelled. Nothing removed.${import_ui.reset}
@@ -100,6 +95,7 @@ async function runUninit(projectPath, opts) {
       "kirograph-sync-on-delete.kiro.hook",
       "kirograph-sync-if-dirty.kiro.hook",
       "kirograph-compress-hint.kiro.hook",
+      "kirograph-mem-capture.kiro.hook",
       // Legacy .json filenames
       "kirograph-mark-dirty-on-save.json",
       "kirograph-mark-dirty-on-create.json",
@@ -107,7 +103,8 @@ async function runUninit(projectPath, opts) {
       "kirograph-sync-if-dirty.json",
       "kirograph-sync-on-save.json",
       "kirograph-sync-on-create.json",
-      "kirograph-compress-hint.json"
+      "kirograph-compress-hint.json",
+      "kirograph-mem-capture.json"
     ];
     const hooksDir = path.join(target, ".kiro", "hooks");
     let removedHooks = 0;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/commands/uninit.ts"],
-  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { printBanner } from '../banner';\nimport { dim, reset, violet, bold, green } from '../ui';\n\nexport const UNINIT_FAREWELLS = [\n  \"Oh. So it's come to this.\",\n  \"We're sorry to see you go. (Are we? Yes. We are.)\",\n  \"Deleting months of carefully indexed knowledge. Bold move.\",\n  \"Fine. We'll just sit here in the dark.\",\n  \"You can always come back. We won't mention this.\",\n  \"The graph remembers everything. Except, soon, anything.\",\n  \"Somewhere a tree-sitter is crying.\",\n  \"Uninstalling... and pretending it doesn't hurt.\",\n  \"574 embeddings. Gone. Just like that.\",\n  \"See you on the other side of `kirograph install`.\",\n];\n\ntype UninitTarget = 'kiro' | 'claude' | 'codex' | 'all';\n\nconst UNINIT_TARGETS: UninitTarget[] = ['kiro', 'claude', 'codex', 'all'];\n\nasync function confirm(question: string): Promise<boolean> {\n  const readline = await import('readline');\n  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n  return new Promise<boolean>(resolve => rl.question(question, ans => {\n    rl.close();\n    resolve(ans.toLowerCase() === 'y');\n  }));\n}\n\nasync function runUninit(projectPath: string | undefined, opts: { force?: boolean; target?: string }): Promise<void> {\n  const target = path.resolve(projectPath ?? process.cwd());\n  const integration = (opts.target ?? 'kiro').toLowerCase() as UninitTarget;\n  if (!UNINIT_TARGETS.includes(integration)) {\n    console.error(`Unknown uninit target: ${opts.target}. Choose from: kiro, claude, codex, all`);\n    process.exit(1);\n  }\n  const dir = path.join(target, '.kirograph');\n  if (!fs.existsSync(dir)) { console.log('Not initialized.'); return; }\n\n  let removeIntegration = true;\n  let removeGraph = opts.force === true;\n\n  if (!opts.force) {\n    printBanner();\n    const farewell = UNINIT_FAREWELLS[Math.floor(Math.random() * UNINIT_FAREWELLS.length)]!;\n    console.log(`  ${violet}${bold}${farewell}${reset}`);\n    console.log(`\\n  ${dim}This can remove ${integration} integration files and, separately, the shared .kirograph/ data.${reset}`);\n    console.log(`  ${dim}Your source code is untouched.${reset}\\n`);\n\n    removeIntegration = await confirm(`  ${violet}Remove ${integration} integration files?${reset} ${dim}(y/N)${reset} `);\n    removeGraph = await confirm(`  ${violet}Remove shared .kirograph/ data too?${reset} ${dim}(y/N)${reset} `);\n\n    if (!removeIntegration && !removeGraph) {\n      console.log(`\\n  ${dim}Cancelled. Nothing removed.${reset}\\n`);\n      return;\n    }\n    console.log();\n  }\n\n  if (removeGraph) {\n    fs.rmSync(dir, { recursive: true, force: true });\n    console.log(`  ${green}\u2713${reset} Removed .kirograph/`);\n  }\n\n  if (removeIntegration && (integration === 'kiro' || integration === 'all')) {\n    // Remove .kiro hooks created by kirograph\n    const kiroHooks = [\n      'kirograph-mark-dirty-on-save.kiro.hook',\n      'kirograph-mark-dirty-on-create.kiro.hook',\n      'kirograph-sync-on-delete.kiro.hook',\n      'kirograph-sync-if-dirty.kiro.hook',\n      'kirograph-compress-hint.kiro.hook',\n      // Legacy .json filenames\n      'kirograph-mark-dirty-on-save.json',\n      'kirograph-mark-dirty-on-create.json',\n      'kirograph-sync-on-delete.json',\n      'kirograph-sync-if-dirty.json',\n      'kirograph-sync-on-save.json',\n      'kirograph-sync-on-create.json',\n      'kirograph-compress-hint.json',\n    ];\n    const hooksDir = path.join(target, '.kiro', 'hooks');\n    let removedHooks = 0;\n    for (const hook of kiroHooks) {\n      const p = path.join(hooksDir, hook);\n      if (fs.existsSync(p)) { fs.unlinkSync(p); removedHooks++; }\n    }\n    if (removedHooks > 0) console.log(`  ${green}\u2713${reset} Removed ${removedHooks} hook(s) from .kiro/hooks/`);\n\n    // Remove .kiro/steering/kirograph.md\n    const steeringPath = path.join(target, '.kiro', 'steering', 'kirograph.md');\n    if (fs.existsSync(steeringPath)) {\n      fs.unlinkSync(steeringPath);\n      console.log(`  ${green}\u2713${reset} Removed .kiro/steering/kirograph.md`);\n    }\n\n    // Remove .kiro/agents/kirograph.json\n    const agentPath = path.join(target, '.kiro', 'agents', 'kirograph.json');\n    if (fs.existsSync(agentPath)) {\n      fs.unlinkSync(agentPath);\n      console.log(`  ${green}\u2713${reset} Removed .kiro/agents/kirograph.json`);\n    }\n\n    // Remove kirograph server from .kiro/settings/mcp.json\n    const { removeMcpServersConfig } = await Promise.resolve().then(() => require('../installer/common.js'));\n    const mcpPath = path.join(target, '.kiro', 'settings', 'mcp.json');\n    if (removeMcpServersConfig(mcpPath)) {\n      console.log(`  ${green}\u2713${reset} Removed kirograph from .kiro/settings/mcp.json`);\n    }\n  }\n\n  if (removeIntegration && (integration === 'claude' || integration === 'all')) {\n    const { uninitClaude } = await Promise.resolve().then(() => require('../installer/targets/claude.js'));\n    uninitClaude(target);\n  }\n\n  if (removeIntegration && (integration === 'codex' || integration === 'all')) {\n    const { uninitCodex } = await Promise.resolve().then(() => require('../installer/targets/codex.js'));\n    uninitCodex(target);\n  }\n\n  console.log(`\\n  ${dim}Done. Run ${violet}kirograph install --target ${integration === 'all' ? 'kiro' : integration}${reset}${dim} to come back anytime.${reset}\\n`);\n}\n\nexport function register(program: Command): void {\n  program\n    .command('uninit [projectPath]')\n    .description('Remove KiroGraph from a project')\n    .option('--force', 'Skip confirmation')\n    .option('--target <target>', 'Integration target to clean up: kiro, claude, codex, or all', 'kiro')\n    .action(runUninit);\n\n  program\n    .command('uninstall [projectPath]')\n    .description('Alias for uninit. Remove KiroGraph from a project')\n    .option('--force', 'Skip confirmation')\n    .option('--target <target>', 'Integration target to clean up: kiro, claude, codex, or all', 'kiro')\n    .action(runUninit);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport * as readline from 'readline';\nimport { printBanner } from '../banner';\nimport { dim, reset, violet, bold, green } from '../ui';\nimport { askToggle } from '../installer/prompts';\n\nexport const UNINIT_FAREWELLS = [\n  \"Oh. So it's come to this.\",\n  \"We're sorry to see you go. (Are we? Yes. We are.)\",\n  \"Deleting months of carefully indexed knowledge. Bold move.\",\n  \"Fine. We'll just sit here in the dark.\",\n  \"You can always come back. We won't mention this.\",\n  \"The graph remembers everything. Except, soon, anything.\",\n  \"Somewhere a tree-sitter is crying.\",\n  \"Uninstalling... and pretending it doesn't hurt.\",\n  \"574 embeddings. Gone. Just like that.\",\n  \"See you on the other side of `kirograph install`.\",\n];\n\ntype UninitTarget = 'kiro' | 'claude' | 'codex' | 'all';\n\nconst UNINIT_TARGETS: UninitTarget[] = ['kiro', 'claude', 'codex', 'all'];\n\nasync function runUninit(projectPath: string | undefined, opts: { force?: boolean; target?: string }): Promise<void> {\n  const target = path.resolve(projectPath ?? process.cwd());\n  const integration = (opts.target ?? 'kiro').toLowerCase() as UninitTarget;\n  if (!UNINIT_TARGETS.includes(integration)) {\n    console.error(`Unknown uninit target: ${opts.target}. Choose from: kiro, claude, codex, all`);\n    process.exit(1);\n  }\n  const dir = path.join(target, '.kirograph');\n  if (!fs.existsSync(dir)) { console.log('Not initialized.'); return; }\n\n  let removeIntegration = true;\n  let removeGraph = opts.force === true;\n\n  if (!opts.force) {\n    printBanner();\n    const farewell = UNINIT_FAREWELLS[Math.floor(Math.random() * UNINIT_FAREWELLS.length)]!;\n    console.log(`  ${violet}${bold}${farewell}${reset}`);\n    console.log(`\\n  ${dim}This can remove ${integration} integration files and, separately, the shared .kirograph/ data.${reset}`);\n    console.log(`  ${dim}Your source code is untouched.${reset}`);\n\n    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n\n    removeIntegration = await askToggle(rl, `Remove ${integration} integration files?`, 'Removes hooks, steering, MCP config, and agent instructions for this target.', false);\n    removeGraph = await askToggle(rl, 'Remove shared .kirograph/ data too?', 'Deletes the graph database, snapshots, and all indexed data. Cannot be undone.', false);\n\n    rl.close();\n\n    if (!removeIntegration && !removeGraph) {\n      console.log(`\\n  ${dim}Cancelled. Nothing removed.${reset}\\n`);\n      return;\n    }\n    console.log();\n  }\n\n  if (removeGraph) {\n    fs.rmSync(dir, { recursive: true, force: true });\n    console.log(`  ${green}\u2713${reset} Removed .kirograph/`);\n  }\n\n  if (removeIntegration && (integration === 'kiro' || integration === 'all')) {\n    // Remove .kiro hooks created by kirograph\n    const kiroHooks = [\n      'kirograph-mark-dirty-on-save.kiro.hook',\n      'kirograph-mark-dirty-on-create.kiro.hook',\n      'kirograph-sync-on-delete.kiro.hook',\n      'kirograph-sync-if-dirty.kiro.hook',\n      'kirograph-compress-hint.kiro.hook',\n      'kirograph-mem-capture.kiro.hook',\n      // Legacy .json filenames\n      'kirograph-mark-dirty-on-save.json',\n      'kirograph-mark-dirty-on-create.json',\n      'kirograph-sync-on-delete.json',\n      'kirograph-sync-if-dirty.json',\n      'kirograph-sync-on-save.json',\n      'kirograph-sync-on-create.json',\n      'kirograph-compress-hint.json',\n      'kirograph-mem-capture.json',\n    ];\n    const hooksDir = path.join(target, '.kiro', 'hooks');\n    let removedHooks = 0;\n    for (const hook of kiroHooks) {\n      const p = path.join(hooksDir, hook);\n      if (fs.existsSync(p)) { fs.unlinkSync(p); removedHooks++; }\n    }\n    if (removedHooks > 0) console.log(`  ${green}\u2713${reset} Removed ${removedHooks} hook(s) from .kiro/hooks/`);\n\n    // Remove .kiro/steering/kirograph.md\n    const steeringPath = path.join(target, '.kiro', 'steering', 'kirograph.md');\n    if (fs.existsSync(steeringPath)) {\n      fs.unlinkSync(steeringPath);\n      console.log(`  ${green}\u2713${reset} Removed .kiro/steering/kirograph.md`);\n    }\n\n    // Remove .kiro/agents/kirograph.json\n    const agentPath = path.join(target, '.kiro', 'agents', 'kirograph.json');\n    if (fs.existsSync(agentPath)) {\n      fs.unlinkSync(agentPath);\n      console.log(`  ${green}\u2713${reset} Removed .kiro/agents/kirograph.json`);\n    }\n\n    // Remove kirograph server from .kiro/settings/mcp.json\n    const { removeMcpServersConfig } = await Promise.resolve().then(() => require('../installer/common.js'));\n    const mcpPath = path.join(target, '.kiro', 'settings', 'mcp.json');\n    if (removeMcpServersConfig(mcpPath)) {\n      console.log(`  ${green}\u2713${reset} Removed kirograph from .kiro/settings/mcp.json`);\n    }\n  }\n\n  if (removeIntegration && (integration === 'claude' || integration === 'all')) {\n    const { uninitClaude } = await Promise.resolve().then(() => require('../installer/targets/claude.js'));\n    uninitClaude(target);\n  }\n\n  if (removeIntegration && (integration === 'codex' || integration === 'all')) {\n    const { uninitCodex } = await Promise.resolve().then(() => require('../installer/targets/codex.js'));\n    uninitCodex(target);\n  }\n\n  console.log(`\\n  ${dim}Done. Run ${violet}kirograph install --target ${integration === 'all' ? 'kiro' : integration}${reset}${dim} to come back anytime.${reset}\\n`);\n}\n\nexport function register(program: Command): void {\n  program\n    .command('uninit [projectPath]')\n    .description('Remove KiroGraph from a project')\n    .option('--force', 'Skip confirmation')\n    .option('--target <target>', 'Integration target to clean up: kiro, claude, codex, or all', 'kiro')\n    .action(runUninit);\n\n  program\n    .command('uninstall [projectPath]')\n    .description('Alias for uninit. Remove KiroGraph from a project')\n    .option('--force', 'Skip confirmation')\n    .option('--target <target>', 'Integration target to clean up: kiro, claude, codex, or all', 'kiro')\n    .action(runUninit);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/bin/installer/config-prompt.js

@@ -57,16 +57,17 @@ const PRESET_MODELS = [
   }
 ];
 async function promptConfigOptions(rl) {
-  const enableEmbeddings = await (0, import_prompts.askBool)(
+  (0, import_prompts.printSection)("\u{1F50D}", "Semantic Search");
+  const enableEmbeddings = await (0, import_prompts.askToggle)(
     rl,
-    "Enable semantic embeddings for similarity search? (requires a local embedding model)",
-    "Enables semantic/similarity-based code search. Increases indexing time; the chosen embedding model is downloaded automatically on first use."
+    "Semantic embeddings (similarity search):",
+    "Enables natural-language code search via vector embeddings. A local model (~130MB) is downloaded on first use."
   );
-  const patch = { enableEmbeddings, useVecIndex: false, semanticEngine: "cosine", typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: "off", shellCompressionLevel: "normal" };
+  const patch = { enableEmbeddings, useVecIndex: false, semanticEngine: "cosine", typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: "off", shellCompressionLevel: "normal", enableMemory: false };
   if (enableEmbeddings) {
     const modelChoice = await (0, import_prompts.arrowSelect)(
       rl,
-      "Choose an embedding model:",
+      "Embedding model:",
       PRESET_MODELS.map((m) => ({ value: m.value, label: m.label, description: m.description }))
     );
     let embeddingModel;
@@ -100,7 +101,7 @@ async function promptConfigOptions(rl) {
     }
     patch.embeddingModel = embeddingModel;
     patch.embeddingDim = embeddingDim;
-    const semanticEngine = await (0, import_prompts.arrowSelect)(rl, "Choose the semantic search engine:", [
+    const semanticEngine = await (0, import_prompts.arrowSelect)(rl, "Vector search engine:", [
       { value: "cosine", label: "cosine", description: "In-process cosine similarity. No extra deps. Best for small/medium projects." },
       { value: "sqlite-vec", label: "sqlite-vec", description: "ANN index. Sub-linear search. Best for large codebases. Needs: better-sqlite3, sqlite-vec (native)." },
       { value: "orama", label: "orama", description: "Hybrid search (full-text + vector). Pure JS. Needs: @orama/orama, @orama/plugin-data-persistence." },
@@ -112,49 +113,62 @@ async function promptConfigOptions(rl) {
     patch.semanticEngine = semanticEngine;
     patch.useVecIndex = semanticEngine === "sqlite-vec";
     if (semanticEngine === "typesense") {
-      patch.typesenseDashboard = await (0, import_prompts.askBool)(
+      patch.typesenseDashboard = await (0, import_prompts.askToggle)(
         rl,
-        "Open Typesense dashboard after indexing?",
-        "Serves the Typesense Dashboard locally and opens it in your browser after indexing completes."
+        "Typesense dashboard:",
+        "Serves the Typesense Dashboard locally and opens it in your browser after indexing completes.",
+        false
       );
     }
     if (semanticEngine === "qdrant") {
-      patch.qdrantDashboard = await (0, import_prompts.askBool)(
+      patch.qdrantDashboard = await (0, import_prompts.askToggle)(
         rl,
-        "Open Qdrant dashboard after indexing?",
-        "Downloads the Qdrant Web UI (first time only) and opens it in your browser after indexing completes."
+        "Qdrant dashboard:",
+        "Downloads the Qdrant Web UI (first time only) and opens it in your browser after indexing completes.",
+        false
       );
     }
   }
-  patch.extractDocstrings = await (0, import_prompts.askBool)(
+  (0, import_prompts.printSection)("\u{1F4CA}", "Graph Features");
+  patch.extractDocstrings = await (0, import_prompts.askToggle)(
     rl,
-    "Extract docstrings from source files?",
+    "Docstring extraction:",
     "Enriches symbol metadata and improves context quality. Slightly increases indexing time."
   );
-  patch.trackCallSites = await (0, import_prompts.askBool)(
+  patch.trackCallSites = await (0, import_prompts.askToggle)(
     rl,
-    "Track call sites to enable caller/callee graph traversal?",
-    "Enables the kirograph_callers and kirograph_callees MCP tools for graph traversal. Increases index size."
+    "Call site tracking (caller/callee graph):",
+    "Enables kirograph_callers and kirograph_callees MCP tools. Increases index size."
   );
-  patch.enableArchitecture = await (0, import_prompts.askBool)(
+  patch.enableArchitecture = await (0, import_prompts.askToggle)(
     rl,
-    "Enable architecture analysis (package graph + layer detection)?",
-    "Detects packages from manifests (package.json, go.mod, Cargo.toml, etc.) and architectural layers (api, service, data, ui, shared) from file structure. Enables kirograph_architecture, kirograph_coupling, and kirograph_package MCP tools."
+    "Architecture analysis (packages + layers):",
+    "Detects packages from manifests and architectural layers. Enables kirograph_architecture, kirograph_coupling, kirograph_package.",
+    false
   );
-  const cavemanChoice = await (0, import_prompts.arrowSelect)(rl, "Caveman mode: agent communication style:", [
-    { value: "off", label: "off", description: "Normal responses" },
+  (0, import_prompts.printSection)("\u{1F916}", "Agent Behavior");
+  const cavemanChoice = await (0, import_prompts.arrowSelect)(rl, "Communication style (caveman mode):", [
+    { value: "off", label: "off", description: "Normal responses \u2014 no compression" },
     { value: "lite", label: "lite", description: "Compact, no filler, full sentences" },
     { value: "full", label: "full", description: "Fragments, no articles, short synonyms" },
     { value: "ultra", label: "ultra", description: "Max compression, abbreviations, \u2192 for causality" }
   ]);
   patch.cavemanMode = cavemanChoice;
-  const compressionChoice = await (0, import_prompts.arrowSelect)(rl, "Shell compression: default level for kirograph_exec:", [
+  const compressionChoice = await (0, import_prompts.arrowSelect)(rl, "Shell compression (kirograph_exec default level):", [
     { value: "off", label: "off", description: "No compression hook or steering (tool still available)" },
     { value: "normal", label: "normal", description: "Balanced: removes noise, keeps structure (recommended)" },
     { value: "aggressive", label: "aggressive", description: "More compact: groups by category, limits output" },
     { value: "ultra", label: "ultra", description: "Maximum compression: counts and summaries only" }
   ]);
   patch.shellCompressionLevel = compressionChoice;
+  (0, import_prompts.printSection)("\u{1F9E0}", "Memory");
+  patch.enableMemory = await (0, import_prompts.askToggle)(
+    rl,
+    "Persistent memory (cross-session observations):",
+    "Stores decisions, errors, and patterns across sessions. Compressed (if caveman is on), linked to code symbols, searchable via kirograph_mem_* tools. Zero LLM tokens on write.",
+    false
+    // Requires explicit enable
+  );
   return patch;
 }
 // Annotate the CommonJS export names for ESM import in node: