@aicopycoders/exodus 2026.10.2400-beta.2 → 2026.11.200-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,7 +9,7 @@ creative inspired by your watchlist's top competitor ads.
9
9
 
10
10
  Usage:
11
11
  exodus swipe run Trigger a run for the active brand
12
- exodus swipe mine [--batch N] Scrape watchlist competitors (default batch=50)
12
+ exodus swipe mine [--batch N] Mine your brand's competitors on your own Scrape Creators key (default batch=50)
13
13
  exodus swipe status <runId> Poll a run by id
14
14
  exodus swipe latest Show the latest run for the active brand
15
15
  exodus swipe history [--limit N] Show recent runs (default 20, max 100)
@@ -147,7 +147,7 @@ async function runMinePipeline(flags) {
147
147
  }
148
148
  console.log(`Mine started: triggerRunId=${res.data.triggerRunId}`);
149
149
  console.log(` batchSize: ${res.data.batchSize ?? batchSize}`);
150
- console.log(`\nScrapes the active watchlist sequentially.`);
150
+ console.log(`\nMines your brand's active competitors, one at a time, on your own Scrape Creators key.`);
151
151
  console.log(`Check progress: exodus swipe brands list`);
152
152
  }
153
153
  async function runStatus(positional, flags) {
@@ -65,6 +65,11 @@ export interface ClipFinding {
65
65
  export declare function qcWithoutJudgeWording(qc: ClipQc): ClipQc;
66
66
  export declare const NO_TAKE_HISTORY_LINE = "no history recorded for this clip";
67
67
  export declare function renderQcTakeHistory(takes: ClipQcTake[] | undefined): string[];
68
+ export interface ReplannedIdea {
69
+ framePrompt?: string;
70
+ videoPrompt?: string;
71
+ imageUrl: string;
72
+ }
68
73
  export type ArtifactSubset = {
69
74
  type: "storyboard";
70
75
  storyboard?: unknown;
@@ -100,6 +105,7 @@ export type ArtifactSubset = {
100
105
  voiceFirstBlockedBy?: string[];
101
106
  voicePitchHz?: number;
102
107
  voicePitchMethod?: string;
108
+ replannedIdea?: ReplannedIdea;
103
109
  } | {
104
110
  type: "audio";
105
111
  sceneIndex?: number;
@@ -460,6 +466,7 @@ export interface ScriptStartOptions {
460
466
  shots?: RunShots;
461
467
  stopAtScript?: true;
462
468
  rewriteToFit?: true;
469
+ sourceRecordFile?: string;
463
470
  wait: boolean;
464
471
  json: boolean;
465
472
  onProgressLine?: (line: string) => void;
@@ -504,6 +511,7 @@ export declare function storyboardFlow(runId: string, json: boolean, deps: Video
504
511
  export declare function approveFlow(runId: string, opts: {
505
512
  json: boolean;
506
513
  approveStaleCut: boolean;
514
+ acceptFindings?: boolean;
507
515
  }, deps: VideoDeps): Promise<FlowResult>;
508
516
  export declare function flagFlow(runId: string, note: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
509
517
  export declare function retryFrameFlow(runId: string, nodeId: string | undefined, sceneIndex: number, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
@@ -129,7 +129,7 @@ Usage:
129
129
  exodus video voices [<runId>] --catalog [--json]
130
130
  exodus video pull <runId> --out <dir> [--json]
131
131
  exodus video upload <runId> --file <cut.mp4> [--duration <sec>] [--json]
132
- exodus video start --script <file> --conceit <kind> --style <look> [--direction "<note>"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice <native|voice-first>] [--music] [--broll] [--one-shot] [--director] [--wait] [--json]
132
+ exodus video start --script <file> --conceit <kind> --style <look> [--direction "<note>"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice <native|voice-first>] [--source-record <file.json>] [--music] [--broll] [--one-shot] [--director] [--wait] [--json]
133
133
  exodus video director <runId> <on|off|follow> [--json]
134
134
 
135
135
  Options:
@@ -156,6 +156,9 @@ Options:
156
156
  --approve-stale-cut Deliver the cut you uploaded even though a clip changed
157
157
  after you uploaded it (approve). Without it, approving
158
158
  stops and names the scenes that changed
159
+ --accept-findings Go on past the check's findings on a storyboard it
160
+ stopped (approve). Without it, approving that
161
+ storyboard stops and says why
159
162
  --set <who>=<voice> Give a character a voice (voices). The voice is a
160
163
  catalog voice's name, like George, or an ElevenLabs
161
164
  voice ID. Name the character by its ID or by the name
@@ -177,6 +180,10 @@ Options:
177
180
  the server can't tell who says a line, it asks and
178
181
  starts nothing. If a description is too thin to write
179
182
  from, it says what is missing and starts nothing
183
+ --source-record <file.json>
184
+ A real ad's source record (start, with --conceit), for
185
+ a kind of ad that copies an ad shot for shot. Such a
186
+ kind needs one; any other kind refuses it
180
187
  --stop-at-script Print the script the run would start on, and start
181
188
  nothing (start, with --conceit). To read a written or
182
189
  laid-out script first; send it back with --script
@@ -227,7 +234,7 @@ Options:
227
234
 
228
235
  Who can use what. Admins get every command here. Beta testers with video
229
236
  switched on get these, on their own brands: start (--script, --conceit,
230
- --style, --direction, --frame, --pacing, --music, --one-shot,
237
+ --style, --direction, --frame, --pacing, --music, --source-record, --one-shot,
231
238
  --review-storyboard, --stop-at-script, --rewrite-to-fit),
232
239
  status, storyboard, approve (the storyboard), voices, retry-frame --scene <n> (redo one scene's
233
240
  picture while the storyboard waits), pull (the finished video, each scene's
@@ -747,6 +754,7 @@ function clipFromArtifact(sceneIndex, artifact) {
747
754
  voiceFirstBlockedBy: artifact.voiceFirstBlockedBy ?? null,
748
755
  voicePitchHz: artifact.voicePitchHz ?? null,
749
756
  voicePitchMethod: artifact.voicePitchMethod ?? null,
757
+ replannedIdea: artifact.replannedIdea ?? null,
750
758
  };
751
759
  }
752
760
  function keyframeDownload(sceneIndex, imageUrl) {
@@ -903,23 +911,37 @@ function isNarrationMaster(artifact) {
903
911
  artifact.sceneIndex === undefined &&
904
912
  Array.isArray(artifact.narration?.cuts));
905
913
  }
914
+ function withoutLookRider(prompt) {
915
+ return prompt.replace(/\n\nCUTAWAY STYLE: [\s\S]*$/, "");
916
+ }
917
+ function withReplannedPrompts(raw, replanned) {
918
+ let board;
919
+ try {
920
+ board = JSON.parse(raw);
921
+ }
922
+ catch {
923
+ return raw;
924
+ }
925
+ if (!Array.isArray(board.scenes))
926
+ return raw;
927
+ const scenes = board.scenes.map((scene) => {
928
+ const idea = typeof scene.sceneIndex === "number" ? replanned.get(scene.sceneIndex) : undefined;
929
+ return idea ? { ...scene, ...idea } : scene;
930
+ });
931
+ return JSON.stringify({ ...board, scenes }, null, 2);
932
+ }
906
933
  export function planPull(run, items, opts) {
907
934
  const texts = [];
908
935
  const storyboardArtifact = run.nodes
909
936
  .flatMap((n) => n.outputs ?? [])
910
937
  .find((a) => a.type === "storyboard");
911
- let storyboard = null;
912
- if (storyboardArtifact) {
913
- const raw = typeof storyboardArtifact.storyboardJson === "string"
938
+ const storyboardRaw = storyboardArtifact
939
+ ? typeof storyboardArtifact.storyboardJson === "string"
914
940
  ? storyboardArtifact.storyboardJson
915
941
  : storyboardArtifact.storyboard !== undefined
916
942
  ? JSON.stringify(storyboardArtifact.storyboard, null, 2)
917
- : undefined;
918
- if (raw !== undefined) {
919
- storyboard = "storyboard.json";
920
- texts.push({ file: storyboard, body: raw.endsWith("\n") ? raw : `${raw}\n` });
921
- }
922
- }
943
+ : undefined
944
+ : undefined;
923
945
  let reference = null;
924
946
  let productSheet = null;
925
947
  let setPlate = null;
@@ -1056,6 +1078,21 @@ export function planPull(run, items, opts) {
1056
1078
  const pendingRedo = scenesBeingRedone(run, items);
1057
1079
  for (const sceneIndex of pendingRedo)
1058
1080
  clipByScene.delete(sceneIndex);
1081
+ const replanned = new Map();
1082
+ for (const [sceneIndex, clip] of clipByScene) {
1083
+ if (!clip.replannedIdea)
1084
+ continue;
1085
+ const { imageUrl, framePrompt, videoPrompt } = clip.replannedIdea;
1086
+ keyframeByScene.set(sceneIndex, keyframeDownload(sceneIndex, imageUrl));
1087
+ if (framePrompt && videoPrompt)
1088
+ replanned.set(sceneIndex, { framePrompt, videoPrompt });
1089
+ }
1090
+ let storyboard = null;
1091
+ if (storyboardRaw !== undefined) {
1092
+ const body = replanned.size > 0 ? withReplannedPrompts(storyboardRaw, replanned) : storyboardRaw;
1093
+ storyboard = "storyboard.json";
1094
+ texts.unshift({ file: storyboard, body: body.endsWith("\n") ? body : `${body}\n` });
1095
+ }
1059
1096
  const sceneIndexes = [
1060
1097
  ...new Set([
1061
1098
  ...clipByScene.keys(),
@@ -1427,6 +1464,9 @@ export function planVideoStart(flags, occurrences) {
1427
1464
  const pacingFlag = planValueFlag(occurrences, "pacing");
1428
1465
  if (!pacingFlag.ok)
1429
1466
  return { kind: "usage", line: pacingFlag.line };
1467
+ const recordFlag = planValueFlag(occurrences, "source-record");
1468
+ if (!recordFlag.ok)
1469
+ return { kind: "usage", line: recordFlag.line };
1430
1470
  const videoModel = videoModelFlag.value;
1431
1471
  const voiceMode = voiceFlag.value;
1432
1472
  const reviewStoryboardFlag = occurrences.some((o) => o.flag === "review-storyboard");
@@ -1505,6 +1545,12 @@ export function planVideoStart(flags, occurrences) {
1505
1545
  line: "--director works with --conceit, not --show.",
1506
1546
  };
1507
1547
  }
1548
+ if (showId && recordFlag.value) {
1549
+ return {
1550
+ kind: "usage",
1551
+ line: "--source-record works with --conceit, not --show.",
1552
+ };
1553
+ }
1508
1554
  if (showId && broll) {
1509
1555
  return {
1510
1556
  kind: "usage",
@@ -1583,6 +1629,8 @@ export function planVideoStart(flags, occurrences) {
1583
1629
  opts.stopAtScript = true;
1584
1630
  if (rewriteToFit)
1585
1631
  opts.rewriteToFit = true;
1632
+ if (recordFlag.value)
1633
+ opts.sourceRecordFile = recordFlag.value;
1586
1634
  if (frameFlag.value || pacingFlag.value) {
1587
1635
  opts.shots = {
1588
1636
  ...(frameFlag.value ? { frame: frameFlag.value } : {}),
@@ -1848,6 +1896,20 @@ export async function startScriptFlow(opts, deps) {
1848
1896
  if (script.trim().length === 0) {
1849
1897
  return { code: 1, lines: [`The script file "${opts.scriptFile}" is empty.`] };
1850
1898
  }
1899
+ let sourceRecord;
1900
+ if (opts.sourceRecordFile) {
1901
+ try {
1902
+ sourceRecord = JSON.parse(deps.readFile(opts.sourceRecordFile));
1903
+ }
1904
+ catch (e) {
1905
+ return {
1906
+ code: 1,
1907
+ lines: [
1908
+ `Can't read the source record "${opts.sourceRecordFile}" as JSON: ${e instanceof Error ? e.message : String(e)}`,
1909
+ ],
1910
+ };
1911
+ }
1912
+ }
1851
1913
  const listed = await deps.get(SCRIPT_RUNS_PATH).catch(() => null);
1852
1914
  if (listed?.ok) {
1853
1915
  const options = scriptRunOptionsOf(listed.data);
@@ -1874,6 +1936,7 @@ export async function startScriptFlow(opts, deps) {
1874
1936
  ...(opts.shots ? { shots: opts.shots } : {}),
1875
1937
  ...(opts.stopAtScript ? { stopAtScript: true } : {}),
1876
1938
  ...(opts.rewriteToFit ? { rewriteToFit: true } : {}),
1939
+ ...(sourceRecord !== undefined ? { sourceRecord } : {}),
1877
1940
  });
1878
1941
  if (!res.ok)
1879
1942
  return scriptNeedsCallerResult(res, opts.json) ?? scriptStartRefused(res, opts.json);
@@ -2201,6 +2264,10 @@ export async function statusFlow(runId, json, deps) {
2201
2264
  }
2202
2265
  if (row.clip?.error)
2203
2266
  lines.push(` ${row.clip.error}`);
2267
+ const usedIdea = row.clip?.artifact?.type === "video" ? row.clip.artifact.replannedIdea : undefined;
2268
+ if (usedIdea?.framePrompt) {
2269
+ lines.push(` clip: made from a new idea instead of the approved one. It shows: ${withoutLookRider(usedIdea.framePrompt)}`);
2270
+ }
2204
2271
  if (revoicedByScene.has(sceneIndex))
2205
2272
  lines.push(" voice: cast voice applied");
2206
2273
  if (voiceFirstByScene.has(sceneIndex))
@@ -2397,7 +2464,21 @@ export async function storyboardFlow(runId, json, deps) {
2397
2464
  .get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`)
2398
2465
  .catch(() => null);
2399
2466
  const showAd = runRes?.ok === true && isShowAd(asVideoRun(runRes.data));
2400
- lines.push("", `approve with: exodus video approve ${runId}`);
2467
+ const logic = cards.logicFindings;
2468
+ if (logic) {
2469
+ lines.push("", "The check before pictures");
2470
+ if (logic.findings.length === 0)
2471
+ lines.push(" nothing found");
2472
+ for (const f of logic.findings) {
2473
+ const where = f.scenes.length ? ` (scene ${f.scenes.join(", ")})` : "";
2474
+ lines.push(` ${f.id} ${f.severity}, ${f.kind}${where}: ${f.what}`);
2475
+ }
2476
+ for (const n of logic.notes ?? [])
2477
+ lines.push(` note: ${n}`);
2478
+ }
2479
+ lines.push("", logic?.open
2480
+ ? `a block stops this storyboard. Fix it, or go on: exodus video approve ${runId} --accept-findings`
2481
+ : `approve with: exodus video approve ${runId}`);
2401
2482
  if (showAd) {
2402
2483
  lines.push(`send it back: exodus video flag ${runId} --note "what's wrong"`);
2403
2484
  }
@@ -2434,11 +2515,15 @@ function sceneCardLines(scene) {
2434
2515
  export async function approveFlow(runId, opts, deps) {
2435
2516
  const res = await deps.post(APPROVE_PATH, {
2436
2517
  runId,
2518
+ ...(opts.acceptFindings ? { acceptFindings: true } : {}),
2437
2519
  ...(opts.approveStaleCut ? { approveStaleCut: true } : {}),
2438
2520
  });
2439
2521
  if (!res.ok) {
2440
2522
  const refusal = errorResult(res, opts.json);
2441
2523
  const staleCut = !opts.json && videoApiError(res).includes("approve this cut anyway");
2524
+ if (!opts.json && videoApiError(res).includes("accept the findings")) {
2525
+ return { ...refusal, lines: [...refusal.lines, `To go on anyway: exodus video approve ${runId} --accept-findings`] };
2526
+ }
2442
2527
  return staleCut
2443
2528
  ? {
2444
2529
  ...refusal,
@@ -3710,6 +3795,7 @@ const VALUE_FLAGS = new Set([
3710
3795
  "voice",
3711
3796
  "frame",
3712
3797
  "pacing",
3798
+ "source-record",
3713
3799
  "note",
3714
3800
  "out",
3715
3801
  "file",
@@ -3818,7 +3904,11 @@ export async function run(flags, occurrences) {
3818
3904
  return printResult(await directorFlow(runId, choice.on, json, defaultDeps));
3819
3905
  }
3820
3906
  if (sub === "approve") {
3821
- return printResult(await approveFlow(runId, { json, approveStaleCut: flags["approve-stale-cut"] === true }, defaultDeps));
3907
+ return printResult(await approveFlow(runId, {
3908
+ json,
3909
+ approveStaleCut: flags["approve-stale-cut"] === true,
3910
+ acceptFindings: flags["accept-findings"] === true,
3911
+ }, defaultDeps));
3822
3912
  }
3823
3913
  if (sub === "flag") {
3824
3914
  const note = flagString(flags, "note");
@@ -1,4 +1,4 @@
1
- export declare const AD_TYPES: readonly ["before-after", "native-news", "testimonial", "bold", "meme", "screenshot", "hero", "holding-sign", "handwritten", "comment", "breaking-news", "lofi", "comparison", "infographic", "headline", "collage", "product-breakdown", "scientific", "animation", "founder-note", "carousel", "statistics", "post-it-notes", "happy-avatar", "problem-solution", "writing-on-body", "multi-testimonial", "receipt", "step-by-step", "sale-promotional-offer", "cost-of-inaction", "ugc", "quiz-interactive", "action-figure", "at-home-routine", "billboard", "black-and-white", "blurred", "choose", "cutout", "drawing", "facetime", "marker", "notes", "photo", "quadrant", "search", "thumbnail", "xray", "zoom-bubble", "advice-cacophony", "annotated-testimonial", "body-morph", "body-portal", "bundle-showcase", "clay-world", "colossus-product", "cost-receipt", "cultural-icon-dressup", "effect-field", "fine-art-intervention", "flavor-story", "giant-tiny", "half-face-reveal", "hero-vs-villain", "horror-illustration", "horror-object-interior", "illustrated-cutaway", "impossible-physics", "ingredient-warrior", "lifestyle-colorway-array", "material-state", "mirror-reveal", "object-launch", "organ-buddy", "polaroid-sticky", "pop-art-comic", "product-as-body", "product-as-hero", "retro-game-screen", "sequential-state-strip", "sketch-equation", "spotlight-hero", "stat-surround-flatlay", "stat-surround-hero", "street-find", "street-poster", "stuffed-container", "surrogate-character", "symbol-swap", "symptom-collage", "threat-map", "tiny-universe", "tiny-world", "toxic-assemblage", "toxic-emanation", "trophy-moment", "villain-pour", "vintage-reframe", "whiteboard", "zipper-reveal"];
1
+ export declare const AD_TYPES: readonly ["before-after", "native-news", "testimonial", "bold", "meme", "screenshot", "hero", "holding-sign", "handwritten", "comment", "breaking-news", "lofi", "comparison", "infographic", "headline", "collage", "product-breakdown", "scientific", "animation", "founder-note", "carousel", "statistics", "post-it-notes", "happy-avatar", "problem-solution", "writing-on-body", "multi-testimonial", "receipt", "step-by-step", "sale-promotional-offer", "cost-of-inaction", "ugc", "quiz-interactive", "action-figure", "at-home-routine", "billboard", "black-and-white", "blurred", "choose", "cutout", "drawing", "facetime", "marker", "notes", "photo", "quadrant", "search", "thumbnail", "xray", "zoom-bubble", "advice-cacophony", "annotated-testimonial", "body-morph", "body-portal", "bundle-showcase", "clay-world", "colossus-product", "cost-receipt", "cultural-icon-dressup", "effect-field", "fine-art-intervention", "flavor-story", "giant-tiny", "half-face-reveal", "hero-vs-villain", "horror-illustration", "horror-object-interior", "illustrated-cutaway", "impossible-physics", "ingredient-warrior", "lifestyle-colorway-array", "material-state", "mirror-reveal", "object-launch", "organ-buddy", "polaroid-sticky", "pop-art-comic", "product-as-body", "product-as-hero", "retro-game-screen", "sequential-state-strip", "sketch-equation", "spotlight-hero", "stat-surround-flatlay", "stat-surround-hero", "street-find", "street-poster", "stuffed-container", "surrogate-character", "symbol-swap", "symptom-collage", "threat-map", "tiny-universe", "tiny-world", "toxic-assemblage", "toxic-emanation", "trophy-moment", "villain-pour", "vintage-reframe", "whiteboard", "zipper-reveal", "curiosity-bait"];
2
2
  export type AdType = (typeof AD_TYPES)[number];
3
3
  export declare const AD_TYPE_NAMES: Record<AdType, string>;
4
4
  export declare const REPTILE_TRIGGERS: readonly ["ultra-real", "bizarre", "voyeur", "suffering", "gory", "sexual", "primal-fear", "odd-contrast", "inside-joke", "time-warp", "victory-lap", "selfie", "uncanny-objects"];
@@ -100,6 +100,7 @@ export const AD_TYPES = [
100
100
  "vintage-reframe",
101
101
  "whiteboard",
102
102
  "zipper-reveal",
103
+ "curiosity-bait",
103
104
  ];
104
105
  export const AD_TYPE_NAMES = {
105
106
  "before-after": "Before / After",
@@ -203,6 +204,7 @@ export const AD_TYPE_NAMES = {
203
204
  "vintage-reframe": "Vintage Reframe",
204
205
  "whiteboard": "Whiteboard",
205
206
  "zipper-reveal": "Zipper Reveal",
207
+ "curiosity-bait": "Curiosity Bait",
206
208
  };
207
209
  export const REPTILE_TRIGGERS = [
208
210
  "ultra-real",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.10.2400-beta.2",
3
+ "version": "2026.11.200-beta.1",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",