somtum 0.1.2

package/dist/core/retrieval_stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval_stats.d.ts","sourceRoot":"","sources":["../../src/core/retrieval_stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgBrD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,EAAE;IAEnC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAYxE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAY1C,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAW3C,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAW9D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe;CAYvD"}

package/dist/core/retrieval_stats.js

@@ -0,0 +1,56 @@
+export class RetrievalStatsStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    incrementRetrieval(projectId, strategy) {
+        this.db
+            .prepare(`INSERT INTO retrieval_stats (project_id, strategy, call_count, last_called_at)
+         VALUES (?, ?, 1, ?)
+         ON CONFLICT (project_id, strategy) DO UPDATE SET
+           call_count = call_count + 1,
+           last_called_at = excluded.last_called_at`)
+            .run(projectId, strategy, Date.now());
+    }
+    incrementCacheHit(projectId) {
+        this.db
+            .prepare(`INSERT INTO cache_hit_stats (project_id, hit_count, miss_count, last_hit_at)
+         VALUES (?, 1, 0, ?)
+         ON CONFLICT (project_id) DO UPDATE SET
+           hit_count = hit_count + 1,
+           last_hit_at = excluded.last_hit_at`)
+            .run(projectId, Date.now());
+    }
+    incrementCacheMiss(projectId) {
+        this.db
+            .prepare(`INSERT INTO cache_hit_stats (project_id, hit_count, miss_count, last_hit_at)
+         VALUES (?, 0, 1, NULL)
+         ON CONFLICT (project_id) DO UPDATE SET
+           miss_count = miss_count + 1`)
+            .run(projectId);
+    }
+    getRetrievalBreakdown(projectId) {
+        const rows = this.db
+            .prepare(`SELECT * FROM retrieval_stats WHERE project_id = ? ORDER BY call_count DESC`)
+            .all(projectId);
+        return rows.map((r) => ({
+            strategy: r.strategy,
+            call_count: r.call_count,
+            last_called_at: r.last_called_at,
+        }));
+    }
+    getCacheHitSummary(projectId) {
+        const row = this.db
+            .prepare(`SELECT * FROM cache_hit_stats WHERE project_id = ?`)
+            .get(projectId);
+        if (!row)
+            return { hit_count: 0, miss_count: 0, hit_rate: null };
+        const total = row.hit_count + row.miss_count;
+        return {
+            hit_count: row.hit_count,
+            miss_count: row.miss_count,
+            hit_rate: total > 0 ? Number((row.hit_count / total).toFixed(3)) : null,
+        };
+    }
+}
+//# sourceMappingURL=retrieval_stats.js.map

package/dist/core/retrieval_stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval_stats.js","sourceRoot":"","sources":["../../src/core/retrieval_stats.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,EAAM;QAAN,OAAE,GAAF,EAAE,CAAI;IAAG,CAAC;IAEvC,kBAAkB,CAAC,SAAiB,EAAE,QAA2B;QAC/D,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;;oDAI4C,CAC7C;aACA,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,iBAAiB,CAAC,SAAiB;QACjC,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;;8CAIsC,CACvC;aACA,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;uCAG+B,CAChC;aACA,GAAG,CAAC,SAAS,CAAC,CAAC;IACpB,CAAC;IAED,qBAAqB,CAAC,SAAiB;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,6EAA6E,CAAC;aACtF,GAAG,CAAC,SAAS,CAAmB,CAAC;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,QAAQ,EAAE,CAAC,CAAC,QAA6B;YACzC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,cAAc,EAAE,CAAC,CAAC,cAAc;SACjC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,oDAAoD,CAAC;aAC7D,GAAG,CAAC,SAAS,CAA4B,CAAC;QAC7C,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC;QAC7C,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;SACxE,CAAC;IACJ,CAAC;CACF"}

package/dist/core/retriever/bm25.d.ts

@@ -0,0 +1,15 @@
+import type { DB } from '../db.js';
+import type { Observation } from '../schema.js';
+import type { Retriever, RetrievalResult, SearchOptions } from './types.js';
+export declare class Bm25Retriever implements Retriever {
+    private readonly db;
+    readonly name: "bm25";
+    private readonly store;
+    constructor(db: DB);
+    search(query: string, options: SearchOptions): Promise<RetrievalResult[]>;
+}
+export declare function _forTestingOnly(): {
+    escapeFtsQuery: (q: string) => string;
+};
+export type { Observation };
+//# sourceMappingURL=bm25.d.ts.map

package/dist/core/retriever/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../../src/core/retriever/bm25.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoB5E,qBAAa,aAAc,YAAW,SAAS;IAIjC,OAAO,CAAC,QAAQ,CAAC,EAAE;IAH/B,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAEP,EAAE,EAAE,EAAE;IAI7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CA0BhF;AAED,wBAAgB,eAAe,IAAI;IAAE,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAE3E;AAED,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/core/retriever/bm25.js

@@ -0,0 +1,51 @@
+import { MemoryStore } from '../store.js';
+// SQLite FTS5 MATCH uses an embedded query grammar; user input with bare
+// punctuation can raise "fts5: syntax error". We quote each token to treat
+// the input as a bag of literal terms (phrase-ish), which is the right
+// behavior for natural-language queries against BM25.
+function escapeFtsQuery(query) {
+    const tokens = query
+        .split(/\s+/)
+        .map((t) => t.replace(/["]/g, '').trim())
+        .filter((t) => t.length > 0);
+    if (tokens.length === 0)
+        return '""';
+    return tokens.map((t) => `"${t}"`).join(' OR ');
+}
+export class Bm25Retriever {
+    db;
+    name = 'bm25';
+    store;
+    constructor(db) {
+        this.db = db;
+        this.store = new MemoryStore(db);
+    }
+    async search(query, options) {
+        const ftsQuery = escapeFtsQuery(query);
+        if (ftsQuery === '""')
+            return [];
+        // bm25() returns lower-is-better; invert so higher = more relevant,
+        // and the Retriever contract's `score` reads naturally.
+        const rows = this.db
+            .prepare(`SELECT o.id AS id, -bm25(observations_fts) AS score
+         FROM observations_fts
+         JOIN observations o ON o.rowid = observations_fts.rowid
+         WHERE observations_fts MATCH ?
+           AND o.project_id = ?
+           AND o.deleted_at IS NULL
+         ORDER BY score DESC
+         LIMIT ?`)
+            .all(ftsQuery, options.projectId, options.k);
+        const results = [];
+        for (const row of rows) {
+            const obs = this.store.get(row.id);
+            if (obs)
+                results.push({ id: row.id, score: row.score, observation: obs, source: 'bm25' });
+        }
+        return results;
+    }
+}
+export function _forTestingOnly() {
+    return { escapeFtsQuery };
+}
+//# sourceMappingURL=bm25.js.map

package/dist/core/retriever/bm25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.js","sourceRoot":"","sources":["../../../src/core/retriever/bm25.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,yEAAyE;AACzE,2EAA2E;AAC3E,uEAAuE;AACvE,sDAAsD;AACtD,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,MAAM,GAAG,KAAK;SACjB,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAOD,MAAM,OAAO,aAAa;IAIK;IAHpB,IAAI,GAAG,MAAe,CAAC;IACf,KAAK,CAAc;IAEpC,YAA6B,EAAM;QAAN,OAAE,GAAF,EAAE,CAAI;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAsB;QAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAEjC,oEAAoE;QACpE,wDAAwD;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN;;;;;;;iBAOS,CACV;aACA,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAc,CAAC;QAE5D,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,cAAc,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/retriever/embeddings.d.ts

@@ -0,0 +1,9 @@
+import type { DB } from '../db.js';
+import type { Retriever, RetrievalResult, SearchOptions } from './types.js';
+export declare class EmbeddingsRetriever implements Retriever {
+    readonly name: "embeddings";
+    private readonly store;
+    constructor(db: DB);
+    search(query: string, options: SearchOptions): Promise<RetrievalResult[]>;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/core/retriever/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../src/core/retriever/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI5E,qBAAa,mBAAoB,YAAW,SAAS;IACnD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,EAAE,EAAE,EAAE;IAIZ,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAqBhF"}

package/dist/core/retriever/embeddings.js

@@ -0,0 +1,34 @@
+import { MemoryStore } from '../store.js';
+import { cosineSimilarity, decodeVector, getEmbedder } from '../embeddings.js';
+// Brute-force cosine over all stored vectors for the project. Fine up to
+// tens of thousands of observations; swap for an ANN index later if needed.
+export class EmbeddingsRetriever {
+    name = 'embeddings';
+    store;
+    constructor(db) {
+        this.store = new MemoryStore(db);
+    }
+    async search(query, options) {
+        if (query.trim().length === 0)
+            return [];
+        const embedder = await getEmbedder();
+        const [qv] = await embedder.embed([query]);
+        if (!qv)
+            return [];
+        const rows = this.store.listWithEmbeddings(options.projectId);
+        const scored = rows.map((r) => {
+            const v = decodeVector(r.embedding, embedder.dim);
+            return { id: r.id, score: cosineSimilarity(qv, v) };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        const top = scored.slice(0, options.k);
+        const results = [];
+        for (const s of top) {
+            const obs = this.store.get(s.id);
+            if (obs)
+                results.push({ id: s.id, score: s.score, observation: obs, source: 'embeddings' });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/core/retriever/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../../src/core/retriever/embeddings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/E,yEAAyE;AACzE,4EAA4E;AAC5E,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,YAAqB,CAAC;IACrB,KAAK,CAAc;IAEpC,YAAY,EAAM;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAsB;QAChD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;YAClD,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,GAAG;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/core/retriever/factory.d.ts

@@ -0,0 +1,6 @@
+import type { DB } from '../db.js';
+import type { Config, RetrievalStrategy } from '../schema.js';
+import type { Retriever } from './types.js';
+export declare function makeRetriever(strategy: RetrievalStrategy, db: DB, config: Config): Retriever;
+export declare function strategyAvailable(strategy: RetrievalStrategy, config?: Config): boolean;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/retriever/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/core/retriever/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAY5C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAuB5F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAUvF"}

package/dist/core/retriever/factory.js

@@ -0,0 +1,53 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { Bm25Retriever } from './bm25.js';
+import { EmbeddingsRetriever } from './embeddings.js';
+import { HybridRetriever } from './hybrid.js';
+import { LlmIndexRetriever } from './llm_index.js';
+import { anthropicCaller } from '../extractor.js';
+import { isEmbedderReady } from '../embeddings.js';
+// Returns a retriever by strategy name. Falls back to BM25 when the requested
+// strategy's prerequisites are missing (e.g. embeddings disabled in config or
+// the model has not been loaded). Callers that care about the fallback can
+// check `strategyAvailable` up front.
+export function makeRetriever(strategy, db, config) {
+    switch (strategy) {
+        case 'bm25':
+            return new Bm25Retriever(db);
+        case 'embeddings':
+            if (!config.retrieval.embeddings.enabled)
+                return new Bm25Retriever(db);
+            return new EmbeddingsRetriever(db);
+        case 'hybrid':
+            if (!config.retrieval.embeddings.enabled)
+                return new Bm25Retriever(db);
+            return new HybridRetriever(db);
+        case 'index': {
+            if (!config.retrieval.index.enabled)
+                return new Bm25Retriever(db);
+            const apiKey = process.env['ANTHROPIC_API_KEY'];
+            if (!apiKey)
+                return new Bm25Retriever(db);
+            const caller = anthropicCaller(new Anthropic({ apiKey }));
+            return new LlmIndexRetriever(db, {
+                caller,
+                model: config.retrieval.index.model,
+            });
+        }
+        default:
+            return new Bm25Retriever(db);
+    }
+}
+export function strategyAvailable(strategy, config) {
+    if (strategy === 'bm25')
+        return true;
+    if (strategy === 'embeddings' || strategy === 'hybrid') {
+        if (!config?.retrieval.embeddings.enabled)
+            return false;
+        return isEmbedderReady() || true;
+    }
+    if (strategy === 'index') {
+        return Boolean(config?.retrieval.index.enabled && process.env['ANTHROPIC_API_KEY']);
+    }
+    return false;
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/retriever/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/core/retriever/factory.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAI1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,sCAAsC;AACtC,MAAM,UAAU,aAAa,CAAC,QAA2B,EAAE,EAAM,EAAE,MAAc;IAC/E,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;QAC/B,KAAK,YAAY;YACf,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;YACvE,OAAO,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACrC,KAAK,QAAQ;YACX,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;YACvE,OAAO,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;QACjC,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO;gBAAE,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAC1D,OAAO,IAAI,iBAAiB,CAAC,EAAE,EAAE;gBAC/B,MAAM;gBACN,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK;aACpC,CAAC,CAAC;QACL,CAAC;QACD;YACE,OAAO,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA2B,EAAE,MAAe;IAC5E,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QACxD,OAAO,eAAe,EAAE,IAAI,IAAI,CAAC;IACnC,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/retriever/hybrid.d.ts

@@ -0,0 +1,14 @@
+import type { DB } from '../db.js';
+import type { Retriever, RetrievalResult, SearchOptions } from './types.js';
+export interface HybridOptions {
+    poolSize?: number;
+}
+export declare class HybridRetriever implements Retriever {
+    readonly name: "hybrid";
+    private readonly bm25;
+    private readonly embeddings;
+    private readonly poolSize;
+    constructor(db: DB, options?: HybridOptions);
+    search(query: string, options: SearchOptions): Promise<RetrievalResult[]>;
+}
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/core/retriever/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../../src/core/retriever/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAW5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAgB,YAAW,SAAS;IAC/C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,EAAE,EAAE,EAAE,EAAE,OAAO,GAAE,aAAkB;IAMzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAoChF"}

package/dist/core/retriever/hybrid.js

@@ -0,0 +1,52 @@
+import { Bm25Retriever } from './bm25.js';
+import { EmbeddingsRetriever } from './embeddings.js';
+// Reciprocal Rank Fusion. Widely-used, parameter-light way to blend two
+// ranked lists without having to normalize scores across strategies.
+// k=60 is the standard default from the original RRF paper.
+const RRF_K = 60;
+function rrf(rank) {
+    return 1 / (RRF_K + rank + 1);
+}
+export class HybridRetriever {
+    name = 'hybrid';
+    bm25;
+    embeddings;
+    poolSize;
+    constructor(db, options = {}) {
+        this.bm25 = new Bm25Retriever(db);
+        this.embeddings = new EmbeddingsRetriever(db);
+        this.poolSize = options.poolSize ?? 50;
+    }
+    async search(query, options) {
+        const poolOpts = { k: this.poolSize, projectId: options.projectId };
+        // Run both retrievers in parallel; if one throws (e.g. embedder not loaded)
+        // the other still produces a result set.
+        const [bm25Res, embRes] = await Promise.all([
+            this.bm25.search(query, poolOpts).catch(() => []),
+            this.embeddings.search(query, poolOpts).catch(() => []),
+        ]);
+        const merged = new Map();
+        const accumulate = (list) => {
+            list.forEach((r, i) => {
+                const prev = merged.get(r.id);
+                const contribution = rrf(i);
+                if (prev) {
+                    prev.score += contribution;
+                }
+                else {
+                    merged.set(r.id, {
+                        result: { ...r, source: 'hybrid' },
+                        score: contribution,
+                    });
+                }
+            });
+        };
+        accumulate(bm25Res);
+        accumulate(embRes);
+        return [...merged.values()]
+            .sort((a, b) => b.score - a.score)
+            .slice(0, options.k)
+            .map((e) => ({ ...e.result, score: e.score }));
+    }
+}
+//# sourceMappingURL=hybrid.js.map

package/dist/core/retriever/hybrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.js","sourceRoot":"","sources":["../../../src/core/retriever/hybrid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,wEAAwE;AACxE,qEAAqE;AACrE,4DAA4D;AAC5D,MAAM,KAAK,GAAG,EAAE,CAAC;AAEjB,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC;AAMD,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,QAAiB,CAAC;IACjB,IAAI,CAAgB;IACpB,UAAU,CAAsB;IAChC,QAAQ,CAAS;IAElC,YAAY,EAAM,EAAE,UAAyB,EAAE;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAsB;QAChD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QACpE,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAuB,CAAC;YACtE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAuB,CAAC;SAC7E,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,GAAG,EAGnB,CAAC;QAEJ,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAQ,EAAE;YACnD,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACpB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9B,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;wBACf,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE;wBAClC,KAAK,EAAE,YAAY;qBACpB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,UAAU,CAAC,OAAO,CAAC,CAAC;QACpB,UAAU,CAAC,MAAM,CAAC,CAAC;QAEnB,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;aACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/core/retriever/llm_index.d.ts

@@ -0,0 +1,18 @@
+import type { DB } from '../db.js';
+import type { LlmCaller } from '../extractor.js';
+import type { Retriever, RetrievalResult, SearchOptions } from './types.js';
+export interface LlmIndexRetrieverOptions {
+    caller: LlmCaller;
+    model: string;
+    maxCatalog?: number;
+}
+export declare class LlmIndexRetriever implements Retriever {
+    readonly name: "index";
+    private readonly store;
+    private readonly caller;
+    private readonly model;
+    private readonly maxCatalog;
+    constructor(db: DB, opts: LlmIndexRetrieverOptions);
+    search(query: string, options: SearchOptions): Promise<RetrievalResult[]>;
+}
+//# sourceMappingURL=llm_index.d.ts.map

package/dist/core/retriever/llm_index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm_index.d.ts","sourceRoot":"","sources":["../../../src/core/retriever/llm_index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA+C5E,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IAId,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,iBAAkB,YAAW,SAAS;IACjD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,wBAAwB;IAO5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAyChF"}

package/dist/core/retriever/llm_index.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { MemoryStore } from '../store.js';
+// LLM-backed retriever. Feeds a compact catalog (id + title + kind + files +
+// tags) to a cheap model and asks it to pick the top-K observation IDs.
+// Slower and costlier than BM25, but much better at paraphrased queries
+// and cross-field intent ("auth stuff" → matches an observation titled
+// "JWT session rotation"). Falls back to BM25 via the factory when the
+// caller or the `retrieval.index.enabled` flag is missing.
+const SYSTEM_PROMPT = `You are Somtum's index retriever. You are given a user query and a catalog of stored observations (each with id, kind, title, tags, files). Pick the most relevant observations for the query.
+
+OUTPUT: a single JSON object, no prose, no markdown fences:
+{"ids": ["id1","id2",...]}
+
+Rules:
+- Only include IDs that appear verbatim in the catalog.
+- Order by relevance, most relevant first.
+- Return at most the number of IDs requested by the user.
+- If nothing matches, return {"ids": []}.`;
+const IdsSchema = z.object({ ids: z.array(z.string()) });
+function toCatalog(observations) {
+    return observations.map((o) => ({
+        id: o.id,
+        kind: o.kind,
+        title: o.title,
+        tags: o.tags,
+        files: o.files,
+    }));
+}
+function extractJsonBlob(text) {
+    const trimmed = text.trim();
+    const fence = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (fence?.[1])
+        return fence[1].trim();
+    return trimmed;
+}
+const DEFAULT_MAX_CATALOG = 500;
+export class LlmIndexRetriever {
+    name = 'index';
+    store;
+    caller;
+    model;
+    maxCatalog;
+    constructor(db, opts) {
+        this.store = new MemoryStore(db);
+        this.caller = opts.caller;
+        this.model = opts.model;
+        this.maxCatalog = opts.maxCatalog ?? DEFAULT_MAX_CATALOG;
+    }
+    async search(query, options) {
+        if (query.trim().length === 0)
+            return [];
+        // listByProject returns most-recent first, so truncation drops the oldest.
+        const all = this.store.listByProject(options.projectId, { limit: this.maxCatalog });
+        if (all.length === 0)
+            return [];
+        const catalog = toCatalog(all);
+        const user = `Query: ${query}\n\n` +
+            `Return up to ${options.k} IDs.\n\n` +
+            `Catalog:\n${JSON.stringify(catalog)}`;
+        const { text } = await this.caller.complete({
+            model: this.model,
+            system: SYSTEM_PROMPT,
+            user,
+        });
+        let parsed;
+        try {
+            parsed = JSON.parse(extractJsonBlob(text));
+        }
+        catch {
+            return [];
+        }
+        const validated = IdsSchema.safeParse(parsed);
+        if (!validated.success)
+            return [];
+        const byId = new Map(all.map((o) => [o.id, o]));
+        const results = [];
+        const top = validated.data.ids.slice(0, options.k);
+        top.forEach((id, idx) => {
+            const obs = byId.get(id);
+            if (!obs)
+                return;
+            // Synthetic linear score so callers that rank multiple strategies
+            // can still compare. Top hit = 1.0, last hit = ~1/k.
+            const score = (top.length - idx) / top.length;
+            results.push({ id, score, observation: obs, source: 'index' });
+        });
+        return results;
+    }
+}
+//# sourceMappingURL=llm_index.js.map

package/dist/core/retriever/llm_index.js.map

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

package/dist/core/retriever/types.d.ts

@@ -0,0 +1,16 @@
+import type { Observation } from '../schema.js';
+export interface RetrievalResult {
+    id: string;
+    score: number;
+    observation: Observation;
+    source: 'bm25' | 'embeddings' | 'index' | 'hybrid';
+}
+export interface SearchOptions {
+    k: number;
+    projectId: string;
+}
+export interface Retriever {
+    readonly name: 'bm25' | 'embeddings' | 'index' | 'hybrid';
+    search(query: string, options: SearchOptions): Promise<RetrievalResult[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/retriever/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/retriever/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC3E"}

package/dist/core/retriever/types.js

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

package/dist/core/retriever/types.js.map

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