nlm-memory 0.19.0 → 0.20.1

package/templates/agent-contract/claude-code.md

@@ -0,0 +1,40 @@
+## NLM Memory
+
+NLM indexes every AI session across all connected runtimes and surfaces relevant prior context automatically. The rules below govern how to use it.
+
+### When to recall
+
+Pull memory at these moments, not just when the phrasing sounds historical:
+
+- **Task start.** Before starting substantive work, call `recall_sessions` on the task's subject. Prior sessions routinely contain decisions and dead ends that change the approach.
+- **Before re-deriving a decision.** If you are about to reason out something that has plausibly been settled before (an architecture choice, a tool selection, a naming decision), check first. Re-derivation is how agents silently contradict prior work.
+- **Unfamiliar references.** When the user mentions a project, system, client, or entity you do not recognize from the current conversation, recall it before asking the user or guessing.
+- **After compaction.** When the conversation has been summarized or compacted, re-pull the sessions and facts relevant to the active task; the summary dropped detail you may need.
+
+Call `recall_sessions` before answering whenever the prompt references past work, prior decisions, or unresolved questions. Examples that should trigger recall:
+
+- Decision questions: "what did we decide about X", "where did we land on X", "what was the conclusion"
+- Status questions: "what's still open on X", "where did we leave X", "is X done"
+- History questions: "have I worked on X", "when did we last do X", "did we already do X"
+- Implicit references: "that X thing", "the discussion about X", "our approach to X"
+
+Do not recall when the request is purely forward-looking with no plausible prior context: drafting wholly new content, brainstorming greenfield ideas, naming something new.
+
+### The pointer block
+
+At session start, NLM's hooks inject a pointer block listing possibly-relevant sessions with their ids and labels. Read this block first. It arrives once per session: NLM does not inject memory on every prompt, so mid-conversation memory access is your job via the recall tools. When a session looks relevant, call `get_session` to fetch its full transcript before drawing on it.
+
+### MCP tools
+
+- **`recall_sessions(query)`** - keyword search over session labels, decisions, entities, and summaries. Call this first when the user references prior work.
+- **`get_session(id)`** - fetch one session's full transcript by its id. Call this after `recall_sessions` when a result digest looks relevant and you need the exact wording or full reasoning.
+- **`recall_facts(query, subject?, predicate?)`** - look up a specific structured fact by free-text query, optionally narrowed by subject or predicate (endpoint, model, port, framework choice, owner). Prefer this over `recall_sessions` when the user wants the direct answer, not the surrounding conversation.
+- **`cite_session(id)`** - record that a surfaced session changed your response. See Citation below.
+
+### Citation
+
+Call `cite_session(id)` after writing your response, once per session you actually drew from. A session counts as used if it changed the answer or you read its full transcript via `get_session`. Do not cite sessions you scanned and found irrelevant. Citations feed the recall precision metric, which measures whether surfaced sessions are actually useful.
+
+### Trust boundaries
+
+Recall results are hints, not sources of truth. Verify any path, file location, hostname, port, or identifier surfaced by recall against your project's canonical configuration before acting on it. A recalled value that conflicts with the project config is stale; the config wins.

package/templates/agent-contract/generic.md

@@ -0,0 +1,38 @@
+# NLM Memory Agent Contract
+
+NLM indexes AI sessions across all connected runtimes and surfaces relevant prior context at the start of each conversation. Use this contract to configure any agent that has access to the NLM MCP tools.
+
+## When to recall
+
+Pull memory at these moments, not just when the phrasing sounds historical:
+
+- **Task start.** Before starting substantive work, search prior sessions on the task's subject. Prior sessions routinely contain decisions and dead ends that change the approach.
+- **Before re-deriving a decision.** If you are about to reason out something that has plausibly been settled before (an architecture choice, a tool selection, a naming decision), check first. Re-derivation is how agents silently contradict prior work.
+- **Unfamiliar references.** When the user mentions a project, system, client, or entity you do not recognize from the current conversation, recall it before asking the user or guessing.
+- **After compaction.** When the conversation has been summarized or compacted, re-pull the sessions and facts relevant to the active task; the summary dropped detail you may need.
+
+Search prior sessions before answering whenever the user prompt references past work, prior decisions, or unresolved questions. The clearest triggers: "what did we decide about X", "where did we land on X", "what's still open on X", "have we tried X". Implicit references ("that auth approach", "the thing we built for the client last month") are the dangerous case and the most costly to miss.
+
+Do not recall when the request is purely forward-looking with no plausible prior context: drafting wholly new content, brainstorming greenfield ideas, naming something new.
+
+## The pointer block
+
+At session start, NLM's hooks inject a block listing possibly-relevant sessions with their ids and labels. Read this block first. It arrives once per session: NLM does not inject memory on every prompt, so mid-conversation recall is your job via the MCP tools. When a session looks relevant, call `get_session` to fetch its full transcript before drawing on it.
+
+## MCP tools
+
+`recall_sessions(query)` searches session labels, decisions, entities, and summaries. Call this first when the user references prior work.
+
+`get_session(id)` fetches one session's full transcript by its id. Call this after `recall_sessions` when a result looks relevant and you need the exact wording or full reasoning.
+
+`recall_facts(query, subject?, predicate?)` looks up a specific structured fact: endpoint, model, port, framework choice, owner, deadline. Prefer this over `recall_sessions` when the user wants the direct answer, not the surrounding conversation.
+
+`cite_session(id)` records that a surfaced session changed your response. See Citation below.
+
+## Citation
+
+Call `cite_session(id)` after writing your response, once per session you actually drew from. A session counts as used if it changed the answer or you read its full transcript via `get_session`. Do not cite sessions you scanned and found irrelevant. Citations feed the recall precision metric, which measures whether the sessions NLM surfaces are actually useful.
+
+## Trust boundaries
+
+Recall results are hints, not sources of truth. Verify any path, file location, hostname, port, or identifier surfaced by recall against your project's canonical configuration before acting on it. A recalled value that conflicts with the project config is stale; the config wins.

package/dist/core/embedding/embed-normalize.d.ts

@@ -1,28 +0,0 @@
-/**
- * embed-normalize — one-shot migration: L2-normalize every row in
- * session_embeddings. Ports `embed_normalize.py`.
- *
- * vec0 with implicit L2 distance ranks correctly by cosine similarity
- * only when stored vectors are unit-length. New writes (post-this-fix)
- * are normalized at source by OllamaClient.embed; this module brings
- * existing rows to the same invariant.
- *
- * Idempotent: re-running on already-normalized vectors is a no-op
- * within float tolerance (EPS = 1e-3). Each row is rewritten in its
- * own transaction so interrupts are safe.
- */
-export interface NormalizeOptions {
-    readonly dbPath: string;
-    readonly dim?: number;
-    readonly batchSize?: number;
-    readonly dryRun?: boolean;
-}
-export interface NormalizeReport {
-    readonly total: number;
-    readonly alreadyNormalized: number;
-    readonly rewritten: number;
-    readonly zeroVector: number;
-    readonly dbMissing: boolean;
-    readonly dryRun: boolean;
-}
-export declare function normalizeEmbeddings(opts: NormalizeOptions): NormalizeReport;

package/dist/core/embedding/embed-normalize.js

@@ -1,98 +0,0 @@
-/**
- * embed-normalize — one-shot migration: L2-normalize every row in
- * session_embeddings. Ports `embed_normalize.py`.
- *
- * vec0 with implicit L2 distance ranks correctly by cosine similarity
- * only when stored vectors are unit-length. New writes (post-this-fix)
- * are normalized at source by OllamaClient.embed; this module brings
- * existing rows to the same invariant.
- *
- * Idempotent: re-running on already-normalized vectors is a no-op
- * within float tolerance (EPS = 1e-3). Each row is rewritten in its
- * own transaction so interrupts are safe.
- */
-import { existsSync } from "node:fs";
-import Database from "better-sqlite3";
-import * as sqliteVec from "sqlite-vec";
-const EPS = 1e-3;
-const DEFAULT_DIM = 768;
-const DEFAULT_BATCH = 100;
-function bytesToFloats(buf, dim) {
-    if (buf.byteLength !== dim * 4) {
-        throw new Error(`expected ${dim * 4} bytes, got ${buf.byteLength}`);
-    }
-    return new Float32Array(buf.buffer, buf.byteOffset, dim);
-}
-function floatsToBytes(vec) {
-    return Buffer.from(vec.buffer, vec.byteOffset, vec.byteLength);
-}
-export function normalizeEmbeddings(opts) {
-    const dim = opts.dim ?? DEFAULT_DIM;
-    const batchSize = opts.batchSize ?? DEFAULT_BATCH;
-    const dryRun = opts.dryRun ?? false;
-    if (!existsSync(opts.dbPath)) {
-        return { total: 0, alreadyNormalized: 0, rewritten: 0, zeroVector: 0, dbMissing: true, dryRun };
-    }
-    const db = new Database(opts.dbPath);
-    sqliteVec.load(db);
-    let total = 0;
-    let alreadyNormalized = 0;
-    let rewritten = 0;
-    let zeroVector = 0;
-    try {
-        const ids = db
-            .prepare("SELECT session_id FROM session_embeddings")
-            .all()
-            .map((r) => r.session_id);
-        total = ids.length;
-        const sel = db.prepare("SELECT session_id, embedding FROM session_embeddings WHERE session_id = ?");
-        const del = db.prepare("DELETE FROM session_embeddings WHERE session_id = ?");
-        const ins = db.prepare("INSERT INTO session_embeddings (session_id, embedding) VALUES (?, ?)");
-        for (let start = 0; start < total; start += batchSize) {
-            const batch = ids.slice(start, start + batchSize);
-            for (const sid of batch) {
-                const row = sel.get(sid);
-                if (!row)
-                    continue;
-                const vec = bytesToFloats(row.embedding, dim);
-                let sumSq = 0;
-                for (let i = 0; i < dim; i++) {
-                    const v = vec[i] ?? 0;
-                    sumSq += v * v;
-                }
-                if (sumSq === 0) {
-                    zeroVector += 1;
-                    continue;
-                }
-                const norm = Math.sqrt(sumSq);
-                if (Math.abs(norm - 1) <= EPS) {
-                    alreadyNormalized += 1;
-                    continue;
-                }
-                if (dryRun) {
-                    rewritten += 1;
-                    continue;
-                }
-                const normalized = new Float32Array(dim);
-                for (let i = 0; i < dim; i++) {
-                    normalized[i] = (vec[i] ?? 0) / norm;
-                }
-                del.run(sid);
-                ins.run(sid, floatsToBytes(normalized));
-                rewritten += 1;
-            }
-        }
-    }
-    finally {
-        db.close();
-    }
-    return {
-        total,
-        alreadyNormalized,
-        rewritten,
-        zeroVector,
-        dbMissing: false,
-        dryRun,
-    };
-}
-//# sourceMappingURL=embed-normalize.js.map

package/dist/core/embedding/embed-normalize.js.map

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

package/dist/core/storage/pg-tx-context.d.ts

@@ -1,52 +0,0 @@
-/**
- * PgTxContext — write-queue for PgStorage.withTransaction.
- *
- * PgStorage.withTransaction requires a sync callback (port contract). PG
- * transactions are async. Bridge: sync callback queues SQL ops; PgStorage
- * flushes the queue in one BEGIN/COMMIT after the callback returns.
- *
- * Read methods throw — they cannot see uncommitted queue state. The
- * FactStore/SessionStore contracts never read inside withTransaction.
- */
-import type { FactListFilter, FactQuery, FactSemanticNeighbor, FactStore } from "../../ports/fact-store.js";
-import type { KeywordNeighbor, SemanticNeighbor, SessionFilter, SessionStore } from "../../ports/session-store.js";
-import type { Fact, FactHistoryChain, Session, SessionStatus } from "../../shared/types.js";
-export interface QueuedOp {
-    readonly sql: string;
-    readonly params: readonly unknown[];
-}
-export declare class PgTxBoundFactStore implements FactStore {
-    private readonly q;
-    constructor(q: QueuedOp[]);
-    insert(fact: Fact): Promise<void>;
-    insertMany(facts: ReadonlyArray<Fact>): Promise<void>;
-    markSuperseded(oldId: string, newId: string | null): Promise<void>;
-    retire(factId: string): Promise<void>;
-    ingestSessionFacts(sessionId: string, facts: ReadonlyArray<Fact>): Promise<void>;
-    upsertEmbedding(factId: string, vector: Float32Array): Promise<void>;
-    getById(_id: string): Promise<Fact | null>;
-    getByIds(_ids: ReadonlyArray<string>): Promise<ReadonlyArray<Fact>>;
-    findCurrent(_s: string, _p: string): Promise<Fact | null>;
-    list(_q: FactQuery): Promise<ReadonlyArray<Fact>>;
-    listBySession(_id: string): Promise<ReadonlyArray<Fact>>;
-    listForRecall(_f: FactListFilter): Promise<ReadonlyArray<Fact>>;
-    semanticSearch(_v: Float32Array, _n: number): Promise<ReadonlyArray<FactSemanticNeighbor>>;
-    getHistory(_s: string, _p?: string): Promise<ReadonlyArray<FactHistoryChain>>;
-    corroborationCounts(_t: ReadonlyArray<{
-        subject: string;
-        predicate: string;
-        value: string;
-    }>): Promise<Map<string, number>>;
-}
-export declare class PgTxBoundSessionStore implements SessionStore {
-    private readonly q;
-    constructor(q: QueuedOp[]);
-    updateStatus(sessionId: string, status: SessionStatus): Promise<void>;
-    markSuperseded(predecessorId: string, successorId: string): Promise<void>;
-    list(_filter?: SessionFilter): Promise<ReadonlyArray<Session>>;
-    getById(_id: string): Promise<Session | null>;
-    getByIds(_ids: ReadonlyArray<string>): Promise<ReadonlyArray<Session>>;
-    semanticSearch(_v: Float32Array, _n: number): Promise<ReadonlyArray<SemanticNeighbor>>;
-    keywordSearch(_q: string, _n: number): Promise<ReadonlyArray<KeywordNeighbor>>;
-    resolveSuccessors(_ids: ReadonlyArray<string>): Promise<Map<string, string>>;
-}

package/dist/core/storage/pg-tx-context.js

@@ -1,149 +0,0 @@
-/**
- * PgTxContext — write-queue for PgStorage.withTransaction.
- *
- * PgStorage.withTransaction requires a sync callback (port contract). PG
- * transactions are async. Bridge: sync callback queues SQL ops; PgStorage
- * flushes the queue in one BEGIN/COMMIT after the callback returns.
- *
- * Read methods throw — they cannot see uncommitted queue state. The
- * FactStore/SessionStore contracts never read inside withTransaction.
- */
-function noRead(method) {
-    throw new Error(`PgStorage.withTransaction: ${method} read not supported inside sync callback`);
-}
-export class PgTxBoundFactStore {
-    q;
-    constructor(q) {
-        this.q = q;
-    }
-    insert(fact) {
-        this.q.push(insertFactOp(fact));
-        return Promise.resolve();
-    }
-    insertMany(facts) {
-        for (const f of facts)
-            this.q.push(insertFactOp(f));
-        return Promise.resolve();
-    }
-    markSuperseded(oldId, newId) {
-        this.q.push({
-            sql: "UPDATE facts SET superseded_by = $1 WHERE id = $2",
-            params: [newId, oldId],
-        });
-        return Promise.resolve();
-    }
-    retire(factId) {
-        this.q.push({
-            sql: "UPDATE facts SET retired_at = $1 WHERE id = $2",
-            params: [new Date().toISOString(), factId],
-        });
-        this.q.push({
-            sql: "DELETE FROM fact_embeddings WHERE fact_id = $1",
-            params: [factId],
-        });
-        return Promise.resolve();
-    }
-    ingestSessionFacts(sessionId, facts) {
-        this.q.push({
-            sql: "DELETE FROM facts WHERE source_session_id = $1",
-            params: [sessionId],
-        });
-        for (const f of facts)
-            this.q.push(insertFactOp(f));
-        if (facts.length > 0) {
-            const values = facts
-                .map((_, i) => `($${i * 3 + 1}, $${i * 3 + 2}, $${i * 3 + 3})`)
-                .join(", ");
-            const params = [];
-            for (const f of facts)
-                params.push(f.subject, f.predicate, f.id);
-            this.q.push({
-                sql: `
-          UPDATE facts AS old
-          SET superseded_by = new_f.new_id
-          FROM (VALUES ${values}) AS new_f(subject, predicate, new_id)
-          WHERE old.subject = new_f.subject
-            AND old.predicate = new_f.predicate
-            AND old.superseded_by IS NULL
-            AND old.id != new_f.new_id
-        `,
-                params,
-            });
-        }
-        return Promise.resolve();
-    }
-    upsertEmbedding(factId, vector) {
-        this.q.push({
-            sql: `
-        INSERT INTO fact_embeddings (fact_id, embedding)
-        VALUES ($1, $2)
-        ON CONFLICT (fact_id) DO UPDATE SET embedding = EXCLUDED.embedding
-      `,
-            params: [factId, `[${Array.from(vector).join(",")}]`],
-        });
-        return Promise.resolve();
-    }
-    getById(_id) { return noRead("FactStore.getById"); }
-    getByIds(_ids) { return noRead("FactStore.getByIds"); }
-    findCurrent(_s, _p) { return noRead("FactStore.findCurrent"); }
-    list(_q) { return noRead("FactStore.list"); }
-    listBySession(_id) { return noRead("FactStore.listBySession"); }
-    listForRecall(_f) { return noRead("FactStore.listForRecall"); }
-    semanticSearch(_v, _n) { return noRead("FactStore.semanticSearch"); }
-    getHistory(_s, _p) { return noRead("FactStore.getHistory"); }
-    corroborationCounts(_t) {
-        return noRead("FactStore.corroborationCounts");
-    }
-}
-export class PgTxBoundSessionStore {
-    q;
-    constructor(q) {
-        this.q = q;
-    }
-    updateStatus(sessionId, status) {
-        if (status === "idle") {
-            throw new Error("Cannot persist derived status 'idle'");
-        }
-        this.q.push({
-            sql: "UPDATE sessions SET status = $1, updated_at = NOW() WHERE id = $2",
-            params: [status, sessionId],
-        });
-        return Promise.resolve();
-    }
-    markSuperseded(predecessorId, successorId) {
-        this.q.push({
-            sql: `
-        INSERT INTO session_edges (from_session, to_session, kind)
-        VALUES ($1, $2, 'supersedes')
-        ON CONFLICT DO NOTHING
-      `,
-            params: [successorId, predecessorId],
-        });
-        this.q.push({
-            sql: "UPDATE sessions SET status = 'superseded', updated_at = NOW() WHERE id = $1",
-            params: [predecessorId],
-        });
-        return Promise.resolve();
-    }
-    list(_filter) { return noRead("SessionStore.list"); }
-    getById(_id) { return noRead("SessionStore.getById"); }
-    getByIds(_ids) { return noRead("SessionStore.getByIds"); }
-    semanticSearch(_v, _n) { return noRead("SessionStore.semanticSearch"); }
-    keywordSearch(_q, _n) { return noRead("SessionStore.keywordSearch"); }
-    resolveSuccessors(_ids) { return noRead("SessionStore.resolveSuccessors"); }
-}
-function insertFactOp(f) {
-    return {
-        sql: `
-      INSERT INTO facts (
-        id, kind, subject, predicate, value, source_session_id,
-        source_quote, created_at, superseded_by, confidence
-      ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
-    `,
-        params: [
-            f.id, f.kind, f.subject, f.predicate, f.value,
-            f.sourceSessionId, f.sourceQuote, f.createdAt, f.supersededBy, f.confidence,
-        ],
-    };
-}
-//# sourceMappingURL=pg-tx-context.js.map

package/dist/core/storage/pg-tx-context.js.map

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