@swarmify/agents-cli 1.11.2 → 1.11.3

package/dist/lib/session/__tests__/discover.test.js

@@ -0,0 +1,100 @@
+import { describe, expect, it } from 'vitest';
+import { buildBM25Index, scoreBM25 } from '../discover.js';
+function session(id, topic, userText) {
+    return {
+        id,
+        shortId: id.slice(0, 8),
+        agent: 'claude',
+        timestamp: '2026-04-17T19:00:00.000Z',
+        filePath: `/tmp/${id}.jsonl`,
+        topic,
+        _userTerms: userText ? [userText] : undefined,
+    };
+}
+describe('buildBM25Index', () => {
+    it('captures term frequencies and per-doc lengths', () => {
+        const docs = [
+            session('doc-a', 'auth middleware bug', 'fix the auth auth middleware'),
+            session('doc-b', 'payment refund', 'handle refund edge case'),
+        ];
+        const index = buildBM25Index(docs);
+        expect(index.N).toBe(2);
+        // doc-a: "auth middleware bug fix the auth auth middleware" -> 8 tokens
+        expect(index.docLengths.get('doc-a')).toBe(8);
+        // doc-b: "payment refund handle refund edge case" -> 6 tokens
+        expect(index.docLengths.get('doc-b')).toBe(6);
+        expect(index.avgdl).toBe(7);
+        // "auth" appears 3 times in doc-a, 0 in doc-b
+        expect(index.postings.get('auth')?.get('doc-a')).toBe(3);
+        expect(index.postings.get('auth')?.has('doc-b')).toBe(false);
+        // "refund" appears twice in doc-b
+        expect(index.postings.get('refund')?.get('doc-b')).toBe(2);
+    });
+    it('skips tokens shorter than 2 characters', () => {
+        const docs = [session('short', 'a b ab')];
+        const index = buildBM25Index(docs);
+        expect(index.postings.has('a')).toBe(false);
+        expect(index.postings.has('b')).toBe(false);
+        expect(index.postings.get('ab')?.get('short')).toBe(1);
+    });
+});
+describe('scoreBM25', () => {
+    it('ranks a rare term higher than a common one via IDF', () => {
+        // "bug" in 1 doc, "session" in all 4 — rare term should dominate
+        const docs = [
+            session('doc-0', 'session bug', 'the bug'),
+            session('doc-1', 'session notes', 'session notes'),
+            session('doc-2', 'session thoughts', 'session thoughts'),
+            session('doc-3', 'session plan', 'session plan'),
+        ];
+        const index = buildBM25Index(docs);
+        const rareHit = scoreBM25(index, 'bug');
+        const commonHit = scoreBM25(index, 'session');
+        const bugScore = rareHit.get('doc-0').score;
+        const sessionScore = commonHit.get('doc-0').score;
+        expect(bugScore).toBeGreaterThan(sessionScore);
+    });
+    it('ranks shorter docs above longer docs at equal term frequency', () => {
+        // Both docs mention "widget" once, but one is much longer.
+        const docs = [
+            session('short-doc', 'widget', 'widget'),
+            session('long-doc', 'widget', 'widget ' + 'padding '.repeat(50).trim()),
+        ];
+        const index = buildBM25Index(docs);
+        const results = scoreBM25(index, 'widget');
+        const ids = [...results.keys()];
+        expect(ids[0]).toBe('short-doc');
+        expect(ids[1]).toBe('long-doc');
+    });
+    it('accumulates scores across multiple query terms', () => {
+        const docs = [
+            session('both', 'auth token', 'auth token handling'),
+            session('one', 'auth only', 'auth only'),
+            session('none', 'unrelated', 'unrelated notes'),
+        ];
+        const index = buildBM25Index(docs);
+        const results = scoreBM25(index, 'auth token');
+        expect(results.get('both').matchedTerms.sort()).toEqual(['auth', 'token']);
+        expect(results.get('one').matchedTerms).toEqual(['auth']);
+        expect(results.has('none')).toBe(false);
+        expect(results.get('both').score).toBeGreaterThan(results.get('one').score);
+    });
+    it('returns an empty map for queries with no indexed terms', () => {
+        const docs = [session('doc-0', 'hello world')];
+        const index = buildBM25Index(docs);
+        expect(scoreBM25(index, '').size).toBe(0);
+        expect(scoreBM25(index, 'nonexistent').size).toBe(0);
+    });
+    it('orders results by score descending (Map insertion order)', () => {
+        const docs = [
+            session('low', 'apple', 'apple'),
+            session('mid', 'apple apple', 'apple apple'),
+            session('high', 'apple apple apple', 'apple apple apple'),
+        ];
+        const index = buildBM25Index(docs);
+        const results = scoreBM25(index, 'apple');
+        const ordered = [...results.keys()];
+        expect(ordered).toEqual(['high', 'mid', 'low']);
+    });
+});
+//# sourceMappingURL=discover.test.js.map

package/dist/lib/session/__tests__/discover.test.js.map

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

package/dist/lib/session/discover.d.ts

@@ -20,6 +20,13 @@ export declare function discoverSessions(options?: DiscoverOptions): Promise<Ses
  * Resolve a session by full or short ID from the full index.
  */
 export declare function resolveSessionById(sessions: SessionMeta[], idQuery: string): SessionMeta[];
+export interface BM25Index {
+    N: number;
+    avgdl: number;
+    docLengths: Map<string, number>;
+    postings: Map<string, Map<string, number>>;
+}
+export declare function buildBM25Index(sessions: SessionMeta[]): BM25Index;
 /**
  * Collect all directories to scan for an agent's sessions.
  * Scans: active config dir, all installed version homes, and backups.
@@ -38,8 +45,16 @@ export declare function readFirstLines(filePath: string, maxLines: number): Prom
 export declare function walkForFiles(dir: string, ext: string, limit: number): string[];
 export declare function parseTimeFilter(input: string): number;
 /**
- * Score sessions by matching against terms from the content index.
- * Returns sessions with matched terms attached for highlighting.
+ * Pure BM25 scorer over an in-memory index. Returns sessionId -> score+matched terms,
+ * sorted by score descending (Map preserves insertion order).
+ */
+export declare function scoreBM25(index: BM25Index, query: string): Map<string, {
+    score: number;
+    matchedTerms: string[];
+}>;
+/**
+ * Score sessions using Okapi BM25 against the persisted content index.
+ * Returns a Map sorted by score descending, with matched terms attached.
  */
 export declare function searchContentIndex(sessions: SessionMeta[], query: string): Map<string, SessionMeta>;
 //# sourceMappingURL=discover.d.ts.map

package/dist/lib/session/discover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/lib/session/discover.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAa9D,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0ExF;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAW1F;AAmHD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAqC3E;AAywBD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBpF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B9E;AAsLD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAmC1B"}
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/lib/session/discover.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAc9D,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0ExF;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAW1F;AAmDD,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAyBD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAsBjE;AAwED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAqC3E;AA4yBD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBpF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B9E;AAsLD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmCxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAoB1B"}

package/dist/lib/session/discover.js

@@ -4,7 +4,7 @@ import * as os from 'os';
 import * as crypto from 'crypto';
 import * as readline from 'readline';
 import { execSync } from 'child_process';
-import { getCliVersion } from '../agents.js';
+import { AGENTS, getCliVersion } from '../agents.js';
 import { getConfigSymlinkVersion } from '../shims.js';
 import { SESSION_AGENTS } from './types.js';
 import { extractSessionTopic } from './prompt.js';
@@ -13,6 +13,7 @@ const AGENTS_DIR = path.join(HOME, '.agents');
 const SESSIONS_DIR = path.join(AGENTS_DIR, 'sessions');
 const INDEX_PATH = path.join(SESSIONS_DIR, 'index.jsonl');
 const CONTENT_INDEX_PATH = path.join(SESSIONS_DIR, 'content_index.jsonl');
+let cachedOpenClawWorkspaces = null;
 const cachedAgentVersions = new Map();
 /**
  * Discover sessions across all installed agents, versions, and backups.
@@ -48,9 +49,9 @@ export async function discoverSessions(options) {
         toSave.set(s.id, s);
     }
     saveIndex([...toSave.values()]);
-    // Build content index for all discovered sessions
-    const contentIndex = await buildContentIndex(sessions);
-    saveContentIndex(contentIndex);
+    // Build BM25 content index for all discovered sessions
+    const bm25 = buildBM25Index(sessions);
+    saveBM25Index(bm25);
     const projectQuery = options?.project?.trim();
     // Filter by project (case-insensitive substring match)
     if (projectQuery) {
@@ -142,78 +143,127 @@ function saveIndex(sessions) {
     }
 }
 // ---------------------------------------------------------------------------
-// Content index (inverted term -> session terms)
+// BM25 content index
 // ---------------------------------------------------------------------------
-async function buildContentIndex(sessions) {
-    const index = new Map();
-    for (const session of sessions) {
-        const terms = extractSessionTerms(session);
-        for (const term of terms) {
-            if (!index.has(term))
-                index.set(term, new Set());
-            index.get(term).add(session.id);
-        }
+const BM25_K1 = 1.2;
+const BM25_B = 0.75;
+const BM25_INDEX_VERSION = 2;
+function tokenizeCounted(text) {
+    const counts = new Map();
+    let length = 0;
+    const raw = text.toLowerCase().split(/[^a-z0-9]+/);
+    for (const token of raw) {
+        if (token.length < 2)
+            continue;
+        length++;
+        counts.set(token, (counts.get(token) ?? 0) + 1);
     }
-    return index;
+    return { length, counts };
 }
-function extractSessionTerms(session) {
-    const textParts = [];
-    if (session.topic)
-        textParts.push(session.topic);
-    if (session.project)
-        textParts.push(session.project);
-    if (session.cwd)
-        textParts.push(session.cwd);
-    if (session.gitBranch)
-        textParts.push(session.gitBranch);
-    if (session.account)
-        textParts.push(session.account);
-    if (session._userTerms)
-        textParts.push(session._userTerms.join('\n'));
-    return tokenizeText(textParts.join('\n'));
+function collectSessionText(s) {
+    const parts = [];
+    if (s.topic)
+        parts.push(s.topic);
+    if (s.project)
+        parts.push(s.project);
+    if (s.cwd)
+        parts.push(s.cwd);
+    if (s.gitBranch)
+        parts.push(s.gitBranch);
+    if (s.account)
+        parts.push(s.account);
+    if (s._userTerms)
+        parts.push(s._userTerms.join('\n'));
+    return parts.join('\n');
 }
-function tokenizeText(text) {
-    const seen = new Set();
-    const terms = [];
-    const tokens = text.toLowerCase().split(/[^a-z0-9]+/);
-    for (const token of tokens) {
-        if (token.length < 2 || seen.has(token))
-            continue;
-        seen.add(token);
-        terms.push(token);
+export function buildBM25Index(sessions) {
+    const docLengths = new Map();
+    const postings = new Map();
+    let totalLength = 0;
+    for (const session of sessions) {
+        const { length, counts } = tokenizeCounted(collectSessionText(session));
+        docLengths.set(session.id, length);
+        totalLength += length;
+        for (const [term, tf] of counts) {
+            let termPostings = postings.get(term);
+            if (!termPostings) {
+                termPostings = new Map();
+                postings.set(term, termPostings);
+            }
+            termPostings.set(session.id, tf);
+        }
     }
-    return terms;
+    const N = sessions.length;
+    const avgdl = N > 0 ? totalLength / N : 0;
+    return { N, avgdl, docLengths, postings };
 }
-function saveContentIndex(index) {
+function saveBM25Index(index) {
     try {
         fs.mkdirSync(SESSIONS_DIR, { recursive: true });
         const lines = [];
-        for (const [term, sessionIds] of index) {
-            lines.push(JSON.stringify({ term, sessions: [...sessionIds] }));
+        lines.push(JSON.stringify({ v: BM25_INDEX_VERSION, N: index.N, avgdl: index.avgdl }));
+        for (const [sid, len] of index.docLengths) {
+            lines.push(JSON.stringify({ d: sid, l: len }));
+        }
+        for (const [term, termPostings] of index.postings) {
+            const p = [];
+            for (const [sid, tf] of termPostings)
+                p.push([sid, tf]);
+            lines.push(JSON.stringify({ t: term, p }));
         }
         fs.writeFileSync(CONTENT_INDEX_PATH, lines.join('\n') + '\n', 'utf-8');
     }
-    catch { /* index save failure is non-fatal */ }
+    catch { /* non-fatal */ }
 }
-function loadContentIndex() {
-    const index = new Map();
+function loadBM25Index() {
     if (!fs.existsSync(CONTENT_INDEX_PATH))
-        return index;
+        return null;
+    let content;
     try {
-        const content = fs.readFileSync(CONTENT_INDEX_PATH, 'utf-8');
-        for (const line of content.split('\n')) {
-            if (!line.trim())
-                continue;
-            try {
-                const entry = JSON.parse(line);
-                if (entry.term && entry.sessions) {
-                    index.set(entry.term, new Set(entry.sessions));
+        content = fs.readFileSync(CONTENT_INDEX_PATH, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const lines = content.split('\n').filter(l => l.trim());
+    if (lines.length === 0)
+        return null;
+    let header;
+    try {
+        header = JSON.parse(lines[0]);
+    }
+    catch {
+        return null;
+    }
+    if (header?.v !== BM25_INDEX_VERSION)
+        return null;
+    const index = {
+        N: Number(header.N) || 0,
+        avgdl: Number(header.avgdl) || 0,
+        docLengths: new Map(),
+        postings: new Map(),
+    };
+    for (let i = 1; i < lines.length; i++) {
+        let entry;
+        try {
+            entry = JSON.parse(lines[i]);
+        }
+        catch {
+            continue;
+        }
+        if (typeof entry.d === 'string' && typeof entry.l === 'number') {
+            index.docLengths.set(entry.d, entry.l);
+        }
+        else if (typeof entry.t === 'string' && Array.isArray(entry.p)) {
+            const termPostings = new Map();
+            for (const pair of entry.p) {
+                if (Array.isArray(pair) && pair.length >= 2) {
+                    termPostings.set(String(pair[0]), Number(pair[1]));
                 }
             }
-            catch { /* malformed index entry, skip */ }
+            index.postings.set(entry.t, termPostings);
         }
     }
-    catch { /* index load failure is non-fatal */ }
     return index;
 }
 // ---------------------------------------------------------------------------
@@ -781,6 +831,7 @@ async function discoverOpenClawSessions() {
                 agent: 'openclaw',
                 timestamp: new Date().toISOString(),
                 project: name,
+                cwd: getOpenClawSessionCwd(agentId),
                 version: currentVersion,
                 filePath: '',
             });
@@ -815,7 +866,6 @@ async function discoverOpenClawSessions() {
             //   [schedule+next, last, status, target, agentId, model]
             const rest = line.slice(headMatch[0].length).trim();
             const cols = rest.split(/\s{2,}/);
-            const status = cols[2] || '';
             const agentId = cols[4] || '';
             sessions.push({
                 id: `openclaw-cron-${jobId}`,
@@ -823,7 +873,7 @@ async function discoverOpenClawSessions() {
                 agent: 'openclaw',
                 timestamp: new Date().toISOString(),
                 project: `${jobName} (${agentId || 'unknown'})`,
-                cwd: status,
+                cwd: getOpenClawSessionCwd(agentId),
                 version: currentVersion,
                 filePath: '',
             });
@@ -978,6 +1028,36 @@ async function scanCodexSession(filePath) {
         userTerms: userTexts.length > 0 ? userTexts : undefined,
     };
 }
+function getOpenClawSessionCwd(agentId) {
+    const workspace = agentId ? getOpenClawWorkspaceMap().get(agentId) : undefined;
+    if (workspace)
+        return workspace;
+    const configDir = AGENTS.openclaw.configDir;
+    return safeRealpathSync(configDir) || configDir;
+}
+function getOpenClawWorkspaceMap() {
+    if (cachedOpenClawWorkspaces)
+        return cachedOpenClawWorkspaces;
+    const workspaces = new Map();
+    const configPath = path.join(AGENTS.openclaw.configDir, 'openclaw.json');
+    if (!fs.existsSync(configPath)) {
+        cachedOpenClawWorkspaces = workspaces;
+        return workspaces;
+    }
+    try {
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        for (const agent of config.agents?.list || []) {
+            if (!agent.id || !agent.workspace)
+                continue;
+            workspaces.set(agent.id, safeRealpathSync(agent.workspace) || agent.workspace);
+        }
+    }
+    catch {
+        // Ignore invalid OpenClaw config and fall back to ~/.openclaw.
+    }
+    cachedOpenClawWorkspaces = workspaces;
+    return workspaces;
+}
 // ---------------------------------------------------------------------------
 // Utilities
 // ---------------------------------------------------------------------------
@@ -1204,50 +1284,76 @@ export function parseTimeFilter(input) {
         const value = parseInt(relativeMatch[1], 10);
         const unit = relativeMatch[2].toLowerCase();
         if (unit === 'd')
-            return Date.now() - value * 86400000;
+            return Date.now() - value * 86_400_000;
         if (unit === 'w')
-            return Date.now() - value * 7 * 86400000;
+            return Date.now() - value * 7 * 86_400_000;
     }
     const ts = new Date(input).getTime();
     return Number.isNaN(ts) ? 0 : ts;
 }
 // ---------------------------------------------------------------------------
-// Content index search
+// BM25 content index search
 // ---------------------------------------------------------------------------
 /**
- * Score sessions by matching against terms from the content index.
- * Returns sessions with matched terms attached for highlighting.
+ * Pure BM25 scorer over an in-memory index. Returns sessionId -> score+matched terms,
+ * sorted by score descending (Map preserves insertion order).
  */
-export function searchContentIndex(sessions, query) {
-    const index = loadContentIndex();
-    if (index.size === 0)
-        return new Map();
-    const terms = tokenizeText(query);
-    if (terms.length === 0)
-        return new Map();
+export function scoreBM25(index, query) {
+    const result = new Map();
+    if (index.N === 0)
+        return result;
+    const { counts: queryTerms } = tokenizeCounted(query);
+    if (queryTerms.size === 0)
+        return result;
+    const avgdl = index.avgdl || 1;
     const scored = new Map();
-    for (const term of terms) {
-        const matchingSessions = index.get(term);
-        if (!matchingSessions)
+    for (const [term] of queryTerms) {
+        const termPostings = index.postings.get(term);
+        if (!termPostings)
             continue;
-        for (const sessionId of matchingSessions) {
+        const df = termPostings.size;
+        const idf = Math.log(1 + (index.N - df + 0.5) / (df + 0.5));
+        for (const [sessionId, tf] of termPostings) {
+            const dl = index.docLengths.get(sessionId) ?? avgdl;
+            const norm = 1 - BM25_B + BM25_B * (dl / avgdl);
+            const termScore = idf * (tf * (BM25_K1 + 1)) / (tf + BM25_K1 * norm);
             const entry = scored.get(sessionId);
             if (!entry) {
-                scored.set(sessionId, { score: 1, matchedTerms: [term] });
+                scored.set(sessionId, { score: termScore, matchedTerms: [term] });
             }
             else {
-                entry.score += 1;
-                if (!entry.matchedTerms.includes(term)) {
+                entry.score += termScore;
+                if (!entry.matchedTerms.includes(term))
                     entry.matchedTerms.push(term);
-                }
             }
         }
     }
+    const sorted = [...scored.entries()].sort((a, b) => b[1].score - a[1].score);
+    for (const [sid, info] of sorted)
+        result.set(sid, info);
+    return result;
+}
+/**
+ * Score sessions using Okapi BM25 against the persisted content index.
+ * Returns a Map sorted by score descending, with matched terms attached.
+ */
+export function searchContentIndex(sessions, query) {
+    const index = loadBM25Index();
+    if (!index)
+        return new Map();
+    const scored = scoreBM25(index, query);
+    if (scored.size === 0)
+        return new Map();
+    const sessionsById = new Map(sessions.map(s => [s.id, s]));
     const result = new Map();
     for (const [sessionId, info] of scored) {
-        const session = sessions.find(s => s.id === sessionId);
+        const session = sessionsById.get(sessionId);
         if (session) {
-            result.set(sessionId, { ...session, _matchedTerms: info.matchedTerms });
+            result.set(sessionId, {
+                ...session,
+                _matchedTerms: info.matchedTerms,
+                _bm25Score: info.score,
+            });
         }
     }
     return result;