nlm-memory 0.19.0 → 0.20.1

package/dist/core/work-digest/read-transcript-timestamps.js

@@ -0,0 +1,40 @@
+import { readFileSync } from "node:fs";
+/**
+ * Extract message timestamps (epoch ms) from a transcript JSONL file, keeping
+ * only those within [fromMs, toMs). Best-effort: a missing/unreadable file or
+ * an unparseable line yields no timestamps rather than throwing. Accepts the
+ * common timestamp fields across runtimes (claude-code/pi use `timestamp`).
+ */
+export function readTranscriptTimestamps(path, fromMs, toMs) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const tsRaw = obj["timestamp"] ?? obj["ts"] ?? obj["created_at"];
+        if (typeof tsRaw !== "string")
+            continue;
+        const ms = Date.parse(tsRaw);
+        if (!Number.isFinite(ms))
+            continue;
+        if (ms >= fromMs && ms < toMs)
+            out.push(ms);
+    }
+    out.sort((a, b) => a - b);
+    return out;
+}
+//# sourceMappingURL=read-transcript-timestamps.js.map

package/dist/core/work-digest/read-transcript-timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-transcript-timestamps.js","sourceRoot":"","sources":["../../../src/core/work-digest/read-transcript-timestamps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY;IACjF,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,GAA4B,CAAC;QACjC,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QACjE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,SAAS;QACnC,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,GAAG,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,18 @@
+/** The minimal session view a topic provider sees. Extensions (e.g. NLOS) can
+ *  key on entities and/or label to impose their own taxonomy. */
+export interface TopicInput {
+    readonly entities: ReadonlyArray<string>;
+    readonly label: string;
+    /** Resolved live-workstream label, when the session is bound. Takes precedence over entity/alias topics. */
+    readonly workstreamLabel?: string;
+}
+export type TopicProvider = (input: TopicInput) => string;
+/** NLM-core default: the session's first classified entity, normalized. */
+export declare const defaultTopicProvider: TopicProvider;
+/** NLM-core: prefer the bound workstream's label; fall through to `fallback`
+ *  (alias-map / first-entity) for unbound sessions. Retires the
+ *  alphabetically-first-entity dependency for bound sessions (spec §10). */
+export declare function workstreamTopicProvider(fallback: TopicProvider): TopicProvider;
+/** NLM-core optional: group entities into labels via an operator-supplied map.
+ *  The same interface an extension uses to supply a function/taxonomy map. */
+export declare function aliasTopicProvider(map: Record<string, string>): TopicProvider;

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

@@ -0,0 +1,26 @@
+function normalize(s) {
+    return s.trim().toLowerCase();
+}
+/** NLM-core default: the session's first classified entity, normalized. */
+export const defaultTopicProvider = (input) => {
+    const first = input.entities[0];
+    return first && first.trim() ? normalize(first) : "uncategorized";
+};
+/** NLM-core: prefer the bound workstream's label; fall through to `fallback`
+ *  (alias-map / first-entity) for unbound sessions. Retires the
+ *  alphabetically-first-entity dependency for bound sessions (spec §10). */
+export function workstreamTopicProvider(fallback) {
+    return (input) => input.workstreamLabel && input.workstreamLabel.trim() ? input.workstreamLabel : fallback(input);
+}
+/** NLM-core optional: group entities into labels via an operator-supplied map.
+ *  The same interface an extension uses to supply a function/taxonomy map. */
+export function aliasTopicProvider(map) {
+    const norm = {};
+    for (const [k, v] of Object.entries(map))
+        norm[normalize(k)] = v;
+    return (input) => {
+        const base = defaultTopicProvider(input);
+        return norm[base] ?? base;
+    };
+}
+//# sourceMappingURL=topics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/core/work-digest/topics.ts"],"names":[],"mappings":"AAWA,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAkB,CAAC,KAAK,EAAE,EAAE;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;AACpE,CAAC,CAAC;AAEF;;4EAE4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,CAAC,KAAK,EAAE,EAAE,CACf,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,GAA2B;IAC5D,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/work-digest/types.d.ts

@@ -0,0 +1,45 @@
+/** A half-open-ish activity interval in epoch milliseconds (end >= start). */
+export interface Interval {
+    readonly start: number;
+    readonly end: number;
+}
+/** One session's in-day message timestamps plus its resolved topic. */
+export interface SessionActivity {
+    readonly sessionId: string;
+    readonly topic: string;
+    readonly timestampsMs: ReadonlyArray<number>;
+    readonly workstreamId?: string | null;
+}
+/** Attention: active minutes attributed to one topic. `meta` is an opaque
+ *  extension seam (Section 7.1 of the design) — NLM core never reads it. */
+export interface TopicShare {
+    readonly topic: string;
+    readonly activeMinutes: number;
+    readonly share: number;
+    readonly meta?: Record<string, unknown>;
+}
+export interface FocusStats {
+    readonly contextSwitches: number;
+    readonly longestBlockMin: number;
+    readonly deepWorkRatio: number;
+    readonly projectsTouched: number;
+}
+export interface ProgressStats {
+    readonly decisions: ReadonlyArray<string>;
+    readonly openLoops: ReadonlyArray<string>;
+}
+export interface Coverage {
+    readonly sessions: number;
+    readonly activeTimeMeasured: number;
+    readonly activeTimeSkipped: number;
+}
+export interface WorkDigest {
+    readonly date: string;
+    readonly idleThresholdMin: number;
+    readonly scopeNote: string;
+    readonly coverage: Coverage;
+    readonly activeMinutes: number;
+    readonly byTopic: ReadonlyArray<TopicShare>;
+    readonly focus: FocusStats;
+    readonly progress: ProgressStats;
+}

package/dist/core/work-digest/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/work-digest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/work-digest/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,25 @@
+import type { WorkstreamStore } from "../../ports/workstream-store.js";
+import type { SessionStore } from "../../ports/session-store.js";
+import type { LLMClient } from "../../ports/llm-client.js";
+import type { BindingSource } from "./model.js";
+export declare const NAMING_CONTENT_CHARS = 8000;
+export interface BindDeps {
+    readonly namer: Pick<LLMClient, "nameWorkstream">;
+    readonly workstreams: Pick<WorkstreamStore, "listAll" | "upsertEntities" | "touchLastSession">;
+    readonly sessions: Pick<SessionStore, "setWorkstreamBinding">;
+    readonly aliasToLabel: ReadonlyMap<string, string>;
+    readonly log?: (msg: string) => void;
+    readonly source?: BindingSource;
+}
+export interface BindInput {
+    readonly sessionId: string;
+    readonly label: string;
+    readonly summary: string;
+    readonly body?: string;
+    readonly entities: ReadonlyArray<string>;
+    readonly startedAt: string;
+}
+export interface BindResult {
+    readonly workstreamId: string;
+}
+export declare function bindSessionToWorkstream(deps: BindDeps, input: BindInput): Promise<BindResult | null>;

package/dist/core/workstream/bind.js

@@ -0,0 +1,23 @@
+import { decideWorkstreamByName } from "./name-match.js";
+export const NAMING_CONTENT_CHARS = 8000;
+export async function bindSessionToWorkstream(deps, input) {
+    try {
+        const ws = await deps.workstreams.listAll();
+        const hints = ws.map((w) => ({ label: w.label }));
+        const content = `${input.label}\n${(input.body || input.summary).slice(0, NAMING_CONTENT_CHARS)}`;
+        const named = await deps.namer.nameWorkstream(content, hints);
+        const decision = decideWorkstreamByName(named, ws, deps.aliasToLabel);
+        if (decision.kind === "abstain")
+            return null;
+        const { workstreamId } = decision;
+        await deps.sessions.setWorkstreamBinding(input.sessionId, workstreamId, deps.source ?? "classifier", null);
+        await deps.workstreams.upsertEntities(workstreamId, input.entities);
+        await deps.workstreams.touchLastSession(workstreamId, input.startedAt);
+        return { workstreamId };
+    }
+    catch (e) {
+        deps.log?.(`[workstream] bind failed for ${input.sessionId}: ${e instanceof Error ? e.message : String(e)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=bind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bind.js","sourceRoot":"","sources":["../../../src/core/workstream/bind.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAwBzC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAc,EAAE,KAAgB;IAC5E,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAClG,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtE,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAE7C,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC;QAClC,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY,EAAE,IAAI,CAAC,CAAC;QAC3G,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvE,OAAO,EAAE,YAAY,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,EAAE,CAAC,gCAAgC,KAAK,CAAC,SAAS,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7G,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/workstream/compose-recall.d.ts

@@ -0,0 +1,2 @@
+import type { WorkstreamRollup } from "./model.js";
+export declare function composeWorkstreamRecall(view: WorkstreamRollup): string;

package/dist/core/workstream/compose-recall.js

@@ -0,0 +1,39 @@
+export function composeWorkstreamRecall(view) {
+    const { workstream, sessionIds, facts, exemplars } = view;
+    const lines = [];
+    lines.push(`WORKSTREAM: ${workstream.label}`);
+    lines.push(`(${sessionIds.length} sessions${workstream.lastSessionAt ? `, last active ${workstream.lastSessionAt.slice(0, 10)}` : ""})`);
+    lines.push("");
+    const decisions = facts.filter((f) => f.kind === "decision");
+    const open = facts.filter((f) => f.kind === "open");
+    const attrs = facts.filter((f) => f.kind === "attribute");
+    if (decisions.length) {
+        lines.push("DECISIONS:");
+        for (const f of decisions)
+            lines.push(`  - ${f.value}`);
+        lines.push("");
+    }
+    if (open.length) {
+        lines.push("OPEN LOOPS:");
+        for (const f of open)
+            lines.push(`  - ${f.value}`);
+        lines.push("");
+    }
+    if (attrs.length) {
+        lines.push("FACTS:");
+        for (const f of attrs)
+            lines.push(`  - ${f.subject} ${f.predicate} ${f.value}`);
+        lines.push("");
+    }
+    if (exemplars.length) {
+        lines.push("CODE EXEMPLARS:");
+        for (const e of exemplars)
+            lines.push(`  - [${e.outcome}] ${e.repo}: ${e.taskContext}`);
+        lines.push("");
+    }
+    if (!decisions.length && !open.length && !attrs.length && !exemplars.length) {
+        lines.push("(no accumulated facts or exemplars yet)");
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=compose-recall.js.map

package/dist/core/workstream/compose-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-recall.js","sourceRoot":"","sources":["../../../src/core/workstream/compose-recall.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,uBAAuB,CAAC,IAAsB;IAC5D,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,YAAY,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAE1D,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/core/workstream/merge-suggest.d.ts

@@ -0,0 +1,19 @@
+export interface MergeSuggestInputItem {
+    readonly id: string;
+    readonly label: string;
+    readonly entities: ReadonlyArray<string>;
+    readonly sessionIds: ReadonlyArray<string>;
+}
+export interface MergeSuggestion {
+    readonly aId: string;
+    readonly aLabel: string;
+    readonly bId: string;
+    readonly bLabel: string;
+    readonly score: number;
+    readonly sharedEntities: number;
+    readonly sharedSessions: number;
+    readonly labelSimilarity: number;
+}
+export declare function scoreMergePair(a: MergeSuggestInputItem, b: MergeSuggestInputItem): MergeSuggestion;
+/** All unordered pairs scoring >= minScore, ranked desc. Pure; O(n^2) over the (small) workstream set. */
+export declare function suggestMerges(items: ReadonlyArray<MergeSuggestInputItem>, minScore: number): ReadonlyArray<MergeSuggestion>;

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,20 @@
+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;
+}
+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;AAwBzC,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"}