@rryando/arcs 3.10.0 → 4.0.0

package/dist/utils/claude-transcript.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Claude Code transcript mirroring for the session bridge.
+ *
+ * Owns a per-session sidecar at `sessions/{normalizedId}.transcript.jsonl`
+ * that mirrors a Claude Code JSONL transcript (the runtime's single source of
+ * truth) into a derived read-model for the web UI. The sidecar is append-only
+ * and keyed by transcript line offsets so re-mirroring is idempotent; when the
+ * transcript is compacted/rewritten below the mirrored offset, the sidecar is
+ * rebuilt from line 0 while preserving ARCS-authored turns (any record with a
+ * negative id — references and web-sent user/assistant turns).
+ *
+ * Never throws: missing/unreadable/oversized/malformed inputs are silent
+ * no-ops, and the sidecar never touches `sessions/index.json`.
+ */
+/** A MarkdownSection payload the caller sent to the session. Preserved on the
+ *  sidecar reference record verbatim so the web UI can render the section with
+ *  click-through back to its source document. */
+export interface ReferenceSection {
+    /** Heading depth of the referenced section (1-based). */
+    depth: number;
+    /** The section's rendered markdown, exactly as it was sent to the session. */
+    text: string;
+    /** Stable id of the section within its document. */
+    id: string;
+    /** Character offsets of the section within the full document text. */
+    startOffset: number;
+    endOffset: number;
+}
+/** Identity of the document a reference was quoted from. */
+export interface ReferenceSource {
+    /** Which ARCS store the referenced document lives in. */
+    kind: "overview" | "knowledge" | "plan";
+    /** Human-readable name of the source document. */
+    label: string;
+    /** Optional doc identifier (e.g. knowledge entry id, plan id). */
+    doc?: string;
+    id?: string;
+}
+/**
+ * A markdown document section — the ONLY reference shape that existed before
+ * the union, and therefore the shape every reference turn already on disk
+ * carries. Its `section`/`source` fields are frozen: a sidecar written by an
+ * older ARCS must keep parsing, and a doc reference written today must stay
+ * byte-identical to one written then. The tag is filled in at the schema
+ * boundary (`sessionReferenceSchema`) rather than required on the wire, because
+ * legacy bodies carry no tag at all.
+ */
+export interface DocReference {
+    type: "doc";
+    text: string;
+    section: ReferenceSection;
+    source: ReferenceSource;
+}
+/**
+ * A line range in a workspace file, sent as a POINTER rather than as content:
+ * `excerpt` is a short human anchor, never the authoritative text — the agent
+ * reads the live file. `headRev` is the revision the slice was taken at, so a
+ * later diff can tell whether the file moved under the agent.
+ */
+export interface FileReference {
+    type: "file";
+    /** Workspace-relative path, as the caller sent it. */
+    path: string;
+    /** 1-based, inclusive. */
+    startLine: number;
+    endLine: number;
+    excerpt?: string;
+    headRev?: string;
+}
+/** A DAG entity. Carries no text slice — ARCS is the source of truth for it. */
+export interface NodeReference {
+    type: "node";
+    kind: "task" | "plan" | "knowledge";
+    id: string;
+}
+/** Everything a caller can point a session at, discriminated on `type`. */
+export type SessionReference = DocReference | FileReference | NodeReference;
+/** The pointer kinds, which have no historical fields of their own and so ride
+ *  a reference turn whole (see `TranscriptTurn.ref`). */
+export type PointerReference = FileReference | NodeReference;
+/**
+ * The `text` a reference TURN records — the sidecar's own label, which is what
+ * the transcript panel shows. NOT prompt text: rendering a reference for a
+ * model is `web-server/prompt-assembly.ts`'s exclusive job. Doc references keep
+ * the caller's quoted text verbatim (unchanged from before the union); the
+ * pointer kinds have no text of their own, so the turn carries their identity.
+ */
+export declare function referenceTurnText(reference: SessionReference): string;
+export interface TranscriptTurn {
+    /**
+     * Absolute 0-based line index in the source transcript for mirrored turns.
+     * ARCS-authored turns (references and web-sent user/assistant turns) carry a
+     * negative id drawn from one shared monotonic sequence, so they live in a
+     * disjoint space and can never collide with transcript line indices or with
+     * each other (the panel keys TurnRow on id).
+     */
+    id: number;
+    type: "user" | "assistant" | "reference";
+    text: string;
+    ts?: string;
+    tool?: {
+        name: string;
+    };
+    /** Reference turns only: the MarkdownSection payload the caller sent to the
+     *  session, preserved for click-through rendering. */
+    section?: ReferenceSection;
+    /** Reference turns only: identity of the source document. */
+    source?: ReferenceSource;
+    /**
+     * Reference turns only, POINTER kinds only: the file-slice or DAG-node
+     * payload the caller sent, preserved whole. Doc references deliberately do
+     * NOT land here — they keep their historical `section`/`source` fields, so a
+     * record written today is byte-identical to one written before the union
+     * existed and an older sidecar still reads.
+     */
+    ref?: PointerReference;
+    /**
+     * Run this turn was folded down from (see web-server/run-event-log.ts). Set
+     * only on ARCS-authored turns written at a run's settle, where it doubles as
+     * the fold's idempotence marker: a run whose id already appears here has
+     * been folded and is never folded again.
+     */
+    run?: string;
+}
+export interface ReadTranscriptResult {
+    turns: TranscriptTurn[];
+    /** Number of record lines in the transcript (trailing newline excluded). */
+    totalLines: number;
+}
+export interface ReferenceTurnInput {
+    text?: string;
+    ts?: string;
+    tool?: {
+        name: string;
+    };
+    section?: ReferenceSection;
+    source?: ReferenceSource;
+    /** Pointer kinds only — see `TranscriptTurn.ref`. */
+    ref?: PointerReference;
+}
+/** An ARCS-authored user/assistant turn sent to the session from the web UI. */
+export interface SessionTurnInput {
+    type: "user" | "assistant";
+    text: string;
+    ts?: string;
+    /** Tool this turn stands for — a `tool_use` folded down from a run's event
+     *  log, rendered dimmed exactly like a mirrored tool turn. */
+    tool?: {
+        name: string;
+    };
+    /** Run this turn was folded down from; also the fold's idempotence marker. */
+    run?: string;
+}
+/** Single-read cap for transcript files; anything larger mirrors as a no-op. */
+export declare const TRANSCRIPT_MAX_BYTES: number;
+/**
+ * Sidecar path. The filename keys on the normalized id so it matches the
+ * session index record exactly (normalizeIdentifier round-trips UUIDs
+ * unchanged, so Claude Code session uuids survive verbatim).
+ */
+export declare function sessionTranscriptPath(projectDir: string, normalizedId: string): string;
+/**
+ * Reads a Claude Code JSONL transcript and parses only lines >= fromLine.
+ * Returns the kept turns (absolute line indices) plus the transcript's total
+ * record-line count. Never throws — unreadable files yield empty results.
+ */
+export declare function readTranscriptTurns(filePath: string, fromLine: number): Promise<ReadTranscriptResult>;
+/**
+ * Mirrors the transcript into the per-session sidecar (append-only, offset
+ * idempotent). When the transcript has fewer lines than the mirrored offset —
+ * Claude Code compacts/rewrites its JSONL — the sidecar is rebuilt from line 0
+ * with existing ARCS-authored turns (id < 0) preserved.
+ *
+ * Never throws: missing/unreadable/oversized/malformed inputs are silent
+ * no-ops and the sidecar stays untouched. Never writes sessions/index.json.
+ */
+export declare function mirrorSessionTranscript(projectDir: string, normalizedId: string, transcriptPath: string): Promise<void>;
+/**
+ * Appends an ARCS-authored reference turn (a document section, file slice or
+ * DAG node the caller pointed the session at) to the sidecar under the same
+ * sessions/.store lock the session
+ * store uses, so appends serialize with index mutations. A failed append is a
+ * swallowed no-op — the caller has already delivered the message. The id is
+ * minted from the shared ARCS-authored negative space so it can never collide
+ * with a web-sent user/assistant turn.
+ */
+export declare function appendReferenceTurn(projectDir: string, normalizedId: string, turn: ReferenceTurnInput): Promise<void>;
+/**
+ * Appends an ARCS-authored user/assistant turn (sent to the session from the
+ * web UI) to the sidecar under the same sessions/.store lock the session store
+ * and the other sidecar writers use, so appends serialize with index mutations
+ * and reference appends. A failed append is a swallowed no-op. The id is
+ * minted from the shared ARCS-authored negative space so it can never collide
+ * with a reference turn — both render through <TurnRow key={t.id}>.
+ *
+ * `tool` and `run` ride through verbatim: they are what a run's event-log
+ * fold-down writes (one turn per `tool_use`, every turn tagged with the run
+ * whose log produced it — see web-server/run-event-log.ts).
+ */
+export declare function appendSessionTurn(projectDir: string, normalizedId: string, turn: SessionTurnInput): Promise<void>;
+/**
+ * Reads the sidecar for the GET route, skipping malformed lines. Returns an
+ * empty array when the sidecar is missing. Never throws.
+ */
+export declare function readSessionTurns(projectDir: string, normalizedId: string): Promise<TranscriptTurn[]>;
+//# sourceMappingURL=claude-transcript.d.ts.map

package/dist/utils/claude-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-transcript.d.ts","sourceRoot":"","sources":["../../src/utils/claude-transcript.ts"],"names":[],"mappings":"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"}

package/dist/utils/claude-transcript.js

@@ -0,0 +1,384 @@
+/**
+ * Claude Code transcript mirroring for the session bridge.
+ *
+ * Owns a per-session sidecar at `sessions/{normalizedId}.transcript.jsonl`
+ * that mirrors a Claude Code JSONL transcript (the runtime's single source of
+ * truth) into a derived read-model for the web UI. The sidecar is append-only
+ * and keyed by transcript line offsets so re-mirroring is idempotent; when the
+ * transcript is compacted/rewritten below the mirrored offset, the sidecar is
+ * rebuilt from line 0 while preserving ARCS-authored turns (any record with a
+ * negative id — references and web-sent user/assistant turns).
+ *
+ * Never throws: missing/unreadable/oversized/malformed inputs are silent
+ * no-ops, and the sidecar never touches `sessions/index.json`.
+ */
+import { appendFile, readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { withLock } from "./file-lock.js";
+import { normalizeIdentifier } from "./slug.js";
+import { ensureDir, nowISO, writeTextAtomic } from "./storage-utils.js";
+/**
+ * The `text` a reference TURN records — the sidecar's own label, which is what
+ * the transcript panel shows. NOT prompt text: rendering a reference for a
+ * model is `web-server/prompt-assembly.ts`'s exclusive job. Doc references keep
+ * the caller's quoted text verbatim (unchanged from before the union); the
+ * pointer kinds have no text of their own, so the turn carries their identity.
+ */
+export function referenceTurnText(reference) {
+    switch (reference.type) {
+        case "file":
+            return `${reference.path}:${reference.startLine}-${reference.endLine}`;
+        case "node":
+            return `${reference.kind} ${reference.id}`;
+        default:
+            return reference.text;
+    }
+}
+/** Single-read cap for transcript files; anything larger mirrors as a no-op. */
+export const TRANSCRIPT_MAX_BYTES = 20 * 1024 * 1024;
+// ---------------------------------------------------------------------------
+// Paths & locking
+// ---------------------------------------------------------------------------
+/**
+ * Sidecar path. The filename keys on the normalized id so it matches the
+ * session index record exactly (normalizeIdentifier round-trips UUIDs
+ * unchanged, so Claude Code session uuids survive verbatim).
+ */
+export function sessionTranscriptPath(projectDir, normalizedId) {
+    return join(projectDir, "sessions", `${normalizeIdentifier(normalizedId)}.transcript.jsonl`);
+}
+/**
+ * The same advisory lock the session store uses for index mutations. Kept
+ * local (not imported) because session-store's helper is private and that
+ * module is out of scope; the path mirrors its `sessions/.store` so appends
+ * here serialize with createSession/updateSession/etc.
+ */
+function sessionStoreLockPath(projectDir) {
+    return join(projectDir, "sessions", ".store");
+}
+// ---------------------------------------------------------------------------
+// Transcript parser — verified against the real Claude Code JSONL shape
+// ---------------------------------------------------------------------------
+function isBlock(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Concatenates non-empty text blocks; thinking/tool_use blocks are dropped. */
+function extractTextBlocks(blocks) {
+    return blocks
+        .filter((block) => isBlock(block) &&
+        block.type === "text" &&
+        typeof block.text === "string" &&
+        block.text !== "")
+        .map((block) => block.text)
+        .join("\n");
+}
+/**
+ * Parses one transcript line into a normalized turn, or null when the line is
+ * noise/malformed. Malformed JSON is skipped, never thrown.
+ *
+ * Noise rules (verified against real ~/.claude/projects JSONL transcripts):
+ * - types other than "user"/"assistant" (mode, agent-setting, permission-mode,
+ *   file-history-snapshot, last-prompt, queue-operation, system, attachment…)
+ * - user entries with isMeta:true (the <local-command-caveat> wrapper)
+ * - user local-command payloads (<command-name>/<local-command-stdout>), which
+ *   in practice carry NO isMeta flag at all — filtered by content marker
+ * - user entries whose content is a tool_result array (tool output echoes)
+ * - thinking blocks inside assistant content
+ * - assistant lines with neither text nor tool_use (thinking-only lines)
+ */
+function parseTranscriptLine(rawLine, lineIndex) {
+    if (rawLine.trim() === "")
+        return null;
+    let entry;
+    try {
+        entry = JSON.parse(rawLine);
+    }
+    catch {
+        return null;
+    }
+    if (!isBlock(entry))
+        return null;
+    if (entry.type !== "user" && entry.type !== "assistant")
+        return null;
+    const message = entry.message;
+    if (!isBlock(message))
+        return null;
+    const ts = typeof entry.timestamp === "string" ? entry.timestamp : undefined;
+    if (entry.type === "user") {
+        if (entry.isMeta === true)
+            return null;
+        const content = message.content;
+        if (typeof content === "string") {
+            const text = content.trim();
+            if (text.startsWith("<command-name>") ||
+                text.startsWith("<local-command-stdout>") ||
+                text.startsWith("<local-command-caveat>")) {
+                return null;
+            }
+            return { id: lineIndex, type: "user", text, ...(ts !== undefined ? { ts } : {}) };
+        }
+        if (Array.isArray(content)) {
+            // Claude Code user arrays are tool_result blocks — echoed tool output,
+            // never a real prompt. (The rare text-only array, e.g. an interruption
+            // notice, is kept.)
+            if (content.some((block) => isBlock(block) && block.type === "tool_result"))
+                return null;
+            const text = extractTextBlocks(content);
+            if (text === "")
+                return null;
+            return { id: lineIndex, type: "user", text, ...(ts !== undefined ? { ts } : {}) };
+        }
+        return null;
+    }
+    // assistant — content is a block array: keep text, dim tool_use, drop thinking.
+    if (!Array.isArray(message.content))
+        return null;
+    const text = extractTextBlocks(message.content);
+    const toolUse = message.content.find((block) => isBlock(block) && block.type === "tool_use" && typeof block.name === "string");
+    if (text === "" && toolUse === undefined)
+        return null;
+    const turn = {
+        id: lineIndex,
+        type: "assistant",
+        text,
+        ...(ts !== undefined ? { ts } : {}),
+    };
+    if (toolUse !== undefined)
+        turn.tool = { name: toolUse.name };
+    return turn;
+}
+/**
+ * Reads a Claude Code JSONL transcript and parses only lines >= fromLine.
+ * Returns the kept turns (absolute line indices) plus the transcript's total
+ * record-line count. Never throws — unreadable files yield empty results.
+ */
+export async function readTranscriptTurns(filePath, fromLine) {
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf-8");
+    }
+    catch {
+        return { turns: [], totalLines: 0 };
+    }
+    const lines = raw.split("\n");
+    // A trailing newline produces one empty split element — not a record line.
+    while (lines.length > 0 && lines[lines.length - 1] === "")
+        lines.pop();
+    const totalLines = lines.length;
+    const turns = [];
+    for (let lineIndex = fromLine; lineIndex < totalLines; lineIndex++) {
+        const turn = parseTranscriptLine(lines[lineIndex] ?? "", lineIndex);
+        if (turn !== null)
+            turns.push(turn);
+    }
+    return { turns, totalLines };
+}
+// ---------------------------------------------------------------------------
+// Sidecar read/write
+// ---------------------------------------------------------------------------
+function parseSidecarLine(rawLine) {
+    if (rawLine.trim() === "")
+        return null;
+    try {
+        const parsed = JSON.parse(rawLine);
+        if (isBlock(parsed) &&
+            (parsed.type === "user" || parsed.type === "assistant" || parsed.type === "reference")) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Reads the sidecar, skipping malformed lines. Never throws. */
+async function readSidecarRecords(filePath) {
+    try {
+        const raw = await readFile(filePath, "utf-8");
+        return raw.split("\n").flatMap((line) => {
+            const record = parseSidecarLine(line);
+            return record !== null ? [record] : [];
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Resume offset = the next unmirrored transcript line. ARCS-authored turns are
+ * excluded (they are not transcript lines, and their negative ids never exceed
+ * the -1 sentinel, so they cannot push the offset), and the id of the last
+ * mirrored turn is the transcript line index it came from, so
+ * `last id + 1` is the count of transcript lines consumed. Equivalent to the
+ * sidecar line count in the noise-free case, and correct under interleaved
+ * noise and ARCS-authored turns where a raw line count would drift.
+ */
+function mirrorOffset(records) {
+    let lastMirroredId = -1;
+    for (const record of records) {
+        if (record.type !== "reference" &&
+            typeof record.id === "number" &&
+            record.id > lastMirroredId) {
+            lastMirroredId = record.id;
+        }
+    }
+    return lastMirroredId + 1;
+}
+function serializeRecords(records) {
+    if (records.length === 0)
+        return "";
+    return `${records.map((record) => JSON.stringify(record)).join("\n")}\n`;
+}
+/**
+ * Next id in the shared ARCS-authored negative space: min(existing id < 0) − 1.
+ * All ARCS-authored records — session user/assistant turns and references —
+ * draw from this one monotonic sequence, so a user turn and a reference can
+ * never collide on the same id (the panel renders <TurnRow key={t.id}>).
+ * No negative ids yet: first id is −1 (0 − 1).
+ */
+function nextNegativeTurnId(records) {
+    let minNegative = 0;
+    for (const record of records) {
+        if (typeof record.id === "number" && record.id < 0 && record.id < minNegative) {
+            minNegative = record.id;
+        }
+    }
+    return minNegative - 1;
+}
+async function appendRecords(filePath, records) {
+    if (records.length === 0)
+        return;
+    await appendFile(filePath, serializeRecords(records), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Mirrors the transcript into the per-session sidecar (append-only, offset
+ * idempotent). When the transcript has fewer lines than the mirrored offset —
+ * Claude Code compacts/rewrites its JSONL — the sidecar is rebuilt from line 0
+ * with existing ARCS-authored turns (id < 0) preserved.
+ *
+ * Never throws: missing/unreadable/oversized/malformed inputs are silent
+ * no-ops and the sidecar stays untouched. Never writes sessions/index.json.
+ */
+export async function mirrorSessionTranscript(projectDir, normalizedId, transcriptPath) {
+    try {
+        // Cap the single read: oversized transcripts are silently skipped.
+        const transcriptStat = await stat(transcriptPath);
+        if (!transcriptStat.isFile() || transcriptStat.size > TRANSCRIPT_MAX_BYTES)
+            return;
+        await withLock(sessionStoreLockPath(projectDir), async () => {
+            const sidecarPath = sessionTranscriptPath(projectDir, normalizedId);
+            const existing = await readSidecarRecords(sidecarPath);
+            const offset = mirrorOffset(existing);
+            const { turns, totalLines } = await readTranscriptTurns(transcriptPath, offset);
+            if (totalLines < offset) {
+                // Compaction/rewrite: rebuild from line 0, preserving every
+                // ARCS-authored turn (id < 0) — references and web-sent user/assistant
+                // turns both live in the negative space.
+                // SHORTCUT: compaction detection is line-count-only — a corrupted or
+                // truncated transcript that happens to shrink below the mirrored
+                // offset is treated as compaction and mirrored turns are dropped
+                // (ARCS-authored turns always survive). Upgrade when Claude Code's
+                // JSONL rewrite signals are identifiable, e.g. a marker record.
+                const arsAuthored = existing.filter((record) => typeof record.id === "number" && record.id < 0);
+                const { turns: allTurns } = await readTranscriptTurns(transcriptPath, 0);
+                await ensureDir(join(projectDir, "sessions"));
+                await writeTextAtomic(sidecarPath, serializeRecords([...arsAuthored, ...allTurns]));
+                return;
+            }
+            if (turns.length === 0)
+                return;
+            await ensureDir(join(projectDir, "sessions"));
+            await appendRecords(sidecarPath, turns);
+        });
+    }
+    catch {
+        // Never throws — every mirror failure is a swallowed no-op.
+    }
+}
+/**
+ * Appends an ARCS-authored reference turn (a document section, file slice or
+ * DAG node the caller pointed the session at) to the sidecar under the same
+ * sessions/.store lock the session
+ * store uses, so appends serialize with index mutations. A failed append is a
+ * swallowed no-op — the caller has already delivered the message. The id is
+ * minted from the shared ARCS-authored negative space so it can never collide
+ * with a web-sent user/assistant turn.
+ */
+export async function appendReferenceTurn(projectDir, normalizedId, turn) {
+    try {
+        await ensureDir(join(projectDir, "sessions"));
+        await withLock(sessionStoreLockPath(projectDir), async () => {
+            const sidecarPath = sessionTranscriptPath(projectDir, normalizedId);
+            const existing = await readSidecarRecords(sidecarPath);
+            const record = {
+                id: nextNegativeTurnId(existing),
+                type: "reference",
+                text: turn.text ?? "",
+                ts: turn.ts ?? nowISO(),
+                ...(turn.tool !== undefined ? { tool: turn.tool } : {}),
+                ...(turn.section !== undefined ? { section: turn.section } : {}),
+                ...(turn.source !== undefined ? { source: turn.source } : {}),
+                // LAST for the POINTER records' sake. It buys the doc record nothing: a
+                // doc turn has `ref === undefined`, so this spread contributes no key
+                // wherever it sits, and the pre-union key order survives by that absence
+                // rather than by this position. What the position DOES fix is the pointer
+                // records' own layout — `ref` always trails `section`/`source`, so every
+                // file/node turn serializes its keys in one stable order.
+                ...(turn.ref !== undefined ? { ref: turn.ref } : {}),
+            };
+            await appendRecords(sidecarPath, [record]);
+        });
+    }
+    catch {
+        // Failed append is a swallowed no-op.
+    }
+}
+/**
+ * Appends an ARCS-authored user/assistant turn (sent to the session from the
+ * web UI) to the sidecar under the same sessions/.store lock the session store
+ * and the other sidecar writers use, so appends serialize with index mutations
+ * and reference appends. A failed append is a swallowed no-op. The id is
+ * minted from the shared ARCS-authored negative space so it can never collide
+ * with a reference turn — both render through <TurnRow key={t.id}>.
+ *
+ * `tool` and `run` ride through verbatim: they are what a run's event-log
+ * fold-down writes (one turn per `tool_use`, every turn tagged with the run
+ * whose log produced it — see web-server/run-event-log.ts).
+ */
+export async function appendSessionTurn(projectDir, normalizedId, turn) {
+    try {
+        await ensureDir(join(projectDir, "sessions"));
+        await withLock(sessionStoreLockPath(projectDir), async () => {
+            const sidecarPath = sessionTranscriptPath(projectDir, normalizedId);
+            const existing = await readSidecarRecords(sidecarPath);
+            const record = {
+                id: nextNegativeTurnId(existing),
+                type: turn.type,
+                text: turn.text,
+                ...(turn.ts !== undefined ? { ts: turn.ts } : {}),
+                ...(turn.tool !== undefined ? { tool: turn.tool } : {}),
+                ...(turn.run !== undefined ? { run: turn.run } : {}),
+            };
+            await appendRecords(sidecarPath, [record]);
+        });
+    }
+    catch {
+        // Failed append is a swallowed no-op.
+    }
+}
+/**
+ * Reads the sidecar for the GET route, skipping malformed lines. Returns an
+ * empty array when the sidecar is missing. Never throws.
+ */
+export async function readSessionTurns(projectDir, normalizedId) {
+    try {
+        return await readSidecarRecords(sessionTranscriptPath(projectDir, normalizedId));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=claude-transcript.js.map

package/dist/utils/claude-transcript.js.map

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

package/dist/utils/diagram-generator.d.ts

@@ -1,4 +1,4 @@
-import type { TaskMeta } from "./project-memory.js";
+import { type TaskMeta } from "./task-store.js";
 export interface DiagramNode {
     nodeId: string;
     taskId: string;

package/dist/utils/diagram-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-generator.d.ts","sourceRoot":"","sources":["../../src/utils/diagram-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAwHjG"}
+{"version":3,"file":"diagram-generator.d.ts","sourceRoot":"","sources":["../../src/utils/diagram-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAyHjG"}

package/dist/utils/diagram-generator.js

@@ -1,3 +1,4 @@
+import { normalizeTaskWorkMetadata } from "./task-store.js";
 /**
  * Generates a Mermaid .mmd diagram from plan tasks.
  * Node IDs assigned T001+ in stable task.id order (a.id.localeCompare(b.id)).
@@ -55,12 +56,12 @@ export function generateDiagramFromTasks(planId, tasks) {
     lines.push(`%% next-action: Start first backlog task`, "");
     for (let i = 0; i < nodes.length; i++) {
         const node = nodes[i];
-        const t = sorted[i];
+        const t = normalizeTaskWorkMetadata(sorted[i]);
         const deps = t.dependsOn ?? [];
         const blockedBy = deps
             .map((depId) => taskIdToNodeId.get(depId))
             .filter((n) => n !== undefined);
-        lines.push(`%% node: ${node.nodeId}`, `%% title: ${t.title}`, `%% status: ${t.status}`, `%% skill: ${t.skill ?? "quick-dev"}`, `%% scope: ${t.scope ?? "(TBD)"}`);
+        lines.push(`%% node: ${node.nodeId}`, `%% title: ${t.title}`, `%% status: ${t.status}`, `%% skill: ${t.skill ?? "implementation"}`, `%% work-mode: ${t.workMode ?? "bounded"}`, `%% scope: ${t.scope ?? "(TBD)"}`);
         if (t.sourceFiles && t.sourceFiles.length > 0) {
             const filesStr = t.sourceFiles
                 .map((f) => (f.anchor ? `${f.path}:${f.anchor}` : f.path))