kirograph 0.12.1

package/dist/bin/commands/serve.js

@@ -0,0 +1,59 @@
+"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 serve_exports = {};
+__export(serve_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(serve_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("serve").description("Start the MCP server").option("--mcp", "Run as MCP stdio server").option("--path <path>", "Project path").action(async (opts) => {
+    if (!opts.mcp) {
+      console.log(`
+  ${import_ui.dim}Start the KiroGraph MCP server for Kiro.${import_ui.reset}`);
+      console.log(`
+  ${import_ui.dim}Usage:${import_ui.reset}  ${import_ui.violet}${import_ui.bold}kirograph serve --mcp${import_ui.reset}`);
+      console.log(`
+  ${import_ui.dim}Add to${import_ui.reset} ${import_ui.violet}${import_ui.bold}.kiro/settings/mcp.json${import_ui.reset}${import_ui.dim}:${import_ui.reset}
+`);
+      console.log(`  ${import_ui.dim}${JSON.stringify({ mcpServers: { kirograph: { command: "kirograph", args: ["serve", "--mcp"] } } }, null, 2).split("\n").join("\n  ")}${import_ui.reset}
+`);
+      return;
+    }
+    const { MCPServer } = await Promise.resolve().then(() => require("../../mcp/server.js"));
+    const server = new MCPServer(opts.path ? path.resolve(opts.path) : process.cwd());
+    await server.start();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=serve.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/serve.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport { dim, reset, violet, bold } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('serve')\n    .description('Start the MCP server')\n    .option('--mcp', 'Run as MCP stdio server')\n    .option('--path <path>', 'Project path')\n    .action(async (opts: { mcp?: boolean; path?: string }) => {\n      if (!opts.mcp) {\n        console.log(`\\n  ${dim}Start the KiroGraph MCP server for Kiro.${reset}`);\n        console.log(`\\n  ${dim}Usage:${reset}  ${violet}${bold}kirograph serve --mcp${reset}`);\n        console.log(`\\n  ${dim}Add to${reset} ${violet}${bold}.kiro/settings/mcp.json${reset}${dim}:${reset}\\n`);\n        console.log(`  ${dim}${JSON.stringify({ mcpServers: { kirograph: { command: 'kirograph', args: ['serve', '--mcp'] } } }, null, 2).split('\\n').join('\\n  ')}${reset}\\n`);\n        return;\n      }\n      const { MCPServer } = await Promise.resolve().then(() => require('../../mcp/server.js'));\n      const server = new MCPServer(opts.path ? path.resolve(opts.path) : process.cwd());\n      await server.start();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,WAAsB;AACtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,OAAO,EACf,YAAY,sBAAsB,EAClC,OAAO,SAAS,yBAAyB,EACzC,OAAO,iBAAiB,cAAc,EACtC,OAAO,OAAO,SAA2C;AACxD,QAAI,CAAC,KAAK,KAAK;AACb,cAAQ,IAAI;AAAA,IAAO,aAAG,2CAA2C,eAAK,EAAE;AACxE,cAAQ,IAAI;AAAA,IAAO,aAAG,SAAS,eAAK,KAAK,gBAAM,GAAG,cAAI,wBAAwB,eAAK,EAAE;AACrF,cAAQ,IAAI;AAAA,IAAO,aAAG,SAAS,eAAK,IAAI,gBAAM,GAAG,cAAI,0BAA0B,eAAK,GAAG,aAAG,IAAI,eAAK;AAAA,CAAI;AACvG,cAAQ,IAAI,KAAK,aAAG,GAAG,KAAK,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,aAAa,MAAM,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,EAAE,MAAM,IAAI,EAAE,KAAK,MAAM,CAAC,GAAG,eAAK;AAAA,CAAI;AACtK;AAAA,IACF;AACA,UAAM,EAAE,UAAU,IAAI,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,qBAAqB,CAAC;AACvF,UAAM,SAAS,IAAI,UAAU,KAAK,OAAO,KAAK,QAAQ,KAAK,IAAI,IAAI,QAAQ,IAAI,CAAC;AAChF,UAAM,OAAO,MAAM;AAAA,EACrB,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/snapshot.js

@@ -0,0 +1,122 @@
+"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 snapshot_exports = {};
+__export(snapshot_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(snapshot_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  const snapshotCmd = program.command("snapshot").description("Save or list graph snapshots for later diffing");
+  snapshotCmd.command("save [label]").description("Save a snapshot of the current graph state").option("--path <p>", "Project root path").action(async (label, 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 sm = cg.createSnapshotManager();
+    const snapshot = sm.save(label);
+    cg.close();
+    console.log();
+    console.log(`  ${import_ui.green}\u2713${import_ui.reset} Snapshot saved: ${import_ui.violet}${import_ui.bold}${snapshot.label}${import_ui.reset}`);
+    console.log(`  ${import_ui.dim}${snapshot.nodeCount} symbols, ${snapshot.edgeCount} edges${import_ui.reset}`);
+    console.log();
+  });
+  snapshotCmd.command("list").description("List saved snapshots").option("--path <p>", "Project root path").action(async (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 sm = cg.createSnapshotManager();
+    const snapshots = sm.list();
+    cg.close();
+    if (snapshots.length === 0) {
+      console.log(`
+  ${import_ui.dim}No snapshots yet. Run \`kirograph snapshot save\` first.${import_ui.reset}
+`);
+      return;
+    }
+    console.log();
+    console.log(`  ${import_ui.violet}${import_ui.bold}Snapshots${import_ui.reset}
+`);
+    for (const s of snapshots) {
+      const date = new Date(s.timestamp).toISOString().slice(0, 19).replace("T", " ");
+      console.log(`  ${import_ui.violet}${import_ui.bold}${s.label}${import_ui.reset}  ${import_ui.dim}${date}  ${s.nodeCount} symbols, ${s.edgeCount} edges${import_ui.reset}`);
+    }
+    console.log();
+  });
+  snapshotCmd.command("diff [label]").description("Diff current graph vs a saved snapshot (defaults to latest)").option("--path <p>", "Project root path").option("--format <fmt>", "Output format: summary | full | json", "summary").action(async (label, 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 sm = cg.createSnapshotManager();
+    const snapshot = label ? sm.load(label) : sm.loadLatest();
+    if (!snapshot) {
+      console.log(`
+  ${import_ui.dim}${label ? `Snapshot "${label}" not found.` : "No snapshots found. Run `kirograph snapshot save` first."} ${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    const diff = sm.diff(snapshot, sm.currentSnapshot());
+    cg.close();
+    if (opts.format === "json") {
+      console.log(JSON.stringify(diff, null, 2));
+      return;
+    }
+    const fromDate = new Date(diff.from.timestamp).toISOString().slice(0, 19).replace("T", " ");
+    console.log();
+    console.log(`  ${import_ui.violet}${import_ui.bold}Graph Diff${import_ui.reset}  ${import_ui.dim}"${diff.from.label}" (${fromDate}) \u2192 current${import_ui.reset}
+`);
+    console.log(`  ${import_ui.green}+${import_ui.reset} ${import_ui.bold}${diff.addedNodes.length}${import_ui.reset}${import_ui.dim} symbols added${import_ui.reset}    ${import_ui.dim}-${import_ui.reset} ${import_ui.bold}${diff.removedNodes.length}${import_ui.reset}${import_ui.dim} symbols removed${import_ui.reset}`);
+    console.log(`  ${import_ui.green}+${import_ui.reset} ${import_ui.bold}${diff.addedEdges.length}${import_ui.reset}${import_ui.dim} edges added${import_ui.reset}      ${import_ui.dim}-${import_ui.reset} ${import_ui.bold}${diff.removedEdges.length}${import_ui.reset}${import_ui.dim} edges removed${import_ui.reset}`);
+    if (opts.format === "full") {
+      if (diff.addedNodes.length > 0) {
+        console.log(`
+  ${import_ui.dim}Added symbols:${import_ui.reset}`);
+        for (const n of diff.addedNodes.slice(0, 50)) {
+          console.log(`    ${import_ui.green}+${import_ui.reset} ${import_ui.violet}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}  ${n.filePath}${import_ui.reset}`);
+        }
+        if (diff.addedNodes.length > 50) console.log(`    ${import_ui.dim}\u2026and ${diff.addedNodes.length - 50} more${import_ui.reset}`);
+      }
+      if (diff.removedNodes.length > 0) {
+        console.log(`
+  ${import_ui.dim}Removed symbols:${import_ui.reset}`);
+        for (const n of diff.removedNodes.slice(0, 50)) {
+          console.log(`    ${import_ui.dim}- ${n.name}  ${n.kind}  ${n.filePath}${import_ui.reset}`);
+        }
+        if (diff.removedNodes.length > 50) console.log(`    ${import_ui.dim}\u2026and ${diff.removedNodes.length - 50} more${import_ui.reset}`);
+      }
+    }
+    console.log();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=snapshot.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/snapshot.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport { Command } from 'commander';\nimport { bold, dim, green, reset, violet } from '../ui';\n\nexport function register(program: Command): void {\n  const snapshotCmd = program\n    .command('snapshot')\n    .description('Save or list graph snapshots for later diffing');\n\n  // kirograph snapshot save [label] [projectPath]\n  snapshotCmd\n    .command('save [label]')\n    .description('Save a snapshot of the current graph state')\n    .option('--path <p>', 'Project root path')\n    .action(async (label: string | undefined, opts: { 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      const sm = cg.createSnapshotManager();\n      const snapshot = sm.save(label);\n      cg.close();\n      console.log();\n      console.log(`  ${green}\u2713${reset} Snapshot saved: ${violet}${bold}${snapshot.label}${reset}`);\n      console.log(`  ${dim}${snapshot.nodeCount} symbols, ${snapshot.edgeCount} edges${reset}`);\n      console.log();\n    });\n\n  // kirograph snapshot list [projectPath]\n  snapshotCmd\n    .command('list')\n    .description('List saved snapshots')\n    .option('--path <p>', 'Project root path')\n    .action(async (opts: { 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      const sm = cg.createSnapshotManager();\n      const snapshots = sm.list();\n      cg.close();\n\n      if (snapshots.length === 0) {\n        console.log(`\\n  ${dim}No snapshots yet. Run \\`kirograph snapshot save\\` first.${reset}\\n`);\n        return;\n      }\n\n      console.log();\n      console.log(`  ${violet}${bold}Snapshots${reset}\\n`);\n      for (const s of snapshots) {\n        const date = new Date(s.timestamp).toISOString().slice(0, 19).replace('T', ' ');\n        console.log(`  ${violet}${bold}${s.label}${reset}  ${dim}${date}  ${s.nodeCount} symbols, ${s.edgeCount} edges${reset}`);\n      }\n      console.log();\n    });\n\n  // kirograph snapshot diff [label] [projectPath]\n  snapshotCmd\n    .command('diff [label]')\n    .description('Diff current graph vs a saved snapshot (defaults to latest)')\n    .option('--path <p>', 'Project root path')\n    .option('--format <fmt>', 'Output format: summary | full | json', 'summary')\n    .action(async (label: string | undefined, opts: { path?: string; format: 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      const sm = cg.createSnapshotManager();\n\n      const snapshot = label ? sm.load(label) : sm.loadLatest();\n      if (!snapshot) {\n        console.log(`\\n  ${dim}${label ? `Snapshot \"${label}\" not found.` : 'No snapshots found. Run `kirograph snapshot save` first.'} ${reset}\\n`);\n        cg.close();\n        return;\n      }\n\n      const diff = sm.diff(snapshot, sm.currentSnapshot());\n      cg.close();\n\n      if (opts.format === 'json') {\n        console.log(JSON.stringify(diff, null, 2));\n        return;\n      }\n\n      const fromDate = new Date(diff.from.timestamp).toISOString().slice(0, 19).replace('T', ' ');\n      console.log();\n      console.log(`  ${violet}${bold}Graph Diff${reset}  ${dim}\"${diff.from.label}\" (${fromDate}) \u2192 current${reset}\\n`);\n      console.log(`  ${green}+${reset} ${bold}${diff.addedNodes.length}${reset}${dim} symbols added${reset}    ${dim}-${reset} ${bold}${diff.removedNodes.length}${reset}${dim} symbols removed${reset}`);\n      console.log(`  ${green}+${reset} ${bold}${diff.addedEdges.length}${reset}${dim} edges added${reset}      ${dim}-${reset} ${bold}${diff.removedEdges.length}${reset}${dim} edges removed${reset}`);\n\n      if (opts.format === 'full') {\n        if (diff.addedNodes.length > 0) {\n          console.log(`\\n  ${dim}Added symbols:${reset}`);\n          for (const n of diff.addedNodes.slice(0, 50)) {\n            console.log(`    ${green}+${reset} ${violet}${n.name}${reset}  ${dim}${n.kind}  ${n.filePath}${reset}`);\n          }\n          if (diff.addedNodes.length > 50) console.log(`    ${dim}\u2026and ${diff.addedNodes.length - 50} more${reset}`);\n        }\n        if (diff.removedNodes.length > 0) {\n          console.log(`\\n  ${dim}Removed symbols:${reset}`);\n          for (const n of diff.removedNodes.slice(0, 50)) {\n            console.log(`    ${dim}- ${n.name}  ${n.kind}  ${n.filePath}${reset}`);\n          }\n          if (diff.removedNodes.length > 50) console.log(`    ${dim}\u2026and ${diff.removedNodes.length - 50} more${reset}`);\n        }\n      }\n\n      console.log();\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function register(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/bin/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D/C"}

package/dist/bin/commands/status.js

@@ -0,0 +1,107 @@
+"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 status_exports = {};
+__export(status_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(status_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("status [projectPath]").description("Show index statistics").action(async (projectPath) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(projectPath ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const stats = await cg.getStats();
+    console.log();
+    console.log((0, import_ui.section)("  Graph"));
+    console.log(`  ${(0, import_ui.label)("Files")}      ${(0, import_ui.value)(String(stats.files))}`);
+    console.log(`  ${(0, import_ui.label)("Symbols")}    ${(0, import_ui.value)(String(stats.nodes))}`);
+    console.log(`  ${(0, import_ui.label)("Edges")}      ${(0, import_ui.value)(String(stats.edges))}`);
+    if (stats.frameworks.length > 0) {
+      console.log(`  ${(0, import_ui.label)("Frameworks")} ${(0, import_ui.value)(stats.frameworks.join(", "))}`);
+    }
+    const kindEntries = Object.entries(stats.nodesByKind).sort((a, b) => b[1] - a[1]);
+    if (kindEntries.length > 0) {
+      console.log(`
+  ${(0, import_ui.label)("By kind")}`);
+      console.log((0, import_ui.renderTable)(kindEntries.map(([k, v]) => [k, String(v)])));
+    }
+    const langEntries = Object.entries(stats.filesByLanguage ?? {}).sort((a, b) => b[1] - a[1]);
+    if (langEntries.length > 0) {
+      console.log(`
+  ${(0, import_ui.label)("By language")}`);
+      console.log((0, import_ui.renderTable)(langEntries.map(([k, v]) => [k, String(v)])));
+    }
+    const threshold = stats.syncWarningThreshold ?? 10;
+    const pendingFiles = stats.pendingFiles ?? 0;
+    const syncRunning = stats.syncRunning ?? false;
+    console.log();
+    console.log((0, import_ui.section)("  Sync"));
+    if (syncRunning) {
+      console.log(`  ${"\x1B[33m"}\u26A0 Sync is currently running in the background.${import_ui.reset}`);
+    } else {
+      console.log(`  ${(0, import_ui.label)("Status")}     ${import_ui.dim}idle${import_ui.reset}`);
+    }
+    if (pendingFiles > 0) {
+      const warn = threshold > 0 && pendingFiles >= threshold;
+      const pendingLabel = warn ? `${"\x1B[33m"}${pendingFiles} files pending${import_ui.reset}` : `${import_ui.dim}${pendingFiles} files pending${import_ui.reset}`;
+      console.log(`  ${(0, import_ui.label)("Pending")}    ${pendingLabel}`);
+      if (warn) {
+        console.log(`  ${"\x1B[33m"}\u26A0 Index may be stale. Run \`kirograph sync\` to update.${import_ui.reset}`);
+      }
+    } else {
+      console.log(`  ${(0, import_ui.label)("Pending")}    ${import_ui.green}up to date${import_ui.reset}`);
+    }
+    console.log();
+    console.log((0, import_ui.section)("  Semantic Search"));
+    if (stats.embeddingsEnabled) {
+      const engineLabel = stats.semanticEngine === "sqlite-vec" ? `sqlite-vec  ${import_ui.dim}(${stats.vecIndexCount} entries in ANN index)${import_ui.reset}` : stats.semanticEngine === "orama" ? `orama  ${import_ui.dim}(hybrid \u2014 ${stats.vecIndexCount} docs in index)${import_ui.reset}` : stats.semanticEngine === "pglite" ? `pglite+pgvector  ${import_ui.dim}(hybrid \u2014 ${stats.vecIndexCount} rows in DB)${import_ui.reset}` : stats.semanticEngine === "lancedb" ? `lancedb  ${import_ui.dim}(${stats.vecIndexCount} entries in ANN index)${import_ui.reset}` : stats.semanticEngine === "qdrant" ? `qdrant  ${import_ui.dim}(${stats.vecIndexCount} points in collection)${import_ui.reset}` : stats.semanticEngine === "typesense" ? `typesense  ${import_ui.dim}(${stats.vecIndexCount} documents in collection)${import_ui.reset}` : `in-process cosine`;
+      const total = stats.embeddableNodeCount > 0 ? stats.embeddableNodeCount : stats.nodes;
+      const displayed = Math.min(stats.embeddingCount, total);
+      const coverage = total > 0 ? Math.min(100, Math.round(stats.embeddingCount / total * 100)) : 0;
+      console.log(`  ${(0, import_ui.label)("Status")}     ${import_ui.green}${import_ui.bold}enabled${import_ui.reset}`);
+      console.log(`  ${(0, import_ui.label)("Model")}      ${(0, import_ui.value)(stats.embeddingModel)}`);
+      console.log(`  ${(0, import_ui.label)("Engine")}     ${import_ui.violet}${engineLabel}${import_ui.reset}`);
+      if (stats.engineFallback) {
+        console.log(`  ${"\x1B[33m"}\u26A0 engine fallback: ${stats.engineFallback}${import_ui.reset}`);
+      }
+      console.log(`  ${(0, import_ui.label)("Indexed")}    ${(0, import_ui.value)(`${displayed} / ${total}`)}  ${import_ui.dim}(${coverage}%)${import_ui.reset}`);
+    } else {
+      console.log(`  ${(0, import_ui.label)("Status")}     ${import_ui.dim}disabled${import_ui.reset}`);
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/status.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport { dim, reset, violet, bold, green, label, value, section, renderTable } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('status [projectPath]')\n    .description('Show index statistics')\n    .action(async (projectPath: string | undefined) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(projectPath ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n      const stats = await cg.getStats();\n\n      console.log();\n      console.log(section('  Graph'));\n      console.log(`  ${label('Files')}      ${value(String(stats.files))}`);\n      console.log(`  ${label('Symbols')}    ${value(String(stats.nodes))}`);\n      console.log(`  ${label('Edges')}      ${value(String(stats.edges))}`);\n\n      if (stats.frameworks.length > 0) {\n        console.log(`  ${label('Frameworks')} ${value(stats.frameworks.join(', '))}`);\n      }\n\n      const kindEntries = Object.entries(stats.nodesByKind).sort((a, b) => b[1] - a[1]);\n      if (kindEntries.length > 0) {\n        console.log(`\\n  ${label('By kind')}`);\n        console.log(renderTable(kindEntries.map(([k, v]) => [k, String(v)])));\n      }\n\n      const langEntries = Object.entries(stats.filesByLanguage ?? {}).sort((a, b) => b[1] - a[1]);\n      if (langEntries.length > 0) {\n        console.log(`\\n  ${label('By language')}`);\n        console.log(renderTable(langEntries.map(([k, v]) => [k, String(v)])));\n      }\n\n      // Sync state\n      const threshold = stats.syncWarningThreshold ?? 10;\n      const pendingFiles: number = stats.pendingFiles ?? 0;\n      const syncRunning: boolean = stats.syncRunning ?? false;\n      console.log();\n      console.log(section('  Sync'));\n      if (syncRunning) {\n        console.log(`  ${'\\x1b[33m'}\u26A0 Sync is currently running in the background.${reset}`);\n      } else {\n        console.log(`  ${label('Status')}     ${dim}idle${reset}`);\n      }\n      if (pendingFiles > 0) {\n        const warn = threshold > 0 && pendingFiles >= threshold;\n        const pendingLabel = warn ? `${'\\x1b[33m'}${pendingFiles} files pending${reset}` : `${dim}${pendingFiles} files pending${reset}`;\n        console.log(`  ${label('Pending')}    ${pendingLabel}`);\n        if (warn) {\n          console.log(`  ${'\\x1b[33m'}\u26A0 Index may be stale. Run \\`kirograph sync\\` to update.${reset}`);\n        }\n      } else {\n        console.log(`  ${label('Pending')}    ${green}up to date${reset}`);\n      }\n\n      console.log();\n      console.log(section('  Semantic Search'));\n      if (stats.embeddingsEnabled) {\n        const engineLabel =\n          stats.semanticEngine === 'sqlite-vec' ? `sqlite-vec  ${dim}(${stats.vecIndexCount} entries in ANN index)${reset}` :\n          stats.semanticEngine === 'orama'      ? `orama  ${dim}(hybrid \u2014 ${stats.vecIndexCount} docs in index)${reset}` :\n          stats.semanticEngine === 'pglite'     ? `pglite+pgvector  ${dim}(hybrid \u2014 ${stats.vecIndexCount} rows in DB)${reset}` :\n          stats.semanticEngine === 'lancedb'    ? `lancedb  ${dim}(${stats.vecIndexCount} entries in ANN index)${reset}` :\n          stats.semanticEngine === 'qdrant'     ? `qdrant  ${dim}(${stats.vecIndexCount} points in collection)${reset}` :\n          stats.semanticEngine === 'typesense'  ? `typesense  ${dim}(${stats.vecIndexCount} documents in collection)${reset}` :\n          `in-process cosine`;\n        const total = stats.embeddableNodeCount > 0 ? stats.embeddableNodeCount : stats.nodes;\n        const displayed = Math.min(stats.embeddingCount, total);\n        const coverage = total > 0 ? Math.min(100, Math.round((stats.embeddingCount / total) * 100)) : 0;\n        console.log(`  ${label('Status')}     ${green}${bold}enabled${reset}`);\n        console.log(`  ${label('Model')}      ${value(stats.embeddingModel)}`);\n        console.log(`  ${label('Engine')}     ${violet}${engineLabel}${reset}`);\n        if (stats.engineFallback) {\n          console.log(`  ${'\\x1b[33m'}\u26A0 engine fallback: ${stats.engineFallback}${reset}`);\n        }\n        console.log(`  ${label('Indexed')}    ${value(`${displayed} / ${total}`)}  ${dim}(${coverage}%)${reset}`);\n      } else {\n        console.log(`  ${label('Status')}     ${dim}disabled${reset}`);\n      }\n\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/commands/stop.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function register(program: Command): void;
+//# sourceMappingURL=stop.d.ts.map

package/dist/bin/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyC/C"}

package/dist/bin/commands/stop.js

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const ui_1 = require("../ui");
+const SERVER_STATE_FILE = 'typesense-server.json';
+function register(program) {
+    program
+        .command('stop [projectPath]')
+        .description('Stop background engine processes (e.g. Typesense)')
+        .action(async (projectPath) => {
+        const target = path.resolve(projectPath ?? process.cwd());
+        const stateFile = path.join(target, '.kirograph', SERVER_STATE_FILE);
+        if (!fs.existsSync(stateFile)) {
+            console.log(`\n  ${ui_1.dim}No background engine processes found.${ui_1.reset}\n`);
+            return;
+        }
+        let state;
+        try {
+            state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+        }
+        catch {
+            fs.unlinkSync(stateFile);
+            console.log(`\n  ${ui_1.dim}State file was corrupt — cleaned up.${ui_1.reset}\n`);
+            return;
+        }
+        console.log();
+        let killed = false;
+        try {
+            process.kill(state.pid, 0); // throws if not alive
+            process.kill(state.pid, 'SIGTERM');
+            killed = true;
+        }
+        catch {
+            // Process already gone
+        }
+        fs.unlinkSync(stateFile);
+        if (killed) {
+            console.log(`  ${ui_1.green}✓${ui_1.reset} Stopped Typesense server  ${ui_1.dim}(pid ${state.pid}, port ${state.apiPort})${ui_1.reset}`);
+        }
+        else {
+            console.log(`  ${ui_1.dim}Typesense server (pid ${state.pid}) was not running — state file cleaned up.${ui_1.reset}`);
+        }
+        console.log();
+    });
+}
+//# sourceMappingURL=stop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/bin/commands/stop.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,4BAyCC;AAjDD,2CAA6B;AAC7B,uCAAyB;AACzB,8BAAwD;AAExD,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAIlD,SAAgB,QAAQ,CAAC,OAAgB;IACvC,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;QAErE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,QAAG,wCAAwC,UAAK,IAAI,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,IAAI,KAAkB,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,OAAO,QAAG,uCAAuC,UAAK,IAAI,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB;YAClD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACnC,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;QAED,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEzB,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,KAAK,UAAK,IAAI,UAAK,8BAA8B,QAAG,QAAQ,KAAK,CAAC,GAAG,UAAU,KAAK,CAAC,OAAO,IAAI,UAAK,EAAE,CAAC,CAAC;QACvH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,QAAG,yBAAyB,KAAK,CAAC,GAAG,6CAA6C,UAAK,EAAE,CAAC,CAAC;QAC9G,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/bin/commands/surprising.js

@@ -0,0 +1,79 @@
+"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 surprising_exports = {};
+__export(surprising_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(surprising_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("surprising [projectPath]").description("Find non-obvious cross-file connections between distant symbols").option("--limit <n>", "Max results (default: 20)", "20").option("--format <fmt>", "Output format: table | json", "table").action(async (projectPath, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(projectPath ?? process.cwd());
+    const cg = await KiroGraph.open(target);
+    const limit = Math.max(1, Math.min(100, parseInt(opts.limit) || 20));
+    const connections = cg.findSurprisingConnections(limit);
+    cg.close();
+    if (connections.length === 0) {
+      console.log(`
+  ${import_ui.dim}No surprising cross-file connections found.${import_ui.reset}
+`);
+      return;
+    }
+    if (opts.format === "json") {
+      console.log(JSON.stringify(connections.map((c) => ({
+        source: { name: c.source.name, kind: c.source.kind, file: c.source.filePath },
+        target: { name: c.target.name, kind: c.target.kind, file: c.target.filePath },
+        kind: c.kind,
+        score: c.score
+      })), null, 2));
+      return;
+    }
+    console.log();
+    console.log(`  ${import_ui.violet}${import_ui.bold}Surprising Connections${import_ui.reset}  ${import_ui.dim}non-obvious cross-file links${import_ui.reset}
+`);
+    for (let i = 0; i < connections.length; i++) {
+      const c = connections[i];
+      const rank = String(i + 1).padStart(2);
+      const score = c.score.toFixed(2);
+      console.log(`  ${import_ui.dim}${rank}.${import_ui.reset} ${import_ui.violet}${import_ui.bold}${c.source.name}${import_ui.reset}  ${import_ui.dim}${c.source.kind}${import_ui.reset}  ${import_ui.dim}\u2500[${c.kind}]\u2192${import_ui.reset}  ${import_ui.violet}${import_ui.bold}${c.target.name}${import_ui.reset}  ${import_ui.dim}${c.target.kind}${import_ui.reset}  ${import_ui.dim}score: ${score}${import_ui.reset}`);
+      console.log(`      ${import_ui.dim}${c.source.filePath}${import_ui.reset}`);
+      console.log(`      ${import_ui.dim}${c.target.filePath}${import_ui.reset}`);
+    }
+    console.log(`
+  ${import_ui.dim}${connections.length} result(s) \u2014 score = path distance \xD7 edge weight${import_ui.reset}
+`);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=surprising.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/surprising.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('surprising [projectPath]')\n    .description('Find non-obvious cross-file connections between distant symbols')\n    .option('--limit <n>', 'Max results (default: 20)', '20')\n    .option('--format <fmt>', 'Output format: table | json', 'table')\n    .action(async (projectPath: string | undefined, opts: { limit: string; format: string }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(projectPath ?? process.cwd());\n      const cg = await KiroGraph.open(target);\n      const limit = Math.max(1, Math.min(100, parseInt(opts.limit) || 20));\n      const connections = cg.findSurprisingConnections(limit);\n      cg.close();\n\n      if (connections.length === 0) {\n        console.log(`\\n  ${dim}No surprising cross-file connections found.${reset}\\n`);\n        return;\n      }\n\n      if (opts.format === 'json') {\n        console.log(JSON.stringify(connections.map(c => ({\n          source: { name: c.source.name, kind: c.source.kind, file: c.source.filePath },\n          target: { name: c.target.name, kind: c.target.kind, file: c.target.filePath },\n          kind: c.kind,\n          score: c.score,\n        })), null, 2));\n        return;\n      }\n\n      console.log();\n      console.log(`  ${violet}${bold}Surprising Connections${reset}  ${dim}non-obvious cross-file links${reset}\\n`);\n\n      for (let i = 0; i < connections.length; i++) {\n        const c = connections[i];\n        const rank = String(i + 1).padStart(2);\n        const score = c.score.toFixed(2);\n        console.log(`  ${dim}${rank}.${reset} ${violet}${bold}${c.source.name}${reset}  ${dim}${c.source.kind}${reset}  ${dim}\u2500[${c.kind}]\u2192${reset}  ${violet}${bold}${c.target.name}${reset}  ${dim}${c.target.kind}${reset}  ${dim}score: ${score}${reset}`);\n        console.log(`      ${dim}${c.source.filePath}${reset}`);\n        console.log(`      ${dim}${c.target.filePath}${reset}`);\n      }\n\n      console.log(`\\n  ${dim}${connections.length} result(s) \u2014 score = path distance \u00D7 edge weight${reset}\\n`);\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,0BAA0B,EAClC,YAAY,iEAAiE,EAC7E,OAAO,eAAe,6BAA6B,IAAI,EACvD,OAAO,kBAAkB,+BAA+B,OAAO,EAC/D,OAAO,OAAO,aAAiC,SAA4C;AAC1F,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,eAAe,QAAQ,IAAI,CAAC;AACxD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AACtC,UAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,SAAS,KAAK,KAAK,KAAK,EAAE,CAAC;AACnE,UAAM,cAAc,GAAG,0BAA0B,KAAK;AACtD,OAAG,MAAM;AAET,QAAI,YAAY,WAAW,GAAG;AAC5B,cAAQ,IAAI;AAAA,IAAO,aAAG,8CAA8C,eAAK;AAAA,CAAI;AAC7E;AAAA,IACF;AAEA,QAAI,KAAK,WAAW,QAAQ;AAC1B,cAAQ,IAAI,KAAK,UAAU,YAAY,IAAI,QAAM;AAAA,QAC/C,QAAQ,EAAE,MAAM,EAAE,OAAO,MAAM,MAAM,EAAE,OAAO,MAAM,MAAM,EAAE,OAAO,SAAS;AAAA,QAC5E,QAAQ,EAAE,MAAM,EAAE,OAAO,MAAM,MAAM,EAAE,OAAO,MAAM,MAAM,EAAE,OAAO,SAAS;AAAA,QAC5E,MAAM,EAAE;AAAA,QACR,OAAO,EAAE;AAAA,MACX,EAAE,GAAG,MAAM,CAAC,CAAC;AACb;AAAA,IACF;AAEA,YAAQ,IAAI;AACZ,YAAQ,IAAI,KAAK,gBAAM,GAAG,cAAI,yBAAyB,eAAK,KAAK,aAAG,+BAA+B,eAAK;AAAA,CAAI;AAE5G,aAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;AAC3C,YAAM,IAAI,YAAY,CAAC;AACvB,YAAM,OAAO,OAAO,IAAI,CAAC,EAAE,SAAS,CAAC;AACrC,YAAM,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC/B,cAAQ,IAAI,KAAK,aAAG,GAAG,IAAI,IAAI,eAAK,IAAI,gBAAM,GAAG,cAAI,GAAG,EAAE,OAAO,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,OAAO,IAAI,GAAG,eAAK,KAAK,aAAG,UAAK,EAAE,IAAI,UAAK,eAAK,KAAK,gBAAM,GAAG,cAAI,GAAG,EAAE,OAAO,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,OAAO,IAAI,GAAG,eAAK,KAAK,aAAG,UAAU,KAAK,GAAG,eAAK,EAAE;AACrP,cAAQ,IAAI,SAAS,aAAG,GAAG,EAAE,OAAO,QAAQ,GAAG,eAAK,EAAE;AACtD,cAAQ,IAAI,SAAS,aAAG,GAAG,EAAE,OAAO,QAAQ,GAAG,eAAK,EAAE;AAAA,IACxD;AAEA,YAAQ,IAAI;AAAA,IAAO,aAAG,GAAG,YAAY,MAAM,2DAAmD,eAAK;AAAA,CAAI;AAAA,EACzG,CAAC;AACL;",
+  "names": []
+}

package/dist/bin/commands/sync-if-dirty.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function register(program: Command): void;
+//# sourceMappingURL=sync-if-dirty.d.ts.map

package/dist/bin/commands/sync-if-dirty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-if-dirty.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/sync-if-dirty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B/C"}

package/dist/bin/commands/sync-if-dirty.js

@@ -0,0 +1,67 @@
+"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 sync_if_dirty_exports = {};
+__export(sync_if_dirty_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(sync_if_dirty_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+var import_utils = require("./utils");
+function register(program) {
+  program.command("sync-if-dirty [projectPath]").description("Sync only if a dirty marker is present").option("-q, --quiet", "Suppress output").action(async (projectPath, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(projectPath ?? process.cwd());
+    if (!KiroGraph.isInitialized(target)) {
+      process.exit(0);
+    }
+    const cg = await KiroGraph.open(target);
+    const result = await cg.syncIfDirty();
+    if (!opts.quiet) {
+      if (result) {
+        const changed = result.added.length + result.modified.length + result.removed.length;
+        if (changed === 0) {
+          console.log(`  ${import_ui.dim}Index up to date.${import_ui.reset}`);
+        } else {
+          console.log((0, import_utils.formatSyncCounts)(result));
+        }
+        if (result.errors.length) console.warn(`  \x1B[33m\u26A0 ${result.errors.length} warning(s)\x1B[0m`);
+        (0, import_utils.warnFallback)(cg.getEngineFallback());
+      } else {
+        console.log(`  ${import_ui.dim}Not dirty, skipped.${import_ui.reset}`);
+      }
+    }
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=sync-if-dirty.js.map