kirograph 0.12.1

package/dist/vectors/lancedb-index.js

@@ -0,0 +1,153 @@
+"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 lancedb_index_exports = {};
+__export(lancedb_index_exports, {
+  LanceDBIndex: () => LanceDBIndex
+});
+module.exports = __toCommonJS(lancedb_index_exports);
+var path = __toESM(require("path"));
+var import_errors = require("../errors");
+const DEFAULT_DIM = 768;
+const DB_DIR = "lancedb";
+const TABLE_NAME = "kg_nodes";
+class LanceDBIndex {
+  constructor(kirographDir, dim = DEFAULT_DIM) {
+    this.kirographDir = kirographDir;
+    this.dim = dim;
+    this.db = null;
+    this.table = null;
+    this._available = false;
+    this.dbPath = path.join(kirographDir, DB_DIR);
+  }
+  isAvailable() {
+    return this._available;
+  }
+  /**
+   * Load @lancedb/lancedb, open the file-persisted database, and open or create
+   * the kg_nodes table. Silent no-op when the optional dep is missing.
+   */
+  async initialize() {
+    if (this._available) return;
+    let lancedb;
+    try {
+      lancedb = require("@lancedb/lancedb");
+    } catch {
+      (0, import_errors.logDebug)("LanceDBIndex: @lancedb/lancedb not installed \u2014 LanceDB engine unavailable");
+      return;
+    }
+    try {
+      this.db = await lancedb.connect(this.dbPath);
+      const existingTables = await this.db.tableNames();
+      if (existingTables.includes(TABLE_NAME)) {
+        this.table = await this.db.openTable(TABLE_NAME);
+      } else {
+        this.table = await this.db.createTable(TABLE_NAME, [{
+          node_id: "__init__",
+          name: "__init__",
+          kind: "function",
+          file_path: "",
+          signature: "",
+          vector: new Float32Array(this.dim)
+        }]);
+        await this.table.delete(`node_id = '__init__'`);
+      }
+      this._available = true;
+      (0, import_errors.logDebug)("LanceDBIndex: ready", { path: this.dbPath, dim: this.dim });
+    } catch (err) {
+      (0, import_errors.logError)("LanceDBIndex: initialization failed", { error: String(err) });
+    }
+  }
+  /**
+   * Insert or update a node using LanceDB's native mergeInsert — a single
+   * round-trip that updates the row if node_id exists, inserts it otherwise.
+   */
+  async upsert(node, embedding) {
+    if (!this._available || !this.table) return;
+    try {
+      await this.table.mergeInsert("node_id").whenMatchedUpdateAll().whenNotMatchedInsertAll().execute([{
+        node_id: node.id,
+        name: node.name,
+        kind: node.kind,
+        file_path: node.filePath,
+        signature: node.signature ?? "",
+        vector: embedding
+      }]);
+    } catch (err) {
+      (0, import_errors.logWarn)("LanceDBIndex: upsert failed", { nodeId: node.id, error: String(err) });
+    }
+  }
+  /**
+   * Remove a node's record from the index.
+   */
+  async delete(nodeId) {
+    if (!this._available || !this.table) return;
+    try {
+      await this.table.delete(`node_id = '${nodeId.replace(/'/g, "''")}'`);
+    } catch (err) {
+      (0, import_errors.logWarn)("LanceDBIndex: delete failed", { nodeId, error: String(err) });
+    }
+  }
+  /**
+   * ANN vector search. Returns node IDs ordered by cosine similarity (descending).
+   */
+  async search(queryVec, topN = 10) {
+    if (!this._available || !this.table) return [];
+    try {
+      const results = await this.table.search(queryVec).distanceType("cosine").limit(topN).toArray();
+      return results.map((row) => row.node_id);
+    } catch (err) {
+      (0, import_errors.logWarn)("LanceDBIndex: search failed", { error: String(err) });
+      return [];
+    }
+  }
+  /** Return all node IDs currently stored in the index. */
+  async getEmbeddedNodeIds() {
+    if (!this._available || !this.table) return [];
+    try {
+      const rows = await this.table.query().select(["node_id"]).toArray();
+      return rows.map((row) => row.node_id);
+    } catch {
+      return [];
+    }
+  }
+  /** Number of records currently in the index. */
+  async count() {
+    if (!this._available || !this.table) return 0;
+    try {
+      return await this.table.countRows();
+    } catch {
+      return 0;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LanceDBIndex
+});
+//# sourceMappingURL=lancedb-index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/vectors/lancedb-index.ts"],
+  "sourcesContent": ["/**\n * KiroGraph LanceDB Index\n *\n * ANN vector search backed by @lancedb/lancedb (Apache Arrow / Lance format).\n * The database is persisted to .kirograph/lancedb/ (Lance columnar file storage).\n *\n * Opt-in: set config.semanticEngine = 'lancedb'\n * Required optional dependency (not installed by default):\n *   npm install @lancedb/lancedb\n *\n * Key characteristics:\n *   - Pure JS/WASM, no native compilation required\n *   - Columnar storage (Apache Lance format) \u2014 efficient for batch reads/writes\n *   - ANN search via IVF-PQ or HNSW index for sub-linear query time\n *   - Native upsert via mergeInsert (single round-trip, no delete+insert dance)\n */\n\nimport * as path from 'path';\nimport { logDebug, logWarn, logError } from '../errors';\nimport type { Node } from '../types';\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;\nconst DB_DIR       = 'lancedb';\nconst TABLE_NAME   = 'kg_nodes';\n\n// \u2500\u2500 LanceDBIndex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 LanceDBIndex {\n  private db: any    = null;\n  private table: any = null;\n  private _available = false;\n  private dbPath: string;\n\n  constructor(\n    private readonly kirographDir: string,\n    private readonly dim = DEFAULT_DIM,\n  ) {\n    this.dbPath = path.join(kirographDir, DB_DIR);\n  }\n\n  isAvailable(): boolean {\n    return this._available;\n  }\n\n  /**\n   * Load @lancedb/lancedb, open the file-persisted database, and open or create\n   * the kg_nodes table. Silent no-op when the optional dep is missing.\n   */\n  async initialize(): Promise<void> {\n    if (this._available) return;\n\n    let lancedb: any;\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      lancedb = require('@lancedb/lancedb');\n    } catch {\n      logDebug('LanceDBIndex: @lancedb/lancedb not installed \u2014 LanceDB engine unavailable');\n      return;\n    }\n\n    try {\n      this.db = await lancedb.connect(this.dbPath);\n\n      const existingTables: string[] = await this.db.tableNames();\n      if (existingTables.includes(TABLE_NAME)) {\n        this.table = await this.db.openTable(TABLE_NAME);\n      } else {\n        // Create table with a dummy record so LanceDB knows the schema, then delete it.\n        this.table = await this.db.createTable(TABLE_NAME, [{\n          node_id:   '__init__',\n          name:      '__init__',\n          kind:      'function',\n          file_path: '',\n          signature: '',\n          vector:    new Float32Array(this.dim),\n        }]);\n        await this.table.delete(`node_id = '__init__'`);\n      }\n\n      this._available = true;\n      logDebug('LanceDBIndex: ready', { path: this.dbPath, dim: this.dim });\n    } catch (err) {\n      logError('LanceDBIndex: initialization failed', { error: String(err) });\n    }\n  }\n\n  /**\n   * Insert or update a node using LanceDB's native mergeInsert \u2014 a single\n   * round-trip that updates the row if node_id exists, inserts it otherwise.\n   */\n  async upsert(node: Node, embedding: Float32Array): Promise<void> {\n    if (!this._available || !this.table) return;\n\n    try {\n      await this.table\n        .mergeInsert('node_id')\n        .whenMatchedUpdateAll()\n        .whenNotMatchedInsertAll()\n        .execute([{\n          node_id:   node.id,\n          name:      node.name,\n          kind:      node.kind,\n          file_path: node.filePath,\n          signature: node.signature ?? '',\n          vector:    embedding,\n        }]);\n    } catch (err) {\n      logWarn('LanceDBIndex: upsert failed', { nodeId: node.id, error: String(err) });\n    }\n  }\n\n  /**\n   * Remove a node's record from the index.\n   */\n  async delete(nodeId: string): Promise<void> {\n    if (!this._available || !this.table) return;\n\n    try {\n      await this.table.delete(`node_id = '${nodeId.replace(/'/g, \"''\")}'`);\n    } catch (err) {\n      logWarn('LanceDBIndex: delete failed', { nodeId, error: String(err) });\n    }\n  }\n\n  /**\n   * ANN vector search. Returns node IDs ordered by cosine similarity (descending).\n   */\n  async search(queryVec: Float32Array, topN = 10): Promise<string[]> {\n    if (!this._available || !this.table) return [];\n\n    try {\n      const results = await this.table\n        .search(queryVec)\n        .distanceType('cosine')\n        .limit(topN)\n        .toArray();\n\n      return results.map((row: any) => row.node_id as string);\n    } catch (err) {\n      logWarn('LanceDBIndex: search failed', { error: String(err) });\n      return [];\n    }\n  }\n\n  /** Return all node IDs currently stored in the index. */\n  async getEmbeddedNodeIds(): Promise<string[]> {\n    if (!this._available || !this.table) return [];\n    try {\n      const rows = await this.table.query().select(['node_id']).toArray();\n      return rows.map((row: any) => row.node_id as string);\n    } catch {\n      return [];\n    }\n  }\n\n  /** Number of records currently in the index. */\n  async count(): Promise<number> {\n    if (!this._available || !this.table) return 0;\n    try {\n      return await this.table.countRows();\n    } catch {\n      return 0;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,54 @@
+/**
+ * KiroGraph Orama Index
+ *
+ * Hybrid search (full-text + vector) backed by @orama/orama.
+ * The index is persisted to .kirograph/orama.json via @orama/plugin-data-persistence.
+ *
+ * Opt-in: set config.semanticEngine = 'orama'
+ * Required optional dependencies (not installed by default):
+ *   npm install @orama/orama @orama/plugin-data-persistence
+ *
+ * Key advantage over cosine/sqlite-vec: Orama combines full-text relevance and
+ * vector similarity in a single hybrid query, producing higher-quality results
+ * than running the two searches separately and merging by priority.
+ */
+import type { Node } from '../types';
+export declare class OramaIndex {
+    private readonly kirographDir;
+    private readonly dim;
+    private db;
+    private _available;
+    private indexPath;
+    private orama;
+    private persistence;
+    constructor(kirographDir: string, dim?: number);
+    isAvailable(): boolean;
+    /**
+     * Load @orama/orama + @orama/plugin-data-persistence, then either restore
+     * the persisted index from orama.json or create a fresh one.
+     * Silent no-op when optional deps are missing.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Insert or replace a node's document in the index.
+     * Orama has no native upsert, so we remove any existing doc first.
+     */
+    upsert(node: Node, embedding: Float32Array): Promise<void>;
+    /**
+     * Remove a node's document from the index.
+     */
+    delete(nodeId: string): Promise<void>;
+    /**
+     * Hybrid search: combines full-text relevance on name/kind/filePath/signature
+     * with vector similarity on the embedding field.
+     * Returns node IDs ordered by Orama's combined score (best first).
+     */
+    search(queryText: string, queryVec: Float32Array, topN?: number): Promise<string[]>;
+    /** Persist the in-memory index to .kirograph/orama.json. */
+    save(): Promise<void>;
+    /** Return all node IDs currently stored in the index. */
+    getEmbeddedNodeIds(): Promise<string[]>;
+    /** Number of documents currently in the index. */
+    count(): Promise<number>;
+}
+//# sourceMappingURL=orama-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orama-index.d.ts","sourceRoot":"","sources":["../../src/vectors/orama-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AASrC,qBAAa,UAAU;IAmBnB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAnBtB,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,KAAK,CAMG;IAChB,OAAO,CAAC,WAAW,CAGH;gBAGG,YAAY,EAAE,MAAM,EACpB,GAAG,SAAc;IAKpC,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDjC;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhE;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3C;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBrF,4DAA4D;IACtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,yDAAyD;IACnD,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAU7C,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAQ/B"}

package/dist/vectors/orama-index.js

@@ -0,0 +1,213 @@
+"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 orama_index_exports = {};
+__export(orama_index_exports, {
+  OramaIndex: () => OramaIndex
+});
+module.exports = __toCommonJS(orama_index_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var import_errors = require("../errors");
+const DEFAULT_DIM = 768;
+const INDEX_FILE = "orama.json";
+class OramaIndex {
+  constructor(kirographDir, dim = DEFAULT_DIM) {
+    this.kirographDir = kirographDir;
+    this.dim = dim;
+    this.db = null;
+    this._available = false;
+    // Lazily-loaded Orama functions
+    this.orama = null;
+    this.persistence = null;
+    this.indexPath = path.join(kirographDir, INDEX_FILE);
+  }
+  isAvailable() {
+    return this._available;
+  }
+  /**
+   * Load @orama/orama + @orama/plugin-data-persistence, then either restore
+   * the persisted index from orama.json or create a fresh one.
+   * Silent no-op when optional deps are missing.
+   */
+  async initialize() {
+    if (this._available) return;
+    try {
+      const oramaModule = require("@orama/orama");
+      this.orama = {
+        create: oramaModule.create,
+        insert: oramaModule.insert,
+        remove: oramaModule.remove,
+        search: oramaModule.search,
+        count: oramaModule.count
+      };
+    } catch {
+      (0, import_errors.logDebug)("OramaIndex: @orama/orama not installed \u2014 Orama engine unavailable");
+      return;
+    }
+    try {
+      const persistModule = require("@orama/plugin-data-persistence/server");
+      this.persistence = {
+        persistToFile: persistModule.persistToFile,
+        restoreFromFile: persistModule.restoreFromFile
+      };
+    } catch {
+      (0, import_errors.logDebug)("OramaIndex: @orama/plugin-data-persistence not installed \u2014 Orama engine unavailable");
+      return;
+    }
+    try {
+      if (fs.existsSync(this.indexPath)) {
+        this.db = await this.persistence.restoreFromFile("json", this.indexPath);
+        (0, import_errors.logDebug)("OramaIndex: restored from disk", { path: this.indexPath });
+      } else {
+        this.db = await this.orama.create({
+          schema: {
+            nodeId: "enum",
+            // exact-match filterable field (not full-text indexed)
+            name: "string",
+            kind: "string",
+            filePath: "string",
+            signature: "string",
+            embedding: `vector[${this.dim}]`
+          }
+        });
+        (0, import_errors.logDebug)("OramaIndex: created fresh index", { dim: this.dim });
+      }
+      this._available = true;
+    } catch (err) {
+      (0, import_errors.logError)("OramaIndex: initialization failed", { error: String(err) });
+    }
+  }
+  /**
+   * Insert or replace a node's document in the index.
+   * Orama has no native upsert, so we remove any existing doc first.
+   */
+  async upsert(node, embedding) {
+    if (!this._available || !this.db) return;
+    try {
+      const existing = await this.orama.search(this.db, {
+        term: "",
+        where: { nodeId: { eq: node.id } },
+        limit: 1
+      });
+      if (existing?.hits?.length > 0) {
+        for (const hit of existing.hits) {
+          await this.orama.remove(this.db, hit.id);
+        }
+      }
+      await this.orama.insert(this.db, {
+        nodeId: node.id,
+        name: node.name,
+        kind: node.kind,
+        filePath: node.filePath,
+        signature: node.signature ?? "",
+        embedding: Array.from(embedding)
+      });
+    } catch (err) {
+      (0, import_errors.logWarn)("OramaIndex: upsert failed", { nodeId: node.id, error: String(err) });
+    }
+  }
+  /**
+   * Remove a node's document from the index.
+   */
+  async delete(nodeId) {
+    if (!this._available || !this.db) return;
+    try {
+      const existing = await this.orama.search(this.db, {
+        term: "",
+        where: { nodeId: { eq: nodeId } },
+        limit: 1
+      });
+      if (existing?.hits?.length > 0) {
+        for (const hit of existing.hits) {
+          await this.orama.remove(this.db, hit.id);
+        }
+      }
+    } catch (err) {
+      (0, import_errors.logWarn)("OramaIndex: delete failed", { nodeId, error: String(err) });
+    }
+  }
+  /**
+   * Hybrid search: combines full-text relevance on name/kind/filePath/signature
+   * with vector similarity on the embedding field.
+   * Returns node IDs ordered by Orama's combined score (best first).
+   */
+  async search(queryText, queryVec, topN = 10) {
+    if (!this._available || !this.db) return [];
+    try {
+      const results = await this.orama.search(this.db, {
+        term: queryText,
+        mode: "hybrid",
+        vector: {
+          value: Array.from(queryVec),
+          property: "embedding"
+        },
+        limit: topN,
+        similarity: 0.3
+      });
+      return (results?.hits ?? []).map((hit) => hit.document.nodeId);
+    } catch (err) {
+      (0, import_errors.logWarn)("OramaIndex: search failed", { error: String(err) });
+      return [];
+    }
+  }
+  /** Persist the in-memory index to .kirograph/orama.json. */
+  async save() {
+    if (!this._available || !this.db || !this.persistence) return;
+    try {
+      await this.persistence.persistToFile(this.db, "json", this.indexPath);
+      (0, import_errors.logDebug)("OramaIndex: saved to disk", { path: this.indexPath });
+    } catch (err) {
+      (0, import_errors.logWarn)("OramaIndex: save failed", { error: String(err) });
+    }
+  }
+  /** Return all node IDs currently stored in the index. */
+  async getEmbeddedNodeIds() {
+    if (!this._available || !this.db) return [];
+    try {
+      const results = await this.orama.search(this.db, { term: "", limit: 1e6, includeVectors: false });
+      return (results?.hits ?? []).map((hit) => hit.document.nodeId);
+    } catch {
+      return [];
+    }
+  }
+  /** Number of documents currently in the index. */
+  async count() {
+    if (!this._available || !this.db) return 0;
+    try {
+      return await this.orama.count(this.db);
+    } catch {
+      return 0;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OramaIndex
+});
+//# sourceMappingURL=orama-index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/vectors/orama-index.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Orama Index\n *\n * Hybrid search (full-text + vector) backed by @orama/orama.\n * The index is persisted to .kirograph/orama.json via @orama/plugin-data-persistence.\n *\n * Opt-in: set config.semanticEngine = 'orama'\n * Required optional dependencies (not installed by default):\n *   npm install @orama/orama @orama/plugin-data-persistence\n *\n * Key advantage over cosine/sqlite-vec: Orama combines full-text relevance and\n * vector similarity in a single hybrid query, producing higher-quality results\n * than running the two searches separately and merging by priority.\n */\n\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { logDebug, logWarn, logError } from '../errors';\nimport type { Node } from '../types';\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;\nconst INDEX_FILE  = 'orama.json';\n\n// \u2500\u2500 OramaIndex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 OramaIndex {\n  private db: any = null;\n  private _available = false;\n  private indexPath: string;\n\n  // Lazily-loaded Orama functions\n  private orama: {\n    create: Function;\n    insert: Function;\n    remove: Function;\n    search: Function;\n    count: Function;\n  } | null = null;\n  private persistence: {\n    persistToFile: Function;\n    restoreFromFile: Function;\n  } | null = null;\n\n  constructor(\n    private readonly kirographDir: string,\n    private readonly dim = DEFAULT_DIM,\n  ) {\n    this.indexPath = path.join(kirographDir, INDEX_FILE);\n  }\n\n  isAvailable(): boolean {\n    return this._available;\n  }\n\n  /**\n   * Load @orama/orama + @orama/plugin-data-persistence, then either restore\n   * the persisted index from orama.json or create a fresh one.\n   * Silent no-op when optional deps are missing.\n   */\n  async initialize(): Promise<void> {\n    if (this._available) return;\n\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const oramaModule = require('@orama/orama');\n      this.orama = {\n        create:  oramaModule.create,\n        insert:  oramaModule.insert,\n        remove:  oramaModule.remove,\n        search:  oramaModule.search,\n        count:   oramaModule.count,\n      };\n    } catch {\n      logDebug('OramaIndex: @orama/orama not installed \u2014 Orama engine unavailable');\n      return;\n    }\n\n    try {\n      // persistToFile / restoreFromFile live in the /server subpath (Node.js only)\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const persistModule = require('@orama/plugin-data-persistence/server');\n      this.persistence = {\n        persistToFile:   persistModule.persistToFile,\n        restoreFromFile: persistModule.restoreFromFile,\n      };\n    } catch {\n      logDebug('OramaIndex: @orama/plugin-data-persistence not installed \u2014 Orama engine unavailable');\n      return;\n    }\n\n    try {\n      if (fs.existsSync(this.indexPath)) {\n        this.db = await this.persistence!.restoreFromFile('json', this.indexPath);\n        logDebug('OramaIndex: restored from disk', { path: this.indexPath });\n      } else {\n        this.db = await this.orama!.create({\n          schema: {\n            nodeId:    'enum',    // exact-match filterable field (not full-text indexed)\n            name:      'string',\n            kind:      'string',\n            filePath:  'string',\n            signature: 'string',\n            embedding: `vector[${this.dim}]`,\n          },\n        });\n        logDebug('OramaIndex: created fresh index', { dim: this.dim });\n      }\n      this._available = true;\n    } catch (err) {\n      logError('OramaIndex: initialization failed', { error: String(err) });\n    }\n  }\n\n  /**\n   * Insert or replace a node's document in the index.\n   * Orama has no native upsert, so we remove any existing doc first.\n   */\n  async upsert(node: Node, embedding: Float32Array): Promise<void> {\n    if (!this._available || !this.db) return;\n\n    try {\n      // Remove existing document if present (exact match on enum field \u2014 no full-text)\n      const existing = await this.orama!.search(this.db, {\n        term: '',\n        where: { nodeId: { eq: node.id } },\n        limit: 1,\n      });\n      if (existing?.hits?.length > 0) {\n        for (const hit of existing.hits) {\n          await this.orama!.remove(this.db, hit.id);\n        }\n      }\n\n      await this.orama!.insert(this.db, {\n        nodeId:    node.id,\n        name:      node.name,\n        kind:      node.kind,\n        filePath:  node.filePath,\n        signature: node.signature ?? '',\n        embedding: Array.from(embedding),\n      });\n    } catch (err) {\n      logWarn('OramaIndex: upsert failed', { nodeId: node.id, error: String(err) });\n    }\n  }\n\n  /**\n   * Remove a node's document from the index.\n   */\n  async delete(nodeId: string): Promise<void> {\n    if (!this._available || !this.db) return;\n\n    try {\n      const existing = await this.orama!.search(this.db, {\n        term: '',\n        where: { nodeId: { eq: nodeId } },\n        limit: 1,\n      });\n      if (existing?.hits?.length > 0) {\n        for (const hit of existing.hits) {\n          await this.orama!.remove(this.db, hit.id);\n        }\n      }\n    } catch (err) {\n      logWarn('OramaIndex: delete failed', { nodeId, error: String(err) });\n    }\n  }\n\n  /**\n   * Hybrid search: combines full-text relevance on name/kind/filePath/signature\n   * with vector similarity on the embedding field.\n   * Returns node IDs ordered by Orama's combined score (best first).\n   */\n  async search(queryText: string, queryVec: Float32Array, topN = 10): Promise<string[]> {\n    if (!this._available || !this.db) return [];\n\n    try {\n      const results = await this.orama!.search(this.db, {\n        term:  queryText,\n        mode:  'hybrid',\n        vector: {\n          value:    Array.from(queryVec),\n          property: 'embedding',\n        },\n        limit:      topN,\n        similarity: 0.3,\n      });\n\n      return (results?.hits ?? []).map((hit: any) => hit.document.nodeId as string);\n    } catch (err) {\n      logWarn('OramaIndex: search failed', { error: String(err) });\n      return [];\n    }\n  }\n\n  /** Persist the in-memory index to .kirograph/orama.json. */\n  async save(): Promise<void> {\n    if (!this._available || !this.db || !this.persistence) return;\n\n    try {\n      await this.persistence.persistToFile(this.db, 'json', this.indexPath);\n      logDebug('OramaIndex: saved to disk', { path: this.indexPath });\n    } catch (err) {\n      logWarn('OramaIndex: save failed', { error: String(err) });\n    }\n  }\n\n  /** Return all node IDs currently stored in the index. */\n  async getEmbeddedNodeIds(): Promise<string[]> {\n    if (!this._available || !this.db) return [];\n    try {\n      const results = await this.orama!.search(this.db, { term: '', limit: 1_000_000, includeVectors: false });\n      return (results?.hits ?? []).map((hit: any) => hit.document.nodeId as string);\n    } catch {\n      return [];\n    }\n  }\n\n  /** Number of documents currently in the index. */\n  async count(): Promise<number> {\n    if (!this._available || !this.db) return 0;\n    try {\n      return await this.orama!.count(this.db);\n    } catch {\n      return 0;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,53 @@
+/**
+ * KiroGraph PGLite Index
+ *
+ * Hybrid search (full-text + exact vector) backed by @electric-sql/pglite + pgvector.
+ * The database is persisted to .kirograph/pglite/ (PGLite's WAL-based file storage).
+ *
+ * Opt-in: set config.semanticEngine = 'pglite'
+ * Required optional dependency (not installed by default):
+ *   npm install @electric-sql/pglite
+ *
+ * Key advantages over other engines:
+ *   - Pure WASM, no native compilation required (unlike sqlite-vec)
+ *   - Exact nearest-neighbour search (deterministic, unlike ANN approximation)
+ *   - Native SQL upsert via ON CONFLICT — no remove+insert dance (unlike Orama)
+ *   - HNSW index for fast approximate search when the table grows large
+ *   - Full-text search via PostgreSQL tsvector + ts_rank combined in one query
+ */
+import type { Node } from '../types';
+export declare class PGliteIndex {
+    private readonly kirographDir;
+    private readonly dim;
+    private db;
+    private _available;
+    private dbPath;
+    constructor(kirographDir: string, dim?: number);
+    isAvailable(): boolean;
+    /**
+     * Load @electric-sql/pglite, open the file-persisted database, enable pgvector,
+     * and apply the schema (idempotent — safe to call on every startup).
+     * Silent no-op when the optional dep is missing.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Insert or update a node's record using PostgreSQL's native ON CONFLICT upsert.
+     */
+    upsert(node: Node, embedding: Float32Array): Promise<void>;
+    /**
+     * Remove a node's record from the index.
+     */
+    delete(nodeId: string): Promise<void>;
+    /**
+     * Hybrid search: combines pgvector cosine distance with PostgreSQL full-text
+     * ranking in a single SQL query. Returns node IDs ordered by combined score.
+     *
+     * Score = VECTOR_WEIGHT × (1 - cosine_distance) + FTS_WEIGHT × ts_rank
+     */
+    search(queryText: string, queryVec: Float32Array, topN?: number): Promise<string[]>;
+    /** Return all node IDs currently stored in the index. */
+    getEmbeddedNodeIds(): Promise<string[]>;
+    /** Number of documents currently in the index. */
+    count(): Promise<number>;
+}
+//# sourceMappingURL=pglite-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pglite-index.d.ts","sourceRoot":"","sources":["../../src/vectors/pglite-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAarC,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAGJ,YAAY,EAAE,MAAM,EACpB,GAAG,SAAc;IAKpC,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDjC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhE;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BrF,yDAAyD;IACnD,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAU7C,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAS/B"}