@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/core/run-data-join.js

@@ -0,0 +1,264 @@
+/*
+ * run-data-join.ts — per-run data join over A01's tolerant event projection
+ * (A02, campaign webui-wow-usability-2026-07-10). Read-only, stateless, tolerant.
+ *
+ * Consumes `event-log-reader.ts` (A01) and turns each `work_completed` run into
+ * the shape Mission Control / the Ship's-Log / the board render, plus a
+ * grade-trend series folded from `grade_snapshot` events (which A01 skips). An
+ * absent/unreadable log → an empty bundle, an unknown `runId` → `null`, NEVER a
+ * throw or a 500.
+ *
+ * Honesty (spec AC3), enforced structurally:
+ *   - `phaseDurations` comes ONLY from a run's own `phase_timings` (absent →
+ *     `null`); pipeline transitions are aggregated by (phase, splitId) project-wide, never pinned to one run.
+ *   - Durations are never synthesized/interpolated/estimated/back-filled.
+ *   - Gates are DERIVED (`derived: true`, no `gate_verdict` object exists); only
+ *     `test` carries a real per-run signal today. Current grade is NOT re-derived
+ *     here — that stays with `compliance-reader.ts`; this file adds the trend.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { recordsFromLines } from "./jsonl-records.js";
+import { pathGuard } from "./path-guard.js";
+import { deriveTestsGate } from "./tests-gate.js";
+import { EVENT_FILE, projectEventLog, } from "./event-log-reader.js";
+export * from "./run-data-types.js";
+function tsEpoch(ts) {
+    if (typeof ts !== "string" || !ts)
+        return -Infinity;
+    const t = Date.parse(ts);
+    return Number.isFinite(t) ? t : -Infinity;
+}
+function asString(v) {
+    return typeof v === "string" ? v : null;
+}
+function asFiniteNumberOrNull(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+/** Lowercase-normalize `spec_impact` (none/modify/add/remove); null when absent. */
+function normalizeSpecImpact(raw) {
+    if (raw === null)
+        return null;
+    const t = raw.trim().toLowerCase();
+    return t.length > 0 ? t : null;
+}
+/**
+ * The test gate from a run's own tests, delegating to the single epoch-aware
+ * predicate (`tests-gate.ts`, iterate-2026-08-08-tests-total-skip-contract) —
+ * `ts` resolves which convention (`total` = executed vs. collected) applies.
+ */
+export function deriveTestGate(tests, ts) {
+    return deriveTestsGate(tests, ts);
+}
+/**
+ * DERIVED gate lamps for a run. Returns `null` when nothing is derivable (no
+ * tests). `derived: true` is permanent — never an authoritative verdict.
+ * `review`/`security` have no per-run signal in the event log today → "unknown".
+ */
+export function deriveGates(run) {
+    if (!run.tests)
+        return null;
+    return {
+        derived: true,
+        test: deriveTestGate(run.tests, run.ts),
+        review: "unknown",
+        security: "unknown",
+    };
+}
+/**
+ * Project a run's `phase_timings` (the iterate flat mark-list) into normalized
+ * `PhaseDuration[]`, or `null` when absent/empty/malformed (the honest n/a
+ * signal). Each mark's `startedAt`/`durationMs` is read THROUGH — a mark missing
+ * either is preserved as `null`, never back-filled. NEVER synthesized.
+ */
+export function projectPhaseDurations(phaseTimings) {
+    if (!Array.isArray(phaseTimings) || phaseTimings.length === 0)
+        return null;
+    const out = [];
+    for (const raw of phaseTimings) {
+        if (typeof raw !== "object" || raw === null)
+            continue;
+        const o = raw;
+        const phase = asString(o.phase);
+        if (phase === null)
+            continue; // a mark with no phase name is unusable
+        out.push({
+            phase,
+            startedAt: asString(o.started) ?? asString(o.startedAt),
+            durationMs: asFiniteNumberOrNull(o.duration_ms ?? o.durationMs),
+        });
+    }
+    return out.length > 0 ? out : null;
+}
+/** Build the per-run join from one A01 `RunProjection`. */
+export function joinRunData(run) {
+    return {
+        runId: run.runId,
+        ts: run.ts,
+        source: run.source,
+        intent: run.intent,
+        changeType: run.changeType,
+        summary: run.summary,
+        description: run.description,
+        commit: run.commit,
+        specImpact: normalizeSpecImpact(run.specImpact),
+        specImpactRaw: run.specImpact,
+        affectedFrs: run.affectedFrs,
+        newFrs: run.newFrs,
+        tests: run.tests,
+        gates: deriveGates(run),
+        phaseDurations: projectPhaseDurations(run.phaseTimings),
+        campaign: run.campaign,
+        subIterateId: run.subIterateId,
+    };
+}
+/**
+ * Aggregate pipeline `phase_started`/`phase_completed` transitions by
+ * (phase, splitId). PROJECT-level ONLY — transitions carry no run-join key, so
+ * this is never attributed to a single run. A phase may have MULTIPLE splits
+ * (monorepo #369): each split is paired independently (start→end), and the
+ * phase `totalMs` sums the computable split durations (`phase_failed` also
+ * closes a split); `complete` is true only when every split paired.
+ */
+export function aggregatePhaseTransitions(transitions) {
+    // phase -> splitId -> accumulator, insertion-ordered. A JS Map keys `null`
+    // distinctly from any string, so a null splitId gets its own bucket without a
+    // sentinel (a string sentinel could collide with a real splitId value).
+    const byPhase = new Map();
+    for (const t of transitions) {
+        if (t.phase === null)
+            continue;
+        if (t.type !== "phase_started" && t.type !== "phase_completed" && t.type !== "phase_failed") {
+            continue;
+        }
+        let splits = byPhase.get(t.phase);
+        if (!splits) {
+            splits = new Map();
+            byPhase.set(t.phase, splits);
+        }
+        let acc = splits.get(t.splitId);
+        if (!acc) {
+            acc = { splitId: t.splitId, startedAt: null, completedAt: null, durationMs: null };
+            splits.set(t.splitId, acc);
+        }
+        if (t.type === "phase_started") {
+            acc.startedAt = t.ts ?? acc.startedAt;
+        }
+        else {
+            // phase_completed | phase_failed both close the split (last end wins).
+            acc.completedAt = t.ts ?? acc.completedAt;
+        }
+    }
+    const out = [];
+    for (const [phase, splits] of byPhase) {
+        const splitList = [];
+        let total = 0;
+        let anyDuration = false;
+        let complete = true;
+        for (const acc of splits.values()) {
+            const s = tsEpoch(acc.startedAt);
+            const e = tsEpoch(acc.completedAt);
+            const paired = Number.isFinite(s) && Number.isFinite(e) && acc.startedAt !== null && acc.completedAt !== null;
+            // A negative interval (end before start) is a corrupt pair → honest null.
+            acc.durationMs = paired && e - s >= 0 ? e - s : null;
+            if (acc.durationMs !== null) {
+                total += acc.durationMs;
+                anyDuration = true;
+            }
+            else {
+                complete = false;
+            }
+            splitList.push(acc);
+        }
+        out.push({ phase, splits: splitList, totalMs: anyDuration ? total : null, complete });
+    }
+    return out;
+}
+/**
+ * Fold `grade_snapshot` events into a chronological `[{ts, grade, score}]`
+ * trend. A01's reader intentionally skips this event type, so this pass reads
+ * the raw lines directly (tolerant: a torn line is skipped). Ascending by ts
+ * (oldest→newest, parity with the prototype's `gradeTrend`); unparseable ts is
+ * treated as earliest and kept in file order.
+ */
+export function projectGradeTrend(lines) {
+    const rows = [];
+    let idx = 0;
+    // Shares the record-boundary contract with `projectEventLog` so BOTH passes
+    // over the same bytes agree on how many records a damaged line holds — they
+    // are two independent scans of one file, and disagreeing would be worse than
+    // either behaviour alone (iterate-2026-07-19-events-reader-recovery).
+    for (const o of recordsFromLines(lines)) {
+        const i = idx++;
+        if (o.type !== "grade_snapshot")
+            continue;
+        const grade = asString(o.grade);
+        if (grade === null)
+            continue; // a snapshot with no grade is unusable
+        const ts = asString(o.ts);
+        rows.push({
+            idx: i,
+            key: tsEpoch(ts),
+            snap: { ts, grade, score: asFiniteNumberOrNull(o.score) },
+        });
+    }
+    rows.sort((a, b) => (a.key !== b.key ? a.key - b.key : a.idx - b.idx));
+    return rows.map((r) => r.snap);
+}
+/**
+ * Pure bundle projection over an event log's lines: per-run joins + grade trend
+ * + project-level pipeline phase durations. Reuses A01's `projectEventLog` for
+ * the run dedup + phase transitions. `opts.runId` filters `runs` to one `adr_id`.
+ */
+export function projectRunData(lines, opts = {}) {
+    const projection = projectEventLog(lines, opts);
+    const runs = projection.runs.map(joinRunData);
+    return {
+        runs,
+        runCount: runs.length,
+        gradeTrend: projectGradeTrend(lines),
+        pipelinePhaseDurations: aggregatePhaseTransitions(projection.phaseTransitions),
+        skippedLines: projection.skippedLines,
+    };
+}
+/** Empty (graceful) bundle — an absent/unreadable/guarded-out log. */
+function emptyBundle() {
+    return {
+        runs: [],
+        runCount: 0,
+        gradeTrend: [],
+        pipelinePhaseDurations: [],
+        skippedLines: 0,
+    };
+}
+/**
+ * File-loading wrapper: read `<projectRoot>/shipwright_events.jsonl` ONCE and
+ * project the full bundle. `pathGuard` defends the constant filename; a
+ * missing/unreadable/guarded-out log yields the empty bundle (spec AC1).
+ */
+export function readRunData(projectRoot, opts = {}) {
+    const guard = pathGuard(projectRoot, EVENT_FILE);
+    if (!guard.ok)
+        return emptyBundle();
+    if (!existsSync(guard.absolute))
+        return emptyBundle();
+    let text;
+    try {
+        text = readFileSync(guard.absolute, "utf-8");
+    }
+    catch {
+        return emptyBundle();
+    }
+    return projectRunData(text.split("\n"), opts);
+}
+/**
+ * Detail helper: the single run joined for `runId`, or `null` when no
+ * `work_completed` event carries that `adr_id` (the tested miss-case — spec
+ * AC2). Never throws.
+ */
+export function readRunDetail(projectRoot, runId) {
+    if (!runId)
+        return null;
+    const bundle = readRunData(projectRoot, { runId });
+    return bundle.runs.length > 0 ? bundle.runs[0] : null;
+}
+//# sourceMappingURL=run-data-join.js.map

package/server/dist/core/run-data-join.js.map

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

package/server/dist/core/run-data-types.d.ts

@@ -0,0 +1,126 @@
+import type { RunTests } from "./event-log-types.js";
+export type { RunTests } from "./event-log-types.js";
+/** A derived gate lamp state — NEVER an authoritative producer verdict. */
+export type GateState = "pass" | "fail" | "unknown";
+/**
+ * Gate lamps DERIVED WebUI-side. No `gate_verdict` object exists in the
+ * emitters (backend audit MISSING-2), so these are computed from the run's own
+ * facts and flagged `derived: true` permanently. A consumer MUST render them
+ * as derived, never as a producer verdict. Today only `test` carries a real
+ * signal (the run's own suite); `review`/`security` have no per-run signal in
+ * the event log and stay `"unknown"` until a producer emits an authoritative
+ * verdict.
+ */
+export interface RunGates {
+    derived: true;
+    /**
+     * From the run's own tests, via the epoch-aware `tests-gate.ts` predicate:
+     * pre-reversal `pass` means `passed===total`; post-reversal (>= `REVERSAL_EPOCH_MS`,
+     * 2026-08-08) it means `passed+skipped===total` — the event's own `ts`
+     * decides which convention applies, never both.
+     */
+    test: GateState;
+    /** No per-run review signal in the event log → `"unknown"` today. */
+    review: GateState;
+    /** No per-run security signal in the event log → `"unknown"` today. */
+    security: GateState;
+}
+/**
+ * One projected iterate phase-timing mark, from `work_completed.phase_timings`
+ * (the flat 5-mark list: scope · build · review · test · finalize). Present
+ * per-run and unambiguous. `durationMs`/`startedAt` are read THROUGH — a mark
+ * missing either is preserved as `null`, never back-filled.
+ */
+export interface PhaseDuration {
+    phase: string;
+    startedAt: string | null;
+    durationMs: number | null;
+}
+/**
+ * One (phase, splitId) duration from a pipeline `phase_started`/`phase_completed`
+ * pair. A phase may have MULTIPLE splits (monorepo #369) → multiple ends; each
+ * split is paired independently. `durationMs` is `null` unless BOTH ends parsed.
+ */
+export interface PhaseSplitDuration {
+    splitId: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    durationMs: number | null;
+}
+/**
+ * Pipeline phase durations AGGREGATED by (phase, splitId). PROJECT-LEVEL: the
+ * phase transitions carry no run-join key, so this is NEVER attributed to a
+ * single run — attributing the whole transition array to one run would silently
+ * mis-attribute or drop durations (spec upstream note). A phase with N splits
+ * has N ends: `totalMs` sums the computable ones, `complete` is true only when
+ * every split paired.
+ */
+export interface AggregatedPhase {
+    phase: string;
+    splits: PhaseSplitDuration[];
+    /** Sum of non-null split durations, or `null` when none are computable. */
+    totalMs: number | null;
+    /** true only when every split has a computable duration (both ends parsed). */
+    complete: boolean;
+}
+/** A grade-trend point folded from a `grade_snapshot` event. */
+export interface GradeSnapshot {
+    /** ISO timestamp of the snapshot, or `null` when absent. */
+    ts: string | null;
+    /** Control-grade letter (A / B+ / C- …). */
+    grade: string;
+    /** Numeric score (0-100), or `null` when absent/unparseable. */
+    score: number | null;
+}
+/**
+ * The per-run join: `runId` joined to its FRs, tests, DERIVED gates and iterate
+ * phase-timings. `runId == adr_id == task.runId` (the documented contract). An
+ * unknown `runId` yields `null` upstream (never a throw). Every optional source
+ * field degrades to `null`/`[]`.
+ */
+export interface RunDataJoin {
+    /** The event `adr_id` — the task-join key (`task.runId == adr_id`). */
+    runId: string;
+    ts: string | null;
+    source: string | null;
+    intent: string | null;
+    changeType: string | null;
+    summary: string | null;
+    description: string | null;
+    commit: string | null;
+    /** `spec_impact` normalized to lowercase (none/modify/add/remove); `null` when absent. */
+    specImpact: string | null;
+    /** Raw `spec_impact`, case preserved (the reader's `specImpact`). */
+    specImpactRaw: string | null;
+    affectedFrs: string[];
+    newFrs: string[];
+    tests: RunTests | null;
+    /** DERIVED gates (`derived: true`), or `null` when nothing is derivable. */
+    gates: RunGates | null;
+    /** Iterate phase-timing marks (`phase_timings`), or `null` — render **n/a**. */
+    phaseDurations: PhaseDuration[] | null;
+    campaign: string | null;
+    subIterateId: string | null;
+}
+/**
+ * The full run-data bundle behind the three A02 endpoints. Read once per
+ * request from the project's `shipwright_events.jsonl`; the endpoints pick the
+ * slice they serve. An absent/unreadable log → an empty bundle (graceful).
+ */
+export interface RunDataBundle {
+    /** Per-run joins, latest `work_completed` per `adr_id`, ts-desc. */
+    runs: RunDataJoin[];
+    /** `runs.length` (of the returned, possibly runId-filtered set). */
+    runCount: number;
+    /** `grade_snapshot` trend, chronological ascending; `[]` when absent. */
+    gradeTrend: GradeSnapshot[];
+    /** Pipeline phase durations aggregated by (phase, splitId); PROJECT-level. */
+    pipelinePhaseDurations: AggregatedPhase[];
+    /** Non-empty lines that FAILED to parse (torn/corrupt) — skipped, not fatal. */
+    skippedLines: number;
+}
+export interface ReadRunDataOptions {
+    /** When set, `runs` is filtered to this single `adr_id` (detail view). */
+    runId?: string;
+}
+//# sourceMappingURL=run-data-types.d.ts.map

package/server/dist/core/run-data-types.d.ts.map

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

package/server/dist/core/run-data-types.js

@@ -0,0 +1,25 @@
+/*
+ * run-data-types.ts — shape contract for the per-run data join
+ * (`run-data-join.ts`, A02, campaign webui-wow-usability-2026-07-10).
+ *
+ * A02 turns A01's raw event projection (`event-log-reader.ts`) into the
+ * per-run shape Mission Control / the Ship's-Log gallery / the board consume:
+ * a run's `runId` (== `task.runId` == `adr_id`) joined to its affected FRs,
+ * test counts, DERIVED gate lamps, iterate phase-timings, plus a grade-trend
+ * series folded from `grade_snapshot` events.
+ *
+ * Honesty is the hard contract (spec AC3):
+ *   - Durations are NEVER synthesized. `phaseDurations` comes back `null` when
+ *     the emitter produced no `phase_timings` (the common case today) — the
+ *     consumer renders `n/a`. Pipeline `phase_started`/`phase_completed` pairs
+ *     are aggregated by (phase, splitId) at PROJECT level; they carry no run
+ *     join key so they are never attributed to a single run.
+ *   - Gate lamps are DERIVED WebUI-side (no `gate_verdict` object exists in the
+ *     emitters) and carry a permanent `derived: true` honesty flag.
+ *
+ * Split out to keep the join body under the 300-LOC ceiling (CLAUDE.md
+ * file-size rule); verbatim-mirrored client-side in `client/src/lib/runDataApi.ts`
+ * (ADR-080 — no cross-package import).
+ */
+export {};
+//# sourceMappingURL=run-data-types.js.map

package/server/dist/core/run-data-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-data-types.js","sourceRoot":"","sources":["../../src/core/run-data-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/server/dist/core/run-loop-state-reader.d.ts

@@ -0,0 +1,27 @@
+import { type RunConfigV2, type RunPhase } from "../types/run-config-v2.js";
+/** The paused-at-human-gate loop status (mirrors LOOP_STATUSES in the framework). */
+export declare const PAUSED_HUMAN_GATE = "paused_human_gate";
+/** The subset of the loop-state file the gate cares about. */
+export interface LoopState {
+    status?: string;
+    currentPhaseTaskId?: string | null;
+    runId?: string;
+}
+export interface DesignGate {
+    /** Paused at the design human-gate AND the viewer exists → show "Review mockups". */
+    active: boolean;
+    /** The paused design phase task id, when active. */
+    phaseTaskId: string | null;
+    phase: RunPhase | null;
+}
+export declare const INACTIVE_DESIGN_GATE: DesignGate;
+export declare function loopStatePath(projectPath: string): string;
+/** Read + parse the loop-state, or null (missing / torn / malformed → no gate). */
+export declare function readLoopState(projectPath: string): LoopState | null;
+/**
+ * Derive the design-gate state from the loop-state + run-config + whether the
+ * emitted viewer exists. Pure — the caller supplies `hasViewer`
+ * (`existsSync(.shipwright/designs/index.html)`).
+ */
+export declare function deriveDesignGate(loopState: LoopState | null, config: RunConfigV2 | null, hasViewer: boolean): DesignGate;
+//# sourceMappingURL=run-loop-state-reader.d.ts.map

package/server/dist/core/run-loop-state-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop-state-reader.d.ts","sourceRoot":"","sources":["../../src/core/run-loop-state-reader.ts"],"names":[],"mappings":"AA2BA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,2BAA2B,CAAC;AAEnC,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAIrD,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,MAAM,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB;AAED,eAAO,MAAM,oBAAoB,EAAE,UAIlC,CAAC;AAEF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAcnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,SAAS,EAAE,OAAO,GACjB,UAAU,CAeZ"}

package/server/dist/core/run-loop-state-reader.js

@@ -0,0 +1,79 @@
+/*
+ * core/run-loop-state-reader.ts — read-only observer of the single-session
+ * orchestrator's loop-state file, for the design-gate affordance
+ * (iterate-2026-07-10-design-gate-review-host, FR-01.45).
+ *
+ * The `/shipwright-run` master records a human-gate PAUSE at the design
+ * `orchestrator-approve` gate by flipping `.shipwright/run_loop_state.json`
+ * (`single_session/loop_state.py`) to `status: "paused_human_gate"`. This is a
+ * SEPARATE file from `shipwright_run_config.json` — the run-config never carries
+ * the gate — so it gets its own reader (run-config-reader.ts is at its bloat
+ * ceiling and stays untouched).
+ *
+ * WebUI is a pure read-only observer here (CLAUDE.md rule 12 / DO-NOT #1): it
+ * never writes the loop-state, run-config, or Claude JSONL. A missing / torn /
+ * malformed loop-state simply reports "no gate" — never a throw.
+ *
+ * `deriveDesignGate` is pure so it unit-tests without the filesystem; the gate
+ * is active ONLY when the loop is paused at a human gate AND its current phase
+ * task is the `design` phase AND the emitted viewer exists on disk. That triple
+ * predicate is the anti-staleness guard: the moment the master resumes it flips
+ * the loop off `paused_human_gate`, so a lingering `index.html` cannot resurrect
+ * the button.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { TERMINAL_PHASE_TASK_STATUSES, } from "../types/run-config-v2.js";
+/** The paused-at-human-gate loop status (mirrors LOOP_STATUSES in the framework). */
+export const PAUSED_HUMAN_GATE = "paused_human_gate";
+const LOOP_STATE_REL = path.join(".shipwright", "run_loop_state.json");
+export const INACTIVE_DESIGN_GATE = {
+    active: false,
+    phaseTaskId: null,
+    phase: null,
+};
+export function loopStatePath(projectPath) {
+    return path.join(projectPath, LOOP_STATE_REL);
+}
+/** Read + parse the loop-state, or null (missing / torn / malformed → no gate). */
+export function readLoopState(projectPath) {
+    let raw;
+    try {
+        raw = readFileSync(loopStatePath(projectPath), "utf-8");
+    }
+    catch {
+        return null; // ENOENT (no single-session run) or a transient read error.
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object")
+            return parsed;
+        return null;
+    }
+    catch {
+        return null; // torn write mid-read — the next poll retries.
+    }
+}
+/**
+ * Derive the design-gate state from the loop-state + run-config + whether the
+ * emitted viewer exists. Pure — the caller supplies `hasViewer`
+ * (`existsSync(.shipwright/designs/index.html)`).
+ */
+export function deriveDesignGate(loopState, config, hasViewer) {
+    if (!loopState || loopState.status !== PAUSED_HUMAN_GATE) {
+        return INACTIVE_DESIGN_GATE;
+    }
+    const phaseTaskId = loopState.currentPhaseTaskId ?? null;
+    if (!phaseTaskId || !config)
+        return INACTIVE_DESIGN_GATE;
+    const pt = config.phase_tasks.find((t) => t.phaseTaskId === phaseTaskId);
+    if (!pt || pt.phase !== "design")
+        return INACTIVE_DESIGN_GATE;
+    // Belt-and-suspenders anti-staleness (plan review R8): a design task that has
+    // already reached a terminal status cannot be at a live human gate, even if a
+    // torn loop-state momentarily still reads paused.
+    if (TERMINAL_PHASE_TASK_STATUSES.includes(pt.status))
+        return INACTIVE_DESIGN_GATE;
+    return { active: hasViewer, phaseTaskId, phase: pt.phase };
+}
+//# sourceMappingURL=run-loop-state-reader.js.map

package/server/dist/core/run-loop-state-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-loop-state-reader.js","sourceRoot":"","sources":["../../src/core/run-loop-state-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,4BAA4B,GAG7B,MAAM,2BAA2B,CAAC;AAEnC,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;AAiBvE,MAAM,CAAC,MAAM,oBAAoB,GAAe;IAC9C,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,IAAI;IACjB,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAChD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,4DAA4D;IAC3E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAmB,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAA2B,EAC3B,MAA0B,EAC1B,SAAkB;IAElB,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACzD,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,MAAM,WAAW,GAAG,SAAS,CAAC,kBAAkB,IAAI,IAAI,CAAC;IACzD,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM;QAAE,OAAO,oBAAoB,CAAC;IAEzD,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IACzE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,oBAAoB,CAAC;IAC9D,8EAA8E;IAC9E,8EAA8E;IAC9E,kDAAkD;IAClD,IAAI,4BAA4B,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAElF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;AAC7D,CAAC"}

package/server/dist/core/sdk-sessions-merge.d.ts

@@ -0,0 +1,60 @@
+import type { ExternalTask } from "./sdk-sessions-store.js";
+/** Deep structural equality for JSON-shaped ExternalTask values. */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/** Deep-copy a sessions map so the baseline snapshot can't alias live rows. */
+export declare function cloneSessions(sessions: Map<string, ExternalTask>): Map<string, ExternalTask>;
+/**
+ * Merge this instance's local changes (baseline → memory) onto the current
+ * on-disk state (disk). `deleted` is the set of ids this instance removed since
+ * baseline — they are dropped UNCONDITIONALLY (a delete wins over a concurrent
+ * instance's poll rewrite; taskIds are random UUIDs, never reused). Returns a
+ * fresh map; the inputs are never mutated.
+ */
+export declare function mergeSessions(baseline: Map<string, ExternalTask>, memory: Map<string, ExternalTask>, disk: Map<string, ExternalTask>, deleted: ReadonlySet<string>): Map<string, ExternalTask>;
+export type DiskReadResult = {
+    kind: "ok";
+    disk: Map<string, ExternalTask>;
+} | {
+    kind: "corrupt";
+} | {
+    kind: "future";
+};
+/**
+ * Classify the on-disk bytes for a merge re-read (pure; no side effects). Empty
+ * / whitespace is a legitimately-empty store. Corrupt = unparseable JSON, a
+ * non-object root, a malformed `sessions`, or a non-integer / < 1 schemaVersion.
+ * Future = valid JSON whose integer schemaVersion is GREATER than this build's.
+ */
+export declare function classifyDiskRaw(raw: string, current: number): {
+    kind: "ok";
+    schemaVersion: 1 | 2 | 3 | 4;
+    sessions: Record<string, unknown>;
+} | {
+    kind: "corrupt";
+} | {
+    kind: "future";
+};
+/**
+ * Re-read + classify + validate the on-disk file for a persist merge. A missing
+ * file / ENOENT is an empty store; a TRANSIENT read error (EBUSY/EPERM/EACCES)
+ * is retried, then re-thrown (the caller must reject, NOT full-write — that
+ * would clobber a concurrent instance's rows). Returns "corrupt"/"future" for
+ * the caller to recover / abort. Reuses the store's row validator (injected to
+ * avoid a store↔merge import cycle).
+ */
+export declare function reReadDisk(deps: {
+    existsSync: (p: string) => boolean;
+    readFile: (p: string, e: string) => Promise<string>;
+}, path: string, current: number, validate: (id: string, value: unknown, schemaVersion: 1 | 2 | 3 | 4) => ExternalTask | null): Promise<DiskReadResult>;
+/**
+ * Atomic write: stage to a unique `<path>.tmp-*` (a mid-write crash lands there,
+ * never truncating the live file) then rename it into place — using the
+ * injected `rename`, else the fs default when a lock is held (real fs), with the
+ * EBUSY/EPERM/EACCES retry + best-effort temp cleanup. Lock-less test doubles
+ * (no injected rename) fall back to an in-place write of the SAME payload.
+ */
+export declare function atomicWriteFile(deps: {
+    writeFile: (path: string, data: string) => Promise<void>;
+    rename?: (from: string, to: string) => Promise<void>;
+}, path: string, data: string, hasLock: boolean): Promise<void>;
+//# sourceMappingURL=sdk-sessions-merge.d.ts.map

package/server/dist/core/sdk-sessions-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-sessions-merge.d.ts","sourceRoot":"","sources":["../../src/core/sdk-sessions-merge.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAK5D,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAkBzD;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAClC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAI3B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACjC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAyB3B;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAEb;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAerB;AAiBD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE;IAAE,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,EACjG,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,YAAY,GAAG,IAAI,GAC1F,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAeD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE;IACJ,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,EACD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAcf"}