kirograph 0.13.0 → 0.14.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/index.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer for Kiro\n *\n * Wires up:\n *  1. .kiro/settings/mcp.json        \u2014 registers the MCP server (IDE + CLI)\n *  2. .kiro/hooks/*.json             \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 path from 'path';\nimport * as readline from 'readline';\nimport { spawnSync } from 'child_process';\nimport { updateConfig } from '../../config';\nimport { printBanner } from '../banner';\nimport { renderIndexProgress } from '../progress';\nimport { dim, reset } from '../ui';\nimport { ask } from './prompts';\nimport { promptConfigOptions } from './config-prompt';\nimport { writeMcpConfig } from './mcp';\nimport { writeHooks } from './hooks';\nimport { writeSteering } from './steering';\nimport { writeCliAgent } from './cli-agent';\nimport { openTypesenseDashboard } from './dashboard';\nimport { ensureQdrantUI, openQdrantDashboard } from './qdrant-dashboard';\n\nexport async function runInstaller(): 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 kiroDir = path.join(cwd, '.kiro');\n\n    console.log(`  Workspace: ${cwd}\\n`);\n\n    const proceed = await ask(rl, '  Install KiroGraph for this Kiro workspace? (Y/n) ');\n    if (proceed.toLowerCase() === 'n') { console.log('  Cancelled.'); rl.close(); return; }\n    console.log();\n\n    // 1. MCP config\n    writeMcpConfig(kiroDir);\n\n    // 2. IDE hooks\n    writeHooks(kiroDir);\n\n    // 3. Steering written after config prompt (needs cavemanMode) \u2014 deferred below\n\n    // 3b. Prompt for config options and persist\n    const patch = await promptConfigOptions(rl);\n    try {\n      await updateConfig(cwd, patch);\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: ${patch.cavemanMode ?? 'off'}`);\n\n    // 3. Steering + CLI agent \u2014 written here so they include cavemanMode\n    writeSteering(kiroDir, patch.cavemanMode ?? 'off');\n\n    // 4. CLI agent config\n    writeCliAgent(kiroDir);\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 (patch.qdrantDashboard) {\n      await ensureQdrantUI(cwd);\n    }\n\n    // 6. Optionally init + index\n    const doIndex = await ask(rl, '\\n  Initialize and index this project now? (Y/n) ');\n    if (doIndex.toLowerCase() !== 'n') {\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 (patch.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 (patch.qdrantDashboard) {\n        await openQdrantDashboard(cwd);\n      }\n    }\n\n    console.log('\\n  Done! Restart Kiro IDE for the MCP server to load.');\n    console.log('  For Kiro CLI, use the \"kirograph\" agent: kiro-cli --agent kirograph\\n');\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/*.json             \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 } 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 ask(rl, `  Install KiroGraph for ${installer.label}? (Y/n) `);\n    if (proceed.toLowerCase() === 'n') { 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 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        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      } 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        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      }\n\n      installer.installLate(cwd, cavemanMode, shellCompressionLevel);\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 ask(rl, '\\n  Initialize and index this project now? (Y/n) ')).toLowerCase() !== 'n') {\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.js

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var instructions_exports = {};
+__export(instructions_exports, {
+  buildAgentInstructions: () => buildAgentInstructions
+});
+module.exports = __toCommonJS(instructions_exports);
+var import_caveman = require("./caveman");
+function buildAgentInstructions(cavemanMode) {
+  const 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.
+
+## Tool selection
+
+- Start code tasks with \`kirograph_context\`.
+- Find symbols by name with \`kirograph_search\`.
+- Inspect a symbol with \`kirograph_node\`; set \`includeCode: true\` only when source is needed.
+- Trace call flow with \`kirograph_callers\` and \`kirograph_callees\`.
+- Check blast radius before edits with \`kirograph_impact\`.
+- Use \`kirograph_path\` to explain how two symbols connect.
+- Use \`kirograph_type_hierarchy\` for inheritance/interface questions.
+- Use \`kirograph_files\` to inspect indexed file structure.
+- Use \`kirograph_status\` if results seem stale or incomplete.
+- Use \`kirograph_architecture\`, \`kirograph_coupling\`, and \`kirograph_package\` for package/layer questions when architecture analysis is enabled.
+- Use \`kirograph_hotspots\`, \`kirograph_surprising\`, and \`kirograph_diff\` for refactor planning and review.
+
+## Workflow
+
+1. Call \`kirograph_context\` for orientation.
+2. Drill into specific symbols with \`kirograph_node\`.
+3. Use graph traversal tools before reading unrelated files.
+4. Fall back to normal filesystem tools only when the graph is missing, stale, or lacks the needed detail.
+
+If \`.kirograph/\` does not exist, ask whether to run \`kirograph init --index\`.
+`;
+  const caveman = cavemanMode && cavemanMode !== "off" ? import_caveman.CAVEMAN_RULES[cavemanMode] : null;
+  return caveman ? content.trimEnd() + "\n\n" + caveman + "\n" : content;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildAgentInstructions
+});
+//# sourceMappingURL=instructions.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/installer/instructions.ts"],
+  "sourcesContent": ["import { CAVEMAN_RULES, CavemanMode } from './caveman';\n\nexport function buildAgentInstructions(cavemanMode?: CavemanMode | 'off'): string {\n  const 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## 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  const caveman = cavemanMode && cavemanMode !== 'off' ? CAVEMAN_RULES[cavemanMode] : null;\n  return caveman ? content.trimEnd() + '\\n\\n' + caveman + '\\n' : content;\n}\n\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA2C;AAEpC,SAAS,uBAAuB,aAA2C;AAChF,QAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BhB,QAAM,UAAU,eAAe,gBAAgB,QAAQ,6BAAc,WAAW,IAAI;AACpF,SAAO,UAAU,QAAQ,QAAQ,IAAI,SAAS,UAAU,OAAO;AACjE;",
+  "names": []
+}

package/dist/bin/installer/mcp.js

@@ -31,46 +31,16 @@ __export(mcp_exports, {
   writeMcpConfig: () => writeMcpConfig
 });
 module.exports = __toCommonJS(mcp_exports);
-var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
-function ensureDir(p) {
-  fs.mkdirSync(p, { recursive: true });
-}
-function readJson(p) {
-  try {
-    return JSON.parse(fs.readFileSync(p, "utf8"));
-  } catch {
-    return {};
-  }
-}
-function writeJson(p, data) {
-  fs.writeFileSync(p, JSON.stringify(data, null, 2) + "\n");
-}
+var import_common = require("./common");
 function writeMcpConfig(kiroDir) {
   const mcpPath = path.join(kiroDir, "settings", "mcp.json");
-  ensureDir(path.dirname(mcpPath));
-  const existing = readJson(mcpPath);
-  existing.mcpServers = existing.mcpServers ?? {};
-  existing.mcpServers.kirograph = {
-    command: "kirograph",
-    args: ["serve", "--mcp"],
+  (0, import_common.writeMcpServersConfig)(mcpPath, {
+    command: import_common.KIROGRAPH_COMMAND,
+    args: import_common.KIROGRAPH_MCP_ARGS,
     disabled: false,
-    autoApprove: [
-      "kirograph_search",
-      "kirograph_context",
-      "kirograph_callers",
-      "kirograph_callees",
-      "kirograph_impact",
-      "kirograph_node",
-      "kirograph_status",
-      "kirograph_files",
-      "kirograph_dead_code",
-      "kirograph_circular_deps",
-      "kirograph_path",
-      "kirograph_type_hierarchy"
-    ]
-  };
-  writeJson(mcpPath, existing);
+    autoApprove: import_common.KIROGRAPH_TOOLS
+  });
   console.log(`  \u2713 MCP server registered in ${mcpPath}`);
 }
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/mcp.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 MCP server registration\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nfunction readJson(p: string): any {\n  try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch { return {}; }\n}\n\nfunction writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nexport function writeMcpConfig(kiroDir: string): void {\n  const mcpPath = path.join(kiroDir, 'settings', 'mcp.json');\n  ensureDir(path.dirname(mcpPath));\n  const existing = readJson(mcpPath);\n  existing.mcpServers = existing.mcpServers ?? {};\n  existing.mcpServers.kirograph = {\n    command: 'kirograph',\n    args: ['serve', '--mcp'],\n    disabled: false,\n    autoApprove: [\n      'kirograph_search',\n      'kirograph_context',\n      'kirograph_callers',\n      'kirograph_callees',\n      'kirograph_impact',\n      'kirograph_node',\n      'kirograph_status',\n      'kirograph_files',\n      'kirograph_dead_code',\n      'kirograph_circular_deps',\n      'kirograph_path',\n      'kirograph_type_hierarchy',\n    ],\n  };\n  writeJson(mcpPath, existing);\n  console.log(`  \u2713 MCP server registered in ${mcpPath}`);\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,SAAoB;AACpB,WAAsB;AAEtB,SAAS,UAAU,GAAiB;AAClC,KAAG,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACrC;AAEA,SAAS,SAAS,GAAgB;AAChC,MAAI;AAAE,WAAO,KAAK,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAAA,EAAG,QAAQ;AAAE,WAAO,CAAC;AAAA,EAAG;AAC5E;AAEA,SAAS,UAAU,GAAW,MAAqB;AACjD,KAAG,cAAc,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,IAAI;AAC1D;AAEO,SAAS,eAAe,SAAuB;AACpD,QAAM,UAAU,KAAK,KAAK,SAAS,YAAY,UAAU;AACzD,YAAU,KAAK,QAAQ,OAAO,CAAC;AAC/B,QAAM,WAAW,SAAS,OAAO;AACjC,WAAS,aAAa,SAAS,cAAc,CAAC;AAC9C,WAAS,WAAW,YAAY;AAAA,IAC9B,SAAS;AAAA,IACT,MAAM,CAAC,SAAS,OAAO;AAAA,IACvB,UAAU;AAAA,IACV,aAAa;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,YAAU,SAAS,QAAQ;AAC3B,UAAQ,IAAI,qCAAgC,OAAO,EAAE;AACvD;",
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 MCP server registration\n */\n\nimport * as path from 'path';\nimport { KIROGRAPH_COMMAND, KIROGRAPH_MCP_ARGS, KIROGRAPH_TOOLS, writeMcpServersConfig } from './common';\n\nexport function writeMcpConfig(kiroDir: string): void {\n  const mcpPath = path.join(kiroDir, 'settings', 'mcp.json');\n  writeMcpServersConfig(mcpPath, {\n    command: KIROGRAPH_COMMAND,\n    args: KIROGRAPH_MCP_ARGS,\n    disabled: false,\n    autoApprove: KIROGRAPH_TOOLS,\n  });\n  console.log(`  \u2713 MCP server registered in ${mcpPath}`);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,WAAsB;AACtB,oBAA8F;AAEvF,SAAS,eAAe,SAAuB;AACpD,QAAM,UAAU,KAAK,KAAK,SAAS,YAAY,UAAU;AACzD,2CAAsB,SAAS;AAAA,IAC7B,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,aAAa;AAAA,EACf,CAAC;AACD,UAAQ,IAAI,qCAAgC,OAAO,EAAE;AACvD;",
   "names": []
 }

package/dist/bin/installer/steering.js

@@ -64,12 +64,14 @@ KiroGraph builds a semantic knowledge graph of your codebase. Use its MCP tools
 | What packages/layers exist? | \`kirograph_architecture\` |
 | How coupled is package X? | \`kirograph_coupling\` |
 | What does package X depend on? | \`kirograph_package\` |
+| Run a command with token savings | \`kirograph_exec\` |
+| Check token savings stats | \`kirograph_gain\` |
 
 ---
 
 ## Tool reference
 
-### \`kirograph_context\` \u2014 **start here for any code task**
+### \`kirograph_context\`: **start here for any code task**
 
 Returns entry points, related symbols, and code snippets for a natural-language task description. Usually enough to orient without any additional tool calls.
 
@@ -79,7 +81,7 @@ kirograph_context(task: "add dark mode", maxNodes: 30)
 kirograph_context(task: "refactor payment service", includeCode: false)
 \`\`\`
 
-### \`kirograph_search\` \u2014 find symbols by name
+### \`kirograph_search\`: find symbols by name
 
 Exact match \u2192 FTS \u2192 LIKE fallback \u2192 vector (last resort). Use instead of grep.
 
@@ -91,7 +93,7 @@ kirograph_search(query: "auth", limit: 20)
 
 Supported kinds: \`function\`, \`method\`, \`class\`, \`interface\`, \`type_alias\`, \`variable\`, \`route\`, \`component\`
 
-### \`kirograph_node\` \u2014 inspect a symbol
+### \`kirograph_node\`: inspect a symbol
 
 Returns kind, file, signature, docstring. Add \`includeCode: true\` to get the full source.
 
@@ -100,7 +102,7 @@ kirograph_node(symbol: "validateToken")
 kirograph_node(symbol: "AuthService", includeCode: true)
 \`\`\`
 
-### \`kirograph_callers\` \u2014 who calls this?
+### \`kirograph_callers\`: who calls this?
 
 BFS over incoming \`calls\` edges (depth 1).
 
@@ -108,7 +110,7 @@ BFS over incoming \`calls\` edges (depth 1).
 kirograph_callers(symbol: "processPayment", limit: 30)
 \`\`\`
 
-### \`kirograph_callees\` \u2014 what does this call?
+### \`kirograph_callees\`: what does this call?
 
 BFS over outgoing \`calls\` edges (depth 1).
 
@@ -116,7 +118,7 @@ BFS over outgoing \`calls\` edges (depth 1).
 kirograph_callees(symbol: "handleRequest")
 \`\`\`
 
-### \`kirograph_impact\` \u2014 blast radius before a change
+### \`kirograph_impact\`: blast radius before a change
 
 Traverses all incoming edges up to \`depth\` hops. Call this before editing a symbol.
 
@@ -124,7 +126,7 @@ Traverses all incoming edges up to \`depth\` hops. Call this before editing a sy
 kirograph_impact(symbol: "UserRepository", depth: 3)
 \`\`\`
 
-### \`kirograph_path\` \u2014 how are two symbols connected?
+### \`kirograph_path\`: how are two symbols connected?
 
 BFS shortest path across all edge types.
 
@@ -132,7 +134,7 @@ BFS shortest path across all edge types.
 kirograph_path(from: "LoginController", to: "DatabasePool")
 \`\`\`
 
-### \`kirograph_type_hierarchy\` \u2014 class/interface inheritance
+### \`kirograph_type_hierarchy\`: class/interface inheritance
 
 \`\`\`
 kirograph_type_hierarchy(symbol: "BaseRepository", direction: "down")  // derived types
@@ -140,7 +142,7 @@ kirograph_type_hierarchy(symbol: "PaymentService", direction: "up")    // base t
 kirograph_type_hierarchy(symbol: "IUserStore", direction: "both")      // all
 \`\`\`
 
-### \`kirograph_dead_code\` \u2014 unreferenced symbols
+### \`kirograph_dead_code\`: unreferenced symbols
 
 Returns unexported symbols with zero incoming edges. Good first step when cleaning up.
 
@@ -148,7 +150,7 @@ Returns unexported symbols with zero incoming edges. Good first step when cleani
 kirograph_dead_code(limit: 50)
 \`\`\`
 
-### \`kirograph_circular_deps\` \u2014 import cycles
+### \`kirograph_circular_deps\`: import cycles
 
 Runs Tarjan's SCC over import edges. No parameters needed.
 
@@ -156,7 +158,7 @@ Runs Tarjan's SCC over import edges. No parameters needed.
 kirograph_circular_deps()
 \`\`\`
 
-### \`kirograph_files\` \u2014 indexed file structure
+### \`kirograph_files\`: indexed file structure
 
 \`\`\`
 kirograph_files(format: "tree")                          // default
@@ -166,11 +168,11 @@ kirograph_files(filterPath: "src/auth", maxDepth: 2)
 kirograph_files(pattern: "**/*.test.ts")
 \`\`\`
 
-### \`kirograph_status\` \u2014 index health
+### \`kirograph_status\`: index health
 
 Returns file count, symbol count, edge count, embedding coverage, DB size. Call when something feels off.
 
-### \`kirograph_hotspots\` \u2014 most-connected symbols
+### \`kirograph_hotspots\`: most-connected symbols
 
 Returns the top-N symbols by total edge degree (in + out, excluding structural \`contains\` edges). Use to find core abstractions, identify high blast-radius symbols before a refactor, or understand what the codebase revolves around.
 
@@ -178,7 +180,7 @@ Returns the top-N symbols by total edge degree (in + out, excluding structural \
 kirograph_hotspots(limit: 20)
 \`\`\`
 
-### \`kirograph_surprising\` \u2014 unexpected cross-module coupling
+### \`kirograph_surprising\`: unexpected cross-module coupling
 
 Finds direct edges between symbols in structurally distant files, scored by path distance \xD7 edge-kind weight. Use before a refactor to discover hidden dependencies that will break. High score = more unexpected.
 
@@ -186,9 +188,9 @@ Finds direct edges between symbols in structurally distant files, scored by path
 kirograph_surprising(limit: 20)
 \`\`\`
 
-### \`kirograph_diff\` \u2014 what changed since a snapshot?
+### \`kirograph_diff\`: what changed since a snapshot?
 
-Compares the current graph against a saved snapshot. Shows added/removed symbols and edges. A snapshot must exist \u2014 the user saves one with \`kirograph snapshot save <label>\` before making changes.
+Compares the current graph against a saved snapshot. Shows added/removed symbols and edges. A snapshot must exist: the user saves one with \`kirograph snapshot save <label>\` before making changes.
 
 \`\`\`
 kirograph_diff()                              // vs latest snapshot
@@ -199,7 +201,7 @@ kirograph_diff(snapshot: "pre-refactor")     // vs named snapshot
 
 ## Architecture tools *(require \`enableArchitecture: true\` in config)*
 
-### \`kirograph_architecture\` \u2014 **start here for architectural questions**
+### \`kirograph_architecture\`: **start here for architectural questions**
 
 Returns the full package graph, detected layers (api/service/data/ui/shared), and their dependency edges.
 
@@ -210,9 +212,9 @@ kirograph_architecture(level: "layers")
 kirograph_architecture(includeFiles: true)  // add file\u2192package assignments
 \`\`\`
 
-### \`kirograph_coupling\` \u2014 stability metrics per package
+### \`kirograph_coupling\`: stability metrics per package
 
-Returns Ca (afferent \u2014 depended on by), Ce (efferent \u2014 depends on), and instability (Ce/(Ca+Ce)).
+Returns Ca (afferent: depended on by), Ce (efferent: depends on), and instability (Ce/(Ca+Ce)).
 - High Ca + low instability = load-bearing, safe to depend on, risky to change interface.
 - High Ce + high instability = depends on many things, safe to refactor internals.
 
@@ -222,7 +224,7 @@ kirograph_coupling(sortBy: "afferent")     // most depended-on first
 kirograph_coupling(sortBy: "efferent")     // most outgoing deps first
 \`\`\`
 
-### \`kirograph_package\` \u2014 drill into one package
+### \`kirograph_package\`: drill into one package
 
 Returns metadata, coupling metrics, outgoing deps, incoming dependents, and file list.
 
@@ -236,27 +238,27 @@ kirograph_package(package: "src/services", includeFiles: false)
 ## Workflows
 
 **Bug fix or feature:**
-1. \`kirograph_context\` \u2014 orient, find entry points.
-2. \`kirograph_node\` with \`includeCode: true\` \u2014 read the relevant symbol.
-3. \`kirograph_callers\` / \`kirograph_callees\` \u2014 trace the call flow.
-4. \`kirograph_impact\` \u2014 check blast radius before editing.
+1. \`kirograph_context\`: orient, find entry points.
+2. \`kirograph_node\` with \`includeCode: true\`: read the relevant symbol.
+3. \`kirograph_callers\` / \`kirograph_callees\`: trace the call flow.
+4. \`kirograph_impact\`: check blast radius before editing.
 
 **Refactor planning:**
-1. \`kirograph_hotspots\` \u2014 identify the most-connected symbols; changing these is risky.
-2. \`kirograph_surprising\` \u2014 surface hidden coupling that will break.
-3. \`kirograph_impact\` on specific targets \u2014 confirm blast radius.
-4. \`kirograph_diff\` after the refactor \u2014 verify the structural change matches intent.
+1. \`kirograph_hotspots\`: identify the most-connected symbols; changing these is risky.
+2. \`kirograph_surprising\`: surface hidden coupling that will break.
+3. \`kirograph_impact\` on specific targets: confirm blast radius.
+4. \`kirograph_diff\` after the refactor: verify the structural change matches intent.
 
 **Architectural review:**
-1. \`kirograph_architecture\` \u2014 get the package and layer map.
-2. \`kirograph_coupling\` \u2014 find the most stable (high Ca) and most volatile (high instability) packages.
-3. \`kirograph_package\` \u2014 drill into any package of interest.
-4. \`kirograph_circular_deps\` \u2014 check for import cycles.
+1. \`kirograph_architecture\`: get the package and layer map.
+2. \`kirograph_coupling\`: find the most stable (high Ca) and most volatile (high instability) packages.
+3. \`kirograph_package\`: drill into any package of interest.
+4. \`kirograph_circular_deps\`: check for import cycles.
 
 **Code cleanup:**
-1. \`kirograph_dead_code\` \u2014 find unreferenced unexported symbols.
-2. \`kirograph_circular_deps\` \u2014 find import cycles to untangle.
-3. \`kirograph_surprising\` \u2014 find unexpected coupling to decouple.
+1. \`kirograph_dead_code\`: find unreferenced unexported symbols.
+2. \`kirograph_circular_deps\`: find import cycles to untangle.
+3. \`kirograph_surprising\`: find unexpected coupling to decouple.
 
 ---
 
@@ -264,16 +266,90 @@ kirograph_package(package: "src/services", includeFiles: false)
 
 Ask the user: "This project doesn't have KiroGraph initialized. Run \`kirograph init -i\` to build a code knowledge graph for faster exploration?"
 `;
-function buildSteeringContent(cavemanMode) {
+const LEVEL_DESCRIPTIONS = {
+  normal: "Balanced: removes noise, keeps structure.",
+  aggressive: "Compact: groups by category, limits output.",
+  ultra: "Maximum compression: counts and summaries only."
+};
+const LEVEL_EXAMPLES = {
+  normal: `\\\`\\\`\\\`
+kirograph_exec(command: "git status")
+kirograph_exec(command: "npm test")
+kirograph_exec(command: "cargo build")
+kirograph_exec(command: "ls -la src/")
+\\\`\\\`\\\``,
+  aggressive: `\\\`\\\`\\\`
+kirograph_exec(command: "git status", level: "aggressive")
+kirograph_exec(command: "npm test", level: "aggressive")
+kirograph_exec(command: "eslint .", level: "aggressive")
+kirograph_exec(command: "find . -name '*.ts'", level: "aggressive")
+\\\`\\\`\\\``,
+  ultra: `\\\`\\\`\\\`
+kirograph_exec(command: "git status", level: "ultra")
+kirograph_exec(command: "npm test", level: "ultra")
+kirograph_exec(command: "docker ps", level: "ultra")
+kirograph_exec(command: "ls -la src/", level: "ultra")
+\\\`\\\`\\\``
+};
+function buildCompressionSection(level) {
+  return `
+---
+
+## Shell Compression (\\\`kirograph_exec\\\`)
+
+When running shell commands, prefer \\\`kirograph_exec\\\` over raw shell execution for:
+- **git** operations (status, log, diff, push, pull, commit, add, fetch, branch)
+- **GitHub CLI** (gh pr list/view, gh issue list, gh run list)
+- **test runners** (jest, vitest, pytest, cargo test, go test, rspec, minitest, playwright)
+- **linters/build** (eslint, tsc, ruff, clippy, cargo build, prettier, biome, golangci-lint, rubocop, next build)
+- **file listings** (ls, find, tree)
+- **search** (grep, rg/ripgrep: grouped by file)
+- **diff** (diff file1 file2: condensed context)
+- **docker/k8s** (docker ps, images, logs, compose ps, kubectl pods, logs, services)
+- **package managers** (npm/pnpm install/list, pip list/install, bundle install, prisma generate)
+- **AWS CLI** (sts, ec2, lambda, logs, cloudformation, dynamodb, iam, s3, ecs, sqs, sns)
+- **network** (curl, wget: strip progress bars and headers)
+
+This saves 60-90% of tokens compared to raw output.
+
+Compression level: **${level}**: ${LEVEL_DESCRIPTIONS[level]}
+
+${LEVEL_EXAMPLES[level]}
+
+**Important:** Error details are always preserved. Failed commands show full diagnostic output regardless of level.
+
+**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.
+
+Use \\\`kirograph_gain\\\` to check token savings statistics.`;
+}
+function buildSteeringContent(opts) {
+  const cavemanMode = opts?.cavemanMode;
+  const enableCompression = opts?.enableCompression !== false && opts?.shellCompressionLevel !== "off";
+  const shellCompressionLevel = opts?.shellCompressionLevel ?? "normal";
+  let content = STEERING_CONTENT;
+  if (enableCompression && shellCompressionLevel !== "off") {
+    const section = buildCompressionSection(shellCompressionLevel);
+    content = content.replace(
+      "---\n\n## If `.kirograph/` does NOT exist",
+      section.trim() + "\n\n---\n\n## If `.kirograph/` does NOT exist"
+    );
+  }
+  if (!enableCompression) {
+    content = content.replace("| Run a command with token savings | `kirograph_exec` |\n", "");
+    content = content.replace("| Check token savings stats | `kirograph_gain` |\n", "");
+  }
   const caveman = cavemanMode && cavemanMode !== "off" ? import_caveman.CAVEMAN_RULES[cavemanMode] : null;
-  if (!caveman) return STEERING_CONTENT;
-  return STEERING_CONTENT.trimEnd() + "\n\n" + caveman + "\n";
+  if (caveman) {
+    content = content.trimEnd() + "\n\n" + caveman + "\n";
+  }
+  return content;
 }
-function writeSteering(kiroDir, cavemanMode) {
+function writeSteering(kiroDir, opts) {
   const steeringDir = path.join(kiroDir, "steering");
   fs.mkdirSync(steeringDir, { recursive: true });
   const steeringPath = path.join(steeringDir, "kirograph.md");
-  fs.writeFileSync(steeringPath, buildSteeringContent(cavemanMode));
+  const resolvedOpts = typeof opts === "string" ? { cavemanMode: opts } : opts ?? {};
+  fs.writeFileSync(steeringPath, buildSteeringContent(resolvedOpts));
   console.log(`  \u2713 Steering file written to ${steeringPath}`);
 }
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/steering.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro steering file\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { CAVEMAN_RULES, CavemanMode } from './caveman';\n\nconst STEERING_CONTENT = `---\ninclusion: always\n---\n\n# KiroGraph\n\nKiroGraph builds a semantic knowledge graph of your codebase. Use its MCP tools instead of grep/glob/file reads whenever \\`.kirograph/\\` exists in the project.\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| 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---\n\n## Tool reference\n\n### \\`kirograph_context\\` \u2014 **start here for any code task**\n\nReturns entry points, related symbols, and code snippets for a natural-language task description. Usually enough to orient without any additional tool calls.\n\n\\`\\`\\`\nkirograph_context(task: \"fix the auth token expiry bug\")\nkirograph_context(task: \"add dark mode\", maxNodes: 30)\nkirograph_context(task: \"refactor payment service\", includeCode: false)\n\\`\\`\\`\n\n### \\`kirograph_search\\` \u2014 find symbols by name\n\nExact match \u2192 FTS \u2192 LIKE fallback \u2192 vector (last resort). Use instead of grep.\n\n\\`\\`\\`\nkirograph_search(query: \"signIn\")\nkirograph_search(query: \"UserService\", kind: \"class\")\nkirograph_search(query: \"auth\", limit: 20)\n\\`\\`\\`\n\nSupported kinds: \\`function\\`, \\`method\\`, \\`class\\`, \\`interface\\`, \\`type_alias\\`, \\`variable\\`, \\`route\\`, \\`component\\`\n\n### \\`kirograph_node\\` \u2014 inspect a symbol\n\nReturns kind, file, signature, docstring. Add \\`includeCode: true\\` to get the full source.\n\n\\`\\`\\`\nkirograph_node(symbol: \"validateToken\")\nkirograph_node(symbol: \"AuthService\", includeCode: true)\n\\`\\`\\`\n\n### \\`kirograph_callers\\` \u2014 who calls this?\n\nBFS over incoming \\`calls\\` edges (depth 1).\n\n\\`\\`\\`\nkirograph_callers(symbol: \"processPayment\", limit: 30)\n\\`\\`\\`\n\n### \\`kirograph_callees\\` \u2014 what does this call?\n\nBFS over outgoing \\`calls\\` edges (depth 1).\n\n\\`\\`\\`\nkirograph_callees(symbol: \"handleRequest\")\n\\`\\`\\`\n\n### \\`kirograph_impact\\` \u2014 blast radius before a change\n\nTraverses all incoming edges up to \\`depth\\` hops. Call this before editing a symbol.\n\n\\`\\`\\`\nkirograph_impact(symbol: \"UserRepository\", depth: 3)\n\\`\\`\\`\n\n### \\`kirograph_path\\` \u2014 how are two symbols connected?\n\nBFS shortest path across all edge types.\n\n\\`\\`\\`\nkirograph_path(from: \"LoginController\", to: \"DatabasePool\")\n\\`\\`\\`\n\n### \\`kirograph_type_hierarchy\\` \u2014 class/interface inheritance\n\n\\`\\`\\`\nkirograph_type_hierarchy(symbol: \"BaseRepository\", direction: \"down\")  // derived types\nkirograph_type_hierarchy(symbol: \"PaymentService\", direction: \"up\")    // base types\nkirograph_type_hierarchy(symbol: \"IUserStore\", direction: \"both\")      // all\n\\`\\`\\`\n\n### \\`kirograph_dead_code\\` \u2014 unreferenced symbols\n\nReturns unexported symbols with zero incoming edges. Good first step when cleaning up.\n\n\\`\\`\\`\nkirograph_dead_code(limit: 50)\n\\`\\`\\`\n\n### \\`kirograph_circular_deps\\` \u2014 import cycles\n\nRuns Tarjan's SCC over import edges. No parameters needed.\n\n\\`\\`\\`\nkirograph_circular_deps()\n\\`\\`\\`\n\n### \\`kirograph_files\\` \u2014 indexed file structure\n\n\\`\\`\\`\nkirograph_files(format: \"tree\")                          // default\nkirograph_files(format: \"flat\")                          // one path per line\nkirograph_files(format: \"grouped\")                       // by directory\nkirograph_files(filterPath: \"src/auth\", maxDepth: 2)\nkirograph_files(pattern: \"**/*.test.ts\")\n\\`\\`\\`\n\n### \\`kirograph_status\\` \u2014 index health\n\nReturns file count, symbol count, edge count, embedding coverage, DB size. Call when something feels off.\n\n### \\`kirograph_hotspots\\` \u2014 most-connected symbols\n\nReturns the top-N symbols by total edge degree (in + out, excluding structural \\`contains\\` edges). Use to find core abstractions, identify high blast-radius symbols before a refactor, or understand what the codebase revolves around.\n\n\\`\\`\\`\nkirograph_hotspots(limit: 20)\n\\`\\`\\`\n\n### \\`kirograph_surprising\\` \u2014 unexpected cross-module coupling\n\nFinds direct edges between symbols in structurally distant files, scored by path distance \u00D7 edge-kind weight. Use before a refactor to discover hidden dependencies that will break. High score = more unexpected.\n\n\\`\\`\\`\nkirograph_surprising(limit: 20)\n\\`\\`\\`\n\n### \\`kirograph_diff\\` \u2014 what changed since a snapshot?\n\nCompares the current graph against a saved snapshot. Shows added/removed symbols and edges. A snapshot must exist \u2014 the user saves one with \\`kirograph snapshot save <label>\\` before making changes.\n\n\\`\\`\\`\nkirograph_diff()                              // vs latest snapshot\nkirograph_diff(snapshot: \"pre-refactor\")     // vs named snapshot\n\\`\\`\\`\n\n---\n\n## Architecture tools *(require \\`enableArchitecture: true\\` in config)*\n\n### \\`kirograph_architecture\\` \u2014 **start here for architectural questions**\n\nReturns the full package graph, detected layers (api/service/data/ui/shared), and their dependency edges.\n\n\\`\\`\\`\nkirograph_architecture()                    // packages + layers\nkirograph_architecture(level: \"packages\")\nkirograph_architecture(level: \"layers\")\nkirograph_architecture(includeFiles: true)  // add file\u2192package assignments\n\\`\\`\\`\n\n### \\`kirograph_coupling\\` \u2014 stability metrics per package\n\nReturns Ca (afferent \u2014 depended on by), Ce (efferent \u2014 depends on), and instability (Ce/(Ca+Ce)).\n- High Ca + low instability = load-bearing, safe to depend on, risky to change interface.\n- High Ce + high instability = depends on many things, safe to refactor internals.\n\n\\`\\`\\`\nkirograph_coupling()                        // all packages, sorted by instability\nkirograph_coupling(sortBy: \"afferent\")     // most depended-on first\nkirograph_coupling(sortBy: \"efferent\")     // most outgoing deps first\n\\`\\`\\`\n\n### \\`kirograph_package\\` \u2014 drill into one package\n\nReturns metadata, coupling metrics, outgoing deps, incoming dependents, and file list.\n\n\\`\\`\\`\nkirograph_package(package: \"auth\")\nkirograph_package(package: \"src/services\", includeFiles: false)\n\\`\\`\\`\n\n---\n\n## Workflows\n\n**Bug fix or feature:**\n1. \\`kirograph_context\\` \u2014 orient, find entry points.\n2. \\`kirograph_node\\` with \\`includeCode: true\\` \u2014 read the relevant symbol.\n3. \\`kirograph_callers\\` / \\`kirograph_callees\\` \u2014 trace the call flow.\n4. \\`kirograph_impact\\` \u2014 check blast radius before editing.\n\n**Refactor planning:**\n1. \\`kirograph_hotspots\\` \u2014 identify the most-connected symbols; changing these is risky.\n2. \\`kirograph_surprising\\` \u2014 surface hidden coupling that will break.\n3. \\`kirograph_impact\\` on specific targets \u2014 confirm blast radius.\n4. \\`kirograph_diff\\` after the refactor \u2014 verify the structural change matches intent.\n\n**Architectural review:**\n1. \\`kirograph_architecture\\` \u2014 get the package and layer map.\n2. \\`kirograph_coupling\\` \u2014 find the most stable (high Ca) and most volatile (high instability) packages.\n3. \\`kirograph_package\\` \u2014 drill into any package of interest.\n4. \\`kirograph_circular_deps\\` \u2014 check for import cycles.\n\n**Code cleanup:**\n1. \\`kirograph_dead_code\\` \u2014 find unreferenced unexported symbols.\n2. \\`kirograph_circular_deps\\` \u2014 find import cycles to untangle.\n3. \\`kirograph_surprising\\` \u2014 find unexpected coupling to decouple.\n\n---\n\n## If \\`.kirograph/\\` does NOT exist\n\nAsk the user: \"This project doesn't have KiroGraph initialized. Run \\`kirograph init -i\\` to build a code knowledge graph for faster exploration?\"\n`;\n\nfunction buildSteeringContent(cavemanMode?: CavemanMode | 'off'): string {\n  const caveman = cavemanMode && cavemanMode !== 'off' ? CAVEMAN_RULES[cavemanMode] : null;\n  if (!caveman) return STEERING_CONTENT;\n  return STEERING_CONTENT.trimEnd() + '\\n\\n' + caveman + '\\n';\n}\n\nexport function writeSteering(kiroDir: string, cavemanMode?: CavemanMode | 'off'): void {\n  const steeringDir = path.join(kiroDir, 'steering');\n  fs.mkdirSync(steeringDir, { recursive: true });\n  const steeringPath = path.join(steeringDir, 'kirograph.md');\n  fs.writeFileSync(steeringPath, buildSteeringContent(cavemanMode));\n  console.log(`  \u2713 Steering file written to ${steeringPath}`);\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,SAAoB;AACpB,WAAsB;AACtB,qBAA2C;AAE3C,MAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuOzB,SAAS,qBAAqB,aAA2C;AACvE,QAAM,UAAU,eAAe,gBAAgB,QAAQ,6BAAc,WAAW,IAAI;AACpF,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,iBAAiB,QAAQ,IAAI,SAAS,UAAU;AACzD;AAEO,SAAS,cAAc,SAAiB,aAAyC;AACtF,QAAM,cAAc,KAAK,KAAK,SAAS,UAAU;AACjD,KAAG,UAAU,aAAa,EAAE,WAAW,KAAK,CAAC;AAC7C,QAAM,eAAe,KAAK,KAAK,aAAa,cAAc;AAC1D,KAAG,cAAc,cAAc,qBAAqB,WAAW,CAAC;AAChE,UAAQ,IAAI,qCAAgC,YAAY,EAAE;AAC5D;",
+  "sourcesContent": ["/**\n * KiroGraph Installer: Kiro steering file\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { CAVEMAN_RULES, CavemanMode } from './caveman';\n\nconst STEERING_CONTENT = `---\ninclusion: always\n---\n\n# KiroGraph\n\nKiroGraph builds a semantic knowledge graph of your codebase. Use its MCP tools instead of grep/glob/file reads whenever \\`.kirograph/\\` exists in the project.\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| What packages/layers exist? | \\`kirograph_architecture\\` |\n| How coupled is package X? | \\`kirograph_coupling\\` |\n| What does package X depend on? | \\`kirograph_package\\` |\n| Run a command with token savings | \\`kirograph_exec\\` |\n| Check token savings stats | \\`kirograph_gain\\` |\n\n---\n\n## Tool reference\n\n### \\`kirograph_context\\`: **start here for any code task**\n\nReturns entry points, related symbols, and code snippets for a natural-language task description. Usually enough to orient without any additional tool calls.\n\n\\`\\`\\`\nkirograph_context(task: \"fix the auth token expiry bug\")\nkirograph_context(task: \"add dark mode\", maxNodes: 30)\nkirograph_context(task: \"refactor payment service\", includeCode: false)\n\\`\\`\\`\n\n### \\`kirograph_search\\`: find symbols by name\n\nExact match \u2192 FTS \u2192 LIKE fallback \u2192 vector (last resort). Use instead of grep.\n\n\\`\\`\\`\nkirograph_search(query: \"signIn\")\nkirograph_search(query: \"UserService\", kind: \"class\")\nkirograph_search(query: \"auth\", limit: 20)\n\\`\\`\\`\n\nSupported kinds: \\`function\\`, \\`method\\`, \\`class\\`, \\`interface\\`, \\`type_alias\\`, \\`variable\\`, \\`route\\`, \\`component\\`\n\n### \\`kirograph_node\\`: inspect a symbol\n\nReturns kind, file, signature, docstring. Add \\`includeCode: true\\` to get the full source.\n\n\\`\\`\\`\nkirograph_node(symbol: \"validateToken\")\nkirograph_node(symbol: \"AuthService\", includeCode: true)\n\\`\\`\\`\n\n### \\`kirograph_callers\\`: who calls this?\n\nBFS over incoming \\`calls\\` edges (depth 1).\n\n\\`\\`\\`\nkirograph_callers(symbol: \"processPayment\", limit: 30)\n\\`\\`\\`\n\n### \\`kirograph_callees\\`: what does this call?\n\nBFS over outgoing \\`calls\\` edges (depth 1).\n\n\\`\\`\\`\nkirograph_callees(symbol: \"handleRequest\")\n\\`\\`\\`\n\n### \\`kirograph_impact\\`: blast radius before a change\n\nTraverses all incoming edges up to \\`depth\\` hops. Call this before editing a symbol.\n\n\\`\\`\\`\nkirograph_impact(symbol: \"UserRepository\", depth: 3)\n\\`\\`\\`\n\n### \\`kirograph_path\\`: how are two symbols connected?\n\nBFS shortest path across all edge types.\n\n\\`\\`\\`\nkirograph_path(from: \"LoginController\", to: \"DatabasePool\")\n\\`\\`\\`\n\n### \\`kirograph_type_hierarchy\\`: class/interface inheritance\n\n\\`\\`\\`\nkirograph_type_hierarchy(symbol: \"BaseRepository\", direction: \"down\")  // derived types\nkirograph_type_hierarchy(symbol: \"PaymentService\", direction: \"up\")    // base types\nkirograph_type_hierarchy(symbol: \"IUserStore\", direction: \"both\")      // all\n\\`\\`\\`\n\n### \\`kirograph_dead_code\\`: unreferenced symbols\n\nReturns unexported symbols with zero incoming edges. Good first step when cleaning up.\n\n\\`\\`\\`\nkirograph_dead_code(limit: 50)\n\\`\\`\\`\n\n### \\`kirograph_circular_deps\\`: import cycles\n\nRuns Tarjan's SCC over import edges. No parameters needed.\n\n\\`\\`\\`\nkirograph_circular_deps()\n\\`\\`\\`\n\n### \\`kirograph_files\\`: indexed file structure\n\n\\`\\`\\`\nkirograph_files(format: \"tree\")                          // default\nkirograph_files(format: \"flat\")                          // one path per line\nkirograph_files(format: \"grouped\")                       // by directory\nkirograph_files(filterPath: \"src/auth\", maxDepth: 2)\nkirograph_files(pattern: \"**/*.test.ts\")\n\\`\\`\\`\n\n### \\`kirograph_status\\`: index health\n\nReturns file count, symbol count, edge count, embedding coverage, DB size. Call when something feels off.\n\n### \\`kirograph_hotspots\\`: most-connected symbols\n\nReturns the top-N symbols by total edge degree (in + out, excluding structural \\`contains\\` edges). Use to find core abstractions, identify high blast-radius symbols before a refactor, or understand what the codebase revolves around.\n\n\\`\\`\\`\nkirograph_hotspots(limit: 20)\n\\`\\`\\`\n\n### \\`kirograph_surprising\\`: unexpected cross-module coupling\n\nFinds direct edges between symbols in structurally distant files, scored by path distance \u00D7 edge-kind weight. Use before a refactor to discover hidden dependencies that will break. High score = more unexpected.\n\n\\`\\`\\`\nkirograph_surprising(limit: 20)\n\\`\\`\\`\n\n### \\`kirograph_diff\\`: what changed since a snapshot?\n\nCompares the current graph against a saved snapshot. Shows added/removed symbols and edges. A snapshot must exist: the user saves one with \\`kirograph snapshot save <label>\\` before making changes.\n\n\\`\\`\\`\nkirograph_diff()                              // vs latest snapshot\nkirograph_diff(snapshot: \"pre-refactor\")     // vs named snapshot\n\\`\\`\\`\n\n---\n\n## Architecture tools *(require \\`enableArchitecture: true\\` in config)*\n\n### \\`kirograph_architecture\\`: **start here for architectural questions**\n\nReturns the full package graph, detected layers (api/service/data/ui/shared), and their dependency edges.\n\n\\`\\`\\`\nkirograph_architecture()                    // packages + layers\nkirograph_architecture(level: \"packages\")\nkirograph_architecture(level: \"layers\")\nkirograph_architecture(includeFiles: true)  // add file\u2192package assignments\n\\`\\`\\`\n\n### \\`kirograph_coupling\\`: stability metrics per package\n\nReturns Ca (afferent: depended on by), Ce (efferent: depends on), and instability (Ce/(Ca+Ce)).\n- High Ca + low instability = load-bearing, safe to depend on, risky to change interface.\n- High Ce + high instability = depends on many things, safe to refactor internals.\n\n\\`\\`\\`\nkirograph_coupling()                        // all packages, sorted by instability\nkirograph_coupling(sortBy: \"afferent\")     // most depended-on first\nkirograph_coupling(sortBy: \"efferent\")     // most outgoing deps first\n\\`\\`\\`\n\n### \\`kirograph_package\\`: drill into one package\n\nReturns metadata, coupling metrics, outgoing deps, incoming dependents, and file list.\n\n\\`\\`\\`\nkirograph_package(package: \"auth\")\nkirograph_package(package: \"src/services\", includeFiles: false)\n\\`\\`\\`\n\n---\n\n## Workflows\n\n**Bug fix or feature:**\n1. \\`kirograph_context\\`: orient, find entry points.\n2. \\`kirograph_node\\` with \\`includeCode: true\\`: read the relevant symbol.\n3. \\`kirograph_callers\\` / \\`kirograph_callees\\`: trace the call flow.\n4. \\`kirograph_impact\\`: check blast radius before editing.\n\n**Refactor planning:**\n1. \\`kirograph_hotspots\\`: identify the most-connected symbols; changing these is risky.\n2. \\`kirograph_surprising\\`: surface hidden coupling that will break.\n3. \\`kirograph_impact\\` on specific targets: confirm blast radius.\n4. \\`kirograph_diff\\` after the refactor: verify the structural change matches intent.\n\n**Architectural review:**\n1. \\`kirograph_architecture\\`: get the package and layer map.\n2. \\`kirograph_coupling\\`: find the most stable (high Ca) and most volatile (high instability) packages.\n3. \\`kirograph_package\\`: drill into any package of interest.\n4. \\`kirograph_circular_deps\\`: check for import cycles.\n\n**Code cleanup:**\n1. \\`kirograph_dead_code\\`: find unreferenced unexported symbols.\n2. \\`kirograph_circular_deps\\`: find import cycles to untangle.\n3. \\`kirograph_surprising\\`: find unexpected coupling to decouple.\n\n---\n\n## If \\`.kirograph/\\` does NOT exist\n\nAsk the user: \"This project doesn't have KiroGraph initialized. Run \\`kirograph init -i\\` to build a code knowledge graph for faster exploration?\"\n`;\n\n// \u2500\u2500 Compression section builder (level-aware) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 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\nfunction buildCompressionSection(level: 'normal' | 'aggressive' | 'ultra'): string {\n  return `\n---\n\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\nexport interface SteeringOptions {\n  cavemanMode?: CavemanMode | 'off';\n  enableCompression?: boolean;\n  shellCompressionLevel?: 'off' | 'normal' | 'aggressive' | 'ultra';\n}\n\nfunction buildSteeringContent(opts?: SteeringOptions): string {\n  const cavemanMode = opts?.cavemanMode;\n  const enableCompression = opts?.enableCompression !== false && opts?.shellCompressionLevel !== 'off';\n  const shellCompressionLevel = opts?.shellCompressionLevel ?? 'normal';\n\n  let content = STEERING_CONTENT;\n\n  // Insert compression section before the \"If .kirograph/ does NOT exist\" section\n  if (enableCompression && shellCompressionLevel !== 'off') {\n    const section = buildCompressionSection(shellCompressionLevel as 'normal' | 'aggressive' | 'ultra');\n    content = content.replace(\n      '---\\n\\n## If `.kirograph/` does NOT exist',\n      section.trim() + '\\n\\n---\\n\\n## If `.kirograph/` does NOT exist',\n    );\n  }\n\n  // Remove compression tools from decision guide if disabled\n  if (!enableCompression) {\n    content = content.replace('| Run a command with token savings | `kirograph_exec` |\\n', '');\n    content = content.replace('| Check token savings stats | `kirograph_gain` |\\n', '');\n  }\n\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\nexport function writeSteering(kiroDir: string, opts?: SteeringOptions | CavemanMode | 'off'): void {\n  const steeringDir = path.join(kiroDir, 'steering');\n  fs.mkdirSync(steeringDir, { recursive: true });\n  const steeringPath = path.join(steeringDir, 'kirograph.md');\n\n  // Support both old signature (cavemanMode string) and new signature (options object)\n  const resolvedOpts: SteeringOptions = typeof opts === 'string'\n    ? { cavemanMode: opts }\n    : opts ?? {};\n\n  fs.writeFileSync(steeringPath, buildSteeringContent(resolvedOpts));\n  console.log(`  \u2713 Steering file written to ${steeringPath}`);\n}\n"],
+  "mappings": "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",
   "names": []
 }