nlm-memory 0.20.0 → 0.21.0

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

@@ -0,0 +1,76 @@
+const round1 = (n) => Math.round(n * 10) / 10;
+const round2 = (n) => Math.round(n * 100) / 100;
+function countIn(ts, iv) {
+    let n = 0;
+    for (const t of ts)
+        if (t >= iv.start && t <= iv.end)
+            n++;
+    return n;
+}
+/**
+ * Attribute each merged active interval to a topic and derive attention +
+ * focus. v1 uses dominant-session attribution: the whole interval goes to the
+ * session with the most messages in it (the bounded simplification over
+ * fractional splitting documented in the design). Focus is derived from the
+ * ordered, attributed segments: adjacent same-topic segments collapse into
+ * blocks; a topic change between blocks is one context switch.
+ */
+export function attribute(merged, sessions, opts) {
+    const segments = [];
+    for (const iv of merged) {
+        const minutes = (iv.end - iv.start) / 60_000;
+        let best;
+        let bestN = -1;
+        for (const s of sessions) {
+            const n = countIn(s.timestampsMs, iv);
+            if (n > bestN) {
+                bestN = n;
+                best = s;
+            }
+        }
+        segments.push({ topic: best ? best.topic : "uncategorized", minutes, workstreamId: best?.workstreamId ?? null });
+    }
+    const totalMin = segments.reduce((t, s) => t + s.minutes, 0);
+    const byTopicMap = new Map();
+    for (const seg of segments)
+        byTopicMap.set(seg.topic, (byTopicMap.get(seg.topic) ?? 0) + seg.minutes);
+    const wsByTopic = new Map();
+    for (const seg of segments)
+        if (seg.workstreamId && !wsByTopic.has(seg.topic))
+            wsByTopic.set(seg.topic, seg.workstreamId);
+    const byTopic = [...byTopicMap.entries()]
+        .map(([topic, mins]) => {
+        const wsId = wsByTopic.get(topic);
+        return {
+            topic,
+            activeMinutes: round1(mins),
+            share: totalMin ? round2(mins / totalMin) : 0,
+            ...(wsId ? { meta: { workstream_id: wsId } } : {}),
+        };
+    })
+        .sort((a, b) => b.activeMinutes - a.activeMinutes);
+    const blocks = [];
+    for (const seg of segments) {
+        const last = blocks[blocks.length - 1];
+        if (last && last.topic === seg.topic)
+            last.minutes += seg.minutes;
+        else
+            blocks.push({ topic: seg.topic, minutes: seg.minutes });
+    }
+    const contextSwitches = Math.max(0, blocks.length - 1);
+    const longestBlockMin = blocks.reduce((mx, b) => Math.max(mx, b.minutes), 0);
+    const deepMin = blocks
+        .filter((b) => b.minutes >= opts.deepBlockMin)
+        .reduce((t, b) => t + b.minutes, 0);
+    const deepWorkRatio = totalMin ? round2(deepMin / totalMin) : 0;
+    return {
+        byTopic,
+        focus: {
+            contextSwitches,
+            longestBlockMin: round1(longestBlockMin),
+            deepWorkRatio,
+            projectsTouched: byTopicMap.size,
+        },
+    };
+}
+//# sourceMappingURL=attribute.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { SessionStore } from "../../ports/session-store.js";
+import { type TopicProvider } from "./topics.js";
+import type { WorkDigest } from "./types.js";
+export interface BuildWorkDigestDeps {
+    readonly store: Pick<SessionStore, "listByDateRange">;
+    readonly topicProvider?: TopicProvider;
+    readonly idleThresholdMin?: number;
+    readonly deepBlockMin?: number;
+    readonly readTimestamps?: (path: string, fromMs: number, toMs: number) => number[];
+    readonly workstreams?: Pick<import("../../ports/workstream-store.js").WorkstreamStore, "listAll">;
+}
+export declare function buildWorkDigest(deps: BuildWorkDigestDeps, date: string): Promise<WorkDigest>;

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

@@ -0,0 +1,69 @@
+import { activeSpans } from "./active-spans.js";
+import { mergeIntervals } from "./merge-active.js";
+import { attribute } from "./attribute.js";
+import { readTranscriptTimestamps } from "./read-transcript-timestamps.js";
+import { defaultTopicProvider, workstreamTopicProvider } from "./topics.js";
+import { resolveWorkstreamId } from "../workstream/resolve.js";
+const SCOPE_NOTE = "Agent-assisted active time. Excludes meetings and work without an agent.";
+/** Local-midnight window for `date` (YYYY-MM-DD) in the process timezone. */
+function dayWindow(date) {
+    const from = new Date(`${date}T00:00:00`);
+    const to = new Date(from);
+    to.setDate(to.getDate() + 1);
+    return { fromMs: from.getTime(), toMs: to.getTime(), fromIso: from.toISOString(), toIso: to.toISOString() };
+}
+export async function buildWorkDigest(deps, date) {
+    const idleThresholdMin = deps.idleThresholdMin ?? 5;
+    const deepBlockMin = deps.deepBlockMin ?? 25;
+    const topicProvider = deps.topicProvider ?? defaultTopicProvider;
+    const readTs = deps.readTimestamps ?? readTranscriptTimestamps;
+    const provider = deps.workstreams ? workstreamTopicProvider(topicProvider) : topicProvider;
+    const wsList = deps.workstreams ? await deps.workstreams.listAll() : [];
+    const wsById = new Map(wsList.map((w) => [w.id, { id: w.id, mergedInto: w.mergedInto }]));
+    const wsLabel = new Map(wsList.map((w) => [w.id, w.label]));
+    function resolveWs(id) {
+        if (!id)
+            return null;
+        const live = resolveWorkstreamId(id, wsById);
+        const label = wsLabel.get(live);
+        return label ? { id: live, label } : null;
+    }
+    const { fromMs, toMs, fromIso, toIso } = dayWindow(date);
+    const sessions = await deps.store.listByDateRange(fromIso, toIso);
+    const activities = [];
+    const allSpans = [];
+    const decisions = new Set();
+    const openLoops = new Set();
+    let measured = 0;
+    let skipped = 0;
+    for (const s of sessions) {
+        for (const d of s.decisions)
+            decisions.add(d);
+        for (const o of s.open)
+            openLoops.add(o);
+        const timestampsMs = s.transcriptPath ? readTs(s.transcriptPath, fromMs, toMs) : [];
+        if (timestampsMs.length === 0) {
+            skipped++;
+            continue;
+        }
+        measured++;
+        const ws = resolveWs(s.workstreamId);
+        const topic = provider({ entities: s.entities, label: s.label, ...(ws ? { workstreamLabel: ws.label } : {}) });
+        activities.push({ sessionId: s.id, topic, timestampsMs, ...(ws ? { workstreamId: ws.id } : {}) });
+        for (const span of activeSpans(timestampsMs, idleThresholdMin))
+            allSpans.push(span);
+    }
+    const { merged, totalMinutes } = mergeIntervals(allSpans);
+    const { byTopic, focus } = attribute(merged, activities, { deepBlockMin });
+    return {
+        date,
+        idleThresholdMin,
+        scopeNote: SCOPE_NOTE,
+        coverage: { sessions: sessions.length, activeTimeMeasured: measured, activeTimeSkipped: skipped },
+        activeMinutes: Math.round(totalMinutes * 10) / 10,
+        byTopic,
+        focus,
+        progress: { decisions: [...decisions], openLoops: [...openLoops] },
+    };
+}
+//# sourceMappingURL=build-work-digest.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { WorkDigest } from "./types.js";
+/** Render a WorkDigest as the shared operator-facing text. No em dashes. */
+export declare function composeWorkDigest(d: WorkDigest): string;

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

@@ -0,0 +1,52 @@
+const PROGRESS_CAP = 8;
+function hours(min) {
+    return (min / 60).toFixed(1) + "h";
+}
+function renderProgressList(items, emptyLine, label) {
+    const len = items.length;
+    if (len === 0) {
+        return [emptyLine];
+    }
+    if (len <= PROGRESS_CAP) {
+        return [`  ${label} (${len}):`, ...items.map((item) => `   - ${item}`)];
+    }
+    const tail = items.slice(len - PROGRESS_CAP);
+    const overflow = len - PROGRESS_CAP;
+    return [
+        `  ${label}: ${len} (showing last ${PROGRESS_CAP})`,
+        ...tail.map((item) => `   - ${item}`),
+        `   ... (+${overflow} more)`,
+    ];
+}
+/** Render a WorkDigest as the shared operator-facing text. No em dashes. */
+export function composeWorkDigest(d) {
+    const lines = [];
+    lines.push(`DAILY WORK RECAP - ${d.date}`);
+    lines.push(`(${d.scopeNote})`);
+    lines.push("");
+    if (d.activeMinutes <= 0) {
+        lines.push("no agent-assisted work recorded for this day.");
+        return lines.join("\n");
+    }
+    const skipped = d.coverage.activeTimeSkipped > 0
+        ? `   (${d.coverage.activeTimeSkipped} session(s): active-time not measured)`
+        : "";
+    lines.push(`~${hours(d.activeMinutes)} active across ${d.coverage.sessions} sessions, ${d.focus.projectsTouched} projects${skipped}`);
+    lines.push("");
+    lines.push("ATTENTION");
+    for (const t of d.byTopic) {
+        const pct = Math.round(t.share * 100) + "%";
+        lines.push(`  ${t.topic}: ${pct} (${hours(t.activeMinutes)})`);
+    }
+    lines.push("");
+    lines.push("FOCUS");
+    lines.push(`  longest block: ${Math.round(d.focus.longestBlockMin)} min   ` +
+        `context switches: ${d.focus.contextSwitches}   ` +
+        `deep-work: ${Math.round(d.focus.deepWorkRatio * 100)}%`);
+    lines.push("");
+    lines.push("PROGRESS");
+    lines.push(...renderProgressList(d.progress.decisions, "  decided: none recorded", "decided"));
+    lines.push(...renderProgressList(d.progress.openLoops, "  open loops: none", "open loops"));
+    return lines.join("\n");
+}
+//# sourceMappingURL=compose-work-digest.js.map

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

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

package/dist/core/work-digest/merge-active.d.ts

@@ -0,0 +1,10 @@
+import type { Interval } from "./types.js";
+/**
+ * Union overlapping/touching activity intervals into a single wall-clock
+ * timeline so concurrently-supervised agents are not double-counted, and
+ * report the total active minutes of that timeline.
+ */
+export declare function mergeIntervals(intervals: ReadonlyArray<Interval>): {
+    merged: Interval[];
+    totalMinutes: number;
+};

package/dist/core/work-digest/merge-active.js

@@ -0,0 +1,22 @@
+/**
+ * Union overlapping/touching activity intervals into a single wall-clock
+ * timeline so concurrently-supervised agents are not double-counted, and
+ * report the total active minutes of that timeline.
+ */
+export function mergeIntervals(intervals) {
+    const sorted = [...intervals].sort((a, b) => a.start - b.start);
+    const merged = [];
+    for (const iv of sorted) {
+        const last = merged[merged.length - 1];
+        if (last && iv.start <= last.end) {
+            if (iv.end > last.end)
+                merged[merged.length - 1] = { start: last.start, end: iv.end };
+        }
+        else {
+            merged.push({ start: iv.start, end: iv.end });
+        }
+    }
+    const totalMinutes = merged.reduce((t, iv) => t + (iv.end - iv.start) / 60_000, 0);
+    return { merged, totalMinutes };
+}
+//# sourceMappingURL=merge-active.js.map

package/dist/core/work-digest/merge-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-active.js","sourceRoot":"","sources":["../../../src/core/work-digest/merge-active.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAkC;IAElC,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,IAAI,IAAI,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG;gBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;QACxF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACnF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/work-digest/read-transcript-timestamps.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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 declare function readTranscriptTimestamps(path: string, fromMs: number, toMs: number): number[];

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,26 @@
+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" | "create" | "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;
+    readonly scope: string | null;
+}
+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,42 @@
+import { makeWorkstreamId } from "./model.js";
+import { decideWorkstreamByName } from "./name-match.js";
+import { scopeStampEnabled } from "../scope/stamp-flag.js";
+export const NAMING_CONTENT_CHARS = 8000;
+function scopeMatches(wsScope, sessionScope) {
+    return wsScope === sessionScope;
+}
+async function applyBinding(deps, input, workstreamId) {
+    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 };
+}
+export async function bindSessionToWorkstream(deps, input) {
+    try {
+        const all = await deps.workstreams.listAll();
+        const content = `${input.label}\n${(input.body || input.summary).slice(0, NAMING_CONTENT_CHARS)}`;
+        if (scopeStampEnabled()) {
+            const scoped = all.filter((w) => scopeMatches(w.scope, input.scope));
+            const named = await deps.namer.nameWorkstream(content, scoped.map((w) => ({ label: w.label })));
+            const decision = decideWorkstreamByName(named, scoped, deps.aliasToLabel);
+            if (decision.kind === "bind") {
+                return applyBinding(deps, input, decision.workstreamId);
+            }
+            if (named && named.trim()) {
+                const ws = await deps.workstreams.create({ id: makeWorkstreamId(), label: named.trim(), scope: input.scope });
+                return applyBinding(deps, input, ws.id);
+            }
+            return null;
+        }
+        const named = await deps.namer.nameWorkstream(content, all.map((w) => ({ label: w.label })));
+        const decision = decideWorkstreamByName(named, all, deps.aliasToLabel);
+        if (decision.kind === "abstain")
+            return null;
+        return applyBinding(deps, input, decision.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":"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"}

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>;