kirograph 0.19.0 → 0.20.1

package/dist/bin/installer/hooks.js

@@ -35,6 +35,33 @@ var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
 var import_errors = require("../../errors");
 const HOOK_EXT = ".kiro.hook";
+function buildWatchmenHook(synthesisMode) {
+  if (synthesisMode === "local") {
+    return {
+      name: "KiroGraph Watchmen",
+      version: "1.0.0",
+      description: "After memory capture, run local model synthesis if enough observations have accumulated.",
+      when: { type: "agentStop" },
+      then: { type: "runCommand", command: "kirograph mem watchmen synthesize --quiet 2>&1 || true" }
+    };
+  }
+  return {
+    name: "KiroGraph Watchmen",
+    version: "1.0.0",
+    description: "After memory capture, check if enough observations have accumulated. If so, synthesize them into workspace brief files.",
+    when: { type: "agentStop" },
+    then: {
+      type: "askAgent",
+      prompt: `Check if KiroGraph Watchmen synthesis should run: call kirograph_mem_store with kind='note' and content='watchmen check'. If the response does not include watchmenReady: true, do nothing and stop.
+
+If watchmenReady: true:
+1. Call kirograph_mem_search for each kind (decision, error, pattern, architecture, note) with limit 20.
+2. Write or update the workspace brief: upsert the ## KiroGraph Watchmen section in each file listed in targetFiles. For .kiro/steering/kirograph-watchmen.md use inclusion: always frontmatter with sections for Decisions, Known Errors & Fixes, Recurring Patterns, and Architecture Notes. For all other files write a compact ## KiroGraph Watchmen block.
+3. Generate skill files: if skillTargetDir is present in the response, identify recurring procedures (any procedure appearing in 3+ observations). For each, write a .kiro/steering/watchmen-<slug>.md file with inclusion: manual frontmatter, a short title, a "When to use" line with trigger phrases, and numbered steps. Prefix all generated files with watchmen- so they are distinguishable from hand-written steering files. Remove any .kiro/steering/watchmen-*.md files from previous runs that no longer match current patterns. If skillTargetDir is absent, embed a ## Recurring Procedures section in each targetFile instead, listing each procedure with trigger context and steps.
+4. Store a kind='summary' observation briefly describing what was synthesized (e.g. "Synthesized 8 observations: updated kirograph-watchmen.md, wrote watchmen-auth-flow.md and watchmen-test-pattern.md").`
+    }
+  };
+}
 const HOOKS = [
   {
     filename: `kirograph-sync-if-dirty${HOOK_EXT}`,
@@ -162,6 +189,13 @@ function writeHooks(kiroDir, opts) {
     }
     writeJson(path.join(hooksDir, filename), hook);
   }
+  const watchmenHookPath = path.join(hooksDir, `kirograph-watchmen${HOOK_EXT}`);
+  if (opts?.enableWatchmen) {
+    const mode = opts.watchmenSynthesisMode ?? "local";
+    writeJson(watchmenHookPath, buildWatchmenHook(mode));
+  } else {
+    if (fs.existsSync(watchmenHookPath)) fs.unlinkSync(watchmenHookPath);
+  }
   console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/bin/installer/hooks.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/hooks.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro hook file management\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logWarn } from '../../errors';\n\n// \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst HOOK_EXT = '.kiro.hook';\n\nconst HOOKS: Array<{ filename: string; hook: object }> = [\n  {\n    filename: `kirograph-sync-if-dirty${HOOK_EXT}`,\n    hook: {\n      name: 'KiroGraph Sync on Agent Stop',\n      version: '1.0.0',\n      description: 'Sync the KiroGraph index when the agent stops, picking up any file edits, creates, or deletes from the session.',\n      when: { type: 'agentStop' },\n      then: { type: 'runCommand', command: 'kirograph sync --quiet 2>&1 > /dev/null' },\n    },\n  },\n  {\n    filename: `kirograph-compress-hint${HOOK_EXT}`,\n    hook: {\n      name: 'KiroGraph Compression Hint',\n      version: '1.0.0',\n      description: 'Remind the agent to use kirograph_exec for shell commands that benefit from token compression (git, gh, test, lint, build, docker, aws, grep).',\n      when: { type: 'preToolUse', toolTypes: ['shell'] },\n      then: {\n        type: 'askAgent',\n        prompt: 'If this shell command is a git operation, GitHub CLI, test runner, linter, build tool, file listing, grep/rg, docker/kubectl, AWS CLI, or package manager command, consider using the kirograph_exec MCP tool instead for 60-90% token savings. The tool compresses output automatically while preserving error details.',\n      },\n    },\n  },\n  {\n    filename: `kirograph-mem-capture${HOOK_EXT}`,\n    hook: {\n      name: 'KiroGraph Memory Capture',\n      version: '1.0.0',\n      description: 'Prompt the agent to store important observations in memory at the end of each session.',\n      when: { type: 'agentStop' },\n      then: {\n        type: 'askAgent',\n        prompt: 'Before ending, review what happened in this session. If there were any important decisions, bug root causes, architecture insights, error patterns, or lessons learned, store them using kirograph_mem_store with the appropriate kind (decision, error, pattern, architecture, note). Keep observations concise \u2014 one fact per observation. Skip if nothing noteworthy happened.',\n      },\n    },\n  },\n];\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nfunction writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nfunction migrateOnIdleHooks(hooksDir: string): void {\n  if (!fs.existsSync(hooksDir)) return;\n  let files: string[];\n  try {\n    files = fs.readdirSync(hooksDir).filter(f => f.endsWith('.json') || f.endsWith(HOOK_EXT));\n  } catch {\n    return;\n  }\n  for (const file of files) {\n    const filePath = path.join(hooksDir, file);\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      logWarn(`KiroGraph installer: could not read hook file ${filePath}`);\n      continue;\n    }\n    let obj: any;\n    try {\n      obj = JSON.parse(raw);\n    } catch {\n      logWarn(`KiroGraph installer: could not parse hook file ${filePath}`);\n      continue;\n    }\n    let changed = false;\n    if (obj?.when?.type === 'onIdle') {\n      obj.when.type = 'agentStop';\n      changed = true;\n    }\n    // Migrate .json \u2192 .kiro.hook extension\n    if (file.endsWith('.json') && file.startsWith('kirograph-')) {\n      const newName = file.replace(/\\.json$/, HOOK_EXT);\n      const newPath = path.join(hooksDir, newName);\n      try {\n        fs.writeFileSync(newPath, JSON.stringify(obj, null, 2) + '\\n');\n        fs.unlinkSync(filePath);\n      } catch {\n        logWarn(`KiroGraph installer: could not migrate hook file ${filePath} \u2192 ${newName}`);\n      }\n    } else if (changed) {\n      try {\n        fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\\n');\n      } catch {\n        logWarn(`KiroGraph installer: could not write migrated hook file ${filePath}`);\n      }\n    }\n  }\n}\n\n// \u2500\u2500 Public \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function writeHooks(kiroDir: string, opts?: { enableCompression?: boolean; enableMemory?: boolean }): void {\n  const hooksDir = path.join(kiroDir, 'hooks');\n  ensureDir(hooksDir);\n\n  migrateOnIdleHooks(hooksDir);\n\n  const oldHooks = [\n    'kirograph-sync-on-save.json', 'kirograph-sync-on-create.json',\n    // Legacy .json versions (migrated to .kiro.hook)\n    'kirograph-mark-dirty-on-save.json', 'kirograph-mark-dirty-on-create.json',\n    'kirograph-sync-on-delete.json', 'kirograph-sync-if-dirty.json',\n    'kirograph-compress-hint.json', 'kirograph-mem-capture.json',\n    // Removed per-file hooks (consolidated into agentStop sync)\n    `kirograph-mark-dirty-on-save${HOOK_EXT}`,\n    `kirograph-mark-dirty-on-create${HOOK_EXT}`,\n    `kirograph-sync-on-delete${HOOK_EXT}`,\n  ];\n  for (const old of oldHooks) {\n    const p = path.join(hooksDir, old);\n    if (fs.existsSync(p)) fs.unlinkSync(p);\n  }\n\n  for (const { filename, hook } of HOOKS) {\n    // Skip compression hook if compression is disabled\n    if (filename === `kirograph-compress-hint${HOOK_EXT}` && opts?.enableCompression === false) {\n      const p = path.join(hooksDir, filename);\n      if (fs.existsSync(p)) fs.unlinkSync(p);\n      continue;\n    }\n    // Skip memory hook if memory is disabled\n    if (filename === `kirograph-mem-capture${HOOK_EXT}` && !opts?.enableMemory) {\n      const p = path.join(hooksDir, filename);\n      if (fs.existsSync(p)) fs.unlinkSync(p);\n      continue;\n    }\n    writeJson(path.join(hooksDir, filename), hook);\n  }\n\n  console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,SAAoB;AACpB,WAAsB;AACtB,oBAAwB;AAIxB,MAAM,WAAW;AAEjB,MAAM,QAAmD;AAAA,EACvD;AAAA,IACE,UAAU,0BAA0B,QAAQ;AAAA,IAC5C,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,YAAY;AAAA,MAC1B,MAAM,EAAE,MAAM,cAAc,SAAS,0CAA0C;AAAA,IACjF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU,0BAA0B,QAAQ;AAAA,IAC5C,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,cAAc,WAAW,CAAC,OAAO,EAAE;AAAA,MACjD,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU,wBAAwB,QAAQ;AAAA,IAC1C,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,YAAY;AAAA,MAC1B,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,QAAQ;AAAA,MACV;AAAA,IACF;AAAA,EACF;AACF;AAIA,SAAS,UAAU,GAAiB;AAClC,KAAG,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACrC;AAEA,SAAS,UAAU,GAAW,MAAqB;AACjD,KAAG,cAAc,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,IAAI;AAC1D;AAEA,SAAS,mBAAmB,UAAwB;AAClD,MAAI,CAAC,GAAG,WAAW,QAAQ,EAAG;AAC9B,MAAI;AACJ,MAAI;AACF,YAAQ,GAAG,YAAY,QAAQ,EAAE,OAAO,OAAK,EAAE,SAAS,OAAO,KAAK,EAAE,SAAS,QAAQ,CAAC;AAAA,EAC1F,QAAQ;AACN;AAAA,EACF;AACA,aAAW,QAAQ,OAAO;AACxB,UAAM,WAAW,KAAK,KAAK,UAAU,IAAI;AACzC,QAAI;AACJ,QAAI;AACF,YAAM,GAAG,aAAa,UAAU,MAAM;AAAA,IACxC,QAAQ;AACN,iCAAQ,iDAAiD,QAAQ,EAAE;AACnE;AAAA,IACF;AACA,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,MAAM,GAAG;AAAA,IACtB,QAAQ;AACN,iCAAQ,kDAAkD,QAAQ,EAAE;AACpE;AAAA,IACF;AACA,QAAI,UAAU;AACd,QAAI,KAAK,MAAM,SAAS,UAAU;AAChC,UAAI,KAAK,OAAO;AAChB,gBAAU;AAAA,IACZ;AAEA,QAAI,KAAK,SAAS,OAAO,KAAK,KAAK,WAAW,YAAY,GAAG;AAC3D,YAAM,UAAU,KAAK,QAAQ,WAAW,QAAQ;AAChD,YAAM,UAAU,KAAK,KAAK,UAAU,OAAO;AAC3C,UAAI;AACF,WAAG,cAAc,SAAS,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI;AAC7D,WAAG,WAAW,QAAQ;AAAA,MACxB,QAAQ;AACN,mCAAQ,oDAAoD,QAAQ,WAAM,OAAO,EAAE;AAAA,MACrF;AAAA,IACF,WAAW,SAAS;AAClB,UAAI;AACF,WAAG,cAAc,UAAU,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI;AAAA,MAChE,QAAQ;AACN,mCAAQ,2DAA2D,QAAQ,EAAE;AAAA,MAC/E;AAAA,IACF;AAAA,EACF;AACF;AAIO,SAAS,WAAW,SAAiB,MAAsE;AAChH,QAAM,WAAW,KAAK,KAAK,SAAS,OAAO;AAC3C,YAAU,QAAQ;AAElB,qBAAmB,QAAQ;AAE3B,QAAM,WAAW;AAAA,IACf;AAAA,IAA+B;AAAA;AAAA,IAE/B;AAAA,IAAqC;AAAA,IACrC;AAAA,IAAiC;AAAA,IACjC;AAAA,IAAgC;AAAA;AAAA,IAEhC,+BAA+B,QAAQ;AAAA,IACvC,iCAAiC,QAAQ;AAAA,IACzC,2BAA2B,QAAQ;AAAA,EACrC;AACA,aAAW,OAAO,UAAU;AAC1B,UAAM,IAAI,KAAK,KAAK,UAAU,GAAG;AACjC,QAAI,GAAG,WAAW,CAAC,EAAG,IAAG,WAAW,CAAC;AAAA,EACvC;AAEA,aAAW,EAAE,UAAU,KAAK,KAAK,OAAO;AAEtC,QAAI,aAAa,0BAA0B,QAAQ,MAAM,MAAM,sBAAsB,OAAO;AAC1F,YAAM,IAAI,KAAK,KAAK,UAAU,QAAQ;AACtC,UAAI,GAAG,WAAW,CAAC,EAAG,IAAG,WAAW,CAAC;AACrC;AAAA,IACF;AAEA,QAAI,aAAa,wBAAwB,QAAQ,MAAM,CAAC,MAAM,cAAc;AAC1E,YAAM,IAAI,KAAK,KAAK,UAAU,QAAQ;AACtC,UAAI,GAAG,WAAW,CAAC,EAAG,IAAG,WAAW,CAAC;AACrC;AAAA,IACF;AACA,cAAU,KAAK,KAAK,UAAU,QAAQ,GAAG,IAAI;AAAA,EAC/C;AAEA,UAAQ,IAAI,uCAAkC,QAAQ,EAAE;AAC1D;",
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro hook file management\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logWarn } from '../../errors';\n\n// \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst HOOK_EXT = '.kiro.hook';\n\n// \u2500\u2500 Hook builders \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction buildWatchmenHook(synthesisMode: 'local' | 'agent'): object {\n  if (synthesisMode === 'local') {\n    return {\n      name: 'KiroGraph Watchmen',\n      version: '1.0.0',\n      description: 'After memory capture, run local model synthesis if enough observations have accumulated.',\n      when: { type: 'agentStop' },\n      then: { type: 'runCommand', command: 'kirograph mem watchmen synthesize --quiet 2>&1 || true' },\n    };\n  }\n  return {\n    name: 'KiroGraph Watchmen',\n    version: '1.0.0',\n    description: 'After memory capture, check if enough observations have accumulated. If so, synthesize them into workspace brief files.',\n    when: { type: 'agentStop' },\n    then: {\n      type: 'askAgent',\n      prompt: `Check if KiroGraph Watchmen synthesis should run: call kirograph_mem_store with kind='note' and content='watchmen check'. If the response does not include watchmenReady: true, do nothing and stop.\n\nIf watchmenReady: true:\n1. Call kirograph_mem_search for each kind (decision, error, pattern, architecture, note) with limit 20.\n2. Write or update the workspace brief: upsert the ## KiroGraph Watchmen section in each file listed in targetFiles. For .kiro/steering/kirograph-watchmen.md use inclusion: always frontmatter with sections for Decisions, Known Errors & Fixes, Recurring Patterns, and Architecture Notes. For all other files write a compact ## KiroGraph Watchmen block.\n3. Generate skill files: if skillTargetDir is present in the response, identify recurring procedures (any procedure appearing in 3+ observations). For each, write a .kiro/steering/watchmen-<slug>.md file with inclusion: manual frontmatter, a short title, a \"When to use\" line with trigger phrases, and numbered steps. Prefix all generated files with watchmen- so they are distinguishable from hand-written steering files. Remove any .kiro/steering/watchmen-*.md files from previous runs that no longer match current patterns. If skillTargetDir is absent, embed a ## Recurring Procedures section in each targetFile instead, listing each procedure with trigger context and steps.\n4. Store a kind='summary' observation briefly describing what was synthesized (e.g. \"Synthesized 8 observations: updated kirograph-watchmen.md, wrote watchmen-auth-flow.md and watchmen-test-pattern.md\").`,\n    },\n  };\n}\n\nconst HOOKS: Array<{ filename: string; hook: object }> = [\n  {\n    filename: `kirograph-sync-if-dirty${HOOK_EXT}`,\n    hook: {\n      name: 'KiroGraph Sync on Agent Stop',\n      version: '1.0.0',\n      description: 'Sync the KiroGraph index when the agent stops, picking up any file edits, creates, or deletes from the session.',\n      when: { type: 'agentStop' },\n      then: { type: 'runCommand', command: 'kirograph sync --quiet 2>&1 > /dev/null' },\n    },\n  },\n  {\n    filename: `kirograph-compress-hint${HOOK_EXT}`,\n    hook: {\n      name: 'KiroGraph Compression Hint',\n      version: '1.0.0',\n      description: 'Remind the agent to use kirograph_exec for shell commands that benefit from token compression (git, gh, test, lint, build, docker, aws, grep).',\n      when: { type: 'preToolUse', toolTypes: ['shell'] },\n      then: {\n        type: 'askAgent',\n        prompt: 'If this shell command is a git operation, GitHub CLI, test runner, linter, build tool, file listing, grep/rg, docker/kubectl, AWS CLI, or package manager command, consider using the kirograph_exec MCP tool instead for 60-90% token savings. The tool compresses output automatically while preserving error details.',\n      },\n    },\n  },\n  {\n    filename: `kirograph-mem-capture${HOOK_EXT}`,\n    hook: {\n      name: 'KiroGraph Memory Capture',\n      version: '1.0.0',\n      description: 'Prompt the agent to store important observations in memory at the end of each session.',\n      when: { type: 'agentStop' },\n      then: {\n        type: 'askAgent',\n        prompt: 'Before ending, review what happened in this session. If there were any important decisions, bug root causes, architecture insights, error patterns, or lessons learned, store them using kirograph_mem_store with the appropriate kind (decision, error, pattern, architecture, note). Keep observations concise \u2014 one fact per observation. Skip if nothing noteworthy happened.',\n      },\n    },\n  },\n];\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nfunction writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nfunction migrateOnIdleHooks(hooksDir: string): void {\n  if (!fs.existsSync(hooksDir)) return;\n  let files: string[];\n  try {\n    files = fs.readdirSync(hooksDir).filter(f => f.endsWith('.json') || f.endsWith(HOOK_EXT));\n  } catch {\n    return;\n  }\n  for (const file of files) {\n    const filePath = path.join(hooksDir, file);\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      logWarn(`KiroGraph installer: could not read hook file ${filePath}`);\n      continue;\n    }\n    let obj: any;\n    try {\n      obj = JSON.parse(raw);\n    } catch {\n      logWarn(`KiroGraph installer: could not parse hook file ${filePath}`);\n      continue;\n    }\n    let changed = false;\n    if (obj?.when?.type === 'onIdle') {\n      obj.when.type = 'agentStop';\n      changed = true;\n    }\n    // Migrate .json \u2192 .kiro.hook extension\n    if (file.endsWith('.json') && file.startsWith('kirograph-')) {\n      const newName = file.replace(/\\.json$/, HOOK_EXT);\n      const newPath = path.join(hooksDir, newName);\n      try {\n        fs.writeFileSync(newPath, JSON.stringify(obj, null, 2) + '\\n');\n        fs.unlinkSync(filePath);\n      } catch {\n        logWarn(`KiroGraph installer: could not migrate hook file ${filePath} \u2192 ${newName}`);\n      }\n    } else if (changed) {\n      try {\n        fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\\n');\n      } catch {\n        logWarn(`KiroGraph installer: could not write migrated hook file ${filePath}`);\n      }\n    }\n  }\n}\n\n// \u2500\u2500 Public \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function writeHooks(kiroDir: string, opts?: { enableCompression?: boolean; enableMemory?: boolean; enableWatchmen?: boolean; watchmenSynthesisMode?: 'local' | 'agent' }): void {\n  const hooksDir = path.join(kiroDir, 'hooks');\n  ensureDir(hooksDir);\n\n  migrateOnIdleHooks(hooksDir);\n\n  const oldHooks = [\n    'kirograph-sync-on-save.json', 'kirograph-sync-on-create.json',\n    // Legacy .json versions (migrated to .kiro.hook)\n    'kirograph-mark-dirty-on-save.json', 'kirograph-mark-dirty-on-create.json',\n    'kirograph-sync-on-delete.json', 'kirograph-sync-if-dirty.json',\n    'kirograph-compress-hint.json', 'kirograph-mem-capture.json',\n    // Removed per-file hooks (consolidated into agentStop sync)\n    `kirograph-mark-dirty-on-save${HOOK_EXT}`,\n    `kirograph-mark-dirty-on-create${HOOK_EXT}`,\n    `kirograph-sync-on-delete${HOOK_EXT}`,\n  ];\n  for (const old of oldHooks) {\n    const p = path.join(hooksDir, old);\n    if (fs.existsSync(p)) fs.unlinkSync(p);\n  }\n\n  for (const { filename, hook } of HOOKS) {\n    // Skip compression hook if compression is disabled\n    if (filename === `kirograph-compress-hint${HOOK_EXT}` && opts?.enableCompression === false) {\n      const p = path.join(hooksDir, filename);\n      if (fs.existsSync(p)) fs.unlinkSync(p);\n      continue;\n    }\n    // Skip memory hook if memory is disabled\n    if (filename === `kirograph-mem-capture${HOOK_EXT}` && !opts?.enableMemory) {\n      const p = path.join(hooksDir, filename);\n      if (fs.existsSync(p)) fs.unlinkSync(p);\n      continue;\n    }\n    writeJson(path.join(hooksDir, filename), hook);\n  }\n\n  // Watchmen hook \u2014 built dynamically based on synthesis mode\n  const watchmenHookPath = path.join(hooksDir, `kirograph-watchmen${HOOK_EXT}`);\n  if (opts?.enableWatchmen) {\n    const mode = opts.watchmenSynthesisMode ?? 'local';\n    writeJson(watchmenHookPath, buildWatchmenHook(mode));\n  } else {\n    if (fs.existsSync(watchmenHookPath)) fs.unlinkSync(watchmenHookPath);\n  }\n\n  console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/bin/installer/index.d.ts

@@ -1,11 +1,12 @@
 /**
- * KiroGraph Installer for Kiro
+ * KiroGraph Installer
  *
- * Wires up:
+ * The default target wires up Kiro:
  *  1. .kiro/settings/mcp.json        — registers the MCP server (IDE + CLI)
- *  2. .kiro/hooks/*.json             — auto-sync hooks for Kiro IDE
+ *  2. .kiro/hooks/*.kiro.hook       — auto-sync hooks for Kiro IDE
  *  3. .kiro/steering/kirograph.md    — teaches Kiro to use the graph tools (IDE + CLI)
  *  4. .kiro/agents/kirograph.json    — custom agent config for Kiro CLI
  */
-export declare function runInstaller(): Promise<void>;
+import type { InstallTarget } from './common';
+export declare function runInstaller(target?: InstallTarget): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/bin/installer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqJlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C,wBAAsB,YAAY,CAAC,MAAM,GAAE,aAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4QhF"}

package/dist/bin/installer/index.js

@@ -44,7 +44,7 @@ var import_config_prompt = require("./config-prompt");
 var import_dashboard = require("./dashboard");
 var import_qdrant_dashboard = require("./qdrant-dashboard");
 var import_targets = require("./targets");
-async function runInstaller(target = "kiro") {
+async function runInstaller(target = "kiro", opts = {}) {
   (0, import_banner.printBanner)();
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   try {
@@ -52,11 +52,15 @@ async function runInstaller(target = "kiro") {
     const installer = (0, import_targets.getTargetInstaller)(target);
     console.log(`  Workspace: ${cwd}
 `);
-    const proceed = await (0, import_prompts.askToggle)(rl, `Install KiroGraph for ${installer.label}?`, "Registers the MCP server and writes integration files for this workspace.");
-    if (!proceed) {
-      console.log("  Cancelled.");
-      rl.close();
-      return;
+    if (!opts.yes) {
+      const proceed = await (0, import_prompts.askToggle)(rl, `Install KiroGraph for ${installer.label}?`, "Registers the MCP server and writes integration files for this workspace.");
+      if (!proceed) {
+        console.log("  Cancelled.");
+        rl.close();
+        return;
+      }
+    } else {
+      console.log(`  Installing KiroGraph for ${installer.label} (--yes)`);
     }
     console.log();
     installer.installEarly(cwd);
@@ -67,7 +71,10 @@ async function runInstaller(target = "kiro") {
     let enableDocs = false;
     let enableData = false;
     let enableSecurity = false;
+    let enablePatterns = false;
     let enableArchitecture = false;
+    let enableWatchmen = false;
+    let watchmenSynthesisMode = "local";
     let shouldOfferIndex = false;
     let typesenseDashboard = false;
     let qdrantDashboard = false;
@@ -80,6 +87,9 @@ async function runInstaller(target = "kiro") {
         enableDocs = config.enableDocs ?? false;
         enableData = config.enableData ?? false;
         enableSecurity = config.enableSecurity ?? false;
+        enableWatchmen = config.enableWatchmen ?? false;
+        watchmenSynthesisMode = config.watchmenSynthesisMode ?? "local";
+        enablePatterns = config.enablePatterns ?? false;
         enableArchitecture = config.enableArchitecture ?? false;
         console.log(`  \u2713 Reusing existing KiroGraph data in ${cwd}/.kirograph/`);
         console.log(`  \u2022 semanticEngine: ${config.semanticEngine}`);
@@ -91,6 +101,7 @@ async function runInstaller(target = "kiro") {
         console.log(`  \u2022 enableDocs: ${enableDocs}`);
         console.log(`  \u2022 enableData: ${enableData}`);
         console.log(`  \u2022 enableSecurity: ${enableSecurity}`);
+        console.log(`  \u2022 enablePatterns: ${enablePatterns}`);
       } else {
         shouldOfferIndex = true;
         const patch = await (0, import_config_prompt.promptConfigOptions)(rl);
@@ -101,7 +112,10 @@ async function runInstaller(target = "kiro") {
         enableDocs = patch.enableDocs ?? false;
         enableData = patch.enableData ?? false;
         enableSecurity = patch.enableSecurity ?? false;
+        enablePatterns = patch.enablePatterns ?? false;
         enableArchitecture = patch.enableArchitecture ?? false;
+        enableWatchmen = patch.enableWatchmen ?? false;
+        watchmenSynthesisMode = patch.watchmenSynthesisMode ?? "local";
         typesenseDashboard = patch.typesenseDashboard;
         qdrantDashboard = patch.qdrantDashboard;
         console.log(`
@@ -184,6 +198,7 @@ async function runInstaller(target = "kiro") {
         console.log(`  \u2022 enableDocs: ${enableDocs}`);
         console.log(`  \u2022 enableData: ${enableData}`);
         console.log(`  \u2022 enableSecurity: ${enableSecurity}`);
+        console.log(`  \u2022 enablePatterns: ${enablePatterns}`);
         if (enableData) {
           if (patch.dataInstallExcel) {
             console.log(`
@@ -206,8 +221,51 @@ async function runInstaller(target = "kiro") {
             }
           }
         }
+        if (enablePatterns) {
+          console.log(`
+  Installing @ast-grep/napi...`);
+          const astGrepResult = (0, import_child_process.spawnSync)("npm", ["install", "@ast-grep/napi", "--save-optional"], {
+            stdio: "inherit",
+            shell: true
+          });
+          if (astGrepResult.status === 0) {
+            console.log(`  \u2713 @ast-grep/napi installed`);
+            const langPackages = [
+              "@ast-grep/lang-go",
+              "@ast-grep/lang-python",
+              "@ast-grep/lang-java",
+              "@ast-grep/lang-rust",
+              "@ast-grep/lang-c",
+              "@ast-grep/lang-cpp",
+              "@ast-grep/lang-csharp",
+              "@ast-grep/lang-kotlin",
+              "@ast-grep/lang-swift",
+              "@ast-grep/lang-ruby",
+              "@ast-grep/lang-php",
+              "@ast-grep/lang-bash",
+              "@ast-grep/lang-scala",
+              "@ast-grep/lang-dart",
+              "@ast-grep/lang-lua",
+              "@ast-grep/lang-elixir",
+              "@ast-grep/lang-haskell"
+            ];
+            const langResult = (0, import_child_process.spawnSync)("npm", ["install", ...langPackages, "--save-optional"], {
+              stdio: "inherit",
+              shell: true
+            });
+            if (langResult.status === 0) {
+              console.log(`  \u2713 @ast-grep language grammars installed`);
+            } else {
+              console.warn(`  \u2717 Language grammar install failed. Pattern matching will be limited to JS/TS/HTML/CSS.`);
+              console.warn(`    Run manually: npm install ${langPackages.join(" ")}`);
+            }
+          } else {
+            console.warn(`  \u2717 @ast-grep/napi install failed. Run manually: npm install @ast-grep/napi`);
+            console.warn(`  KiroGraph will continue but kirograph pattern and kirograph_live_search will be unavailable.`);
+          }
+        }
       }
-      installer.installLate(cwd, cavemanMode, shellCompressionLevel, enableMemory, enableDocs, enableData, enableSecurity, enableArchitecture);
+      installer.installLate(cwd, cavemanMode, shellCompressionLevel, enableMemory, enableDocs, enableData, enableSecurity, enableArchitecture, enablePatterns, enableWatchmen, watchmenSynthesisMode);
     } catch (err) {
       const reason = err instanceof Error ? err.message : String(err);
       console.error(`
@@ -217,7 +275,8 @@ async function runInstaller(target = "kiro") {
     if (qdrantDashboard) {
       await (0, import_qdrant_dashboard.ensureQdrantUI)(cwd);
     }
-    if (shouldOfferIndex && await (0, import_prompts.askToggle)(rl, "Initialize and index this project now?", "Creates .kirograph/ and indexes all source files. Takes a few seconds for small projects, longer for large ones.")) {
+    const doIndex = shouldOfferIndex && (opts.yes || await (0, import_prompts.askToggle)(rl, "Initialize and index this project now?", "Creates .kirograph/ and indexes all source files. Takes a few seconds for small projects, longer for large ones."));
+    if (doIndex) {
       const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
       const fileBytes = /* @__PURE__ */ new Map();
       const modelProgress = (file, loaded, total, done) => {

package/dist/bin/installer/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/index.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer\n *\n * The default target wires up Kiro:\n *  1. .kiro/settings/mcp.json        \u2014 registers the MCP server (IDE + CLI)\n *  2. .kiro/hooks/*.kiro.hook       \u2014 auto-sync hooks for Kiro IDE\n *  3. .kiro/steering/kirograph.md    \u2014 teaches Kiro to use the graph tools (IDE + CLI)\n *  4. .kiro/agents/kirograph.json    \u2014 custom agent config for Kiro CLI\n */\n\nimport * as readline from 'readline';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { spawnSync } from 'child_process';\nimport { loadConfig, updateConfig } from '../../config';\nimport { printBanner } from '../banner';\nimport { renderIndexProgress } from '../progress';\nimport { dim, reset } from '../ui';\nimport { ask, askToggle } from './prompts';\nimport { promptConfigOptions } from './config-prompt';\nimport { openTypesenseDashboard } from './dashboard';\nimport { ensureQdrantUI, openQdrantDashboard } from './qdrant-dashboard';\nimport type { InstallTarget } from './common';\nimport { getTargetInstaller } from './targets';\nimport type { CavemanMode } from './caveman';\n\nexport async function runInstaller(target: InstallTarget = 'kiro'): Promise<void> {\n  printBanner();\n\n  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n\n  try {\n    const cwd = process.cwd();\n    const installer = getTargetInstaller(target);\n\n    console.log(`  Workspace: ${cwd}\\n`);\n\n    const proceed = await askToggle(rl, `Install KiroGraph for ${installer.label}?`, 'Registers the MCP server and writes integration files for this workspace.');\n    if (!proceed) { console.log('  Cancelled.'); rl.close(); return; }\n    console.log();\n\n    installer.installEarly(cwd);\n\n    const alreadyInitialized = fs.existsSync(path.join(cwd, '.kirograph'));\n    let cavemanMode: CavemanMode | 'off' = 'off';\n    let shellCompressionLevel: 'off' | 'normal' | 'aggressive' | 'ultra' = 'normal';\n    let enableMemory = false;\n    let enableDocs = false;\n    let enableData = false;\n    let enableSecurity = false;\n    let enableArchitecture = false;\n    let shouldOfferIndex = false;\n    let typesenseDashboard = false;\n    let qdrantDashboard = false;\n\n    try {\n      if (alreadyInitialized) {\n        const config = await loadConfig(cwd);\n        cavemanMode = config.cavemanMode ?? 'off';\n        shellCompressionLevel = config.shellCompressionLevel ?? 'normal';\n        enableMemory = config.enableMemory ?? false;\n        enableDocs = config.enableDocs ?? false;\n        enableData = (config as any).enableData ?? false;\n        enableSecurity = (config as any).enableSecurity ?? false;\n        enableArchitecture = config.enableArchitecture ?? false;\n        console.log(`  \u2713 Reusing existing KiroGraph data in ${cwd}/.kirograph/`);\n        console.log(`  \u2022 semanticEngine: ${config.semanticEngine}`);\n        console.log(`  \u2022 enableEmbeddings: ${config.enableEmbeddings}`);\n        console.log(`  \u2022 enableArchitecture: ${config.enableArchitecture}`);\n        console.log(`  \u2022 cavemanMode: ${cavemanMode}`);\n        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);\n        console.log(`  \u2022 enableMemory: ${enableMemory}`);\n        console.log(`  \u2022 enableDocs: ${enableDocs}`);\n        console.log(`  \u2022 enableData: ${enableData}`);\n        console.log(`  \u2022 enableSecurity: ${enableSecurity}`);\n      } else {\n        shouldOfferIndex = true;\n        const patch = await promptConfigOptions(rl);\n        await updateConfig(cwd, patch);\n        cavemanMode = patch.cavemanMode ?? 'off';\n        shellCompressionLevel = patch.shellCompressionLevel ?? 'normal';\n        enableMemory = patch.enableMemory ?? false;\n        enableDocs = patch.enableDocs ?? false;\n        enableData = patch.enableData ?? false;\n        enableSecurity = patch.enableSecurity ?? false;\n        enableArchitecture = patch.enableArchitecture ?? false;\n        typesenseDashboard = patch.typesenseDashboard;\n        qdrantDashboard = patch.qdrantDashboard;\n\n        console.log(`\\n  Configuration saved to ${cwd}/.kirograph/config.json`);\n        console.log(`  \u2022 enableEmbeddings: ${patch.enableEmbeddings}`);\n        if ('embeddingModel' in patch) {\n          console.log(`  \u2022 embeddingModel: ${patch.embeddingModel}  ${dim}(${patch.embeddingDim}-dim)${reset}`);\n        }\n        if (patch.enableEmbeddings) {\n          console.log(`  \u2022 semanticEngine: ${patch.semanticEngine}`);\n          if (patch.semanticEngine === 'sqlite-vec') {\n            console.log(`\\n  Installing sqlite-vec dependencies...`);\n            const result = spawnSync('npm', ['install', 'better-sqlite3', 'sqlite-vec'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 better-sqlite3 and sqlite-vec installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install better-sqlite3 sqlite-vec`);\n            }\n          } else if (patch.semanticEngine === 'orama') {\n            console.log(`\\n  Installing Orama dependencies...`);\n            const result = spawnSync('npm', ['install', '@orama/orama', '@orama/plugin-data-persistence'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 @orama/orama and @orama/plugin-data-persistence installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install @orama/orama @orama/plugin-data-persistence`);\n            }\n          } else if (patch.semanticEngine === 'pglite') {\n            console.log(`\\n  Installing PGlite dependencies...`);\n            const result = spawnSync('npm', ['install', '@electric-sql/pglite'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 @electric-sql/pglite installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install @electric-sql/pglite`);\n            }\n          } else if (patch.semanticEngine === 'lancedb') {\n            console.log(`\\n  Installing LanceDB dependencies...`);\n            const result = spawnSync('npm', ['install', '@lancedb/lancedb'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 @lancedb/lancedb installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install @lancedb/lancedb`);\n            }\n          } else if (patch.semanticEngine === 'qdrant') {\n            console.log(`\\n  Installing Qdrant dependencies...`);\n            const result = spawnSync('npm', ['install', 'qdrant-local'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 qdrant-local installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install qdrant-local`);\n            }\n          } else if (patch.semanticEngine === 'typesense') {\n            console.log(`\\n  Installing Typesense dependencies...`);\n            const result = spawnSync('npm', ['install', 'typesense'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 typesense installed`);\n              console.log(`  \u2139  The Typesense binary (~37MB) will be auto-downloaded on first index run.`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install typesense`);\n            }\n          }\n        }\n        console.log(`  \u2022 extractDocstrings: ${patch.extractDocstrings}`);\n        console.log(`  \u2022 trackCallSites: ${patch.trackCallSites}`);\n        console.log(`  \u2022 enableArchitecture: ${patch.enableArchitecture}`);\n        console.log(`  \u2022 cavemanMode: ${cavemanMode}`);\n        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);\n        console.log(`  \u2022 enableMemory: ${enableMemory}`);\n        console.log(`  \u2022 enableDocs: ${enableDocs}`);\n        console.log(`  \u2022 enableData: ${enableData}`);\n        console.log(`  \u2022 enableSecurity: ${enableSecurity}`);\n\n        // Install optional data format deps if enableData is on\n        if (enableData) {\n          if ((patch as any).dataInstallExcel) {\n            console.log(`\\n  Installing xlsx...`);\n            const xlsxResult = spawnSync('npm', ['install', 'xlsx'], { stdio: 'inherit', shell: true });\n            if (xlsxResult.status === 0) {\n              console.log(`  \u2713 xlsx installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed. Run manually: npm install xlsx`);\n            }\n          }\n          if ((patch as any).dataInstallParquet) {\n            console.log(`\\n  Installing parquetjs-lite...`);\n            const pqResult = spawnSync('npm', ['install', 'parquetjs-lite'], { stdio: 'inherit', shell: true });\n            if (pqResult.status === 0) {\n              console.log(`  \u2713 parquetjs-lite installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed. Run manually: npm install parquetjs-lite`);\n            }\n          }\n        }\n      }\n\n      installer.installLate(cwd, cavemanMode, shellCompressionLevel, enableMemory, enableDocs, enableData, enableSecurity, enableArchitecture);\n    } catch (err) {\n      const reason = err instanceof Error ? err.message : String(err);\n      console.error(`\\n  \u2717 Failed to write configuration: ${reason}`);\n      process.exit(1);\n    }\n\n    // 5. Pre-download Qdrant UI before indexing so Qdrant starts with static content dir\n    if (qdrantDashboard) {\n      await ensureQdrantUI(cwd);\n    }\n\n    // 6. Optionally init + index\n    if (shouldOfferIndex && await askToggle(rl, 'Initialize and index this project now?', 'Creates .kirograph/ and indexes all source files. Takes a few seconds for small projects, longer for large ones.')) {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n\n      const fileBytes = new Map<string, { loaded: number; total: number }>();\n      const modelProgress = (file: string, loaded: number, total: number, done: boolean): void => {\n        const entry = fileBytes.get(file) ?? { loaded: 0, total: 0 };\n        if (total > 0) entry.total = total;\n        entry.loaded = done ? entry.total : loaded;\n        fileBytes.set(file, entry);\n\n        // Only count files where we know the size (content-length was present)\n        const knownFiles = Array.from(fileBytes.values()).filter(f => f.total > 0);\n        const totalLoaded = knownFiles.reduce((s, f) => s + f.loaded, 0);\n        const totalBytes = knownFiles.reduce((s, f) => s + f.total, 0);\n        const pct = totalBytes > 0 ? Math.min((totalLoaded / totalBytes) * 100, 100) : 0;\n\n        const filled = Math.round(pct / 5);\n        const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(20 - filled);\n        const mb = (totalLoaded / 1024 / 1024).toFixed(1);\n        const totalMb = (totalBytes / 1024 / 1024).toFixed(1);\n        process.stdout.write(`\\r  [${bar}] ${pct.toFixed(0).padStart(3)}%  ${mb} / ${totalMb} MB   `);\n      };\n\n      // Suppress noisy internal warnings from @huggingface/transformers during download\n      const originalStderrWrite = process.stderr.write.bind(process.stderr);\n      const stderrFilter = (chunk: unknown, ...args: unknown[]): boolean => {\n        const str = typeof chunk === 'string' ? chunk : String(chunk);\n        if (str.includes('content-length') || str.includes('dtype not specified')) return true;\n        return (originalStderrWrite as (...a: unknown[]) => boolean)(chunk, ...args);\n      };\n      process.stderr.write = stderrFilter as typeof process.stderr.write;\n\n      let cg;\n      try {\n        if (!KiroGraph.isInitialized(cwd)) {\n          process.stdout.write('  Downloading embedding model\u2026\\n');\n          cg = await KiroGraph.init(cwd, undefined, modelProgress);\n          process.stdout.write('\\n');\n          console.log('  \u2713 Created .kirograph/');\n        } else {\n          cg = await KiroGraph.open(cwd, modelProgress);\n          if (fileBytes.size > 0) process.stdout.write('\\n');\n        }\n      } finally {\n        process.stderr.write = originalStderrWrite;\n      }\n      console.log('  Indexing...');\n      const result = await cg.indexAll({ onProgress: renderIndexProgress });\n      process.stdout.write('\\n');\n      console.log(`  \u2713 Indexed ${result.filesIndexed} files, ${result.nodesCreated} symbols, ${result.edgesCreated} edges`);\n      cg.close();\n\n      if (typesenseDashboard) {\n        const dashboardServer = await openTypesenseDashboard(cwd);\n        console.log(`  ${dim}Press Ctrl+C to stop the dashboard server when done.${reset}`);\n        await new Promise<void>(resolve => {\n          process.on('SIGINT', () => {\n            if (dashboardServer) {\n              dashboardServer.close(() => resolve());\n            } else {\n              resolve();\n            }\n          });\n        });\n        return; // rl.close() handled in finally\n      }\n\n      if (qdrantDashboard) {\n        await openQdrantDashboard(cwd);\n      }\n    }\n\n    installer.printNextSteps(cwd);\n  } finally {\n    rl.close();\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Installer\n *\n * The default target wires up Kiro:\n *  1. .kiro/settings/mcp.json        \u2014 registers the MCP server (IDE + CLI)\n *  2. .kiro/hooks/*.kiro.hook       \u2014 auto-sync hooks for Kiro IDE\n *  3. .kiro/steering/kirograph.md    \u2014 teaches Kiro to use the graph tools (IDE + CLI)\n *  4. .kiro/agents/kirograph.json    \u2014 custom agent config for Kiro CLI\n */\n\nimport * as readline from 'readline';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { spawnSync } from 'child_process';\nimport { loadConfig, updateConfig } from '../../config';\nimport { printBanner } from '../banner';\nimport { renderIndexProgress } from '../progress';\nimport { dim, reset } from '../ui';\nimport { ask, askToggle } from './prompts';\nimport { promptConfigOptions } from './config-prompt';\nimport { openTypesenseDashboard } from './dashboard';\nimport { ensureQdrantUI, openQdrantDashboard } from './qdrant-dashboard';\nimport type { InstallTarget } from './common';\nimport { getTargetInstaller } from './targets';\nimport type { CavemanMode } from './caveman';\n\nexport async function runInstaller(target: InstallTarget = 'kiro', opts: { yes?: boolean } = {}): Promise<void> {\n  printBanner();\n\n  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });\n\n  try {\n    const cwd = process.cwd();\n    const installer = getTargetInstaller(target);\n\n    console.log(`  Workspace: ${cwd}\\n`);\n\n    if (!opts.yes) {\n      const proceed = await askToggle(rl, `Install KiroGraph for ${installer.label}?`, 'Registers the MCP server and writes integration files for this workspace.');\n      if (!proceed) { console.log('  Cancelled.'); rl.close(); return; }\n    } else {\n      console.log(`  Installing KiroGraph for ${installer.label} (--yes)`);\n    }\n    console.log();\n\n    installer.installEarly(cwd);\n\n    const alreadyInitialized = fs.existsSync(path.join(cwd, '.kirograph'));\n    let cavemanMode: CavemanMode | 'off' = 'off';\n    let shellCompressionLevel: 'off' | 'normal' | 'aggressive' | 'ultra' = 'normal';\n    let enableMemory = false;\n    let enableDocs = false;\n    let enableData = false;\n    let enableSecurity = false;\n    let enablePatterns = false;\n    let enableArchitecture = false;\n    let enableWatchmen = false;\n    let watchmenSynthesisMode: 'local' | 'agent' = 'local';\n    let shouldOfferIndex = false;\n    let typesenseDashboard = false;\n    let qdrantDashboard = false;\n\n    try {\n      if (alreadyInitialized) {\n        const config = await loadConfig(cwd);\n        cavemanMode = config.cavemanMode ?? 'off';\n        shellCompressionLevel = config.shellCompressionLevel ?? 'normal';\n        enableMemory = config.enableMemory ?? false;\n        enableDocs = config.enableDocs ?? false;\n        enableData = (config as any).enableData ?? false;\n        enableSecurity = (config as any).enableSecurity ?? false;\n        enableWatchmen = config.enableWatchmen ?? false;\n        watchmenSynthesisMode = config.watchmenSynthesisMode ?? 'local';\n        enablePatterns = (config as any).enablePatterns ?? false;\n        enableArchitecture = config.enableArchitecture ?? false;\n        console.log(`  \u2713 Reusing existing KiroGraph data in ${cwd}/.kirograph/`);\n        console.log(`  \u2022 semanticEngine: ${config.semanticEngine}`);\n        console.log(`  \u2022 enableEmbeddings: ${config.enableEmbeddings}`);\n        console.log(`  \u2022 enableArchitecture: ${config.enableArchitecture}`);\n        console.log(`  \u2022 cavemanMode: ${cavemanMode}`);\n        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);\n        console.log(`  \u2022 enableMemory: ${enableMemory}`);\n        console.log(`  \u2022 enableDocs: ${enableDocs}`);\n        console.log(`  \u2022 enableData: ${enableData}`);\n        console.log(`  \u2022 enableSecurity: ${enableSecurity}`);\n        console.log(`  \u2022 enablePatterns: ${enablePatterns}`);\n      } else {\n        shouldOfferIndex = true;\n        const patch = await promptConfigOptions(rl);\n        await updateConfig(cwd, patch);\n        cavemanMode = patch.cavemanMode ?? 'off';\n        shellCompressionLevel = patch.shellCompressionLevel ?? 'normal';\n        enableMemory = patch.enableMemory ?? false;\n        enableDocs = patch.enableDocs ?? false;\n        enableData = patch.enableData ?? false;\n        enableSecurity = patch.enableSecurity ?? false;\n        enablePatterns = patch.enablePatterns ?? false;\n        enableArchitecture = patch.enableArchitecture ?? false;\n        enableWatchmen = patch.enableWatchmen ?? false;\n        watchmenSynthesisMode = patch.watchmenSynthesisMode ?? 'local';\n        typesenseDashboard = patch.typesenseDashboard;\n        qdrantDashboard = patch.qdrantDashboard;\n\n        console.log(`\\n  Configuration saved to ${cwd}/.kirograph/config.json`);\n        console.log(`  \u2022 enableEmbeddings: ${patch.enableEmbeddings}`);\n        if ('embeddingModel' in patch) {\n          console.log(`  \u2022 embeddingModel: ${patch.embeddingModel}  ${dim}(${patch.embeddingDim}-dim)${reset}`);\n        }\n        if (patch.enableEmbeddings) {\n          console.log(`  \u2022 semanticEngine: ${patch.semanticEngine}`);\n          if (patch.semanticEngine === 'sqlite-vec') {\n            console.log(`\\n  Installing sqlite-vec dependencies...`);\n            const result = spawnSync('npm', ['install', 'better-sqlite3', 'sqlite-vec'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 better-sqlite3 and sqlite-vec installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install better-sqlite3 sqlite-vec`);\n            }\n          } else if (patch.semanticEngine === 'orama') {\n            console.log(`\\n  Installing Orama dependencies...`);\n            const result = spawnSync('npm', ['install', '@orama/orama', '@orama/plugin-data-persistence'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 @orama/orama and @orama/plugin-data-persistence installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install @orama/orama @orama/plugin-data-persistence`);\n            }\n          } else if (patch.semanticEngine === 'pglite') {\n            console.log(`\\n  Installing PGlite dependencies...`);\n            const result = spawnSync('npm', ['install', '@electric-sql/pglite'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 @electric-sql/pglite installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install @electric-sql/pglite`);\n            }\n          } else if (patch.semanticEngine === 'lancedb') {\n            console.log(`\\n  Installing LanceDB dependencies...`);\n            const result = spawnSync('npm', ['install', '@lancedb/lancedb'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 @lancedb/lancedb installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install @lancedb/lancedb`);\n            }\n          } else if (patch.semanticEngine === 'qdrant') {\n            console.log(`\\n  Installing Qdrant dependencies...`);\n            const result = spawnSync('npm', ['install', 'qdrant-local'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 qdrant-local installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install qdrant-local`);\n            }\n          } else if (patch.semanticEngine === 'typesense') {\n            console.log(`\\n  Installing Typesense dependencies...`);\n            const result = spawnSync('npm', ['install', 'typesense'], { stdio: 'inherit', shell: true });\n            if (result.status === 0) {\n              console.log(`  \u2713 typesense installed`);\n              console.log(`  \u2139  The Typesense binary (~37MB) will be auto-downloaded on first index run.`);\n            } else {\n              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);\n              console.warn(`    npm install typesense`);\n            }\n          }\n        }\n        console.log(`  \u2022 extractDocstrings: ${patch.extractDocstrings}`);\n        console.log(`  \u2022 trackCallSites: ${patch.trackCallSites}`);\n        console.log(`  \u2022 enableArchitecture: ${patch.enableArchitecture}`);\n        console.log(`  \u2022 cavemanMode: ${cavemanMode}`);\n        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);\n        console.log(`  \u2022 enableMemory: ${enableMemory}`);\n        console.log(`  \u2022 enableDocs: ${enableDocs}`);\n        console.log(`  \u2022 enableData: ${enableData}`);\n        console.log(`  \u2022 enableSecurity: ${enableSecurity}`);\n        console.log(`  \u2022 enablePatterns: ${enablePatterns}`);\n\n        // Install optional data format deps if enableData is on\n        if (enableData) {\n          if ((patch as any).dataInstallExcel) {\n            console.log(`\\n  Installing xlsx...`);\n            const xlsxResult = spawnSync('npm', ['install', 'xlsx'], { stdio: 'inherit', shell: true });\n            if (xlsxResult.status === 0) {\n              console.log(`  \u2713 xlsx installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed. Run manually: npm install xlsx`);\n            }\n          }\n          if ((patch as any).dataInstallParquet) {\n            console.log(`\\n  Installing parquetjs-lite...`);\n            const pqResult = spawnSync('npm', ['install', 'parquetjs-lite'], { stdio: 'inherit', shell: true });\n            if (pqResult.status === 0) {\n              console.log(`  \u2713 parquetjs-lite installed`);\n            } else {\n              console.warn(`  \u2717 npm install failed. Run manually: npm install parquetjs-lite`);\n            }\n          }\n        }\n\n        if (enablePatterns) {\n          console.log(`\\n  Installing @ast-grep/napi...`);\n          const astGrepResult = spawnSync('npm', ['install', '@ast-grep/napi', '--save-optional'], {\n            stdio: 'inherit',\n            shell: true,\n          });\n          if (astGrepResult.status === 0) {\n            console.log(`  \u2713 @ast-grep/napi installed`);\n\n            // Install tree-sitter grammar packages for languages beyond the built-in\n            // JS/TS/HTML/CSS set. These are optional \u2014 missing packages are silently\n            // skipped at runtime, so a failed install here isn't fatal.\n            const langPackages = [\n              '@ast-grep/lang-go',\n              '@ast-grep/lang-python',\n              '@ast-grep/lang-java',\n              '@ast-grep/lang-rust',\n              '@ast-grep/lang-c',\n              '@ast-grep/lang-cpp',\n              '@ast-grep/lang-csharp',\n              '@ast-grep/lang-kotlin',\n              '@ast-grep/lang-swift',\n              '@ast-grep/lang-ruby',\n              '@ast-grep/lang-php',\n              '@ast-grep/lang-bash',\n              '@ast-grep/lang-scala',\n              '@ast-grep/lang-dart',\n              '@ast-grep/lang-lua',\n              '@ast-grep/lang-elixir',\n              '@ast-grep/lang-haskell',\n            ];\n            const langResult = spawnSync('npm', ['install', ...langPackages, '--save-optional'], {\n              stdio: 'inherit',\n              shell: true,\n            });\n            if (langResult.status === 0) {\n              console.log(`  \u2713 @ast-grep language grammars installed`);\n            } else {\n              console.warn(`  \u2717 Language grammar install failed. Pattern matching will be limited to JS/TS/HTML/CSS.`);\n              console.warn(`    Run manually: npm install ${langPackages.join(' ')}`);\n            }\n          } else {\n            console.warn(`  \u2717 @ast-grep/napi install failed. Run manually: npm install @ast-grep/napi`);\n            console.warn(`  KiroGraph will continue but kirograph pattern and kirograph_live_search will be unavailable.`);\n          }\n        }\n      }\n\n      installer.installLate(cwd, cavemanMode, shellCompressionLevel, enableMemory, enableDocs, enableData, enableSecurity, enableArchitecture, enablePatterns, enableWatchmen, watchmenSynthesisMode);\n    } catch (err) {\n      const reason = err instanceof Error ? err.message : String(err);\n      console.error(`\\n  \u2717 Failed to write configuration: ${reason}`);\n      process.exit(1);\n    }\n\n    // 5. Pre-download Qdrant UI before indexing so Qdrant starts with static content dir\n    if (qdrantDashboard) {\n      await ensureQdrantUI(cwd);\n    }\n\n    // 6. Optionally init + index\n    const doIndex = shouldOfferIndex && (opts.yes || await askToggle(rl, 'Initialize and index this project now?', 'Creates .kirograph/ and indexes all source files. Takes a few seconds for small projects, longer for large ones.'));\n    if (doIndex) {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n\n      const fileBytes = new Map<string, { loaded: number; total: number }>();\n      const modelProgress = (file: string, loaded: number, total: number, done: boolean): void => {\n        const entry = fileBytes.get(file) ?? { loaded: 0, total: 0 };\n        if (total > 0) entry.total = total;\n        entry.loaded = done ? entry.total : loaded;\n        fileBytes.set(file, entry);\n\n        // Only count files where we know the size (content-length was present)\n        const knownFiles = Array.from(fileBytes.values()).filter(f => f.total > 0);\n        const totalLoaded = knownFiles.reduce((s, f) => s + f.loaded, 0);\n        const totalBytes = knownFiles.reduce((s, f) => s + f.total, 0);\n        const pct = totalBytes > 0 ? Math.min((totalLoaded / totalBytes) * 100, 100) : 0;\n\n        const filled = Math.round(pct / 5);\n        const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(20 - filled);\n        const mb = (totalLoaded / 1024 / 1024).toFixed(1);\n        const totalMb = (totalBytes / 1024 / 1024).toFixed(1);\n        process.stdout.write(`\\r  [${bar}] ${pct.toFixed(0).padStart(3)}%  ${mb} / ${totalMb} MB   `);\n      };\n\n      // Suppress noisy internal warnings from @huggingface/transformers during download\n      const originalStderrWrite = process.stderr.write.bind(process.stderr);\n      const stderrFilter = (chunk: unknown, ...args: unknown[]): boolean => {\n        const str = typeof chunk === 'string' ? chunk : String(chunk);\n        if (str.includes('content-length') || str.includes('dtype not specified')) return true;\n        return (originalStderrWrite as (...a: unknown[]) => boolean)(chunk, ...args);\n      };\n      process.stderr.write = stderrFilter as typeof process.stderr.write;\n\n      let cg;\n      try {\n        if (!KiroGraph.isInitialized(cwd)) {\n          process.stdout.write('  Downloading embedding model\u2026\\n');\n          cg = await KiroGraph.init(cwd, undefined, modelProgress);\n          process.stdout.write('\\n');\n          console.log('  \u2713 Created .kirograph/');\n        } else {\n          cg = await KiroGraph.open(cwd, modelProgress);\n          if (fileBytes.size > 0) process.stdout.write('\\n');\n        }\n      } finally {\n        process.stderr.write = originalStderrWrite;\n      }\n      console.log('  Indexing...');\n      const result = await cg.indexAll({ onProgress: renderIndexProgress });\n      process.stdout.write('\\n');\n      console.log(`  \u2713 Indexed ${result.filesIndexed} files, ${result.nodesCreated} symbols, ${result.edgesCreated} edges`);\n      cg.close();\n\n      if (typesenseDashboard) {\n        const dashboardServer = await openTypesenseDashboard(cwd);\n        console.log(`  ${dim}Press Ctrl+C to stop the dashboard server when done.${reset}`);\n        await new Promise<void>(resolve => {\n          process.on('SIGINT', () => {\n            if (dashboardServer) {\n              dashboardServer.close(() => resolve());\n            } else {\n              resolve();\n            }\n          });\n        });\n        return; // rl.close() handled in finally\n      }\n\n      if (qdrantDashboard) {\n        await openQdrantDashboard(cwd);\n      }\n    }\n\n    installer.printNextSteps(cwd);\n  } finally {\n    rl.close();\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/bin/installer/instructions.d.ts

@@ -0,0 +1,14 @@
+import { CavemanMode } from './caveman';
+export interface InstructionOptions {
+    cavemanMode?: CavemanMode | 'off';
+    shellCompressionLevel?: 'off' | 'normal' | 'aggressive' | 'ultra';
+    enableArchitecture?: boolean;
+    enableMemory?: boolean;
+    enableDocs?: boolean;
+    enableData?: boolean;
+    enableSecurity?: boolean;
+    enablePatterns?: boolean;
+    hasHooks?: boolean;
+}
+export declare function buildAgentInstructions(cavemanModeOrOpts?: CavemanMode | 'off' | InstructionOptions): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/bin/installer/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAClC,qBAAqB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA6BD,wBAAgB,sBAAsB,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,kBAAkB,GAAG,MAAM,CA2O3G"}

package/dist/bin/installer/instructions.js

@@ -57,6 +57,7 @@ function buildAgentInstructions(cavemanModeOrOpts) {
   const enableDocs = opts.enableDocs ?? false;
   const enableData = opts.enableData ?? false;
   const enableSecurity = opts.enableSecurity ?? false;
+  const enablePatterns = opts.enablePatterns ?? false;
   let content = `# KiroGraph
 
 KiroGraph builds a local semantic knowledge graph of this codebase. When the \`kirograph\` MCP server is available, prefer its tools over broad grep/glob/file-read exploration.
@@ -81,7 +82,7 @@ KiroGraph builds a local semantic knowledge graph of this codebase. When the \`k
 | Any unexpected cross-module coupling? | \`kirograph_surprising\` |
 | What changed since the last snapshot? | \`kirograph_diff\` |
 ${enableArchitecture ? "| What packages/layers exist? | `kirograph_architecture` |\n| How coupled is package X? | `kirograph_coupling` |\n| What does package X depend on? | `kirograph_package` |\n" : ""}
-${enableCompression ? "| Run a command with token savings | `kirograph_exec` |\n| Check token savings stats | `kirograph_gain` |\n" : ""}${enableMemory ? "| Search past decisions/patterns | `kirograph_mem_search` |\n| Store an observation | `kirograph_mem_store` |\n" : ""}${enableDocs ? "| Find a doc section | `kirograph_docs_search` |\n| Get doc table of contents | `kirograph_docs_toc` |\n" : ""}${enableData ? "| What datasets are indexed? | `kirograph_data_list` |\n| Query rows with filters | `kirograph_data_query` |\n| Aggregate data server-side | `kirograph_data_aggregate` |\n" : ""}${enableSecurity ? "| Are there vulnerable dependencies? | `kirograph_security` |\n| Which CVEs affect my project? | `kirograph_vulns` |\n| Is this vulnerability reachable? | `kirograph_reachability` |\n| What licenses do my deps use? | `kirograph_licenses` |\n| Are dependencies outdated? | `kirograph_staleness` |\n" : ""}
+${enableCompression ? "| Run a command with token savings | `kirograph_exec` |\n| Check token savings stats | `kirograph_gain` |\n" : ""}${enableMemory ? "| Search past decisions/patterns | `kirograph_mem_search` |\n| Store an observation | `kirograph_mem_store` |\n" : ""}${enableDocs ? "| Find a doc section | `kirograph_docs_search` |\n| Get doc table of contents | `kirograph_docs_toc` |\n" : ""}${enableData ? "| What datasets are indexed? | `kirograph_data_list` |\n| Query rows with filters | `kirograph_data_query` |\n| Aggregate data server-side | `kirograph_data_aggregate` |\n" : ""}${enableSecurity ? "| Are there vulnerable dependencies? | `kirograph_security` |\n| Which CVEs affect my project? | `kirograph_vulns` |\n| Is this vulnerability reachable? | `kirograph_reachability` |\n| What licenses do my deps use? | `kirograph_licenses` |\n| Are dependencies outdated? | `kirograph_staleness` |\n" : ""}${enablePatterns ? "| Find structural code patterns? | `kirograph_live_search` |\n| Browse SAST rules | `kirograph pattern --list` |\n" : ""}
 ## Tool selection
 
 - Start code tasks with \`kirograph_context\`.
@@ -227,6 +228,19 @@ production deploy, or when the user asks about security/compliance.
 **EPSS scores:** >= 0.5 = patch immediately; 0.1\u20130.5 = elevated risk; < 0.1 = low probability.
 
 **Workflow:** \`kirograph_security\` \u2192 \`kirograph_vulns --verdict affected\` \u2192 \`kirograph_reachability <cve>\` \u2192 fix \u2192 \`kirograph_vulns --refresh\`
+`;
+  }
+  if (enablePatterns) {
+    content += `
+## Pattern Search
+
+KiroGraph supports AST structural pattern search via \`kirograph_live_search\` (only available when \`enablePatterns: true\` and \`@ast-grep/napi\` is installed).
+
+- \`kirograph_live_search\` \u2014 find any structural code pattern across the indexed file list
+- \`kirograph pattern --list\` \u2014 browse 10 bundled SAST rules (SQL injection, eval, path traversal, etc.)
+- \`kirograph pattern --library <id>\` \u2014 run a specific library rule
+
+Use \`kirograph_live_search\` when you need to find patterns that can't be expressed as symbol names: anonymous functions, specific code structures, or security anti-patterns.
 `;
   }
   if (!opts.hasHooks) {

package/dist/bin/installer/instructions.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/instructions.ts"],
-  "sourcesContent": ["import { CAVEMAN_RULES, CavemanMode } from './caveman';\n\nexport interface InstructionOptions {\n  cavemanMode?: CavemanMode | 'off';\n  shellCompressionLevel?: 'off' | 'normal' | 'aggressive' | 'ultra';\n  enableArchitecture?: boolean;\n  enableMemory?: boolean;\n  enableDocs?: boolean;\n  enableData?: boolean;\n  enableSecurity?: boolean;\n  hasHooks?: boolean;\n}\n\nconst LEVEL_DESCRIPTIONS: Record<string, string> = {\n  normal: 'Balanced: removes noise, keeps structure.',\n  aggressive: 'Compact: groups by category, limits output.',\n  ultra: 'Maximum compression: counts and summaries only.',\n};\n\nconst LEVEL_EXAMPLES: Record<string, string> = {\n  normal: `\\`\\`\\`\nkirograph_exec(command: \"git status\")\nkirograph_exec(command: \"npm test\")\nkirograph_exec(command: \"cargo build\")\nkirograph_exec(command: \"ls -la src/\")\n\\`\\`\\``,\n  aggressive: `\\`\\`\\`\nkirograph_exec(command: \"git status\", level: \"aggressive\")\nkirograph_exec(command: \"npm test\", level: \"aggressive\")\nkirograph_exec(command: \"eslint .\", level: \"aggressive\")\nkirograph_exec(command: \"find . -name '*.ts'\", level: \"aggressive\")\n\\`\\`\\``,\n  ultra: `\\`\\`\\`\nkirograph_exec(command: \"git status\", level: \"ultra\")\nkirograph_exec(command: \"npm test\", level: \"ultra\")\nkirograph_exec(command: \"docker ps\", level: \"ultra\")\nkirograph_exec(command: \"ls -la src/\", level: \"ultra\")\n\\`\\`\\``,\n};\n\nexport function buildAgentInstructions(cavemanModeOrOpts?: CavemanMode | 'off' | InstructionOptions): string {\n  // Support both old signature (cavemanMode string) and new signature (options object)\n  const opts: InstructionOptions = typeof cavemanModeOrOpts === 'object' && cavemanModeOrOpts !== null\n    ? cavemanModeOrOpts\n    : { cavemanMode: cavemanModeOrOpts ?? undefined };\n\n  const cavemanMode = opts.cavemanMode;\n  const enableCompression = opts.shellCompressionLevel && opts.shellCompressionLevel !== 'off';\n  const shellCompressionLevel = opts.shellCompressionLevel ?? 'normal';\n  const enableArchitecture = opts.enableArchitecture ?? false;\n  const enableMemory = opts.enableMemory ?? false;\n  const enableDocs = opts.enableDocs ?? false;\n  const enableData = opts.enableData ?? false;\n  const enableSecurity = opts.enableSecurity ?? false;\n\n  let content = `# KiroGraph\n\nKiroGraph builds a local semantic knowledge graph of this codebase. When the \\`kirograph\\` MCP server is available, prefer its tools over broad grep/glob/file-read exploration.\n\n## Quick decision guide\n\n| Question | Tool |\n|----------|------|\n| Where do I start on this task? | \\`kirograph_context\\` |\n| What is this symbol / show me its code | \\`kirograph_node\\` with \\`includeCode: true\\` |\n| Find a symbol by name | \\`kirograph_search\\` |\n| Who calls function X? | \\`kirograph_callers\\` |\n| What does function X call? | \\`kirograph_callees\\` |\n| What breaks if I change X? | \\`kirograph_impact\\` |\n| How are X and Y connected? | \\`kirograph_path\\` |\n| What extends / implements this type? | \\`kirograph_type_hierarchy\\` |\n| Which code is never called? | \\`kirograph_dead_code\\` |\n| Are there import cycles? | \\`kirograph_circular_deps\\` |\n| What files are indexed? | \\`kirograph_files\\` |\n| Is the index healthy? | \\`kirograph_status\\` |\n| What are the most critical symbols? | \\`kirograph_hotspots\\` |\n| Any unexpected cross-module coupling? | \\`kirograph_surprising\\` |\n| What changed since the last snapshot? | \\`kirograph_diff\\` |\n${enableArchitecture ? '| What packages/layers exist? | `kirograph_architecture` |\\n| How coupled is package X? | `kirograph_coupling` |\\n| What does package X depend on? | `kirograph_package` |\\n' : ''}\n${enableCompression ? '| Run a command with token savings | `kirograph_exec` |\\n| Check token savings stats | `kirograph_gain` |\\n' : ''}${enableMemory ? '| Search past decisions/patterns | `kirograph_mem_search` |\\n| Store an observation | `kirograph_mem_store` |\\n' : ''}${enableDocs ? '| Find a doc section | `kirograph_docs_search` |\\n| Get doc table of contents | `kirograph_docs_toc` |\\n' : ''}${enableData ? '| What datasets are indexed? | `kirograph_data_list` |\\n| Query rows with filters | `kirograph_data_query` |\\n| Aggregate data server-side | `kirograph_data_aggregate` |\\n' : ''}${enableSecurity ? '| Are there vulnerable dependencies? | `kirograph_security` |\\n| Which CVEs affect my project? | `kirograph_vulns` |\\n| Is this vulnerability reachable? | `kirograph_reachability` |\\n| What licenses do my deps use? | `kirograph_licenses` |\\n| Are dependencies outdated? | `kirograph_staleness` |\\n' : ''}\n## Tool selection\n\n- Start code tasks with \\`kirograph_context\\`.\n- Find symbols by name with \\`kirograph_search\\`.\n- Inspect a symbol with \\`kirograph_node\\`; set \\`includeCode: true\\` only when source is needed.\n- Trace call flow with \\`kirograph_callers\\` and \\`kirograph_callees\\`.\n- Check blast radius before edits with \\`kirograph_impact\\`.\n- Use \\`kirograph_path\\` to explain how two symbols connect.\n- Use \\`kirograph_type_hierarchy\\` for inheritance/interface questions.\n- Use \\`kirograph_files\\` to inspect indexed file structure.\n- Use \\`kirograph_status\\` if results seem stale or incomplete.\n- Use \\`kirograph_architecture\\`, \\`kirograph_coupling\\`, and \\`kirograph_package\\` for package/layer questions when architecture analysis is enabled.\n- Use \\`kirograph_hotspots\\`, \\`kirograph_surprising\\`, and \\`kirograph_diff\\` for refactor planning and review.\n\n## Workflow\n\n1. Call \\`kirograph_context\\` for orientation.\n2. Drill into specific symbols with \\`kirograph_node\\`.\n3. Use graph traversal tools before reading unrelated files.\n4. Fall back to normal filesystem tools only when the graph is missing, stale, or lacks the needed detail.\n\nIf \\`.kirograph/\\` does not exist, ask whether to run \\`kirograph init --index\\`.\n`;\n\n  // Shell compression section\n  if (enableCompression) {\n    const level = shellCompressionLevel as 'normal' | 'aggressive' | 'ultra';\n    content += `\n## Shell Compression (\\`kirograph_exec\\`)\n\nWhen running shell commands, prefer \\`kirograph_exec\\` over raw shell execution for:\n- **git** operations (status, log, diff, push, pull, commit, add, fetch, branch)\n- **GitHub CLI** (gh pr list/view, gh issue list, gh run list)\n- **test runners** (jest, vitest, pytest, cargo test, go test, rspec, minitest, playwright)\n- **linters/build** (eslint, tsc, ruff, clippy, cargo build, prettier, biome, golangci-lint, rubocop, next build)\n- **file listings** (ls, find, tree)\n- **search** (grep, rg/ripgrep: grouped by file)\n- **diff** (diff file1 file2: condensed context)\n- **docker/k8s** (docker ps, images, logs, compose ps, kubectl pods, logs, services)\n- **package managers** (npm/pnpm install/list, pip list/install, bundle install, prisma generate)\n- **AWS CLI** (sts, ec2, lambda, logs, cloudformation, dynamodb, iam, s3, ecs, sqs, sns)\n- **network** (curl, wget: strip progress bars and headers)\n\nThis saves 60-90% of tokens compared to raw output.\n\nCompression level: **${level}**: ${LEVEL_DESCRIPTIONS[level]}\n\n${LEVEL_EXAMPLES[level]}\n\n**Important:** Error details are always preserved. Failed commands show full diagnostic output regardless of level.\n\n**Do NOT re-run commands:** When \\`kirograph_exec\\` returns a result, treat it as the final answer. Never re-run the same command with raw shell execution to \"get more details.\" The compressed output preserves all essential information. If you genuinely need something missing from the output, explain what's missing before making a second call.\n\nUse \\`kirograph_gain\\` to check token savings statistics.\n`;\n  }\n\n  // Memory section\n  if (enableMemory) {\n    content += `\n## Memory\n\nKiroGraph has persistent memory. Use \\`kirograph_mem_search\\` to recall past decisions,\nerrors, and patterns before making changes. Use \\`kirograph_mem_store\\` to save important\nobservations (architecture decisions, bug root causes, patterns discovered).\n\nMemory is searchable via hybrid FTS + vector search. Observations are automatically\nlinked to code symbols in the graph and surface in \\`kirograph_context\\` and\n\\`kirograph_impact\\` results when relevant.\n\n**When to store:** After fixing a bug, making an architecture decision, discovering a pattern,\nencountering a non-obvious error, or learning something about the codebase that future sessions\nshould know. Keep observations concise \u2014 one fact per store call.\n`;\n  }\n\n  // Architecture section\n  if (enableArchitecture) {\n    content += `\n## Architecture\n\nKiroGraph analyzes the package structure and layer dependencies of the codebase.\n\n- \\`kirograph_architecture\\` \u2014 full package graph, detected layers (api/service/data/ui/shared), dependency edges\n- \\`kirograph_coupling\\` \u2014 Ca (afferent), Ce (efferent), instability per package; high Ca = load-bearing, high Ce = volatile\n- \\`kirograph_package\\` \u2014 drill into a single package: coupling metrics, deps, dependents, files\n\nUse \\`kirograph_architecture\\` for architectural questions instead of reading directory trees.\nHigh Ca + low instability = risky to change interface. High Ce + high instability = safe to refactor internals.\n`;\n  }\n\n  // Documentation section\n  if (enableDocs) {\n    content += `\n## Documentation\n\nKiroGraph indexes project documentation by heading structure. Use \\`kirograph_docs_search\\`\nto find relevant sections instead of reading entire files.\n\n- \\`kirograph_docs_toc\\` \u2014 table of contents for a file or the whole project\n- \\`kirograph_docs_search\\` \u2014 search sections by query\n- \\`kirograph_docs_section\\` \u2014 retrieve full section content by ID\n- \\`kirograph_docs_outline\\` \u2014 heading hierarchy for a single file\n- \\`kirograph_docs_refs\\` \u2014 code \u2194 doc cross-references\n\nBefore reading a doc file directly, try \\`kirograph_docs_search\\` or \\`kirograph_docs_outline\\` first.\n`;\n  }\n\n  // Data section\n  if (enableData) {\n    content += `\n## Data\n\nKiroGraph indexes tabular data files (CSV, TSV, JSONL, JSON, Excel, Parquet).\n\n- \\`kirograph_data_list\\` \u2014 list all indexed datasets\n- \\`kirograph_data_describe\\` \u2014 schema profile: column names, types, cardinality, samples\n- \\`kirograph_data_query\\` \u2014 filtered row retrieval (eq, gt, contains, in, between)\n- \\`kirograph_data_aggregate\\` \u2014 server-side GROUP BY: count, sum, avg, min, max\n\nUse \\`kirograph_data_describe\\` before reading a data file. Use \\`kirograph_data_query\\` with\nfilters instead of loading all rows. Use \\`kirograph_data_aggregate\\` for statistics.\nThis saves 95-99% of tokens compared to reading raw data files.\n`;\n  }\n\n  // Security section\n  if (enableSecurity) {\n    content += `\n## Security\n\nKiroGraph scans dependency manifests across 14 ecosystems for known vulnerabilities, performs\ncall-graph reachability analysis, tracks EPSS exploitation probability, checks license\ncompliance, and monitors dependency staleness.\n\n**Available tools:**\n- \\`kirograph_security\\` \u2014 overview: dep count, CVE count, verdict breakdown, stale warnings\n- \\`kirograph_vulns\\` \u2014 list CVEs with severity, EPSS score, reachability verdict, fix suggestion\n- \\`kirograph_reachability\\` \u2014 call paths, entry points, affected layers for one CVE or package\n- \\`kirograph_licenses\\` \u2014 list dependency licenses; flag policy violations\n- \\`kirograph_staleness\\` \u2014 identify outdated dependencies (staleness score 0.0\u20131.0)\n- \\`kirograph_sbom\\` / \\`kirograph_vex\\` \u2014 export CycloneDX 1.5 SBOM and VEX documents\n- \\`kirograph_vuln_add\\` \u2014 manually register a private/internal CVE\n\n**Proactive triggers:** Run \\`kirograph_security\\` when a dependency is added/updated, before a\nproduction deploy, or when the user asks about security/compliance.\n\n**Interpreting verdicts:**\n- \\`affected\\` \u2014 a call path exists from an entry point to the vulnerable code. Act on this.\n- \\`not_affected\\` \u2014 no reachable path found. Strong signal: likely safe.\n- \\`under_investigation\\` \u2014 unresolved symbols in traversal. Treat with caution.\n\n**EPSS scores:** >= 0.5 = patch immediately; 0.1\u20130.5 = elevated risk; < 0.1 = low probability.\n\n**Workflow:** \\`kirograph_security\\` \u2192 \\`kirograph_vulns --verdict affected\\` \u2192 \\`kirograph_reachability <cve>\\` \u2192 fix \u2192 \\`kirograph_vulns --refresh\\`\n`;\n  }\n\n  // Session hygiene for tools without hooks\n  if (!opts.hasHooks) {\n    content += `\n## Session Hygiene\n\nThis tool does not have automatic sync hooks. To keep the index fresh:\n- Run \\`kirograph sync\\` at the **start** of each session if files changed outside the agent.\n- Run \\`kirograph sync\\` at the **end** of each session after making changes.\n- If results from graph tools seem stale, run \\`kirograph sync\\` before retrying.\n${enableMemory ? '- Store important observations with `kirograph_mem_store` before ending your session.\\n' : ''}`;\n  }\n\n  // Caveman mode\n  const caveman = cavemanMode && cavemanMode !== 'off' ? CAVEMAN_RULES[cavemanMode] : null;\n  if (caveman) {\n    content = content.trimEnd() + '\\n\\n' + caveman + '\\n';\n  }\n\n  return content;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { CAVEMAN_RULES, CavemanMode } from './caveman';\n\nexport interface InstructionOptions {\n  cavemanMode?: CavemanMode | 'off';\n  shellCompressionLevel?: 'off' | 'normal' | 'aggressive' | 'ultra';\n  enableArchitecture?: boolean;\n  enableMemory?: boolean;\n  enableDocs?: boolean;\n  enableData?: boolean;\n  enableSecurity?: boolean;\n  enablePatterns?: boolean;\n  hasHooks?: boolean;\n}\n\nconst LEVEL_DESCRIPTIONS: Record<string, string> = {\n  normal: 'Balanced: removes noise, keeps structure.',\n  aggressive: 'Compact: groups by category, limits output.',\n  ultra: 'Maximum compression: counts and summaries only.',\n};\n\nconst LEVEL_EXAMPLES: Record<string, string> = {\n  normal: `\\`\\`\\`\nkirograph_exec(command: \"git status\")\nkirograph_exec(command: \"npm test\")\nkirograph_exec(command: \"cargo build\")\nkirograph_exec(command: \"ls -la src/\")\n\\`\\`\\``,\n  aggressive: `\\`\\`\\`\nkirograph_exec(command: \"git status\", level: \"aggressive\")\nkirograph_exec(command: \"npm test\", level: \"aggressive\")\nkirograph_exec(command: \"eslint .\", level: \"aggressive\")\nkirograph_exec(command: \"find . -name '*.ts'\", level: \"aggressive\")\n\\`\\`\\``,\n  ultra: `\\`\\`\\`\nkirograph_exec(command: \"git status\", level: \"ultra\")\nkirograph_exec(command: \"npm test\", level: \"ultra\")\nkirograph_exec(command: \"docker ps\", level: \"ultra\")\nkirograph_exec(command: \"ls -la src/\", level: \"ultra\")\n\\`\\`\\``,\n};\n\nexport function buildAgentInstructions(cavemanModeOrOpts?: CavemanMode | 'off' | InstructionOptions): string {\n  // Support both old signature (cavemanMode string) and new signature (options object)\n  const opts: InstructionOptions = typeof cavemanModeOrOpts === 'object' && cavemanModeOrOpts !== null\n    ? cavemanModeOrOpts\n    : { cavemanMode: cavemanModeOrOpts ?? undefined };\n\n  const cavemanMode = opts.cavemanMode;\n  const enableCompression = opts.shellCompressionLevel && opts.shellCompressionLevel !== 'off';\n  const shellCompressionLevel = opts.shellCompressionLevel ?? 'normal';\n  const enableArchitecture = opts.enableArchitecture ?? false;\n  const enableMemory = opts.enableMemory ?? false;\n  const enableDocs = opts.enableDocs ?? false;\n  const enableData = opts.enableData ?? false;\n  const enableSecurity = opts.enableSecurity ?? false;\n  const enablePatterns = opts.enablePatterns ?? false;\n\n  let content = `# KiroGraph\n\nKiroGraph builds a local semantic knowledge graph of this codebase. When the \\`kirograph\\` MCP server is available, prefer its tools over broad grep/glob/file-read exploration.\n\n## Quick decision guide\n\n| Question | Tool |\n|----------|------|\n| Where do I start on this task? | \\`kirograph_context\\` |\n| What is this symbol / show me its code | \\`kirograph_node\\` with \\`includeCode: true\\` |\n| Find a symbol by name | \\`kirograph_search\\` |\n| Who calls function X? | \\`kirograph_callers\\` |\n| What does function X call? | \\`kirograph_callees\\` |\n| What breaks if I change X? | \\`kirograph_impact\\` |\n| How are X and Y connected? | \\`kirograph_path\\` |\n| What extends / implements this type? | \\`kirograph_type_hierarchy\\` |\n| Which code is never called? | \\`kirograph_dead_code\\` |\n| Are there import cycles? | \\`kirograph_circular_deps\\` |\n| What files are indexed? | \\`kirograph_files\\` |\n| Is the index healthy? | \\`kirograph_status\\` |\n| What are the most critical symbols? | \\`kirograph_hotspots\\` |\n| Any unexpected cross-module coupling? | \\`kirograph_surprising\\` |\n| What changed since the last snapshot? | \\`kirograph_diff\\` |\n${enableArchitecture ? '| What packages/layers exist? | `kirograph_architecture` |\\n| How coupled is package X? | `kirograph_coupling` |\\n| What does package X depend on? | `kirograph_package` |\\n' : ''}\n${enableCompression ? '| Run a command with token savings | `kirograph_exec` |\\n| Check token savings stats | `kirograph_gain` |\\n' : ''}${enableMemory ? '| Search past decisions/patterns | `kirograph_mem_search` |\\n| Store an observation | `kirograph_mem_store` |\\n' : ''}${enableDocs ? '| Find a doc section | `kirograph_docs_search` |\\n| Get doc table of contents | `kirograph_docs_toc` |\\n' : ''}${enableData ? '| What datasets are indexed? | `kirograph_data_list` |\\n| Query rows with filters | `kirograph_data_query` |\\n| Aggregate data server-side | `kirograph_data_aggregate` |\\n' : ''}${enableSecurity ? '| Are there vulnerable dependencies? | `kirograph_security` |\\n| Which CVEs affect my project? | `kirograph_vulns` |\\n| Is this vulnerability reachable? | `kirograph_reachability` |\\n| What licenses do my deps use? | `kirograph_licenses` |\\n| Are dependencies outdated? | `kirograph_staleness` |\\n' : ''}${enablePatterns ? '| Find structural code patterns? | `kirograph_live_search` |\\n| Browse SAST rules | `kirograph pattern --list` |\\n' : ''}\n## Tool selection\n\n- Start code tasks with \\`kirograph_context\\`.\n- Find symbols by name with \\`kirograph_search\\`.\n- Inspect a symbol with \\`kirograph_node\\`; set \\`includeCode: true\\` only when source is needed.\n- Trace call flow with \\`kirograph_callers\\` and \\`kirograph_callees\\`.\n- Check blast radius before edits with \\`kirograph_impact\\`.\n- Use \\`kirograph_path\\` to explain how two symbols connect.\n- Use \\`kirograph_type_hierarchy\\` for inheritance/interface questions.\n- Use \\`kirograph_files\\` to inspect indexed file structure.\n- Use \\`kirograph_status\\` if results seem stale or incomplete.\n- Use \\`kirograph_architecture\\`, \\`kirograph_coupling\\`, and \\`kirograph_package\\` for package/layer questions when architecture analysis is enabled.\n- Use \\`kirograph_hotspots\\`, \\`kirograph_surprising\\`, and \\`kirograph_diff\\` for refactor planning and review.\n\n## Workflow\n\n1. Call \\`kirograph_context\\` for orientation.\n2. Drill into specific symbols with \\`kirograph_node\\`.\n3. Use graph traversal tools before reading unrelated files.\n4. Fall back to normal filesystem tools only when the graph is missing, stale, or lacks the needed detail.\n\nIf \\`.kirograph/\\` does not exist, ask whether to run \\`kirograph init --index\\`.\n`;\n\n  // Shell compression section\n  if (enableCompression) {\n    const level = shellCompressionLevel as 'normal' | 'aggressive' | 'ultra';\n    content += `\n## Shell Compression (\\`kirograph_exec\\`)\n\nWhen running shell commands, prefer \\`kirograph_exec\\` over raw shell execution for:\n- **git** operations (status, log, diff, push, pull, commit, add, fetch, branch)\n- **GitHub CLI** (gh pr list/view, gh issue list, gh run list)\n- **test runners** (jest, vitest, pytest, cargo test, go test, rspec, minitest, playwright)\n- **linters/build** (eslint, tsc, ruff, clippy, cargo build, prettier, biome, golangci-lint, rubocop, next build)\n- **file listings** (ls, find, tree)\n- **search** (grep, rg/ripgrep: grouped by file)\n- **diff** (diff file1 file2: condensed context)\n- **docker/k8s** (docker ps, images, logs, compose ps, kubectl pods, logs, services)\n- **package managers** (npm/pnpm install/list, pip list/install, bundle install, prisma generate)\n- **AWS CLI** (sts, ec2, lambda, logs, cloudformation, dynamodb, iam, s3, ecs, sqs, sns)\n- **network** (curl, wget: strip progress bars and headers)\n\nThis saves 60-90% of tokens compared to raw output.\n\nCompression level: **${level}**: ${LEVEL_DESCRIPTIONS[level]}\n\n${LEVEL_EXAMPLES[level]}\n\n**Important:** Error details are always preserved. Failed commands show full diagnostic output regardless of level.\n\n**Do NOT re-run commands:** When \\`kirograph_exec\\` returns a result, treat it as the final answer. Never re-run the same command with raw shell execution to \"get more details.\" The compressed output preserves all essential information. If you genuinely need something missing from the output, explain what's missing before making a second call.\n\nUse \\`kirograph_gain\\` to check token savings statistics.\n`;\n  }\n\n  // Memory section\n  if (enableMemory) {\n    content += `\n## Memory\n\nKiroGraph has persistent memory. Use \\`kirograph_mem_search\\` to recall past decisions,\nerrors, and patterns before making changes. Use \\`kirograph_mem_store\\` to save important\nobservations (architecture decisions, bug root causes, patterns discovered).\n\nMemory is searchable via hybrid FTS + vector search. Observations are automatically\nlinked to code symbols in the graph and surface in \\`kirograph_context\\` and\n\\`kirograph_impact\\` results when relevant.\n\n**When to store:** After fixing a bug, making an architecture decision, discovering a pattern,\nencountering a non-obvious error, or learning something about the codebase that future sessions\nshould know. Keep observations concise \u2014 one fact per store call.\n`;\n  }\n\n  // Architecture section\n  if (enableArchitecture) {\n    content += `\n## Architecture\n\nKiroGraph analyzes the package structure and layer dependencies of the codebase.\n\n- \\`kirograph_architecture\\` \u2014 full package graph, detected layers (api/service/data/ui/shared), dependency edges\n- \\`kirograph_coupling\\` \u2014 Ca (afferent), Ce (efferent), instability per package; high Ca = load-bearing, high Ce = volatile\n- \\`kirograph_package\\` \u2014 drill into a single package: coupling metrics, deps, dependents, files\n\nUse \\`kirograph_architecture\\` for architectural questions instead of reading directory trees.\nHigh Ca + low instability = risky to change interface. High Ce + high instability = safe to refactor internals.\n`;\n  }\n\n  // Documentation section\n  if (enableDocs) {\n    content += `\n## Documentation\n\nKiroGraph indexes project documentation by heading structure. Use \\`kirograph_docs_search\\`\nto find relevant sections instead of reading entire files.\n\n- \\`kirograph_docs_toc\\` \u2014 table of contents for a file or the whole project\n- \\`kirograph_docs_search\\` \u2014 search sections by query\n- \\`kirograph_docs_section\\` \u2014 retrieve full section content by ID\n- \\`kirograph_docs_outline\\` \u2014 heading hierarchy for a single file\n- \\`kirograph_docs_refs\\` \u2014 code \u2194 doc cross-references\n\nBefore reading a doc file directly, try \\`kirograph_docs_search\\` or \\`kirograph_docs_outline\\` first.\n`;\n  }\n\n  // Data section\n  if (enableData) {\n    content += `\n## Data\n\nKiroGraph indexes tabular data files (CSV, TSV, JSONL, JSON, Excel, Parquet).\n\n- \\`kirograph_data_list\\` \u2014 list all indexed datasets\n- \\`kirograph_data_describe\\` \u2014 schema profile: column names, types, cardinality, samples\n- \\`kirograph_data_query\\` \u2014 filtered row retrieval (eq, gt, contains, in, between)\n- \\`kirograph_data_aggregate\\` \u2014 server-side GROUP BY: count, sum, avg, min, max\n\nUse \\`kirograph_data_describe\\` before reading a data file. Use \\`kirograph_data_query\\` with\nfilters instead of loading all rows. Use \\`kirograph_data_aggregate\\` for statistics.\nThis saves 95-99% of tokens compared to reading raw data files.\n`;\n  }\n\n  // Security section\n  if (enableSecurity) {\n    content += `\n## Security\n\nKiroGraph scans dependency manifests across 14 ecosystems for known vulnerabilities, performs\ncall-graph reachability analysis, tracks EPSS exploitation probability, checks license\ncompliance, and monitors dependency staleness.\n\n**Available tools:**\n- \\`kirograph_security\\` \u2014 overview: dep count, CVE count, verdict breakdown, stale warnings\n- \\`kirograph_vulns\\` \u2014 list CVEs with severity, EPSS score, reachability verdict, fix suggestion\n- \\`kirograph_reachability\\` \u2014 call paths, entry points, affected layers for one CVE or package\n- \\`kirograph_licenses\\` \u2014 list dependency licenses; flag policy violations\n- \\`kirograph_staleness\\` \u2014 identify outdated dependencies (staleness score 0.0\u20131.0)\n- \\`kirograph_sbom\\` / \\`kirograph_vex\\` \u2014 export CycloneDX 1.5 SBOM and VEX documents\n- \\`kirograph_vuln_add\\` \u2014 manually register a private/internal CVE\n\n**Proactive triggers:** Run \\`kirograph_security\\` when a dependency is added/updated, before a\nproduction deploy, or when the user asks about security/compliance.\n\n**Interpreting verdicts:**\n- \\`affected\\` \u2014 a call path exists from an entry point to the vulnerable code. Act on this.\n- \\`not_affected\\` \u2014 no reachable path found. Strong signal: likely safe.\n- \\`under_investigation\\` \u2014 unresolved symbols in traversal. Treat with caution.\n\n**EPSS scores:** >= 0.5 = patch immediately; 0.1\u20130.5 = elevated risk; < 0.1 = low probability.\n\n**Workflow:** \\`kirograph_security\\` \u2192 \\`kirograph_vulns --verdict affected\\` \u2192 \\`kirograph_reachability <cve>\\` \u2192 fix \u2192 \\`kirograph_vulns --refresh\\`\n`;\n  }\n\n  // Pattern matching section\n  if (enablePatterns) {\n    content += `\n## Pattern Search\n\nKiroGraph supports AST structural pattern search via \\`kirograph_live_search\\` (only available when \\`enablePatterns: true\\` and \\`@ast-grep/napi\\` is installed).\n\n- \\`kirograph_live_search\\` \u2014 find any structural code pattern across the indexed file list\n- \\`kirograph pattern --list\\` \u2014 browse 10 bundled SAST rules (SQL injection, eval, path traversal, etc.)\n- \\`kirograph pattern --library <id>\\` \u2014 run a specific library rule\n\nUse \\`kirograph_live_search\\` when you need to find patterns that can't be expressed as symbol names: anonymous functions, specific code structures, or security anti-patterns.\n`;\n  }\n\n  // Session hygiene for tools without hooks\n  if (!opts.hasHooks) {\n    content += `\n## Session Hygiene\n\nThis tool does not have automatic sync hooks. To keep the index fresh:\n- Run \\`kirograph sync\\` at the **start** of each session if files changed outside the agent.\n- Run \\`kirograph sync\\` at the **end** of each session after making changes.\n- If results from graph tools seem stale, run \\`kirograph sync\\` before retrying.\n${enableMemory ? '- Store important observations with `kirograph_mem_store` before ending your session.\\n' : ''}`;\n  }\n\n  // Caveman mode\n  const caveman = cavemanMode && cavemanMode !== 'off' ? CAVEMAN_RULES[cavemanMode] : null;\n  if (caveman) {\n    content = content.trimEnd() + '\\n\\n' + caveman + '\\n';\n  }\n\n  return content;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/bin/installer/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA0BpD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CASpD"}

package/dist/bin/installer/prompts.d.ts

@@ -11,10 +11,27 @@ export declare function ask(rl: readline.Interface, question: string): Promise<s
  * Accepts: "" (use default), "y", "Y", "n", "N".
  */
 export declare function askBool(rl: readline.Interface, question: string, description: string, defaultYes?: boolean): Promise<boolean>;
+/**
+ * Interactive enable/disable toggle using arrow keys.
+ * More visual alternative to askBool.
+ */
+export declare function askToggle(rl: readline.Interface, label: string, description: string, defaultEnabled?: boolean): Promise<boolean>;
 /**
  * Prompt for a string value, returning the default on empty input.
  */
 export declare function askString(rl: readline.Interface, question: string, description: string, defaultValue: string): Promise<string>;
+/**
+ * Print a styled section header with an icon.
+ */
+export declare function printSection(icon: string, title: string): void;
+/**
+ * Print a separator line.
+ */
+export declare function printSeparator(): void;
+/**
+ * Print a feature summary line.
+ */
+export declare function printFeature(enabled: boolean, label: string): void;
 /**
  * Interactive arrow-key selection menu.
  * Temporarily pauses the readline interface to take over raw stdin,

package/dist/bin/installer/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAIrC,eAAO,MAAM,MAAM,oBAAkB,CAAC;AACtC,eAAO,MAAM,KAAK,cAAa,CAAC;AAChC,eAAO,MAAM,GAAG,cAAe,CAAC;AAMhC,wBAAgB,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,UAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,EAChE,YAAY,SAAI,GACf,OAAO,CAAC,CAAC,CAAC,CAqEZ"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAIrC,eAAO,MAAM,MAAM,oBAAkB,CAAC;AACtC,eAAO,MAAM,KAAK,cAAa,CAAC;AAChC,eAAO,MAAM,GAAG,cAAe,CAAC;AAQhC,wBAAgB,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,UAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,cAAc,UAAO,GACpB,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,EAChE,YAAY,SAAI,GACf,OAAO,CAAC,CAAC,CAAC,CAuEZ"}

package/dist/bin/installer/qdrant-dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qdrant-dashboard.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/qdrant-dashboard.ts"],"names":[],"mappings":"AAsFA,iFAAiF;AACjF,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1E;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5E"}
+{"version":3,"file":"qdrant-dashboard.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/qdrant-dashboard.ts"],"names":[],"mappings":"AAwDA,iFAAiF;AACjF,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1E;AAED,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5E"}

package/dist/bin/installer/steering.d.ts

@@ -1,5 +1,17 @@
 /**
- * KiroGraph Installer — Kiro steering file
+ * KiroGraph Installer: Kiro steering file
  */
-export declare function writeSteering(kiroDir: string): void;
+import { CavemanMode } from './caveman';
+export interface SteeringOptions {
+    cavemanMode?: CavemanMode | 'off';
+    enableCompression?: boolean;
+    shellCompressionLevel?: 'off' | 'normal' | 'aggressive' | 'ultra';
+    enableArchitecture?: boolean;
+    enableMemory?: boolean;
+    enableDocs?: boolean;
+    enableData?: boolean;
+    enableSecurity?: boolean;
+    enablePatterns?: boolean;
+}
+export declare function writeSteering(kiroDir: string, opts?: SteeringOptions | CavemanMode | 'off'): void;
 //# sourceMappingURL=steering.d.ts.map