@aicopycoders/exodus 2026.10.1701-beta.1 → 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

@@ -457,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

@@ -168,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.
@@ -207,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:
@@ -1457,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",
@@ -1531,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 } : {}),
@@ -1644,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))
@@ -1667,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);
@@ -1681,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,
@@ -1700,6 +1748,7 @@ function stoppedAtScriptResult(data, json) {
                     script,
                     ...(tidied ? { tidied } : {}),
                     ...(written !== null ? { written } : {}),
+                    ...(rewritten !== null ? { rewritten } : {}),
                 }),
             ],
         };
@@ -1708,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}` : "")),
             "",
@@ -1792,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);
@@ -1811,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,
@@ -1844,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)] };
@@ -2045,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;

package/dist/lib/runStatus.d.ts

@@ -14,7 +14,7 @@ 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;

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 {

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.1701-beta.1",
+  "version": "2026.10.1900-beta.1",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",