kirograph 0.13.1 → 0.14.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/config-prompt.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 configuration prompting\n */\n\nimport * as readline from 'readline';\nimport { KiroGraphConfig } from '../../config';\ntype CavemanMode = 'lite' | 'full' | 'ultra';\nimport { ask, askBool, arrowSelect, dim, reset, violet } from './prompts';\nexport type ConfigPatch = Pick<KiroGraphConfig, 'enableEmbeddings' | 'useVecIndex' | 'semanticEngine' | 'typesenseDashboard' | 'qdrantDashboard' | 'extractDocstrings' | 'trackCallSites' | 'enableArchitecture' | 'cavemanMode'> & { embeddingModel?: string; embeddingDim?: number };\nexport type SemanticEngine = KiroGraphConfig['semanticEngine'];\n\nexport const DEFAULT_EMBEDDING_MODEL = 'nomic-ai/nomic-embed-text-v1.5';\n\n/** Well-known embedding models with their output dimensions. */\nconst PRESET_MODELS = [\n  {\n    value: 'nomic-ai/nomic-embed-text-v1.5',\n    label: 'nomic-embed-text-v1.5',\n    dim: 768,\n    description: '768-dim \u00B7 ~130MB \u00B7 Best quality for code search  (recommended)',\n  },\n  {\n    value: 'onnx-community/embeddinggemma-300m-ONNX',\n    label: 'embeddinggemma-300m',\n    dim: 768,\n    description: '768-dim \u00B7 ~300MB \u00B7 Google Gemma-based, multilingual, 2048-token context',\n  },\n  {\n    value: 'Xenova/all-MiniLM-L6-v2',\n    label: 'all-MiniLM-L6-v2',\n    dim: 384,\n    description: '384-dim \u00B7 ~23MB  \u00B7 Fast and lightweight, lower accuracy',\n  },\n  {\n    value: 'BAAI/bge-base-en-v1.5',\n    label: 'bge-base-en-v1.5',\n    dim: 768,\n    description: '768-dim \u00B7 ~110MB \u00B7 Strong general-purpose alternative to nomic',\n  },\n  {\n    value: '__other__',\n    label: 'Other',\n    dim: 768,\n    description: 'Enter a custom HuggingFace model ID and embedding dimension',\n  },\n] as const;\n\nexport async function promptConfigOptions(rl: readline.Interface): Promise<ConfigPatch> {\n  const enableEmbeddings = await askBool(\n    rl,\n    'Enable semantic embeddings for similarity search? (requires a local embedding model)',\n    'Enables semantic/similarity-based code search. Increases indexing time; the chosen embedding model is downloaded automatically on first use.',\n  );\n\n  const patch: ConfigPatch = { enableEmbeddings, useVecIndex: false, semanticEngine: 'cosine', typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: 'off' };\n\n  if (enableEmbeddings) {\n    // \u2500\u2500 Model selection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    const modelChoice = await arrowSelect<string>(\n      rl,\n      'Choose an embedding model:',\n      PRESET_MODELS.map(m => ({ value: m.value, label: m.label, description: m.description })),\n    );\n\n    let embeddingModel: string;\n    let embeddingDim: number;\n\n    if (modelChoice === '__other__') {\n      console.log(`\\n  ${dim}Enter a HuggingFace model ID in the format org/model-name.${reset}`);\n      while (true) {\n        const raw = (await ask(rl, `  ${violet}Model identifier:${reset} `)).trim();\n        if (raw.includes('/')) { embeddingModel = raw; break; }\n        console.log(`  Expected a HuggingFace model ID in the format org/model-name (e.g. nomic-ai/nomic-embed-text-v1.5).`);\n      }\n      console.log(`\\n  ${dim}Enter the embedding output dimension for this model (check the model card on HuggingFace).${reset}`);\n      while (true) {\n        const raw = (await ask(rl, `  ${violet}Embedding dimension (e.g. 768, 384):${reset} `)).trim();\n        const n = parseInt(raw, 10);\n        if (!isNaN(n) && n > 0) { embeddingDim = n; break; }\n        console.log(`  Expected a positive integer (e.g. 768, 384, 1536).`);\n      }\n    } else {\n      const preset = PRESET_MODELS.find(m => m.value === modelChoice)!;\n      embeddingModel = preset.value;\n      embeddingDim = preset.dim;\n    }\n\n    patch.embeddingModel = embeddingModel;\n    patch.embeddingDim = embeddingDim;\n\n    // \u2500\u2500 Engine selection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    const semanticEngine = await arrowSelect<SemanticEngine>(rl, 'Choose the semantic search engine:', [\n      { value: 'cosine',     label: 'cosine',     description: 'In-process cosine similarity. No extra deps. Best for small/medium projects.' },\n      { value: 'sqlite-vec', label: 'sqlite-vec', description: 'ANN index. Sub-linear search. Best for large codebases. Needs: better-sqlite3, sqlite-vec (native).' },\n      { value: 'orama',      label: 'orama',      description: 'Hybrid search (full-text + vector). Pure JS. Needs: @orama/orama, @orama/plugin-data-persistence.' },\n      { value: 'pglite',     label: 'pglite',     description: 'Hybrid search via PostgreSQL + pgvector. Exact results. Pure WASM. Needs: @electric-sql/pglite.' },\n      { value: 'lancedb',    label: 'lancedb',    description: 'ANN search via LanceDB (Apache Lance columnar format). Pure JS. Needs: @lancedb/lancedb.' },\n      { value: 'qdrant',     label: 'qdrant',     description: 'ANN search via Qdrant embedded binary (HNSW index, Cosine). Needs: qdrant-local.' },\n      { value: 'typesense',  label: 'typesense',  description: 'ANN search via Typesense (auto-downloaded binary, HNSW, Cosine). Needs: typesense.' },\n    ]);\n    patch.semanticEngine = semanticEngine;\n    patch.useVecIndex = semanticEngine === 'sqlite-vec';\n\n    if (semanticEngine === 'typesense') {\n      patch.typesenseDashboard = await askBool(\n        rl,\n        'Open Typesense dashboard after indexing?',\n        'Serves the Typesense Dashboard locally and opens it in your browser after indexing completes.',\n      );\n    }\n\n    if (semanticEngine === 'qdrant') {\n      patch.qdrantDashboard = await askBool(\n        rl,\n        'Open Qdrant dashboard after indexing?',\n        'Downloads the Qdrant Web UI (first time only) and opens it in your browser after indexing completes.',\n      );\n    }\n  }\n\n  patch.extractDocstrings = await askBool(\n    rl,\n    'Extract docstrings from source files?',\n    'Enriches symbol metadata and improves context quality. Slightly increases indexing time.',\n  );\n\n  patch.trackCallSites = await askBool(\n    rl,\n    'Track call sites to enable caller/callee graph traversal?',\n    'Enables the kirograph_callers and kirograph_callees MCP tools for graph traversal. Increases index size.',\n  );\n\n  patch.enableArchitecture = await askBool(\n    rl,\n    'Enable architecture analysis (package graph + layer detection)?',\n    'Detects packages from manifests (package.json, go.mod, Cargo.toml, etc.) and architectural layers (api, service, data, ui, shared) from file structure. Enables kirograph_architecture, kirograph_coupling, and kirograph_package MCP tools.',\n  );\n\n  const cavemanChoice = await arrowSelect(rl, 'Caveman mode \u2014 agent communication style:', [\n    { value: 'off',   label: 'off',   description: 'Normal responses' },\n    { value: 'lite',  label: 'lite',  description: 'Compact, no filler, full sentences' },\n    { value: 'full',  label: 'full',  description: 'Fragments, no articles, short synonyms' },\n    { value: 'ultra', label: 'ultra', description: 'Max compression, abbreviations, \u2192 for causality' },\n  ]);\n  patch.cavemanMode = cavemanChoice as CavemanMode | 'off';\n\n  return patch;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 configuration prompting\n */\n\nimport * as readline from 'readline';\nimport { KiroGraphConfig } from '../../config';\ntype CavemanMode = 'lite' | 'full' | 'ultra';\nimport { ask, askBool, arrowSelect, dim, reset, violet } from './prompts';\nexport type ConfigPatch = Pick<KiroGraphConfig, 'enableEmbeddings' | 'useVecIndex' | 'semanticEngine' | 'typesenseDashboard' | 'qdrantDashboard' | 'extractDocstrings' | 'trackCallSites' | 'enableArchitecture' | 'cavemanMode' | 'shellCompressionLevel'> & { embeddingModel?: string; embeddingDim?: number };\nexport type SemanticEngine = KiroGraphConfig['semanticEngine'];\n\nexport const DEFAULT_EMBEDDING_MODEL = 'nomic-ai/nomic-embed-text-v1.5';\n\n/** Well-known embedding models with their output dimensions. */\nconst PRESET_MODELS = [\n  {\n    value: 'nomic-ai/nomic-embed-text-v1.5',\n    label: 'nomic-embed-text-v1.5',\n    dim: 768,\n    description: '768-dim \u00B7 ~130MB \u00B7 Best quality for code search  (recommended)',\n  },\n  {\n    value: 'onnx-community/embeddinggemma-300m-ONNX',\n    label: 'embeddinggemma-300m',\n    dim: 768,\n    description: '768-dim \u00B7 ~300MB \u00B7 Google Gemma-based, multilingual, 2048-token context',\n  },\n  {\n    value: 'Xenova/all-MiniLM-L6-v2',\n    label: 'all-MiniLM-L6-v2',\n    dim: 384,\n    description: '384-dim \u00B7 ~23MB  \u00B7 Fast and lightweight, lower accuracy',\n  },\n  {\n    value: 'BAAI/bge-base-en-v1.5',\n    label: 'bge-base-en-v1.5',\n    dim: 768,\n    description: '768-dim \u00B7 ~110MB \u00B7 Strong general-purpose alternative to nomic',\n  },\n  {\n    value: '__other__',\n    label: 'Other',\n    dim: 768,\n    description: 'Enter a custom HuggingFace model ID and embedding dimension',\n  },\n] as const;\n\nexport async function promptConfigOptions(rl: readline.Interface): Promise<ConfigPatch> {\n  const enableEmbeddings = await askBool(\n    rl,\n    'Enable semantic embeddings for similarity search? (requires a local embedding model)',\n    'Enables semantic/similarity-based code search. Increases indexing time; the chosen embedding model is downloaded automatically on first use.',\n  );\n\n  const patch: ConfigPatch = { enableEmbeddings, useVecIndex: false, semanticEngine: 'cosine', typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: 'off', shellCompressionLevel: 'normal' };\n\n  if (enableEmbeddings) {\n    // \u2500\u2500 Model selection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    const modelChoice = await arrowSelect<string>(\n      rl,\n      'Choose an embedding model:',\n      PRESET_MODELS.map(m => ({ value: m.value, label: m.label, description: m.description })),\n    );\n\n    let embeddingModel: string;\n    let embeddingDim: number;\n\n    if (modelChoice === '__other__') {\n      console.log(`\\n  ${dim}Enter a HuggingFace model ID in the format org/model-name.${reset}`);\n      while (true) {\n        const raw = (await ask(rl, `  ${violet}Model identifier:${reset} `)).trim();\n        if (raw.includes('/')) { embeddingModel = raw; break; }\n        console.log(`  Expected a HuggingFace model ID in the format org/model-name (e.g. nomic-ai/nomic-embed-text-v1.5).`);\n      }\n      console.log(`\\n  ${dim}Enter the embedding output dimension for this model (check the model card on HuggingFace).${reset}`);\n      while (true) {\n        const raw = (await ask(rl, `  ${violet}Embedding dimension (e.g. 768, 384):${reset} `)).trim();\n        const n = parseInt(raw, 10);\n        if (!isNaN(n) && n > 0) { embeddingDim = n; break; }\n        console.log(`  Expected a positive integer (e.g. 768, 384, 1536).`);\n      }\n    } else {\n      const preset = PRESET_MODELS.find(m => m.value === modelChoice)!;\n      embeddingModel = preset.value;\n      embeddingDim = preset.dim;\n    }\n\n    patch.embeddingModel = embeddingModel;\n    patch.embeddingDim = embeddingDim;\n\n    // \u2500\u2500 Engine selection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    const semanticEngine = await arrowSelect<SemanticEngine>(rl, 'Choose the semantic search engine:', [\n      { value: 'cosine',     label: 'cosine',     description: 'In-process cosine similarity. No extra deps. Best for small/medium projects.' },\n      { value: 'sqlite-vec', label: 'sqlite-vec', description: 'ANN index. Sub-linear search. Best for large codebases. Needs: better-sqlite3, sqlite-vec (native).' },\n      { value: 'orama',      label: 'orama',      description: 'Hybrid search (full-text + vector). Pure JS. Needs: @orama/orama, @orama/plugin-data-persistence.' },\n      { value: 'pglite',     label: 'pglite',     description: 'Hybrid search via PostgreSQL + pgvector. Exact results. Pure WASM. Needs: @electric-sql/pglite.' },\n      { value: 'lancedb',    label: 'lancedb',    description: 'ANN search via LanceDB (Apache Lance columnar format). Pure JS. Needs: @lancedb/lancedb.' },\n      { value: 'qdrant',     label: 'qdrant',     description: 'ANN search via Qdrant embedded binary (HNSW index, Cosine). Needs: qdrant-local.' },\n      { value: 'typesense',  label: 'typesense',  description: 'ANN search via Typesense (auto-downloaded binary, HNSW, Cosine). Needs: typesense.' },\n    ]);\n    patch.semanticEngine = semanticEngine;\n    patch.useVecIndex = semanticEngine === 'sqlite-vec';\n\n    if (semanticEngine === 'typesense') {\n      patch.typesenseDashboard = await askBool(\n        rl,\n        'Open Typesense dashboard after indexing?',\n        'Serves the Typesense Dashboard locally and opens it in your browser after indexing completes.',\n      );\n    }\n\n    if (semanticEngine === 'qdrant') {\n      patch.qdrantDashboard = await askBool(\n        rl,\n        'Open Qdrant dashboard after indexing?',\n        'Downloads the Qdrant Web UI (first time only) and opens it in your browser after indexing completes.',\n      );\n    }\n  }\n\n  patch.extractDocstrings = await askBool(\n    rl,\n    'Extract docstrings from source files?',\n    'Enriches symbol metadata and improves context quality. Slightly increases indexing time.',\n  );\n\n  patch.trackCallSites = await askBool(\n    rl,\n    'Track call sites to enable caller/callee graph traversal?',\n    'Enables the kirograph_callers and kirograph_callees MCP tools for graph traversal. Increases index size.',\n  );\n\n  patch.enableArchitecture = await askBool(\n    rl,\n    'Enable architecture analysis (package graph + layer detection)?',\n    'Detects packages from manifests (package.json, go.mod, Cargo.toml, etc.) and architectural layers (api, service, data, ui, shared) from file structure. Enables kirograph_architecture, kirograph_coupling, and kirograph_package MCP tools.',\n  );\n\n  const cavemanChoice = await arrowSelect(rl, 'Caveman mode: agent communication style:', [\n    { value: 'off',   label: 'off',   description: 'Normal responses' },\n    { value: 'lite',  label: 'lite',  description: 'Compact, no filler, full sentences' },\n    { value: 'full',  label: 'full',  description: 'Fragments, no articles, short synonyms' },\n    { value: 'ultra', label: 'ultra', description: 'Max compression, abbreviations, \u2192 for causality' },\n  ]);\n  patch.cavemanMode = cavemanChoice as CavemanMode | 'off';\n\n  const compressionChoice = await arrowSelect(rl, 'Shell compression: default level for kirograph_exec:', [\n    { value: 'off',        label: 'off',        description: 'No compression hook or steering (tool still available)' },\n    { value: 'normal',     label: 'normal',     description: 'Balanced: removes noise, keeps structure (recommended)' },\n    { value: 'aggressive', label: 'aggressive', description: 'More compact: groups by category, limits output' },\n    { value: 'ultra',      label: 'ultra',      description: 'Maximum compression: counts and summaries only' },\n  ]);\n  patch.shellCompressionLevel = compressionChoice as KiroGraphConfig['shellCompressionLevel'];\n\n  return patch;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,qBAA8D;AAIvD,MAAM,0BAA0B;AAGvC,MAAM,gBAAgB;AAAA,EACpB;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,KAAK;AAAA,IACL,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,KAAK;AAAA,IACL,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,KAAK;AAAA,IACL,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,KAAK;AAAA,IACL,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,KAAK;AAAA,IACL,aAAa;AAAA,EACf;AACF;AAEA,eAAsB,oBAAoB,IAA8C;AACtF,QAAM,mBAAmB,UAAM;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,QAAqB,EAAE,kBAAkB,aAAa,OAAO,gBAAgB,UAAU,oBAAoB,OAAO,iBAAiB,OAAO,mBAAmB,MAAM,gBAAgB,MAAM,oBAAoB,OAAO,aAAa,OAAO,uBAAuB,SAAS;AAE9Q,MAAI,kBAAkB;AAEpB,UAAM,cAAc,UAAM;AAAA,MACxB;AAAA,MACA;AAAA,MACA,cAAc,IAAI,QAAM,EAAE,OAAO,EAAE,OAAO,OAAO,EAAE,OAAO,aAAa,EAAE,YAAY,EAAE;AAAA,IACzF;AAEA,QAAI;AACJ,QAAI;AAEJ,QAAI,gBAAgB,aAAa;AAC/B,cAAQ,IAAI;AAAA,IAAO,kBAAG,6DAA6D,oBAAK,EAAE;AAC1F,aAAO,MAAM;AACX,cAAM,OAAO,UAAM,oBAAI,IAAI,KAAK,qBAAM,oBAAoB,oBAAK,GAAG,GAAG,KAAK;AAC1E,YAAI,IAAI,SAAS,GAAG,GAAG;AAAE,2BAAiB;AAAK;AAAA,QAAO;AACtD,gBAAQ,IAAI,uGAAuG;AAAA,MACrH;AACA,cAAQ,IAAI;AAAA,IAAO,kBAAG,6FAA6F,oBAAK,EAAE;AAC1H,aAAO,MAAM;AACX,cAAM,OAAO,UAAM,oBAAI,IAAI,KAAK,qBAAM,uCAAuC,oBAAK,GAAG,GAAG,KAAK;AAC7F,cAAM,IAAI,SAAS,KAAK,EAAE;AAC1B,YAAI,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG;AAAE,yBAAe;AAAG;AAAA,QAAO;AACnD,gBAAQ,IAAI,sDAAsD;AAAA,MACpE;AAAA,IACF,OAAO;AACL,YAAM,SAAS,cAAc,KAAK,OAAK,EAAE,UAAU,WAAW;AAC9D,uBAAiB,OAAO;AACxB,qBAAe,OAAO;AAAA,IACxB;AAEA,UAAM,iBAAiB;AACvB,UAAM,eAAe;AAGrB,UAAM,iBAAiB,UAAM,4BAA4B,IAAI,sCAAsC;AAAA,MACjG,EAAE,OAAO,UAAc,OAAO,UAAc,aAAa,+EAA+E;AAAA,MACxI,EAAE,OAAO,cAAc,OAAO,cAAc,aAAa,sGAAsG;AAAA,MAC/J,EAAE,OAAO,SAAc,OAAO,SAAc,aAAa,oGAAoG;AAAA,MAC7J,EAAE,OAAO,UAAc,OAAO,UAAc,aAAa,kGAAkG;AAAA,MAC3J,EAAE,OAAO,WAAc,OAAO,WAAc,aAAa,2FAA2F;AAAA,MACpJ,EAAE,OAAO,UAAc,OAAO,UAAc,aAAa,mFAAmF;AAAA,MAC5I,EAAE,OAAO,aAAc,OAAO,aAAc,aAAa,qFAAqF;AAAA,IAChJ,CAAC;AACD,UAAM,iBAAiB;AACvB,UAAM,cAAc,mBAAmB;AAEvC,QAAI,mBAAmB,aAAa;AAClC,YAAM,qBAAqB,UAAM;AAAA,QAC/B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,mBAAmB,UAAU;AAC/B,YAAM,kBAAkB,UAAM;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,oBAAoB,UAAM;AAAA,IAC9B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,iBAAiB,UAAM;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,qBAAqB,UAAM;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,gBAAgB,UAAM,4BAAY,IAAI,4CAA4C;AAAA,IACtF,EAAE,OAAO,OAAS,OAAO,OAAS,aAAa,mBAAmB;AAAA,IAClE,EAAE,OAAO,QAAS,OAAO,QAAS,aAAa,qCAAqC;AAAA,IACpF,EAAE,OAAO,QAAS,OAAO,QAAS,aAAa,yCAAyC;AAAA,IACxF,EAAE,OAAO,SAAS,OAAO,SAAS,aAAa,uDAAkD;AAAA,EACnG,CAAC;AACD,QAAM,cAAc;AAEpB,QAAM,oBAAoB,UAAM,4BAAY,IAAI,wDAAwD;AAAA,IACtG,EAAE,OAAO,OAAc,OAAO,OAAc,aAAa,yDAAyD;AAAA,IAClH,EAAE,OAAO,UAAc,OAAO,UAAc,aAAa,yDAAyD;AAAA,IAClH,EAAE,OAAO,cAAc,OAAO,cAAc,aAAa,kDAAkD;AAAA,IAC3G,EAAE,OAAO,SAAc,OAAO,SAAc,aAAa,iDAAiD;AAAA,EAC5G,CAAC;AACD,QAAM,wBAAwB;AAE9B,SAAO;AACT;",
   "names": []
 }

package/dist/bin/installer/hooks.js

@@ -112,6 +112,19 @@ const HOOKS = [
       when: { type: "agentStop" },
       then: { type: "runCommand", command: "kirograph sync-if-dirty --quiet 2>/dev/null || true" }
     }
+  },
+  {
+    filename: "kirograph-compress-hint.json",
+    hook: {
+      name: "KiroGraph Compression Hint",
+      version: "1.0.0",
+      description: "Remind the agent to use kirograph_exec for shell commands that benefit from token compression (git, gh, test, lint, build, docker, aws, grep).",
+      when: { type: "preToolUse", toolTypes: ["shell"] },
+      then: {
+        type: "askAgent",
+        prompt: "If this shell command is a git operation, GitHub CLI, test runner, linter, build tool, file listing, grep/rg, docker/kubectl, AWS CLI, or package manager command, consider using the kirograph_exec MCP tool instead for 60-90% token savings. The tool compresses output automatically while preserving error details."
+      }
+    }
   }
 ];
 function ensureDir(p) {
@@ -154,7 +167,7 @@ function migrateOnIdleHooks(hooksDir) {
     }
   }
 }
-function writeHooks(kiroDir) {
+function writeHooks(kiroDir, opts) {
   const hooksDir = path.join(kiroDir, "hooks");
   ensureDir(hooksDir);
   migrateOnIdleHooks(hooksDir);
@@ -164,6 +177,11 @@ function writeHooks(kiroDir) {
     if (fs.existsSync(p)) fs.unlinkSync(p);
   }
   for (const { filename, hook } of HOOKS) {
+    if (filename === "kirograph-compress-hint.json" && opts?.enableCompression === false) {
+      const p = path.join(hooksDir, filename);
+      if (fs.existsSync(p)) fs.unlinkSync(p);
+      continue;
+    }
     writeJson(path.join(hooksDir, filename), hook);
   }
   console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/bin/installer/hooks.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro hook file management\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logWarn } from '../../errors';\n\n// \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst FILE_PATTERNS = [\n  '**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx',\n  '**/*.py', '**/*.go', '**/*.rs', '**/*.java',\n  '**/*.cs', '**/*.rb', '**/*.php', '**/*.swift',\n  '**/*.kt', '**/*.dart',\n  '**/*.ex', '**/*.exs',\n  '**/*.scala', '**/*.sc', '**/*.lua', '**/*.zig',\n  '**/*.sh', '**/*.bash', '**/*.ml', '**/*.mli',\n  '**/*.elm', '**/*.sol', '**/*.vue', '**/*.m',\n  '**/*.yaml', '**/*.yml',\n  '**/*.tf', '**/*.tfvars',\n  '**/*.css', '**/*.scss', '**/*.sass',\n  '**/*.html',\n];\n\nconst HOOKS: Array<{ filename: string; hook: object }> = [\n  {\n    filename: 'kirograph-mark-dirty-on-save.json',\n    hook: {\n      name: 'KiroGraph Mark Dirty on Save',\n      version: '1.0.0',\n      description: 'Mark the KiroGraph index as dirty when source files are saved. Sync is deferred to agent idle.',\n      when: { type: 'fileEdited', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph mark-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-mark-dirty-on-create.json',\n    hook: {\n      name: 'KiroGraph Mark Dirty on Create',\n      version: '1.0.0',\n      description: 'Mark the KiroGraph index as dirty when source files are created.',\n      when: { type: 'fileCreated', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph mark-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-sync-on-delete.json',\n    hook: {\n      name: 'KiroGraph Sync on Delete',\n      version: '1.0.0',\n      description: 'Remove deleted files from the KiroGraph index immediately.',\n      when: { type: 'fileDeleted', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph sync-if-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-sync-if-dirty.json',\n    hook: {\n      name: 'KiroGraph Deferred Sync',\n      version: '1.0.0',\n      description: 'Sync the KiroGraph index when the agent is idle and a dirty marker is present. Batches multiple rapid saves into one sync.',\n      when: { type: 'agentStop' },\n      then: { type: 'runCommand', command: 'kirograph sync-if-dirty --quiet 2>/dev/null || true' },\n    },\n  },\n];\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nfunction writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nfunction migrateOnIdleHooks(hooksDir: string): void {\n  if (!fs.existsSync(hooksDir)) return;\n  let files: string[];\n  try {\n    files = fs.readdirSync(hooksDir).filter(f => f.endsWith('.json'));\n  } catch {\n    return;\n  }\n  for (const file of files) {\n    const filePath = path.join(hooksDir, file);\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      logWarn(`KiroGraph installer: could not read hook file ${filePath}`);\n      continue;\n    }\n    let obj: any;\n    try {\n      obj = JSON.parse(raw);\n    } catch {\n      logWarn(`KiroGraph installer: could not parse hook file ${filePath}`);\n      continue;\n    }\n    if (obj?.when?.type === 'onIdle') {\n      obj.when.type = 'agentStop';\n      try {\n        fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\\n');\n      } catch {\n        logWarn(`KiroGraph installer: could not write migrated hook file ${filePath}`);\n      }\n    }\n  }\n}\n\n// \u2500\u2500 Public \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function writeHooks(kiroDir: string): void {\n  const hooksDir = path.join(kiroDir, 'hooks');\n  ensureDir(hooksDir);\n\n  migrateOnIdleHooks(hooksDir);\n\n  const oldHooks = ['kirograph-sync-on-save.json', 'kirograph-sync-on-create.json'];\n  for (const old of oldHooks) {\n    const p = path.join(hooksDir, old);\n    if (fs.existsSync(p)) fs.unlinkSync(p);\n  }\n\n  for (const { filename, hook } of HOOKS) {\n    writeJson(path.join(hooksDir, filename), hook);\n  }\n\n  console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro hook file management\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logWarn } from '../../errors';\n\n// \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nconst FILE_PATTERNS = [\n  '**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx',\n  '**/*.py', '**/*.go', '**/*.rs', '**/*.java',\n  '**/*.cs', '**/*.rb', '**/*.php', '**/*.swift',\n  '**/*.kt', '**/*.dart',\n  '**/*.ex', '**/*.exs',\n  '**/*.scala', '**/*.sc', '**/*.lua', '**/*.zig',\n  '**/*.sh', '**/*.bash', '**/*.ml', '**/*.mli',\n  '**/*.elm', '**/*.sol', '**/*.vue', '**/*.m',\n  '**/*.yaml', '**/*.yml',\n  '**/*.tf', '**/*.tfvars',\n  '**/*.css', '**/*.scss', '**/*.sass',\n  '**/*.html',\n];\n\nconst HOOKS: Array<{ filename: string; hook: object }> = [\n  {\n    filename: 'kirograph-mark-dirty-on-save.json',\n    hook: {\n      name: 'KiroGraph Mark Dirty on Save',\n      version: '1.0.0',\n      description: 'Mark the KiroGraph index as dirty when source files are saved. Sync is deferred to agent idle.',\n      when: { type: 'fileEdited', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph mark-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-mark-dirty-on-create.json',\n    hook: {\n      name: 'KiroGraph Mark Dirty on Create',\n      version: '1.0.0',\n      description: 'Mark the KiroGraph index as dirty when source files are created.',\n      when: { type: 'fileCreated', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph mark-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-sync-on-delete.json',\n    hook: {\n      name: 'KiroGraph Sync on Delete',\n      version: '1.0.0',\n      description: 'Remove deleted files from the KiroGraph index immediately.',\n      when: { type: 'fileDeleted', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph sync-if-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-sync-if-dirty.json',\n    hook: {\n      name: 'KiroGraph Deferred Sync',\n      version: '1.0.0',\n      description: 'Sync the KiroGraph index when the agent is idle and a dirty marker is present. Batches multiple rapid saves into one sync.',\n      when: { type: 'agentStop' },\n      then: { type: 'runCommand', command: 'kirograph sync-if-dirty --quiet 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-compress-hint.json',\n    hook: {\n      name: 'KiroGraph Compression Hint',\n      version: '1.0.0',\n      description: 'Remind the agent to use kirograph_exec for shell commands that benefit from token compression (git, gh, test, lint, build, docker, aws, grep).',\n      when: { type: 'preToolUse', toolTypes: ['shell'] },\n      then: {\n        type: 'askAgent',\n        prompt: 'If this shell command is a git operation, GitHub CLI, test runner, linter, build tool, file listing, grep/rg, docker/kubectl, AWS CLI, or package manager command, consider using the kirograph_exec MCP tool instead for 60-90% token savings. The tool compresses output automatically while preserving error details.',\n      },\n    },\n  },\n];\n\n// \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nfunction writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nfunction migrateOnIdleHooks(hooksDir: string): void {\n  if (!fs.existsSync(hooksDir)) return;\n  let files: string[];\n  try {\n    files = fs.readdirSync(hooksDir).filter(f => f.endsWith('.json'));\n  } catch {\n    return;\n  }\n  for (const file of files) {\n    const filePath = path.join(hooksDir, file);\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      logWarn(`KiroGraph installer: could not read hook file ${filePath}`);\n      continue;\n    }\n    let obj: any;\n    try {\n      obj = JSON.parse(raw);\n    } catch {\n      logWarn(`KiroGraph installer: could not parse hook file ${filePath}`);\n      continue;\n    }\n    if (obj?.when?.type === 'onIdle') {\n      obj.when.type = 'agentStop';\n      try {\n        fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\\n');\n      } catch {\n        logWarn(`KiroGraph installer: could not write migrated hook file ${filePath}`);\n      }\n    }\n  }\n}\n\n// \u2500\u2500 Public \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function writeHooks(kiroDir: string, opts?: { enableCompression?: boolean }): void {\n  const hooksDir = path.join(kiroDir, 'hooks');\n  ensureDir(hooksDir);\n\n  migrateOnIdleHooks(hooksDir);\n\n  const oldHooks = ['kirograph-sync-on-save.json', 'kirograph-sync-on-create.json'];\n  for (const old of oldHooks) {\n    const p = path.join(hooksDir, old);\n    if (fs.existsSync(p)) fs.unlinkSync(p);\n  }\n\n  for (const { filename, hook } of HOOKS) {\n    // Skip compression hook if compression is disabled\n    if (filename === 'kirograph-compress-hint.json' && opts?.enableCompression === false) {\n      // Remove the hook file if it exists from a previous install\n      const p = path.join(hooksDir, filename);\n      if (fs.existsSync(p)) fs.unlinkSync(p);\n      continue;\n    }\n    writeJson(path.join(hooksDir, filename), hook);\n  }\n\n  console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/bin/installer/index.js

@@ -62,6 +62,7 @@ async function runInstaller(target = "kiro") {
     installer.installEarly(cwd);
     const alreadyInitialized = fs.existsSync(path.join(cwd, ".kirograph"));
     let cavemanMode = "off";
+    let shellCompressionLevel = "normal";
     let shouldOfferIndex = false;
     let typesenseDashboard = false;
     let qdrantDashboard = false;
@@ -69,16 +70,19 @@ async function runInstaller(target = "kiro") {
       if (alreadyInitialized) {
         const config = await (0, import_config.loadConfig)(cwd);
         cavemanMode = config.cavemanMode ?? "off";
+        shellCompressionLevel = config.shellCompressionLevel ?? "normal";
         console.log(`  \u2713 Reusing existing KiroGraph data in ${cwd}/.kirograph/`);
         console.log(`  \u2022 semanticEngine: ${config.semanticEngine}`);
         console.log(`  \u2022 enableEmbeddings: ${config.enableEmbeddings}`);
         console.log(`  \u2022 enableArchitecture: ${config.enableArchitecture}`);
         console.log(`  \u2022 cavemanMode: ${cavemanMode}`);
+        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);
       } else {
         shouldOfferIndex = true;
         const patch = await (0, import_config_prompt.promptConfigOptions)(rl);
         await (0, import_config.updateConfig)(cwd, patch);
         cavemanMode = patch.cavemanMode ?? "off";
+        shellCompressionLevel = patch.shellCompressionLevel ?? "normal";
         typesenseDashboard = patch.typesenseDashboard;
         qdrantDashboard = patch.qdrantDashboard;
         console.log(`
@@ -156,8 +160,9 @@ async function runInstaller(target = "kiro") {
         console.log(`  \u2022 trackCallSites: ${patch.trackCallSites}`);
         console.log(`  \u2022 enableArchitecture: ${patch.enableArchitecture}`);
         console.log(`  \u2022 cavemanMode: ${cavemanMode}`);
+        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);
       }
-      installer.installLate(cwd, cavemanMode);
+      installer.installLate(cwd, cavemanMode, shellCompressionLevel);
     } catch (err) {
       const reason = err instanceof Error ? err.message : String(err);
       console.error(`

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/*.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 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        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      } else {\n        shouldOfferIndex = true;\n        const patch = await promptConfigOptions(rl);\n        await updateConfig(cwd, patch);\n        cavemanMode = patch.cavemanMode ?? 'off';\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      }\n\n      installer.installLate(cwd, cavemanMode);\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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",
+  "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/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: