fix: compact terminal codex steer rejection

scripts/src/code-queue.ts

@@ -621,11 +621,57 @@ function classifySteerFailure(response: unknown, targetPath: string, stableProxy
   };
 }
 
-function unwrapSteerResponse(response: unknown, targetPath: string, stableProxyPath: string, rawProxyEquivalent: string): { ok: true; upstream: { ok: unknown; status: unknown }; body: Record<string, unknown> } | { ok: false; diagnostics: ClassifiedCodexSteerError } {
+function unwrapSteerResponse(response: unknown, targetPath: string, stableProxyPath: string, rawProxyEquivalent: string): { ok: true; upstream: { ok: unknown; status: unknown }; body: Record<string, unknown> } | { ok: false; diagnostics: ClassifiedCodexSteerError; rawResponse: unknown } {
   const record = asRecord(response);
   const body = responseBody(record);
   if (record?.ok === true && body?.ok === true) return { ok: true, upstream: { ok: record.ok, status: record.status }, body };
-  return { ok: false, diagnostics: classifySteerFailure(response, targetPath, stableProxyPath, rawProxyEquivalent) };
+  return { ok: false, diagnostics: classifySteerFailure(response, targetPath, stableProxyPath, rawProxyEquivalent), rawResponse: response };
+}
+
+function terminalStatusFromTask(task: Record<string, unknown> | null): string {
+  const direct = asString(task?.terminalStatus);
+  if (direct.length > 0) return direct;
+  const attempts = asArray(task?.attempts).map((item) => asRecord(item)).filter((item): item is Record<string, unknown> => item !== null);
+  for (let index = attempts.length - 1; index >= 0; index -= 1) {
+    const status = asString(attempts[index]?.terminalStatus);
+    if (status.length > 0) return status;
+  }
+  return "";
+}
+
+function compactTerminalSteerRejection(taskId: string, response: unknown): Record<string, unknown> | null {
+  const record = asRecord(response);
+  const body = responseBody(record);
+  const task = asRecord(body?.task);
+  const status = asString(task?.status);
+  if (!isTerminalTaskStatus(status)) return null;
+  const terminalStatus = terminalStatusFromTask(task);
+  const lastUpdate = task?.updatedAt ?? task?.finishedAt ?? null;
+  return {
+    ok: false,
+    steer: {
+      accepted: false,
+      reason: "task-already-terminal",
+      taskId,
+      status,
+      terminalStatus: terminalStatus || null,
+      lastUpdate,
+      updatedAt: task?.updatedAt ?? null,
+      finishedAt: task?.finishedAt ?? null,
+      retryable: false,
+    },
+    message: `task ${taskId} is already terminal (${status}); codex steer only applies to an active running turn`,
+    commands: {
+      show: `bun scripts/cli.ts codex task ${taskId}`,
+      read: `bun scripts/cli.ts codex read ${taskId}`,
+      followUpSubmit: `bun scripts/cli.ts codex submit --prompt-file <path> --reference-task-id ${taskId}`,
+      supervisor: `bun scripts/cli.ts codex tasks --view supervisor --limit ${defaultTasksLimit}`,
+    },
+    upstream: {
+      status: responseStatus(record),
+      error: asString(body?.error) || null,
+    },
+  };
 }
 
 function steerSuccessAttempt(attempt: number, durationMs: number, upstream: { ok: unknown; status: unknown }): CodexSteerAttemptSummary {
@@ -4756,6 +4802,8 @@ function codexSteerTask(taskId: string, args: string[], fetcher: CodexResponseFe
     }
     attempts.push(steerFailureAttempt(attempt, durationMs, response.diagnostics));
     failedResponse = response;
+    const terminalRejection = compactTerminalSteerRejection(taskId, response.rawResponse);
+    if (terminalRejection !== null) return terminalRejection;
     if (!shouldRetrySteerFailure(response.diagnostics, attempt, options.retryAttempts)) break;
     sleepSync(options.retryDelayMs);
   }

scripts/src/help.ts

@@ -61,7 +61,7 @@ export function rootHelp(): unknown {
       { command: "codex read <taskId>", description: "Mark one reviewed terminal task read and return terminal metadata plus final response; prompt/tool logs stay behind drill-down commands." },
       { command: "codex dev-ready", description: "Fetch execution-container readiness, including sanitized skill injection status from /api/dev-ready." },
       { command: "codex judge <taskId> --attempt N [--dry-run] [--include-prompt]", description: "Replay one stored Code Queue attempt through the same judge context builder and MiniMax judge call path used by the live queue worker." },
-      { command: "codex steer <taskId> [prompt|--prompt-file path|--prompt-stdin] [--dry-run] [--no-retry|--retry-attempts N]", description: "Push a corrective prompt into a running Code Queue task; retryable tunnel aborts get bounded retry diagnostics, and real success does not echo prompt text." },
+      { command: "codex steer <taskId> [prompt|--prompt-file path|--prompt-stdin] [--dry-run] [--no-retry|--retry-attempts N]", description: "Push a corrective prompt into a running Code Queue task; retryable tunnel aborts get bounded diagnostics, terminal-task rejection suggests codex task/read plus codex submit --reference-task-id <taskId>, and real success does not echo prompt text." },
       { command: "codex interrupt|cancel <taskId>", description: "Request interrupt for a running Code Queue task, or cancel a queued/retry_wait task, through the same private proxy." },
       { command: "codex (queues [--full|--all] | queue create <queueId> | queue merge <sourceQueueId> --into <targetQueueId> | move <taskId> --queue <queueId>)", description: "List low-noise queue summaries by default, including effective activity counts that distinguish scheduler-local queues, DB running tasks, and heartbeat-fresh runners; full queue rows require --full/--all." },
       { command: "job list [--limit N] [--include-command]", description: "List async jobs from .state/jobs with a bounded default page." },
@@ -300,7 +300,7 @@ function codexHelp(): unknown {
       redline: "data.supervisor.activeRunning.redline names the count field, routine target, burst redline, hard redline, and decisionReady flag.",
       limitSemantics: "filters.requestedLimit preserves the user input; filters.limit/effectiveLimit shows the capped query budget; section outputBudget/rowPage show returned-row caps.",
     },
-    description: "Operate Code Queue through the stable backend-core private proxy path with bounded activity summaries for queue and supervisor views. Real submit/steer success is a low-noise write confirmation and does not echo prompt text.",
+    description: "Operate Code Queue through the stable backend-core private proxy path with bounded activity summaries for queue and supervisor views. Real submit/steer success is a low-noise write confirmation and does not echo prompt text; terminal steer rejection returns compact status plus codex task/read/submit follow-up commands.",
   };
 }