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

package/assets/docs/PIPELINES.md

@@ -152,7 +152,8 @@ run options:
   --mode auto|manual|hybrid   Generation mode (default: auto)
   --render-mode images|prompts   prompts = skip render, return LLM prompts only (default: images)
   --aspect 1:1|9:16     Image aspect ratio (default: 1:1)
-  --model gpt-image-2|nano-banana-pro   Kie.ai model (default: gpt-image-2)
+  --model gpt-image-2.5|gpt-image-2.5-sunburst|gpt-image-2|nano-banana-pro
+                        Kie.ai model (default: gpt-image-2.5)
   --realism off|realistic   Realism enforcement (default: off)
   --quantities "slug:N,slug:N"   manual-mode per-type counts (e.g. "testimonial:3,hero:2")
   --pairings '<JSON>'   hybrid-mode host/modifier pairs: '[{"host":"testimonial","modifier":"hero"}]'

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

@@ -244,6 +244,7 @@ internals into chat.
 - The rig's child image runs are still `creativeSuiteRuns` with engine `meme`,
   so finished memes appear in the creative-suite library alongside other engines
   and `exodus browse --agent meme` still covers them.
-- `run` accepts only the two models the rig renders (`gpt-image-2`,
-  `nano-banana-pro`, or their Kie slugs); anything else is a 400 listing the
-  accepted values. It used to accept any value and silently ignore it.
+- `run` accepts only the models the rig renders (`gpt-image-2.5`, the house
+  default, plus `gpt-image-2.5-sunburst`, `gpt-image-2` and `nano-banana-pro`,
+  or their Kie slugs); anything else is a 400 listing the accepted values. It
+  used to accept any value and silently ignore it.

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

@@ -17,7 +17,8 @@ run options:
   --mode auto|manual|hybrid   Generation mode (default: auto)
   --render-mode images|prompts   prompts = skip render, return LLM prompts only (default: images)
   --aspect 1:1|9:16     Image aspect ratio (default: 1:1)
-  --model gpt-image-2|nano-banana-pro   Kie.ai model (default: gpt-image-2)
+  --model gpt-image-2.5|gpt-image-2.5-sunburst|gpt-image-2|nano-banana-pro
+                        Kie.ai model (default: gpt-image-2.5)
   --realism off|realistic   Realism enforcement (default: off)
   --quantities "slug:N,slug:N"   manual-mode per-type counts (e.g. "testimonial:3,hero:2")
   --pairings '<JSON>'   hybrid-mode host/modifier pairs: '[{"host":"testimonial","modifier":"hero"}]'

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

@@ -21,12 +21,27 @@ Your job in this skill is to drive that loop, hand over the pieces with the
 facts about them, and make whatever cut the user asked for. **How to edit is the
 user's call, not this skill's** — see "Cutting the ad".
 
+This file ships on the member's machine. It holds commands, the manifest's
+shape, and recipes for the cut. It does not hold prompt text, house primers,
+judge wording, or model instructions.
+
 ## How a run starts
 
 The ad is a saved workflow in the brand, started script-first with `exodus
 workflow run`. From there the same nodes render, `video status` reads the run,
 `video pull` writes the folder, and `video upload` and `approve` finish it.
 
+A Show is no longer required. `exodus video start` starts from a script, a
+conceit, and a style, and the same parks follow. The full line is under
+"Starting a run". An optional `--direction` note is whole-ad rules, and that
+note cannot contain a colon. "The script file" shows the right form and the
+wrong one.
+
+The Rig box on that workflow is where the run's Conceit and Style come from.
+Conceit is the family plus Wrapper, Narrator Person, and Delivery. Style is the
+look. Narrated Story is the voice-over family and Acted Story is the dialogue
+family (`familyTree.ts`). Those family names stay the code's names.
+
 ## Before anything
 
 - `npx @aicopycoders/exodus video --help` and `workflow --help` are the
@@ -69,6 +84,11 @@ exodus workflow run <workflowId|name> --input <field>=@script.txt --voices @voic
 exodus workflow run <workflowId|name> --input <field>=@script.txt --voice-treatment @voice-treatment.json --wait
                                                           same, with the video model speaking voices you WROTE
 exodus video status <runId>                               where it is, per scene
+exodus video start --script <file> --conceit <podcast|ugc|stage|street|personification> --style <slug> [--direction "…"] [--voice-path <path>] [--video-model <id>] [--voice native] [--music] [--wait]
+                                                          start from a script, a conceit and a look.
+                                                          No music bed unless you pass --music.
+                                                          Each conceit has its own video model and voice;
+                                                          --video-model / --voice override them for one run
 ```
 
 **From the storyboard on.**
@@ -81,7 +101,7 @@ exodus video approve <runId>                              keep going
 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
-exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"]
+exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
                                                           redo one clip at the final watch
 exodus video revoice <runId> --all | --scene <n>          redo only the voice; no new video
                                                           … make the cut (your choice of tool)
@@ -98,13 +118,24 @@ already printed the same stop block, and `workflow inbox` lists a parked video
 run, but neither shows the per-scene detail, and the checkpoint verbs cannot
 resolve a video park — see "What the CLI can and cannot do".
 
-**Where a run can stop.** Five stops, each with the exact next command printed
+**Where a run can stop.** The two video parks come in order when the run has
+both. The storyboard gate is first. You read the cards there and you set the
+voices there. Approving that gate releases the voices and the clips. That is the
+expensive part. The final watch is next, after the pieces exist, and only when
+the video node sets `finalWatch: true`. That park is for the cut. You pull, you
+cut, and you upload. Approving the upload makes it the ad. A node with
+`finalWatch` off skips the second park and the run finishes.
+
+Five stops, each with the exact next command printed
 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.
@@ -112,6 +143,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
@@ -203,11 +239,42 @@ anything:
 
 ## The script file
 
-Plain text. A `CAST:` block naming the speakers, one line per turn, then a
-`CTA:` block. The planner sizes every line at
-2.5 words per second (`WORD_LADDER_WPS`), so a turn near 14 words plans a clip
-near 6 seconds. If a line does get truncated in its clip, the manifest says so
-(`speech-cutoff`).
+Plain text. An optional `DIRECTION:` block may open the file, before `CAST:` or
+the first spoken line. Then a `CAST:` block naming the speakers, one line per
+turn, then a `CTA:` block.
+
+`DIRECTION:` carries whole-ad rules and no spoken words. The header is its own
+line. The lines under it are the rules. The block ends at a blank line, at
+`CAST:`, at `CTA:`, or at the first line that names a speaker. A second
+`DIRECTION:` block is refused. So is a `DIRECTION:` after the first spoken line.
+An empty block is refused too. The error code is `malformed-direction`.
+
+Do not put a colon inside direction prose. The reader splits a line at its first
+colon to find a speaker, so a colon in that prose is read as a name.
+
+Right.
+
+```
+DIRECTION:
+Nobody looks at the camera. The product stays on the table until the last line.
+```
+
+Wrong.
+
+```
+DIRECTION:
+Rule: nobody looks at the camera.
+```
+
+The wrong line is not direction. `Rule` is read as the speaker, and the
+block above it is empty, so the file is refused.
+
+The planner sizes every line at 2.5 words per second (`WORD_LADDER_WPS`), so a
+turn near 14 words plans a clip near 6 seconds. If a line does get truncated in
+its clip, the manifest says so (`speech-cutoff`). That finding means the clip
+cut the words off. Redo the clip. Do not speed the speech or cut it short to
+hide the finding. The product rule is under "What the product actually
+requires".
 
 ```
 CAST:
@@ -221,6 +288,15 @@ CTA:
 THE SOFTGEL: Tap below and give your eyes ClearBlink.
 ```
 
+The dash in a `CAST:` line is the parser's own separator. The example above
+already shows that dash. A cast line may separate the name from the description
+with an em dash, an en dash, or a hyphen with a space on each side. Keep that
+dash on cast lines. A reader who strips it makes the line fail.
+
+Do not use a long dash in words a character says, or in words shown on screen.
+Synthesised speech reads a long dash oddly, and so does burned-in text. A spoken
+line stays `NAME: what they say`.
+
 **How many speakers you may have depends on the rig.** Three by default. A rig
 that carries saved format rules sets its own number: an ensemble rig seats more,
 a talking-head rig seats one. Over the number, the launch refuses before
@@ -253,9 +329,13 @@ unattended.
 By default a workflow run's characters have no voice of their own. A character
 without one gets the run's default voice (the workflow's narrator voice) when the
 run has one; with no default either, the clip keeps the voice the video model
-invents. `exodus video voices` shows which of the three applies and is where it
-gets fixed, and it only works **before** the storyboard is approved — once clips start
-it refuses.
+invents. `exodus video voices` shows which of the three applies, and it is where you
+fix the mapping. Fix it before you approve the storyboard gate. Approving that
+gate locks the mapping, and `exodus video voices` refuses afterwards. On a
+finished clip whose voice was never applied, the later command is `exodus video
+revoice`, and that pass bills again. A clip that already went through the voice
+pass is refused there. Use `retry-clip` for that one. See "Redoing only the
+voice on finished clips".
 
 ```
 exodus video voices <runId>
@@ -329,7 +409,7 @@ nobody knows the speaker names yet. When the storyboard arrives, the voices are
 already set and `exodus video voices <runId>` shows them.
 
 **Choosing how the voices are made.** `--voice-treatment` on `workflow run` says
-HOW a run makes its voices, and it is the only door. Two
+HOW a run makes its voices, and it is the only way. Two
 kinds of answer.
 
 A name on its own picks a way of working that plays a voice you already have,
@@ -402,7 +482,8 @@ person made at a keyboard for one run, and nobody made it for the sub-workflow.
 **Written voices cannot be changed at the review.** They are chosen when the run
 starts. `exodus video voices <runId>` on a described run names the treatment and
 prints each written voice, and says plainly that `--voice-treatment` at launch is
-what changes them. Do not set a voice path in node config — it is not a door.
+what changes them. Do not set a voice path in node config. Node config does
+not set the treatment.
 
 **Where it shows up afterwards.** The launch receipt and `exodus workflow status`
 both print one line naming the treatment and the speakers who got a written
@@ -480,6 +561,15 @@ manifest.json            the index below
 runId, pulledAt, dashboardUrl        the run and the page that opens it:
                                      /workflows/<workflowId>/runs/<runId>
 storyboard, reference, music         filenames, or null when not delivered
+musicBed                             on | off | unknown — whether the RUN has a
+                                     music bed, which is not the same question
+                                     as the `music` filename above. "unknown" is
+                                     a run made before the run carried the
+                                     answer; it is not "off"
+musicHeardScenes[]                   scene numbers whose clip came back with
+                                     music the video model baked in. A run with
+                                     the bed off can still list scenes here, and
+                                     those are the ones to listen to
 narration                            { file, timing }, or null on a per-scene run
 cast[]                               one per identity still
   characterId, name                  from the run's cast lock; null for an
@@ -512,6 +602,9 @@ scenes[]                             one per scene, in order
                                      on record when the voice pass replaced the
                                      clip with a new file; null when the clip IS
                                      that file, or there is no clip
+  voiceMode                          "voice-first" when the clip was redone voice
+                                     first (its line recorded, then the clip made
+                                     to match it); null otherwise
 provenance                           which saved rulebook this run followed:
                                      {format: {via, nodeId, rigId, rigName,
                                      rulesFrom, specVersion}}. Absent when the
@@ -541,8 +634,9 @@ envelope also carries `overlays[]` (each with a `cueLineId` and a `placement`)
 and `audio` (`roomTone`, `music`, `sfxCues[]`) — the planner's notes on what
 should sit on top. The image and motion prompts (`framePrompt`, `videoPrompt`,
 `referencePrompt`) reach an admin key in full. A caller who cannot use video on
-this brand gets them stripped before the file arrives — they are style-pack IP
-(`redactVideoIp` in `convex/workflows.ts`).
+this brand gets them stripped before the file arrives. They are private Style
+fragment IP (`redactVideoIp` in `convex/workflows.ts`). Style pack is the
+retired name.
 
 **The narration track** (`narration.mp3` + `narration.json`). Present when the
 run recorded continuously: every narrated scene's `voText` joined into one
@@ -569,9 +663,9 @@ speech inside the clip — under the default voice treatment the video model's
 invented voice is then replaced, in place, with the cast member's pinned
 ElevenLabs voice (that is `revoiced: true`). Other treatments leave the render
 owning its own audio, e.g. lip-sync retargeting a VO track onto the video. The
-treatment is frozen on the run when it starts, and there is exactly one door
+treatment is frozen on the run when it starts, and there is exactly one flag
 that sets it: `--voice-treatment` on `workflow run` (see **Choosing how the
-voices are made**). Node config is never a door — nothing on the canvas sets a
+voices are made**). Node config never sets it. Nothing on the canvas sets a
 voice treatment, and a run that was given none renders the default. Read
 `wordsFrom` and `revoiced` per scene rather than assuming.
 
@@ -633,6 +727,11 @@ blocking the run.
   A `speech-cutoff` on the CTA scene is the one to worry about; the ad's last
   words are missing. `status` shows the checker's own wording behind each
   finding; the manifest carries only the verdict.
+- A `pass` verdict is not a review. The checks are often optimistic. Watch the
+  frames and listen to the audio before you call the run good. Two checks fail
+  the wrong way. A cast-count check can reject a silent
+  listener who belongs in the shot. A clip check can flag a clip that is fine.
+  Read the finding, then watch the scene.
 - `clipStatus: "failed"` or `"missing"` with a `keyframe`: `durationSec` is null
   (it comes from the clip), but the scene can still hold its place as a still —
   for the length of its voice track, or the storyboard's planned duration when
@@ -650,6 +749,7 @@ is no second run, no new storyboard and no re-render of anything else.
 exodus video retry-clip <runId> --scene 3
 exodus video retry-clip <runId> --scene 3 --note "keep both hands in frame on the handshake"
 exodus video retry-clip <runId> --scene 3 --node video-2
+exodus video retry-clip <runId> --scene 3 --voice-first
 ```
 
 `--node` is only needed when a run has clips for that scene on two video steps;
@@ -672,13 +772,26 @@ revoiced and trimmed the same way, with fresh findings and fresh word timings.
 scene's motion prompt only (`withRedoDirection`,
 `scout/src/trigger/workflow-scene-retry.ts`); the spoken line still comes from
 the approved storyboard. Asking for different words in a note will not change
-them. If the words are wrong, that is a new run.
+them. If the script's words are wrong, that is a new run.
+
+**`--voice-first` fixes a clip that said its line wrong** (#2299). It is for a
+clip whose findings include `speech-mismatch`, `speech-repeat`,
+`speech-after-line` or `speech-long-pause`. The scene's line is recorded in each
+speaker's pinned ElevenLabs voice, and MiniMax (`minimax-h3/reference-to-video`)
+makes the clip to match the recording. Only that clip changes; the word check
+and the other checks still run on it. It needs an ElevenLabs key and a voice for
+every speaker in the scene, and it is refused for a scene with no spoken line.
+The clip then reads `clip: redone voice first` in `status`, carries
+`voiceMode: "voice-first"` in the manifest, and is listed in the `pull` summary.
 
 **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
@@ -756,7 +869,10 @@ they want; if they have not said and are not around, say which you used and why.
 - **HyperFrames** — HTML/CSS compositions rendered to video. Suits an ad that
   needs captions, title cards, overlays or motion graphics laid over the clips.
   It is a separate skill pack; check that a `hyperframes` skill is installed
-  before offering it.
+  before offering it. The cut is made outside Exodus. `exodus video pull` is the
+  handover. The folder it writes is what the next tool reads. When a HyperFrames
+  skill pack is installed, that pack is the route for an HTML and CSS
+  composition. Do not look for a stitch inside Exodus.
 - **An NLE over MCP** — DaVinci Resolve publishes an MCP server, so a timeline
   can be built in a real editor and the user can carry on by hand afterwards.
   Suits a user who wants to keep editing after you stop. Check what MCP servers
@@ -853,6 +969,11 @@ lines, re-recording narration, or cutting words out of the CTA will ship,
 silently. Cut the pictures to the words, not the words to the pictures. If the
 words are wrong, that is a new run, not an edit.
 
+Never stretch speech, speed it up, slow it down, or cut it short so it fits a
+clip. That is a product rule, and it holds for every tool that makes the cut,
+including the bundled script. If the audio does not fit, redo the clip with
+`exodus video retry-clip`. Do not repair the fit in the editor.
+
 ## Reporting to the user
 
 Lead with where the run is and what it needs from them. Then, when you pulled

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

@@ -161,7 +161,7 @@ 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.
+**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 `DIRECTION:` block with no colon in its prose, then 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.
 
 **A saved rig can bring a rulebook with it.** Some saved rigs carry saved format rules: how many speakers the script may have, which checks run on the clips, how the cast is built. Point a Rig box at one of those rigs and the run follows its rules — an ensemble rig seats more speakers than the usual three, a talking-head rig seats one. The start receipt says which rulebook ran:
 

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/image.js

@@ -184,7 +184,7 @@ async function runTemplate(text, flags, who) {
         renderMode: "images",
         inputAds: text,
         aspectRatio: aspect,
-        model: "gpt-image-2",
+        model: "gpt-image-2.5",
         realismMode: realisticFlag ? "realistic" : "off",
         ...(steering ? { steering } : {}),
         ...(requestedImageCount !== undefined ? { requestedImageCount } : {}),

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/template.js

@@ -17,7 +17,8 @@ Run options:
   --mode auto|manual              Generation mode (default: auto)
   --render-mode images|prompts    Skip render and return prompts only (default: images)
   --aspect 1:1|9:16               Image aspect ratio (default: 1:1)
-  --model gpt-image-2|nano-banana-pro   Kie.ai model (default: gpt-image-2)
+  --model gpt-image-2.5|gpt-image-2.5-sunburst|gpt-image-2|nano-banana-pro
+                                  Kie.ai model (default: gpt-image-2.5)
   --realism off|realistic         Realism enforcement (default: off)
   --quantities <slug:N,slug:N>    Manual-mode per-type counts (e.g. "testimonial:3,hero:2")
   --requested-count N             Auto-mode total render target (optional)
@@ -103,9 +104,15 @@ async function runTemplate(flags) {
         process.exit(1);
         return;
     }
-    const model = typeof flags["model"] === "string" ? flags["model"] : "gpt-image-2";
-    if (model !== "gpt-image-2" && model !== "nano-banana-pro") {
-        console.error(`Error: --model must be gpt-image-2 | nano-banana-pro (got "${model}").`);
+    const TEMPLATE_MODELS = [
+        "gpt-image-2.5",
+        "gpt-image-2.5-sunburst",
+        "gpt-image-2",
+        "nano-banana-pro",
+    ];
+    const model = typeof flags["model"] === "string" ? flags["model"] : "gpt-image-2.5";
+    if (!TEMPLATE_MODELS.includes(model)) {
+        console.error(`Error: --model must be one of ${TEMPLATE_MODELS.join(" | ")} (got "${model}").`);
         process.exit(1);
         return;
     }