@aicopycoders/exodus 2026.11.1200-beta.10 → 2026.11.1200-beta.12

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.
@@ -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,10 +357,41 @@ 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.
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. On a run started with `--one-shot` that cut is delivered by itself,
366
+ with no approve: on an admin key `status` then says "Final cut: approved
367
+ and delivered.", and on a beta tester's key "Your video is ready: <link>".
368
+ Only when the app's check of the finished film against its own sound fails
369
+ (One-take UGC checks it) does a One-shot cut wait instead, as a Guided one
370
+ 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
371
+ the last held take, since that keep starts the cut. Say so at each. Give
372
+ the member the run page to watch the film. A run that stopped at the
373
+ storyboard waits for the member instead: on an admin key `status` says
374
+ "Final cut: uploaded. Approve it with: exodus video approve <runId>"; on a
375
+ beta tester's key it says "Your video is ready to watch: <link>" and gives
376
+ the line that finishes it, `exodus video approve <runId>` (the video's page
377
+ finishes it too).
378
+ - **You make the cut** of any other run (an admin's `video start` or
379
+ `workflow run`). When the cut is already uploaded, give the member the run
380
+ page to watch it. When the run waits for a cut: `exodus video pull <runId>
381
+ --out ./ad-<runId>`, make the cut ("Cutting the ad"), `exodus video upload
382
+ <runId> --file <cut.mp4>`, and give the member the run page. On a run
383
+ started with `--one-shot` the upload is delivered by itself, as above.
384
+
385
+ When the cut waits for the member, ask: approve, redo a clip, or stop here.
386
+ On a One-take run no take is made again on its own (every redo door refuses
387
+ it): ask approve, a new run that films every take again at its full price
388
+ (for a swiped video, `exodus video swipe start <swipeId> --again`, its price
389
+ first), or stop here.
390
+
391
+ On an admin key, `pull` writes the pieces only, never the finished video,
392
+ even once the app has made and delivered it: give the member the run page to
393
+ watch it. On a beta tester's key, `pull` also writes `video.<ext>` once the
394
+ finished video is ready.
338
395
 
339
396
  - Approve: `exodus video approve <runId>` makes the cut the ad. It is one-way.
340
397
  - Redo a clip: `retry-clip` as at stop 4, after their yes. Then pull, cut
@@ -374,12 +431,15 @@ ads from the brand's swipe library to pick from. A member who asks to say yes
374
431
  before each paid step gets "Step by step" below.
375
432
 
376
433
  **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.
434
+ template, 15 for a write (the write always waits; it has no `--wait`) and 5
435
+ more while the people a write makes are made (up to 20 in all), and 60 for
436
+ `swipe start --wait`. A start first waits up to 5 minutes while people are
437
+ still being made for its swipe, then goes on and says what it films. Run these
438
+ in the background, or leave `--wait` off and check in, so the shell's own time
439
+ limit does not cut them off. A wait that was cut off or timed out is not a
440
+ failure: the work goes on. Follow it by the id it printed, with the command
441
+ the CLI names, and never by running the paid line again: a second run buys it
442
+ a second time.
383
443
 
384
444
  ### 0. No ad named: find some
385
445
 
@@ -575,7 +635,7 @@ Send this in one message, in this order, then stop and wait:
575
635
  > **How many:** <n> videos = <a> ads × <p> personas:
576
636
  > - Video 1: <ad> × <persona>
577
637
  > - Video 2: <ad> × <persona>
578
- > **Cost:** no price before the write; a kind with a saved sheet gets its price after it.
638
+ > **Cost:** no price before the write, but for the people a write makes (in It buys); a kind with a saved sheet gets its price after it.
579
639
  > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
640
  > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
641
  > with "Say yes to <n> videos, or change a row." instead.)
@@ -612,23 +672,74 @@ The rows:
612
672
  - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
673
  each 15 or 25 seconds of the script filmed as one long take. It is open to
614
674
  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, known once the swipe is written: `exodus video swipe
675
+ to them. Use it when the member asks for a one-take UGC video or names
676
+ Luke's UGC method, and then the sheet's first line says the swipe makes
677
+ one-take UGC. Use it too when the template prints "Also fits their ad:
678
+ One-take UGC (ugc-one-take). …" and the member asked for a UGC video of one
679
+ person talking to the camera, in any words: the word "one-take" is not
680
+ needed. Then take it: in the sheet's first line, in place of "The swipe
681
+ makes that kind of ad.", say in one line that the swipe makes One-take UGC,
682
+ with the reason the template's line gives; One-take UGC is then the kind
683
+ made. The write carries `--kind ugc-one-take`, its dry run first (People,
684
+ below), and the sheet's yes is the yes to it. The line comes only for an ad
685
+ its write takes and a member who may start it. When the line comes and the
686
+ member asked for nothing it fits, name it in the sheet's first line as one
687
+ option beside the kind the swipe makes, with the reason that line gives.
688
+ Then add `--kind ugc-one-take` to the write only on the member's yes; never
689
+ choose it unasked. A reply that picks it is not the yes yet: run its write line with
690
+ `--kind ugc-one-take` and no `--yes` (free; People, below) for the people's
691
+ price, send the sheet again with **It buys:** in the saved sheet's form, and
692
+ wait for the yes. A sheet run (`exodus video swipe run --sheet <file>`) of
693
+ one ad that names no kind prints the same line, ending "set "kind":
694
+ "ugc-one-take" in the sheet before its next run.": set it only on their yes,
695
+ and say that the next run writes that ad again, which is paid. On an ad it
696
+ can't be made from, the write refuses it and says why. It buys a face photo,
697
+ a picture of the room, a cut-out of the product and one take for each 15 or
698
+ 25 seconds of script, on the member's Kie key, and text calls on their model
699
+ key; it needs their ElevenLabs key and their Kie key. Its price is the
700
+ server's estimate, known once the swipe is written: `exodus video swipe
625
701
  sheet price <swipeId>` (free) prints it at 720p or a 480p draft, the whole
626
- video or the first take only, each with the most it can cost.
702
+ video or the first take only, each with the most it can cost. The "about"
703
+ films each take once. A take filmed again (as when a filming left out
704
+ script words that matter) is paid again, so the run can cost more than
705
+ "about"; the "at most" counts each take and picture made twice. On an admin
706
+ key, plain `exodus video status` prints a line that starts "Cost so far:"
707
+ or "Cost:" once the run has spent anything: that is the run's own cost, the
708
+ figure the dashboard shows, and the line says what is not in it (what the
709
+ swipe paid for before the run). When it prints none, no cost is recorded
710
+ yet: say so, and never call the run free.
627
711
  - **The saved sheet** (a kind that has one; One-take UGC today). The server
628
712
  keeps one for each swipe of such a kind, made after its write. For such a
629
- video this sheet's yes covers the write only, and **It buys:** says so:
630
- "<n> scripts now; each video after your yes on its saved sheet". The
631
- saved sheet and its yes come in step 4.
713
+ video this sheet's yes covers the write and its people only, and **It
714
+ buys:** says so: "<n> scripts now, each with <k> people to pick from (at
715
+ most $<most> for each script's people); each video after your yes on its
716
+ saved sheet", with the people's part only when the dry write printed their
717
+ price (People, below). The saved sheet and its yes come in step 4.
718
+ - **People** (a kind whose write can make them: One-take UGC, when the
719
+ server offers people to pick from). Before you
720
+ send the sheet, run that video's write line (step 4) without `--yes`: it
721
+ writes nothing and pays for nothing. When the kind makes people, it prints
722
+ "This write also gives the sheet <k> people to pick from, …", their price
723
+ ("About $… for new people: …" and "At most $… in all: …") and the line to
724
+ run: "On their yes, run the same command with --yes --people-max-usd
725
+ <most>". Put that most on the sheet, as above: the sheet's yes is the yes to
726
+ it. When the member gave a money limit and the people's most, added over
727
+ every video on the sheet, is already over it, say so on the sheet and ask:
728
+ no write goes out until what it can cost fits. When it prints no people's
729
+ price, the write makes none. When the member
730
+ wants no people, the write takes `--no-people`, and the sheet says so. Two
731
+ more writes make none, and nothing is paid for them. A member's own
732
+ script (`their-format`) that keeps its own person (the "Persona and
733
+ mechanism" row below says when) makes none even with the figure; the write prints
734
+ "No people were made with this write: the script keeps no type of their
735
+ speaker to make them from. Nothing was paid for them. …". A video that step
736
+ 5 writes is written with a plain `--yes`, which makes none; it prints "No
737
+ people to pick from were made with this write: its yes carried no
738
+ --people-max-usd. …". So leave the people out of **It buys** for a step 5
739
+ video, and for the member's own script say its people are made only when the
740
+ script keeps their speaker's type. Either way the member can ask for people
741
+ on the saved sheet: `exodus video swipe sheet people <swipeId>`, the price
742
+ first.
632
743
  - **Persona.** Offer the three saved personas that fit the ad best, each with
633
744
  a short reason, then "show all <N>" (every persona not marked
634
745
  `[archived]`). Several may be picked: one video for each.
@@ -643,16 +754,28 @@ The rows:
643
754
  the member does not pay for several videos expecting a script for each
644
755
  persona. Two other ways make a persona real without step 5. The member
645
756
  writes their own script for that persona, and the write takes it with
646
- `--mode their-format --script <file>`, made the way their ad is made. Or
647
- the member swipes the words with the `swipe` skill and makes the film from
648
- one of our formats (its "Make it a video"). That path asks a yes before
649
- each paid step, and it makes the film in the format they pick, not in the
650
- ad's own kind and look.
651
- - **Characters.** A swiped run takes no saved characters and draws no new
652
- faces yet, so the row offers only "the tool picks".
757
+ `--mode their-format --script <file>`, made the way their ad is made. For
758
+ a kind whose sheet has a person (One-take UGC today), who is filmed
759
+ depends on the script. One that names no speaker, and does not make its
760
+ speaker the other sex from their ad's speaker, is cast as their ad's
761
+ speaker's type: the write puts that type on the script's cast line. A
762
+ speaker label that is not a placeholder ("Maya:", not "Speaker:"), a name
763
+ the script says ("Hi, I'm Jess"), its own words about the speaker, or words
764
+ that make the speaker the other sex keep the script's own person. The
765
+ saved sheet's person row says which, and why. To film the persona's own
766
+ person, the script names its speaker, or the member sets `who` on the
767
+ saved sheet. Or the member swipes the words with the `swipe` skill and
768
+ makes the film from one of our formats (its "Make it a video"). That path
769
+ asks a yes before each paid step, and it makes the film in the format they
770
+ pick, not in the ad's own kind and look.
771
+ - **Characters.** A swiped run takes no saved characters, so the row offers
772
+ only "the tool picks". A kind whose write makes people (People, above)
773
+ has its person picked on the saved sheet, in step 4.
653
774
  - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
654
775
  scripts, and <n> storyboards with their pictures; the voices and clips
655
- wait for your yes at each storyboard.
776
+ wait for your yes at each storyboard. With "one shot", the film is
777
+ delivered by itself once the app's cut is made, with no final approve: say
778
+ so in **My picks** when one shot is picked.
656
779
  - **Finish.** `swipe start` takes `--music` and nothing else for the finish.
657
780
  Music is made on the member's own ElevenLabs key. Caption style, speed,
658
781
  jump cuts and the end card come with a later update.
@@ -663,7 +786,15 @@ The rows:
663
786
  - **Cost.** Before the write the CLI prints no price for a swipe, so the
664
787
  sheet says exactly that: no number, no range, no guess. A kind with a saved
665
788
  sheet (One-take UGC today) gets its price after the write, with its saved
666
- sheet (step 4). The Director block of `exodus video
789
+ sheet (step 4). The people its write makes are priced before it (People,
790
+ above). A kind with no saved sheet prints no price before its write or its
791
+ start, so the member sees no figure before the yes: say so on the sheet.
792
+ When the member gave a money limit ("under $27"), say too that this kind
793
+ prints no price, so the limit cannot be checked against one before the yes.
794
+ Only when the template offered One-take UGC for this ad ("Also fits their
795
+ ad: …"), say that it prints a price before its start, and that its start is
796
+ refused when it can cost more than the "at most" shown. Ask how they want to
797
+ go on, and wait. The Director block of `exodus video
667
798
  status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
668
799
  for its redos on that video, not a price and not a ceiling for the first
669
800
  pass. Never quote it as the cost.
@@ -701,15 +832,38 @@ are done already.
701
832
  today): the yes of step 3 covers its writes, and its starts wait for one more
702
833
  yes. Run step 1 for every such video first. Then read each one's saved sheet
703
834
  with `exodus video swipe sheet <swipeId>` (free) and show them one time,
704
- together in one message: their rows, and the swipe's dashboard page each
835
+ together in one message: their rows (with each person made, their picture's
836
+ address, and the one recommended, when the sheet shows them), and the swipe's dashboard page each
705
837
  prints (that page does not show the saved sheet yet). Ask one yes for all
706
838
  their starts, then run step 2 for each. A reply that only changes a row is
707
839
  not that yes: set it with `exodus video swipe sheet set <swipeId>
708
840
  notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
709
841
  and ask the yes again. Say a row marked "no step reads it yet" as saved, not
710
842
  used. The start copies the saved sheet into the video; a change after it is
711
- for the next video. `who` picks the person filmed, in the row's own form, as
712
- `who="a white woman in her 30s, grey hoodie"`; unset, the script decides.
843
+ for the next video.
844
+
845
+ **Recommended rows.** A row may print `recommended:` and a reason: a value
846
+ worked out for this swipe. Today that can be the person (`who`), the voice
847
+ (`voice`), what the person holds (`prop`), the kind of opening (`hookKind`)
848
+ and the text card at the start (`headline`). Show each with its reason. "Let
849
+ it run" here, said in reply to these saved sheets and their prices, is the yes
850
+ to the starts with the sheets as they stand: set nothing (a size a money
851
+ limit needs is set before the sheets are shown, below), since a start with no pick films every recommended value
852
+ and every other row's default. A "let it run" said before them, as in the
853
+ first message, is not this yes: the writes went on the yes to step 3's sheet,
854
+ and the starts wait for a reply to these. When people were made but the person row recommends none,
855
+ a start with no pick films a new person, not one of them: the write and the
856
+ start say so, and the member picks with `who=<n>` if they want one of them. A
857
+ member's pick wins (the row then reads `from you:`). `<row>=` clears a pick,
858
+ and the row goes back to its recommended value or default. `prop=none` holds
859
+ nothing through the video (it prints `prop: none (nothing held through the
860
+ video)`), though a take may still pick up a small thing for a moment, such as
861
+ a mug or a drink; `prop=` takes it back to its default.
862
+
863
+ `who` is the person filmed: a person made for the swipe, by number
864
+ (`who=<n>`), or words in the row's own form, as `who="a white woman in her
865
+ 30s, grey hoodie"`. A row with no value at all prints "not set": then the
866
+ script decides.
713
867
  `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
714
868
  and where it is filmed, each with its default's reason; set one only when the
715
869
  member asks (`time=dusk`). `notes` end every take's prompt.
@@ -718,7 +872,8 @@ usual), and `hookKind` its kind (`any`, or one the row lists), each with
718
872
  its default's reason; set one only when the member asks (`hook=3`,
719
873
  `hook=off`). With the hook on, the board asks the hook director for the
720
874
  opening: one text call on the member's model key, which the price names among
721
- what it leaves out.
875
+ what it leaves out. `headline` is the text card at the start: `none`, or the
876
+ member's own words for it (one short line; a refusal says what fits).
722
877
  With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
723
878
  (free) prints it at the sheet's rows, with the most it can cost and one line
724
879
  of what it leaves out. A 480p draft or the first take only is a row the
@@ -727,18 +882,55 @@ price again after a set. The first take only is a cheap check of the method
727
882
  and the size, not of the final person: the whole video after it is a second
728
883
  start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
729
884
  and it casts the person and draws the pictures again. Say so before that yes.
730
-
731
- Offer people or voices to pick from only when the member asks for options.
732
- People are paid on the member's keys: run `exodus video swipe sheet people
733
- <swipeId> --count <n>` first (no `--yes`), show the price it prints word for
734
- word, and after their yes run the line it prints (`--yes --max-usd <n>`, the
735
- most the price said). Do not add `--wait`: it can wait up to 45 minutes. Read
736
- the sheet a few minutes later (`exodus video swipe sheet <swipeId>`) and show
737
- each person's name and picture address. Voices are free: `exodus video swipe
738
- sheet voices <swipeId>` lists them, each with a sample to hear. A pick is a set
739
- (`who=<n>`, `voice=<n>`), and the video is filmed with that person, their face
740
- and that voice. If the server says these choices are not switched on yet, say
741
- so and go on with the sheet as it is.
885
+ **A money limit.** When the member gave one ("keep the whole thing under
886
+ $15"), hold it before the start: add the people's most when the dry write
887
+ printed one (its "At most $… in all"), what the write cost when the limit is
888
+ for everything, and the start's "at most" (never its "about": a take filmed
889
+ again is paid again), and compare the sum with the limit. The text calls the
890
+ price leaves out are in no figure: say so, and leave room for them. Over it,
891
+ nothing starts. When a smaller size the price lists fits (its whole video,
892
+ every take, and the start does not refuse it), set it before you show the
893
+ saved sheets (`exodus video swipe sheet set <swipeId> size=480p`, free), read
894
+ the price again, and say on the sheet in one line that it is a 480p draft,
895
+ the size that fits their limit: their yes to that sheet is the yes to it. A
896
+ limit given after they saw the sheets: name the 480p draft and wait for their
897
+ yes. With a money limit and no "at most" printed, the limit cannot be
898
+ checked: stop and ask. For example, with a limit for everything:
899
+ when the write's cost, the people's most and 720p's "at most" add up to more
900
+ than the limit, and the same sum with 480p's "at most" is under it, set
901
+ 480p. Every figure in that sum is the one the CLI printed for this swipe,
902
+ never one from memory. When no size fits, stop and ask; when the price lists the first take
903
+ only (`takes=first`), you may name it as a smaller thing they can choose,
904
+ never as the whole video. The `--max-usd` you start with is the "at most" the
905
+ price shows, so it is never above what is left of the member's limit.
906
+
907
+ A write that carried the people's most makes the first people to pick from
908
+ (People, step 3). Offer more people, or voices to pick from, only when the
909
+ member asks for options. More people are paid on the member's keys: run
910
+ `exodus video swipe sheet people <swipeId> --count <n>` first (no `--yes`),
911
+ show the price it prints word for word, and after their yes run the line it
912
+ prints (`--yes --max-usd <n>`, the most the price said). Do not add `--wait`:
913
+ it can wait up to 45 minutes. Read the sheet a few minutes later (`exodus
914
+ video swipe sheet <swipeId>`) and show each person's name and picture address.
915
+ A sheet with a `voice` row (there only while the server offers people and
916
+ voices to pick from) has its voices listed once by the server after the write
917
+ (when the member has an ElevenLabs key), and the row may recommend one
918
+ and say why: a voice that fits the person, which may skip a voice the
919
+ brand's recent swipes already have, so its videos don't all sound the same.
920
+ A sheet with no `voice` row has no voices to pick from: say nothing about
921
+ them. `exodus
922
+ video swipe sheet voices <swipeId>` lists them again: one read of the voice
923
+ list on the member's ElevenLabs key, and no speech is made, so it buys
924
+ nothing. It prints the voices that fit the person, best fit first, each with
925
+ its age and accent when known ("Sarah · young · American") and a sample to
926
+ hear, then "Recommended: <n> (…). <why> A start with no pick films it."; after
927
+ the member's pick, "Recommended: <n> (…). You picked it, so a start films it."
928
+ or "… You picked <m>, so a start films your pick."; or why none is. A voice
929
+ row with no voice prints "List the voices: exodus video swipe sheet voices
930
+ <swipeId>". A
931
+ pick is a set (`who=<n>`, `voice=<n>`), and the video is filmed with that
932
+ person, their face and that voice. If the server says these choices are not
933
+ switched on yet, say so and go on with the sheet as it is.
742
934
 
743
935
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
744
936
  every video has started:
@@ -756,6 +948,38 @@ every video has started:
756
948
  or a mechanism was picked and step 5 does not apply, add one line: "The
757
949
  persona and the mechanism are noted, not used: the video writer does not
758
950
  read them yet."
951
+ For a kind whose write makes people (People, step 3), run the yes line
952
+ the dry write printed: `--yes --people-max-usd <most>`, or `--yes
953
+ --no-people` when the member wants none. A plain `--yes` makes no people,
954
+ and the write then says so: "No people to pick from were made with this
955
+ write: its yes carried no --people-max-usd. See their price (free): …".
956
+ With the figure, the write waits for the people (a line ending "Waiting for
957
+ them, up to 5 minutes."), then prints how their ask ended and each person
958
+ with their picture's address. Show each person's name and picture. Read the
959
+ write's own lines; never assume one is recommended. When the ask names one
960
+ ("Person N is recommended." and why), the write says "A start with no pick
961
+ films person N, the recommended one." When it names none, it says "… films
962
+ a new person cast from …, not one of these. To film one of them (free):
963
+ exodus video swipe sheet set <swipeId> who=<n>": tell the member that a
964
+ start with no pick films none of the people shown, and set `who=<n>` only
965
+ on their word. When none were made, it prints the server's sentence for
966
+ that (it says why when the server knows, as for a script that keeps no type
967
+ of their speaker) or "No people were made with this write, and nothing was
968
+ paid for them.", then "Ask for them (the price first, free): exodus video
969
+ swipe sheet people <swipeId>". After 5 minutes it prints "Still not done
970
+ after 5 minutes: …" with what the server last said, then "See them: exodus
971
+ video swipe sheet <swipeId>" (when the server said nothing: "The people are
972
+ still being made. See them: …"): the write is done, so read the sheet a few
973
+ minutes later.
974
+ For a kind whose sheet has these rows (One-take UGC today), the write may
975
+ also write our own text card and pick a kind of opening. They show on the
976
+ saved sheet as `headline` and `hookKind`, marked recommended. When one was
977
+ left out, Changed ends with a note. "We left out the text card we wrote:
978
+ <why>. The video has no text card.": tell the member in one line; they may
979
+ write their own card (`headline="<words>"`) or leave the video with none.
980
+ "We left out the kind of opening we picked: <why>. The sheet's kind of
981
+ opening row keeps its default.": tell the member; they may set `hookKind`
982
+ to a kind the row lists, or leave the default.
759
983
  The write's last line says "Start the video (paid; ask first)": the
760
984
  sheet's yes was that ask, so start now, with the line below, not the
761
985
  write's own, which leaves out `--one-shot`. For a kind with a saved
@@ -765,13 +989,24 @@ every video has started:
765
989
  `--one-shot` when the member chose to stop at the storyboard, and with
766
990
  `--music` when they chose music. For a kind with a saved sheet whose price
767
991
  printed a number, add `--max-usd <n>` with the "at most" it showed: a
768
- start that can now cost more is refused, and nothing is started. No
769
- number printed: no `--max-usd`, and never a guessed one. Give the member the
992
+ start that can now cost more is refused, and nothing is started. With a
993
+ money limit, start only once that "at most" fits what is left of it ("A
994
+ money limit", above). No
995
+ number printed: no `--max-usd`, and never a guessed one. When the sheet
996
+ has people, the start says first whom it films ("A start with no pick
997
+ films person N, the recommended one.", or the member's pick). While they
998
+ are still being made it says "People to pick from are being made for this
999
+ swipe. The start waits for them, …", waits until 5 minutes after they
1000
+ were asked for, then starts and says whom it films. Give the member the
770
1001
  `Watch it:` link at once. Then go on to the next video.
771
1002
  3. When every video has started, follow each run with `exodus video status
772
- <runId>` and do what it prints. A one-shot run that waits for a cut goes
773
- to "End: watch and approve" (pull, cut, upload, the run page). A run that
774
- stopped at the storyboard goes to stop 3, then the end.
1003
+ <runId>` and do what it prints. The app makes a swiped video's cut ("End:
1004
+ watch and approve"), so make no cut of your own. A one-shot run is
1005
+ delivered by itself once that cut is made: give the member its run page.
1006
+ While the app makes it, `status` may still say "Parked: every piece is
1007
+ made and the run is waiting for a cut." for a short while: read `status`
1008
+ again before anything else. A run that stopped at the storyboard goes to
1009
+ stop 3, then the end.
775
1010
 
776
1011
  **Never start the same swipe twice.** One swipe is one video. A start of a
777
1012
  swipe that already has a video is refused, starts nothing, and names the run:
@@ -787,18 +1022,66 @@ row marked refused is that write's refusal: report it as a refused write. When
787
1022
  no such row is there yet, the write may still finish: check again later.
788
1023
 
789
1024
  At the end, report each video on one line: its ad and persona, its run id
790
- and its `Watch it:` link, or why it stopped.
1025
+ and its `Watch it:` link, or why it stopped. For a One-take video, add what it
1026
+ cost (the "Cost:" line of `status`), beside the "about" shown before the
1027
+ yes.
791
1028
 
792
- **The final approve** is asked for each video as at "End: watch and
793
- approve". It is one way. A redo of a clip there needs its own yes.
1029
+ **The end of each video** is as "End: watch and approve" says. A one-shot
1030
+ video is delivered by itself once the app's cut is made, with no final
1031
+ approve, unless the film's check against its own sound fails ("End: watch and
1032
+ approve"). A video that stopped at the storyboard asks the final approve, which
1033
+ is one way. A redo of a clip there needs its own yes.
794
1034
 
795
1035
  **A refusal or a failed check stops that video only.** The others go on, and
796
- every video is in the report at the end. A refused write prints the writer's
797
- sentence, its swipe id, what it cost, and "Nothing was started.": report all
798
- of it for that video. Writing again is paid again and needs the member's
799
- word. A refused start prints its sentence: report it for that video. A
800
- one-shot run whose checks find a problem stops for the member: show what
801
- `status` prints and ask.
1036
+ every video is in the report at the end. A refused write prints "The writer
1037
+ refused:" and its sentence (on an admin key, then "What the checks found:"),
1038
+ its swipe id, what it cost, "Nothing was started." and "Writing again is paid
1039
+ too: the same exodus video swipe write line, after the member's yes.". Report
1040
+ all of it for that video.
1041
+
1042
+ A refusal for claims reads "Your product sheet doesn't back up …" and names
1043
+ up to two held lines, each with why in brackets: `it says "…", which we
1044
+ couldn't find on the sheet`; `… which the sheet says, but we couldn't find it
1045
+ in the part we matched to this claim`; `we found no one sentence of the sheet
1046
+ that backs "…" as the line says it`; `it still hedges or repeats a word of
1047
+ "…", the claim we rewrote it from`; `it names the product next to a line we
1048
+ took out, so it reads as that line's claim`; or, for a shot, `it shows a
1049
+ result, "…", in so many words, and we never back a shot that does, whatever
1050
+ the sheet says`. More lines end "and N more (the dashboard lists every one)".
1051
+ Give the member the way out the refusal ends with:
1052
+
1053
+ - When it ends "If it's true, add the line's own words to your product's
1054
+ description (on the dashboard: Library, Materials, Brand info, then the
1055
+ product's Edit), then write again." (or "If a line is true, …", or "If a
1056
+ spoken line whose claim we couldn't find on the sheet is true, …"): ask
1057
+ the member whether that line is true of their product. Only if it is, they
1058
+ add the line's own words to the product's description at that place. Then,
1059
+ on their yes, run the same write line again.
1060
+ - When it ends "Write again." alone, no held line can be backed by the
1061
+ description: on the member's yes, run the same write line again.
1062
+ - "… a price or code your product sheet doesn't list. If it's right, add it
1063
+ to your product's description (…), then write again.": the same, for that
1064
+ price or code.
1065
+ - "The script we wrote left out …, and at closeness … every beat stays. …":
1066
+ the member adds what that beat can say to the product's description, or
1067
+ picks closeness 4 or 5, where beats can merge or drop. Then write again on
1068
+ their yes.
1069
+ - "Your script says "…", from their ad or a price or code your product sheet
1070
+ doesn't list. We never change your words, so take it out, then try again.":
1071
+ the member's own script holds those words. They take them out of the file,
1072
+ and you write again on their yes.
1073
+ - Any other sentence: say it as it is, and write again only on their yes.
1074
+
1075
+ **Never write around a refusal yourself.** Do not pass the refused script,
1076
+ its held lines, or lines you wrote, to `--mode their-format --script`. The
1077
+ way out is the one the refusal ends with, above.
1078
+
1079
+ A refused start prints its sentence: report it for that video. When it says
1080
+ a row of the sheet "holds words it no longer takes" (what the person holds,
1081
+ for one), nothing was paid: change that row only on the member's word (their
1082
+ new words, or `prop=none`), then start again on their yes. A one-shot run
1083
+ whose checks find a problem stops for the member: show what `status` prints
1084
+ and ask.
802
1085
 
803
1086
  ### 5. With a persona or a mechanism: the text swipe bot
804
1087
 
@@ -956,11 +1239,11 @@ noted only.
956
1239
  ### Step by step: a yes before each paid step
957
1240
 
958
1241
  For a member who asks for stops. Four steps cost money, and the CLI prints no
959
- price for any of them but the start of a kind with a saved sheet. Run each
960
- one first without `--yes`: it sends nothing and prints what the step buys and
961
- who pays. Tell the member both, and the price when it prints one, else say
962
- the CLI prints no price; never guess one, and run the same line with `--yes`
963
- only after their yes.
1242
+ price for any of them but the people a write makes and the start of a kind
1243
+ with a saved sheet. Run each one first without `--yes`: it sends nothing and
1244
+ prints what the step buys and who pays. Tell the member both, and the price
1245
+ when it prints one, else say the CLI prints no price; never guess one, and run
1246
+ the same line with `--yes` only after their yes.
964
1247
 
965
1248
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
966
1249
  Instagram or YouTube), or a video ad in the brand's swipe library by the
@@ -985,9 +1268,14 @@ only after their yes.
985
1268
  2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
986
1269
  member's own Anthropic or OpenRouter key. It prints the kind of ad and the
987
1270
  look the ad matched, and why. A template made before costs nothing. Show
988
- the member the kind and the look. The swipe writes that kind and no other.
989
- If the member wants another kind, stop here and make the video from that
990
- format with the ad's words instead ("From one sentence to a film").
1271
+ the member the kind and the look, and the "Also fits their ad: …" line when
1272
+ it prints one (the One-take UGC row under "3. The sheet, once" says what to
1273
+ do with it). The swipe writes the kind it was matched to, or the one the
1274
+ write names with `--kind`, and no other: name another kind only on the
1275
+ member's yes. A kind this ad can't be made as is refused before the write
1276
+ is paid, with the kinds it can be made as. For any other kind, stop here
1277
+ and make the video from that format with the ad's words instead ("From one
1278
+ sentence to a film").
991
1279
  3. **The choices.** `exodus video swipe products` lists the brand's
992
1280
  products. Ask which product, what to swipe and how close. What to swipe
993
1281
  (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
@@ -996,13 +1284,21 @@ only after their yes.
996
1284
  2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
997
1285
  has each one's line.
998
1286
  4. **The write.** `exodus video swipe write <breakdownId> --product <id>
999
- [--mode …] [--closeness …]`, paid on the member's own key. It takes four
1000
- to nine minutes and waits by itself. Show the member the script, the
1001
- direction, Kept and Changed, and what it cost. A refusal prints the
1002
- writer's sentence and "Nothing was started.": tell the member, and offer to
1003
- write again, which is paid too. If the wait gives up, the write may still
1004
- finish: run `exodus video swipe list` before writing again. It shows the
1005
- brand's newest swipes, and a refused one is marked with what it cost.
1287
+ [--mode …] [--closeness …]`, paid on the member's own key. It takes four to
1288
+ nine minutes and waits by itself. Show the member the script, the
1289
+ direction, Kept and Changed, and what it cost. When the line without
1290
+ `--yes` also prints the people's price (One-take UGC, when the server
1291
+ offers people), it prints the yes line with `--people-max-usd <most>`: tell
1292
+ the member that price, and run that line on their yes, or `--yes
1293
+ --no-people` when they want none. When it prints none, the write makes no
1294
+ people. With people, the write then waits up to 5 minutes more for the people and
1295
+ shows them, as step 1 of "On the yes" says. A refusal prints the writer's
1296
+ sentence and "Nothing was started.": tell the member, give them the way out
1297
+ the sentence ends with ("A refusal or a failed check" in "On the yes"), and
1298
+ write again, which is paid too, only on their yes. If the wait gives up,
1299
+ the write may still finish: run `exodus video swipe list` before writing
1300
+ again. It shows the brand's newest swipes, and a refused one is marked with
1301
+ what it cost.
1006
1302
  5. **The start.** `exodus video swipe start <swipeId>`. It buys the
1007
1303
  storyboard and its pictures; the voices and clips wait for the storyboard's
1008
1304
  yes. `--style <look>` changes the look, `--music` adds a music bed.
@@ -1030,15 +1326,19 @@ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown st
1030
1326
  --full adds what it read: shots, script, cast, filming
1031
1327
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
1032
1328
  exodus video swipe products the brand's products and their ids
1033
- exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
1034
- the brand's version (member's key); waits for it
1329
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes [--people-max-usd <n>]] [--no-people]
1330
+ the brand's version (member's key); waits for it. For a kind
1331
+ whose write makes people (when the server offers them),
1332
+ without --yes it also prints their price, and --yes
1333
+ --people-max-usd <n> makes them too
1035
1334
  exodus video swipe show <swipeId> one swipe again
1036
1335
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
1037
1336
  a refused one shows what it cost
1038
1337
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
1039
1338
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
1040
1339
  start the run on the kind the swipe wrote; --again for a
1041
- second, paid video of a swipe that already has one
1340
+ second, paid video of a swipe that already has one; waits
1341
+ up to 5 minutes for people still being made
1042
1342
  exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1043
1343
  no dashboard page shows it yet
1044
1344
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
@@ -1046,8 +1346,10 @@ exodus video swipe sheet price <swipeId> the video's price at t
1046
1346
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1047
1347
  new people to pick from (paid on the member's keys: the
1048
1348
  price first, --yes with its most makes them); who=<n> picks one
1049
- exodus video swipe sheet voices <swipeId> the account's voices that fit the person, then the member's
1050
- own, each with a sample (free); voice=<n> picks one
1349
+ exodus video swipe sheet voices <swipeId> the voices that fit the person, best fit first, each with its
1350
+ sample (and its age and accent when known), and the one the
1351
+ row recommends, if any: one read of the voice list on the
1352
+ member's ElevenLabs key, no speech; voice=<n> picks one
1051
1353
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
1052
1354
  ```
1053
1355
 
@@ -1100,7 +1402,9 @@ CLI words it the way the run page does. On their own brands they can:
1100
1402
  until the storyboard is approved.
1101
1403
  - `video retry-frame <runId> --scene <n>`: redraws one scene's picture while
1102
1404
  the storyboard waits. No `--node`; the server finds the step.
1103
- - `video pull <runId> --out <dir>`: the finished video (`video.<ext>`), each
1405
+ - `video pull <runId> --out <dir>`: the finished video (`video.<ext>`) once
1406
+ it is ready (until then it says "The finished video isn't ready yet, so
1407
+ only the scene pieces came down."), each
1104
1408
  scene's clip (`scene-NN.<ext>`) and voice (`scene-NN.voice.<ext>`), and the
1105
1409
  music (`music.<ext>`), with a `manifest.json` holding only `runId`,
1106
1410
  `pulledAt`, `dashboardUrl`, `scenes` (`index`, `clip`, `voice`), `music` and
@@ -1342,8 +1646,9 @@ under it:
1342
1646
  it instead (`stop.missingScenes` in `--json`) and approval is refused until
1343
1647
  it has one. A scene whose picture the video service refused needs
1344
1648
  `retry-frame --note` before `retry-clip`; the clip redo alone resends the
1345
- refused picture. On a video started from the dashboard, the app makes the
1346
- cut itself; when a scene's clip still has a drawing fault after it was made
1649
+ refused picture. On a video the app cuts itself (one started from the
1650
+ dashboard, a swiped video, a beta tester's run: "End: watch and approve"),
1651
+ the app makes the cut; when a scene's clip still has a drawing fault after it was made
1347
1652
  again, the stop block says `Held:` and names the scene
1348
1653
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1349
1654
  made again with `retry-clip`, or kept as it is with `exodus video keep
@@ -1355,7 +1660,21 @@ under it:
1355
1660
  cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1356
1661
  and ask them to watch the take. With their yes, `exodus video keep <runId>
1357
1662
  --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1358
- take starts the cut. Otherwise a new run films it again.
1663
+ take starts the cut. Otherwise a new run films it again. On a One-shot run
1664
+ that cut is delivered by itself: say so before the last keep.
1665
+ A take held for its label has a sentence that begins "The label check
1666
+ read the product's label as mirror writing in take N", says why it was not
1667
+ fixed (a flip would turn the room around against the other takes, the take
1668
+ could not be flipped, or a second look could not make sure), and ends with
1669
+ its two ways out. Give the member both, in its own words. Keep it, on their
1670
+ yes (`exodus video keep <runId> --scene <n>`), and the film shows the label
1671
+ as it is in the take. Or start a new
1672
+ run, which films every take again at its full price: for a swiped video,
1673
+ `exodus video swipe start <swipeId> --again`, first without `--yes` for its
1674
+ price, then the line it prints, on their yes. The new start keeps none of
1675
+ the first start's flags: give it `--one-shot` and `--music` again when the
1676
+ first had them, in that dry line too (without `--one-shot` it stops at the
1677
+ storyboard).
1359
1678
  - paused: a builder checkpoint neither video verb resolves —
1360
1679
  `exodus workflow checkpoint <runId>` is the verb for that one.
1361
1680
  - failed: `status` shows how far it got, and a `--wait` that was running exits
@@ -1369,6 +1688,17 @@ under it:
1369
1688
  says instead that a retry stops the same way, the orders may already be
1370
1689
  paid for: only a new start draws the picture (`exodus video swipe start
1371
1690
  <swipeId> --again` says its price before it pays for anything).
1691
+ - A picture no retry can order: its sentence says "A retry of this step
1692
+ stops the same way, since those orders may already be paid for. Start
1693
+ the video again instead: …". Do not retry: it stops the same way, and
1694
+ `status` offers no retry for it. From here, the new start of a swiped
1695
+ video is `exodus video swipe start <swipeId> --again`. Run it first
1696
+ without `--yes`: it sends nothing and prints the whole video's price (the
1697
+ pictures, the takes and the text calls are all paid again) and the line
1698
+ to run. Tell the member the price, and run that line only on their yes.
1699
+ The new start keeps none of the first start's flags: give it
1700
+ `--one-shot` and `--music` again when the first had them, in that dry
1701
+ line too (without `--one-shot` it stops at the storyboard).
1372
1702
  - The connection to the text model dropped twice: the retry asks again and
1373
1703
  keeps what was already written. The storyboard already asked once more
1374
1704
  by itself after the first drop.
@@ -1987,7 +2317,8 @@ length. Do not invent a number.
1987
2317
  `pull` writes a flat folder and a `manifest.json` that indexes it. The manifest
1988
2318
  is the data you decide from; the filenames are its values. Scene numbers are the
1989
2319
  run's own. Every `pull` re-downloads and overwrites every file, so running it
1990
- again is always safe.
2320
+ again is always safe. It never writes the finished video the app made ("End:
2321
+ watch and approve").
1991
2322
 
1992
2323
  ```
1993
2324
  storyboard.json the whole storyboard envelope (see below)