@aicopycoders/exodus 2026.9.2000-beta.5 → 2026.9.2000-beta.7

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;
@@ -132,6 +156,10 @@ export interface NodeItem {
         take: number;
         outcome: string;
         label: string;
+        displacedHistory?: {
+            title: string;
+            lines: string[];
+        };
     };
     artifact?: ArtifactSubset;
 }
@@ -277,7 +305,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[];

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, SET_OPTION_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
 
@@ -149,6 +150,48 @@ 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;
+}
+function printDisplacedHistory(lines, lastRedo) {
+    const history = lastRedo.displacedHistory;
+    if (!history)
+        return;
+    lines.push(`       ${history.title}`);
+    for (const line of history.lines)
+        lines.push(`         ${line}`);
+}
 export function asVideoRun(data) {
     const run = (data ?? {});
     return { ...run, nodes: Array.isArray(run.nodes) ? run.nodes : [] };
@@ -363,6 +406,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`,
@@ -412,7 +462,10 @@ export function planFailureLines(node, runId) {
     }
     return lines;
 }
-export const CAST_LEDGER_BASE = 910000;
+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",
@@ -429,6 +482,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 ?? []);
 }
@@ -458,7 +515,9 @@ function keyframeDownload(sceneIndex, imageUrl) {
 function reservedCastFrames(items) {
     const byIndex = new Map();
     for (const item of items) {
-        if (item.itemKind === "frame" && item.sceneIndex >= CAST_LEDGER_BASE) {
+        if (item.itemKind === "frame" &&
+            item.sceneIndex >= CAST_LEDGER_BASE &&
+            item.sceneIndex < SET_OPTION_LEDGER_BASE) {
             byIndex.set(item.sceneIndex, item);
         }
     }
@@ -611,6 +670,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));
         }
     }
@@ -628,7 +689,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: {
@@ -669,6 +730,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;
@@ -678,6 +741,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)) {
@@ -709,7 +774,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);
@@ -744,7 +809,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,
@@ -1088,10 +1153,19 @@ 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)
+            if (row.clip?.lastRedo) {
                 lines.push(`       clip: ${row.clip.lastRedo.label}`);
-            if (row.voiceover?.lastRedo)
+                printDisplacedHistory(lines, row.clip.lastRedo);
+            }
+            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}`);
+                printDisplacedHistory(lines, row.voiceover.lastRedo);
+            }
             if (row.frame?.lastRedo)
                 lines.push(`       picture: ${row.frame.lastRedo.label}`);
             for (const finding of row.clip?.findings ?? []) {

package/dist/lib/helperLedgerBase.d.ts

@@ -0,0 +1,3 @@
+export declare const HELPER_LEDGER_BASE = 900000;
+export declare const SET_OPTION_LEDGER_BASE = 920000;
+export declare const CAST_OPTION_LEDGER_BASE = 960000;

package/dist/lib/helperLedgerBase.js

@@ -0,0 +1,3 @@
+export const HELPER_LEDGER_BASE = 900000;
+export const SET_OPTION_LEDGER_BASE = 920000;
+export const CAST_OPTION_LEDGER_BASE = 960000;

package/package.json

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