nlm-memory 0.11.1 → 0.13.0

package/dist/core/exemplars/extract-exemplar.js

@@ -0,0 +1,177 @@
+/**
+ * Exemplar extraction from a Signal.
+ *
+ * Two sourcing paths (plan section 2):
+ * (a) git diff at the linked commit — language-agnostic, preferred for
+ *     gate/test signals tied to a commit; uses git's hunk headers for
+ *     free funcname capture.
+ * (b) producer-supplied code in signal.detail.code — for pre-commit gates
+ *     and eval harnesses where no commit exists yet.
+ *
+ * Returns null when neither path produces a valid chunk, so the caller can
+ * skip without error.
+ */
+import { execFileSync } from "node:child_process";
+import { codeHash, normalizeExemplar } from "./ingest-exemplar.js";
+/** Extract a git hunk header funcname: `@@ ... @@ funcname` */
+function parseFuncname(hunkHeader) {
+    const m = hunkHeader.match(/@@ [^@]+ @@ (.+)/);
+    return m?.[1]?.trim() ?? null;
+}
+/** Detect likely language from file extension. */
+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.
+ */
+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).
+ */
+function extractAddedLines(hunkBody) {
+    return hunkBody
+        .split("\n")
+        .filter((l) => l.startsWith("+"))
+        .map((l) => l.slice(1))
+        .join("\n");
+}
+/**
+ * Path (a): extract exemplar from a git commit's diff.
+ * Returns null if the git command fails or no valid hunks are found.
+ */
+export function extractFromGitSha(signal, gitSha, opts) {
+    const repoPath = opts.repoPath ?? signal.repo;
+    let diff;
+    try {
+        diff = execFileSync("git", ["show", "--unified=3", "--diff-filter=AM", gitSha], { cwd: repoPath, encoding: "utf8", timeout: 10_000 });
+    }
+    catch {
+        return null;
+    }
+    const hunks = parseHunks(diff);
+    if (hunks.length === 0)
+        return null;
+    // Pick the largest hunk by added-line count (most representative).
+    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;
+        }
+    }
+    if (!best)
+        return null;
+    const code = extractAddedLines(best.body);
+    const funcname = parseFuncname(best.hunkHeader);
+    const taskContext = funcname
+        ? `${funcname} (${best.file})`
+        : `changes in ${best.file}`;
+    try {
+        return normalizeExemplar({
+            installScope: opts.installScope,
+            signalId: signal.id,
+            sessionId: signal.sessionId,
+            repo: signal.repo,
+            model: signal.model,
+            lang: detectLang(best.file),
+            taskContext,
+            code,
+            outcome: signal.outcome,
+            gitSha,
+            survived: null,
+            ts: signal.ts,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Path (b): extract exemplar from signal.detail.code (producer-supplied).
+ * Returns null if detail.code is absent or doesn't pass size validation.
+ */
+export function extractFromDetail(signal, opts) {
+    const detail = signal.detail;
+    if (!detail || typeof detail["code"] !== "string")
+        return null;
+    const code = detail["code"];
+    const taskContext = typeof detail["task"] === "string"
+        ? detail["task"]
+        : typeof signal.step === "string"
+            ? signal.step
+            : "agent-supplied code";
+    const lang = typeof detail["lang"] === "string" ? detail["lang"] : null;
+    try {
+        return normalizeExemplar({
+            installScope: opts.installScope,
+            signalId: signal.id,
+            sessionId: signal.sessionId,
+            repo: signal.repo,
+            model: signal.model,
+            lang,
+            taskContext,
+            code,
+            outcome: signal.outcome,
+            gitSha: typeof detail["git_sha"] === "string" ? detail["git_sha"] : null,
+            survived: null,
+            ts: signal.ts,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Top-level: try path (a) first, fall back to path (b).
+ * Inline with signal ingest; called after a signal is stored.
+ */
+export function extractExemplar(signal, opts) {
+    // Path (a): git sha from detail, if present.
+    const gitSha = signal.detail && typeof signal.detail["git_sha"] === "string"
+        ? signal.detail["git_sha"]
+        : null;
+    if (gitSha) {
+        const repoPath = opts.repoBasePath ? `${opts.repoBasePath}/${signal.repo}` : signal.repo;
+        const fromGit = extractFromGitSha(signal, gitSha, { installScope: opts.installScope, repoPath });
+        if (fromGit)
+            return fromGit;
+    }
+    // Path (b): producer-supplied code in detail.
+    return extractFromDetail(signal, opts);
+}
+//# sourceMappingURL=extract-exemplar.js.map

package/dist/core/exemplars/extract-exemplar.js.map

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

package/dist/core/exemplars/ingest-exemplar.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Boundary validation + normalization for inbound code exemplars.
+ *
+ * Parallel to ingest-signal.ts: validates at the boundary (fail loud),
+ * soft-defaults optional fields. The id is deterministic so re-ingesting
+ * the same chunk is a no-op at the store layer (INSERT OR IGNORE).
+ *
+ * Gated by NLM_CODE_EXEMPLARS_ENABLED. Callers must check the flag.
+ */
+import type { CodeExemplarInput } from "../../shared/types.js";
+/**
+ * sha256 of the code after whitespace normalization.
+ * Normalization: trim trailing whitespace per line + collapse blank runs.
+ */
+export declare function codeHash(code: string): string;
+export interface RawExemplarPayload {
+    readonly installScope: string;
+    readonly signalId?: string | null;
+    readonly sessionId?: string | null;
+    readonly repo: string;
+    readonly model: string;
+    readonly lang?: string | null;
+    readonly taskContext: string;
+    readonly code: string;
+    readonly outcome: string;
+    readonly gitSha?: string | null;
+    readonly survived?: 0 | 1 | null;
+    readonly ts?: string;
+}
+export declare function normalizeExemplar(raw: RawExemplarPayload, now?: () => string): CodeExemplarInput;

package/dist/core/exemplars/ingest-exemplar.js

@@ -0,0 +1,71 @@
+/**
+ * Boundary validation + normalization for inbound code exemplars.
+ *
+ * Parallel to ingest-signal.ts: validates at the boundary (fail loud),
+ * soft-defaults optional fields. The id is deterministic so re-ingesting
+ * the same chunk is a no-op at the store layer (INSERT OR IGNORE).
+ *
+ * Gated by NLM_CODE_EXEMPLARS_ENABLED. Callers must check the flag.
+ */
+import { createHash } from "node:crypto";
+const OUTCOMES = new Set(["pass", "fail", "fix", "exhausted"]);
+const MIN_MEANINGFUL_LINES = 2;
+const MAX_LINES = 200;
+/**
+ * sha256 of the code after whitespace normalization.
+ * Normalization: trim trailing whitespace per line + collapse blank runs.
+ */
+export function codeHash(code) {
+    const normalized = code
+        .split("\n")
+        .map((l) => l.trimEnd())
+        .filter((l, i, arr) => l !== "" || arr[i - 1] !== "")
+        .join("\n")
+        .trim();
+    return createHash("sha256").update(normalized).digest("hex");
+}
+/** Count non-blank, non-brace-only lines. */
+function meaningfulLineCount(code) {
+    return code.split("\n").filter((l) => {
+        const t = l.trim();
+        return t.length > 0 && t !== "{" && t !== "}" && t !== "}" + ";" && t !== "};";
+    }).length;
+}
+export function normalizeExemplar(raw, now = () => new Date().toISOString()) {
+    const outcome = raw.outcome;
+    if (!OUTCOMES.has(outcome)) {
+        throw new Error(`exemplar.outcome must be one of pass|fail|fix|exhausted (got ${String(outcome)})`);
+    }
+    if (!raw.repo || typeof raw.repo !== "string") {
+        throw new Error("exemplar.repo is required");
+    }
+    if (!raw.taskContext || typeof raw.taskContext !== "string") {
+        throw new Error("exemplar.taskContext is required");
+    }
+    if (!raw.code || typeof raw.code !== "string") {
+        throw new Error("exemplar.code is required");
+    }
+    const meaningful = meaningfulLineCount(raw.code);
+    if (meaningful < MIN_MEANINGFUL_LINES) {
+        throw new Error(`exemplar.code too small (${meaningful} meaningful lines, minimum ${MIN_MEANINGFUL_LINES})`);
+    }
+    if (meaningful > MAX_LINES) {
+        throw new Error(`exemplar.code too large (${meaningful} meaningful lines, maximum ${MAX_LINES}); split into smaller hunks`);
+    }
+    return {
+        installScope: raw.installScope,
+        signalId: raw.signalId ?? null,
+        sessionId: raw.sessionId ?? null,
+        repo: raw.repo,
+        model: raw.model || "unknown",
+        lang: raw.lang ?? null,
+        taskContext: raw.taskContext,
+        code: raw.code,
+        codeHash: codeHash(raw.code),
+        outcome: outcome,
+        gitSha: raw.gitSha ?? null,
+        survived: raw.survived ?? null,
+        ts: raw.ts ?? now(),
+    };
+}
+//# sourceMappingURL=ingest-exemplar.js.map

package/dist/core/exemplars/ingest-exemplar.js.map

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

package/dist/core/exemplars/recall-code.d.ts

@@ -0,0 +1,25 @@
+/**
+ * recall-code — semantic search over the code-exemplar lane.
+ *
+ * Embeds the query with the code embedder (or falls back to the prose embedder),
+ * delegates to CodeExemplarStore.searchByVector, and formats results.
+ * Negatives are returned clearly labeled — "code that failed the gate" is
+ * as useful to the caller as the positive.
+ */
+import type { CodeEmbedder } from "../../ports/code-embedder.js";
+import type { CodeExemplarSearchFilter, CodeExemplarStore } from "../../ports/code-exemplar-store.js";
+import type { LLMClient } from "../../ports/llm-client.js";
+import type { CodeExemplarHit } from "../../shared/types.js";
+export interface RecallCodeOptions extends CodeExemplarSearchFilter {
+    /** Natural-language description of the task. Used to build the query vector. */
+    readonly query: string;
+}
+export interface RecallCodeResult {
+    readonly positives: ReadonlyArray<CodeExemplarHit>;
+    readonly negatives: ReadonlyArray<CodeExemplarHit>;
+}
+/**
+ * Recall code exemplars. Returns positives (pass/fix) and negatives (fail/exhausted)
+ * as separate lists so the caller can surface them with distinct framing.
+ */
+export declare function recallCode(opts: RecallCodeOptions, store: CodeExemplarStore, codeEmbedder: CodeEmbedder | null, proseFallback: LLMClient | null): Promise<RecallCodeResult>;

package/dist/core/exemplars/recall-code.js

@@ -0,0 +1,49 @@
+/**
+ * recall-code — semantic search over the code-exemplar lane.
+ *
+ * Embeds the query with the code embedder (or falls back to the prose embedder),
+ * delegates to CodeExemplarStore.searchByVector, and formats results.
+ * Negatives are returned clearly labeled — "code that failed the gate" is
+ * as useful to the caller as the positive.
+ */
+/**
+ * Recall code exemplars. Returns positives (pass/fix) and negatives (fail/exhausted)
+ * as separate lists so the caller can surface them with distinct framing.
+ */
+export async function recallCode(opts, store, codeEmbedder, proseFallback) {
+    let queryVector = null;
+    if (codeEmbedder) {
+        try {
+            const result = await codeEmbedder.embed(opts.query, "query");
+            queryVector = result.vector;
+        }
+        catch {
+            // Degraded: fall through to prose fallback
+        }
+    }
+    if (!queryVector && proseFallback) {
+        try {
+            const result = await proseFallback.embed(opts.query, "query");
+            queryVector = result.vector;
+        }
+        catch {
+            // No embedder available
+        }
+    }
+    if (!queryVector) {
+        return { positives: [], negatives: [] };
+    }
+    const filter = {
+        installScope: opts.installScope,
+        ...(opts.repo !== undefined && { repo: opts.repo }),
+        ...(opts.lang !== undefined && { lang: opts.lang }),
+        ...(opts.model !== undefined && { model: opts.model }),
+        includeNegatives: opts.includeNegatives ?? true,
+        k: opts.k ?? 5,
+    };
+    const hits = await store.searchByVector(queryVector, filter);
+    const positives = hits.filter((h) => h.outcome === "pass" || h.outcome === "fix");
+    const negatives = hits.filter((h) => h.outcome === "fail" || h.outcome === "exhausted");
+    return { positives, negatives };
+}
+//# sourceMappingURL=recall-code.js.map

package/dist/core/exemplars/recall-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-code.js","sourceRoot":"","sources":["../../../src/core/exemplars/recall-code.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAuB,EACvB,KAAwB,EACxB,YAAiC,EACjC,aAA+B;IAE/B,IAAI,WAAW,GAAwB,IAAI,CAAC;IAE5C,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7D,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,aAAa,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC9D,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAA6B;QACvC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;QAC/C,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;KACf,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE7D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;IAClF,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;IAExF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/facts/backfill-facts.d.ts

@@ -17,10 +17,12 @@
  */
 import type { SqliteFactStore } from "../storage/sqlite-fact-store.js";
 import type { SqliteSessionStore } from "../storage/sqlite-session-store.js";
+import { PgSessionStore } from "../storage/pg-session-store.js";
+import type { PgFactStore } from "../storage/pg-fact-store.js";
 import type { LLMClient } from "../../ports/llm-client.js";
 export interface BackfillFactsOptions {
-    readonly store: SqliteSessionStore;
-    readonly factStore: SqliteFactStore;
+    readonly store: SqliteSessionStore | PgSessionStore;
+    readonly factStore: SqliteFactStore | PgFactStore;
     readonly classifier: LLMClient;
     /** Optional embedder. When omitted, facts are written without semantic vectors. */
     readonly embedder?: LLMClient | null;

package/dist/core/facts/backfill-facts.js

@@ -19,6 +19,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
 import { extractFacts } from "../facts/extract-facts.js";
+import { PgSessionStore } from "../storage/pg-session-store.js";
 import { LLMUnreachableError } from "../../ports/llm-client.js";
 const DEFAULT_STATE_PATH = join(homedir(), ".nlm", "backfill_facts.state");
 const SAVE_EVERY = 25;
@@ -43,34 +44,16 @@ export async function backfillFacts(opts) {
     const startedAtCutoff = new Date().toISOString();
     const statePath = opts.statePath ?? DEFAULT_STATE_PATH;
     const done = opts.dryRun ? new Set() : loadState(statePath);
-    const db = opts.store.rawDb();
     // Eligible sessions: started strictly before this run's cutoff (don't
     // race with live ingest), with a non-empty body (the classifier needs
     // transcript text). When reprocess=false, exclude sessions that already
-    // have facts attributed to them.
-    const sql = opts.reprocess
-        ? `
-      SELECT id, started_at, body
-      FROM sessions
-      WHERE started_at < ?
-        AND body IS NOT NULL AND length(body) > 0
-        ${opts.from ? "AND id > ?" : ""}
-      ORDER BY started_at ASC, id ASC
-    `
-        : `
-      SELECT s.id, s.started_at, s.body
-      FROM sessions s
-      WHERE s.started_at < ?
-        AND s.body IS NOT NULL AND length(s.body) > 0
-        AND NOT EXISTS (
-          SELECT 1 FROM facts f WHERE f.source_session_id = s.id
-        )
-        ${opts.from ? "AND s.id > ?" : ""}
-      ORDER BY s.started_at ASC, s.id ASC
-    `;
-    const rows = opts.from
-        ? db.prepare(sql).all(startedAtCutoff, opts.from)
-        : db.prepare(sql).all(startedAtCutoff);
+    // have facts attributed to them. SQL lives in each adapter's
+    // listBackfillCandidates so backfill is backend-agnostic.
+    const rows = await opts.store.listBackfillCandidates({
+        cutoff: startedAtCutoff,
+        ...(opts.from ? { from: opts.from } : {}),
+        reprocess: opts.reprocess ?? false,
+    });
     // Filter state-file-known done ids BEFORE applying limit. Without this,
     // a dense cluster of previously-skipped (low-confidence) sessions would
     // burn the batch's --limit on no-op skips. With it, --limit N means
@@ -119,7 +102,7 @@ export async function backfillFacts(opts) {
                 break;
             continue;
         }
-        const facts = extractFacts(classification, sid, row.started_at);
+        const facts = extractFacts(classification, sid, row.startedAt);
         if (facts.length === 0) {
             skippedLowConfidence += 1;
             opts.onProgress?.(i + 1, total, sid, "skipped_low_confidence", `confidence=${classification.confidence}`);
@@ -137,7 +120,15 @@ export async function backfillFacts(opts) {
             continue;
         }
         try {
-            await opts.store.insertFactsForSession(sid, opts.factStore, facts, opts.embedder ?? null);
+            // store + factStore share a backend (composed together in buildStorage),
+            // so the factStore cast is sound — TS just can't correlate the two union
+            // members at one call site.
+            if (opts.store instanceof PgSessionStore) {
+                await opts.store.insertFactsForSession(sid, opts.factStore, facts, opts.embedder ?? null);
+            }
+            else {
+                await opts.store.insertFactsForSession(sid, opts.factStore, facts, opts.embedder ?? null);
+            }
         }
         catch (err) {
             storageFailures += 1;

package/dist/core/facts/backfill-facts.js.map

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

package/dist/core/hook/strip-injected-context.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Removes NLM's own injected recall pointer block from a transcript before it
+ * is classified. The recall hook prepends a "Possibly-relevant prior sessions"
+ * / "Known facts about top entities" block (see pointer-block.ts) to the user
+ * prompt every turn; that block lands in the stored transcript and the
+ * classifier then extracted "facts" FROM it — a feedback loop that produced
+ * garbage facts like `acme-app owner: user` sourced from the recall block
+ * itself (NLM #325).
+ *
+ * The block is bounded: it starts at one of the two known headers and always
+ * ends with the `NLM tools:` footer (formatPointerBlock emits it
+ * unconditionally). We strip header→footer inclusive. A header with no
+ * following footer is left in place — that signals truncated/real content, and
+ * dropping to end-of-text could eat the user's actual message.
+ */
+/**
+ * The recall pointer block's marker strings — the single source of truth.
+ * The shipped pi recall hook (nlm/index.js) carries its own copy of these in
+ * its self-contained formatPointerBlock; recall-marker-contract.test.ts asserts
+ * the hook still emits these so marker drift can't silently reopen the loop.
+ */
+export declare const BLOCK_HEADERS: string[];
+export declare const FOOTER_PREFIX = "NLM tools:";
+export declare function stripInjectedContext(text: string): string;

package/dist/core/hook/strip-injected-context.js

@@ -0,0 +1,73 @@
+/**
+ * Removes NLM's own injected recall pointer block from a transcript before it
+ * is classified. The recall hook prepends a "Possibly-relevant prior sessions"
+ * / "Known facts about top entities" block (see pointer-block.ts) to the user
+ * prompt every turn; that block lands in the stored transcript and the
+ * classifier then extracted "facts" FROM it — a feedback loop that produced
+ * garbage facts like `acme-app owner: user` sourced from the recall block
+ * itself (NLM #325).
+ *
+ * The block is bounded: it starts at one of the two known headers and always
+ * ends with the `NLM tools:` footer (formatPointerBlock emits it
+ * unconditionally). We strip header→footer inclusive. A header with no
+ * following footer is left in place — that signals truncated/real content, and
+ * dropping to end-of-text could eat the user's actual message.
+ */
+/**
+ * The recall pointer block's marker strings — the single source of truth.
+ * The shipped pi recall hook (nlm/index.js) carries its own copy of these in
+ * its self-contained formatPointerBlock; recall-marker-contract.test.ts asserts
+ * the hook still emits these so marker drift can't silently reopen the loop.
+ */
+export const BLOCK_HEADERS = [
+    "## Possibly-relevant prior sessions (nlm-memory)",
+    "## Known facts about top entities",
+];
+export const FOOTER_PREFIX = "NLM tools:";
+export function stripInjectedContext(text) {
+    if (!text.includes(FOOTER_PREFIX))
+        return text;
+    const lines = text.split("\n");
+    const kept = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        if (BLOCK_HEADERS.includes(line.trim())) {
+            const footerIdx = findFooter(lines, i + 1);
+            if (footerIdx !== -1) {
+                i = footerIdx; // skip header..footer inclusive
+                continue;
+            }
+        }
+        kept.push(line);
+    }
+    return collapseBlankRuns(kept).join("\n");
+}
+function findFooter(lines, from) {
+    for (let i = from; i < lines.length; i++) {
+        if ((lines[i] ?? "").startsWith(FOOTER_PREFIX))
+            return i;
+    }
+    return -1;
+}
+/** Collapse 3+ consecutive blank lines (left by removal) down to one. */
+function collapseBlankRuns(lines) {
+    const out = [];
+    let blanks = 0;
+    for (const line of lines) {
+        if (line.trim() === "") {
+            blanks += 1;
+            if (blanks > 1)
+                continue;
+        }
+        else {
+            blanks = 0;
+        }
+        out.push(line);
+    }
+    while (out.length > 0 && (out[0] ?? "").trim() === "")
+        out.shift();
+    while (out.length > 0 && (out[out.length - 1] ?? "").trim() === "")
+        out.pop();
+    return out;
+}
+//# sourceMappingURL=strip-injected-context.js.map

package/dist/core/hook/strip-injected-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-injected-context.js","sourceRoot":"","sources":["../../../src/core/hook/strip-injected-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,kDAAkD;IAClD,mCAAmC;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3C,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrB,CAAC,GAAG,SAAS,CAAC,CAAC,gCAAgC;gBAC/C,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,KAA4B,EAAE,IAAY;IAC5D,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,yEAAyE;AACzE,SAAS,iBAAiB,CAAC,KAA4B;IACrD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,MAAM,GAAG,CAAC;gBAAE,SAAS;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IACnE,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAC9E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/ingest/ingest-session.d.ts

@@ -8,6 +8,8 @@
  */
 import type { SqliteFactStore } from "../storage/sqlite-fact-store.js";
 import type { SqliteSessionStore } from "../storage/sqlite-session-store.js";
+import { PgSessionStore } from "../storage/pg-session-store.js";
+import type { PgFactStore } from "../storage/pg-fact-store.js";
 import type { LLMClient } from "../../ports/llm-client.js";
 export interface IngestInput {
     /** Optional — if omitted, derived from a hash of (runtime + startedAt + text). */
@@ -24,8 +26,8 @@ export interface IngestInput {
 export interface IngestDeps {
     readonly classifier: LLMClient;
     readonly embedder: LLMClient;
-    readonly store: SqliteSessionStore;
-    readonly factStore?: SqliteFactStore;
+    readonly store: SqliteSessionStore | PgSessionStore;
+    readonly factStore?: SqliteFactStore | PgFactStore;
     /** Optional logger — defaults to console.error. */
     readonly log?: (msg: string) => void;
 }