kirograph 0.12.1

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * KiroGraph Type Definitions
+ */
+export type NodeKind = 'file' | 'module' | 'class' | 'struct' | 'interface' | 'trait' | 'protocol' | 'function' | 'method' | 'property' | 'field' | 'variable' | 'constant' | 'enum' | 'enum_member' | 'type_alias' | 'namespace' | 'parameter' | 'import' | 'export' | 'route' | 'component';
+export type EdgeKind = 'contains' | 'calls' | 'imports' | 'exports' | 'extends' | 'implements' | 'references' | 'type_of' | 'returns' | 'instantiates' | 'overrides' | 'decorates';
+export type Language = 'typescript' | 'javascript' | 'tsx' | 'jsx' | 'python' | 'go' | 'rust' | 'java' | 'c' | 'cpp' | 'csharp' | 'php' | 'ruby' | 'swift' | 'kotlin' | 'dart' | 'svelte' | 'pascal' | 'liquid' | 'unknown';
+export interface Node {
+    id: string;
+    kind: NodeKind;
+    name: string;
+    qualifiedName: string;
+    filePath: string;
+    language: Language;
+    startLine: number;
+    endLine: number;
+    startColumn: number;
+    endColumn: number;
+    docstring?: string;
+    signature?: string;
+    visibility?: 'public' | 'private' | 'protected' | 'internal';
+    isExported?: boolean;
+    isAsync?: boolean;
+    isStatic?: boolean;
+    isAbstract?: boolean;
+    decorators?: string[];
+    typeParameters?: string[];
+    updatedAt: number;
+}
+export interface Edge {
+    source: string;
+    target: string;
+    kind: EdgeKind;
+    metadata?: Record<string, unknown>;
+    line?: number;
+    column?: number;
+}
+export interface FileRecord {
+    path: string;
+    contentHash: string;
+    language: Language;
+    fileSize: number;
+    symbolCount: number;
+    indexedAt: number;
+}
+export interface SearchResult {
+    node: Node;
+    score: number;
+    matchType: 'exact' | 'prefix' | 'fuzzy' | 'semantic';
+}
+export interface SearchOptions {
+    kinds?: NodeKind[];
+    languages?: Language[];
+    limit?: number;
+    minScore?: number;
+}
+export interface Subgraph {
+    nodes: Node[];
+    edges: Edge[];
+    entryPoints: string[];
+}
+export interface NodeContext {
+    node: Node;
+    ancestors: Node[];
+    children: Node[];
+    callers: Node[];
+    callees: Node[];
+}
+export interface NodeMetrics {
+    incomingEdgeCount: number;
+    outgoingEdgeCount: number;
+    callCount: number;
+    callerCount: number;
+    childCount: number;
+}
+export interface GraphStats {
+    files: number;
+    nodes: number;
+    edges: number;
+    nodesByKind: Record<string, number>;
+    filesByLanguage: Record<string, number>;
+    dbSizeBytes: number;
+    embeddingCount: number;
+    embeddableNodeCount: number;
+    embeddingsEnabled: boolean;
+    embeddingModel: string;
+    useVecIndex: boolean;
+    semanticEngine: 'cosine' | 'sqlite-vec' | 'orama' | 'pglite' | 'lancedb' | 'qdrant' | 'typesense';
+    vecIndexCount: number;
+    engineFallback: string | null;
+    frameworks: string[];
+    architectureEnabled: boolean;
+    architectureStats?: {
+        packages: number;
+        layers: number;
+        packageDeps: number;
+    };
+}
+export interface TaskContext {
+    task: string;
+    entryPoints: Node[];
+    relatedNodes: Node[];
+    edges: Edge[];
+    codeSnippets: Map<string, string>;
+    summary: string;
+}
+export interface IndexProgress {
+    phase: 'scanning' | 'parsing' | 'storing' | 'resolving' | 'detecting frameworks' | 'embeddings' | 'architecture';
+    current: number;
+    total: number;
+    currentFile?: string;
+    meta?: Record<string, unknown>;
+}
+export interface IndexResult {
+    success: boolean;
+    filesIndexed: number;
+    nodesCreated: number;
+    edgesCreated: number;
+    errors: string[];
+    duration: number;
+}
+export interface SyncResult {
+    added: string[];
+    modified: string[];
+    removed: string[];
+    nodesCreated: number;
+    nodesRemoved: number;
+    errors: string[];
+    duration: number;
+}
+export { KiroGraphError, FileError, ParseError, DatabaseError, ConfigError, } from './errors';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,37 @@
+"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 types_exports = {};
+__export(types_exports, {
+  ConfigError: () => import_errors.ConfigError,
+  DatabaseError: () => import_errors.DatabaseError,
+  FileError: () => import_errors.FileError,
+  KiroGraphError: () => import_errors.KiroGraphError,
+  ParseError: () => import_errors.ParseError
+});
+module.exports = __toCommonJS(types_exports);
+var import_errors = require("./errors");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigError,
+  DatabaseError,
+  FileError,
+  KiroGraphError,
+  ParseError
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Type Definitions\n */\n\nexport type NodeKind =\n  | 'file' | 'module' | 'class' | 'struct' | 'interface' | 'trait' | 'protocol'\n  | 'function' | 'method' | 'property' | 'field' | 'variable' | 'constant'\n  | 'enum' | 'enum_member' | 'type_alias' | 'namespace' | 'parameter'\n  | 'import' | 'export' | 'route' | 'component';\n\nexport type EdgeKind =\n  | 'contains' | 'calls' | 'imports' | 'exports' | 'extends' | 'implements'\n  | 'references' | 'type_of' | 'returns' | 'instantiates' | 'overrides' | 'decorates';\n\nexport type Language =\n  | 'typescript' | 'javascript' | 'tsx' | 'jsx' | 'python' | 'go' | 'rust'\n  | 'java' | 'c' | 'cpp' | 'csharp' | 'php' | 'ruby' | 'swift' | 'kotlin'\n  | 'dart' | 'svelte' | 'pascal' | 'liquid' | 'elixir' | 'unknown';\n\nexport interface Node {\n  id: string;\n  kind: NodeKind;\n  name: string;\n  qualifiedName: string;\n  filePath: string;\n  language: Language;\n  startLine: number;\n  endLine: number;\n  startColumn: number;\n  endColumn: number;\n  docstring?: string;\n  signature?: string;\n  visibility?: 'public' | 'private' | 'protected' | 'internal';\n  isExported?: boolean;\n  isAsync?: boolean;\n  isStatic?: boolean;\n  isAbstract?: boolean;\n  decorators?: string[];\n  typeParameters?: string[];\n  updatedAt: number;\n}\n\nexport interface Edge {\n  source: string;\n  target: string;\n  kind: EdgeKind;\n  metadata?: Record<string, unknown>;\n  line?: number;\n  column?: number;\n}\n\nexport interface FileRecord {\n  path: string;\n  contentHash: string;\n  language: Language;\n  fileSize: number;\n  symbolCount: number;\n  indexedAt: number;\n}\n\nexport interface SearchResult {\n  node: Node;\n  score: number;\n  matchType: 'exact' | 'prefix' | 'fuzzy' | 'semantic';\n}\n\nexport interface SearchOptions {\n  kinds?: NodeKind[];\n  languages?: Language[];\n  limit?: number;\n  minScore?: number;\n}\n\nexport interface Subgraph {\n  nodes: Node[];\n  edges: Edge[];\n  entryPoints: string[];\n}\n\nexport interface NodeContext {\n  node: Node;\n  ancestors: Node[];\n  children: Node[];\n  callers: Node[];\n  callees: Node[];\n}\n\nexport interface NodeMetrics {\n  incomingEdgeCount: number;\n  outgoingEdgeCount: number;\n  callCount: number;\n  callerCount: number;\n  childCount: number;\n}\n\nexport interface GraphStats {\n  files: number;\n  nodes: number;\n  edges: number;\n  nodesByKind: Record<string, number>;\n  filesByLanguage: Record<string, number>;\n  dbSizeBytes: number;\n  embeddingCount: number;\n  embeddableNodeCount: number;\n  embeddingsEnabled: boolean;\n  embeddingModel: string;\n  useVecIndex: boolean;\n  semanticEngine: 'cosine' | 'sqlite-vec' | 'orama' | 'pglite' | 'lancedb' | 'qdrant' | 'typesense';\n  vecIndexCount: number;\n  engineFallback: string | null;\n  frameworks: string[];\n  architectureEnabled: boolean;\n  architectureStats?: { packages: number; layers: number; packageDeps: number };\n}\n\nexport interface TaskContext {\n  task: string;\n  entryPoints: Node[];\n  relatedNodes: Node[];\n  edges: Edge[];\n  codeSnippets: Map<string, string>;\n  summary: string;\n}\n\nexport interface IndexProgress {\n  phase: 'scanning' | 'parsing' | 'storing' | 'resolving' | 'detecting frameworks' | 'embeddings' | 'architecture' | 'retrying';\n  current: number;\n  total: number;\n  currentFile?: string;\n  meta?: Record<string, unknown>;\n}\n\nexport interface IndexResult {\n  success: boolean;\n  filesIndexed: number;\n  nodesCreated: number;\n  edgesCreated: number;\n  errors: string[];\n  duration: number;\n}\n\nexport interface SyncResult {\n  added: string[];\n  modified: string[];\n  removed: string[];\n  nodesCreated: number;\n  nodesUpdated: number;\n  nodesRemoved: number;\n  edgesCreated: number;\n  edgesRemoved: number;\n  filesScanned: number;\n  errors: string[];\n  duration: number;\n}\n\n// \u2500\u2500 Error Classes (re-exported from src/errors.ts for backward compatibility) \u2500\u2500\n\nexport {\n  KiroGraphError,\n  FileError,\n  ParseError,\n  DatabaseError,\n  ConfigError,\n} from './errors';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6JA,oBAMO;",
+  "names": []
+}

package/dist/utils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * KiroGraph Utility Module
+ *
+ * Shared utilities: concurrency, batching, rate limiting, memory monitoring,
+ * security path validation, and misc helpers.
+ */
+export declare class Mutex {
+    private queue;
+    private _locked;
+    acquire(): Promise<() => void>;
+    withLock<T>(fn: () => Promise<T>): Promise<T>;
+    isLocked(): boolean;
+    private _release;
+}
+export declare class FileLock {
+    private readonly lockPath;
+    static readonly STALE_TIMEOUT_MS = 120000;
+    constructor(lockPath: string);
+    acquire(): Promise<() => void>;
+    withLock<T>(fn: () => T): T;
+    withLockAsync<T>(fn: () => Promise<T>): Promise<T>;
+    private _release;
+}
+export declare function processInBatches<T, R>(items: T[], batchSize: number, fn: (batch: T[]) => Promise<R[]>): Promise<R[]>;
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delayMs: number): T;
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, intervalMs: number): T;
+export declare class MemoryMonitor {
+    private readonly thresholdBytes;
+    private readonly intervalMs;
+    private timer;
+    private peakBytes;
+    constructor(opts: {
+        thresholdMb: number;
+        intervalMs: number;
+    });
+    start(): void;
+    stop(): void;
+    /** Returns peak heap usage in bytes. */
+    getPeakUsage(): number;
+}
+/** Resolve and validate that filePath is within root. Returns null if not. */
+export declare function validatePathWithinRoot(filePath: string, root: string): string | null;
+/** Throw if the given path is a sensitive system directory. */
+export declare function validateProjectPath(projectRoot: string): void;
+/** Returns true if filePath is within root (string-based, no symlink resolution). */
+export declare function isPathWithinRoot(filePath: string, root: string): boolean;
+/** Returns true if filePath is within root, resolving symlinks (symlink-safe). */
+export declare function isPathWithinRootReal(filePath: string, root: string): boolean;
+export declare function clamp(value: number, min: number, max: number): number;
+export declare function normalizePath(p: string): string;
+export declare function safeJsonParse<T>(json: string, fallback: T): T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAAS;IAElB,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAc9B,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASnD,QAAQ,IAAI,OAAO;IAInB,OAAO,CAAC,QAAQ;CAKjB;AAID,qBAAa,QAAQ;IAGP,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,UAAW;gBAEd,QAAQ,EAAE,MAAM;IAEvC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IA4BpC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAWrB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASxD,OAAO,CAAC,QAAQ;CAOjB;AAID,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EACzC,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC,CAQd;AAID,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAS7F;AAID,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,CAShG;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,SAAS,CAAK;gBAEV,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAK7D,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAOZ,wCAAwC;IACxC,YAAY,IAAI,MAAM;CAGvB;AAID,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKpF;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAM7D;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIxE;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ5E;AAID,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAM7D"}

package/dist/utils.js

@@ -0,0 +1,254 @@
+"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 utils_exports = {};
+__export(utils_exports, {
+  FileLock: () => FileLock,
+  MemoryMonitor: () => MemoryMonitor,
+  Mutex: () => Mutex,
+  clamp: () => clamp,
+  debounce: () => debounce,
+  isPathWithinRoot: () => isPathWithinRoot,
+  isPathWithinRootReal: () => isPathWithinRootReal,
+  normalizePath: () => normalizePath,
+  processInBatches: () => processInBatches,
+  safeJsonParse: () => safeJsonParse,
+  throttle: () => throttle,
+  validatePathWithinRoot: () => validatePathWithinRoot,
+  validateProjectPath: () => validateProjectPath
+});
+module.exports = __toCommonJS(utils_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var import_errors = require("./errors");
+class Mutex {
+  constructor() {
+    this.queue = [];
+    this._locked = false;
+  }
+  async acquire() {
+    return new Promise((resolve) => {
+      const tryAcquire = () => {
+        if (!this._locked) {
+          this._locked = true;
+          resolve(() => this._release());
+        } else {
+          this.queue.push(tryAcquire);
+        }
+      };
+      tryAcquire();
+    });
+  }
+  async withLock(fn) {
+    const release = await this.acquire();
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  }
+  isLocked() {
+    return this._locked;
+  }
+  _release() {
+    this._locked = false;
+    const next = this.queue.shift();
+    if (next) next();
+  }
+}
+class FileLock {
+  // 2 minutes
+  constructor(lockPath) {
+    this.lockPath = lockPath;
+  }
+  static {
+    this.STALE_TIMEOUT_MS = 12e4;
+  }
+  async acquire() {
+    const deadline = Date.now() + FileLock.STALE_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+      try {
+        const fd = fs.openSync(this.lockPath, "wx");
+        fs.writeSync(fd, String(process.pid));
+        fs.closeSync(fd);
+        return () => this._release();
+      } catch {
+        try {
+          const stat = fs.statSync(this.lockPath);
+          if (Date.now() - stat.mtimeMs > FileLock.STALE_TIMEOUT_MS) {
+            fs.unlinkSync(this.lockPath);
+            continue;
+          }
+        } catch {
+          continue;
+        }
+        await new Promise((r) => setTimeout(r, 50));
+      }
+    }
+    throw new Error(`FileLock: timed out waiting for lock at ${this.lockPath}`);
+  }
+  withLock(fn) {
+    const fd = fs.openSync(this.lockPath, "wx");
+    fs.writeSync(fd, String(process.pid));
+    fs.closeSync(fd);
+    try {
+      return fn();
+    } finally {
+      this._release();
+    }
+  }
+  async withLockAsync(fn) {
+    const release = await this.acquire();
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  }
+  _release() {
+    try {
+      fs.unlinkSync(this.lockPath);
+    } catch {
+    }
+  }
+}
+async function processInBatches(items, batchSize, fn) {
+  const results = [];
+  for (let i = 0; i < items.length; i += batchSize) {
+    const batch = items.slice(i, i + batchSize);
+    const batchResults = await fn(batch);
+    results.push(...batchResults);
+  }
+  return results;
+}
+function debounce(fn, delayMs) {
+  let timer = null;
+  return function(...args) {
+    if (timer !== null) clearTimeout(timer);
+    timer = setTimeout(() => {
+      timer = null;
+      fn.apply(this, args);
+    }, delayMs);
+  };
+}
+function throttle(fn, intervalMs) {
+  let lastCall = 0;
+  return function(...args) {
+    const now = Date.now();
+    if (now - lastCall >= intervalMs) {
+      lastCall = now;
+      return fn.apply(this, args);
+    }
+  };
+}
+class MemoryMonitor {
+  constructor(opts) {
+    this.timer = null;
+    this.peakBytes = 0;
+    this.thresholdBytes = opts.thresholdMb * 1024 * 1024;
+    this.intervalMs = opts.intervalMs;
+  }
+  start() {
+    if (this.timer !== null) return;
+    this.timer = setInterval(() => {
+      const used = process.memoryUsage().heapUsed;
+      if (used > this.peakBytes) this.peakBytes = used;
+      if (used > this.thresholdBytes) {
+        (0, import_errors.logWarn)(`MemoryMonitor: heap usage ${(used / 1024 / 1024).toFixed(1)} MB exceeds threshold ${(this.thresholdBytes / 1024 / 1024).toFixed(1)} MB`);
+      }
+    }, this.intervalMs);
+    if (this.timer.unref) this.timer.unref();
+  }
+  stop() {
+    if (this.timer !== null) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+  /** Returns peak heap usage in bytes. */
+  getPeakUsage() {
+    return this.peakBytes;
+  }
+}
+function validatePathWithinRoot(filePath, root) {
+  const resolved = path.resolve(filePath);
+  const resolvedRoot = path.resolve(root);
+  if (!resolved.startsWith(resolvedRoot + path.sep) && resolved !== resolvedRoot) return null;
+  return resolved;
+}
+function validateProjectPath(projectRoot) {
+  const SENSITIVE_DIRS = /* @__PURE__ */ new Set(["/", "/etc", "/usr", "/var", "/bin", "/sbin", "/lib", "/lib64", "/proc", "/sys", "/dev", "/boot"]);
+  const resolved = path.resolve(projectRoot);
+  if (SENSITIVE_DIRS.has(resolved)) {
+    throw new Error(`Refusing to initialize KiroGraph in sensitive directory: ${resolved}`);
+  }
+}
+function isPathWithinRoot(filePath, root) {
+  const resolved = path.resolve(filePath);
+  const resolvedRoot = path.resolve(root);
+  return resolved === resolvedRoot || resolved.startsWith(resolvedRoot + path.sep);
+}
+function isPathWithinRootReal(filePath, root) {
+  try {
+    const real = fs.realpathSync(filePath);
+    const realRoot = fs.realpathSync(root);
+    return real === realRoot || real.startsWith(realRoot + path.sep);
+  } catch {
+    return false;
+  }
+}
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function normalizePath(p) {
+  return p.split(path.sep).join("/");
+}
+function safeJsonParse(json, fallback) {
+  try {
+    return JSON.parse(json);
+  } catch {
+    return fallback;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FileLock,
+  MemoryMonitor,
+  Mutex,
+  clamp,
+  debounce,
+  isPathWithinRoot,
+  isPathWithinRootReal,
+  normalizePath,
+  processInBatches,
+  safeJsonParse,
+  throttle,
+  validatePathWithinRoot,
+  validateProjectPath
+});
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/utils.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Utility Module\n *\n * Shared utilities: concurrency, batching, rate limiting, memory monitoring,\n * security path validation, and misc helpers.\n */\n\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { logWarn } from './errors';\n\n// \u2500\u2500 Mutex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 class Mutex {\n  private queue: Array<() => void> = [];\n  private _locked = false;\n\n  async acquire(): Promise<() => void> {\n    return new Promise(resolve => {\n      const tryAcquire = () => {\n        if (!this._locked) {\n          this._locked = true;\n          resolve(() => this._release());\n        } else {\n          this.queue.push(tryAcquire);\n        }\n      };\n      tryAcquire();\n    });\n  }\n\n  async withLock<T>(fn: () => Promise<T>): Promise<T> {\n    const release = await this.acquire();\n    try {\n      return await fn();\n    } finally {\n      release();\n    }\n  }\n\n  isLocked(): boolean {\n    return this._locked;\n  }\n\n  private _release(): void {\n    this._locked = false;\n    const next = this.queue.shift();\n    if (next) next();\n  }\n}\n\n// \u2500\u2500 FileLock \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 class FileLock {\n  static readonly STALE_TIMEOUT_MS = 120_000; // 2 minutes\n\n  constructor(private readonly lockPath: string) {}\n\n  async acquire(): Promise<() => void> {\n    const deadline = Date.now() + FileLock.STALE_TIMEOUT_MS;\n    while (Date.now() < deadline) {\n      try {\n        // Atomic create: fails if file already exists\n        const fd = fs.openSync(this.lockPath, 'wx');\n        fs.writeSync(fd, String(process.pid));\n        fs.closeSync(fd);\n        return () => this._release();\n      } catch {\n        // Check for stale lock\n        try {\n          const stat = fs.statSync(this.lockPath);\n          if (Date.now() - stat.mtimeMs > FileLock.STALE_TIMEOUT_MS) {\n            fs.unlinkSync(this.lockPath);\n            continue;\n          }\n        } catch {\n          // Lock file disappeared between attempts \u2014 retry\n          continue;\n        }\n        // Wait a bit before retrying\n        await new Promise(r => setTimeout(r, 50));\n      }\n    }\n    throw new Error(`FileLock: timed out waiting for lock at ${this.lockPath}`);\n  }\n\n  withLock<T>(fn: () => T): T {\n    const fd = fs.openSync(this.lockPath, 'wx');\n    fs.writeSync(fd, String(process.pid));\n    fs.closeSync(fd);\n    try {\n      return fn();\n    } finally {\n      this._release();\n    }\n  }\n\n  async withLockAsync<T>(fn: () => Promise<T>): Promise<T> {\n    const release = await this.acquire();\n    try {\n      return await fn();\n    } finally {\n      release();\n    }\n  }\n\n  private _release(): void {\n    try {\n      fs.unlinkSync(this.lockPath);\n    } catch {\n      // Already removed \u2014 ignore\n    }\n  }\n}\n\n// \u2500\u2500 processInBatches \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 processInBatches<T, R>(\n  items: T[],\n  batchSize: number,\n  fn: (batch: T[]) => Promise<R[]>\n): Promise<R[]> {\n  const results: R[] = [];\n  for (let i = 0; i < items.length; i += batchSize) {\n    const batch = items.slice(i, i + batchSize);\n    const batchResults = await fn(batch);\n    results.push(...batchResults);\n  }\n  return results;\n}\n\n// \u2500\u2500 debounce \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 debounce<T extends (...args: unknown[]) => unknown>(fn: T, delayMs: number): T {\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  return function (this: unknown, ...args: unknown[]) {\n    if (timer !== null) clearTimeout(timer);\n    timer = setTimeout(() => {\n      timer = null;\n      fn.apply(this, args);\n    }, delayMs);\n  } as T;\n}\n\n// \u2500\u2500 throttle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 throttle<T extends (...args: unknown[]) => unknown>(fn: T, intervalMs: number): T {\n  let lastCall = 0;\n  return function (this: unknown, ...args: unknown[]) {\n    const now = Date.now();\n    if (now - lastCall >= intervalMs) {\n      lastCall = now;\n      return fn.apply(this, args);\n    }\n  } as T;\n}\n\n// \u2500\u2500 MemoryMonitor \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 class MemoryMonitor {\n  private readonly thresholdBytes: number;\n  private readonly intervalMs: number;\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private peakBytes = 0;\n\n  constructor(opts: { thresholdMb: number; intervalMs: number }) {\n    this.thresholdBytes = opts.thresholdMb * 1024 * 1024;\n    this.intervalMs = opts.intervalMs;\n  }\n\n  start(): void {\n    if (this.timer !== null) return;\n    this.timer = setInterval(() => {\n      const used = process.memoryUsage().heapUsed;\n      if (used > this.peakBytes) this.peakBytes = used;\n      if (used > this.thresholdBytes) {\n        logWarn(`MemoryMonitor: heap usage ${(used / 1024 / 1024).toFixed(1)} MB exceeds threshold ${(this.thresholdBytes / 1024 / 1024).toFixed(1)} MB`);\n      }\n    }, this.intervalMs);\n    // Allow the process to exit even if the monitor is running\n    if (this.timer.unref) this.timer.unref();\n  }\n\n  stop(): void {\n    if (this.timer !== null) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n  }\n\n  /** Returns peak heap usage in bytes. */\n  getPeakUsage(): number {\n    return this.peakBytes;\n  }\n}\n\n// \u2500\u2500 Security utils (moved from src/index.ts) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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/** Resolve and validate that filePath is within root. Returns null if not. */\nexport function validatePathWithinRoot(filePath: string, root: string): string | null {\n  const resolved = path.resolve(filePath);\n  const resolvedRoot = path.resolve(root);\n  if (!resolved.startsWith(resolvedRoot + path.sep) && resolved !== resolvedRoot) return null;\n  return resolved;\n}\n\n/** Throw if the given path is a sensitive system directory. */\nexport function validateProjectPath(projectRoot: string): void {\n  const SENSITIVE_DIRS = new Set(['/', '/etc', '/usr', '/var', '/bin', '/sbin', '/lib', '/lib64', '/proc', '/sys', '/dev', '/boot']);\n  const resolved = path.resolve(projectRoot);\n  if (SENSITIVE_DIRS.has(resolved)) {\n    throw new Error(`Refusing to initialize KiroGraph in sensitive directory: ${resolved}`);\n  }\n}\n\n/** Returns true if filePath is within root (string-based, no symlink resolution). */\nexport function isPathWithinRoot(filePath: string, root: string): boolean {\n  const resolved = path.resolve(filePath);\n  const resolvedRoot = path.resolve(root);\n  return resolved === resolvedRoot || resolved.startsWith(resolvedRoot + path.sep);\n}\n\n/** Returns true if filePath is within root, resolving symlinks (symlink-safe). */\nexport function isPathWithinRootReal(filePath: string, root: string): boolean {\n  try {\n    const real = fs.realpathSync(filePath);\n    const realRoot = fs.realpathSync(root);\n    return real === realRoot || real.startsWith(realRoot + path.sep);\n  } catch {\n    return false;\n  }\n}\n\n// \u2500\u2500 Misc 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\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\nexport function normalizePath(p: string): string {\n  return p.split(path.sep).join('/');\n}\n\nexport function safeJsonParse<T>(json: string, fallback: T): T {\n  try {\n    return JSON.parse(json) as T;\n  } catch {\n    return fallback;\n  }\n}\n\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/vectors/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * KiroGraph Vector Manager
+ *
+ * Semantic search using nomic-ai/nomic-embed-text-v1.5 via @xenova/transformers.
+ * Mirrors CodeGraph src/vectors/ (embedder.ts + manager.ts) adapted for KiroGraph:
+ *   - Cache dir: ~/.kirograph/models/ (not ~/.codegraph/models/)
+ *   - Embeddings stored in the `vectors` SQLite table
+ *   - Cosine similarity search done in-process by default (no extra deps)
+ *   - ANN search via sqlite-vec opt-in: set config.useVecIndex = true
+ *     (requires `npm install better-sqlite3 sqlite-vec`)
+ *   - Disabled by default; opt-in via config.enableEmbeddings = true
+ */
+import type { KiroGraphConfig } from '../config';
+import type { Node } from '../types';
+import type { GraphDatabase } from '../db/database';
+export declare class VectorManager {
+    private readonly db;
+    private readonly config;
+    private readonly projectRoot?;
+    private pipeline;
+    private _initialized;
+    private vecIndex;
+    private oramaIndex;
+    private pgliteIndex;
+    private lancedbIndex;
+    private qdrantIndex;
+    private typesenseIndex;
+    private _engineFallback;
+    constructor(db: GraphDatabase, config: KiroGraphConfig, projectRoot?: string | undefined);
+    isInitialized(): boolean;
+    /** Non-null when the configured engine failed to load and cosine is being used instead. */
+    getEngineFallback(): string | null;
+    /**
+     * Load the embedding model. No-op when embeddings are disabled.
+     * Fails silently so callers can continue without semantic search.
+     * When config.useVecIndex is true, also initializes the sqlite-vec ANN index.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Embed a single node and persist to the vectors table.
+     * Skips silently when disabled; logs on failure without throwing.
+     */
+    embedNode(node: Node): Promise<void>;
+    /** Number of entries currently in the active ANN/hybrid index (0 when not in use). */
+    vecIndexCount(): Promise<number>;
+    /**
+     * Remove embeddings for the given node IDs from the active index.
+     * For cosine the `vectors` SQLite table is cleaned up automatically via FK cascade
+     * when nodes are deleted. For sqlite-vec, orama, and pglite the engine itself is
+     * the sole store of record, so we delete from it explicitly here.
+     */
+    deleteEmbeddings(nodeIds: string[]): Promise<void>;
+    /**
+     * Embed all eligible nodes in the database that don't yet have embeddings.
+     * Processes in batches of BATCH_SIZE.
+     */
+    embedAll(onProgress?: (current: number, total: number) => void): Promise<number>;
+    /**
+     * Semantic search: embed the query and return top-N nodes by similarity.
+     *
+     * When sqlite-vec is available (useVecIndex: true), delegates ANN search to
+     * VecIndex (fast, sub-linear). Otherwise falls back to in-process cosine
+     * similarity over all stored embeddings (linear scan, no extra deps).
+     *
+     * Returns empty array when not initialized.
+     */
+    search(query: string, topN?: number): Promise<Node[]>;
+    /** Release engine resources (e.g. kill Qdrant child process). */
+    close(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAuEpD,qBAAa,aAAa;IAYtB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAb/B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAuB;gBAG3B,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,eAAe,EACvB,WAAW,CAAC,EAAE,MAAM,YAAA;IAGvC,aAAa,IAAI,OAAO;IAIxB,2FAA2F;IAC3F,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+HjC;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1C,sFAAsF;IAChF,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAUtC;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD;;;OAGG;IACG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAyEtF;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAmDvD,iEAAiE;IACjE,KAAK,IAAI,IAAI;CAId"}