@aicopycoders/exodus 2026.9.2000-beta.10 → 2026.9.2000-beta.12

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

@@ -101,7 +101,7 @@ exodus video approve <runId>                              keep going
 exodus video retry-frame <runId> --node <nodeId> --scene <n>  redo one still at the pixel gate
 exodus video status <runId>                               where it is, per scene
 exodus video pull <runId> --out ./ad-<runId>              every piece + manifest.json
-exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"]
+exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
                                                           redo one clip at the final watch
 exodus video revoice <runId> --all | --scene <n>          redo only the voice; no new video
                                                           … make the cut (your choice of tool)
@@ -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
@@ -602,6 +606,9 @@ scenes[]                             one per scene, in order
                                      on record when the voice pass replaced the
                                      clip with a new file; null when the clip IS
                                      that file, or there is no clip
+  voiceMode                          "voice-first" when the clip was redone voice
+                                     first (its line recorded, then the clip made
+                                     to match it); null otherwise
 provenance                           which saved rulebook this run followed:
                                      {format: {via, nodeId, rigId, rigName,
                                      rulesFrom, specVersion}}. Absent when the
@@ -746,6 +753,7 @@ is no second run, no new storyboard and no re-render of anything else.
 exodus video retry-clip <runId> --scene 3
 exodus video retry-clip <runId> --scene 3 --note "keep both hands in frame on the handshake"
 exodus video retry-clip <runId> --scene 3 --node video-2
+exodus video retry-clip <runId> --scene 3 --voice-first
 ```
 
 `--node` is only needed when a run has clips for that scene on two video steps;
@@ -768,7 +776,17 @@ revoiced and trimmed the same way, with fresh findings and fresh word timings.
 scene's motion prompt only (`withRedoDirection`,
 `scout/src/trigger/workflow-scene-retry.ts`); the spoken line still comes from
 the approved storyboard. Asking for different words in a note will not change
-them. If the words are wrong, that is a new run.
+them. If the script's words are wrong, that is a new run.
+
+**`--voice-first` fixes a clip that said its line wrong** (#2299). It is for a
+clip whose findings include `speech-mismatch`, `speech-repeat`,
+`speech-after-line` or `speech-long-pause`. The scene's line is recorded in each
+speaker's pinned ElevenLabs voice, and MiniMax (`minimax-h3/reference-to-video`)
+makes the clip to match the recording. Only that clip changes; the word check
+and the other checks still run on it. It needs an ElevenLabs key and a voice for
+every speaker in the scene, and it is refused for a scene with no spoken line.
+The clip then reads `clip: redone voice first` in `status`, carries
+`voiceMode: "voice-first"` in the manifest, and is listed in the `pull` summary.
 
 **A redo whose take fails the checks keeps the original clip.** On a finished
 clip the row stays `done` with the ORIGINAL take and only its findings are

package/dist/commands/video.d.ts

@@ -74,6 +74,7 @@ export type ArtifactSubset = {
     speechTrimmed?: boolean;
     tailTrimmed?: boolean;
     rawStorageId?: string;
+    voiceMode?: "voice-first";
 } | {
     type: "audio";
     sceneIndex?: number;
@@ -114,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 {
@@ -161,6 +167,7 @@ export interface NodeItem {
         take: number;
         outcome: string;
         label: string;
+        reason?: string;
         displacedHistory?: {
             title: string;
             lines: string[];
@@ -220,6 +227,8 @@ export type RunStop = {
     showAd?: true;
 } | {
     at: "final-watch";
+    missingScenes?: MissingScene[];
+    framesNodeId?: string;
 } | {
     at: "paused";
     nodeId?: string;
@@ -236,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;
@@ -273,6 +283,7 @@ export interface ManifestScene {
     revoiced: boolean | null;
     speechTrimmed: boolean | null;
     rawStorageId: string | null;
+    voiceMode: "voice-first" | null;
     clipStatus: string;
     error: string | null;
     flagged: boolean;
@@ -411,7 +422,11 @@ export interface ClipRedoTarget {
     nodeId?: string;
 }
 export declare function planClipRedo(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
-export declare function retryClipFlow(runId: string, target: ClipRedoTarget, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export interface ClipRedoOptions {
+    note?: string;
+    voiceFirst?: boolean;
+}
+export declare function retryClipFlow(runId: string, target: ClipRedoTarget, { note, voiceFirst }: ClipRedoOptions, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare const VOICE_PATHS_NEVER_HEARD: Set<string>;
 export declare function planClipRevoice(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
 export type RevoiceTarget = ClipRedoTarget | {

package/dist/commands/video.js

@@ -70,7 +70,9 @@ The whole loop, in order:
 
      exodus video retry-clip <runId> --scene <n>
        Redo ONE finished clip while the run waits for the cut. Everything
-       else stays. A --note steers the motion, never the words.
+       else stays. A --note steers the motion, never the words. Add
+       --voice-first when the words came out wrong: the line is recorded in
+       the character's own voice first, then the clip is made to match it.
 
      exodus video revoice <runId> --all
        Redo only the VOICE on clips that kept the video model's own voice
@@ -93,7 +95,7 @@ Usage:
   exodus video storyboard <runId> [--json]
   exodus video approve <runId> [--approve-stale-cut] [--json]
   exodus video retry-frame <runId> --node <nodeId> --scene <n> [--note "..."] [--json]
-  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--json]
+  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--voice-first] [--json]
   exodus video revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
   exodus video voices <runId> [--set <character>=<voiceId>] [--clear <character>] [--from <file.json>] [--json]
   exodus video pull <runId> --out <dir> [--json]
@@ -113,6 +115,9 @@ Options:
                        (retry-frame, retry-clip, revoice)
   --all                Every finished clip that kept the video model's voice
                        (revoice)
+  --voice-first        Record the scene's line in the character's own voice,
+                       then make the clip to match it (retry-clip). For a clip
+                       whose words came out wrong
   --approve-stale-cut  Deliver the cut you uploaded even though a clip changed
                        after you uploaded it (approve). Without it, approving
                        stops and names the scenes that changed
@@ -151,6 +156,7 @@ Examples:
   exodus video approve run_123
   exodus video retry-frame run_123 --node frames-1 --scene 2
   exodus video retry-clip run_123 --scene 3 --note "keep the handshake in frame"
+  exodus video retry-clip run_123 --scene 3 --voice-first
   exodus video revoice run_123 --all
   exodus video voices run_123
   exodus video voices run_123 --set C1=abc123voiceid --set "HOST 2=def456voiceid"
@@ -171,6 +177,9 @@ const FLAG_PATH = "/api/v2/video/storyboard/flag";
 const APPROVE_PATH = "/api/v2/workflow/approve";
 const SCENE_RETRY_PATH = "/api/v2/workflow/scene/retry";
 const SCENE_REVOICE_PATH = "/api/v2/workflow/scene/revoice";
+const SCENE_VOICE_FIRST_PATH = "/api/v2/workflow/scene/voice-first";
+const VOICE_FIRST_NOT_ON_THIS_SERVER = "This Exodus server cannot redo a clip voice first yet, so nothing was started and nothing " +
+    "was spent. It arrives with the next server update.";
 const REVOICE_NOT_ON_THIS_SERVER = "This Exodus server does not have the voice redo yet, so nothing was started and nothing " +
     "was spent. It arrives with the next server update.";
 const FINAL_PATH = "/api/v2/video/final";
@@ -214,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)
@@ -337,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");
@@ -350,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")
@@ -395,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 = [
@@ -411,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.",
@@ -540,6 +588,7 @@ function clipFromArtifact(sceneIndex, artifact) {
         revoiced: artifact.revoiced === true,
         speechTrimmed: artifact.speechTrimmed === true,
         rawStorageId: artifact.rawStorageId ?? null,
+        voiceMode: artifact.voiceMode ?? null,
     };
 }
 function keyframeDownload(sceneIndex, imageUrl) {
@@ -849,6 +898,7 @@ export function planPull(run, items, opts) {
             revoiced: clip ? clip.revoiced : null,
             speechTrimmed: clip ? clip.speechTrimmed : null,
             rawStorageId: clip ? clip.rawStorageId : null,
+            voiceMode: clip ? clip.voiceMode : null,
             clipStatus: item?.status ?? "missing",
             error: item?.error ?? null,
             flagged: item?.flagged === true,
@@ -922,6 +972,7 @@ export function markPullFailure(manifest, failure) {
             scene.revoiced = null;
             scene.speechTrimmed = null;
             scene.rawStorageId = null;
+            scene.voiceMode = null;
         }
         if (scene.voice === failure.file)
             scene.voice = null;
@@ -1419,8 +1470,14 @@ export async function statusFlow(runId, json, deps) {
         };
     }
     const revoicedByScene = new Set();
+    const voiceFirstByScene = new Set();
     const timedOnOriginalVoice = new Set();
     for (const artifact of outputsOfNodeKind(run, "video")) {
+        if (artifact.type === "video" &&
+            artifact.voiceMode === "voice-first" &&
+            typeof artifact.sceneIndex === "number") {
+            voiceFirstByScene.add(artifact.sceneIndex);
+        }
         if (artifact.type === "video" && artifact.revoiced === true && typeof artifact.sceneIndex === "number") {
             revoicedByScene.add(artifact.sceneIndex);
             if ((artifact.words?.length ?? 0) > 0)
@@ -1461,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) {
@@ -1470,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)
@@ -1489,6 +1546,8 @@ export async function statusFlow(runId, json, deps) {
                 lines.push(`       ${row.clip.error}`);
             if (revoicedByScene.has(sceneIndex))
                 lines.push("       voice: cast voice applied");
+            if (voiceFirstByScene.has(sceneIndex))
+                lines.push("       clip: redone voice first");
             if (timedOnOriginalVoice.has(sceneIndex)) {
                 lines.push("       word timings: measured on the original voice (close, not frame-exact)");
             }
@@ -1789,7 +1848,7 @@ function findClipRow(run, items, target) {
     }
     return { row, uploadedCut };
 }
-export async function retryClipFlow(runId, target, note, json, deps) {
+export async function retryClipFlow(runId, target, { note, voiceFirst = false }, json, deps) {
     const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
     if (!runRes.ok)
         return errorResult(runRes, json);
@@ -1805,12 +1864,20 @@ export async function retryClipFlow(runId, target, note, json, deps) {
             lines: json ? [JSON.stringify({ ok: false, error: plan.reason })] : [plan.reason],
         };
     }
-    const res = await deps.post(SCENE_RETRY_PATH, {
+    const res = await deps.post(voiceFirst ? SCENE_VOICE_FIRST_PATH : SCENE_RETRY_PATH, {
         runId,
         nodeId: plan.nodeId,
         sceneIndex: plan.sceneIndex,
         ...(note ? { note } : {}),
     });
+    if (voiceFirst && missingRouteLine(res, "exodus video retry-clip --voice-first")) {
+        return {
+            code: 1,
+            lines: json
+                ? [JSON.stringify({ ok: false, status: 404, error: VOICE_FIRST_NOT_ON_THIS_SERVER })]
+                : [VOICE_FIRST_NOT_ON_THIS_SERVER],
+        };
+    }
     if (!res.ok)
         return errorResult(res, json);
     const triggerRunId = res.data.triggerRunId;
@@ -1829,6 +1896,7 @@ export async function retryClipFlow(runId, target, note, json, deps) {
                     reviewUrl: review,
                     warnings: plan.warnings,
                     ...(note ? { note } : {}),
+                    ...(voiceFirst ? { voiceMode: "voice-first" } : {}),
                 }),
             ],
         };
@@ -1836,7 +1904,10 @@ export async function retryClipFlow(runId, target, note, json, deps) {
     return {
         code: 0,
         lines: [
-            `Redoing scene ${plan.sceneIndex}'s clip on ${plan.nodeId}.`,
+            voiceFirst
+                ? `Redoing scene ${plan.sceneIndex}'s clip on ${plan.nodeId}, voice first: the line is ` +
+                    "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.",
             ...(note
@@ -2207,6 +2278,11 @@ export async function pullFlow(runId, dir, json, deps) {
         `Every piece is indexed in ${path.join(dir, "manifest.json")} — scene numbers there are the run's own.`,
         ...musicLines(plan.manifest),
     ];
+    const voiceFirst = plan.manifest.scenes.filter((s) => s.voiceMode === "voice-first");
+    if (voiceFirst.length > 0) {
+        lines.push("", `Redone voice first (the line recorded, then the clip made to match it): ` +
+            `scene${voiceFirst.length === 1 ? "" : "s"} ${voiceFirst.map((s) => s.sceneIndex).join(", ")}`);
+    }
     const flagged = plan.manifest.scenes.filter((s) => s.flagged);
     if (flagged.length > 0) {
         lines.push("", `${flagged.length} clip${flagged.length === 1 ? "" : "s"} came back flagged — usable, but look before you cut:`);
@@ -2583,7 +2659,7 @@ export async function run(flags, occurrences) {
         if (!Number.isInteger(sceneIndex)) {
             usage(`video retry-clip --scene must be a whole scene number, not "${sceneRaw}".`);
         }
-        return printResult(await retryClipFlow(runId, { sceneIndex, nodeId: flagString(flags, "node") }, flagString(flags, "note"), json, defaultDeps));
+        return printResult(await retryClipFlow(runId, { sceneIndex, nodeId: flagString(flags, "node") }, { note: flagString(flags, "note"), voiceFirst: flags["voice-first"] === true }, json, defaultDeps));
     }
     if (sub === "revoice") {
         const sceneRaw = flagString(flags, "scene");

package/dist/commands/workflow.d.ts

@@ -409,7 +409,7 @@ export interface RunFormatProvenance {
     };
     specVersion: string | null;
 }
-export type VoicePath = "sts-revoice" | "lipsync-retarget" | "native-prompt" | "omni-audio-ids" | "gemini-direct";
+export type VoicePath = "sts-revoice" | "lipsync-retarget" | "native-prompt" | "omni-audio-ids" | "gemini-direct" | "voice-first";
 export type RunVoiceProvenance = {
     source: "show";
     path: VoicePath;

package/package.json

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