@aicopycoders/exodus 2026.9.2000-beta.1 → 2026.9.2000-beta.3

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

@@ -104,7 +104,10 @@ under it:
 - storyboard gate: needs `approve`. When the stop block prints a `Redo one
   frame:` line with a node id, one still can be redone first with `retry-frame`;
   a gate parked before the stills are drawn has nothing to redraw.
-- final watch: every piece is made; needs `pull`, a cut, and `upload`. It is also
+- final watch: every piece is made; needs `pull`, a cut, and `upload`. Once a
+  cut is uploaded the stop block leads with `approve` instead, and `status
+  --json` says which state it is in (`stop.cutAttached`, plus the same next-step
+  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.
@@ -677,8 +680,11 @@ them. If the words are wrong, that is a new run.
 **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
 refreshed, because a worse take must never replace a delivered one. So never
-report that the clip changed. Read `status` again for the new findings, then pull
-and compare the file before and after.
+report that the clip changed without reading `status` again: under the scene it
+prints what the redo did, `new take accepted (take N)` or `new take rejected,
+original kept (take N)`, and `status --json` carries the same sentence on the
+row as `lastRedo.label`. A row with no `lastRedo` was redone before outcomes
+were recorded; for those, pull and compare the file before and after.
 
 **Re-cut afterwards.** A cut you already uploaded still holds the old clip, and
 the CLI says so when that is the case. Pull again, re-cut and upload again before

package/dist/commands/genesis.js

@@ -1,6 +1,5 @@
 import { readFileSync, existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { createInterface } from "node:readline/promises";
 import { apiGet, apiPost, getDashboardUrl } from "../lib/client.js";
 import { pollUntilDone } from "../lib/poll.js";
 import { displayRunStatus, formatGenesisRun, formatError, tickerRunStatus } from "../lib/format.js";
@@ -278,52 +277,13 @@ export async function run(flags) {
             return submitGenesis(action.body, { noWait, cc });
     }
 }
-async function listBank(limit) {
-    const res = await apiGet(`/api/v2/scout/bank?limit=${limit}`);
-    if (!res.ok) {
-        console.log(formatError(res));
-        process.exit(1);
-    }
-    const ideas = Array.isArray(res.data.ideas) ? res.data.ideas : [];
-    if (ideas.length === 0) {
-        console.log("Bank is empty.");
-        console.log('Fill it with: exodus genesis scrape   (or paste a reel: exodus genesis --reel "<url>")');
-        return;
-    }
-    console.log(`## Idea Bank (${ideas.length} reel${ideas.length === 1 ? "" : "s"})`);
-    console.log("");
-    for (const i of ideas) {
-        const hook = i.hook ?? "(no hook)";
-        const user = typeof i.sourceUsername === "string" && i.sourceUsername.length > 0
-            ? `  @${i.sourceUsername.replace(/^@+/, "")}`
-            : "";
-        const score = typeof i.relevanceScore === "number" ? ` score=${i.relevanceScore.toFixed(2)}` : "";
-        const used = typeof i.useCount === "number" && i.useCount > 0 ? " · used" : "";
-        console.log(`  • ${hook}${user}${score}`);
-        console.log(`    id: ${i._id ?? "?"}  [${i.status ?? "new"}${used}]`);
-        if (i.sourceUrl)
-            console.log(`    ${i.sourceUrl}`);
-    }
-    console.log("");
-    console.log("Write from one:  exodus genesis --from-bank --idea <id>");
+async function listBank(_limit) {
+    console.error(`This command has been retired. View the idea bank in the dashboard: ${getDashboardUrl()}/idea-bank`);
+    process.exit(1);
 }
-async function runFromBank(ideaId, opts, rt) {
-    const res = await apiPost("/api/v2/scout/bank/ideas", { ideaIds: [ideaId] }, { ccCommand: rt.cc });
-    if (!res.ok) {
-        console.log(formatError(res));
-        process.exit(1);
-    }
-    const idea = (res.data.ideas ?? [])[0];
-    if (!idea) {
-        console.error(`No banked idea found for id "${ideaId}". List the bank: exodus genesis --from-bank`);
-        process.exit(1);
-    }
-    if (!idea.sourceUrl) {
-        console.error(`Banked idea "${ideaId}" has no source reel URL to write from.`);
-        process.exit(1);
-    }
-    console.log(`Writing from banked reel: ${idea.sourceUrl}`);
-    return runReel([idea.sourceUrl], opts, rt);
+async function runFromBank(_ideaId, _opts, _rt) {
+    console.error(`This command has been retired. Write from banked ideas in the dashboard: ${getDashboardUrl()}/idea-bank`);
+    process.exit(1);
 }
 async function runReel(urls, opts, rt) {
     console.log(`Transcribing ${urls.length === 1 ? "the reel" : `${urls.length} reels`} → idea → Genesis…`);
@@ -613,92 +573,11 @@ function requireActiveBrand() {
     }
     return slug;
 }
-async function runConnectInstagram(flags, cc) {
-    const client = requireActiveBrand();
-    const start = await apiPost("/api/v2/genesis/instagram/connect/start", { client }, { ccCommand: cc });
-    if (!start.ok || !start.data.liveViewUrl) {
-        console.log(formatError(start));
-        process.exit(1);
-    }
-    console.log(`\nConnecting an Instagram account to brand "${client}".`);
-    console.log("\n1. Open this link in your browser:\n");
-    console.log(`   ${start.data.liveViewUrl}\n`);
-    console.log('2. Go to instagram.com and log into the account for THIS brand.');
-    console.log("3. Scroll your feed for a bit so the algorithm learns the niche.");
-    console.log("4. Come back here and press Enter.\n");
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        await rl.question("Press Enter once you're logged in and done grooming... ");
-        let username = typeof flags["username"] === "string" ? flags["username"].trim() : "";
-        while (!username) {
-            username = (await rl.question("Instagram handle you just logged in as (e.g. mybrand): ")).trim();
-        }
-        const finish = await apiPost("/api/v2/genesis/instagram/connect/finish", { client, igUsername: username }, { ccCommand: cc });
-        if (!finish.ok) {
-            console.log(formatError(finish));
-            process.exit(1);
-        }
-        console.log(`\n✓ Instagram @${username.replace(/^@+/, "")} connected to "${client}".`);
-        console.log("Fill the idea bank now:  exodus genesis scrape --organic");
-    }
-    finally {
-        rl.close();
-    }
+async function runConnectInstagram(_flags, _cc) {
+    console.error(`This command has been retired. Connect Instagram accounts in the dashboard: ${getDashboardUrl()}/settings`);
+    process.exit(1);
 }
-async function runScrape(flags, cc) {
-    const client = requireActiveBrand();
-    const noWait = flags["wait"] === false || flags["no-wait"] === true;
-    if (flags["organic"] === true) {
-        const smoke = flags["smoke"] === true;
-        const res = await apiPost("/api/v2/scout/organic", { client, ...(smoke ? { smoke: true } : {}) }, { ccCommand: cc });
-        if (!res.ok || !res.data.runId) {
-            console.log(formatError(res));
-            process.exit(1);
-        }
-        console.log(`Organic scrape started for "${client}": ${res.data.runId}${smoke ? " (smoke)" : ""}`);
-        return pollScrape(res.data.runId, noWait, 1_800_000);
-    }
-    const term = typeof flags["term"] === "string" ? flags["term"] : undefined;
-    const body = { sourceMode: "fresh", client };
-    if (term)
-        body.term = term;
-    const res = await apiPost("/api/v2/scout", body, { ccCommand: cc });
-    if (!res.ok || !res.data.runId) {
-        console.log(formatError(res));
-        process.exit(1);
-    }
-    console.log(`Discovery scrape started for "${client}": ${res.data.runId}`);
-    return pollScrape(res.data.runId, noWait, 1_200_000);
-}
-async function pollScrape(runId, noWait, timeoutMs) {
-    if (noWait) {
-        console.log(`Run ID: ${runId}`);
-        console.log(`Check status: exodus status --type scout --id ${runId}`);
-        return;
-    }
-    console.log("Polling for completion...");
-    const result = await pollUntilDone({
-        path: `/api/v2/scout?runId=${runId}`,
-        intervalMs: 15_000,
-        timeoutMs,
-        onProgress: (data) => {
-            const status = data["status"];
-            const captured = data["organicCaptured"];
-            const qualified = data["organicQualified"];
-            const counts = captured !== undefined || qualified !== undefined
-                ? ` captured=${captured ?? 0} qualified=${qualified ?? 0}`
-                : "";
-            if (status)
-                process.stdout.write(`\r  status: ${tickerRunStatus(status)}${counts}              `);
-        },
-    });
-    console.log();
-    if (result.timedOut) {
-        console.log(`Timed out waiting. Check later: exodus status --type scout --id ${runId}`);
-    }
-    else {
-        console.log(`Done. Banked reels are ready to write: exodus genesis --from-bank`);
-    }
-    if (!result.ok && !result.timedOut)
-        process.exit(1);
+async function runScrape(_flags, _cc) {
+    console.error(`This command has been retired. Fill the idea bank from the Mining page in the dashboard: ${getDashboardUrl()}/mining`);
+    process.exit(1);
 }

package/dist/commands/status.js

@@ -1,6 +1,5 @@
-import { apiGet } from "../lib/client.js";
+import { apiGet, getDashboardUrl } from "../lib/client.js";
 import { formatGeneration, formatGenesisRun, formatError, displayRunStatus } from "../lib/format.js";
-import { hydrateScoutIdeasCount } from "../lib/scout-hydrate.js";
 import { formatIntelResult as formatIntelResultRich } from "../lib/intel-format.js";
 export const helpText = `
 exodus status — Check the status of a pipeline run
@@ -12,19 +11,13 @@ Required:
   --id <runId>           The generation or run ID returned by a prior exodus command
 
 Options:
-  --type <pipeline>      Pipeline type: generation (default) | genesis | intel | pulse | scout
+  --type <pipeline>      Pipeline type: generation (default) | genesis | intel | pulse
                          | creative | template
                          Spark, Viral, Mirror, Remix runs use --type generation (default).
-                         Intel, Pulse, Scout require --type intel|pulse|scout.
+                         Intel, Pulse require --type intel|pulse.
                          Creative-suite (native/copy-derived/ref-match/meme)
                          use --type creative; Template uses --type template.
 `.trim();
-async function fetchScoutIdeasCount(runId) {
-    const res = await apiGet(`/api/v2/scout/ideas?runId=${runId}&limit=1`);
-    if (res.ok && typeof res.data.count === "number")
-        return res.data.count;
-    return null;
-}
 export function formatIntelResult(data) {
     return formatIntelResultRich(data).replace("## Intel Analysis Result", "## Intel Status");
 }
@@ -157,18 +150,21 @@ export async function run(flags) {
         process.exit(1);
     }
     const type = flags["type"] ?? "generation";
+    if (type === "scout") {
+        console.error(`--type scout has been retired. Check run status in the dashboard: ${getDashboardUrl()}/runs`);
+        process.exit(1);
+    }
     const pathMap = {
         generation: `/api/v2/generations?id=${id}`,
         genesis: `/api/v2/genesis?id=${id}`,
         intel: `/api/v2/intel?id=${id}`,
         pulse: `/api/v2/pulse?id=${id}`,
-        scout: `/api/v2/scout?runId=${id}`,
         creative: `/api/v2/creative?runId=${id}`,
         template: `/api/v2/template?runId=${id}`,
     };
     const path = pathMap[type];
     if (!path) {
-        console.error(`Unknown type: "${type}". Valid types: generation, genesis, intel, pulse, scout, creative, template`);
+        console.error(`Unknown type: "${type}". Valid types: generation, genesis, intel, pulse, creative, template`);
         process.exit(1);
     }
     const res = await apiGet(path);
@@ -176,9 +172,6 @@ export async function run(flags) {
         console.log(formatError(res));
         process.exit(1);
     }
-    if (type === "scout") {
-        await hydrateScoutIdeasCount(id, res.data, fetchScoutIdeasCount);
-    }
     switch (type) {
         case "generation":
             console.log(formatGeneration(res.data));
@@ -192,9 +185,6 @@ export async function run(flags) {
         case "pulse":
             console.log(formatPulseResult(res.data));
             break;
-        case "scout":
-            console.log(formatScoutResult(res.data));
-            break;
         case "creative":
             console.log(formatCreativeSuiteStatus("Creative Suite Status", res.data));
             break;

package/dist/commands/video.d.ts

@@ -72,7 +72,7 @@ export type ArtifactSubset = {
 export interface VideoRunNode {
     nodeId: string;
     kind: string;
-    status: "idle" | "running" | "done" | "failed" | "skipped";
+    status: "idle" | "running" | "done" | "failed" | "skipped" | "out-of-scope";
     error?: string;
     warning?: string;
     outputs?: ArtifactSubset[];
@@ -117,6 +117,11 @@ export interface NodeItem {
     flagged?: boolean;
     findings?: ClipFinding[];
     staleClaim?: boolean;
+    lastRedo?: {
+        take: number;
+        outcome: string;
+        label: string;
+    };
     artifact?: ArtifactSubset;
 }
 export interface ShowRow {
@@ -184,11 +189,20 @@ export type RunStop = {
     at: "finished";
     status: string;
 };
+export type ResolvedStop = Exclude<RunStop, {
+    at: "final-watch";
+}> | {
+    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;
+export declare function resolveStopAtPark(stop: RunStop, runId: string, deps: Pick<VideoDeps, "get">): Promise<ResolvedStop>;
 export declare function stageWord(stage: string): string;
 export declare function stepName(kind: string | undefined): string;
 export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId" | "moduleOwned">): string;
-export declare function stopLines(stop: RunStop, runId: string, runUrl: string): string[];
+export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string): string[];
 export interface PullDownload {
     file: string;
     url: string;
@@ -279,7 +293,10 @@ export declare function waitFlow(runId: string, opts: {
 }, deps: VideoDeps): Promise<FlowResult>;
 export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function storyboardFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
-export declare function approveFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function approveFlow(runId: string, opts: {
+    json: boolean;
+    approveStaleCut: boolean;
+}, deps: VideoDeps): Promise<FlowResult>;
 export declare function flagFlow(runId: string, note: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function retryFrameFlow(runId: string, nodeId: string, sceneIndex: number, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export type ClipRedoPlan = {

package/dist/commands/video.js

@@ -62,12 +62,14 @@ The whole loop, in order:
       Attaches your cut to the run and prints the page to approve it on.
 
   11. exodus video approve <runId>
-      Or click Approve on the page from step 10.
+      Or click Approve on the page from step 10. If you redid a clip after
+      uploading, this stops and says which scenes changed. Upload a fresh cut,
+      or add --approve-stale-cut to deliver the cut you already uploaded.
 
 Usage:
   exodus video status <runId> [--json]
   exodus video storyboard <runId> [--json]
-  exodus video approve <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 revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
@@ -88,6 +90,9 @@ Options:
                        (retry-frame, retry-clip, revoice)
   --all                Every finished clip that kept the video model's voice
                        (revoice)
+  --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
   --set <who>=<id>     Give a character an ElevenLabs voice (voices). Name the
                        character by its ID or by the name your script uses.
                        Repeat it once per character
@@ -254,6 +259,22 @@ export function classifyRun(run) {
     const active = run.nodes.find((n) => n.status === "running");
     return { at: "running", stage: active?.kind ?? "starting" };
 }
+export function hasAttachedCut(items) {
+    return items.some((i) => i.itemKind === "final" && i.status === "done");
+}
+export function resolveStop(stop, cutAttached) {
+    if (stop.at !== "final-watch")
+        return stop;
+    return { at: "final-watch", cutAttached };
+}
+export async function resolveStopAtPark(stop, runId, deps) {
+    if (stop.at !== "final-watch")
+        return stop;
+    const res = await deps.get(`${ITEMS_PATH}?runId=${encodeURIComponent(runId)}`);
+    if (!res.ok)
+        return resolveStop(stop, null);
+    return resolveStop(stop, hasAttachedCut(res.data.items ?? []));
+}
 const STAGE_WORDS = {
     brief: "reading the script",
     storyboard: "writing the storyboard",
@@ -300,6 +321,21 @@ export function stopLines(stop, runId, runUrl) {
         return lines;
     }
     if (stop.at === "final-watch") {
+        if (stop.cutAttached === null) {
+            return [
+                "Parked: every piece is made.",
+                `Couldn't check whether a cut is already uploaded. See where it stands: exodus video status ${runId}`,
+                `Watch it here:   ${runUrl}`,
+            ];
+        }
+        if (stop.cutAttached) {
+            return [
+                "Parked: your cut is uploaded and waiting for your approval.",
+                `Approve it:      exodus video approve ${runId}`,
+                `Watch it here:   ${runUrl}`,
+                "Changed your mind? You can still redo a clip and upload a new cut.",
+            ];
+        }
         return [
             "Parked: every piece is made and the run is waiting for a cut.",
             `Pull the pieces: exodus video pull ${runId} --out ./ad-${runId}`,
@@ -891,15 +927,16 @@ export async function waitFlow(runId, opts, deps) {
             }
             continue;
         }
+        const resolved = await resolveStopAtPark(stop, runId, deps);
         if (opts.json) {
             return {
                 code: stop.at === "failed" ? 1 : 0,
-                lines: [JSON.stringify({ runId, stop, status: run.status, url: opts.url })],
+                lines: [JSON.stringify({ runId, stop: resolved, status: run.status, url: opts.url })],
             };
         }
         return {
             code: stop.at === "failed" ? 1 : 0,
-            lines: [...lines, ...stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run))],
+            lines: [...lines, ...stopLines(resolved, runId, reviewUrl(deps.dashboardUrl, run))],
         };
     }
     const timeoutLine = `Still running after ${Math.round((maxPolls * interval) / 60000)} minutes. Check in with: exodus video status ${runId}`;
@@ -924,6 +961,11 @@ function itemWord(item) {
         return "flagged";
     return ITEM_STATUS_WORD[item.status] ?? item.status;
 }
+const CARRYING_ON_LINE = "Waiting for a worker to carry on. Everything finished so far is kept — the run picks up from there by itself.";
+function carryingOn(run) {
+    return (run.status === "queued" &&
+        run.nodes.some((n) => n.status !== "idle" && n.status !== "out-of-scope"));
+}
 export async function statusFlow(runId, json, deps) {
     const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
     if (!runRes.ok)
@@ -933,15 +975,18 @@ export async function statusFlow(runId, json, deps) {
     if (!itemsRes.ok)
         return errorResult(itemsRes, json);
     const items = itemsRes.data.items ?? [];
-    const stop = classifyRun(run);
-    const hasFinal = items.some((i) => i.itemKind === "final" && i.status === "done");
+    const hasFinal = hasAttachedCut(items);
+    const stop = resolveStop(classifyRun(run), hasFinal);
+    const guidance = stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run));
     const warnings = run.nodes
         .filter((n) => n.warning)
         .map((n) => ({ nodeId: n.nodeId, step: n.kind, warning: n.warning }));
     if (json) {
         return {
             code: 0,
-            lines: [JSON.stringify({ runId, status: run.status, stop, items, hasFinal, warnings })],
+            lines: [
+                JSON.stringify({ runId, status: run.status, stop, items, hasFinal, warnings, guidance }),
+            ],
         };
     }
     const revoicedByScene = new Set();
@@ -972,7 +1017,8 @@ export async function statusFlow(runId, json, deps) {
         : `Ad run ${runId} — ${displayRunStatus(run.status)}`;
     const lines = [
         headline,
-        ...stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run)),
+        ...(carryingOn(run) ? [CARRYING_ON_LINE] : []),
+        ...guidance,
         ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
         ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
     ];
@@ -984,6 +1030,12 @@ export async function statusFlow(runId, json, deps) {
         for (const sceneIndex of [...byScene.keys()].sort((a, b) => a - b)) {
             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}`);
+            if (row.voiceover?.lastRedo)
+                lines.push(`       voice: ${row.voiceover.lastRedo.label}`);
+            if (row.frame?.lastRedo)
+                lines.push(`       picture: ${row.frame.lastRedo.label}`);
             for (const finding of row.clip?.findings ?? []) {
                 lines.push(`       ${finding.code} (${finding.severity}): ${finding.detail}`);
                 const judgeSeverity = finding.judgeSeverity ?? finding.severity;
@@ -1095,14 +1147,30 @@ function sceneCardLines(scene) {
         lines.push(`    picture: ${scene.frame.status}`);
     return lines;
 }
-export async function approveFlow(runId, json, deps) {
-    const res = await deps.post(APPROVE_PATH, { runId });
-    if (!res.ok)
-        return errorResult(res, json);
-    if (json)
-        return { code: 0, lines: [JSON.stringify({ ok: true, runId, data: res.data })] };
-    const voices = res.data
-        ?.voices;
+export async function approveFlow(runId, opts, deps) {
+    const res = await deps.post(APPROVE_PATH, {
+        runId,
+        ...(opts.approveStaleCut ? { approveStaleCut: true } : {}),
+    });
+    if (!res.ok) {
+        const refusal = errorResult(res, opts.json);
+        const staleCut = !opts.json && videoApiError(res).includes("approve this cut anyway");
+        return staleCut
+            ? {
+                ...refusal,
+                lines: [
+                    ...refusal.lines,
+                    `To deliver it anyway: exodus video approve ${runId} --approve-stale-cut`,
+                ],
+            }
+            : refusal;
+    }
+    const data = res.data;
+    const warnings = Array.isArray(data?.warnings) ? data.warnings : [];
+    if (opts.json) {
+        return { code: 0, lines: [JSON.stringify({ ok: true, runId, warnings, data: res.data })] };
+    }
+    const voices = data?.voices;
     const summary = voices
         ? voiceSummaryLines(Array.isArray(voices.cast) ? voices.cast : [], Array.isArray(voices.notices) ? voices.notices : [])
         : [];
@@ -1110,6 +1178,7 @@ export async function approveFlow(runId, json, deps) {
         code: 0,
         lines: [
             "Approved.",
+            ...warnings,
             ...(summary.length > 0 ? ["", ...summary, ""] : []),
             `See what happens next: exodus video status ${runId}`,
         ],
@@ -1167,8 +1236,9 @@ export async function retryFrameFlow(runId, nodeId, sceneIndex, note, json, deps
         ],
     };
 }
-const UPLOADED_CUT_WARNING = "The cut you already uploaded will not include the new clip. Pull the pieces again, " +
-    "re-cut, and upload again.";
+const UPLOADED_CUT_WARNING = "The cut you already uploaded will not include the new clip. If this redo replaces the clip, " +
+    "exodus video approve stops until you pull the pieces again, re-cut and upload again, " +
+    "or pass --approve-stale-cut to deliver the cut you uploaded as it is.";
 export function planClipRedo(run, items, target) {
     const stop = classifyRun(run);
     const found = findClipRow(run, items, target);
@@ -1201,7 +1271,7 @@ export function planClipRedo(run, items, target) {
     };
 }
 function findClipRow(run, items, target) {
-    const uploadedCut = items.some((i) => i.itemKind === "final" && i.status === "done");
+    const uploadedCut = hasAttachedCut(items);
     const rows = items.filter((i) => i.itemKind === "clip" &&
         i.sceneIndex === target.sceneIndex &&
         (target.nodeId === undefined || i.nodeId === target.nodeId));
@@ -1987,8 +2057,9 @@ export async function run(flags, occurrences) {
         return printResult(await statusFlow(runId, json, defaultDeps));
     if (sub === "storyboard")
         return printResult(await storyboardFlow(runId, json, defaultDeps));
-    if (sub === "approve")
-        return printResult(await approveFlow(runId, json, defaultDeps));
+    if (sub === "approve") {
+        return printResult(await approveFlow(runId, { json, approveStaleCut: flags["approve-stale-cut"] === true }, defaultDeps));
+    }
     if (sub === "flag") {
         const note = flagString(flags, "note");
         if (!note)

package/dist/commands/workflow.d.ts

@@ -34,14 +34,60 @@ export interface WorkflowEdge {
     targetHandle: string;
 }
 export type WorkflowTriggerEvent = "winner-promoted";
+export interface ImageRigLineOverride {
+    count?: number;
+    aspects?: string[];
+    adType?: string;
+    style?: string;
+    memeFormat?: string;
+    steering?: string;
+    copyPin?: string;
+}
+export interface ImageRigPlanOverride {
+    lines?: unknown[];
+    steering?: string;
+    defaultAspects?: string[];
+    defaultStyle?: string;
+    model?: string;
+    confirmLargeRun?: boolean;
+}
+export interface ImageRigNodeOverride {
+    plan?: ImageRigPlanOverride;
+    lines?: Record<string, ImageRigLineOverride>;
+    confirmLargeRun?: boolean;
+    model?: string;
+}
+export type ImageRigOverrides = Record<string, ImageRigNodeOverride>;
+export interface VoiceRequest {
+    who: string;
+    choice: {
+        kind: "pin";
+        voiceId: string;
+        label?: string;
+    } | {
+        kind: "clear";
+    };
+}
+export type TriggerVoiceMap = Record<string, string | {
+    voiceId: string;
+    label?: string;
+} | null>;
 export type WorkflowTrigger = {
     type: "event";
     event: WorkflowTriggerEvent;
     enabled: boolean;
+    imageRigOverrides?: ImageRigOverrides;
+    voices?: VoiceRequest[];
 } | {
     type: "cron";
     cron: string;
     enabled: boolean;
+    imageRigOverrides?: ImageRigOverrides;
+    voices?: VoiceRequest[];
+};
+type WithoutVoices<T> = T extends unknown ? Omit<T, "voices"> : never;
+export type WorkflowContractTrigger = WithoutVoices<WorkflowTrigger> & {
+    voices?: TriggerVoiceMap;
 };
 export interface WorkflowContractJson {
     contract: "exodus-workflow";
@@ -51,7 +97,7 @@ export interface WorkflowContractJson {
     name: string;
     description?: string;
     slots?: WorkflowSlot[];
-    triggers?: WorkflowTrigger[];
+    triggers?: WorkflowContractTrigger[];
     nodes: WorkflowNode[];
     edges: WorkflowEdge[];
 }
@@ -530,12 +576,13 @@ export declare function parseVersionFlag(flags: Record<string, string | boolean>
 export declare function versionsFlow(workflowRef: string, opts: {
     json: boolean;
 }, deps: WorkflowRunDeps, channel?: Channel): Promise<FlowResult>;
-export declare function triggerExpect(t: WorkflowTrigger): {
+type AnyTrigger = WorkflowTrigger | WorkflowContractTrigger;
+export declare function triggerExpect(t: AnyTrigger): {
     type: string;
     event?: string;
     cron?: string;
 };
-export declare function formatTriggers(triggers: WorkflowTrigger[]): string;
+export declare function formatTriggers(triggers: AnyTrigger[]): string;
 export declare function triggersListFlow(workflowRef: string, opts: {
     json: boolean;
 }, deps: WorkflowRunDeps): Promise<FlowResult>;
@@ -546,6 +593,7 @@ export declare function triggersFireFlow(workflowRef: string, opts: {
     n?: number;
     text?: string;
     imageRigOverrides?: Record<string, unknown>;
+    voices?: VoiceMap;
     wait: boolean;
     json: boolean;
     onProgressLine?: (line: string) => void;

package/dist/commands/workflow.js

@@ -10,7 +10,7 @@ import { runDisplayName, runHeadingWord, runTypeWord } from "../lib/runNames.js"
 import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { getChannel } from "../lib/channel.js";
-import { asVideoRun, classifyRun, reviewUrl, stopLines, } from "./video.js";
+import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, stopLines, } from "./video.js";
 export const helpText = `
 exodus workflow — List, describe, run, inspect, import, and export saved workflows
 
@@ -32,7 +32,7 @@ Usage:
   exodus workflow triggers <workflowId|name> [--json]
   exodus workflow triggers <workflowId|name> enable <n> [--json]
   exodus workflow triggers <workflowId|name> disable <n> [--json]
-  exodus workflow triggers <workflowId|name> fire [<n>] [--text "..."] [--rig-overrides <json|@file>] [--wait] [--json]
+  exodus workflow triggers <workflowId|name> fire [<n>] [--text "..."] [--rig-overrides <json|@file>] [--voices <json|@voices.json>] [--wait] [--json]
   exodus workflow inbox [--json]
   exodus workflow checkpoint <runId> [show] [--json]
   exodus workflow checkpoint <runId> edit <n> [--text "..." | --file <path> | (stdin)] [--json]
@@ -84,9 +84,9 @@ Flags:
                          before anything runs, and the error names it. On
                          "triggers fire" it REPLACES the schedule's own
                          overrides for that one test fire.
-  --voices <json>        (run) Give the ad's characters their voices at the
-                         moment the run starts, instead of at the storyboard
-                         review. Keyed by the names the SCRIPT uses for its
+  --voices <json>        (run, triggers fire) Give the ad's characters their
+                         voices at the moment the run starts, instead of at the
+                         storyboard review. Keyed by the names the SCRIPT uses for its
                          speakers ("HOST 1") — the planner's character ids
                          (C1, C2) do not exist yet when a run starts. Takes a
                          JSON object, or @path to a .json file holding one:
@@ -103,6 +103,14 @@ Flags:
                          <run>" at the storyboard review instead. Voice ids
                          belong to the brand's own folder — never put them in a
                          shared workflow or template.
+                         A schedule can carry the same map in its YAML
+                         ("voices:" beside the schedule), so a weekly ad arrives
+                         already voiced. On "triggers fire" this flag REPLACES
+                         the schedule's own voices for that one test fire. A
+                         schedule whose voice has been deleted, or whose
+                         ElevenLabs key is missing or refused, does not start at
+                         all: it leaves a failed run saying which speaker and
+                         what to fix, and spends nothing.
   --voice-treatment <v>  (run) Say HOW this run makes its voices. Two kinds of
                          answer. A name on its own picks a way of working that
                          uses voices you already have:
@@ -279,7 +287,9 @@ Notes:
   panel in the app); anything you name that isn't there stops the launch and the
   message says which key was wrong. A trigger can carry the same payload in its
   YAML ("imageRigOverrides:" beside its schedule), so a Monday schedule and a
-  Friday one can fire the same workflow at different sizes.
+  Friday one can fire the same workflow at different sizes. A trigger can carry
+  "voices:" the same way — the same map "workflow run --voices" takes — so a run
+  that starts on a schedule arrives at the storyboard already voiced.
   "workflow run --voices" hands a video run its voices at the start, so a brand
   that always uses the same hosts stops choosing them by hand on every run. The
   file is keyed by the names the script uses for its speakers, because that is
@@ -2085,9 +2095,10 @@ async function waitForRun(runId, opts, deps) {
     const saved = opts.out !== undefined && terminalRun
         ? await saveDeliveries(terminalRun, opts.out, deps)
         : undefined;
-    const videoStop = !pollResult.timedOut && isRecord(pollResult.data)
+    const parkStop = !pollResult.timedOut && isRecord(pollResult.data)
         ? videoParkStop(pollResult.data)
         : undefined;
+    const videoStop = parkStop ? await resolveStopAtPark(parkStop, runId, deps) : undefined;
     if (opts.json) {
         return {
             code: pollResult.ok ? 0 : 1,
@@ -2449,6 +2460,7 @@ export async function triggersFireFlow(workflowRef, opts, deps) {
         ...(opts.imageRigOverrides
             ? { imageRigOverrides: opts.imageRigOverrides }
             : {}),
+        ...(opts.voices ? { voices: opts.voices } : {}),
     });
     if (!res.ok)
         return triggerErrorResult(res, verb, opts.json);
@@ -3312,8 +3324,10 @@ export async function run(flags, occurrences) {
                 }
             }
             let fireOverrides;
+            let fireVoices;
             try {
                 fireOverrides = parseRigOverridesFlag(occurrences, defaultDeps.readFile);
+                fireVoices = parseVoicesFlag(occurrences, defaultDeps.readFile);
             }
             catch (e) {
                 console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
@@ -3323,6 +3337,7 @@ export async function run(flags, occurrences) {
                 n,
                 text: flagString(flags, "text"),
                 imageRigOverrides: fireOverrides,
+                voices: fireVoices,
                 wait: flags["wait"] === true,
                 json,
                 onProgressLine: (line) => console.log(line),

package/package.json

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