kirograph 0.13.0 → 0.14.0

package/dist/bin/installer/common.js

@@ -0,0 +1,154 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var common_exports = {};
+__export(common_exports, {
+  KIROGRAPH_COMMAND: () => KIROGRAPH_COMMAND,
+  KIROGRAPH_MCP_ARGS: () => KIROGRAPH_MCP_ARGS,
+  KIROGRAPH_SCOPED_TOOLS: () => KIROGRAPH_SCOPED_TOOLS,
+  KIROGRAPH_SERVER_NAME: () => KIROGRAPH_SERVER_NAME,
+  KIROGRAPH_SYNC_CMD: () => KIROGRAPH_SYNC_CMD,
+  KIROGRAPH_TOOLS: () => KIROGRAPH_TOOLS,
+  appendImportLine: () => appendImportLine,
+  ensureDir: () => ensureDir,
+  readJson: () => readJson,
+  removeGeneratedBlock: () => removeGeneratedBlock,
+  removeImportLine: () => removeImportLine,
+  removeMcpServersConfig: () => removeMcpServersConfig,
+  upsertGeneratedBlock: () => upsertGeneratedBlock,
+  writeJson: () => writeJson,
+  writeMcpServersConfig: () => writeMcpServersConfig
+});
+module.exports = __toCommonJS(common_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_tool_names = require("../../mcp/tool-names");
+const KIROGRAPH_SERVER_NAME = "kirograph";
+const KIROGRAPH_COMMAND = "kirograph";
+const KIROGRAPH_MCP_ARGS = ["serve", "--mcp"];
+const KIROGRAPH_SYNC_CMD = "kirograph sync-if-dirty --quiet 2>/dev/null || true";
+const KIROGRAPH_TOOLS = import_tool_names.KIROGRAPH_TOOL_NAMES;
+const KIROGRAPH_SCOPED_TOOLS = import_tool_names.KIROGRAPH_TOOL_NAMES.map((name) => `@kirograph/${name}`);
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+function readJson(p) {
+  try {
+    return JSON.parse(fs.readFileSync(p, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function writeJson(p, data) {
+  fs.writeFileSync(p, JSON.stringify(data, null, 2) + "\n");
+}
+function writeMcpServersConfig(configPath, serverConfig) {
+  ensureDir(path.dirname(configPath));
+  const existing = readJson(configPath);
+  existing.mcpServers = existing.mcpServers ?? {};
+  existing.mcpServers[KIROGRAPH_SERVER_NAME] = serverConfig;
+  writeJson(configPath, existing);
+}
+function removeMcpServersConfig(configPath) {
+  if (!fs.existsSync(configPath)) return false;
+  const existing = readJson(configPath);
+  if (!existing.mcpServers?.[KIROGRAPH_SERVER_NAME]) return false;
+  delete existing.mcpServers[KIROGRAPH_SERVER_NAME];
+  writeJson(configPath, existing);
+  return true;
+}
+function appendImportLine(filePath, line, heading) {
+  const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : "";
+  if (existing.includes(line)) return false;
+  const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  const separator = existing.trim().length > 0 ? "\n" : "";
+  fs.writeFileSync(filePath, existing + prefix + separator + heading + "\n" + line + "\n");
+  return true;
+}
+function removeImportLine(filePath, line) {
+  if (!fs.existsSync(filePath)) return false;
+  const original = fs.readFileSync(filePath, "utf8");
+  const next = original.split("\n").filter((l) => l.trim() !== line).join("\n").replace(/\n{3,}/g, "\n\n");
+  if (next === original) return false;
+  fs.writeFileSync(filePath, next.endsWith("\n") ? next : next + "\n");
+  return true;
+}
+function upsertGeneratedBlock(filePath, blockId, heading, content) {
+  const start = `<!-- kirograph:${blockId}:start -->`;
+  const end = `<!-- kirograph:${blockId}:end -->`;
+  const block = `${start}
+${heading}
+
+${content.trim()}
+${end}`;
+  const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : "";
+  const pattern = new RegExp(`${escapeRegExp(start)}[\\s\\S]*?${escapeRegExp(end)}`);
+  if (pattern.test(existing)) {
+    const next = existing.replace(pattern, block);
+    if (next === existing) return false;
+    fs.writeFileSync(filePath, next.endsWith("\n") ? next : next + "\n");
+    return true;
+  }
+  const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+  const separator = existing.trim().length > 0 ? "\n" : "";
+  fs.writeFileSync(filePath, existing + prefix + separator + block + "\n");
+  return true;
+}
+function removeGeneratedBlock(filePath, blockId) {
+  if (!fs.existsSync(filePath)) return false;
+  const start = `<!-- kirograph:${blockId}:start -->`;
+  const end = `<!-- kirograph:${blockId}:end -->`;
+  const original = fs.readFileSync(filePath, "utf8");
+  const pattern = new RegExp(`\\n?${escapeRegExp(start)}[\\s\\S]*?${escapeRegExp(end)}\\n?`);
+  const next = original.replace(pattern, "\n").replace(/\n{3,}/g, "\n\n");
+  if (next === original) return false;
+  fs.writeFileSync(filePath, next.endsWith("\n") ? next : next + "\n");
+  return true;
+}
+function escapeRegExp(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KIROGRAPH_COMMAND,
+  KIROGRAPH_MCP_ARGS,
+  KIROGRAPH_SCOPED_TOOLS,
+  KIROGRAPH_SERVER_NAME,
+  KIROGRAPH_SYNC_CMD,
+  KIROGRAPH_TOOLS,
+  appendImportLine,
+  ensureDir,
+  readJson,
+  removeGeneratedBlock,
+  removeImportLine,
+  removeMcpServersConfig,
+  upsertGeneratedBlock,
+  writeJson,
+  writeMcpServersConfig
+});
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/installer/common.ts"],
+  "sourcesContent": ["import * as fs from 'fs';\nimport * as path from 'path';\nimport { KIROGRAPH_TOOL_NAMES } from '../../mcp/tool-names';\n\nexport type InstallTarget = 'kiro' | 'claude' | 'codex';\n\nexport const KIROGRAPH_SERVER_NAME = 'kirograph';\nexport const KIROGRAPH_COMMAND = 'kirograph';\nexport const KIROGRAPH_MCP_ARGS = ['serve', '--mcp'];\nexport const KIROGRAPH_SYNC_CMD = 'kirograph sync-if-dirty --quiet 2>/dev/null || true';\nexport const KIROGRAPH_TOOLS = KIROGRAPH_TOOL_NAMES;\nexport const KIROGRAPH_SCOPED_TOOLS = KIROGRAPH_TOOL_NAMES.map(name => `@kirograph/${name}`);\n\nexport function ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nexport function readJson(p: string): any {\n  try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch { return {}; }\n}\n\nexport function writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nexport function writeMcpServersConfig(configPath: string, serverConfig: object): void {\n  ensureDir(path.dirname(configPath));\n  const existing = readJson(configPath);\n  existing.mcpServers = existing.mcpServers ?? {};\n  existing.mcpServers[KIROGRAPH_SERVER_NAME] = serverConfig;\n  writeJson(configPath, existing);\n}\n\nexport function removeMcpServersConfig(configPath: string): boolean {\n  if (!fs.existsSync(configPath)) return false;\n  const existing = readJson(configPath);\n  if (!existing.mcpServers?.[KIROGRAPH_SERVER_NAME]) return false;\n  delete existing.mcpServers[KIROGRAPH_SERVER_NAME];\n  writeJson(configPath, existing);\n  return true;\n}\n\nexport function appendImportLine(filePath: string, line: string, heading: string): boolean {\n  const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';\n  if (existing.includes(line)) return false;\n\n  const prefix = existing.length > 0 && !existing.endsWith('\\n') ? '\\n' : '';\n  const separator = existing.trim().length > 0 ? '\\n' : '';\n  fs.writeFileSync(filePath, existing + prefix + separator + heading + '\\n' + line + '\\n');\n  return true;\n}\n\nexport function removeImportLine(filePath: string, line: string): boolean {\n  if (!fs.existsSync(filePath)) return false;\n  const original = fs.readFileSync(filePath, 'utf8');\n  const next = original\n    .split('\\n')\n    .filter(l => l.trim() !== line)\n    .join('\\n')\n    .replace(/\\n{3,}/g, '\\n\\n');\n  if (next === original) return false;\n  fs.writeFileSync(filePath, next.endsWith('\\n') ? next : next + '\\n');\n  return true;\n}\n\nexport function upsertGeneratedBlock(filePath: string, blockId: string, heading: string, content: string): boolean {\n  const start = `<!-- kirograph:${blockId}:start -->`;\n  const end = `<!-- kirograph:${blockId}:end -->`;\n  const block = `${start}\\n${heading}\\n\\n${content.trim()}\\n${end}`;\n  const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';\n  const pattern = new RegExp(`${escapeRegExp(start)}[\\\\s\\\\S]*?${escapeRegExp(end)}`);\n\n  if (pattern.test(existing)) {\n    const next = existing.replace(pattern, block);\n    if (next === existing) return false;\n    fs.writeFileSync(filePath, next.endsWith('\\n') ? next : next + '\\n');\n    return true;\n  }\n\n  const prefix = existing.length > 0 && !existing.endsWith('\\n') ? '\\n' : '';\n  const separator = existing.trim().length > 0 ? '\\n' : '';\n  fs.writeFileSync(filePath, existing + prefix + separator + block + '\\n');\n  return true;\n}\n\nexport function removeGeneratedBlock(filePath: string, blockId: string): boolean {\n  if (!fs.existsSync(filePath)) return false;\n  const start = `<!-- kirograph:${blockId}:start -->`;\n  const end = `<!-- kirograph:${blockId}:end -->`;\n  const original = fs.readFileSync(filePath, 'utf8');\n  const pattern = new RegExp(`\\\\n?${escapeRegExp(start)}[\\\\s\\\\S]*?${escapeRegExp(end)}\\\\n?`);\n  const next = original.replace(pattern, '\\n').replace(/\\n{3,}/g, '\\n\\n');\n  if (next === original) return false;\n  fs.writeFileSync(filePath, next.endsWith('\\n') ? next : next + '\\n');\n  return true;\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -62,7 +62,7 @@ async function promptConfigOptions(rl) {
     "Enable semantic embeddings for similarity search? (requires a local embedding model)",
     "Enables semantic/similarity-based code search. Increases indexing time; the chosen embedding model is downloaded automatically on first use."
   );
-  const patch = { enableEmbeddings, useVecIndex: false, semanticEngine: "cosine", typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: "off" };
+  const patch = { enableEmbeddings, useVecIndex: false, semanticEngine: "cosine", typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: "off", shellCompressionLevel: "normal" };
   if (enableEmbeddings) {
     const modelChoice = await (0, import_prompts.arrowSelect)(
       rl,
@@ -141,13 +141,20 @@ async function promptConfigOptions(rl) {
     "Enable architecture analysis (package graph + layer detection)?",
     "Detects packages from manifests (package.json, go.mod, Cargo.toml, etc.) and architectural layers (api, service, data, ui, shared) from file structure. Enables kirograph_architecture, kirograph_coupling, and kirograph_package MCP tools."
   );
-  const cavemanChoice = await (0, import_prompts.arrowSelect)(rl, "Caveman mode \u2014 agent communication style:", [
+  const cavemanChoice = await (0, import_prompts.arrowSelect)(rl, "Caveman mode: agent communication style:", [
     { value: "off", label: "off", description: "Normal responses" },
     { value: "lite", label: "lite", description: "Compact, no filler, full sentences" },
     { value: "full", label: "full", description: "Fragments, no articles, short synonyms" },
     { value: "ultra", label: "ultra", description: "Max compression, abbreviations, \u2192 for causality" }
   ]);
   patch.cavemanMode = cavemanChoice;
+  const compressionChoice = await (0, import_prompts.arrowSelect)(rl, "Shell compression: default level for kirograph_exec:", [
+    { value: "off", label: "off", description: "No compression hook or steering (tool still available)" },
+    { value: "normal", label: "normal", description: "Balanced: removes noise, keeps structure (recommended)" },
+    { value: "aggressive", label: "aggressive", description: "More compact: groups by category, limits output" },
+    { value: "ultra", label: "ultra", description: "Maximum compression: counts and summaries only" }
+  ]);
+  patch.shellCompressionLevel = compressionChoice;
   return patch;
 }
 // Annotate the CommonJS export names for ESM import in node:

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": "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",
   "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

@@ -31,8 +31,9 @@ __export(installer_exports, {
   runInstaller: () => runInstaller
 });
 module.exports = __toCommonJS(installer_exports);
-var path = __toESM(require("path"));
 var readline = __toESM(require("readline"));
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
 var import_child_process = require("child_process");
 var import_config = require("../../config");
 var import_banner = require("../banner");
@@ -40,120 +41,138 @@ var import_progress = require("../progress");
 var import_ui = require("../ui");
 var import_prompts = require("./prompts");
 var import_config_prompt = require("./config-prompt");
-var import_mcp = require("./mcp");
-var import_hooks = require("./hooks");
-var import_steering = require("./steering");
-var import_cli_agent = require("./cli-agent");
 var import_dashboard = require("./dashboard");
 var import_qdrant_dashboard = require("./qdrant-dashboard");
-async function runInstaller() {
+var import_targets = require("./targets");
+async function runInstaller(target = "kiro") {
   (0, import_banner.printBanner)();
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   try {
     const cwd = process.cwd();
-    const kiroDir = path.join(cwd, ".kiro");
+    const installer = (0, import_targets.getTargetInstaller)(target);
     console.log(`  Workspace: ${cwd}
 `);
-    const proceed = await (0, import_prompts.ask)(rl, "  Install KiroGraph for this Kiro workspace? (Y/n) ");
+    const proceed = await (0, import_prompts.ask)(rl, `  Install KiroGraph for ${installer.label}? (Y/n) `);
     if (proceed.toLowerCase() === "n") {
       console.log("  Cancelled.");
       rl.close();
       return;
     }
     console.log();
-    (0, import_mcp.writeMcpConfig)(kiroDir);
-    (0, import_hooks.writeHooks)(kiroDir);
-    const patch = await (0, import_config_prompt.promptConfigOptions)(rl);
+    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;
     try {
-      await (0, import_config.updateConfig)(cwd, patch);
-      console.log(`
+      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(`
   Configuration saved to ${cwd}/.kirograph/config.json`);
-      console.log(`  \u2022 enableEmbeddings: ${patch.enableEmbeddings}`);
-      if ("embeddingModel" in patch) {
-        console.log(`  \u2022 embeddingModel: ${patch.embeddingModel}  ${import_ui.dim}(${patch.embeddingDim}-dim)${import_ui.reset}`);
-      }
-      if (patch.enableEmbeddings) {
-        console.log(`  \u2022 semanticEngine: ${patch.semanticEngine}`);
-        if (patch.semanticEngine === "sqlite-vec") {
-          console.log(`
+        console.log(`  \u2022 enableEmbeddings: ${patch.enableEmbeddings}`);
+        if ("embeddingModel" in patch) {
+          console.log(`  \u2022 embeddingModel: ${patch.embeddingModel}  ${import_ui.dim}(${patch.embeddingDim}-dim)${import_ui.reset}`);
+        }
+        if (patch.enableEmbeddings) {
+          console.log(`  \u2022 semanticEngine: ${patch.semanticEngine}`);
+          if (patch.semanticEngine === "sqlite-vec") {
+            console.log(`
   Installing sqlite-vec dependencies...`);
-          const result = (0, import_child_process.spawnSync)("npm", ["install", "better-sqlite3", "sqlite-vec"], { stdio: "inherit", shell: true });
-          if (result.status === 0) {
-            console.log(`  \u2713 better-sqlite3 and sqlite-vec installed`);
-          } else {
-            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
-            console.warn(`    npm install better-sqlite3 sqlite-vec`);
-          }
-        } else if (patch.semanticEngine === "orama") {
-          console.log(`
+            const result = (0, import_child_process.spawnSync)("npm", ["install", "better-sqlite3", "sqlite-vec"], { stdio: "inherit", shell: true });
+            if (result.status === 0) {
+              console.log(`  \u2713 better-sqlite3 and sqlite-vec installed`);
+            } else {
+              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+              console.warn(`    npm install better-sqlite3 sqlite-vec`);
+            }
+          } else if (patch.semanticEngine === "orama") {
+            console.log(`
   Installing Orama dependencies...`);
-          const result = (0, import_child_process.spawnSync)("npm", ["install", "@orama/orama", "@orama/plugin-data-persistence"], { stdio: "inherit", shell: true });
-          if (result.status === 0) {
-            console.log(`  \u2713 @orama/orama and @orama/plugin-data-persistence installed`);
-          } else {
-            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
-            console.warn(`    npm install @orama/orama @orama/plugin-data-persistence`);
-          }
-        } else if (patch.semanticEngine === "pglite") {
-          console.log(`
+            const result = (0, import_child_process.spawnSync)("npm", ["install", "@orama/orama", "@orama/plugin-data-persistence"], { stdio: "inherit", shell: true });
+            if (result.status === 0) {
+              console.log(`  \u2713 @orama/orama and @orama/plugin-data-persistence installed`);
+            } else {
+              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+              console.warn(`    npm install @orama/orama @orama/plugin-data-persistence`);
+            }
+          } else if (patch.semanticEngine === "pglite") {
+            console.log(`
   Installing PGlite dependencies...`);
-          const result = (0, import_child_process.spawnSync)("npm", ["install", "@electric-sql/pglite"], { stdio: "inherit", shell: true });
-          if (result.status === 0) {
-            console.log(`  \u2713 @electric-sql/pglite installed`);
-          } else {
-            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
-            console.warn(`    npm install @electric-sql/pglite`);
-          }
-        } else if (patch.semanticEngine === "lancedb") {
-          console.log(`
+            const result = (0, import_child_process.spawnSync)("npm", ["install", "@electric-sql/pglite"], { stdio: "inherit", shell: true });
+            if (result.status === 0) {
+              console.log(`  \u2713 @electric-sql/pglite installed`);
+            } else {
+              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+              console.warn(`    npm install @electric-sql/pglite`);
+            }
+          } else if (patch.semanticEngine === "lancedb") {
+            console.log(`
   Installing LanceDB dependencies...`);
-          const result = (0, import_child_process.spawnSync)("npm", ["install", "@lancedb/lancedb"], { stdio: "inherit", shell: true });
-          if (result.status === 0) {
-            console.log(`  \u2713 @lancedb/lancedb installed`);
-          } else {
-            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
-            console.warn(`    npm install @lancedb/lancedb`);
-          }
-        } else if (patch.semanticEngine === "qdrant") {
-          console.log(`
+            const result = (0, import_child_process.spawnSync)("npm", ["install", "@lancedb/lancedb"], { stdio: "inherit", shell: true });
+            if (result.status === 0) {
+              console.log(`  \u2713 @lancedb/lancedb installed`);
+            } else {
+              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+              console.warn(`    npm install @lancedb/lancedb`);
+            }
+          } else if (patch.semanticEngine === "qdrant") {
+            console.log(`
   Installing Qdrant dependencies...`);
-          const result = (0, import_child_process.spawnSync)("npm", ["install", "qdrant-local"], { stdio: "inherit", shell: true });
-          if (result.status === 0) {
-            console.log(`  \u2713 qdrant-local installed`);
-          } else {
-            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
-            console.warn(`    npm install qdrant-local`);
-          }
-        } else if (patch.semanticEngine === "typesense") {
-          console.log(`
+            const result = (0, import_child_process.spawnSync)("npm", ["install", "qdrant-local"], { stdio: "inherit", shell: true });
+            if (result.status === 0) {
+              console.log(`  \u2713 qdrant-local installed`);
+            } else {
+              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+              console.warn(`    npm install qdrant-local`);
+            }
+          } else if (patch.semanticEngine === "typesense") {
+            console.log(`
   Installing Typesense dependencies...`);
-          const result = (0, import_child_process.spawnSync)("npm", ["install", "typesense"], { stdio: "inherit", shell: true });
-          if (result.status === 0) {
-            console.log(`  \u2713 typesense installed`);
-            console.log(`  \u2139  The Typesense binary (~37MB) will be auto-downloaded on first index run.`);
-          } else {
-            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
-            console.warn(`    npm install typesense`);
+            const result = (0, import_child_process.spawnSync)("npm", ["install", "typesense"], { stdio: "inherit", shell: true });
+            if (result.status === 0) {
+              console.log(`  \u2713 typesense installed`);
+              console.log(`  \u2139  The Typesense binary (~37MB) will be auto-downloaded on first index run.`);
+            } else {
+              console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+              console.warn(`    npm install typesense`);
+            }
           }
         }
+        console.log(`  \u2022 extractDocstrings: ${patch.extractDocstrings}`);
+        console.log(`  \u2022 trackCallSites: ${patch.trackCallSites}`);
+        console.log(`  \u2022 enableArchitecture: ${patch.enableArchitecture}`);
+        console.log(`  \u2022 cavemanMode: ${cavemanMode}`);
+        console.log(`  \u2022 shellCompressionLevel: ${shellCompressionLevel}`);
       }
-      console.log(`  \u2022 extractDocstrings: ${patch.extractDocstrings}`);
-      console.log(`  \u2022 trackCallSites: ${patch.trackCallSites}`);
-      console.log(`  \u2022 enableArchitecture: ${patch.enableArchitecture}`);
-      console.log(`  \u2022 cavemanMode: ${patch.cavemanMode ?? "off"}`);
-      (0, import_steering.writeSteering)(kiroDir, patch.cavemanMode ?? "off");
-      (0, import_cli_agent.writeCliAgent)(kiroDir);
+      installer.installLate(cwd, cavemanMode, shellCompressionLevel);
     } catch (err) {
       const reason = err instanceof Error ? err.message : String(err);
       console.error(`
   \u2717 Failed to write configuration: ${reason}`);
       process.exit(1);
     }
-    if (patch.qdrantDashboard) {
+    if (qdrantDashboard) {
       await (0, import_qdrant_dashboard.ensureQdrantUI)(cwd);
     }
-    const doIndex = await (0, import_prompts.ask)(rl, "\n  Initialize and index this project now? (Y/n) ");
-    if (doIndex.toLowerCase() !== "n") {
+    if (shouldOfferIndex && (await (0, import_prompts.ask)(rl, "\n  Initialize and index this project now? (Y/n) ")).toLowerCase() !== "n") {
       const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
       const fileBytes = /* @__PURE__ */ new Map();
       const modelProgress = (file, loaded, total, done) => {
@@ -197,7 +216,7 @@ async function runInstaller() {
       process.stdout.write("\n");
       console.log(`  \u2713 Indexed ${result.filesIndexed} files, ${result.nodesCreated} symbols, ${result.edgesCreated} edges`);
       cg.close();
-      if (patch.typesenseDashboard) {
+      if (typesenseDashboard) {
         const dashboardServer = await (0, import_dashboard.openTypesenseDashboard)(cwd);
         console.log(`  ${import_ui.dim}Press Ctrl+C to stop the dashboard server when done.${import_ui.reset}`);
         await new Promise((resolve) => {
@@ -211,12 +230,11 @@ async function runInstaller() {
         });
         return;
       }
-      if (patch.qdrantDashboard) {
+      if (qdrantDashboard) {
         await (0, import_qdrant_dashboard.openQdrantDashboard)(cwd);
       }
     }
-    console.log("\n  Done! Restart Kiro IDE for the MCP server to load.");
-    console.log('  For Kiro CLI, use the "kirograph" agent: kiro-cli --agent kirograph\n');
+    installer.printNextSteps(cwd);
   } finally {
     rl.close();
   }