kirograph 0.12.1

package/dist/bin/commands/mark-dirty.js

@@ -0,0 +1,51 @@
+"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 mark_dirty_exports = {};
+__export(mark_dirty_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(mark_dirty_exports);
+var path = __toESM(require("path"));
+function register(program) {
+  program.command("mark-dirty [projectPath]").description("Write a dirty marker to trigger deferred sync").action(async (projectPath) => {
+    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);
+    cg.markDirty();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=mark-dirty.js.map

package/dist/bin/commands/mark-dirty.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/mark-dirty.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\n\nexport function register(program: Command): void {\n  program\n    .command('mark-dirty [projectPath]')\n    .description('Write a dirty marker to trigger deferred sync')\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      if (!KiroGraph.isInitialized(target)) { process.exit(0); }\n      const cg = await KiroGraph.open(target);\n      cg.markDirty();\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,WAAsB;AAEf,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,0BAA0B,EAClC,YAAY,+CAA+C,EAC3D,OAAO,OAAO,gBAAoC;AACjD,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,SAAS,KAAK,QAAQ,eAAe,QAAQ,IAAI,CAAC;AACxD,QAAI,CAAC,UAAU,cAAc,MAAM,GAAG;AAAE,cAAQ,KAAK,CAAC;AAAA,IAAG;AACzD,UAAM,KAAK,MAAM,UAAU,KAAK,MAAM;AACtC,OAAG,UAAU;AACb,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

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

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

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

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

package/dist/bin/commands/package.js

@@ -0,0 +1,139 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var package_exports = {};
+__export(package_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(package_exports);
+var import_ui = require("../ui");
+function register(program) {
+  program.command("package <name>").description("Inspect a package: files, coupling, and dependencies").option("--no-files", "Omit file list").option("--format <fmt>", "Output format: markdown, json", "markdown").action(async (name, opts, cmd) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const cg = await KiroGraph.open(process.cwd());
+    if (!cg.isArchitectureEnabled()) {
+      console.error(`
+  ${"\x1B[33m"}\u26A0 Architecture analysis is disabled.${import_ui.reset}`);
+      console.error(`  ${import_ui.dim}Enable it in .kirograph/config.json:${import_ui.reset} ${import_ui.violet}${import_ui.bold}"enableArchitecture": true${import_ui.reset}`);
+      console.error(`  ${import_ui.dim}Then re-run:${import_ui.reset} ${import_ui.violet}${import_ui.bold}kirograph index${import_ui.reset}
+`);
+      cg.close();
+      process.exit(1);
+    }
+    const arch = cg.getArchitecture();
+    const query = name.toLowerCase();
+    const pkg = arch.packages.find(
+      (p) => p.name.toLowerCase().includes(query) || p.path.toLowerCase().includes(query) || p.id.toLowerCase().includes(query)
+    );
+    if (!pkg) {
+      console.error(`
+  ${"\x1B[38;5;203m"}\u2717 Package "${name}" not found.${import_ui.reset}`);
+      console.error(`  ${import_ui.dim}Run ${import_ui.reset}${import_ui.violet}${import_ui.bold}kirograph architecture --packages${import_ui.reset}${import_ui.dim} to list all packages.${import_ui.reset}
+`);
+      cg.close();
+      process.exit(1);
+    }
+    if (opts.format === "json") {
+      const deps2 = arch.packageDeps.filter((d) => d.sourcePkg === pkg.id);
+      const dependents2 = arch.packageDeps.filter((d) => d.targetPkg === pkg.id);
+      const coupling2 = arch.coupling.find((c) => c.packageId === pkg.id);
+      const files = Object.entries(arch.filePackages).filter(([, ids]) => ids.includes(pkg.id)).map(([f]) => f).sort();
+      console.log(JSON.stringify({ package: pkg, coupling: coupling2, deps: deps2, dependents: dependents2, files }, null, 2));
+      cg.close();
+      return;
+    }
+    const srcLabel = pkg.source === "manifest" ? `${import_ui.green}manifest${import_ui.reset}` : `${import_ui.dim}directory${import_ui.reset}`;
+    console.log(`
+  ${(0, import_ui.section)(pkg.name)}  ${import_ui.dim}${pkg.path}${import_ui.reset}`);
+    console.log(`  ${import_ui.dim}id: ${pkg.id}${import_ui.reset}
+`);
+    const meta = [
+      ["Source", pkg.source === "manifest" ? "manifest" : "directory"]
+    ];
+    if (pkg.language) meta.push(["Language", pkg.language]);
+    if (pkg.version) meta.push(["Version", pkg.version]);
+    if (pkg.manifestPath) meta.push(["Manifest", pkg.manifestPath]);
+    console.log((0, import_ui.renderTable)(meta));
+    const coupling = arch.coupling.find((c) => c.packageId === pkg.id);
+    if (coupling) {
+      console.log(`
+  ${(0, import_ui.section)("Coupling")}
+`);
+      console.log((0, import_ui.renderTable)([
+        ["Afferent Ca", String(coupling.afferent)],
+        ["Efferent Ce", String(coupling.efferent)],
+        ["Instability", `${(coupling.instability * 100).toFixed(0)}%`]
+      ]));
+    }
+    const deps = arch.packageDeps.filter((d) => d.sourcePkg === pkg.id);
+    if (deps.length > 0) {
+      console.log(`
+  ${(0, import_ui.label)("Depends on")}  ${import_ui.dim}(${deps.length})${import_ui.reset}
+`);
+      for (const dep of deps) {
+        const depName = arch.packages.find((p) => p.id === dep.targetPkg)?.name ?? dep.targetPkg;
+        console.log(`  ${import_ui.dim}\u2192${import_ui.reset}  ${import_ui.violet}${depName}${import_ui.reset}  ${import_ui.dim}(${dep.depCount} import${dep.depCount !== 1 ? "s" : ""})${import_ui.reset}`);
+      }
+    }
+    const dependents = arch.packageDeps.filter((d) => d.targetPkg === pkg.id);
+    if (dependents.length > 0) {
+      console.log(`
+  ${(0, import_ui.label)("Depended on by")}  ${import_ui.dim}(${dependents.length})${import_ui.reset}
+`);
+      for (const dep of dependents) {
+        const depName = arch.packages.find((p) => p.id === dep.sourcePkg)?.name ?? dep.sourcePkg;
+        console.log(`  ${import_ui.dim}\u2190${import_ui.reset}  ${import_ui.violet}${depName}${import_ui.reset}  ${import_ui.dim}(${dep.depCount} import${dep.depCount !== 1 ? "s" : ""})${import_ui.reset}`);
+      }
+    }
+    if (pkg.externalDeps && pkg.externalDeps.length > 0) {
+      console.log(`
+  ${(0, import_ui.label)("External deps")}  ${import_ui.dim}(${pkg.externalDeps.length})${import_ui.reset}
+`);
+      const chunks = [];
+      for (let i = 0; i < Math.min(pkg.externalDeps.length, 30); i += 4) {
+        chunks.push("  " + pkg.externalDeps.slice(i, i + 4).map((d) => `${import_ui.violet}${d}${import_ui.reset}`).join(`  ${import_ui.dim}\xB7${import_ui.reset}  `));
+      }
+      console.log(chunks.join("\n"));
+      if (pkg.externalDeps.length > 30) {
+        console.log(`  ${import_ui.dim}\u2026and ${pkg.externalDeps.length - 30} more${import_ui.reset}`);
+      }
+    }
+    if (opts.files) {
+      const files = Object.entries(arch.filePackages).filter(([, ids]) => ids.includes(pkg.id)).map(([f]) => f).sort();
+      if (files.length > 0) {
+        console.log(`
+  ${(0, import_ui.label)("Files")}  ${import_ui.dim}(${files.length})${import_ui.reset}
+`);
+        const shown = files.slice(0, 40);
+        for (const f of shown) {
+          console.log(`  ${import_ui.dim}${f}${import_ui.reset}`);
+        }
+        if (files.length > 40) {
+          console.log(`  ${import_ui.dim}\u2026and ${files.length - 40} more${import_ui.reset}`);
+        }
+      }
+    }
+    console.log();
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=package.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/package.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('package <name>')\n    .description('Inspect a package: files, coupling, and dependencies')\n    .option('--no-files', 'Omit file list')\n    .option('--format <fmt>', 'Output format: markdown, json', 'markdown')\n    .action(async (name: string, opts: { files: boolean; format: string }, cmd: Command) => {\n      // commander puts the project path as the parent option, but we keep it simple\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const cg = await KiroGraph.open(process.cwd());\n\n      if (!cg.isArchitectureEnabled()) {\n        console.error(`\\n  ${'\\x1b[33m'}\u26A0 Architecture analysis is disabled.${reset}`);\n        console.error(`  ${dim}Enable it in .kirograph/config.json:${reset} ${violet}${bold}\"enableArchitecture\": true${reset}`);\n        console.error(`  ${dim}Then re-run:${reset} ${violet}${bold}kirograph index${reset}\\n`);\n        cg.close(); process.exit(1);\n      }\n\n      const arch = cg.getArchitecture();\n      const query = name.toLowerCase();\n      const pkg = arch.packages.find(p =>\n        p.name.toLowerCase().includes(query) ||\n        p.path.toLowerCase().includes(query) ||\n        p.id.toLowerCase().includes(query)\n      );\n\n      if (!pkg) {\n        console.error(`\\n  ${'\\x1b[38;5;203m'}\u2717 Package \"${name}\" not found.${reset}`);\n        console.error(`  ${dim}Run ${reset}${violet}${bold}kirograph architecture --packages${reset}${dim} to list all packages.${reset}\\n`);\n        cg.close(); process.exit(1);\n      }\n\n      if (opts.format === 'json') {\n        const deps      = arch.packageDeps.filter(d => d.sourcePkg === pkg.id);\n        const dependents = arch.packageDeps.filter(d => d.targetPkg === pkg.id);\n        const coupling  = arch.coupling.find(c => c.packageId === pkg.id);\n        const files     = Object.entries(arch.filePackages)\n          .filter(([, ids]) => ids.includes(pkg.id))\n          .map(([f]) => f)\n          .sort();\n        console.log(JSON.stringify({ package: pkg, coupling, deps, dependents, files }, null, 2));\n        cg.close(); return;\n      }\n\n      // \u2500\u2500 Header \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n      const srcLabel = pkg.source === 'manifest'\n        ? `${green}manifest${reset}`\n        : `${dim}directory${reset}`;\n\n      console.log(`\\n  ${section(pkg.name)}  ${dim}${pkg.path}${reset}`);\n      console.log(`  ${dim}id: ${pkg.id}${reset}\\n`);\n\n      const meta: [string, string][] = [\n        ['Source', pkg.source === 'manifest' ? 'manifest' : 'directory'],\n      ];\n      if (pkg.language)     meta.push(['Language', pkg.language]);\n      if (pkg.version)      meta.push(['Version', pkg.version]);\n      if (pkg.manifestPath) meta.push(['Manifest', pkg.manifestPath]);\n      console.log(renderTable(meta));\n\n      // \u2500\u2500 Coupling \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n      const coupling = arch.coupling.find(c => c.packageId === pkg.id);\n      if (coupling) {\n        console.log(`\\n  ${section('Coupling')}\\n`);\n        console.log(renderTable([\n          ['Afferent Ca',  String(coupling.afferent)],\n          ['Efferent Ce',  String(coupling.efferent)],\n          ['Instability',  `${(coupling.instability * 100).toFixed(0)}%`],\n        ]));\n      }\n\n      // \u2500\u2500 Dependencies \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n      const deps = arch.packageDeps.filter(d => d.sourcePkg === pkg.id);\n      if (deps.length > 0) {\n        console.log(`\\n  ${label('Depends on')}  ${dim}(${deps.length})${reset}\\n`);\n        for (const dep of deps) {\n          const depName = arch.packages.find(p => p.id === dep.targetPkg)?.name ?? dep.targetPkg;\n          console.log(`  ${dim}\u2192${reset}  ${violet}${depName}${reset}  ${dim}(${dep.depCount} import${dep.depCount !== 1 ? 's' : ''})${reset}`);\n        }\n      }\n\n      const dependents = arch.packageDeps.filter(d => d.targetPkg === pkg.id);\n      if (dependents.length > 0) {\n        console.log(`\\n  ${label('Depended on by')}  ${dim}(${dependents.length})${reset}\\n`);\n        for (const dep of dependents) {\n          const depName = arch.packages.find(p => p.id === dep.sourcePkg)?.name ?? dep.sourcePkg;\n          console.log(`  ${dim}\u2190${reset}  ${violet}${depName}${reset}  ${dim}(${dep.depCount} import${dep.depCount !== 1 ? 's' : ''})${reset}`);\n        }\n      }\n\n      // \u2500\u2500 External deps \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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      if (pkg.externalDeps && pkg.externalDeps.length > 0) {\n        console.log(`\\n  ${label('External deps')}  ${dim}(${pkg.externalDeps.length})${reset}\\n`);\n        const chunks: string[] = [];\n        for (let i = 0; i < Math.min(pkg.externalDeps.length, 30); i += 4) {\n          chunks.push('  ' + pkg.externalDeps.slice(i, i + 4).map(d => `${violet}${d}${reset}`).join(`  ${dim}\u00B7${reset}  `));\n        }\n        console.log(chunks.join('\\n'));\n        if (pkg.externalDeps.length > 30) {\n          console.log(`  ${dim}\u2026and ${pkg.externalDeps.length - 30} more${reset}`);\n        }\n      }\n\n      // \u2500\u2500 Files \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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      if (opts.files) {\n        const files = Object.entries(arch.filePackages)\n          .filter(([, ids]) => ids.includes(pkg.id))\n          .map(([f]) => f)\n          .sort();\n\n        if (files.length > 0) {\n          console.log(`\\n  ${label('Files')}  ${dim}(${files.length})${reset}\\n`);\n          const shown = files.slice(0, 40);\n          for (const f of shown) {\n            console.log(`  ${dim}${f}${reset}`);\n          }\n          if (files.length > 40) {\n            console.log(`  ${dim}\u2026and ${files.length - 40} more${reset}`);\n          }\n        }\n      }\n\n      console.log();\n      cg.close();\n    });\n}\n"],
+  "mappings": "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",
+  "names": ["deps", "dependents", "coupling"]
+}

package/dist/bin/commands/path.js

@@ -0,0 +1,93 @@
+"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 path_exports = {};
+__export(path_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(path_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("path <from> <to>").description("Find the shortest path between two symbols in the graph").option("--format <fmt>", "Output format: table | json", "table").action(async (from, to, opts, cmd) => {
+    const projectPath = cmd.parent?.args.find((_, i, arr) => arr[i - 1] === "--path");
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const target = path.resolve(process.cwd());
+    const cg = await KiroGraph.open(target);
+    const fromResults = cg.searchNodes(from, void 0, 3);
+    const toResults = cg.searchNodes(to, void 0, 3);
+    if (fromResults.length === 0) {
+      console.error(`
+  Symbol "${from}" not found in index.
+`);
+      cg.close();
+      return;
+    }
+    if (toResults.length === 0) {
+      console.error(`
+  Symbol "${to}" not found in index.
+`);
+      cg.close();
+      return;
+    }
+    const SYMBOL_KINDS = /* @__PURE__ */ new Set(["function", "method", "class", "interface", "type_alias", "variable", "component", "route", "constant"]);
+    const preferSymbol = (results) => results.find((r) => SYMBOL_KINDS.has(r.node.kind)) ?? results[0];
+    const fromNode = preferSymbol(fromResults).node;
+    const toNode = preferSymbol(toResults).node;
+    const pathNodes = await cg.findPath(fromNode.id, toNode.id);
+    cg.close();
+    if (opts.format === "json") {
+      console.log(JSON.stringify(pathNodes, null, 2));
+      return;
+    }
+    console.log();
+    console.log(`  ${import_ui.dim}from  ${import_ui.reset}${import_ui.violet}${import_ui.bold}${fromNode.name}${import_ui.reset}  ${import_ui.dim}${fromNode.kind}  ${fromNode.filePath}:${fromNode.startLine}${import_ui.reset}`);
+    console.log(`  ${import_ui.dim}to    ${import_ui.reset}${import_ui.violet}${import_ui.bold}${toNode.name}${import_ui.reset}  ${import_ui.dim}${toNode.kind}  ${toNode.filePath}:${toNode.startLine}${import_ui.reset}
+`);
+    if (pathNodes.length === 0) {
+      console.log(`  ${import_ui.dim}No path found.${import_ui.reset}
+`);
+      return;
+    }
+    console.log(`  ${import_ui.violet}${import_ui.bold}Path${import_ui.reset}  ${import_ui.dim}${pathNodes.length} hop${pathNodes.length === 1 ? "" : "s"}${import_ui.reset}
+`);
+    for (let i = 0; i < pathNodes.length; i++) {
+      const n = pathNodes[i];
+      const connector = i < pathNodes.length - 1 ? `
+  ${import_ui.dim}\u2502${import_ui.reset}` : "";
+      console.log(`  ${import_ui.dim}${String(i + 1).padStart(2)}.${import_ui.reset} ${import_ui.violet}${import_ui.bold}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}${import_ui.reset}`);
+      console.log(`      ${import_ui.dim}${n.filePath}:${n.startLine}${import_ui.reset}${connector}`);
+    }
+    console.log();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=path.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/path.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('path <from> <to>')\n    .description('Find the shortest path between two symbols in the graph')\n    .option('--format <fmt>', 'Output format: table | json', 'table')\n    .action(async (from: string, to: string, opts: { format: string }, cmd: Command) => {\n      const projectPath = cmd.parent?.args.find((_, i, arr) => arr[i - 1] === '--path');\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const target = path.resolve(process.cwd());\n      const cg = await KiroGraph.open(target);\n\n      const fromResults = cg.searchNodes(from, undefined, 3);\n      const toResults   = cg.searchNodes(to,   undefined, 3);\n\n      if (fromResults.length === 0) {\n        console.error(`\\n  Symbol \"${from}\" not found in index.\\n`);\n        cg.close();\n        return;\n      }\n      if (toResults.length === 0) {\n        console.error(`\\n  Symbol \"${to}\" not found in index.\\n`);\n        cg.close();\n        return;\n      }\n\n      const SYMBOL_KINDS = new Set(['function', 'method', 'class', 'interface', 'type_alias', 'variable', 'component', 'route', 'constant']);\n      const preferSymbol = (results: typeof fromResults) =>\n        results.find(r => SYMBOL_KINDS.has(r.node.kind)) ?? results[0];\n\n      const fromNode = preferSymbol(fromResults).node;\n      const toNode   = preferSymbol(toResults).node;\n      const pathNodes = await cg.findPath(fromNode.id, toNode.id);\n      cg.close();\n\n      if (opts.format === 'json') {\n        console.log(JSON.stringify(pathNodes, null, 2));\n        return;\n      }\n\n      console.log();\n      console.log(`  ${dim}from  ${reset}${violet}${bold}${fromNode.name}${reset}  ${dim}${fromNode.kind}  ${fromNode.filePath}:${fromNode.startLine}${reset}`);\n      console.log(`  ${dim}to    ${reset}${violet}${bold}${toNode.name}${reset}  ${dim}${toNode.kind}  ${toNode.filePath}:${toNode.startLine}${reset}\\n`);\n\n      if (pathNodes.length === 0) {\n        console.log(`  ${dim}No path found.${reset}\\n`);\n        return;\n      }\n\n      console.log(`  ${violet}${bold}Path${reset}  ${dim}${pathNodes.length} hop${pathNodes.length === 1 ? '' : 's'}${reset}\\n`);\n\n      for (let i = 0; i < pathNodes.length; i++) {\n        const n = pathNodes[i];\n        const connector = i < pathNodes.length - 1 ? `\\n  ${dim}\u2502${reset}` : '';\n        console.log(`  ${dim}${String(i + 1).padStart(2)}.${reset} ${violet}${bold}${n.name}${reset}  ${dim}${n.kind}${reset}`);\n        console.log(`      ${dim}${n.filePath}:${n.startLine}${reset}${connector}`);\n      }\n\n      console.log();\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

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

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

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

package/dist/bin/commands/qdrant.js

@@ -0,0 +1,159 @@
+"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 http = __importStar(require("http"));
+const ui_1 = require("../ui");
+const qdrant_dashboard_1 = require("../installer/qdrant-dashboard");
+const SERVER_STATE_FILE = 'qdrant-server.json';
+function readState(kirographDir) {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(kirographDir, SERVER_STATE_FILE), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Check if the Qdrant dashboard endpoint returns something other than 404. */
+function dashboardReachable(port) {
+    return new Promise(resolve => {
+        const req = http.get(`http://127.0.0.1:${port}/dashboard`, res => {
+            resolve(res.statusCode !== 404);
+            res.resume();
+        });
+        req.on('error', () => resolve(false));
+        req.setTimeout(1000, () => { req.destroy(); resolve(false); });
+    });
+}
+function register(program) {
+    const cmd = program
+        .command('qdrant [projectPath]')
+        .description('Manage the Qdrant engine and dashboard');
+    // ── start ──────────────────────────────────────────────────────────────────
+    cmd.command('start [projectPath]')
+        .description('Start the Qdrant server (if not running) and open the dashboard')
+        .action(async (projectPath) => {
+        const target = path.resolve(projectPath ?? process.cwd());
+        const kirographDir = path.join(target, '.kirograph');
+        // 1. Ensure UI files are downloaded BEFORE starting Qdrant so
+        //    QdrantIndex.initialize() finds them and sets STATIC_CONTENT_DIR.
+        const uiReady = await (0, qdrant_dashboard_1.ensureQdrantUI)(target);
+        if (!uiReady) {
+            console.log(`  Could not download Qdrant Web UI.\n`);
+            return;
+        }
+        // 2. If already running, check whether the dashboard is actually served.
+        //    If not (started without static dir), restart so it picks up the files.
+        const saved = readState(kirographDir);
+        if (saved && isAlive(saved.pid)) {
+            const hasDashboard = await dashboardReachable(saved.port);
+            if (!hasDashboard) {
+                // Restart with static content dir now that UI files are present
+                try {
+                    process.kill(saved.pid, 'SIGTERM');
+                }
+                catch { /* ignore */ }
+                await new Promise(r => setTimeout(r, 400));
+                try {
+                    fs.unlinkSync(path.join(kirographDir, SERVER_STATE_FILE));
+                }
+                catch { /* ignore */ }
+            }
+            else {
+                console.log(`\n  ${ui_1.green}✓${ui_1.reset} Qdrant already running with dashboard  ${ui_1.dim}(pid ${saved.pid}, port ${saved.port})${ui_1.reset}`);
+                await (0, qdrant_dashboard_1.openQdrantDashboard)(target);
+                console.log(`  ${ui_1.dim}Qdrant keeps running in the background — use ${ui_1.reset}kg qdrant stop${ui_1.dim} to shut it down.${ui_1.reset}\n`);
+                return;
+            }
+        }
+        // 3. Spawn (or re-spawn) Qdrant — files are in place so STATIC_CONTENT_DIR is set
+        console.log();
+        const { QdrantIndex } = await Promise.resolve().then(() => __importStar(require('../../vectors/qdrant-index')));
+        const index = new QdrantIndex(kirographDir);
+        await index.initialize();
+        if (!index.isAvailable()) {
+            console.log(`  Qdrant failed to start.\n`);
+            return;
+        }
+        index.close();
+        await (0, qdrant_dashboard_1.openQdrantDashboard)(target);
+        console.log(`  ${ui_1.dim}Qdrant keeps running in the background — use ${ui_1.reset}kg qdrant stop${ui_1.dim} to shut it down.${ui_1.reset}\n`);
+    });
+    // ── stop ───────────────────────────────────────────────────────────────────
+    cmd.command('stop [projectPath]')
+        .description('Stop the Qdrant server')
+        .action((projectPath) => {
+        const target = path.resolve(projectPath ?? process.cwd());
+        const kirographDir = path.join(target, '.kirograph');
+        const stateFile = path.join(kirographDir, SERVER_STATE_FILE);
+        console.log();
+        const saved = readState(kirographDir);
+        if (!saved) {
+            console.log(`  ${ui_1.dim}No running Qdrant server found.${ui_1.reset}\n`);
+            return;
+        }
+        let killed = false;
+        if (isAlive(saved.pid)) {
+            try {
+                process.kill(saved.pid, 'SIGTERM');
+                killed = true;
+            }
+            catch { /* ignore */ }
+        }
+        try {
+            fs.unlinkSync(stateFile);
+        }
+        catch { /* ignore */ }
+        if (killed) {
+            console.log(`  ${ui_1.green}✓${ui_1.reset} ${(0, ui_1.label)('Stopped')} Qdrant server  ${ui_1.dim}(pid ${saved.pid}, port ${saved.port})${ui_1.reset}`);
+        }
+        else {
+            console.log(`  ${ui_1.dim}Qdrant server (pid ${saved.pid}) was not running — state file cleaned up.${ui_1.reset}`);
+        }
+        console.log();
+    });
+}
+//# sourceMappingURL=qdrant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant.js","sourceRoot":"","sources":["../../../src/bin/commands/qdrant.ts"],"names":[],"mappings":"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"}

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

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

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

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

package/dist/bin/commands/query.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var query_exports = {};
+__export(query_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(query_exports);
+var import_ui = require("../ui");
+function register(program) {
+  program.command("query <search>").description("Search for symbols").option("--kind <kind>", "Filter by kind").option("--limit <n>", "Max results", "10").action(async (search, opts) => {
+    const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+    const cg = await KiroGraph.open(process.cwd());
+    const results = cg.searchNodes(search, opts.kind, parseInt(opts.limit));
+    if (results.length === 0) {
+      console.log(`  ${import_ui.dim}No results for${import_ui.reset} ${import_ui.violet}${import_ui.bold}${search}${import_ui.reset}`);
+    } else {
+      console.log();
+      for (const r of results) {
+        console.log(`  ${import_ui.violet}${import_ui.bold}${r.node.name}${import_ui.reset}  ${import_ui.dim}${r.node.kind}${import_ui.reset}  ${import_ui.dim}${r.node.filePath}:${r.node.startLine}${import_ui.reset}`);
+      }
+      console.log(`
+  ${import_ui.dim}${results.length} result(s)${import_ui.reset}`);
+    }
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/query.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport { dim, reset, violet, bold } from '../ui';\n\nexport function register(program: Command): void {\n  program\n    .command('query <search>')\n    .description('Search for symbols')\n    .option('--kind <kind>', 'Filter by kind')\n    .option('--limit <n>', 'Max results', '10')\n    .action(async (search: string, opts: { kind?: string; limit: string }) => {\n      const KiroGraph = (await Promise.resolve().then(() => require('../../index.js'))).default;\n      const cg = await KiroGraph.open(process.cwd());\n      const results = cg.searchNodes(search, opts.kind as any, parseInt(opts.limit));\n      if (results.length === 0) {\n        console.log(`  ${dim}No results for${reset} ${violet}${bold}${search}${reset}`);\n      } else {\n        console.log();\n        for (const r of results) {\n          console.log(`  ${violet}${bold}${r.node.name}${reset}  ${dim}${r.node.kind}${reset}  ${dim}${r.node.filePath}:${r.node.startLine}${reset}`);\n        }\n        console.log(`\\n  ${dim}${results.length} result(s)${reset}`);\n      }\n      cg.close();\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,gBAAgB,EACxB,YAAY,oBAAoB,EAChC,OAAO,iBAAiB,gBAAgB,EACxC,OAAO,eAAe,eAAe,IAAI,EACzC,OAAO,OAAO,QAAgB,SAA2C;AACxE,UAAM,aAAa,MAAM,QAAQ,QAAQ,EAAE,KAAK,MAAM,QAAQ,gBAAgB,CAAC,GAAG;AAClF,UAAM,KAAK,MAAM,UAAU,KAAK,QAAQ,IAAI,CAAC;AAC7C,UAAM,UAAU,GAAG,YAAY,QAAQ,KAAK,MAAa,SAAS,KAAK,KAAK,CAAC;AAC7E,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,IAAI,KAAK,aAAG,iBAAiB,eAAK,IAAI,gBAAM,GAAG,cAAI,GAAG,MAAM,GAAG,eAAK,EAAE;AAAA,IAChF,OAAO;AACL,cAAQ,IAAI;AACZ,iBAAW,KAAK,SAAS;AACvB,gBAAQ,IAAI,KAAK,gBAAM,GAAG,cAAI,GAAG,EAAE,KAAK,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,KAAK,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,SAAS,GAAG,eAAK,EAAE;AAAA,MAC5I;AACA,cAAQ,IAAI;AAAA,IAAO,aAAG,GAAG,QAAQ,MAAM,aAAa,eAAK,EAAE;AAAA,IAC7D;AACA,OAAG,MAAM;AAAA,EACX,CAAC;AACL;",
+  "names": []
+}

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

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

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

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