@aicopycoders/exodus 2026.10.1700 → 2026.10.1900-beta.1

package/assets/skills/exodus-video/SKILL.md

@@ -101,7 +101,7 @@ never how it is made. Every answer to them says `"view": "customer"`, and the
 CLI words it the way the run page does. On their own brands they can:
 
 - `video start --script <file> --conceit <key> --style <slug>` with
-  `--direction`, `--frame`, `--pacing`, `--music`, `--one-shot`, `--review-storyboard`, `--stop-at-script` and `--wait`. Any other start
+  `--direction`, `--frame`, `--pacing`, `--music`, `--one-shot`, `--review-storyboard`, `--stop-at-script`, `--rewrite-to-fit` and `--wait`. Any other start
   flag is refused with one sentence naming it. The answer is the run id and the
   link to the video's page, plus what the server did to the script: laid a
   plain transcript out, or wrote a script from a description (see "The script
@@ -158,7 +158,7 @@ exodus workflow run <workflowId|name> --input <field>=@script.txt --voices @voic
 exodus workflow run <workflowId|name> --input <field>=@script.txt --voice-treatment @voice-treatment.json --wait
                                                           same, with the video model speaking voices you WROTE
 exodus video status <runId>                               where it is, per scene
-exodus video start --script <file> --conceit <kind> --style <look> [--direction "…"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice native] [--music] [--one-shot] [--director] [--stop-at-script] [--wait]
+exodus video start --script <file> --conceit <kind> --style <look> [--direction "…"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice native] [--music] [--one-shot] [--director] [--stop-at-script] [--rewrite-to-fit] [--wait]
                                                           start from a script and the kinds the server offers.
                                                           The file can be a plain transcript, a draft or a
                                                           description: the server tidies it (see "The script
@@ -397,6 +397,16 @@ What the CLI prints, and what you tell the user:
   one-person kind of ad): the notes come first, then the refusal, and `--json`
   carries the tidied script under `script`. Fix that script and send it. It is
   already in the format, so it is not tidied or paid for again.
+- **The script doesn't fit the kind of ad** (too many speakers, or a rule the
+  kind of ad has): the refusal says `--rewrite-to-fit` can fix it, and
+  `--json` carries `rewriteOffered: true`. Ask the user before you add the
+  flag: the server then writes a new script for that kind of ad from theirs
+  (the dashboard's "Rewrite to fit"), which can change every line and the
+  names, starts the run on it, and prints it (`rewritten` in `--json`). Show
+  the user that script. To let them read it first, add `--stop-at-script` too.
+  If the rewrite can't be made, nothing starts and the error says why
+  (`SCRIPT_NOT_REWRITTEN`). The other way out is a kind of ad made for the
+  script's cast.
 
 **`--stop-at-script`** prints the script the run would start on and starts
 nothing (exit 0). A question or a description too thin to write from answers

package/dist/commands/video-customer.d.ts

@@ -57,6 +57,7 @@ export interface CustomerStart {
     dashboardUrl: string;
     tidied?: ScriptTidied;
     written?: string;
+    rewritten?: string;
 }
 export interface CustomerStoryboard {
     view: "customer";

package/dist/commands/video.d.ts

@@ -298,6 +298,7 @@ export type RunStop = {
     repair?: true;
     nodeId?: string;
     step?: string;
+    workerStopped?: true;
 } | {
     at: "finished";
     status: string;
@@ -456,6 +457,7 @@ export interface ScriptStartOptions {
     director?: true;
     shots?: RunShots;
     stopAtScript?: true;
+    rewriteToFit?: true;
     wait: boolean;
     json: boolean;
     onProgressLine?: (line: string) => void;

package/dist/commands/video.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { apiGet, apiPost, getDashboardUrl } from "../lib/client.js";
 import { displayRunStatus, formatApiError } from "../lib/format.js";
+import { isWorkerStoppedPark } from "../lib/runStatus.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { hasBinary } from "../lib/preflight.js";
 import { ASSET_UPLOAD_POLICY, pauseAheadLine, } from "./workflow.js";
@@ -167,6 +168,13 @@ Options:
   --stop-at-script     Print the script the run would start on, and start
                        nothing (start, with --conceit). To read a written or
                        laid-out script first; send it back with --script
+  --rewrite-to-fit     If the script doesn't fit the kind of ad (more speakers
+                       than it takes, or a rule it has), write a new script for
+                       it from yours, print it, and start on it (start, with
+                       --conceit). That can change every line and the names.
+                       A script that fits starts as it is. With
+                       --stop-at-script, it prints the new script and starts
+                       nothing
   --conceit <kind>     Kind of ad (start)
   --style <look>       Look (start)
                        The server lists the kinds and looks it offers. An unknown word prints them.
@@ -206,7 +214,7 @@ Options:
 Who can use what. Admins get every command here. Beta testers with video
 switched on get these, on their own brands: start (--script, --conceit,
 --style, --direction, --frame, --pacing, --music, --one-shot,
---review-storyboard, --stop-at-script),
+--review-storyboard, --stop-at-script, --rewrite-to-fit),
 status, storyboard, approve (the storyboard), voices, retry-frame --scene <n> (redo one scene's
 picture while the storyboard waits), pull (the finished video, each scene's
 clip and voice, and the music) and upload. These stay admin-only:
@@ -411,6 +419,8 @@ export function classifyRun(run) {
     if (run.isTerminal)
         return { at: "finished", status: run.status };
     if (isAwaitingApproval(run.status)) {
+        if (isWorkerStoppedPark(run))
+            return { at: "failed", repair: true, workerStopped: true };
         if (run.pauseReason === "repair") {
             const deadNode = run.nodes.find((n) => n.status === "failed");
             const why = deadNode?.error ?? run.error;
@@ -591,6 +601,13 @@ export function stopLines(stop, runId, runUrl) {
         ];
     }
     if (stop.at === "failed") {
+        if (stop.workerStopped) {
+            return [
+                "The worker making this ad stopped partway. Finished steps are kept.",
+                `Carry on from where it stopped: exodus workflow repair ${runId} retry`,
+                `Or open the run:                ${runUrl}`,
+            ];
+        }
         if (stop.repair) {
             if (!stop.step) {
                 return [
@@ -1447,6 +1464,20 @@ export function planVideoStart(flags, occurrences) {
             line: "--stop-at-script works with --conceit, not --show. A Show's script is read as you wrote it.",
         };
     }
+    const refitFlags = occurrences.filter((o) => o.flag === "rewrite-to-fit");
+    if (refitFlags.some((o) => o.value !== undefined && !o.value.startsWith("--"))) {
+        return {
+            kind: "usage",
+            line: "--rewrite-to-fit takes no value. Leave it off to start the script as you wrote it.",
+        };
+    }
+    const rewriteToFit = refitFlags.length > 0;
+    if (showId && rewriteToFit) {
+        return {
+            kind: "usage",
+            line: "--rewrite-to-fit works with --conceit, not --show. A Show's script is read as you wrote it.",
+        };
+    }
     if (showId && director) {
         return {
             kind: "usage",
@@ -1521,6 +1552,8 @@ export function planVideoStart(flags, occurrences) {
         opts.director = true;
     if (stopAtScript)
         opts.stopAtScript = true;
+    if (rewriteToFit)
+        opts.rewriteToFit = true;
     if (frameFlag.value || pacingFlag.value) {
         opts.shots = {
             ...(frameFlag.value ? { frame: frameFlag.value } : {}),
@@ -1634,6 +1667,20 @@ function scriptWrittenHead(written, started) {
 function writtenOf(value) {
     return typeof value === "string" && value.trim() !== "" ? value : null;
 }
+function scriptRewrittenHead(rewritten, started) {
+    if (rewritten === null)
+        return [];
+    return [
+        started
+            ? "Your script didn't fit this kind of ad, so we wrote a new one from it and started the run on it:"
+            : "Your script didn't fit this kind of ad, so we wrote a new one from it:",
+        "",
+        ...rewritten.split("\n").map((line) => (line ? `  ${line}` : "")),
+        "",
+    ];
+}
+const REWRITE_OFFER = "To have a new script written from yours for this kind of ad, run the same command with --rewrite-to-fit. " +
+    "That can change every line and the names.";
 function scriptNeedsCallerResult(res, json) {
     const data = res.data;
     if (!isRecord(data) || !isRecord(data.error))
@@ -1657,7 +1704,9 @@ function scriptStartRefused(res, json) {
     const data = isRecord(res.data) ? res.data : {};
     const tidied = data.tidied === undefined ? null : scriptTidiedOf(data.tidied);
     const written = writtenOf(data.written);
-    if (!tidied && written === null)
+    const rewritten = writtenOf(data.rewritten);
+    const offered = data.rewriteOffered === true;
+    if (!tidied && written === null && rewritten === null && !offered)
         return errorResult(res, json);
     const script = typeof data.script === "string" ? data.script : null;
     const error = videoApiError(res);
@@ -1671,16 +1720,25 @@ function scriptStartRefused(res, json) {
                     error,
                     ...(tidied ? { tidied } : {}),
                     ...(written !== null ? { written } : {}),
+                    ...(rewritten !== null ? { rewritten } : {}),
                     ...(script !== null ? { script } : {}),
+                    ...(offered ? { rewriteOffered: true } : {}),
                 }),
             ]
-            : [...scriptTidiedHead(tidied), ...scriptWrittenHead(written, false), error],
+            : [
+                ...scriptTidiedHead(tidied),
+                ...scriptWrittenHead(written, false),
+                ...scriptRewrittenHead(rewritten, false),
+                error,
+                ...(offered ? [REWRITE_OFFER] : []),
+            ],
     };
 }
 function stoppedAtScriptResult(data, json) {
     const script = typeof data.script === "string" ? data.script : "";
     const tidied = data.tidied === undefined ? null : scriptTidiedOf(data.tidied);
     const written = writtenOf(data.written);
+    const rewritten = writtenOf(data.rewritten);
     if (json) {
         return {
             code: 0,
@@ -1690,6 +1748,7 @@ function stoppedAtScriptResult(data, json) {
                     script,
                     ...(tidied ? { tidied } : {}),
                     ...(written !== null ? { written } : {}),
+                    ...(rewritten !== null ? { rewritten } : {}),
                 }),
             ],
         };
@@ -1698,9 +1757,11 @@ function stoppedAtScriptResult(data, json) {
         code: 0,
         lines: [
             ...scriptTidiedHead(tidied),
-            written !== null
-                ? "Your file described the ad, so we wrote this script from it. Nothing has started."
-                : "This is the script the run would start on. Nothing has started.",
+            rewritten !== null
+                ? "Your script didn't fit this kind of ad, so we wrote a new one from it. Nothing has started."
+                : written !== null
+                    ? "Your file described the ad, so we wrote this script from it. Nothing has started."
+                    : "This is the script the run would start on. Nothing has started.",
             "",
             ...script.split("\n").map((line) => (line ? `  ${line}` : "")),
             "",
@@ -1782,6 +1843,7 @@ export async function startScriptFlow(opts, deps) {
         ...(opts.director ? { director: true } : {}),
         ...(opts.shots ? { shots: opts.shots } : {}),
         ...(opts.stopAtScript ? { stopAtScript: true } : {}),
+        ...(opts.rewriteToFit ? { rewriteToFit: true } : {}),
     });
     if (!res.ok)
         return scriptNeedsCallerResult(res, opts.json) ?? scriptStartRefused(res, opts.json);
@@ -1801,13 +1863,19 @@ export async function startScriptFlow(opts, deps) {
     const video = startedVideoChoice(started.videoChoice);
     const tidied = started.tidied === undefined ? null : scriptTidiedOf(started.tidied);
     const written = writtenOf(started.written);
+    const rewritten = writtenOf(started.rewritten);
     const facts = {
         card,
         ...(video ? { videoChoice: video } : {}),
         ...(tidied ? { tidied } : {}),
         ...(written !== null ? { written } : {}),
+        ...(rewritten !== null ? { rewritten } : {}),
     };
-    const head = [...scriptTidiedHead(tidied), ...scriptWrittenHead(written, true)];
+    const head = [
+        ...scriptTidiedHead(tidied),
+        ...scriptWrittenHead(written, true),
+        ...scriptRewrittenHead(rewritten, true),
+    ];
     if (!opts.wait) {
         return {
             code: 0,
@@ -1834,16 +1902,22 @@ async function customerStartedResult(started, opts, deps) {
     const { runId, dashboardUrl } = started;
     const tidied = started.tidied === undefined ? null : scriptTidiedOf(started.tidied);
     const written = writtenOf(started.written);
+    const rewritten = writtenOf(started.rewritten);
     const head = [
         ...scriptTidiedHead(tidied),
         ...scriptWrittenHead(written, true),
+        ...scriptRewrittenHead(rewritten, true),
         `Started video ${runId}`,
         `Watch it: ${dashboardUrl}`,
     ];
     if (opts.wait) {
         const waited = await startedThenWait(runId, head, { ...opts, url: dashboardUrl }, deps);
-        const facts = { ...(tidied ? { tidied } : {}), ...(written !== null ? { written } : {}) };
-        return opts.json && (tidied || written !== null) ? waitJsonWith(waited, facts) : waited;
+        const facts = {
+            ...(tidied ? { tidied } : {}),
+            ...(written !== null ? { written } : {}),
+            ...(rewritten !== null ? { rewritten } : {}),
+        };
+        return opts.json && (tidied || written !== null || rewritten !== null) ? waitJsonWith(waited, facts) : waited;
     }
     if (opts.json)
         return { code: 0, lines: [JSON.stringify(started)] };
@@ -2035,7 +2109,7 @@ export async function statusFlow(runId, json, deps) {
         if (item.itemKind !== "clip" && item.itemKind !== "voiceover" && item.itemKind !== "frame") {
             continue;
         }
-        if (item.sceneIndex < 0)
+        if (!isPullSceneIndex(item.sceneIndex))
             continue;
         if (item.itemKind === "frame" && !sceneFrameNodeIds.has(item.nodeId))
             continue;
@@ -2043,9 +2117,11 @@ export async function statusFlow(runId, json, deps) {
         row[item.itemKind] = item;
         byScene.set(item.sceneIndex, row);
     }
-    const headline = stop.at === "failed" && stop.repair
-        ? `Ad run ${runId} — Stopped, a step failed`
-        : `Ad run ${runId} — ${displayRunStatus(run.status)}`;
+    const headline = stop.at === "failed" && stop.workerStopped
+        ? `Ad run ${runId} — Stopped, its worker went quiet`
+        : stop.at === "failed" && stop.repair
+            ? `Ad run ${runId} — Stopped, a step failed`
+            : `Ad run ${runId} — ${displayRunStatus(run.status)}`;
     const lines = [
         headline,
         ...(carryingOn(run) ? [CARRYING_ON_LINE] : []),

package/dist/commands/workflow.d.ts

@@ -508,7 +508,9 @@ interface RunFlowOptions {
     onProgressLine?: (line: string) => void;
     onWarningLine?: (line: string) => void;
 }
-export declare function formatPauseNotice(pauseReason: WorkflowPauseReason | undefined, runId: string, dashboardUrl: string): string[];
+export declare function formatPauseNotice(pauseReason: WorkflowPauseReason | undefined, runId: string, dashboardUrl: string, { workerStopped }?: {
+    workerStopped?: boolean;
+}): string[];
 export declare function parseRawInputFlags(occurrences: FlagOccurrence[]): Record<string, string>;
 export declare function parseInputFlags(occurrences: FlagOccurrence[], readFile?: (path: string) => string): Record<string, string>;
 export declare const ASSET_UPLOAD_POLICY: Record<WorkflowMediaType, {

package/dist/commands/workflow.js

@@ -4,7 +4,7 @@ import nodePath from "node:path";
 import { apiGet, apiGetText, apiPost, apiPostDashboard, getDashboardUrl, } from "../lib/client.js";
 import { formatApiError } from "../lib/format.js";
 import { pollUntilDone } from "../lib/poll.js";
-import { normalizeRunStatus, isTerminalRunStatus, storedWorkflowStatusForms, TERMINAL_RUN_STATUSES, } from "../lib/runStatus.js";
+import { normalizeRunStatus, isTerminalRunStatus, storedWorkflowStatusForms, isWorkerStoppedPark, TERMINAL_RUN_STATUSES, } from "../lib/runStatus.js";
 import { runVerdict } from "../lib/runVerdict.js";
 import { runDisplayName, runHeadingWord, runTypeWord } from "../lib/runNames.js";
 import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
@@ -354,9 +354,11 @@ Notes:
   its own box on the canvas, sitting on a wire between two steps, so the diagram
   shows exactly where a run will stop. A require-all collector that stalled
   on a dead input is a "repair" park — retry it, skip the dead input, or kill the
-  run. A nested sub-workflow waiting on inputs is a "slots" park — answer it with
-  repeatable --slot key=value flags (run "answer" with no --slot to list the slot
-  ids it wants). The "gate" verbs retired in 2.0 along with the Gate node — the
+  run. A run whose worker stopped partway is also a "repair" park, with nothing
+  dead in it: retry carries it on from where it stopped and keeps every finished
+  step, and skip is refused. (#3820) A nested sub-workflow waiting on inputs is a
+  "slots" park — answer it with repeatable --slot key=value flags (run "answer"
+  with no --slot to list the slot ids it wants). The "gate" verbs retired in 2.0 along with the Gate node — the
   command now prints a pointer at "checkpoint" and exits 1.
 `.trim();
 export function formatRulesLine(provenance) {
@@ -567,7 +569,7 @@ function gateParkedNodeId(status, pauseReason, pausedNodeId) {
 }
 const RETIRED_GATE_VERB_POINTER = "The Gate node retired in 2.0 — runs now pause at a Checkpoint box on the canvas. " +
     "Use: exodus workflow checkpoint <runId> [approve|edit|retry|cancel]";
-export function formatPauseNotice(pauseReason, runId, dashboardUrl) {
+export function formatPauseNotice(pauseReason, runId, dashboardUrl, { workerStopped = false } = {}) {
     if (!pauseReason) {
         return [
             "  ⏸ paused at the cost gate — approve or edit the storyboard in the web app to continue.",
@@ -591,6 +593,13 @@ export function formatPauseNotice(pauseReason, runId, dashboardUrl) {
             "     Then run the workflow again.",
         ];
     }
+    if (pauseReason === "repair" && workerStopped) {
+        return [
+            "  ⏸ the worker stopped partway — retry carries on from where it stopped, finished steps are kept.",
+            `     Resolve here:  exodus workflow repair ${runId} retry|kill`,
+            `     Or in the app: ${dashboardUrl}${RUN_PAGE_PREFIX}${runId}`,
+        ];
+    }
     const resolveVerb = pauseReason === "repair"
         ? `exodus workflow repair ${runId} retry|skip|kill`
         : `exodus workflow answer ${runId} --slot key=value`;
@@ -2121,7 +2130,12 @@ async function waitForRun(runId, opts, deps) {
                 pausedNotified = true;
                 const dashboardUrl = deps.dashboardUrl ?? getDashboardUrl();
                 const pauseReason = raw["pauseReason"];
-                for (const line of formatPauseNotice(pauseReason, runId, dashboardUrl)) {
+                const workerStopped = isWorkerStoppedPark({
+                    status: raw["status"],
+                    pauseReason,
+                    error: raw["error"],
+                });
+                for (const line of formatPauseNotice(pauseReason, runId, dashboardUrl, { workerStopped })) {
                     opts.onProgressLine(line);
                 }
             }
@@ -2996,6 +3010,10 @@ export async function repairFlow(runId, action, opts, deps) {
     const pf = await preflightPark(runId, "repair", verb, opts.json, deps);
     if (!pf.ok)
         return pf.result;
+    if (action === "skip" && isWorkerStoppedPark(pf.run)) {
+        return errLine(`Run ${runId} has nothing to skip — its worker stopped partway. ` +
+            `Carry on from where it stopped (finished steps are kept): exodus workflow repair ${runId} retry`, opts.json);
+    }
     if (action === "kill") {
         const res = await deps.post(CANCEL_PATH, { runId });
         if (!res.ok)

package/dist/lib/runStatus.d.ts

@@ -14,9 +14,15 @@ export declare function isActiveRunStatus(raw: string | null | undefined): boole
 export declare const WORKFLOW_RUN_STATUS_VALUES: readonly ["queued", "running", "awaiting-approval", "succeeded", "succeeded-with-warnings", "failed", "cancelled"];
 export declare const LEGACY_WORKFLOW_RUN_STATUS_VALUES: readonly ["awaiting-review", "completed", "partial", "canceled"];
 export declare function storedWorkflowStatusForms(status: RunStatus): string[];
-export declare function workflowRunPresentation(rawStatus: string | null | undefined, pauseReason?: string | null): {
+export declare function workflowRunPresentation(rawStatus: string | null | undefined, pauseReason?: string | null, workerStopped?: boolean): {
     status: RunStatus;
     label: string;
     tone: RunStatusTone;
     detail?: string;
 };
+export declare const WORKER_STOPPED_PARK_ERROR = "timeout-zombie-sweep: worker stopped heartbeating; finished steps are kept";
+export declare function isWorkerStoppedPark(run: {
+    status?: string | null;
+    pauseReason?: string | null;
+    error?: string | null;
+}): boolean;

package/dist/lib/runStatus.js

@@ -115,7 +115,7 @@ export function storedWorkflowStatusForms(status) {
     const twin = LEGACY_WORKFLOW_TWIN[status];
     return twin ? [status, twin] : [status];
 }
-export function workflowRunPresentation(rawStatus, pauseReason) {
+export function workflowRunPresentation(rawStatus, pauseReason, workerStopped) {
     let status = normalizeRunStatus(rawStatus);
     let detail;
     if (status === "awaiting-approval") {
@@ -127,7 +127,7 @@ export function workflowRunPresentation(rawStatus, pauseReason) {
             detail = "needs inputs";
         }
         else if (pauseReason === "repair") {
-            detail = "needs repair";
+            detail = workerStopped ? "worker stopped" : "needs repair";
         }
     }
     return {
@@ -137,3 +137,9 @@ export function workflowRunPresentation(rawStatus, pauseReason) {
         detail,
     };
 }
+export const WORKER_STOPPED_PARK_ERROR = "timeout-zombie-sweep: worker stopped heartbeating; finished steps are kept";
+export function isWorkerStoppedPark(run) {
+    return (normalizeRunStatus(run.status) === "awaiting-approval" &&
+        run.pauseReason === "repair" &&
+        run.error === WORKER_STOPPED_PARK_ERROR);
+}

package/dist/lib/runVerdict.d.ts

@@ -8,6 +8,7 @@ export interface RunVerdictDelivery {
 export interface RunVerdictInput {
     status?: string | null;
     pauseReason?: string | null;
+    error?: string | null;
     counts?: {
         done?: number;
         failed?: number;

package/dist/lib/runVerdict.js

@@ -1,4 +1,4 @@
-import { RUN_STATUS_LABELS, workflowRunPresentation } from "./runStatus.js";
+import { RUN_STATUS_LABELS, isWorkerStoppedPark, workflowRunPresentation, } from "./runStatus.js";
 export function summarizeDeliveries(deliveries) {
     if (deliveries === undefined || deliveries === null)
         return undefined;
@@ -8,7 +8,7 @@ export function summarizeDeliveries(deliveries) {
     };
 }
 export function runVerdict(run) {
-    const presented = workflowRunPresentation(run.status, run.pauseReason);
+    const presented = workflowRunPresentation(run.status, run.pauseReason, isWorkerStoppedPark(run));
     const delivery = summarizeDeliveries(run.deliveries) ?? run.deliverySummary ?? undefined;
     if ((presented.status === "succeeded" || presented.status === "succeeded-with-warnings") &&
         (run.counts?.failed ?? 0) > 0 &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.10.1700",
+  "version": "2026.10.1900-beta.1",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",