nlm-memory 0.20.0 → 0.20.1

package/dist/core/eval/classifier-fixture-eval.js.map

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

package/dist/core/eval/extraction-scoring.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Pure scoring + aggregation for the classifier extraction-quality eval.
+ *
+ * The scoring model is precision/recall over three extraction surfaces:
+ *  - DECISION PRECISION: of the decisions a candidate extracted, what fraction
+ *    a judge ruled `supported` against the TRANSCRIPT (not the reference -- a
+ *    candidate may legitimately surface a true decision the reference missed).
+ *  - DECISION RECALL: of the REFERENCE decisions, what fraction the judge ruled
+ *    semantically matched by some candidate decision.
+ *  - ENTITY PRECISION: of the entities a candidate extracted, what fraction the
+ *    judge ruled actually present/relevant in the transcript.
+ *
+ * These functions are deterministic and dependency-free. The live judge work
+ * (LLM verdicts) happens in the harness; this module only turns verdict arrays
+ * into rates so the math is unit-testable without an LLM.
+ */
+export type Verdict = "supported" | "unsupported";
+export type MatchVerdict = "matched" | "unmatched";
+export interface ExtractionVerdicts {
+    /** One per candidate-extracted decision: faithful to transcript? */
+    readonly decisionPrecision: ReadonlyArray<Verdict>;
+    /** One per reference decision: matched by any candidate decision? */
+    readonly decisionRecall: ReadonlyArray<MatchVerdict>;
+    /** One per candidate-extracted entity: present/relevant in transcript? */
+    readonly entityPrecision: ReadonlyArray<Verdict>;
+    /** Distinct transcript decisions captured by no extracted decision (judge count). */
+    readonly missedDecisions: number;
+}
+export interface SessionScore {
+    readonly decisionPrecision: number | null;
+    /** Reference-based recall: fraction of reference decisions matched. Position-biased. */
+    readonly decisionRecall: number | null;
+    /** Transcript-grounded recall: supported / (supported + missedDecisions). Reference-free. */
+    readonly decisionRecallTranscript: number | null;
+    readonly entityPrecision: number | null;
+    /** True when the candidate produced no usable ClassifyResult for this session. */
+    readonly schemaFailed: boolean;
+}
+/**
+ * Per-session rates. A surface with zero items yields `null` (not 0): a session
+ * with no extracted decisions has undefined precision, not 0% precision, and
+ * must not drag the mean down. nulls are dropped at aggregation time.
+ */
+export declare function scoreSession(verdicts: ExtractionVerdicts, schemaFailed: boolean): SessionScore;
+export declare function rate<T>(items: ReadonlyArray<T>, hit: (x: T) => boolean): number | null;
+export interface AggregateExtraction {
+    readonly n: number;
+    /** Sessions that produced a usable extraction (n - schema failures). */
+    readonly scored: number;
+    readonly schemaFailures: number;
+    /** Macro-average across sessions that had >= 1 item on the surface. */
+    readonly decisionPrecision: number | null;
+    readonly decisionRecall: number | null;
+    readonly decisionRecallTranscript: number | null;
+    readonly entityPrecision: number | null;
+    /** How many sessions contributed to each surface mean (had >= 1 item). */
+    readonly decisionPrecisionN: number;
+    readonly decisionRecallN: number;
+    readonly decisionRecallTranscriptN: number;
+    readonly entityPrecisionN: number;
+}
+/** Macro-average per-session rates, dropping nulls (surfaces with no items). */
+export declare function aggregateExtraction(scores: ReadonlyArray<SessionScore>): AggregateExtraction;

package/dist/core/eval/extraction-scoring.js

@@ -0,0 +1,79 @@
+/**
+ * Pure scoring + aggregation for the classifier extraction-quality eval.
+ *
+ * The scoring model is precision/recall over three extraction surfaces:
+ *  - DECISION PRECISION: of the decisions a candidate extracted, what fraction
+ *    a judge ruled `supported` against the TRANSCRIPT (not the reference -- a
+ *    candidate may legitimately surface a true decision the reference missed).
+ *  - DECISION RECALL: of the REFERENCE decisions, what fraction the judge ruled
+ *    semantically matched by some candidate decision.
+ *  - ENTITY PRECISION: of the entities a candidate extracted, what fraction the
+ *    judge ruled actually present/relevant in the transcript.
+ *
+ * These functions are deterministic and dependency-free. The live judge work
+ * (LLM verdicts) happens in the harness; this module only turns verdict arrays
+ * into rates so the math is unit-testable without an LLM.
+ */
+/**
+ * Per-session rates. A surface with zero items yields `null` (not 0): a session
+ * with no extracted decisions has undefined precision, not 0% precision, and
+ * must not drag the mean down. nulls are dropped at aggregation time.
+ */
+export function scoreSession(verdicts, schemaFailed) {
+    if (schemaFailed) {
+        return {
+            decisionPrecision: null,
+            decisionRecall: null,
+            decisionRecallTranscript: null,
+            entityPrecision: null,
+            schemaFailed: true,
+        };
+    }
+    const supported = verdicts.decisionPrecision.filter((v) => v === "supported").length;
+    const recallDenom = supported + verdicts.missedDecisions;
+    return {
+        decisionPrecision: rate(verdicts.decisionPrecision, (v) => v === "supported"),
+        decisionRecall: rate(verdicts.decisionRecall, (v) => v === "matched"),
+        decisionRecallTranscript: recallDenom === 0 ? null : supported / recallDenom,
+        entityPrecision: rate(verdicts.entityPrecision, (v) => v === "supported"),
+        schemaFailed: false,
+    };
+}
+export function rate(items, hit) {
+    if (items.length === 0)
+        return null;
+    let n = 0;
+    for (const x of items)
+        if (hit(x))
+            n++;
+    return n / items.length;
+}
+/** Macro-average per-session rates, dropping nulls (surfaces with no items). */
+export function aggregateExtraction(scores) {
+    const schemaFailures = scores.filter((s) => s.schemaFailed).length;
+    const dp = meanOfDefined(scores.map((s) => s.decisionPrecision));
+    const dr = meanOfDefined(scores.map((s) => s.decisionRecall));
+    const drt = meanOfDefined(scores.map((s) => s.decisionRecallTranscript));
+    const ep = meanOfDefined(scores.map((s) => s.entityPrecision));
+    return {
+        n: scores.length,
+        scored: scores.length - schemaFailures,
+        schemaFailures,
+        decisionPrecision: dp.mean,
+        decisionRecall: dr.mean,
+        decisionRecallTranscript: drt.mean,
+        entityPrecision: ep.mean,
+        decisionPrecisionN: dp.count,
+        decisionRecallN: dr.count,
+        decisionRecallTranscriptN: drt.count,
+        entityPrecisionN: ep.count,
+    };
+}
+function meanOfDefined(values) {
+    const defined = values.filter((v) => v !== null);
+    if (defined.length === 0)
+        return { mean: null, count: 0 };
+    const sum = defined.reduce((a, b) => a + b, 0);
+    return { mean: sum / defined.length, count: defined.length };
+}
+//# sourceMappingURL=extraction-scoring.js.map

package/dist/core/eval/extraction-scoring.js.map

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

package/dist/core/eval/run-eval.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Corpus-agnostic R@k / MRR runner shared by `nlm eval` and the regression
+ * gate. Takes a query set with expected ids and a recall searcher, returns a
+ * per-mode report. The query set is supplied by the caller and never bundled.
+ */
+import type { RecallMode } from "../../shared/types.js";
+export interface EvalQuery {
+    readonly query: string;
+    readonly expectedIds: ReadonlyArray<string>;
+}
+export interface EvalReport {
+    readonly mode: RecallMode;
+    readonly n: number;
+    readonly rAt1: number;
+    readonly rAt5: number;
+    readonly mrr: number;
+    readonly misses: ReadonlyArray<{
+        query: string;
+        expected: ReadonlyArray<string>;
+        got: ReadonlyArray<string>;
+    }>;
+}
+interface Searcher {
+    search(q: {
+        query: string;
+        mode: RecallMode;
+        limit: number;
+    }): Promise<{
+        results: ReadonlyArray<{
+            id: string;
+        }>;
+    }>;
+}
+export declare function runEval(deps: {
+    recall: Searcher;
+}, queries: ReadonlyArray<EvalQuery>, opts: {
+    mode: RecallMode;
+    k: number;
+}): Promise<EvalReport>;
+export {};

package/dist/core/eval/run-eval.js

@@ -0,0 +1,34 @@
+/**
+ * Corpus-agnostic R@k / MRR runner shared by `nlm eval` and the regression
+ * gate. Takes a query set with expected ids and a recall searcher, returns a
+ * per-mode report. The query set is supplied by the caller and never bundled.
+ */
+export async function runEval(deps, queries, opts) {
+    let hit1 = 0;
+    let hit5 = 0;
+    let rrSum = 0;
+    const misses = [];
+    for (const q of queries) {
+        const { results } = await deps.recall.search({ query: q.query, mode: opts.mode, limit: opts.k });
+        const ids = results.map((r) => r.id);
+        const rank = ids.findIndex((id) => q.expectedIds.includes(id)) + 1; // 0 => miss
+        if (rank === 1)
+            hit1++;
+        if (rank >= 1 && rank <= 5)
+            hit5++;
+        if (rank >= 1)
+            rrSum += 1 / rank;
+        else
+            misses.push({ query: q.query, expected: q.expectedIds, got: ids });
+    }
+    const n = queries.length || 1;
+    return {
+        mode: opts.mode,
+        n: queries.length,
+        rAt1: hit1 / n,
+        rAt5: hit5 / n,
+        mrr: rrSum / n,
+        misses,
+    };
+}
+//# sourceMappingURL=run-eval.js.map

package/dist/core/eval/run-eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-eval.js","sourceRoot":"","sources":["../../../src/core/eval/run-eval.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAA0B,EAC1B,OAAiC,EACjC,IAAqC;IAErC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,MAAM,GAA0F,EAAE,CAAC;IACzG,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACjG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;QAChF,IAAI,IAAI,KAAK,CAAC;YAAE,IAAI,EAAE,CAAC;QACvB,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;YAAE,IAAI,EAAE,CAAC;QACnC,IAAI,IAAI,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;;YAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,CAAC,EAAE,OAAO,CAAC,MAAM;QACjB,IAAI,EAAE,IAAI,GAAG,CAAC;QACd,IAAI,EAAE,IAAI,GAAG,CAAC;QACd,GAAG,EAAE,KAAK,GAAG,CAAC;QACd,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/core/exemplars/capture-from-session.d.ts

@@ -22,6 +22,7 @@ export interface SessionExemplarContext {
     readonly summary: string;
     readonly decisions: ReadonlyArray<string>;
     readonly installScope: string;
+    readonly model?: string;
 }
 export declare function composeTaskContext(summary: string, decisions: ReadonlyArray<string>): string;
 export declare function captureExemplarsFromSession(ctx: SessionExemplarContext): CodeExemplarInput[];

package/dist/core/exemplars/capture-from-session.js

@@ -11,8 +11,10 @@
  * (the scheduler) to insert + embed. Git failures yield fewer exemplars,
  * never wrong ones.
  */
+import { basename } from "node:path";
 import { detectCommitShas } from "./detect-commits.js";
 import { extractFromGitSha } from "./extract-exemplar.js";
+import { composeEmbedText } from "./embed-text.js";
 const TASK_CONTEXT_CAP = 280;
 export function composeTaskContext(summary, decisions) {
     const base = summary.trim();
@@ -27,10 +29,12 @@ export function captureExemplarsFromSession(ctx) {
     const out = [];
     for (const sha of detectCommitShas(ctx.text)) {
         const exemplar = extractFromGitSha({
-            repo: ctx.projectDir,
+            repo: basename(ctx.projectDir),
+            repoPath: ctx.projectDir,
             sha,
             installScope: ctx.installScope,
             outcome: "pass",
+            ...(ctx.model ? { model: ctx.model } : {}),
             sessionId: ctx.sessionId,
             ts: ctx.startedAt,
             taskContext,
@@ -54,7 +58,7 @@ export async function drainSessionExemplars(ctx, deps) {
                 const embedder = deps.codeEmbedder;
                 const store = deps.exemplarStore;
                 void embedder
-                    .embed(input.taskContext + "\n" + input.code, "document")
+                    .embed(composeEmbedText(input.taskContext, input.code), "document")
                     .then((r) => store.upsertEmbedding(id, r.vector))
                     .catch(() => { });
             }

package/dist/core/exemplars/capture-from-session.js.map

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

package/dist/core/exemplars/diff-parse.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Unified-diff parsing helpers shared by the exemplar extractor (path a) and
+ * the code-signal producer. Pure string functions — no I/O.
+ */
+export interface DiffHunk {
+    readonly file: string;
+    readonly hunkHeader: string;
+    readonly body: string;
+}
+/** Extract a git hunk header funcname: `@@ ... @@ funcname` */
+export declare function parseFuncname(hunkHeader: string): string | null;
+/** Detect likely language from file extension. */
+export declare function detectLang(filePath: string): string | null;
+/**
+ * Parse a unified diff into individual hunks. Returns (file, hunkHeader, body) triples.
+ */
+export declare function parseHunks(diff: string): DiffHunk[];
+/**
+ * Extract the added/changed lines from a hunk body (strip context and removed lines).
+ */
+export declare function extractAddedLines(hunkBody: string): string;
+/** Pick the hunk with the most non-blank added lines (most representative). */
+export declare function selectLargestHunk(hunks: readonly DiffHunk[]): DiffHunk | null;

package/dist/core/exemplars/diff-parse.js

@@ -0,0 +1,73 @@
+/**
+ * Unified-diff parsing helpers shared by the exemplar extractor (path a) and
+ * the code-signal producer. Pure string functions — no I/O.
+ */
+/** Extract a git hunk header funcname: `@@ ... @@ funcname` */
+export function parseFuncname(hunkHeader) {
+    const m = hunkHeader.match(/@@ [^@]+ @@ (.+)/);
+    return m?.[1]?.trim() ?? null;
+}
+/** Detect likely language from file extension. */
+export function detectLang(filePath) {
+    const ext = filePath.split(".").pop()?.toLowerCase() ?? "";
+    const map = {
+        ts: "ts", tsx: "ts", js: "js", jsx: "js", mjs: "js",
+        py: "py", go: "go", rb: "rb", rs: "rs", java: "java",
+        c: "c", cpp: "cpp", cs: "cs", swift: "swift", kt: "kt",
+        sh: "sh", bash: "sh", zsh: "sh",
+    };
+    return map[ext] ?? null;
+}
+/**
+ * Parse a unified diff into individual hunks. Returns (file, hunkHeader, body) triples.
+ */
+export function parseHunks(diff) {
+    const result = [];
+    let currentFile = "";
+    let currentHeader = "";
+    let bodyLines = [];
+    for (const line of diff.split("\n")) {
+        if (line.startsWith("+++ b/")) {
+            currentFile = line.slice(6);
+        }
+        else if (line.startsWith("@@ ")) {
+            if (currentHeader && bodyLines.length > 0) {
+                result.push({ file: currentFile, hunkHeader: currentHeader, body: bodyLines.join("\n") });
+            }
+            currentHeader = line;
+            bodyLines = [];
+        }
+        else if (currentHeader && (line.startsWith("+") || line.startsWith("-") || line.startsWith(" "))) {
+            bodyLines.push(line);
+        }
+    }
+    if (currentHeader && bodyLines.length > 0) {
+        result.push({ file: currentFile, hunkHeader: currentHeader, body: bodyLines.join("\n") });
+    }
+    return result;
+}
+/**
+ * Extract the added/changed lines from a hunk body (strip context and removed lines).
+ */
+export function extractAddedLines(hunkBody) {
+    return hunkBody
+        .split("\n")
+        .filter((l) => l.startsWith("+"))
+        .map((l) => l.slice(1))
+        .join("\n");
+}
+/** Pick the hunk with the most non-blank added lines (most representative). */
+export function selectLargestHunk(hunks) {
+    let best;
+    let bestCount = 0;
+    for (const h of hunks) {
+        const added = extractAddedLines(h.body);
+        const count = added.split("\n").filter((l) => l.trim()).length;
+        if (count > bestCount) {
+            bestCount = count;
+            best = h;
+        }
+    }
+    return best ?? null;
+}
+//# sourceMappingURL=diff-parse.js.map

package/dist/core/exemplars/diff-parse.js.map

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

package/dist/core/exemplars/embed-backfill.d.ts

@@ -0,0 +1,36 @@
+/**
+ * exemplar embed-backfill — (re)embed code_exemplars rows that are missing a
+ * vector. The /api/signal capture path embeds exemplars fire-and-forget; a
+ * cold CodeRankEmbed model on first capture can drop the vector, leaving the
+ * exemplar permanently unretrievable (recall_code is vector-only). This is
+ * the repair: discover rows with no entry in code_exemplars_vec, embed
+ * taskContext + code via the CodeEmbedder, and upsert the vector.
+ *
+ * Mirrors the session embed-backfill (reembedCorpus): same embed-text shape
+ * as the live capture path (composeEmbedText, role "document"), the store's
+ * existing upsertEmbedding, and a single retry on transient
+ * embedder failures. Idempotent — rows that already have a vector are skipped
+ * (discovery is by absence in the vec table, so a second run finds nothing).
+ *
+ * Layering: depends on the CodeExemplarStore port for the upsert and on a
+ * read-only better-sqlite3 handle for discovery (the store has no
+ * "list rows missing a vector" method and adding one to the port for a
+ * one-shot operational tool isn't worth it — same direct-SQLite call the
+ * session backfill makes).
+ */
+import type { CodeEmbedder } from "../../ports/code-embedder.js";
+import type { CodeExemplarStore } from "../../ports/code-exemplar-store.js";
+export interface ExemplarBackfillOptions {
+    readonly dbPath: string;
+    readonly embedder: CodeEmbedder;
+    readonly store: CodeExemplarStore;
+    readonly limit?: number;
+    readonly onProgress?: (i: number, total: number, id: string, status: string) => void;
+}
+export interface ExemplarBackfillReport {
+    readonly total: number;
+    readonly succeeded: number;
+    readonly failed: number;
+    readonly dbMissing: boolean;
+}
+export declare function backfillExemplarEmbeddings(opts: ExemplarBackfillOptions): Promise<ExemplarBackfillReport>;

package/dist/core/exemplars/embed-backfill.js

@@ -0,0 +1,85 @@
+/**
+ * exemplar embed-backfill — (re)embed code_exemplars rows that are missing a
+ * vector. The /api/signal capture path embeds exemplars fire-and-forget; a
+ * cold CodeRankEmbed model on first capture can drop the vector, leaving the
+ * exemplar permanently unretrievable (recall_code is vector-only). This is
+ * the repair: discover rows with no entry in code_exemplars_vec, embed
+ * taskContext + code via the CodeEmbedder, and upsert the vector.
+ *
+ * Mirrors the session embed-backfill (reembedCorpus): same embed-text shape
+ * as the live capture path (composeEmbedText, role "document"), the store's
+ * existing upsertEmbedding, and a single retry on transient
+ * embedder failures. Idempotent — rows that already have a vector are skipped
+ * (discovery is by absence in the vec table, so a second run finds nothing).
+ *
+ * Layering: depends on the CodeExemplarStore port for the upsert and on a
+ * read-only better-sqlite3 handle for discovery (the store has no
+ * "list rows missing a vector" method and adding one to the port for a
+ * one-shot operational tool isn't worth it — same direct-SQLite call the
+ * session backfill makes).
+ */
+import { existsSync } from "node:fs";
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { LLMUnreachableError } from "../../ports/llm-client.js";
+import { composeEmbedText } from "./embed-text.js";
+export async function backfillExemplarEmbeddings(opts) {
+    if (!existsSync(opts.dbPath)) {
+        return { total: 0, succeeded: 0, failed: 0, dbMissing: true };
+    }
+    const db = new Database(opts.dbPath, { readonly: true });
+    sqliteVec.load(db);
+    let rows;
+    try {
+        const sql = "SELECT e.id, e.task_context, e.code FROM code_exemplars e " +
+            "WHERE e.id NOT IN (SELECT exemplar_id FROM code_exemplars_vec) " +
+            "ORDER BY e.created_at" +
+            (opts.limit ? ` LIMIT ${Math.trunc(opts.limit)}` : "");
+        rows = db.prepare(sql).all();
+    }
+    finally {
+        db.close();
+    }
+    const total = rows.length;
+    let succeeded = 0;
+    let failed = 0;
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        const idx = i + 1;
+        const text = composeEmbedText(row.task_context, row.code);
+        let vector;
+        let lastErr;
+        for (let attempt = 0; attempt < 2; attempt++) {
+            try {
+                const out = await opts.embedder.embed(text, "document");
+                vector = out.vector;
+                lastErr = undefined;
+                break;
+            }
+            catch (e) {
+                lastErr = e;
+                if (!(e instanceof LLMUnreachableError))
+                    throw e;
+                if (attempt === 0)
+                    await new Promise((r) => setTimeout(r, 200));
+            }
+        }
+        if (vector === undefined) {
+            failed += 1;
+            opts.onProgress?.(idx, total, row.id, `FAIL (embedder): ${lastErr?.message ?? "unknown"}`);
+            continue;
+        }
+        try {
+            await opts.store.upsertEmbedding(row.id, vector);
+        }
+        catch (e) {
+            failed += 1;
+            opts.onProgress?.(idx, total, row.id, `FAIL (db): ${e.message}`);
+            continue;
+        }
+        succeeded += 1;
+        opts.onProgress?.(idx, total, row.id, "OK");
+    }
+    return { total, succeeded, failed, dbMissing: false };
+}
+//# sourceMappingURL=embed-backfill.js.map

package/dist/core/exemplars/embed-backfill.js.map

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

package/dist/core/exemplars/embed-text.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The embed payload for a code exemplar is `taskContext + "\n" + code`. The
+ * code embedder (CodeRankEmbed) has a ~512-token context window; a real commit
+ * diff easily exceeds it, at which point Ollama returns HTTP 500 ("the input
+ * length exceeds the context length") and the vector is silently dropped —
+ * leaving the exemplar unretrievable (recall_code is vector-only).
+ *
+ * composeEmbedText is the single place both the live capture path and the
+ * backfill build that payload, capping it so the embed always fits. 2000 chars
+ * sits comfortably under the window even for token-dense code (empirically the
+ * window tolerates ~4000 chars; 2000 leaves margin for the model's prompt
+ * prefix and tokenizer variance).
+ */
+export declare const EMBED_TEXT_CAP = 2000;
+export declare function composeEmbedText(taskContext: string, code: string): string;

package/dist/core/exemplars/embed-text.js

@@ -0,0 +1,18 @@
+/**
+ * The embed payload for a code exemplar is `taskContext + "\n" + code`. The
+ * code embedder (CodeRankEmbed) has a ~512-token context window; a real commit
+ * diff easily exceeds it, at which point Ollama returns HTTP 500 ("the input
+ * length exceeds the context length") and the vector is silently dropped —
+ * leaving the exemplar unretrievable (recall_code is vector-only).
+ *
+ * composeEmbedText is the single place both the live capture path and the
+ * backfill build that payload, capping it so the embed always fits. 2000 chars
+ * sits comfortably under the window even for token-dense code (empirically the
+ * window tolerates ~4000 chars; 2000 leaves margin for the model's prompt
+ * prefix and tokenizer variance).
+ */
+export const EMBED_TEXT_CAP = 2000;
+export function composeEmbedText(taskContext, code) {
+    return (taskContext + "\n" + code).slice(0, EMBED_TEXT_CAP);
+}
+//# sourceMappingURL=embed-text.js.map

package/dist/core/exemplars/embed-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-text.js","sourceRoot":"","sources":["../../../src/core/exemplars/embed-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,IAAY;IAChE,OAAO,CAAC,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AAC9D,CAAC"}