@aicopycoders/exodus 2026.9.1400-beta.1 → 2026.9.1700-beta.0

package/assets/docs/CLAUDE.md

@@ -64,7 +64,7 @@ These are the **Exodus** pipelines — the automatic system that drives the Gene
 | **Video** | `exodus-video` | Make a video ad from a Show: start a run from a script, read and approve the storyboard, `npx @aicopycoders/exodus video pull` every piece (per-scene clips, voices, keyframes, word timings, music bed) plus a manifest, cut them with the bundled first-cut script, upload the cut and approve it. Admin-only. |
 | **Browse** | `exodus-browse` | View history and retrieve past outputs |
 | **Drive** | `exodus-drive` | Read/write Google Docs, Sheets, and Drive files via `npx @aicopycoders/exodus drive` (uses the dashboard's Google OAuth — no local CLI) |
-| **Swipe / Mining** | (no skill; CLI only) | The competitor watch list behind the Mining page: `npx @aicopycoders/exodus swipe brands list`, `swipe brands bulk-import <csv>` (checks each brand and starts collecting its ads), `swipe brands add "<Name>" --fb <pageId>` (adds without starting research, #1366), `swipe run` / `swipe mine`. There is no `competitors` verb. |
+| **Swipe / Mining** | (no skill; CLI only) | The competitor watch list behind the Mining page: `npx @aicopycoders/exodus swipe brands list`, `swipe brands bulk-import <csv>` (checks each brand and starts collecting its ads), `swipe brands add "<Name>" --fb <pageId>` (adds one brand and starts checking it the same way), `swipe run` / `swipe mine`. There is no `competitors` verb. |
 | **Ads** | `exodus-ads` | Read your own live Meta ads once the account is connected on the dashboard — `npx @aicopycoders/exodus ads list` (sort by cost per result, spend or CTR), `ads show <adId>` (copy, both windows, media links, comment counts), `npx @aicopycoders/exodus comments list` (already commenter-redacted), and `npx @aicopycoders/exodus winners definition` (what this brand means by a winner). Read-only; no Meta login or MCP needed. |
 | **Winners** | `exodus-winners` | Mine your own Meta ad account for winning ads and import them into Exodus as generative fuel — interview, visual confirmation, `npx @aicopycoders/exodus winners import`. A brand whose Meta account is connected reads its ads and its winner definition straight from Exodus; only an unconnected brand needs the Meta Ads MCP. |
 

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

@@ -43,6 +43,7 @@ exodus video start --show <id> --script script.txt --wait  start, wait for the s
 exodus video storyboard <runId>                           read the scene cards
 exodus video approve <runId>                              keep going
 exodus video flag <runId> --note "what's wrong"           or send it back
+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
 node .claude/skills/exodus-video/scripts/first-cut.mjs ./ad-<runId>   a plain cut (path from the workspace root)
@@ -115,13 +116,19 @@ storyboard.json          scene text, order, planned durations, cast looks
 reference.<ext>          the reference still the pictures were drawn from
 scene-NN.keyframe.<ext>  the picture for scene NN
 scene-NN.voice.<ext>     the voice track for scene NN, when one was delivered
-                         (a Show whose voices live inside the clips delivers none)
+                         (a Show whose voices live inside the clips delivers none;
+                         on a continuous-narrator run this is a cut of narration.mp3)
+narration.mp3            one continuous narrator take for the whole script (#1802),
+                         when the run used continuous narration
+narration.json           takeHash, voice/model/speed, master-timeline words, scene
+                         cut ranges into narration.mp3
 scene-NN.<ext>           the clip for scene NN, usually .mp4, voice included
 scene-NN.words.json      [{w, s, e}] word timings for the speech in that scene, from
                          the clip's own dialogue or, on a narrated scene, from the
                          voice track (seconds from the start of that file)
 music.<ext>              the music bed, composed to the clips' total length
-manifest.json            the index below
+manifest.json            the index below (includes narration { file, timing } when
+                         a continuous master landed)
 ```
 
 `manifest.json`:
@@ -147,6 +154,9 @@ How to read it before cutting:
 - `wordsFrom: "voice"` (or narration in the storyboard with no on-camera line):
   a narrated scene. Its clip is picture only; the voice track is the sound.
   Never cut a narrated scene with the clip's own audio.
+- Continuous master present (`manifest.narration`): listen to `narration.mp3`
+  and the joins between adjacent scene voice files before approving the cut.
+  Voice-ID match alone does not prove continuity (#1802).
 - `flagged: true` is a warning, not a block. The clip was delivered anyway; the
   findings say what the QC model saw (`wrong-character`, `eyeline-off`,
   `set-drift`, `speech-cutoff`, `framing-off`). Tell the user which scenes are

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

@@ -143,6 +143,8 @@ Accepts a workflow id **or** a name. It reports three things:
 
 Fill every required input. For a free-text brief you can compose a **bespoke brief from in-session research** — the winning angle you just worked out, the swipe you analyzed — and pass it inline (`--input brief="..."`) or, if it's long, write it to a project file and pass it with `@file` (see Chain, below). For URL/swipe sources, pass the value the source expects.
 
+**A brief wired straight into a Storyboard is a script, not a prompt.** On a video workflow whose Storyboard takes its `script` port from a Brief node, the text you pass for that brief boards VERBATIM, the same way a Show ad's pasted script does: one speaker per scene, every line rendered once in order, long lines split across clips, narrated lines rendered silent under the voice track. So it must be in the script form the `exodus-video` skill documents (an optional `CAST:` block of `NAME — description` lines, then `NAME:` turns, then a `CTA:` block; `NARRATOR:` lines only for Narrated Story and Explainer). A brief that is not a script, or one that does not fit the wired rig's family, is refused at launch with the parser's own message and nothing is spent. Write the script to a file and pass it with `--input script=@script.txt`. A Storyboard fed by a bot is unaffected.
+
 For an **`asset` (file) input, pass the path to a local file** and the CLI does the uploading for you — mint, push the bytes, register, then start the run with the stored asset:
 
 ```bash

package/assets/skills/find-competitors/SKILL.md

@@ -128,7 +128,7 @@ Thresholds used: <…>. Verdict: FOLLOW 3+ · WATCH 2 · SKIP 0–1.
 
 The sheet lives in the folder. The FOLLOW rows become the watch list: an Ad Library page link per brand (the shape above) saved as a links file the rip can consume, and the brands added to Atria's followed list by hand in the app. When the brand is set up in Exodus, the Scout feed covers the Instagram side.
 
-**Push the watch list into Exodus (the Mining page).** The CLI verb is `npx @aicopycoders/exodus swipe brands`, not `competitors`. Write the FOLLOW rows as a CSV (`name,igHandle,fbPageId,category[,website][,youtubeHandle]`; the Ad Library `view_all_page_id` is the `fbPageId`) and run `npx @aicopycoders/exodus swipe brands bulk-import <file.csv>`: it checks each brand's page on the member's own Scrape Creators key and starts collecting its ads. `swipe brands add "<Name>" --fb <pageId>` adds one brand but does not start the research yet (open issue #1366), so prefer the CSV route even for one brand. `swipe brands list` shows what is on the page.
+**Push the watch list into Exodus (the Mining page).** The CLI verb is `npx @aicopycoders/exodus swipe brands`, not `competitors`. Write the FOLLOW rows as a CSV (`name,igHandle,fbPageId,category[,website][,youtubeHandle]`; the Ad Library `view_all_page_id` is the `fbPageId`) and run `npx @aicopycoders/exodus swipe brands bulk-import <file.csv>`: it checks each brand's page on the member's own Scrape Creators key and starts collecting its ads. `swipe brands add "<Name>" --fb <pageId>` adds one brand and starts the same check on it; the CSV route is only for lists. `swipe brands list` shows what is on the page.
 
 ## Hand-offs
 

package/dist/commands/video.d.ts

@@ -15,6 +15,8 @@ export interface ClipFinding {
     code: string;
     severity: "fail" | "warn";
     detail: string;
+    judgeDetail?: string;
+    judgeSeverity?: "fail" | "warn";
 }
 export type ArtifactSubset = {
     type: "storyboard";
@@ -29,6 +31,7 @@ export type ArtifactSubset = {
 } | {
     type: "image";
     imageUrl?: string;
+    storageId?: string;
 } | {
     type: "video";
     sceneIndex?: number;
@@ -45,6 +48,19 @@ export type ArtifactSubset = {
     audioUrl?: string;
     durationSec?: number;
     words?: ClipWord[];
+    narration?: {
+        takeHash: string;
+        voiceId?: string;
+        modelId?: string;
+        speed?: number;
+        alignment?: "elevenlabs-timestamps";
+        cuts?: Array<{
+            sceneIndex: number;
+            startSec: number;
+            durationSec: number;
+            takeHash: string;
+        }>;
+    };
 } | {
     type: "text" | "primer" | "session" | "document";
 };
@@ -56,6 +72,20 @@ export interface VideoRunNode {
     outputs?: ArtifactSubset[];
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
+export interface PullCastLockMember {
+    characterId: string;
+    name: string;
+    look?: string;
+    identityRefs?: Array<{
+        storageId?: string;
+        imageUrl?: string;
+    }>;
+}
+export interface PullCastLock {
+    mintedAt: number;
+    styleSlug?: string;
+    cast: PullCastLockMember[];
+}
 export interface VideoRun {
     _id: string;
     status: string;
@@ -64,6 +94,7 @@ export interface VideoRun {
     pauseReason?: BuilderPauseReason;
     pausedNodeId?: string;
     nodes: VideoRunNode[];
+    castLock?: PullCastLock | null;
 }
 export declare function asVideoRun(data: unknown): VideoRun;
 export interface NodeItem {
@@ -75,6 +106,7 @@ export interface NodeItem {
     attempt?: number;
     flagged?: boolean;
     findings?: ClipFinding[];
+    artifact?: ArtifactSubset;
 }
 export interface ShowRow {
     id: string;
@@ -124,6 +156,7 @@ export type RunStop = {
 } | {
     at: "storyboard-gate";
     nodeId?: string;
+    framesNodeId?: string;
 } | {
     at: "final-watch";
 } | {
@@ -167,13 +200,20 @@ export interface ManifestScene {
     error: string | null;
     flagged: boolean;
     findings: ClipFinding[];
-    keyframeFindings: ClipFinding[];
+    keyframeFindings: ClipFinding[] | null;
 }
 export interface PullFailure {
     file: string;
     url: string;
     error: string;
 }
+export interface ManifestCastRef {
+    characterId: string | null;
+    name: string | null;
+    file: string | null;
+    status: string;
+    error: string | null;
+}
 export interface VideoManifest {
     runId: string;
     pulledAt: string;
@@ -181,9 +221,15 @@ export interface VideoManifest {
     storyboard: string | null;
     reference: string | null;
     music: string | null;
+    cast: ManifestCastRef[];
+    narration: {
+        file: string;
+        timing: string;
+    } | null;
     scenes: ManifestScene[];
     failed: PullFailure[];
 }
+export declare const CAST_LEDGER_BASE = 910000;
 export interface PullPlan {
     downloads: PullDownload[];
     texts: PullTextFile[];
@@ -217,6 +263,7 @@ export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps
 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 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 declare function pullFlow(runId: string, dir: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function parseMvhdDurationSec(bytes: Uint8Array): number | null;
 export declare const NO_DURATION_MESSAGE: string;

package/dist/commands/video.js

@@ -27,6 +27,8 @@ The whole loop, in order:
 
   4. exodus video approve <runId>          (looks right — keep going)
      exodus video flag <runId> --note "…"  (something is wrong — send it back)
+     exodus video retry-frame <runId> --node <nodeId> --scene <n>
+       Redo ONE still at the pixel gate. Neighbours stay. The gate holds.
 
   5. exodus video status <runId>
      Where the run is and how each scene's clip turned out.
@@ -49,6 +51,7 @@ Usage:
   exodus video storyboard <runId> [--json]
   exodus video approve <runId> [--json]
   exodus video flag <runId> --note "<what is wrong>" [--json]
+  exodus video retry-frame <runId> --node <nodeId> --scene <n> [--note "..."] [--json]
   exodus video pull <runId> --out <dir> [--json]
   exodus video upload <runId> --file <cut.mp4> [--duration <sec>] [--json]
 
@@ -63,7 +66,10 @@ Options:
   --file <cut.mp4>     Your finished cut (upload). MP4, MOV or WebM, up to 200MB
   --duration <sec>     How long your cut is, in seconds. Only needed when the
                        length can't be read off the file itself
-  --note "<text>"      What is wrong with the storyboard (flag)
+  --note "<text>"      What is wrong with the storyboard (flag), or how to
+                       steer one frame redo (retry-frame)
+  --node <nodeId>      Which scene-frames node holds the still (retry-frame)
+  --scene <n>          Which scene's frame to redo. One scene only (retry-frame)
   --json               Machine-readable output
   --help, -h           Show this help
 
@@ -75,6 +81,7 @@ Examples:
   exodus video start --show k57abc --script ./script.txt --wait
   exodus video storyboard run_123
   exodus video approve run_123
+  exodus video retry-frame run_123 --node frames-1 --scene 2
   exodus video pull run_123 --out ./ad-run_123
   exodus video upload run_123 --file ./cut.mp4
 `.trim();
@@ -85,9 +92,13 @@ const ITEMS_PATH = "/api/v2/workflow/items";
 const STORYBOARD_PATH = "/api/v2/video/storyboard";
 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 FINAL_PATH = "/api/v2/video/final";
 const ASSET_UPLOAD_URL_PATH = "/api/v2/workflows/asset-upload-url";
 const ASSETS_PATH = "/api/v2/workflows/assets";
+function withoutJudgeFields({ judgeDetail: _d, judgeSeverity: _s, ...rest }) {
+    return rest;
+}
 export function asVideoRun(data) {
     const run = (data ?? {});
     return { ...run, nodes: Array.isArray(run.nodes) ? run.nodes : [] };
@@ -194,7 +205,13 @@ export function classifyRun(run) {
         }
         const pausedNode = run.nodes.find((n) => n.nodeId === run.pausedNodeId);
         if (pausedNode && parkedAtStoryboardGate(run, pausedNode)) {
-            return { at: "storyboard-gate", nodeId: pausedNode.nodeId };
+            return {
+                at: "storyboard-gate",
+                nodeId: pausedNode.nodeId,
+                ...(pausedNode.kind === "scene-frames"
+                    ? { framesNodeId: pausedNode.nodeId }
+                    : {}),
+            };
         }
         if (parkedAtFinalWatch(run))
             return { at: "final-watch" };
@@ -230,12 +247,16 @@ export function stepName(kind) {
 }
 export function stopLines(stop, runId, dashboardUrl) {
     if (stop.at === "storyboard-gate") {
-        return [
+        const lines = [
             "Parked: the storyboard is waiting for your yes.",
             `Read it:    exodus video storyboard ${runId}`,
             `Approve it: exodus video approve ${runId}`,
             `Send back:  exodus video flag ${runId} --note "what's wrong"`,
         ];
+        if (stop.framesNodeId) {
+            lines.push(`Redo one frame: exodus video retry-frame ${runId} --node ${stop.framesNodeId} --scene <n>`);
+        }
+        return lines;
     }
     if (stop.at === "final-watch") {
         return [
@@ -271,6 +292,7 @@ export function stopLines(stop, runId, dashboardUrl) {
     }
     return [`Working: ${stageWord(stop.stage)}.`];
 }
+export const CAST_LEDGER_BASE = 910000;
 const FALLBACK_EXT = {
     image: "png",
     video: "mp4",
@@ -290,6 +312,118 @@ export function scenePrefix(sceneIndex) {
 function outputsOfNodeKind(run, kind) {
     return run.nodes.filter((n) => n.kind === kind).flatMap((n) => n.outputs ?? []);
 }
+function clipFromArtifact(sceneIndex, artifact) {
+    if (!artifact || artifact.type !== "video" || artifact.final || !artifact.videoUrl) {
+        return null;
+    }
+    return {
+        download: {
+            file: `${scenePrefix(sceneIndex)}.${extFor(artifact.videoUrl, "video")}`,
+            url: artifact.videoUrl,
+        },
+        durationSec: artifact.durationSec ?? null,
+        qc: artifact.qc ?? null,
+        words: artifact.words ?? null,
+        revoiced: artifact.revoiced === true,
+        speechTrimmed: artifact.speechTrimmed === true,
+    };
+}
+function keyframeDownload(sceneIndex, imageUrl) {
+    return {
+        file: `${scenePrefix(sceneIndex)}.keyframe.${extFor(imageUrl, "image")}`,
+        url: imageUrl,
+    };
+}
+function reservedCastFrames(items) {
+    const byIndex = new Map();
+    for (const item of items) {
+        if (item.itemKind === "frame" && item.sceneIndex >= CAST_LEDGER_BASE) {
+            byIndex.set(item.sceneIndex, item);
+        }
+    }
+    return byIndex;
+}
+function planCastRefs(run, items) {
+    const ledger = reservedCastFrames(items);
+    const ledgerRows = [...ledger.entries()].sort(([a], [b]) => a - b);
+    const locked = run.castLock?.cast;
+    const rows = [];
+    if (locked !== undefined && locked.length > 0) {
+        const claimedStorageIds = new Set();
+        for (const member of locked) {
+            const storageId = member.identityRefs?.[0]?.storageId;
+            const item = typeof storageId === "string" && storageId.length > 0
+                ? ledgerRows.find(([, row]) => {
+                    const art = row.artifact;
+                    return art?.type === "image" && art.storageId === storageId;
+                })?.[1]
+                : undefined;
+            if (typeof storageId === "string" && storageId.length > 0) {
+                claimedStorageIds.add(storageId);
+            }
+            const art = item?.artifact;
+            const url = (art?.type === "image" ? art.imageUrl : undefined) ??
+                member.identityRefs?.[0]?.imageUrl;
+            rows.push({
+                characterId: member.characterId,
+                name: member.name,
+                url,
+                status: item?.status ?? (url ? "done" : "missing"),
+                error: item?.error ?? null,
+                stem: `cast-${member.characterId}`,
+            });
+        }
+        for (const [sceneIndex, item] of ledgerRows) {
+            const art = item.artifact;
+            const sid = art?.type === "image" ? art.storageId : undefined;
+            if (typeof sid === "string" && claimedStorageIds.has(sid))
+                continue;
+            const url = art?.type === "image" ? art.imageUrl : undefined;
+            rows.push({
+                characterId: null,
+                name: null,
+                url,
+                status: item.status,
+                error: item.error ?? null,
+                stem: `cast-ref-${String(sceneIndex - CAST_LEDGER_BASE).padStart(2, "0")}`,
+            });
+        }
+    }
+    else {
+        for (const [sceneIndex, item] of ledgerRows) {
+            const art = item.artifact;
+            const url = art?.type === "image" ? art.imageUrl : undefined;
+            rows.push({
+                characterId: null,
+                name: null,
+                url,
+                status: item.status,
+                error: item.error ?? null,
+                stem: `cast-ref-${String(sceneIndex - CAST_LEDGER_BASE).padStart(2, "0")}`,
+            });
+        }
+    }
+    const cast = [];
+    const downloads = [];
+    for (const row of rows) {
+        const file = row.url ? `${row.stem}.${extFor(row.url, "image")}` : null;
+        cast.push({
+            characterId: row.characterId,
+            name: row.name,
+            file,
+            status: row.status,
+            error: row.error,
+        });
+        if (file && row.url)
+            downloads.push({ file, url: row.url });
+    }
+    return { cast, downloads };
+}
+function isNarrationMaster(artifact) {
+    return (artifact.type === "audio" &&
+        artifact.sceneIndex === undefined &&
+        Array.isArray(artifact.narration?.cuts));
+}
 export function planPull(run, items, opts) {
     const texts = [];
     const storyboardArtifact = run.nodes
@@ -323,17 +457,24 @@ export function planPull(run, items, opts) {
         for (const frame of artifact.frames ?? []) {
             if (!frame.imageUrl)
                 continue;
-            keyframeByScene.set(frame.sceneIndex, {
-                file: `${scenePrefix(frame.sceneIndex)}.keyframe.${extFor(frame.imageUrl, "image")}`,
-                url: frame.imageUrl,
-            });
+            keyframeByScene.set(frame.sceneIndex, keyframeDownload(frame.sceneIndex, frame.imageUrl));
         }
     }
     const voiceByScene = new Map();
+    let narrationDownload = null;
+    let narrationMaster = null;
     for (const artifact of outputsOfNodeKind(run, "voiceover")) {
-        if (artifact.type !== "audio" || typeof artifact.sceneIndex !== "number")
+        if (artifact.type !== "audio" || !artifact.audioUrl)
             continue;
-        if (!artifact.audioUrl)
+        if (isNarrationMaster(artifact)) {
+            narrationMaster = artifact;
+            narrationDownload = {
+                file: `narration.${extFor(artifact.audioUrl, "audio")}`,
+                url: artifact.audioUrl,
+            };
+            continue;
+        }
+        if (typeof artifact.sceneIndex !== "number" || artifact.sceneIndex < 0)
             continue;
         voiceByScene.set(artifact.sceneIndex, {
             download: {
@@ -343,6 +484,28 @@ export function planPull(run, items, opts) {
             words: artifact.words ?? null,
         });
     }
+    if (narrationMaster && narrationDownload) {
+        const timing = {
+            takeHash: narrationMaster.narration?.takeHash,
+            voiceId: narrationMaster.narration?.voiceId,
+            modelId: narrationMaster.narration?.modelId,
+            speed: narrationMaster.narration?.speed,
+            alignment: narrationMaster.narration?.alignment,
+            words: narrationMaster.words ?? [],
+            cuts: (narrationMaster.narration?.cuts ?? []).map((cut) => ({
+                sceneIndex: cut.sceneIndex,
+                startSec: cut.startSec,
+                durationSec: cut.durationSec,
+                takeHash: cut.takeHash,
+                file: voiceByScene.get(cut.sceneIndex)?.download.file ??
+                    `${scenePrefix(cut.sceneIndex)}.voice.mp3`,
+            })),
+        };
+        texts.push({
+            file: "narration.json",
+            body: `${JSON.stringify(timing, null, 2)}\n`,
+        });
+    }
     const clipByScene = new Map();
     let music = null;
     for (const artifact of outputsOfNodeKind(run, "video")) {
@@ -352,19 +515,10 @@ export function planPull(run, items, opts) {
         }
         if (artifact.type !== "video" || typeof artifact.sceneIndex !== "number")
             continue;
-        if (artifact.final || !artifact.videoUrl)
+        const clip = clipFromArtifact(artifact.sceneIndex, artifact);
+        if (!clip)
             continue;
-        clipByScene.set(artifact.sceneIndex, {
-            download: {
-                file: `${scenePrefix(artifact.sceneIndex)}.${extFor(artifact.videoUrl, "video")}`,
-                url: artifact.videoUrl,
-            },
-            durationSec: artifact.durationSec ?? null,
-            qc: artifact.qc ?? null,
-            words: artifact.words ?? null,
-            revoiced: artifact.revoiced === true,
-            speechTrimmed: artifact.speechTrimmed === true,
-        });
+        clipByScene.set(artifact.sceneIndex, clip);
     }
     const clipItemByScene = new Map();
     const frameItemByScene = new Map();
@@ -376,6 +530,22 @@ export function planPull(run, items, opts) {
             frameItemByScene.set(item.sceneIndex, item);
         }
     }
+    for (const [sceneIndex, item] of clipItemByScene) {
+        if (item.status !== "done" || clipByScene.has(sceneIndex))
+            continue;
+        const clip = clipFromArtifact(sceneIndex, item.artifact);
+        if (!clip)
+            continue;
+        clipByScene.set(sceneIndex, clip);
+    }
+    for (const [sceneIndex, item] of frameItemByScene) {
+        if (item.status !== "done" || keyframeByScene.has(sceneIndex))
+            continue;
+        const artifact = item.artifact;
+        if (!artifact || artifact.type !== "image" || !artifact.imageUrl)
+            continue;
+        keyframeByScene.set(sceneIndex, keyframeDownload(sceneIndex, artifact.imageUrl));
+    }
     const sceneIndexes = [
         ...new Set([
             ...clipByScene.keys(),
@@ -384,7 +554,9 @@ export function planPull(run, items, opts) {
             ...clipItemByScene.keys(),
             ...frameItemByScene.keys(),
         ]),
-    ].sort((a, b) => a - b);
+    ]
+        .filter((sceneIndex) => sceneIndex >= 0 && sceneIndex < CAST_LEDGER_BASE)
+        .sort((a, b) => a - b);
     const scenes = sceneIndexes.map((sceneIndex) => {
         const clip = clipByScene.get(sceneIndex);
         const voice = voiceByScene.get(sceneIndex);
@@ -419,16 +591,19 @@ export function planPull(run, items, opts) {
             clipStatus: item?.status ?? "missing",
             error: item?.error ?? null,
             flagged: item?.flagged === true,
-            findings: item?.findings ?? [],
-            keyframeFindings: frameItem?.findings ?? [],
+            findings: (item?.findings ?? []).map(withoutJudgeFields),
+            keyframeFindings: frameItem?.findings?.map(withoutJudgeFields) ?? null,
         };
     });
+    const { cast, downloads: castDownloads } = planCastRefs(run, items);
     const downloads = [
         ...(reference ? [reference] : []),
         ...keyframeByScene.values(),
         ...[...voiceByScene.values()].map((v) => v.download),
+        ...(narrationDownload ? [narrationDownload] : []),
         ...[...clipByScene.values()].map((c) => c.download),
         ...(music ? [music] : []),
+        ...castDownloads,
     ];
     return {
         downloads,
@@ -440,6 +615,10 @@ export function planPull(run, items, opts) {
             storyboard,
             reference: reference?.file ?? null,
             music: music?.file ?? null,
+            cast,
+            narration: narrationDownload
+                ? { file: narrationDownload.file, timing: "narration.json" }
+                : null,
             scenes,
             failed: [],
         },
@@ -453,6 +632,12 @@ export function markPullFailure(manifest, failure) {
         manifest.reference = null;
     if (manifest.music === failure.file)
         manifest.music = null;
+    for (const ref of manifest.cast) {
+        if (ref.file === failure.file)
+            ref.file = null;
+    }
+    if (manifest.narration?.file === failure.file)
+        manifest.narration = null;
     for (const scene of manifest.scenes) {
         const lostWordsSource = (scene.clip === failure.file && scene.wordsFrom === "clip") ||
             (scene.voice === failure.file && scene.wordsFrom === "voice");
@@ -675,6 +860,8 @@ export async function statusFlow(runId, json, deps) {
         if (item.itemKind !== "clip" && item.itemKind !== "voiceover" && item.itemKind !== "frame") {
             continue;
         }
+        if (item.sceneIndex < 0)
+            continue;
         if (item.itemKind === "frame" && !sceneFrameNodeIds.has(item.nodeId))
             continue;
         const row = byScene.get(item.sceneIndex) ?? {};
@@ -695,6 +882,13 @@ export async function statusFlow(runId, json, deps) {
             lines.push(`${String(sceneIndex).padEnd(5)}  ${itemWord(row.clip).padEnd(8)}  ${itemWord(row.voiceover).padEnd(8)}  ${itemWord(row.frame)}`);
             for (const finding of row.clip?.findings ?? []) {
                 lines.push(`       ${finding.code} (${finding.severity}): ${finding.detail}`);
+                const judgeSeverity = finding.judgeSeverity ?? finding.severity;
+                if (finding.judgeDetail) {
+                    lines.push(`         checker said (${judgeSeverity}): ${finding.judgeDetail}`);
+                }
+                else if (judgeSeverity !== finding.severity) {
+                    lines.push(`         checker rated it ${judgeSeverity}`);
+                }
             }
             if (row.clip?.error)
                 lines.push(`       ${row.clip.error}`);
@@ -704,6 +898,9 @@ export async function statusFlow(runId, json, deps) {
                 lines.push(`       picture: ${finding.code} (${finding.severity}): ${finding.detail}`);
             }
         }
+        if (outputsOfNodeKind(run, "voiceover").some(isNarrationMaster)) {
+            lines.push("Narration  master take");
+        }
     }
     lines.push("", hasFinal && stop.at === "finished"
         ? "Final cut: approved and delivered."
@@ -747,6 +944,9 @@ export async function storyboardFlow(runId, json, deps) {
             lines.push(...sceneCardLines(scene));
     }
     lines.push("", `approve with: exodus video approve ${runId}`, `send it back: exodus video flag ${runId} --note "what's wrong"`);
+    if (cards.framesNodeId) {
+        lines.push(`redo one frame: exodus video retry-frame ${runId} --node ${cards.framesNodeId} --scene <n>`);
+    }
     return { code: 0, lines };
 }
 function sceneCardLines(scene) {
@@ -803,6 +1003,40 @@ export async function flagFlow(runId, note, json, deps) {
         ],
     };
 }
+export async function retryFrameFlow(runId, nodeId, sceneIndex, note, json, deps) {
+    const res = await deps.post(SCENE_RETRY_PATH, {
+        runId,
+        nodeId,
+        sceneIndex,
+        ...(note ? { note } : {}),
+    });
+    if (!res.ok)
+        return errorResult(res, json);
+    const triggerRunId = res.data.triggerRunId;
+    if (json) {
+        return {
+            code: 0,
+            lines: [
+                JSON.stringify({
+                    ok: true,
+                    runId,
+                    nodeId,
+                    sceneIndex,
+                    triggerRunId,
+                    ...(note ? { note } : {}),
+                }),
+            ],
+        };
+    }
+    return {
+        code: 0,
+        lines: [
+            `Redoing scene ${sceneIndex} on ${nodeId}.`,
+            `triggerRunId: ${triggerRunId ?? "-"}`,
+            "Neighbours stay. The pixel gate holds.",
+        ],
+    };
+}
 export async function pullFlow(runId, dir, json, deps) {
     const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
     if (!runRes.ok)
@@ -1107,6 +1341,8 @@ const VALUE_FLAGS = new Set([
     "out",
     "file",
     "duration",
+    "node",
+    "scene",
 ]);
 export function parsePositional(args = process.argv.slice(3)) {
     const out = [];
@@ -1166,7 +1402,7 @@ export async function run(flags) {
         }, defaultDeps));
     }
     const runId = rest[0];
-    const needsRunId = ["status", "storyboard", "approve", "flag", "pull", "upload"];
+    const needsRunId = ["status", "storyboard", "approve", "flag", "retry-frame", "pull", "upload"];
     if (needsRunId.includes(sub) && !runId) {
         usage(`video ${sub} needs a run id: exodus video ${sub} <runId>`);
     }
@@ -1182,6 +1418,20 @@ export async function run(flags) {
             usage('video flag needs --note "<what is wrong>".');
         return printResult(await flagFlow(runId, note, json, defaultDeps));
     }
+    if (sub === "retry-frame") {
+        const nodeId = flagString(flags, "node");
+        if (!nodeId)
+            usage("video retry-frame needs --node <nodeId>.");
+        const sceneRaw = flagString(flags, "scene");
+        if (sceneRaw === undefined) {
+            usage("video retry-frame needs --scene <n>, the scene index to redo.");
+        }
+        const sceneIndex = Number(sceneRaw);
+        if (!Number.isFinite(sceneIndex)) {
+            usage("video retry-frame --scene must be a number.");
+        }
+        return printResult(await retryFrameFlow(runId, nodeId, sceneIndex, flagString(flags, "note"), json, defaultDeps));
+    }
     if (sub === "pull") {
         const dir = flagString(flags, "out");
         if (!dir)

package/package.json

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