@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/core/run-config-reader.js

@@ -0,0 +1,362 @@
+/*
+ * Read `<projectPath>/shipwright_run_config.json` and return a typed view.
+ *
+ * The orchestrator writes the file atomically (rename), but on Windows the
+ * brief rename window can still produce EBUSY/EPERM/EACCES, and a polling
+ * reader can momentarily catch a partial parse if filesystem caching lags.
+ * Mitigations:
+ *   - Retry 3 times with 50/150/450 ms backoff on SyntaxError + EBUSY /
+ *     EPERM / EACCES (mirrors core/session-watcher.ts torn-read budget but
+ *     shorter, since the file is small and rotates fast). The SAME retry
+ *     envelope covers the existence stat probe, not just the read (F15).
+ *   - Fall back to a per-path last-good cache (30s TTL — comfortably above
+ *     the 5s client poll cadence, F15) so a torn read never produces an
+ *     `invalid` flap visible to the UI.
+ *
+ * Per-row fault isolation for `phase_tasks[]`: a malformed row is dropped
+ * AND surfaced via `diagnostics.droppedPhaseTaskIds[]` — silent drop hides
+ * orchestrator-state corruption (review O #13). The whole file is still
+ * accepted so downstream UI shows the run with a "N entries unreadable"
+ * banner instead of a blank screen.
+ *
+ * v1 detection: `schemaVersion` missing OR === 1 (the framework hard-cuts
+ * v1 in its phase-lifecycle subcommands; webui treats it as legacy-flat
+ * and renders today's pre-pipeline UI).
+ */
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { isRetryableTornRead, parseRunMode, PHASE_TASK_ID_PATTERN, retryTornRead, RUN_CONFIG_RETRY_DELAYS_MS, RUN_ID_PATTERN, RUN_PHASES, SESSION_UUID_PATTERN, SLASH_COMMAND_PATTERN, } from "../types/run-config-v2.js";
+const RUN_CONFIG_FILENAME = "shipwright_run_config.json";
+// TTL is held comfortably ABOVE the client poll cadence (5s) so a single torn
+// poll never expires the cache at fallback time — the root of F15's flap.
+const LAST_GOOD_TTL_MS = 30_000;
+const lastGoodCache = new Map();
+/**
+ * Serve the per-path last-good cache when still within TTL (else null). A
+ * single torn stat/read/parse during the orchestrator's atomic-rename window
+ * must never surface as `invalid` and latch the client poll OFF (F15).
+ */
+function serveLastGood(path, now, warning) {
+    const cached = lastGoodCache.get(path);
+    if (!cached || cached.expiresAt <= now())
+        return null;
+    return {
+        ...cached.result,
+        diagnostics: {
+            ...cached.result.diagnostics,
+            warnings: [...cached.result.diagnostics.warnings, warning],
+        },
+    };
+}
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+export async function readRunConfig(projectPath, deps = {}) {
+    const path = join(projectPath, RUN_CONFIG_FILENAME);
+    const fsRead = deps.readFile ?? ((p) => readFile(p, "utf-8"));
+    const fsStat = deps.stat ??
+        (async (p) => {
+            try {
+                const s = await stat(p);
+                return { mtimeMs: s.mtimeMs };
+            }
+            catch (err) {
+                const code = err?.code;
+                if (code === "ENOENT")
+                    return null;
+                throw err;
+            }
+        });
+    const wait = deps.sleep ?? sleep;
+    const now = deps.now ?? (() => Date.now());
+    // Existence probe — retry a Windows rename-window fault (EPERM/EBUSY/EACCES)
+    // exactly like the read path; ENOENT resolves to null (stable state, no
+    // retry). On exhaustion serve last-good so a transient stat fault never
+    // flaps the lane to `invalid` and latches the client poll OFF (F15).
+    const statAttempt = await retryTornRead(() => fsStat(path), wait);
+    if (!statAttempt.ok) {
+        return (serveLastGood(path, now, `stat retried and served last-good cache: ${stringifyErr(statAttempt.error)}`) ??
+            { status: "invalid", reason: `stat failed: ${stringifyErr(statAttempt.error)}` });
+    }
+    const st = statAttempt.value;
+    if (st === null)
+        return { status: "missing" };
+    // Read with retry budget (EBUSY/EPERM/EACCES → retry); on exhaustion fall
+    // back to the last-good cache within TTL.
+    const readAttempt = await retryTornRead(() => fsRead(path), wait);
+    if (!readAttempt.ok) {
+        return (serveLastGood(path, now, `read retried and served last-good cache: ${stringifyErr(readAttempt.error)}`) ??
+            { status: "invalid", reason: `read failed: ${stringifyErr(readAttempt.error)}` });
+    }
+    const raw = readAttempt.value;
+    // Parse with retry budget on SyntaxError (torn-read mid-rename window).
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        if (isRetryableTornRead(err)) {
+            // One more re-read pass for SyntaxError specifically — orchestrator's
+            // atomic write window is short.
+            for (let attempt = 0; attempt < RUN_CONFIG_RETRY_DELAYS_MS.length; attempt++) {
+                await wait(RUN_CONFIG_RETRY_DELAYS_MS[attempt] ?? 0);
+                try {
+                    const reread = await fsRead(path);
+                    parsed = JSON.parse(reread);
+                    break;
+                }
+                catch {
+                    // keep going
+                }
+            }
+            if (parsed === undefined) {
+                return (serveLastGood(path, now, "torn read on JSON parse; served last-good cache") ??
+                    { status: "invalid", reason: "torn JSON read on retry" });
+            }
+        }
+        else {
+            return { status: "invalid", reason: `parse failed: ${stringifyErr(err)}` };
+        }
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return { status: "invalid", reason: "top-level is not an object" };
+    }
+    const top = parsed;
+    const sv = top.schemaVersion;
+    if (sv === undefined || sv === null || sv === 1)
+        return { status: "v1_legacy" };
+    if (sv !== 2)
+        return { status: "invalid", reason: `schemaVersion ${String(sv)} not supported` };
+    const validation = validateRunConfigV2(top);
+    if (validation.status === "invalid")
+        return validation;
+    const result = {
+        status: "ok",
+        config: validation.config,
+        diagnostics: validation.diagnostics,
+    };
+    lastGoodCache.set(path, {
+        expiresAt: now() + LAST_GOOD_TTL_MS,
+        result,
+    });
+    return result;
+}
+/** Test helper — drops the per-path last-good cache. */
+export function clearRunConfigReaderCache() {
+    lastGoodCache.clear();
+}
+// ---------------- validation ----------------
+function validateRunConfigV2(top) {
+    const runId = top.runId;
+    if (typeof runId !== "string" || !RUN_ID_PATTERN.test(runId)) {
+        return { status: "invalid", reason: "runId missing or malformed" };
+    }
+    const status = top.status;
+    if (!isRunStatus(status)) {
+        return { status: "invalid", reason: `status ${JSON.stringify(status)} not recognized` };
+    }
+    const scope = top.scope;
+    if (scope !== "full_app" && scope !== "extension") {
+        return { status: "invalid", reason: `scope ${JSON.stringify(scope)} not recognized` };
+    }
+    const autonomy = top.autonomy;
+    if (autonomy !== "guided" && autonomy !== "autonomous") {
+        return { status: "invalid", reason: `autonomy ${JSON.stringify(autonomy)} not recognized` };
+    }
+    if (typeof top.deploy_target !== "string") {
+        return { status: "invalid", reason: "deploy_target missing" };
+    }
+    const pipeline = top.pipeline;
+    if (!Array.isArray(pipeline) || !pipeline.every(isRunPhase)) {
+        return { status: "invalid", reason: "pipeline must be an array of valid phases" };
+    }
+    const runConditions = validateRunConditions(top.runConditions);
+    if (runConditions === null) {
+        return { status: "invalid", reason: "runConditions malformed" };
+    }
+    const splits_frozen = Array.isArray(top.splits_frozen)
+        ? top.splits_frozen.filter((v) => typeof v === "string")
+        : null;
+    if (splits_frozen === null) {
+        return { status: "invalid", reason: "splits_frozen must be an array of strings" };
+    }
+    const completedRaw = top.completed_phase_task_ids;
+    if (!Array.isArray(completedRaw) ||
+        !completedRaw.every((v) => typeof v === "string" && PHASE_TASK_ID_PATTERN.test(v))) {
+        return {
+            status: "invalid",
+            reason: "completed_phase_task_ids must be an array of phaseTaskId strings",
+        };
+    }
+    const completed_phase_task_ids = completedRaw;
+    if (typeof top.created_at !== "string") {
+        return { status: "invalid", reason: "created_at missing" };
+    }
+    // mode: parsed by parseRunMode (kept next to the RunMode type — this reader
+    // is at its bloat ceiling). Unrecognised → dropped + warned, never rejects.
+    const { mode, warnings } = parseRunMode(top.mode);
+    const phaseTasksRaw = top.phase_tasks;
+    if (!Array.isArray(phaseTasksRaw)) {
+        return { status: "invalid", reason: "phase_tasks must be an array" };
+    }
+    const droppedPhaseTaskIds = [];
+    const phase_tasks = [];
+    for (let i = 0; i < phaseTasksRaw.length; i++) {
+        const row = phaseTasksRaw[i];
+        const validated = validatePhaseTask(row);
+        if (validated === null) {
+            const candidateId = row && typeof row === "object" && "phaseTaskId" in row
+                ? String(row.phaseTaskId)
+                : `index_${i}`;
+            droppedPhaseTaskIds.push(candidateId);
+            continue;
+        }
+        phase_tasks.push(validated);
+    }
+    const config = {
+        schemaVersion: 2,
+        runId,
+        scope: scope,
+        profile: typeof top.profile === "string" ? top.profile : top.profile === null ? null : undefined,
+        autonomy: autonomy,
+        deploy_target: top.deploy_target,
+        pipeline: pipeline,
+        runConditions,
+        splits_frozen,
+        status,
+        completed_phase_task_ids,
+        phase_tasks,
+        created_at: top.created_at,
+    };
+    if (mode !== undefined)
+        config.mode = mode;
+    if (typeof top.updated_at === "string")
+        config.updated_at = top.updated_at;
+    if (top.phase_history && typeof top.phase_history === "object" && !Array.isArray(top.phase_history)) {
+        config.phase_history = top.phase_history;
+    }
+    if (Array.isArray(top.iterate_history))
+        config.iterate_history = top.iterate_history;
+    if (Array.isArray(top.validation_issues))
+        config.validation_issues = top.validation_issues;
+    if (Array.isArray(top.validation_notes))
+        config.validation_notes = top.validation_notes;
+    return {
+        status: "ok",
+        config,
+        diagnostics: { droppedPhaseTaskIds, warnings },
+    };
+}
+function validateRunConditions(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const r = raw;
+    if (typeof r.securityEnabled !== "boolean")
+        return null;
+    if (typeof r.aikidoClientIdPresent !== "boolean")
+        return null;
+    let splitMode;
+    if (r.splitMode === null || r.splitMode === undefined) {
+        splitMode = null;
+    }
+    else if (r.splitMode === "none" || r.splitMode === "per_split") {
+        splitMode = r.splitMode;
+    }
+    else {
+        return null;
+    }
+    return {
+        securityEnabled: r.securityEnabled,
+        aikidoClientIdPresent: r.aikidoClientIdPresent,
+        splitMode,
+    };
+}
+function validatePhaseTask(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const r = raw;
+    if (typeof r.phaseTaskId !== "string" || !PHASE_TASK_ID_PATTERN.test(r.phaseTaskId))
+        return null;
+    if (!isRunPhase(r.phase))
+        return null;
+    if (!(typeof r.splitId === "string" || r.splitId === null))
+        return null;
+    if (typeof r.sessionUuid !== "string" || !SESSION_UUID_PATTERN.test(r.sessionUuid))
+        return null;
+    if (typeof r.version !== "number" || !Number.isInteger(r.version) || r.version < 1)
+        return null;
+    if (!isPhaseTaskStatus(r.status))
+        return null;
+    if (typeof r.title !== "string")
+        return null;
+    if (typeof r.slashCommand !== "string" || !SLASH_COMMAND_PATTERN.test(r.slashCommand))
+        return null;
+    if (!Array.isArray(r.prerequisites) ||
+        !r.prerequisites.every((p) => typeof p === "string" && PHASE_TASK_ID_PATTERN.test(p))) {
+        return null;
+    }
+    if (typeof r.executionCount !== "number" || !Number.isInteger(r.executionCount) || r.executionCount < 0) {
+        return null;
+    }
+    if (typeof r.createdAt !== "string")
+        return null;
+    // Defensive: plan/build phases CAN have splitId; everyone else must be null.
+    // The schema's allOf enforces this; we mirror the constraint to drop bad rows.
+    if (r.splitId !== null && r.phase !== "plan" && r.phase !== "build")
+        return null;
+    const out = {
+        phaseTaskId: r.phaseTaskId,
+        phase: r.phase,
+        splitId: r.splitId,
+        sessionUuid: r.sessionUuid,
+        version: r.version,
+        status: r.status,
+        title: r.title,
+        slashCommand: r.slashCommand,
+        prerequisites: r.prerequisites,
+        executionCount: r.executionCount,
+        createdAt: r.createdAt,
+    };
+    if (typeof r.description === "string")
+        out.description = r.description;
+    if (typeof r.launchCommandHint === "string")
+        out.launchCommandHint = r.launchCommandHint;
+    if (typeof r.claimedBySessionUuid === "string" || r.claimedBySessionUuid === null) {
+        out.claimedBySessionUuid = r.claimedBySessionUuid;
+    }
+    if (typeof r.claimAttemptedAt === "string" || r.claimAttemptedAt === null) {
+        out.claimAttemptedAt = r.claimAttemptedAt;
+    }
+    if (typeof r.awaitingLaunchAt === "string" || r.awaitingLaunchAt === null) {
+        out.awaitingLaunchAt = r.awaitingLaunchAt;
+    }
+    if (typeof r.startedAt === "string" || r.startedAt === null)
+        out.startedAt = r.startedAt;
+    if (typeof r.completedAt === "string" || r.completedAt === null)
+        out.completedAt = r.completedAt;
+    if (r.result && typeof r.result === "object" && !Array.isArray(r.result)) {
+        out.result = r.result;
+    }
+    else if (r.result === null) {
+        out.result = null;
+    }
+    if (Array.isArray(r.errors) && r.errors.every((e) => typeof e === "string")) {
+        out.errors = r.errors;
+    }
+    return out;
+}
+function isRunPhase(v) {
+    return typeof v === "string" && RUN_PHASES.includes(v);
+}
+function isRunStatus(v) {
+    return v === "in_progress" || v === "complete" || v === "failed" || v === "needs_validation";
+}
+function isPhaseTaskStatus(v) {
+    return v === "backlog" || v === "awaiting_launch" || v === "in_progress" || v === "done" || v === "failed" || v === "skipped";
+}
+function stringifyErr(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=run-config-reader.js.map

package/server/dist/core/run-config-reader.js.map

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

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

@@ -0,0 +1,60 @@
+import { type PhaseTransition, type RunProjection, type RunTests } from "./event-log-reader.js";
+import type { AggregatedPhase, GateState, GradeSnapshot, PhaseDuration, ReadRunDataOptions, RunDataBundle, RunDataJoin, RunGates } from "./run-data-types.js";
+export * from "./run-data-types.js";
+/**
+ * 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 declare function deriveTestGate(tests: RunTests | null, ts: string | null): GateState;
+/**
+ * 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 declare function deriveGates(run: RunProjection): RunGates | null;
+/**
+ * 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 declare function projectPhaseDurations(phaseTimings: unknown): PhaseDuration[] | null;
+/** Build the per-run join from one A01 `RunProjection`. */
+export declare function joinRunData(run: RunProjection): RunDataJoin;
+/**
+ * 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 declare function aggregatePhaseTransitions(transitions: PhaseTransition[]): AggregatedPhase[];
+/**
+ * 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 declare function projectGradeTrend(lines: Iterable<string>): GradeSnapshot[];
+/**
+ * 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 declare function projectRunData(lines: string[], opts?: ReadRunDataOptions): RunDataBundle;
+/**
+ * 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 declare function readRunData(projectRoot: string, opts?: ReadRunDataOptions): RunDataBundle;
+/**
+ * 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 declare function readRunDetail(projectRoot: string, runId: string): RunDataJoin | null;
+//# sourceMappingURL=run-data-join.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-data-join.d.ts","sourceRoot":"","sources":["../../src/core/run-data-join.ts"],"names":[],"mappings":"AAwBA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,aAAa,EACb,aAAa,EAEb,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,cAAc,qBAAqB,CAAC;AAuBpC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ,GAAG,IAAI,CAQ/D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,IAAI,CAenF;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CAoB3D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,eAAe,EAAE,GAC7B,eAAe,EAAE,CAqDnB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,aAAa,EAAE,CAqB1E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,kBAAuB,GAC5B,aAAa,CAUf;AAaD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,kBAAuB,GAC5B,aAAa,CAWf;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,WAAW,GAAG,IAAI,CAIpB"}