kirograph 0.27.1 → 0.28.0

package/README.md

@@ -51,10 +51,39 @@ 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: **126 tools · ~6,240 tok**.
+
+| Flag | Tools | ~Tokens |
+|------|------:|--------:|
+| core (always-on) | 3 | ~170 |
+| `enableNavigation` | 3 | ~120 |
+| `enableMemory` | 16 | ~746 |
+| `enableSecurity` | 15 | ~675 |
+| `enableData` | 10 | ~519 |
+| `enableWiki` | 10 | ~319 |
+| `enableCodeHealth` | 25 | ~935 |
+| `enableDocs` | 5 | ~241 |
+| `enableAgentUtils` | 4 | ~278 |
+| `enableArchitecture` | 5 | ~205 |
+| `enableWatchmen` | 3 | ~140 |
+| `enablePatterns` | 3 | ~93 |
+| `trackCallSites` | 2 | ~84 |
+| `enableGitContext` | 7 | ~410 |
+| `enableComplexity` | 5 | ~660 |
+| `enableEditPrimitives` | 5 | ~280 |
+| `enableBranch` | 3 | ~300 |
+| `enableShellExec` | 1 | ~71 |
+| `enableGeneralCompression` | 1 | ~68 |
+| **Total** | **126** | **~6,240** |
+
 ## Quick Start
 
 ```bash
@@ -152,9 +181,11 @@ 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.
+- [tokensave](https://tokensave.dev): gap-close roadmap inspiration — code quality tools (complexity, god class, recursion, doc coverage), git workflow context tools (diff_context, commit_context, test_map), atomic edit primitives, multi-branch indexing, per-call token metrics, and MCP protocol annotations (`readOnlyHint`, `alwaysLoad`).
 
 ### Contributors
 
@@ -163,7 +194,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,11 +208,13 @@ 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 |
+| Gap-close roadmap | [tokensave](https://tokensave.dev) | Code quality metrics, git context tools, atomic edit primitives, multi-branch indexing |
 
-See the [full comparison](docs/guide/comparison.md) for a detailed feature matrix against CodeGraph, code-review-graph, jCodeMunch, and others.
+See the [full comparison](docs/guide/comparison.md) for a detailed feature matrix against CodeGraph, code-review-graph, jCodeMunch, tokensave, and others.
 
 ## Star History
 

package/dist/bin/commands/annotations.js

@@ -0,0 +1,56 @@
+"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 annotations_exports = {};
+__export(annotations_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(annotations_exports);
+var path = __toESM(require("path"));
+async function runTool(target, toolName, args) {
+  const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+  const { ToolHandler } = await Promise.resolve().then(() => require("../../mcp/handler.js"));
+  const cg = await KiroGraph.open(target);
+  const handler = new ToolHandler(cg);
+  const result = await handler.handle(toolName, { ...args, projectPath: target });
+  cg.close();
+  const text = result.content.map((c) => c.text).join("");
+  console.log(text);
+}
+function register(program) {
+  program.command("annotations [projectPath]").description("Decorator/attribute histogram across the codebase").option("--decorator <name>", "Filter by decorator name").option("--limit <n>", "Max results", "20").action(async (projectPath, opts) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const limit = parseInt(opts.limit) || 20;
+    await runTool(target, "kirograph_annotations", { decorator: opts.decorator, limit });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=annotations.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/annotations.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { dim, reset, violet, bold } from '../ui';\n\nasync function runTool(target: string, toolName: string, args: Record<string, unknown>): Promise<void> {\n  const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n  const { ToolHandler } = (await Promise.resolve().then(() => require('../../mcp/handler.js'))) as any;\n  const cg = await KiroGraph.open(target);\n  const handler = new ToolHandler(cg);\n  const result = await handler.handle(toolName, { ...args, projectPath: target });\n  cg.close();\n  const text: string = result.content.map((c: any) => c.text).join('');\n  console.log(text);\n}\n\nexport function register(program: Command): void {\n  program\n    .command('annotations [projectPath]')\n    .description('Decorator/attribute histogram across the codebase')\n    .option('--decorator <name>', 'Filter by decorator name')\n    .option('--limit <n>', 'Max results', '20')\n    .action(async (projectPath: string | undefined, opts: { decorator?: string; limit: string }) => {\n      const target = path.resolve(projectPath ?? process.cwd());\n      const limit = parseInt(opts.limit) || 20;\n      await runTool(target, 'kirograph_annotations', { decorator: opts.decorator, limit });\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAItB,eAAe,QAAQ,QAAgB,UAAkB,MAA8C;AACrG,QAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,QAAM,EAAE,YAAY,IAAK,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,sBAAsB,CAAC;AAC3F,QAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AACtC,QAAM,UAAU,IAAI,YAAY,EAAE;AAClC,QAAM,SAAS,MAAM,QAAQ,OAAO,UAAU,EAAE,GAAG,MAAM,aAAa,OAAO,CAAC;AAC9E,KAAG,MAAM;AACT,QAAM,OAAe,OAAO,QAAQ,IAAI,CAAC,MAAW,EAAE,IAAI,EAAE,KAAK,EAAE;AACnE,UAAQ,IAAI,IAAI;AAClB;AAEO,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,2BAA2B,EACnC,YAAY,mDAAmD,EAC/D,OAAO,sBAAsB,0BAA0B,EACvD,OAAO,eAAe,eAAe,IAAI,EACzC,OAAO,OAAO,aAAiC,SAAgD;AAC9F,UAAM,SAAS,KAAK,QAAQ,eAAe,QAAQ,IAAI,CAAC;AACxD,UAAM,QAAQ,SAAS,KAAK,KAAK,KAAK;AACtC,UAAM,QAAQ,QAAQ,yBAAyB,EAAE,WAAW,KAAK,WAAW,MAAM,CAAC;AAAA,EACrF,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/ast-rewrite.js

@@ -0,0 +1,55 @@
+"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 ast_rewrite_exports = {};
+__export(ast_rewrite_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(ast_rewrite_exports);
+var path = __toESM(require("path"));
+async function runTool(target, toolName, args) {
+  const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+  const { ToolHandler } = await Promise.resolve().then(() => require("../../mcp/handler.js"));
+  const cg = await KiroGraph.open(target);
+  const handler = new ToolHandler(cg);
+  const result = await handler.handle(toolName, { ...args, projectPath: target });
+  cg.close();
+  const text = result.content.map((c) => c.text).join("");
+  console.log(text);
+}
+function register(program) {
+  program.command("ast-rewrite <file> <pattern> <rewrite> [projectPath]").description("Structural rewrite via ast-grep (requires ast-grep on PATH)").action(async (file, pattern, rewrite, projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    await runTool(target, "kirograph_ast_grep_rewrite", { file, pattern, rewrite });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=ast-rewrite.js.map

package/dist/bin/commands/ast-rewrite.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/ast-rewrite.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { dim, reset, violet, bold } from '../ui';\n\nasync function runTool(target: string, toolName: string, args: Record<string, unknown>): Promise<void> {\n  const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n  const { ToolHandler } = (await Promise.resolve().then(() => require('../../mcp/handler.js'))) as any;\n  const cg = await KiroGraph.open(target);\n  const handler = new ToolHandler(cg);\n  const result = await handler.handle(toolName, { ...args, projectPath: target });\n  cg.close();\n  const text: string = result.content.map((c: any) => c.text).join('');\n  console.log(text);\n}\n\nexport function register(program: Command): void {\n  program\n    .command('ast-rewrite <file> <pattern> <rewrite> [projectPath]')\n    .description('Structural rewrite via ast-grep (requires ast-grep on PATH)')\n    .action(async (file: string, pattern: string, rewrite: string, projectPath: string | undefined) => {\n      const target = path.resolve(projectPath ?? process.cwd());\n      await runTool(target, 'kirograph_ast_grep_rewrite', { file, pattern, rewrite });\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAItB,eAAe,QAAQ,QAAgB,UAAkB,MAA8C;AACrG,QAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,QAAM,EAAE,YAAY,IAAK,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,sBAAsB,CAAC;AAC3F,QAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AACtC,QAAM,UAAU,IAAI,YAAY,EAAE;AAClC,QAAM,SAAS,MAAM,QAAQ,OAAO,UAAU,EAAE,GAAG,MAAM,aAAa,OAAO,CAAC;AAC9E,KAAG,MAAM;AACT,QAAM,OAAe,OAAO,QAAQ,IAAI,CAAC,MAAW,EAAE,IAAI,EAAE,KAAK,EAAE;AACnE,UAAQ,IAAI,IAAI;AAClB;AAEO,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,sDAAsD,EAC9D,YAAY,6DAA6D,EACzE,OAAO,OAAO,MAAc,SAAiB,SAAiB,gBAAoC;AACjG,UAAM,SAAS,KAAK,QAAQ,eAAe,QAAQ,IAAI,CAAC;AACxD,UAAM,QAAQ,QAAQ,8BAA8B,EAAE,MAAM,SAAS,QAAQ,CAAC;AAAA,EAChF,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/bench.js

@@ -0,0 +1,103 @@
+"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 bench_exports = {};
+__export(bench_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(bench_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var import_ui = require("../ui");
+const BENCH_QUERIES = [
+  { label: "context:large-task", tool: "context", task: "Understand the main entry point and core data flow" },
+  { label: "context:small-task", tool: "context", task: "Find authentication logic" },
+  { label: "search:function", tool: "search", query: "handle" }
+];
+function register(program) {
+  program.command("bench [projectPath]").description("Quick token-efficiency benchmark on the current project").option("--quiet", "Output only the summary line").action(async (projectPath, opts) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    if (!KiroGraph.isInitialized(target)) {
+      console.error("Project not indexed. Run: kirograph index");
+      process.exit(1);
+    }
+    const cg = await KiroGraph.open(target);
+    const allNodes = cg.getAllNodes();
+    const sourceFiles = [...new Set(allNodes.map((n) => n.filePath))];
+    let naiveTokens = 0;
+    for (const fp of sourceFiles) {
+      try {
+        const fullPath = path.join(target, fp);
+        naiveTokens += Math.round(fs.statSync(fullPath).size / 4);
+      } catch {
+      }
+    }
+    if (!opts.quiet) {
+      console.log("\n  KiroGraph Local Bench");
+      console.log("  " + import_ui.dim + sourceFiles.length + " source files, ~" + naiveTokens.toLocaleString() + " naive tokens" + import_ui.reset);
+      console.log("");
+    }
+    let totalGraphTokens = 0;
+    let queryCount = 0;
+    for (const q of BENCH_QUERIES) {
+      const start = Date.now();
+      let responseText = "";
+      try {
+        if (q.tool === "context") {
+          const ctx = await cg.buildContext(q.task, { maxNodes: 20, includeCode: true });
+          responseText = ctx.summary + ctx.entryPoints.map((n) => n.name).join(" ");
+          for (const [, code] of ctx.codeSnippets) responseText += code;
+        } else {
+          const results = cg.searchNodes(q.query, void 0, 20);
+          responseText = results.map((r) => r.node.name + " " + r.node.filePath).join("\n");
+        }
+      } catch {
+      }
+      const graphTok = Math.round(responseText.length / 4);
+      totalGraphTokens += graphTok;
+      queryCount++;
+      const ms = Date.now() - start;
+      if (!opts.quiet) {
+        const savings = naiveTokens > 0 ? Math.round((1 - graphTok / naiveTokens) * 100) : 0;
+        console.log("  " + q.label + ": " + graphTok + " tok (" + savings + "% savings, " + ms + "ms)");
+      }
+    }
+    cg.close();
+    const avgTok = Math.round(totalGraphTokens / queryCount);
+    const avgSavings = naiveTokens > 0 ? Math.round((1 - avgTok / naiveTokens) * 100) : 0;
+    console.log("");
+    console.log("  avg " + avgSavings + "% token savings vs naive file reading");
+    console.log("");
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=bench.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/bench.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport * as fs from 'fs';\nimport { Command } from 'commander';\nimport { dim, reset } from '../ui';\n\nconst BENCH_QUERIES = [\n  { label: 'context:large-task', tool: 'context', task: 'Understand the main entry point and core data flow' },\n  { label: 'context:small-task', tool: 'context', task: 'Find authentication logic' },\n  { label: 'search:function', tool: 'search', query: 'handle' },\n];\n\nexport function register(program: Command): void {\n  program.command('bench [projectPath]')\n    .description('Quick token-efficiency benchmark on the current project')\n    .option('--quiet', 'Output only the summary line')\n    .action(async (projectPath: string | undefined, opts: { quiet?: boolean }) => {\n      const target = path.resolve(projectPath ?? process.cwd());\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      if (!KiroGraph.isInitialized(target)) {\n        console.error('Project not indexed. Run: kirograph index');\n        process.exit(1);\n      }\n      const cg = await KiroGraph.open(target);\n\n      // Estimate naive token cost: sum all source file sizes / 4\n      const allNodes = cg.getAllNodes();\n      const sourceFiles = [...new Set(allNodes.map((n: any) => n.filePath as string))];\n      let naiveTokens = 0;\n      for (const fp of sourceFiles) {\n        try {\n          const fullPath = path.join(target, fp);\n          naiveTokens += Math.round(fs.statSync(fullPath).size / 4);\n        } catch { /* skip */ }\n      }\n\n      if (!opts.quiet) {\n        console.log('\\n  KiroGraph Local Bench');\n        console.log('  ' + dim + sourceFiles.length + ' source files, ~' + naiveTokens.toLocaleString() + ' naive tokens' + reset);\n        console.log('');\n      }\n\n      let totalGraphTokens = 0;\n      let queryCount = 0;\n      for (const q of BENCH_QUERIES) {\n        const start = Date.now();\n        let responseText = '';\n        try {\n          if (q.tool === 'context') {\n            const ctx = await cg.buildContext(q.task as string, { maxNodes: 20, includeCode: true });\n            responseText = ctx.summary + ctx.entryPoints.map((n: any) => n.name).join(' ');\n            for (const [, code] of ctx.codeSnippets) responseText += code;\n          } else {\n            const results = cg.searchNodes(q.query as string, undefined, 20);\n            responseText = results.map((r: any) => r.node.name + ' ' + r.node.filePath).join('\\n');\n          }\n        } catch { /* skip */ }\n        const graphTok = Math.round(responseText.length / 4);\n        totalGraphTokens += graphTok;\n        queryCount++;\n        const ms = Date.now() - start;\n        if (!opts.quiet) {\n          const savings = naiveTokens > 0 ? Math.round((1 - graphTok / naiveTokens) * 100) : 0;\n          console.log('  ' + q.label + ': ' + graphTok + ' tok (' + savings + '% savings, ' + ms + 'ms)');\n        }\n      }\n      cg.close();\n\n      const avgTok = Math.round(totalGraphTokens / queryCount);\n      const avgSavings = naiveTokens > 0 ? Math.round((1 - avgTok / naiveTokens) * 100) : 0;\n      console.log('');\n      console.log('  avg ' + avgSavings + '% token savings vs naive file reading');\n      console.log('');\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/commands/branch.js

@@ -0,0 +1,133 @@
+"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 branch_exports = {};
+__export(branch_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(branch_exports);
+var path = __toESM(require("path"));
+async function runTool(target, toolName, args) {
+  const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+  const { ToolHandler } = await Promise.resolve().then(() => require("../../mcp/handler.js"));
+  const cg = await KiroGraph.open(target);
+  const handler = new ToolHandler(cg);
+  const result = await handler.handle(toolName, { ...args, projectPath: target });
+  cg.close();
+  const text = result.content.map((c) => c.text).join("");
+  console.log(text);
+}
+async function getBranchManager() {
+  try {
+    return await Promise.resolve().then(() => require("../../core/branch-manager.js"));
+  } catch {
+    return null;
+  }
+}
+function register(program) {
+  const branch = program.command("branch").description("Multi-branch graph management");
+  branch.command("list [projectPath]").description("List tracked branches").action(async (projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const bm = await getBranchManager();
+    if (!bm) {
+      console.error("  Branch manager not available in this build.");
+      process.exit(1);
+    }
+    const branches = bm.listTrackedBranches(target);
+    const current = bm.getCurrentGitBranch(target);
+    if (branches.length === 0) {
+      console.log("  No tracked branches. Use: kirograph branch add [name]");
+      return;
+    }
+    console.log("  Tracked branches (current git branch: " + current + "):");
+    for (const b of branches) {
+      const size = b.sizeBytes > 1048576 ? (b.sizeBytes / 1048576).toFixed(1) + " MB" : Math.round(b.sizeBytes / 1024) + " KB";
+      const sync = new Date(b.mtimeMs).toISOString().slice(0, 19);
+      console.log("  * " + b.name + "  " + size + "  synced " + sync);
+    }
+  });
+  branch.command("add [branchName] [projectPath]").description("Start tracking a branch").action(async (branchName, projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const bm = await getBranchManager();
+    if (!bm) {
+      console.error("  Branch manager not available in this build.");
+      process.exit(1);
+    }
+    const name = branchName ?? bm.getCurrentGitBranch(target);
+    try {
+      const r = bm.addBranch(target, name);
+      if (r.created) {
+        console.log("  Tracking branch " + name + " \u2192 " + r.dbPath);
+        console.log("  Run kirograph sync to populate.");
+      } else {
+        console.log("  Already tracking branch: " + name);
+      }
+    } catch (err) {
+      console.error("  Error: " + err.message);
+      process.exit(1);
+    }
+  });
+  branch.command("remove <branchName> [projectPath]").description("Stop tracking a branch").action(async (branchName, projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const bm = await getBranchManager();
+    if (!bm) {
+      console.error("  Branch manager not available in this build.");
+      process.exit(1);
+    }
+    const removed = bm.removeBranch(target, branchName);
+    console.log(removed ? "  Removed branch: " + branchName : "  Branch not tracked: " + branchName);
+  });
+  branch.command("gc [projectPath]").description("Remove DBs for deleted git branches").action(async (projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const bm = await getBranchManager();
+    if (!bm) {
+      console.error("  Branch manager not available in this build.");
+      process.exit(1);
+    }
+    const removed = bm.gcBranches(target);
+    if (removed.length === 0) {
+      console.log("  Nothing to clean up.");
+      return;
+    }
+    for (const name of removed) console.log("  Removed: " + name);
+    console.log("  Cleaned " + removed.length + " branch(es).");
+  });
+  branch.command("diff <branchA> [branchB] [projectPath]").description("Diff symbols between two tracked branches").action(async (branchA, branchB, projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    await runTool(target, "kirograph_branch_diff", { branchA, branchB: branchB ?? "main" });
+  });
+  branch.command("search <query> <branchName> [projectPath]").description("Search symbols in a tracked branch").action(async (query, branchName, projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    await runTool(target, "kirograph_branch_search", { query, branch: branchName });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=branch.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/branch.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\n\nasync function runTool(target: string, toolName: string, args: Record<string, unknown>): Promise<void> {\n  const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n  const { ToolHandler } = (await Promise.resolve().then(() => require('../../mcp/handler.js'))) as any;\n  const cg = await KiroGraph.open(target);\n  const handler = new ToolHandler(cg);\n  const result = await handler.handle(toolName, { ...args, projectPath: target });\n  cg.close();\n  const text: string = result.content.map((c: any) => c.text).join('');\n  console.log(text);\n}\n\nasync function getBranchManager() {\n  try {\n    return await Promise.resolve().then(() => require('../../core/branch-manager.js')) as any;\n  } catch {\n    return null;\n  }\n}\n\nexport function register(program: Command): void {\n  const branch = program.command('branch').description('Multi-branch graph management');\n\n  branch.command('list [projectPath]').description('List tracked branches').action(async (projectPath: string | undefined) => {\n    const target = path.resolve(projectPath ?? process.cwd());\n    const bm = await getBranchManager();\n    if (!bm) {\n      console.error('  Branch manager not available in this build.');\n      process.exit(1);\n    }\n    const branches = bm.listTrackedBranches(target);\n    const current = bm.getCurrentGitBranch(target);\n    if (branches.length === 0) {\n      console.log('  No tracked branches. Use: kirograph branch add [name]');\n      return;\n    }\n    console.log('  Tracked branches (current git branch: ' + current + '):');\n    for (const b of branches) {\n      const size = b.sizeBytes > 1048576 ? (b.sizeBytes / 1048576).toFixed(1) + ' MB' : Math.round(b.sizeBytes / 1024) + ' KB';\n      const sync = new Date(b.mtimeMs).toISOString().slice(0, 19);\n      console.log('  * ' + b.name + '  ' + size + '  synced ' + sync);\n    }\n  });\n\n  branch.command('add [branchName] [projectPath]').description('Start tracking a branch').action(async (branchName: string | undefined, projectPath: string | undefined) => {\n    const target = path.resolve(projectPath ?? process.cwd());\n    const bm = await getBranchManager();\n    if (!bm) {\n      console.error('  Branch manager not available in this build.');\n      process.exit(1);\n    }\n    const name = branchName ?? bm.getCurrentGitBranch(target);\n    try {\n      const r = bm.addBranch(target, name);\n      if (r.created) {\n        console.log('  Tracking branch ' + name + ' \u2192 ' + r.dbPath);\n        console.log('  Run kirograph sync to populate.');\n      } else {\n        console.log('  Already tracking branch: ' + name);\n      }\n    } catch (err: any) {\n      console.error('  Error: ' + err.message);\n      process.exit(1);\n    }\n  });\n\n  branch.command('remove <branchName> [projectPath]').description('Stop tracking a branch').action(async (branchName: string, projectPath: string | undefined) => {\n    const target = path.resolve(projectPath ?? process.cwd());\n    const bm = await getBranchManager();\n    if (!bm) {\n      console.error('  Branch manager not available in this build.');\n      process.exit(1);\n    }\n    const removed = bm.removeBranch(target, branchName);\n    console.log(removed ? '  Removed branch: ' + branchName : '  Branch not tracked: ' + branchName);\n  });\n\n  branch.command('gc [projectPath]').description('Remove DBs for deleted git branches').action(async (projectPath: string | undefined) => {\n    const target = path.resolve(projectPath ?? process.cwd());\n    const bm = await getBranchManager();\n    if (!bm) {\n      console.error('  Branch manager not available in this build.');\n      process.exit(1);\n    }\n    const removed = bm.gcBranches(target);\n    if (removed.length === 0) { console.log('  Nothing to clean up.'); return; }\n    for (const name of removed) console.log('  Removed: ' + name);\n    console.log('  Cleaned ' + removed.length + ' branch(es).');\n  });\n\n  branch.command('diff <branchA> [branchB] [projectPath]').description('Diff symbols between two tracked branches').action(async (branchA: string, branchB: string | undefined, projectPath: string | undefined) => {\n    const target = path.resolve(projectPath ?? process.cwd());\n    await runTool(target, 'kirograph_branch_diff', { branchA, branchB: branchB ?? 'main' });\n  });\n\n  branch.command('search <query> <branchName> [projectPath]').description('Search symbols in a tracked branch').action(async (query: string, branchName: string, projectPath: string | undefined) => {\n    const target = path.resolve(projectPath ?? process.cwd());\n    await runTool(target, 'kirograph_branch_search', { query, branch: branchName });\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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": []
+}