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

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

@@ -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;

package/dist/commands/video.js

@@ -254,6 +254,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 +316,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 +922,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}`;
@@ -933,15 +965,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 +1007,7 @@ export async function statusFlow(runId, json, deps) {
         : `Ad run ${runId} — ${displayRunStatus(run.status)}`;
     const lines = [
         headline,
-        ...stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run)),
+        ...guidance,
         ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
         ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
     ];
@@ -984,6 +1019,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;
@@ -1201,7 +1242,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));

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
 
@@ -2085,9 +2085,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,

package/package.json

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