@soleri/core 2.12.0 → 7.0.0

package/dist/vault/linking.js

@@ -0,0 +1,275 @@
+/**
+ * LinkManager — Zettelkasten bidirectional linking for vault entries.
+ *
+ * Provides typed links between entries (supports, contradicts, extends, sequences),
+ * backlink traversal, graph walking, orphan detection, and link suggestions via FTS5.
+ *
+ * Ported from Salvador MCP with improvements:
+ * - Uses PersistenceProvider (not raw SQLite) for backend abstraction
+ * - Uses FTS5 for suggest_links (Salvador used TF-IDF cosine similarity)
+ * - Graceful degradation — all methods return empty on table-not-found
+ */
+export class LinkManager {
+    provider;
+    initialized = false;
+    constructor(provider) {
+        this.provider = provider;
+        this.ensureTable();
+    }
+    // ===========================================================================
+    // SCHEMA
+    // ===========================================================================
+    ensureTable() {
+        if (this.initialized)
+            return;
+        try {
+            this.provider.execSql(`
+        CREATE TABLE IF NOT EXISTS vault_links (
+          source_id TEXT NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
+          target_id TEXT NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
+          link_type TEXT NOT NULL CHECK(link_type IN ('supports', 'contradicts', 'extends', 'sequences')),
+          note TEXT,
+          created_at INTEGER NOT NULL,
+          PRIMARY KEY (source_id, target_id)
+        );
+        CREATE INDEX IF NOT EXISTS idx_links_target ON vault_links(target_id);
+        CREATE INDEX IF NOT EXISTS idx_links_type ON vault_links(link_type);
+      `);
+            this.initialized = true;
+        }
+        catch {
+            // Table may already exist or DB may be read-only — degrade gracefully
+        }
+    }
+    // ===========================================================================
+    // CRUD
+    // ===========================================================================
+    /** Create a typed link between two entries. */
+    addLink(sourceId, targetId, linkType, note) {
+        this.provider.run(`INSERT OR REPLACE INTO vault_links (source_id, target_id, link_type, note, created_at)
+       VALUES (?, ?, ?, ?, ?)`, [sourceId, targetId, linkType, note ?? null, Date.now()]);
+    }
+    /** Remove a link between two entries. */
+    removeLink(sourceId, targetId) {
+        this.provider.run('DELETE FROM vault_links WHERE source_id = ? AND target_id = ?', [
+            sourceId,
+            targetId,
+        ]);
+    }
+    /** Get all outgoing links FROM an entry. */
+    getLinks(entryId) {
+        try {
+            const rows = this.provider.all('SELECT * FROM vault_links WHERE source_id = ?', [entryId]);
+            return rows.map(rowToVaultLink);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get all incoming links TO an entry (backlinks). */
+    getBacklinks(entryId) {
+        try {
+            const rows = this.provider.all('SELECT * FROM vault_links WHERE target_id = ?', [entryId]);
+            return rows.map(rowToVaultLink);
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Get total link count (outgoing + incoming). */
+    getLinkCount(entryId) {
+        try {
+            const row = this.provider.get('SELECT COUNT(*) as count FROM vault_links WHERE source_id = ? OR target_id = ?', [entryId, entryId]);
+            return row?.count ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // ===========================================================================
+    // GRAPH TRAVERSAL
+    // ===========================================================================
+    /**
+     * Walk the link graph from a starting entry up to `depth` hops.
+     * Returns all connected entries with link metadata.
+     * BFS — walks both outgoing and incoming links (undirected).
+     */
+    traverse(entryId, depth = 2) {
+        const visited = new Set([entryId]);
+        const result = [];
+        let frontier = [entryId];
+        for (let d = 0; d < depth && frontier.length > 0; d++) {
+            const nextFrontier = [];
+            for (const currentId of frontier) {
+                // Outgoing
+                for (const link of this.getLinks(currentId)) {
+                    if (!visited.has(link.targetId)) {
+                        visited.add(link.targetId);
+                        nextFrontier.push(link.targetId);
+                        const entry = this.getEntryMeta(link.targetId);
+                        if (entry) {
+                            result.push({
+                                ...entry,
+                                linkType: link.linkType,
+                                linkDirection: 'outgoing',
+                                linkNote: link.note,
+                            });
+                        }
+                    }
+                }
+                // Incoming
+                for (const link of this.getBacklinks(currentId)) {
+                    if (!visited.has(link.sourceId)) {
+                        visited.add(link.sourceId);
+                        nextFrontier.push(link.sourceId);
+                        const entry = this.getEntryMeta(link.sourceId);
+                        if (entry) {
+                            result.push({
+                                ...entry,
+                                linkType: link.linkType,
+                                linkDirection: 'incoming',
+                                linkNote: link.note,
+                            });
+                        }
+                    }
+                }
+            }
+            frontier = nextFrontier;
+        }
+        return result;
+    }
+    // ===========================================================================
+    // ORPHAN DETECTION
+    // ===========================================================================
+    /** Find entries with zero links. */
+    getOrphans(limit = 50) {
+        try {
+            return this.provider.all(`SELECT id, title, type, domain FROM entries
+         WHERE id NOT IN (SELECT source_id FROM vault_links)
+           AND id NOT IN (SELECT target_id FROM vault_links)
+         ORDER BY updated_at DESC LIMIT ?`, [limit]);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ===========================================================================
+    // LINK SUGGESTIONS (FTS5-powered — improvement over Salvador's TF-IDF)
+    // ===========================================================================
+    /** Find semantically similar entries as link candidates using FTS5. */
+    suggestLinks(entryId, limit = 5) {
+        try {
+            // Get the entry to build a search query
+            const entry = this.provider.get('SELECT title, description, type, tags FROM entries WHERE id = ?', [entryId]);
+            if (!entry)
+                return [];
+            // Build FTS query from entry content — extract significant keywords only.
+            // FTS5 MATCH chokes on long raw text; use top keywords joined with OR.
+            const rawWords = `${entry.title} ${entry.description}`
+                .replace(/[^\w\s]/g, ' ')
+                .toLowerCase()
+                .split(/\s+/)
+                .filter((w) => w.length > 2);
+            // Deduplicate and take top 10 most significant words (skip common stop words)
+            const stopWords = new Set([
+                'the',
+                'and',
+                'for',
+                'with',
+                'from',
+                'this',
+                'that',
+                'are',
+                'was',
+                'not',
+                'but',
+                'have',
+                'has',
+                'use',
+                'can',
+                'will',
+                'all',
+                'each',
+                'than',
+                'its',
+                'more',
+                'when',
+                'into',
+                'also',
+                'any',
+                'may',
+                'only',
+                'should',
+                'which',
+            ]);
+            const unique = [...new Set(rawWords)].filter((w) => !stopWords.has(w));
+            const keywords = unique.slice(0, 10);
+            if (keywords.length === 0)
+                return [];
+            const queryTerms = keywords.join(' OR ');
+            // FTS5 match with BM25 ranking
+            const matches = this.provider.all(`SELECT e.id, e.title, e.type, e.domain, rank
+         FROM entries_fts fts
+         JOIN entries e ON e.rowid = fts.rowid
+         WHERE entries_fts MATCH ?
+         ORDER BY rank
+         LIMIT ?`, [queryTerms, limit + 5]);
+            // Filter out self and already-linked entries
+            const existingLinks = new Set([
+                ...this.getLinks(entryId).map((l) => l.targetId),
+                ...this.getBacklinks(entryId).map((l) => l.sourceId),
+            ]);
+            return matches
+                .filter((m) => m.id !== entryId && !existingLinks.has(m.id))
+                .slice(0, limit)
+                .map((m) => {
+                const suggestedType = inferLinkType(entry.type, m.type);
+                return {
+                    entryId: m.id,
+                    title: m.title,
+                    type: m.type,
+                    score: Math.abs(m.rank), // FTS5 rank is negative (lower = better)
+                    suggestedType,
+                    reason: `${m.type} in ${m.domain}`,
+                };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    // ===========================================================================
+    // PRIVATE
+    // ===========================================================================
+    getEntryMeta(entryId) {
+        try {
+            const row = this.provider.get('SELECT id, title, type, domain FROM entries WHERE id = ?', [entryId]);
+            return row ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+function rowToVaultLink(row) {
+    return {
+        sourceId: row.source_id,
+        targetId: row.target_id,
+        linkType: row.link_type,
+        note: row.note ?? undefined,
+        createdAt: row.created_at,
+    };
+}
+function inferLinkType(sourceType, targetType) {
+    if (sourceType === 'pattern' && targetType === 'anti-pattern')
+        return 'contradicts';
+    if (sourceType === 'anti-pattern' && targetType === 'pattern')
+        return 'contradicts';
+    if (targetType === 'rule')
+        return 'supports';
+    return 'extends';
+}
+//# sourceMappingURL=linking.js.map

package/dist/vault/linking.js.map

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

package/dist/vault/vault-types.d.ts

@@ -27,4 +27,41 @@ export interface VaultTierInfo {
     connected: boolean;
     entryCount: number;
 }
+/** Typed relationship between two vault entries. */
+export type LinkType = 'supports' | 'contradicts' | 'extends' | 'sequences';
+/** A directional, typed link between two vault entries. */
+export interface VaultLink {
+    sourceId: string;
+    targetId: string;
+    linkType: LinkType;
+    note?: string;
+    createdAt: number;
+}
+/** Raw SQLite row from vault_links table. */
+export interface VaultLinkRow {
+    source_id: string;
+    target_id: string;
+    link_type: string;
+    note: string | null;
+    created_at: number;
+}
+/** Entry enriched with link context for graph traversal results. */
+export interface LinkedEntry {
+    id: string;
+    title: string;
+    type: string;
+    domain: string;
+    linkType: LinkType;
+    linkDirection: 'outgoing' | 'incoming';
+    linkNote?: string;
+}
+/** Suggested link candidate from semantic/FTS similarity. */
+export interface LinkSuggestion {
+    entryId: string;
+    title: string;
+    type: string;
+    score: number;
+    suggestedType: LinkType;
+    reason: string;
+}
 //# sourceMappingURL=vault-types.d.ts.map

package/dist/vault/vault-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault-types.d.ts","sourceRoot":"","sources":["../../src/vault/vault-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIlD,CAAC;AAMF,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9C;AAMD,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"vault-types.d.ts","sourceRoot":"","sources":["../../src/vault/vault-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIlD,CAAC;AAMF,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1B,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9C;AAMD,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5E,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,UAAU,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,QAAQ,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/vault/vault.d.ts

@@ -48,9 +48,19 @@ export declare class Vault {
     private initialize;
     private migrateTierColumn;
     private migrateTemporalSchema;
+    private migrateOriginColumn;
     private migrateContentHash;
     private migrateBrainSchema;
     seed(entries: IntelligenceEntry[]): number;
+    /**
+     * Install a knowledge pack — seeds entries with origin:'pack' and content-hash dedup.
+     * Packs are installable domain knowledge (UX laws, design tokens, clean code rules).
+     * Unlike seed(), this forces origin:'pack' regardless of what the entry says.
+     */
+    installPack(entries: IntelligenceEntry[]): {
+        installed: number;
+        skipped: number;
+    };
     /**
      * Seed entries with content-hash dedup. Returns per-entry results.
      * Unlike seed(), skips entries whose content already exists in the vault.
@@ -64,6 +74,7 @@ export declare class Vault {
         domain?: string;
         type?: string;
         severity?: string;
+        origin?: 'agent' | 'pack' | 'user';
         limit?: number;
         includeExpired?: boolean;
     }): SearchResult[];
@@ -72,6 +83,7 @@ export declare class Vault {
         domain?: string;
         type?: string;
         severity?: string;
+        origin?: 'agent' | 'pack' | 'user';
         tags?: string[];
         limit?: number;
         offset?: number;

package/dist/vault/vault.d.ts.map

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

package/dist/vault/vault.js

@@ -137,6 +137,7 @@ export class Vault {
     `);
         this.migrateBrainSchema();
         this.migrateTemporalSchema();
+        this.migrateOriginColumn();
         this.migrateContentHash();
         this.migrateTierColumn();
     }
@@ -163,6 +164,15 @@ export class Vault {
             // Column already exists
         }
     }
+    migrateOriginColumn() {
+        try {
+            this.provider.run("ALTER TABLE entries ADD COLUMN origin TEXT NOT NULL DEFAULT 'user' CHECK(origin IN ('agent', 'pack', 'user'))");
+        }
+        catch {
+            // Column already exists
+        }
+        this.provider.execSql('CREATE INDEX IF NOT EXISTS idx_entries_origin ON entries(origin)');
+    }
     migrateContentHash() {
         try {
             this.provider.run('ALTER TABLE entries ADD COLUMN content_hash TEXT');
@@ -233,12 +243,12 @@ export class Vault {
     }
     seed(entries) {
         const sql = `
-      INSERT INTO entries (id,type,domain,title,severity,description,context,example,counter_example,why,tags,applies_to,valid_from,valid_until,content_hash,tier)
-      VALUES (@id,@type,@domain,@title,@severity,@description,@context,@example,@counterExample,@why,@tags,@appliesTo,@validFrom,@validUntil,@contentHash,@tier)
+      INSERT INTO entries (id,type,domain,title,severity,description,context,example,counter_example,why,tags,applies_to,valid_from,valid_until,content_hash,tier,origin)
+      VALUES (@id,@type,@domain,@title,@severity,@description,@context,@example,@counterExample,@why,@tags,@appliesTo,@validFrom,@validUntil,@contentHash,@tier,@origin)
       ON CONFLICT(id) DO UPDATE SET type=excluded.type,domain=excluded.domain,title=excluded.title,severity=excluded.severity,
         description=excluded.description,context=excluded.context,example=excluded.example,counter_example=excluded.counter_example,
         why=excluded.why,tags=excluded.tags,applies_to=excluded.applies_to,valid_from=excluded.valid_from,valid_until=excluded.valid_until,
-        content_hash=excluded.content_hash,tier=excluded.tier,updated_at=unixepoch()
+        content_hash=excluded.content_hash,tier=excluded.tier,origin=excluded.origin,updated_at=unixepoch()
     `;
         return this.provider.transaction(() => {
             let count = 0;
@@ -260,6 +270,7 @@ export class Vault {
                     validUntil: entry.validUntil ?? null,
                     contentHash: computeContentHash(entry),
                     tier: entry.tier ?? 'agent',
+                    origin: entry.origin ?? 'agent',
                 });
                 count++;
                 if (this.syncManager) {
@@ -269,6 +280,25 @@ export class Vault {
             return count;
         });
     }
+    /**
+     * Install a knowledge pack — seeds entries with origin:'pack' and content-hash dedup.
+     * Packs are installable domain knowledge (UX laws, design tokens, clean code rules).
+     * Unlike seed(), this forces origin:'pack' regardless of what the entry says.
+     */
+    installPack(entries) {
+        let installed = 0;
+        let skipped = 0;
+        // Tag all entries with origin:'pack' and seed — seed() handles its own transaction
+        const tagged = entries.map((e) => ({ ...e, origin: 'pack' }));
+        const results = this.seedDedup(tagged);
+        for (const r of results) {
+            if (r.action === 'inserted')
+                installed++;
+            else
+                skipped++;
+        }
+        return { installed, skipped };
+    }
     /**
      * Seed entries with content-hash dedup. Returns per-entry results.
      * Unlike seed(), skips entries whose content already exists in the vault.
@@ -306,6 +336,10 @@ export class Vault {
             filters.push('e.severity = @severity');
             fp.severity = options.severity;
         }
+        if (options?.origin) {
+            filters.push('e.origin = @origin');
+            fp.origin = options.origin;
+        }
         if (!options?.includeExpired) {
             const now = Math.floor(Date.now() / 1000);
             filters.push('(e.valid_until IS NULL OR e.valid_until > @now)');
@@ -313,12 +347,24 @@ export class Vault {
             fp.now = now;
         }
         const wc = filters.length > 0 ? `AND ${filters.join(' AND ')}` : '';
+        // Build FTS5 query: use OR between terms for broader matching,
+        // with title column boosted 3x for relevance ranking.
+        // FTS5 BM25 with default AND degrades with more entries because
+        // fewer documents match ALL terms simultaneously.
+        const ftsQuery = buildFtsQuery(query);
         try {
-            const rows = this.provider.all(`SELECT e.*, -rank as score FROM entries_fts fts JOIN entries e ON e.rowid = fts.rowid WHERE entries_fts MATCH @query ${wc} ORDER BY score DESC LIMIT @limit`, { query, limit, ...fp });
+            const rows = this.provider.all(`SELECT e.*, bm25(entries_fts, 5.0, 10.0, 3.0, 1.0, 2.0) as score FROM entries_fts fts JOIN entries e ON e.rowid = fts.rowid WHERE entries_fts MATCH @query ${wc} ORDER BY score ASC LIMIT @limit`, { query: ftsQuery, limit, ...fp });
             return rows.map(rowToSearchResult);
         }
         catch {
-            return [];
+            // Fallback: try original query if FTS5 syntax fails
+            try {
+                const rows = this.provider.all(`SELECT e.*, -rank as score FROM entries_fts fts JOIN entries e ON e.rowid = fts.rowid WHERE entries_fts MATCH @query ${wc} ORDER BY score DESC LIMIT @limit`, { query, limit, ...fp });
+                return rows.map(rowToSearchResult);
+            }
+            catch {
+                return [];
+            }
         }
     }
     get(id) {
@@ -342,6 +388,10 @@ export class Vault {
             filters.push('severity = @severity');
             params.severity = options.severity;
         }
+        if (options?.origin) {
+            filters.push('origin = @origin');
+            params.origin = options.origin;
+        }
         if (options?.tags?.length) {
             const c = options.tags.map((t, i) => {
                 params[`tag${i}`] = `%"${t}"%`;
@@ -866,12 +916,41 @@ function rowToEntry(row) {
         tags: JSON.parse(row.tags || '[]'),
         appliesTo: JSON.parse(row.applies_to || '[]'),
         tier: row.tier ?? undefined,
+        origin: row.origin ?? undefined,
         validFrom: row.valid_from ?? undefined,
         validUntil: row.valid_until ?? undefined,
     };
 }
 function rowToSearchResult(row) {
-    return { entry: rowToEntry(row), score: row.score };
+    // bm25() returns negative scores (lower = better), normalize to positive
+    const rawScore = row.score;
+    const score = rawScore < 0 ? -rawScore : rawScore;
+    return { entry: rowToEntry(row), score };
+}
+/**
+ * Build an FTS5 query from natural language input.
+ *
+ * Converts "React render performance memo" to:
+ *   {title}: (react OR render OR performance OR memo) OR (react OR render OR performance OR memo)
+ *
+ * Uses OR matching (not AND) so results include partial matches.
+ * FTS5 BM25 ranks documents with more matching terms higher.
+ * Title column is boosted via bm25() weights in the SQL query.
+ */
+function buildFtsQuery(query) {
+    const terms = query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((t) => t.length >= 2)
+        .map((t) => t.replace(/[^a-z0-9]/g, ''))
+        .filter(Boolean);
+    if (terms.length === 0)
+        return query;
+    if (terms.length === 1)
+        return terms[0];
+    // Use OR to match any term — BM25 ranks by how many terms match
+    const orTerms = terms.join(' OR ');
+    return orTerms;
 }
 function rowToMemory(row) {
     return {