@bhimudev/gnanai 0.4.0

package/dist/mcp/search-index.d.ts

@@ -0,0 +1,45 @@
+import type { KnowledgeEntry } from './knowledge-utils.js';
+/**
+ * Options for search queries.
+ */
+export interface SearchOptions {
+    /** Filter results to a specific category. */
+    category?: string;
+    /** Maximum number of results to return (default: 5). */
+    limit?: number;
+}
+/**
+ * A single search result with match context and relevance score.
+ */
+export interface SearchResult {
+    /** Entry ID (filename without .md). */
+    id: string;
+    /** Entry title. */
+    title: string;
+    /** Entry category (decisions, patterns, etc.). */
+    category: string;
+    /** Highlighted match context snippet. */
+    snippet: string;
+    /** Relevance score (lower = more relevant for BM25, higher = more relevant for MiniSearch). */
+    score: number;
+    /** True when semantic search was unavailable and results are keyword-only fallback. */
+    degraded?: boolean;
+}
+/**
+ * Abstract search index interface.
+ * Both SQLite FTS5 and MiniSearch implementations conform to this.
+ */
+export interface SearchIndex {
+    /** Full-text search with optional category filter and result limit. */
+    search(query: string, options?: SearchOptions): SearchResult[];
+    /** Add or update an entry in the index. */
+    add(entry: KnowledgeEntry): void;
+    /** Remove an entry from the index by ID. */
+    remove(id: string): void;
+    /** Rebuild the entire index from the given entries. */
+    rebuild(entries: KnowledgeEntry[]): void;
+    /** Close the index and release resources. */
+    close(): void;
+}
+export type { KnowledgeEntry };
+//# sourceMappingURL=search-index.d.ts.map

package/dist/mcp/search-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../src/mcp/search-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE,CAAC;IAE/D,2CAA2C;IAC3C,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAEjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,uDAAuD;IACvD,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEzC,6CAA6C;IAC7C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/mcp/search-index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-index.js.map

package/dist/mcp/search-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.js","sourceRoot":"","sources":["../../src/mcp/search-index.ts"],"names":[],"mappings":""}

package/dist/mcp/search-minisearch.d.ts

@@ -0,0 +1,46 @@
+import type { SearchIndex, SearchOptions, SearchResult, KnowledgeEntry } from './search-index.js';
+interface MiniSearchConstructor {
+    new <T>(options: MiniSearchOptions<T>): MiniSearchInstance<T>;
+}
+interface MiniSearchOptions<T> {
+    fields: string[];
+    storeFields?: string[];
+    searchOptions?: {
+        boost?: Record<string, number>;
+        fuzzy?: number | boolean;
+        prefix?: boolean;
+    };
+    idField?: string;
+}
+interface MiniSearchInstance<T> {
+    search(query: string, options?: {
+        boost?: Record<string, number>;
+        fuzzy?: number | boolean;
+        prefix?: boolean;
+    }): Array<{
+        id: string;
+        score: number;
+        match: Record<string, string[]>;
+    } & Record<string, unknown>>;
+    add(doc: T): void;
+    remove(doc: T): void;
+    removeAll(): void;
+    addAll(docs: T[]): void;
+}
+/**
+ * MiniSearch-backed search index (pure JS fallback).
+ * Used when better-sqlite3 is not available.
+ */
+export declare class MiniSearchIndex implements SearchIndex {
+    private index;
+    private docs;
+    constructor(MiniSearch: MiniSearchConstructor);
+    search(query: string, options?: SearchOptions): SearchResult[];
+    add(entry: KnowledgeEntry): void;
+    remove(id: string): void;
+    rebuild(entries: KnowledgeEntry[]): void;
+    close(): void;
+    private generateSnippet;
+}
+export {};
+//# sourceMappingURL=search-minisearch.d.ts.map

package/dist/mcp/search-minisearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-minisearch.d.ts","sourceRoot":"","sources":["../../src/mcp/search-minisearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGlG,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED,UAAU,iBAAiB,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE;QACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjN,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,SAAS,IAAI,IAAI,CAAC;IAClB,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;CACzB;AAUD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,IAAI,CAAoD;gBAEpD,UAAU,EAAE,qBAAqB;IAS7C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IA4B9D,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAqBhC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUxB,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAQxC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/mcp/search-minisearch.js

@@ -0,0 +1,99 @@
+/**
+ * MiniSearch-backed search index (pure JS fallback).
+ * Used when better-sqlite3 is not available.
+ */
+export class MiniSearchIndex {
+    index;
+    docs;
+    constructor(MiniSearch) {
+        this.index = new MiniSearch({
+            fields: ['title', 'content', 'tags'],
+            storeFields: ['id', 'title', 'category'],
+            idField: 'id',
+        });
+        this.docs = new Map();
+    }
+    search(query, options) {
+        const limit = options?.limit ?? 5;
+        let results = this.index.search(query, {
+            boost: { title: 2, content: 1, tags: 1.5 },
+            fuzzy: 0.2,
+            prefix: true,
+        });
+        if (options?.category) {
+            results = results.filter(r => {
+                const doc = this.docs.get(r.id);
+                return doc && doc.category === options.category;
+            });
+        }
+        return results.slice(0, limit).map(r => {
+            const doc = this.docs.get(r.id);
+            return {
+                id: r.id,
+                title: doc?.title ?? '',
+                category: doc?.category ?? '',
+                snippet: this.generateSnippet(doc?.fullContent ?? '', query),
+                score: r.score,
+            };
+        });
+    }
+    add(entry) {
+        const doc = {
+            id: entry.id,
+            title: entry.title,
+            content: entry.content,
+            tags: entry.tags?.join(', ') ?? '',
+            category: entry.category,
+        };
+        // Remove existing if present (MiniSearch doesn't support upsert)
+        if (this.docs.has(entry.id)) {
+            try {
+                const oldDoc = this.docs.get(entry.id);
+                this.index.remove({ id: oldDoc.id, title: oldDoc.title, content: oldDoc.fullContent, tags: oldDoc.tags ?? '', category: oldDoc.category });
+            }
+            catch { /* ignore remove errors */ }
+        }
+        this.index.add(doc);
+        this.docs.set(entry.id, { ...doc, fullContent: entry.content, tags: entry.tags?.join(', ') ?? '' });
+    }
+    remove(id) {
+        const doc = this.docs.get(id);
+        if (doc) {
+            try {
+                this.index.remove({ id: doc.id, title: doc.title, content: doc.fullContent, tags: doc.tags ?? '', category: doc.category });
+            }
+            catch { /* ignore */ }
+            this.docs.delete(id);
+        }
+    }
+    rebuild(entries) {
+        this.index.removeAll();
+        this.docs.clear();
+        for (const entry of entries) {
+            this.add(entry);
+        }
+    }
+    close() {
+        // No-op for in-memory index
+    }
+    generateSnippet(content, query) {
+        const terms = query.toLowerCase().split(/\s+/).filter(t => t.length > 2 && !['and', 'or', 'not'].includes(t));
+        const lowerContent = content.toLowerCase();
+        for (const term of terms) {
+            const idx = lowerContent.indexOf(term);
+            if (idx >= 0) {
+                const start = Math.max(0, idx - 40);
+                const end = Math.min(content.length, idx + term.length + 40);
+                let snippet = content.slice(start, end);
+                if (start > 0)
+                    snippet = '...' + snippet;
+                if (end < content.length)
+                    snippet = snippet + '...';
+                return snippet;
+            }
+        }
+        // No match found in content, return first 80 chars
+        return content.length > 80 ? content.slice(0, 80) + '...' : content;
+    }
+}
+//# sourceMappingURL=search-minisearch.js.map

package/dist/mcp/search-minisearch.js.map

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

package/dist/mcp/search-sqlite.d.ts

@@ -0,0 +1,30 @@
+import type { SearchIndex, SearchOptions, SearchResult, KnowledgeEntry } from './search-index.js';
+type DatabaseConstructor = new (filename: string) => DatabaseInstance;
+interface DatabaseInstance {
+    pragma(pragma: string): unknown;
+    exec(sql: string): void;
+    prepare(sql: string): Statement;
+    close(): void;
+}
+interface Statement {
+    run(...params: unknown[]): unknown;
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+}
+export declare class SqliteSearchIndex implements SearchIndex {
+    private db;
+    constructor(db: DatabaseInstance);
+    search(query: string, options?: SearchOptions): SearchResult[];
+    add(entry: KnowledgeEntry): void;
+    remove(id: string): void;
+    rebuild(entries: KnowledgeEntry[]): void;
+    close(): void;
+}
+export declare function needsRebuild(dbPath: string, groupPath: string): Promise<boolean>;
+export declare function openOrCreateDb(dbPath: string, Database: DatabaseConstructor, groupPath: string): Promise<{
+    db: DatabaseInstance;
+    wasRebuilt: boolean;
+}>;
+export declare function createSqliteSearchIndex(groupPath: string, Database: DatabaseConstructor, entries: KnowledgeEntry[]): Promise<SqliteSearchIndex>;
+export {};
+//# sourceMappingURL=search-sqlite.d.ts.map

package/dist/mcp/search-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-sqlite.d.ts","sourceRoot":"","sources":["../../src/mcp/search-sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMlG,KAAK,mBAAmB,GAAG,KAAK,QAAQ,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAEtE,UAAU,gBAAgB;IACxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,UAAU,SAAS;IACjB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC;AAkDD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,EAAE,CAAmB;gBAEjB,EAAE,EAAE,gBAAgB;IAIhC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IAuB9D,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQhC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAUxC,KAAK,IAAI,IAAI;CAGd;AAMD,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAStF;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,EAAE,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CA8BxD;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAiB5B"}

package/dist/mcp/search-sqlite.js

@@ -0,0 +1,188 @@
+import fsSync from 'node:fs';
+import fs from 'fs-extra';
+import path from 'path';
+import { listEntryFiles, parseEntry } from './knowledge-utils.js';
+const SCHEMA_SQL = [
+    'CREATE TABLE IF NOT EXISTS entries (',
+    '  id TEXT PRIMARY KEY,',
+    '  category TEXT NOT NULL,',
+    '  title TEXT NOT NULL,',
+    '  content TEXT NOT NULL,',
+    '  tags TEXT,',
+    '  source_repo TEXT,',
+    '  created TEXT NOT NULL',
+    ');',
+    '',
+    'CREATE VIRTUAL TABLE IF NOT EXISTS entries_fts USING fts5(',
+    '  title, content, tags,',
+    "  content='entries',",
+    "  content_rowid='rowid',",
+    "  tokenize='porter unicode61'",
+    ');',
+    '',
+    'CREATE TRIGGER IF NOT EXISTS entries_ai AFTER INSERT ON entries BEGIN',
+    '  INSERT INTO entries_fts(rowid, title, content, tags) VALUES (new.rowid, new.title, new.content, new.tags);',
+    'END;',
+    '',
+    'CREATE TRIGGER IF NOT EXISTS entries_au AFTER UPDATE ON entries BEGIN',
+    "  INSERT INTO entries_fts(entries_fts, rowid, title, content, tags) VALUES ('delete', old.rowid, old.title, old.content, old.tags);",
+    '  INSERT INTO entries_fts(rowid, title, content, tags) VALUES (new.rowid, new.title, new.content, new.tags);',
+    'END;',
+    '',
+    'CREATE TRIGGER IF NOT EXISTS entries_ad AFTER DELETE ON entries BEGIN',
+    "  INSERT INTO entries_fts(entries_fts, rowid, title, content, tags) VALUES ('delete', old.rowid, old.title, old.content, old.tags);",
+    'END;',
+].join('\n');
+const SEARCH_SQL = [
+    'SELECT e.id, e.title, e.category,',
+    "  snippet(entries_fts, 1, '>>', '<<', '...', 30) as snippet,",
+    '  bm25(entries_fts) as score',
+    'FROM entries e',
+    'JOIN entries_fts ON e.rowid = entries_fts.rowid',
+    'WHERE entries_fts MATCH ?',
+    '  AND (? IS NULL OR e.category = ?)',
+    'ORDER BY score',
+    'LIMIT ?',
+].join('\n');
+const INSERT_SQL = 'INSERT OR REPLACE INTO entries (id, category, title, content, tags, source_repo, created) VALUES (?, ?, ?, ?, ?, ?, ?)';
+const DELETE_SQL = 'DELETE FROM entries WHERE id = ?';
+export class SqliteSearchIndex {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    search(query, options) {
+        if (!query || !query.trim())
+            return [];
+        const category = options?.category ?? null;
+        const limit = options?.limit ?? 5;
+        try {
+            const rows = this.db.prepare(SEARCH_SQL).all(query, category, category, limit);
+            return rows.map(row => ({
+                id: row.id, title: row.title, category: row.category,
+                snippet: row.snippet, score: row.score,
+            }));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('fts5')) {
+                throw new Error('Invalid search query syntax. Supported: keywords, phrase search, prefix*, AND/OR/NOT. Details: ' + message);
+            }
+            throw err;
+        }
+    }
+    add(entry) {
+        const tags = entry.tags?.join(', ') ?? '';
+        this.db.prepare(INSERT_SQL).run(entry.id, entry.category, entry.title, entry.content, tags, entry.source_repo ?? null, entry.created);
+    }
+    remove(id) {
+        this.db.prepare(DELETE_SQL).run(id);
+    }
+    rebuild(entries) {
+        this.db.exec('DELETE FROM entries');
+        this.db.exec("INSERT INTO entries_fts(entries_fts) VALUES('rebuild')");
+        const stmt = this.db.prepare(INSERT_SQL);
+        for (const entry of entries) {
+            const tags = entry.tags?.join(', ') ?? '';
+            stmt.run(entry.id, entry.category, entry.title, entry.content, tags, entry.source_repo ?? null, entry.created);
+        }
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch { /* ignore */ }
+    }
+}
+function createSchema(db) {
+    db.exec(SCHEMA_SQL);
+}
+export async function needsRebuild(dbPath, groupPath) {
+    if (!(await fs.pathExists(dbPath)))
+        return true;
+    let dbMtime;
+    try {
+        dbMtime = (await fs.stat(dbPath)).mtimeMs;
+    }
+    catch {
+        return true;
+    }
+    const files = await listEntryFiles(groupPath);
+    for (const file of files) {
+        try {
+            if ((await fs.stat(file)).mtimeMs > dbMtime)
+                return true;
+        }
+        catch { /* skip */ }
+    }
+    return false;
+}
+export async function openOrCreateDb(dbPath, Database, groupPath) {
+    let openedDb = null;
+    try {
+        openedDb = new Database(dbPath);
+        openedDb.pragma('journal_mode=WAL');
+        const check = openedDb.pragma('integrity_check');
+        if (check.length > 0 && check[0].integrity_check !== 'ok')
+            throw new Error('Integrity check failed');
+        createSchema(openedDb);
+        return { db: openedDb, wasRebuilt: false };
+    }
+    catch (err) {
+        // Close handle before deleting (required on Windows to avoid EBUSY)
+        if (openedDb)
+            try {
+                openedDb.close();
+            }
+            catch { /* ignore */ }
+        process.stderr.write('Index corrupt, rebuilding: ' + (err instanceof Error ? err.message : String(err)) + '\n');
+        try {
+            fsSync.unlinkSync(dbPath);
+        }
+        catch { /* ignore */ }
+        try {
+            fsSync.unlinkSync(dbPath + '-wal');
+        }
+        catch { /* ignore */ }
+        try {
+            fsSync.unlinkSync(dbPath + '-shm');
+        }
+        catch { /* ignore */ }
+        const db = new Database(dbPath);
+        db.pragma('journal_mode=WAL');
+        createSchema(db);
+        const files = await listEntryFiles(groupPath);
+        const insertStmt = db.prepare(INSERT_SQL);
+        for (const file of files) {
+            try {
+                const entry = await parseEntry(file);
+                const tags = entry.tags?.join(', ') ?? '';
+                insertStmt.run(entry.id, entry.category, entry.title, entry.content, tags, entry.source_repo ?? null, entry.created);
+            }
+            catch { /* skip malformed */ }
+        }
+        return { db, wasRebuilt: true };
+    }
+}
+export async function createSqliteSearchIndex(groupPath, Database, entries) {
+    const dbPath = path.join(groupPath, '.index.db');
+    const { db, wasRebuilt } = await openOrCreateDb(dbPath, Database, groupPath);
+    const index = new SqliteSearchIndex(db);
+    if (!wasRebuilt) {
+        const stale = await needsRebuild(dbPath, groupPath);
+        if (stale) {
+            index.rebuild(entries);
+        }
+        else if (entries.length > 0) {
+            // Check if DB is empty (e.g., newly created) and needs populating
+            try {
+                const row = db.prepare('SELECT COUNT(*) as cnt FROM entries').get();
+                if (!row || row.cnt === 0)
+                    index.rebuild(entries);
+            }
+            catch { /* table may not exist yet */ }
+        }
+    }
+    return index;
+}
+//# sourceMappingURL=search-sqlite.js.map

package/dist/mcp/search-sqlite.js.map

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

package/dist/mcp/vector-store.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Vector store for semantic search.
+ * Stores embedding vectors in a .vectors.json file per knowledge group.
+ * Uses brute-force cosine similarity for search (fast at 50-500 entries).
+ * Write operations are serialized via a mutex to prevent corruption.
+ */
+import type { EmbeddingEngine } from "./embeddings.js";
+import type { KnowledgeEntry } from "./knowledge-utils.js";
+export interface VectorEntry {
+    id: string;
+    vector: number[];
+    category: string;
+    title: string;
+    snippetText: string;
+}
+export interface VectorStoreData {
+    model: string;
+    dimensions: number;
+    entries: VectorEntry[];
+}
+export interface VectorSearchResult {
+    id: string;
+    title: string;
+    category: string;
+    snippet: string;
+    score: number;
+}
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export declare function truncateForSnippet(text: string, maxLen?: number): string;
+export declare class VectorStore {
+    private data;
+    private filePath;
+    private engine;
+    private writeLock;
+    private writeQueue;
+    constructor(filePath: string, engine: EmbeddingEngine);
+    get entryCount(): number;
+    has(id: string): boolean;
+    load(onRebuildNeeded?: () => Promise<KnowledgeEntry[]>): Promise<void>;
+    save(): Promise<void>;
+    add(id: string, vector: number[], metadata: {
+        category: string;
+        title: string;
+        content: string;
+    }): Promise<void>;
+    remove(id: string): Promise<void>;
+    search(queryVector: number[], topK?: number): VectorSearchResult[];
+    rebuild(entries: KnowledgeEntry[]): Promise<void>;
+    private acquireLock;
+    private releaseLock;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/mcp/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../src/mcp/vector-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAGrE;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAyB;gBAE/B,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe;IAUrD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlB,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CtE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBhH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,SAAI,GAAG,kBAAkB,EAAE;IAevD,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAmCzC,WAAW;IAUzB,OAAO,CAAC,WAAW;CAQpB"}