purecontext-mcp 1.0.1

package/dist/core/db/savings-store.js

@@ -0,0 +1,64 @@
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { StorageError } from '../errors.js';
+// ─── Path override (for testing) ─────────────────────────────────────────────
+let _pathOverride = null;
+let _dirInitialized = false;
+export function _setSavingsPathForTesting(path) {
+    _pathOverride = path;
+    _dirInitialized = false; // reset so the new dir is created on next save
+}
+function getSavingsPath() {
+    if (_pathOverride !== null)
+        return _pathOverride;
+    return join(homedir(), '.purecontext', '_savings.json');
+}
+function getSavingsDir() {
+    if (_pathOverride !== null)
+        return join(_pathOverride, '..');
+    return join(homedir(), '.purecontext');
+}
+function ensureDir() {
+    if (_dirInitialized)
+        return;
+    mkdirSync(getSavingsDir(), { recursive: true });
+    _dirInitialized = true;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+export function loadSavings() {
+    const path = getSavingsPath();
+    if (!existsSync(path)) {
+        return {
+            total_tokens_saved: 0,
+            anon_id: randomUUID(),
+            last_updated: new Date().toISOString(),
+        };
+    }
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            total_tokens_saved: typeof parsed.total_tokens_saved === 'number' ? parsed.total_tokens_saved : 0,
+            anon_id: parsed.anon_id ?? randomUUID(),
+            last_updated: parsed.last_updated ?? new Date().toISOString(),
+        };
+    }
+    catch (err) {
+        throw new StorageError('Failed to load savings data', 'loadSavings', err);
+    }
+}
+export function saveSavings(data) {
+    const path = getSavingsPath();
+    const tmpPath = `${path}.tmp`;
+    try {
+        ensureDir();
+        writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+        renameSync(tmpPath, path);
+    }
+    catch (err) {
+        throw new StorageError('Failed to save savings data', 'saveSavings', err);
+    }
+}
+//# sourceMappingURL=savings-store.js.map

package/dist/core/db/savings-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savings-store.js","sourceRoot":"","sources":["../../../src/core/db/savings-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAU5C,gFAAgF;AAEhF,IAAI,aAAa,GAAkB,IAAI,CAAC;AACxC,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,UAAU,yBAAyB,CAAC,IAAmB;IAC3D,aAAa,GAAG,IAAI,CAAC;IACrB,eAAe,GAAG,KAAK,CAAC,CAAC,+CAA+C;AAC1E,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,aAAa,CAAC;IACjD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,eAAe;QAAE,OAAO;IAC5B,SAAS,CAAC,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAE9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,kBAAkB,EAAE,CAAC;YACrB,OAAO,EAAE,UAAU,EAAE;YACrB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACvD,OAAO;YACL,kBAAkB,EAAE,OAAO,MAAM,CAAC,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACjG,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,EAAE;YACvC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,6BAA6B,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC;IAE9B,IAAI,CAAC;QACH,SAAS,EAAE,CAAC;QACZ,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,6BAA6B,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC"}

package/dist/core/db/schema.d.ts

@@ -0,0 +1,14 @@
+import type { RepoMetadata } from '../types.js';
+import type _BetterSqlite3 from 'better-sqlite3';
+type DatabaseConstructor = typeof _BetterSqlite3;
+export declare const SCHEMA_VERSION = 3;
+export declare function computeRepoId(absolutePath: string): string;
+export declare function getIndexDir(): string;
+export declare function openDatabase(repoId: string, indexDir?: string): InstanceType<DatabaseConstructor>;
+export declare function openInMemoryDatabase(): InstanceType<DatabaseConstructor>;
+export declare function initializeDatabase(db: InstanceType<DatabaseConstructor>): void;
+export declare function upsertRepo(db: InstanceType<DatabaseConstructor>, meta: RepoMetadata): void;
+export declare function getRepo(db: InstanceType<DatabaseConstructor>, repoId: string): RepoMetadata | null;
+export declare function listRepos(db: InstanceType<DatabaseConstructor>): RepoMetadata[];
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/core/db/schema.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,OAAO,KAAK,cAAc,MAAM,gBAAgB,CAAC;AACjD,KAAK,mBAAmB,GAAG,OAAO,cAAc,CAAC;AAoBjD,eAAO,MAAM,cAAc,IAAI,CAAC;AA4EhC,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAOjG;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAAC,mBAAmB,CAAC,CAKxE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAI9E;AAuED,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAwB1F;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKlG;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,mBAAmB,CAAC,GAAG,YAAY,EAAE,CAE/E"}

package/dist/core/db/schema.js

@@ -0,0 +1,235 @@
+import { createRequire } from 'module';
+import { createHash } from 'crypto';
+import { mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { EMBEDDINGS_DDL } from './embedding-store.js';
+import { NativeDependencyError } from '../errors.js';
+// ─── Lazy-load better-sqlite3 ─────────────────────────────────────────────────
+// We defer the native-addon load so any binary mismatch throws a
+// NativeDependencyError (with an actionable user message) rather than an
+// opaque module-load crash.
+const _require = createRequire(import.meta.url);
+let _Database = null;
+let _dbLoadError = null;
+let _dbLoaded = false;
+function getDatabase() {
+    if (!_dbLoaded) {
+        try {
+            _Database = _require('better-sqlite3');
+        }
+        catch (err) {
+            _dbLoadError = err;
+        }
+        _dbLoaded = true;
+    }
+    if (_dbLoadError !== null || _Database === null) {
+        throw new NativeDependencyError(_dbLoadError);
+    }
+    return _Database;
+}
+export const SCHEMA_VERSION = 3;
+const DDL = `
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS repos (
+  id              TEXT    PRIMARY KEY,
+  root_path       TEXT    NOT NULL UNIQUE,
+  symbol_count    INTEGER NOT NULL DEFAULT 0,
+  file_count      INTEGER NOT NULL DEFAULT 0,
+  languages       TEXT    NOT NULL DEFAULT '[]',
+  indexed_at      INTEGER NOT NULL,
+  schema_version  INTEGER NOT NULL,
+  tenant_id       TEXT    NOT NULL DEFAULT 'local'
+);
+
+CREATE TABLE IF NOT EXISTS files (
+  repo_id       TEXT    NOT NULL,
+  path          TEXT    NOT NULL,
+  content_hash  TEXT    NOT NULL,
+  raw_content   BLOB,
+  indexed_at    INTEGER NOT NULL,
+  tenant_id     TEXT    NOT NULL DEFAULT 'local',
+  PRIMARY KEY (repo_id, path),
+  FOREIGN KEY (repo_id) REFERENCES repos(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS symbols (
+  id             TEXT    NOT NULL,
+  repo_id        TEXT    NOT NULL,
+  name           TEXT    NOT NULL,
+  kind           TEXT    NOT NULL,
+  file_path      TEXT    NOT NULL,
+  start_byte     INTEGER NOT NULL,
+  end_byte       INTEGER NOT NULL,
+  signature      TEXT    NOT NULL DEFAULT '',
+  summary        TEXT    NOT NULL DEFAULT '',
+  framework_meta TEXT,
+  indexed_at     INTEGER NOT NULL,
+  tenant_id      TEXT    NOT NULL DEFAULT 'local',
+  PRIMARY KEY (id, repo_id),
+  FOREIGN KEY (repo_id) REFERENCES repos(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS dep_edges (
+  id               INTEGER PRIMARY KEY AUTOINCREMENT,
+  repo_id          TEXT NOT NULL,
+  source_file      TEXT NOT NULL,
+  source_symbol_id TEXT,
+  target_file      TEXT NOT NULL,
+  target_symbol_id TEXT,
+  edge_type        TEXT NOT NULL,
+  specifier        TEXT NOT NULL,
+  tenant_id        TEXT NOT NULL DEFAULT 'local',
+  FOREIGN KEY (repo_id) REFERENCES repos(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_symbols_repo_name     ON symbols(repo_id, name);
+CREATE INDEX IF NOT EXISTS idx_symbols_repo_file     ON symbols(repo_id, file_path);
+CREATE INDEX IF NOT EXISTS idx_symbols_repo_kind     ON symbols(repo_id, kind);
+CREATE INDEX IF NOT EXISTS idx_dep_edges_source      ON dep_edges(repo_id, source_file);
+CREATE INDEX IF NOT EXISTS idx_dep_edges_target      ON dep_edges(repo_id, target_file);
+CREATE INDEX IF NOT EXISTS idx_dep_edges_target_sym  ON dep_edges(repo_id, target_symbol_id)
+  WHERE target_symbol_id IS NOT NULL;
+
+CREATE VIRTUAL TABLE IF NOT EXISTS fts_symbols USING fts5(
+  symbol_id UNINDEXED,
+  repo_id   UNINDEXED,
+  content,
+  tokenize  = 'porter ascii'
+);
+`;
+// ─── Database factory ─────────────────────────────────────────────────────────
+export function computeRepoId(absolutePath) {
+    return createHash('sha256').update(absolutePath).digest('hex').slice(0, 16);
+}
+export function getIndexDir() {
+    const dataDir = process.env['PCTX_DATA_DIR'];
+    if (dataDir)
+        return join(dataDir, 'indexes');
+    return join(homedir(), '.purecontext', 'indexes');
+}
+export function openDatabase(repoId, indexDir) {
+    const DB = getDatabase();
+    const dir = indexDir ?? getIndexDir();
+    mkdirSync(dir, { recursive: true });
+    const db = new DB(join(dir, `${repoId}.db`));
+    initializeDatabase(db);
+    return db;
+}
+export function openInMemoryDatabase() {
+    const DB = getDatabase();
+    const db = new DB(':memory:');
+    initializeDatabase(db);
+    return db;
+}
+export function initializeDatabase(db) {
+    db.exec(DDL);
+    db.exec(EMBEDDINGS_DDL);
+    runMigrations(db);
+}
+// ─── Migrations ───────────────────────────────────────────────────────────────
+function runMigrations(db) {
+    // Read the highest schema_version present in repos (if any rows exist).
+    // If the table is empty or new, no migration needed — rows are written at
+    // SCHEMA_VERSION by callers.
+    const row = db.prepare('SELECT MAX(schema_version) AS v FROM repos').get();
+    const dbVersion = row?.v ?? 0;
+    // Migration v1 → v2: add clone_path column to repos table.
+    if (dbVersion < 2) {
+        // SQLite doesn't support IF NOT EXISTS for ADD COLUMN — check first.
+        const repoCols = db.prepare("PRAGMA table_info(repos)").all();
+        if (!repoCols.some((c) => c.name === 'clone_path')) {
+            db.exec('ALTER TABLE repos ADD COLUMN clone_path TEXT');
+        }
+        // Add embedding column to symbols table.
+        const symCols = db.prepare("PRAGMA table_info(symbols)").all();
+        if (!symCols.some((c) => c.name === 'embedding')) {
+            db.exec('ALTER TABLE symbols ADD COLUMN embedding BLOB');
+        }
+        // The fts_symbols virtual table is created by the DDL above (IF NOT EXISTS).
+    }
+    // Migration v2 → v3: add tenant_id to all data tables.
+    // Existing rows migrate to the default 'local' tenant.
+    if (dbVersion < 3) {
+        const repoCols = db.prepare("PRAGMA table_info(repos)").all();
+        if (!repoCols.some((c) => c.name === 'tenant_id')) {
+            db.exec("ALTER TABLE repos ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'local'");
+        }
+        const fileCols = db.prepare("PRAGMA table_info(files)").all();
+        if (!fileCols.some((c) => c.name === 'tenant_id')) {
+            db.exec("ALTER TABLE files ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'local'");
+        }
+        const symCols = db.prepare("PRAGMA table_info(symbols)").all();
+        if (!symCols.some((c) => c.name === 'tenant_id')) {
+            db.exec("ALTER TABLE symbols ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'local'");
+        }
+        const edgeCols = db.prepare("PRAGMA table_info(dep_edges)").all();
+        if (!edgeCols.some((c) => c.name === 'tenant_id')) {
+            db.exec("ALTER TABLE dep_edges ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'local'");
+        }
+        // Add tenant_id to embeddings table (created by EMBEDDINGS_DDL, not DDL above).
+        const embCols = db.prepare("PRAGMA table_info(embeddings)").all();
+        if (embCols.length > 0 && !embCols.some((c) => c.name === 'tenant_id')) {
+            db.exec("ALTER TABLE embeddings ADD COLUMN tenant_id TEXT NOT NULL DEFAULT 'local'");
+        }
+        // Add tenant index on symbols (may already exist on fresh DBs from DDL).
+        try {
+            db.exec('CREATE INDEX IF NOT EXISTS idx_symbols_tenant ON symbols(tenant_id, repo_id)');
+            db.exec('CREATE INDEX IF NOT EXISTS idx_files_tenant ON files(tenant_id, repo_id)');
+            db.exec('CREATE INDEX IF NOT EXISTS idx_dep_edges_tenant ON dep_edges(tenant_id, repo_id)');
+            db.exec('CREATE INDEX IF NOT EXISTS idx_embeddings_tenant ON embeddings(tenant_id, repo_id)');
+        }
+        catch {
+            // Indexes already exist — ignore
+        }
+    }
+}
+// ─── Repo operations ──────────────────────────────────────────────────────────
+export function upsertRepo(db, meta) {
+    db.prepare(`
+    INSERT INTO repos (id, root_path, symbol_count, file_count, languages, indexed_at, schema_version, clone_path, tenant_id)
+    VALUES (@id, @rootPath, @symbolCount, @fileCount, @languages, @indexedAt, @schemaVersion, @clonePath, @tenantId)
+    ON CONFLICT(id) DO UPDATE SET
+      root_path      = excluded.root_path,
+      symbol_count   = excluded.symbol_count,
+      file_count     = excluded.file_count,
+      languages      = excluded.languages,
+      indexed_at     = excluded.indexed_at,
+      schema_version = excluded.schema_version,
+      clone_path     = excluded.clone_path,
+      tenant_id      = excluded.tenant_id
+  `).run({
+        id: meta.id,
+        rootPath: meta.rootPath,
+        symbolCount: meta.symbolCount,
+        fileCount: meta.fileCount,
+        languages: JSON.stringify(meta.languages),
+        indexedAt: meta.indexedAt,
+        schemaVersion: meta.schemaVersion,
+        clonePath: meta.clonePath ?? null,
+        tenantId: meta.tenantId ?? 'local',
+    });
+}
+export function getRepo(db, repoId) {
+    const row = db.prepare('SELECT * FROM repos WHERE id = ?').get(repoId);
+    return row ? rowToRepo(row) : null;
+}
+export function listRepos(db) {
+    return db.prepare('SELECT * FROM repos ORDER BY indexed_at DESC').all().map(rowToRepo);
+}
+function rowToRepo(row) {
+    return {
+        id: row.id,
+        rootPath: row.root_path,
+        symbolCount: row.symbol_count,
+        fileCount: row.file_count,
+        languages: JSON.parse(row.languages),
+        indexedAt: row.indexed_at,
+        schemaVersion: row.schema_version,
+        clonePath: row.clone_path ?? null,
+        tenantId: row.tenant_id ?? 'local',
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/db/schema.js.map

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

package/dist/core/db/symbol-store.d.ts

@@ -0,0 +1,64 @@
+import type Database from 'better-sqlite3';
+import type { SymbolRecord, SymbolKind } from '../types.js';
+export interface SearchOptions {
+    kind?: SymbolKind;
+    filePath?: string;
+    limit?: number;
+    /** When provided, results are filtered to this tenant only. */
+    tenantId?: string;
+}
+export declare function insertSymbols(db: Database.Database, repoId: string, symbols: SymbolRecord[], tenantId?: string): void;
+export declare function searchSymbols(db: Database.Database, repoId: string, query: string, options?: SearchOptions): SymbolRecord[];
+export declare function getSymbolById(db: Database.Database, repoId: string, id: string, tenantId?: string): SymbolRecord | null;
+export declare function getSymbolsByFile(db: Database.Database, repoId: string, filePath: string, tenantId?: string): SymbolRecord[];
+export declare function getSymbolsByRepo(db: Database.Database, repoId: string, limit?: number, tenantId?: string): SymbolRecord[];
+export declare function deleteByFile(db: Database.Database, repoId: string, filePath: string): void;
+/**
+ * Store packed embedding bytes for a symbol.
+ * Embeddings are stored as raw Float32Array bytes (4 bytes per dimension).
+ */
+export declare function upsertEmbedding(db: Database.Database, repoId: string, symbolId: string, embedding: Buffer): void;
+/**
+ * Load all symbols that have stored embeddings for a repo.
+ * Returns { symbol, embedding } pairs.
+ */
+export declare function getSymbolsWithEmbeddings(db: Database.Database, repoId: string): Array<{
+    symbol: SymbolRecord;
+    embedding: Buffer;
+}>;
+/**
+ * Insert/replace a symbol into the FTS5 full-text search index.
+ * Content = name + signature + summary (space-joined for broad matching).
+ */
+export declare function upsertFtsSymbol(db: Database.Database, repoId: string, symbol: SymbolRecord): void;
+/**
+ * Bulk-insert symbols into the FTS5 index. Replaces any existing entries.
+ */
+export declare function bulkUpsertFtsSymbols(db: Database.Database, repoId: string, symbols: SymbolRecord[]): void;
+export interface FtsSearchOptions {
+    kind?: SymbolKind;
+    filePath?: string;
+    limit?: number;
+    tenantId?: string;
+}
+/**
+ * Search symbols using FTS5 full-text search.
+ * Returns matching SymbolRecords sorted by BM25 relevance (most relevant first).
+ */
+export declare function ftsSearchSymbols(db: Database.Database, repoId: string, query: string, options?: FtsSearchOptions): SymbolRecord[];
+/**
+ * Returns true if the FTS5 index has been populated for this repo.
+ * Used to decide whether to use FTS or fall back to LIKE search.
+ */
+export declare function hasFtsIndex(db: Database.Database, repoId: string): boolean;
+/**
+ * Delete FTS5 entries for all symbols in a file (called when a file is reindexed).
+ */
+export declare function deleteFtsByFile(db: Database.Database, repoId: string, filePath: string): void;
+/**
+ * Bulk-update the summary field for a set of symbols identified by id.
+ * Used by the AI summarizer (Stage 3) to apply generated summaries after
+ * indexing completes. Skips ids not present in the database.
+ */
+export declare function updateSymbolSummaries(db: Database.Database, repoId: string, summaries: Map<string, string>): void;
+//# sourceMappingURL=symbol-store.d.ts.map

package/dist/core/db/symbol-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-store.d.ts","sourceRoot":"","sources":["../../../src/core/db/symbol-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmB5D,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6BD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,SAAU,GACjB,IAAI,CA2CN;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,EAAE,CAyBhB;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,GAAG,IAAI,CAWrB;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,EAAE,CAehB;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,SAAO,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,EAAE,CAehB;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,IAAI,CAIN;AAUD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAUpD;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GACnB,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,EAAE,GACtB,IAAI,CAgBN;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,YAAY,EAAE,CA+BhB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,IAAI,CAgBN;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,IAAI,CAcN"}

package/dist/core/db/symbol-store.js

@@ -0,0 +1,243 @@
+import { StorageError } from '../errors.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Extract the file stem (basename without extension) from a relative file path. */
+function getFileStem(filePath) {
+    const base = filePath.replace(/\\/g, '/').split('/').pop() ?? filePath;
+    const dot = base.lastIndexOf('.');
+    return dot > 0 ? base.slice(0, dot) : base;
+}
+function rowToSymbol(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        kind: row.kind,
+        filePath: row.file_path,
+        startByte: row.start_byte,
+        endByte: row.end_byte,
+        signature: row.signature,
+        summary: row.summary,
+        frameworkMeta: row.framework_meta
+            ? JSON.parse(row.framework_meta)
+            : undefined,
+    };
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export function insertSymbols(db, repoId, symbols, tenantId = 'local') {
+    if (symbols.length === 0)
+        return;
+    const stmt = db.prepare(`
+    INSERT OR REPLACE INTO symbols
+      (id, repo_id, name, kind, file_path, start_byte, end_byte, signature, summary, framework_meta, indexed_at, tenant_id)
+    VALUES
+      (@id, @repoId, @name, @kind, @filePath, @startByte, @endByte, @signature, @summary, @frameworkMeta, @indexedAt, @tenantId)
+  `);
+    const now = Date.now();
+    const delFts = db.prepare('DELETE FROM fts_symbols WHERE symbol_id = ? AND repo_id = ?');
+    const insFts = db.prepare('INSERT INTO fts_symbols (symbol_id, repo_id, content) VALUES (?, ?, ?)');
+    const insert = db.transaction((rows) => {
+        for (const s of rows) {
+            try {
+                stmt.run({
+                    id: s.id,
+                    repoId,
+                    name: s.name,
+                    kind: s.kind,
+                    filePath: s.filePath,
+                    startByte: s.startByte,
+                    endByte: s.endByte,
+                    signature: s.signature,
+                    summary: s.summary,
+                    frameworkMeta: s.frameworkMeta ? JSON.stringify(s.frameworkMeta) : null,
+                    indexedAt: now,
+                    tenantId,
+                });
+                // Keep FTS5 index in sync
+                delFts.run(s.id, repoId);
+                insFts.run(s.id, repoId, `${s.name} ${getFileStem(s.filePath)} ${s.signature} ${s.summary}`);
+            }
+            catch (err) {
+                throw new StorageError(`Failed to insert symbol "${s.name}"`, 'insertSymbols', err);
+            }
+        }
+    });
+    insert(symbols);
+}
+export function searchSymbols(db, repoId, query, options = {}) {
+    const { kind, filePath, limit = 50, tenantId } = options;
+    const parts = ['repo_id = ?'];
+    const params = [repoId];
+    parts.push('name LIKE ?');
+    params.push(`%${query}%`);
+    if (kind) {
+        parts.push('kind = ?');
+        params.push(kind);
+    }
+    if (filePath) {
+        parts.push('file_path = ?');
+        params.push(filePath);
+    }
+    if (tenantId !== undefined) {
+        parts.push('tenant_id = ?');
+        params.push(tenantId);
+    }
+    const sql = `SELECT * FROM symbols WHERE ${parts.join(' AND ')} ORDER BY name LIMIT ?`;
+    params.push(limit);
+    return db.prepare(sql).all(...params).map(rowToSymbol);
+}
+export function getSymbolById(db, repoId, id, tenantId) {
+    if (tenantId !== undefined) {
+        const row = db.prepare('SELECT * FROM symbols WHERE repo_id = ? AND id = ? AND tenant_id = ?').get(repoId, id, tenantId);
+        return row ? rowToSymbol(row) : null;
+    }
+    const row = db.prepare('SELECT * FROM symbols WHERE repo_id = ? AND id = ?').get(repoId, id);
+    return row ? rowToSymbol(row) : null;
+}
+export function getSymbolsByFile(db, repoId, filePath, tenantId) {
+    if (tenantId !== undefined) {
+        return db
+            .prepare('SELECT * FROM symbols WHERE repo_id = ? AND file_path = ? AND tenant_id = ? ORDER BY start_byte')
+            .all(repoId, filePath, tenantId)
+            .map(rowToSymbol);
+    }
+    return db
+        .prepare('SELECT * FROM symbols WHERE repo_id = ? AND file_path = ? ORDER BY start_byte')
+        .all(repoId, filePath)
+        .map(rowToSymbol);
+}
+export function getSymbolsByRepo(db, repoId, limit = 1000, tenantId) {
+    if (tenantId !== undefined) {
+        return db
+            .prepare('SELECT * FROM symbols WHERE repo_id = ? AND tenant_id = ? ORDER BY file_path, start_byte LIMIT ?')
+            .all(repoId, tenantId, limit)
+            .map(rowToSymbol);
+    }
+    return db
+        .prepare('SELECT * FROM symbols WHERE repo_id = ? ORDER BY file_path, start_byte LIMIT ?')
+        .all(repoId, limit)
+        .map(rowToSymbol);
+}
+export function deleteByFile(db, repoId, filePath) {
+    // Remove from FTS first (needs symbol IDs which exist before main delete)
+    deleteFtsByFile(db, repoId, filePath);
+    db.prepare('DELETE FROM symbols WHERE repo_id = ? AND file_path = ?').run(repoId, filePath);
+}
+/**
+ * Store packed embedding bytes for a symbol.
+ * Embeddings are stored as raw Float32Array bytes (4 bytes per dimension).
+ */
+export function upsertEmbedding(db, repoId, symbolId, embedding) {
+    db.prepare('UPDATE symbols SET embedding = ? WHERE repo_id = ? AND id = ?').run(embedding, repoId, symbolId);
+}
+/**
+ * Load all symbols that have stored embeddings for a repo.
+ * Returns { symbol, embedding } pairs.
+ */
+export function getSymbolsWithEmbeddings(db, repoId) {
+    const rows = db
+        .prepare('SELECT * FROM symbols WHERE repo_id = ? AND embedding IS NOT NULL')
+        .all(repoId);
+    return rows
+        .filter((r) => r.embedding !== null)
+        .map((r) => ({ symbol: rowToSymbol(r), embedding: r.embedding }));
+}
+// ─── FTS5 operations ──────────────────────────────────────────────────────────
+/**
+ * Insert/replace a symbol into the FTS5 full-text search index.
+ * Content = name + signature + summary (space-joined for broad matching).
+ */
+export function upsertFtsSymbol(db, repoId, symbol) {
+    // Delete any existing entry first (FTS5 doesn't support UPSERT).
+    db.prepare('DELETE FROM fts_symbols WHERE symbol_id = ? AND repo_id = ?').run(symbol.id, repoId);
+    db.prepare('INSERT INTO fts_symbols (symbol_id, repo_id, content) VALUES (?, ?, ?)').run(symbol.id, repoId, `${symbol.name} ${getFileStem(symbol.filePath)} ${symbol.signature} ${symbol.summary}`);
+}
+/**
+ * Bulk-insert symbols into the FTS5 index. Replaces any existing entries.
+ */
+export function bulkUpsertFtsSymbols(db, repoId, symbols) {
+    if (symbols.length === 0)
+        return;
+    const del = db.prepare('DELETE FROM fts_symbols WHERE symbol_id = ? AND repo_id = ?');
+    const ins = db.prepare('INSERT INTO fts_symbols (symbol_id, repo_id, content) VALUES (?, ?, ?)');
+    const upsert = db.transaction((rows) => {
+        for (const s of rows) {
+            del.run(s.id, repoId);
+            ins.run(s.id, repoId, `${s.name} ${getFileStem(s.filePath)} ${s.signature} ${s.summary}`);
+        }
+    });
+    upsert(symbols);
+}
+/**
+ * Search symbols using FTS5 full-text search.
+ * Returns matching SymbolRecords sorted by BM25 relevance (most relevant first).
+ */
+export function ftsSearchSymbols(db, repoId, query, options = {}) {
+    const { kind, filePath, limit = 20, tenantId } = options;
+    const parts = ['f.repo_id = ?', 'fts_symbols MATCH ?'];
+    const params = [repoId, query];
+    if (tenantId !== undefined) {
+        parts.push('s.tenant_id = ?');
+        params.push(tenantId);
+    }
+    if (kind) {
+        parts.push('s.kind = ?');
+        params.push(kind);
+    }
+    if (filePath) {
+        parts.push('s.file_path LIKE ?');
+        params.push(filePath);
+    }
+    params.push(limit);
+    const sql = `
+    SELECT s.*
+    FROM symbols s
+    JOIN fts_symbols f ON f.symbol_id = s.id AND f.repo_id = s.repo_id
+    WHERE ${parts.join(' AND ')}
+    ORDER BY bm25(fts_symbols)
+    LIMIT ?
+  `;
+    return db.prepare(sql).all(...params).map(rowToSymbol);
+}
+/**
+ * Returns true if the FTS5 index has been populated for this repo.
+ * Used to decide whether to use FTS or fall back to LIKE search.
+ */
+export function hasFtsIndex(db, repoId) {
+    const row = db
+        .prepare('SELECT COUNT(*) AS c FROM fts_symbols WHERE repo_id = ?')
+        .get(repoId);
+    return (row?.c ?? 0) > 0;
+}
+/**
+ * Delete FTS5 entries for all symbols in a file (called when a file is reindexed).
+ */
+export function deleteFtsByFile(db, repoId, filePath) {
+    // Look up symbol IDs for this file, then delete from FTS.
+    const ids = db
+        .prepare('SELECT id FROM symbols WHERE repo_id = ? AND file_path = ?')
+        .all(repoId, filePath)
+        .map((r) => r.id);
+    const del = db.prepare('DELETE FROM fts_symbols WHERE symbol_id = ? AND repo_id = ?');
+    const cleanup = db.transaction((idList) => {
+        for (const id of idList) {
+            del.run(id, repoId);
+        }
+    });
+    cleanup(ids);
+}
+/**
+ * Bulk-update the summary field for a set of symbols identified by id.
+ * Used by the AI summarizer (Stage 3) to apply generated summaries after
+ * indexing completes. Skips ids not present in the database.
+ */
+export function updateSymbolSummaries(db, repoId, summaries) {
+    if (summaries.size === 0)
+        return;
+    const stmt = db.prepare('UPDATE symbols SET summary = ? WHERE repo_id = ? AND id = ?');
+    const update = db.transaction((entries) => {
+        for (const [id, summary] of entries) {
+            stmt.run(summary, repoId, id);
+        }
+    });
+    update([...summaries.entries()]);
+}
+//# sourceMappingURL=symbol-store.js.map