kirograph 0.12.1

package/dist/bin/installer/config-prompt.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/installer/config-prompt.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 configuration prompting\n */\n\nimport * as readline from 'readline';\nimport { KiroGraphConfig } from '../../config';\ntype CavemanMode = 'lite' | 'full' | 'ultra';\nimport { ask, askBool, arrowSelect, dim, reset, violet } from './prompts';\nexport type ConfigPatch = Pick<KiroGraphConfig, 'enableEmbeddings' | 'useVecIndex' | 'semanticEngine' | 'typesenseDashboard' | 'qdrantDashboard' | 'extractDocstrings' | 'trackCallSites' | 'enableArchitecture' | 'cavemanMode'> & { embeddingModel?: string; embeddingDim?: number };\nexport type SemanticEngine = KiroGraphConfig['semanticEngine'];\n\nexport const DEFAULT_EMBEDDING_MODEL = 'nomic-ai/nomic-embed-text-v1.5';\n\n/** Well-known embedding models with their output dimensions. */\nconst PRESET_MODELS = [\n  {\n    value: 'nomic-ai/nomic-embed-text-v1.5',\n    label: 'nomic-embed-text-v1.5',\n    dim: 768,\n    description: '768-dim \u00B7 ~130MB \u00B7 Best quality for code search  (recommended)',\n  },\n  {\n    value: 'onnx-community/embeddinggemma-300m-ONNX',\n    label: 'embeddinggemma-300m',\n    dim: 768,\n    description: '768-dim \u00B7 ~300MB \u00B7 Google Gemma-based, multilingual, 2048-token context',\n  },\n  {\n    value: 'Xenova/all-MiniLM-L6-v2',\n    label: 'all-MiniLM-L6-v2',\n    dim: 384,\n    description: '384-dim \u00B7 ~23MB  \u00B7 Fast and lightweight, lower accuracy',\n  },\n  {\n    value: 'BAAI/bge-base-en-v1.5',\n    label: 'bge-base-en-v1.5',\n    dim: 768,\n    description: '768-dim \u00B7 ~110MB \u00B7 Strong general-purpose alternative to nomic',\n  },\n  {\n    value: '__other__',\n    label: 'Other',\n    dim: 768,\n    description: 'Enter a custom HuggingFace model ID and embedding dimension',\n  },\n] as const;\n\nexport async function promptConfigOptions(rl: readline.Interface): Promise<ConfigPatch> {\n  const enableEmbeddings = await askBool(\n    rl,\n    'Enable semantic embeddings for similarity search? (requires a local embedding model)',\n    'Enables semantic/similarity-based code search. Increases indexing time; the chosen embedding model is downloaded automatically on first use.',\n  );\n\n  const patch: ConfigPatch = { enableEmbeddings, useVecIndex: false, semanticEngine: 'cosine', typesenseDashboard: false, qdrantDashboard: false, extractDocstrings: true, trackCallSites: true, enableArchitecture: false, cavemanMode: 'off' };\n\n  if (enableEmbeddings) {\n    // \u2500\u2500 Model selection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 modelChoice = await arrowSelect<string>(\n      rl,\n      'Choose an embedding model:',\n      PRESET_MODELS.map(m => ({ value: m.value, label: m.label, description: m.description })),\n    );\n\n    let embeddingModel: string;\n    let embeddingDim: number;\n\n    if (modelChoice === '__other__') {\n      console.log(`\\n  ${dim}Enter a HuggingFace model ID in the format org/model-name.${reset}`);\n      while (true) {\n        const raw = (await ask(rl, `  ${violet}Model identifier:${reset} `)).trim();\n        if (raw.includes('/')) { embeddingModel = raw; break; }\n        console.log(`  Expected a HuggingFace model ID in the format org/model-name (e.g. nomic-ai/nomic-embed-text-v1.5).`);\n      }\n      console.log(`\\n  ${dim}Enter the embedding output dimension for this model (check the model card on HuggingFace).${reset}`);\n      while (true) {\n        const raw = (await ask(rl, `  ${violet}Embedding dimension (e.g. 768, 384):${reset} `)).trim();\n        const n = parseInt(raw, 10);\n        if (!isNaN(n) && n > 0) { embeddingDim = n; break; }\n        console.log(`  Expected a positive integer (e.g. 768, 384, 1536).`);\n      }\n    } else {\n      const preset = PRESET_MODELS.find(m => m.value === modelChoice)!;\n      embeddingModel = preset.value;\n      embeddingDim = preset.dim;\n    }\n\n    patch.embeddingModel = embeddingModel;\n    patch.embeddingDim = embeddingDim;\n\n    // \u2500\u2500 Engine selection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 semanticEngine = await arrowSelect<SemanticEngine>(rl, 'Choose the semantic search engine:', [\n      { value: 'cosine',     label: 'cosine',     description: 'In-process cosine similarity. No extra deps. Best for small/medium projects.' },\n      { value: 'sqlite-vec', label: 'sqlite-vec', description: 'ANN index. Sub-linear search. Best for large codebases. Needs: better-sqlite3, sqlite-vec (native).' },\n      { value: 'orama',      label: 'orama',      description: 'Hybrid search (full-text + vector). Pure JS. Needs: @orama/orama, @orama/plugin-data-persistence.' },\n      { value: 'pglite',     label: 'pglite',     description: 'Hybrid search via PostgreSQL + pgvector. Exact results. Pure WASM. Needs: @electric-sql/pglite.' },\n      { value: 'lancedb',    label: 'lancedb',    description: 'ANN search via LanceDB (Apache Lance columnar format). Pure JS. Needs: @lancedb/lancedb.' },\n      { value: 'qdrant',     label: 'qdrant',     description: 'ANN search via Qdrant embedded binary (HNSW index, Cosine). Needs: qdrant-local.' },\n      { value: 'typesense',  label: 'typesense',  description: 'ANN search via Typesense (auto-downloaded binary, HNSW, Cosine). Needs: typesense.' },\n    ]);\n    patch.semanticEngine = semanticEngine;\n    patch.useVecIndex = semanticEngine === 'sqlite-vec';\n\n    if (semanticEngine === 'typesense') {\n      patch.typesenseDashboard = await askBool(\n        rl,\n        'Open Typesense dashboard after indexing?',\n        'Serves the Typesense Dashboard locally and opens it in your browser after indexing completes.',\n      );\n    }\n\n    if (semanticEngine === 'qdrant') {\n      patch.qdrantDashboard = await askBool(\n        rl,\n        'Open Qdrant dashboard after indexing?',\n        'Downloads the Qdrant Web UI (first time only) and opens it in your browser after indexing completes.',\n      );\n    }\n  }\n\n  patch.extractDocstrings = await askBool(\n    rl,\n    'Extract docstrings from source files?',\n    'Enriches symbol metadata and improves context quality. Slightly increases indexing time.',\n  );\n\n  patch.trackCallSites = await askBool(\n    rl,\n    'Track call sites to enable caller/callee graph traversal?',\n    'Enables the kirograph_callers and kirograph_callees MCP tools for graph traversal. Increases index size.',\n  );\n\n  patch.enableArchitecture = await askBool(\n    rl,\n    'Enable architecture analysis (package graph + layer detection)?',\n    'Detects packages from manifests (package.json, go.mod, Cargo.toml, etc.) and architectural layers (api, service, data, ui, shared) from file structure. Enables kirograph_architecture, kirograph_coupling, and kirograph_package MCP tools.',\n  );\n\n  const cavemanChoice = await arrowSelect(rl, 'Caveman mode \u2014 agent communication style:', [\n    { value: 'off',   label: 'off',   description: 'Normal responses' },\n    { value: 'lite',  label: 'lite',  description: 'Compact, no filler, full sentences' },\n    { value: 'full',  label: 'full',  description: 'Fragments, no articles, short synonyms' },\n    { value: 'ultra', label: 'ultra', description: 'Max compression, abbreviations, \u2192 for causality' },\n  ]);\n  patch.cavemanMode = cavemanChoice as CavemanMode | 'off';\n\n  return patch;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+import * as http from 'http';
+export declare function openTypesenseDashboard(projectRoot: string): Promise<http.Server | null>;
+//# sourceMappingURL=dashboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/dashboard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAuK7B,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAwC7F"}

package/dist/bin/installer/dashboard.js

@@ -0,0 +1,149 @@
+"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, {
+  openTypesenseDashboard: () => openTypesenseDashboard
+});
+module.exports = __toCommonJS(dashboard_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var http = __toESM(require("http"));
+var import_child_process = require("child_process");
+var import_ui = require("../ui");
+var import_archive = require("./archive");
+const SERVER_STATE_FILE = "typesense-server.json";
+const DASHBOARD_TARBALL = "https://github.com/bfritscher/typesense-dashboard/archive/refs/heads/gh-pages.tar.gz";
+const STRIP_TAR_PREFIX = "typesense-dashboard-gh-pages/";
+const STRIP_URL_PREFIX = "/typesense-dashboard";
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  try {
+    (0, import_child_process.spawn)(cmd, [url], { stdio: "ignore", detached: true, shell: process.platform === "win32" }).unref();
+  } catch {
+  }
+}
+function downloadDashboard(cacheDir) {
+  return (0, import_archive.extractTarGzFromUrl)(DASHBOARD_TARBALL, cacheDir, {
+    stripPrefix: STRIP_TAR_PREFIX
+  }).then(() => {
+  });
+}
+const MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "application/javascript",
+  ".mjs": "application/javascript",
+  ".css": "text/css",
+  ".json": "application/json",
+  ".png": "image/png",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".map": "application/json"
+};
+function serveDashboard(cacheDir, port) {
+  return http.createServer((req, res) => {
+    let urlPath = (req.url ?? "/").split("?")[0];
+    if (urlPath.startsWith(STRIP_URL_PREFIX)) {
+      urlPath = urlPath.slice(STRIP_URL_PREFIX.length) || "/";
+    }
+    if (urlPath === "" || urlPath === "/") urlPath = "/index.html";
+    const filePath = path.join(cacheDir, urlPath);
+    if (!filePath.startsWith(cacheDir)) {
+      res.writeHead(403);
+      res.end();
+      return;
+    }
+    let target = filePath;
+    if (!fs.existsSync(target) || fs.statSync(target).isDirectory()) {
+      target = path.join(cacheDir, "index.html");
+    }
+    if (!fs.existsSync(target)) {
+      res.writeHead(404);
+      res.end("Not found");
+      return;
+    }
+    const ext = path.extname(target).toLowerCase();
+    const mime = MIME[ext] ?? "application/octet-stream";
+    res.writeHead(200, { "Content-Type": mime });
+    fs.createReadStream(target).pipe(res);
+  }).listen(port, "127.0.0.1");
+}
+function getFreePort() {
+  return new Promise((resolve, reject) => {
+    const srv = http.createServer().listen(0, "127.0.0.1", () => {
+      const port = srv.address().port;
+      srv.close(() => resolve(port));
+    }).on("error", reject);
+  });
+}
+async function openTypesenseDashboard(projectRoot) {
+  const kirographDir = path.join(projectRoot, ".kirograph");
+  const cacheDir = path.join(kirographDir, "typesense", "dashboard");
+  const stateFile = path.join(kirographDir, SERVER_STATE_FILE);
+  let apiPort = null;
+  try {
+    const state = JSON.parse(fs.readFileSync(stateFile, "utf8"));
+    apiPort = state.apiPort;
+  } catch {
+  }
+  const indexHtml = path.join(cacheDir, "index.html");
+  if (!fs.existsSync(indexHtml)) {
+    process.stdout.write(`  Downloading Typesense Dashboard (first time only)\u2026
+`);
+    try {
+      await downloadDashboard(cacheDir);
+      process.stdout.write(`  Dashboard ready.
+`);
+    } catch (err) {
+      process.stdout.write(`  Dashboard download failed: ${String(err)}
+`);
+      return null;
+    }
+  }
+  const dashboardPort = await getFreePort();
+  const server = serveDashboard(cacheDir, dashboardPort);
+  const url = `http://127.0.0.1:${dashboardPort}`;
+  console.log(`
+  ${import_ui.violet}${import_ui.bold}Typesense Dashboard${import_ui.reset}  ${import_ui.dim}(local)${import_ui.reset}`);
+  console.log(`  ${import_ui.green}\u2713${import_ui.reset} Serving at ${import_ui.violet}${url}${import_ui.reset}`);
+  console.log();
+  console.log(`  Connect with:`);
+  console.log(`  ${import_ui.dim}Node URL${import_ui.reset}  ${import_ui.violet}http://127.0.0.1:${apiPort ?? "???"}${import_ui.reset}`);
+  console.log(`  ${import_ui.dim}API Key ${import_ui.reset}  ${import_ui.violet}kirograph-local${import_ui.reset}`);
+  console.log();
+  openBrowser(url);
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  openTypesenseDashboard
+});
+//# sourceMappingURL=dashboard.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/installer/dashboard.ts"],
+  "sourcesContent": ["import * as path from 'path';\nimport * as fs from 'fs';\nimport * as http from 'http';\nimport { spawn } from 'child_process';\nimport { dim, reset, violet, bold, green } from '../ui';\nimport { extractTarGzFromUrl } from './archive';\n\n// \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nconst SERVER_STATE_FILE  = 'typesense-server.json';\nconst DASHBOARD_TARBALL  = 'https://github.com/bfritscher/typesense-dashboard/archive/refs/heads/gh-pages.tar.gz';\nconst STRIP_TAR_PREFIX   = 'typesense-dashboard-gh-pages/'; // prefix inside the tarball\nconst STRIP_URL_PREFIX   = '/typesense-dashboard';          // base path baked into the built app\n\ninterface ServerState { pid: number; apiPort: number; }\n\n// \u2500\u2500 Browser open \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 openBrowser(url: string): void {\n  const cmd = process.platform === 'darwin' ? 'open'\n            : process.platform === 'win32'  ? 'start'\n            : 'xdg-open';\n  try {\n    spawn(cmd, [url], { stdio: 'ignore', detached: true, shell: process.platform === 'win32' }).unref();\n  } catch { /* best-effort */ }\n}\n\n// \u2500\u2500 Dashboard download \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 downloadDashboard(cacheDir: string): Promise<void> {\n  return extractTarGzFromUrl(DASHBOARD_TARBALL, cacheDir, {\n    stripPrefix: STRIP_TAR_PREFIX,\n  }).then(() => {});\n}\n\n// \u2500\u2500 Local HTTP server \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nconst MIME: Record<string, string> = {\n  '.html':  'text/html; charset=utf-8',\n  '.js':    'application/javascript',\n  '.mjs':   'application/javascript',\n  '.css':   'text/css',\n  '.json':  'application/json',\n  '.png':   'image/png',\n  '.svg':   'image/svg+xml',\n  '.ico':   'image/x-icon',\n  '.woff':  'font/woff',\n  '.woff2': 'font/woff2',\n  '.ttf':   'font/ttf',\n  '.map':   'application/json',\n};\n\nfunction serveDashboard(cacheDir: string, port: number): http.Server {\n  return http.createServer((req, res) => {\n    let urlPath = (req.url ?? '/').split('?')[0]!;\n\n    // Strip the GitHub Pages base path baked into the built app\n    if (urlPath.startsWith(STRIP_URL_PREFIX)) {\n      urlPath = urlPath.slice(STRIP_URL_PREFIX.length) || '/';\n    }\n    if (urlPath === '' || urlPath === '/') urlPath = '/index.html';\n\n    const filePath = path.join(cacheDir, urlPath);\n\n    // Prevent path traversal\n    if (!filePath.startsWith(cacheDir)) {\n      res.writeHead(403); res.end(); return;\n    }\n\n    let target = filePath;\n    if (!fs.existsSync(target) || fs.statSync(target).isDirectory()) {\n      // SPA fallback\n      target = path.join(cacheDir, 'index.html');\n    }\n\n    if (!fs.existsSync(target)) {\n      res.writeHead(404); res.end('Not found'); return;\n    }\n\n    const ext  = path.extname(target).toLowerCase();\n    const mime = MIME[ext] ?? 'application/octet-stream';\n\n    res.writeHead(200, { 'Content-Type': mime });\n    fs.createReadStream(target).pipe(res);\n  }).listen(port, '127.0.0.1');\n}\n\nfunction getFreePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const srv = http.createServer().listen(0, '127.0.0.1', () => {\n      const port = (srv.address() as { port: number }).port;\n      srv.close(() => resolve(port));\n    }).on('error', reject);\n  });\n}\n\n// \u2500\u2500 Public API \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 async function openTypesenseDashboard(projectRoot: string): Promise<http.Server | null> {\n  const kirographDir = path.join(projectRoot, '.kirograph');\n  const cacheDir     = path.join(kirographDir, 'typesense', 'dashboard');\n\n  // Read Typesense server connection details\n  const stateFile = path.join(kirographDir, SERVER_STATE_FILE);\n  let apiPort: number | null = null;\n  try {\n    const state = JSON.parse(fs.readFileSync(stateFile, 'utf8')) as ServerState;\n    apiPort = state.apiPort;\n  } catch { /* server not started or state missing */ }\n\n  // Download dashboard if not cached\n  const indexHtml = path.join(cacheDir, 'index.html');\n  if (!fs.existsSync(indexHtml)) {\n    process.stdout.write(`  Downloading Typesense Dashboard (first time only)\u2026\\n`);\n    try {\n      await downloadDashboard(cacheDir);\n      process.stdout.write(`  Dashboard ready.\\n`);\n    } catch (err) {\n      process.stdout.write(`  Dashboard download failed: ${String(err)}\\n`);\n      return null;\n    }\n  }\n\n  const dashboardPort = await getFreePort();\n  const server = serveDashboard(cacheDir, dashboardPort);\n\n  const url = `http://127.0.0.1:${dashboardPort}`;\n\n  console.log(`\\n  ${violet}${bold}Typesense Dashboard${reset}  ${dim}(local)${reset}`);\n  console.log(`  ${green}\u2713${reset} Serving at ${violet}${url}${reset}`);\n  console.log();\n  console.log(`  Connect with:`);\n  console.log(`  ${dim}Node URL${reset}  ${violet}http://127.0.0.1:${apiPort ?? '???'}${reset}`);\n  console.log(`  ${dim}API Key ${reset}  ${violet}kirograph-local${reset}`);\n  console.log();\n\n  openBrowser(url);\n  return server;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/installer/hooks.d.ts

@@ -0,0 +1,5 @@
+/**
+ * KiroGraph Installer — Kiro hook file management
+ */
+export declare function writeHooks(kiroDir: string): void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/bin/installer/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyGH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAgBhD"}

package/dist/bin/installer/hooks.js

@@ -0,0 +1,155 @@
+"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 hooks_exports = {};
+__export(hooks_exports, {
+  writeHooks: () => writeHooks
+});
+module.exports = __toCommonJS(hooks_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_errors = require("../../errors");
+const FILE_PATTERNS = [
+  "**/*.ts",
+  "**/*.tsx",
+  "**/*.js",
+  "**/*.jsx",
+  "**/*.py",
+  "**/*.go",
+  "**/*.rs",
+  "**/*.java",
+  "**/*.cs",
+  "**/*.rb",
+  "**/*.php",
+  "**/*.swift",
+  "**/*.kt",
+  "**/*.dart",
+  "**/*.ex",
+  "**/*.exs"
+];
+const HOOKS = [
+  {
+    filename: "kirograph-mark-dirty-on-save.json",
+    hook: {
+      name: "KiroGraph Mark Dirty on Save",
+      version: "1.0.0",
+      description: "Mark the KiroGraph index as dirty when source files are saved. Sync is deferred to agent idle.",
+      when: { type: "fileEdited", patterns: FILE_PATTERNS },
+      then: { type: "runCommand", command: "kirograph mark-dirty 2>/dev/null || true" }
+    }
+  },
+  {
+    filename: "kirograph-mark-dirty-on-create.json",
+    hook: {
+      name: "KiroGraph Mark Dirty on Create",
+      version: "1.0.0",
+      description: "Mark the KiroGraph index as dirty when source files are created.",
+      when: { type: "fileCreated", patterns: FILE_PATTERNS },
+      then: { type: "runCommand", command: "kirograph mark-dirty 2>/dev/null || true" }
+    }
+  },
+  {
+    filename: "kirograph-sync-on-delete.json",
+    hook: {
+      name: "KiroGraph Sync on Delete",
+      version: "1.0.0",
+      description: "Remove deleted files from the KiroGraph index immediately.",
+      when: { type: "fileDeleted", patterns: FILE_PATTERNS },
+      then: { type: "runCommand", command: "kirograph sync-if-dirty 2>/dev/null || true" }
+    }
+  },
+  {
+    filename: "kirograph-sync-if-dirty.json",
+    hook: {
+      name: "KiroGraph Deferred Sync",
+      version: "1.0.0",
+      description: "Sync the KiroGraph index when the agent is idle and a dirty marker is present. Batches multiple rapid saves into one sync.",
+      when: { type: "agentStop" },
+      then: { type: "runCommand", command: "kirograph sync-if-dirty --quiet 2>/dev/null || true" }
+    }
+  }
+];
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+function writeJson(p, data) {
+  fs.writeFileSync(p, JSON.stringify(data, null, 2) + "\n");
+}
+function migrateOnIdleHooks(hooksDir) {
+  if (!fs.existsSync(hooksDir)) return;
+  let files;
+  try {
+    files = fs.readdirSync(hooksDir).filter((f) => f.endsWith(".json"));
+  } catch {
+    return;
+  }
+  for (const file of files) {
+    const filePath = path.join(hooksDir, file);
+    let raw;
+    try {
+      raw = fs.readFileSync(filePath, "utf8");
+    } catch {
+      (0, import_errors.logWarn)(`KiroGraph installer: could not read hook file ${filePath}`);
+      continue;
+    }
+    let obj;
+    try {
+      obj = JSON.parse(raw);
+    } catch {
+      (0, import_errors.logWarn)(`KiroGraph installer: could not parse hook file ${filePath}`);
+      continue;
+    }
+    if (obj?.when?.type === "onIdle") {
+      obj.when.type = "agentStop";
+      try {
+        fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + "\n");
+      } catch {
+        (0, import_errors.logWarn)(`KiroGraph installer: could not write migrated hook file ${filePath}`);
+      }
+    }
+  }
+}
+function writeHooks(kiroDir) {
+  const hooksDir = path.join(kiroDir, "hooks");
+  ensureDir(hooksDir);
+  migrateOnIdleHooks(hooksDir);
+  const oldHooks = ["kirograph-sync-on-save.json", "kirograph-sync-on-create.json"];
+  for (const old of oldHooks) {
+    const p = path.join(hooksDir, old);
+    if (fs.existsSync(p)) fs.unlinkSync(p);
+  }
+  for (const { filename, hook } of HOOKS) {
+    writeJson(path.join(hooksDir, filename), hook);
+  }
+  console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  writeHooks
+});
+//# sourceMappingURL=hooks.js.map

package/dist/bin/installer/hooks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/bin/installer/hooks.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Installer \u2014 Kiro hook file management\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { logWarn } from '../../errors';\n\n// \u2500\u2500 Constants \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nconst FILE_PATTERNS = [\n  '**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx',\n  '**/*.py', '**/*.go', '**/*.rs', '**/*.java',\n  '**/*.cs', '**/*.rb', '**/*.php', '**/*.swift',\n  '**/*.kt', '**/*.dart',\n  '**/*.ex', '**/*.exs',\n];\n\nconst HOOKS: Array<{ filename: string; hook: object }> = [\n  {\n    filename: 'kirograph-mark-dirty-on-save.json',\n    hook: {\n      name: 'KiroGraph Mark Dirty on Save',\n      version: '1.0.0',\n      description: 'Mark the KiroGraph index as dirty when source files are saved. Sync is deferred to agent idle.',\n      when: { type: 'fileEdited', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph mark-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-mark-dirty-on-create.json',\n    hook: {\n      name: 'KiroGraph Mark Dirty on Create',\n      version: '1.0.0',\n      description: 'Mark the KiroGraph index as dirty when source files are created.',\n      when: { type: 'fileCreated', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph mark-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-sync-on-delete.json',\n    hook: {\n      name: 'KiroGraph Sync on Delete',\n      version: '1.0.0',\n      description: 'Remove deleted files from the KiroGraph index immediately.',\n      when: { type: 'fileDeleted', patterns: FILE_PATTERNS },\n      then: { type: 'runCommand', command: 'kirograph sync-if-dirty 2>/dev/null || true' },\n    },\n  },\n  {\n    filename: 'kirograph-sync-if-dirty.json',\n    hook: {\n      name: 'KiroGraph Deferred Sync',\n      version: '1.0.0',\n      description: 'Sync the KiroGraph index when the agent is idle and a dirty marker is present. Batches multiple rapid saves into one sync.',\n      when: { type: 'agentStop' },\n      then: { type: 'runCommand', command: 'kirograph sync-if-dirty --quiet 2>/dev/null || true' },\n    },\n  },\n];\n\n// \u2500\u2500 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\u2500\u2500\u2500\u2500\u2500\n\nfunction ensureDir(p: string): void {\n  fs.mkdirSync(p, { recursive: true });\n}\n\nfunction writeJson(p: string, data: unknown): void {\n  fs.writeFileSync(p, JSON.stringify(data, null, 2) + '\\n');\n}\n\nfunction migrateOnIdleHooks(hooksDir: string): void {\n  if (!fs.existsSync(hooksDir)) return;\n  let files: string[];\n  try {\n    files = fs.readdirSync(hooksDir).filter(f => f.endsWith('.json'));\n  } catch {\n    return;\n  }\n  for (const file of files) {\n    const filePath = path.join(hooksDir, file);\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      logWarn(`KiroGraph installer: could not read hook file ${filePath}`);\n      continue;\n    }\n    let obj: any;\n    try {\n      obj = JSON.parse(raw);\n    } catch {\n      logWarn(`KiroGraph installer: could not parse hook file ${filePath}`);\n      continue;\n    }\n    if (obj?.when?.type === 'onIdle') {\n      obj.when.type = 'agentStop';\n      try {\n        fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\\n');\n      } catch {\n        logWarn(`KiroGraph installer: could not write migrated hook file ${filePath}`);\n      }\n    }\n  }\n}\n\n// \u2500\u2500 Public \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 writeHooks(kiroDir: string): void {\n  const hooksDir = path.join(kiroDir, 'hooks');\n  ensureDir(hooksDir);\n\n  migrateOnIdleHooks(hooksDir);\n\n  const oldHooks = ['kirograph-sync-on-save.json', 'kirograph-sync-on-create.json'];\n  for (const old of oldHooks) {\n    const p = path.join(hooksDir, old);\n    if (fs.existsSync(p)) fs.unlinkSync(p);\n  }\n\n  for (const { filename, hook } of HOOKS) {\n    writeJson(path.join(hooksDir, filename), hook);\n  }\n\n  console.log(`  \u2713 Auto-sync hooks written to ${hooksDir}`);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,SAAoB;AACpB,WAAsB;AACtB,oBAAwB;AAIxB,MAAM,gBAAgB;AAAA,EACpB;AAAA,EAAW;AAAA,EAAY;AAAA,EAAW;AAAA,EAClC;AAAA,EAAW;AAAA,EAAW;AAAA,EAAW;AAAA,EACjC;AAAA,EAAW;AAAA,EAAW;AAAA,EAAY;AAAA,EAClC;AAAA,EAAW;AAAA,EACX;AAAA,EAAW;AACb;AAEA,MAAM,QAAmD;AAAA,EACvD;AAAA,IACE,UAAU;AAAA,IACV,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,cAAc,UAAU,cAAc;AAAA,MACpD,MAAM,EAAE,MAAM,cAAc,SAAS,2CAA2C;AAAA,IAClF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,eAAe,UAAU,cAAc;AAAA,MACrD,MAAM,EAAE,MAAM,cAAc,SAAS,2CAA2C;AAAA,IAClF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,eAAe,UAAU,cAAc;AAAA,MACrD,MAAM,EAAE,MAAM,cAAc,SAAS,8CAA8C;AAAA,IACrF;AAAA,EACF;AAAA,EACA;AAAA,IACE,UAAU;AAAA,IACV,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,SAAS;AAAA,MACT,aAAa;AAAA,MACb,MAAM,EAAE,MAAM,YAAY;AAAA,MAC1B,MAAM,EAAE,MAAM,cAAc,SAAS,sDAAsD;AAAA,IAC7F;AAAA,EACF;AACF;AAIA,SAAS,UAAU,GAAiB;AAClC,KAAG,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACrC;AAEA,SAAS,UAAU,GAAW,MAAqB;AACjD,KAAG,cAAc,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,IAAI;AAC1D;AAEA,SAAS,mBAAmB,UAAwB;AAClD,MAAI,CAAC,GAAG,WAAW,QAAQ,EAAG;AAC9B,MAAI;AACJ,MAAI;AACF,YAAQ,GAAG,YAAY,QAAQ,EAAE,OAAO,OAAK,EAAE,SAAS,OAAO,CAAC;AAAA,EAClE,QAAQ;AACN;AAAA,EACF;AACA,aAAW,QAAQ,OAAO;AACxB,UAAM,WAAW,KAAK,KAAK,UAAU,IAAI;AACzC,QAAI;AACJ,QAAI;AACF,YAAM,GAAG,aAAa,UAAU,MAAM;AAAA,IACxC,QAAQ;AACN,iCAAQ,iDAAiD,QAAQ,EAAE;AACnE;AAAA,IACF;AACA,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,MAAM,GAAG;AAAA,IACtB,QAAQ;AACN,iCAAQ,kDAAkD,QAAQ,EAAE;AACpE;AAAA,IACF;AACA,QAAI,KAAK,MAAM,SAAS,UAAU;AAChC,UAAI,KAAK,OAAO;AAChB,UAAI;AACF,WAAG,cAAc,UAAU,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI;AAAA,MAChE,QAAQ;AACN,mCAAQ,2DAA2D,QAAQ,EAAE;AAAA,MAC/E;AAAA,IACF;AAAA,EACF;AACF;AAIO,SAAS,WAAW,SAAuB;AAChD,QAAM,WAAW,KAAK,KAAK,SAAS,OAAO;AAC3C,YAAU,QAAQ;AAElB,qBAAmB,QAAQ;AAE3B,QAAM,WAAW,CAAC,+BAA+B,+BAA+B;AAChF,aAAW,OAAO,UAAU;AAC1B,UAAM,IAAI,KAAK,KAAK,UAAU,GAAG;AACjC,QAAI,GAAG,WAAW,CAAC,EAAG,IAAG,WAAW,CAAC;AAAA,EACvC;AAEA,aAAW,EAAE,UAAU,KAAK,KAAK,OAAO;AACtC,cAAU,KAAK,KAAK,UAAU,QAAQ,GAAG,IAAI;AAAA,EAC/C;AAEA,UAAQ,IAAI,uCAAkC,QAAQ,EAAE;AAC1D;",
+  "names": []
+}

package/dist/bin/installer/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * KiroGraph Installer for Kiro
+ *
+ * Wires up:
+ *  1. .kiro/settings/mcp.json        — registers the MCP server (IDE + CLI)
+ *  2. .kiro/hooks/*.json             — auto-sync hooks for Kiro IDE
+ *  3. .kiro/steering/kirograph.md    — teaches Kiro to use the graph tools (IDE + CLI)
+ *  4. .kiro/agents/kirograph.json    — custom agent config for Kiro CLI
+ */
+export declare function runInstaller(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/bin/installer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bin/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqJlD"}

package/dist/bin/installer/index.js

@@ -0,0 +1,228 @@
+"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 installer_exports = {};
+__export(installer_exports, {
+  runInstaller: () => runInstaller
+});
+module.exports = __toCommonJS(installer_exports);
+var path = __toESM(require("path"));
+var readline = __toESM(require("readline"));
+var import_child_process = require("child_process");
+var import_config = require("../../config");
+var import_banner = require("../banner");
+var import_progress = require("../progress");
+var import_ui = require("../ui");
+var import_prompts = require("./prompts");
+var import_config_prompt = require("./config-prompt");
+var import_mcp = require("./mcp");
+var import_hooks = require("./hooks");
+var import_steering = require("./steering");
+var import_cli_agent = require("./cli-agent");
+var import_dashboard = require("./dashboard");
+var import_qdrant_dashboard = require("./qdrant-dashboard");
+async function runInstaller() {
+  (0, import_banner.printBanner)();
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const cwd = process.cwd();
+    const kiroDir = path.join(cwd, ".kiro");
+    console.log(`  Workspace: ${cwd}
+`);
+    const proceed = await (0, import_prompts.ask)(rl, "  Install KiroGraph for this Kiro workspace? (Y/n) ");
+    if (proceed.toLowerCase() === "n") {
+      console.log("  Cancelled.");
+      rl.close();
+      return;
+    }
+    console.log();
+    (0, import_mcp.writeMcpConfig)(kiroDir);
+    (0, import_hooks.writeHooks)(kiroDir);
+    const patch = await (0, import_config_prompt.promptConfigOptions)(rl);
+    try {
+      await (0, import_config.updateConfig)(cwd, patch);
+      console.log(`
+  Configuration saved to ${cwd}/.kirograph/config.json`);
+      console.log(`  \u2022 enableEmbeddings: ${patch.enableEmbeddings}`);
+      if ("embeddingModel" in patch) {
+        console.log(`  \u2022 embeddingModel: ${patch.embeddingModel}  ${import_ui.dim}(${patch.embeddingDim}-dim)${import_ui.reset}`);
+      }
+      if (patch.enableEmbeddings) {
+        console.log(`  \u2022 semanticEngine: ${patch.semanticEngine}`);
+        if (patch.semanticEngine === "sqlite-vec") {
+          console.log(`
+  Installing sqlite-vec dependencies...`);
+          const result = (0, import_child_process.spawnSync)("npm", ["install", "better-sqlite3", "sqlite-vec"], { stdio: "inherit", shell: true });
+          if (result.status === 0) {
+            console.log(`  \u2713 better-sqlite3 and sqlite-vec installed`);
+          } else {
+            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+            console.warn(`    npm install better-sqlite3 sqlite-vec`);
+          }
+        } else if (patch.semanticEngine === "orama") {
+          console.log(`
+  Installing Orama dependencies...`);
+          const result = (0, import_child_process.spawnSync)("npm", ["install", "@orama/orama", "@orama/plugin-data-persistence"], { stdio: "inherit", shell: true });
+          if (result.status === 0) {
+            console.log(`  \u2713 @orama/orama and @orama/plugin-data-persistence installed`);
+          } else {
+            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+            console.warn(`    npm install @orama/orama @orama/plugin-data-persistence`);
+          }
+        } else if (patch.semanticEngine === "pglite") {
+          console.log(`
+  Installing PGlite dependencies...`);
+          const result = (0, import_child_process.spawnSync)("npm", ["install", "@electric-sql/pglite"], { stdio: "inherit", shell: true });
+          if (result.status === 0) {
+            console.log(`  \u2713 @electric-sql/pglite installed`);
+          } else {
+            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+            console.warn(`    npm install @electric-sql/pglite`);
+          }
+        } else if (patch.semanticEngine === "lancedb") {
+          console.log(`
+  Installing LanceDB dependencies...`);
+          const result = (0, import_child_process.spawnSync)("npm", ["install", "@lancedb/lancedb"], { stdio: "inherit", shell: true });
+          if (result.status === 0) {
+            console.log(`  \u2713 @lancedb/lancedb installed`);
+          } else {
+            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+            console.warn(`    npm install @lancedb/lancedb`);
+          }
+        } else if (patch.semanticEngine === "qdrant") {
+          console.log(`
+  Installing Qdrant dependencies...`);
+          const result = (0, import_child_process.spawnSync)("npm", ["install", "qdrant-local"], { stdio: "inherit", shell: true });
+          if (result.status === 0) {
+            console.log(`  \u2713 qdrant-local installed`);
+          } else {
+            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+            console.warn(`    npm install qdrant-local`);
+          }
+        } else if (patch.semanticEngine === "typesense") {
+          console.log(`
+  Installing Typesense dependencies...`);
+          const result = (0, import_child_process.spawnSync)("npm", ["install", "typesense"], { stdio: "inherit", shell: true });
+          if (result.status === 0) {
+            console.log(`  \u2713 typesense installed`);
+            console.log(`  \u2139  The Typesense binary (~37MB) will be auto-downloaded on first index run.`);
+          } else {
+            console.warn(`  \u2717 npm install failed (exit ${result.status}). Run manually:`);
+            console.warn(`    npm install typesense`);
+          }
+        }
+      }
+      console.log(`  \u2022 extractDocstrings: ${patch.extractDocstrings}`);
+      console.log(`  \u2022 trackCallSites: ${patch.trackCallSites}`);
+      console.log(`  \u2022 enableArchitecture: ${patch.enableArchitecture}`);
+      console.log(`  \u2022 cavemanMode: ${patch.cavemanMode ?? "off"}`);
+      (0, import_steering.writeSteering)(kiroDir, patch.cavemanMode ?? "off");
+      (0, import_cli_agent.writeCliAgent)(kiroDir);
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      console.error(`
+  \u2717 Failed to write configuration: ${reason}`);
+      process.exit(1);
+    }
+    if (patch.qdrantDashboard) {
+      await (0, import_qdrant_dashboard.ensureQdrantUI)(cwd);
+    }
+    const doIndex = await (0, import_prompts.ask)(rl, "\n  Initialize and index this project now? (Y/n) ");
+    if (doIndex.toLowerCase() !== "n") {
+      const KiroGraph = (await Promise.resolve().then(() => require("../../index.js"))).default;
+      const fileBytes = /* @__PURE__ */ new Map();
+      const modelProgress = (file, loaded, total, done) => {
+        const entry = fileBytes.get(file) ?? { loaded: 0, total: 0 };
+        if (total > 0) entry.total = total;
+        entry.loaded = done ? entry.total : loaded;
+        fileBytes.set(file, entry);
+        const knownFiles = Array.from(fileBytes.values()).filter((f) => f.total > 0);
+        const totalLoaded = knownFiles.reduce((s, f) => s + f.loaded, 0);
+        const totalBytes = knownFiles.reduce((s, f) => s + f.total, 0);
+        const pct = totalBytes > 0 ? Math.min(totalLoaded / totalBytes * 100, 100) : 0;
+        const filled = Math.round(pct / 5);
+        const bar = "\u2588".repeat(filled) + "\u2591".repeat(20 - filled);
+        const mb = (totalLoaded / 1024 / 1024).toFixed(1);
+        const totalMb = (totalBytes / 1024 / 1024).toFixed(1);
+        process.stdout.write(`\r  [${bar}] ${pct.toFixed(0).padStart(3)}%  ${mb} / ${totalMb} MB   `);
+      };
+      const originalStderrWrite = process.stderr.write.bind(process.stderr);
+      const stderrFilter = (chunk, ...args) => {
+        const str = typeof chunk === "string" ? chunk : String(chunk);
+        if (str.includes("content-length") || str.includes("dtype not specified")) return true;
+        return originalStderrWrite(chunk, ...args);
+      };
+      process.stderr.write = stderrFilter;
+      let cg;
+      try {
+        if (!KiroGraph.isInitialized(cwd)) {
+          process.stdout.write("  Downloading embedding model\u2026\n");
+          cg = await KiroGraph.init(cwd, void 0, modelProgress);
+          process.stdout.write("\n");
+          console.log("  \u2713 Created .kirograph/");
+        } else {
+          cg = await KiroGraph.open(cwd, modelProgress);
+          if (fileBytes.size > 0) process.stdout.write("\n");
+        }
+      } finally {
+        process.stderr.write = originalStderrWrite;
+      }
+      console.log("  Indexing...");
+      const result = await cg.indexAll({ onProgress: import_progress.renderIndexProgress });
+      process.stdout.write("\n");
+      console.log(`  \u2713 Indexed ${result.filesIndexed} files, ${result.nodesCreated} symbols, ${result.edgesCreated} edges`);
+      cg.close();
+      if (patch.typesenseDashboard) {
+        const dashboardServer = await (0, import_dashboard.openTypesenseDashboard)(cwd);
+        console.log(`  ${import_ui.dim}Press Ctrl+C to stop the dashboard server when done.${import_ui.reset}`);
+        await new Promise((resolve) => {
+          process.on("SIGINT", () => {
+            if (dashboardServer) {
+              dashboardServer.close(() => resolve());
+            } else {
+              resolve();
+            }
+          });
+        });
+        return;
+      }
+      if (patch.qdrantDashboard) {
+        await (0, import_qdrant_dashboard.openQdrantDashboard)(cwd);
+      }
+    }
+    console.log("\n  Done! Restart Kiro IDE for the MCP server to load.");
+    console.log('  For Kiro CLI, use the "kirograph" agent: kiro-cli --agent kirograph\n');
+  } finally {
+    rl.close();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runInstaller
+});
+//# sourceMappingURL=index.js.map