@aicopycoders/exodus 2026.11.1200-beta.2 → 2026.11.1200-beta.20

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.
@@ -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. 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`.
3
+ description: Make a video ad with Exodus from the terminal, a UGC talking-head video included. A competitor's ad swiped into a video for the member's brand comes here, with or without the word "exodus": their ad given as a video file or a video link with a video wanted or an ad in Exodus, or a video or a size asked for with an ad to swipe ("swipe this ad for my brand as a UGC video like theirs: their-ad.mp4, make it at 720p"). It runs `exodus video swipe`, as Swipe a video does on the dashboard; with no ad named ("find some ads to swipe for this product") it offers ads from the brand's swipe library (`exodus video swipe find`). Also here: a video run checked or waited on ("exodus, is my video run done", `exodus video status`), its pieces pulled ("pull the pieces", `exodus video pull`), a cut made or uploaded ("make the cut", "upload my cut"), and the script-first run of a saved video workflow (`exodus workflow run`, "exodus, make a video ad from this script"). Admins get every video command; beta testers with Video switched on get the swipe and their own runs' commands. Not this skill: a UGC script with no video ("write me a UGC script") is `ugc-ads`; the UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`; a timeline ad asked for without "exodus" is `timeline-ad-factory` ("exodus, make a skeleton timeline video" stays here); a link for copy is `swipe`; generic editing ("edit this mp4") without Exodus context is not Exodus.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -8,14 +8,17 @@ description: Make a video ad with Exodus from the terminal. One sentence ("swipe
8
8
  Exodus makes the PIECES of a video ad, not the finished ad. From a script, a run
9
9
  writes a storyboard, draws one picture per scene, records the voice, renders one
10
10
  video clip per scene, and generates a music bed. Then it parks and waits for a
11
- cut.
11
+ cut (the app makes it for some runs, below).
12
12
 
13
- There is no server-side stitch and no server-side mix. Nothing joins the clips,
14
- nothing sets levels, nothing burns in captions
13
+ On a run you cut (an admin's run started with `exodus video start` or
14
+ `workflow run`), there is no server-side stitch and no server-side mix.
15
+ Nothing joins the clips, nothing sets levels, nothing burns in captions
15
16
  (`scout/src/workflow/video/music-bed.ts` states the ruling: "the cut, and the
16
17
  mix, happen outside from the pieces the CLI pulls"). You pull the pieces, cut
17
18
  them wherever you like, and upload the result. Approving the upload is what
18
- makes it the ad.
19
+ makes it the ad. The app cuts the others itself: a swiped video, a video from
20
+ the dashboard's Video page and a beta tester's run ("End: watch and
21
+ approve").
19
22
 
20
23
  Your job in this skill is to drive that loop, hand over the pieces with the
21
24
  facts about them, and make whatever cut the user asked for. **How to edit is the
@@ -42,7 +45,7 @@ wrong one.
42
45
  server's list is the truth, and nothing prints it on request. Pass a key it
43
46
  doesn't offer and the refusal names every key it does: `video start --conceit
44
47
  must be one of …`. Nothing is spent on a refused start. Today the server offers
45
- 15 formats and then Custom:
48
+ these formats and then Custom (One-take UGC to admins only, for now):
46
49
 
47
50
  | Key | Kind |
48
51
  |---|---|
@@ -61,8 +64,27 @@ must be one of …`. Nothing is spent on a refused start. Today the server offer
61
64
  | `infomercial` | Infomercial |
62
65
  | `dating-show` | Dating Show |
63
66
  | `game-show` | Game Show |
67
+ | `doorbell-cam` | Doorbell Cam |
68
+ | `reality-confessional` | Reality Confessional |
69
+ | `movie-trailer` | Movie Trailer |
70
+ | `sitcom-skit` | Sitcom Skit |
71
+ | `press-conference` | Press Conference |
72
+ | `stand-up-special` | Stand-up Special |
73
+ | `whisper-asmr` | Whisper ASMR |
74
+ | `unboxing` | Unboxing |
75
+ | `doctor-consult` | Doctor's Office Consult |
76
+ | `documentary-sit-down` | Documentary Sit-down |
77
+ | `microdrama` | Microdrama |
78
+ | `pixar-song` | Suno Pixar Song |
79
+ | `skeleton-timeline` | Skeleton / Claymation |
80
+ | `authority-yapper` | Authority Yapper |
81
+ | `ugc-ultra-realistic` | UGC Ultra-Realistic |
82
+ | `ugc-one-take` | One-take UGC |
64
83
  | `custom` | Custom |
65
84
 
85
+ A swipe's template prints its kind by one of these keys
86
+ (`ugc-ultra-realistic`, say).
87
+
66
88
  Custom builds the ad from the script itself. A script with no `CAST:` runs as a
67
89
  voice-over, and a script with people runs as a scene. Voice-over and Scene are
68
90
  not on the menu by name; Custom is the way to them. A narrator-only script fits
@@ -83,7 +105,11 @@ The member types one sentence, such as "swipe this ad as a microdrama for my
83
105
  brand". You drive the run through its stops and wait for the member at each
84
106
  one. When the sentence names a video ad to swipe as it is made (a video file,
85
107
  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
108
+ their own, go to "Swiping a video ad" below instead. Words that say how their
109
+ ad is made are not a format of their own: "as a UGC video, one person talking
110
+ to the camera, like theirs" goes to the swipe, whose template reads the kind
111
+ from the ad. A format of their own is one their ad is not made as, or a
112
+ template the member names as one ("the UGC template"). The Golden Six formats start on the template door, which needs
87
113
  Templates switched on for the member's account. Without it the CLI answers
88
114
  "video isn't enabled for this key" or "Templates aren't available on your
89
115
  account. Ask an admin if you need it." Tell the member that and stop. A beta
@@ -129,8 +155,8 @@ does offer, and nothing is spent.
129
155
  Exodus or behind a link (the `swipe` skill's section 1 gets them). Save
130
156
  the words to `source.txt`. A video ad the member wants swiped whole, its
131
157
  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.
158
+ ad" below. That path picks the kind itself, so a member set on a format
159
+ of their own (as above), one of the Golden Six among them, stays here.
134
160
  - the format: the table above.
135
161
  - the brand: `exodus brand current`.
136
162
  2. `exodus video start --input-options --conceit <key>` prints the template's
@@ -331,14 +357,59 @@ the audition scenes and prints what to run next:
331
357
  ### End: watch and approve
332
358
 
333
359
  At the final watch, follow the block `status` prints ("Where a run can
334
- stop"). When the cut is already uploaded, give the member the run page to
335
- watch it. When the run waits for a cut: `exodus video pull <runId> --out ./ad-<runId>`, make the
336
- cut ("Cutting the ad"), `exodus video upload <runId> --file <cut.mp4>`, and
337
- give the member the run page. Ask: approve, redo a clip, or stop here.
338
-
339
- - Approve: `exodus video approve <runId>` makes the cut the ad. It is one-way.
340
- - Redo a clip: `retry-clip` as at stop 4, after their yes. Then pull, cut
341
- and upload again.
360
+ stop"). Who makes the cut, and whether the member approves it, depends on how
361
+ the run started:
362
+
363
+ - **The app makes the cut** of a swiped video, a video from the dashboard's
364
+ Video page and a beta tester's run, once every clip is made and no scene is
365
+ held. While it makes it, `status` on an admin key says "Every piece is
366
+ made. The app makes the cut now; look again in a minute: exodus video
367
+ status <runId>": make no cut of your own, and read `status` again in a
368
+ minute. `exodus video wait <runId>` waits through it. On a run started with `--one-shot` that cut is delivered by itself,
369
+ with no approve: on an admin key `status` then says "Final cut: approved
370
+ and delivered.", and on a beta tester's key "Your video is ready: <link>".
371
+ In the minute between the cut and the delivery, `status` on an admin key
372
+ says "Final cut: made. This run delivers it by itself; look again in a
373
+ minute.": read it again then, and send no approve. Only when the app's check of the finished film against its own sound fails
374
+ (One-take UGC checks it) does a One-shot cut wait instead, as a Guided one
375
+ does, with the check's sentences under it in `status`. The member's last say is before that: the One-shot yes, and the yes to keep
376
+ the last held take, since that keep starts the cut. Say so at each. Give
377
+ the member the run page to watch the film. A run that stopped at the
378
+ storyboard waits for the member instead: on an admin key `status` says
379
+ "Final cut: made by the app. Approve it with: exodus video approve <runId>"; on a
380
+ beta tester's key it says "Your video is ready to watch: <link>" and gives
381
+ the line that finishes it, `exodus video approve <runId>` (the video's page
382
+ finishes it too).
383
+ - **You make the cut** of any other run (an admin's `video start` or
384
+ `workflow run`). When the cut is already uploaded, give the member the run
385
+ page to watch it. When the run waits for a cut: `exodus video pull <runId>
386
+ --out ./ad-<runId>`, make the cut ("Cutting the ad"), `exodus video upload
387
+ <runId> --file <cut.mp4>`, and give the member the run page. On a run
388
+ started with `--one-shot` the upload is delivered by itself, as above.
389
+
390
+ When the cut waits for the member, ask: approve, redo a clip, or stop here.
391
+ On a One-take run no take is made again on its own (every redo door refuses
392
+ it): ask approve, a new run that films every take again at its full price
393
+ (for a swiped video, `exodus video swipe start <swipeId> --again`, its price
394
+ first), or stop here.
395
+
396
+ `pull` also writes the finished video as `video.<ext>` once the run has one,
397
+ on an admin key as on a beta tester's. On a delivered run it ends "This run
398
+ is delivered. The finished video is <file>.": give the member that file and
399
+ the run page to watch it. On a run the app cuts, once every piece is made
400
+ and until it is delivered, it ends with no upload line: make no cut of your
401
+ own, unless `status` says the app's cut didn't work and offers you to cut it
402
+ yourself, and the member says yes.
403
+
404
+ - Approve: `exodus video approve <runId>` makes the cut the run's finished
405
+ video. Unless the run started from a template, it can't be undone; a change
406
+ after it is a new run. Nothing is posted to an ad account. The video stays
407
+ on the run page and in Video → Your ads, and `pull` saves it. A workflow
408
+ whose Output names a Drive folder, or that has a webhook, also sends it
409
+ there.
410
+ - Redo a clip: `retry-clip` as at stop 4, after their yes. On a run the app
411
+ cuts, it cuts again by itself (read `status`); on any other, pull, cut and
412
+ upload again.
342
413
 
343
414
  **On the song format**, tell the member this before they approve: "The song
344
415
  made here is for review. Before this video runs as a paid ad, make the same
@@ -348,38 +419,124 @@ on those plans and downloaded from Suno."
348
419
 
349
420
  ## Swiping a video ad
350
421
 
351
- What Swipe a video does on the dashboard, from the terminal. Exodus breaks the
422
+ What Swipe a video does on the dashboard, from the terminal: Exodus breaks the
352
423
  competitor's ad down, matches it to the closest kind of ad and look it makes
353
424
  (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.
425
+ the swipe wrote, the same run Swipe a video starts on the dashboard.
356
426
 
357
427
  These steps need Video switched on for the member's account. Without it every
358
428
  swipe command answers "Not found on this brand. The id is wrong or is another
359
429
  brand's, video isn't switched on for your dashboard user, or this is not the
360
430
  brand you meant (exodus brand current). Check the id first." Check the id and
361
431
  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.
432
+ them, and offer `ugc-swipe` (the script) instead of stopping: it swipes their
433
+ ad's words into a script for their product, with no video. Offer it too when
434
+ they want only the words.
435
+
436
+ This path has no picks stop and no pilot clip: the run goes from the start
437
+ straight to the storyboard (stop 3), whose approve makes every clip, and a
438
+ `--one-shot` run approves it itself when its checks pass. A video made from
439
+ one of our formats (`--adapt`, "From one sentence to a film") keeps both.
440
+
441
+ By default a swipe is one round: read the ad, one question with the plan, and
442
+ on its yes write and make each video. When the member names no ad, the
443
+ options come first (step 0); "Step by step" asks before each paid step.
444
+
445
+ **How it talks.** Seven rules; the screens below are their templates (the
446
+ question's text, options and money line as written; the message in your words).
447
+
448
+ 1. **Decide, then show.** Pick every row you can (how close, where it stops,
449
+ music, the product, the recommended person and voice); the member edits it.
450
+ Rows that do nothing today (persona and mechanism while noted, not read;
451
+ the "not yet" lists) stay off the first screen.
452
+ 2. **Text first, then the question, in one reply.** The picker shows only its
453
+ question's text and each option's label and description, so a plan you
454
+ only thought never reaches the screen. Write the message as plain text
455
+ first (one or two lines: what you read, rule 7's cue; never the plan
456
+ twice), then call `AskUserQuestion`: its text holds the plan and the money
457
+ line in at most 3 short lines, then the question. No paragraph of reasons.
458
+ 3. **Ask with the `AskUserQuestion` tool** (1 to 4 questions, 2 to 4 options
459
+ each, a header of at most 12 characters, one line of description an option;
460
+ it adds "Other" by itself), the recommended option first with
461
+ "(Recommended)" only for a real reason. Where the tool is not there (it
462
+ errors, in a subagent, on a host without it), send the question's text and
463
+ the same options as a short numbered list after the message. A typed answer
464
+ always works. Step 0's six options stay a numbered list. One real option
465
+ gets a second ("Stop here", "None"). A row of more than four values (how
466
+ close has five; a long product or voice list) shows what it is now and the
467
+ nearest two or three, and names the rest in the question's text ("also:
468
+ Same arc") for "Other", or goes as a numbered list.
469
+ 4. **The option that spends carries its price in its label**, in the CLI's own
470
+ figures, or "no printed price" where it prints none: a verb, what it buys
471
+ in two or three words, the price. Its description starts with what it buys
472
+ in full. Never a figure you worked out, never a formula.
473
+ 5. **One money line**, in each paid step's question's text, right before the
474
+ question, and at the end: `Spent so far: $<X>`, each cost line the CLI
475
+ printed counted once, with whose money it was (never the team's and the
476
+ member's added up), and in brackets what printed no cost: `Spent so far:
477
+ $<X> on the team's keys for reading their ad (the template, on your model
478
+ key: not printed)`. On a run whose `status` prints "Cost so far:" or "Cost:"
479
+ (an admin key), of a kind whose price the member said yes to: `Spent $<X> of
480
+ about $<Y>`, X that line's figure, Y that price's "about". With no such
481
+ line, "the run's cost is not printed": never a figure, never that it was
482
+ free. Who pays is said once: the read's line (step 1), then the sheet's
483
+ spending option ("on your own keys", naming the Kie and ElevenLabs keys a
484
+ kind needs). Say a cost as the CLI printed it, each once ("It cost $<X> on
485
+ the member's key."): never a range, an average or an "about" of your own.
486
+ 6. **Progress is one line; a problem is two lines and a question** (step 4).
487
+ Narrate no command; wait on a run in the background (`exodus video wait
488
+ <runId>`) and speak when it is delivered or stops.
489
+ 7. **Details on request**, named once on the first screen: "show sheet", "show
490
+ script", "show people", "why" (step 3).
491
+
492
+ Rule 4's spending options, each figure the one the CLI printed for this swipe.
493
+ An option that runs a `--yes` line and has no row still carries the CLI's
494
+ figures or "no printed price" in its label, not only in its description:
495
+
496
+ | Ask | Label | Its description starts |
497
+ |---|---|---|
498
+ | The sheet | `Make 1 video · no printed price` (above 6: `Make 8 videos · no printed price`) | 1 script, then the video to its storyboard; the voices and clips wait for your yes there (one shot: the whole video, with no final approve). On your own keys. |
499
+ | The sheet, a write that makes people | `Write it · people about $…, at most $…` | 1 script (no printed price), <k> people to pick from, and the animal's picture ($…) if the script has one. The film waits for your yes on its price. |
500
+ | "Film it?" | `Film it · about $…, at most $…` | <k> takes at <size>. The cut plays them a little faster and shortens long pauses, so the video is shorter than its takes and can be shorter than their ad. … Not in the price: text calls on your model key, the word check on your ElevenLabs key, a second listen on your Kie key. |
501
+ | Their look | `Their look · about $…, at most $…` | One read of their speaker's look, then <k> new people and a check of their faces. Never their face. |
502
+ | More people | `<n> more people · at most $…` | <n> new people to pick from, on your model and Kie keys. Nothing is filmed. |
503
+ | A hold | `Film every take again · about $…, at most $…` | A new video from the same swipe. One take cannot be filmed alone. |
504
+ | A refused write | `Write again · no printed price` (with people: `Write again · people about $…, at most $…`) | The same write again, on your model key. A refused write is paid too. |
505
+ | Your own script | `Use my own script · no printed price` | Your lines word for word, made the way their ad is made, on your model key; people only when the script keeps their speaker's type. |
506
+ | Step by step; the read past its limit or again (step 1); a start on its own (a refused start, step 5's check) | `Read the ad · no printed price`, `Read the rest · <what is left> · no printed price`, `Read it again · no printed price`, `Make the template · no printed price`, `Write it · no printed price`, `Start it · no printed price` | What the line without its yes printed that it buys, and who pays: each breakdown on the team's keys, each template and write on your model key. A write with people is the sheet's "Write it" row; a start of a kind with a saved sheet, the "Film it?" row. |
507
+ | Mining (step 0) | `Mine them · no printed price` | Every active competitor on the watchlist, up to 50 in one run, on your Scrape Creators key. It starts at once. |
508
+ | The bot again (step 5) | `Call the bot again · no printed price` | One more text swipe call, on your Genesis and model keys. |
509
+
510
+ **What a yes is, at every question on this path**: the sheet, "Film it?", a
511
+ stop's "What now?", Their look, more people, and the storyboard stop and the
512
+ end approve when a swipe's run reaches them ("Stop 3: the storyboard" and "End:
513
+ watch and approve" say what each shows). Each paid
514
+ line (`--yes`, or an `approve` that buys) runs only after the member pressed an
515
+ option whose own label names what it buys and its price (or "no printed
516
+ price"), or typed a yes to that option ("go", "film it"; with the picker up, a
517
+ typed answer arrives as "Other"). It buys only what the pressed label, its
518
+ description and the question's text showed: a plan pick in none of them is not
519
+ covered, so ask again with it in the question. Its `--max-usd` or
520
+ `--people-max-usd` is that label's "at most". With two options that spend, a
521
+ bare "go" names neither: ask which. None of these is a yes: a press or a typed
522
+ pick of any other option ("Show me …", "Change something", a free look,
523
+ "Stop"); "ok", "thanks", "maybe" or "looks good" after something you showed; a
524
+ question, or a reply you are not sure of; a change with no yes in it; a picker
525
+ that errored, timed out or was closed; an answer from another agent when you
526
+ run as a subagent (then run nothing paid and hand the question back). Do what
527
+ was asked, then ask the same question again, with the price read again if a row
528
+ changed.
375
529
 
376
530
  **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.
531
+ template, 15 for a write (the write always waits; it has no `--wait`) and 5
532
+ more while the people a write makes are made (up to 20 in all), and 60 for
533
+ `swipe start --wait` and for `video wait <runId>`. A start first waits up to 5 minutes while people are
534
+ still being made for its swipe, then goes on and says what it films. Run these
535
+ in the background, or leave `--wait` off and check in, so the shell's own time
536
+ limit does not cut them off. A wait that was cut off or timed out is not a
537
+ failure: the work goes on. Follow it by the id it printed, with the command
538
+ the CLI names, and never by running the paid line again: a second run buys it
539
+ a second time.
383
540
 
384
541
  ### 0. No ad named: find some
385
542
 
@@ -433,9 +590,9 @@ The rules of the options:
433
590
  **A find by kind.** When the member asks for a kind of ad ("find me some
434
591
  authority yappers"), offer at most six whose words sound like that kind, and
435
592
  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).
593
+ the read confirms it." After the reads, the sheet's first line marks an ad the
594
+ template read as another kind in a few words ("ad 3: read as <kind>"), so the
595
+ member can drop it ("drop video 3, go" is already a yes).
439
596
 
440
597
  **What a pick is.** Only numbers given after an options message ("1, 3 and
441
598
  5"), or "all" (the options the member last saw), are picks. The numbering
@@ -537,54 +694,60 @@ zero, and a new template is unknown.
537
694
 
538
695
  Read one ad at a time: its breakdown, then its template. Before each read
539
696
  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.
697
+ member once when the costs counted have reached $0.50, or when any read so far
698
+ is unknown: an unknown cost counts as reaching the limit. Say what is left to
699
+ read. A new template is always unknown, so with several ads you read the first
700
+ and ask before the rest. The check comes before each read, so the total can
701
+ pass $0.50 by one read. Ads the member picked by number from the options (step
702
+ 0), or with "all", are already a yes to read: read every picked ad without
703
+ this ask. The ask still comes before any ad they did not pick. Ask it as a
704
+ question whose text ends with the money line: "Read the rest · <what is left>
705
+ · no printed price", or "Stop here".
706
+
707
+ A breakdown or a template that fails prints why. With one ad, tell the member
708
+ and stop. With several, leave that ad out, mark it in a few words on the
709
+ sheet's first line ("ad 2: not read"), and go on with the others.
553
710
 
554
711
  ### 2. Read the choices
555
712
 
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.
713
+ Free, and no yes: `exodus segment personas` (the saved personas; leave out the
714
+ ones marked `[archived]`) and `exodus primer show` (its MECHANISM section;
715
+ with no primer saved, the mechanism row offers only the member's own words or
716
+ none). The products came in step 1.
560
717
 
561
718
  ### 3. The sheet, once
562
719
 
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.)
720
+ Send the sheet as one reply, its message as text first and its question after
721
+ it (rule 2), then stop and wait. The message:
722
+
723
+ > Read your ad: <length>, <who is in it>, <how it is cut>. (several ads: one sheet for all, a few words each)
724
+ > Say "show sheet", "show script" or "why" · "personas": <N> saved, several make one video each, <noted only | written in by the text swipe bot> (only when the brand has some) · "mechanism" (only when step 5's path is open)
725
+
726
+ Its question (`AskUserQuestion`, header "Make it?"), its text:
727
+
728
+ > <the kind the swipe makes> for <product> · Script <how close, in words> · Stop <at the storyboard, before the paid clips | at the end, with no final approve> · Music <off | on, on your ElevenLabs key>
729
+ > Videos <n> = <a> ads × <p> personas: 1 <ad> × <persona>, 2 … (only when more than one) · Persona and mechanism: <the picks>, <written in by the text swipe bot | noted only: the videos differ only as two writes do> (only when picked)
730
+ > Spent so far: $<X> on the team's keys for reading their ad (the template, on your model key: not printed). Make it?
731
+
732
+ Its options: 1. the spending option (the table) 2. another way, only when
733
+ there is one, such as One-take UGC when the template offered it 3. Change
734
+ something: the product, how close, where it stops, music 4. Stop.
735
+
736
+ "Change something" asks the rows as questions (rule 3), what each is now first,
737
+ marked "(now)", then sends the sheet again. "show sheet" prints every row as
738
+ `swipe-sheet.md` (beside this file) lays it out. "show script" is their ad's
739
+ script (`status --full`, free), and after the write the written one with its
740
+ direction, Kept and Changed; "show people", each person made with their
741
+ picture's address, and the voices when the sheet has a `voice` row; "why", your
742
+ reasons, one line each.
582
743
 
583
744
  **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.
745
+ start, the member has seen the list and the count, and said yes to them. This
746
+ holds also when their first message says "just do it" or "let it run": "Let it
747
+ run" fills the rows with your picks, and the yes still comes from the member.
748
+ The yes is as "What a yes is" says. A typed change with no yes in it: make the
749
+ change, send the sheet again with its price, and ask again. Each "wait" below
750
+ asks the question again.
588
751
 
589
752
  - A reply that makes the buy bigger is not the yes, even with "go" in it:
590
753
  more videos, another ad, music on where the sheet said off, or "one shot"
@@ -594,10 +757,11 @@ the member.
594
757
  "go", is the yes: how close, music off, or leaving out videos it names
595
758
  ("drop video 3, go"). Say the change in one line and start. "Fewer" with
596
759
  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.
760
+ - Above 6 videos, only a yes that names the count is the yes ("yes to 8
761
+ videos", "8, go"); a bare "go" or "yes" gets the count asked again. So above
762
+ 6 videos the spending option names the count ("Make 8 videos · …"), and its
763
+ press is a yes that names it; a numbered list ends "That is 8 videos. Say
764
+ yes to 8 videos."
601
765
  - On a sheet of 1 video, "1: Anna, Ben and Cara. Go." is 3 videos: send the
602
766
  list of 3 and wait.
603
767
 
@@ -612,77 +776,137 @@ The rows:
612
776
  - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
777
  each 15 or 25 seconds of the script filmed as one long take. It is open to
614
778
  admins only for now: for anyone else the CLI refuses it, so don't offer it
615
- to them. Use it when
616
- the member asks for a one-take UGC video or names Luke's UGC method, and
617
- then the sheet's first line says the swipe makes one-take UGC. When the ad
618
- is one person talking to the camera, you may name it as one option beside
619
- the kind the swipe makes; never choose it unasked. On an ad it can't be
620
- made from, the write refuses it and says why. It buys a face photo, a
621
- picture of the room, a cut-out of the product and one take for each 15 or
622
- 25 seconds of script, on the member's Kie key, and text calls on their
623
- model key; it needs their ElevenLabs key and their Kie key. Its price is
624
- the server's estimate, shown only where the CLI prints one; for a swipe it
625
- prints none today.
626
- - **The saved sheet** (a kind that has one; One-take UGC today). The server
627
- keeps one for each swipe of such a kind, made after its write. For such a
628
- video this sheet's yes covers the write only, and **It buys:** says so:
629
- "<n> scripts now; each video after your yes on its saved sheet". The
630
- saved sheet and its yes come in step 4.
631
- - **Persona.** Offer the three saved personas that fit the ad best, each with
632
- a short reason, then "show all <N>" (every persona not marked
633
- `[archived]`). Several may be picked: one video for each.
779
+ to them. Take it when the member asks for a one-take UGC video or names
780
+ Luke's UGC method. Use it too when the template prints "Also fits their ad:
781
+ One-take UGC (ugc-one-take). …" and the member asked for a UGC video of one
782
+ person talking to the camera, in any words: the word "one-take" is not
783
+ needed. Then take it: the plan says the swipe makes One-take UGC, with the
784
+ reason the template's line gives; One-take UGC is then the kind made. The
785
+ write carries `--kind ugc-one-take`, its dry run first (People, below), and
786
+ the sheet's yes is the yes to it. The line comes only for an ad its write
787
+ takes and a member who may start it. When the line comes and the member
788
+ asked for nothing it fits, offer it as one option of the sheet's question,
789
+ beside the kind the swipe makes, with the reason that line gives; never
790
+ choose it unasked. A press or a typed pick of it is not the yes yet: run its
791
+ write line with `--kind ugc-one-take` and no `--yes` (free; People, below),
792
+ and send the sheet again with that price. A sheet run (`exodus video swipe
793
+ run --sheet <file>`) of one ad that names no kind prints the same line,
794
+ ending "set "kind": "ugc-one-take" in the sheet before its next run.": set
795
+ it only on their yes, and say that the next run writes that ad again, which
796
+ is paid. On an ad it can't be made from, the write refuses it and says why.
797
+ It buys a face photo, a picture of the room, a cut-out of the product, a
798
+ picture of an animal when the script puts one in the picture, and one take
799
+ for each 15 or 25 seconds of script, on the member's Kie key, and text calls
800
+ on their model key; it needs their ElevenLabs key and their Kie key. Its
801
+ price, the server's estimate, comes after the write (step 4). The "about"
802
+ films each take once. A take filmed again (as when a filming left out script
803
+ words that matter) is paid again, so the run can cost more than "about"; the
804
+ "at most" counts each take and picture made twice. On an admin key, plain
805
+ `exodus video status` prints a line that starts "Cost so far:" or "Cost:"
806
+ once the run has spent anything: that is the run's own cost, the figure the
807
+ dashboard shows, and the line says what is not in it (what the swipe paid
808
+ for before the run). When it prints none, no cost is recorded yet: say so,
809
+ and never call the run free.
810
+ - **The saved sheet** (One-take UGC today) comes after the write, with its
811
+ own yes (step 4). This sheet's yes covers their write and its people only,
812
+ and the spending option says so, with the people's part only when the dry
813
+ write printed their price (People, below).
814
+ - **People** (a kind whose write can make them: One-take UGC, when the server
815
+ offers people to pick from). Before you send the sheet, run that video's
816
+ write line (step 4) without `--yes`: it writes nothing and pays for nothing.
817
+ When the kind makes people, it prints "This write also gives the sheet <k>
818
+ people to pick from, …", their price ("About $… for new people: …", "A
819
+ picture of the animal, if the script puts one in the picture: $…" and "At
820
+ most $… in all: …") and the line to run: "On their yes, run the same command
821
+ with --yes --people-max-usd <most>". Those figures go in the spending option
822
+ ("Write it" in the table, each video's as printed): the about from "About $…
823
+ for new people" (the people only; the animal's own line goes in the
824
+ description) and the most from "At most $… in all". Its press is the yes to
825
+ that most. With it, the write also draws the animal its stored script puts
826
+ in the picture (the dog in a dog product's ad) with the people, inside the
827
+ same most; `exodus video swipe sheet set <swipeId> animal=none` takes it out
828
+ of the video (free). When the member gave a money limit and the people's
829
+ most, added over every video on the sheet, is already over it, say so in one
830
+ line of the plan and ask: no write goes out until what it can cost fits.
831
+ When it prints none, the write makes no people. Nor does `--no-people`. Two
832
+ more writes make none, and nothing is paid for them: a member's own script
833
+ (`their-format`) that keeps its own person (the "Persona and mechanism" row
834
+ below says when), and a video that step 5 writes, written with a plain
835
+ `--yes`; each write says so. So leave the people out of a step 5 video's
836
+ option, and for the member's own script its description says its people are
837
+ made only when the script keeps their speaker's type. Either way the member
838
+ can ask for people on the saved sheet: `exodus video swipe sheet people
839
+ <swipeId>`, the price first.
840
+ - **Persona.** Pick none unless the member named one. "personas" asks the three
841
+ that fit the ad best, each with a short reason, as one question that takes
842
+ several picks, and "show all <N>" lists every one. "mechanism" asks the
843
+ primer's mechanisms (step 2), the member's own words, or none.
634
844
  - **Persona and mechanism.** The video writer reads neither. When step 5's
635
845
  path is open, the text swipe bot writes them into each video's lines, and
636
846
  the rows say so (step 5). When it is closed, and for a video the bot does
637
- not write, they are noted, not read: in
638
- **My picks**, a persona or a mechanism always carries "(noted, not used
639
- yet)", the primer's lead mechanism included, and videos for two personas
640
- differ only as two writes of the same request differ. In that case, when
641
- more than one persona is picked, say this in your reply before the yes, so
642
- the member does not pay for several videos expecting a script for each
643
- persona. Two other ways make a persona real without step 5. The member
644
- writes their own script for that persona, and the write takes it with
645
- `--mode their-format --script <file>`, made the way their ad is made. Or
646
- the member swipes the words with the `swipe` skill and makes the film from
647
- one of our formats (its "Make it a video"). That path asks a yes before
847
+ not write, they are noted, not read: on "show sheet", a persona or a
848
+ mechanism always carries "(noted, not used yet)", the primer's lead
849
+ mechanism included, and videos for two personas differ only as two writes of
850
+ the same request differ. In that case, when more than one persona is picked,
851
+ the plan's personas line says so ("noted only: the videos differ only as two
852
+ writes do"), so the member does not pay for several videos expecting a
853
+ script for each persona. Two other ways make a persona real without step 5.
854
+ The member writes their own script for that persona, and the write takes it
855
+ with `--mode their-format --script <file>`, made the way their ad is made.
856
+ For a kind whose sheet has a person (One-take UGC today), who is filmed
857
+ depends on the script. One that names no speaker, and does not make its
858
+ speaker the other sex from their ad's speaker, is cast as their ad's
859
+ speaker's type: the write puts that type on the script's cast line. A
860
+ speaker label that is not a placeholder ("Maya:", not "Speaker:"), a name
861
+ the script says ("Hi, I'm Jess"), its own words about the speaker, or words
862
+ that make the speaker the other sex keep the script's own person. The saved
863
+ sheet's person row says which, and why. To film the persona's own person,
864
+ the script names its speaker, or the member sets `who` on the saved sheet.
865
+ Or the member swipes the words with the `swipe` skill and makes the film
866
+ from one of our formats (its "Make it a video"). That path asks a yes before
648
867
  each paid step, and it makes the film in the format they pick, not in the
649
868
  ad's own kind and look.
650
- - **Characters.** A swiped run takes no saved characters and draws no new
651
- faces yet, so the row offers only "the tool picks".
652
- - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
653
- scripts, and <n> storyboards with their pictures; the voices and clips
654
- wait for your yes at each storyboard.
869
+ - **Characters.** A swiped run takes no saved characters, so the row offers
870
+ only "the tool picks". People a write makes are picked in step 4.
871
+ - **Run.** "Stop at the storyboard" buys the scripts and the storyboards with
872
+ their pictures; the voices and clips wait for your yes at each. "One shot"
873
+ has no final approve (step 4): the plan's Stop line says so.
655
874
  - **Finish.** `swipe start` takes `--music` and nothing else for the finish.
656
- Music is made on the member's own ElevenLabs key. Caption style, speed,
657
- jump cuts and the end card come with a later update.
875
+ Music is made on the member's own ElevenLabs key. Music is off unless the
876
+ member asked for it; the plan's line says which. Caption style, speed, jump
877
+ cuts and the end card come with a later update.
658
878
  - **How many.** Ads × personas, with none counting as one persona and the
659
879
  characters counting as one today. Show the multiplication, as in "4 videos
660
- = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
661
- that count in so many words: "That is 8 videos. Say yes to 8 videos."
662
- - **Cost.** The CLI prints no price for a swipe, so the sheet says exactly
663
- that: no number, no range, no guess. The Director block of `exodus video
664
- status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
665
- for its redos on that video, not a price and not a ceiling for the first
666
- pass. Never quote it as the cost.
667
- - **Product.** Add a row **Product:** only when `swipe products` lists more
668
- than one. With one, write for that one.
880
+ = 2 ads × 2 personas".
881
+ - **Cost.** Before the write the CLI prints no price for a swipe: the option's
882
+ "no printed price" says so, and no other line about cost goes on the screen.
883
+ With a money limit and a kind with no saved sheet, add one line: "This kind
884
+ prints no price, so I can't check your $<limit> before the yes." There, when
885
+ the template offered One-take UGC for this ad ("Also fits their ad: …"), its
886
+ option's description says it prints a price before its start, held to its "at
887
+ most". The Director block of `exodus video status` prints "Spent: $… of
888
+ $12.00": the $12.00 is the Director's limit for its redos on that video, not
889
+ a price and not a ceiling for the first pass. Never quote it as the cost.
890
+ - **Product.** Ask the product only when `swipe products` lists more than one
891
+ and the member named none. With one, write for that one.
669
892
  - **Anything else.** Add a row only when the member's ask carried a note. A
670
893
  note that names what to swipe (hook only, their format with their own
671
894
  script, a new look) sets `--mode` (step 4), and **My picks** says the mode
672
- back. Say back any other note as noted, not used yet.
673
- - **Several ads.** One sheet covers every ad the member named: list what you
674
- read from each in the first line. The count and the warning above 6 hold.
895
+ back. So does the plan. Say back any other note in one line, as noted, not
896
+ used yet.
675
897
 
676
- **The videos, in a fixed order.** List them one per line: the ads in the
898
+ **The videos, in a fixed order.** List them in this order: the ads in the
677
899
  order the member gave them, and for each ad the personas in the order the
678
900
  sheet shows them. The same picks give the same list.
679
901
 
680
- **A bare number.** Read a reply of only a number ("3") as the count of
681
- videos, and say so in the list's first line: "I read 3 as 3 videos." Pick
682
- one video for each ad, in the order given, before a second persona for any
683
- ad; then the next persona in the order shown for each ad, and so on, until
684
- the count is reached. List the videos in the fixed order and wait for the
685
- yes. When the picks cannot make that many, say how many they can make.
902
+ **A bare number.** After a numbered list of options (rule 3's fallback), a
903
+ number picks that option, as a press does. Anywhere else, read a reply of only
904
+ a number ("3") as the count of videos, and say so in the list's first line: "I
905
+ read 3 as 3 videos." Pick one video for each ad, in the order given, before a
906
+ second persona for any ad; then the next persona in the order shown for each
907
+ ad, and so on, until the count is reached. List the videos in the fixed order
908
+ and wait for the yes. When the picks cannot make that many, say how many they
909
+ can make.
686
910
 
687
911
  When the member says "just do it": no persona, the primer's lead mechanism
688
912
  (noted, not used yet), closeness 2, the tool picks the characters, one shot,
@@ -691,21 +915,154 @@ no music. With more than one product and none named, ask that one row first.
691
915
  ### 4. On the yes
692
916
 
693
917
  The yes covers the writes and the starts, and the bot calls when step 5
694
- applies; nothing else. The breakdown and the template are once per ad, and
695
- are done already.
696
-
697
- **The saved sheet** changes this for a kind that has one (One-take UGC
698
- today): the yes of step 3 covers its writes, and its starts wait for one more
699
- yes. Run step 1 for every such video first. Then read each one's saved sheet
700
- with `exodus video swipe sheet <swipeId>` (free) and show them one time,
701
- together in one message: their rows, and the swipe's dashboard page each
702
- prints (that page does not show the saved sheet yet). Ask one yes for all
703
- their starts, then run step 2 for each. A reply that only changes a row is
704
- not that yes: set it with `exodus video swipe sheet set <swipeId>
705
- notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
706
- and ask the yes again. Say a row marked "no step reads it yet" as saved, not
707
- used. The start copies the saved sheet into the video; a change after it is
708
- for the next video.
918
+ applies; nothing else (the read is done).
919
+
920
+ **The saved sheet** (step 3's row) changes this: the yes of step 3 covers its
921
+ writes, and its starts wait for one more yes. Run step 1 for every such video
922
+ first. Then read each one's saved sheet and its price, both free (`exodus
923
+ video swipe sheet <swipeId>` and `exodus video swipe sheet price <swipeId>`),
924
+ and send one reply for all their starts, its message as text first (rule 2):
925
+
926
+ > Script ready: <n> lines, <k> takes. Say "show sheet", "show script" or "why"
927
+
928
+ Its question (`AskUserQuestion`, header "Film it?"), its text:
929
+
930
+ > It opens: "<its first line>". (several videos: one line for all, each video's number, first words and person, and no Person line)
931
+ > Person: <name>, the recommended one of <k> | a new person cast from their speaker's type (or the words the write names), none of the <k> made · Voice: <name><, not <accent> like their speaker: "Change something" picks another> (Person only when the sheet has people, Voice only with a `voice` row; "not <accent>" only when `status --full`'s Cast names their speaker's accent and the voice row's reason, or the voice's name as `sheet voices` prints it, shows another or none)
932
+ > Spent so far: $<X> on the team's keys for reading their ad, $<W> on yours (the template, on your model key: not printed). Film it?
933
+
934
+ Its options: 1. Film it (the table), its figures from the price's "Price:"
935
+ line 2. Show me the script and the <k> people 3. Change something: person,
936
+ voice, size, how it is filmed, their look 4. Stop.
937
+
938
+ With several videos, the label says how many and the description each one's
939
+ price as printed, never their sum. Each start's `--max-usd`, and each write's
940
+ `--people-max-usd`, is that video's own printed "at most", never a sum. "show sheet" prints each saved sheet's rows
941
+ (with each person made, their picture's address, and the one recommended, when
942
+ the sheet shows them) and the swipe's dashboard page each prints, whose
943
+ Pre-production card on Your version shows the same picks: a change made there
944
+ is to this same saved sheet, so read it and its price again. A press of "Film
945
+ it", or a typed yes to it, is the one yes for all their starts: run step 2 for
946
+ each. A reply that only changes a row is not that yes: set it with `exodus
947
+ video swipe sheet set <swipeId> notes="<words>"` (free; `<row>=` clears a row),
948
+ read the price again, say the change in one line, and ask again. Say a row
949
+ marked "no step reads it yet" as saved, not used. The start copies the saved
950
+ sheet into the video; a change after it is for the next video.
951
+
952
+ **Recommended rows.** A row may print `recommended:` and a reason ("why" gives
953
+ it): today `who`, `voice`, `prop` (what the person holds), `hookKind` and
954
+ `headline`. "Let it run" here, said in reply to these saved sheets and their
955
+ prices, is the yes to the starts with the sheets as they stand: set nothing (a
956
+ size a money limit needs is set before the sheets are shown, below), since a
957
+ start with no pick films every recommended value and every other row's default.
958
+ A "let it run" said before them, as in the first message, is not this yes: the
959
+ writes went on the yes to step 3's sheet, and the starts wait for a reply to
960
+ these. A member's pick wins (the row then reads `from you:`); `<row>=` clears
961
+ it, back to the recommended value or default. `prop=none` holds nothing through
962
+ the video (it prints `prop: none (nothing held through the video)`), though a
963
+ take may still pick up a small thing for a moment, such as a mug or a drink;
964
+ `prop=` takes it back to its default.
965
+
966
+ `who` is the person filmed: a person made for the swipe, by number
967
+ (`who=<n>`), or words in the row's own form, as `who="a white woman in her
968
+ 30s, grey hoodie"`. A row with no value at all prints "not set": then the
969
+ script decides.
970
+ **Their look.** When the member wants the person to look like their speaker
971
+ ("make her look like the woman in their ad", closer to, the same as), the row
972
+ is "How close to their speaker" (`basedOn`): `type`, the default (a new person
973
+ of their speaker's type), or `look`: new people who also have their speaker's
974
+ hair, clothes, nails, skin tone, brows, makeup, freckles and build, read from
975
+ their ad in our words, never their face, a name, a tattoo, a scar or a
976
+ birthmark. Their age stays the type's. Never write `who` by hand for this.
977
+ `exodus video swipe sheet set <swipeId> basedOn=look` with no `--yes` buys
978
+ nothing: it prints the price (one read of their speaker's look on the member's
979
+ OpenRouter key, then 4 new people and the check of their faces) and the line
980
+ that says yes. Ask it as a question whose option carries that price ("Their
981
+ look · about $…, at most $…", the table); only on its yes run it with `--yes
982
+ --people-max-usd <the most it showed>`, then read the sheet a few minutes
983
+ later and show the people made from it. `basedOn=type` goes back, free. When
984
+ the row offers only `type`, it says why (no OpenRouter key, a well-known or
985
+ named speaker, their ad's video not kept, a read that failed): say that reason
986
+ and do not work around it. A sheet with no `basedOn` row has no such choice
987
+ for this swipe: say so, and keep `who`. `filmed`, `pose`, `prop`, `moves`,
988
+ `place`, `look`, `time`, `placeNote` (how and where it is filmed), `hook`
989
+ (take 1's opening action, `off` or a level from 1 to 5, 2 the usual) and
990
+ `hookKind` (its kind, `any` or one the row lists) each carry their default's
991
+ reason: set one only when the member asks (`time=dusk`, `hook=3`). `notes` end
992
+ every take's prompt. With the hook on, the board asks the hook director for
993
+ the opening: one text call on the member's model key, which the price names
994
+ among what it leaves out. `headline` is the text card at the start: `none`, or
995
+ the member's own words for it (one short line; a refusal says what fits). The
996
+ screen's price is `exodus video swipe sheet price <swipeId>` (free) at the
997
+ sheet's rows, with the most it can cost; the option's description ends with
998
+ what it leaves out, shortened (the table's "Film it?" row). "why" gives each
999
+ line of the price. A 480p draft or the first take only is a row the member
1000
+ sets (`size=480p`, `takes=first`) when the price lists them; read the price
1001
+ again after a set. The first take only is a cheap check of the method and the
1002
+ size, not of the final person: the whole video after it is a second start,
1003
+ paid on its own (`takes=all`, then `swipe start <swipeId> --again`), and it
1004
+ casts the person and draws the pictures again. Say so before that yes.
1005
+ **A money limit.** When the member gave one ("keep the whole thing under
1006
+ $15"), hold it before the start: add the people's most when the dry write
1007
+ printed one (its "At most $… in all"), what the write cost when the limit is
1008
+ for everything, and the start's "at most" (never its "about": a take filmed
1009
+ again is paid again), and compare the sum with the limit. The text calls the
1010
+ price leaves out are in no figure: say so, and leave room for them. Over it,
1011
+ nothing starts. When a smaller size the price lists fits (its whole video,
1012
+ every take, and the start does not refuse it), set it before you show the
1013
+ saved sheets (`exodus video swipe sheet set <swipeId> size=480p`, free), read
1014
+ the price again, and say on the sheet in one line that it is a 480p draft, the
1015
+ size that fits their limit: their yes to that sheet is the yes to it. A limit
1016
+ given after they saw the sheets: name the 480p draft and wait for their yes.
1017
+ With a money limit and no "at most" printed, the limit cannot be checked: stop
1018
+ and ask. For example, with a limit for everything: when the write's cost, the
1019
+ people's most and 720p's "at most" add up to more than the limit, and the same
1020
+ sum with 480p's "at most" is under it, set 480p. Every figure in that sum is
1021
+ the one the CLI printed for this swipe, never one from memory. When no size
1022
+ fits, stop and ask; when the price lists the first take only (`takes=first`),
1023
+ you may name it as a smaller thing they can choose, never as the whole video.
1024
+ The `--max-usd` you start with is the "at most" the price shows, so it is
1025
+ never above what is left of the member's limit.
1026
+
1027
+ **A video that reached its estimate.** A regular video (not One-take) keeps
1028
+ the estimate it showed before the start. When its next take would cost more
1029
+ than that, it stops before ordering it and waits for the member. `exodus
1030
+ video status` then prints a line that starts "Waiting for you:", with what
1031
+ the video has cost so far, its estimate, what it wants to film next and
1032
+ about what that costs, and under it two commands: `exodus video keep-going
1033
+ <runId>` and `exodus video stop-here <runId>`. That choice is the member's,
1034
+ never yours: show them that line word for word, and run the command they
1035
+ pick only after they answer. A money limit they gave you, or a `--max-usd`,
1036
+ does not answer it for them. Nothing is paid while it waits, and it waits
1037
+ until they answer. Keep going films on and asks again if it passes the next
1038
+ whole estimate. Stop here orders nothing more: each scene keeps the clip it
1039
+ has, and a scene with none is named; status says what was kept.
1040
+
1041
+ A write that carried the people's most makes the first people to pick from
1042
+ (People, step 3). Offer more people, or voices to pick from, only when the
1043
+ member asks for options. More people are paid on the member's keys: run
1044
+ `exodus video swipe sheet people <swipeId> --count <n>` first (no `--yes`),
1045
+ put the price it prints in the option, and after the yes run the line it
1046
+ prints (`--yes --max-usd <n>`, the most the price said). Do not add
1047
+ `--wait`: it can wait up to 45 minutes. Read the sheet a few minutes later and
1048
+ show each person's name and picture address. A sheet with a `voice` row
1049
+ (there only while the server offers people and voices to pick from) has its
1050
+ voices listed once by the server after the write (when the member has an
1051
+ ElevenLabs key), and the row may recommend one and say why: a voice that fits
1052
+ the person, which may skip a voice the brand's recent swipes already have, so
1053
+ its videos don't all sound the same. A sheet with no `voice` row has no voices to pick from: say nothing
1054
+ about them. `exodus video swipe sheet voices <swipeId>` lists them again: one
1055
+ read of the voice list on the member's ElevenLabs key, and no speech is made,
1056
+ so it buys nothing. It prints the voices that fit the person, best fit first,
1057
+ each with its age and accent when known ("Sarah · young · American") and a
1058
+ sample to hear, then "Recommended: <n> (…). <why> A start with no pick films
1059
+ it."; after the member's pick, "Recommended: <n> (…). You picked it, so a
1060
+ start films it." or "… You picked <m>, so a start films your pick."; or why
1061
+ none is. A voice row with no voice prints "List the voices: exodus video swipe
1062
+ sheet voices <swipeId>". A pick is a set (`who=<n>`, `voice=<n>`), and the
1063
+ video is filmed with that person, their face and that voice. If the server
1064
+ says these choices are not switched on yet, say so and go on with the sheet as
1065
+ it is.
709
1066
 
710
1067
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
711
1068
  every video has started:
@@ -713,29 +1070,84 @@ every video has started:
713
1070
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
714
1071
  --closeness <n> --yes`. A mode set from a note changes the line:
715
1072
  `hook-only` takes `--closeness` as `whole-ad` does. `their-format` takes
716
- the member's own script: save it to a file and pass `--script <file>`,
717
- with no `--closeness` (the CLI refuses one). `new-look` takes `--look
718
- <slug>`; no command lists the looks a swipe can take, so ask the member
719
- for the exact look name and never invent one (the writer refuses a look
720
- it does not make). When step 5 applies, its write line takes the place of
721
- this one. The write takes four to nine minutes. Show the member the
722
- script, the direction, Kept and Changed, and what it cost. When a persona
723
- or a mechanism was picked and step 5 does not apply, add one line: "The
724
- persona and the mechanism are noted, not used: the video writer does not
725
- read them yet."
726
- The write's last line says "Start the video (paid; ask first)": the
727
- sheet's yes was that ask, so start now, with the line below, not the
728
- write's own, which leaves out `--one-shot`. For a kind with a saved
729
- sheet, that ask is the saved sheet's yes instead: start after it. Note the
730
- swipe id it printed for that video.
731
- 2. `exodus video swipe start <swipeId> --one-shot --yes`, without
732
- `--one-shot` when the member chose to stop at the storyboard, and with
733
- `--music` when they chose music. Give the member the `Watch it:` link at
734
- once. Then go on to the next video.
735
- 3. When every video has started, follow each run with `exodus video status
736
- <runId>` and do what it prints. A one-shot run that waits for a cut goes
737
- to "End: watch and approve" (pull, cut, upload, the run page). A run that
738
- stopped at the storyboard goes to stop 3, then the end.
1073
+ the member's own script: save it to a file and pass `--script <file>`, with
1074
+ no `--closeness` (the CLI refuses one). `new-look` takes `--look <slug>`;
1075
+ no command lists the looks a swipe can take, so ask the member for the
1076
+ exact look name and never invent one (the writer refuses a look it does not
1077
+ make). When step 5 applies, its write line takes the place of this one. The
1078
+ write takes four to nine minutes: say so in one line. When it is done, one
1079
+ line: the script's opening and what it cost ("show script" gives the
1080
+ script, the direction, Kept and Changed). When the member picked a persona
1081
+ or a mechanism and step 5 does not apply, add one line: "The persona and
1082
+ the mechanism are noted, not used: the video writer does not read them
1083
+ yet." For a kind whose write makes people (People, step 3), run the yes
1084
+ line the dry write printed (`--yes --people-max-usd <most>`), or `--yes
1085
+ --no-people` when the member wants none; a plain `--yes` makes none, and
1086
+ says so. With the figure, the write waits up to 5 minutes for the people,
1087
+ then prints each with their picture's address and whom a start with no pick
1088
+ films: the one it recommends, or a new person cast from their speaker's
1089
+ type, not one of these (tell the member; set `who=<n>` only on their word;
1090
+ never assume one is recommended). When none were made it says so, that
1091
+ nothing was paid for them, and how to ask for them (the price first, free).
1092
+ After the 5 minutes the write is done: read the sheet a few minutes later.
1093
+ The animal, when the script has one, is on the saved sheet's row "The
1094
+ animal" a few minutes later, with its picture's address; a start waits for
1095
+ it. For One-take UGC the write may also write our own text card and pick a
1096
+ kind of opening (`headline`, `hookKind`, marked recommended); when Changed
1097
+ ends "We left out the text card we wrote: …" or "We left out the kind of
1098
+ opening we picked: …", tell the member in one line: they may write their
1099
+ own card (`headline="<words>"`), set `hookKind` to a kind the row lists, or
1100
+ leave it. The write's last line says "Start the video (paid; ask first)":
1101
+ the sheet's yes was that ask, so start now, with the line below, not the
1102
+ write's own, which leaves out `--one-shot`. For a kind with a saved sheet,
1103
+ that ask is the saved sheet's yes instead: start after it. Note the swipe
1104
+ id it printed for that video.
1105
+ 2. `exodus video swipe start <swipeId> --one-shot --yes`, without `--one-shot`
1106
+ when the member chose to stop at the storyboard, and with `--music` when
1107
+ they chose music. For a kind with a saved sheet whose price printed a
1108
+ number, add `--max-usd <n>` with the "at most" it showed: a start that can
1109
+ now cost more is refused, and nothing is started. With a money limit, start
1110
+ only once that "at most" fits what is left of it ("A money limit", above).
1111
+ No number printed: no `--max-usd`, and never a guessed one. When the sheet
1112
+ has people, the start says first whom it films. Give the member the `Watch
1113
+ it:` link in one line, at once. Then go on to the next video.
1114
+ 3. When every video has started, wait on each run in the background with
1115
+ `exodus video wait <runId>`, each in its own command, and say one line:
1116
+ "Filming <n> videos · I'll tell you when each is delivered or needs you."
1117
+ When a wait ends, read `exodus video status <runId>` once and do what it
1118
+ prints. The app makes a swiped video's cut ("End: watch and approve"), so
1119
+ make no cut of your own. A run that stopped at the storyboard goes to stop
1120
+ 3, then the end, which asks the final approve. A one-shot video is
1121
+ delivered by itself once the app's cut is made, with no final approve,
1122
+ unless the film's check against its own sound fails ("End: watch and
1123
+ approve").
1124
+
1125
+ **A stop that needs the member** (a check found a problem, a held take, a
1126
+ refused write or start) is two lines and a question, offering only the ways
1127
+ that `status`, the hold's own sentence or the refusal names: the free look
1128
+ first, a free way marked "free", a paid way with the price the CLI printed for
1129
+ it (`sheet price` before a new run with `--again`) or "no printed price". A
1130
+ new run keeps none of the first start's flags: give `--one-shot` and `--music`
1131
+ again when the first had them. Its message, as text first (rule 2):
1132
+
1133
+ > Stopped for you. <each cost line the stopped step printed, as printed, if any: "It cost $<X> on the member's key."> Say "why"
1134
+
1135
+ Its question (`AskUserQuestion`, header "What now?"), its text:
1136
+
1137
+ > <what happened, in plain words>. <what is still good>.
1138
+ > Spent $<X> of about $<Y> (or rule 5's other forms). What now?
1139
+
1140
+ Its options: 1. the free look ("Watch take 2 first") 2. a free way on ("Keep
1141
+ it · free") 3. a paid way on, as the table's "A hold" or "A refused write" row.
1142
+
1143
+ **Delivered** is three lines, the money line last:
1144
+
1145
+ > Done. <the run page, or the file `pull` wrote>.
1146
+ > Listen once: <a word `status` flags, or the product's name>.
1147
+ > Spent $<X> of about $<Y> for the film (or rule 5's other forms); before it, <the last money line's figures, each with whose keys>
1148
+
1149
+ With several videos, one line a video: its ad and persona, its `Watch it:`
1150
+ link and its money, or why it stopped.
739
1151
 
740
1152
  **Never start the same swipe twice.** One swipe is one video. A start of a
741
1153
  swipe that already has a video is refused, starts nothing, and names the run:
@@ -750,19 +1162,48 @@ noted none), with no run and not marked refused, is that write. Show it with
750
1162
  row marked refused is that write's refusal: report it as a refused write. When
751
1163
  no such row is there yet, the write may still finish: check again later.
752
1164
 
753
- At the end, report each video on one line: its ad and persona, its run id
754
- and its `Watch it:` link, or why it stopped.
755
-
756
- **The final approve** is asked for each video as at "End: watch and
757
- approve". It is one way. A redo of a clip there needs its own yes.
758
-
759
1165
  **A refusal or a failed check stops that video only.** The others go on, and
760
- every video is in the report at the end. A refused write prints the writer's
761
- sentence, its swipe id, what it cost, and "Nothing was started.": report all
762
- of it for that video. Writing again is paid again and needs the member's
763
- word. A refused start prints its sentence: report it for that video. A
764
- one-shot run whose checks find a problem stops for the member: show what
765
- `status` prints and ask.
1166
+ every video is in the report at the end. A refused write prints "The writer
1167
+ refused:" and its sentence (on an admin key, then "What the checks found:"),
1168
+ its swipe id, what it cost, "Nothing was started." and "Writing again is paid
1169
+ too: the same exodus video swipe write line, after the member's yes.". Report
1170
+ it as a stop that needs the member (above), with the ways on its sentence ends
1171
+ with.
1172
+
1173
+ A refusal for claims reads "Your product sheet doesn't back up …" and names up
1174
+ to two held lines, each with why in brackets (not found on the sheet, a hedge
1175
+ kept, the product named next to a line taken out, a shot that shows a result);
1176
+ more end "and N more (the dashboard lists every one)". The ways on, by how it
1177
+ ends:
1178
+
1179
+ - "If it's true, add the line's own words to your product's description (on
1180
+ the dashboard: Library, Materials, Brand info, then the product's Edit),
1181
+ then write again." (or "If a line is true, …", "If a spoken line whose claim
1182
+ we couldn't find on the sheet is true, …", or the same for "a price or code
1183
+ your product sheet doesn't list"): ask the member whether it is true of
1184
+ their product. Only if it is, they add its own words there; then, on their
1185
+ yes, run the same write line again.
1186
+ - "Write again." alone: no held line can be backed by the description: on the
1187
+ member's yes, run the same write line again.
1188
+ - "The script we wrote left out …, and at closeness … every beat stays. …":
1189
+ the member adds what that beat can say to the product's description, or
1190
+ picks closeness 4 or 5, where beats can merge or drop; then write again on
1191
+ their yes.
1192
+ - "Your script says "…", from their ad or a price or code your product sheet
1193
+ doesn't list. We never change your words, so take it out, then try again.":
1194
+ they take those words out of their own script; write again on their yes.
1195
+ - Any other sentence: say it as it is, and write again only on their yes.
1196
+
1197
+ **Never write around a refusal yourself.** Do not pass the refused script,
1198
+ its held lines, or lines you wrote, to `--mode their-format --script`. The
1199
+ way out is the one the refusal ends with, above.
1200
+
1201
+ A refused start prints its sentence: report it for that video. When it says
1202
+ a row of the sheet "holds words it no longer takes" (what the person holds,
1203
+ for one), nothing was paid: change that row only on the member's word (their
1204
+ new words, or `prop=none`), then start again on their yes. A one-shot run
1205
+ whose checks find a problem stops for the member: show what `status` prints
1206
+ and ask.
766
1207
 
767
1208
  ### 5. With a persona or a mechanism: the text swipe bot
768
1209
 
@@ -801,16 +1242,19 @@ mechanism noted only.
801
1242
 
802
1243
  **On the sheet, when the path is open.**
803
1244
 
804
- - Rows 1 and 2 read "(used through the text swipe bot)" in place of
805
- "(noted; …)".
806
- - Row 3 reads "1 Near-clone, 2 New scene, same beats, 3 Same idea, new
807
- drama, 4 Same arc, 5 Pattern only (with 4 or 5, the persona and the
808
- mechanism are only noted)". Levels 1 to 3 are the `swipe` skill's levels
809
- (its section 2), not the dial's: say so when the member asks. A video the
810
- bot does not write takes the same number as its `--closeness`.
811
- - **It buys** adds, when the picks give the bot any video: "and a text swipe
812
- call for each video (two at level 2 or 3), on your own Genesis and model
813
- keys." When only some videos take it, name them ("for videos 1 and 3").
1245
+ - On "show sheet" and in "Change something", rows 1 and 2 read "(used through
1246
+ the text swipe bot)" in place of "(noted; …)".
1247
+ - On "show sheet" and in "Change something", row 3 reads "1 Near-clone, 2 New
1248
+ scene, same beats, 3 Same idea, new drama, 4 Same arc, 5 Pattern only (with
1249
+ 4 or 5, the persona and the mechanism are only noted)". Levels 1 to 3 are
1250
+ the `swipe` skill's levels (its section 2), not the dial's: say so when the
1251
+ member asks. A video the bot does not write takes the same number as its
1252
+ `--closeness`.
1253
+ - The spending option's description adds, when the picks give the bot any
1254
+ video: "Plus a text swipe call for each video (two at level 2 or 3), on your
1255
+ own Genesis and model keys, no printed price." When only some videos take
1256
+ it, name them ("for videos 1 and 3"). **It buys** on "show sheet" says the
1257
+ same.
814
1258
  - A reply that adds bot calls makes the buy bigger, so it is not the yes: a
815
1259
  persona or a mechanism added where the sheet had none, or, while a persona
816
1260
  or a mechanism is picked, how close moved from 1 to 2 or 3, or from 4 or 5
@@ -881,19 +1325,19 @@ say; a result beyond them needs a product fact.
881
1325
  "the #1").
882
1326
 
883
1327
  When a picked persona or mechanism is missing, or a line promises something
884
- the product's facts do not hold (a result, a health benefit, a number), do
885
- not start that video: show the member that line and ask. The other videos go
886
- on. Show each such line with the fact it would need, and offer three ways
887
- on: start it as written, leave that video out, or the member's own words for
888
- those lines, written again with `--mode their-format --script <file>` (a
889
- second paid write, on their word) and checked again. This is the one stop
890
- this path adds, and it comes only when the check finds something. The write
891
- may still refuse a name, price or code from their ad, or a cast the kind of
892
- ad cannot take (more speakers than it holds, or speakers where it takes a
893
- narrator only): a refused write stops that video only, as above. A write
894
- whose wait was cut off and is found again with `exodus video swipe show
895
- <swipeId>` (as "On the yes" says) gets this check too, on the script `show`
896
- prints, before its start.
1328
+ the product's facts do not hold (a result, a health benefit, a number), do not
1329
+ start that video: show the member that line and ask. The other videos go on.
1330
+ Show each such line with the fact it would need, and offer three ways on:
1331
+ start it as written, leave that video out, or the member's own words for those
1332
+ lines, written again with `--mode their-format --script <file>` (a second paid
1333
+ write, on their word) and checked again. Ask it as step 4's stop that needs
1334
+ the member. This is the one stop this path adds, and it comes only when the
1335
+ check finds something. The write may still refuse a name, price or code from
1336
+ their ad, or a cast the kind of ad cannot take (more speakers than it holds,
1337
+ or speakers where it takes a narrator only): a refused write stops that video
1338
+ only, as above. A write whose wait was cut off and is found again with `exodus
1339
+ video swipe show <swipeId>` (as "On the yes" says) gets this check too, on the
1340
+ script `show` prints, before its start.
897
1341
 
898
1342
  **Run so far.** Levels 1 and 2 of this path have been run for real, as far
899
1343
  as the write. Level 3 has not.
@@ -919,60 +1363,42 @@ noted only.
919
1363
 
920
1364
  ### Step by step: a yes before each paid step
921
1365
 
922
- For a member who asks for stops. Four steps cost money, and the CLI prints no
923
- price for any of them. Run each one first without `--yes`: it sends nothing
924
- and prints what the step buys and who pays. Tell the member both, say the CLI
925
- prints no price, never guess one, and run the same line with `--yes` only
926
- after their yes.
927
-
928
- 1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
929
- Instagram or YouTube), or a video ad in the brand's swipe library by the
930
- id that `exodus video swipe find` prints (free):
931
- `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId>`.
932
- The breakdown is paid on the team's keys, not the member's. A link or an
933
- ad this brand broke down before comes back at once and costs nothing.
934
- With `--wait` it prints each step as it starts, and takes a few minutes.
935
- Once it is done, `exodus video swipe status <breakdownId> --full` prints
936
- what Exodus read from the ad: each shot with its cut times, a-roll or
937
- cutaway, framing, camera and description, then the script with who says
938
- each line, then the cast. It is free. Show the member the shot list and
939
- the script before the template, so they can say whether Exodus read their
940
- ad right.
941
- 2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
942
- member's own Anthropic or OpenRouter key. It prints the kind of ad and the
943
- look the ad matched, and why. A template made before costs nothing. Show
944
- the member the kind and the look. The swipe writes that kind and no other.
945
- If the member wants another kind, stop here and make the video from that
946
- format with the ad's words instead ("From one sentence to a film").
947
- 3. **The choices.** `exodus video swipe products` lists the brand's
948
- products. Ask which product, what to swipe and how close. What to swipe
949
- (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
950
- script (`--script <file>`, the member's own words), or Their script, a new
951
- look (`--look <slug>`). How close (`--closeness`, 2 if left off): 1 Mirror,
952
- 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
953
- has each one's line.
954
- 4. **The write.** `exodus video swipe write <breakdownId> --product <id>
955
- [--mode …] [--closeness …]`, paid on the member's own key. It takes four
956
- to nine minutes and waits by itself. Show the member the script, the
957
- direction, Kept and Changed, and what it cost. A refusal prints the
958
- writer's sentence and "Nothing was started.": tell the member, and offer to
959
- write again, which is paid too. If the wait gives up, the write may still
960
- finish: run `exodus video swipe list` before writing again. It shows the
961
- brand's newest swipes, and a refused one is marked with what it cost.
962
- 5. **The start.** `exodus video swipe start <swipeId>`. It buys the
963
- storyboard and its pictures; the voices and clips wait for the storyboard's
964
- yes. `--style <look>` changes the look, `--music` adds a music bed.
965
- `--title "<name>"` names the ad, for admins only: a beta tester leaves it
966
- off, or the CLI refuses it with one sentence naming it. With `--one-shot`
967
- it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
968
- member. A swipe that already has a video is refused, with its run; a
969
- second video from it needs `--again` and the member's yes to a second video.
970
- For a kind with a saved sheet (One-take UGC today), show the saved sheet
971
- one time before this start, as in step 4 (`exodus video swipe sheet
972
- <swipeId>`, free), in the same message as what the start buys and who
973
- pays (the line without `--yes`). On this path the saved sheet's yes is
974
- the start's yes: ask once, then run the line with `--yes`. A reply that
975
- only changes a row is not that yes.
1366
+ For a member who asks for stops: the steps above, with one question before
1367
+ each of the four paid steps (the read of an ad, its template, the write, the
1368
+ start) in place of one yes for all. Run each one first without `--yes` (it
1369
+ sends nothing), put what it prints in the option (the table's "Step by step"
1370
+ row), and run the same line with `--yes` only after their yes.
1371
+
1372
+ 1. **Get the ad.** Step 1's breakdown line for one ad, first without `--yes`,
1373
+ then asked ("without asking" does not hold here): a video file, a link
1374
+ (Meta Ad Library, TikTok, Instagram or YouTube), or a video ad in the
1375
+ brand's swipe library by the id that `exodus video swipe find` prints
1376
+ (free). Then show the shot list and the script (`status --full`, free), so
1377
+ the member can say whether Exodus read their ad right. In "How it is
1378
+ filmed", every line but Measured, Cuts and Words is the video model's
1379
+ reading by eye, often wrong (the camera height was right 2 times in 9 in
1380
+ Exodus's checks): say those as what Exodus thinks it saw. Cuts counts jump
1381
+ cuts the model saw too; Measured does not prove the phone was put down.
1382
+ 2. **The template.** Step 1's template line, first without `--yes`, then
1383
+ asked. Show the kind, the look, why, and the "Also fits their ad: …" line
1384
+ when it prints one (the One-take UGC row of step 3). The swipe writes the
1385
+ kind it was matched to, or another named with `--kind` on the member's yes.
1386
+ For a kind this ad can't be made as (step 3's "The kind of ad"), stop here
1387
+ and make the video from that format with the ad's words ("From one sentence
1388
+ to a film").
1389
+ 3. **The choices**, as questions: the product, what to swipe (`--mode`, as
1390
+ step 4's write line says) and how close (`--closeness`, 2 if left off).
1391
+ 4. **The write.** Step 4's write line: its people's price goes in the option
1392
+ when the line without `--yes` prints one, and their yes line is the one it
1393
+ prints.
1394
+ 5. **The start.** `exodus video swipe start <swipeId>` buys the storyboard and
1395
+ its pictures; the voices and clips wait for the storyboard's yes. With
1396
+ `--one-shot` it buys the whole video with no stop: ask before passing it.
1397
+ `--style <look>` changes the look, `--music` adds a music bed, and `--wait`
1398
+ waits until the run needs the member. `--title "<name>"` names the ad, for
1399
+ admins only: a beta tester leaves it off, or the CLI refuses it with one
1400
+ sentence naming it. For a kind with a saved sheet, its question (step 4) is
1401
+ the start's question, with the `--max-usd <n>` the line printed.
976
1402
  6. **Then** stop 3 (the storyboard) and the end, as above.
977
1403
 
978
1404
  ### Every swipe command
@@ -980,22 +1406,27 @@ after their yes.
980
1406
  ```operator-guide
981
1407
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
982
1408
  break the ad down (team's keys); one read before costs nothing
983
- exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
984
- --full adds what it read: shots, script, cast
1409
+ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands; --full: shots, script, cast, filming
985
1410
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
986
1411
  exodus video swipe products the brand's products and their ids
987
- exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
988
- the brand's version (member's key); waits for it
1412
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes [--people-max-usd <n>]] [--no-people]
1413
+ the brand's version (member's key); without --yes, its people's price
989
1414
  exodus video swipe show <swipeId> one swipe again
990
- exodus video swipe list the brand's newest swipes, each with when it was written and its product;
991
- a refused one shows what it cost
1415
+ exodus video swipe list the brand's newest swipes, when written, product, a refusal's cost
992
1416
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
993
- exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait]
994
- start the run on the kind the swipe wrote; --again for a
995
- second, paid video of a swipe that already has one
996
- exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
997
- no dashboard page shows it yet
1417
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
1418
+ the run on the kind the swipe wrote; --again: a second, paid video
1419
+ exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free)
998
1420
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1421
+ exodus video swipe sheet set <swipeId> basedOn=look --yes --people-max-usd <n>
1422
+ their look: run it first without --yes for its price
1423
+ exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1424
+ exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1425
+ new people to pick from (member's keys; the price first); who=<n> picks one
1426
+ exodus video swipe sheet voices <swipeId> the voices that fit the person, best fit first, each with its
1427
+ sample (and its age and accent when known), and the one the
1428
+ row recommends, if any: one read of the voice list on the
1429
+ member's ElevenLabs key, no speech; voice=<n> picks one
999
1430
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
1000
1431
  ```
1001
1432
 
@@ -1033,21 +1464,28 @@ CLI words it the way the run page does. On their own brands they can:
1033
1464
  file"). `--stop-at-script` prints that script and starts nothing.
1034
1465
  - `video status <runId>`: where the video is, in plain words (waiting in line,
1035
1466
  planning, drawing, storyboard ready for review, filming, ready with its link,
1036
- held for a scene they must make again or keep as it is on the video's page,
1037
- or stopped and why). `--json` prints the server's answer as it came; a held
1038
- video says `"stage": "failed"` with the held scenes in `cutHolds`.
1467
+ held for a scene they must make again or keep as it is, or stopped and why).
1468
+ `--json` prints the server's answer as it came; a held video says
1469
+ `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1470
+ also sends `cutHeldScenes` (each held scene's number and its sentence).
1471
+ - `video wait <runId>`: reads the video until it stops for them, is ready
1472
+ or stops, then prints where it stands and its page.
1039
1473
  - `video storyboard <runId>`: each scene's line and picture, while the
1040
1474
  storyboard waits for review.
1041
1475
  - `video approve <runId>`: approves the storyboard. At an audition stop,
1042
1476
  `video approve <runId> --audition <digest>` accepts the audition clips, and
1043
1477
  plain `video approve <runId>` pays for another try of the failed audition
1044
- takes ("The audition stop"). Nothing else.
1478
+ takes ("The audition stop"). When their finished video waits for them
1479
+ ("finish it"), `video approve <runId>` finishes it, as "End: watch and
1480
+ approve" says. Nothing else.
1045
1481
  - `video voices <runId>`: who speaks, their current voice, and the voices on
1046
1482
  the tester's own ElevenLabs account. `--set <character>=<voiceId>` picks one,
1047
1483
  until the storyboard is approved.
1048
1484
  - `video retry-frame <runId> --scene <n>`: redraws one scene's picture while
1049
1485
  the storyboard waits. No `--node`; the server finds the step.
1050
- - `video pull <runId> --out <dir>`: the finished video (`video.<ext>`), each
1486
+ - `video pull <runId> --out <dir>`: the finished video (`video.<ext>`) once
1487
+ it is ready (until then it says "The finished video isn't ready yet, so
1488
+ only the scene pieces came down."), each
1051
1489
  scene's clip (`scene-NN.<ext>`) and voice (`scene-NN.voice.<ext>`), and the
1052
1490
  music (`music.<ext>`), with a `manifest.json` holding only `runId`,
1053
1491
  `pulledAt`, `dashboardUrl`, `scenes` (`index`, `clip`, `voice`), `music` and
@@ -1055,6 +1493,9 @@ CLI words it the way the run page does. On their own brands they can:
1055
1493
  handover" below applies to them.
1056
1494
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
1057
1495
  to watch it on.
1496
+ - `video keep <runId> --scene <n>`: keeps a held scene's clip as it is, as
1497
+ "Use scene N as-is" on the video's page does, after their yes. It orders
1498
+ nothing; keeping the last held scene starts the cut.
1058
1499
  - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1059
1500
  which is refused with one sentence naming it. The run it starts answers the
1060
1501
  way start's does.
@@ -1093,6 +1534,11 @@ exodus workflow run <workflowId|name> --input <field>=@script.txt --voices @voic
1093
1534
  exodus workflow run <workflowId|name> --input <field>=@script.txt --voice-treatment @voice-treatment.json --wait
1094
1535
  same, with the video model speaking voices you WROTE
1095
1536
  exodus video status <runId> where it is, per scene
1537
+ exodus video wait <runId> waits until the run stops for the member, fails or is
1538
+ delivered (up to an hour), through the app's cut, and
1539
+ prints where the run stopped and the next step, as the
1540
+ first lines of `status` do; a server that stops
1541
+ answering ends it with exit 2, and the run goes on
1096
1542
  exodus video start --script <file> --conceit <kind> --style <look> [--direction "…"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice native] [--music] [--broll] [--one-shot] [--director] [--stop-at-script] [--rewrite-to-fit] [--wait]
1097
1543
  start from a script and the kinds the server offers.
1098
1544
  The file can be a plain transcript, a draft or a
@@ -1240,6 +1686,12 @@ exodus video pull <runId> --out ./ad-<runId> every piece + manifest
1240
1686
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
1241
1687
  redo one clip at the final watch
1242
1688
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1689
+ exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1690
+ only after the member's yes
1691
+ exodus video keep-going <runId> a video waiting at its estimate films on;
1692
+ only after the member's own yes
1693
+ exodus video stop-here <runId> a video waiting at its estimate orders nothing
1694
+ more; only on the member's own answer
1243
1695
  … make the cut (your choice of tool)
1244
1696
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1245
1697
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1284,16 +1736,67 @@ under it:
1284
1736
  it instead (`stop.missingScenes` in `--json`) and approval is refused until
1285
1737
  it has one. A scene whose picture the video service refused needs
1286
1738
  `retry-frame --note` before `retry-clip`; the clip redo alone resends the
1287
- refused picture. On a video started from the dashboard, the app makes the
1288
- cut itself; when a scene's clip still has a drawing fault after it was made
1739
+ refused picture. On a video the app cuts itself (one started from the
1740
+ dashboard, a swiped video, a beta tester's run: "End: watch and approve"),
1741
+ the app makes the cut. While it makes it, the stop block says "Every piece
1742
+ is made. The app makes the cut now; look again in a minute: exodus video
1743
+ status <runId>" and names no pull, upload or `retry-clip`: read `status`
1744
+ again in a minute. When a scene's clip still has a drawing fault after it was made
1289
1745
  again, the stop block says `Held:` and names the scene
1290
1746
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1291
- made again with `retry-clip`, or kept as it is on the video's page (the
1292
- link it prints). Keeping the last one starts the cut.
1747
+ made again with `retry-clip`, or kept as it is with `exodus video keep
1748
+ <runId> --scene <n>` or on the video's page (the link it prints). Keeping
1749
+ the last one starts the cut.
1750
+ A One-take take held for its words, for a picture that came out turned on
1751
+ its side or upside down, or for a product label that came out backwards and
1752
+ could not be fixed, is named under `Held:` with its own
1753
+ sentence, every reason it was held for (`stop.heldTakes` in `--json`), from
1754
+ the moment the take is made. It
1755
+ cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1756
+ and ask them to watch the take. With their yes, `exodus video keep <runId>
1757
+ --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1758
+ take starts the cut. Otherwise a new run films it again. On a One-shot run
1759
+ that cut is delivered by itself: say so before the last keep.
1760
+ A take held for its label has a sentence that begins "The label check
1761
+ read the product's label as mirror writing in take N", says why it was not
1762
+ fixed (a flip would turn the room around against the other takes, the take
1763
+ could not be flipped, or a second look could not make sure), and ends with
1764
+ its two ways out. Give the member both, in its own words. Keep it, on their
1765
+ yes (`exodus video keep <runId> --scene <n>`), and the film shows the label
1766
+ as it is in the take. Or start a new
1767
+ run, which films every take again at its full price: for a swiped video,
1768
+ `exodus video swipe start <swipeId> --again`, first without `--yes` for its
1769
+ price, then the line it prints, on their yes. The new start keeps none of
1770
+ the first start's flags: give it `--one-shot` and `--music` again when the
1771
+ first had them, in that dry line too (without `--one-shot` it stops at the
1772
+ storyboard).
1293
1773
  - paused: a builder checkpoint neither video verb resolves —
1294
1774
  `exodus workflow checkpoint <runId>` is the verb for that one.
1295
1775
  - failed: `status` shows how far it got, and a `--wait` that was running exits
1296
1776
  1 with the error. Tell the user; do not start another run on your own.
1777
+ Two stops of a One-take run have a way out, each after the user's yes:
1778
+ `exodus workflow repair <runId> retry`.
1779
+ - Kie failed a picture twice (its sentence says "Kie failed it" and what Kie
1780
+ said): the retry orders that picture again, at most twice more. Each
1781
+ order that draws is paid on their Kie key at Kie's price for that
1782
+ picture; an order Kie failed is not counted as paid. When the sentence
1783
+ says instead that a retry stops the same way, the orders may already be
1784
+ paid for: only a new start draws the picture (`exodus video swipe start
1785
+ <swipeId> --again` says its price before it pays for anything).
1786
+ - A picture no retry can order: its sentence says "A retry of this step
1787
+ stops the same way, since those orders may already be paid for. Start
1788
+ the video again instead: …". Do not retry: it stops the same way, and
1789
+ `status` offers no retry for it. From here, the new start of a swiped
1790
+ video is `exodus video swipe start <swipeId> --again`. Run it first
1791
+ without `--yes`: it sends nothing and prints the whole video's price (the
1792
+ pictures, the takes and the text calls are all paid again) and the line
1793
+ to run. Tell the member the price, and run that line only on their yes.
1794
+ The new start keeps none of the first start's flags: give it
1795
+ `--one-shot` and `--music` again when the first had them, in that dry
1796
+ line too (without `--one-shot` it stops at the storyboard).
1797
+ - The connection to the text model dropped twice: the retry asks again and
1798
+ keeps what was already written. The storyboard already asked once more
1799
+ by itself after the first drop.
1297
1800
  When the storyboard is the step that failed, `status` adds a "What happened
1298
1801
  to the storyboard" block: which parts of the plan were accepted, which part
1299
1802
  was turned down, and why (#1902). Relay it as written. On an admin key it may
@@ -1909,7 +2412,10 @@ length. Do not invent a number.
1909
2412
  `pull` writes a flat folder and a `manifest.json` that indexes it. The manifest
1910
2413
  is the data you decide from; the filenames are its values. Scene numbers are the
1911
2414
  run's own. Every `pull` re-downloads and overwrites every file, so running it
1912
- again is always safe.
2415
+ again is always safe. Once the run has a finished video, it writes that too,
2416
+ as `video.<ext>` ("End: watch and approve"), except while the app makes the
2417
+ cut again after a redo: the one on the run then is about to be replaced. When
2418
+ a different `video.<ext>` was already in the folder, it says it replaced it.
1913
2419
 
1914
2420
  ```
1915
2421
  storyboard.json the whole storyboard envelope (see below)
@@ -1924,6 +2430,7 @@ narration.mp3 one continuous narrator take of the whole script
1924
2430
  narration.json that take's settings, master-timeline words, and the
1925
2431
  per-scene ranges it was cut into
1926
2432
  music.<ext> the music bed
2433
+ video.<ext> the finished video, once the run has one
1927
2434
  manifest.json the index below
1928
2435
  ```
1929
2436
 
@@ -2003,6 +2510,8 @@ provenance which saved rulebook this run followed:
2003
2510
  rig is a copy. Names, ids and a version
2004
2511
  only — never the rules themselves
2005
2512
  failed[] files that did not download: {file, url, error}
2513
+ video the finished video's filename; null when it
2514
+ did not download. Absent when the run has none
2006
2515
  ```
2007
2516
 
2008
2517
  ### What each piece is