@aicopycoders/exodus 2026.10.2400-beta.3 → 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) {
@@ -466,6 +466,7 @@ export interface ScriptStartOptions {
466
466
  shots?: RunShots;
467
467
  stopAtScript?: true;
468
468
  rewriteToFit?: true;
469
+ sourceRecordFile?: string;
469
470
  wait: boolean;
470
471
  json: boolean;
471
472
  onProgressLine?: (line: string) => void;
@@ -510,6 +511,7 @@ export declare function storyboardFlow(runId: string, json: boolean, deps: Video
510
511
  export declare function approveFlow(runId: string, opts: {
511
512
  json: boolean;
512
513
  approveStaleCut: boolean;
514
+ acceptFindings?: boolean;
513
515
  }, deps: VideoDeps): Promise<FlowResult>;
514
516
  export declare function flagFlow(runId: string, note: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
515
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
@@ -1457,6 +1464,9 @@ export function planVideoStart(flags, occurrences) {
1457
1464
  const pacingFlag = planValueFlag(occurrences, "pacing");
1458
1465
  if (!pacingFlag.ok)
1459
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 };
1460
1470
  const videoModel = videoModelFlag.value;
1461
1471
  const voiceMode = voiceFlag.value;
1462
1472
  const reviewStoryboardFlag = occurrences.some((o) => o.flag === "review-storyboard");
@@ -1535,6 +1545,12 @@ export function planVideoStart(flags, occurrences) {
1535
1545
  line: "--director works with --conceit, not --show.",
1536
1546
  };
1537
1547
  }
1548
+ if (showId && recordFlag.value) {
1549
+ return {
1550
+ kind: "usage",
1551
+ line: "--source-record works with --conceit, not --show.",
1552
+ };
1553
+ }
1538
1554
  if (showId && broll) {
1539
1555
  return {
1540
1556
  kind: "usage",
@@ -1613,6 +1629,8 @@ export function planVideoStart(flags, occurrences) {
1613
1629
  opts.stopAtScript = true;
1614
1630
  if (rewriteToFit)
1615
1631
  opts.rewriteToFit = true;
1632
+ if (recordFlag.value)
1633
+ opts.sourceRecordFile = recordFlag.value;
1616
1634
  if (frameFlag.value || pacingFlag.value) {
1617
1635
  opts.shots = {
1618
1636
  ...(frameFlag.value ? { frame: frameFlag.value } : {}),
@@ -1878,6 +1896,20 @@ export async function startScriptFlow(opts, deps) {
1878
1896
  if (script.trim().length === 0) {
1879
1897
  return { code: 1, lines: [`The script file "${opts.scriptFile}" is empty.`] };
1880
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
+ }
1881
1913
  const listed = await deps.get(SCRIPT_RUNS_PATH).catch(() => null);
1882
1914
  if (listed?.ok) {
1883
1915
  const options = scriptRunOptionsOf(listed.data);
@@ -1904,6 +1936,7 @@ export async function startScriptFlow(opts, deps) {
1904
1936
  ...(opts.shots ? { shots: opts.shots } : {}),
1905
1937
  ...(opts.stopAtScript ? { stopAtScript: true } : {}),
1906
1938
  ...(opts.rewriteToFit ? { rewriteToFit: true } : {}),
1939
+ ...(sourceRecord !== undefined ? { sourceRecord } : {}),
1907
1940
  });
1908
1941
  if (!res.ok)
1909
1942
  return scriptNeedsCallerResult(res, opts.json) ?? scriptStartRefused(res, opts.json);
@@ -2431,7 +2464,21 @@ export async function storyboardFlow(runId, json, deps) {
2431
2464
  .get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`)
2432
2465
  .catch(() => null);
2433
2466
  const showAd = runRes?.ok === true && isShowAd(asVideoRun(runRes.data));
2434
- 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}`);
2435
2482
  if (showAd) {
2436
2483
  lines.push(`send it back: exodus video flag ${runId} --note "what's wrong"`);
2437
2484
  }
@@ -2468,11 +2515,15 @@ function sceneCardLines(scene) {
2468
2515
  export async function approveFlow(runId, opts, deps) {
2469
2516
  const res = await deps.post(APPROVE_PATH, {
2470
2517
  runId,
2518
+ ...(opts.acceptFindings ? { acceptFindings: true } : {}),
2471
2519
  ...(opts.approveStaleCut ? { approveStaleCut: true } : {}),
2472
2520
  });
2473
2521
  if (!res.ok) {
2474
2522
  const refusal = errorResult(res, opts.json);
2475
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
+ }
2476
2527
  return staleCut
2477
2528
  ? {
2478
2529
  ...refusal,
@@ -3744,6 +3795,7 @@ const VALUE_FLAGS = new Set([
3744
3795
  "voice",
3745
3796
  "frame",
3746
3797
  "pacing",
3798
+ "source-record",
3747
3799
  "note",
3748
3800
  "out",
3749
3801
  "file",
@@ -3852,7 +3904,11 @@ export async function run(flags, occurrences) {
3852
3904
  return printResult(await directorFlow(runId, choice.on, json, defaultDeps));
3853
3905
  }
3854
3906
  if (sub === "approve") {
3855
- 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));
3856
3912
  }
3857
3913
  if (sub === "flag") {
3858
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.3",
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",