@aicopycoders/exodus 2026.9.2000-beta.11 → 2026.9.2000-beta.13

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

@@ -138,7 +138,11 @@ under it:
   lines under `guidance`). It is also
   the one park where a finished clip can be redone, with `retry-clip`. A run
   only reaches this park if its video node sets `finalWatch: true` — otherwise
-  it skips straight to finished.
+  it skips straight to finished. If a scene has no clip, the stop block names
+  it instead (`stop.missingScenes` in `--json`) and approval is refused until
+  it has one. A scene whose picture the video service refused needs
+  `retry-frame --note` before `retry-clip`; the clip redo alone resends the
+  refused picture.
 - paused: a builder checkpoint neither video verb resolves —
   `exodus workflow checkpoint <runId>` is the verb for that one.
 - failed: `status` shows how far it got, and a `--wait` that was running exits

package/dist/commands/video.d.ts

@@ -115,6 +115,11 @@ export interface VideoRunNode {
     planFailure?: PlanFailureRecord;
     hasRejectedDraft?: boolean;
     outputs?: ArtifactSubset[];
+    missingScenes?: MissingScene[];
+}
+export interface MissingScene {
+    sceneIndex: number;
+    pictureRefused: boolean;
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
 export interface PullCastLockMember {
@@ -162,6 +167,7 @@ export interface NodeItem {
         take: number;
         outcome: string;
         label: string;
+        reason?: string;
         displacedHistory?: {
             title: string;
             lines: string[];
@@ -221,6 +227,8 @@ export type RunStop = {
     showAd?: true;
 } | {
     at: "final-watch";
+    missingScenes?: MissingScene[];
+    framesNodeId?: string;
 } | {
     at: "paused";
     nodeId?: string;
@@ -237,10 +245,11 @@ export type RunStop = {
 };
 export type ResolvedStop = Exclude<RunStop, {
     at: "final-watch";
-}> | {
+}> | (Extract<RunStop, {
     at: "final-watch";
+}> & {
     cutAttached: boolean | null;
-};
+});
 export declare function classifyRun(run: VideoRun): RunStop;
 export declare function hasAttachedCut(items: NodeItem[]): boolean;
 export declare function resolveStop(stop: RunStop, cutAttached: boolean | null): ResolvedStop;

package/dist/commands/video.js

@@ -223,6 +223,9 @@ export function renderQcTakeHistory(takes) {
     });
     return lines;
 }
+function redoLine(lastRedo) {
+    return lastRedo.reason ? `${lastRedo.label}: ${lastRedo.reason}` : lastRedo.label;
+}
 function printDisplacedHistory(lines, lastRedo) {
     const history = lastRedo.displacedHistory;
     if (!history)
@@ -346,8 +349,17 @@ export function classifyRun(run) {
                 ...(isShowAd(run) ? { showAd: true } : {}),
             };
         }
-        if (parkedAtFinalWatch(run))
-            return { at: "final-watch" };
+        if (parkedAtFinalWatch(run)) {
+            const missingScenes = run.nodes
+                .filter((n) => n.kind === "video")
+                .flatMap((n) => n.missingScenes ?? []);
+            const framesNodeId = run.nodes.find((n) => n.kind === "scene-frames")?.nodeId;
+            return {
+                at: "final-watch",
+                ...(missingScenes.length > 0 ? { missingScenes } : {}),
+                ...(missingScenes.length > 0 && framesNodeId ? { framesNodeId } : {}),
+            };
+        }
         return { at: "paused", nodeId: run.pausedNodeId, reason: run.pauseReason };
     }
     const active = run.nodes.find((n) => n.status === "running");
@@ -359,7 +371,7 @@ export function hasAttachedCut(items) {
 export function resolveStop(stop, cutAttached) {
     if (stop.at !== "final-watch")
         return stop;
-    return { at: "final-watch", cutAttached };
+    return { ...stop, cutAttached };
 }
 export async function resolveStopAtPark(stop, runId, deps) {
     if (stop.at !== "final-watch")
@@ -404,6 +416,30 @@ export function reviewUrl(dashboardUrl, run) {
         return `${dashboardUrl}/workflows/${run.workflowId}/runs/${run._id}`;
     return `${dashboardUrl}/runs/${run._id}`;
 }
+function scenesPhrase(scenes) {
+    if (scenes.length === 1)
+        return `scene ${scenes[0]}`;
+    return `scenes ${scenes.slice(0, -1).join(", ")} and ${scenes[scenes.length - 1]}`;
+}
+function missingSceneLines(missing, framesNodeId, runId, runUrl) {
+    const scenes = missing.map((m) => m.sceneIndex);
+    const lines = [
+        `Parked: ${scenesPhrase(scenes)} ${scenes.length === 1 ? "has" : "have"} no clip yet, so the ad isn't complete.`,
+    ];
+    for (const { sceneIndex, pictureRefused } of missing) {
+        if (!pictureRefused) {
+            lines.push(`Redo clip ${sceneIndex}:     exodus video retry-clip ${runId} --scene ${sceneIndex}`);
+            continue;
+        }
+        lines.push(`Scene ${sceneIndex}'s picture was refused by the video service as too close to an existing character, so redraw it before redoing the clip.`);
+        lines.push(framesNodeId
+            ? `Redraw frame ${sceneIndex}:  exodus video retry-frame ${runId} --node ${framesNodeId} --scene ${sceneIndex} --note "<what to change>"`
+            : `Redraw frame ${sceneIndex}:  on the run page, ${runUrl}`);
+        lines.push(`Then redo clip ${sceneIndex}: exodus video retry-clip ${runId} --scene ${sceneIndex}`);
+    }
+    lines.push("The ad can't be approved until every scene has a clip.", `Watch it here:   ${runUrl}`);
+    return lines;
+}
 export function stopLines(stop, runId, runUrl) {
     if (stop.at === "storyboard-gate") {
         const lines = [
@@ -420,6 +456,9 @@ export function stopLines(stop, runId, runUrl) {
         return lines;
     }
     if (stop.at === "final-watch") {
+        if (stop.missingScenes?.length) {
+            return missingSceneLines(stop.missingScenes, stop.framesNodeId, runId, runUrl);
+        }
         if (stop.cutAttached === null) {
             return [
                 "Parked: every piece is made.",
@@ -1479,7 +1518,7 @@ export async function statusFlow(runId, json, deps) {
             const row = byScene.get(sceneIndex);
             lines.push(`${String(sceneIndex).padEnd(5)}  ${itemWord(row.clip).padEnd(8)}  ${itemWord(row.voiceover).padEnd(8)}  ${itemWord(row.frame)}`);
             if (row.clip?.lastRedo) {
-                lines.push(`       clip: ${row.clip.lastRedo.label}`);
+                lines.push(`       clip: ${redoLine(row.clip.lastRedo)}`);
                 printDisplacedHistory(lines, row.clip.lastRedo);
             }
             if (row.clip?.lastRedo || row.clip?.flagged) {
@@ -1488,7 +1527,7 @@ export async function statusFlow(runId, json, deps) {
                 }
             }
             if (row.voiceover?.lastRedo) {
-                lines.push(`       voice: ${row.voiceover.lastRedo.label}`);
+                lines.push(`       voice: ${redoLine(row.voiceover.lastRedo)}`);
                 printDisplacedHistory(lines, row.voiceover.lastRedo);
             }
             if (row.frame?.lastRedo)
@@ -1870,7 +1909,12 @@ export async function retryClipFlow(runId, target, { note, voiceFirst = false },
                     "recorded in the character's own voice, then the clip is made to match it."
                 : `Redoing scene ${plan.sceneIndex}'s clip on ${plan.nodeId}.`,
             `triggerRunId: ${triggerRunId ?? "-"}`,
-            "Every other scene stays as it is, and so do the pictures, the voices and the script.",
+            ...(voiceFirst
+                ? [
+                    "Every other scene stays as it is, and so do the pictures and the script.",
+                    "A speaking character with no voice yet gets one picked and saved for the whole run.",
+                ]
+                : ["Every other scene stays as it is, and so do the pictures, the voices and the script."]),
             ...(note
                 ? ["Your note steers how this clip moves. It never changes the words that are spoken."]
                 : []),

package/package.json

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