kirograph 0.28.1 → 1.0.0

package/dist/vectors/turso-index.js

@@ -0,0 +1,307 @@
+"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 turso_index_exports = {};
+__export(turso_index_exports, {
+  TursoIndex: () => TursoIndex
+});
+module.exports = __toCommonJS(turso_index_exports);
+var path = __toESM(require("path"));
+var import_errors = require("../errors");
+const DEFAULT_DIM = 768;
+const DB_FILE = "turso.db";
+const VECTOR_WEIGHT = 0.7;
+const FTS_WEIGHT = 0.3;
+class TursoIndex {
+  constructor(kirographDir, dim = DEFAULT_DIM) {
+    this.kirographDir = kirographDir;
+    this.dim = dim;
+    this.db = null;
+    this._available = false;
+    this._failReason = null;
+    this.dbPath = path.join(kirographDir, DB_FILE);
+  }
+  isAvailable() {
+    return this._available;
+  }
+  getFailReason() {
+    return this._failReason;
+  }
+  /**
+   * Load @tursodatabase/database, open a local file-based database, and apply the schema.
+   * Silent no-op when the optional dep is missing.
+   */
+  async initialize() {
+    if (this._available) return;
+    let connect;
+    try {
+      const mod = require("@tursodatabase/database");
+      connect = mod.connect ?? mod.default?.connect ?? mod;
+    } catch {
+      (0, import_errors.logDebug)("TursoIndex: @tursodatabase/database not installed \u2014 Turso engine unavailable");
+      return;
+    }
+    try {
+      const fs = await import("fs");
+      let lastErr;
+      for (let attempt = 0; attempt < 3; attempt++) {
+        try {
+          this.db = await connect(this.dbPath);
+          lastErr = null;
+          break;
+        } catch (err) {
+          lastErr = err;
+          const msg = String(err);
+          if (msg.includes("locked") || msg.includes("Locking")) {
+            (0, import_errors.logDebug)(`TursoIndex: DB locked, retry ${attempt + 1}/3`);
+            if (attempt < 2) {
+              await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
+            }
+          } else {
+            throw err;
+          }
+        }
+      }
+      if (lastErr) {
+        const msg = String(lastErr);
+        if (msg.includes("locked") || msg.includes("Locking")) {
+          (0, import_errors.logDebug)("TursoIndex: removing stale locked DB and retrying");
+          try {
+            fs.unlinkSync(this.dbPath);
+          } catch {
+          }
+          try {
+            fs.unlinkSync(this.dbPath + "-wal");
+          } catch {
+          }
+          try {
+            fs.unlinkSync(this.dbPath + "-shm");
+          } catch {
+          }
+          this.db = await connect(this.dbPath);
+        } else {
+          throw lastErr;
+        }
+      }
+      await this.db.exec(`
+        CREATE TABLE IF NOT EXISTS kg_nodes (
+          node_id   TEXT PRIMARY KEY,
+          name      TEXT NOT NULL DEFAULT '',
+          kind      TEXT NOT NULL DEFAULT '',
+          file_path TEXT NOT NULL DEFAULT '',
+          signature TEXT NOT NULL DEFAULT '',
+          embedding vector32(${this.dim})
+        );
+      `);
+      try {
+        await this.db.exec(`
+          CREATE INDEX IF NOT EXISTS kg_nodes_fts ON kg_nodes USING fts (name, signature);
+        `);
+      } catch {
+        (0, import_errors.logDebug)("TursoIndex: FTS index creation failed \u2014 hybrid search will fall back to pure vector");
+      }
+      this._available = true;
+      (0, import_errors.logDebug)("TursoIndex: ready", { path: this.dbPath, dim: this.dim });
+    } catch (err) {
+      this._failReason = String(err);
+      (0, import_errors.logError)("TursoIndex: initialization failed", { error: String(err) });
+      this._available = false;
+      this.db = null;
+    }
+  }
+  /**
+   * Insert or update a node's record using ON CONFLICT upsert.
+   */
+  async upsert(node, embedding) {
+    if (!this._available || !this.db) return;
+    try {
+      const vecLiteral = `vector32('[${Array.from(embedding).join(",")}]')`;
+      const stmt = this.db.prepare(`
+        INSERT INTO kg_nodes (node_id, name, kind, file_path, signature, embedding)
+        VALUES (?, ?, ?, ?, ?, ${vecLiteral})
+        ON CONFLICT (node_id) DO UPDATE SET
+          name      = excluded.name,
+          kind      = excluded.kind,
+          file_path = excluded.file_path,
+          signature = excluded.signature,
+          embedding = excluded.embedding
+      `);
+      await stmt.run(
+        node.id,
+        node.name,
+        node.kind,
+        node.filePath,
+        node.signature ?? ""
+      );
+    } catch (err) {
+      (0, import_errors.logWarn)("TursoIndex: upsert failed", { nodeId: node.id, error: String(err) });
+    }
+  }
+  /**
+   * Bulk upsert for batch embedding. Uses a transaction for atomicity and speed.
+   */
+  async bulkUpsert(nodes, embeddings) {
+    if (!this._available || !this.db) return;
+    if (nodes.length === 0) return;
+    try {
+      await this.db.exec("BEGIN");
+      for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const embedding = embeddings[i];
+        const vecLiteral = `vector32('[${Array.from(embedding).join(",")}]')`;
+        const stmt = this.db.prepare(`
+          INSERT INTO kg_nodes (node_id, name, kind, file_path, signature, embedding)
+          VALUES (?, ?, ?, ?, ?, ${vecLiteral})
+          ON CONFLICT (node_id) DO UPDATE SET
+            name      = excluded.name,
+            kind      = excluded.kind,
+            file_path = excluded.file_path,
+            signature = excluded.signature,
+            embedding = excluded.embedding
+        `);
+        await stmt.run(
+          node.id,
+          node.name,
+          node.kind,
+          node.filePath,
+          node.signature ?? ""
+        );
+      }
+      await this.db.exec("COMMIT");
+    } catch (err) {
+      try {
+        await this.db.exec("ROLLBACK");
+      } catch {
+      }
+      (0, import_errors.logWarn)("TursoIndex: bulkUpsert failed", { count: nodes.length, error: String(err) });
+    }
+  }
+  /**
+   * Remove a node's record from the index.
+   */
+  async delete(nodeId) {
+    if (!this._available || !this.db) return;
+    try {
+      const stmt = this.db.prepare("DELETE FROM kg_nodes WHERE node_id = ?");
+      await stmt.run(nodeId);
+    } catch (err) {
+      (0, import_errors.logWarn)("TursoIndex: delete failed", { nodeId, error: String(err) });
+    }
+  }
+  /**
+   * Hybrid search: combines Turso native vector_distance_cos with Tantivy FTS.
+   * Returns node IDs ordered by combined score.
+   *
+   * Score = VECTOR_WEIGHT * (1 - cosine_distance) + FTS_WEIGHT * fts_score
+   *
+   * Falls back to pure vector search when the query text produces no FTS matches
+   * or when FTS is not available.
+   */
+  async search(queryText, queryVec, topN = 10) {
+    if (!this._available || !this.db) return [];
+    const vecLiteral = `vector32('[${Array.from(queryVec).join(",")}]')`;
+    try {
+      const stmt = this.db.prepare(`
+        SELECT
+          n.node_id,
+          (${VECTOR_WEIGHT} * (1.0 - vector_distance_cos(n.embedding, ${vecLiteral}))
+           + ${FTS_WEIGHT} * COALESCE(fts_score(n.name, n.signature, ?), 0.0)
+          ) AS score
+        FROM kg_nodes n
+        WHERE n.embedding IS NOT NULL
+        ORDER BY score DESC
+        LIMIT ?
+      `);
+      const rows = await stmt.all(queryText, topN);
+      if (rows && rows.length > 0) {
+        return rows.map((r) => r.node_id);
+      }
+    } catch {
+      (0, import_errors.logDebug)("TursoIndex: hybrid search unavailable, using pure vector");
+    }
+    return this.vectorSearch(queryVec, topN);
+  }
+  /**
+   * Pure vector similarity search using Turso's native vector_distance_cos.
+   */
+  async vectorSearch(queryVec, topN) {
+    const vecLiteral = `vector32('[${Array.from(queryVec).join(",")}]')`;
+    try {
+      const stmt = this.db.prepare(`
+        SELECT node_id, vector_distance_cos(embedding, ${vecLiteral}) AS distance
+        FROM kg_nodes
+        WHERE embedding IS NOT NULL
+        ORDER BY distance ASC
+        LIMIT ?
+      `);
+      const rows = await stmt.all(topN);
+      return (rows ?? []).map((r) => r.node_id);
+    } catch (err) {
+      (0, import_errors.logWarn)("TursoIndex: vector search failed", { error: String(err) });
+      return [];
+    }
+  }
+  /** Return all node IDs currently stored in the index. */
+  async getEmbeddedNodeIds() {
+    if (!this._available || !this.db) return [];
+    try {
+      const stmt = this.db.prepare("SELECT node_id FROM kg_nodes");
+      const rows = await stmt.all();
+      return (rows ?? []).map((r) => r.node_id);
+    } catch {
+      return [];
+    }
+  }
+  /** Number of documents currently in the index. */
+  async count() {
+    if (!this._available || !this.db) return 0;
+    try {
+      const stmt = this.db.prepare("SELECT COUNT(*) AS c FROM kg_nodes");
+      const row = await stmt.get();
+      return row ? row.c : 0;
+    } catch {
+      return 0;
+    }
+  }
+  /** Close the database connection and release resources. */
+  close() {
+    if (this.db) {
+      try {
+        if (typeof this.db.close === "function") this.db.close();
+      } catch {
+      }
+      this.db = null;
+      this._available = false;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TursoIndex
+});
+//# sourceMappingURL=turso-index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/vectors/turso-index.ts"],
+  "sourcesContent": ["/**\n * KiroGraph Turso Index\n *\n * Hybrid search (native vector similarity + Tantivy FTS) backed by Turso,\n * the ground-up rewrite of SQLite with MVCC, async I/O, and built-in vector search.\n * The database is persisted to .kirograph/turso.db (local-only, no cloud sync).\n *\n * Opt-in: set config.semanticEngine = 'turso'\n * Required optional dependency (not installed by default):\n *   npm install @tursodatabase/database\n *\n * Key advantages:\n *   - Native vector_distance_cos() \u2014 no extensions, built into the engine\n *   - Tantivy-powered FTS with BM25 ranking (more powerful than FTS5)\n *   - MVCC concurrent writes \u2014 no \"database is locked\" errors\n *   - Async I/O \u2014 non-blocking operations\n *   - SQLite-compatible \u2014 all standard SQL works unchanged\n *   - Local-only: no cloud dependency, no network calls\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_FILE = 'turso.db';\n\n// Weight for vector score vs full-text score in hybrid ranking (must sum to 1.0)\nconst VECTOR_WEIGHT = 0.7;\nconst FTS_WEIGHT = 0.3;\n\n// \u2500\u2500 TursoIndex \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 TursoIndex {\n  private db: any = null;\n  private _available = false;\n  private dbPath: string;\n  private _failReason: string | null = null;\n\n  constructor(\n    private readonly kirographDir: string,\n    private readonly dim = DEFAULT_DIM,\n  ) {\n    this.dbPath = path.join(kirographDir, DB_FILE);\n  }\n\n  isAvailable(): boolean {\n    return this._available;\n  }\n\n  getFailReason(): string | null {\n    return this._failReason;\n  }\n\n  /**\n   * Load @tursodatabase/database, open a local file-based database, and apply the schema.\n   * Silent no-op when the optional dep is missing.\n   */\n  async initialize(): Promise<void> {\n    if (this._available) return;\n\n    let connect: any;\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const mod = require('@tursodatabase/database');\n      connect = mod.connect ?? mod.default?.connect ?? mod;\n    } catch {\n      logDebug('TursoIndex: @tursodatabase/database not installed \u2014 Turso engine unavailable');\n      return;\n    }\n\n    try {\n      // Turso uses exclusive file locking. If another process (e.g. MCP server) holds\n      // the DB open, the connect call will fail. Retry after a brief delay.\n      // If all retries fail due to locking, remove the stale DB and try once more\n      // (safe because the DB is rebuilt from embeddings on next index).\n      const fs = await import('fs');\n      let lastErr: unknown;\n      for (let attempt = 0; attempt < 3; attempt++) {\n        try {\n          this.db = await connect(this.dbPath);\n          lastErr = null;\n          break;\n        } catch (err) {\n          lastErr = err;\n          const msg = String(err);\n          if (msg.includes('locked') || msg.includes('Locking')) {\n            logDebug(`TursoIndex: DB locked, retry ${attempt + 1}/3`);\n            if (attempt < 2) {\n              await new Promise(r => setTimeout(r, 500 * (attempt + 1)));\n            }\n          } else {\n            throw err;\n          }\n        }\n      }\n      // If still locked after retries, remove the stale DB and try one final time\n      if (lastErr) {\n        const msg = String(lastErr);\n        if (msg.includes('locked') || msg.includes('Locking')) {\n          logDebug('TursoIndex: removing stale locked DB and retrying');\n          try { fs.unlinkSync(this.dbPath); } catch { /* ignore */ }\n          try { fs.unlinkSync(this.dbPath + '-wal'); } catch { /* ignore */ }\n          try { fs.unlinkSync(this.dbPath + '-shm'); } catch { /* ignore */ }\n          this.db = await connect(this.dbPath);\n        } else {\n          throw lastErr;\n        }\n      }\n\n      // Create table with native vector column\n      await this.db.exec(`\n        CREATE TABLE IF NOT EXISTS kg_nodes (\n          node_id   TEXT PRIMARY KEY,\n          name      TEXT NOT NULL DEFAULT '',\n          kind      TEXT NOT NULL DEFAULT '',\n          file_path TEXT NOT NULL DEFAULT '',\n          signature TEXT NOT NULL DEFAULT '',\n          embedding vector32(${this.dim})\n        );\n      `);\n\n      // Tantivy-powered FTS index for hybrid search\n      // Note: Turso FTS uses CREATE INDEX ... USING fts syntax\n      try {\n        await this.db.exec(`\n          CREATE INDEX IF NOT EXISTS kg_nodes_fts ON kg_nodes USING fts (name, signature);\n        `);\n      } catch {\n        // FTS index creation may fail on older Turso versions \u2014 fall back to pure vector\n        logDebug('TursoIndex: FTS index creation failed \u2014 hybrid search will fall back to pure vector');\n      }\n\n      this._available = true;\n      logDebug('TursoIndex: ready', { path: this.dbPath, dim: this.dim });\n    } catch (err) {\n      this._failReason = String(err);\n      logError('TursoIndex: initialization failed', { error: String(err) });\n      this._available = false;\n      this.db = null;\n    }\n  }\n\n  /**\n   * Insert or update a node's record using ON CONFLICT upsert.\n   */\n  async upsert(node: Node, embedding: Float32Array): Promise<void> {\n    if (!this._available || !this.db) return;\n\n    try {\n      const vecLiteral = `vector32('[${Array.from(embedding).join(',')}]')`;\n      const stmt = this.db.prepare(`\n        INSERT INTO kg_nodes (node_id, name, kind, file_path, signature, embedding)\n        VALUES (?, ?, ?, ?, ?, ${vecLiteral})\n        ON CONFLICT (node_id) DO UPDATE SET\n          name      = excluded.name,\n          kind      = excluded.kind,\n          file_path = excluded.file_path,\n          signature = excluded.signature,\n          embedding = excluded.embedding\n      `);\n      await stmt.run(\n        node.id,\n        node.name,\n        node.kind,\n        node.filePath,\n        node.signature ?? '',\n      );\n    } catch (err) {\n      logWarn('TursoIndex: upsert failed', { nodeId: node.id, error: String(err) });\n    }\n  }\n\n  /**\n   * Bulk upsert for batch embedding. Uses a transaction for atomicity and speed.\n   */\n  async bulkUpsert(nodes: Node[], embeddings: Float32Array[]): Promise<void> {\n    if (!this._available || !this.db) return;\n    if (nodes.length === 0) return;\n\n    try {\n      await this.db.exec('BEGIN');\n      for (let i = 0; i < nodes.length; i++) {\n        const node = nodes[i]!;\n        const embedding = embeddings[i]!;\n        const vecLiteral = `vector32('[${Array.from(embedding).join(',')}]')`;\n        const stmt = this.db.prepare(`\n          INSERT INTO kg_nodes (node_id, name, kind, file_path, signature, embedding)\n          VALUES (?, ?, ?, ?, ?, ${vecLiteral})\n          ON CONFLICT (node_id) DO UPDATE SET\n            name      = excluded.name,\n            kind      = excluded.kind,\n            file_path = excluded.file_path,\n            signature = excluded.signature,\n            embedding = excluded.embedding\n        `);\n        await stmt.run(\n          node.id,\n          node.name,\n          node.kind,\n          node.filePath,\n          node.signature ?? '',\n        );\n      }\n      await this.db.exec('COMMIT');\n    } catch (err) {\n      try { await this.db.exec('ROLLBACK'); } catch { /* ignore */ }\n      logWarn('TursoIndex: bulkUpsert failed', { count: nodes.length, 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.db) return;\n\n    try {\n      const stmt = this.db.prepare('DELETE FROM kg_nodes WHERE node_id = ?');\n      await stmt.run(nodeId);\n    } catch (err) {\n      logWarn('TursoIndex: delete failed', { nodeId, error: String(err) });\n    }\n  }\n\n  /**\n   * Hybrid search: combines Turso native vector_distance_cos with Tantivy FTS.\n   * Returns node IDs ordered by combined score.\n   *\n   * Score = VECTOR_WEIGHT * (1 - cosine_distance) + FTS_WEIGHT * fts_score\n   *\n   * Falls back to pure vector search when the query text produces no FTS matches\n   * or when FTS is not available.\n   */\n  async search(queryText: string, queryVec: Float32Array, topN = 10): Promise<string[]> {\n    if (!this._available || !this.db) return [];\n\n    const vecLiteral = `vector32('[${Array.from(queryVec).join(',')}]')`;\n\n    // Try hybrid search first\n    try {\n      const stmt = this.db.prepare(`\n        SELECT\n          n.node_id,\n          (${VECTOR_WEIGHT} * (1.0 - vector_distance_cos(n.embedding, ${vecLiteral}))\n           + ${FTS_WEIGHT} * COALESCE(fts_score(n.name, n.signature, ?), 0.0)\n          ) AS score\n        FROM kg_nodes n\n        WHERE n.embedding IS NOT NULL\n        ORDER BY score DESC\n        LIMIT ?\n      `);\n      const rows = await stmt.all(queryText, topN);\n\n      if (rows && rows.length > 0) {\n        return rows.map((r: any) => r.node_id as string);\n      }\n    } catch {\n      // FTS functions may not be available \u2014 fall back to pure vector\n      logDebug('TursoIndex: hybrid search unavailable, using pure vector');\n    }\n\n    // Fallback: pure vector search\n    return this.vectorSearch(queryVec, topN);\n  }\n\n  /**\n   * Pure vector similarity search using Turso's native vector_distance_cos.\n   */\n  private async vectorSearch(queryVec: Float32Array, topN: number): Promise<string[]> {\n    const vecLiteral = `vector32('[${Array.from(queryVec).join(',')}]')`;\n    try {\n      const stmt = this.db.prepare(`\n        SELECT node_id, vector_distance_cos(embedding, ${vecLiteral}) AS distance\n        FROM kg_nodes\n        WHERE embedding IS NOT NULL\n        ORDER BY distance ASC\n        LIMIT ?\n      `);\n      const rows = await stmt.all(topN);\n      return (rows ?? []).map((r: any) => r.node_id as string);\n    } catch (err) {\n      logWarn('TursoIndex: vector 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.db) return [];\n    try {\n      const stmt = this.db.prepare('SELECT node_id FROM kg_nodes');\n      const rows = await stmt.all();\n      return (rows ?? []).map((r: any) => r.node_id 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      const stmt = this.db.prepare('SELECT COUNT(*) AS c FROM kg_nodes');\n      const row = await stmt.get();\n      return row ? (row as any).c : 0;\n    } catch {\n      return 0;\n    }\n  }\n\n  /** Close the database connection and release resources. */\n  close(): void {\n    // @tursodatabase/database may not have a sync close \u2014 best-effort\n    if (this.db) {\n      try {\n        if (typeof this.db.close === 'function') this.db.close();\n      } catch { /* ignore */ }\n      this.db = null;\n      this._available = false;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kirograph",
-  "version": "0.28.1",
+  "version": "1.0.0",
   "description": "Semantic code knowledge graph for Kiro: fewer tool calls, instant symbol lookups, 100% local.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,6 +25,7 @@
     "test:git": "bash test/git/test.sh",
     "test:graph": "bash test/graph/test.sh",
     "test:health": "bash test/health/test.sh",
+    "test:hooks": "bash test/hooks/test.sh",
     "test:insights": "bash test/insights/test.sh",
     "test:mem": "bash test/mem/test.sh",
     "test:patterns": "bash test/patterns/test.sh",
@@ -34,7 +35,7 @@
     "test:watchmen": "bash test/watchmen/test.sh",
     "test:watchmen:skip-llm": "bash test/watchmen/test.sh --skip-llm",
     "test:wiki": "bash test/wiki/test.sh",
-    "test:integration": "bash test/agent/test.sh --no-build && bash test/architecture/test.sh --no-build && bash test/branch/test.sh --no-build && bash test/data/test.sh --no-build && bash test/edit/test.sh --no-build && bash test/git/test.sh --no-build && bash test/graph/test.sh --no-build && bash test/health/test.sh --no-build && bash test/insights/test.sh --no-build && bash test/mem/test.sh --no-build && bash test/patterns/test.sh --no-build && bash test/security/test.sh --no-build && bash test/turboquant/test.sh --no-build && bash test/turbovec/test.sh --no-build && bash test/watchmen/test.sh --no-build --skip-llm && bash test/wiki/test.sh --no-build",
+    "test:integration": "bash test/agent/test.sh --no-build && bash test/architecture/test.sh --no-build && bash test/branch/test.sh --no-build && bash test/data/test.sh --no-build && bash test/edit/test.sh --no-build && bash test/git/test.sh --no-build && bash test/graph/test.sh --no-build && bash test/health/test.sh --no-build && bash test/hooks/test.sh --no-build && bash test/insights/test.sh --no-build && bash test/mem/test.sh --no-build && bash test/patterns/test.sh --no-build && bash test/security/test.sh --no-build && bash test/turboquant/test.sh --no-build && bash test/turbovec/test.sh --no-build && bash test/watchmen/test.sh --no-build --skip-llm && bash test/wiki/test.sh --no-build",
     "test:agent:mcp": "bash test/agent/mcp.sh",
     "test:architecture:mcp": "bash test/architecture/mcp.sh",
     "test:branch:mcp": "bash test/branch/mcp.sh",