kirograph 0.12.1

package/dist/bin/commands/coupling.js

@@ -0,0 +1,164 @@
+"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 coupling_exports = {};
+__export(coupling_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(coupling_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+const INSTABILITY_HIGH = 0.7;
+const INSTABILITY_LOW = 0.3;
+function instabilityBar(i) {
+  const pct = Math.round(i * 10);
+  const filled = "\u2588".repeat(pct);
+  const empty = "\u2591".repeat(10 - pct);
+  const color = i >= INSTABILITY_HIGH ? "\x1B[38;5;203m" : i <= INSTABILITY_LOW ? import_ui.green : "\x1B[33m";
+  return `${color}${filled}${import_ui.dim}${empty}${import_ui.reset}`;
+}
+function instabilityLabel(i) {
+  if (i >= INSTABILITY_HIGH) return `${"\x1B[38;5;203m"}unstable${import_ui.reset}`;
+  if (i <= INSTABILITY_LOW) return `${import_ui.green}stable${import_ui.reset}`;
+  return `${"\x1B[33m"}neutral${import_ui.reset}`;
+}
+function register(program) {
+  program.command("coupling [projectPath]").description("Show package coupling metrics (Ca, Ce, instability)").option("--package <id>", "Show details for a single package (ID or name fragment)").option("--sort <by>", "Sort by: instability, ca, ce, name", "instability").option("--format <fmt>", "Output format: markdown, json", "markdown").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);
+    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();
+    if (opts.format === "json") {
+      const out = opts.package ? arch.coupling.filter((c) => c.packageId.includes(opts.package) || arch.packages.find((p) => p.id === c.packageId)?.name.includes(opts.package)) : arch.coupling;
+      console.log(JSON.stringify(out, null, 2));
+      cg.close();
+      return;
+    }
+    if (opts.package) {
+      const pkg = arch.packages.find(
+        (p) => p.id.includes(opts.package) || p.name.toLowerCase().includes(opts.package.toLowerCase())
+      );
+      if (!pkg) {
+        console.error(`
+  ${"\x1B[38;5;203m"}\u2717 Package not found: ${opts.package}${import_ui.reset}
+`);
+        cg.close();
+        process.exit(1);
+      }
+      const c = arch.coupling.find((x) => x.packageId === pkg.id);
+      console.log(`
+  ${(0, import_ui.section)(pkg.name)}  ${import_ui.dim}${pkg.path}${import_ui.reset}
+`);
+      console.log((0, import_ui.renderTable)([
+        ["Afferent Ca", String(c?.afferent ?? 0)],
+        ["Efferent Ce", String(c?.efferent ?? 0)],
+        ["Instability", c ? `${(c.instability * 100).toFixed(0)}%` : "n/a"]
+      ]));
+      const incoming = arch.packageDeps.filter((d) => d.targetPkg === pkg.id);
+      if (incoming.length > 0) {
+        console.log(`
+  ${(0, import_ui.label)("Depended on by")}  ${import_ui.dim}(${incoming.length})${import_ui.reset}
+`);
+        for (const d of incoming) {
+          const name = arch.packages.find((p) => p.id === d.sourcePkg)?.name ?? d.sourcePkg;
+          console.log(`  ${import_ui.dim}\u2190${import_ui.reset}  ${import_ui.violet}${name}${import_ui.reset}  ${import_ui.dim}(${d.depCount} import${d.depCount !== 1 ? "s" : ""})${import_ui.reset}`);
+        }
+      }
+      const outgoing = arch.packageDeps.filter((d) => d.sourcePkg === pkg.id);
+      if (outgoing.length > 0) {
+        console.log(`
+  ${(0, import_ui.label)("Depends on")}  ${import_ui.dim}(${outgoing.length})${import_ui.reset}
+`);
+        for (const d of outgoing) {
+          const name = arch.packages.find((p) => p.id === d.targetPkg)?.name ?? d.targetPkg;
+          console.log(`  ${import_ui.dim}\u2192${import_ui.reset}  ${import_ui.violet}${name}${import_ui.reset}  ${import_ui.dim}(${d.depCount} import${d.depCount !== 1 ? "s" : ""})${import_ui.reset}`);
+        }
+      }
+      console.log();
+      cg.close();
+      return;
+    }
+    let coupling = arch.coupling.slice();
+    const pkgById = new Map(arch.packages.map((p) => [p.id, p]));
+    switch (opts.sort) {
+      case "ca":
+        coupling.sort((a, b) => b.afferent - a.afferent);
+        break;
+      case "ce":
+        coupling.sort((a, b) => b.efferent - a.efferent);
+        break;
+      case "name":
+        coupling.sort((a, b) => (pkgById.get(a.packageId)?.name ?? "").localeCompare(pkgById.get(b.packageId)?.name ?? ""));
+        break;
+      default:
+        coupling.sort((a, b) => b.instability - a.instability);
+        break;
+    }
+    console.log(`
+  ${(0, import_ui.section)("Coupling Metrics")}  ${import_ui.dim}sorted by ${opts.sort}${import_ui.reset}
+`);
+    if (coupling.length === 0) {
+      console.log(`  ${import_ui.dim}No coupling data. Run ${import_ui.reset}${import_ui.violet}${import_ui.bold}kirograph index${import_ui.reset}${import_ui.dim} with enableArchitecture=true.${import_ui.reset}
+`);
+      cg.close();
+      return;
+    }
+    const nameW = Math.max(...coupling.map((c) => (pkgById.get(c.packageId)?.name ?? c.packageId).length), 4);
+    console.log(`  ${import_ui.dim}${"Package".padEnd(nameW)}  Ca   Ce   Instability${import_ui.reset}`);
+    console.log(`  ${import_ui.dim}${"\u2500".repeat(nameW + 26)}${import_ui.reset}`);
+    for (const c of coupling) {
+      const pkg = pkgById.get(c.packageId);
+      const name = (pkg?.name ?? c.packageId).padEnd(nameW);
+      const ca = String(c.afferent).padStart(3);
+      const ce = String(c.efferent).padStart(3);
+      const pct = `${(c.instability * 100).toFixed(0)}%`.padStart(4);
+      const bar = instabilityBar(c.instability);
+      const lbl = instabilityLabel(c.instability);
+      console.log(`  ${import_ui.violet}${name}${import_ui.reset}  ${import_ui.dim}${ca}${import_ui.reset}  ${import_ui.dim}${ce}${import_ui.reset}  ${bar} ${pct}  ${lbl}`);
+    }
+    const avgInstability = coupling.length > 0 ? coupling.reduce((s, c) => s + c.instability, 0) / coupling.length : 0;
+    console.log(`
+  ${(0, import_ui.label)("Packages")}  ${(0, import_ui.value)(String(coupling.length))}    ${(0, import_ui.label)("Avg instability")}  ${(0, import_ui.value)(`${(avgInstability * 100).toFixed(0)}%`)}
+`);
+    cg.close();
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=coupling.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/coupling.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport { dim, reset, violet, bold, green, label, value, section, renderTable } from '../ui';\n\nconst INSTABILITY_HIGH   = 0.7;\nconst INSTABILITY_LOW    = 0.3;\n\nfunction instabilityBar(i: number): string {\n  const pct = Math.round(i * 10);\n  const filled = '\u2588'.repeat(pct);\n  const empty  = '\u2591'.repeat(10 - pct);\n  const color  = i >= INSTABILITY_HIGH ? '\\x1b[38;5;203m' : i <= INSTABILITY_LOW ? green : '\\x1b[33m';\n  return `${color}${filled}${dim}${empty}${reset}`;\n}\n\nfunction instabilityLabel(i: number): string {\n  if (i >= INSTABILITY_HIGH) return `${'\\x1b[38;5;203m'}unstable${reset}`;\n  if (i <= INSTABILITY_LOW)  return `${green}stable${reset}`;\n  return `${'\\x1b[33m'}neutral${reset}`;\n}\n\nexport function register(program: Command): void {\n  program\n    .command('coupling [projectPath]')\n    .description('Show package coupling metrics (Ca, Ce, instability)')\n    .option('--package <id>', 'Show details for a single package (ID or name fragment)')\n    .option('--sort <by>', 'Sort by: instability, ca, ce, name', 'instability')\n    .option('--format <fmt>', 'Output format: markdown, json', 'markdown')\n    .action(async (projectPath: string | undefined, opts: { package?: string; sort: 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\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\n      if (opts.format === 'json') {\n        const out = opts.package\n          ? arch.coupling.filter(c => c.packageId.includes(opts.package!) || arch.packages.find(p => p.id === c.packageId)?.name.includes(opts.package!))\n          : arch.coupling;\n        console.log(JSON.stringify(out, null, 2));\n        cg.close(); return;\n      }\n\n      // \u2500\u2500 Single package detail \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.package) {\n        const pkg = arch.packages.find(p =>\n          p.id.includes(opts.package!) || p.name.toLowerCase().includes(opts.package!.toLowerCase())\n        );\n        if (!pkg) {\n          console.error(`\\n  ${'\\x1b[38;5;203m'}\u2717 Package not found: ${opts.package}${reset}\\n`);\n          cg.close(); process.exit(1);\n        }\n        const c = arch.coupling.find(x => x.packageId === pkg.id);\n\n        console.log(`\\n  ${section(pkg.name)}  ${dim}${pkg.path}${reset}\\n`);\n        console.log(renderTable([\n          ['Afferent Ca',   String(c?.afferent ?? 0)],\n          ['Efferent Ce',   String(c?.efferent ?? 0)],\n          ['Instability',   c ? `${(c.instability * 100).toFixed(0)}%` : 'n/a'],\n        ]));\n\n        // Incoming deps (who depends on this package)\n        const incoming = arch.packageDeps.filter(d => d.targetPkg === pkg.id);\n        if (incoming.length > 0) {\n          console.log(`\\n  ${label('Depended on by')}  ${dim}(${incoming.length})${reset}\\n`);\n          for (const d of incoming) {\n            const name = arch.packages.find(p => p.id === d.sourcePkg)?.name ?? d.sourcePkg;\n            console.log(`  ${dim}\u2190${reset}  ${violet}${name}${reset}  ${dim}(${d.depCount} import${d.depCount !== 1 ? 's' : ''})${reset}`);\n          }\n        }\n\n        // Outgoing deps (what this package depends on)\n        const outgoing = arch.packageDeps.filter(d => d.sourcePkg === pkg.id);\n        if (outgoing.length > 0) {\n          console.log(`\\n  ${label('Depends on')}  ${dim}(${outgoing.length})${reset}\\n`);\n          for (const d of outgoing) {\n            const name = arch.packages.find(p => p.id === d.targetPkg)?.name ?? d.targetPkg;\n            console.log(`  ${dim}\u2192${reset}  ${violet}${name}${reset}  ${dim}(${d.depCount} import${d.depCount !== 1 ? 's' : ''})${reset}`);\n          }\n        }\n\n        console.log();\n        cg.close(); return;\n      }\n\n      // \u2500\u2500 All packages overview \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      let coupling = arch.coupling.slice();\n\n      // Attach package name for sorting/display\n      const pkgById = new Map(arch.packages.map(p => [p.id, p]));\n\n      switch (opts.sort) {\n        case 'ca':   coupling.sort((a, b) => b.afferent - a.afferent); break;\n        case 'ce':   coupling.sort((a, b) => b.efferent - a.efferent); break;\n        case 'name': coupling.sort((a, b) => (pkgById.get(a.packageId)?.name ?? '').localeCompare(pkgById.get(b.packageId)?.name ?? '')); break;\n        default:     coupling.sort((a, b) => b.instability - a.instability); break;\n      }\n\n      console.log(`\\n  ${section('Coupling Metrics')}  ${dim}sorted by ${opts.sort}${reset}\\n`);\n\n      if (coupling.length === 0) {\n        console.log(`  ${dim}No coupling data. Run ${reset}${violet}${bold}kirograph index${reset}${dim} with enableArchitecture=true.${reset}\\n`);\n        cg.close(); return;\n      }\n\n      const nameW = Math.max(...coupling.map(c => (pkgById.get(c.packageId)?.name ?? c.packageId).length), 4);\n\n      // Header\n      console.log(`  ${dim}${'Package'.padEnd(nameW)}  Ca   Ce   Instability${reset}`);\n      console.log(`  ${dim}${'\u2500'.repeat(nameW + 26)}${reset}`);\n\n      for (const c of coupling) {\n        const pkg = pkgById.get(c.packageId);\n        const name = (pkg?.name ?? c.packageId).padEnd(nameW);\n        const ca = String(c.afferent).padStart(3);\n        const ce = String(c.efferent).padStart(3);\n        const pct = `${(c.instability * 100).toFixed(0)}%`.padStart(4);\n        const bar = instabilityBar(c.instability);\n        const lbl = instabilityLabel(c.instability);\n        console.log(`  ${violet}${name}${reset}  ${dim}${ca}${reset}  ${dim}${ce}${reset}  ${bar} ${pct}  ${lbl}`);\n      }\n\n      // Summary\n      const avgInstability = coupling.length > 0\n        ? coupling.reduce((s, c) => s + c.instability, 0) / coupling.length\n        : 0;\n      console.log(`\\n  ${label('Packages')}  ${value(String(coupling.length))}    ${label('Avg instability')}  ${value(`${(avgInstability * 100).toFixed(0)}%`)}\\n`);\n\n      cg.close();\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

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

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

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

package/dist/bin/commands/dashboard.js

@@ -0,0 +1,209 @@
+"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 dashboard_exports = {};
+__export(dashboard_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(dashboard_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var http = __toESM(require("http"));
+var import_ui = require("../ui");
+var import_config = require("../../config");
+function readJson(file) {
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function killState(stateFile, pid, label_, portLabel) {
+  let killed = false;
+  if (isAlive(pid)) {
+    try {
+      process.kill(pid, "SIGTERM");
+      killed = true;
+    } catch {
+    }
+  }
+  try {
+    fs.unlinkSync(stateFile);
+  } catch {
+  }
+  if (killed) {
+    console.log(`  ${import_ui.green}\u2713${import_ui.reset} ${(0, import_ui.label)("Stopped")} ${label_}  ${import_ui.dim}(pid ${pid}, port ${portLabel})${import_ui.reset}`);
+  } else {
+    console.log(`  ${import_ui.dim}${label_} (pid ${pid}) was not running \u2014 state file cleaned up.${import_ui.reset}`);
+  }
+}
+function qdrantDashboardReachable(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(1e3, () => {
+      req.destroy();
+      resolve(false);
+    });
+  });
+}
+async function startTypesense(target) {
+  const kirographDir = path.join(target, ".kirograph");
+  const stateFile = path.join(kirographDir, "typesense-server.json");
+  const saved = readJson(stateFile);
+  if (saved && isAlive(saved.pid)) {
+    console.log(`
+  ${import_ui.green}\u2713${import_ui.reset} Typesense already running  ${import_ui.dim}(pid ${saved.pid}, port ${saved.apiPort})${import_ui.reset}`);
+  } else {
+    console.log();
+    const { TypesenseIndex } = await Promise.resolve().then(() => require("../../vectors/typesense-index.js"));
+    const index = new TypesenseIndex(kirographDir);
+    await index.initialize();
+    if (!index.isAvailable()) {
+      console.log(`  Typesense failed to start.
+`);
+      return;
+    }
+    index.close();
+  }
+  const { openTypesenseDashboard } = await Promise.resolve().then(() => require("../installer/dashboard.js"));
+  await openTypesenseDashboard(target);
+  console.log(`  ${import_ui.dim}Press Ctrl+C to close the dashboard (Typesense keeps running \u2014 use ${import_ui.reset}kg dashboard stop${import_ui.dim} to shut it down).${import_ui.reset}
+`);
+  process.on("SIGINT", () => process.exit(0));
+}
+async function startQdrant(target) {
+  const kirographDir = path.join(target, ".kirograph");
+  const stateFile = path.join(kirographDir, "qdrant-server.json");
+  const { ensureQdrantUI, openQdrantDashboard } = await Promise.resolve().then(() => require("../installer/qdrant-dashboard.js"));
+  const uiReady = await ensureQdrantUI(target);
+  if (!uiReady) {
+    console.log(`  Could not download Qdrant Web UI.
+`);
+    return;
+  }
+  const saved = readJson(stateFile);
+  if (saved && isAlive(saved.pid)) {
+    const hasDashboard = await qdrantDashboardReachable(saved.port);
+    if (hasDashboard) {
+      console.log(`
+  ${import_ui.green}\u2713${import_ui.reset} Qdrant already running with dashboard  ${import_ui.dim}(pid ${saved.pid}, port ${saved.port})${import_ui.reset}`);
+      await openQdrantDashboard(target);
+      console.log(`  ${import_ui.dim}Qdrant keeps running in the background \u2014 use ${import_ui.reset}kg dashboard stop${import_ui.dim} to shut it down.${import_ui.reset}
+`);
+      return;
+    }
+    try {
+      process.kill(saved.pid, "SIGTERM");
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 400));
+    try {
+      fs.unlinkSync(stateFile);
+    } catch {
+    }
+  }
+  console.log();
+  const { QdrantIndex } = await Promise.resolve().then(() => require("../../vectors/qdrant-index.js"));
+  const index = new QdrantIndex(kirographDir);
+  await index.initialize();
+  if (!index.isAvailable()) {
+    console.log(`  Qdrant failed to start.
+`);
+    return;
+  }
+  index.close();
+  await openQdrantDashboard(target);
+  console.log(`  ${import_ui.dim}Qdrant keeps running in the background \u2014 use ${import_ui.reset}kg dashboard stop${import_ui.dim} to shut it down.${import_ui.reset}
+`);
+}
+function stopTypesense(target) {
+  const stateFile = path.join(target, ".kirograph", "typesense-server.json");
+  const saved = readJson(stateFile);
+  if (!saved) {
+    console.log(`  ${import_ui.dim}No running Typesense server found.${import_ui.reset}`);
+    return;
+  }
+  killState(stateFile, saved.pid, "Typesense server", String(saved.apiPort));
+}
+function stopQdrant(target) {
+  const stateFile = path.join(target, ".kirograph", "qdrant-server.json");
+  const saved = readJson(stateFile);
+  if (!saved) {
+    console.log(`  ${import_ui.dim}No running Qdrant server found.${import_ui.reset}`);
+    return;
+  }
+  killState(stateFile, saved.pid, "Qdrant server", String(saved.port));
+}
+function register(program) {
+  const cmd = program.command("dashboard [projectPath]").description("Manage the engine dashboard (qdrant, typesense)");
+  cmd.command("start [projectPath]").description("Start the engine server (if not running) and open its dashboard").action(async (projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const config = await (0, import_config.loadConfig)(target);
+    const engine = config.semanticEngine;
+    if (engine === "typesense") return startTypesense(target);
+    if (engine === "qdrant") return startQdrant(target);
+    console.log(`
+  ${import_ui.dim}Dashboard not available for engine "${engine}". Use qdrant or typesense.${import_ui.reset}
+`);
+  });
+  cmd.command("stop [projectPath]").description("Stop the running engine server").action(async (projectPath) => {
+    const target = path.resolve(projectPath ?? process.cwd());
+    const config = await (0, import_config.loadConfig)(target);
+    const engine = config.semanticEngine;
+    console.log();
+    if (engine === "typesense") {
+      stopTypesense(target);
+      console.log();
+      return;
+    }
+    if (engine === "qdrant") {
+      stopQdrant(target);
+      console.log();
+      return;
+    }
+    console.log(`  ${import_ui.dim}No dashboard engine active (current engine: "${engine}").${import_ui.reset}
+`);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=dashboard.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/dashboard.ts"],
+  "sourcesContent": ["import { Command } from 'commander';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport * as http from 'http';\nimport { dim, reset, green, label } from '../ui';\nimport { loadConfig } from '../../config';\n\n// \u2500\u2500 State helpers \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\ninterface TsState { pid: number; apiPort: number; }\ninterface QdState { pid: number; port: number; }\n\nfunction readJson<T>(file: string): T | null {\n  try { return JSON.parse(fs.readFileSync(file, 'utf8')) as T; } catch { return null; }\n}\n\nfunction isAlive(pid: number): boolean {\n  try { process.kill(pid, 0); return true; } catch { return false; }\n}\n\nfunction killState(stateFile: string, pid: number, label_: string, portLabel: string): void {\n  let killed = false;\n  if (isAlive(pid)) {\n    try { process.kill(pid, 'SIGTERM'); killed = true; } catch { /* ignore */ }\n  }\n  try { fs.unlinkSync(stateFile); } catch { /* ignore */ }\n  if (killed) {\n    console.log(`  ${green}\u2713${reset} ${label('Stopped')} ${label_}  ${dim}(pid ${pid}, port ${portLabel})${reset}`);\n  } else {\n    console.log(`  ${dim}${label_} (pid ${pid}) was not running \u2014 state file cleaned up.${reset}`);\n  }\n}\n\n/** Check if the Qdrant /dashboard endpoint returns something other than 404. */\nfunction qdrantDashboardReachable(port: number): Promise<boolean> {\n  return new Promise(resolve => {\n    const req = http.get(`http://127.0.0.1:${port}/dashboard`, res => {\n      resolve(res.statusCode !== 404);\n      res.resume();\n    });\n    req.on('error', () => resolve(false));\n    req.setTimeout(1000, () => { req.destroy(); resolve(false); });\n  });\n}\n\n// \u2500\u2500 Engine-specific start logic \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\nasync function startTypesense(target: string): Promise<void> {\n  const kirographDir = path.join(target, '.kirograph');\n  const stateFile    = path.join(kirographDir, 'typesense-server.json');\n  const saved        = readJson<TsState>(stateFile);\n\n  if (saved && isAlive(saved.pid)) {\n    console.log(`\\n  ${green}\u2713${reset} Typesense already running  ${dim}(pid ${saved.pid}, port ${saved.apiPort})${reset}`);\n  } else {\n    console.log();\n    const { TypesenseIndex } = await Promise.resolve().then(() => require('../../vectors/typesense-index.js'));\n    const index = new TypesenseIndex(kirographDir);\n    await index.initialize();\n    if (!index.isAvailable()) {\n      console.log(`  Typesense failed to start.\\n`); return;\n    }\n    index.close();\n  }\n\n  const { openTypesenseDashboard } = await Promise.resolve().then(() => require('../installer/dashboard.js'));\n  await openTypesenseDashboard(target);\n  console.log(`  ${dim}Press Ctrl+C to close the dashboard (Typesense keeps running \u2014 use ${reset}kg dashboard stop${dim} to shut it down).${reset}\\n`);\n  process.on('SIGINT', () => process.exit(0));\n  // HTTP server keeps Node alive\n}\n\nasync function startQdrant(target: string): Promise<void> {\n  const kirographDir = path.join(target, '.kirograph');\n  const stateFile    = path.join(kirographDir, 'qdrant-server.json');\n\n  const { ensureQdrantUI, openQdrantDashboard } = await Promise.resolve().then(() => require('../installer/qdrant-dashboard.js'));\n\n  const uiReady = await ensureQdrantUI(target);\n  if (!uiReady) { console.log(`  Could not download Qdrant Web UI.\\n`); return; }\n\n  const saved = readJson<QdState>(stateFile);\n  if (saved && isAlive(saved.pid)) {\n    const hasDashboard = await qdrantDashboardReachable(saved.port);\n    if (hasDashboard) {\n      console.log(`\\n  ${green}\u2713${reset} Qdrant already running with dashboard  ${dim}(pid ${saved.pid}, port ${saved.port})${reset}`);\n      await openQdrantDashboard(target);\n      console.log(`  ${dim}Qdrant keeps running in the background \u2014 use ${reset}kg dashboard stop${dim} to shut it down.${reset}\\n`);\n      return;\n    }\n    // Running but without dashboard \u2014 restart\n    try { process.kill(saved.pid, 'SIGTERM'); } catch { /* ignore */ }\n    await new Promise(r => setTimeout(r, 400));\n    try { fs.unlinkSync(stateFile); } catch { /* ignore */ }\n  }\n\n  console.log();\n  const { QdrantIndex } = await Promise.resolve().then(() => require('../../vectors/qdrant-index.js'));\n  const index = new QdrantIndex(kirographDir);\n  await index.initialize();\n  if (!index.isAvailable()) { console.log(`  Qdrant failed to start.\\n`); return; }\n  index.close();\n\n  await openQdrantDashboard(target);\n  console.log(`  ${dim}Qdrant keeps running in the background \u2014 use ${reset}kg dashboard stop${dim} to shut it down.${reset}\\n`);\n}\n\n// \u2500\u2500 Stop logic \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\nfunction stopTypesense(target: string): void {\n  const stateFile = path.join(target, '.kirograph', 'typesense-server.json');\n  const saved     = readJson<TsState>(stateFile);\n  if (!saved) { console.log(`  ${dim}No running Typesense server found.${reset}`); return; }\n  killState(stateFile, saved.pid, 'Typesense server', String(saved.apiPort));\n}\n\nfunction stopQdrant(target: string): void {\n  const stateFile = path.join(target, '.kirograph', 'qdrant-server.json');\n  const saved     = readJson<QdState>(stateFile);\n  if (!saved) { console.log(`  ${dim}No running Qdrant server found.${reset}`); return; }\n  killState(stateFile, saved.pid, 'Qdrant server', String(saved.port));\n}\n\n// \u2500\u2500 Command registration \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\nexport function register(program: Command): void {\n  const cmd = program\n    .command('dashboard [projectPath]')\n    .description('Manage the engine dashboard (qdrant, typesense)');\n\n  cmd.command('start [projectPath]')\n    .description('Start the engine server (if not running) and open its dashboard')\n    .action(async (projectPath: string | undefined) => {\n      const target = path.resolve(projectPath ?? process.cwd());\n      const config = await loadConfig(target);\n      const engine = config.semanticEngine;\n\n      if (engine === 'typesense') return startTypesense(target);\n      if (engine === 'qdrant')    return startQdrant(target);\n\n      console.log(`\\n  ${dim}Dashboard not available for engine \"${engine}\". Use qdrant or typesense.${reset}\\n`);\n    });\n\n  cmd.command('stop [projectPath]')\n    .description('Stop the running engine server')\n    .action(async (projectPath: string | undefined) => {\n      const target = path.resolve(projectPath ?? process.cwd());\n      const config = await loadConfig(target);\n      const engine = config.semanticEngine;\n\n      console.log();\n      if (engine === 'typesense') { stopTypesense(target); console.log(); return; }\n      if (engine === 'qdrant')    { stopQdrant(target);    console.log(); return; }\n\n      console.log(`  ${dim}No dashboard engine active (current engine: \"${engine}\").${reset}\\n`);\n    });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/commands/dead-code.js

@@ -0,0 +1,77 @@
+"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 dead_code_exports = {};
+__export(dead_code_exports, {
+  register: () => register
+});
+module.exports = __toCommonJS(dead_code_exports);
+var path = __toESM(require("path"));
+var import_ui = require("../ui");
+function register(program) {
+  program.command("dead-code [projectPath]").description("Find unexported symbols with no incoming references").option("--limit <n>", "Max results (default: 50)", "50").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) || 50));
+    const dead = cg.findDeadCode(limit);
+    cg.close();
+    if (dead.length === 0) {
+      console.log(`
+  ${import_ui.dim}No dead code detected.${import_ui.reset}
+`);
+      return;
+    }
+    if (opts.format === "json") {
+      console.log(JSON.stringify(dead, null, 2));
+      return;
+    }
+    console.log();
+    console.log(`  ${import_ui.violet}${import_ui.bold}Dead Code${import_ui.reset}  ${import_ui.dim}unexported symbols with no incoming references${import_ui.reset}
+`);
+    const byFile = /* @__PURE__ */ new Map();
+    for (const n of dead) {
+      if (!byFile.has(n.filePath)) byFile.set(n.filePath, []);
+      byFile.get(n.filePath).push(n);
+    }
+    for (const [file, nodes] of byFile) {
+      console.log(`  ${import_ui.dim}${file}${import_ui.reset}`);
+      for (const n of nodes) {
+        console.log(`    ${import_ui.violet}${import_ui.bold}${n.name}${import_ui.reset}  ${import_ui.dim}${n.kind}  line ${n.startLine}${import_ui.reset}`);
+      }
+    }
+    console.log(`
+  ${import_ui.dim}${dead.length} result(s)${import_ui.reset}
+`);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  register
+});
+//# sourceMappingURL=dead-code.js.map

package/dist/bin/commands/dead-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/commands/dead-code.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('dead-code [projectPath]')\n    .description('Find unexported symbols with no incoming references')\n    .option('--limit <n>', 'Max results (default: 50)', '50')\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) || 50));\n      const dead = cg.findDeadCode(limit);\n      cg.close();\n\n      if (dead.length === 0) {\n        console.log(`\\n  ${dim}No dead code detected.${reset}\\n`);\n        return;\n      }\n\n      if (opts.format === 'json') {\n        console.log(JSON.stringify(dead, null, 2));\n        return;\n      }\n\n      console.log();\n      console.log(`  ${violet}${bold}Dead Code${reset}  ${dim}unexported symbols with no incoming references${reset}\\n`);\n\n      // Group by file for readability\n      const byFile = new Map<string, typeof dead>();\n      for (const n of dead) {\n        if (!byFile.has(n.filePath)) byFile.set(n.filePath, []);\n        byFile.get(n.filePath)!.push(n);\n      }\n\n      for (const [file, nodes] of byFile) {\n        console.log(`  ${dim}${file}${reset}`);\n        for (const n of nodes) {\n          console.log(`    ${violet}${bold}${n.name}${reset}  ${dim}${n.kind}  line ${n.startLine}${reset}`);\n        }\n      }\n\n      console.log(`\\n  ${dim}${dead.length} result(s)${reset}\\n`);\n    });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AAEtB,gBAAyC;AAElC,SAAS,SAAS,SAAwB;AAC/C,UACG,QAAQ,yBAAyB,EACjC,YAAY,qDAAqD,EACjE,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,OAAO,GAAG,aAAa,KAAK;AAClC,OAAG,MAAM;AAET,QAAI,KAAK,WAAW,GAAG;AACrB,cAAQ,IAAI;AAAA,IAAO,aAAG,yBAAyB,eAAK;AAAA,CAAI;AACxD;AAAA,IACF;AAEA,QAAI,KAAK,WAAW,QAAQ;AAC1B,cAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AACzC;AAAA,IACF;AAEA,YAAQ,IAAI;AACZ,YAAQ,IAAI,KAAK,gBAAM,GAAG,cAAI,YAAY,eAAK,KAAK,aAAG,iDAAiD,eAAK;AAAA,CAAI;AAGjH,UAAM,SAAS,oBAAI,IAAyB;AAC5C,eAAW,KAAK,MAAM;AACpB,UAAI,CAAC,OAAO,IAAI,EAAE,QAAQ,EAAG,QAAO,IAAI,EAAE,UAAU,CAAC,CAAC;AACtD,aAAO,IAAI,EAAE,QAAQ,EAAG,KAAK,CAAC;AAAA,IAChC;AAEA,eAAW,CAAC,MAAM,KAAK,KAAK,QAAQ;AAClC,cAAQ,IAAI,KAAK,aAAG,GAAG,IAAI,GAAG,eAAK,EAAE;AACrC,iBAAW,KAAK,OAAO;AACrB,gBAAQ,IAAI,OAAO,gBAAM,GAAG,cAAI,GAAG,EAAE,IAAI,GAAG,eAAK,KAAK,aAAG,GAAG,EAAE,IAAI,UAAU,EAAE,SAAS,GAAG,eAAK,EAAE;AAAA,MACnG;AAAA,IACF;AAEA,YAAQ,IAAI;AAAA,IAAO,aAAG,GAAG,KAAK,MAAM,aAAa,eAAK;AAAA,CAAI;AAAA,EAC5D,CAAC;AACL;",
+  "names": []
+}