@svenroth-ai/shipwright 0.27.0 → 0.28.0

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"}

package/server/dist/core/codex-terminal-signal-detect.js

@@ -0,0 +1,113 @@
+/*
+ * codex-terminal-signal-detect.ts — Codex Light §5.3 "Guided-mode approvals
+ * and structured errors": pure detectors over the visible-viewport text of
+ * a Codex-runtime embedded terminal, mirroring `terminal-prompt-detect.ts`'s
+ * shape (bottom-anchored, bounded, best-effort) but keyed to Codex's own
+ * strings instead of Claude's.
+ *
+ * Evidence: `codex-task-watcher.ts`'s module header previously scoped this
+ * detector OUT as "no verified plain-pty-TUI text pattern to build a
+ * detector from yet" — the spec's own §3 confirmation test only exercised
+ * `request_user_input` over the APP-SERVER protocol (Stage 2, not v1). That
+ * gap is now closed for the plain-pty case: the exact strings below were
+ * extracted directly from the real, installed `codex-cli 0.147.0` Windows
+ * binary (`@openai/codex-win32-x64`'s `codex.exe`, via a printable-string
+ * scan), the same evidence tier `codex-thread-discovery.ts` used for the
+ * rollout-file naming convention. One honest gap remains, smaller than that
+ * one: these strings are confirmed to exist verbatim in the binary, not
+ * (yet) observed in an actual rendered pty capture of a live approval
+ * dialog — ratatui box-drawing/wrapping around them is unverified. The
+ * detectors are therefore deliberately conservative (a short, literal
+ * heading match within a bottom-anchored recency window, no footer-shape
+ * assumptions) so a wrapped border cannot produce a false NEGATIVE beyond
+ * "missed this tick, the next poll on unchanged text still forms a false
+ * positive risk that a real capture might have avoided" — and the anchor
+ * strings are distinctive enough (only Codex's own approval elicitation or
+ * error footer would ever emit them) that a false POSITIVE is effectively
+ * impossible.
+ *
+ * Independent of the silence-timer/oracle loop (§5.3's own wording) — wired
+ * as an Inbox post-pass (`external/inbox/_codex.ts`), not into
+ * `CodexTaskWatcher.tick()`, exactly like `terminal_prompt`'s own
+ * `appendTerminalPrompts` post-pass.
+ */
+/** Recency window — how many trailing lines of visible text count as "the
+ *  current bottom-most content" for either signal. A live dialog or error
+ *  footer is always the last thing Codex printed; older scrollback above
+ *  this window is deliberately never scanned (an old, since-scrolled-past
+ *  approval/error must not resurrect itself as "still pending"). */
+const RECENCY_WINDOW_LINES = 40;
+/** Codex's two known approval-elicitation headings (command exec, patch
+ *  apply) — verified verbatim in the real codex.exe binary. */
+const APPROVAL_HEADING = /Allow Codex to (run `|apply proposed code changes\?)/i;
+/** Codex's generic turn-ending error footer — shown for a turn abort,
+ *  Ctrl-C interrupt, high load, rate limit, etc.; the one constant across
+ *  all of them. Verified verbatim in the real codex.exe binary. */
+const ERROR_FOOTER = /Something went wrong\??\s*Hit\s*`?\/feedback`?\s*to report the issue/i;
+const MAX_BLOCK_LINES = 24;
+/** Mirrors terminal-prompt-detect.ts's MAX_QUESTION_TEXT_LEN cap — keeps a
+ *  pathological viewport from leaking unbounded text into the Inbox. */
+const MAX_SIGNAL_TEXT_LEN = 4000;
+function isBlank(line) {
+    return line.trim().length === 0;
+}
+function recencyLines(visibleText) {
+    const lines = visibleText.split("\n");
+    const startIndex = Math.max(0, lines.length - RECENCY_WINDOW_LINES);
+    return { lines: lines.slice(startIndex), startIndex };
+}
+/** Collect a bounded block around the matched heading line — from the
+ *  heading down to the next blank-line gap or the hard cap, so the block
+ *  captures the command/heading plus its immediately-following option
+ *  list without pulling in unrelated scrollback. */
+function collectBlock(lines, headingIndex) {
+    const block = [];
+    let blankRun = 0;
+    for (let i = headingIndex; i < lines.length && block.length < MAX_BLOCK_LINES; i++) {
+        const line = lines[i];
+        if (isBlank(line)) {
+            blankRun++;
+            if (blankRun >= 2)
+                break;
+        }
+        else {
+            blankRun = 0;
+        }
+        block.push(line);
+    }
+    while (block.length > 0 && isBlank(block[block.length - 1]))
+        block.pop();
+    const text = block.join("\n");
+    return text.length > MAX_SIGNAL_TEXT_LEN ? text.slice(0, MAX_SIGNAL_TEXT_LEN) : text;
+}
+/** A pending Codex approval request (command exec or patch apply) in the
+ *  trailing text of a live embedded terminal, or `null`. */
+export function extractCodexApprovalPrompt(visibleText) {
+    if (!visibleText)
+        return null;
+    const { lines } = recencyLines(visibleText);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (APPROVAL_HEADING.test(lines[i])) {
+            return collectBlock(lines, i);
+        }
+    }
+    return null;
+}
+/** A Codex-reported structured error/turn-abort in the trailing text of a
+ *  live embedded terminal, or `null`. */
+export function extractCodexErrorText(visibleText) {
+    if (!visibleText)
+        return null;
+    const { lines } = recencyLines(visibleText);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (ERROR_FOOTER.test(lines[i])) {
+            // The error line itself is usually self-contained ("<cause>.
+            // Something went wrong? Hit `/feedback` ...") — a few lines of
+            // leading context in case the cause wrapped onto the prior line.
+            const from = Math.max(0, i - 2);
+            return collectBlock(lines, from);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=codex-terminal-signal-detect.js.map

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

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

package/server/dist/core/codex-thread-discovery.d.ts

@@ -0,0 +1,21 @@
+export interface CodexThreadDiscoveryDeps {
+    readdir: (dir: string) => Promise<string[]>;
+    /** Reads just the head of a file — rollout files can be large, but `session_meta` is always the very first line. */
+    readHead: (filePath: string, maxBytes: number) => Promise<string>;
+    homeDir: () => string;
+}
+export declare function codexSessionsRoot(deps: Pick<CodexThreadDiscoveryDeps, "homeDir">): string;
+export interface DiscoverCodexThreadIdArgs {
+    cwd: string;
+    /** ISO-8601 — only rollout files at/after this instant are considered. */
+    sinceIso: string;
+    /** Skip these thread ids — already claimed by another task this process knows about. */
+    excludeThreadIds?: ReadonlySet<string>;
+}
+/**
+ * Best-effort, filename-first discovery of the thread id a fresh Codex
+ * launch produced. Returns `null` (not an error) when nothing matches yet.
+ */
+export declare function discoverCodexThreadId(args: DiscoverCodexThreadIdArgs, deps: CodexThreadDiscoveryDeps): Promise<string | null>;
+export declare const defaultCodexThreadDiscoveryDeps: CodexThreadDiscoveryDeps;
+//# sourceMappingURL=codex-thread-discovery.d.ts.map

package/server/dist/core/codex-thread-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-thread-discovery.d.ts","sourceRoot":"","sources":["../../src/core/codex-thread-discovery.ts"],"names":[],"mappings":"AAkDA,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,oHAAoH;IACpH,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB;AAkBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,GAAG,MAAM,CAEzF;AA2BD,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqDxB;AAED,eAAO,MAAM,+BAA+B,EAAE,wBAa7C,CAAC"}