@aicopycoders/exodus 2026.11.1000-beta.2 → 2026.11.1100-beta.10

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.
Files changed (54) hide show
  1. package/README.md +56 -3
  2. package/assets/docs/CLAUDE.md +2 -0
  3. package/assets/docs/PIPELINES.md +2 -0
  4. package/assets/skills/exodus/SKILL.md +2 -0
  5. package/assets/skills/exodus-video/SKILL.md +700 -11
  6. package/assets/skills/exodus-video/scripts/first-cut-speech.d.mts +100 -0
  7. package/assets/skills/exodus-video/scripts/first-cut-speech.mjs +361 -0
  8. package/assets/skills/exodus-video/scripts/first-cut-text-render.mjs +15 -0
  9. package/assets/skills/exodus-video/scripts/first-cut-text.d.mts +12 -0
  10. package/assets/skills/exodus-video/scripts/first-cut-text.mjs +18 -4
  11. package/assets/skills/exodus-video/scripts/first-cut.d.mts +85 -2
  12. package/assets/skills/exodus-video/scripts/first-cut.mjs +1388 -162
  13. package/assets/skills/swipe/SKILL.md +3 -1
  14. package/assets/skills/timeline-ad-factory/AGENTS.md +8 -0
  15. package/assets/skills/timeline-ad-factory/README.md +38 -0
  16. package/assets/skills/timeline-ad-factory/SKILL.md +132 -0
  17. package/assets/skills/timeline-ad-factory/reference/00_hook_elements.md +71 -0
  18. package/assets/skills/timeline-ad-factory/reference/01_elements.md +53 -0
  19. package/assets/skills/timeline-ad-factory/reference/02_openers.md +83 -0
  20. package/assets/skills/timeline-ad-factory/reference/03_script_rules.md +83 -0
  21. package/assets/skills/timeline-ad-factory/reference/04_storyboard.md +153 -0
  22. package/assets/skills/timeline-ad-factory/reference/05_generation.md +57 -0
  23. package/assets/skills/timeline-ad-factory/scripts/assemble.py +86 -0
  24. package/assets/skills/timeline-ad-factory/scripts/contact_sheet.py +76 -0
  25. package/assets/skills/timeline-ad-factory/scripts/cost_report.py +25 -0
  26. package/assets/skills/timeline-ad-factory/scripts/gen_images.py +76 -0
  27. package/assets/skills/timeline-ad-factory/scripts/gen_music.py +36 -0
  28. package/assets/skills/timeline-ad-factory/scripts/gen_video.py +167 -0
  29. package/assets/skills/timeline-ad-factory/scripts/gen_vo.py +180 -0
  30. package/assets/skills/timeline-ad-factory/scripts/kie.py +168 -0
  31. package/assets/skills/timeline-ad-factory/scripts/review_clips.py +39 -0
  32. package/assets/skills/timeline-ad-factory/scripts/setup_check.py +54 -0
  33. package/assets/skills/timeline-ad-factory/scripts/voices.py +2 -0
  34. package/assets/skills/timeline-ad-factory/templates/project.json +38 -0
  35. package/assets/skills/ugc-ads/SKILL.md +32 -0
  36. package/assets/skills/ugc-ads/scripts/run.py +83 -0
  37. package/assets/skills/ugc-preproduction/SKILL.md +56 -0
  38. package/assets/skills/ugc-swipe/SKILL.md +34 -0
  39. package/assets/skills/ugc-template/SKILL.md +40 -0
  40. package/assets/skills/ugc-write/SKILL.md +33 -0
  41. package/dist/commands/video-customer.d.ts +33 -0
  42. package/dist/commands/video-customer.js +33 -1
  43. package/dist/commands/video-swipe.d.ts +465 -0
  44. package/dist/commands/video-swipe.js +2780 -0
  45. package/dist/commands/video.d.ts +122 -2
  46. package/dist/commands/video.js +385 -33
  47. package/dist/commands/workflow.js +5 -3
  48. package/dist/lib/script-approval.d.ts +3 -0
  49. package/dist/lib/script-approval.js +17 -0
  50. package/dist/lib/speechIssueText.d.ts +2 -0
  51. package/dist/lib/speechIssueText.js +8 -0
  52. package/dist/lib/template-audition.d.ts +12 -0
  53. package/dist/lib/template-audition.js +4 -0
  54. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: exodus-video
3
- description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, status, storyboard, approve, voices, retry-frame, pull and upload on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
3
+ description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. A UGC script with no video ("write me a UGC script", "swipe this UGC ad" for a script) is `ugc-ads`, and the separate UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`, not this skill. A timeline ad asked for without "exodus" ("make me a timeline ad", "turn this winning ad into timeline ads") is `timeline-ad-factory`, on the member's own Kie.ai key; "exodus, make a skeleton timeline video" stays here. A competitor's video ad (a file, a link, or an ad in Exodus) is swiped with `exodus video swipe`, as Swipe a video does on the dashboard: broken down, matched to a kind of ad, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, swipe, status, storyboard, approve, voices, retry-frame, pull and upload on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -81,7 +81,9 @@ family (`familyTree.ts`). Those family names stay the code's names.
81
81
 
82
82
  The member types one sentence, such as "swipe this ad as a microdrama for my
83
83
  brand". You drive the run through its stops and wait for the member at each
84
- one. The Golden Six formats start on the template door, which needs
84
+ one. When the sentence names a video ad to swipe as it is made (a video file,
85
+ a link to the ad, or an ad in Exodus) and the member asks for no format of
86
+ their own, go to "Swiping a video ad" below instead. The Golden Six formats start on the template door, which needs
85
87
  Templates switched on for the member's account. Without it the CLI answers
86
88
  "video isn't enabled for this key" or "Templates aren't available on your
87
89
  account. Ask an admin if you need it." Tell the member that and stop. A beta
@@ -125,7 +127,10 @@ does offer, and nothing is spent.
125
127
  missing:
126
128
  - the source ad: pasted text or a file, as it is, or the words of an ad in
127
129
  Exodus or behind a link (the `swipe` skill's section 1 gets them). Save
128
- the words to `source.txt`.
130
+ the words to `source.txt`. A video ad the member wants swiped whole, its
131
+ kind and look and shots as well as its words, goes to "Swiping a video
132
+ ad" below. That path picks the kind itself, so a member set on one of the
133
+ Golden Six stays here.
129
134
  - the format: the table above.
130
135
  - the brand: `exodus brand current`.
131
136
  2. `exodus video start --input-options --conceit <key>` prints the template's
@@ -159,7 +164,12 @@ does offer, and nothing is spent.
159
164
  3. Write the script out byte for byte:
160
165
  `node -e 'process.stdout.write(require("./stop1.json").script)' > script.txt`.
161
166
  Show the member the source and `script.txt` side by side, and the cast:
162
- each name that speaks a line. Ask: go on, change a line, or stop.
167
+ each name that speaks a line. The stop file can also carry the app's notes
168
+ on the copy, such as a claim it could not check against the source or a
169
+ line that may not fit:
170
+ `node -e 'for (const n of require("./stop1.json").copyNotes ?? []) console.log(n.detail)'`.
171
+ Show each note next to the script, word for word. A note stops nothing;
172
+ the member decides. Ask: go on, change a line, or stop.
163
173
  - Go on: "The run starts" below.
164
174
  - Change a line: copy `script.txt` to `edited.txt` and make their change.
165
175
  An edited script is checked and approved again, at a price of its own.
@@ -173,7 +183,7 @@ does offer, and nothing is spent.
173
183
  ```
174
184
 
175
185
  From here `stop1b.json` is the stop file. Write its script over
176
- `script.txt` the same way and show it again.
186
+ `script.txt` the same way and show it again, with its copy notes.
177
187
  - Stop: nothing more is spent.
178
188
 
179
189
  ### The run starts
@@ -182,6 +192,15 @@ does offer, and nothing is spent.
182
192
  Use it with `script.txt` written out from it, unchanged. A different script,
183
193
  product, voice or reference is refused, and nothing starts.
184
194
 
195
+ The approval in a stop file lasts 24 hours, and only a key of the member who
196
+ approved it can use it. After that the storyboard quote is refused and nothing
197
+ is spent. Renew it with the two "Change a line" lines above, with
198
+ `<stop file>` in place of `stop1.json`, `script.txt` as the script and
199
+ `--renew-script-approval` added to both. That checks the
200
+ same script again at a price of its own (give the member the price, and run
201
+ the second line on their yes); it writes nothing new. Continue from the new
202
+ stop file.
203
+
185
204
  ```
186
205
  exodus video start --resume-script <stop file> --script script.txt \
187
206
  --conceit <key> --style <look> --quote-preparation --json > board-quote.json
@@ -234,10 +253,11 @@ then `picks` again.
234
253
  `status` says "Parked: the storyboard is waiting for your yes."
235
254
  `exodus video storyboard <runId>` prints each scene's line and picture, and who
236
255
  speaks with which voice ("Reading the storyboard gate" has the detail). Show it
237
- with the run page link, then ask: approve, redo a picture, change a voice, or
238
- stop.
256
+ with the run page link, then ask: approve, redo a picture, change a voice,
257
+ move someone (Micro-drama template only), or stop.
239
258
 
240
- - Approve: `exodus video approve <runId>`. It buys the voices and the clips
259
+ - Approve: `exodus video approve <runId>`. It approves the storyboard and
260
+ buys the voices and the clips
241
261
  (with the pilot stop, the pilot first), the expensive part. The CLI prints
242
262
  no price for them at this stop: say so, and approve on their yes. A storyboard the app's check stopped is
243
263
  refused with the reason. Tell the member, and on their yes approve again
@@ -248,6 +268,21 @@ stop.
248
268
  say so and wait for their yes.
249
269
  - Change a voice: `exodus video voices <runId> --set <who>=<voice>` ("Giving
250
270
  the characters voices").
271
+ - Move someone (only the Micro-drama template has the blocking map, and it is
272
+ admin-only today; its storyboard prints `see each room and where everyone
273
+ stands`): `exodus video map <runId>` prints each room in metres seen from
274
+ above, each person's mark, their side of the wide shot, the setups that film
275
+ the room, and what a move there redraws and its price. Show it. Then
276
+ `exodus video move <runId> --move <who>=<x>,<y> [--place <place>] [--note
277
+ "<what to change>"]`, with `<who>` as the script names them. Before it, tell
278
+ the member how many pictures the move redraws and the price `map` printed;
279
+ when `map` says `price unknown`, say the price is unknown. Either way, run it
280
+ only after their yes. A move that keeps everyone on the same side of the
281
+ wide shot redraws nothing and costs nothing, and `move` says so. A move off
282
+ the room, onto another person or across the 180-degree line of a setup is
283
+ refused in one sentence: tell the member and ask again. After a move, wait
284
+ for the redrawn pictures (`exodus video storyboard <runId>` shows them)
285
+ before you approve; approve and another move are refused until they land.
251
286
  - Stop: `exodus workflow cancel <runId>`.
252
287
 
253
288
  **The song format** waits twice more. `exodus video song <runId>` prints the
@@ -276,6 +311,23 @@ keep: offer the redo it prints, which names the scene.
276
311
  their yes. The note steers the motion,
277
312
  never the words.
278
313
 
314
+ ### The audition stop
315
+
316
+ A template run started from the dashboard can film a few planned scenes first
317
+ and hold the rest. A run started here never asks for one. `status` then names
318
+ the audition scenes and prints what to run next:
319
+
320
+ - `exodus video approve <runId> --audition <digest>`: show the member those
321
+ clips on the run page first. On their yes, run it exactly as printed. The
322
+ run then goes on and makes the clips it held.
323
+ - `exodus video approve <runId>` with "failed audition takes only": it pays
324
+ for another try of the audition takes that did not finish; the finished
325
+ ones are kept. The CLI prints no price for it: say so and wait for their
326
+ yes.
327
+ - "inputs changed" or "refused for safety or their pictures": nothing can
328
+ be approved. Offer to stop the run (`exodus workflow cancel <runId>`) and
329
+ start a new video.
330
+
279
331
  ### End: watch and approve
280
332
 
281
333
  At the final watch, follow the block `status` prints ("Where a run can
@@ -294,6 +346,615 @@ lyrics and style again in the Suno app while on a Pro or Premier plan, download
294
346
  it there and use that file: Suno's terms allow commercial use only of songs made
295
347
  on those plans and downloaded from Suno."
296
348
 
349
+ ## Swiping a video ad
350
+
351
+ What Swipe a video does on the dashboard, from the terminal. Exodus breaks the
352
+ competitor's ad down, matches it to the closest kind of ad and look it makes
353
+ (the template), writes the brand's version, and starts the video on the kind
354
+ the swipe wrote. The run is the same one Swipe a video starts on the
355
+ dashboard.
356
+
357
+ These steps need Video switched on for the member's account. Without it every
358
+ swipe command answers "Not found on this brand. The id is wrong or is another
359
+ brand's, video isn't switched on for your dashboard user, or this is not the
360
+ brand you meant (exodus brand current). Check the id first." Check the id and
361
+ the brand. If both are right, tell the member Video isn't switched on for
362
+ them, and stop.
363
+
364
+ This path has no picks stop and no pilot clip. The run goes from the start
365
+ straight to the storyboard (stop 3), and approving the storyboard makes every
366
+ clip. A run started with `--one-shot` approves its own storyboard when its
367
+ checks pass. Making the video from one of our formats (`--adapt`, "From one
368
+ sentence to a film") keeps the picks stop and the pilot clip.
369
+
370
+ By default a swipe is one round: you read the ad, send the member one sheet,
371
+ and on their one yes write the brand's version and make each video they
372
+ picked. When the member names no ad, the options come first (step 0): video
373
+ ads from the brand's swipe library to pick from. A member who asks to say yes
374
+ before each paid step gets "Step by step" below.
375
+
376
+ **Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
377
+ template, 15 for a write (the write always waits; it has no `--wait`), and 60
378
+ for `swipe start --wait`. Run these in the background, or leave `--wait` off
379
+ and check in, so the shell's own time limit does not cut them off. A wait that
380
+ was cut off or timed out is not a failure: the work goes on. Follow it by the
381
+ id it printed, with the command the CLI names, and never by running the paid
382
+ line again: a second run buys it a second time.
383
+
384
+ ### 0. No ad named: find some
385
+
386
+ When the member asks for ads to swipe without naming one ("find some ads to
387
+ swipe for this product, give me options"), offer options first. Skip this
388
+ step when the member named a file, a link or an id.
389
+
390
+ 1. The free product check comes first, as in step 1: `exodus video swipe
391
+ products`, and with no products, tell the member and stop. Then, free:
392
+ `exodus video swipe find --json`. It looks through up to 200 ads of the
393
+ brand's swipe library, shared fairly across the competitors (the whole
394
+ library when it holds fewer, and then `"wholeLibrary"` is true), and keeps
395
+ the video ads with a file, newest collected first, each with its id,
396
+ advertiser, first line, word count and the start of its transcript. Its
397
+ counts are of the ads it looked through, not of the whole library.
398
+ 2. Send the options in one message, then stop and wait:
399
+
400
+ > I found <V> video ads from <C> competitors in <your swipe library, or, when "wholeLibrary" is false: the 200 ads I looked through in your swipe library>. The <k> that fit <product> best:
401
+ > 1. **<Advertiser>**: "<first line>" (<w> words). Fits: <one reason, from the ad's words and the product>.
402
+ > 2. **<Advertiser>**: post text "<first line>" (no transcript yet).
403
+ > <V − k> more found. Say "more" for the next six, or name a competitor.
404
+ > Pick by number, or say "all" for these <k>. Your pick is your yes to read
405
+ > every ad you pick, one after another: each read costs a little, on the
406
+ > team's keys and on your model key. Nothing is written or started before
407
+ > your yes to the sheet.
408
+
409
+ The rules of the options:
410
+
411
+ - **At most six options in one message.** "More" sends the next six in the
412
+ same order you chose them by, leaving out every ad already shown; past
413
+ the rows the CLI showed, run `exodus video swipe find --limit 200
414
+ --json`. When the member names a competitor, run `exodus video
415
+ swipe find --brand "<name>" --json`. Leave out the "more found" line when
416
+ there are no more. When that find says none of the video ads is from that
417
+ name, say the CLI's line and offer the advertisers it lists.
418
+ - **"All" means the options the member last saw**, never every ad found.
419
+ - **The reason comes from the ad's words and the product.** A product fact
420
+ in it comes only from `exodus video swipe products` (the product's name
421
+ and description) or the primer. Say nothing about the competitor beyond
422
+ the ad's own words. Never call an ad a winner, a top ad or a proven ad:
423
+ the list holds no results (no spend, no views, no days running) and does
424
+ not rank by them. Its order is newest collected first, nothing more.
425
+ - **Post text is not spoken.** A first line with `"firstLineFrom": "post
426
+ text"` is the post's headline or text, not words said in the video: show
427
+ it as post text, never as something someone says.
428
+ - **An ad with no transcript goes last**, with no reason: its words are not
429
+ known before the read.
430
+ - **The kind of an ad is known only after it is read.** Never state a kind
431
+ as fact before a read.
432
+
433
+ **A find by kind.** When the member asks for a kind of ad ("find me some
434
+ authority yappers"), offer at most six whose words sound like that kind, and
435
+ say so in the message's first line, as "<kind>: sounds like, from the words;
436
+ the read confirms it." After the reads, the sheet's first
437
+ line names any ad the template read as another kind, so the member can drop
438
+ it ("drop video 3, go" is already a yes).
439
+
440
+ **What a pick is.** Only numbers given after an options message ("1, 3 and
441
+ 5"), or "all" (the options the member last saw), are picks. The numbering
442
+ goes on across "more" and across a new find (for a named competitor): the
443
+ next six are 7 to 12, and so on, never 1 again. Keep the id of every
444
+ number you showed, and read a pick by that id. "You pick" is not a
445
+ pick: name your own picks by number, each with its reason, and wait; read
446
+ nothing yet. A reply that takes them ("yes, those") is the pick. "Swipe all
447
+ of them" in the first message, before any options were shown, gets the
448
+ options first. A reply that picks nothing (a question, "tell me more about
449
+ 2", "maybe") is not a pick: answer it and wait.
450
+
451
+ **A pick is the yes to read every ad picked.** Say in one line what you are
452
+ about to read and who pays, in words like: "I'll read these 2 ads now, one
453
+ after another: each breakdown on the team's keys, each template on your own
454
+ model key." Then step 1 reads them in number order, by the ids the find
455
+ printed (`--ad <id>`), each breakdown then its template, without asking
456
+ again between them. Only what the member did not pick still gets the one
457
+ ask of "The limit: $0.50 for the read." in step 1: an ad found or named
458
+ after the pick, or a second pass over the same list. A pick whose read is
459
+ refused (its video expired or was removed; the read says so in one sentence
460
+ and buys nothing) or fails is left out, as step 1 says. Reading a failed ad
461
+ again is paid and needs its own yes.
462
+
463
+ **Into the sheet.** Every pick is on the sheet, in number order. The count is
464
+ ads × personas, and every rule of step 3 holds, above 6 videos too. In a
465
+ sheet file, each pick is `{"ad": "<id>"}` in `"sources"`, in the same order.
466
+
467
+ **Only part of the library was looked through.** When `"wholeLibrary"` is false
468
+ and none of those ads is a video with a file, the library is not empty:
469
+ the find looked through only part of it. Say the CLI's line, say that, and
470
+ offer a link or a file of an ad. Do not offer mining.
471
+
472
+ **An empty library.** When the find answers "The swipe library has no ads yet
473
+ for this brand.", or, with `"wholeLibrary"` true, that none of its ads is a
474
+ video with a file, tell the member in the CLI's own words, then offer
475
+ three ways and run none of them:
476
+
477
+ - a link or a file of an ad (step 1 reads it);
478
+ - `exodus swipe brands list` (free): the competitors this brand tracks, each
479
+ with the date it was last mined;
480
+ - `exodus swipe mine`: collects the tracked competitors' ads into the
481
+ library.
482
+
483
+ **Before any yes to mining**, tell the member in one message: it runs on
484
+ their own Scrape Creators key; the CLI prints no price for it; it mines every
485
+ active competitor on the watchlist, up to 50 in one run, the least recently
486
+ mined first; and it starts the moment it runs, in the background. Only a
487
+ reply that names mining after that message is the yes ("yes, mine them"), and
488
+ it buys the mining only, no read. After the mine, do not find again at
489
+ once: `exodus swipe latest` and `exodus swipe status <runId>` follow the
490
+ weekly swipe run, not mining, so they cannot show it is done. The mine
491
+ itself prints "Check progress: exodus swipe brands list". Tell the member
492
+ the mine has started and that you can look again in a few minutes. When
493
+ they ask, run `exodus swipe brands list` (a competitor that showed
494
+ `never-scraped` and now shows a `last=` date has been mined; the date has
495
+ no time, so one mined earlier the same day shows no change), then `exodus
496
+ video swipe find --json`. If it is still empty, say what the list shows and
497
+ stop; do not keep checking. Transcripts are made after the mine finishes, so
498
+ a newly mined ad can show "no transcript yet" for a while.
499
+
500
+ ### 1. Read the ad
501
+
502
+ First, free: `exodus video swipe products`. When it answers "This brand has
503
+ no products yet. Add one in the dashboard first.", tell the member and stop
504
+ before any read.
505
+
506
+ **Reading the ad, without asking.** Read each ad the member named before the
507
+ sheet, and only those. Say so in one line, in words like: "I read the ad
508
+ first; that costs a little, on the team's keys and on your model key." Then:
509
+ `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> --yes --wait`
510
+ (the breakdown, on the team's keys), `exodus video swipe status <breakdownId>
511
+ --full` (what it read: each shot, the script with who says each line, the
512
+ cast; free), and `exodus video swipe template <breakdownId> --yes` (the kind
513
+ of ad and look it matched; one model call on the member's own Anthropic or
514
+ OpenRouter key). The CLI's next lines say "ask first": here the one line
515
+ above covers the read, and the sheet's yes covers the writes and the starts.
516
+ When the breakdown prints "Still reading after 25 minutes", it is not done:
517
+ wait once more with `exodus video swipe status <breakdownId> --wait`, and if
518
+ it is still reading, stop and tell the member.
519
+
520
+ **The limit: $0.50 for the read.** The CLI prints no price before a read, so
521
+ keep to the limit with what it prints after. Count each breakdown once, from
522
+ the lines it ends with: those of the `exodus video swipe --file | --url |
523
+ --ad … --wait` command, or, when that wait was cut off, those of `exodus
524
+ video swipe status <breakdownId>` once it says the breakdown is done:
525
+
526
+ - "It cost $…, on the team's keys." is that breakdown's cost. Part of it may
527
+ be an estimate: "It cost $… (partly an estimate), on the team's keys."
528
+ - A first line "This ad already has a breakdown: <id>. It cost nothing." is
529
+ zero, even when a later line repeats what it cost the first time. "It
530
+ reused answers bought before, so it cost nothing." is zero too.
531
+ - No cost line at all is unknown.
532
+
533
+ Every later `exodus video swipe status <breakdownId>` repeats the cost: count
534
+ it once only. The template is the member's own money in the read, and its cost is
535
+ never printed: "This template was already made, so it cost nothing." is
536
+ zero, and a new template is unknown.
537
+
538
+ Read one ad at a time: its breakdown, then its template. Before each read
539
+ after the first (a template, or the next ad's breakdown), stop and ask the
540
+ member once when the costs counted have reached $0.50, or when any read so
541
+ far is unknown: an unknown cost counts as reaching the limit. Say what is
542
+ left to read. A new template is always
543
+ unknown, so with several ads you read the first and ask before the rest. The
544
+ check comes before each read, so the total can pass $0.50 by one read. Ads
545
+ the member picked by number from the options (step 0), or with "all", are
546
+ already a yes to read: read every picked ad without this ask. The ask still
547
+ comes before any ad they did not pick.
548
+
549
+ A breakdown or a template that fails prints why. With one ad, tell the
550
+ member and stop. With several, leave that ad out, say so in the sheet's first
551
+ line, and go on with the others. Reading again is paid too, and needs their
552
+ yes.
553
+
554
+ ### 2. Read the choices
555
+
556
+ Free, and no yes: `exodus segment personas` (the saved personas; leave out
557
+ the ones marked `[archived]`) and `exodus primer show` (its MECHANISM
558
+ section; with no primer saved, say so once and offer only the member's own
559
+ words or none). The products came in step 1.
560
+
561
+ ### 3. The sheet, once
562
+
563
+ Send this in one message, in this order, then stop and wait:
564
+
565
+ > I read your ad as <kind of ad>, <look>, <n> lines, about <s> s. The swipe
566
+ > makes that kind of ad. Say "show me" for the shot list and the script.
567
+ > One sheet, answer once (my picks are marked):
568
+ > 0. **Let it run** (I pick every row) or **I choose**.
569
+ > 1. **Persona** (noted; the video writer does not read it yet): <your three best fits, each with a short reason>, show all <N>, or none. Pick several for one video each.
570
+ > 2. **Mechanism** (noted; the video writer does not read it yet): <the primer's mechanisms>, your own words, or none.
571
+ > 3. **How close:** 1 Mirror, 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only.
572
+ > 4. **Characters:** the tool picks them (your saved characters: not yet).
573
+ > 5. **Run:** one shot, or stop at the storyboard.
574
+ > 6. **Finish:** music on or off (captions, speed, cuts: not yet).
575
+ > **How many:** <n> videos = <a> ads × <p> personas:
576
+ > - Video 1: <ad> × <persona>
577
+ > - Video 2: <ad> × <persona>
578
+ > **Cost:** the CLI prints no price for a swipe.
579
+ > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
+ > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
+ > with "Say yes to <n> videos, or change a row." instead.)
582
+
583
+ **The yes covers only the list the member last saw.** Before any write or
584
+ start, the member has seen the list and the count, and said yes to them.
585
+ This holds also when their first message says "just do it" or "let it run":
586
+ "Let it run" fills the rows with your picks, and the yes still comes from
587
+ the member.
588
+
589
+ - A reply that makes the buy bigger is not the yes, even with "go" in it:
590
+ more videos, another ad, music on where the sheet said off, or "one shot"
591
+ where the sheet said "stop at the storyboard". Send the new list and count,
592
+ and wait.
593
+ - A reply that changes a row without making the buy bigger, together with
594
+ "go", is the yes: how close, music off, or leaving out videos it names
595
+ ("drop video 3, go"). Say the change in one line and start. "Fewer" with
596
+ no say in which ones is not the yes: send the shorter list and wait.
597
+ - Anything else is not the yes: a question, "show me", "maybe", "looks
598
+ good?", or a reply you are not sure of. Answer it and wait. Above 6 videos,
599
+ only a yes that names the count is the yes ("yes to 8 videos", "8, go"); a
600
+ bare "go" or "yes" gets the count asked again.
601
+ - On a sheet of 1 video, "1: Anna, Ben and Cara. Go." is 3 videos: send the
602
+ list of 3 and wait.
603
+
604
+ The rows:
605
+
606
+ - **The kind of ad.** The swipe writes the kind the template read. When the
607
+ member asks for another kind ("make it UGC instead"), name it with
608
+ `--kind <key>` on the write or `"kind"` in the sheet. A kind this ad can't
609
+ be made as is refused before the write is paid, with the kinds it can be
610
+ made as: offer those, or leave this path for "From one sentence to a
611
+ film", with the ad's words from `status --full`.
612
+ - **Persona.** Offer the three saved personas that fit the ad best, each with
613
+ a short reason, then "show all <N>" (every persona not marked
614
+ `[archived]`). Several may be picked: one video for each.
615
+ - **Persona and mechanism.** The video writer reads neither. When step 5's
616
+ path is open, the text swipe bot writes them into each video's lines, and
617
+ the rows say so (step 5). When it is closed, and for a video the bot does
618
+ not write, they are noted, not read: in
619
+ **My picks**, a persona or a mechanism always carries "(noted, not used
620
+ yet)", the primer's lead mechanism included, and videos for two personas
621
+ differ only as two writes of the same request differ. In that case, when
622
+ more than one persona is picked, say this in your reply before the yes, so
623
+ the member does not pay for several videos expecting a script for each
624
+ persona. Two other ways make a persona real without step 5. The member
625
+ writes their own script for that persona, and the write takes it with
626
+ `--mode their-format --script <file>`, made the way their ad is made. Or
627
+ the member swipes the words with the `swipe` skill and makes the film from
628
+ one of our formats (its "Make it a video"). That path asks a yes before
629
+ each paid step, and it makes the film in the format they pick, not in the
630
+ ad's own kind and look.
631
+ - **Characters.** A swiped run takes no saved characters and draws no new
632
+ faces yet, so the row offers only "the tool picks".
633
+ - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
634
+ scripts, and <n> storyboards with their pictures; the voices and clips
635
+ wait for your yes at each storyboard.
636
+ - **Finish.** `swipe start` takes `--music` and nothing else for the finish.
637
+ Music is made on the member's own ElevenLabs key. Caption style, speed,
638
+ jump cuts and the end card come with a later update.
639
+ - **How many.** Ads × personas, with none counting as one persona and the
640
+ characters counting as one today. Show the multiplication, as in "4 videos
641
+ = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
642
+ that count in so many words: "That is 8 videos. Say yes to 8 videos."
643
+ - **Cost.** The CLI prints no price for a swipe, so the sheet says exactly
644
+ that: no number, no range, no guess. The Director block of `exodus video
645
+ status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
646
+ for its redos on that video, not a price and not a ceiling for the first
647
+ pass. Never quote it as the cost.
648
+ - **Product.** Add a row **Product:** only when `swipe products` lists more
649
+ than one. With one, write for that one.
650
+ - **Anything else.** Add a row only when the member's ask carried a note. A
651
+ note that names what to swipe (hook only, their format with their own
652
+ script, a new look) sets `--mode` (step 4), and **My picks** says the mode
653
+ back. Say back any other note as noted, not used yet.
654
+ - **Several ads.** One sheet covers every ad the member named: list what you
655
+ read from each in the first line. The count and the warning above 6 hold.
656
+
657
+ **The videos, in a fixed order.** List them one per line: the ads in the
658
+ order the member gave them, and for each ad the personas in the order the
659
+ sheet shows them. The same picks give the same list.
660
+
661
+ **A bare number.** Read a reply of only a number ("3") as the count of
662
+ videos, and say so in the list's first line: "I read 3 as 3 videos." Pick
663
+ one video for each ad, in the order given, before a second persona for any
664
+ ad; then the next persona in the order shown for each ad, and so on, until
665
+ the count is reached. List the videos in the fixed order and wait for the
666
+ yes. When the picks cannot make that many, say how many they can make.
667
+
668
+ When the member says "just do it": no persona, the primer's lead mechanism
669
+ (noted, not used yet), closeness 2, the tool picks the characters, one shot,
670
+ no music. With more than one product and none named, ask that one row first.
671
+
672
+ ### 4. On the yes
673
+
674
+ The yes covers the writes and the starts, and the bot calls when step 5
675
+ applies; nothing else. The breakdown and the template are once per ad, and
676
+ are done already. For each video, in the listed order, run steps 1 and 2;
677
+ step 3 comes once every video has started:
678
+
679
+ 1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
680
+ --closeness <n> --yes`. A mode set from a note changes the line:
681
+ `hook-only` takes `--closeness` as `whole-ad` does. `their-format` takes
682
+ the member's own script: save it to a file and pass `--script <file>`,
683
+ with no `--closeness` (the CLI refuses one). `new-look` takes `--look
684
+ <slug>`; no command lists the looks a swipe can take, so ask the member
685
+ for the exact look name and never invent one (the writer refuses a look
686
+ it does not make). When step 5 applies, its write line takes the place of
687
+ this one. The write takes four to nine minutes. Show the member the
688
+ script, the direction, Kept and Changed, and what it cost. When a persona
689
+ or a mechanism was picked and step 5 does not apply, add one line: "The
690
+ persona and the mechanism are noted, not used: the video writer does not
691
+ read them yet."
692
+ The write's last line says "Start the video (paid; ask first)": the
693
+ sheet's yes was that ask, so start now, with the line below, not the
694
+ write's own, which leaves out `--one-shot`. Note the swipe id it printed
695
+ for that video.
696
+ 2. `exodus video swipe start <swipeId> --one-shot --yes`, without
697
+ `--one-shot` when the member chose to stop at the storyboard, and with
698
+ `--music` when they chose music. Give the member the `Watch it:` link at
699
+ once. Then go on to the next video.
700
+ 3. When every video has started, follow each run with `exodus video status
701
+ <runId>` and do what it prints. A one-shot run that waits for a cut goes
702
+ to "End: watch and approve" (pull, cut, upload, the run page). A run that
703
+ stopped at the storyboard goes to stop 3, then the end.
704
+
705
+ **Never start the same swipe twice.** One swipe is one video. A start of a
706
+ swipe that already has a video is refused, starts nothing, and names the run:
707
+ follow that run with `exodus video status <runId>`. `--again` makes a second,
708
+ paid video from the same swipe: use it only when the member asks for a second
709
+ video. Before writing again after a write whose wait was cut off, run
710
+ `exodus video swipe list`. It lists the newest first, each with when it was
711
+ written and its product, and the writes run one at a time, so a row for that
712
+ ad and product above the last swipe id you noted (any row for it, when you
713
+ noted none), with no run and not marked refused, is that write. Show it with
714
+ `exodus video swipe show <swipeId>` and start it instead of writing again. A
715
+ row marked refused is that write's refusal: report it as a refused write. When
716
+ no such row is there yet, the write may still finish: check again later.
717
+
718
+ At the end, report each video on one line: its ad and persona, its run id
719
+ and its `Watch it:` link, or why it stopped.
720
+
721
+ **The final approve** is asked for each video as at "End: watch and
722
+ approve". It is one way. A redo of a clip there needs its own yes.
723
+
724
+ **A refusal or a failed check stops that video only.** The others go on, and
725
+ every video is in the report at the end. A refused write prints the writer's
726
+ sentence, its swipe id, what it cost, and "Nothing was started.": report all
727
+ of it for that video. Writing again is paid again and needs the member's
728
+ word. A refused start prints its sentence: report it for that video. A
729
+ one-shot run whose checks find a problem stops for the member: show what
730
+ `status` prints and ask.
731
+
732
+ ### 5. With a persona or a mechanism: the text swipe bot
733
+
734
+ The video writer reads no persona and no mechanism. The `swipe` skill's bot
735
+ does: it writes the ad's lines again with them in, and the write then makes
736
+ those lines the way their ad is made.
737
+
738
+ **When the path is open.** Before the sheet, check these three, all free:
739
+
740
+ - `.claude/skills/genesis-bots/scripts/genesis-stream.mjs` is in the folder.
741
+ - `exodus keys status` (it prints key names, never values) shows
742
+ `GENESIS_API_KEY`, and `ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY`, as
743
+ "local ✓". When it cannot reach the dashboard, this does not hold.
744
+ - `grep -l '^GENESIS_BASE_URL=' .env .claude/skills/genesis-bots/.env`, run
745
+ in the folder that holds `.claude/`, names at least one file. It prints
746
+ file names only, never a value. The helper needs this address, and
747
+ `exodus keys status` does not show it.
748
+
749
+ When one does not hold, the path is closed and everything stays as above:
750
+ the rows keep "(noted; the video writer does not read it yet)" and every
751
+ write is the one "On the yes" gives.
752
+
753
+ **Which videos take it.** With the path open, the bot writes a video's lines
754
+ when all three hold for that video, and "step 5 applies" means that video:
755
+
756
+ - The member picked a persona for it, or a mechanism. The primer's lead
757
+ mechanism that "just do it" picks stays noted only.
758
+ - How close is 1, 2 or 3.
759
+ - The write would be `--mode whole-ad`. A note that sets `hook-only`,
760
+ `their-format` or `new-look` keeps that write, and the persona and the
761
+ mechanism stay noted only: the bot never takes the place of the member's
762
+ own script.
763
+
764
+ Every other video is made as "On the yes" says, with the persona and the
765
+ mechanism noted only.
766
+
767
+ **On the sheet, when the path is open.**
768
+
769
+ - Rows 1 and 2 read "(used through the text swipe bot)" in place of
770
+ "(noted; …)".
771
+ - Row 3 reads "1 Near-clone, 2 New scene, same beats, 3 Same idea, new
772
+ drama, 4 Same arc, 5 Pattern only (with 4 or 5, the persona and the
773
+ mechanism are only noted)". Levels 1 to 3 are the `swipe` skill's levels
774
+ (its section 2), not the dial's: say so when the member asks. A video the
775
+ bot does not write takes the same number as its `--closeness`.
776
+ - **It buys** adds, when the picks give the bot any video: "and a text swipe
777
+ call for each video (two at level 2 or 3), on your own Genesis and model
778
+ keys." When only some videos take it, name them ("for videos 1 and 3").
779
+ - A reply that adds bot calls makes the buy bigger, so it is not the yes: a
780
+ persona or a mechanism added where the sheet had none, or, while a persona
781
+ or a mechanism is picked, how close moved from 1 to 2 or 3, or from 4 or 5
782
+ to 1, 2 or 3. A reply that moves how close to 4 or 5 while a persona or a
783
+ mechanism is picked is not the yes either: say that they will then be only
784
+ noted, and wait. One persona changed for another, with the same count, is
785
+ not a bigger buy.
786
+
787
+ **For each video the bot writes, on the yes:**
788
+
789
+ 1. The ad's lines: the Script part of `exodus video swipe status
790
+ <breakdownId> --full` (free), with who says each line. Keep each video's
791
+ files in a folder of its own, `swipes/<slug>/video-<n>/`, so no video
792
+ reads another's lines, and save the options answer as `options.md`, apart
793
+ from the lines.
794
+ 2. The PRODUCT block, built as the `swipe` skill's section 3 says, with that
795
+ video's persona and the mechanism. Begin it with the line `exodus video
796
+ swipe products` prints for the product being written (its name and
797
+ description).
798
+ 3. The bot, called as the `swipe` skill's section 4 says, with LEVEL from
799
+ row 3, one stream at a time, under that skill's "Security" rules. At level
800
+ 2 or 3 its options call comes first; its options are short scenes, one
801
+ line each. The one round has no stop for the pick: take option 1 and send
802
+ its full SCENE text, as section 4 says. Section 4's retries and section
803
+ 5's count and FIX call are each another paid call, and are not part of
804
+ this path. Run the helper so the shell's own time limit cannot cut it off
805
+ (a long timeout, or in the background), and wait for its "Done:" line or
806
+ its error.
807
+ 4. Save the bot's lines to a file, each line with its speaker label exactly
808
+ as the bot wrote it ("Alex: …"). Drop blank lines, a line "---", and a
809
+ first line that starts "Value mismatch —". When that first line comes,
810
+ tell the member in one sentence: it says why the scene and the product do
811
+ not fit, and may name a better level.
812
+ 5. `exodus video swipe write <breakdownId> --product <id> --mode their-format --script <file> --yes`.
813
+ No `--closeness`: the CLI refuses it with `their-format`, and the bot's
814
+ LEVEL carried the closeness. The write keeps each line word for word, and
815
+ its cast follows the file's speakers.
816
+ 6. The check below, then the start, as "On the yes" does.
817
+
818
+ At level 2 the bot may give the lines to a new speaker named after the
819
+ persona, in place of the ad's own; the cast follows the script. Say so in
820
+ one line of the report for that video. For an ad with one speaker it still
821
+ wrote one speaker, even when its options had several people in them.
822
+
823
+ **The check is yours.** The write keeps the script's lines as they are and
824
+ checks none of their claims, so after each write and before its start, read
825
+ every line of the script it prints, and its Direction, against (1) that
826
+ video's persona, when one was picked, (2) the mechanism, when one was
827
+ picked, and (3) the product's own facts. The facts are only these: the line
828
+ `exodus video swipe products` prints for that product, and the product
829
+ facts in the PRODUCT block you sent for that video. Never the ad's own
830
+ claims (they were made for another product), and never the bot's. A picked
831
+ mechanism's own words count as a fact for a line that says only what they
832
+ say; a result beyond them needs a product fact.
833
+
834
+ - The persona is in when the lines speak as that person or to them (their
835
+ situation, what they want). The mechanism is in when the lines name it or
836
+ explain it.
837
+ - A line holds only when one of those facts says the same thing. A line that
838
+ goes further does not hold: a result the facts do not name, a bigger
839
+ number, a shorter time, "cures" where the facts say "helps". When you are
840
+ not sure, it does not hold.
841
+ - Each of these needs a fact that says it: a health or body result (sleep,
842
+ pain, weight, energy, skin, treating or curing anything), a money result
843
+ (earning, saving), a guarantee or a refund, any number (a percent, a time,
844
+ a count, a price, a rating, how many customers), and a named result (a
845
+ named person's result, a review, a doctor or an expert, a study, an award,
846
+ "the #1").
847
+
848
+ When a picked persona or mechanism is missing, or a line promises something
849
+ the product's facts do not hold (a result, a health benefit, a number), do
850
+ not start that video: show the member that line and ask. The other videos go
851
+ on. Show each such line with the fact it would need, and offer three ways
852
+ on: start it as written, leave that video out, or the member's own words for
853
+ those lines, written again with `--mode their-format --script <file>` (a
854
+ second paid write, on their word) and checked again. This is the one stop
855
+ this path adds, and it comes only when the check finds something. The write
856
+ may still refuse a name, price or code from their ad, or a cast the kind of
857
+ ad cannot take (more speakers than it holds, or speakers where it takes a
858
+ narrator only): a refused write stops that video only, as above. A write
859
+ whose wait was cut off and is found again with `exodus video swipe show
860
+ <swipeId>` (as "On the yes" says) gets this check too, on the script `show`
861
+ prints, before its start.
862
+
863
+ **Run so far.** Levels 1 and 2 of this path have been run for real, as far
864
+ as the write. Level 3 has not.
865
+
866
+ **A bot call that fails** (the helper prints an error, or "stream completed
867
+ but produced no content") stops that video only. Report it. Calling the bot
868
+ again is paid again and needs the member's word, even when the helper's own
869
+ error says "retry". Never use the partial lines a failed call leaves in its
870
+ file. These count as failed calls too: a "Done:" line with
871
+ `finish_reason=length`, which means the lines were cut short; an answer with
872
+ no speaker lines in it; and a call the shell cut off before "Done:" or an
873
+ error, which may have been paid all the same.
874
+
875
+ Some failures stop every video the same way. The helper stops before it
876
+ sends anything, and charges nothing, with "ERROR: GENESIS_BASE_URL is not
877
+ set", "ERROR: GENESIS_API_KEY is not set" or "ERROR: no provider key found".
878
+ A wrong model key prints `ERROR: provider_error: 401 …` and charges nothing.
879
+ A Genesis key it refuses, a limit reached or a server fault prints `ERROR:
880
+ HTTP 401`, `HTTP 429` or `HTTP 5…`. On one of these, make no further bot
881
+ call. Tell the member what went wrong, and ask whether to fix it and go on,
882
+ or to make the rest as "On the yes" says, with the persona and the mechanism
883
+ noted only.
884
+
885
+ ### Step by step: a yes before each paid step
886
+
887
+ For a member who asks for stops. Four steps cost money, and the CLI prints no
888
+ price for any of them. Run each one first without `--yes`: it sends nothing
889
+ and prints what the step buys and who pays. Tell the member both, say the CLI
890
+ prints no price, never guess one, and run the same line with `--yes` only
891
+ after their yes.
892
+
893
+ 1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
894
+ Instagram or YouTube), or a video ad in the brand's swipe library by the
895
+ id that `exodus video swipe find` prints (free):
896
+ `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId>`.
897
+ The breakdown is paid on the team's keys, not the member's. A link or an
898
+ ad this brand broke down before comes back at once and costs nothing.
899
+ With `--wait` it prints each step as it starts, and takes a few minutes.
900
+ Once it is done, `exodus video swipe status <breakdownId> --full` prints
901
+ what Exodus read from the ad: each shot with its cut times, a-roll or
902
+ cutaway, framing, camera and description, then the script with who says
903
+ each line, then the cast. It is free. Show the member the shot list and
904
+ the script before the template, so they can say whether Exodus read their
905
+ ad right.
906
+ 2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
907
+ member's own Anthropic or OpenRouter key. It prints the kind of ad and the
908
+ look the ad matched, and why. A template made before costs nothing. Show
909
+ the member the kind and the look. The swipe writes that kind and no other.
910
+ If the member wants another kind, stop here and make the video from that
911
+ format with the ad's words instead ("From one sentence to a film").
912
+ 3. **The choices.** `exodus video swipe products` lists the brand's
913
+ products. Ask which product, what to swipe and how close. What to swipe
914
+ (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
915
+ script (`--script <file>`, the member's own words), or Their script, a new
916
+ look (`--look <slug>`). How close (`--closeness`, 2 if left off): 1 Mirror,
917
+ 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
918
+ has each one's line.
919
+ 4. **The write.** `exodus video swipe write <breakdownId> --product <id>
920
+ [--mode …] [--closeness …]`, paid on the member's own key. It takes four
921
+ to nine minutes and waits by itself. Show the member the script, the
922
+ direction, Kept and Changed, and what it cost. A refusal prints the
923
+ writer's sentence and "Nothing was started.": tell the member, and offer to
924
+ write again, which is paid too. If the wait gives up, the write may still
925
+ finish: run `exodus video swipe list` before writing again. It shows the
926
+ brand's newest swipes, and a refused one is marked with what it cost.
927
+ 5. **The start.** `exodus video swipe start <swipeId>`. It buys the
928
+ storyboard and its pictures; the voices and clips wait for the storyboard's
929
+ yes. `--style <look>` changes the look, `--music` adds a music bed.
930
+ `--title "<name>"` names the ad, for admins only: a beta tester leaves it
931
+ off, or the CLI refuses it with one sentence naming it. With `--one-shot`
932
+ it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
933
+ member. A swipe that already has a video is refused, with its run; a
934
+ second video from it needs `--again` and the member's yes to a second video.
935
+ 6. **Then** stop 3 (the storyboard) and the end, as above.
936
+
937
+ ### Every swipe command
938
+
939
+ ```operator-guide
940
+ exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
941
+ break the ad down (team's keys); one read before costs nothing
942
+ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
943
+ --full adds what it read: shots, script, cast
944
+ exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
945
+ exodus video swipe products the brand's products and their ids
946
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
947
+ the brand's version (member's key); waits for it
948
+ exodus video swipe show <swipeId> one swipe again
949
+ exodus video swipe list the brand's newest swipes, each with when it was written and its product;
950
+ a refused one shows what it cost
951
+ exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
952
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait]
953
+ start the run on the kind the swipe wrote; --again for a
954
+ second, paid video of a swipe that already has one
955
+ exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
956
+ ```
957
+
297
958
  ## Before anything
298
959
 
299
960
  - `npx @aicopycoders/exodus video --help` and `workflow --help` are the
@@ -328,10 +989,15 @@ CLI words it the way the run page does. On their own brands they can:
328
989
  file"). `--stop-at-script` prints that script and starts nothing.
329
990
  - `video status <runId>`: where the video is, in plain words (waiting in line,
330
991
  planning, drawing, storyboard ready for review, filming, ready with its link,
331
- or stopped and why). `--json` prints the server's answer as it came.
992
+ held for a scene they must make again or keep as it is on the video's page,
993
+ or stopped and why). `--json` prints the server's answer as it came; a held
994
+ video says `"stage": "failed"` with the held scenes in `cutHolds`.
332
995
  - `video storyboard <runId>`: each scene's line and picture, while the
333
996
  storyboard waits for review.
334
- - `video approve <runId>`: approves the storyboard. Nothing else.
997
+ - `video approve <runId>`: approves the storyboard. At an audition stop,
998
+ `video approve <runId> --audition <digest>` accepts the audition clips, and
999
+ plain `video approve <runId>` pays for another try of the failed audition
1000
+ takes ("The audition stop"). Nothing else.
335
1001
  - `video voices <runId>`: who speaks, their current voice, and the voices on
336
1002
  the tester's own ElevenLabs account. `--set <character>=<voiceId>` picks one,
337
1003
  until the storyboard is approved.
@@ -345,6 +1011,9 @@ CLI words it the way the run page does. On their own brands they can:
345
1011
  handover" below applies to them.
346
1012
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
347
1013
  to watch it on.
1014
+ - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1015
+ which is refused with one sentence naming it. The run it starts answers the
1016
+ way start's does.
348
1017
 
349
1018
  Admin-only, answered "video isn't enabled for this key" (or, for retry-clip and
350
1019
  revoice, a sentence saying they are for admins): `director`,
@@ -466,6 +1135,14 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
466
1135
  A different product still needs fresh writing and approval
467
1136
  without --resume-script.
468
1137
  Not for --show
1138
+ --renew-script-approval
1139
+ Optional. Every --resume-script --stop-at-script review
1140
+ already re-checks the --script edits against the saved
1141
+ source and issues a new 24-hour approval, also when the
1142
+ saved one expired; it never writes a fresh script. This
1143
+ flag sends nothing extra: it only refuses the line
1144
+ without --resume-script --stop-at-script, or with
1145
+ --rewrite-to-fit or --show
469
1146
  --input-options List your templates: Golden Six first, then more templates.
470
1147
  Add --conceit <template> for structures, capabilities,
471
1148
  identity locks, references and account voices.
@@ -477,6 +1154,7 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
477
1154
 
478
1155
  The other template flags (`--input-mode`, `--structure`, `--reference`,
479
1156
  `--subject`, `--template-brief`, `--song-controls`, `--mechanism-plan`,
1157
+ `--source-record`, `--adaptation-plan`,
480
1158
  `--requested-seconds`, `--pictures-per-scene`, `--product`, `--elements`,
481
1159
  `--voices`) are in `exodus video --help`.
482
1160
 
@@ -491,6 +1169,12 @@ exodus video picks <runId> --redo face:<who>|room:<place> --note "…"
491
1169
  four new paid pictures for one face or room;
492
1170
  only after the member's yes
493
1171
  exodus video storyboard <runId> read the scene cards
1172
+ exodus video map <runId> [--place <place>] Micro-drama template (admin-only): each room in metres,
1173
+ each person's mark and the setups that film it
1174
+ exodus video move <runId> --move <who>=<x>,<y> [--place <place>] [--note "…"]
1175
+ move people in one room; redraws that room's pictures,
1176
+ one a camera setup; only after the member's yes;
1177
+ approve only once they are redrawn
494
1178
  exodus video voices <runId> who speaks and with whose voice
495
1179
  exodus video voices <runId> --set <character>=<voiceId> give a character a voice
496
1180
  exodus video quote <runId> a quoting format: the exact prepared requests and prices
@@ -556,7 +1240,12 @@ under it:
556
1240
  it instead (`stop.missingScenes` in `--json`) and approval is refused until
557
1241
  it has one. A scene whose picture the video service refused needs
558
1242
  `retry-frame --note` before `retry-clip`; the clip redo alone resends the
559
- refused picture.
1243
+ refused picture. On a video started from the dashboard, the app makes the
1244
+ cut itself; when a scene's clip still has a drawing fault after it was made
1245
+ again, the stop block says `Held:` and names the scene
1246
+ (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1247
+ made again with `retry-clip`, or kept as it is on the video's page (the
1248
+ link it prints). Keeping the last one starts the cut.
560
1249
  - paused: a builder checkpoint neither video verb resolves —
561
1250
  `exodus workflow checkpoint <runId>` is the verb for that one.
562
1251
  - failed: `status` shows how far it got, and a `--wait` that was running exits