kirograph 0.27.1 → 0.27.2

package/README.md

@@ -51,10 +51,34 @@ The result is fewer tool calls, less context used, and faster responses on compl
 | <h4>Token Optimization</h4> | |
 | 🗜️ **Shell Compression (KiroGraph-RTK opt-in  module)** | Token-optimized command output (git, tests, linters, docker, AWS) — 60-90% savings |
 | 🪨 **Caveman Mode (KiroGraph-Caveman opt-in module)** 🪨 | Agent prose compression (lite → ultra) — fewer tokens on explanations without touching code |
+| 📦 **General-purpose Compression (`kirograph_compress`, opt-in)** | On-demand compression tool for arbitrary text. Two engines: rtk-style structural filters for shell output (command-hinted), caveman grammar for prose. Five levels (lite → ultra). Reports inline savings. Inspired by [headroom](https://github.com/chopratejas/headroom). |
+| 📥 **File Read Cache + CCR (`kirograph_read` / `kirograph_retrieve`, opt-in)** | `kirograph_read` caches files on first read — unchanged files return a ~13-token marker on subsequent reads. `kirograph_retrieve` (CCR) recovers the cached full content without a filesystem re-read. Prefix-stable markers enable KV cache hits on conversation context. Inspired by [lean-ctx](https://github.com/yvgude/lean-ctx) and [headroom](https://github.com/chopratejas/headroom). |
 | 📈 **Token Analytics (KiroGraph-Gain core module)** | Track cumulative savings from graph tools and shell compression over time |
 | <h4>Integration (KiroGraph-Integration core module)</h4> | |
 | 🔌 **Multi-tool Support** | Native Kiro + 32 experimental targets (Cursor, Copilot, Claude Code, Codex, Windsurf, Cline, and more) |
 
+## MCP Tool List Token Budget
+
+Each enabled flag adds tools to the model context on every MCP call. Total with all flags: **92 tools · ~4,367 tok**.
+
+| Flag | Tools | ~Tokens |
+|------|------:|--------:|
+| core (always-on) | 8 | ~472 |
+| `enableMemory` | 16 | ~746 |
+| `enableSecurity` | 15 | ~675 |
+| `enableData` | 10 | ~519 |
+| `enableWiki` | 10 | ~319 |
+| `enableCodeHealth` | 7 | ~309 |
+| `enableAgentUtils` | 4 | ~278 |
+| `enableAdvancedAnalysis` | 4 | ~210 |
+| `enableArchitecture` | 3 | ~142 |
+| `enableWatchmen` | 3 | ~140 |
+| `enablePatterns` | 3 | ~93 |
+| `trackCallSites` | 2 | ~84 |
+| `enableShellExec` | 1 | ~71 |
+| `enableGeneralCompression` | 1 | ~68 |
+| **Total** | **92** | **~4,367** |
+
 ## Quick Start
 
 ```bash
@@ -152,6 +176,7 @@ KiroGraph is inspired by [CodeGraph](https://github.com/colbymchenry/codegraph)
 - [rtk](https://github.com/rtk-ai/rtk) by [rtk-ai](https://github.com/rtk-ai): the shell compression module's command-family approach and token-optimized output patterns.
 - [code-review-graph](https://github.com/tirth8205/code-review-graph) by [Tirth Kanani](https://github.com/tirth8205): community detection, execution flow tracing, refactoring tools, and multi-platform auto-detection patterns.
 - [lean-ctx](https://github.com/yvgude/lean-ctx) by [Yves Gugger](https://github.com/yvgude): file read caching, multiple read modes, and context budget governance concepts.
+- [headroom](https://github.com/chopratejas/headroom) by [Tejas Chopra](https://github.com/chopratejas): the CCR (Cached Content Retrieval) pattern (`kirograph_retrieve`), dual-engine on-demand compression (`kirograph_compress`), and KV cache prefix stability via deterministic marker strings.
 - [turboquant-js](https://github.com/danilodevhub/turboquant-js) by [Danilo Dev](https://github.com/danilodevhub): the TurboQuant engine — TypeScript implementation of Google's Walsh-Hadamard + Lloyd-Max quantization algorithm used for embedding compression.
 - [turbovec](https://github.com/RyanCodrai/turbovec) by [Ryan Codrai](https://github.com/RyanCodrai): the TurboVec engine — Rust implementation of TurboQuant with SIMD acceleration, exposed to Node.js via a napi-rs native addon.
 - [pdf-inspector](https://github.com/firecrawl/pdf-inspector) by [Firecrawl](https://github.com/firecrawl): the PDF parser used in the data module — pure Rust, no OCR, no network, prebuilt binaries for linux-x64 and macOS ARM64.
@@ -163,7 +188,7 @@ KiroGraph is inspired by [CodeGraph](https://github.com/colbymchenry/codegraph)
 
 ## How It Compares
 
-KiroGraph combines capabilities from 13 separate projects into one integrated MCP server:
+KiroGraph combines capabilities from 14 separate projects into one integrated MCP server:
 
 | Capability | Inspired by | What KiroGraph adds |
 |-----------|-------------|---------------------|
@@ -177,6 +202,7 @@ KiroGraph combines capabilities from 13 separate projects into one integrated MC
 | PDF parsing | [pdf-inspector](https://github.com/firecrawl/pdf-inspector) | Pure Rust, no OCR/network, prebuilt binaries, piped into data module |
 | Shell compression | [rtk](https://github.com/rtk-ai/rtk) | Integrated as MCP tool, no separate binary |
 | Prose compression | [caveman](https://github.com/JuliusBrussee/caveman) | Multi-level (lite/full/ultra) via steering |
+| On-demand compression + CCR | [headroom](https://github.com/chopratejas/headroom) | Dual-engine (rtk shell + caveman prose) via `kirograph_compress`; CCR pattern via `kirograph_retrieve`; KV-cache prefix stability |
 | Embedding compression | [turboquant-js](https://github.com/danilodevhub/turboquant-js) | 9 engine options, SIMD Rust variant, 20–30× RAM savings |
 | SIMD vector search | [turbovec](https://github.com/RyanCodrai/turbovec) | NEON on ARM64, AVX-512BW on x86, auto-built by installer |
 | Context layer | [lean-ctx](https://github.com/yvgude/lean-ctx) | File caching, read modes, budget governance |

package/dist/bin/commands/callees.js

@@ -0,0 +1,76 @@
+"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 callees_exports = {};
+__export(callees_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(callees_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("callees <symbol>").description("List symbols called by a given function or method").option("--limit <n>", "Max results (default: 20)", "20").option("-j, --json", "Output as JSON").option("-p, --path <path>", "Project path").action(async (symbol, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(opts.path ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const results = cg.searchNodes(symbol, void 0, 5);
+    if (results.length === 0) {
+      console.error(`  \u2716 Symbol "${symbol}" not found in index.`);
+      cg.close();
+      process.exit(1);
+    }
+    const node = results[0].node;
+    const limit = Math.max(1, Math.min(100, parseInt(opts.limit) || 20));
+    const callees = await cg.getCallees(node.id, limit);
+    if (opts.json) {
+      console.log(JSON.stringify({ symbol: node.name, callees }));
+      cg.close();
+      return;
+    }
+    if (callees.length === 0) {
+      console.log(`
+  ${import_ui.dim}\`${node.name}\` doesn't call any indexed symbols.${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    console.log(`
+  ${import_ui.violet}${import_ui.bold}\`${node.name}\` calls${import_ui.reset}  ${import_ui.dim}(${callees.length})${import_ui.reset}
+`);
+    for (const n of callees) {
+      console.log(`  ${import_ui.violet}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}  ${n.filePath}:${n.startLine}${import_ui.reset}`);
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=callees.js.map

package/dist/bin/commands/callees.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/callees.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { bold, dim, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('callees <symbol>')\n    .description('List symbols called by a given function or method')\n    .option('--limit <n>', 'Max results (default: 20)', '20')\n    .option('-j, --json', 'Output as JSON')\n    .option('-p, --path <path>', 'Project path')\n    .action(async (symbol: string, opts: { limit: string; json?: boolean; path?: string }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(opts.path ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n\n      const results = cg.searchNodes(symbol, undefined, 5);\n      if (results.length === 0) {\n        console.error(`  \u2716 Symbol \"${symbol}\" not found in index.`);\n        cg.close(); process.exit(1);\n      }\n\n      const node = results[0].node;\n      const limit = Math.max(1, Math.min(100, parseInt(opts.limit) || 20));\n      const callees = await cg.getCallees(node.id, limit);\n\n      if (opts.json) {\n        console.log(JSON.stringify({ symbol: node.name, callees }));\n        cg.close(); return;\n      }\n\n      if (callees.length === 0) {\n        console.log(`\\n  ${dim}\\`${node.name}\\` doesn't call any indexed symbols.${reset}\\n`);\n        cg.close(); return;\n      }\n\n      console.log(`\\n  ${violet}${bold}\\`${node.name}\\` calls${reset}  ${dim}(${callees.length})${reset}\\n`);\n      for (const n of callees) {\n        console.log(`  ${violet}${n.name}${reset}  ${dim}${n.kind}  ${n.filePath}:${n.startLine}${reset}`);\n      }\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,kBAAkB,EAC1B,YAAY,mDAAmD,EAC/D,OAAO,eAAe,6BAA6B,IAAI,EACvD,OAAO,cAAc,gBAAgB,EACrC,OAAO,qBAAqB,cAAc,EAC1C,OAAO,OAAO,QAAgB,SAA2D;AACxF,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,KAAK,QAAQ,QAAQ,IAAI,CAAC;AACtD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AAEtC,UAAM,UAAU,GAAG,YAAY,QAAQ,QAAW,CAAC;AACnD,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,MAAM,oBAAe,MAAM,uBAAuB;AAC1D,SAAG,MAAM;AAAG,cAAQ,KAAK,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,QAAQ,CAAC,EAAE;AACxB,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,SAAS,KAAK,KAAK,KAAK,EAAE,CAAC;AACnE,UAAM,UAAU,MAAM,GAAG,WAAW,KAAK,IAAI,KAAK;AAElD,QAAI,KAAK,MAAM;AACb,cAAQ,IAAI,KAAK,UAAU,EAAE,QAAQ,KAAK,MAAM,QAAQ,CAAC,CAAC;AAC1D,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,IAAI;AAAA,IAAO,aAAG,KAAK,KAAK,IAAI,uCAAuC,eAAK;AAAA,CAAI;AACpF,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,YAAQ,IAAI;AAAA,IAAO,gBAAM,GAAG,cAAI,KAAK,KAAK,IAAI,WAAW,eAAK,KAAK,aAAG,IAAI,QAAQ,MAAM,IAAI,eAAK;AAAA,CAAI;AACrG,eAAW,KAAK,SAAS;AACvB,cAAQ,IAAI,KAAK,gBAAM,GAAG,EAAE,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,IAAI,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,GAAG,eAAK,EAAE;AAAA,IACnG;AACA,YAAQ,IAAI;AACZ,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/callers.js

@@ -0,0 +1,76 @@
+"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 callers_exports = {};
+__export(callers_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(callers_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("callers <symbol>").description("List symbols that call a given function or method").option("--limit <n>", "Max results (default: 20)", "20").option("-j, --json", "Output as JSON").option("-p, --path <path>", "Project path").action(async (symbol, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(opts.path ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const results = cg.searchNodes(symbol, void 0, 5);
+    if (results.length === 0) {
+      console.error(`  \u2716 Symbol "${symbol}" not found in index.`);
+      cg.close();
+      process.exit(1);
+    }
+    const node = results[0].node;
+    const limit = Math.max(1, Math.min(100, parseInt(opts.limit) || 20));
+    const callers = await cg.getCallers(node.id, limit);
+    if (opts.json) {
+      console.log(JSON.stringify({ symbol: node.name, callers }));
+      cg.close();
+      return;
+    }
+    if (callers.length === 0) {
+      console.log(`
+  ${import_ui.dim}No callers found for \`${node.name}\`.${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    console.log(`
+  ${import_ui.violet}${import_ui.bold}Callers of \`${node.name}\`${import_ui.reset}  ${import_ui.dim}(${callers.length})${import_ui.reset}
+`);
+    for (const n of callers) {
+      console.log(`  ${import_ui.violet}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}  ${n.filePath}:${n.startLine}${import_ui.reset}`);
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=callers.js.map

package/dist/bin/commands/callers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/callers.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { bold, dim, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('callers <symbol>')\n    .description('List symbols that call a given function or method')\n    .option('--limit <n>', 'Max results (default: 20)', '20')\n    .option('-j, --json', 'Output as JSON')\n    .option('-p, --path <path>', 'Project path')\n    .action(async (symbol: string, opts: { limit: string; json?: boolean; path?: string }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(opts.path ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n\n      const results = cg.searchNodes(symbol, undefined, 5);\n      if (results.length === 0) {\n        console.error(`  \u2716 Symbol \"${symbol}\" not found in index.`);\n        cg.close(); process.exit(1);\n      }\n\n      const node = results[0].node;\n      const limit = Math.max(1, Math.min(100, parseInt(opts.limit) || 20));\n      const callers = await cg.getCallers(node.id, limit);\n\n      if (opts.json) {\n        console.log(JSON.stringify({ symbol: node.name, callers }));\n        cg.close(); return;\n      }\n\n      if (callers.length === 0) {\n        console.log(`\\n  ${dim}No callers found for \\`${node.name}\\`.${reset}\\n`);\n        cg.close(); return;\n      }\n\n      console.log(`\\n  ${violet}${bold}Callers of \\`${node.name}\\`${reset}  ${dim}(${callers.length})${reset}\\n`);\n      for (const n of callers) {\n        console.log(`  ${violet}${n.name}${reset}  ${dim}${n.kind}  ${n.filePath}:${n.startLine}${reset}`);\n      }\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,kBAAkB,EAC1B,YAAY,mDAAmD,EAC/D,OAAO,eAAe,6BAA6B,IAAI,EACvD,OAAO,cAAc,gBAAgB,EACrC,OAAO,qBAAqB,cAAc,EAC1C,OAAO,OAAO,QAAgB,SAA2D;AACxF,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,KAAK,QAAQ,QAAQ,IAAI,CAAC;AACtD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AAEtC,UAAM,UAAU,GAAG,YAAY,QAAQ,QAAW,CAAC;AACnD,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,MAAM,oBAAe,MAAM,uBAAuB;AAC1D,SAAG,MAAM;AAAG,cAAQ,KAAK,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,QAAQ,CAAC,EAAE;AACxB,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,SAAS,KAAK,KAAK,KAAK,EAAE,CAAC;AACnE,UAAM,UAAU,MAAM,GAAG,WAAW,KAAK,IAAI,KAAK;AAElD,QAAI,KAAK,MAAM;AACb,cAAQ,IAAI,KAAK,UAAU,EAAE,QAAQ,KAAK,MAAM,QAAQ,CAAC,CAAC;AAC1D,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,IAAI;AAAA,IAAO,aAAG,0BAA0B,KAAK,IAAI,MAAM,eAAK;AAAA,CAAI;AACxE,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,YAAQ,IAAI;AAAA,IAAO,gBAAM,GAAG,cAAI,gBAAgB,KAAK,IAAI,KAAK,eAAK,KAAK,aAAG,IAAI,QAAQ,MAAM,IAAI,eAAK;AAAA,CAAI;AAC1G,eAAW,KAAK,SAAS;AACvB,cAAQ,IAAI,KAAK,gBAAM,GAAG,EAAE,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,IAAI,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,GAAG,eAAK,EAAE;AAAA,IACnG;AACA,YAAQ,IAAI;AACZ,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/circular-deps.js

@@ -0,0 +1,68 @@
+"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 circular_deps_exports = {};
+__export(circular_deps_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(circular_deps_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("circular-deps [projectPath]").description("Find circular dependency cycles in the codebase").option("-j, --json", "Output as JSON").action(async (projectPath, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(projectPath ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const cycles = cg.findCircularDependencies();
+    if (opts.json) {
+      console.log(JSON.stringify({ cycles }));
+      cg.close();
+      return;
+    }
+    if (cycles.length === 0) {
+      console.log(`
+  ${import_ui.dim}No circular dependencies found.${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    console.log(`
+  ${import_ui.violet}${import_ui.bold}Circular Dependencies${import_ui.reset}  ${import_ui.dim}(${cycles.length} cycle(s))${import_ui.reset}
+`);
+    for (let i = 0; i < cycles.length; i++) {
+      console.log(`  ${import_ui.dim}Cycle ${i + 1}:${import_ui.reset} ${cycles[i].map((s) => `${import_ui.violet}${s}${import_ui.reset}`).join(` ${import_ui.dim}\u2192${import_ui.reset} `)}`);
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=circular-deps.js.map

package/dist/bin/commands/circular-deps.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/circular-deps.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { bold, dim, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('circular-deps [projectPath]')\n    .description('Find circular dependency cycles in the codebase')\n    .option('-j, --json', 'Output as JSON')\n    .action(async (projectPath: string | undefined, opts: { json?: boolean }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(projectPath ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n\n      const cycles = cg.findCircularDependencies();\n\n      if (opts.json) {\n        console.log(JSON.stringify({ cycles }));\n        cg.close(); return;\n      }\n\n      if (cycles.length === 0) {\n        console.log(`\\n  ${dim}No circular dependencies found.${reset}\\n`);\n        cg.close(); return;\n      }\n\n      console.log(`\\n  ${violet}${bold}Circular Dependencies${reset}  ${dim}(${cycles.length} cycle(s))${reset}\\n`);\n      for (let i = 0; i < cycles.length; i++) {\n        console.log(`  ${dim}Cycle ${i + 1}:${reset} ${cycles[i].map(s => `${violet}${s}${reset}`).join(` ${dim}\u2192${reset} `)}`);\n      }\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,6BAA6B,EACrC,YAAY,iDAAiD,EAC7D,OAAO,cAAc,gBAAgB,EACrC,OAAO,OAAO,aAAiC,SAA6B;AAC3E,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,eAAe,QAAQ,IAAI,CAAC;AACxD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AAEtC,UAAM,SAAS,GAAG,yBAAyB;AAE3C,QAAI,KAAK,MAAM;AACb,cAAQ,IAAI,KAAK,UAAU,EAAE,OAAO,CAAC,CAAC;AACtC,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,QAAI,OAAO,WAAW,GAAG;AACvB,cAAQ,IAAI;AAAA,IAAO,aAAG,kCAAkC,eAAK;AAAA,CAAI;AACjE,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,YAAQ,IAAI;AAAA,IAAO,gBAAM,GAAG,cAAI,wBAAwB,eAAK,KAAK,aAAG,IAAI,OAAO,MAAM,aAAa,eAAK;AAAA,CAAI;AAC5G,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,cAAQ,IAAI,KAAK,aAAG,SAAS,IAAI,CAAC,IAAI,eAAK,IAAI,OAAO,CAAC,EAAE,IAAI,OAAK,GAAG,gBAAM,GAAG,CAAC,GAAG,eAAK,EAAE,EAAE,KAAK,IAAI,aAAG,SAAI,eAAK,GAAG,CAAC,EAAE;AAAA,IACxH;AACA,YAAQ,IAAI;AACZ,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/impact.js

@@ -0,0 +1,76 @@
+"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 impact_exports = {};
+__export(impact_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(impact_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("impact <symbol>").description("Show symbols that would be affected by changing a given symbol").option("-d, --depth <n>", "Max traversal depth (default: 2)", "2").option("-j, --json", "Output as JSON").option("-p, --path <path>", "Project path").action(async (symbol, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(opts.path ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const results = cg.searchNodes(symbol, void 0, 5);
+    if (results.length === 0) {
+      console.error(`  \u2716 Symbol "${symbol}" not found in index.`);
+      cg.close();
+      process.exit(1);
+    }
+    const node = results[0].node;
+    const depth = Math.max(1, Math.min(10, parseInt(opts.depth) || 2));
+    const affected = await cg.getImpactRadius(node.id, depth);
+    if (opts.json) {
+      console.log(JSON.stringify({ symbol: node.name, depth, affected }));
+      cg.close();
+      return;
+    }
+    if (affected.length === 0) {
+      console.log(`
+  ${import_ui.dim}No dependents found for \`${node.name}\`.${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    console.log(`
+  ${import_ui.violet}${import_ui.bold}Impact of \`${node.name}\`${import_ui.reset}  ${import_ui.dim}(${affected.length} symbol(s) affected, depth: ${depth})${import_ui.reset}
+`);
+    for (const n of affected) {
+      console.log(`  ${import_ui.violet}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}  ${n.filePath}:${n.startLine}${import_ui.reset}`);
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=impact.js.map

package/dist/bin/commands/impact.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/impact.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { bold, dim, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('impact <symbol>')\n    .description('Show symbols that would be affected by changing a given symbol')\n    .option('-d, --depth <n>', 'Max traversal depth (default: 2)', '2')\n    .option('-j, --json', 'Output as JSON')\n    .option('-p, --path <path>', 'Project path')\n    .action(async (symbol: string, opts: { depth: string; json?: boolean; path?: string }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(opts.path ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n\n      const results = cg.searchNodes(symbol, undefined, 5);\n      if (results.length === 0) {\n        console.error(`  \u2716 Symbol \"${symbol}\" not found in index.`);\n        cg.close(); process.exit(1);\n      }\n\n      const node = results[0].node;\n      const depth = Math.max(1, Math.min(10, parseInt(opts.depth) || 2));\n      const affected = await cg.getImpactRadius(node.id, depth);\n\n      if (opts.json) {\n        console.log(JSON.stringify({ symbol: node.name, depth, affected }));\n        cg.close(); return;\n      }\n\n      if (affected.length === 0) {\n        console.log(`\\n  ${dim}No dependents found for \\`${node.name}\\`.${reset}\\n`);\n        cg.close(); return;\n      }\n\n      console.log(`\\n  ${violet}${bold}Impact of \\`${node.name}\\`${reset}  ${dim}(${affected.length} symbol(s) affected, depth: ${depth})${reset}\\n`);\n      for (const n of affected) {\n        console.log(`  ${violet}${n.name}${reset}  ${dim}${n.kind}  ${n.filePath}:${n.startLine}${reset}`);\n      }\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,iBAAiB,EACzB,YAAY,gEAAgE,EAC5E,OAAO,mBAAmB,oCAAoC,GAAG,EACjE,OAAO,cAAc,gBAAgB,EACrC,OAAO,qBAAqB,cAAc,EAC1C,OAAO,OAAO,QAAgB,SAA2D;AACxF,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,KAAK,QAAQ,QAAQ,IAAI,CAAC;AACtD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AAEtC,UAAM,UAAU,GAAG,YAAY,QAAQ,QAAW,CAAC;AACnD,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,MAAM,oBAAe,MAAM,uBAAuB;AAC1D,SAAG,MAAM;AAAG,cAAQ,KAAK,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,QAAQ,CAAC,EAAE;AACxB,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,KAAK,KAAK,KAAK,CAAC,CAAC;AACjE,UAAM,WAAW,MAAM,GAAG,gBAAgB,KAAK,IAAI,KAAK;AAExD,QAAI,KAAK,MAAM;AACb,cAAQ,IAAI,KAAK,UAAU,EAAE,QAAQ,KAAK,MAAM,OAAO,SAAS,CAAC,CAAC;AAClE,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,QAAI,SAAS,WAAW,GAAG;AACzB,cAAQ,IAAI;AAAA,IAAO,aAAG,6BAA6B,KAAK,IAAI,MAAM,eAAK;AAAA,CAAI;AAC3E,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,YAAQ,IAAI;AAAA,IAAO,gBAAM,GAAG,cAAI,eAAe,KAAK,IAAI,KAAK,eAAK,KAAK,aAAG,IAAI,SAAS,MAAM,+BAA+B,KAAK,IAAI,eAAK;AAAA,CAAI;AAC9I,eAAW,KAAK,UAAU;AACxB,cAAQ,IAAI,KAAK,gBAAM,GAAG,EAAE,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,IAAI,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,GAAG,eAAK,EAAE;AAAA,IACnG;AACA,YAAQ,IAAI;AACZ,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/type-hierarchy.js

@@ -0,0 +1,76 @@
+"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 type_hierarchy_exports = {};
+__export(type_hierarchy_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(type_hierarchy_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("type-hierarchy <symbol>").description("Traverse the type hierarchy of a class or interface (base types and derived types)").option("--direction <dir>", "Direction: up (base types), down (derived types), both (default)", "both").option("-j, --json", "Output as JSON").option("-p, --path <path>", "Project path").action(async (symbol, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(opts.path ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const results = cg.searchNodes(symbol, void 0, 5);
+    if (results.length === 0) {
+      console.error(`  \u2716 Symbol "${symbol}" not found in index.`);
+      cg.close();
+      process.exit(1);
+    }
+    const node = results[0].node;
+    const direction = ["up", "down", "both"].includes(opts.direction) ? opts.direction : "both";
+    const hierarchy = cg.getTypeHierarchy(node.id, direction);
+    if (opts.json) {
+      console.log(JSON.stringify({ symbol: node.name, direction, hierarchy }));
+      cg.close();
+      return;
+    }
+    if (hierarchy.length === 0) {
+      console.log(`
+  ${import_ui.dim}No type hierarchy found for \`${node.name}\`.${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    console.log(`
+  ${import_ui.violet}${import_ui.bold}Type hierarchy of \`${node.name}\`${import_ui.reset}  ${import_ui.dim}(direction: ${direction})${import_ui.reset}
+`);
+    for (const n of hierarchy) {
+      console.log(`  ${import_ui.violet}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}  ${n.filePath}:${n.startLine}${import_ui.reset}`);
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=type-hierarchy.js.map

package/dist/bin/commands/type-hierarchy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/type-hierarchy.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { bold, dim, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('type-hierarchy <symbol>')\n    .description('Traverse the type hierarchy of a class or interface (base types and derived types)')\n    .option('--direction <dir>', 'Direction: up (base types), down (derived types), both (default)', 'both')\n    .option('-j, --json', 'Output as JSON')\n    .option('-p, --path <path>', 'Project path')\n    .action(async (symbol: string, opts: { direction: string; json?: boolean; path?: string }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(opts.path ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n\n      const results = cg.searchNodes(symbol, undefined, 5);\n      if (results.length === 0) {\n        console.error(`  \u2716 Symbol \"${symbol}\" not found in index.`);\n        cg.close(); process.exit(1);\n      }\n\n      const node = results[0].node;\n      const direction = (['up', 'down', 'both'].includes(opts.direction) ? opts.direction : 'both') as 'up' | 'down' | 'both';\n      const hierarchy = cg.getTypeHierarchy(node.id, direction);\n\n      if (opts.json) {\n        console.log(JSON.stringify({ symbol: node.name, direction, hierarchy }));\n        cg.close(); return;\n      }\n\n      if (hierarchy.length === 0) {\n        console.log(`\\n  ${dim}No type hierarchy found for \\`${node.name}\\`.${reset}\\n`);\n        cg.close(); return;\n      }\n\n      console.log(`\\n  ${violet}${bold}Type hierarchy of \\`${node.name}\\`${reset}  ${dim}(direction: ${direction})${reset}\\n`);\n      for (const n of hierarchy) {\n        console.log(`  ${violet}${n.name}${reset}  ${dim}${n.kind}  ${n.filePath}:${n.startLine}${reset}`);\n      }\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,yBAAyB,EACjC,YAAY,oFAAoF,EAChG,OAAO,qBAAqB,oEAAoE,MAAM,EACtG,OAAO,cAAc,gBAAgB,EACrC,OAAO,qBAAqB,cAAc,EAC1C,OAAO,OAAO,QAAgB,SAA+D;AAC5F,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,KAAK,QAAQ,QAAQ,IAAI,CAAC;AACtD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AAEtC,UAAM,UAAU,GAAG,YAAY,QAAQ,QAAW,CAAC;AACnD,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,MAAM,oBAAe,MAAM,uBAAuB;AAC1D,SAAG,MAAM;AAAG,cAAQ,KAAK,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,QAAQ,CAAC,EAAE;AACxB,UAAM,YAAa,CAAC,MAAM,QAAQ,MAAM,EAAE,SAAS,KAAK,SAAS,IAAI,KAAK,YAAY;AACtF,UAAM,YAAY,GAAG,iBAAiB,KAAK,IAAI,SAAS;AAExD,QAAI,KAAK,MAAM;AACb,cAAQ,IAAI,KAAK,UAAU,EAAE,QAAQ,KAAK,MAAM,WAAW,UAAU,CAAC,CAAC;AACvE,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,QAAI,UAAU,WAAW,GAAG;AAC1B,cAAQ,IAAI;AAAA,IAAO,aAAG,iCAAiC,KAAK,IAAI,MAAM,eAAK;AAAA,CAAI;AAC/E,SAAG,MAAM;AAAG;AAAA,IACd;AAEA,YAAQ,IAAI;AAAA,IAAO,gBAAM,GAAG,cAAI,uBAAuB,KAAK,IAAI,KAAK,eAAK,KAAK,aAAG,eAAe,SAAS,IAAI,eAAK;AAAA,CAAI;AACvH,eAAW,KAAK,WAAW;AACzB,cAAQ,IAAI,KAAK,gBAAM,GAAG,EAAE,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,IAAI,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,GAAG,eAAK,EAAE;AAAA,IACnG;AACA,YAAQ,IAAI;AACZ,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/installer/common.js

@@ -148,16 +148,22 @@ function removeGeneratedBlock(filePath, blockId) {
 function escapeRegExp(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function buildInstructionOpts(cavemanMode, shellCompressionLevel, enableMemory, hasHooks, enableDocs, enableData, enableSecurity, enableArchitecture, enablePatterns) {
+function buildInstructionOpts(opts, hasHooks) {
   return {
-    cavemanMode,
-    shellCompressionLevel: shellCompressionLevel ?? void 0,
-    enableArchitecture: enableArchitecture ?? false,
-    enableMemory: enableMemory ?? false,
-    enableDocs: enableDocs ?? false,
-    enableData: enableData ?? false,
-    enableSecurity: enableSecurity ?? false,
-    enablePatterns: enablePatterns ?? false,
+    cavemanMode: opts.cavemanMode,
+    shellCompressionLevel: opts.shellCompressionLevel ?? void 0,
+    enableArchitecture: opts.enableArchitecture ?? false,
+    enableMemory: opts.enableMemory ?? false,
+    enableDocs: opts.enableDocs ?? false,
+    enableData: opts.enableData ?? false,
+    enableSecurity: opts.enableSecurity ?? false,
+    enablePatterns: opts.enablePatterns ?? false,
+    enableWiki: opts.enableWiki ?? false,
+    enableCodeHealth: opts.enableCodeHealth ?? false,
+    enableAdvancedAnalysis: opts.enableAdvancedAnalysis ?? false,
+    enableAgentUtils: opts.enableAgentUtils ?? false,
+    enableGeneralCompression: opts.enableGeneralCompression ?? false,
+    trackCallSites: opts.trackCallSites ?? false,
     hasHooks: hasHooks ?? false
   };
 }

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

@@ -1,7 +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';\nimport type { InstructionOptions } from './instructions';\nimport type { CavemanMode } from './caveman';\n\nexport type InstallTarget = 'kiro' | 'claude' | 'codex' | 'cursor' | 'antigravity' | 'opencode' | 'windsurf' | 'cline' | 'copilot' | 'copilot-cli' | 'junie' | 'gemini-cli' | 'continue' | 'roo' | 'warp' | 'aider' | 'trae' | 'augment' | 'kilo' | 'amp' | 'devin' | 'replit' | 'goose' | 'openhands' | 'tabnine' | 'mistral-vibe' | 'ibm-bob' | 'crush' | 'droid-factory' | 'forgecode' | 'iflow' | 'qwen' | 'rovo' | 'qoder';\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\n/**\n * Write MCP server config to a JSON file under the mcpServers key.\n * Returns true if the config was written, false if already configured (idempotent).\n */\nexport function writeMcpServersConfig(configPath: string, serverConfig: object): boolean {\n  ensureDir(path.dirname(configPath));\n  const existing = readJson(configPath);\n  existing.mcpServers = existing.mcpServers ?? {};\n  if (existing.mcpServers[KIROGRAPH_SERVER_NAME]) {\n    return false; // Already configured\n  }\n  existing.mcpServers[KIROGRAPH_SERVER_NAME] = serverConfig;\n  writeJson(configPath, existing);\n  return true;\n}\n\n/**\n * Always write (overwrite) the MCP server config entry, regardless of whether it already exists.\n * Used when the final state is known upfront and idempotency would cause stale data.\n */\nexport function overwriteMcpServersConfig(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\n/**\n * Build InstructionOptions from the installLate parameters.\n * Used by all targets to pass full feature config to buildAgentInstructions.\n */\nexport function buildInstructionOpts(\n  cavemanMode?: CavemanMode | 'off',\n  shellCompressionLevel?: string,\n  enableMemory?: boolean,\n  hasHooks?: boolean,\n  enableDocs?: boolean,\n  enableData?: boolean,\n  enableSecurity?: boolean,\n  enableArchitecture?: boolean,\n  enablePatterns?: boolean,\n): InstructionOptions {\n  return {\n    cavemanMode,\n    shellCompressionLevel: (shellCompressionLevel as InstructionOptions['shellCompressionLevel']) ?? undefined,\n    enableArchitecture: enableArchitecture ?? false,\n    enableMemory: enableMemory ?? false,\n    enableDocs: enableDocs ?? false,\n    enableData: enableData ?? false,\n    enableSecurity: enableSecurity ?? false,\n    enablePatterns: enablePatterns ?? false,\n    hasHooks: hasHooks ?? false,\n  };\n}\n\nconst violet = '\\x1b[38;5;99m';\nconst resetAnsi = '\\x1b[0m';\nconst dimAnsi = '\\x1b[2m';\nconst boldAnsi = '\\x1b[1m';\n\n/**\n * Print a highlighted MCP config JSON block for targets that need user-scoped setup.\n */\nexport function printMcpSetup(configPath: string, projectRoot: string): void {\n  const escapedPath = projectRoot.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n  console.log(`\\n  ${dimAnsi}Add the MCP server manually:${resetAnsi}`);\n  console.log(`  ${dimAnsi}Edit${resetAnsi} ${violet}${boldAnsi}${configPath}${resetAnsi} ${dimAnsi}and add:${resetAnsi}`);\n  console.log(`  ${violet}{${resetAnsi}`);\n  console.log(`  ${violet}  \"mcpServers\": {${resetAnsi}`);\n  console.log(`  ${violet}    \"kirograph\": {${resetAnsi}`);\n  console.log(`  ${violet}      \"command\": \"kirograph\",${resetAnsi}`);\n  console.log(`  ${violet}      \"args\": [\"serve\", \"--mcp\", \"--path\", \"${escapedPath}\"]${resetAnsi}`);\n  console.log(`  ${violet}    }${resetAnsi}`);\n  console.log(`  ${violet}  }${resetAnsi}`);\n  console.log(`  ${violet}}${resetAnsi}\\n`);\n}\n\n/**\n * Print a highlighted CLI command for MCP registration.\n */\nexport function printMcpCommand(command: string): void {\n  console.log(`\\n  ${dimAnsi}Add the MCP server with:${resetAnsi}`);\n  console.log(`  ${violet}${boldAnsi}${command}${resetAnsi}\\n`);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as fs from 'fs';\nimport * as path from 'path';\nimport { KIROGRAPH_TOOL_NAMES } from '../../mcp/tool-names';\nimport type { InstructionOptions } from './instructions';\nimport type { CavemanMode } from './caveman';\n\n/** Single options object passed to every target's installLate(). */\nexport interface LateInstallOptions {\n  cavemanMode?: CavemanMode | 'off';\n  shellCompressionLevel?: string;\n  enableMemory?: boolean;\n  enableDocs?: boolean;\n  enableData?: boolean;\n  enableSecurity?: boolean;\n  enableArchitecture?: boolean;\n  enablePatterns?: boolean;\n  enableWatchmen?: boolean;\n  watchmenSynthesisMode?: 'local' | 'agent';\n  enableWiki?: boolean;\n  wikiSynthesisMode?: 'local' | 'agent';\n  wikiLocalModel?: string;\n  enableCodeHealth?: boolean;\n  enableAdvancedAnalysis?: boolean;\n  enableAgentUtils?: boolean;\n  enableGeneralCompression?: boolean;\n  trackCallSites?: boolean;\n  kiroHookFormat?: 'v1-legacy' | 'v2';\n}\n\nexport type InstallTarget = 'kiro' | 'claude' | 'codex' | 'cursor' | 'antigravity' | 'opencode' | 'windsurf' | 'cline' | 'copilot' | 'copilot-cli' | 'junie' | 'gemini-cli' | 'continue' | 'roo' | 'warp' | 'aider' | 'trae' | 'augment' | 'kilo' | 'amp' | 'devin' | 'replit' | 'goose' | 'openhands' | 'tabnine' | 'mistral-vibe' | 'ibm-bob' | 'crush' | 'droid-factory' | 'forgecode' | 'iflow' | 'qwen' | 'rovo' | 'qoder';\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\n/**\n * Write MCP server config to a JSON file under the mcpServers key.\n * Returns true if the config was written, false if already configured (idempotent).\n */\nexport function writeMcpServersConfig(configPath: string, serverConfig: object): boolean {\n  ensureDir(path.dirname(configPath));\n  const existing = readJson(configPath);\n  existing.mcpServers = existing.mcpServers ?? {};\n  if (existing.mcpServers[KIROGRAPH_SERVER_NAME]) {\n    return false; // Already configured\n  }\n  existing.mcpServers[KIROGRAPH_SERVER_NAME] = serverConfig;\n  writeJson(configPath, existing);\n  return true;\n}\n\n/**\n * Always write (overwrite) the MCP server config entry, regardless of whether it already exists.\n * Used when the final state is known upfront and idempotency would cause stale data.\n */\nexport function overwriteMcpServersConfig(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\n/**\n * Build InstructionOptions from the installLate parameters.\n * Used by all targets to pass full feature config to buildAgentInstructions.\n */\nexport function buildInstructionOpts(opts: LateInstallOptions, hasHooks?: boolean): InstructionOptions {\n  return {\n    cavemanMode: opts.cavemanMode,\n    shellCompressionLevel: (opts.shellCompressionLevel as InstructionOptions['shellCompressionLevel']) ?? undefined,\n    enableArchitecture: opts.enableArchitecture ?? false,\n    enableMemory: opts.enableMemory ?? false,\n    enableDocs: opts.enableDocs ?? false,\n    enableData: opts.enableData ?? false,\n    enableSecurity: opts.enableSecurity ?? false,\n    enablePatterns: opts.enablePatterns ?? false,\n    enableWiki: opts.enableWiki ?? false,\n    enableCodeHealth: opts.enableCodeHealth ?? false,\n    enableAdvancedAnalysis: opts.enableAdvancedAnalysis ?? false,\n    enableAgentUtils: opts.enableAgentUtils ?? false,\n    enableGeneralCompression: opts.enableGeneralCompression ?? false,\n    trackCallSites: opts.trackCallSites ?? false,\n    hasHooks: hasHooks ?? false,\n  };\n}\n\nconst violet = '\\x1b[38;5;99m';\nconst resetAnsi = '\\x1b[0m';\nconst dimAnsi = '\\x1b[2m';\nconst boldAnsi = '\\x1b[1m';\n\n/**\n * Print a highlighted MCP config JSON block for targets that need user-scoped setup.\n */\nexport function printMcpSetup(configPath: string, projectRoot: string): void {\n  const escapedPath = projectRoot.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n  console.log(`\\n  ${dimAnsi}Add the MCP server manually:${resetAnsi}`);\n  console.log(`  ${dimAnsi}Edit${resetAnsi} ${violet}${boldAnsi}${configPath}${resetAnsi} ${dimAnsi}and add:${resetAnsi}`);\n  console.log(`  ${violet}{${resetAnsi}`);\n  console.log(`  ${violet}  \"mcpServers\": {${resetAnsi}`);\n  console.log(`  ${violet}    \"kirograph\": {${resetAnsi}`);\n  console.log(`  ${violet}      \"command\": \"kirograph\",${resetAnsi}`);\n  console.log(`  ${violet}      \"args\": [\"serve\", \"--mcp\", \"--path\", \"${escapedPath}\"]${resetAnsi}`);\n  console.log(`  ${violet}    }${resetAnsi}`);\n  console.log(`  ${violet}  }${resetAnsi}`);\n  console.log(`  ${violet}}${resetAnsi}\\n`);\n}\n\n/**\n * Print a highlighted CLI command for MCP registration.\n */\nexport function printMcpCommand(command: string): void {\n  console.log(`\\n  ${dimAnsi}Add the MCP server with:${resetAnsi}`);\n  console.log(`  ${violet}${boldAnsi}${command}${resetAnsi}\\n`);\n}\n"],
+  "mappings": "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",
   "names": []
 }