@svenroth-ai/shipwright 0.27.0 → 0.29.0

package/server/dist/core/codex-oracle-runner.js

@@ -0,0 +1,124 @@
+/*
+ * core/codex-oracle-runner.ts — the injection-safe bridge to `shared/
+ * scripts/tools/codex_completion_oracle.py` (Codex Light §1.7).
+ *
+ * Mirrors `triage-cli-runner.ts`'s spawn discipline verbatim (same reason:
+ * `uv run --no-project --python ">=3.11"` so the script always runs in a
+ * Python that actually satisfies its own floor, never whichever of
+ * python3/python/py answers `--version` first — see that module's header
+ * for the incident this avoids). `--no-project` matters here too: the
+ * oracle script has no `pyproject.toml` of its own (it's a plain module
+ * under `shared/scripts/tools/`), so an ambient one discovered by walking
+ * up from the SPAWNING PROCESS's cwd must never get silently activated.
+ *
+ * Unlike `grade-runner.ts` / `triage-cli-runner.ts`, the oracle CLI prints
+ * its JSON payload on EVERY exit code (0-3 all carry a verdict; there is no
+ * "non-JSON means engine trouble" branch) — see `codex_completion_oracle.py`
+ * `main()`. This wrapper therefore always attempts to parse stdout first and
+ * only falls back to an engine-unavailable/failed outcome when uv/the
+ * script itself couldn't be resolved or spawned at all.
+ *
+ * Required-CI PR-review finding (PR #466): the spawn pattern was a
+ * verbatim mirror of `triage-cli-runner.ts` (already in production), but
+ * the CADENCE is new — this runs every 60s tick for as long as a task
+ * stays stalled, where the triage call site fires once per user-initiated
+ * transition. `execFile`'s own `timeout` only SIGTERMs the immediate `uv`
+ * child; if `uv run` had already forked a Python grandchild, Node would
+ * not reap that process tree on Windows by default. Fixed (not merely
+ * accepted) via `cli-child-spawn.ts`'s shared tree-kill-on-timeout
+ * wrapper, shared with `triage-cli-runner.ts` so the two can't re-diverge.
+ */
+import { existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { defaultCliChildSpawn } from "./cli-child-spawn.js";
+import { READINESS_REPAIR_COMMAND, shipwrightCacheRoot } from "./readiness-probe.js";
+import { resolveUv } from "./uv-runner.js";
+export const CODEX_ORACLE_TIMEOUT_MS = 30_000;
+export const defaultSpawnOracle = defaultCliChildSpawn;
+/** Resolve the single cache-owned oracle CLI shipped with the Shipwright runtime. */
+export function resolveCodexOracleScript(deps = {}) {
+    const exists = deps.existsFn ?? existsSync;
+    if (deps.scriptOverride)
+        return exists(deps.scriptOverride) ? deps.scriptOverride : null;
+    const candidate = path.join(shipwrightCacheRoot(deps.homeDir ?? os.homedir()), "shared", "scripts", "tools", "codex_completion_oracle.py");
+    return exists(candidate) ? candidate : null;
+}
+function cleanStderr(stderr) {
+    return stderr.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).pop() ?? "";
+}
+const ENGINE_UNAVAILABLE_REASON = "The Codex completion oracle isn't installed.";
+/**
+ * Run `codex_completion_oracle.py --project-root <root> --phase <p>
+ * --session <sid> [--since <iso>]` and parse its JSON verdict. Never
+ * throws for an oracle failure — only a programming error would reject.
+ */
+export async function runCodexOracle(input, deps = {}) {
+    const script = resolveCodexOracleScript(deps);
+    if (!script) {
+        return { kind: "engine-unavailable", reason: ENGINE_UNAVAILABLE_REASON, repairCommand: READINESS_REPAIR_COMMAND };
+    }
+    const uv = await resolveUv({ run: deps.run, homeDir: deps.homeDir, baseEnv: deps.baseEnv });
+    if (!uv) {
+        return {
+            kind: "engine-unavailable",
+            reason: "uv isn't installed — the Codex completion oracle needs it to run in a managed Python 3.11+.",
+            repairCommand: READINESS_REPAIR_COMMAND,
+        };
+    }
+    const spawn = deps.spawn ?? defaultSpawnOracle;
+    const args = [
+        "run",
+        "--no-project",
+        "--python",
+        ">=3.11",
+        script,
+        "--project-root",
+        input.projectRoot,
+        "--phase",
+        input.phase,
+        "--session",
+        input.session,
+        ...(input.since ? ["--since", input.since] : []),
+    ];
+    const result = await spawn(uv.bin, args, {
+        timeoutMs: deps.timeoutMs ?? CODEX_ORACLE_TIMEOUT_MS,
+        env: uv.env,
+    });
+    if (result.code === -1) {
+        return { kind: "engine-unavailable", reason: "uv couldn't start on this machine.", repairCommand: READINESS_REPAIR_COMMAND };
+    }
+    // Every other exit (0-3 documented, anything else a crash) prints JSON on
+    // stdout per the script's own contract — try to parse before giving up.
+    try {
+        const payload = JSON.parse(result.stdout);
+        if ((payload.verdict === "done" ||
+            payload.verdict === "not_done" ||
+            payload.verdict === "delivery_pending" ||
+            payload.verdict === "no_oracle") &&
+            typeof payload.phase === "string" &&
+            typeof payload.session === "string" &&
+            payload.evidence &&
+            typeof payload.evidence === "object") {
+            return {
+                kind: "ok",
+                result: {
+                    verdict: payload.verdict,
+                    phase: payload.phase,
+                    session: payload.session,
+                    evidence: payload.evidence,
+                },
+            };
+        }
+    }
+    catch {
+        /* fall through to the failed branch below */
+    }
+    return {
+        kind: "failed",
+        reason: result.spawnError === "timeout"
+            ? "The completion oracle took too long and was stopped."
+            : cleanStderr(result.stderr) || "The completion oracle returned an unrecognised response.",
+    };
+}
+//# sourceMappingURL=codex-oracle-runner.js.map

package/server/dist/core/codex-oracle-runner.js.map

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

package/server/dist/core/codex-status-report.d.ts

@@ -0,0 +1,6 @@
+export interface ShipwrightStatusReport {
+    phase: string;
+    done: boolean;
+}
+export declare function parseShipwrightStatusReport(text: string): ShipwrightStatusReport | null;
+//# sourceMappingURL=codex-status-report.d.ts.map

package/server/dist/core/codex-status-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-status-report.d.ts","sourceRoot":"","sources":["../../src/core/codex-status-report.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAQD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAiBvF"}

package/server/dist/core/codex-status-report.js

@@ -0,0 +1,40 @@
+/*
+ * core/codex-status-report.ts — §5.4's structured self-report parser.
+ *
+ * Every Codex launch prompt (`launcher-codex.ts buildCodexPrompt`) ends
+ * with an instruction to close with a fenced ```SHIPWRIGHT-STATUS {json}```
+ * block. §5.4 (hard v1 scope, not an "Open item"): "Parsed from terminal
+ * scrollback, cross-checked against the oracle verdict: agreement raises
+ * confidence; disagreement always defers to the oracle. This gives
+ * `no_oracle` phases a real, if weaker, signal."
+ *
+ * Pure parser — no I/O. `CodexTaskWatcher` reads the terminal text (via
+ * `PtyManager.peekTerminalText`'s visible-viewport snapshot, the same
+ * mechanism `appendCodexTerminalSignals` already uses for approval-request
+ * detection) and hands it here.
+ */
+// Matches the exact fence `buildCodexPrompt` instructs Codex to emit. Global
+// so a viewport containing more than one report (e.g. an earlier nudge's
+// echoed instruction text plus a real closing report) is fully scanned —
+// the LAST well-formed match wins, since that's the most recent status.
+const FENCE_RE = /```SHIPWRIGHT-STATUS\s*\r?\n([\s\S]*?)```/g;
+export function parseShipwrightStatusReport(text) {
+    let match;
+    let last = null;
+    FENCE_RE.lastIndex = 0;
+    while ((match = FENCE_RE.exec(text)) !== null) {
+        try {
+            const parsed = JSON.parse(match[1].trim());
+            if (parsed && typeof parsed === "object" && typeof parsed.done === "boolean") {
+                const p = parsed;
+                last = { phase: typeof p.phase === "string" ? p.phase : "", done: p.done };
+            }
+        }
+        catch {
+            // Malformed block (truncated viewport, stray backticks in unrelated
+            // output) — skip it and keep scanning for an earlier well-formed one.
+        }
+    }
+    return last;
+}
+//# sourceMappingURL=codex-status-report.js.map

package/server/dist/core/codex-status-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-status-report.js","sourceRoot":"","sources":["../../src/core/codex-status-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,6EAA6E;AAC7E,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,MAAM,QAAQ,GAAG,4CAA4C,CAAC;AAE9D,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,IAAI,KAA6B,CAAC;IAClC,IAAI,IAAI,GAAkC,IAAI,CAAC;IAC/C,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAQ,MAAkC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC1G,MAAM,CAAC,GAAG,MAAiC,CAAC;gBAC5C,IAAI,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAe,EAAE,CAAC;YACxF,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,sEAAsE;QACxE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/server/dist/core/codex-task-watcher-types.d.ts

@@ -0,0 +1,69 @@
+import type { ExternalTask } from "./sdk-sessions-store.js";
+import type { OracleOutcome, RunCodexOracleInput } from "./codex-oracle-runner.js";
+/** Settings default per §5 (min 5 — Settings enforces the floor, not this module). */
+export declare const DEFAULT_STALL_TIMEOUT_MS: number;
+/** §5.2 launch-confirmation window — distinct from, and shorter than, the
+ *  mid-task stall trigger above. */
+export declare const DEFAULT_LAUNCH_CONFIRM_TIMEOUT_MS: number;
+export type CodexWatcherNoticeKind = "nudge_sent" | "delivery_error" | "no_oracle_unresolved" | "launch_confirmation_failed";
+export interface CodexWatcherNotice {
+    taskId: string;
+    kind: CodexWatcherNoticeKind;
+    detail: string;
+    at: number;
+}
+export interface CodexTaskWatcherStore {
+    list(): ExternalTask[];
+    patch(taskId: string, patch: Partial<ExternalTask>): ExternalTask | undefined;
+    persist(): Promise<void>;
+}
+export interface CodexTaskWatcherPtyManager {
+    getLastDataAt(taskId: string): number | null;
+    attachCount(taskId: string): number;
+    write(taskId: string, data: string): void;
+}
+export interface CodexTaskWatcherDeps {
+    store: CodexTaskWatcherStore;
+    ptyManager: CodexTaskWatcherPtyManager;
+    getProjectById: (id: string) => {
+        path: string;
+    } | undefined;
+    runOracle: (input: RunCodexOracleInput) => Promise<OracleOutcome>;
+    /**
+     * §4 — best-effort, filename-first discovery of a fresh launch's thread
+     * id (`core/codex-thread-discovery.ts`). Optional: omitting it just means
+     * no task ever gets a `threadId`, i.e. `resume` never fires (§4's earlier,
+     * pre-discovery behavior) — tests that don't care about §4 can skip it.
+     */
+    discoverThreadId?: (args: {
+        cwd: string;
+        sinceIso: string;
+        excludeThreadIds?: ReadonlySet<string>;
+    }) => Promise<string | null>;
+    now?: () => number;
+    /**
+     * Settings-backed (`GlobalSettings.codexStallTimeoutMinutes`) — a plain
+     * number OR a (possibly async) getter, so a caller that re-reads
+     * settings.json can hand in `async () => (await readSettings())...` and
+     * have a live-edited Settings value take effect on the very next tick,
+     * without reconstructing the watcher (which would drop in-flight
+     * episode/notice state).
+     */
+    stallTimeoutMs?: number | (() => number | Promise<number>);
+    launchConfirmTimeoutMs?: number | (() => number | Promise<number>);
+    /**
+     * §5.4 — best-effort visible-viewport text for the self-report parser
+     * (`codex-status-report.ts`). Optional and best-effort by design, same
+     * as `PtyManager.peekTerminalText` itself: `null`/omitted just means no
+     * self-report signal is available (headless mirror disabled, no live
+     * entry) — the oracle-only classification path is unaffected either way.
+     */
+    peekTerminalText?: (taskId: string) => string | null;
+}
+export interface EpisodeState {
+    /** The `lastDataAt` value this episode "belongs to" — a newer value
+     *  means fresh output arrived, which starts a brand-new episode. */
+    lastSeenDataAt: number;
+    nudged: boolean;
+}
+//# sourceMappingURL=codex-task-watcher-types.d.ts.map

package/server/dist/core/codex-task-watcher-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-task-watcher-types.d.ts","sourceRoot":"","sources":["../../src/core/codex-task-watcher-types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,QAAiB,CAAC;AACvD;oCACoC;AACpC,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAE3D,MAAM,MAAM,sBAAsB,GAC9B,YAAY,GACZ,gBAAgB,GAChB,sBAAsB,GACtB,4BAA4B,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,UAAU,EAAE,0BAA0B,CAAC;IACvC,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC7D,SAAS,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAClE;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QACxB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KACxC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,sBAAsB,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B;wEACoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/server/dist/core/codex-task-watcher-types.js

@@ -0,0 +1,12 @@
+/*
+ * core/codex-task-watcher-types.ts — types, deps interfaces, and tunable
+ * defaults for `CodexTaskWatcher` (`codex-task-watcher.ts`). Split out to
+ * keep the class file under the 300-line guideline; re-exported verbatim
+ * from `codex-task-watcher.ts` so every existing import site is unaffected.
+ */
+/** Settings default per §5 (min 5 — Settings enforces the floor, not this module). */
+export const DEFAULT_STALL_TIMEOUT_MS = 15 * 60 * 1000;
+/** §5.2 launch-confirmation window — distinct from, and shorter than, the
+ *  mid-task stall trigger above. */
+export const DEFAULT_LAUNCH_CONFIRM_TIMEOUT_MS = 90 * 1000;
+//# sourceMappingURL=codex-task-watcher-types.js.map

package/server/dist/core/codex-task-watcher-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-task-watcher-types.js","sourceRoot":"","sources":["../../src/core/codex-task-watcher-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,sFAAsF;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACvD;oCACoC;AACpC,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/server/dist/core/codex-task-watcher.d.ts

@@ -0,0 +1,30 @@
+import { type CodexWatcherNotice, type CodexTaskWatcherDeps } from "./codex-task-watcher-types.js";
+export { DEFAULT_STALL_TIMEOUT_MS, DEFAULT_LAUNCH_CONFIRM_TIMEOUT_MS, type CodexWatcherNoticeKind, type CodexWatcherNotice, type CodexTaskWatcherStore, type CodexTaskWatcherPtyManager, type CodexTaskWatcherDeps, } from "./codex-task-watcher-types.js";
+export declare class CodexTaskWatcher {
+    private readonly deps;
+    private readonly episodes;
+    private readonly notices;
+    private readonly nowFn;
+    private readonly stallTimeoutMs;
+    private readonly launchConfirmTimeoutMs;
+    /** Reentrancy guard (doubt-review finding) — `index.ts`'s `setInterval`
+     *  never awaits the prior tick, and one tick can outlive 60s with a
+     *  handful of stalled tasks (N sequential up-to-30s oracle calls). Two
+     *  OVERLAPPING ticks would each build their own `claimedThreadIds` from
+     *  `store.list()` and miss the other's in-flight §4 discovery, risking
+     *  two tasks in the same cwd permanently claiming the same threadId (no
+     *  re-validation once set). Skipping an overlapping tick is always safe
+     *  — the next one 60s later just re-evaluates the same tasks. */
+    private ticking;
+    constructor(deps: CodexTaskWatcherDeps);
+    private resolveStallTimeoutMs;
+    private resolveLaunchConfirmTimeoutMs;
+    /** Ephemeral, in-memory Inbox feed — see the module header. */
+    snapshot(): CodexWatcherNotice[];
+    tick(): Promise<void>;
+    private checkTask;
+    private classify;
+    private setNotice;
+    private markDone;
+}
+//# sourceMappingURL=codex-task-watcher.d.ts.map

package/server/dist/core/codex-task-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-task-watcher.d.ts","sourceRoot":"","sources":["../../src/core/codex-task-watcher.ts"],"names":[],"mappings":"AA+CA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAE1B,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AAUvC,qBAAa,gBAAgB;IAgBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4C;IAC3E,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA4C;IACnF;;;;;;;qEAOiE;IACjE,OAAO,CAAC,OAAO,CAAS;gBAEK,IAAI,EAAE,oBAAoB;YAMzC,qBAAqB;YAIrB,6BAA6B;IAM3C,+DAA+D;IAC/D,QAAQ,IAAI,kBAAkB,EAAE;IAI1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAiCb,SAAS;YA2ET,QAAQ;IA+DtB,OAAO,CAAC,SAAS;YAQH,QAAQ;CAMvB"}

package/server/dist/core/codex-task-watcher.js

@@ -0,0 +1,252 @@
+/*
+ * core/codex-task-watcher.ts — Codex Light §5.1 `CodexTaskWatcher`: the
+ * plain module (no new process) that ties the completion oracle (§1) to
+ * the live pty (§4) into the actual runtime behavior AC5/AC6 need.
+ *
+ * On every `tick()`, for each live Codex-runtime task whose pty has been
+ * silent ≥ `stallTimeoutMs` (Settings-configurable, default 15 min, floor
+ * 5 min — §5's Settings field), calls the oracle CLI (`codex-oracle-
+ * runner.ts`) and classifies per the spec's table:
+ *
+ *   not_done + silent      → auto-nudge, capped at one attempt per stall
+ *                            EPISODE (a fresh `lastDataAt` starts a new one)
+ *   delivery_pending, delivery_state absent/"indeterminate" → case 13
+ *                            proper; keep re-polling every tick, never nudge
+ *   delivery_pending, delivery_state === "error" → surface distinctly to
+ *                            Inbox, never re-poll as "still pending" forever
+ *                            (§5.1's correction — do NOT branch on the
+ *                            verdict string alone)
+ *   done                   → label done; the pty is left running (§4 —
+ *                            marking done never kills the process)
+ *   no_oracle               → one self-check nudge per episode, then
+ *                            Inbox-only once that nudge is spent (§5.4's
+ *                            self-report can still resolve it — see below)
+ *
+ * `snapshot()` exposes the resulting notices for the Inbox aggregator
+ * (`external/inbox/_codex.ts`) — an ephemeral, in-memory side-channel, not
+ * persisted to `sdk-sessions.json`; a server restart just re-derives it.
+ *
+ * Each `checkTask()` pass also attempts §4's `threadId` discovery
+ * (`core/codex-thread-discovery.ts`) for any Codex task that doesn't have
+ * one yet — a fresh launch never learns its own thread id from the launch
+ * command (v1 has no `--session-id`-equivalent flag), so without this the
+ * resume branch in `runtime-chokepoint.ts` could never fire. `tick()`'s
+ * reentrancy guard (below) also protects this from a cross-tick race.
+ *
+ * §5.3 Guided-mode approval/structured-error TEXT detection does NOT live
+ * here — it runs as an Inbox post-pass (`external/inbox/_codex.ts`'s
+ * `appendCodexTerminalSignals`, over `core/codex-terminal-signal-detect.ts`).
+ *
+ * §5.4's structured self-report (`codex-status-report.ts`) is consulted
+ * only in the `no_oracle` branch of `classify()` below — see that branch's
+ * own comment for why.
+ */
+import { parseShipwrightStatusReport } from "./codex-status-report.js";
+import { DEFAULT_STALL_TIMEOUT_MS, DEFAULT_LAUNCH_CONFIRM_TIMEOUT_MS, } from "./codex-task-watcher-types.js";
+// Types/interfaces/constants live in `codex-task-watcher-types.ts` (split to
+// stay under the 300-line guideline); re-exported here so every existing
+// import site (`from "./codex-task-watcher.js"`) is unaffected.
+export { DEFAULT_STALL_TIMEOUT_MS, DEFAULT_LAUNCH_CONFIRM_TIMEOUT_MS, } from "./codex-task-watcher-types.js";
+const WAKER_PROMPT = "\n[Shipwright] Still there? If you're finished, wrap up and close with your " +
+    "SHIPWRIGHT-STATUS block. If not, please continue.\n";
+const SELF_CHECK_PROMPT = "\n[Shipwright] This phase has no automated completion check — please confirm " +
+    "your status directly: are you done, or still working? Close with your " +
+    "SHIPWRIGHT-STATUS block either way.\n";
+export class CodexTaskWatcher {
+    deps;
+    episodes = new Map();
+    notices = new Map();
+    nowFn;
+    stallTimeoutMs;
+    launchConfirmTimeoutMs;
+    /** Reentrancy guard (doubt-review finding) — `index.ts`'s `setInterval`
+     *  never awaits the prior tick, and one tick can outlive 60s with a
+     *  handful of stalled tasks (N sequential up-to-30s oracle calls). Two
+     *  OVERLAPPING ticks would each build their own `claimedThreadIds` from
+     *  `store.list()` and miss the other's in-flight §4 discovery, risking
+     *  two tasks in the same cwd permanently claiming the same threadId (no
+     *  re-validation once set). Skipping an overlapping tick is always safe
+     *  — the next one 60s later just re-evaluates the same tasks. */
+    ticking = false;
+    constructor(deps) {
+        this.deps = deps;
+        this.nowFn = deps.now ?? Date.now;
+        this.stallTimeoutMs = deps.stallTimeoutMs ?? DEFAULT_STALL_TIMEOUT_MS;
+        this.launchConfirmTimeoutMs = deps.launchConfirmTimeoutMs ?? DEFAULT_LAUNCH_CONFIRM_TIMEOUT_MS;
+    }
+    async resolveStallTimeoutMs() {
+        return typeof this.stallTimeoutMs === "function" ? await this.stallTimeoutMs() : this.stallTimeoutMs;
+    }
+    async resolveLaunchConfirmTimeoutMs() {
+        return typeof this.launchConfirmTimeoutMs === "function"
+            ? await this.launchConfirmTimeoutMs()
+            : this.launchConfirmTimeoutMs;
+    }
+    /** Ephemeral, in-memory Inbox feed — see the module header. */
+    snapshot() {
+        return [...this.notices.values()];
+    }
+    async tick() {
+        if (this.ticking)
+            return; // reentrancy guard — see the field doc above
+        this.ticking = true;
+        try {
+            const allTasks = this.deps.store.list();
+            // §4 discovery de-dup — a rollout file already claimed by one task (in
+            // the store, or by an earlier task this same tick) is never handed to
+            // a second one, guarding the rare case of two Codex tasks launched in
+            // the same cwd within the same discovery window. The `ticking` guard
+            // above is what makes "this same tick" the only case that can ever
+            // happen — see its doc for why a cross-tick race would otherwise slip
+            // past this Set entirely.
+            const claimedThreadIds = new Set(allTasks.map((t) => t.threadId).filter((id) => Boolean(id)));
+            const tasks = allTasks.filter((t) => t.runtime === "codex" &&
+                (t.state === "active" || t.state === "awaiting_external_start"));
+            // Resolved ONCE per tick, not per task — the production getter
+            // re-reads settings.json on every call, so per-task was an N+1 read
+            // (code-review finding). A live edit still lands next tick either way.
+            const stallTimeoutMs = await this.resolveStallTimeoutMs();
+            const launchConfirmTimeoutMs = await this.resolveLaunchConfirmTimeoutMs();
+            for (const task of tasks) {
+                await this.checkTask(task, claimedThreadIds, stallTimeoutMs, launchConfirmTimeoutMs);
+            }
+        }
+        finally {
+            this.ticking = false;
+        }
+    }
+    async checkTask(task, claimedThreadIds, stallTimeoutMs, launchConfirmTimeoutMs) {
+        const lastDataAt = this.deps.ptyManager.getLastDataAt(task.taskId);
+        if (lastDataAt === null) {
+            // pty gone (PR #466 preflight finding) — any notice describes a
+            // state that no longer exists; don't leave it in the Inbox forever.
+            this.episodes.delete(task.taskId);
+            this.notices.delete(task.taskId);
+            return;
+        }
+        if (!task.threadId && this.deps.discoverThreadId && task.launchedAt) {
+            const threadId = await this.deps.discoverThreadId({
+                cwd: task.cwd,
+                sinceIso: task.launchedAt,
+                excludeThreadIds: claimedThreadIds,
+            });
+            if (threadId) {
+                claimedThreadIds.add(threadId);
+                this.deps.store.patch(task.taskId, { threadId });
+                await this.deps.store.persist();
+                task = { ...task, threadId };
+            }
+        }
+        const now = this.nowFn();
+        const silenceMs = now - lastDataAt;
+        // §5.2 — launch-confirmation timeout: distinct, shorter window, only
+        // while still awaiting the handshake and nothing has ever streamed.
+        // Disposition (external-code-review, OpenAI MEDIUM, accepted not fixed):
+        // `lastDataAt` is PtyManager's generic "any bytes" idle timer (ADR-068-A1)
+        // — a shell-prompt echo counts the same as a real Codex frame. Accepted:
+        // AC8's CLI check closes the common case; `codex-terminal-signal-detect.ts`
+        // already accepts the same fragile-TUI-matching gap elsewhere.
+        if (task.state === "awaiting_external_start") {
+            if (silenceMs >= launchConfirmTimeoutMs) {
+                this.setNotice(task.taskId, "launch_confirmation_failed", "Codex never produced output after launch — the terminal may not have started correctly.");
+            }
+            return;
+        }
+        // Doubt-review finding: reaching here means state left
+        // awaiting_external_start, so a stale launch_confirmation_failed
+        // banner must not keep sitting in the Inbox for a healthy run.
+        if (this.notices.get(task.taskId)?.kind === "launch_confirmation_failed") {
+            this.notices.delete(task.taskId);
+        }
+        const prev = this.episodes.get(task.taskId);
+        if (!prev || prev.lastSeenDataAt !== lastDataAt) {
+            this.episodes.set(task.taskId, { lastSeenDataAt: lastDataAt, nudged: false });
+            // A fresh episode's nudge notice is stale — mirrors the two clears above.
+            if (this.notices.get(task.taskId)?.kind === "nudge_sent") {
+                this.notices.delete(task.taskId);
+            }
+        }
+        if (silenceMs < stallTimeoutMs)
+            return;
+        const project = this.deps.getProjectById(task.projectId);
+        if (!project)
+            return;
+        const outcome = await this.deps.runOracle({
+            projectRoot: project.path,
+            phase: task.phase ?? "",
+            session: task.sessionUuid,
+            since: task.launchedAt,
+        });
+        if (outcome.kind !== "ok")
+            return; // engine-unavailable/failed — try again next tick
+        await this.classify(task, outcome.result.verdict, outcome.result.evidence);
+    }
+    async classify(task, verdict, evidence) {
+        const episode = this.episodes.get(task.taskId);
+        // External-code-review (GLM MEDIUM): a delivery_error notice, once
+        // set, was never cleared unless the task reached "done" — mirrors the
+        // launch_confirmation_failed clearing fix in checkTask() above.
+        const isDeliveryError = verdict === "delivery_pending" && evidence.delivery_state === "error";
+        if (!isDeliveryError && this.notices.get(task.taskId)?.kind === "delivery_error") {
+            this.notices.delete(task.taskId);
+        }
+        if (verdict === "done") {
+            await this.markDone(task.taskId);
+            return;
+        }
+        if (verdict === "delivery_pending") {
+            if (evidence.delivery_state === "error") {
+                this.setNotice(task.taskId, "delivery_error", "Codex's PR delivery failed (CI failed or the PR was closed) — needs your attention.");
+            }
+            // absent / "indeterminate" — case 13 proper: keep re-polling, never nudge.
+            //
+            // Disposition (external-code-review, GLM MEDIUM, accepted not
+            // fixed): re-polls the oracle every 60s tick while stalled+pending
+            // — §1.6/§5.1's "low-frequency" language could read as wanting a
+            // slower interval. Accepted: spec's "Open items" #4 names this
+            // interval a build-time call, and 60s matches the watcher's one
+            // existing tick rather than a second timer for an unspecified value.
+            return;
+        }
+        if (!episode || episode.nudged) {
+            if (verdict === "no_oracle") {
+                // §5.4 (external-code-review, OpenAI MEDIUM): the self-report's
+                // one behavior-changing use — no_oracle has no other completion
+                // signal, so a well-formed done:true report still on-screen after
+                // the spent nudge counts as real completion. Every OTHER verdict
+                // still defers to the oracle on disagreement, per §5.4.
+                const selfReport = parseShipwrightStatusReport(this.deps.peekTerminalText?.(task.taskId) ?? "");
+                if (selfReport?.done) {
+                    await this.markDone(task.taskId);
+                    return;
+                }
+                this.setNotice(task.taskId, "no_oracle_unresolved", "This phase has no automated completion check and the self-check nudge didn't resolve it.");
+            }
+            return;
+        }
+        // not_done or no_oracle — one nudge per episode. A watched task
+        // (attachCount !== 0) gets neither, by design (doubt-review, low):
+        // someone already has the terminal open.
+        if (this.deps.ptyManager.attachCount(task.taskId) !== 0)
+            return;
+        this.deps.ptyManager.write(task.taskId, verdict === "no_oracle" ? SELF_CHECK_PROMPT : WAKER_PROMPT);
+        episode.nudged = true;
+        this.setNotice(task.taskId, "nudge_sent", verdict === "no_oracle"
+            ? "Sent a self-check nudge — no automated completion check exists for this phase."
+            : "Sent a nudge — the completion oracle reports this run isn't done yet.");
+    }
+    setNotice(taskId, kind, detail) {
+        this.notices.set(taskId, { taskId, kind, detail, at: this.nowFn() });
+    }
+    // Shared by an oracle "done" verdict and a §5.4 self-report completion.
+    // boardColumn synced alongside state (doubt-review finding) — mirrors
+    // POST /tasks/:id/close's AC-6 fix; otherwise a task dragged to a
+    // non-Done column stays stranded/locked once auto-completed.
+    async markDone(taskId) {
+        this.episodes.delete(taskId);
+        this.notices.delete(taskId);
+        this.deps.store.patch(taskId, { state: "done", boardColumn: "done" });
+        await this.deps.store.persist();
+    }
+}
+//# sourceMappingURL=codex-task-watcher.js.map

package/server/dist/core/codex-task-watcher.js.map

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

package/server/dist/core/codex-terminal-signal-detect.d.ts

@@ -0,0 +1,7 @@
+/** A pending Codex approval request (command exec or patch apply) in the
+ *  trailing text of a live embedded terminal, or `null`. */
+export declare function extractCodexApprovalPrompt(visibleText: string): string | null;
+/** A Codex-reported structured error/turn-abort in the trailing text of a
+ *  live embedded terminal, or `null`. */
+export declare function extractCodexErrorText(visibleText: string): string | null;
+//# sourceMappingURL=codex-terminal-signal-detect.d.ts.map

package/server/dist/core/codex-terminal-signal-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-terminal-signal-detect.d.ts","sourceRoot":"","sources":["../../src/core/codex-terminal-signal-detect.ts"],"names":[],"mappings":"AAuFA;4DAC4D;AAC5D,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED;yCACyC;AACzC,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAaxE"}