@aicopycoders/exodus 2026.9.1900-beta.2 → 2026.9.2000-beta.0

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

@@ -147,9 +147,15 @@ minutes with "Still running after 60 minutes" and exit 0; that is not done, so
 check `status` before treating it as finished. Do not poll `status` in a tight
 loop; a full run is several minutes.
 
-**What costs money.** Starting the run creates the storyboard. Approving the
-storyboard is the cost gate: it releases the paid rendering of every picture,
-voice and clip. `shows`, `workflow list`, `workflow describe`, `video status`,
+**What costs money.** Starting the run writes the storyboard and then draws the
+reference, cast and scene pictures, and only then pauses. Each picture is a few
+cents and each scene draws a few to choose from: about 25 cents on a small test,
+and it can approach a dollar on a longer ad. Approving releases the expensive
+part: the voices and the clips. So a run that has not paused yet is already
+spending a little, and a run still drawing pictures is healthy. `exodus workflow
+status` and `exodus video status` both print "This run will pause for your
+approval once the frames are ready" on a run that is headed for the gate. Do not
+cancel it because the pause has not arrived. `shows`, `workflow list`, `workflow describe`, `video status`,
 `storyboard` and `pull` are free reads; run them as often as you like. Never
 start a second run to "retry" without the user asking; flag the storyboard (Show
 runs) or tell them what failed instead.
@@ -157,7 +163,7 @@ runs) or tell them what failed instead.
 **`--auto-approve` does not cover either video gate.** It releases Checkpoint
 boxes only (`convex/workflows.ts:7266` keys on `pauseReason === "checkpoint"`),
 and the storyboard gate and the final watch carry no pause reason. An unattended
-`workflow run --auto-approve` still stops dead at the cost gate — which is the
+`workflow run --auto-approve` still stops dead at the storyboard gate — which is the
 safe behaviour, since nothing should approve paid rendering or ship an uncut ad
 on its own.
 
@@ -276,8 +282,9 @@ for the user, then ask one question.
 On a **workflow run** the question is approve or don't — there is no flag. If
 the storyboard is wrong, say so plainly and let the user decide between
 approving anyway, cancelling (`exodus workflow cancel <runId>`) and re-running
-with a better script, or changing the workflow. Approving is the cost gate, so
-do not approve a storyboard you have just told the user is wrong.
+with a better script, or changing the workflow. Approving is what releases the
+voices and the clips — the expensive part — so do not approve a storyboard you
+have just told the user is wrong.
 
 On a **Show run** you can also send it back: `video flag <runId> --note "…"`.
 The note is read by the model that rewrites the storyboard, so make it concrete
@@ -457,7 +464,10 @@ changed[]             the characters whose voice actually moved (set only)
 canChange             false once the run has left the storyboard review
 whyNot                why, in one sentence, when canChange is false
 treatment.path        which way of making voices this run froze, or null
-treatment.kind        "performance-then-conversion" or "render-owns-voice"
+treatment.kind        "performance-then-conversion", "voiceover-then-lipsync" or
+                      "render-owns-voice"
+treatment.pinsHeard   true when the chosen ElevenLabs voices are heard on this
+                      run; false only for "render-owns-voice"
 cast[]                one per character
   characterId, name
   voice               { voiceId, label }: the voice this character's clips are

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

@@ -237,7 +237,7 @@ Two limits worth knowing before you treat an empty inbox as proof of anything:
 
 **What `inbox` does not list is work that isn't waiting on anybody.** A queued run, a running run, and any automation that ran start-to-finish without an approval step never appear there — not because they're hidden, but because there is nothing for you to decide. Plenty of workflows are built that way on purpose; the shipped **Winner Flywheel** starter is one (brief → splitter → output, no Checkpoint box anywhere), so its run *can never* show up in `inbox`. An empty inbox after a promote means "nothing needs you", not "nothing ran".
 
-**To see runs that aren't waiting on you, run `workflow status` with no `--id`.** That prints the brand's recent runs — newest first, one row each with the workflow name, its status, the **date** it started, and its **run id**. That bare list is how you discover a background run at all, including one that started and finished while you weren't looking; take the id from it and `status --id <runId>` for the full detail.
+**To see runs that aren't waiting on you, run `workflow status` with no `--id`.** That prints the brand's recent runs — newest first, one row each with the run's own name (the name you gave it, else the first line of its brief, else the workflow's name), its type ("Copy run" or "Workflow"), its status, the **date** it started, and its **run id**. That bare list is how you discover a background run at all, including one that started and finished while you weren't looking; take the id from it and `status --id <runId>` for the full detail.
 
 Two things about that list you have to know before you answer a question with it:
 

package/dist/commands/video.d.ts

@@ -1,6 +1,6 @@
 import { type ApiResponse } from "../lib/client.js";
 import type { FlagOccurrence } from "../lib/args.js";
-import { type RunProvenance } from "./workflow.js";
+import { type RunProvenance, type WorkflowRun } from "./workflow.js";
 export declare const helpText: string;
 export declare const VOICES_PATH = "/api/v2/video/voices";
 export interface ClipWord {
@@ -100,6 +100,7 @@ export interface VideoRun {
     pauseReason?: BuilderPauseReason;
     pausedNodeId?: string;
     nodes: VideoRunNode[];
+    pauseAhead?: WorkflowRun["pauseAhead"];
     castLock?: PullCastLock | null;
     provenance?: RunProvenance;
     workflowId?: string;
@@ -115,6 +116,7 @@ export interface NodeItem {
     attempt?: number;
     flagged?: boolean;
     findings?: ClipFinding[];
+    staleClaim?: boolean;
     artifact?: ArtifactSubset;
 }
 export interface ShowRow {
@@ -296,6 +298,7 @@ export interface ClipRedoTarget {
 }
 export declare function planClipRedo(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
 export declare function retryClipFlow(runId: string, target: ClipRedoTarget, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare const VOICE_PATHS_NEVER_HEARD: Set<string>;
 export declare function planClipRevoice(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
 export type RevoiceTarget = ClipRedoTarget | {
     all: true;

package/dist/commands/video.js

@@ -5,7 +5,7 @@ import { apiGet, apiPost, getDashboardUrl } from "../lib/client.js";
 import { displayRunStatus, formatApiError } from "../lib/format.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { hasBinary } from "../lib/preflight.js";
-import { ASSET_UPLOAD_POLICY } from "./workflow.js";
+import { ASSET_UPLOAD_POLICY, pauseAheadLine, } from "./workflow.js";
 export const helpText = `
 exodus video — make an ad from a Show, pull every piece, upload your cut
 
@@ -921,6 +921,8 @@ const ITEM_STATUS_WORD = {
 function itemWord(item) {
     if (!item)
         return "—";
+    if (item.staleClaim === true)
+        return "stopped";
     if (item.flagged === true)
         return "flagged";
     return ITEM_STATUS_WORD[item.status] ?? item.status;
@@ -974,6 +976,7 @@ export async function statusFlow(runId, json, deps) {
     const lines = [
         headline,
         ...stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run)),
+        ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
         ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
     ];
     if (byScene.size === 0) {
@@ -1176,6 +1179,7 @@ export function planClipRedo(run, items, target) {
         return { ok: false, reason: found.reason };
     const { row, uploadedCut } = found;
     const redoable = row.status === "failed" ||
+        row.staleClaim === true ||
         (row.status === "done" && (row.flagged === true || stop.at === "final-watch"));
     if (!redoable) {
         if (row.status === "done") {
@@ -1228,7 +1232,7 @@ function findClipRow(run, items, target) {
                 "and one clip can only be redone on a step that finished.",
         };
     }
-    if (row.status === "running") {
+    if (row.status === "running" && row.staleClaim !== true) {
         return { reason: `Scene ${target.sceneIndex} is already being redone.` };
     }
     return { row, uploadedCut };
@@ -1294,20 +1298,34 @@ export async function retryClipFlow(runId, target, note, json, deps) {
 }
 function clipIsStillRaw(item) {
     const a = item.artifact;
-    return (item.status === "done" &&
+    return ((item.status === "done" || item.staleClaim === true) &&
         a?.type === "video" &&
         a.revoiced !== true &&
         a.speechTrimmed !== true &&
         a.tailTrimmed !== true);
 }
 const VOICE_NOT_CHANGED_CODES = new Set(["voice-unpinned", "voice-not-applied"]);
+export const VOICE_PATHS_NEVER_HEARD = new Set(["native-prompt", "omni-audio-ids", "gemini-direct"]);
+async function neverHeardRunLine(runId, deps) {
+    const res = await deps
+        .get(`${VOICES_PATH}?runId=${encodeURIComponent(runId)}`)
+        .catch(() => null);
+    if (!res?.ok)
+        return null;
+    const path = res.data?.treatment?.path;
+    if (typeof path !== "string" || !VOICE_PATHS_NEVER_HEARD.has(path))
+        return null;
+    return (`This run's clips are not voiced by ElevenLabs — the "${path}" way settles each voice as ` +
+        "the clip is rendered — so no clip on this run has a voice pass to redo. Nothing was queued " +
+        "and nothing was spent. To make a clip again from scratch, redo the clip instead.");
+}
 export function planClipRevoice(run, items, target) {
     const found = findClipRow(run, items, target);
     if ("reason" in found)
         return { ok: false, reason: found.reason };
     const { row, uploadedCut } = found;
     const remake = `To make the clip again from scratch: exodus video retry-clip ${run._id} --scene ${target.sceneIndex}`;
-    if (row.status !== "done" || row.artifact?.type !== "video") {
+    if ((row.status !== "done" && row.staleClaim !== true) || row.artifact?.type !== "video") {
         return {
             ok: false,
             reason: `Scene ${target.sceneIndex} has no finished clip, so there is no voice to redo. ${remake}`,
@@ -1351,10 +1369,11 @@ export async function revoiceFlow(runId, target, json, deps) {
             .map((i) => ({ sceneIndex: i.sceneIndex, nodeId: i.nodeId }))
         : [target];
     if (targets.length === 0) {
-        const nothing = "No clip on this run is waiting for a voice pass, so nothing was started.";
+        const note = (await neverHeardRunLine(runId, deps)) ??
+            "No clip on this run is waiting for a voice pass, so nothing was started.";
         return {
             code: 0,
-            lines: json ? [JSON.stringify({ ok: true, runId, scenes: [], note: nothing })] : [nothing],
+            lines: json ? [JSON.stringify({ ok: true, runId, scenes: [], note })] : [note],
         };
     }
     const scenes = [];
@@ -1551,7 +1570,8 @@ export function voiceSheetLines(sheet) {
     for (const row of sheet.cast) {
         const voice = voiceWords(row);
         lines.push(`  ${row.characterId}  ${row.name}  ${voice}  ${availabilityWords(row)}  ` +
-            `speaks in ${row.spokenScenes} scenes, about ${row.spokenSeconds}s`);
+            `speaks in ${row.spokenScenes} scene${row.spokenScenes === 1 ? "" : "s"}, ` +
+            `about ${row.spokenSeconds}s`);
         if (row.description)
             lines.push(`      written voice: ${row.description}`);
     }
@@ -1565,8 +1585,9 @@ export function voiceSheetLines(sheet) {
             : "Nothing changed — those voices were already set. Pictures and script were not touched.");
     }
     lines.push(`How voices are applied: ${sheet.treatment.summary}${sheet.treatment.speedChange ? "" : " No speed change."}`);
-    const rendersOwnVoice = sheet.treatment.kind === "render-owns-voice";
-    if (!rendersOwnVoice || sheet.treatment.usesElevenLabs === undefined) {
+    const playsPinnedVoices = sheet.treatment.kind !== "render-owns-voice";
+    const convertsClips = playsPinnedVoices && sheet.treatment.usage.clips > 0;
+    if (convertsClips || sheet.treatment.usesElevenLabs === undefined) {
         lines.push(`Cost: billed to your own ElevenLabs key. ${sheet.treatment.costNote} ` +
             `About ${sheet.treatment.usage.seconds} seconds of speech across ` +
             `${sheet.treatment.usage.clips} clips will be converted.`);

package/dist/commands/workflow.d.ts

@@ -386,6 +386,9 @@ export interface WorkflowRun {
     _id: string;
     workflowId: string;
     workflowName: string;
+    runTitle?: string;
+    title?: string;
+    moduleKey?: string;
     status: WorkflowRunStatus;
     error?: string;
     counts?: WorkflowCounts;
@@ -408,7 +411,12 @@ export interface WorkflowRun {
         approvedAt: number;
     }[];
     provenance?: RunProvenance;
+    pauseAhead?: {
+        nodeId: string;
+        after: "frames" | "storyboard";
+    };
 }
+export declare function pauseAheadLine(ahead: NonNullable<WorkflowRun["pauseAhead"]>): string;
 export type WorkflowRunProjection = Omit<WorkflowRun, "nodes"> & {
     nodes?: never;
 };

package/dist/commands/workflow.js

@@ -6,6 +6,7 @@ import { formatApiError } from "../lib/format.js";
 import { pollUntilDone } from "../lib/poll.js";
 import { normalizeRunStatus, isTerminalRunStatus, storedWorkflowStatusForms, TERMINAL_RUN_STATUSES, } from "../lib/runStatus.js";
 import { runVerdict } from "../lib/runVerdict.js";
+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";
@@ -366,6 +367,11 @@ export function formatRulesLine(provenance) {
         : "";
     return `Format rules: ${rigName}${version}${where}.${borrowed}`;
 }
+export function pauseAheadLine(ahead) {
+    return ahead.after === "frames"
+        ? "This run will pause for your approval once the frames are ready. The reference, cast and scene pictures are made first (a few cents each). Nothing bigger is spent until you approve."
+        : "This run will pause for your approval once the storyboard is written. Nothing is spent on pictures, voices or clips until you approve.";
+}
 const LIST_PATH = "/api/v2/workflows";
 const RUN_PATH = "/api/v2/workflows/run";
 const STATUS_PATH = "/api/v2/workflow";
@@ -1114,7 +1120,13 @@ const RECENT_RUNS_PAGE = 25;
 export function formatRecentRuns(runs) {
     if (runs.length === 0)
         return "No workflow runs found for the active brand.";
-    const rows = table(["workflow", "status", "created", "id"], runs.map((r) => [r.workflowName, runVerdict(r), dateOnly(r.createdAt), r._id]));
+    const rows = table(["run", "type", "status", "created", "id"], runs.map((r) => [
+        runDisplayName(r),
+        runTypeWord(r),
+        runVerdict(r),
+        dateOnly(r.createdAt),
+        r._id,
+    ]));
     const notes = [];
     if (runs.length >= RECENT_RUNS_PAGE) {
         notes.push(`Showing the ${RECENT_RUNS_PAGE} newest runs — there may be older ones this list doesn't reach.`);
@@ -1195,7 +1207,7 @@ export function formatImportSummary(result, mode = {}) {
 export function formatWorkflowRun(run) {
     const lines = [];
     const counts = formatCounts(run.counts);
-    lines.push(`Workflow run — ${run.workflowName}`);
+    lines.push(`${runHeadingWord(run)} — ${runDisplayName(run)}`);
     lines.push(`runId:        ${run._id}`);
     lines.push(`workflowId:   ${run.workflowId}`);
     if (run.triggerRunId)
@@ -1218,6 +1230,10 @@ export function formatWorkflowRun(run) {
     if (run.autoApprovals && run.autoApprovals.length > 0) {
         lines.push(`auto-approved: ${run.autoApprovals.length} checkpoint stop${run.autoApprovals.length === 1 ? "" : "s"} (${run.autoApprovals.map((a) => a.nodeId).join(", ")}) — launched with --auto-approve, nobody reviewed these`);
     }
+    if (run.pauseAhead) {
+        lines.push("");
+        lines.push(pauseAheadLine(run.pauseAhead));
+    }
     const parkedNodeId = gateParkedNodeId(run.status, run.pauseReason, run.pausedNodeId);
     if (run.nodes.length > 0) {
         lines.push("");

package/dist/lib/runNames.d.ts

@@ -0,0 +1,10 @@
+export declare const COPY_FACE_MODULE_KEY = "copy-face";
+export interface RunNameFields {
+    workflowName?: string;
+    runTitle?: string;
+    title?: string;
+    moduleKey?: string;
+}
+export declare function runDisplayName(run: RunNameFields): string;
+export declare function runTypeWord(run: RunNameFields): string;
+export declare function runHeadingWord(run: RunNameFields): string;

package/dist/lib/runNames.js

@@ -0,0 +1,10 @@
+export const COPY_FACE_MODULE_KEY = "copy-face";
+export function runDisplayName(run) {
+    return run.title || run.runTitle || run.workflowName || "";
+}
+export function runTypeWord(run) {
+    return run.moduleKey === COPY_FACE_MODULE_KEY ? "Copy run" : "Workflow";
+}
+export function runHeadingWord(run) {
+    return run.moduleKey === COPY_FACE_MODULE_KEY ? "Copy run" : "Workflow run";
+}

package/package.json

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