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

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.
@@ -374,12 +374,15 @@ ads from the brand's swipe library to pick from. A member who asks to say yes
374
374
  before each paid step gets "Step by step" below.
375
375
 
376
376
  **Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
377
- template, 15 for a write (the write always waits; it has no `--wait`), and 60
378
- for `swipe start --wait`. Run these in the background, or leave `--wait` off
379
- and check in, so the shell's own time limit does not cut them off. A wait that
380
- was cut off or timed out is not a failure: the work goes on. Follow it by the
381
- id it printed, with the command the CLI names, and never by running the paid
382
- line again: a second run buys it a second time.
377
+ template, 15 for a write (the write always waits; it has no `--wait`) and 5
378
+ more while the people a write makes are made (up to 20 in all), and 60 for
379
+ `swipe start --wait`. A start first waits up to 5 minutes while people are
380
+ still being made for its swipe, then goes on and says what it films. Run these
381
+ in the background, or leave `--wait` off and check in, so the shell's own time
382
+ limit does not cut them off. A wait that was cut off or timed out is not a
383
+ failure: the work goes on. Follow it by the id it printed, with the command
384
+ the CLI names, and never by running the paid line again: a second run buys it
385
+ a second time.
383
386
 
384
387
  ### 0. No ad named: find some
385
388
 
@@ -575,7 +578,7 @@ Send this in one message, in this order, then stop and wait:
575
578
  > **How many:** <n> videos = <a> ads × <p> personas:
576
579
  > - Video 1: <ad> × <persona>
577
580
  > - Video 2: <ad> × <persona>
578
- > **Cost:** no price before the write; a kind with a saved sheet gets its price after it.
581
+ > **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
582
  > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
583
  > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
584
  > with "Say yes to <n> videos, or change a row." instead.)
@@ -612,23 +615,56 @@ The rows:
612
615
  - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
616
  each 15 or 25 seconds of the script filmed as one long take. It is open to
614
617
  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
618
+ to them. Use it when the member asks for a one-take UGC video or names
619
+ Luke's UGC method, and then the sheet's first line says the swipe makes
620
+ one-take UGC. When the template prints "Also fits their ad: One-take UGC
621
+ (ugc-one-take). …", name it in the sheet's first line as one option beside
622
+ the kind the swipe makes, with the reason that line gives. The line comes
623
+ only for an ad its write takes and a member who may start it. Add `--kind
624
+ ugc-one-take` to the write only on the member's yes; never choose it
625
+ unasked. A reply that picks it is not the yes yet: run its write line with
626
+ `--kind ugc-one-take` and no `--yes` (free; People, below) for the people's
627
+ price, send the sheet again with **It buys:** in the saved sheet's form, and
628
+ wait for the yes. A sheet run (`exodus video swipe run --sheet <file>`) of
629
+ one ad that names no kind prints the same line, ending "set "kind":
630
+ "ugc-one-take" in the sheet before its next run.": set it only on their yes,
631
+ and say that the next run writes that ad again, which is paid. On an ad it
632
+ can't be made from, the write refuses it and says why. It buys a face photo,
633
+ a picture of the room, a cut-out of the product and one take for each 15 or
634
+ 25 seconds of script, on the member's Kie key, and text calls on their model
635
+ key; it needs their ElevenLabs key and their Kie key. Its price is the
636
+ server's estimate, known once the swipe is written: `exodus video swipe
625
637
  sheet price <swipeId>` (free) prints it at 720p or a 480p draft, the whole
626
638
  video or the first take only, each with the most it can cost.
627
639
  - **The saved sheet** (a kind that has one; One-take UGC today). The server
628
640
  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.
641
+ video this sheet's yes covers the write and its people only, and **It
642
+ buys:** says so: "<n> scripts now, each with <k> people to pick from (at
643
+ most $<most> for each script's people); each video after your yes on its
644
+ saved sheet", with the people's part only when the dry write printed their
645
+ price (People, below). The saved sheet and its yes come in step 4.
646
+ - **People** (a kind whose write can make them: One-take UGC, when the
647
+ server offers people to pick from). Before you
648
+ send the sheet, run that video's write line (step 4) without `--yes`: it
649
+ writes nothing and pays for nothing. When the kind makes people, it prints
650
+ "This write also gives the sheet <k> people to pick from, …", their price
651
+ ("About $… for new people: …" and "At most $… in all: …") and the line to
652
+ run: "On their yes, run the same command with --yes --people-max-usd
653
+ <most>". Put that most on the sheet, as above: the sheet's yes is the yes to
654
+ it. When it prints no people's price, the write makes none. When the member
655
+ wants no people, the write takes `--no-people`, and the sheet says so. Two
656
+ more writes make none, and nothing is paid for them. A member's own
657
+ script (`their-format`) that keeps its own person (the "Persona and
658
+ mechanism" row below says when) makes none even with the figure; the write prints
659
+ "No people were made with this write: the script keeps no type of their
660
+ speaker to make them from. Nothing was paid for them. …". A video that step
661
+ 5 writes is written with a plain `--yes`, which makes none; it prints "No
662
+ people to pick from were made with this write: its yes carried no
663
+ --people-max-usd. …". So leave the people out of **It buys** for a step 5
664
+ video, and for the member's own script say its people are made only when the
665
+ script keeps their speaker's type. Either way the member can ask for people
666
+ on the saved sheet: `exodus video swipe sheet people <swipeId>`, the price
667
+ first.
632
668
  - **Persona.** Offer the three saved personas that fit the ad best, each with
633
669
  a short reason, then "show all <N>" (every persona not marked
634
670
  `[archived]`). Several may be picked: one video for each.
@@ -643,13 +679,23 @@ The rows:
643
679
  the member does not pay for several videos expecting a script for each
644
680
  persona. Two other ways make a persona real without step 5. The member
645
681
  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".
682
+ `--mode their-format --script <file>`, made the way their ad is made. For
683
+ a kind whose sheet has a person (One-take UGC today), who is filmed
684
+ depends on the script. One that names no speaker, and does not make its
685
+ speaker the other sex from their ad's speaker, is cast as their ad's
686
+ speaker's type: the write puts that type on the script's cast line. A
687
+ speaker label that is not a placeholder ("Maya:", not "Speaker:"), a name
688
+ the script says ("Hi, I'm Jess"), its own words about the speaker, or words
689
+ that make the speaker the other sex keep the script's own person. The
690
+ saved sheet's person row says which, and why. To film the persona's own
691
+ person, the script names its speaker, or the member sets `who` on the
692
+ saved sheet. Or the member swipes the words with the `swipe` skill and
693
+ makes the film from one of our formats (its "Make it a video"). That path
694
+ asks a yes before each paid step, and it makes the film in the format they
695
+ pick, not in the ad's own kind and look.
696
+ - **Characters.** A swiped run takes no saved characters, so the row offers
697
+ only "the tool picks". A kind whose write makes people (People, above)
698
+ has its person picked on the saved sheet, in step 4.
653
699
  - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
654
700
  scripts, and <n> storyboards with their pictures; the voices and clips
655
701
  wait for your yes at each storyboard.
@@ -663,7 +709,8 @@ The rows:
663
709
  - **Cost.** Before the write the CLI prints no price for a swipe, so the
664
710
  sheet says exactly that: no number, no range, no guess. A kind with a saved
665
711
  sheet (One-take UGC today) gets its price after the write, with its saved
666
- sheet (step 4). The Director block of `exodus video
712
+ sheet (step 4). The people its write makes are priced before it (People,
713
+ above). The Director block of `exodus video
667
714
  status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
668
715
  for its redos on that video, not a price and not a ceiling for the first
669
716
  pass. Never quote it as the cost.
@@ -701,15 +748,35 @@ are done already.
701
748
  today): the yes of step 3 covers its writes, and its starts wait for one more
702
749
  yes. Run step 1 for every such video first. Then read each one's saved sheet
703
750
  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
751
+ together in one message: their rows (with each person made, their picture's
752
+ address, and the one recommended, when the sheet shows them), and the swipe's dashboard page each
705
753
  prints (that page does not show the saved sheet yet). Ask one yes for all
706
754
  their starts, then run step 2 for each. A reply that only changes a row is
707
755
  not that yes: set it with `exodus video swipe sheet set <swipeId>
708
756
  notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
709
757
  and ask the yes again. Say a row marked "no step reads it yet" as saved, not
710
758
  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.
759
+ for the next video.
760
+
761
+ **Recommended rows.** A row may print `recommended:` and a reason: a value
762
+ worked out for this swipe. Today that can be the person (`who`), the voice
763
+ (`voice`), what the person holds (`prop`), the kind of opening (`hookKind`)
764
+ and the text card at the start (`headline`). Show each with its reason. "Let
765
+ it run" here is the yes to the starts with the sheets as they stand: set
766
+ nothing, since a start with no pick films every recommended value and every
767
+ other row's default. When people were made but the person row recommends none,
768
+ a start with no pick films a new person, not one of them: the write and the
769
+ start say so, and the member picks with `who=<n>` if they want one of them. A
770
+ member's pick wins (the row then reads `from you:`). `<row>=` clears a pick,
771
+ and the row goes back to its recommended value or default. `prop=none` holds
772
+ nothing through the video (it prints `prop: none (nothing held through the
773
+ video)`), though a take may still pick up a small thing for a moment, such as
774
+ a mug or a drink; `prop=` takes it back to its default.
775
+
776
+ `who` is the person filmed: a person made for the swipe, by number
777
+ (`who=<n>`), or words in the row's own form, as `who="a white woman in her
778
+ 30s, grey hoodie"`. A row with no value at all prints "not set": then the
779
+ script decides.
713
780
  `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
714
781
  and where it is filmed, each with its default's reason; set one only when the
715
782
  member asks (`time=dusk`). `notes` end every take's prompt.
@@ -718,7 +785,8 @@ usual), and `hookKind` its kind (`any`, or one the row lists), each with
718
785
  its default's reason; set one only when the member asks (`hook=3`,
719
786
  `hook=off`). With the hook on, the board asks the hook director for the
720
787
  opening: one text call on the member's model key, which the price names among
721
- what it leaves out.
788
+ what it leaves out. `headline` is the text card at the start: `none`, or the
789
+ member's own words for it (one short line; a refusal says what fits).
722
790
  With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
723
791
  (free) prints it at the sheet's rows, with the most it can cost and one line
724
792
  of what it leaves out. A 480p draft or the first take only is a row the
@@ -728,17 +796,30 @@ and the size, not of the final person: the whole video after it is a second
728
796
  start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
729
797
  and it casts the person and draws the pictures again. Say so before that yes.
730
798
 
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.
799
+ A write that carried the people's most makes the first people to pick from
800
+ (People, step 3). Offer more people, or voices to pick from, only when the
801
+ member asks for options. More people are paid on the member's keys: run
802
+ `exodus video swipe sheet people <swipeId> --count <n>` first (no `--yes`),
803
+ show the price it prints word for word, and after their yes run the line it
804
+ prints (`--yes --max-usd <n>`, the most the price said). Do not add `--wait`:
805
+ it can wait up to 45 minutes. Read the sheet a few minutes later (`exodus
806
+ video swipe sheet <swipeId>`) and show each person's name and picture address.
807
+ A sheet with a `voice` row (there only while the server offers people and
808
+ voices to pick from) has its voices listed once by the server after the write
809
+ (when the member has an ElevenLabs key), and the row may recommend one
810
+ and say why: a voice that fits the person, which may skip a voice the
811
+ brand's recent swipes already have, so its videos don't all sound the same.
812
+ A sheet with no `voice` row has no voices to pick from: say nothing about
813
+ them. `exodus
814
+ video swipe sheet voices <swipeId>` lists them again: one read of the voice
815
+ list on the member's ElevenLabs key, and no speech is made, so it buys
816
+ nothing. It prints the voices that fit the person, best fit first, each with
817
+ its age and accent when known ("Sarah · young · American") and a sample to
818
+ hear, then "Recommended: <n> (…)" and why, or why none is. A voice row with no
819
+ voice prints "List the voices: exodus video swipe sheet voices <swipeId>". A
820
+ pick is a set (`who=<n>`, `voice=<n>`), and the video is filmed with that
821
+ person, their face and that voice. If the server says these choices are not
822
+ switched on yet, say so and go on with the sheet as it is.
742
823
 
743
824
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
744
825
  every video has started:
@@ -756,6 +837,38 @@ every video has started:
756
837
  or a mechanism was picked and step 5 does not apply, add one line: "The
757
838
  persona and the mechanism are noted, not used: the video writer does not
758
839
  read them yet."
840
+ For a kind whose write makes people (People, step 3), run the yes line
841
+ the dry write printed: `--yes --people-max-usd <most>`, or `--yes
842
+ --no-people` when the member wants none. A plain `--yes` makes no people,
843
+ and the write then says so: "No people to pick from were made with this
844
+ write: its yes carried no --people-max-usd. See their price (free): …".
845
+ With the figure, the write waits for the people (a line ending "Waiting for
846
+ them, up to 5 minutes."), then prints how their ask ended and each person
847
+ with their picture's address. Show each person's name and picture. Read the
848
+ write's own lines; never assume one is recommended. When the ask names one
849
+ ("Person N is recommended." and why), the write says "A start with no pick
850
+ films person N, the recommended one." When it names none, it says "… films
851
+ a new person cast from …, not one of these. To film one of them (free):
852
+ exodus video swipe sheet set <swipeId> who=<n>": tell the member that a
853
+ start with no pick films none of the people shown, and set `who=<n>` only
854
+ on their word. When none were made, it prints the server's sentence for
855
+ that (it says why when the server knows, as for a script that keeps no type
856
+ of their speaker) or "No people were made with this write, and nothing was
857
+ paid for them.", then "Ask for them (the price first, free): exodus video
858
+ swipe sheet people <swipeId>". After 5 minutes it prints "Still not done
859
+ after 5 minutes: …" with what the server last said, then "See them: exodus
860
+ video swipe sheet <swipeId>" (when the server said nothing: "The people are
861
+ still being made. See them: …"): the write is done, so read the sheet a few
862
+ minutes later.
863
+ For a kind whose sheet has these rows (One-take UGC today), the write may
864
+ also write our own text card and pick a kind of opening. They show on the
865
+ saved sheet as `headline` and `hookKind`, marked recommended. When one was
866
+ left out, Changed ends with a note. "We left out the text card we wrote:
867
+ <why>. The video has no text card.": tell the member in one line; they may
868
+ write their own card (`headline="<words>"`) or leave the video with none.
869
+ "We left out the kind of opening we picked: <why>. The sheet's kind of
870
+ opening row keeps its default.": tell the member; they may set `hookKind`
871
+ to a kind the row lists, or leave the default.
759
872
  The write's last line says "Start the video (paid; ask first)": the
760
873
  sheet's yes was that ask, so start now, with the line below, not the
761
874
  write's own, which leaves out `--one-shot`. For a kind with a saved
@@ -766,7 +879,12 @@ every video has started:
766
879
  `--music` when they chose music. For a kind with a saved sheet whose price
767
880
  printed a number, add `--max-usd <n>` with the "at most" it showed: a
768
881
  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
882
+ number printed: no `--max-usd`, and never a guessed one. When the sheet
883
+ has people, the start says first whom it films ("A start with no pick
884
+ films person N, the recommended one.", or the member's pick). While they
885
+ are still being made it says "People to pick from are being made for this
886
+ swipe. The start waits for them, …", waits until 5 minutes after they
887
+ were asked for, then starts and says whom it films. Give the member the
770
888
  `Watch it:` link at once. Then go on to the next video.
771
889
  3. When every video has started, follow each run with `exodus video status
772
890
  <runId>` and do what it prints. A one-shot run that waits for a cut goes
@@ -793,12 +911,55 @@ and its `Watch it:` link, or why it stopped.
793
911
  approve". It is one way. A redo of a clip there needs its own yes.
794
912
 
795
913
  **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.
914
+ every video is in the report at the end. A refused write prints "The writer
915
+ refused:" and its sentence (on an admin key, then "What the checks found:"),
916
+ its swipe id, what it cost, "Nothing was started." and "Writing again is paid
917
+ too: the same exodus video swipe write line, after the member's yes.". Report
918
+ all of it for that video.
919
+
920
+ A refusal for claims reads "Your product sheet doesn't back up …" and names
921
+ up to two held lines, each with why in brackets: `it says "…", which we
922
+ couldn't find on the sheet`; `… which the sheet says, but we couldn't find it
923
+ in the part we matched to this claim`; `we found no one sentence of the sheet
924
+ that backs "…" as the line says it`; `it still hedges or repeats a word of
925
+ "…", the claim we rewrote it from`; `it names the product next to a line we
926
+ took out, so it reads as that line's claim`; or, for a shot, `it shows a
927
+ result, "…", in so many words, and we never back a shot that does, whatever
928
+ the sheet says`. More lines end "and N more (the dashboard lists every one)".
929
+ Give the member the way out the refusal ends with:
930
+
931
+ - When it ends "If it's true, add the line's own words to your product's
932
+ description (on the dashboard: Library, Materials, Brand info, then the
933
+ product's Edit), then write again." (or "If a line is true, …", or "If a
934
+ spoken line whose claim we couldn't find on the sheet is true, …"): ask
935
+ the member whether that line is true of their product. Only if it is, they
936
+ add the line's own words to the product's description at that place. Then,
937
+ on their yes, run the same write line again.
938
+ - When it ends "Write again." alone, no held line can be backed by the
939
+ description: on the member's yes, run the same write line again.
940
+ - "… a price or code your product sheet doesn't list. If it's right, add it
941
+ to your product's description (…), then write again.": the same, for that
942
+ price or code.
943
+ - "The script we wrote left out …, and at closeness … every beat stays. …":
944
+ the member adds what that beat can say to the product's description, or
945
+ picks closeness 4 or 5, where beats can merge or drop. Then write again on
946
+ their yes.
947
+ - "Your script says "…", from their ad or a price or code your product sheet
948
+ doesn't list. We never change your words, so take it out, then try again.":
949
+ the member's own script holds those words. They take them out of the file,
950
+ and you write again on their yes.
951
+ - Any other sentence: say it as it is, and write again only on their yes.
952
+
953
+ **Never write around a refusal yourself.** Do not pass the refused script,
954
+ its held lines, or lines you wrote, to `--mode their-format --script`. The
955
+ way out is the one the refusal ends with, above.
956
+
957
+ A refused start prints its sentence: report it for that video. When it says
958
+ a row of the sheet "holds words it no longer takes" (what the person holds,
959
+ for one), nothing was paid: change that row only on the member's word (their
960
+ new words, or `prop=none`), then start again on their yes. A one-shot run
961
+ whose checks find a problem stops for the member: show what `status` prints
962
+ and ask.
802
963
 
803
964
  ### 5. With a persona or a mechanism: the text swipe bot
804
965
 
@@ -956,11 +1117,11 @@ noted only.
956
1117
  ### Step by step: a yes before each paid step
957
1118
 
958
1119
  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.
1120
+ price for any of them but the people a write makes and the start of a kind
1121
+ with a saved sheet. Run each one first without `--yes`: it sends nothing and
1122
+ prints what the step buys and who pays. Tell the member both, and the price
1123
+ when it prints one, else say the CLI prints no price; never guess one, and run
1124
+ the same line with `--yes` only after their yes.
964
1125
 
965
1126
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
966
1127
  Instagram or YouTube), or a video ad in the brand's swipe library by the
@@ -985,9 +1146,14 @@ only after their yes.
985
1146
  2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
986
1147
  member's own Anthropic or OpenRouter key. It prints the kind of ad and the
987
1148
  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").
1149
+ the member the kind and the look, and the "Also fits their ad: …" line when
1150
+ it prints one (the One-take UGC row under "3. The sheet, once" says what to
1151
+ do with it). The swipe writes the kind it was matched to, or the one the
1152
+ write names with `--kind`, and no other: name another kind only on the
1153
+ member's yes. A kind this ad can't be made as is refused before the write
1154
+ is paid, with the kinds it can be made as. For any other kind, stop here
1155
+ and make the video from that format with the ad's words instead ("From one
1156
+ sentence to a film").
991
1157
  3. **The choices.** `exodus video swipe products` lists the brand's
992
1158
  products. Ask which product, what to swipe and how close. What to swipe
993
1159
  (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
@@ -996,13 +1162,21 @@ only after their yes.
996
1162
  2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
997
1163
  has each one's line.
998
1164
  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.
1165
+ [--mode …] [--closeness …]`, paid on the member's own key. It takes four to
1166
+ nine minutes and waits by itself. Show the member the script, the
1167
+ direction, Kept and Changed, and what it cost. When the line without
1168
+ `--yes` also prints the people's price (One-take UGC, when the server
1169
+ offers people), it prints the yes line with `--people-max-usd <most>`: tell
1170
+ the member that price, and run that line on their yes, or `--yes
1171
+ --no-people` when they want none. When it prints none, the write makes no
1172
+ people. With people, the write then waits up to 5 minutes more for the people and
1173
+ shows them, as step 1 of "On the yes" says. A refusal prints the writer's
1174
+ sentence and "Nothing was started.": tell the member, give them the way out
1175
+ the sentence ends with ("A refusal or a failed check" in "On the yes"), and
1176
+ write again, which is paid too, only on their yes. If the wait gives up,
1177
+ the write may still finish: run `exodus video swipe list` before writing
1178
+ again. It shows the brand's newest swipes, and a refused one is marked with
1179
+ what it cost.
1006
1180
  5. **The start.** `exodus video swipe start <swipeId>`. It buys the
1007
1181
  storyboard and its pictures; the voices and clips wait for the storyboard's
1008
1182
  yes. `--style <look>` changes the look, `--music` adds a music bed.
@@ -1030,15 +1204,19 @@ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown st
1030
1204
  --full adds what it read: shots, script, cast, filming
1031
1205
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
1032
1206
  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
1207
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes [--people-max-usd <n>]] [--no-people]
1208
+ the brand's version (member's key); waits for it. For a kind
1209
+ whose write makes people (when the server offers them),
1210
+ without --yes it also prints their price, and --yes
1211
+ --people-max-usd <n> makes them too
1035
1212
  exodus video swipe show <swipeId> one swipe again
1036
1213
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
1037
1214
  a refused one shows what it cost
1038
1215
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
1039
1216
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
1040
1217
  start the run on the kind the swipe wrote; --again for a
1041
- second, paid video of a swipe that already has one
1218
+ second, paid video of a swipe that already has one; waits
1219
+ up to 5 minutes for people still being made
1042
1220
  exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1043
1221
  no dashboard page shows it yet
1044
1222
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
@@ -1046,8 +1224,10 @@ exodus video swipe sheet price <swipeId> the video's price at t
1046
1224
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1047
1225
  new people to pick from (paid on the member's keys: the
1048
1226
  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
1227
+ exodus video swipe sheet voices <swipeId> the voices that fit the person, best fit first, each with its
1228
+ sample (and its age and accent when known), and the one the
1229
+ row recommends, if any: one read of the voice list on the
1230
+ member's ElevenLabs key, no speech; voice=<n> picks one
1051
1231
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
1052
1232
  ```
1053
1233
 
@@ -1356,6 +1536,19 @@ under it:
1356
1536
  and ask them to watch the take. With their yes, `exodus video keep <runId>
1357
1537
  --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1358
1538
  take starts the cut. Otherwise a new run films it again.
1539
+ A take held for its label has a sentence that begins "The label check
1540
+ read the product's label as mirror writing in take N", says why it was not
1541
+ fixed (a flip would turn the room around against the other takes, the take
1542
+ could not be flipped, or a second look could not make sure), and ends with
1543
+ its two ways out. Give the member both, in its own words. Keep it, on their
1544
+ yes (`exodus video keep <runId> --scene <n>`), and the film shows the label
1545
+ as it is in the take. Or start a new
1546
+ run, which films every take again at its full price: for a swiped video,
1547
+ `exodus video swipe start <swipeId> --again`, first without `--yes` for its
1548
+ price, then the line it prints, on their yes. The new start keeps none of
1549
+ the first start's flags: give it `--one-shot` and `--music` again when the
1550
+ first had them, in that dry line too (without `--one-shot` it stops at the
1551
+ storyboard).
1359
1552
  - paused: a builder checkpoint neither video verb resolves —
1360
1553
  `exodus workflow checkpoint <runId>` is the verb for that one.
1361
1554
  - failed: `status` shows how far it got, and a `--wait` that was running exits
@@ -1369,6 +1562,17 @@ under it:
1369
1562
  says instead that a retry stops the same way, the orders may already be
1370
1563
  paid for: only a new start draws the picture (`exodus video swipe start
1371
1564
  <swipeId> --again` says its price before it pays for anything).
1565
+ - A picture no retry can order: its sentence says "A retry of this step
1566
+ stops the same way, since those orders may already be paid for. Start
1567
+ the video again instead: …". Do not retry: it stops the same way, and
1568
+ `status` offers no retry for it. From here, the new start of a swiped
1569
+ video is `exodus video swipe start <swipeId> --again`. Run it first
1570
+ without `--yes`: it sends nothing and prints the whole video's price (the
1571
+ pictures, the takes and the text calls are all paid again) and the line
1572
+ to run. Tell the member the price, and run that line only on their yes.
1573
+ The new start keeps none of the first start's flags: give it
1574
+ `--one-shot` and `--music` again when the first had them, in that dry
1575
+ line too (without `--one-shot` it stops at the storyboard).
1372
1576
  - The connection to the text model dropped twice: the retry asks again and
1373
1577
  keeps what was already written. The storyboard already asked once more
1374
1578
  by itself after the first drop.
@@ -0,0 +1,82 @@
1
+ /** COP-300: two sync checks on a finished cut, in numbers only (first-cut-sync.mjs). */
2
+
3
+ /** Check A's limit: the finished sound and picture end at most this far apart. */
4
+ export const SOUND_PICTURE_LIMIT_MS: number;
5
+ /** Check B's default limits. */
6
+ export const CAPTION_SYNC_LIMITS: Readonly<CaptionSyncLimits>;
7
+ /** A section is judged on at least this many paired captions. */
8
+ export const MIN_SECTION_CAPTIONS: number;
9
+
10
+ export interface CaptionSyncLimits {
11
+ /** The most a section's median offset may be, either way, in ms. */
12
+ sectionMs: number;
13
+ /** The most the median offset may grow from the first judged section to the last, in ms. */
14
+ growthMs: number;
15
+ }
16
+
17
+ /** A caption and the time it is first seen in the finished film. */
18
+ export interface SeenCaption {
19
+ text: string;
20
+ seenSec: number;
21
+ }
22
+
23
+ /** A word of the finished film and when it starts (and ends) there. */
24
+ export interface HeardWord {
25
+ text: string;
26
+ start: number;
27
+ end?: number;
28
+ }
29
+
30
+ export interface SyncSection {
31
+ id: number | string;
32
+ startSec: number;
33
+ endSec: number;
34
+ }
35
+
36
+ /**
37
+ * Check B's verdict, each section judged on its median offset. `pass` covers the judged sections and is null when none
38
+ * was judged; `unjudged` names the sections that hold captions but too few paired ones to judge.
39
+ */
40
+ export interface CaptionSyncVerdict {
41
+ pass: boolean | null;
42
+ worstMs: number | null;
43
+ worstSection: number | string | null;
44
+ growthMs: number | null;
45
+ judged: Array<number | string>;
46
+ unjudged: Array<number | string>;
47
+ limits: CaptionSyncLimits;
48
+ captions: number;
49
+ paired: number;
50
+ sections: Array<{ id: number | string; captions: number; n: number; judged: boolean; meanMs: number | null; medianMs: number | null }>;
51
+ rows: Array<{ text: string; seenSec: number; heardSec: number; offsetMs: number }>;
52
+ }
53
+
54
+ /** Check A's numbers: the film's frames against its decoded sound samples. */
55
+ export interface SoundPictureCheck {
56
+ frames: number;
57
+ fps: number;
58
+ pictureSec: number;
59
+ samples: number;
60
+ sampleRate: number;
61
+ soundSec: number;
62
+ soundMinusPictureMs: number;
63
+ limitMs: number;
64
+ pass: boolean;
65
+ }
66
+
67
+ export function wordKey(text: string): string;
68
+ export function alignWords(a: readonly string[], b: readonly string[]): Array<[number, number]>;
69
+ export function captionSync(args: {
70
+ captions: readonly SeenCaption[];
71
+ heard: readonly HeardWord[];
72
+ sections: readonly SyncSection[];
73
+ limits?: CaptionSyncLimits;
74
+ minCaptions?: number;
75
+ }): CaptionSyncVerdict;
76
+ export function soundPictureCheck(file: string, options?: { limitMs?: number }): SoundPictureCheck | null;
77
+ export function placementHeard(args: {
78
+ film: string;
79
+ speed?: number;
80
+ takes: ReadonlyArray<{ file: string; heard: readonly HeardWord[]; words: readonly HeardWord[] }>;
81
+ }): Array<{ text: string; start: number; end: number; lagMs: number; match: number }>;
82
+ export function retimeWords<T extends { text: string; start: number; end: number }>(rows: readonly T[], heard: readonly HeardWord[], speed?: number): T[];