kirograph 0.17.0 → 0.20.0

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 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        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      } 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        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\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);\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          } 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": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,eAA0B;AAC1B,SAAoB;AACpB,WAAsB;AACtB,2BAA0B;AAC1B,oBAAyC;AACzC,oBAA4B;AAC5B,sBAAoC;AACpC,gBAA2B;AAC3B,qBAA+B;AAC/B,2BAAoC;AACpC,uBAAuC;AACvC,8BAAoD;AAEpD,qBAAmC;AAGnC,eAAsB,aAAa,SAAwB,QAAQ,OAA0B,CAAC,GAAkB;AAC9G,iCAAY;AAEZ,QAAM,KAAK,SAAS,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAEpF,MAAI;AACF,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,gBAAY,mCAAmB,MAAM;AAE3C,YAAQ,IAAI,gBAAgB,GAAG;AAAA,CAAI;AAEnC,QAAI,CAAC,KAAK,KAAK;AACb,YAAM,UAAU,UAAM,0BAAU,IAAI,yBAAyB,UAAU,KAAK,KAAK,2EAA2E;AAC5J,UAAI,CAAC,SAAS;AAAE,gBAAQ,IAAI,cAAc;AAAG,WAAG,MAAM;AAAG;AAAA,MAAQ;AAAA,IACnE,OAAO;AACL,cAAQ,IAAI,8BAA8B,UAAU,KAAK,UAAU;AAAA,IACrE;AACA,YAAQ,IAAI;AAEZ,cAAU,aAAa,GAAG;AAE1B,UAAM,qBAAqB,GAAG,WAAW,KAAK,KAAK,KAAK,YAAY,CAAC;AACrE,QAAI,cAAmC;AACvC,QAAI,wBAAmE;AACvE,QAAI,eAAe;AACnB,QAAI,aAAa;AACjB,QAAI,aAAa;AACjB,QAAI,iBAAiB;AACrB,QAAI,iBAAiB;AACrB,QAAI,qBAAqB;AACzB,QAAI,iBAAiB;AACrB,QAAI,wBAA2C;AAC/C,QAAI,mBAAmB;AACvB,QAAI,qBAAqB;AACzB,QAAI,kBAAkB;AAEtB,QAAI;AACF,UAAI,oBAAoB;AACtB,cAAM,SAAS,UAAM,0BAAW,GAAG;AACnC,sBAAc,OAAO,eAAe;AACpC,gCAAwB,OAAO,yBAAyB;AACxD,uBAAe,OAAO,gBAAgB;AACtC,qBAAa,OAAO,cAAc;AAClC,qBAAc,OAAe,cAAc;AAC3C,yBAAkB,OAAe,kBAAkB;AACnD,yBAAiB,OAAO,kBAAkB;AAC1C,gCAAwB,OAAO,yBAAyB;AACxD,yBAAkB,OAAe,kBAAkB;AACnD,6BAAqB,OAAO,sBAAsB;AAClD,gBAAQ,IAAI,+CAA0C,GAAG,cAAc;AACvE,gBAAQ,IAAI,4BAAuB,OAAO,cAAc,EAAE;AAC1D,gBAAQ,IAAI,8BAAyB,OAAO,gBAAgB,EAAE;AAC9D,gBAAQ,IAAI,gCAA2B,OAAO,kBAAkB,EAAE;AAClE,gBAAQ,IAAI,yBAAoB,WAAW,EAAE;AAC7C,gBAAQ,IAAI,mCAA8B,qBAAqB,EAAE;AACjE,gBAAQ,IAAI,0BAAqB,YAAY,EAAE;AAC/C,gBAAQ,IAAI,wBAAmB,UAAU,EAAE;AAC3C,gBAAQ,IAAI,wBAAmB,UAAU,EAAE;AAC3C,gBAAQ,IAAI,4BAAuB,cAAc,EAAE;AACnD,gBAAQ,IAAI,4BAAuB,cAAc,EAAE;AAAA,MACrD,OAAO;AACL,2BAAmB;AACnB,cAAM,QAAQ,UAAM,0CAAoB,EAAE;AAC1C,kBAAM,4BAAa,KAAK,KAAK;AAC7B,sBAAc,MAAM,eAAe;AACnC,gCAAwB,MAAM,yBAAyB;AACvD,uBAAe,MAAM,gBAAgB;AACrC,qBAAa,MAAM,cAAc;AACjC,qBAAa,MAAM,cAAc;AACjC,yBAAiB,MAAM,kBAAkB;AACzC,yBAAiB,MAAM,kBAAkB;AACzC,6BAAqB,MAAM,sBAAsB;AACjD,yBAAiB,MAAM,kBAAkB;AACzC,gCAAwB,MAAM,yBAAyB;AACvD,6BAAqB,MAAM;AAC3B,0BAAkB,MAAM;AAExB,gBAAQ,IAAI;AAAA,2BAA8B,GAAG,yBAAyB;AACtE,gBAAQ,IAAI,8BAAyB,MAAM,gBAAgB,EAAE;AAC7D,YAAI,oBAAoB,OAAO;AAC7B,kBAAQ,IAAI,4BAAuB,MAAM,cAAc,KAAK,aAAG,IAAI,MAAM,YAAY,QAAQ,eAAK,EAAE;AAAA,QACtG;AACA,YAAI,MAAM,kBAAkB;AAC1B,kBAAQ,IAAI,4BAAuB,MAAM,cAAc,EAAE;AACzD,cAAI,MAAM,mBAAmB,cAAc;AACzC,oBAAQ,IAAI;AAAA,wCAA2C;AACvD,kBAAM,aAAS,gCAAU,OAAO,CAAC,WAAW,kBAAkB,YAAY,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAC9G,gBAAI,OAAO,WAAW,GAAG;AACvB,sBAAQ,IAAI,kDAA6C;AAAA,YAC3D,OAAO;AACL,sBAAQ,KAAK,qCAAgC,OAAO,MAAM,kBAAkB;AAC5E,sBAAQ,KAAK,2CAA2C;AAAA,YAC1D;AAAA,UACF,WAAW,MAAM,mBAAmB,SAAS;AAC3C,oBAAQ,IAAI;AAAA,mCAAsC;AAClD,kBAAM,aAAS,gCAAU,OAAO,CAAC,WAAW,gBAAgB,gCAAgC,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAChI,gBAAI,OAAO,WAAW,GAAG;AACvB,sBAAQ,IAAI,oEAA+D;AAAA,YAC7E,OAAO;AACL,sBAAQ,KAAK,qCAAgC,OAAO,MAAM,kBAAkB;AAC5E,sBAAQ,KAAK,6DAA6D;AAAA,YAC5E;AAAA,UACF,WAAW,MAAM,mBAAmB,UAAU;AAC5C,oBAAQ,IAAI;AAAA,oCAAuC;AACnD,kBAAM,aAAS,gCAAU,OAAO,CAAC,WAAW,sBAAsB,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AACtG,gBAAI,OAAO,WAAW,GAAG;AACvB,sBAAQ,IAAI,yCAAoC;AAAA,YAClD,OAAO;AACL,sBAAQ,KAAK,qCAAgC,OAAO,MAAM,kBAAkB;AAC5E,sBAAQ,KAAK,sCAAsC;AAAA,YACrD;AAAA,UACF,WAAW,MAAM,mBAAmB,WAAW;AAC7C,oBAAQ,IAAI;AAAA,qCAAwC;AACpD,kBAAM,aAAS,gCAAU,OAAO,CAAC,WAAW,kBAAkB,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAClG,gBAAI,OAAO,WAAW,GAAG;AACvB,sBAAQ,IAAI,qCAAgC;AAAA,YAC9C,OAAO;AACL,sBAAQ,KAAK,qCAAgC,OAAO,MAAM,kBAAkB;AAC5E,sBAAQ,KAAK,kCAAkC;AAAA,YACjD;AAAA,UACF,WAAW,MAAM,mBAAmB,UAAU;AAC5C,oBAAQ,IAAI;AAAA,oCAAuC;AACnD,kBAAM,aAAS,gCAAU,OAAO,CAAC,WAAW,cAAc,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAC9F,gBAAI,OAAO,WAAW,GAAG;AACvB,sBAAQ,IAAI,iCAA4B;AAAA,YAC1C,OAAO;AACL,sBAAQ,KAAK,qCAAgC,OAAO,MAAM,kBAAkB;AAC5E,sBAAQ,KAAK,8BAA8B;AAAA,YAC7C;AAAA,UACF,WAAW,MAAM,mBAAmB,aAAa;AAC/C,oBAAQ,IAAI;AAAA,uCAA0C;AACtD,kBAAM,aAAS,gCAAU,OAAO,CAAC,WAAW,WAAW,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAC3F,gBAAI,OAAO,WAAW,GAAG;AACvB,sBAAQ,IAAI,8BAAyB;AACrC,sBAAQ,IAAI,oFAA+E;AAAA,YAC7F,OAAO;AACL,sBAAQ,KAAK,qCAAgC,OAAO,MAAM,kBAAkB;AAC5E,sBAAQ,KAAK,2BAA2B;AAAA,YAC1C;AAAA,UACF;AAAA,QACF;AACA,gBAAQ,IAAI,+BAA0B,MAAM,iBAAiB,EAAE;AAC/D,gBAAQ,IAAI,4BAAuB,MAAM,cAAc,EAAE;AACzD,gBAAQ,IAAI,gCAA2B,MAAM,kBAAkB,EAAE;AACjE,gBAAQ,IAAI,yBAAoB,WAAW,EAAE;AAC7C,gBAAQ,IAAI,mCAA8B,qBAAqB,EAAE;AACjE,gBAAQ,IAAI,0BAAqB,YAAY,EAAE;AAC/C,gBAAQ,IAAI,wBAAmB,UAAU,EAAE;AAC3C,gBAAQ,IAAI,wBAAmB,UAAU,EAAE;AAC3C,gBAAQ,IAAI,4BAAuB,cAAc,EAAE;AACnD,gBAAQ,IAAI,4BAAuB,cAAc,EAAE;AAGnD,YAAI,YAAY;AACd,cAAK,MAAc,kBAAkB;AACnC,oBAAQ,IAAI;AAAA,qBAAwB;AACpC,kBAAM,iBAAa,gCAAU,OAAO,CAAC,WAAW,MAAM,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAC1F,gBAAI,WAAW,WAAW,GAAG;AAC3B,sBAAQ,IAAI,yBAAoB;AAAA,YAClC,OAAO;AACL,sBAAQ,KAAK,6DAAwD;AAAA,YACvE;AAAA,UACF;AACA,cAAK,MAAc,oBAAoB;AACrC,oBAAQ,IAAI;AAAA,+BAAkC;AAC9C,kBAAM,eAAW,gCAAU,OAAO,CAAC,WAAW,gBAAgB,GAAG,EAAE,OAAO,WAAW,OAAO,KAAK,CAAC;AAClG,gBAAI,SAAS,WAAW,GAAG;AACzB,sBAAQ,IAAI,mCAA8B;AAAA,YAC5C,OAAO;AACL,sBAAQ,KAAK,uEAAkE;AAAA,YACjF;AAAA,UACF;AAAA,QACF;AAEA,YAAI,gBAAgB;AAClB,kBAAQ,IAAI;AAAA,+BAAkC;AAC9C,gBAAM,oBAAgB,gCAAU,OAAO,CAAC,WAAW,kBAAkB,iBAAiB,GAAG;AAAA,YACvF,OAAO;AAAA,YACP,OAAO;AAAA,UACT,CAAC;AACD,cAAI,cAAc,WAAW,GAAG;AAC9B,oBAAQ,IAAI,mCAA8B;AAAA,UAC5C,OAAO;AACL,oBAAQ,KAAK,kFAA6E;AAC1F,oBAAQ,KAAK,gGAAgG;AAAA,UAC/G;AAAA,QACF;AAAA,MACF;AAEA,gBAAU,YAAY,KAAK,aAAa,uBAAuB,cAAc,YAAY,YAAY,gBAAgB,oBAAoB,gBAAgB,gBAAgB,qBAAqB;AAAA,IAChM,SAAS,KAAK;AACZ,YAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC9D,cAAQ,MAAM;AAAA,0CAAwC,MAAM,EAAE;AAC9D,cAAQ,KAAK,CAAC;AAAA,IAChB;AAGA,QAAI,iBAAiB;AACnB,gBAAM,wCAAe,GAAG;AAAA,IAC1B;AAGA,UAAM,UAAU,qBAAqB,KAAK,OAAO,UAAM,0BAAU,IAAI,0CAA0C,kHAAkH;AACjO,QAAI,SAAS;AACX,YAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAElF,YAAM,YAAY,oBAAI,IAA+C;AACrE,YAAM,gBAAgB,CAAC,MAAc,QAAgB,OAAe,SAAwB;AAC1F,cAAM,QAAQ,UAAU,IAAI,IAAI,KAAK,EAAE,QAAQ,GAAG,OAAO,EAAE;AAC3D,YAAI,QAAQ,EAAG,OAAM,QAAQ;AAC7B,cAAM,SAAS,OAAO,MAAM,QAAQ;AACpC,kBAAU,IAAI,MAAM,KAAK;AAGzB,cAAM,aAAa,MAAM,KAAK,UAAU,OAAO,CAAC,EAAE,OAAO,OAAK,EAAE,QAAQ,CAAC;AACzE,cAAM,cAAc,WAAW,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,QAAQ,CAAC;AAC/D,cAAM,aAAa,WAAW,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,OAAO,CAAC;AAC7D,cAAM,MAAM,aAAa,IAAI,KAAK,IAAK,cAAc,aAAc,KAAK,GAAG,IAAI;AAE/E,cAAM,SAAS,KAAK,MAAM,MAAM,CAAC;AACjC,cAAM,MAAM,SAAI,OAAO,MAAM,IAAI,SAAI,OAAO,KAAK,MAAM;AACvD,cAAM,MAAM,cAAc,OAAO,MAAM,QAAQ,CAAC;AAChD,cAAM,WAAW,aAAa,OAAO,MAAM,QAAQ,CAAC;AACpD,gBAAQ,OAAO,MAAM,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,OAAO,QAAQ;AAAA,MAC9F;AAGA,YAAM,sBAAsB,QAAQ,OAAO,MAAM,KAAK,QAAQ,MAAM;AACpE,YAAM,eAAe,CAAC,UAAmB,SAA6B;AACpE,cAAM,MAAM,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK;AAC5D,YAAI,IAAI,SAAS,gBAAgB,KAAK,IAAI,SAAS,qBAAqB,EAAG,QAAO;AAClF,eAAQ,oBAAqD,OAAO,GAAG,IAAI;AAAA,MAC7E;AACA,cAAQ,OAAO,QAAQ;AAEvB,UAAI;AACJ,UAAI;AACF,YAAI,CAAC,UAAU,cAAc,GAAG,GAAG;AACjC,kBAAQ,OAAO,MAAM,uCAAkC;AACvD,eAAK,MAAM,UAAU,KAAK,KAAK,QAAW,aAAa;AACvD,kBAAQ,OAAO,MAAM,IAAI;AACzB,kBAAQ,IAAI,8BAAyB;AAAA,QACvC,OAAO;AACL,eAAK,MAAM,UAAU,KAAK,KAAK,aAAa;AAC5C,cAAI,UAAU,OAAO,EAAG,SAAQ,OAAO,MAAM,IAAI;AAAA,QACnD;AAAA,MACF,UAAE;AACA,gBAAQ,OAAO,QAAQ;AAAA,MACzB;AACA,cAAQ,IAAI,eAAe;AAC3B,YAAM,SAAS,MAAM,GAAG,SAAS,EAAE,YAAY,oCAAoB,CAAC;AACpE,cAAQ,OAAO,MAAM,IAAI;AACzB,cAAQ,IAAI,oBAAe,OAAO,YAAY,WAAW,OAAO,YAAY,aAAa,OAAO,YAAY,QAAQ;AACpH,SAAG,MAAM;AAET,UAAI,oBAAoB;AACtB,cAAM,kBAAkB,UAAM,yCAAuB,GAAG;AACxD,gBAAQ,IAAI,KAAK,aAAG,uDAAuD,eAAK,EAAE;AAClF,cAAM,IAAI,QAAc,aAAW;AACjC,kBAAQ,GAAG,UAAU,MAAM;AACzB,gBAAI,iBAAiB;AACnB,8BAAgB,MAAM,MAAM,QAAQ,CAAC;AAAA,YACvC,OAAO;AACL,sBAAQ;AAAA,YACV;AAAA,UACF,CAAC;AAAA,QACH,CAAC;AACD;AAAA,MACF;AAEA,UAAI,iBAAiB;AACnB,kBAAM,6CAAoB,GAAG;AAAA,MAC/B;AAAA,IACF;AAEA,cAAU,eAAe,GAAG;AAAA,EAC9B,UAAE;AACA,OAAG,MAAM;AAAA,EACX;AACF;",
   "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

@@ -22,11 +22,67 @@ __export(instructions_exports, {
 });
 module.exports = __toCommonJS(instructions_exports);
 var import_caveman = require("./caveman");
-function buildAgentInstructions(cavemanMode) {
-  const content = `# KiroGraph
+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 buildAgentInstructions(cavemanModeOrOpts) {
+  const opts = typeof cavemanModeOrOpts === "object" && cavemanModeOrOpts !== null ? cavemanModeOrOpts : { cavemanMode: cavemanModeOrOpts ?? void 0 };
+  const cavemanMode = opts.cavemanMode;
+  const enableCompression = opts.shellCompressionLevel && opts.shellCompressionLevel !== "off";
+  const shellCompressionLevel = opts.shellCompressionLevel ?? "normal";
+  const enableArchitecture = opts.enableArchitecture ?? false;
+  const enableMemory = opts.enableMemory ?? false;
+  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.
 
+## Quick decision guide
+
+| Question | Tool |
+|----------|------|
+| Where do I start on this task? | \`kirograph_context\` |
+| What is this symbol / show me its code | \`kirograph_node\` with \`includeCode: true\` |
+| Find a symbol by name | \`kirograph_search\` |
+| Who calls function X? | \`kirograph_callers\` |
+| What does function X call? | \`kirograph_callees\` |
+| What breaks if I change X? | \`kirograph_impact\` |
+| How are X and Y connected? | \`kirograph_path\` |
+| What extends / implements this type? | \`kirograph_type_hierarchy\` |
+| Which code is never called? | \`kirograph_dead_code\` |
+| Are there import cycles? | \`kirograph_circular_deps\` |
+| What files are indexed? | \`kirograph_files\` |
+| Is the index healthy? | \`kirograph_status\` |
+| What are the most critical symbols? | \`kirograph_hotspots\` |
+| 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" : ""}${enablePatterns ? "| Find structural code patterns? | `kirograph_live_search` |\n| Browse SAST rules | `kirograph pattern --list` |\n" : ""}
 ## Tool selection
 
 - Start code tasks with \`kirograph_context\`.
@@ -50,8 +106,158 @@ KiroGraph builds a local semantic knowledge graph of this codebase. When the \`k
 
 If \`.kirograph/\` does not exist, ask whether to run \`kirograph init --index\`.
 `;
+  if (enableCompression) {
+    const level = shellCompressionLevel;
+    content += `
+## 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.
+`;
+  }
+  if (enableMemory) {
+    content += `
+## Memory
+
+KiroGraph has persistent memory. Use \`kirograph_mem_search\` to recall past decisions,
+errors, and patterns before making changes. Use \`kirograph_mem_store\` to save important
+observations (architecture decisions, bug root causes, patterns discovered).
+
+Memory is searchable via hybrid FTS + vector search. Observations are automatically
+linked to code symbols in the graph and surface in \`kirograph_context\` and
+\`kirograph_impact\` results when relevant.
+
+**When to store:** After fixing a bug, making an architecture decision, discovering a pattern,
+encountering a non-obvious error, or learning something about the codebase that future sessions
+should know. Keep observations concise \u2014 one fact per store call.
+`;
+  }
+  if (enableArchitecture) {
+    content += `
+## Architecture
+
+KiroGraph analyzes the package structure and layer dependencies of the codebase.
+
+- \`kirograph_architecture\` \u2014 full package graph, detected layers (api/service/data/ui/shared), dependency edges
+- \`kirograph_coupling\` \u2014 Ca (afferent), Ce (efferent), instability per package; high Ca = load-bearing, high Ce = volatile
+- \`kirograph_package\` \u2014 drill into a single package: coupling metrics, deps, dependents, files
+
+Use \`kirograph_architecture\` for architectural questions instead of reading directory trees.
+High Ca + low instability = risky to change interface. High Ce + high instability = safe to refactor internals.
+`;
+  }
+  if (enableDocs) {
+    content += `
+## Documentation
+
+KiroGraph indexes project documentation by heading structure. Use \`kirograph_docs_search\`
+to find relevant sections instead of reading entire files.
+
+- \`kirograph_docs_toc\` \u2014 table of contents for a file or the whole project
+- \`kirograph_docs_search\` \u2014 search sections by query
+- \`kirograph_docs_section\` \u2014 retrieve full section content by ID
+- \`kirograph_docs_outline\` \u2014 heading hierarchy for a single file
+- \`kirograph_docs_refs\` \u2014 code \u2194 doc cross-references
+
+Before reading a doc file directly, try \`kirograph_docs_search\` or \`kirograph_docs_outline\` first.
+`;
+  }
+  if (enableData) {
+    content += `
+## Data
+
+KiroGraph indexes tabular data files (CSV, TSV, JSONL, JSON, Excel, Parquet).
+
+- \`kirograph_data_list\` \u2014 list all indexed datasets
+- \`kirograph_data_describe\` \u2014 schema profile: column names, types, cardinality, samples
+- \`kirograph_data_query\` \u2014 filtered row retrieval (eq, gt, contains, in, between)
+- \`kirograph_data_aggregate\` \u2014 server-side GROUP BY: count, sum, avg, min, max
+
+Use \`kirograph_data_describe\` before reading a data file. Use \`kirograph_data_query\` with
+filters instead of loading all rows. Use \`kirograph_data_aggregate\` for statistics.
+This saves 95-99% of tokens compared to reading raw data files.
+`;
+  }
+  if (enableSecurity) {
+    content += `
+## Security
+
+KiroGraph scans dependency manifests across 14 ecosystems for known vulnerabilities, performs
+call-graph reachability analysis, tracks EPSS exploitation probability, checks license
+compliance, and monitors dependency staleness.
+
+**Available tools:**
+- \`kirograph_security\` \u2014 overview: dep count, CVE count, verdict breakdown, stale warnings
+- \`kirograph_vulns\` \u2014 list CVEs with severity, EPSS score, reachability verdict, fix suggestion
+- \`kirograph_reachability\` \u2014 call paths, entry points, affected layers for one CVE or package
+- \`kirograph_licenses\` \u2014 list dependency licenses; flag policy violations
+- \`kirograph_staleness\` \u2014 identify outdated dependencies (staleness score 0.0\u20131.0)
+- \`kirograph_sbom\` / \`kirograph_vex\` \u2014 export CycloneDX 1.5 SBOM and VEX documents
+- \`kirograph_vuln_add\` \u2014 manually register a private/internal CVE
+
+**Proactive triggers:** Run \`kirograph_security\` when a dependency is added/updated, before a
+production deploy, or when the user asks about security/compliance.
+
+**Interpreting verdicts:**
+- \`affected\` \u2014 a call path exists from an entry point to the vulnerable code. Act on this.
+- \`not_affected\` \u2014 no reachable path found. Strong signal: likely safe.
+- \`under_investigation\` \u2014 unresolved symbols in traversal. Treat with caution.
+
+**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) {
+    content += `
+## Session Hygiene
+
+This tool does not have automatic sync hooks. To keep the index fresh:
+- Run \`kirograph sync\` at the **start** of each session if files changed outside the agent.
+- Run \`kirograph sync\` at the **end** of each session after making changes.
+- If results from graph tools seem stale, run \`kirograph sync\` before retrying.
+${enableMemory ? "- Store important observations with `kirograph_mem_store` before ending your session.\n" : ""}`;
+  }
   const caveman = cavemanMode && cavemanMode !== "off" ? import_caveman.CAVEMAN_RULES[cavemanMode] : null;
-  return caveman ? content.trimEnd() + "\n\n" + caveman + "\n" : content;
+  if (caveman) {
+    content = content.trimEnd() + "\n\n" + caveman + "\n";
+  }
+  return content;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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 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;",
+  "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

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

@@ -1 +1 @@
-{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/steering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkEH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMnD"}
+{"version":3,"file":"steering.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/steering.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAiB,WAAW,EAAE,MAAM,WAAW,CAAC;AA8UvD,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,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;CAC1B;AAiMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,KAAK,GAAG,IAAI,CAejG"}