nlm-memory 0.4.0

package/dist/hook/pre-compact-hook.js

@@ -0,0 +1,94 @@
+/**
+ * Claude Code PreCompact hook entrypoint for NLM.
+ *
+ * Fires before Claude Code compacts a long transcript. At compaction time the
+ * in-flight surfaced-IDs memo and any pending citation state would be lost.
+ * This hook POSTs a compaction event to the daemon so it can do a final
+ * synchronous citation scan of the transcript before the shape is lost.
+ *
+ * Daemon endpoint: POST localhost:3940/api/hook/pre-compact
+ * This endpoint does NOT exist yet in the daemon — the hook ships fail-soft
+ * (swallows errors) so it won't block compaction when the endpoint is absent.
+ * The daemon-side handler is a follow-up task.
+ *
+ * Payload: { conversation_id, transcript_path, surfaced_set, ts }
+ *
+ * Fail-open by design: any error yields a clean exit with no output.
+ */
+import { pathToFileURL } from "node:url";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { loadSurfaced } from "../core/hook/memo.js";
+const POST_TIMEOUT_MS = 1500;
+export async function runPreCompact(input, portValue = process.env["NLM_PORT"] ?? "3940") {
+    const surfacedSet = [...loadSurfaced(input.conversationId)];
+    const payload = {
+        conversation_id: input.conversationId,
+        transcript_path: input.transcriptPath,
+        surfaced_set: surfacedSet,
+        ts: new Date().toISOString(),
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), POST_TIMEOUT_MS);
+    try {
+        const res = await fetch(`http://localhost:${portValue}/api/hook/pre-compact`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        });
+        return { conversationId: input.conversationId, posted: res.ok };
+    }
+    catch {
+        // Endpoint absent or daemon down — fail soft, never block compaction.
+        return { conversationId: input.conversationId, posted: false };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function logPath() {
+    return process.env["NLM_HOOK_LOG"] ?? join(homedir(), ".nlm", "hook-log.jsonl");
+}
+function logResult(result) {
+    try {
+        const path = logPath();
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, `${JSON.stringify({
+            ts: new Date().toISOString(),
+            kind: "pre-compact",
+            conversationId: result.conversationId,
+            posted: result.posted,
+        })}\n`, "utf8");
+    }
+    catch {
+        // Telemetry failure must never break the hook.
+    }
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", () => resolve(data));
+    });
+}
+async function main() {
+    try {
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        const conversationId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+        const transcriptPath = typeof payload.transcript_path === "string" ? payload.transcript_path : "";
+        const result = await runPreCompact({ conversationId, transcriptPath });
+        logResult(result);
+    }
+    catch {
+        // Fail open — never block Claude Code compaction.
+    }
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    void main();
+}
+//# sourceMappingURL=pre-compact-hook.js.map

package/dist/hook/pre-compact-hook.js.map

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

package/dist/hook/prompt-recall-hook.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Claude Code UserPromptSubmit hook entrypoint for NLM recall.
+ *
+ * runHook is the testable orchestration; main() is the thin process wrapper
+ * (stdin / stdout / fetch / env). Every path is fail-open: any error yields
+ * no output and a clean exit, so the hook can never block or fail a prompt.
+ *
+ * Mode is read from NLM_HOOK_MODE (default "shadow"). In shadow mode the
+ * hook logs what it would inject and emits nothing; in live mode it emits a
+ * pointer block and records the per-conversation memo.
+ */
+import { type RecallHitInput } from "../core/hook/select.js";
+export type HookMode = "shadow" | "live";
+export interface HookInput {
+    readonly prompt: string;
+    readonly conversationId: string;
+}
+export interface RunHookDeps {
+    readonly mode: HookMode;
+    readonly recall: (prompt: string) => Promise<ReadonlyArray<RecallHitInput>>;
+}
+/** Orchestration. Returns the text to emit on stdout ("" for nothing). */
+export declare function runHook(input: HookInput, deps: RunHookDeps): Promise<string>;

package/dist/hook/prompt-recall-hook.js

@@ -0,0 +1,141 @@
+/**
+ * Claude Code UserPromptSubmit hook entrypoint for NLM recall.
+ *
+ * runHook is the testable orchestration; main() is the thin process wrapper
+ * (stdin / stdout / fetch / env). Every path is fail-open: any error yields
+ * no output and a clean exit, so the hook can never block or fail a prompt.
+ *
+ * Mode is read from NLM_HOOK_MODE (default "shadow"). In shadow mode the
+ * hook logs what it would inject and emits nothing; in live mode it emits a
+ * pointer block and records the per-conversation memo.
+ */
+import { pathToFileURL } from "node:url";
+import { classifyPrompt } from "../core/hook/gate.js";
+import { appendHookLog } from "../core/hook/hook-log.js";
+import { loadSurfaced, recordSurfaced } from "../core/hook/memo.js";
+import { formatPointerBlock } from "../core/hook/pointer-block.js";
+import { selectHits } from "../core/hook/select.js";
+// Keyword recall returns raw BM25 scores (unbounded, not the 0..1 hybrid
+// scale). FTS5 MATCH already gates relevance — only lexically-matching
+// sessions come back — so the floor starts at 0 and a real cutoff is
+// calibrated from the shadow log's score distribution.
+const SCORE_THRESHOLD = 0;
+const PER_FIRE_CAP = 3;
+const PER_CONVERSATION_CAP = 10;
+const RECALL_LIMIT = 5; // fetch more than PER_FIRE_CAP to absorb score-filter + dedup
+const RECALL_TIMEOUT_MS = 2000; // keyword recall is ~400ms warm, ~1.4s cold
+const PROMPT_PREVIEW_CHARS = 200;
+/** Orchestration. Returns the text to emit on stdout ("" for nothing). */
+export async function runHook(input, deps) {
+    const gate = classifyPrompt(input.prompt);
+    const preview = input.prompt.slice(0, PROMPT_PREVIEW_CHARS);
+    if (gate === "generative") {
+        appendHookLog({
+            ts: new Date().toISOString(),
+            conversationId: input.conversationId,
+            promptPreview: preview,
+            gate,
+            hits: [],
+            wouldInject: [],
+            estTokens: 0,
+            mode: deps.mode,
+        });
+        return "";
+    }
+    let hits = [];
+    try {
+        hits = await deps.recall(input.prompt);
+    }
+    catch {
+        hits = [];
+    }
+    const surfaced = loadSurfaced(input.conversationId);
+    const selected = selectHits({
+        hits,
+        surfaced,
+        scoreThreshold: SCORE_THRESHOLD,
+        perFireCap: PER_FIRE_CAP,
+        perConversationCap: PER_CONVERSATION_CAP,
+    });
+    const block = formatPointerBlock(selected);
+    const estTokens = Math.ceil(block.length / 4);
+    appendHookLog({
+        ts: new Date().toISOString(),
+        conversationId: input.conversationId,
+        promptPreview: preview,
+        gate,
+        hits: hits.map((h) => ({ id: h.id, score: h.matchScore })),
+        wouldInject: selected.map((h) => h.id),
+        estTokens,
+        mode: deps.mode,
+    });
+    if (deps.mode === "live" && selected.length > 0) {
+        recordSurfaced(input.conversationId, selected.map((h) => h.id));
+        return block;
+    }
+    return "";
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", () => resolve(data));
+    });
+}
+async function recallOverHttp(prompt) {
+    const portValue = process.env["NLM_PORT"] ?? "3940";
+    // keyword (FTS5) not hybrid: hybrid's Ollama embedding round-trip takes
+    // ~5s, far too slow for a hook that blocks prompt submission.
+    const url = `http://localhost:${portValue}/api/recall` +
+        `?q=${encodeURIComponent(prompt)}&mode=keyword&limit=${RECALL_LIMIT}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), RECALL_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, {
+            headers: { "x-recall-source": "hook" },
+            signal: controller.signal,
+        });
+        if (!res.ok)
+            return [];
+        let body;
+        try {
+            body = (await res.json());
+        }
+        catch {
+            return [];
+        }
+        return (body.results ?? []).map((r) => ({
+            id: r.id,
+            label: r.label,
+            startedAt: r.startedAt,
+            matchScore: r.matchScore,
+        }));
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function main() {
+    try {
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        const prompt = typeof payload.prompt === "string" ? payload.prompt : "";
+        const conversationId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+        if (!prompt)
+            return;
+        const mode = process.env["NLM_HOOK_MODE"] === "live" ? "live" : "shadow";
+        const out = await runHook({ prompt, conversationId }, { mode, recall: recallOverHttp });
+        if (out)
+            process.stdout.write(out);
+    }
+    catch {
+        // Fail open — never block or fail a prompt.
+    }
+}
+// Run main() only when invoked directly as a script, not when imported by tests.
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    void main();
+}
+//# sourceMappingURL=prompt-recall-hook.js.map

package/dist/hook/prompt-recall-hook.js.map

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

package/dist/hook/session-end-hook.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Claude Code SessionEnd hook entrypoint for NLM.
+ *
+ * Fires when a Claude Code session closes. Deletes the per-conversation
+ * memo file written during the session so memo files don't accumulate
+ * indefinitely under ~/.nlm/hook-state/.
+ *
+ * Logs one JSON line per invocation to ~/.nlm/hook-log.jsonl with
+ * `kind: "session-end"` so the daily-digest liveness check can correlate
+ * Claude Code session closes against hook fires the same way it does for
+ * UserPromptSubmit. Fail-open by design: any error yields a clean exit
+ * with no output, so the hook can never block Claude Code shutdown.
+ */
+export interface SessionEndResult {
+    readonly conversationId: string;
+    readonly cleared: boolean;
+}
+export declare function runSessionEnd(conversationId: string): SessionEndResult;

package/dist/hook/session-end-hook.js

@@ -0,0 +1,67 @@
+/**
+ * Claude Code SessionEnd hook entrypoint for NLM.
+ *
+ * Fires when a Claude Code session closes. Deletes the per-conversation
+ * memo file written during the session so memo files don't accumulate
+ * indefinitely under ~/.nlm/hook-state/.
+ *
+ * Logs one JSON line per invocation to ~/.nlm/hook-log.jsonl with
+ * `kind: "session-end"` so the daily-digest liveness check can correlate
+ * Claude Code session closes against hook fires the same way it does for
+ * UserPromptSubmit. Fail-open by design: any error yields a clean exit
+ * with no output, so the hook can never block Claude Code shutdown.
+ */
+import { pathToFileURL } from "node:url";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { clearSurfaced } from "../core/hook/memo.js";
+import { clearCited } from "../core/hook/cite-memo.js";
+export function runSessionEnd(conversationId) {
+    const surfacedCleared = clearSurfaced(conversationId);
+    const citedCleared = clearCited(conversationId);
+    return { conversationId, cleared: surfacedCleared || citedCleared };
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", () => resolve(data));
+    });
+}
+function logPath() {
+    return process.env["NLM_HOOK_LOG"] ?? join(homedir(), ".nlm", "hook-log.jsonl");
+}
+function logSessionEnd(result) {
+    try {
+        const path = logPath();
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, `${JSON.stringify({
+            ts: new Date().toISOString(),
+            kind: "session-end",
+            conversationId: result.conversationId,
+            cleared: result.cleared,
+            mode: process.env["NLM_HOOK_MODE"] === "live" ? "live" : "shadow",
+        })}\n`, "utf8");
+    }
+    catch {
+        // Telemetry failure must never break the hook.
+    }
+}
+async function main() {
+    try {
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        const conversationId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+        logSessionEnd(runSessionEnd(conversationId));
+    }
+    catch {
+        // Fail open — never block Claude Code shutdown.
+    }
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    void main();
+}
+//# sourceMappingURL=session-end-hook.js.map

package/dist/hook/session-end-hook.js.map

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

package/dist/hook/session-start-hook.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Claude Code SessionStart hook entrypoint for NLM recall.
+ *
+ * Fires before any prompt in a new session (including cron-fired and background
+ * agents that never trigger UserPromptSubmit). Surfaces relevant prior context
+ * proactively so cold-start agents aren't recall-blind.
+ *
+ * Query is derived from working_directory + project_name since no user prompt
+ * exists yet — intentionally weaker than prompt-recall, best-effort only.
+ *
+ * Mirrors prompt-recall-hook.ts shape exactly: same pointer-block format, same
+ * memo writes, same NLM_HOOK_MODE semantics.
+ */
+import { type RecallHitInput } from "../core/hook/select.js";
+export type HookMode = "shadow" | "live";
+export interface SessionStartInput {
+    readonly conversationId: string;
+    readonly query: string;
+}
+export interface RunSessionStartDeps {
+    readonly mode: HookMode;
+    readonly recall: (query: string) => Promise<ReadonlyArray<RecallHitInput>>;
+}
+/** Orchestration. Returns the text to emit on stdout ("" for nothing). */
+export declare function runHook(input: SessionStartInput, deps: RunSessionStartDeps): Promise<string>;

package/dist/hook/session-start-hook.js

@@ -0,0 +1,129 @@
+/**
+ * Claude Code SessionStart hook entrypoint for NLM recall.
+ *
+ * Fires before any prompt in a new session (including cron-fired and background
+ * agents that never trigger UserPromptSubmit). Surfaces relevant prior context
+ * proactively so cold-start agents aren't recall-blind.
+ *
+ * Query is derived from working_directory + project_name since no user prompt
+ * exists yet — intentionally weaker than prompt-recall, best-effort only.
+ *
+ * Mirrors prompt-recall-hook.ts shape exactly: same pointer-block format, same
+ * memo writes, same NLM_HOOK_MODE semantics.
+ */
+import { pathToFileURL } from "node:url";
+import { appendHookLog } from "../core/hook/hook-log.js";
+import { loadSurfaced, recordSurfaced } from "../core/hook/memo.js";
+import { formatPointerBlock } from "../core/hook/pointer-block.js";
+import { selectHits } from "../core/hook/select.js";
+const SCORE_THRESHOLD = 0;
+const PER_FIRE_CAP = 3;
+const PER_CONVERSATION_CAP = 10;
+const RECALL_LIMIT = 5;
+const RECALL_TIMEOUT_MS = 2000;
+/** Orchestration. Returns the text to emit on stdout ("" for nothing). */
+export async function runHook(input, deps) {
+    let hits = [];
+    try {
+        hits = await deps.recall(input.query);
+    }
+    catch {
+        hits = [];
+    }
+    const surfaced = loadSurfaced(input.conversationId);
+    const selected = selectHits({
+        hits,
+        surfaced,
+        scoreThreshold: SCORE_THRESHOLD,
+        perFireCap: PER_FIRE_CAP,
+        perConversationCap: PER_CONVERSATION_CAP,
+    });
+    const block = formatPointerBlock(selected);
+    const estTokens = Math.ceil(block.length / 4);
+    appendHookLog({
+        ts: new Date().toISOString(),
+        conversationId: input.conversationId,
+        promptPreview: input.query,
+        gate: "evaluate",
+        hits: hits.map((h) => ({ id: h.id, score: h.matchScore })),
+        wouldInject: selected.map((h) => h.id),
+        estTokens,
+        mode: deps.mode,
+    });
+    if (deps.mode === "live" && selected.length > 0) {
+        recordSurfaced(input.conversationId, selected.map((h) => h.id));
+        return block;
+    }
+    return "";
+}
+/** Derive a best-effort query from SessionStart payload fields. */
+function buildQuery(workingDirectory, projectName) {
+    const dirTail = workingDirectory.split("/").filter(Boolean).at(-1) ?? "";
+    const parts = [dirTail, projectName].filter(Boolean);
+    return parts.join(" ").trim() || "session start";
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", () => resolve(data));
+    });
+}
+async function recallOverHttp(query) {
+    const portValue = process.env["NLM_PORT"] ?? "3940";
+    const url = `http://localhost:${portValue}/api/recall` +
+        `?q=${encodeURIComponent(query)}&mode=hybrid&limit=${RECALL_LIMIT}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), RECALL_TIMEOUT_MS);
+    try {
+        const res = await fetch(url, {
+            headers: { "x-recall-source": "session-start-hook" },
+            signal: controller.signal,
+        });
+        if (!res.ok)
+            return [];
+        let body;
+        try {
+            body = (await res.json());
+        }
+        catch {
+            return [];
+        }
+        return (body.results ?? []).map((r) => ({
+            id: r.id,
+            label: r.label,
+            startedAt: r.startedAt,
+            matchScore: r.matchScore,
+        }));
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function main() {
+    try {
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        const conversationId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+        const workingDirectory = typeof payload.cwd === "string"
+            ? payload.cwd
+            : typeof payload.working_directory === "string"
+                ? payload.working_directory
+                : "";
+        const projectName = typeof payload.project_name === "string" ? payload.project_name : "";
+        const query = buildQuery(workingDirectory, projectName);
+        const mode = process.env["NLM_HOOK_MODE"] === "live" ? "live" : "shadow";
+        const out = await runHook({ conversationId, query }, { mode, recall: recallOverHttp });
+        if (out)
+            process.stdout.write(out);
+    }
+    catch {
+        // Fail open — never block or fail a session start.
+    }
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    void main();
+}
+//# sourceMappingURL=session-start-hook.js.map

package/dist/hook/session-start-hook.js.map

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

package/dist/hook/stop-hook.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Claude Code Stop hook entrypoint for NLM.
+ *
+ * Fires after the model finishes a response. Scans the last assistant message
+ * in the transcript for substrings matching any session ID the recall hook
+ * surfaced this conversation (via the dedup memo). Each match becomes a
+ * citation event posted to the daemon at POST /api/recall/cite-event.
+ *
+ * Double duty:
+ *  - Per-recall useful_hit_rate metric (was the returned ID actually used?)
+ *  - Training-data substrate for a learned reranker (was_cited per query)
+ *
+ * Fail-open by design: any error yields a clean exit with no output. The
+ * Stop hook can never block Claude Code's response. The smoke test path
+ * succeeds even with missing transcript_path because the hook always logs
+ * a `kind:"stop"` line.
+ */
+import { type CitationKind } from "../core/hook/citation-detect.js";
+export interface StopHookInput {
+    readonly conversationId: string;
+    readonly transcriptPath: string;
+    readonly stopHookActive: boolean;
+}
+export interface CitationEvent {
+    readonly id: string;
+    readonly kind: CitationKind;
+}
+export interface StopHookResult {
+    readonly conversationId: string;
+    readonly surfacedCount: number;
+    readonly citations: ReadonlyArray<CitationEvent>;
+    readonly responsePreview: string;
+    readonly skipped: boolean;
+}
+export interface RunStopHookDeps {
+    readonly postCitation: (conversationId: string, citedId: string, kind: CitationKind, responsePreview: string) => Promise<void>;
+}
+export declare function runStopHook(input: StopHookInput, deps: RunStopHookDeps): Promise<StopHookResult>;