kirograph 0.12.1

package/dist/bin/progress.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bin/progress.ts"],
+  "sourcesContent": ["/**\n * KiroGraph CLI Progress Renderer\n *\n * Renders indexAll/sync progress events to stdout.\n * Lives in src/bin/ because it is a display concern \u2014 not part of the core library.\n */\n\nimport type { IndexProgress, SyncResult } from '../types';\n\n// \u2500\u2500 ANSI 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\nconst _v = '\\x1b[38;5;99m';   // violet\nconst _r = '\\x1b[0m';          // reset\nconst _d = '\\x1b[2m';          // dim\nconst _g = '\\x1b[38;5;114m';   // green\n\nfunction _bar(pct: number, width = 20): string {\n  const filled = Math.floor(pct / (100 / width));\n  return '\u2588'.repeat(filled) + '\u2591'.repeat(width - filled);\n}\n\nfunction _num(n: number): string {\n  return n.toLocaleString();\n}\n\n// \u2500\u2500 Renderer \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Renders a single indexAll progress event to stdout.\n * Scanning and framework detection print a persistent line (with \\n).\n * Parsing, resolving, and embeddings overwrite the current line (\\r).\n */\nexport function renderIndexProgress(p: IndexProgress): void {\n  const pct = p.total > 0 ? Math.round((p.current / p.total) * 100) : 0;\n\n  if (p.phase === 'scanning') {\n    process.stdout.write(`  ${_v}\u2713 scanning${_r}   ${_v}${p.current}${_r} ${_d}files found${_r}\\n`);\n\n  } else if (p.phase === 'parsing') {\n    process.stdout.write(`\\r  ${_v}parsing${_r}    [${_bar(pct)}] ${_v}${pct}%${_r}${' '.repeat(8)}`);\n    if (p.current === p.total) process.stdout.write('\\n');\n\n  } else if (p.phase === 'resolving') {\n    if (p.current === 0 && p.total <= 1) {\n      process.stdout.write(`\\r  ${_v}resolving${_r}  cross-file references\u2026${' '.repeat(20)}`);\n    } else if (p.total > 0) {\n      const bar = _bar(pct);\n      const suffix = p.current === p.total\n        ? `${_v}${p.current}${_r}${_d}/${p.total} refs${_r}\\n`\n        : `${_v}${p.current}${_r}${_d}/${p.total}${_r}${' '.repeat(10)}`;\n      const prefix = p.current === p.total ? `\\r  ${_v}\u2713 resolving${_r}` : `\\r  ${_v}resolving${_r} `;\n      process.stdout.write(`${prefix} [${bar}] ${suffix}`);\n    }\n\n  } else if (p.phase === 'detecting frameworks') {\n    if (p.current === 1) {\n      const frameworks = (p.meta?.frameworks as string[]) ?? [];\n      const languages  = (p.meta?.languages  as string[]) ?? [];\n      const fwLabel   = frameworks.length > 0 ? `${_v}${frameworks.join(', ')}${_r}` : `${_d}none${_r}`;\n      const langLabel = languages.length > 0  ? `${_v}${languages.join(', ')}${_r}`  : `${_d}none${_r}`;\n      process.stdout.write(`  ${_v}\u2713 languages${_r}  detected: ${langLabel}\\n`);\n      process.stdout.write(`  ${_v}\u2713 frameworks${_r} detected: ${fwLabel}\\n`);\n    }\n\n  } else if (p.phase === 'embeddings') {\n    if (p.current === -1) {\n      // Large-codebase pre-flight warning emitted by VectorManager\n      process.stdout.write(`\\n  \\x1b[33m\u26A0 Large codebase: ${_num(p.total)} embeddable symbols detected.\\x1b[0m\\n`);\n      process.stdout.write(`  \\x1b[33m  Embedding may be slow or memory-intensive. Consider setting enableEmbeddings: false\\x1b[0m\\n`);\n      process.stdout.write(`  \\x1b[33m  for codebases this large, or use a lighter model (e.g. Xenova/all-MiniLM-L6-v2).\\x1b[0m\\n\\n`);\n    } else {\n      process.stdout.write(`\\r  ${_v}embeddings${_r} [${_bar(pct)}] ${_v}${pct}%${_r}${' '.repeat(10)}`);\n      if (p.current === p.total && p.total > 0) process.stdout.write('\\n');\n    }\n\n  } else {\n    process.stdout.write(`\\r  ${_v}${p.phase}${_r}  ${p.current}/${p.total}${' '.repeat(20)}`);\n  }\n}\n\n\n// \u2500\u2500 Sync Progress Renderer \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Renders a single sync progress event to stdout.\n * Same visual style as renderIndexProgress but tailored for incremental sync.\n */\nexport function renderSyncProgress(p: IndexProgress): void {\n  const pct = p.total > 0 ? Math.round((p.current / p.total) * 100) : 0;\n\n  if (p.phase === 'scanning') {\n    if (p.current > 0) {\n      process.stdout.write(`\\r  ${_v}\u2713 scanning${_r}   ${_v}${_num(p.current)}${_r} ${_d}files found${_r}\\n`);\n    } else {\n      process.stdout.write(`\\r  ${_v}scanning${_r}    ${_d}detecting changes\u2026${_r}${' '.repeat(20)}`);\n    }\n\n  } else if (p.phase === 'parsing') {\n    process.stdout.write(`\\r  ${_v}parsing${_r}    [${_bar(pct)}] ${_v}${pct}%${_r}${' '.repeat(8)}`);\n    if (p.current === p.total) process.stdout.write('\\n');\n\n  } else if (p.phase === 'resolving') {\n    if (p.current === 0 && p.total <= 1) {\n      process.stdout.write(`\\r  ${_v}resolving${_r}  cross-file references\u2026${' '.repeat(20)}`);\n    } else if (p.total > 0) {\n      const bar = _bar(pct);\n      const suffix = p.current === p.total\n        ? `${_v}${_num(p.current)}${_r}${_d}/${_num(p.total)} refs${_r}\\n`\n        : `${_v}${_num(p.current)}${_r}${_d}/${_num(p.total)}${_r}${' '.repeat(10)}`;\n      const prefix = p.current === p.total ? `\\r  ${_v}\u2713 resolving${_r}` : `\\r  ${_v}resolving${_r} `;\n      process.stdout.write(`${prefix} [${bar}] ${suffix}`);\n    }\n\n  } else if (p.phase === 'embeddings') {\n    if (p.current === -1) {\n      process.stdout.write(`\\n  \\x1b[33m\u26A0 Large codebase: ${_num(p.total)} embeddable symbols detected.\\x1b[0m\\n`);\n      process.stdout.write(`  \\x1b[33m  Embedding may be slow or memory-intensive. Consider setting enableEmbeddings: false\\x1b[0m\\n`);\n      process.stdout.write(`  \\x1b[33m  for codebases this large, or use a lighter model (e.g. Xenova/all-MiniLM-L6-v2).\\x1b[0m\\n\\n`);\n    } else {\n      process.stdout.write(`\\r  ${_v}embeddings${_r} [${_bar(pct)}] ${_v}${pct}%${_r}${' '.repeat(10)}`);\n      if (p.current === p.total && p.total > 0) process.stdout.write('\\n');\n    }\n\n  } else {\n    process.stdout.write(`\\r  ${_v}${p.phase}${_r}  ${p.current}/${p.total}${' '.repeat(20)}`);\n  }\n}\n\n/**\n * Verbose sync progress renderer for `sync --progress`.\n * Prints each file as it is processed, errors inline, and a running count.\n * Exclude-cleanup removals are shown with a distinct prefix.\n */\nexport function renderSyncProgressVerbose(p: IndexProgress): void {\n  if (p.phase === 'scanning') {\n    if (p.meta?.excludeCleanup && p.meta.file) {\n      // A file is being removed because it now matches an exclude pattern\n      process.stdout.write(`  ${_d}exclude${_r}  ${_d}${p.meta.file}${_r}\\n`);\n    } else if (p.current > 0) {\n      process.stdout.write(`  ${_v}\u2713 scanning${_r}   ${_v}${_num(p.current)}${_r} ${_d}files found${_r}\\n`);\n    } else {\n      process.stdout.write(`  ${_v}scanning${_r}    ${_d}detecting changes\u2026${_r}\\n`);\n    }\n\n  } else if (p.phase === 'parsing') {\n    if (p.currentFile) {\n      const short = p.currentFile.length > 60\n        ? '\u2026' + p.currentFile.slice(p.currentFile.length - 59)\n        : p.currentFile;\n      process.stdout.write(`  ${_v}parse${_r}  ${_d}[${_num(p.current)}/${_num(p.total)}]${_r}  ${short}\\n`);\n    }\n\n  } else if (p.phase === 'resolving') {\n    if (p.current === 0 && p.total <= 1) {\n      process.stdout.write(`  ${_v}resolving${_r}  cross-file references\u2026\\n`);\n    } else if (p.total > 0 && p.current === p.total) {\n      process.stdout.write(`  ${_v}\u2713 resolving${_r}  ${_v}${_num(p.current)}${_r}${_d}/${_num(p.total)} refs${_r}\\n`);\n    }\n\n  } else if (p.phase === 'embeddings') {\n    if (p.current === -1) {\n      process.stdout.write(`\\n  \\x1b[33m\u26A0 Large codebase: ${_num(p.total)} embeddable symbols detected.\\x1b[0m\\n`);\n      process.stdout.write(`  \\x1b[33m  Embedding may be slow or memory-intensive. Consider setting enableEmbeddings: false\\x1b[0m\\n`);\n      process.stdout.write(`  \\x1b[33m  for codebases this large, or use a lighter model (e.g. Xenova/all-MiniLM-L6-v2).\\x1b[0m\\n\\n`);\n    } else {\n      const pct = p.total > 0 ? Math.round((p.current / p.total) * 100) : 0;\n      process.stdout.write(`\\r  ${_v}embeddings${_r} [${_bar(pct)}] ${_v}${pct}%${_r}${' '.repeat(10)}`);\n      if (p.current === p.total && p.total > 0) process.stdout.write('\\n');\n    }\n\n  } else if (p.phase === 'architecture') {\n    if (p.meta?.msg) {\n      process.stdout.write(`  ${_v}architecture${_r}  ${_d}${p.meta.msg}${_r}\\n`);\n    } else if (p.current === p.total && p.total > 0) {\n      process.stdout.write(`  ${_v}\u2713 architecture${_r}\\n`);\n    }\n\n  } else {\n    process.stdout.write(`  ${_v}${p.phase}${_r}  ${p.current}/${p.total}\\n`);\n  }\n}\n\n/**\n * Renders the final sync summary with before/after counts.\n */\nexport function renderSyncSummary(result: SyncResult): void {\n  const secs = (result.duration / 1000).toFixed(1);\n  const filesChanged = result.added.length + result.modified.length;\n  const filesDeleted = result.removed.length;\n\n  console.log(`\\n  ${_g}\u2713${_r} sync complete ${_d}(${secs}s)${_r}`);\n  console.log(`    ${_d}files scanned:${_r}  ${_v}${_num(result.filesScanned)}${_r}`);\n  console.log(`    ${_d}files changed:${_r}  ${_v}${_num(filesChanged)}${_r}`);\n  console.log(`    ${_d}files deleted:${_r}  ${_v}${_num(filesDeleted)}${_r}`);\n  console.log(`    ${_d}nodes added:${_r}    ${_v}${_num(result.nodesCreated)}${_r}`);\n  console.log(`    ${_d}nodes updated:${_r}  ${_v}${_num(result.nodesUpdated)}${_r}`);\n  console.log(`    ${_d}nodes removed:${_r}  ${_v}${_num(result.nodesRemoved)}${_r}`);\n  console.log(`    ${_d}edges added:${_r}    ${_v}${_num(result.edgesCreated)}${_r}`);\n  console.log(`    ${_d}edges removed:${_r}  ${_v}${_num(result.edgesRemoved)}${_r}`);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/bin/ui.d.ts

@@ -0,0 +1,11 @@
+export declare const violet = "\u001B[38;5;99m";
+export declare const bold = "\u001B[1m";
+export declare const dim = "\u001B[2m";
+export declare const green = "\u001B[38;5;114m";
+export declare const reset = "\u001B[0m";
+export declare function label(text: string): string;
+export declare function value(text: string): string;
+export declare function section(text: string): string;
+/** Render a two-column table with violet borders. Entries: [label, value] pairs. */
+export declare function renderTable(entries: [string, string][], indent?: string): string;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/bin/ui.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,oBAAkB,CAAC;AACtC,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,eAAO,MAAM,GAAG,cAAe,CAAC;AAChC,eAAO,MAAM,KAAK,qBAAoB,CAAC;AACvC,eAAO,MAAM,KAAK,cAAa,CAAC;AAEhC,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAoC;AAC/E,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAA8C;AACzF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAA8C;AAE3F,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,SAAO,GAAG,MAAM,CAa9E"}

package/dist/bin/ui.js

@@ -0,0 +1,71 @@
+"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 ui_exports = {};
+__export(ui_exports, {
+  bold: () => bold,
+  dim: () => dim,
+  green: () => green,
+  label: () => label,
+  renderTable: () => renderTable,
+  reset: () => reset,
+  section: () => section,
+  value: () => value,
+  violet: () => violet
+});
+module.exports = __toCommonJS(ui_exports);
+const violet = "\x1B[38;5;99m";
+const bold = "\x1B[1m";
+const dim = "\x1B[2m";
+const green = "\x1B[38;5;114m";
+const reset = "\x1B[0m";
+function label(text) {
+  return `${dim}${text}${reset}`;
+}
+function value(text) {
+  return `${violet}${bold}${text}${reset}`;
+}
+function section(text) {
+  return `${violet}${bold}${text}${reset}`;
+}
+function renderTable(entries, indent = "  ") {
+  if (entries.length === 0) return "";
+  const colW = Math.max(...entries.map(([k]) => k.length));
+  const top = `${indent}${violet}\u250C${"\u2500".repeat(colW + 2)}\u252C${"\u2500".repeat(18)}\u2510${reset}`;
+  const bottom = `${indent}${violet}\u2514${"\u2500".repeat(colW + 2)}\u2534${"\u2500".repeat(18)}\u2518${reset}`;
+  const rows = entries.map(([k, v], i) => {
+    const sep = i < entries.length - 1 ? `
+${indent}${violet}\u251C${"\u2500".repeat(colW + 2)}\u253C${"\u2500".repeat(18)}\u2524${reset}` : "";
+    const pad = " ".repeat(colW - k.length);
+    return `${indent}${violet}\u2502${reset} ${dim}${k}${reset}${pad} ${violet}\u2502${reset} ${violet}${bold}${v}${reset}${" ".repeat(Math.max(0, 16 - v.length))} ${violet}\u2502${reset}${sep}`;
+  });
+  return [top, ...rows, bottom].join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bold,
+  dim,
+  green,
+  label,
+  renderTable,
+  reset,
+  section,
+  value,
+  violet
+});
+//# sourceMappingURL=ui.js.map

package/dist/bin/ui.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bin/ui.ts"],
+  "sourcesContent": ["export const violet = '\\x1b[38;5;99m';\nexport const bold   = '\\x1b[1m';\nexport const dim    = '\\x1b[2m';\nexport const green  = '\\x1b[38;5;114m';\nexport const reset  = '\\x1b[0m';\n\nexport function label(text: string): string { return `${dim}${text}${reset}`; }\nexport function value(text: string): string { return `${violet}${bold}${text}${reset}`; }\nexport function section(text: string): string { return `${violet}${bold}${text}${reset}`; }\n\n/** Render a two-column table with violet borders. Entries: [label, value] pairs. */\nexport function renderTable(entries: [string, string][], indent = '  '): string {\n  if (entries.length === 0) return '';\n  const colW = Math.max(...entries.map(([k]) => k.length));\n  const top    = `${indent}${violet}\u250C${'\u2500'.repeat(colW + 2)}\u252C${'\u2500'.repeat(18)}\u2510${reset}`;\n  const bottom = `${indent}${violet}\u2514${'\u2500'.repeat(colW + 2)}\u2534${'\u2500'.repeat(18)}\u2518${reset}`;\n  const rows = entries.map(([k, v], i) => {\n    const sep = i < entries.length - 1\n      ? `\\n${indent}${violet}\u251C${'\u2500'.repeat(colW + 2)}\u253C${'\u2500'.repeat(18)}\u2524${reset}`\n      : '';\n    const pad = ' '.repeat(colW - k.length);\n    return `${indent}${violet}\u2502${reset} ${dim}${k}${reset}${pad} ${violet}\u2502${reset} ${violet}${bold}${v}${reset}${' '.repeat(Math.max(0, 16 - v.length))} ${violet}\u2502${reset}${sep}`;\n  });\n  return [top, ...rows, bottom].join('\\n');\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,SAAS;AACf,MAAM,OAAS;AACf,MAAM,MAAS;AACf,MAAM,QAAS;AACf,MAAM,QAAS;AAEf,SAAS,MAAM,MAAsB;AAAE,SAAO,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK;AAAI;AACvE,SAAS,MAAM,MAAsB;AAAE,SAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK;AAAI;AACjF,SAAS,QAAQ,MAAsB;AAAE,SAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK;AAAI;AAGnF,SAAS,YAAY,SAA6B,SAAS,MAAc;AAC9E,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,OAAO,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;AACvD,QAAM,MAAS,GAAG,MAAM,GAAG,MAAM,SAAI,SAAI,OAAO,OAAO,CAAC,CAAC,SAAI,SAAI,OAAO,EAAE,CAAC,SAAI,KAAK;AACpF,QAAM,SAAS,GAAG,MAAM,GAAG,MAAM,SAAI,SAAI,OAAO,OAAO,CAAC,CAAC,SAAI,SAAI,OAAO,EAAE,CAAC,SAAI,KAAK;AACpF,QAAM,OAAO,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM;AACtC,UAAM,MAAM,IAAI,QAAQ,SAAS,IAC7B;AAAA,EAAK,MAAM,GAAG,MAAM,SAAI,SAAI,OAAO,OAAO,CAAC,CAAC,SAAI,SAAI,OAAO,EAAE,CAAC,SAAI,KAAK,KACvE;AACJ,UAAM,MAAM,IAAI,OAAO,OAAO,EAAE,MAAM;AACtC,WAAO,GAAG,MAAM,GAAG,MAAM,SAAI,KAAK,IAAI,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG,IAAI,MAAM,SAAI,KAAK,IAAI,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,MAAM,SAAI,KAAK,GAAG,GAAG;AAAA,EAC/K,CAAC;AACD,SAAO,CAAC,KAAK,GAAG,MAAM,MAAM,EAAE,KAAK,IAAI;AACzC;",
+  "names": []
+}

package/dist/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * KiroGraph Config System
+ *
+ * Mirrors CodeGraph src/config.ts — load, save, validate, and provide defaults
+ * for KiroGraph configuration.
+ */
+export interface KiroGraphConfig {
+    version: number;
+    languages: string[];
+    include: string[];
+    exclude: string[];
+    maxFileSize: number;
+    extractDocstrings: boolean;
+    trackCallSites: boolean;
+    enableEmbeddings: boolean;
+    embeddingModel: string;
+    embeddingDim: number;
+    /** @deprecated Use semanticEngine instead. Kept for backwards compatibility. */
+    useVecIndex: boolean;
+    semanticEngine: 'cosine' | 'sqlite-vec' | 'orama' | 'pglite' | 'lancedb' | 'qdrant' | 'typesense';
+    typesenseDashboard: boolean;
+    qdrantDashboard: boolean;
+    minLogLevel: 'debug' | 'info' | 'warn' | 'error';
+    frameworkHints: string[];
+    fuzzyResolutionThreshold: number;
+    /** Enable architecture analysis (package graph + layer detection). Default: false. */
+    enableArchitecture: boolean;
+    /**
+     * User-defined layer → glob pattern overrides.
+     * When set, config-defined layers win over auto-detected ones.
+     * Example: { "api": ["src/routes/**", "src/controllers/**"] }
+     */
+    architectureLayers?: Record<string, string[]>;
+}
+/**
+ * Returns false if the pattern is potentially dangerous (ReDoS risk) or too long.
+ * Checks for catastrophic backtracking patterns like (a+)+ or (a|a)+.
+ */
+export declare function isSafeRegex(pattern: string): boolean;
+export declare function createDefaultConfig(_projectRoot?: string): KiroGraphConfig;
+export declare function validateConfig(config: unknown): KiroGraphConfig;
+export declare function loadConfig(projectRoot: string): Promise<KiroGraphConfig>;
+export declare function saveConfig(projectRoot: string, config: KiroGraphConfig): Promise<void>;
+export declare function updateConfig(projectRoot: string, patch: Partial<KiroGraphConfig>): Promise<KiroGraphConfig>;
+export declare function addIncludePatterns(projectRoot: string, patterns: string[]): Promise<void>;
+export declare function addExcludePatterns(projectRoot: string, patterns: string[]): Promise<void>;
+export declare function shouldIncludeFile(config: KiroGraphConfig, relPath: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IAExB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClG,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sFAAsF;IACtF,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/C;AAmBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOpD;AAID,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,CAqB1E;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CA8F/D;AA+BD,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB9E;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAUD,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,OAAO,CAAC,eAAe,CAAC,CAK1B;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUnF"}

package/dist/config.js

@@ -0,0 +1,273 @@
+"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 config_exports = {};
+__export(config_exports, {
+  addExcludePatterns: () => addExcludePatterns,
+  addIncludePatterns: () => addIncludePatterns,
+  createDefaultConfig: () => createDefaultConfig,
+  isSafeRegex: () => isSafeRegex,
+  loadConfig: () => loadConfig,
+  saveConfig: () => saveConfig,
+  shouldIncludeFile: () => shouldIncludeFile,
+  updateConfig: () => updateConfig,
+  validateConfig: () => validateConfig
+});
+module.exports = __toCommonJS(config_exports);
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_picomatch = __toESM(require("picomatch"));
+var import_errors = require("./errors");
+const KIROGRAPH_DIR = ".kirograph";
+const CONFIG_FILE = "config.json";
+const KNOWN_FIELDS = /* @__PURE__ */ new Set([
+  "version",
+  "languages",
+  "include",
+  "exclude",
+  "maxFileSize",
+  "extractDocstrings",
+  "trackCallSites",
+  "enableEmbeddings",
+  "embeddingModel",
+  "embeddingDim",
+  "useVecIndex",
+  "semanticEngine",
+  "typesenseDashboard",
+  "qdrantDashboard",
+  "minLogLevel",
+  "frameworkHints",
+  "fuzzyResolutionThreshold",
+  "enableArchitecture",
+  "architectureLayers",
+  "cavemanMode",
+  "syncWarningThreshold"
+]);
+const LOG_LEVELS = /* @__PURE__ */ new Set(["debug", "info", "warn", "error"]);
+function isSafeRegex(pattern) {
+  if (pattern.length > 100) return false;
+  if (/\([^)]*[+*][^)]*\)[+*?]/.test(pattern)) return false;
+  if (/\([^)]*\|[^)]*\)[+*]/.test(pattern)) return false;
+  return true;
+}
+function createDefaultConfig(_projectRoot) {
+  return {
+    version: 2,
+    languages: [],
+    include: [],
+    exclude: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**", "*.min.js", "**/.kirograph/**"],
+    maxFileSize: 1048576,
+    extractDocstrings: true,
+    trackCallSites: true,
+    enableEmbeddings: false,
+    embeddingModel: "nomic-ai/nomic-embed-text-v1.5",
+    embeddingDim: 768,
+    useVecIndex: false,
+    semanticEngine: "cosine",
+    typesenseDashboard: false,
+    qdrantDashboard: false,
+    minLogLevel: "warn",
+    frameworkHints: [],
+    fuzzyResolutionThreshold: 0.5,
+    enableArchitecture: false,
+    cavemanMode: "off",
+    syncWarningThreshold: 10
+  };
+}
+function validateConfig(config) {
+  const defaults = createDefaultConfig();
+  if (typeof config !== "object" || config === null) {
+    return defaults;
+  }
+  const raw = config;
+  for (const key of Object.keys(raw)) {
+    if (!KNOWN_FIELDS.has(key)) {
+      (0, import_errors.logWarn)(`Unknown config field: ${key}`);
+    }
+  }
+  const version = typeof raw.version === "number" ? raw.version : defaults.version;
+  const languages = Array.isArray(raw.languages) && raw.languages.every((l) => typeof l === "string") ? raw.languages : defaults.languages;
+  const maxFileSize = typeof raw.maxFileSize === "number" && raw.maxFileSize > 0 ? raw.maxFileSize : defaults.maxFileSize;
+  const extractDocstrings = typeof raw.extractDocstrings === "boolean" ? raw.extractDocstrings : defaults.extractDocstrings;
+  const trackCallSites = typeof raw.trackCallSites === "boolean" ? raw.trackCallSites : defaults.trackCallSites;
+  const enableEmbeddings = typeof raw.enableEmbeddings === "boolean" ? raw.enableEmbeddings : defaults.enableEmbeddings;
+  const embeddingModel = typeof raw.embeddingModel === "string" && raw.embeddingModel.length > 0 ? raw.embeddingModel : defaults.embeddingModel;
+  const embeddingDim = typeof raw.embeddingDim === "number" && raw.embeddingDim > 0 ? raw.embeddingDim : defaults.embeddingDim;
+  const useVecIndex = typeof raw.useVecIndex === "boolean" ? raw.useVecIndex : defaults.useVecIndex;
+  const SEMANTIC_ENGINES = /* @__PURE__ */ new Set(["cosine", "sqlite-vec", "orama", "pglite", "lancedb", "qdrant", "typesense"]);
+  const semanticEngine = typeof raw.semanticEngine === "string" && SEMANTIC_ENGINES.has(raw.semanticEngine) ? raw.semanticEngine : useVecIndex ? "sqlite-vec" : defaults.semanticEngine;
+  const typesenseDashboard = typeof raw.typesenseDashboard === "boolean" ? raw.typesenseDashboard : defaults.typesenseDashboard;
+  const qdrantDashboard = typeof raw.qdrantDashboard === "boolean" ? raw.qdrantDashboard : defaults.qdrantDashboard;
+  const minLogLevel = typeof raw.minLogLevel === "string" && LOG_LEVELS.has(raw.minLogLevel) ? raw.minLogLevel : defaults.minLogLevel;
+  const frameworkHints = Array.isArray(raw.frameworkHints) && raw.frameworkHints.every((h) => typeof h === "string") ? raw.frameworkHints : defaults.frameworkHints;
+  const fuzzyResolutionThreshold = typeof raw.fuzzyResolutionThreshold === "number" && raw.fuzzyResolutionThreshold >= 0 && raw.fuzzyResolutionThreshold <= 1 ? raw.fuzzyResolutionThreshold : defaults.fuzzyResolutionThreshold;
+  const enableArchitecture = typeof raw.enableArchitecture === "boolean" ? raw.enableArchitecture : defaults.enableArchitecture;
+  const architectureLayers = _validateArchitectureLayers(raw.architectureLayers);
+  const CAVEMAN_MODES = /* @__PURE__ */ new Set(["off", "lite", "full", "ultra"]);
+  const cavemanMode = typeof raw.cavemanMode === "string" && CAVEMAN_MODES.has(raw.cavemanMode) ? raw.cavemanMode : defaults.cavemanMode;
+  const syncWarningThreshold = typeof raw.syncWarningThreshold === "number" && raw.syncWarningThreshold >= 0 ? Math.round(raw.syncWarningThreshold) : defaults.syncWarningThreshold;
+  const include = _validatePatterns(raw.include, defaults.include);
+  const exclude = _validatePatterns(raw.exclude, defaults.exclude);
+  return {
+    version,
+    languages,
+    include,
+    exclude,
+    maxFileSize,
+    extractDocstrings,
+    trackCallSites,
+    enableEmbeddings,
+    embeddingModel,
+    embeddingDim,
+    useVecIndex,
+    semanticEngine,
+    typesenseDashboard,
+    qdrantDashboard,
+    minLogLevel,
+    frameworkHints,
+    fuzzyResolutionThreshold,
+    enableArchitecture,
+    cavemanMode,
+    syncWarningThreshold,
+    ...architectureLayers !== void 0 ? { architectureLayers } : {}
+  };
+}
+function _validateArchitectureLayers(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const result = {};
+  for (const [key, val] of Object.entries(raw)) {
+    if (typeof key !== "string") continue;
+    if (!Array.isArray(val)) continue;
+    const patterns = val.filter((p) => typeof p === "string" && isSafeRegex(p));
+    if (patterns.length > 0) result[key] = patterns;
+  }
+  return Object.keys(result).length > 0 ? result : void 0;
+}
+function _validatePatterns(raw, fallback) {
+  if (!Array.isArray(raw)) return fallback;
+  const valid = [];
+  for (const p of raw) {
+    if (typeof p !== "string") continue;
+    if (!isSafeRegex(p)) {
+      (0, import_errors.logWarn)(`Unsafe regex pattern skipped: ${p}`);
+      continue;
+    }
+    valid.push(p);
+  }
+  return valid;
+}
+const SHALLOW_TO_RECURSIVE = {
+  "node_modules/**": "**/node_modules/**",
+  "dist/**": "**/dist/**",
+  "build/**": "**/build/**",
+  ".git/**": "**/.git/**",
+  ".kirograph/**": "**/.kirograph/**"
+};
+function migrateExcludePatterns(patterns) {
+  return patterns.map((p) => SHALLOW_TO_RECURSIVE[p] ?? p);
+}
+async function loadConfig(projectRoot) {
+  const dir = path.join(projectRoot, KIROGRAPH_DIR);
+  const cfgPath = path.join(dir, CONFIG_FILE);
+  if (!fs.existsSync(cfgPath)) {
+    const defaults = createDefaultConfig(projectRoot);
+    await fs.promises.mkdir(dir, { recursive: true });
+    await _writeAtomic(cfgPath, defaults);
+    return defaults;
+  }
+  let raw;
+  try {
+    const text = await fs.promises.readFile(cfgPath, "utf8");
+    raw = JSON.parse(text);
+  } catch (err) {
+    (0, import_errors.logError)("Config parse error", { path: cfgPath, error: err instanceof Error ? err.message : String(err) });
+    return createDefaultConfig(projectRoot);
+  }
+  const config = validateConfig(raw);
+  if (config.version < 2) {
+    config.version = 2;
+    config.exclude = migrateExcludePatterns(config.exclude);
+    await fs.promises.mkdir(dir, { recursive: true });
+    await _writeAtomic(cfgPath, config);
+  }
+  return config;
+}
+async function saveConfig(projectRoot, config) {
+  const dir = path.join(projectRoot, KIROGRAPH_DIR);
+  const cfgPath = path.join(dir, CONFIG_FILE);
+  await fs.promises.mkdir(dir, { recursive: true });
+  await _writeAtomic(cfgPath, config);
+}
+async function _writeAtomic(cfgPath, config) {
+  const tmp = cfgPath + ".tmp";
+  await fs.promises.writeFile(tmp, JSON.stringify(config, null, 2), "utf8");
+  await fs.promises.rename(tmp, cfgPath);
+}
+async function updateConfig(projectRoot, patch) {
+  const current = await loadConfig(projectRoot);
+  const updated = validateConfig({ ...current, ...patch });
+  await saveConfig(projectRoot, updated);
+  return updated;
+}
+async function addIncludePatterns(projectRoot, patterns) {
+  const config = await loadConfig(projectRoot);
+  const existing = new Set(config.include);
+  const toAdd = patterns.filter((p) => isSafeRegex(p) && !existing.has(p));
+  if (toAdd.length === 0) return;
+  await saveConfig(projectRoot, { ...config, include: [...config.include, ...toAdd] });
+}
+async function addExcludePatterns(projectRoot, patterns) {
+  const config = await loadConfig(projectRoot);
+  const existing = new Set(config.exclude);
+  const toAdd = patterns.filter((p) => isSafeRegex(p) && !existing.has(p));
+  if (toAdd.length === 0) return;
+  await saveConfig(projectRoot, { ...config, exclude: [...config.exclude, ...toAdd] });
+}
+function shouldIncludeFile(config, relPath) {
+  for (const pattern of config.exclude) {
+    if ((0, import_picomatch.default)(pattern)(relPath)) return false;
+  }
+  if (config.include.length > 0) {
+    return config.include.some((pattern) => (0, import_picomatch.default)(pattern)(relPath));
+  }
+  return true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addExcludePatterns,
+  addIncludePatterns,
+  createDefaultConfig,
+  isSafeRegex,
+  loadConfig,
+  saveConfig,
+  shouldIncludeFile,
+  updateConfig,
+  validateConfig
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/config.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Config System\n *\n * Mirrors CodeGraph src/config.ts \u2014 load, save, validate, and provide defaults\n * for KiroGraph configuration.\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport picomatch from 'picomatch';\nimport { logWarn, logError } from './errors';\n\n// \u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 interface KiroGraphConfig {\n  version: number;\n  languages: string[];\n  include: string[];\n  exclude: string[];\n  maxFileSize: number;\n  extractDocstrings: boolean;\n  trackCallSites: boolean;\n  // Parity fields:\n  enableEmbeddings: boolean;\n  embeddingModel: string;\n  embeddingDim: number;\n  /** @deprecated Use semanticEngine instead. Kept for backwards compatibility. */\n  useVecIndex: boolean;\n  semanticEngine: 'cosine' | 'sqlite-vec' | 'orama' | 'pglite' | 'lancedb' | 'qdrant' | 'typesense';\n  typesenseDashboard: boolean;\n  qdrantDashboard: boolean;\n  minLogLevel: 'debug' | 'info' | 'warn' | 'error';\n  frameworkHints: string[];\n  fuzzyResolutionThreshold: number; // 0.0\u20131.0\n  /** Enable architecture analysis (package graph + layer detection). Default: false. */\n  enableArchitecture: boolean;\n  /**\n   * User-defined layer \u2192 glob pattern overrides.\n   * When set, config-defined layers win over auto-detected ones.\n   * Example: { \"api\": [\"src/routes/**\", \"src/controllers/**\"] }\n   */\n  architectureLayers?: Record<string, string[]>;\n  /** Agent communication style injected at agentSpawn. Default: 'off'. */\n  cavemanMode: 'off' | 'lite' | 'full' | 'ultra';\n  /**\n   * Number of pending (unindexed) files above which kirograph_status warns the agent.\n   * Set to 0 to disable the warning. Default: 10.\n   */\n  syncWarningThreshold: number;\n}\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 KIROGRAPH_DIR = '.kirograph';\nconst CONFIG_FILE = 'config.json';\n\nconst KNOWN_FIELDS = new Set<string>([\n  'version', 'languages', 'include', 'exclude', 'maxFileSize',\n  'extractDocstrings', 'trackCallSites', 'enableEmbeddings', 'embeddingModel', 'embeddingDim',\n  'useVecIndex', 'semanticEngine', 'typesenseDashboard', 'qdrantDashboard',\n  'minLogLevel', 'frameworkHints', 'fuzzyResolutionThreshold',\n  'enableArchitecture', 'architectureLayers', 'cavemanMode', 'syncWarningThreshold',\n]);\n\nconst LOG_LEVELS = new Set(['debug', 'info', 'warn', 'error']);\n\n// \u2500\u2500 ReDoS-safe regex check \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Returns false if the pattern is potentially dangerous (ReDoS risk) or too long.\n * Checks for catastrophic backtracking patterns like (a+)+ or (a|a)+.\n */\nexport function isSafeRegex(pattern: string): boolean {\n  if (pattern.length > 100) return false;\n  // Detect nested quantifiers: (x+)+ or (x*)+ or (x+)* etc.\n  if (/\\([^)]*[+*][^)]*\\)[+*?]/.test(pattern)) return false;\n  // Detect alternation with overlap: (a|a)+ style\n  if (/\\([^)]*\\|[^)]*\\)[+*]/.test(pattern)) return false;\n  return true;\n}\n\n// \u2500\u2500 Default config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 createDefaultConfig(_projectRoot?: string): KiroGraphConfig {\n  return {\n    version: 2,\n    languages: [],\n    include: [],\n    exclude: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**', '*.min.js', '**/.kirograph/**'],\n    maxFileSize: 1_048_576,\n    extractDocstrings: true,\n    trackCallSites: true,\n    enableEmbeddings: false,\n    embeddingModel: 'nomic-ai/nomic-embed-text-v1.5',\n    embeddingDim: 768,\n    useVecIndex: false,\n    semanticEngine: 'cosine',\n    typesenseDashboard: false,\n    qdrantDashboard: false,\n    minLogLevel: 'warn',\n    frameworkHints: [],\n    fuzzyResolutionThreshold: 0.5,\n    enableArchitecture: false,\n    cavemanMode: 'off',\n    syncWarningThreshold: 10,\n  };\n}\n\n// \u2500\u2500 Validation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 validateConfig(config: unknown): KiroGraphConfig {\n  const defaults = createDefaultConfig();\n\n  if (typeof config !== 'object' || config === null) {\n    return defaults;\n  }\n\n  const raw = config as Record<string, unknown>;\n\n  // Warn about unknown fields\n  for (const key of Object.keys(raw)) {\n    if (!KNOWN_FIELDS.has(key)) {\n      logWarn(`Unknown config field: ${key}`);\n    }\n  }\n\n  // Validate and coerce each field\n  const version = typeof raw.version === 'number' ? raw.version : defaults.version;\n  const languages = Array.isArray(raw.languages) && raw.languages.every(l => typeof l === 'string')\n    ? (raw.languages as string[])\n    : defaults.languages;\n  const maxFileSize = typeof raw.maxFileSize === 'number' && raw.maxFileSize > 0\n    ? raw.maxFileSize\n    : defaults.maxFileSize;\n  const extractDocstrings = typeof raw.extractDocstrings === 'boolean'\n    ? raw.extractDocstrings\n    : defaults.extractDocstrings;\n  const trackCallSites = typeof raw.trackCallSites === 'boolean'\n    ? raw.trackCallSites\n    : defaults.trackCallSites;\n  const enableEmbeddings = typeof raw.enableEmbeddings === 'boolean'\n    ? raw.enableEmbeddings\n    : defaults.enableEmbeddings;\n  const embeddingModel = typeof raw.embeddingModel === 'string' && raw.embeddingModel.length > 0\n    ? raw.embeddingModel\n    : defaults.embeddingModel;\n  const embeddingDim = typeof raw.embeddingDim === 'number' && raw.embeddingDim > 0\n    ? raw.embeddingDim\n    : defaults.embeddingDim;\n  const useVecIndex = typeof raw.useVecIndex === 'boolean'\n    ? raw.useVecIndex\n    : defaults.useVecIndex;\n  const SEMANTIC_ENGINES = new Set(['cosine', 'sqlite-vec', 'orama', 'pglite', 'lancedb', 'qdrant', 'typesense']);\n  // useVecIndex is a legacy alias: if set and no explicit semanticEngine, map it\n  const semanticEngine = typeof raw.semanticEngine === 'string' && SEMANTIC_ENGINES.has(raw.semanticEngine)\n    ? (raw.semanticEngine as KiroGraphConfig['semanticEngine'])\n    : useVecIndex ? 'sqlite-vec' : defaults.semanticEngine;\n  const typesenseDashboard = typeof raw.typesenseDashboard === 'boolean'\n    ? raw.typesenseDashboard\n    : defaults.typesenseDashboard;\n  const qdrantDashboard = typeof raw.qdrantDashboard === 'boolean'\n    ? raw.qdrantDashboard\n    : defaults.qdrantDashboard;\n  const minLogLevel = typeof raw.minLogLevel === 'string' && LOG_LEVELS.has(raw.minLogLevel)\n    ? (raw.minLogLevel as KiroGraphConfig['minLogLevel'])\n    : defaults.minLogLevel;\n  const frameworkHints = Array.isArray(raw.frameworkHints) && raw.frameworkHints.every(h => typeof h === 'string')\n    ? (raw.frameworkHints as string[])\n    : defaults.frameworkHints;\n  const fuzzyResolutionThreshold = typeof raw.fuzzyResolutionThreshold === 'number'\n    && raw.fuzzyResolutionThreshold >= 0\n    && raw.fuzzyResolutionThreshold <= 1\n    ? raw.fuzzyResolutionThreshold\n    : defaults.fuzzyResolutionThreshold;\n  const enableArchitecture = typeof raw.enableArchitecture === 'boolean'\n    ? raw.enableArchitecture\n    : defaults.enableArchitecture;\n  const architectureLayers = _validateArchitectureLayers(raw.architectureLayers);\n  const CAVEMAN_MODES = new Set(['off', 'lite', 'full', 'ultra']);\n  const cavemanMode = typeof raw.cavemanMode === 'string' && CAVEMAN_MODES.has(raw.cavemanMode)\n    ? (raw.cavemanMode as KiroGraphConfig['cavemanMode'])\n    : defaults.cavemanMode;\n  const syncWarningThreshold = typeof raw.syncWarningThreshold === 'number' && raw.syncWarningThreshold >= 0\n    ? Math.round(raw.syncWarningThreshold)\n    : defaults.syncWarningThreshold;\n\n  // Validate glob patterns \u2014 exclude unsafe regex patterns\n  const include = _validatePatterns(raw.include, defaults.include);\n  const exclude = _validatePatterns(raw.exclude, defaults.exclude);\n\n  return {\n    version,\n    languages,\n    include,\n    exclude,\n    maxFileSize,\n    extractDocstrings,\n    trackCallSites,\n    enableEmbeddings,\n    embeddingModel,\n    embeddingDim,\n    useVecIndex,\n    semanticEngine,\n    typesenseDashboard,\n    qdrantDashboard,\n    minLogLevel,\n    frameworkHints,\n    fuzzyResolutionThreshold,\n    enableArchitecture,\n    cavemanMode,\n    syncWarningThreshold,\n    ...(architectureLayers !== undefined ? { architectureLayers } : {}),\n  };\n}\n\nfunction _validateArchitectureLayers(raw: unknown): Record<string, string[]> | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== 'object' || Array.isArray(raw)) return undefined;\n  const result: Record<string, string[]> = {};\n  for (const [key, val] of Object.entries(raw as Record<string, unknown>)) {\n    if (typeof key !== 'string') continue;\n    if (!Array.isArray(val)) continue;\n    const patterns = val.filter((p): p is string => typeof p === 'string' && isSafeRegex(p));\n    if (patterns.length > 0) result[key] = patterns;\n  }\n  return Object.keys(result).length > 0 ? result : undefined;\n}\n\nfunction _validatePatterns(raw: unknown, fallback: string[]): string[] {\n  if (!Array.isArray(raw)) return fallback;\n  const valid: string[] = [];\n  for (const p of raw) {\n    if (typeof p !== 'string') continue;\n    if (!isSafeRegex(p)) {\n      logWarn(`Unsafe regex pattern skipped: ${p}`);\n      continue;\n    }\n    valid.push(p);\n  }\n  return valid;\n}\n\n// \u2500\u2500 Migration 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\n\n/**\n * Upgrades shallow exclude patterns (e.g. \"node_modules/**\") to recursive ones\n * (e.g. \"** /node_modules/**\") so nested directories are excluded at any depth.\n */\nconst SHALLOW_TO_RECURSIVE: Record<string, string> = {\n  'node_modules/**': '**/node_modules/**',\n  'dist/**': '**/dist/**',\n  'build/**': '**/build/**',\n  '.git/**': '**/.git/**',\n  '.kirograph/**': '**/.kirograph/**',\n};\n\nfunction migrateExcludePatterns(patterns: string[]): string[] {\n  return patterns.map(p => SHALLOW_TO_RECURSIVE[p] ?? p);\n}\n\n// \u2500\u2500 Load / Save \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 loadConfig(projectRoot: string): Promise<KiroGraphConfig> {\n  const dir = path.join(projectRoot, KIROGRAPH_DIR);\n  const cfgPath = path.join(dir, CONFIG_FILE);\n\n  if (!fs.existsSync(cfgPath)) {\n    // Create default config file\n    const defaults = createDefaultConfig(projectRoot);\n    await fs.promises.mkdir(dir, { recursive: true });\n    await _writeAtomic(cfgPath, defaults);\n    return defaults;\n  }\n\n  let raw: unknown;\n  try {\n    const text = await fs.promises.readFile(cfgPath, 'utf8');\n    raw = JSON.parse(text);\n  } catch (err) {\n    logError('Config parse error', { path: cfgPath, error: err instanceof Error ? err.message : String(err) });\n    return createDefaultConfig(projectRoot);\n  }\n\n  const config = validateConfig(raw);\n\n  // Migrate v1 \u2192 v2: upgrade shallow exclude patterns to recursive\n  if (config.version < 2) {\n    config.version = 2;\n    config.exclude = migrateExcludePatterns(config.exclude);\n    await fs.promises.mkdir(dir, { recursive: true });\n    await _writeAtomic(cfgPath, config);\n  }\n\n  return config;\n}\n\nexport async function saveConfig(projectRoot: string, config: KiroGraphConfig): Promise<void> {\n  const dir = path.join(projectRoot, KIROGRAPH_DIR);\n  const cfgPath = path.join(dir, CONFIG_FILE);\n  await fs.promises.mkdir(dir, { recursive: true });\n  await _writeAtomic(cfgPath, config);\n}\n\nasync function _writeAtomic(cfgPath: string, config: KiroGraphConfig): Promise<void> {\n  const tmp = cfgPath + '.tmp';\n  await fs.promises.writeFile(tmp, JSON.stringify(config, null, 2), 'utf8');\n  await fs.promises.rename(tmp, cfgPath);\n}\n\n// \u2500\u2500 Update 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\n\nexport async function updateConfig(\n  projectRoot: string,\n  patch: Partial<KiroGraphConfig>\n): Promise<KiroGraphConfig> {\n  const current = await loadConfig(projectRoot);\n  const updated = validateConfig({ ...current, ...patch });\n  await saveConfig(projectRoot, updated);\n  return updated;\n}\n\nexport async function addIncludePatterns(projectRoot: string, patterns: string[]): Promise<void> {\n  const config = await loadConfig(projectRoot);\n  const existing = new Set(config.include);\n  const toAdd = patterns.filter(p => isSafeRegex(p) && !existing.has(p));\n  if (toAdd.length === 0) return;\n  await saveConfig(projectRoot, { ...config, include: [...config.include, ...toAdd] });\n}\n\nexport async function addExcludePatterns(projectRoot: string, patterns: string[]): Promise<void> {\n  const config = await loadConfig(projectRoot);\n  const existing = new Set(config.exclude);\n  const toAdd = patterns.filter(p => isSafeRegex(p) && !existing.has(p));\n  if (toAdd.length === 0) return;\n  await saveConfig(projectRoot, { ...config, exclude: [...config.exclude, ...toAdd] });\n}\n\n// \u2500\u2500 File inclusion check \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 shouldIncludeFile(config: KiroGraphConfig, relPath: string): boolean {\n  // Check exclude patterns first\n  for (const pattern of config.exclude) {\n    if (picomatch(pattern)(relPath)) return false;\n  }\n  // If include patterns are specified, file must match at least one\n  if (config.include.length > 0) {\n    return config.include.some(pattern => picomatch(pattern)(relPath));\n  }\n  return true;\n}\n"],
+  "mappings": "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",
+  "names": ["picomatch"]
+}

package/dist/context/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * KiroGraph Context Builder
+ *
+ * Implements hybrid search (exact name + semantic + full-text) to assemble
+ * relevant code context for a given query.
+ * Mirrors CodeGraph src/context/index.ts
+ */
+import type { Node, TaskContext } from '../types';
+import type { GraphDatabase } from '../db/database';
+import type { ReferenceResolver } from '../resolution/index';
+import type { VectorManager } from '../vectors/index';
+export interface ContextOptions {
+    maxNodes?: number;
+    maxCodeBlocks?: number;
+    maxCodeBlockSize?: number;
+    traversalDepth?: number;
+}
+export declare class ContextBuilder {
+    private readonly db;
+    private readonly resolver;
+    private readonly vectors;
+    private readonly projectRoot;
+    constructor(db: GraphDatabase, resolver: ReferenceResolver, vectors: VectorManager, projectRoot: string);
+    /**
+     * Find relevant nodes for the given query using hybrid search.
+     *
+     * Pipeline:
+     * 1. Extract symbol tokens from query
+     * 2. Exact name lookup (priority: 'exact')
+     * 3. Semantic search via VectorManager (priority: 'semantic')
+     * 4. Full-text search fallback (priority: 'fts')
+     * 5. Merge and deduplicate by node ID
+     * 6. Resolve import nodes to their definitions via 'imports' edge
+     * 7. Exclude 'import' and 'export' node kinds
+     * 8. Priority-based trimming when exceeding maxNodes
+     */
+    findRelevantContext(query: string, opts?: ContextOptions): Promise<Node[]>;
+    /**
+     * Build a full TaskContext for the given task description.
+     * Finds relevant nodes, gathers their edges and source snippets, and returns
+     * the structured context used by MCP tools and the query API.
+     */
+    buildTaskContext(task: string, opts?: {
+        maxNodes?: number;
+        includeCode?: boolean;
+    }): Promise<TaskContext>;
+    private _readNodeSource;
+    /**
+     * Build a formatted context string for the given query.
+     *
+     * Each node is formatted as:
+     *   [filePath:line] kind name
+     *   ```
+     *   {snippet}
+     *   ```
+     *
+     * Returns NO_RESULTS_MESSAGE when no nodes are found.
+     */
+    build(query: string, opts?: ContextOptions): Promise<string>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkBtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAqBD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAHX,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM;IAGtC;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAsFhF;;;;OAIG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA0B/G,OAAO,CAAC,eAAe;IAQvB;;;;;;;;;;OAUG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBnE"}