@aicopycoders/exodus 2026.9.2000-beta.4 → 2026.9.2000-beta.6

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

@@ -115,6 +115,11 @@ under it:
   `exodus workflow checkpoint <runId>` is the verb for that one.
 - failed: `status` shows how far it got, and a `--wait` that was running exits
   1 with the error. Tell the user; do not start another run on your own.
+  When the storyboard is the step that failed, `status` adds a "What happened
+  to the storyboard" block: which parts of the plan were accepted, which part
+  was turned down, and why (#1902). Relay it as written. On an admin key it may
+  also offer `status <runId> --rejected-draft`. That prints the draft the system
+  threw away. It is a record only: never build on it, edit it, or re-run it.
 - finished: pull what it made.
 
 **`--wait` stops at both video parks** (#1818). `workflow run --wait` ends at

package/dist/commands/video.d.ts

@@ -8,10 +8,31 @@ export interface ClipWord {
     s: number;
     e: number;
 }
+export type ClipQcTakeNeighbours = {
+    state: "not-applicable";
+} | {
+    state: "not-attached";
+} | {
+    state: "none-accepted";
+} | {
+    state: "attached";
+    scenes: number[];
+};
+export interface ClipQcTake {
+    kind: "take" | "soft-retry";
+    failCodes: string[];
+    warnCodes: string[];
+    neighbours: ClipQcTakeNeighbours;
+    judgeWording?: {
+        code: string;
+        wording: string;
+    }[];
+}
 export interface ClipQc {
     verdict: "pass" | "fail";
     attempts: number;
     neighbours?: number[];
+    takes?: ClipQcTake[];
 }
 export interface ClipFinding {
     check: string;
@@ -21,6 +42,9 @@ export interface ClipFinding {
     judgeDetail?: string;
     judgeSeverity?: "fail" | "warn";
 }
+export declare function qcWithoutJudgeWording(qc: ClipQc): ClipQc;
+export declare const NO_TAKE_HISTORY_LINE = "no history recorded for this clip";
+export declare function renderQcTakeHistory(takes: ClipQcTake[] | undefined): string[];
 export type ArtifactSubset = {
     type: "storyboard";
     storyboard?: unknown;
@@ -69,12 +93,23 @@ export type ArtifactSubset = {
 } | {
     type: "text" | "primer" | "session" | "document";
 };
+export interface PlanFailureRecord {
+    kind: string;
+    partsTotal?: number;
+    acceptedParts?: number;
+    acceptedScenes?: number;
+    failedPart?: number;
+    reasons?: string[];
+    lines: string[];
+}
 export interface VideoRunNode {
     nodeId: string;
     kind: string;
     status: "idle" | "running" | "done" | "failed" | "skipped" | "out-of-scope";
     error?: string;
     warning?: string;
+    planFailure?: PlanFailureRecord;
+    hasRejectedDraft?: boolean;
     outputs?: ArtifactSubset[];
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
@@ -205,6 +240,9 @@ export declare function stepName(kind: string | undefined): string;
 export declare function isShowAd(run: Pick<VideoRun, "moduleOwned">): boolean;
 export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId" | "moduleOwned">): string;
 export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string): string[];
+export declare function failedStoryboardNode(run: VideoRun): VideoRunNode | undefined;
+export declare function errorEchoesReasons(error: string | undefined, record: PlanFailureRecord | undefined): boolean;
+export declare function planFailureLines(node: VideoRunNode | undefined, runId: string): string[];
 export interface PullDownload {
     file: string;
     url: string;
@@ -263,7 +301,7 @@ export interface VideoManifest {
     failed: PullFailure[];
     provenance?: RunProvenance;
 }
-export declare const CAST_LEDGER_BASE = 910000;
+export declare const CAST_LEDGER_BASE: number;
 export interface PullPlan {
     downloads: PullDownload[];
     texts: PullTextFile[];
@@ -294,6 +332,7 @@ export declare function waitFlow(runId: string, opts: {
     maxPolls?: number;
 }, deps: VideoDeps): Promise<FlowResult>;
 export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function rejectedDraftFlow(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, opts: {
     json: boolean;

package/dist/commands/video.js

@@ -6,6 +6,7 @@ import { displayRunStatus, formatApiError } from "../lib/format.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { hasBinary } from "../lib/preflight.js";
 import { ASSET_UPLOAD_POLICY, pauseAheadLine, } from "./workflow.js";
+import { HELPER_LEDGER_BASE } from "../lib/helperLedgerBase.js";
 export const helpText = `
 exodus video — make a video ad from a saved workflow, pull every piece, upload your cut
 
@@ -41,7 +42,13 @@ The whole loop, in order:
        Redo ONE still at the pixel gate. Neighbours stay. The gate holds.
 
   7. exodus video status <runId>
-     Where the run is and how each scene's clip turned out.
+     Where the run is and how each scene's clip turned out. If the storyboard
+     failed, it also says which parts of it were accepted and why the next one
+     was turned down.
+
+     exodus video status <runId> --rejected-draft
+       Prints the storyboard draft that was turned down. A record of what
+       happened, thrown away by the system — never something to act on.
 
   8. exodus video pull <runId> --out ./ad
      Writes every piece to that folder plus a manifest.json index.
@@ -67,7 +74,7 @@ The whole loop, in order:
       or add --approve-stale-cut to deliver the cut you already uploaded.
 
 Usage:
-  exodus video status <runId> [--json]
+  exodus video status <runId> [--rejected-draft] [--json]
   exodus video storyboard <runId> [--json]
   exodus video approve <runId> [--approve-stale-cut] [--json]
   exodus video retry-frame <runId> --node <nodeId> --scene <n> [--note "..."] [--json]
@@ -99,6 +106,8 @@ Options:
   --clear <who>        Take a character's voice off again (voices). Repeatable
   --from <file.json>   A file of characters and voice IDs (voices). --set and
                        --clear win over the same name in the file
+  --rejected-draft     Print the storyboard draft the system turned down
+                       (status). It was thrown away — a record only
   --json               Machine-readable output
   --help, -h           Print this help
 
@@ -124,6 +133,9 @@ const SHOWS_PATH = "/api/v2/shows";
 const RUNS_PATH = "/api/v2/video/runs";
 const RUN_PATH = "/api/v2/workflow";
 const ITEMS_PATH = "/api/v2/workflow/items";
+const REJECTED_DRAFT_PATH = "/api/v2/workflow/rejected-draft";
+const REJECTED_DRAFT_NOT_ON_THIS_SERVER = "This Exodus server does not keep rejected drafts yet, so there is nothing to read. It arrives " +
+    "with the next server update.";
 const STORYBOARD_PATH = "/api/v2/video/storyboard";
 const FLAG_PATH = "/api/v2/video/storyboard/flag";
 const APPROVE_PATH = "/api/v2/workflow/approve";
@@ -138,6 +150,40 @@ const ASSETS_PATH = "/api/v2/workflows/assets";
 function withoutJudgeFields({ judgeDetail: _d, judgeSeverity: _s, ...rest }) {
     return rest;
 }
+export function qcWithoutJudgeWording(qc) {
+    if (!qc.takes)
+        return qc;
+    return {
+        ...qc,
+        takes: qc.takes.map(({ judgeWording: _w, ...rest }) => rest),
+    };
+}
+export const NO_TAKE_HISTORY_LINE = "no history recorded for this clip";
+const TAKE_NEIGHBOUR_SENTENCE = {
+    "not-applicable": () => "never compared",
+    "not-attached": () => "no neighbours attached",
+    "none-accepted": () => "no accepted neighbours yet",
+    attached: ({ scenes }) => `compared against scene${scenes.length === 1 ? "" : "s"} ${scenes.join(", ")}`,
+};
+export function renderQcTakeHistory(takes) {
+    if (!takes || takes.length === 0)
+        return [NO_TAKE_HISTORY_LINE];
+    const lines = [];
+    takes.forEach((take, index) => {
+        const say = TAKE_NEIGHBOUR_SENTENCE[take.neighbours.state];
+        const parts = [
+            take.failCodes.length ? `failed ${take.failCodes.join(", ")}` : "passed",
+            ...(take.warnCodes.length ? [`warned ${take.warnCodes.join(", ")}`] : []),
+            say(take.neighbours),
+        ];
+        const bonus = take.kind === "soft-retry" ? " (bonus take)" : "";
+        lines.push(`take ${index + 1}${bonus}: ${parts.join("; ")}`);
+        for (const { code, wording } of take.judgeWording ?? []) {
+            lines.push(`  checker said (${code}): ${wording}`);
+        }
+    });
+    return lines;
+}
 export function asVideoRun(data) {
     const run = (data ?? {});
     return { ...run, nodes: Array.isArray(run.nodes) ? run.nodes : [] };
@@ -352,6 +398,13 @@ export function stopLines(stop, runId, runUrl) {
     }
     if (stop.at === "failed") {
         if (stop.repair) {
+            if (!stop.step) {
+                return [
+                    "This run stopped at a step that can't be picked back up from here.",
+                    "Start a fresh run to get this ad made.",
+                    `Open the run:        ${runUrl}`,
+                ];
+            }
             return [
                 `${stepName(stop.step)} failed${stop.error ? `: ${stop.error}` : "."}`,
                 `Try that step again: exodus workflow repair ${runId} retry`,
@@ -377,7 +430,34 @@ export function stopLines(stop, runId, runUrl) {
     }
     return [`Working: ${stageWord(stop.stage)}.`];
 }
-export const CAST_LEDGER_BASE = 910000;
+export function failedStoryboardNode(run) {
+    return run.nodes.find((n) => n.kind === "storyboard" && n.status === "failed");
+}
+export function errorEchoesReasons(error, record) {
+    if (!error || record?.kind !== "rejected")
+        return false;
+    const reasons = record.reasons ?? [];
+    return reasons.length > 0 && reasons.every((reason) => error.includes(reason));
+}
+export function planFailureLines(node, runId) {
+    const record = node?.planFailure;
+    if (!record || !Array.isArray(record.lines) || !node)
+        return [];
+    const reasons = record.kind === "rejected" ? (record.reasons ?? []) : [];
+    const bodyCount = Math.max(0, record.lines.length - reasons.length);
+    const lines = [`What happened to the storyboard step (${node.nodeId}):`];
+    record.lines.forEach((line, i) => {
+        lines.push(i < bodyCount ? `  ${line}` : `    - ${line}`);
+    });
+    if (node?.hasRejectedDraft === true) {
+        lines.push("  A rejected draft is on file. The system threw it away, so it is a record of what happened and nothing to act on.", `  Read it: exodus video status ${runId} --rejected-draft`);
+    }
+    return lines;
+}
+export const CAST_LEDGER_BASE = HELPER_LEDGER_BASE + 10000;
+function isPullSceneIndex(sceneIndex) {
+    return sceneIndex >= 0 && sceneIndex < HELPER_LEDGER_BASE;
+}
 const FALLBACK_EXT = {
     image: "png",
     video: "mp4",
@@ -394,6 +474,10 @@ function extFor(url, family) {
 export function scenePrefix(sceneIndex) {
     return `scene-${String(sceneIndex).padStart(2, "0")}`;
 }
+function clipQcOf(item) {
+    const artifact = item?.artifact;
+    return artifact && artifact.type === "video" ? artifact.qc?.takes : undefined;
+}
 function outputsOfNodeKind(run, kind) {
     return run.nodes.filter((n) => n.kind === kind).flatMap((n) => n.outputs ?? []);
 }
@@ -576,6 +660,8 @@ export function planPull(run, items, opts) {
         for (const frame of artifact.frames ?? []) {
             if (!frame.imageUrl)
                 continue;
+            if (!isPullSceneIndex(frame.sceneIndex))
+                continue;
             keyframeByScene.set(frame.sceneIndex, keyframeDownload(frame.sceneIndex, frame.imageUrl));
         }
     }
@@ -593,7 +679,7 @@ export function planPull(run, items, opts) {
             };
             continue;
         }
-        if (typeof artifact.sceneIndex !== "number" || artifact.sceneIndex < 0)
+        if (typeof artifact.sceneIndex !== "number" || !isPullSceneIndex(artifact.sceneIndex))
             continue;
         voiceByScene.set(artifact.sceneIndex, {
             download: {
@@ -634,6 +720,8 @@ export function planPull(run, items, opts) {
         }
         if (artifact.type !== "video" || typeof artifact.sceneIndex !== "number")
             continue;
+        if (!isPullSceneIndex(artifact.sceneIndex))
+            continue;
         const clip = clipFromArtifact(artifact.sceneIndex, artifact);
         if (!clip)
             continue;
@@ -643,6 +731,8 @@ export function planPull(run, items, opts) {
     const frameItemByScene = new Map();
     const sceneFrameNodeIds = new Set(run.nodes.filter((n) => n.kind === "scene-frames").map((n) => n.nodeId));
     for (const item of items) {
+        if (!isPullSceneIndex(item.sceneIndex))
+            continue;
         if (item.itemKind === "clip")
             clipItemByScene.set(item.sceneIndex, item);
         if (item.itemKind === "frame" && sceneFrameNodeIds.has(item.nodeId)) {
@@ -674,7 +764,7 @@ export function planPull(run, items, opts) {
             ...frameItemByScene.keys(),
         ]),
     ]
-        .filter((sceneIndex) => sceneIndex >= 0 && sceneIndex < CAST_LEDGER_BASE)
+        .filter((sceneIndex) => isPullSceneIndex(sceneIndex))
         .sort((a, b) => a - b);
     const scenes = sceneIndexes.map((sceneIndex) => {
         const clip = clipByScene.get(sceneIndex);
@@ -709,7 +799,7 @@ export function planPull(run, items, opts) {
                     : "this-file",
             voice: voice?.download.file ?? null,
             keyframe: keyframeByScene.get(sceneIndex)?.file ?? null,
-            qc: clip?.qc ?? null,
+            qc: clip?.qc ? qcWithoutJudgeWording(clip.qc) : null,
             revoiced: clip ? clip.revoiced : null,
             speechTrimmed: clip ? clip.speechTrimmed : null,
             rawStorageId: clip ? clip.rawStorageId : null,
@@ -983,7 +1073,10 @@ export async function statusFlow(runId, json, deps) {
     const items = itemsRes.data.items ?? [];
     const hasFinal = hasAttachedCut(items);
     const stop = resolveStop(classifyRun(run), hasFinal);
-    const guidance = stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run));
+    const failedStoryboard = failedStoryboardNode(run);
+    const guidance = stopLines(stop.at === "failed" && errorEchoesReasons(stop.error, failedStoryboard?.planFailure)
+        ? { ...stop, error: undefined }
+        : 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 }));
@@ -991,7 +1084,20 @@ export async function statusFlow(runId, json, deps) {
         return {
             code: 0,
             lines: [
-                JSON.stringify({ runId, status: run.status, stop, items, hasFinal, warnings, guidance }),
+                JSON.stringify({
+                    runId,
+                    status: run.status,
+                    stop,
+                    items,
+                    hasFinal,
+                    warnings,
+                    guidance,
+                    ...(failedStoryboard?.planFailure ? { planFailure: failedStoryboard.planFailure } : {}),
+                    ...(failedStoryboard?.planFailure
+                        ? { storyboardNodeId: failedStoryboard.nodeId }
+                        : {}),
+                    ...(failedStoryboard?.hasRejectedDraft === true ? { hasRejectedDraft: true } : {}),
+                }),
             ],
         };
     }
@@ -1026,6 +1132,7 @@ export async function statusFlow(runId, json, deps) {
         ...(carryingOn(run) ? [CARRYING_ON_LINE] : []),
         ...guidance,
         ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
+        ...planFailureLines(failedStoryboard, runId),
         ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
     ];
     if (byScene.size === 0) {
@@ -1038,6 +1145,11 @@ 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)}`);
             if (row.clip?.lastRedo)
                 lines.push(`       clip: ${row.clip.lastRedo.label}`);
+            if (row.clip?.lastRedo || row.clip?.flagged) {
+                for (const line of renderQcTakeHistory(clipQcOf(row.clip))) {
+                    lines.push(`       ${line}`);
+                }
+            }
             if (row.voiceover?.lastRedo)
                 lines.push(`       voice: ${row.voiceover.lastRedo.label}`);
             if (row.frame?.lastRedo)
@@ -1074,6 +1186,45 @@ export async function statusFlow(runId, json, deps) {
             : "Final cut: not uploaded yet.");
     return { code: 0, lines };
 }
+export async function rejectedDraftFlow(runId, json, deps) {
+    const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
+    if (!runRes.ok)
+        return errorResult(runRes, json);
+    const node = failedStoryboardNode(asVideoRun(runRes.data));
+    if (!node) {
+        const note = "The storyboard on this run didn't fail, so there is no rejected draft to read.";
+        return {
+            code: 0,
+            lines: json ? [JSON.stringify({ runId, nodeId: null, draft: null })] : [note],
+        };
+    }
+    const res = await deps.get(`${REJECTED_DRAFT_PATH}?runId=${encodeURIComponent(runId)}&nodeId=${encodeURIComponent(node.nodeId)}`);
+    if (missingRouteLine(res, "exodus video status --rejected-draft")) {
+        return {
+            code: 1,
+            lines: json
+                ? [JSON.stringify({ ok: false, status: 404, error: REJECTED_DRAFT_NOT_ON_THIS_SERVER })]
+                : [REJECTED_DRAFT_NOT_ON_THIS_SERVER],
+        };
+    }
+    if (!res.ok)
+        return errorResult(res, json);
+    const draft = res.data.draft ?? null;
+    if (json)
+        return { code: 0, lines: [JSON.stringify({ runId, nodeId: node.nodeId, draft })] };
+    if (!draft)
+        return { code: 0, lines: ["No rejected draft was kept for this attempt."] };
+    return {
+        code: 0,
+        lines: [
+            `REJECTED DRAFT — ad run ${runId}, step ${node.nodeId}`,
+            "The system turned this draft down and threw it away. It is kept only as a record of what happened.",
+            "Nothing in it is part of your ad. There is nothing here to act on or edit.",
+            "",
+            ...draft.split("\n"),
+        ],
+    };
+}
 export async function storyboardFlow(runId, json, deps) {
     const res = await deps.get(`${STORYBOARD_PATH}?runId=${encodeURIComponent(runId)}`);
     if (!res.ok)
@@ -2066,8 +2217,12 @@ export async function run(flags, occurrences) {
     if (needsRunId.includes(sub) && !runId) {
         usage(`video ${sub} needs a run id: exodus video ${sub} <runId>`);
     }
-    if (sub === "status")
+    if (sub === "status") {
+        if (flags["rejected-draft"] !== undefined && flags["rejected-draft"] !== false) {
+            return printResult(await rejectedDraftFlow(runId, json, defaultDeps));
+        }
         return printResult(await statusFlow(runId, json, defaultDeps));
+    }
     if (sub === "storyboard")
         return printResult(await storyboardFlow(runId, json, defaultDeps));
     if (sub === "approve") {

package/dist/lib/helperLedgerBase.d.ts

@@ -0,0 +1 @@
+export declare const HELPER_LEDGER_BASE = 900000;

package/dist/lib/helperLedgerBase.js

@@ -0,0 +1 @@
+export const HELPER_LEDGER_BASE = 900000;

package/package.json

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