kirograph 0.12.1

package/dist/vectors/vec-index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * KiroGraph sqlite-vec ANN Index
+ *
+ * Opt-in ANN index backed by sqlite-vec (the successor to sqlite-vss).
+ * Uses better-sqlite3 to load the sqlite-vec extension into a dedicated
+ * .kirograph/vec.db file, keeping it separate from the main node-sqlite3-wasm
+ * database to avoid WAL-mode conflicts.
+ *
+ * Required optional dependencies (not installed by default):
+ *   npm install better-sqlite3 sqlite-vec
+ *
+ * If either package is missing, VecIndex silently marks itself unavailable
+ * and VectorManager falls back to in-process cosine search.
+ */
+export declare class VecIndex {
+    private readonly kirographDir;
+    private db;
+    private _available;
+    private dim;
+    constructor(kirographDir: string, dim?: number);
+    isAvailable(): boolean;
+    /**
+     * Load better-sqlite3 + sqlite-vec and create the vec schema.
+     * No-op and silent when optional deps are missing.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Insert or update the embedding for a node.
+     * We let vec_nodes auto-assign its rowid (avoiding the SQLITE_INTEGER type
+     * mismatch that occurs when passing explicit JS number rowids to vec0).
+     * The auto-assigned rowid is stored in vec_nodes_map for later lookup.
+     * vec0 tables don't support UPDATE, so updates are a DELETE + INSERT pair.
+     */
+    upsert(nodeId: string, embedding: Float32Array): void;
+    /**
+     * Remove a node's embedding from the index.
+     * Called explicitly when a node is deleted; stale entries are also filtered
+     * harmlessly in search() since GraphDatabase.getNode() will return null.
+     */
+    delete(nodeId: string): void;
+    /**
+     * ANN search: returns node IDs ordered by ascending distance.
+     * Uses sqlite-vec KNN syntax: `WHERE embedding MATCH ? ORDER BY distance LIMIT ?`
+     */
+    search(queryVec: Float32Array, topN?: number): string[];
+    /** Return all node IDs currently stored in the index. */
+    getEmbeddedNodeIds(): string[];
+    /** Returns the number of entries currently in the vec index. */
+    count(): number;
+    close(): void;
+}
+//# sourceMappingURL=vec-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vec-index.d.ts","sourceRoot":"","sources":["../../src/vectors/vec-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,qBAAa,QAAQ;IAMjB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAS;gBAGD,YAAY,EAAE,MAAM,EACrC,GAAG,SAAc;IAKnB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DjC;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAyBrD;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB5B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE;IAoBnD,yDAAyD;IACzD,kBAAkB,IAAI,MAAM,EAAE;IAU9B,gEAAgE;IAChE,KAAK,IAAI,MAAM;IAUf,KAAK,IAAI,IAAI;CAOd"}

package/dist/vectors/vec-index.js

@@ -0,0 +1,198 @@
+"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 vec_index_exports = {};
+__export(vec_index_exports, {
+  VecIndex: () => VecIndex
+});
+module.exports = __toCommonJS(vec_index_exports);
+var path = __toESM(require("path"));
+var import_errors = require("../errors");
+const DEFAULT_DIM = 768;
+class VecIndex {
+  constructor(kirographDir, dim = DEFAULT_DIM) {
+    this.kirographDir = kirographDir;
+    this.db = null;
+    this._available = false;
+    this.dim = dim;
+  }
+  isAvailable() {
+    return this._available;
+  }
+  /**
+   * Load better-sqlite3 + sqlite-vec and create the vec schema.
+   * No-op and silent when optional deps are missing.
+   */
+  async initialize() {
+    if (this._available) return;
+    const dbPath = path.join(this.kirographDir, "vec.db");
+    let BetterSQLite;
+    let sqliteVec;
+    try {
+      BetterSQLite = require("better-sqlite3");
+    } catch {
+      (0, import_errors.logDebug)("VecIndex: better-sqlite3 not installed \u2014 sqlite-vec unavailable");
+      return;
+    }
+    try {
+      sqliteVec = require("sqlite-vec");
+    } catch {
+      (0, import_errors.logDebug)("VecIndex: sqlite-vec not installed \u2014 falling back to in-process cosine search");
+      return;
+    }
+    try {
+      this.db = new BetterSQLite(dbPath);
+      sqliteVec.load(this.db);
+      const mapInfo = this.db.pragma("table_info(vec_nodes_map)");
+      const hasVecRowid = mapInfo.some((col) => col.name === "vec_rowid");
+      if (mapInfo.length > 0 && !hasVecRowid) {
+        (0, import_errors.logDebug)("VecIndex: stale schema detected, rebuilding vec.db");
+        this.db.exec(`
+          DROP TABLE IF EXISTS vec_nodes_map;
+          DROP TABLE IF EXISTS vec_nodes;
+        `);
+      }
+      this.db.exec(`
+        CREATE VIRTUAL TABLE IF NOT EXISTS vec_nodes
+          USING vec0(embedding float[${this.dim}]);
+        CREATE TABLE IF NOT EXISTS vec_nodes_map (
+          node_id TEXT PRIMARY KEY NOT NULL,
+          vec_rowid INTEGER NOT NULL
+        );
+      `);
+      this._available = true;
+      (0, import_errors.logDebug)("VecIndex: initialized", { dbPath, dim: this.dim });
+    } catch (err) {
+      (0, import_errors.logError)("VecIndex: initialization failed", { error: String(err) });
+      this._available = false;
+      if (this.db) {
+        try {
+          this.db.close();
+        } catch {
+        }
+        this.db = null;
+      }
+    }
+  }
+  /**
+   * Insert or update the embedding for a node.
+   * We let vec_nodes auto-assign its rowid (avoiding the SQLITE_INTEGER type
+   * mismatch that occurs when passing explicit JS number rowids to vec0).
+   * The auto-assigned rowid is stored in vec_nodes_map for later lookup.
+   * vec0 tables don't support UPDATE, so updates are a DELETE + INSERT pair.
+   */
+  upsert(nodeId, embedding) {
+    if (!this._available || !this.db) return;
+    try {
+      const existing = this.db.prepare("SELECT vec_rowid FROM vec_nodes_map WHERE node_id = ?").get(nodeId);
+      if (existing) {
+        this.db.prepare("DELETE FROM vec_nodes WHERE rowid = ?").run(existing.vec_rowid);
+        const result = this.db.prepare("INSERT INTO vec_nodes(embedding) VALUES (?)").run(embedding);
+        this.db.prepare("UPDATE vec_nodes_map SET vec_rowid = ? WHERE node_id = ?").run(result.lastInsertRowid, nodeId);
+      } else {
+        const result = this.db.prepare("INSERT INTO vec_nodes(embedding) VALUES (?)").run(embedding);
+        this.db.prepare("INSERT INTO vec_nodes_map(node_id, vec_rowid) VALUES (?, ?)").run(nodeId, result.lastInsertRowid);
+      }
+    } catch (err) {
+      (0, import_errors.logWarn)("VecIndex: upsert failed", { nodeId, error: String(err) });
+    }
+  }
+  /**
+   * Remove a node's embedding from the index.
+   * Called explicitly when a node is deleted; stale entries are also filtered
+   * harmlessly in search() since GraphDatabase.getNode() will return null.
+   */
+  delete(nodeId) {
+    if (!this._available || !this.db) return;
+    try {
+      const existing = this.db.prepare("SELECT vec_rowid FROM vec_nodes_map WHERE node_id = ?").get(nodeId);
+      if (existing) {
+        this.db.prepare("DELETE FROM vec_nodes WHERE rowid = ?").run(existing.vec_rowid);
+        this.db.prepare("DELETE FROM vec_nodes_map WHERE node_id = ?").run(nodeId);
+      }
+    } catch (err) {
+      (0, import_errors.logWarn)("VecIndex: delete failed", { nodeId, error: String(err) });
+    }
+  }
+  /**
+   * ANN search: returns node IDs ordered by ascending distance.
+   * Uses sqlite-vec KNN syntax: `WHERE embedding MATCH ? ORDER BY distance LIMIT ?`
+   */
+  search(queryVec, topN = 10) {
+    if (!this._available || !this.db) return [];
+    try {
+      const rows = this.db.prepare(`
+        SELECT m.node_id, v.distance
+        FROM vec_nodes v
+        JOIN vec_nodes_map m ON m.vec_rowid = v.rowid
+        WHERE v.embedding MATCH ?
+          AND k = ?
+        ORDER BY v.distance
+      `).all(queryVec, topN);
+      return rows.map((r) => r.node_id);
+    } catch (err) {
+      (0, import_errors.logWarn)("VecIndex: search failed", { error: String(err) });
+      return [];
+    }
+  }
+  /** Return all node IDs currently stored in the index. */
+  getEmbeddedNodeIds() {
+    if (!this._available || !this.db) return [];
+    try {
+      const rows = this.db.prepare("SELECT node_id FROM vec_nodes_map").all();
+      return rows.map((r) => r.node_id);
+    } catch {
+      return [];
+    }
+  }
+  /** Returns the number of entries currently in the vec index. */
+  count() {
+    if (!this._available || !this.db) return 0;
+    try {
+      const row = this.db.prepare("SELECT COUNT(*) as c FROM vec_nodes_map").get();
+      return row ? row.c : 0;
+    } catch {
+      return 0;
+    }
+  }
+  close() {
+    if (this.db) {
+      try {
+        this.db.close();
+      } catch {
+      }
+      this.db = null;
+      this._available = false;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VecIndex
+});
+//# sourceMappingURL=vec-index.js.map

package/dist/vectors/vec-index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/vectors/vec-index.ts"],
+  "sourcesContent": ["/**\n * KiroGraph sqlite-vec ANN Index\n *\n * Opt-in ANN index backed by sqlite-vec (the successor to sqlite-vss).\n * Uses better-sqlite3 to load the sqlite-vec extension into a dedicated\n * .kirograph/vec.db file, keeping it separate from the main node-sqlite3-wasm\n * database to avoid WAL-mode conflicts.\n *\n * Required optional dependencies (not installed by default):\n *   npm install better-sqlite3 sqlite-vec\n *\n * If either package is missing, VecIndex silently marks itself unavailable\n * and VectorManager falls back to in-process cosine search.\n */\n\nimport * as path from 'path';\nimport { logDebug, logWarn, logError } 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 DEFAULT_DIM = 768;\n\n// \u2500\u2500 VecIndex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 VecIndex {\n  private db: any = null;\n  private _available = false;\n  private dim: number;\n\n  constructor(\n    private readonly kirographDir: string,\n    dim = DEFAULT_DIM,\n  ) {\n    this.dim = dim;\n  }\n\n  isAvailable(): boolean {\n    return this._available;\n  }\n\n  /**\n   * Load better-sqlite3 + sqlite-vec and create the vec schema.\n   * No-op and silent when optional deps are missing.\n   */\n  async initialize(): Promise<void> {\n    if (this._available) return;\n\n    const dbPath = path.join(this.kirographDir, 'vec.db');\n\n    let BetterSQLite: any;\n    let sqliteVec: any;\n\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      BetterSQLite = require('better-sqlite3');\n    } catch {\n      logDebug('VecIndex: better-sqlite3 not installed \u2014 sqlite-vec unavailable');\n      return;\n    }\n\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      sqliteVec = require('sqlite-vec');\n    } catch {\n      logDebug('VecIndex: sqlite-vec not installed \u2014 falling back to in-process cosine search');\n      return;\n    }\n\n    try {\n      this.db = new BetterSQLite(dbPath);\n      sqliteVec.load(this.db);\n\n      // Drop stale schema if vec_nodes_map is missing the vec_rowid column\n      // (legacy schema used rowid AUTOINCREMENT + node_id; new schema uses node_id PK + vec_rowid)\n      const mapInfo: any[] = this.db.pragma('table_info(vec_nodes_map)');\n      const hasVecRowid = mapInfo.some((col: any) => col.name === 'vec_rowid');\n      if (mapInfo.length > 0 && !hasVecRowid) {\n        logDebug('VecIndex: stale schema detected, rebuilding vec.db');\n        this.db.exec(`\n          DROP TABLE IF EXISTS vec_nodes_map;\n          DROP TABLE IF EXISTS vec_nodes;\n        `);\n      }\n\n      this.db.exec(`\n        CREATE VIRTUAL TABLE IF NOT EXISTS vec_nodes\n          USING vec0(embedding float[${this.dim}]);\n        CREATE TABLE IF NOT EXISTS vec_nodes_map (\n          node_id TEXT PRIMARY KEY NOT NULL,\n          vec_rowid INTEGER NOT NULL\n        );\n      `);\n\n      this._available = true;\n      logDebug('VecIndex: initialized', { dbPath, dim: this.dim });\n    } catch (err) {\n      logError('VecIndex: initialization failed', { error: String(err) });\n      this._available = false;\n      if (this.db) {\n        try { this.db.close(); } catch { /* ignore */ }\n        this.db = null;\n      }\n    }\n  }\n\n  /**\n   * Insert or update the embedding for a node.\n   * We let vec_nodes auto-assign its rowid (avoiding the SQLITE_INTEGER type\n   * mismatch that occurs when passing explicit JS number rowids to vec0).\n   * The auto-assigned rowid is stored in vec_nodes_map for later lookup.\n   * vec0 tables don't support UPDATE, so updates are a DELETE + INSERT pair.\n   */\n  upsert(nodeId: string, embedding: Float32Array): void {\n    if (!this._available || !this.db) return;\n\n    try {\n      const existing = this.db\n        .prepare('SELECT vec_rowid FROM vec_nodes_map WHERE node_id = ?')\n        .get(nodeId) as { vec_rowid: number } | undefined;\n\n      if (existing) {\n        // Remove old vector, re-insert with a fresh auto-assigned rowid\n        this.db.prepare('DELETE FROM vec_nodes WHERE rowid = ?').run(existing.vec_rowid);\n        const result = this.db.prepare('INSERT INTO vec_nodes(embedding) VALUES (?)').run(embedding);\n        this.db.prepare('UPDATE vec_nodes_map SET vec_rowid = ? WHERE node_id = ?')\n          .run(result.lastInsertRowid, nodeId);\n      } else {\n        // First time: insert vector, then record the rowid sqlite-vec chose\n        const result = this.db.prepare('INSERT INTO vec_nodes(embedding) VALUES (?)').run(embedding);\n        this.db.prepare('INSERT INTO vec_nodes_map(node_id, vec_rowid) VALUES (?, ?)')\n          .run(nodeId, result.lastInsertRowid);\n      }\n    } catch (err) {\n      logWarn('VecIndex: upsert failed', { nodeId, error: String(err) });\n    }\n  }\n\n  /**\n   * Remove a node's embedding from the index.\n   * Called explicitly when a node is deleted; stale entries are also filtered\n   * harmlessly in search() since GraphDatabase.getNode() will return null.\n   */\n  delete(nodeId: string): void {\n    if (!this._available || !this.db) return;\n\n    try {\n      const existing = this.db\n        .prepare('SELECT vec_rowid FROM vec_nodes_map WHERE node_id = ?')\n        .get(nodeId) as { vec_rowid: number } | undefined;\n\n      if (existing) {\n        this.db.prepare('DELETE FROM vec_nodes WHERE rowid = ?').run(existing.vec_rowid);\n        this.db.prepare('DELETE FROM vec_nodes_map WHERE node_id = ?').run(nodeId);\n      }\n    } catch (err) {\n      logWarn('VecIndex: delete failed', { nodeId, error: String(err) });\n    }\n  }\n\n  /**\n   * ANN search: returns node IDs ordered by ascending distance.\n   * Uses sqlite-vec KNN syntax: `WHERE embedding MATCH ? ORDER BY distance LIMIT ?`\n   */\n  search(queryVec: Float32Array, topN = 10): string[] {\n    if (!this._available || !this.db) return [];\n\n    try {\n      const rows = this.db.prepare(`\n        SELECT m.node_id, v.distance\n        FROM vec_nodes v\n        JOIN vec_nodes_map m ON m.vec_rowid = v.rowid\n        WHERE v.embedding MATCH ?\n          AND k = ?\n        ORDER BY v.distance\n      `).all(queryVec, topN);\n\n      return rows.map((r: any) => r.node_id as string);\n    } catch (err) {\n      logWarn('VecIndex: search failed', { error: String(err) });\n      return [];\n    }\n  }\n\n  /** Return all node IDs currently stored in the index. */\n  getEmbeddedNodeIds(): string[] {\n    if (!this._available || !this.db) return [];\n    try {\n      const rows = this.db.prepare('SELECT node_id FROM vec_nodes_map').all();\n      return rows.map((r: any) => r.node_id as string);\n    } catch {\n      return [];\n    }\n  }\n\n  /** Returns the number of entries currently in the vec index. */\n  count(): number {\n    if (!this._available || !this.db) return 0;\n    try {\n      const row = this.db.prepare('SELECT COUNT(*) as c FROM vec_nodes_map').get();\n      return row ? (row.c as number) : 0;\n    } catch {\n      return 0;\n    }\n  }\n\n  close(): void {\n    if (this.db) {\n      try { this.db.close(); } catch { /* ignore */ }\n      this.db = null;\n      this._available = false;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "kirograph",
+  "version": "0.12.1",
+  "description": "Semantic code knowledge graph for Kiro — fewer tool calls, instant symbol lookups, 100% local.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "kirograph": "./dist/bin/kirograph.js",
+    "kg": "./dist/bin/kirograph.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsx scripts/build.ts",
+    "dev": "tsx scripts/build.ts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "docs": "npx serve docs"
+  },
+  "keywords": [
+    "kiro",
+    "code-intelligence",
+    "knowledge-graph",
+    "mcp",
+    "semantic-search"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@huggingface/transformers": "^3.0.0",
+    "commander": "^14.0.2",
+    "figlet": "^1.11.0",
+    "node-sqlite3-wasm": "^0.8.30",
+    "picomatch": "^4.0.3",
+    "tree-sitter-wasms": "^0.1.11",
+    "web-tree-sitter": "^0.25.3"
+  },
+  "optionalDependencies": {
+    "@electric-sql/pglite": "^0.2.17",
+    "@lancedb/lancedb": "^0.27.2",
+    "@orama/orama": "^3.1.18",
+    "@orama/plugin-data-persistence": "^3.1.18",
+    "@qdrant/qdrant-js": "^1.17.0",
+    "better-sqlite3": "^11.10.0",
+    "qdrant-local": "^0.0.0-alpha.10",
+    "sqlite-vec": "^0.1.9",
+    "typesense": "^3.0.6"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.7.0",
+    "@types/node": "^20.0.0",
+    "@types/picomatch": "^4.0.2",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "overrides": {
+    "tar": "^7.5.11",
+    "axios": "^1.8.3"
+  }
+}