nlm-memory 0.20.0 → 0.21.0

package/dist/core/workstream/merge-suggest.js

@@ -0,0 +1,61 @@
+import { normalizeLabel } from "./model.js";
+function jaccard(a, b) {
+    const sa = new Set(a);
+    const sb = new Set(b);
+    let shared = 0;
+    for (const x of sa)
+        if (sb.has(x))
+            shared++;
+    const union = sa.size + sb.size - shared;
+    return { shared, score: union === 0 ? 0 : shared / union };
+}
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    let prev = Array.from({ length: n + 1 }, (_, i) => i);
+    let cur = new Array(n + 1);
+    for (let i = 1; i <= m; i++) {
+        cur[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + cost);
+        }
+        [prev, cur] = [cur, prev];
+    }
+    return prev[n];
+}
+function labelSimilarity(a, b) {
+    const na = normalizeLabel(a);
+    const nb = normalizeLabel(b);
+    const maxLen = Math.max(na.length, nb.length);
+    if (maxLen === 0)
+        return 1;
+    return 1 - levenshtein(na, nb) / maxLen;
+}
+export function scoreMergePair(a, b) {
+    const ent = jaccard(a.entities, b.entities);
+    const sess = jaccard(a.sessionIds, b.sessionIds);
+    const lab = labelSimilarity(a.label, b.label);
+    const score = (ent.score + sess.score + lab) / 3;
+    return {
+        aId: a.id, aLabel: a.label, bId: b.id, bLabel: b.label,
+        score, sharedEntities: ent.shared, sharedSessions: sess.shared, labelSimilarity: lab,
+    };
+}
+/** All unordered pairs scoring >= minScore, ranked desc. Pure; O(n^2) over the (small) workstream set. */
+export function suggestMerges(items, minScore) {
+    const out = [];
+    for (let i = 0; i < items.length; i++) {
+        for (let j = i + 1; j < items.length; j++) {
+            const s = scoreMergePair(items[i], items[j]);
+            if (s.score >= minScore)
+                out.push(s);
+        }
+    }
+    return out.sort((x, y) => y.score - x.score);
+}
+//# sourceMappingURL=merge-suggest.js.map

package/dist/core/workstream/merge-suggest.js.map

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

package/dist/core/workstream/model.d.ts

@@ -0,0 +1,21 @@
+import type { Fact, CodeExemplar } from "../../shared/types.js";
+export type WorkstreamStatus = "active" | "merged" | "retired";
+export interface Workstream {
+    readonly id: string;
+    readonly label: string;
+    readonly status: WorkstreamStatus;
+    readonly mergedInto: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly lastSessionAt: string | null;
+    readonly scope: string | null;
+}
+export type BindingSource = "classifier" | "operator" | "backfill";
+export interface WorkstreamRollup {
+    readonly workstream: Workstream;
+    readonly sessionIds: ReadonlyArray<string>;
+    readonly facts: ReadonlyArray<Fact>;
+    readonly exemplars: ReadonlyArray<CodeExemplar>;
+}
+export declare function makeWorkstreamId(): string;
+export declare function normalizeLabel(label: string): string;

package/dist/core/workstream/model.js

@@ -0,0 +1,9 @@
+// src/core/workstream/model.ts
+import { randomUUID } from "node:crypto";
+export function makeWorkstreamId() {
+    return `ws_${randomUUID()}`;
+}
+export function normalizeLabel(label) {
+    return label.trim().toLowerCase().replace(/\s+/g, " ");
+}
+//# sourceMappingURL=model.js.map

package/dist/core/workstream/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/core/workstream/model.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyBzC,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,UAAU,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/workstream/name-match.d.ts

@@ -0,0 +1,8 @@
+import { type Workstream } from "./model.js";
+export type NameDecision = {
+    kind: "bind";
+    workstreamId: string;
+} | {
+    kind: "abstain";
+};
+export declare function decideWorkstreamByName(named: string | null, workstreams: ReadonlyArray<Pick<Workstream, "id" | "label">>, aliasToLabel: ReadonlyMap<string, string>): NameDecision;

package/dist/core/workstream/name-match.js

@@ -0,0 +1,18 @@
+// src/core/workstream/name-match.ts
+import { normalizeLabel } from "./model.js";
+export function decideWorkstreamByName(named, workstreams, aliasToLabel) {
+    if (!named || !named.trim())
+        return { kind: "abstain" };
+    const byLabel = new Map(workstreams.map((w) => [normalizeLabel(w.label), w.id]));
+    const direct = byLabel.get(normalizeLabel(named));
+    if (direct)
+        return { kind: "bind", workstreamId: direct };
+    const canonical = aliasToLabel.get(normalizeLabel(named));
+    if (canonical) {
+        const viaAlias = byLabel.get(normalizeLabel(canonical));
+        if (viaAlias)
+            return { kind: "bind", workstreamId: viaAlias };
+    }
+    return { kind: "abstain" };
+}
+//# sourceMappingURL=name-match.js.map

package/dist/core/workstream/name-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-match.js","sourceRoot":"","sources":["../../../src/core/workstream/name-match.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,cAAc,EAAmB,MAAM,YAAY,CAAC;AAI7D,MAAM,UAAU,sBAAsB,CACpC,KAAoB,EACpB,WAA4D,EAC5D,YAAyC;IAEzC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;QACxD,IAAI,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/core/workstream/resolve.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Walk the merged_into chain to the live survivor. Mirrors the replaces-chain
+ * resolution in ui/lib/thread-groups.ts. Iterative + visited-set guarded so a
+ * (data-corrupt) cycle terminates instead of looping. Fail-open: an id absent
+ * from the map resolves to itself.
+ */
+export declare function resolveWorkstreamId(id: string, byId: ReadonlyMap<string, {
+    id: string;
+    mergedInto: string | null;
+}>): string;

package/dist/core/workstream/resolve.js

@@ -0,0 +1,21 @@
+// src/core/workstream/resolve.ts
+/**
+ * Walk the merged_into chain to the live survivor. Mirrors the replaces-chain
+ * resolution in ui/lib/thread-groups.ts. Iterative + visited-set guarded so a
+ * (data-corrupt) cycle terminates instead of looping. Fail-open: an id absent
+ * from the map resolves to itself.
+ */
+export function resolveWorkstreamId(id, byId) {
+    const seen = new Set();
+    let cur = id;
+    while (true) {
+        if (seen.has(cur))
+            return cur;
+        seen.add(cur);
+        const node = byId.get(cur);
+        if (!node || node.mergedInto === null)
+            return cur;
+        cur = node.mergedInto;
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/workstream/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/core/workstream/resolve.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,EAAU,EACV,IAAoE;IAEpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC;QAClD,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/core/workstream/rollup.d.ts

@@ -0,0 +1,12 @@
+import type { WorkstreamStore } from "../../ports/workstream-store.js";
+import type { SessionStore } from "../../ports/session-store.js";
+import type { FactStore } from "../../ports/fact-store.js";
+import type { CodeExemplarStore } from "../../ports/code-exemplar-store.js";
+import type { WorkstreamRollup } from "./model.js";
+export interface RollupDeps {
+    readonly workstreams: Pick<WorkstreamStore, "listAll" | "getById">;
+    readonly sessions: Pick<SessionStore, "listSessionIdsByWorkstreams">;
+    readonly facts: Pick<FactStore, "listBySessions">;
+    readonly exemplars: Pick<CodeExemplarStore, "listBySessions">;
+}
+export declare function rollupWorkstream(deps: RollupDeps, workstreamId: string): Promise<WorkstreamRollup | null>;

package/dist/core/workstream/rollup.js

@@ -0,0 +1,17 @@
+import { resolveWorkstreamId } from "./resolve.js";
+export async function rollupWorkstream(deps, workstreamId) {
+    const all = await deps.workstreams.listAll();
+    const byId = new Map(all.map((w) => [w.id, { id: w.id, mergedInto: w.mergedInto }]));
+    const survivorId = resolveWorkstreamId(workstreamId, byId);
+    const workstream = await deps.workstreams.getById(survivorId);
+    if (!workstream)
+        return null;
+    const memberIds = all.filter((w) => resolveWorkstreamId(w.id, byId) === survivorId).map((w) => w.id);
+    const sessionIds = await deps.sessions.listSessionIdsByWorkstreams(memberIds);
+    const [facts, exemplars] = await Promise.all([
+        deps.facts.listBySessions(sessionIds),
+        deps.exemplars.listBySessions(sessionIds),
+    ]);
+    return { workstream, sessionIds, facts, exemplars };
+}
+//# sourceMappingURL=rollup.js.map

package/dist/core/workstream/rollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.js","sourceRoot":"","sources":["../../../src/core/workstream/rollup.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AASnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAgB,EAAE,YAAoB;IAC3E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAC9E,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACtD,CAAC"}

package/dist/core/workstream/work-topics.d.ts

@@ -0,0 +1,10 @@
+export interface WorkTopic {
+    readonly label: string;
+    readonly entities: ReadonlyArray<string>;
+}
+export declare function parseWorkTopics(raw: unknown): ReadonlyArray<WorkTopic>;
+/**
+ * Build a map from normalized alias -> canonical label for all topics.
+ * Used by the binding path to resolve classifier output through aliases.
+ */
+export declare function aliasToLabelMap(topics: ReadonlyArray<WorkTopic>): Map<string, string>;

package/dist/core/workstream/work-topics.js

@@ -0,0 +1,55 @@
+// src/core/workstream/work-topics.ts
+import { normalizeLabel } from "./model.js";
+export function parseWorkTopics(raw) {
+    if (Array.isArray(raw)) {
+        return raw.map((t) => {
+            if (!t ||
+                typeof t !== "object" ||
+                typeof t.label !== "string" ||
+                !Array.isArray(t.entities)) {
+                throw new Error(`work-topics: array item is not {label, entities[]}: ${JSON.stringify(t)}`);
+            }
+            return {
+                label: t.label,
+                entities: (t.entities).map(String),
+            };
+        });
+    }
+    if (raw && typeof raw === "object") {
+        const entries = Object.entries(raw);
+        // Alias-map shape { "<alias>": "<canonical>" }: group aliases under their
+        // canonical label. Canonical = workstream label; aliases (+ the canonical itself)
+        // = its entities.
+        if (entries.length > 0 && entries.every(([, v]) => typeof v === "string")) {
+            const byCanonical = new Map();
+            for (const [alias, canonical] of entries) {
+                const set = byCanonical.get(canonical) ?? new Set([canonical]);
+                set.add(alias);
+                byCanonical.set(canonical, set);
+            }
+            return [...byCanonical].map(([label, entities]) => ({ label, entities: [...entities] }));
+        }
+        // Label-to-entities map { "<label>": ["<entity>", ...] }.
+        return entries.map(([label, ents]) => {
+            if (!Array.isArray(ents)) {
+                throw new Error(`work-topics: value for "${label}" is neither a string (alias map) nor an array (entity map)`);
+            }
+            return { label, entities: ents.map(String) };
+        });
+    }
+    throw new Error("work-topics: expected an object map or an array of {label, entities[]}");
+}
+/**
+ * Build a map from normalized alias -> canonical label for all topics.
+ * Used by the binding path to resolve classifier output through aliases.
+ */
+export function aliasToLabelMap(topics) {
+    const out = new Map();
+    for (const topic of topics) {
+        for (const entity of topic.entities) {
+            out.set(normalizeLabel(entity), topic.label);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=work-topics.js.map

package/dist/core/workstream/work-topics.js.map

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

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

@@ -0,0 +1,4 @@
+export declare function readStdin(): Promise<string>;
+export declare function fetchWithTimeout(url: string, init: RequestInit, ms: number): Promise<Response>;
+export declare function hookModeFromEnv(): "shadow" | "live";
+export declare function appendHookEvent(data: Record<string, unknown>): void;

package/dist/hook/hook-helpers.js

@@ -0,0 +1,36 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export 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));
+    });
+}
+export async function fetchWithTimeout(url, init, ms) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), ms);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function hookModeFromEnv() {
+    return process.env["NLM_HOOK_MODE"] === "live" ? "live" : "shadow";
+}
+export function appendHookEvent(data) {
+    try {
+        const path = process.env["NLM_HOOK_LOG"] ?? join(homedir(), ".nlm", "hook-log.jsonl");
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, `${JSON.stringify(data)}\n`, "utf8");
+    }
+    catch {
+        // Telemetry failure must never break the hook.
+    }
+}
+//# sourceMappingURL=hook-helpers.js.map

package/dist/hook/hook-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-helpers.js","sourceRoot":"","sources":["../../src/hook/hook-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,IAAiB,EACjB,EAAU;IAEV,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACtF,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC"}

package/dist/hook/pre-compact-hook.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 /api/hook/pre-compact
+ *
+ * Payload: { conversation_id, transcript_path, surfaced_set, ts }
+ *
+ * Fail-open by design: any error yields a clean exit with no output.
+ */
+export interface PreCompactInput {
+    readonly conversationId: string;
+    readonly transcriptPath: string;
+}
+export interface PreCompactResult {
+    readonly conversationId: string;
+    readonly posted: boolean;
+}
+export declare function runPreCompact(input: PreCompactInput, portValue?: string): Promise<PreCompactResult>;

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

@@ -0,0 +1,67 @@
+/**
+ * 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 /api/hook/pre-compact
+ *
+ * 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 { loadSurfaced } from "../core/hook/memo.js";
+import { autoloadEnv } from "../llm/env-autoload.js";
+import { hookAuthHeaders } from "./hook-auth.js";
+import { readStdin, fetchWithTimeout, appendHookEvent } from "./hook-helpers.js";
+import { DEFAULT_NLM_PORT } from "../shared/net.js";
+const POST_TIMEOUT_MS = 1500;
+export async function runPreCompact(input, portValue = process.env["NLM_PORT"] ?? DEFAULT_NLM_PORT) {
+    const surfacedSet = [...loadSurfaced(input.conversationId)];
+    const payload = {
+        conversation_id: input.conversationId,
+        transcript_path: input.transcriptPath,
+        surfaced_set: surfacedSet,
+        ts: new Date().toISOString(),
+    };
+    try {
+        const res = await fetchWithTimeout(`http://127.0.0.1:${portValue}/api/hook/pre-compact`, {
+            method: "POST",
+            headers: hookAuthHeaders({ "content-type": "application/json" }),
+            body: JSON.stringify(payload),
+        }, POST_TIMEOUT_MS);
+        return { conversationId: input.conversationId, posted: res.ok };
+    }
+    catch {
+        return { conversationId: input.conversationId, posted: false };
+    }
+}
+function logResult(result) {
+    appendHookEvent({
+        ts: new Date().toISOString(),
+        kind: "pre-compact",
+        conversationId: result.conversationId,
+        posted: result.posted,
+    });
+}
+async function main() {
+    try {
+        autoloadEnv();
+        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":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,eAAe,GAAG,IAAI,CAAC;AAY7B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAsB,EACtB,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,gBAAgB;IAEvD,MAAM,WAAW,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG;QACd,eAAe,EAAE,KAAK,CAAC,cAAc;QACrC,eAAe,EAAE,KAAK,CAAC,cAAc;QACrC,YAAY,EAAE,WAAW;QACzB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC7B,CAAC;IACF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAChC,oBAAoB,SAAS,uBAAuB,EACpD;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,eAAe,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;YAChE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,EACD,eAAe,CAChB,CAAC;QACF,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjE,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAAwB;IACzC,eAAe,CAAC;QACd,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,aAAa;QACnB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,WAAW,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAG7B,CAAC;QACF,MAAM,cAAc,GAClB,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,cAAc,GAClB,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC;QACvE,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,KAAK,IAAI,EAAE,CAAC;AACd,CAAC"}

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

@@ -11,17 +11,51 @@
  */
 import { type PointerExemplar, type PointerFact } from "../core/hook/pointer-block.js";
 import { type RecallHitInput } from "../core/hook/select.js";
+export declare function parseHookDeadline(raw: string | undefined, defaultMs?: number): number;
+export declare const HOOK_DEADLINE_MS: number;
 export type HookMode = "shadow" | "live";
 export declare function hookRuntimeFromEnv(env?: NodeJS.ProcessEnv): string;
+/**
+ * Whether the per-prompt ambient recall hook should run at all.
+ *
+ * Pull-first posture (default since #392, 2026-07-03): fresh installs run
+ * per-prompt ambient recall OFF and agents pull memory on demand via the
+ * recall MCP tools. Measured basis (U1, locked judge): pulls 72.4% useful
+ * vs ambient injection 18.2%/7.9%. NLM_HOOK_PROMPT_RECALL=on opts back in;
+ * any other already-set value keeps its pre-flip meaning (non-"off" = on)
+ * so existing installs are untouched. Independent of NLM_HOOK_MODE, which
+ * governs the once-per-session passive layer (session-start hook), which
+ * stays on.
+ */
+export declare function promptRecallEnabled(env?: NodeJS.ProcessEnv): boolean;
 export interface HookInput {
     readonly prompt: string;
     readonly conversationId: string;
+    /** Runtime transcript path, when the runtime exposes one (Claude Code does). */
+    readonly transcriptPath?: string;
 }
+/**
+ * The recall query. Default is the bare prompt (today's behavior). When the
+ * context-recall flag is on AND the prompt is thin (few content words — the
+ * measured off-topic failure band) AND a transcript is available, prepend the
+ * recent conversation turns so the query carries the topic the thin prompt
+ * lacks. Flag-gated + thin-only + fallback => never worse than today.
+ */
+export declare function buildRecallQuery(input: HookInput, env?: NodeJS.ProcessEnv): string;
 export interface RecallFetchResult {
     readonly hits: ReadonlyArray<RecallHitInput>;
     readonly facts: ReadonlyArray<PointerFact>;
     readonly exemplars?: ReadonlyArray<PointerExemplar>;
 }
+export type GateMode = "shadow" | "live";
+export interface RecallGate {
+    /** shadow = log decisions, inject as usual; live = drop irrelevant candidates. */
+    readonly mode: GateMode;
+    /** Predict, from the prompt and a candidate's context, whether to inject it. */
+    readonly judge: (prompt: string, candidate: string) => Promise<"relevant" | "irrelevant">;
+    /** Judge only the top N candidates (bounds hot-path latency). Unset = all. */
+    readonly maxCandidates?: number;
+}
 export interface RunHookDeps {
     readonly mode: HookMode;
     /**
@@ -29,6 +63,10 @@ export interface RunHookDeps {
      * bare hit array; runHook normalizes both shapes.
      */
     readonly recall: (prompt: string) => Promise<ReadonlyArray<RecallHitInput> | RecallFetchResult>;
+    /** Optional pre-injection relevance gate. Absent => no gating (today's behavior). */
+    readonly recallGate?: RecallGate;
+    /** Wall-clock deadline for the combined recall + gate stages. Defaults to NLM_HOOK_DEADLINE_MS (6000ms; must exceed the recall HTTP timeout, see #396). */
+    readonly deadlineMs?: number;
 }
 /** Orchestration. Returns the text to emit on stdout ("" for nothing). */
 export declare function runHook(input: HookInput, deps: RunHookDeps): Promise<string>;