kirograph 0.14.1 → 0.15.0

package/dist/bin/installer/targets/trae.js

@@ -0,0 +1,84 @@
+"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 trae_exports = {};
+__export(trae_exports, {
+  installTraeEarly: () => installTraeEarly,
+  installTraeLate: () => installTraeLate,
+  printTraeNextSteps: () => printTraeNextSteps,
+  uninitTrae: () => uninitTrae
+});
+module.exports = __toCommonJS(trae_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_common = require("../common");
+var import_instructions = require("../instructions");
+var import_common2 = require("../common");
+function installTraeEarly(projectRoot) {
+  const mcpPath = path.join(projectRoot, ".trae", "mcp.json");
+  (0, import_common.writeMcpServersConfig)(mcpPath, {
+    command: import_common.KIROGRAPH_COMMAND,
+    args: import_common.KIROGRAPH_MCP_ARGS
+  });
+  console.log(`  \u2713 Trae MCP server registered in ${mcpPath}`);
+}
+function installTraeLate(projectRoot, cavemanMode, shellCompressionLevel, enableMemory) {
+  const instructionsPath = path.join(projectRoot, ".kirograph", "trae.md");
+  (0, import_common.ensureDir)(path.dirname(instructionsPath));
+  fs.writeFileSync(instructionsPath, (0, import_instructions.buildAgentInstructions)((0, import_common2.buildInstructionOpts)(cavemanMode, shellCompressionLevel, enableMemory)));
+  console.log(`  \u2713 Trae instructions written to ${instructionsPath}`);
+  const rulesDir = path.join(projectRoot, ".trae", "rules");
+  (0, import_common.ensureDir)(rulesDir);
+  const rulePath = path.join(rulesDir, "kirograph.md");
+  const frontmatter = "---\nalwaysApply: true\n---\n\n";
+  fs.writeFileSync(rulePath, frontmatter + (0, import_instructions.buildAgentInstructions)((0, import_common2.buildInstructionOpts)(cavemanMode, shellCompressionLevel, enableMemory)));
+  console.log(`  \u2713 Trae rule written to ${rulePath}`);
+}
+function uninitTrae(projectRoot) {
+  const mcpPath = path.join(projectRoot, ".trae", "mcp.json");
+  if ((0, import_common.removeMcpServersConfig)(mcpPath)) {
+    console.log(`  \u2713 Removed kirograph from .trae/mcp.json`);
+  }
+  const rulePath = path.join(projectRoot, ".trae", "rules", "kirograph.md");
+  if (fs.existsSync(rulePath)) {
+    fs.unlinkSync(rulePath);
+    console.log(`  \u2713 Removed .trae/rules/kirograph.md`);
+  }
+}
+function printTraeNextSteps() {
+  console.log("\n  Done! Restart Trae for the MCP server to load.");
+  console.log("  KiroGraph rule is in .trae/rules/kirograph.md\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  installTraeEarly,
+  installTraeLate,
+  printTraeNextSteps,
+  uninitTrae
+});
+//# sourceMappingURL=trae.js.map

package/dist/bin/installer/targets/trae.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bin/installer/targets/trae.ts"],
+  "sourcesContent": ["import * as fs from 'fs';\nimport * as path from 'path';\nimport { CavemanMode } from '../caveman';\nimport {\n  ensureDir,\n  KIROGRAPH_COMMAND,\n  KIROGRAPH_MCP_ARGS,\n  removeMcpServersConfig,\n  writeMcpServersConfig,\n} from '../common';\nimport { buildAgentInstructions } from '../instructions';\nimport { buildInstructionOpts } from '../common';\n\nexport function installTraeEarly(projectRoot: string): void {\n  const mcpPath = path.join(projectRoot, '.trae', 'mcp.json');\n  writeMcpServersConfig(mcpPath, {\n    command: KIROGRAPH_COMMAND,\n    args: KIROGRAPH_MCP_ARGS,\n  });\n  console.log(`  \u2713 Trae MCP server registered in ${mcpPath}`);\n}\n\nexport function installTraeLate(projectRoot: string, cavemanMode?: CavemanMode | 'off', shellCompressionLevel?: string, enableMemory?: boolean): void {\n  const instructionsPath = path.join(projectRoot, '.kirograph', 'trae.md');\n  ensureDir(path.dirname(instructionsPath));\n  fs.writeFileSync(instructionsPath, buildAgentInstructions(buildInstructionOpts(cavemanMode, shellCompressionLevel, enableMemory)));\n  console.log(`  \u2713 Trae instructions written to ${instructionsPath}`);\n\n  const rulesDir = path.join(projectRoot, '.trae', 'rules');\n  ensureDir(rulesDir);\n  const rulePath = path.join(rulesDir, 'kirograph.md');\n  const frontmatter = '---\\nalwaysApply: true\\n---\\n\\n';\n  fs.writeFileSync(rulePath, frontmatter + buildAgentInstructions(buildInstructionOpts(cavemanMode, shellCompressionLevel, enableMemory)));\n  console.log(`  \u2713 Trae rule written to ${rulePath}`);\n}\n\nexport function uninitTrae(projectRoot: string): void {\n  const mcpPath = path.join(projectRoot, '.trae', 'mcp.json');\n  if (removeMcpServersConfig(mcpPath)) {\n    console.log(`  \u2713 Removed kirograph from .trae/mcp.json`);\n  }\n\n  const rulePath = path.join(projectRoot, '.trae', 'rules', 'kirograph.md');\n  if (fs.existsSync(rulePath)) {\n    fs.unlinkSync(rulePath);\n    console.log(`  \u2713 Removed .trae/rules/kirograph.md`);\n  }\n}\n\nexport function printTraeNextSteps(): void {\n  console.log('\\n  Done! Restart Trae for the MCP server to load.');\n  console.log('  KiroGraph rule is in .trae/rules/kirograph.md\\n');\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAoB;AACpB,WAAsB;AAEtB,oBAMO;AACP,0BAAuC;AACvC,IAAAA,iBAAqC;AAE9B,SAAS,iBAAiB,aAA2B;AAC1D,QAAM,UAAU,KAAK,KAAK,aAAa,SAAS,UAAU;AAC1D,2CAAsB,SAAS;AAAA,IAC7B,SAAS;AAAA,IACT,MAAM;AAAA,EACR,CAAC;AACD,UAAQ,IAAI,0CAAqC,OAAO,EAAE;AAC5D;AAEO,SAAS,gBAAgB,aAAqB,aAAmC,uBAAgC,cAA8B;AACpJ,QAAM,mBAAmB,KAAK,KAAK,aAAa,cAAc,SAAS;AACvE,+BAAU,KAAK,QAAQ,gBAAgB,CAAC;AACxC,KAAG,cAAc,sBAAkB,gDAAuB,qCAAqB,aAAa,uBAAuB,YAAY,CAAC,CAAC;AACjI,UAAQ,IAAI,yCAAoC,gBAAgB,EAAE;AAElE,QAAM,WAAW,KAAK,KAAK,aAAa,SAAS,OAAO;AACxD,+BAAU,QAAQ;AAClB,QAAM,WAAW,KAAK,KAAK,UAAU,cAAc;AACnD,QAAM,cAAc;AACpB,KAAG,cAAc,UAAU,kBAAc,gDAAuB,qCAAqB,aAAa,uBAAuB,YAAY,CAAC,CAAC;AACvI,UAAQ,IAAI,iCAA4B,QAAQ,EAAE;AACpD;AAEO,SAAS,WAAW,aAA2B;AACpD,QAAM,UAAU,KAAK,KAAK,aAAa,SAAS,UAAU;AAC1D,UAAI,sCAAuB,OAAO,GAAG;AACnC,YAAQ,IAAI,gDAA2C;AAAA,EACzD;AAEA,QAAM,WAAW,KAAK,KAAK,aAAa,SAAS,SAAS,cAAc;AACxE,MAAI,GAAG,WAAW,QAAQ,GAAG;AAC3B,OAAG,WAAW,QAAQ;AACtB,YAAQ,IAAI,2CAAsC;AAAA,EACpD;AACF;AAEO,SAAS,qBAA2B;AACzC,UAAQ,IAAI,oDAAoD;AAChE,UAAQ,IAAI,mDAAmD;AACjE;",
+  "names": ["import_common"]
+}

package/dist/bin/installer/targets/warp.js

@@ -0,0 +1,97 @@
+"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 warp_exports = {};
+__export(warp_exports, {
+  installWarpEarly: () => installWarpEarly,
+  installWarpLate: () => installWarpLate,
+  printWarpNextSteps: () => printWarpNextSteps,
+  uninitWarp: () => uninitWarp
+});
+module.exports = __toCommonJS(warp_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_common = require("../common");
+var import_instructions = require("../instructions");
+const WARP_BLOCK_ID = "warp";
+function installWarpEarly(projectRoot) {
+  const mcpPath = path.join(projectRoot, ".warp", ".mcp.json");
+  (0, import_common.ensureDir)(path.dirname(mcpPath));
+  const config = (0, import_common.readJson)(mcpPath);
+  config.mcpServers = config.mcpServers ?? {};
+  config.mcpServers[import_common.KIROGRAPH_SERVER_NAME] = {
+    command: import_common.KIROGRAPH_COMMAND,
+    args: import_common.KIROGRAPH_MCP_ARGS
+  };
+  (0, import_common.writeJson)(mcpPath, config);
+  console.log(`  \u2713 Warp MCP server registered in ${mcpPath}`);
+}
+function installWarpLate(projectRoot, cavemanMode, shellCompressionLevel, enableMemory) {
+  const opts = (0, import_common.buildInstructionOpts)(cavemanMode, shellCompressionLevel, enableMemory);
+  const instructionsPath = path.join(projectRoot, ".kirograph", "warp.md");
+  (0, import_common.ensureDir)(path.dirname(instructionsPath));
+  fs.writeFileSync(instructionsPath, (0, import_instructions.buildAgentInstructions)(opts));
+  console.log(`  \u2713 Warp instructions written to ${instructionsPath}`);
+  const agentsPath = path.join(projectRoot, "AGENTS.md");
+  const changed = (0, import_common.upsertGeneratedBlock)(agentsPath, WARP_BLOCK_ID, "## KiroGraph", (0, import_instructions.buildAgentInstructions)(opts));
+  console.log(changed ? `  \u2713 AGENTS.md updated with KiroGraph instructions (Warp)` : `  \u2713 AGENTS.md already up to date`);
+  const legacyRule = path.join(projectRoot, ".warp", "rules", "kirograph.md");
+  if (fs.existsSync(legacyRule)) {
+    fs.unlinkSync(legacyRule);
+    console.log(`  \u2713 Removed legacy .warp/rules/kirograph.md`);
+  }
+}
+function uninitWarp(projectRoot) {
+  const mcpPath = path.join(projectRoot, ".warp", ".mcp.json");
+  if (fs.existsSync(mcpPath)) {
+    const config = (0, import_common.readJson)(mcpPath);
+    if (config.mcpServers?.[import_common.KIROGRAPH_SERVER_NAME]) {
+      delete config.mcpServers[import_common.KIROGRAPH_SERVER_NAME];
+      if (Object.keys(config.mcpServers).length === 0) delete config.mcpServers;
+      (0, import_common.writeJson)(mcpPath, config);
+      console.log(`  \u2713 Removed kirograph from .warp/.mcp.json`);
+    }
+  }
+  const agentsPath = path.join(projectRoot, "AGENTS.md");
+  if ((0, import_common.removeGeneratedBlock)(agentsPath, WARP_BLOCK_ID)) {
+    console.log(`  \u2713 Removed KiroGraph block from AGENTS.md (Warp)`);
+  }
+}
+function printWarpNextSteps() {
+  console.log("\n  Done! Restart Warp for the MCP server to load.");
+  console.log("  MCP is in .warp/.mcp.json");
+  console.log("  KiroGraph instructions are in AGENTS.md\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  installWarpEarly,
+  installWarpLate,
+  printWarpNextSteps,
+  uninitWarp
+});
+//# sourceMappingURL=warp.js.map

package/dist/bin/installer/targets/warp.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bin/installer/targets/warp.ts"],
+  "sourcesContent": ["/**\n * Warp target.\n *\n * MCP: .warp/.mcp.json (project-level, standard mcpServers format)\n * Rules: AGENTS.md (Warp reads this natively, upsert block)\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { CavemanMode } from '../caveman';\nimport {\n  ensureDir,\n  buildInstructionOpts,\n  readJson,\n  writeJson,\n  KIROGRAPH_COMMAND,\n  KIROGRAPH_MCP_ARGS,\n  KIROGRAPH_SERVER_NAME,\n  upsertGeneratedBlock,\n  removeGeneratedBlock,\n} from '../common';\nimport { buildAgentInstructions } from '../instructions';\n\nconst WARP_BLOCK_ID = 'warp';\n\nexport function installWarpEarly(projectRoot: string): void {\n  // Write MCP to .warp/.mcp.json (project-level)\n  const mcpPath = path.join(projectRoot, '.warp', '.mcp.json');\n  ensureDir(path.dirname(mcpPath));\n  const config = readJson(mcpPath);\n  config.mcpServers = config.mcpServers ?? {};\n  config.mcpServers[KIROGRAPH_SERVER_NAME] = {\n    command: KIROGRAPH_COMMAND,\n    args: KIROGRAPH_MCP_ARGS,\n  };\n  writeJson(mcpPath, config);\n  console.log(`  \u2713 Warp MCP server registered in ${mcpPath}`);\n}\n\nexport function installWarpLate(projectRoot: string, cavemanMode?: CavemanMode | 'off', shellCompressionLevel?: string, enableMemory?: boolean): void {\n  const opts = buildInstructionOpts(cavemanMode, shellCompressionLevel, enableMemory);\n\n  const instructionsPath = path.join(projectRoot, '.kirograph', 'warp.md');\n  ensureDir(path.dirname(instructionsPath));\n  fs.writeFileSync(instructionsPath, buildAgentInstructions(opts));\n  console.log(`  \u2713 Warp instructions written to ${instructionsPath}`);\n\n  // Write to AGENTS.md (Warp reads this natively)\n  const agentsPath = path.join(projectRoot, 'AGENTS.md');\n  const changed = upsertGeneratedBlock(agentsPath, WARP_BLOCK_ID, '## KiroGraph', buildAgentInstructions(opts));\n  console.log(changed\n    ? `  \u2713 AGENTS.md updated with KiroGraph instructions (Warp)`\n    : `  \u2713 AGENTS.md already up to date`);\n\n  // Remove legacy .warp/rules/kirograph.md if it exists\n  const legacyRule = path.join(projectRoot, '.warp', 'rules', 'kirograph.md');\n  if (fs.existsSync(legacyRule)) {\n    fs.unlinkSync(legacyRule);\n    console.log(`  \u2713 Removed legacy .warp/rules/kirograph.md`);\n  }\n}\n\nexport function uninitWarp(projectRoot: string): void {\n  // Remove MCP entry\n  const mcpPath = path.join(projectRoot, '.warp', '.mcp.json');\n  if (fs.existsSync(mcpPath)) {\n    const config = readJson(mcpPath);\n    if (config.mcpServers?.[KIROGRAPH_SERVER_NAME]) {\n      delete config.mcpServers[KIROGRAPH_SERVER_NAME];\n      if (Object.keys(config.mcpServers).length === 0) delete config.mcpServers;\n      writeJson(mcpPath, config);\n      console.log(`  \u2713 Removed kirograph from .warp/.mcp.json`);\n    }\n  }\n\n  // Remove AGENTS.md block\n  const agentsPath = path.join(projectRoot, 'AGENTS.md');\n  if (removeGeneratedBlock(agentsPath, WARP_BLOCK_ID)) {\n    console.log(`  \u2713 Removed KiroGraph block from AGENTS.md (Warp)`);\n  }\n}\n\nexport function printWarpNextSteps(): void {\n  console.log('\\n  Done! Restart Warp for the MCP server to load.');\n  console.log('  MCP is in .warp/.mcp.json');\n  console.log('  KiroGraph instructions are in AGENTS.md\\n');\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAoB;AACpB,WAAsB;AAEtB,oBAUO;AACP,0BAAuC;AAEvC,MAAM,gBAAgB;AAEf,SAAS,iBAAiB,aAA2B;AAE1D,QAAM,UAAU,KAAK,KAAK,aAAa,SAAS,WAAW;AAC3D,+BAAU,KAAK,QAAQ,OAAO,CAAC;AAC/B,QAAM,aAAS,wBAAS,OAAO;AAC/B,SAAO,aAAa,OAAO,cAAc,CAAC;AAC1C,SAAO,WAAW,mCAAqB,IAAI;AAAA,IACzC,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AACA,+BAAU,SAAS,MAAM;AACzB,UAAQ,IAAI,0CAAqC,OAAO,EAAE;AAC5D;AAEO,SAAS,gBAAgB,aAAqB,aAAmC,uBAAgC,cAA8B;AACpJ,QAAM,WAAO,oCAAqB,aAAa,uBAAuB,YAAY;AAElF,QAAM,mBAAmB,KAAK,KAAK,aAAa,cAAc,SAAS;AACvE,+BAAU,KAAK,QAAQ,gBAAgB,CAAC;AACxC,KAAG,cAAc,sBAAkB,4CAAuB,IAAI,CAAC;AAC/D,UAAQ,IAAI,yCAAoC,gBAAgB,EAAE;AAGlE,QAAM,aAAa,KAAK,KAAK,aAAa,WAAW;AACrD,QAAM,cAAU,oCAAqB,YAAY,eAAe,oBAAgB,4CAAuB,IAAI,CAAC;AAC5G,UAAQ,IAAI,UACR,kEACA,uCAAkC;AAGtC,QAAM,aAAa,KAAK,KAAK,aAAa,SAAS,SAAS,cAAc;AAC1E,MAAI,GAAG,WAAW,UAAU,GAAG;AAC7B,OAAG,WAAW,UAAU;AACxB,YAAQ,IAAI,kDAA6C;AAAA,EAC3D;AACF;AAEO,SAAS,WAAW,aAA2B;AAEpD,QAAM,UAAU,KAAK,KAAK,aAAa,SAAS,WAAW;AAC3D,MAAI,GAAG,WAAW,OAAO,GAAG;AAC1B,UAAM,aAAS,wBAAS,OAAO;AAC/B,QAAI,OAAO,aAAa,mCAAqB,GAAG;AAC9C,aAAO,OAAO,WAAW,mCAAqB;AAC9C,UAAI,OAAO,KAAK,OAAO,UAAU,EAAE,WAAW,EAAG,QAAO,OAAO;AAC/D,mCAAU,SAAS,MAAM;AACzB,cAAQ,IAAI,iDAA4C;AAAA,IAC1D;AAAA,EACF;AAGA,QAAM,aAAa,KAAK,KAAK,aAAa,WAAW;AACrD,UAAI,oCAAqB,YAAY,aAAa,GAAG;AACnD,YAAQ,IAAI,wDAAmD;AAAA,EACjE;AACF;AAEO,SAAS,qBAA2B;AACzC,UAAQ,IAAI,oDAAoD;AAChE,UAAQ,IAAI,6BAA6B;AACzC,UAAQ,IAAI,6CAA6C;AAC3D;",
+  "names": []
+}

package/dist/bin/installer/targets/windsurf.js

@@ -0,0 +1,141 @@
+"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 windsurf_exports = {};
+__export(windsurf_exports, {
+  installWindsurfEarly: () => installWindsurfEarly,
+  installWindsurfLate: () => installWindsurfLate,
+  printWindsurfNextSteps: () => printWindsurfNextSteps,
+  uninitWindsurf: () => uninitWindsurf
+});
+module.exports = __toCommonJS(windsurf_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_common = require("../common");
+var import_instructions = require("../instructions");
+const WINDSURF_RULES_FILE = "kirograph.md";
+function buildWindsurfHooks() {
+  return {
+    hooks: {
+      post_cascade_response: [
+        { command: "kirograph sync --quiet 2>/dev/null || true", show_output: false }
+      ]
+    }
+  };
+}
+function buildWindsurfRule(instructions) {
+  const frontmatter = [
+    "---",
+    "trigger: always_on",
+    "---",
+    ""
+  ].join("\n");
+  return frontmatter + instructions;
+}
+function installWindsurfEarly(_projectRoot) {
+}
+function installWindsurfLate(projectRoot, cavemanMode, shellCompressionLevel, enableMemory) {
+  const opts = (0, import_common.buildInstructionOpts)(cavemanMode, shellCompressionLevel, enableMemory, true);
+  const instructionsPath = path.join(projectRoot, ".kirograph", "windsurf.md");
+  (0, import_common.ensureDir)(path.dirname(instructionsPath));
+  fs.writeFileSync(instructionsPath, (0, import_instructions.buildAgentInstructions)(opts));
+  console.log(`  \u2713 Windsurf instructions written to ${instructionsPath}`);
+  const rulesDir = path.join(projectRoot, ".windsurf", "rules");
+  (0, import_common.ensureDir)(rulesDir);
+  const rulePath = path.join(rulesDir, WINDSURF_RULES_FILE);
+  fs.writeFileSync(rulePath, buildWindsurfRule((0, import_instructions.buildAgentInstructions)(opts)));
+  console.log(`  \u2713 Windsurf rule written to ${rulePath}`);
+  const legacyPath = path.join(projectRoot, ".windsurfrules");
+  if (fs.existsSync(legacyPath)) {
+    const content = fs.readFileSync(legacyPath, "utf8");
+    if (content.includes("kirograph")) {
+      fs.unlinkSync(legacyPath);
+      console.log(`  \u2713 Removed legacy .windsurfrules (migrated to .windsurf/rules/)`);
+    }
+  }
+  const hooksPath = path.join(projectRoot, ".windsurf", "hooks.json");
+  const existing = (0, import_common.readJson)(hooksPath);
+  const kgHooks = buildWindsurfHooks();
+  existing.hooks = existing.hooks ?? {};
+  for (const [event, commands] of Object.entries(kgHooks.hooks)) {
+    existing.hooks[event] = existing.hooks[event] ?? [];
+    for (const cmd of commands) {
+      if (!existing.hooks[event].some((h) => h.command === cmd.command)) {
+        existing.hooks[event].push(cmd);
+      }
+    }
+  }
+  (0, import_common.writeJson)(hooksPath, existing);
+  console.log(`  \u2713 Windsurf hooks written to ${hooksPath}`);
+}
+function uninitWindsurf(projectRoot) {
+  const rulePath = path.join(projectRoot, ".windsurf", "rules", WINDSURF_RULES_FILE);
+  if (fs.existsSync(rulePath)) {
+    fs.unlinkSync(rulePath);
+    console.log(`  \u2713 Removed .windsurf/rules/${WINDSURF_RULES_FILE}`);
+  }
+  const legacyPath = path.join(projectRoot, ".windsurfrules");
+  if (fs.existsSync(legacyPath)) {
+    const content = fs.readFileSync(legacyPath, "utf8");
+    if (content.includes("kirograph")) {
+      fs.unlinkSync(legacyPath);
+      console.log(`  \u2713 Removed legacy .windsurfrules`);
+    }
+  }
+  const hooksPath = path.join(projectRoot, ".windsurf", "hooks.json");
+  if (fs.existsSync(hooksPath)) {
+    const config = (0, import_common.readJson)(hooksPath);
+    if (config.hooks) {
+      let changed = false;
+      for (const event of Object.keys(config.hooks)) {
+        const before = config.hooks[event].length;
+        config.hooks[event] = config.hooks[event].filter((h) => !h.command?.includes("kirograph"));
+        if (config.hooks[event].length === 0) delete config.hooks[event];
+        if (config.hooks[event]?.length !== before) changed = true;
+      }
+      if (Object.keys(config.hooks).length === 0) delete config.hooks;
+      if (changed) {
+        (0, import_common.writeJson)(hooksPath, config);
+        console.log(`  \u2713 Removed kirograph hooks from .windsurf/hooks.json`);
+      }
+    }
+  }
+}
+function printWindsurfNextSteps(projectRoot) {
+  console.log("\n  Done! KiroGraph rule is in .windsurf/rules/kirograph.md");
+  console.log("  Auto-sync hook is in .windsurf/hooks.json");
+  (0, import_common.printMcpSetup)("~/.codeium/windsurf/mcp_config.json", projectRoot);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  installWindsurfEarly,
+  installWindsurfLate,
+  printWindsurfNextSteps,
+  uninitWindsurf
+});
+//# sourceMappingURL=windsurf.js.map

package/dist/bin/installer/targets/windsurf.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/bin/installer/targets/windsurf.ts"],
+  "sourcesContent": ["/**\n * Windsurf target.\n *\n * MCP: user-scoped at ~/.codeium/windsurf/mcp_config.json (print instructions)\n * Rules: .windsurf/rules/kirograph.md (workspace-level, with frontmatter)\n * Hooks: .windsurf/hooks.json (workspace-level)\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { CavemanMode } from '../caveman';\nimport {\n  ensureDir,\n  buildInstructionOpts,\n  readJson,\n  writeJson,\n  printMcpSetup,\n} from '../common';\nimport { buildAgentInstructions } from '../instructions';\n\nconst WINDSURF_RULES_FILE = 'kirograph.md';\n\nfunction buildWindsurfHooks(): object {\n  return {\n    hooks: {\n      post_cascade_response: [\n        { command: 'kirograph sync --quiet 2>/dev/null || true', show_output: false },\n      ],\n    },\n  };\n}\n\nfunction buildWindsurfRule(instructions: string): string {\n  const frontmatter = [\n    '---',\n    'trigger: always_on',\n    '---',\n    '',\n  ].join('\\n');\n  return frontmatter + instructions;\n}\n\nexport function installWindsurfEarly(_projectRoot: string): void {\n  // Windsurf MCP is user-scoped at ~/.codeium/windsurf/mcp_config.json.\n  // We print the setup instructions in printNextSteps.\n}\n\nexport function installWindsurfLate(projectRoot: string, cavemanMode?: CavemanMode | 'off', shellCompressionLevel?: string, enableMemory?: boolean): void {\n  const opts = buildInstructionOpts(cavemanMode, shellCompressionLevel, enableMemory, true);\n\n  const instructionsPath = path.join(projectRoot, '.kirograph', 'windsurf.md');\n  ensureDir(path.dirname(instructionsPath));\n  fs.writeFileSync(instructionsPath, buildAgentInstructions(opts));\n  console.log(`  \u2713 Windsurf instructions written to ${instructionsPath}`);\n\n  // Write rules file inside .windsurf/rules/ with frontmatter\n  const rulesDir = path.join(projectRoot, '.windsurf', 'rules');\n  ensureDir(rulesDir);\n  const rulePath = path.join(rulesDir, WINDSURF_RULES_FILE);\n  fs.writeFileSync(rulePath, buildWindsurfRule(buildAgentInstructions(opts)));\n  console.log(`  \u2713 Windsurf rule written to ${rulePath}`);\n\n  // Remove legacy .windsurfrules if it exists and was created by us\n  const legacyPath = path.join(projectRoot, '.windsurfrules');\n  if (fs.existsSync(legacyPath)) {\n    const content = fs.readFileSync(legacyPath, 'utf8');\n    if (content.includes('kirograph')) {\n      fs.unlinkSync(legacyPath);\n      console.log(`  \u2713 Removed legacy .windsurfrules (migrated to .windsurf/rules/)`);\n    }\n  }\n\n  // Write hooks\n  const hooksPath = path.join(projectRoot, '.windsurf', 'hooks.json');\n  const existing = readJson(hooksPath);\n  const kgHooks = buildWindsurfHooks() as any;\n  existing.hooks = existing.hooks ?? {};\n  for (const [event, commands] of Object.entries(kgHooks.hooks)) {\n    existing.hooks[event] = existing.hooks[event] ?? [];\n    for (const cmd of commands as Array<{ command: string; show_output: boolean }>) {\n      if (!existing.hooks[event].some((h: any) => h.command === cmd.command)) {\n        existing.hooks[event].push(cmd);\n      }\n    }\n  }\n  writeJson(hooksPath, existing);\n  console.log(`  \u2713 Windsurf hooks written to ${hooksPath}`);\n}\n\nexport function uninitWindsurf(projectRoot: string): void {\n  // Remove rule file\n  const rulePath = path.join(projectRoot, '.windsurf', 'rules', WINDSURF_RULES_FILE);\n  if (fs.existsSync(rulePath)) {\n    fs.unlinkSync(rulePath);\n    console.log(`  \u2713 Removed .windsurf/rules/${WINDSURF_RULES_FILE}`);\n  }\n\n  // Remove legacy .windsurfrules block\n  const legacyPath = path.join(projectRoot, '.windsurfrules');\n  if (fs.existsSync(legacyPath)) {\n    const content = fs.readFileSync(legacyPath, 'utf8');\n    if (content.includes('kirograph')) {\n      fs.unlinkSync(legacyPath);\n      console.log(`  \u2713 Removed legacy .windsurfrules`);\n    }\n  }\n\n  // Remove kirograph hooks\n  const hooksPath = path.join(projectRoot, '.windsurf', 'hooks.json');\n  if (fs.existsSync(hooksPath)) {\n    const config = readJson(hooksPath);\n    if (config.hooks) {\n      let changed = false;\n      for (const event of Object.keys(config.hooks)) {\n        const before = config.hooks[event].length;\n        config.hooks[event] = config.hooks[event].filter((h: any) => !h.command?.includes('kirograph'));\n        if (config.hooks[event].length === 0) delete config.hooks[event];\n        if (config.hooks[event]?.length !== before) changed = true;\n      }\n      if (Object.keys(config.hooks).length === 0) delete config.hooks;\n      if (changed) {\n        writeJson(hooksPath, config);\n        console.log(`  \u2713 Removed kirograph hooks from .windsurf/hooks.json`);\n      }\n    }\n  }\n}\n\nexport function printWindsurfNextSteps(projectRoot: string): void {\n  console.log('\\n  Done! KiroGraph rule is in .windsurf/rules/kirograph.md');\n  console.log('  Auto-sync hook is in .windsurf/hooks.json');\n  printMcpSetup('~/.codeium/windsurf/mcp_config.json', projectRoot);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/kirograph.js

@@ -31,6 +31,7 @@ var import_export = require("./commands/export");
 var import_gain = require("./commands/gain");
 var import_compression = require("./commands/compression");
 var import_exec = require("./commands/exec");
+var import_memory = require("./commands/memory");
 process.on("uncaughtException", (err) => {
   const msg = err?.message ?? String(err);
   const isWasmAbort = msg.includes("Aborted(") || msg.includes("RuntimeError") || err?.constructor?.name === "RuntimeError";
@@ -59,7 +60,7 @@ process.on("uncaughtException", (err) => {
   process.exit(1);
 });
 const program = new import_commander.Command();
-program.name("kirograph").description("Semantic code knowledge graph for Kiro").version("0.14.1").addHelpCommand(true).hook("preAction", (thisCommand) => {
+program.name("kirograph").description("Semantic code knowledge graph for Kiro").version("0.15.0").addHelpCommand(true).hook("preAction", (thisCommand) => {
   const name = thisCommand.name();
   if (name === "init") (0, import_banner.printBanner)();
 });
@@ -91,6 +92,7 @@ program.name("kirograph").description("Semantic code knowledge graph for Kiro").
 (0, import_gain.register)(program);
 (0, import_compression.register)(program);
 (0, import_exec.register)(program);
+(0, import_memory.register)(program);
 if (process.argv.length === 2) {
   (0, import_banner.printBanner)();
   (0, import_help.printColoredHelp)();

package/dist/bin/kirograph.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bin/kirograph.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n/**\n * KiroGraph CLI\n */\n\nimport { Command } from 'commander';\nimport { printBanner } from './banner';\nimport { printColoredHelp, register as registerHelp } from './commands/help';\nimport { register as registerInit } from './commands/init';\nimport { register as registerUninit } from './commands/uninit';\nimport { register as registerIndex } from './commands/index';\nimport { register as registerSync } from './commands/sync';\nimport { register as registerStatus } from './commands/status';\nimport { register as registerQuery } from './commands/query';\nimport { register as registerFiles } from './commands/files';\nimport { register as registerContext } from './commands/context';\nimport { register as registerAffected } from './commands/affected';\nimport { register as registerMarkDirty } from './commands/mark-dirty';\nimport { register as registerSyncIfDirty } from './commands/sync-if-dirty';\nimport { register as registerUnlock } from './commands/unlock';\nimport { register as registerInstall } from './commands/install';\nimport { register as registerServe } from './commands/serve';\nimport { register as registerDashboard } from './commands/dashboard';\nimport { register as registerArchitecture } from './commands/architecture';\nimport { register as registerCoupling } from './commands/coupling';\nimport { register as registerPackage } from './commands/package';\nimport { register as registerCaveman } from './commands/caveman';\nimport { register as registerDeadCode } from './commands/dead-code';\nimport { register as registerHotspots } from './commands/hotspots';\nimport { register as registerSurprising } from './commands/surprising';\nimport { register as registerSnapshot } from './commands/snapshot';\nimport { register as registerPath } from './commands/path';\nimport { register as registerExport } from './commands/export';\nimport { register as registerGain } from './commands/gain';\nimport { register as registerCompression } from './commands/compression';\nimport { register as registerExec } from './commands/exec';\n\n// \u2500\u2500 Global error handler for WASM runtime crashes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// node-sqlite3-wasm calls process.abort() when it hits a fatal error (e.g.\n// database is locked by another process). This produces a raw \"Aborted()\"\n// message with no context. We intercept it here to print a clear explanation\n// before the process exits.\nprocess.on('uncaughtException', (err: Error) => {\n  const msg = err?.message ?? String(err);\n  const isWasmAbort = msg.includes('Aborted(') || msg.includes('RuntimeError') || (err as any)?.constructor?.name === 'RuntimeError';\n\n  if (isWasmAbort) {\n    process.stderr.write([\n      '',\n      '  \u2716 KiroGraph crashed: SQLite WASM runtime aborted.',\n      '',\n      '  Most likely cause: another process (e.g. the Kiro MCP server) is',\n      '  holding the database open while indexing is running.',\n      '',\n      '  How to fix:',\n      '    1. Close Kiro IDE (or disable the kirograph MCP server) before indexing',\n      '    2. Run: kirograph unlock',\n      '    3. Then retry: kirograph index',\n      '',\n      '  If the problem persists, delete the lock manually:',\n      '    del .kirograph\\\\kirograph.db.lock  (Windows)',\n      '    rm -rf .kirograph/kirograph.db.lock  (macOS/Linux)',\n      '',\n    ].join('\\n'));\n    process.exit(1);\n  }\n\n  // Not a WASM crash \u2014 re-throw as normal\n  process.stderr.write(`Uncaught error: ${msg}\\n`);\n  process.exit(1);\n});\n\ndeclare const __CLI_VERSION__: string;\n\nconst program = new Command();\n\nprogram\n  .name('kirograph')\n  .description('Semantic code knowledge graph for Kiro')\n  .version(__CLI_VERSION__)\n  .addHelpCommand(true)\n  .hook('preAction', (thisCommand) => {\n    const name = thisCommand.name();\n    if (name === 'init') printBanner();\n  });\n\nregisterInstall(program);\nregisterInit(program);\nregisterUninit(program);\nregisterIndex(program);\nregisterSync(program);\nregisterSyncIfDirty(program);\nregisterMarkDirty(program);\nregisterStatus(program);\nregisterQuery(program);\nregisterContext(program);\nregisterFiles(program);\nregisterAffected(program);\nregisterUnlock(program);\nregisterServe(program);\nregisterDashboard(program);\nregisterArchitecture(program);\nregisterCoupling(program);\nregisterPackage(program);\nregisterCaveman(program);\nregisterDeadCode(program);\nregisterHotspots(program);\nregisterSurprising(program);\nregisterSnapshot(program);\nregisterPath(program);\nregisterExport(program);\nregisterGain(program);\nregisterCompression(program);\nregisterExec(program);\n\n// Show banner + help when called with no arguments, otherwise parse normally\nif (process.argv.length === 2) {\n  printBanner();\n  printColoredHelp();\n  process.exit(0);\n}\n\nregisterHelp(program);\n\nprogram.parse(process.argv);\n"],
-  "mappings": ";;AAKA,uBAAwB;AACxB,oBAA4B;AAC5B,kBAA2D;AAC3D,kBAAyC;AACzC,oBAA2C;AAC3C,sBAA0C;AAC1C,kBAAyC;AACzC,oBAA2C;AAC3C,mBAA0C;AAC1C,mBAA0C;AAC1C,qBAA4C;AAC5C,sBAA6C;AAC7C,wBAA8C;AAC9C,2BAAgD;AAChD,oBAA2C;AAC3C,qBAA4C;AAC5C,mBAA0C;AAC1C,uBAA8C;AAC9C,0BAAiD;AACjD,sBAA6C;AAC7C,qBAA4C;AAC5C,qBAA4C;AAC5C,uBAA6C;AAC7C,sBAA6C;AAC7C,wBAA+C;AAC/C,sBAA6C;AAC7C,kBAAyC;AACzC,oBAA2C;AAC3C,kBAAyC;AACzC,yBAAgD;AAChD,kBAAyC;AAQzC,QAAQ,GAAG,qBAAqB,CAAC,QAAe;AAC9C,QAAM,MAAM,KAAK,WAAW,OAAO,GAAG;AACtC,QAAM,cAAc,IAAI,SAAS,UAAU,KAAK,IAAI,SAAS,cAAc,KAAM,KAAa,aAAa,SAAS;AAEpH,MAAI,aAAa;AACf,YAAQ,OAAO,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI,CAAC;AACZ,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,UAAQ,OAAO,MAAM,mBAAmB,GAAG;AAAA,CAAI;AAC/C,UAAQ,KAAK,CAAC;AAChB,CAAC;AAID,MAAM,UAAU,IAAI,yBAAQ;AAE5B,QACG,KAAK,WAAW,EAChB,YAAY,wCAAwC,EACpD,QAAQ,QAAe,EACvB,eAAe,IAAI,EACnB,KAAK,aAAa,CAAC,gBAAgB;AAClC,QAAM,OAAO,YAAY,KAAK;AAC9B,MAAI,SAAS,OAAQ,gCAAY;AACnC,CAAC;AAAA,IAEH,eAAAA,UAAgB,OAAO;AAAA,IACvB,YAAAC,UAAa,OAAO;AAAA,IACpB,cAAAC,UAAe,OAAO;AAAA,IACtB,gBAAAC,UAAc,OAAO;AAAA,IACrB,YAAAC,UAAa,OAAO;AAAA,IACpB,qBAAAC,UAAoB,OAAO;AAAA,IAC3B,kBAAAC,UAAkB,OAAO;AAAA,IACzB,cAAAC,UAAe,OAAO;AAAA,IACtB,aAAAC,UAAc,OAAO;AAAA,IACrB,eAAAC,UAAgB,OAAO;AAAA,IACvB,aAAAC,UAAc,OAAO;AAAA,IACrB,gBAAAC,UAAiB,OAAO;AAAA,IACxB,cAAAC,UAAe,OAAO;AAAA,IACtB,aAAAC,UAAc,OAAO;AAAA,IACrB,iBAAAC,UAAkB,OAAO;AAAA,IACzB,oBAAAC,UAAqB,OAAO;AAAA,IAC5B,gBAAAC,UAAiB,OAAO;AAAA,IACxB,eAAAC,UAAgB,OAAO;AAAA,IACvB,eAAAC,UAAgB,OAAO;AAAA,IACvB,iBAAAC,UAAiB,OAAO;AAAA,IACxB,gBAAAC,UAAiB,OAAO;AAAA,IACxB,kBAAAC,UAAmB,OAAO;AAAA,IAC1B,gBAAAC,UAAiB,OAAO;AAAA,IACxB,YAAAC,UAAa,OAAO;AAAA,IACpB,cAAAC,UAAe,OAAO;AAAA,IACtB,YAAAC,UAAa,OAAO;AAAA,IACpB,mBAAAC,UAAoB,OAAO;AAAA,IAC3B,YAAAC,UAAa,OAAO;AAGpB,IAAI,QAAQ,KAAK,WAAW,GAAG;AAC7B,iCAAY;AACZ,oCAAiB;AACjB,UAAQ,KAAK,CAAC;AAChB;AAAA,IAEA,YAAAC,UAAa,OAAO;AAEpB,QAAQ,MAAM,QAAQ,IAAI;",
-  "names": ["registerInstall", "registerInit", "registerUninit", "registerIndex", "registerSync", "registerSyncIfDirty", "registerMarkDirty", "registerStatus", "registerQuery", "registerContext", "registerFiles", "registerAffected", "registerUnlock", "registerServe", "registerDashboard", "registerArchitecture", "registerCoupling", "registerPackage", "registerCaveman", "registerDeadCode", "registerHotspots", "registerSurprising", "registerSnapshot", "registerPath", "registerExport", "registerGain", "registerCompression", "registerExec", "registerHelp"]
+  "sourcesContent": ["#!/usr/bin/env node\n/**\n * KiroGraph CLI\n */\n\nimport { Command } from 'commander';\nimport { printBanner } from './banner';\nimport { printColoredHelp, register as registerHelp } from './commands/help';\nimport { register as registerInit } from './commands/init';\nimport { register as registerUninit } from './commands/uninit';\nimport { register as registerIndex } from './commands/index';\nimport { register as registerSync } from './commands/sync';\nimport { register as registerStatus } from './commands/status';\nimport { register as registerQuery } from './commands/query';\nimport { register as registerFiles } from './commands/files';\nimport { register as registerContext } from './commands/context';\nimport { register as registerAffected } from './commands/affected';\nimport { register as registerMarkDirty } from './commands/mark-dirty';\nimport { register as registerSyncIfDirty } from './commands/sync-if-dirty';\nimport { register as registerUnlock } from './commands/unlock';\nimport { register as registerInstall } from './commands/install';\nimport { register as registerServe } from './commands/serve';\nimport { register as registerDashboard } from './commands/dashboard';\nimport { register as registerArchitecture } from './commands/architecture';\nimport { register as registerCoupling } from './commands/coupling';\nimport { register as registerPackage } from './commands/package';\nimport { register as registerCaveman } from './commands/caveman';\nimport { register as registerDeadCode } from './commands/dead-code';\nimport { register as registerHotspots } from './commands/hotspots';\nimport { register as registerSurprising } from './commands/surprising';\nimport { register as registerSnapshot } from './commands/snapshot';\nimport { register as registerPath } from './commands/path';\nimport { register as registerExport } from './commands/export';\nimport { register as registerGain } from './commands/gain';\nimport { register as registerCompression } from './commands/compression';\nimport { register as registerExec } from './commands/exec';\nimport { register as registerMemory } from './commands/memory';\n\n// \u2500\u2500 Global error handler for WASM runtime crashes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// node-sqlite3-wasm calls process.abort() when it hits a fatal error (e.g.\n// database is locked by another process). This produces a raw \"Aborted()\"\n// message with no context. We intercept it here to print a clear explanation\n// before the process exits.\nprocess.on('uncaughtException', (err: Error) => {\n  const msg = err?.message ?? String(err);\n  const isWasmAbort = msg.includes('Aborted(') || msg.includes('RuntimeError') || (err as any)?.constructor?.name === 'RuntimeError';\n\n  if (isWasmAbort) {\n    process.stderr.write([\n      '',\n      '  \u2716 KiroGraph crashed: SQLite WASM runtime aborted.',\n      '',\n      '  Most likely cause: another process (e.g. the Kiro MCP server) is',\n      '  holding the database open while indexing is running.',\n      '',\n      '  How to fix:',\n      '    1. Close Kiro IDE (or disable the kirograph MCP server) before indexing',\n      '    2. Run: kirograph unlock',\n      '    3. Then retry: kirograph index',\n      '',\n      '  If the problem persists, delete the lock manually:',\n      '    del .kirograph\\\\kirograph.db.lock  (Windows)',\n      '    rm -rf .kirograph/kirograph.db.lock  (macOS/Linux)',\n      '',\n    ].join('\\n'));\n    process.exit(1);\n  }\n\n  // Not a WASM crash \u2014 re-throw as normal\n  process.stderr.write(`Uncaught error: ${msg}\\n`);\n  process.exit(1);\n});\n\ndeclare const __CLI_VERSION__: string;\n\nconst program = new Command();\n\nprogram\n  .name('kirograph')\n  .description('Semantic code knowledge graph for Kiro')\n  .version(__CLI_VERSION__)\n  .addHelpCommand(true)\n  .hook('preAction', (thisCommand) => {\n    const name = thisCommand.name();\n    if (name === 'init') printBanner();\n  });\n\nregisterInstall(program);\nregisterInit(program);\nregisterUninit(program);\nregisterIndex(program);\nregisterSync(program);\nregisterSyncIfDirty(program);\nregisterMarkDirty(program);\nregisterStatus(program);\nregisterQuery(program);\nregisterContext(program);\nregisterFiles(program);\nregisterAffected(program);\nregisterUnlock(program);\nregisterServe(program);\nregisterDashboard(program);\nregisterArchitecture(program);\nregisterCoupling(program);\nregisterPackage(program);\nregisterCaveman(program);\nregisterDeadCode(program);\nregisterHotspots(program);\nregisterSurprising(program);\nregisterSnapshot(program);\nregisterPath(program);\nregisterExport(program);\nregisterGain(program);\nregisterCompression(program);\nregisterExec(program);\nregisterMemory(program);\n\n// Show banner + help when called with no arguments, otherwise parse normally\nif (process.argv.length === 2) {\n  printBanner();\n  printColoredHelp();\n  process.exit(0);\n}\n\nregisterHelp(program);\n\nprogram.parse(process.argv);\n"],
+  "mappings": "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",
+  "names": ["registerInstall", "registerInit", "registerUninit", "registerIndex", "registerSync", "registerSyncIfDirty", "registerMarkDirty", "registerStatus", "registerQuery", "registerContext", "registerFiles", "registerAffected", "registerUnlock", "registerServe", "registerDashboard", "registerArchitecture", "registerCoupling", "registerPackage", "registerCaveman", "registerDeadCode", "registerHotspots", "registerSurprising", "registerSnapshot", "registerPath", "registerExport", "registerGain", "registerCompression", "registerExec", "registerMemory", "registerHelp"]
 }

package/dist/compression/naive-cost.js

@@ -82,6 +82,20 @@ function estimateNaiveCost(toolName, outputTokens, args) {
     case "kirograph_diff": {
       return Math.max(outputTokens * 3, AVG_FILE_TOKENS * 5);
     }
+    case "kirograph_mem_search": {
+      const limit = args?.limit || 10;
+      const filesEstimate = Math.min(Math.ceil(limit / 2), 5);
+      return filesEstimate * AVG_FILE_TOKENS + AVG_GREP_TOKENS;
+    }
+    case "kirograph_mem_store": {
+      return null;
+    }
+    case "kirograph_mem_timeline": {
+      return AVG_FILE_TOKENS + AVG_GREP_TOKENS;
+    }
+    case "kirograph_mem_status": {
+      return 500;
+    }
     // kirograph_exec and kirograph_gain are tracked separately
     default:
       return null;

package/dist/compression/naive-cost.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/compression/naive-cost.ts"],
-  "sourcesContent": ["/**\n * Naive cost estimator for KiroGraph MCP tools.\n *\n * Estimates how many tokens the agent would have consumed doing the same\n * work without KiroGraph (reading files, running grep, etc.).\n *\n * These are conservative estimates based on typical agent behavior:\n * - kirograph_context: agent would read 5-10 files fully to orient\n * - kirograph_search: agent would run grep/ripgrep across the project\n * - kirograph_callers/callees: agent would grep for the symbol name + read each file\n * - kirograph_impact: agent would trace callers recursively (multiple grep + read cycles)\n * - kirograph_node: agent would read the full file containing the symbol\n * - kirograph_files: agent would run find/ls -R\n * - kirograph_status: agent would check file counts, run wc, etc.\n * - kirograph_hotspots/surprising/dead_code: not feasible manually (infinite cost \u2192 cap at 5x)\n */\n\nimport { estimateTokens } from './index';\n\n/** Average tokens per file read (medium-sized source file ~200 lines) */\nconst AVG_FILE_TOKENS = 1500;\n\n/** Average tokens for a grep result across a medium project */\nconst AVG_GREP_TOKENS = 800;\n\n/** Average tokens for ls -R or find output on a medium project */\nconst AVG_FIND_TOKENS = 2000;\n\n/**\n * Estimate the naive token cost (what the agent would have spent without KiroGraph).\n *\n * @param toolName - The MCP tool that was called\n * @param outputTokens - Actual tokens in the tool's response\n * @param args - The tool arguments (for context-aware estimation)\n * @returns Estimated naive cost in tokens, or null if not estimable\n */\nexport function estimateNaiveCost(toolName: string, outputTokens: number, args?: Record<string, unknown>): number | null {\n  switch (toolName) {\n    case 'kirograph_context': {\n      // Agent would read ~5-10 files to understand a task area\n      const maxNodes = (args?.maxNodes as number) || 20;\n      const filesEstimate = Math.min(Math.ceil(maxNodes / 2), 10);\n      return filesEstimate * AVG_FILE_TOKENS;\n    }\n\n    case 'kirograph_search': {\n      // Agent would run grep/ripgrep and read through results\n      const limit = (args?.limit as number) || 10;\n      // grep output + reading top matches\n      return AVG_GREP_TOKENS + Math.min(limit, 5) * (AVG_FILE_TOKENS / 3);\n    }\n\n    case 'kirograph_callers': {\n      // Agent would grep for the symbol, then read each calling file\n      const limit = (args?.limit as number) || 20;\n      const callersEstimate = Math.min(limit, 10);\n      return AVG_GREP_TOKENS + callersEstimate * (AVG_FILE_TOKENS / 2);\n    }\n\n    case 'kirograph_callees': {\n      // Agent would read the function body + grep for each called symbol\n      return AVG_FILE_TOKENS + AVG_GREP_TOKENS * 3;\n    }\n\n    case 'kirograph_impact': {\n      // Agent would need multiple rounds of grep + read (recursive)\n      const depth = (args?.depth as number) || 2;\n      return (AVG_GREP_TOKENS + AVG_FILE_TOKENS * 3) * depth;\n    }\n\n    case 'kirograph_node': {\n      // Agent would read the full file to find the symbol\n      return AVG_FILE_TOKENS;\n    }\n\n    case 'kirograph_files': {\n      // Agent would run find or ls -R\n      return AVG_FIND_TOKENS;\n    }\n\n    case 'kirograph_status': {\n      // Agent would run multiple commands (wc -l, find, du, etc.)\n      return 500;\n    }\n\n    case 'kirograph_path': {\n      // Agent would need to manually trace connections \u2014 multiple grep + read cycles\n      return AVG_GREP_TOKENS * 4 + AVG_FILE_TOKENS * 3;\n    }\n\n    case 'kirograph_type_hierarchy': {\n      // Agent would grep for extends/implements, read each file\n      return AVG_GREP_TOKENS * 3 + AVG_FILE_TOKENS * 2;\n    }\n\n    case 'kirograph_dead_code': {\n      // Not feasible manually \u2014 would require reading every file and cross-referencing\n      // Cap at 5x the output (conservative)\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 10);\n    }\n\n    case 'kirograph_circular_deps': {\n      // Not feasible manually \u2014 would require building a full import graph\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 8);\n    }\n\n    case 'kirograph_hotspots': {\n      // Not feasible manually \u2014 would require counting edges for every symbol\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 10);\n    }\n\n    case 'kirograph_surprising': {\n      // Not feasible manually\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 10);\n    }\n\n    case 'kirograph_architecture':\n    case 'kirograph_coupling':\n    case 'kirograph_package': {\n      // Architecture analysis is not feasible manually\n      return Math.max(outputTokens * 4, AVG_FILE_TOKENS * 5);\n    }\n\n    case 'kirograph_diff': {\n      // Agent would need to compare file lists and grep for symbols\n      return Math.max(outputTokens * 3, AVG_FILE_TOKENS * 5);\n    }\n\n    // kirograph_exec and kirograph_gain are tracked separately\n    default:\n      return null;\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA,MAAM,kBAAkB;AAGxB,MAAM,kBAAkB;AAGxB,MAAM,kBAAkB;AAUjB,SAAS,kBAAkB,UAAkB,cAAsB,MAA+C;AACvH,UAAQ,UAAU;AAAA,IAChB,KAAK,qBAAqB;AAExB,YAAM,WAAY,MAAM,YAAuB;AAC/C,YAAM,gBAAgB,KAAK,IAAI,KAAK,KAAK,WAAW,CAAC,GAAG,EAAE;AAC1D,aAAO,gBAAgB;AAAA,IACzB;AAAA,IAEA,KAAK,oBAAoB;AAEvB,YAAM,QAAS,MAAM,SAAoB;AAEzC,aAAO,kBAAkB,KAAK,IAAI,OAAO,CAAC,KAAK,kBAAkB;AAAA,IACnE;AAAA,IAEA,KAAK,qBAAqB;AAExB,YAAM,QAAS,MAAM,SAAoB;AACzC,YAAM,kBAAkB,KAAK,IAAI,OAAO,EAAE;AAC1C,aAAO,kBAAkB,mBAAmB,kBAAkB;AAAA,IAChE;AAAA,IAEA,KAAK,qBAAqB;AAExB,aAAO,kBAAkB,kBAAkB;AAAA,IAC7C;AAAA,IAEA,KAAK,oBAAoB;AAEvB,YAAM,QAAS,MAAM,SAAoB;AACzC,cAAQ,kBAAkB,kBAAkB,KAAK;AAAA,IACnD;AAAA,IAEA,KAAK,kBAAkB;AAErB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,mBAAmB;AAEtB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,oBAAoB;AAEvB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,kBAAkB;AAErB,aAAO,kBAAkB,IAAI,kBAAkB;AAAA,IACjD;AAAA,IAEA,KAAK,4BAA4B;AAE/B,aAAO,kBAAkB,IAAI,kBAAkB;AAAA,IACjD;AAAA,IAEA,KAAK,uBAAuB;AAG1B,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,EAAE;AAAA,IACxD;AAAA,IAEA,KAAK,2BAA2B;AAE9B,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAAA,IACvD;AAAA,IAEA,KAAK,sBAAsB;AAEzB,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,EAAE;AAAA,IACxD;AAAA,IAEA,KAAK,wBAAwB;AAE3B,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,EAAE;AAAA,IACxD;AAAA,IAEA,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,qBAAqB;AAExB,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAAA,IACvD;AAAA,IAEA,KAAK,kBAAkB;AAErB,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAAA,IACvD;AAAA;AAAA,IAGA;AACE,aAAO;AAAA,EACX;AACF;",
+  "sourcesContent": ["/**\n * Naive cost estimator for KiroGraph MCP tools.\n *\n * Estimates how many tokens the agent would have consumed doing the same\n * work without KiroGraph (reading files, running grep, etc.).\n *\n * These are conservative estimates based on typical agent behavior:\n * - kirograph_context: agent would read 5-10 files fully to orient\n * - kirograph_search: agent would run grep/ripgrep across the project\n * - kirograph_callers/callees: agent would grep for the symbol name + read each file\n * - kirograph_impact: agent would trace callers recursively (multiple grep + read cycles)\n * - kirograph_node: agent would read the full file containing the symbol\n * - kirograph_files: agent would run find/ls -R\n * - kirograph_status: agent would check file counts, run wc, etc.\n * - kirograph_hotspots/surprising/dead_code: not feasible manually (infinite cost \u2192 cap at 5x)\n */\n\nimport { estimateTokens } from './index';\n\n/** Average tokens per file read (medium-sized source file ~200 lines) */\nconst AVG_FILE_TOKENS = 1500;\n\n/** Average tokens for a grep result across a medium project */\nconst AVG_GREP_TOKENS = 800;\n\n/** Average tokens for ls -R or find output on a medium project */\nconst AVG_FIND_TOKENS = 2000;\n\n/**\n * Estimate the naive token cost (what the agent would have spent without KiroGraph).\n *\n * @param toolName - The MCP tool that was called\n * @param outputTokens - Actual tokens in the tool's response\n * @param args - The tool arguments (for context-aware estimation)\n * @returns Estimated naive cost in tokens, or null if not estimable\n */\nexport function estimateNaiveCost(toolName: string, outputTokens: number, args?: Record<string, unknown>): number | null {\n  switch (toolName) {\n    case 'kirograph_context': {\n      // Agent would read ~5-10 files to understand a task area\n      const maxNodes = (args?.maxNodes as number) || 20;\n      const filesEstimate = Math.min(Math.ceil(maxNodes / 2), 10);\n      return filesEstimate * AVG_FILE_TOKENS;\n    }\n\n    case 'kirograph_search': {\n      // Agent would run grep/ripgrep and read through results\n      const limit = (args?.limit as number) || 10;\n      // grep output + reading top matches\n      return AVG_GREP_TOKENS + Math.min(limit, 5) * (AVG_FILE_TOKENS / 3);\n    }\n\n    case 'kirograph_callers': {\n      // Agent would grep for the symbol, then read each calling file\n      const limit = (args?.limit as number) || 20;\n      const callersEstimate = Math.min(limit, 10);\n      return AVG_GREP_TOKENS + callersEstimate * (AVG_FILE_TOKENS / 2);\n    }\n\n    case 'kirograph_callees': {\n      // Agent would read the function body + grep for each called symbol\n      return AVG_FILE_TOKENS + AVG_GREP_TOKENS * 3;\n    }\n\n    case 'kirograph_impact': {\n      // Agent would need multiple rounds of grep + read (recursive)\n      const depth = (args?.depth as number) || 2;\n      return (AVG_GREP_TOKENS + AVG_FILE_TOKENS * 3) * depth;\n    }\n\n    case 'kirograph_node': {\n      // Agent would read the full file to find the symbol\n      return AVG_FILE_TOKENS;\n    }\n\n    case 'kirograph_files': {\n      // Agent would run find or ls -R\n      return AVG_FIND_TOKENS;\n    }\n\n    case 'kirograph_status': {\n      // Agent would run multiple commands (wc -l, find, du, etc.)\n      return 500;\n    }\n\n    case 'kirograph_path': {\n      // Agent would need to manually trace connections \u2014 multiple grep + read cycles\n      return AVG_GREP_TOKENS * 4 + AVG_FILE_TOKENS * 3;\n    }\n\n    case 'kirograph_type_hierarchy': {\n      // Agent would grep for extends/implements, read each file\n      return AVG_GREP_TOKENS * 3 + AVG_FILE_TOKENS * 2;\n    }\n\n    case 'kirograph_dead_code': {\n      // Not feasible manually \u2014 would require reading every file and cross-referencing\n      // Cap at 5x the output (conservative)\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 10);\n    }\n\n    case 'kirograph_circular_deps': {\n      // Not feasible manually \u2014 would require building a full import graph\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 8);\n    }\n\n    case 'kirograph_hotspots': {\n      // Not feasible manually \u2014 would require counting edges for every symbol\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 10);\n    }\n\n    case 'kirograph_surprising': {\n      // Not feasible manually\n      return Math.max(outputTokens * 5, AVG_FILE_TOKENS * 10);\n    }\n\n    case 'kirograph_architecture':\n    case 'kirograph_coupling':\n    case 'kirograph_package': {\n      // Architecture analysis is not feasible manually\n      return Math.max(outputTokens * 4, AVG_FILE_TOKENS * 5);\n    }\n\n    case 'kirograph_diff': {\n      // Agent would need to compare file lists and grep for symbols\n      return Math.max(outputTokens * 3, AVG_FILE_TOKENS * 5);\n    }\n\n    case 'kirograph_mem_search': {\n      // Without memory, agent would re-read files to rediscover past decisions.\n      // Typically 3-5 files + grep for related context.\n      const limit = (args?.limit as number) || 10;\n      const filesEstimate = Math.min(Math.ceil(limit / 2), 5);\n      return filesEstimate * AVG_FILE_TOKENS + AVG_GREP_TOKENS;\n    }\n\n    case 'kirograph_mem_store': {\n      // Storing has no direct naive equivalent \u2014 the knowledge would simply be lost.\n      // We don't count savings on store; savings are realized on future searches.\n      return null;\n    }\n\n    case 'kirograph_mem_timeline': {\n      // Agent would ask user or re-read previous session context.\n      return AVG_FILE_TOKENS + AVG_GREP_TOKENS;\n    }\n\n    case 'kirograph_mem_status': {\n      // Lightweight status check, minimal naive cost.\n      return 500;\n    }\n\n    // kirograph_exec and kirograph_gain are tracked separately\n    default:\n      return null;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA,MAAM,kBAAkB;AAGxB,MAAM,kBAAkB;AAGxB,MAAM,kBAAkB;AAUjB,SAAS,kBAAkB,UAAkB,cAAsB,MAA+C;AACvH,UAAQ,UAAU;AAAA,IAChB,KAAK,qBAAqB;AAExB,YAAM,WAAY,MAAM,YAAuB;AAC/C,YAAM,gBAAgB,KAAK,IAAI,KAAK,KAAK,WAAW,CAAC,GAAG,EAAE;AAC1D,aAAO,gBAAgB;AAAA,IACzB;AAAA,IAEA,KAAK,oBAAoB;AAEvB,YAAM,QAAS,MAAM,SAAoB;AAEzC,aAAO,kBAAkB,KAAK,IAAI,OAAO,CAAC,KAAK,kBAAkB;AAAA,IACnE;AAAA,IAEA,KAAK,qBAAqB;AAExB,YAAM,QAAS,MAAM,SAAoB;AACzC,YAAM,kBAAkB,KAAK,IAAI,OAAO,EAAE;AAC1C,aAAO,kBAAkB,mBAAmB,kBAAkB;AAAA,IAChE;AAAA,IAEA,KAAK,qBAAqB;AAExB,aAAO,kBAAkB,kBAAkB;AAAA,IAC7C;AAAA,IAEA,KAAK,oBAAoB;AAEvB,YAAM,QAAS,MAAM,SAAoB;AACzC,cAAQ,kBAAkB,kBAAkB,KAAK;AAAA,IACnD;AAAA,IAEA,KAAK,kBAAkB;AAErB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,mBAAmB;AAEtB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,oBAAoB;AAEvB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,kBAAkB;AAErB,aAAO,kBAAkB,IAAI,kBAAkB;AAAA,IACjD;AAAA,IAEA,KAAK,4BAA4B;AAE/B,aAAO,kBAAkB,IAAI,kBAAkB;AAAA,IACjD;AAAA,IAEA,KAAK,uBAAuB;AAG1B,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,EAAE;AAAA,IACxD;AAAA,IAEA,KAAK,2BAA2B;AAE9B,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAAA,IACvD;AAAA,IAEA,KAAK,sBAAsB;AAEzB,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,EAAE;AAAA,IACxD;AAAA,IAEA,KAAK,wBAAwB;AAE3B,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,EAAE;AAAA,IACxD;AAAA,IAEA,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,qBAAqB;AAExB,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAAA,IACvD;AAAA,IAEA,KAAK,kBAAkB;AAErB,aAAO,KAAK,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAAA,IACvD;AAAA,IAEA,KAAK,wBAAwB;AAG3B,YAAM,QAAS,MAAM,SAAoB;AACzC,YAAM,gBAAgB,KAAK,IAAI,KAAK,KAAK,QAAQ,CAAC,GAAG,CAAC;AACtD,aAAO,gBAAgB,kBAAkB;AAAA,IAC3C;AAAA,IAEA,KAAK,uBAAuB;AAG1B,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,0BAA0B;AAE7B,aAAO,kBAAkB;AAAA,IAC3B;AAAA,IAEA,KAAK,wBAAwB;AAE3B,aAAO;AAAA,IACT;AAAA;AAAA,IAGA;AACE,aAAO;AAAA,EACX;AACF;",
   "names": []
 }

package/dist/compression/tracker.js

@@ -87,6 +87,15 @@ class TokenTracker {
   recordGraphSaving(toolName, outputTokens, naiveCost) {
     this.record(toolName, naiveCost, outputTokens, `graph:${toolName}`, "graph");
   }
+  /**
+   * Record a memory tool saving.
+   * @param toolName - The MCP tool that was called
+   * @param outputTokens - Actual tokens returned by the tool
+   * @param naiveCost - Estimated tokens the agent would have used without memory
+   */
+  recordMemorySaving(toolName, outputTokens, naiveCost) {
+    this.record(toolName, naiveCost, outputTokens, `memory:${toolName}`, "memory");
+  }
   /**
    * Get aggregated statistics for a time period.
    */
@@ -101,13 +110,13 @@ class TokenTracker {
         savingsPercent: 0,
         byFamily: {},
         recentCommands: [],
-        bySource: { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 } }
+        bySource: { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 }, memory: { count: 0, saved: 0 } }
       };
     }
     let totalOriginal = 0;
     let totalCompressed = 0;
     const byFamily = /* @__PURE__ */ new Map();
-    const bySource = { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 } };
+    const bySource = { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 }, memory: { count: 0, saved: 0 } };
     for (const r of records) {
       totalOriginal += r.originalTokens;
       totalCompressed += r.compressedTokens;
@@ -118,8 +127,13 @@ class TokenTracker {
       existing.totalCompressed += r.compressedTokens;
       byFamily.set(family, existing);
       const source = r.source || "exec";
-      bySource[source].count++;
-      bySource[source].saved += r.originalTokens - r.compressedTokens;
+      if (bySource[source]) {
+        bySource[source].count++;
+        bySource[source].saved += r.originalTokens - r.compressedTokens;
+      } else {
+        bySource.exec.count++;
+        bySource.exec.saved += r.originalTokens - r.compressedTokens;
+      }
     }
     const totalSaved = totalOriginal - totalCompressed;
     const savingsPercent = totalOriginal > 0 ? Math.round(totalSaved / totalOriginal * 100) : 0;