@aicopycoders/exodus 2026.11.1200-beta.3 → 2026.11.1200-beta.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: exodus-video
3
- description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. A UGC script with no video ("write me a UGC script", "swipe this UGC ad" for a script) is `ugc-ads`, and the separate UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`, not this skill. A timeline ad asked for without "exodus" ("make me a timeline ad", "turn this winning ad into timeline ads") is `timeline-ad-factory`, on the member's own Kie.ai key; "exodus, make a skeleton timeline video" stays here. A competitor's video ad (a file, a link, or an ad in Exodus) is swiped with `exodus video swipe`, as Swipe a video does on the dashboard: broken down, matched to a kind of ad, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, swipe, status, storyboard, approve, voices, retry-frame, pull and upload on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
3
+ description: Make a video ad with Exodus from the terminal, a UGC talking-head video included. A competitor's ad swiped into a video for the member's brand comes here, with or without the word "exodus": their ad given as a video file or a video link with a video wanted or an ad in Exodus, or a video or a size asked for with an ad to swipe ("swipe this ad for my brand as a UGC video like theirs: their-ad.mp4, make it at 720p"). It runs `exodus video swipe`, as Swipe a video does on the dashboard; with no ad named ("find some ads to swipe for this product") it offers ads from the brand's swipe library (`exodus video swipe find`). Also here: a video run checked or waited on ("exodus, is my video run done", `exodus video status`), its pieces pulled ("pull the pieces", `exodus video pull`), a cut made or uploaded ("make the cut", "upload my cut"), and the script-first run of a saved video workflow (`exodus workflow run`, "exodus, make a video ad from this script"). Admins get every video command; beta testers with Video switched on get the swipe and their own runs' commands. Not this skill: a UGC script with no video ("write me a UGC script") is `ugc-ads`; the UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`; a timeline ad asked for without "exodus" is `timeline-ad-factory` ("exodus, make a skeleton timeline video" stays here); a link for copy is `swipe`; generic editing ("edit this mp4") without Exodus context is not Exodus.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -8,14 +8,17 @@ description: Make a video ad with Exodus from the terminal. One sentence ("swipe
8
8
  Exodus makes the PIECES of a video ad, not the finished ad. From a script, a run
9
9
  writes a storyboard, draws one picture per scene, records the voice, renders one
10
10
  video clip per scene, and generates a music bed. Then it parks and waits for a
11
- cut.
11
+ cut (the app makes it for some runs, below).
12
12
 
13
- There is no server-side stitch and no server-side mix. Nothing joins the clips,
14
- nothing sets levels, nothing burns in captions
13
+ On a run you cut (an admin's run started with `exodus video start` or
14
+ `workflow run`), there is no server-side stitch and no server-side mix.
15
+ Nothing joins the clips, nothing sets levels, nothing burns in captions
15
16
  (`scout/src/workflow/video/music-bed.ts` states the ruling: "the cut, and the
16
17
  mix, happen outside from the pieces the CLI pulls"). You pull the pieces, cut
17
18
  them wherever you like, and upload the result. Approving the upload is what
18
- makes it the ad.
19
+ makes it the ad. The app cuts the others itself: a swiped video, a video from
20
+ the dashboard's Video page and a beta tester's run ("End: watch and
21
+ approve").
19
22
 
20
23
  Your job in this skill is to drive that loop, hand over the pieces with the
21
24
  facts about them, and make whatever cut the user asked for. **How to edit is the
@@ -42,7 +45,7 @@ wrong one.
42
45
  server's list is the truth, and nothing prints it on request. Pass a key it
43
46
  doesn't offer and the refusal names every key it does: `video start --conceit
44
47
  must be one of …`. Nothing is spent on a refused start. Today the server offers
45
- 15 formats and then Custom:
48
+ these formats and then Custom (One-take UGC to admins only, for now):
46
49
 
47
50
  | Key | Kind |
48
51
  |---|---|
@@ -61,8 +64,27 @@ must be one of …`. Nothing is spent on a refused start. Today the server offer
61
64
  | `infomercial` | Infomercial |
62
65
  | `dating-show` | Dating Show |
63
66
  | `game-show` | Game Show |
67
+ | `doorbell-cam` | Doorbell Cam |
68
+ | `reality-confessional` | Reality Confessional |
69
+ | `movie-trailer` | Movie Trailer |
70
+ | `sitcom-skit` | Sitcom Skit |
71
+ | `press-conference` | Press Conference |
72
+ | `stand-up-special` | Stand-up Special |
73
+ | `whisper-asmr` | Whisper ASMR |
74
+ | `unboxing` | Unboxing |
75
+ | `doctor-consult` | Doctor's Office Consult |
76
+ | `documentary-sit-down` | Documentary Sit-down |
77
+ | `microdrama` | Microdrama |
78
+ | `pixar-song` | Suno Pixar Song |
79
+ | `skeleton-timeline` | Skeleton / Claymation |
80
+ | `authority-yapper` | Authority Yapper |
81
+ | `ugc-ultra-realistic` | UGC Ultra-Realistic |
82
+ | `ugc-one-take` | One-take UGC |
64
83
  | `custom` | Custom |
65
84
 
85
+ A swipe's template prints its kind by one of these keys
86
+ (`ugc-ultra-realistic`, say).
87
+
66
88
  Custom builds the ad from the script itself. A script with no `CAST:` runs as a
67
89
  voice-over, and a script with people runs as a scene. Voice-over and Scene are
68
90
  not on the menu by name; Custom is the way to them. A narrator-only script fits
@@ -83,7 +105,11 @@ The member types one sentence, such as "swipe this ad as a microdrama for my
83
105
  brand". You drive the run through its stops and wait for the member at each
84
106
  one. When the sentence names a video ad to swipe as it is made (a video file,
85
107
  a link to the ad, or an ad in Exodus) and the member asks for no format of
86
- their own, go to "Swiping a video ad" below instead. The Golden Six formats start on the template door, which needs
108
+ their own, go to "Swiping a video ad" below instead. Words that say how their
109
+ ad is made are not a format of their own: "as a UGC video, one person talking
110
+ to the camera, like theirs" goes to the swipe, whose template reads the kind
111
+ from the ad. A format of their own is one their ad is not made as, or a
112
+ template the member names as one ("the UGC template"). The Golden Six formats start on the template door, which needs
87
113
  Templates switched on for the member's account. Without it the CLI answers
88
114
  "video isn't enabled for this key" or "Templates aren't available on your
89
115
  account. Ask an admin if you need it." Tell the member that and stop. A beta
@@ -129,8 +155,8 @@ does offer, and nothing is spent.
129
155
  Exodus or behind a link (the `swipe` skill's section 1 gets them). Save
130
156
  the words to `source.txt`. A video ad the member wants swiped whole, its
131
157
  kind and look and shots as well as its words, goes to "Swiping a video
132
- ad" below. That path picks the kind itself, so a member set on one of the
133
- Golden Six stays here.
158
+ ad" below. That path picks the kind itself, so a member set on a format
159
+ of their own (as above), one of the Golden Six among them, stays here.
134
160
  - the format: the table above.
135
161
  - the brand: `exodus brand current`.
136
162
  2. `exodus video start --input-options --conceit <key>` prints the template's
@@ -261,7 +287,13 @@ move someone (Micro-drama template only), or stop.
261
287
  (with the pilot stop, the pilot first), the expensive part. The CLI prints
262
288
  no price for them at this stop: say so, and approve on their yes. A storyboard the app's check stopped is
263
289
  refused with the reason. Tell the member, and on their yes approve again
264
- with `--accept-findings`.
290
+ with `--accept-findings`. A `--one-shot` run stops here too when the check
291
+ before pictures finds a problem: `status` prints what it found, scene by
292
+ scene. Show it to the member; accepting it is their call, never yours.
293
+ When `status` also says the plan broke one of the app's planning rules,
294
+ accepting draws the scene pictures and the video stops once more at them,
295
+ so the member looks at the pictures before anything is filmed. That second
296
+ stop is a normal storyboard review: show it and approve only on their yes.
265
297
  - Redo a picture: `exodus video retry-frame <runId> --node <nodeId> --scene <n>
266
298
  --note "<what is wrong>"`, with the node id from the `Redo one frame:` line
267
299
  `status` printed. It redraws one picture. The CLI prints no price for it:
@@ -331,14 +363,59 @@ the audition scenes and prints what to run next:
331
363
  ### End: watch and approve
332
364
 
333
365
  At the final watch, follow the block `status` prints ("Where a run can
334
- stop"). When the cut is already uploaded, give the member the run page to
335
- watch it. When the run waits for a cut: `exodus video pull <runId> --out ./ad-<runId>`, make the
336
- cut ("Cutting the ad"), `exodus video upload <runId> --file <cut.mp4>`, and
337
- give the member the run page. Ask: approve, redo a clip, or stop here.
338
-
339
- - Approve: `exodus video approve <runId>` makes the cut the ad. It is one-way.
340
- - Redo a clip: `retry-clip` as at stop 4, after their yes. Then pull, cut
341
- and upload again.
366
+ stop"). Who makes the cut, and whether the member approves it, depends on how
367
+ the run started:
368
+
369
+ - **The app makes the cut** of a swiped video, a video from the dashboard's
370
+ Video page and a beta tester's run, once every clip is made and no scene is
371
+ held. While it makes it, `status` on an admin key says "Every piece is
372
+ made. The app makes the cut now; look again in a minute: exodus video
373
+ status <runId>": make no cut of your own, and read `status` again in a
374
+ minute. `exodus video wait <runId>` waits through it. On a run started with `--one-shot` that cut is delivered by itself,
375
+ with no approve: on an admin key `status` then says "Final cut: approved
376
+ and delivered.", and on a beta tester's key "Your video is ready: <link>".
377
+ In the minute between the cut and the delivery, `status` on an admin key
378
+ says "Final cut: made. This run delivers it by itself; look again in a
379
+ minute.": read it again then, and send no approve. Only when the app's check of the finished film against its own sound fails
380
+ (One-take UGC checks it) does a One-shot cut wait instead, as a Guided one
381
+ 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
382
+ the last held take, since that keep starts the cut. Say so at each. Give
383
+ the member the run page to watch the film. A run that stopped at the
384
+ storyboard waits for the member instead: on an admin key `status` says
385
+ "Final cut: made by the app. Approve it with: exodus video approve <runId>"; on a
386
+ beta tester's key it says "Your video is ready to watch: <link>" and gives
387
+ the line that finishes it, `exodus video approve <runId>` (the video's page
388
+ finishes it too).
389
+ - **You make the cut** of any other run (an admin's `video start` or
390
+ `workflow run`). When the cut is already uploaded, give the member the run
391
+ page to watch it. When the run waits for a cut: `exodus video pull <runId>
392
+ --out ./ad-<runId>`, make the cut ("Cutting the ad"), `exodus video upload
393
+ <runId> --file <cut.mp4>`, and give the member the run page. On a run
394
+ started with `--one-shot` the upload is delivered by itself, as above.
395
+
396
+ When the cut waits for the member, ask: approve, redo a clip, or stop here.
397
+ On a One-take run no take is made again on its own (every redo door refuses
398
+ it): ask approve, a new run that films every take again at its full price
399
+ (for a swiped video, `exodus video swipe start <swipeId> --again`, its price
400
+ first), or stop here.
401
+
402
+ `pull` also writes the finished video as `video.<ext>` once the run has one,
403
+ on an admin key as on a beta tester's. On a delivered run it ends "This run
404
+ is delivered. The finished video is <file>.": give the member that file and
405
+ the run page to watch it. On a run the app cuts, once every piece is made
406
+ and until it is delivered, it ends with no upload line: make no cut of your
407
+ own, unless `status` says the app's cut didn't work and offers you to cut it
408
+ yourself, and the member says yes.
409
+
410
+ - Approve: `exodus video approve <runId>` makes the cut the run's finished
411
+ video. Unless the run started from a template, it can't be undone; a change
412
+ after it is a new run. Nothing is posted to an ad account. The video stays
413
+ on the run page and in Video → Your ads, and `pull` saves it. A workflow
414
+ whose Output names a Drive folder, or that has a webhook, also sends it
415
+ there.
416
+ - Redo a clip: `retry-clip` as at stop 4, after their yes. On a run the app
417
+ cuts, it cuts again by itself (read `status`); on any other, pull, cut and
418
+ upload again.
342
419
 
343
420
  **On the song format**, tell the member this before they approve: "The song
344
421
  made here is for review. Before this video runs as a paid ad, make the same
@@ -348,38 +425,124 @@ on those plans and downloaded from Suno."
348
425
 
349
426
  ## Swiping a video ad
350
427
 
351
- What Swipe a video does on the dashboard, from the terminal. Exodus breaks the
428
+ What Swipe a video does on the dashboard, from the terminal: Exodus breaks the
352
429
  competitor's ad down, matches it to the closest kind of ad and look it makes
353
430
  (the template), writes the brand's version, and starts the video on the kind
354
- the swipe wrote. The run is the same one Swipe a video starts on the
355
- dashboard.
431
+ the swipe wrote, the same run Swipe a video starts on the dashboard.
356
432
 
357
433
  These steps need Video switched on for the member's account. Without it every
358
434
  swipe command answers "Not found on this brand. The id is wrong or is another
359
435
  brand's, video isn't switched on for your dashboard user, or this is not the
360
436
  brand you meant (exodus brand current). Check the id first." Check the id and
361
437
  the brand. If both are right, tell the member Video isn't switched on for
362
- them, and stop.
363
-
364
- This path has no picks stop and no pilot clip. The run goes from the start
365
- straight to the storyboard (stop 3), and approving the storyboard makes every
366
- clip. A run started with `--one-shot` approves its own storyboard when its
367
- checks pass. Making the video from one of our formats (`--adapt`, "From one
368
- sentence to a film") keeps the picks stop and the pilot clip.
369
-
370
- By default a swipe is one round: you read the ad, send the member one sheet,
371
- and on their one yes write the brand's version and make each video they
372
- picked. When the member names no ad, the options come first (step 0): video
373
- ads from the brand's swipe library to pick from. A member who asks to say yes
374
- before each paid step gets "Step by step" below.
438
+ them, and offer `ugc-swipe` (the script) instead of stopping: it swipes their
439
+ ad's words into a script for their product, with no video. Offer it too when
440
+ they want only the words.
441
+
442
+ This path has no picks stop and no pilot clip: the run goes from the start
443
+ straight to the storyboard (stop 3), whose approve makes every clip, and a
444
+ `--one-shot` run approves it itself when its checks pass. A video made from
445
+ one of our formats (`--adapt`, "From one sentence to a film") keeps both.
446
+
447
+ By default a swipe is one round: read the ad, one question with the plan, and
448
+ on its yes write and make each video. When the member names no ad, the
449
+ options come first (step 0); "Step by step" asks before each paid step.
450
+
451
+ **How it talks.** Seven rules; the screens below are their templates (the
452
+ question's text, options and money line as written; the message in your words).
453
+
454
+ 1. **Decide, then show.** Pick every row you can (how close, where it stops,
455
+ music, the product, the recommended person and voice); the member edits it.
456
+ Rows that do nothing today (persona and mechanism while noted, not read;
457
+ the "not yet" lists) stay off the first screen.
458
+ 2. **Text first, then the question, in one reply.** The picker shows only its
459
+ question's text and each option's label and description, so a plan you
460
+ only thought never reaches the screen. Write the message as plain text
461
+ first (one or two lines: what you read, rule 7's cue; never the plan
462
+ twice), then call `AskUserQuestion`: its text holds the plan and the money
463
+ line in at most 3 short lines, then the question. No paragraph of reasons.
464
+ 3. **Ask with the `AskUserQuestion` tool** (1 to 4 questions, 2 to 4 options
465
+ each, a header of at most 12 characters, one line of description an option;
466
+ it adds "Other" by itself), the recommended option first with
467
+ "(Recommended)" only for a real reason. Where the tool is not there (it
468
+ errors, in a subagent, on a host without it), send the question's text and
469
+ the same options as a short numbered list after the message. A typed answer
470
+ always works. Step 0's six options stay a numbered list. One real option
471
+ gets a second ("Stop here", "None"). A row of more than four values (how
472
+ close has five; a long product or voice list) shows what it is now and the
473
+ nearest two or three, and names the rest in the question's text ("also:
474
+ Same arc") for "Other", or goes as a numbered list.
475
+ 4. **The option that spends carries its price in its label**, in the CLI's own
476
+ figures, or "no printed price" where it prints none: a verb, what it buys
477
+ in two or three words, the price. Its description starts with what it buys
478
+ in full. Never a figure you worked out, never a formula.
479
+ 5. **One money line**, in each paid step's question's text, right before the
480
+ question, and at the end: `Spent so far: $<X>`, each cost line the CLI
481
+ printed counted once, with whose money it was (never the team's and the
482
+ member's added up), and in brackets what printed no cost: `Spent so far:
483
+ $<X> on the team's keys for reading their ad (the template, on your model
484
+ key: not printed)`. On a run whose `status` prints "Cost so far:" or "Cost:"
485
+ (an admin key), of a kind whose price the member said yes to: `Spent $<X> of
486
+ about $<Y>`, X that line's figure, Y that price's "about". With no such
487
+ line, "the run's cost is not printed": never a figure, never that it was
488
+ free. Who pays is said once: the read's line (step 1), then the sheet's
489
+ spending option ("on your own keys", naming the Kie and ElevenLabs keys a
490
+ kind needs). Say a cost as the CLI printed it, each once ("It cost $<X> on
491
+ the member's key."): never a range, an average or an "about" of your own.
492
+ 6. **Progress is one line; a problem is two lines and a question** (step 4).
493
+ Narrate no command; wait on a run in the background (`exodus video wait
494
+ <runId>`) and speak when it is delivered or stops.
495
+ 7. **Details on request**, named once on the first screen: "show sheet", "show
496
+ script", "show people", "why" (step 3).
497
+
498
+ Rule 4's spending options, each figure the one the CLI printed for this swipe.
499
+ An option that runs a `--yes` line and has no row still carries the CLI's
500
+ figures or "no printed price" in its label, not only in its description:
501
+
502
+ | Ask | Label | Its description starts |
503
+ |---|---|---|
504
+ | The sheet | `Make 1 video · no printed price` (above 6: `Make 8 videos · no printed price`) | 1 script, then the video to its storyboard; the voices and clips wait for your yes there (one shot: the whole video, with no final approve). On your own keys. |
505
+ | The sheet, a write that makes people | `Write it · people about $…, at most $…` | 1 script (no printed price), <k> people to pick from, and the animal's picture ($…) if the script has one. The film waits for your yes on its price. |
506
+ | "Film it?" | `Film it · about $…, at most $…` | <k> takes at <size>. The cut plays them a little faster and shortens long pauses (unless the sheet's speed or pauses row says otherwise), so the video is shorter than its takes and can be shorter than their ad. … Not in the price: text calls on your model key, the word check on your ElevenLabs key, a second listen on your Kie key. |
507
+ | Their look | `Their look · about $…, at most $…` | One read of their speaker's look, then <k> new people and a check of their faces. Never their face. |
508
+ | More people | `<n> more people · at most $…` | <n> new people to pick from, on your model and Kie keys. Nothing is filmed. |
509
+ | A hold | `Film every take again · about $…, at most $…` | A new video from the same swipe. One take cannot be filmed alone. |
510
+ | A refused write | `Write again · no printed price` (with people: `Write again · people about $…, at most $…`) | The same write again, on your model key. A refused write is paid too. |
511
+ | Your own script | `Use my own script · no printed price` | Your lines word for word, made the way their ad is made, on your model key; people only when the script keeps their speaker's type. |
512
+ | Step by step; the read past its limit or again (step 1); a start on its own (a refused start, step 5's check) | `Read the ad · no printed price`, `Read the rest · <what is left> · no printed price`, `Read it again · no printed price`, `Make the template · no printed price`, `Write it · no printed price`, `Start it · no printed price` | What the line without its yes printed that it buys, and who pays: each breakdown on the team's keys, each template and write on your model key. A write with people is the sheet's "Write it" row; a start of a kind with a saved sheet, the "Film it?" row. |
513
+ | Mining (step 0) | `Mine them · no printed price` | Every active competitor on the watchlist, up to 50 in one run, on your Scrape Creators key. It starts at once. |
514
+ | The bot again (step 5) | `Call the bot again · no printed price` | One more text swipe call, on your Genesis and model keys. |
515
+
516
+ **What a yes is, at every question on this path**: the sheet, "Film it?", a
517
+ stop's "What now?", Their look, more people, and the storyboard stop and the
518
+ end approve when a swipe's run reaches them ("Stop 3: the storyboard" and "End:
519
+ watch and approve" say what each shows). Each paid
520
+ line (`--yes`, or an `approve` that buys) runs only after the member pressed an
521
+ option whose own label names what it buys and its price (or "no printed
522
+ price"), or typed a yes to that option ("go", "film it"; with the picker up, a
523
+ typed answer arrives as "Other"). It buys only what the pressed label, its
524
+ description and the question's text showed: a plan pick in none of them is not
525
+ covered, so ask again with it in the question. Its `--max-usd` or
526
+ `--people-max-usd` is that label's "at most". With two options that spend, a
527
+ bare "go" names neither: ask which. None of these is a yes: a press or a typed
528
+ pick of any other option ("Show me …", "Change something", a free look,
529
+ "Stop"); "ok", "thanks", "maybe" or "looks good" after something you showed; a
530
+ question, or a reply you are not sure of; a change with no yes in it; a picker
531
+ that errored, timed out or was closed; an answer from another agent when you
532
+ run as a subagent (then run nothing paid and hand the question back). Do what
533
+ was asked, then ask the same question again, with the price read again if a row
534
+ changed.
375
535
 
376
536
  **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.
537
+ template, 15 for a write (the write always waits; it has no `--wait`) and 5
538
+ more while the people a write makes are made (up to 20 in all), and 60 for
539
+ `swipe start --wait` and for `video wait <runId>`. A start first waits up to 5 minutes while people are
540
+ still being made for its swipe, then goes on and says what it films. Run these
541
+ in the background, or leave `--wait` off and check in, so the shell's own time
542
+ limit does not cut them off. A wait that was cut off or timed out is not a
543
+ failure: the work goes on. Follow it by the id it printed, with the command
544
+ the CLI names, and never by running the paid line again: a second run buys it
545
+ a second time.
383
546
 
384
547
  ### 0. No ad named: find some
385
548
 
@@ -433,9 +596,9 @@ The rules of the options:
433
596
  **A find by kind.** When the member asks for a kind of ad ("find me some
434
597
  authority yappers"), offer at most six whose words sound like that kind, and
435
598
  say so in the message's first line, as "<kind>: sounds like, from the words;
436
- the read confirms it." After the reads, the sheet's first
437
- line names any ad the template read as another kind, so the member can drop
438
- it ("drop video 3, go" is already a yes).
599
+ the read confirms it." After the reads, the sheet's first line marks an ad the
600
+ template read as another kind in a few words ("ad 3: read as <kind>"), so the
601
+ member can drop it ("drop video 3, go" is already a yes).
439
602
 
440
603
  **What a pick is.** Only numbers given after an options message ("1, 3 and
441
604
  5"), or "all" (the options the member last saw), are picks. The numbering
@@ -537,54 +700,60 @@ zero, and a new template is unknown.
537
700
 
538
701
  Read one ad at a time: its breakdown, then its template. Before each read
539
702
  after the first (a template, or the next ad's breakdown), stop and ask the
540
- member once when the costs counted have reached $0.50, or when any read so
541
- far is unknown: an unknown cost counts as reaching the limit. Say what is
542
- left to read. A new template is always
543
- unknown, so with several ads you read the first and ask before the rest. The
544
- check comes before each read, so the total can pass $0.50 by one read. Ads
545
- the member picked by number from the options (step 0), or with "all", are
546
- already a yes to read: read every picked ad without this ask. The ask still
547
- comes before any ad they did not pick.
548
-
549
- A breakdown or a template that fails prints why. With one ad, tell the
550
- member and stop. With several, leave that ad out, say so in the sheet's first
551
- line, and go on with the others. Reading again is paid too, and needs their
552
- yes.
703
+ member once when the costs counted have reached $0.50, or when any read so far
704
+ is unknown: an unknown cost counts as reaching the limit. Say what is left to
705
+ read. A new template is always unknown, so with several ads you read the first
706
+ and ask before the rest. The check comes before each read, so the total can
707
+ pass $0.50 by one read. Ads the member picked by number from the options (step
708
+ 0), or with "all", are already a yes to read: read every picked ad without
709
+ this ask. The ask still comes before any ad they did not pick. Ask it as a
710
+ question whose text ends with the money line: "Read the rest · <what is left>
711
+ · no printed price", or "Stop here".
712
+
713
+ A breakdown or a template that fails prints why. With one ad, tell the member
714
+ and stop. With several, leave that ad out, mark it in a few words on the
715
+ sheet's first line ("ad 2: not read"), and go on with the others.
553
716
 
554
717
  ### 2. Read the choices
555
718
 
556
- Free, and no yes: `exodus segment personas` (the saved personas; leave out
557
- the ones marked `[archived]`) and `exodus primer show` (its MECHANISM
558
- section; with no primer saved, say so once and offer only the member's own
559
- words or none). The products came in step 1.
719
+ Free, and no yes: `exodus segment personas` (the saved personas; leave out the
720
+ ones marked `[archived]`) and `exodus primer show` (its MECHANISM section;
721
+ with no primer saved, the mechanism row offers only the member's own words or
722
+ none). The products came in step 1.
560
723
 
561
724
  ### 3. The sheet, once
562
725
 
563
- Send this in one message, in this order, then stop and wait:
564
-
565
- > I read your ad as <kind of ad>, <look>, <n> lines, about <s> s. The swipe
566
- > makes that kind of ad. Say "show me" for the shot list and the script.
567
- > One sheet, answer once (my picks are marked):
568
- > 0. **Let it run** (I pick every row) or **I choose**.
569
- > 1. **Persona** (noted; the video writer does not read it yet): <your three best fits, each with a short reason>, show all <N>, or none. Pick several for one video each.
570
- > 2. **Mechanism** (noted; the video writer does not read it yet): <the primer's mechanisms>, your own words, or none.
571
- > 3. **How close:** 1 Mirror, 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only.
572
- > 4. **Characters:** the tool picks them (your saved characters: not yet).
573
- > 5. **Run:** one shot, or stop at the storyboard.
574
- > 6. **Finish:** music on or off (captions, speed, cuts: not yet).
575
- > **How many:** <n> videos = <a> ads × <p> personas:
576
- > - Video 1: <ad> × <persona>
577
- > - Video 2: <ad> × <persona>
578
- > **Cost:** no price before the write; a kind with a saved sheet gets its price after it.
579
- > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
- > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
- > with "Say yes to <n> videos, or change a row." instead.)
726
+ Send the sheet as one reply, its message as text first and its question after
727
+ it (rule 2), then stop and wait. The message:
728
+
729
+ > Read your ad: <length>, <who is in it>, <how it is cut>. (several ads: one sheet for all, a few words each)
730
+ > Say "show sheet", "show script" or "why" · "personas": <N> saved, several make one video each, <noted only | written in by the text swipe bot> (only when the brand has some) · "mechanism" (only when step 5's path is open)
731
+
732
+ Its question (`AskUserQuestion`, header "Make it?"), its text:
733
+
734
+ > <the kind the swipe makes> for <product> · Script <how close, in words> · Stop <at the storyboard, before the paid clips | at the end, with no final approve> · Music <off | on, on your ElevenLabs key>
735
+ > Videos <n> = <a> ads × <p> personas: 1 <ad> × <persona>, 2 … (only when more than one) · Persona and mechanism: <the picks>, <written in by the text swipe bot | noted only: the videos differ only as two writes do> (only when picked)
736
+ > Spent so far: $<X> on the team's keys for reading their ad (the template, on your model key: not printed). Make it?
737
+
738
+ Its options: 1. the spending option (the table) 2. another way, only when
739
+ there is one, such as One-take UGC when the template offered it 3. Change
740
+ something: the product, how close, where it stops, music 4. Stop.
741
+
742
+ "Change something" asks the rows as questions (rule 3), what each is now first,
743
+ marked "(now)", then sends the sheet again. "show sheet" prints every row as
744
+ `swipe-sheet.md` (beside this file) lays it out. "show script" is their ad's
745
+ script (`status --full`, free), and after the write the written one with its
746
+ direction, Kept and Changed; "show people", each person made with their
747
+ picture's address, and the voices when the sheet has a `voice` row; "why", your
748
+ reasons, one line each.
582
749
 
583
750
  **The yes covers only the list the member last saw.** Before any write or
584
- start, the member has seen the list and the count, and said yes to them.
585
- This holds also when their first message says "just do it" or "let it run":
586
- "Let it run" fills the rows with your picks, and the yes still comes from
587
- the member.
751
+ start, the member has seen the list and the count, and said yes to them. This
752
+ holds also when their first message says "just do it" or "let it run": "Let it
753
+ run" fills the rows with your picks, and the yes still comes from the member.
754
+ The yes is as "What a yes is" says. A typed change with no yes in it: make the
755
+ change, send the sheet again with its price, and ask again. Each "wait" below
756
+ asks the question again.
588
757
 
589
758
  - A reply that makes the buy bigger is not the yes, even with "go" in it:
590
759
  more videos, another ad, music on where the sheet said off, or "one shot"
@@ -594,10 +763,11 @@ the member.
594
763
  "go", is the yes: how close, music off, or leaving out videos it names
595
764
  ("drop video 3, go"). Say the change in one line and start. "Fewer" with
596
765
  no say in which ones is not the yes: send the shorter list and wait.
597
- - Anything else is not the yes: a question, "show me", "maybe", "looks
598
- good?", or a reply you are not sure of. Answer it and wait. Above 6 videos,
599
- only a yes that names the count is the yes ("yes to 8 videos", "8, go"); a
600
- bare "go" or "yes" gets the count asked again.
766
+ - Above 6 videos, only a yes that names the count is the yes ("yes to 8
767
+ videos", "8, go"); a bare "go" or "yes" gets the count asked again. So above
768
+ 6 videos the spending option names the count ("Make 8 videos · …"), and its
769
+ press is a yes that names it; a numbered list ends "That is 8 videos. Say
770
+ yes to 8 videos."
601
771
  - On a sheet of 1 video, "1: Anna, Ben and Cara. Go." is 3 videos: send the
602
772
  list of 3 and wait.
603
773
 
@@ -612,80 +782,138 @@ The rows:
612
782
  - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
783
  each 15 or 25 seconds of the script filmed as one long take. It is open to
614
784
  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
625
- 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.
627
- - **The saved sheet** (a kind that has one; One-take UGC today). The server
628
- 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.
632
- - **Persona.** Offer the three saved personas that fit the ad best, each with
633
- a short reason, then "show all <N>" (every persona not marked
634
- `[archived]`). Several may be picked: one video for each.
785
+ to them. Take it when the member asks for a one-take UGC video or names
786
+ Luke's UGC method. Use it too when the template prints "Also fits their ad:
787
+ One-take UGC (ugc-one-take). …" and the member asked for a UGC video of one
788
+ person talking to the camera, in any words: the word "one-take" is not
789
+ needed. Then take it: the plan says the swipe makes One-take UGC, with the
790
+ reason the template's line gives; One-take UGC is then the kind made. The
791
+ write carries `--kind ugc-one-take`, its dry run first (People, below), and
792
+ the sheet's yes is the yes to it. The line comes only for an ad its write
793
+ takes and a member who may start it. When the line comes and the member
794
+ asked for nothing it fits, offer it as one option of the sheet's question,
795
+ beside the kind the swipe makes, with the reason that line gives; never
796
+ choose it unasked. A press or a typed pick of it is not the yes yet: run its
797
+ write line with `--kind ugc-one-take` and no `--yes` (free; People, below),
798
+ and send the sheet again with that price. A sheet run (`exodus video swipe
799
+ run --sheet <file>`) of one ad that names no kind prints the same line,
800
+ ending "set "kind": "ugc-one-take" in the sheet before its next run.": set
801
+ it only on their yes, and say that the next run writes that ad again, which
802
+ is paid. On an ad it can't be made from, the write refuses it and says why.
803
+ It buys a face photo, a picture of the room, a cut-out of the product, a
804
+ picture of an animal when the script puts one in the picture, and one take
805
+ for each 15 or 25 seconds of script, on the member's Kie key, and text calls
806
+ on their model key; it needs their ElevenLabs key and their Kie key. Its
807
+ price, the server's estimate, comes after the write (step 4). The "about"
808
+ films each take once. A take filmed again (as when a filming left out script
809
+ words that matter) is paid again, so the run can cost more than "about"; the
810
+ "at most" counts each take and picture made twice. On an admin key, plain
811
+ `exodus video status` prints a line that starts "Cost so far:" or "Cost:"
812
+ once the run has spent anything: that is the run's own cost, the figure the
813
+ dashboard shows, and the line says what is not in it (what the swipe paid
814
+ for before the run). When it prints none, no cost is recorded yet: say so,
815
+ and never call the run free.
816
+ - **The saved sheet** (One-take UGC today) comes after the write, with its
817
+ own yes (step 4). This sheet's yes covers their write and its people only,
818
+ and the spending option says so, with the people's part only when the dry
819
+ write printed their price (People, below).
820
+ - **People** (a kind whose write can make them: One-take UGC, when the server
821
+ offers people to pick from). Before you send the sheet, run that video's
822
+ write line (step 4) without `--yes`: it writes nothing and pays for nothing.
823
+ When the kind makes people, it prints "This write also gives the sheet <k>
824
+ people to pick from, …", their price ("About $… for new people: …", "A
825
+ picture of the animal, if the script puts one in the picture: $…" and "At
826
+ most $… in all: …") and the line to run: "On their yes, run the same command
827
+ with --yes --people-max-usd <most>". Those figures go in the spending option
828
+ ("Write it" in the table, each video's as printed): the about from "About $…
829
+ for new people" (the people only; the animal's own line goes in the
830
+ description) and the most from "At most $… in all". Its press is the yes to
831
+ that most. With it, the write also draws the animal its stored script puts
832
+ in the picture (the dog in a dog product's ad) with the people, inside the
833
+ same most; `exodus video swipe sheet set <swipeId> animal=none` takes it out
834
+ of the video (free). When the member gave a money limit and the people's
835
+ most, added over every video on the sheet, is already over it, say so in one
836
+ line of the plan and ask: no write goes out until what it can cost fits.
837
+ When it prints none, the write makes no people. Nor does `--no-people`. Two
838
+ more writes make none, and nothing is paid for them: a member's own script
839
+ (`their-format`) that keeps its own person (the "Persona and mechanism" row
840
+ below says when), and a video that step 5 writes, written with a plain
841
+ `--yes`; each write says so. So leave the people out of a step 5 video's
842
+ option, and for the member's own script its description says its people are
843
+ made only when the script keeps their speaker's type. Either way the member
844
+ can ask for people on the saved sheet: `exodus video swipe sheet people
845
+ <swipeId>`, the price first.
846
+ - **Persona.** Pick none unless the member named one. "personas" asks the three
847
+ that fit the ad best, each with a short reason, as one question that takes
848
+ several picks, and "show all <N>" lists every one. "mechanism" asks the
849
+ primer's mechanisms (step 2), the member's own words, or none.
635
850
  - **Persona and mechanism.** The video writer reads neither. When step 5's
636
851
  path is open, the text swipe bot writes them into each video's lines, and
637
852
  the rows say so (step 5). When it is closed, and for a video the bot does
638
- not write, they are noted, not read: in
639
- **My picks**, a persona or a mechanism always carries "(noted, not used
640
- yet)", the primer's lead mechanism included, and videos for two personas
641
- differ only as two writes of the same request differ. In that case, when
642
- more than one persona is picked, say this in your reply before the yes, so
643
- the member does not pay for several videos expecting a script for each
644
- persona. Two other ways make a persona real without step 5. The member
645
- 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
853
+ not write, they are noted, not read: on "show sheet", a persona or a
854
+ mechanism always carries "(noted, not used yet)", the primer's lead
855
+ mechanism included, and videos for two personas differ only as two writes of
856
+ the same request differ. In that case, when more than one persona is picked,
857
+ the plan's personas line says so ("noted only: the videos differ only as two
858
+ writes do"), so the member does not pay for several videos expecting a
859
+ script for each persona. Two other ways make a persona real without step 5.
860
+ The member writes their own script for that persona, and the write takes it
861
+ with `--mode their-format --script <file>`, made the way their ad is made.
862
+ For a kind whose sheet has a person (One-take UGC today), who is filmed
863
+ depends on the script. One that names no speaker, and does not make its
864
+ speaker the other sex from their ad's speaker, is cast as their ad's
865
+ speaker's type: the write puts that type on the script's cast line. A
866
+ speaker label that is not a placeholder ("Maya:", not "Speaker:"), a name
867
+ the script says ("Hi, I'm Jess"), its own words about the speaker, or words
868
+ that make the speaker the other sex keep the script's own person. The saved
869
+ sheet's person row says which, and why. To film the persona's own person,
870
+ the script names its speaker, or the member sets `who` on the saved sheet.
871
+ Or the member swipes the words with the `swipe` skill and makes the film
872
+ from one of our formats (its "Make it a video"). That path asks a yes before
649
873
  each paid step, and it makes the film in the format they pick, not in the
650
874
  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".
653
- - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
654
- scripts, and <n> storyboards with their pictures; the voices and clips
655
- wait for your yes at each storyboard.
875
+ - **Characters.** A swiped run takes no saved characters, so the row offers
876
+ only "the tool picks". People a write makes are picked in step 4.
877
+ - **Run.** "Stop at the storyboard" buys the scripts and the storyboards with
878
+ their pictures; the voices and clips wait for your yes at each. "One shot"
879
+ has no final approve (step 4): the plan's Stop line says so.
656
880
  - **Finish.** `swipe start` takes `--music` and nothing else for the finish.
657
- Music is made on the member's own ElevenLabs key. Caption style, speed,
658
- jump cuts and the end card come with a later update.
881
+ Music is made on the member's own ElevenLabs key. Music is off unless the
882
+ member asked for it; the plan's line says which. Caption style, speed, jump
883
+ cuts and the end card come with a later update; One-take UGC's saved sheet
884
+ already sets all but the end card (step 4).
659
885
  - **How many.** Ads × personas, with none counting as one persona and the
660
886
  characters counting as one today. Show the multiplication, as in "4 videos
661
- = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
662
- that count in so many words: "That is 8 videos. Say yes to 8 videos."
663
- - **Cost.** Before the write the CLI prints no price for a swipe, so the
664
- sheet says exactly that: no number, no range, no guess. A kind with a saved
665
- sheet (One-take UGC today) gets its price after the write, with its saved
666
- sheet (step 4). The Director block of `exodus video
667
- status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
668
- for its redos on that video, not a price and not a ceiling for the first
669
- pass. Never quote it as the cost.
670
- - **Product.** Add a row **Product:** only when `swipe products` lists more
671
- than one. With one, write for that one.
887
+ = 2 ads × 2 personas".
888
+ - **Cost.** Before the write the CLI prints no price for a swipe: the option's
889
+ "no printed price" says so, and no other line about cost goes on the screen.
890
+ With a money limit and a kind with no saved sheet, add one line: "This kind
891
+ prints no price, so I can't check your $<limit> before the yes." There, when
892
+ the template offered One-take UGC for this ad ("Also fits their ad: …"), its
893
+ option's description says it prints a price before its start, held to its "at
894
+ most". The Director block of `exodus video status` prints "Spent: $… of
895
+ $12.00": the $12.00 is the Director's limit for its redos on that video, not
896
+ a price and not a ceiling for the first pass. Never quote it as the cost.
897
+ - **Product.** Ask the product only when `swipe products` lists more than one
898
+ and the member named none. With one, write for that one.
672
899
  - **Anything else.** Add a row only when the member's ask carried a note. A
673
900
  note that names what to swipe (hook only, their format with their own
674
901
  script, a new look) sets `--mode` (step 4), and **My picks** says the mode
675
- back. Say back any other note as noted, not used yet.
676
- - **Several ads.** One sheet covers every ad the member named: list what you
677
- read from each in the first line. The count and the warning above 6 hold.
902
+ back. So does the plan. Say back any other note in one line, as noted, not
903
+ used yet.
678
904
 
679
- **The videos, in a fixed order.** List them one per line: the ads in the
905
+ **The videos, in a fixed order.** List them in this order: the ads in the
680
906
  order the member gave them, and for each ad the personas in the order the
681
907
  sheet shows them. The same picks give the same list.
682
908
 
683
- **A bare number.** Read a reply of only a number ("3") as the count of
684
- videos, and say so in the list's first line: "I read 3 as 3 videos." Pick
685
- one video for each ad, in the order given, before a second persona for any
686
- ad; then the next persona in the order shown for each ad, and so on, until
687
- the count is reached. List the videos in the fixed order and wait for the
688
- yes. When the picks cannot make that many, say how many they can make.
909
+ **A bare number.** After a numbered list of options (rule 3's fallback), a
910
+ number picks that option, as a press does. Anywhere else, read a reply of only
911
+ a number ("3") as the count of videos, and say so in the list's first line: "I
912
+ read 3 as 3 videos." Pick one video for each ad, in the order given, before a
913
+ second persona for any ad; then the next persona in the order shown for each
914
+ ad, and so on, until the count is reached. List the videos in the fixed order
915
+ and wait for the yes. When the picks cannot make that many, say how many they
916
+ can make.
689
917
 
690
918
  When the member says "just do it": no persona, the primer's lead mechanism
691
919
  (noted, not used yet), closeness 2, the tool picks the characters, one shot,
@@ -694,29 +922,202 @@ no music. With more than one product and none named, ask that one row first.
694
922
  ### 4. On the yes
695
923
 
696
924
  The yes covers the writes and the starts, and the bot calls when step 5
697
- applies; nothing else. The breakdown and the template are once per ad, and
698
- are done already.
699
-
700
- **The saved sheet** changes this for a kind that has one (One-take UGC
701
- today): the yes of step 3 covers its writes, and its starts wait for one more
702
- yes. Run step 1 for every such video first. Then read each one's saved sheet
703
- 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
705
- prints (that page does not show the saved sheet yet). Ask one yes for all
706
- their starts, then run step 2 for each. A reply that only changes a row is
707
- not that yes: set it with `exodus video swipe sheet set <swipeId>
708
- notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
709
- and ask the yes again. Say a row marked "no step reads it yet" as saved, not
710
- used. The start copies the saved sheet into the video; a change after it is
711
- for the next video.
712
- With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
713
- (free) prints it at the sheet's rows, with the most it can cost and one line
714
- of what it leaves out. A 480p draft or the first take only is a row the
715
- member sets (`size=480p`, `takes=first`) when the price lists them; read the
716
- price again after a set. The first take only is a cheap check of the method
717
- and the size, not of the final person: the whole video after it is a second
718
- start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
719
- and it casts the person and draws the pictures again. Say so before that yes.
925
+ applies; nothing else (the read is done).
926
+
927
+ **The saved sheet** (step 3's row) changes this: the yes of step 3 covers its
928
+ writes, and its starts wait for one more yes. Run step 1 for every such video
929
+ first. Then read each one's saved sheet and its price, both free (`exodus
930
+ video swipe sheet <swipeId>` and `exodus video swipe sheet price <swipeId>`),
931
+ and send one reply for all their starts, its message as text first (rule 2):
932
+
933
+ > Script ready: <n> lines, <k> takes. Say "show sheet", "show script" or "why"
934
+
935
+ Its question (`AskUserQuestion`, header "Film it?"), its text:
936
+
937
+ > It opens: "<its first line>". (several videos: one line for all, each video's number, first words and person, and no Person line)
938
+ > Person: <name>, the recommended one of <k> | a new person cast from their speaker's type (or the words the write names), none of the <k> made · Voice: <name><, not <accent> like their speaker: "Change something" picks another> (Person only when the sheet has people, Voice only with a `voice` row; "not <accent>" only when `status --full`'s Cast names their speaker's accent and the voice row's reason, or the voice's name as `sheet voices` prints it, shows another or none)
939
+ > Spent so far: $<X> on the team's keys for reading their ad, $<W> on yours (the template, on your model key: not printed). Film it?
940
+
941
+ Its options: 1. Film it (the table), its figures from the price's "Price:"
942
+ line 2. Show me the script and the <k> people 3. Change something: person,
943
+ voice, size, how it is filmed, how it is finished, captions and card, their
944
+ look 4. Stop.
945
+
946
+ Its "Change something" asks which part first, as one question (rule 3) with
947
+ "How it is finished" among its options, then that part's rows as step 3's
948
+ does, four rows a call. "How it is finished" changes only how the app cuts
949
+ the takes once they are filmed, and `cardPlace` (in "Captions and text card")
950
+ where the cut puts the text card: both free to set, the price's figures the
951
+ same. Set one only on the member's word. As `sheet` prints them:
952
+
953
+ - `speed`: how fast the video plays, from `1.0` (as filmed) to `1.25`.
954
+ - `pauses`: how much silence between words is cut: `trim`, `keep`, or the
955
+ levels `light`, `medium`, `hard`.
956
+ - `cuts`: the framing changes where `7`, `5` or `3.5` seconds pass with no
957
+ cut, and no time is cut out; `off` adds none.
958
+ - `voiceSound`: how the voice sounds: `phone` mic, voice `memo`, `clean` and
959
+ even, or `raw` as recorded.
960
+ - `roomSound`: a faint sound of a place under the voice: `room`, `kitchen`,
961
+ `car`, `outside`, or `none`.
962
+ - `ultraRealism`: `phone`, a phone's look (30 frames a second, a light lens
963
+ smudge, phone grain), or `off`.
964
+ - `cardPlace`: over the chest while the first line is said (`chest`), or a
965
+ headline at the top for the opening (`top`). At the top, with no words on
966
+ `headline` and no `headline=none` from the member, it shows the words on
967
+ screen written for take 1's opening once one more text call on the member's
968
+ model key checks them (with the hook off, none), and the price names that
969
+ call among what it leaves out.
970
+
971
+ With several videos, the label says how many and the description each one's
972
+ price as printed, never their sum. Each start's `--max-usd`, and each write's
973
+ `--people-max-usd`, is that video's own printed "at most", never a sum. "show sheet" prints each saved sheet's rows
974
+ (with each person made, their picture's address, and the one recommended, when
975
+ the sheet shows them) and the swipe's dashboard page each prints, whose
976
+ Pre-production card on Your version shows the same picks: a change made there
977
+ is to this same saved sheet, so read it and its price again. That link with
978
+ `&sheet=finish` added (or another section's `id` from `--json`, such as
979
+ `captions`) opens the card on that section. A press of "Film it", or a typed
980
+ yes to it, is the one yes for all their starts: run step 2 for each. A reply
981
+ that only changes a row is not that yes: set it with `exodus
982
+ video swipe sheet set <swipeId> notes="<words>"` (free; `<row>=` clears a row),
983
+ read the price again, say the change in one line, and ask again. Say a row
984
+ marked "no step reads it yet" as saved, not used. The start copies the saved
985
+ sheet into the video; a change after it is for the next video.
986
+
987
+ **Recommended rows.** A row may print `recommended:` and a reason ("why" gives
988
+ it): a start with no pick films that value. With no pick, the "How it is
989
+ finished" rows and `cardPlace` print `from the kind of ad:`
990
+ (`roomSound`: `not set`) and a start cuts them so. A value one of them
991
+ recommends is used only when picked: `voiceSound` and `roomSound` name it in
992
+ their reason ("pick it to use it"); `pauses`, `cuts` and `cardPlace` mark it
993
+ only as `recommended` in `--json`. "Let it run" here, said in reply to these saved sheets and
994
+ their prices, is the yes to the starts with the sheets as they stand: set
995
+ nothing (a size a money limit needs is set before the sheets are shown,
996
+ below), since a start with no pick films each row's value as the sheet prints
997
+ it. A "let it run" said before them, as in the first message, is not this
998
+ yes: the writes went on the yes to step 3's sheet, and the starts wait for a
999
+ reply to these. A member's pick wins (the row then reads `from you:`); `<row>=`
1000
+ clears it, back to the recommended value or default. `prop=none` holds nothing through
1001
+ the video (it prints `prop: none (nothing held through the video)`), though a
1002
+ take may still pick up a small thing for a moment, such as a mug or a drink;
1003
+ `prop=` takes it back to its default.
1004
+
1005
+ `who` is the person filmed: a person made for the swipe, by number
1006
+ (`who=<n>`), or words in the row's own form, as `who="a white woman in her
1007
+ 30s, grey hoodie"`. A row with no value at all prints "not set": then the
1008
+ script decides.
1009
+ **Their look.** When the member wants the person to look like their speaker
1010
+ ("make her look like the woman in their ad", closer to, the same as), the row
1011
+ is "How close to their speaker" (`basedOn`): `type`, the default (a new person
1012
+ of their speaker's type), or `look`: new people who also have their speaker's
1013
+ hair, clothes, nails, skin tone, brows, makeup, freckles and build, read from
1014
+ their ad in our words, never their face, a name, a tattoo, a scar or a
1015
+ birthmark. Their age stays the type's. Never write `who` by hand for this.
1016
+ `exodus video swipe sheet set <swipeId> basedOn=look` with no `--yes` buys
1017
+ nothing: it prints the price (one read of their speaker's look on the member's
1018
+ OpenRouter key, then 4 new people and the check of their faces) and the line
1019
+ that says yes. Ask it as a question whose option carries that price ("Their
1020
+ look · about $…, at most $…", the table); only on its yes run it with `--yes
1021
+ --people-max-usd <the most it showed>`, then read the sheet a few minutes
1022
+ later and show the people made from it. `basedOn=type` goes back, free. When
1023
+ the row offers only `type`, it says why (no OpenRouter key, a well-known or
1024
+ named speaker, their ad's video not kept, a read that failed): say that reason
1025
+ and do not work around it. A sheet with no `basedOn` row has no such choice
1026
+ for this swipe: say so, and keep `who`. `filmed`, `pose`, `prop`, `moves`,
1027
+ `place`, `look`, `time`, `placeNote` (how and where it is filmed), `hook`
1028
+ (take 1's opening action, `off` or a level from 1 to 5, 2 the usual) and
1029
+ `hookKind` (its kind, `any` or one the row lists) each carry their default's
1030
+ reason: set one only when the member asks (`time=dusk`, `hook=3`). `notes` end
1031
+ every take's prompt. With the hook on, the board asks the hook director for
1032
+ the opening: one text call on the member's model key, which the price names
1033
+ among what it leaves out. `headline` is the text card at the start: `none`, or
1034
+ the member's own words for it (one short line; a refusal says what fits). The
1035
+ screen's price is `exodus video swipe sheet price <swipeId>` (free) at the
1036
+ sheet's rows, with the most it can cost; the option's description ends with
1037
+ what it leaves out, shortened (the table's "Film it?" row). "why" gives each
1038
+ line of the price. A 480p draft or the first take only is a row the member
1039
+ sets (`size=480p`, `takes=first`) when the price lists them; read the price
1040
+ again after a set. The first take only is a cheap check of the method and the
1041
+ size, not of the final person: the whole video after it is a second start,
1042
+ paid on its own (`takes=all`, then `swipe start <swipeId> --again`), and it
1043
+ casts the person and draws the pictures again. Say so before that yes.
1044
+ **A money limit.** When the member gave one ("keep the whole thing under
1045
+ $15"), hold it before the start: add the people's most when the dry write
1046
+ printed one (its "At most $… in all"), what the write cost when the limit is
1047
+ for everything, and the start's "at most" (never its "about": a take filmed
1048
+ again is paid again), and compare the sum with the limit. The text calls the
1049
+ price leaves out are in no figure: say so, and leave room for them. Over it,
1050
+ nothing starts. When a smaller size the price lists fits (its whole video,
1051
+ every take, and the start does not refuse it), set it before you show the
1052
+ saved sheets (`exodus video swipe sheet set <swipeId> size=480p`, free), read
1053
+ the price again, and say on the sheet in one line that it is a 480p draft, the
1054
+ size that fits their limit: their yes to that sheet is the yes to it. A limit
1055
+ given after they saw the sheets: name the 480p draft and wait for their yes.
1056
+ With a money limit and no "at most" printed, the limit cannot be checked: stop
1057
+ and ask. For example, with a limit for everything: when the write's cost, the
1058
+ people's most and 720p's "at most" add up to more than the limit, and the same
1059
+ sum with 480p's "at most" is under it, set 480p. Every figure in that sum is
1060
+ the one the CLI printed for this swipe, never one from memory. When no size
1061
+ fits, stop and ask; when the price lists the first take only (`takes=first`),
1062
+ you may name it as a smaller thing they can choose, never as the whole video.
1063
+ The `--max-usd` you start with is the "at most" the price shows, so it is
1064
+ never above what is left of the member's limit.
1065
+
1066
+ **The price before a beta tester's start.** A beta tester's `exodus video
1067
+ start` without `--yes` starts nothing: it prints what the video will cost (the
1068
+ server's estimate) and the line that starts it (`--yes --max-usd <that
1069
+ price>`). Show the member that line word for word, and run it only after they
1070
+ say yes. If the price changed by then, the start refuses and says the new
1071
+ price: show that and ask again. An older CLI is told to update first. An
1072
+ admin's start begins at once, as before.
1073
+
1074
+ **A video that needs the member's OK to spend more.** A regular video (not
1075
+ One-take) keeps the estimate it showed before the start. A scene's first take
1076
+ does not stop to ask, even past it; when any other take would take the video's cost
1077
+ past it, the video stops before ordering that take and waits for the member,
1078
+ often while its cost so far is still under the estimate. At the storyboard,
1079
+ `exodus video status` says the storyboard's own estimate when it differs from
1080
+ the one the member started with. When the video waits, `exodus video status`
1081
+ prints a line that starts "Waiting for you:", with what
1082
+ the video has cost so far, its estimate, what it wants to film next and
1083
+ about what that costs, and under it two commands: `exodus video keep-going
1084
+ <runId>` and `exodus video stop-here <runId>`. That choice is the member's,
1085
+ never yours: show them that line word for word, and run the command they
1086
+ pick only after they answer. A money limit they gave you, or a `--max-usd`,
1087
+ does not answer it for them. Nothing is paid while it waits, and it waits
1088
+ until they answer. Keep going films on and asks again if it passes the next
1089
+ whole estimate; a yes films every scene the line named before any other
1090
+ scene spends it. Keeping a named scene as it is takes it off the line, which
1091
+ then names the next scene waiting. Stop here orders nothing more: each scene
1092
+ keeps the clip it has, and a scene with none is named; status says what was
1093
+ kept, and such a scene is filmed with Try again on the video's page, which
1094
+ shows its price first.
1095
+
1096
+ A write that carried the people's most makes the first people to pick from
1097
+ (People, step 3). Offer more people, or voices to pick from, only when the
1098
+ member asks for options. More people are paid on the member's keys: run
1099
+ `exodus video swipe sheet people <swipeId> --count <n>` first (no `--yes`),
1100
+ put the price it prints in the option, and after the yes run the line it
1101
+ prints (`--yes --max-usd <n>`, the most the price said). Do not add
1102
+ `--wait`: it can wait up to 45 minutes. Read the sheet a few minutes later and
1103
+ show each person's name and picture address. A sheet with a `voice` row
1104
+ (there only while the server offers people and voices to pick from) has its
1105
+ voices listed once by the server after the write (when the member has an
1106
+ ElevenLabs key), and the row may recommend one and say why: a voice that fits
1107
+ the person, which may skip a voice the brand's recent swipes already have, so
1108
+ its videos don't all sound the same. A sheet with no `voice` row has no voices to pick from: say nothing
1109
+ about them. `exodus video swipe sheet voices <swipeId>` lists them again: one
1110
+ read of the voice list on the member's ElevenLabs key, and no speech is made,
1111
+ so it buys nothing. It prints the voices that fit the person, best fit first,
1112
+ each with its age and accent when known ("Sarah · young · American") and a
1113
+ sample to hear, then "Recommended: <n> (…). <why> A start with no pick films
1114
+ it."; after the member's pick, "Recommended: <n> (…). You picked it, so a
1115
+ start films it." or "… You picked <m>, so a start films your pick."; or why
1116
+ none is. A voice row with no voice prints "List the voices: exodus video swipe
1117
+ sheet voices <swipeId>". A pick is a set (`who=<n>`, `voice=<n>`), and the
1118
+ video is filmed with that person, their face and that voice. If the server
1119
+ says these choices are not switched on yet, say so and go on with the sheet as
1120
+ it is.
720
1121
 
721
1122
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
722
1123
  every video has started:
@@ -724,32 +1125,84 @@ every video has started:
724
1125
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
725
1126
  --closeness <n> --yes`. A mode set from a note changes the line:
726
1127
  `hook-only` takes `--closeness` as `whole-ad` does. `their-format` takes
727
- the member's own script: save it to a file and pass `--script <file>`,
728
- with no `--closeness` (the CLI refuses one). `new-look` takes `--look
729
- <slug>`; no command lists the looks a swipe can take, so ask the member
730
- for the exact look name and never invent one (the writer refuses a look
731
- it does not make). When step 5 applies, its write line takes the place of
732
- this one. The write takes four to nine minutes. Show the member the
733
- script, the direction, Kept and Changed, and what it cost. When a persona
734
- or a mechanism was picked and step 5 does not apply, add one line: "The
735
- persona and the mechanism are noted, not used: the video writer does not
736
- read them yet."
737
- The write's last line says "Start the video (paid; ask first)": the
738
- sheet's yes was that ask, so start now, with the line below, not the
739
- write's own, which leaves out `--one-shot`. For a kind with a saved
740
- sheet, that ask is the saved sheet's yes instead: start after it. Note the
741
- swipe id it printed for that video.
742
- 2. `exodus video swipe start <swipeId> --one-shot --yes`, without
743
- `--one-shot` when the member chose to stop at the storyboard, and with
744
- `--music` when they chose music. For a kind with a saved sheet whose price
745
- printed a number, add `--max-usd <n>` with the "at most" it showed: a
746
- start that can now cost more is refused, and nothing is started. No
747
- number printed: no `--max-usd`, and never a guessed one. Give the member the
748
- `Watch it:` link at once. Then go on to the next video.
749
- 3. When every video has started, follow each run with `exodus video status
750
- <runId>` and do what it prints. A one-shot run that waits for a cut goes
751
- to "End: watch and approve" (pull, cut, upload, the run page). A run that
752
- stopped at the storyboard goes to stop 3, then the end.
1128
+ the member's own script: save it to a file and pass `--script <file>`, with
1129
+ no `--closeness` (the CLI refuses one). `new-look` takes `--look <slug>`;
1130
+ no command lists the looks a swipe can take, so ask the member for the
1131
+ exact look name and never invent one (the writer refuses a look it does not
1132
+ make). When step 5 applies, its write line takes the place of this one. The
1133
+ write takes four to nine minutes: say so in one line. When it is done, one
1134
+ line: the script's opening and what it cost ("show script" gives the
1135
+ script, the direction, Kept and Changed). When the member picked a persona
1136
+ or a mechanism and step 5 does not apply, add one line: "The persona and
1137
+ the mechanism are noted, not used: the video writer does not read them
1138
+ yet." For a kind whose write makes people (People, step 3), run the yes
1139
+ line the dry write printed (`--yes --people-max-usd <most>`), or `--yes
1140
+ --no-people` when the member wants none; a plain `--yes` makes none, and
1141
+ says so. With the figure, the write waits up to 5 minutes for the people,
1142
+ then prints each with their picture's address and whom a start with no pick
1143
+ films: the one it recommends, or a new person cast from their speaker's
1144
+ type, not one of these (tell the member; set `who=<n>` only on their word;
1145
+ never assume one is recommended). When none were made it says so, that
1146
+ nothing was paid for them, and how to ask for them (the price first, free).
1147
+ After the 5 minutes the write is done: read the sheet a few minutes later.
1148
+ The animal, when the script has one, is on the saved sheet's row "The
1149
+ animal" a few minutes later, with its picture's address; a start waits for
1150
+ it. For One-take UGC the write may also write our own text card and pick a
1151
+ kind of opening (`headline`, `hookKind`, marked recommended); when Changed
1152
+ ends "We left out the text card we wrote: …" or "We left out the kind of
1153
+ opening we picked: …", tell the member in one line: they may write their
1154
+ own card (`headline="<words>"`), set `hookKind` to a kind the row lists, or
1155
+ leave it. The write's last line says "Start the video (paid; ask first)":
1156
+ the sheet's yes was that ask, so start now, with the line below, not the
1157
+ write's own, which leaves out `--one-shot`. For a kind with a saved sheet,
1158
+ that ask is the saved sheet's yes instead: start after it. Note the swipe
1159
+ id it printed for that video.
1160
+ 2. `exodus video swipe start <swipeId> --one-shot --yes`, without `--one-shot`
1161
+ when the member chose to stop at the storyboard, and with `--music` when
1162
+ they chose music. For a kind with a saved sheet whose price printed a
1163
+ number, add `--max-usd <n>` with the "at most" it showed: a start that can
1164
+ now cost more is refused, and nothing is started. With a money limit, start
1165
+ only once that "at most" fits what is left of it ("A money limit", above).
1166
+ No number printed: no `--max-usd`, and never a guessed one. When the sheet
1167
+ has people, the start says first whom it films. Give the member the `Watch
1168
+ it:` link in one line, at once. Then go on to the next video.
1169
+ 3. When every video has started, wait on each run in the background with
1170
+ `exodus video wait <runId>`, each in its own command, and say one line:
1171
+ "Filming <n> videos · I'll tell you when each is delivered or needs you."
1172
+ When a wait ends, read `exodus video status <runId>` once and do what it
1173
+ prints. The app makes a swiped video's cut ("End: watch and approve"), so
1174
+ make no cut of your own. A run that stopped at the storyboard goes to stop
1175
+ 3, then the end, which asks the final approve. A one-shot video is
1176
+ delivered by itself once the app's cut is made, with no final approve,
1177
+ unless the film's check against its own sound fails ("End: watch and
1178
+ approve").
1179
+
1180
+ **A stop that needs the member** (a check found a problem, a held take, a
1181
+ refused write or start) is two lines and a question, offering only the ways
1182
+ that `status`, the hold's own sentence or the refusal names: the free look
1183
+ first, a free way marked "free", a paid way with the price the CLI printed for
1184
+ it (`sheet price` before a new run with `--again`) or "no printed price". A
1185
+ new run keeps none of the first start's flags: give `--one-shot` and `--music`
1186
+ again when the first had them. Its message, as text first (rule 2):
1187
+
1188
+ > Stopped for you. <each cost line the stopped step printed, as printed, if any: "It cost $<X> on the member's key."> Say "why"
1189
+
1190
+ Its question (`AskUserQuestion`, header "What now?"), its text:
1191
+
1192
+ > <what happened, in plain words>. <what is still good>.
1193
+ > Spent $<X> of about $<Y> (or rule 5's other forms). What now?
1194
+
1195
+ Its options: 1. the free look ("Watch take 2 first") 2. a free way on ("Keep
1196
+ it · free") 3. a paid way on, as the table's "A hold" or "A refused write" row.
1197
+
1198
+ **Delivered** is three lines, the money line last:
1199
+
1200
+ > Done. <the run page, or the file `pull` wrote>.
1201
+ > Listen once: <a word `status` flags, or the product's name>.
1202
+ > Spent $<X> of about $<Y> for the film (or rule 5's other forms); before it, <the last money line's figures, each with whose keys>
1203
+
1204
+ With several videos, one line a video: its ad and persona, its `Watch it:`
1205
+ link and its money, or why it stopped.
753
1206
 
754
1207
  **Never start the same swipe twice.** One swipe is one video. A start of a
755
1208
  swipe that already has a video is refused, starts nothing, and names the run:
@@ -764,19 +1217,48 @@ noted none), with no run and not marked refused, is that write. Show it with
764
1217
  row marked refused is that write's refusal: report it as a refused write. When
765
1218
  no such row is there yet, the write may still finish: check again later.
766
1219
 
767
- At the end, report each video on one line: its ad and persona, its run id
768
- and its `Watch it:` link, or why it stopped.
769
-
770
- **The final approve** is asked for each video as at "End: watch and
771
- approve". It is one way. A redo of a clip there needs its own yes.
772
-
773
1220
  **A refusal or a failed check stops that video only.** The others go on, and
774
- every video is in the report at the end. A refused write prints the writer's
775
- sentence, its swipe id, what it cost, and "Nothing was started.": report all
776
- of it for that video. Writing again is paid again and needs the member's
777
- word. A refused start prints its sentence: report it for that video. A
778
- one-shot run whose checks find a problem stops for the member: show what
779
- `status` prints and ask.
1221
+ every video is in the report at the end. A refused write prints "The writer
1222
+ refused:" and its sentence (on an admin key, then "What the checks found:"),
1223
+ its swipe id, what it cost, "Nothing was started." and "Writing again is paid
1224
+ too: the same exodus video swipe write line, after the member's yes.". Report
1225
+ it as a stop that needs the member (above), with the ways on its sentence ends
1226
+ with.
1227
+
1228
+ A refusal for claims reads "Your product sheet doesn't back up …" and names up
1229
+ to two held lines, each with why in brackets (not found on the sheet, a hedge
1230
+ kept, the product named next to a line taken out, a shot that shows a result);
1231
+ more end "and N more (the dashboard lists every one)". The ways on, by how it
1232
+ ends:
1233
+
1234
+ - "If it's true, add the line's own words to your product's description (on
1235
+ the dashboard: Library, Materials, Brand info, then the product's Edit),
1236
+ then write again." (or "If a line is true, …", "If a spoken line whose claim
1237
+ we couldn't find on the sheet is true, …", or the same for "a price or code
1238
+ your product sheet doesn't list"): ask the member whether it is true of
1239
+ their product. Only if it is, they add its own words there; then, on their
1240
+ yes, run the same write line again.
1241
+ - "Write again." alone: no held line can be backed by the description: on the
1242
+ member's yes, run the same write line again.
1243
+ - "The script we wrote left out …, and at closeness … every beat stays. …":
1244
+ the member adds what that beat can say to the product's description, or
1245
+ picks closeness 4 or 5, where beats can merge or drop; then write again on
1246
+ their yes.
1247
+ - "Your script says "…", from their ad or a price or code your product sheet
1248
+ doesn't list. We never change your words, so take it out, then try again.":
1249
+ they take those words out of their own script; write again on their yes.
1250
+ - Any other sentence: say it as it is, and write again only on their yes.
1251
+
1252
+ **Never write around a refusal yourself.** Do not pass the refused script,
1253
+ its held lines, or lines you wrote, to `--mode their-format --script`. The
1254
+ way out is the one the refusal ends with, above.
1255
+
1256
+ A refused start prints its sentence: report it for that video. When it says
1257
+ a row of the sheet "holds words it no longer takes" (what the person holds,
1258
+ for one), nothing was paid: change that row only on the member's word (their
1259
+ new words, or `prop=none`), then start again on their yes. A one-shot run
1260
+ whose checks find a problem stops for the member: show what `status` prints
1261
+ and ask.
780
1262
 
781
1263
  ### 5. With a persona or a mechanism: the text swipe bot
782
1264
 
@@ -815,16 +1297,19 @@ mechanism noted only.
815
1297
 
816
1298
  **On the sheet, when the path is open.**
817
1299
 
818
- - Rows 1 and 2 read "(used through the text swipe bot)" in place of
819
- "(noted; …)".
820
- - Row 3 reads "1 Near-clone, 2 New scene, same beats, 3 Same idea, new
821
- drama, 4 Same arc, 5 Pattern only (with 4 or 5, the persona and the
822
- mechanism are only noted)". Levels 1 to 3 are the `swipe` skill's levels
823
- (its section 2), not the dial's: say so when the member asks. A video the
824
- bot does not write takes the same number as its `--closeness`.
825
- - **It buys** adds, when the picks give the bot any video: "and a text swipe
826
- call for each video (two at level 2 or 3), on your own Genesis and model
827
- keys." When only some videos take it, name them ("for videos 1 and 3").
1300
+ - On "show sheet" and in "Change something", rows 1 and 2 read "(used through
1301
+ the text swipe bot)" in place of "(noted; …)".
1302
+ - On "show sheet" and in "Change something", row 3 reads "1 Near-clone, 2 New
1303
+ scene, same beats, 3 Same idea, new drama, 4 Same arc, 5 Pattern only (with
1304
+ 4 or 5, the persona and the mechanism are only noted)". Levels 1 to 3 are
1305
+ the `swipe` skill's levels (its section 2), not the dial's: say so when the
1306
+ member asks. A video the bot does not write takes the same number as its
1307
+ `--closeness`.
1308
+ - The spending option's description adds, when the picks give the bot any
1309
+ video: "Plus a text swipe call for each video (two at level 2 or 3), on your
1310
+ own Genesis and model keys, no printed price." When only some videos take
1311
+ it, name them ("for videos 1 and 3"). **It buys** on "show sheet" says the
1312
+ same.
828
1313
  - A reply that adds bot calls makes the buy bigger, so it is not the yes: a
829
1314
  persona or a mechanism added where the sheet had none, or, while a persona
830
1315
  or a mechanism is picked, how close moved from 1 to 2 or 3, or from 4 or 5
@@ -895,19 +1380,19 @@ say; a result beyond them needs a product fact.
895
1380
  "the #1").
896
1381
 
897
1382
  When a picked persona or mechanism is missing, or a line promises something
898
- the product's facts do not hold (a result, a health benefit, a number), do
899
- not start that video: show the member that line and ask. The other videos go
900
- on. Show each such line with the fact it would need, and offer three ways
901
- on: start it as written, leave that video out, or the member's own words for
902
- those lines, written again with `--mode their-format --script <file>` (a
903
- second paid write, on their word) and checked again. This is the one stop
904
- this path adds, and it comes only when the check finds something. The write
905
- may still refuse a name, price or code from their ad, or a cast the kind of
906
- ad cannot take (more speakers than it holds, or speakers where it takes a
907
- narrator only): a refused write stops that video only, as above. A write
908
- whose wait was cut off and is found again with `exodus video swipe show
909
- <swipeId>` (as "On the yes" says) gets this check too, on the script `show`
910
- prints, before its start.
1383
+ the product's facts do not hold (a result, a health benefit, a number), do not
1384
+ start that video: show the member that line and ask. The other videos go on.
1385
+ Show each such line with the fact it would need, and offer three ways on:
1386
+ start it as written, leave that video out, or the member's own words for those
1387
+ lines, written again with `--mode their-format --script <file>` (a second paid
1388
+ write, on their word) and checked again. Ask it as step 4's stop that needs
1389
+ the member. This is the one stop this path adds, and it comes only when the
1390
+ check finds something. The write may still refuse a name, price or code from
1391
+ their ad, or a cast the kind of ad cannot take (more speakers than it holds,
1392
+ or speakers where it takes a narrator only): a refused write stops that video
1393
+ only, as above. A write whose wait was cut off and is found again with `exodus
1394
+ video swipe show <swipeId>` (as "On the yes" says) gets this check too, on the
1395
+ script `show` prints, before its start.
911
1396
 
912
1397
  **Run so far.** Levels 1 and 2 of this path have been run for real, as far
913
1398
  as the write. Level 3 has not.
@@ -933,70 +1418,42 @@ noted only.
933
1418
 
934
1419
  ### Step by step: a yes before each paid step
935
1420
 
936
- For a member who asks for stops. Four steps cost money, and the CLI prints no
937
- price for any of them but the start of a kind with a saved sheet. Run each
938
- one first without `--yes`: it sends nothing and prints what the step buys and
939
- who pays. Tell the member both, and the price when it prints one, else say
940
- the CLI prints no price; never guess one, and run the same line with `--yes`
941
- only after their yes.
942
-
943
- 1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
944
- Instagram or YouTube), or a video ad in the brand's swipe library by the
945
- id that `exodus video swipe find` prints (free):
946
- `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId>`.
947
- The breakdown is paid on the team's keys, not the member's. A link or an
948
- ad this brand broke down before comes back at once and costs nothing.
949
- With `--wait` it prints each step as it starts, and takes a few minutes.
950
- Once it is done, `exodus video swipe status <breakdownId> --full` prints
951
- what Exodus read from the ad: each shot with its cut times, a-roll or
952
- cutaway, framing, camera and description, then the script with who says
953
- each line, then the cast, then how it is filmed. It is free. Show the
954
- member the shot list and the script before the template, so they can say
955
- whether Exodus read their ad right. In "How it is filmed", every line but
956
- Measured, Cuts and Words is the video model's reading by eye, and it is
957
- often wrong: in Exodus's own checks the camera height was right 2 times
958
- in 9. Cuts is counted, but it includes jump cuts the video model saw.
959
- Give the by-eye lines as what Exodus thinks it saw, never as fact, and
960
- ask the member to check any that matters against the ad. Measured says
961
- only that most of the part of the frame it could read stood still; it
962
- does not prove the phone was put down.
963
- 2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
964
- member's own Anthropic or OpenRouter key. It prints the kind of ad and the
965
- look the ad matched, and why. A template made before costs nothing. Show
966
- the member the kind and the look. The swipe writes that kind and no other.
967
- If the member wants another kind, stop here and make the video from that
968
- format with the ad's words instead ("From one sentence to a film").
969
- 3. **The choices.** `exodus video swipe products` lists the brand's
970
- products. Ask which product, what to swipe and how close. What to swipe
971
- (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
972
- script (`--script <file>`, the member's own words), or Their script, a new
973
- look (`--look <slug>`). How close (`--closeness`, 2 if left off): 1 Mirror,
974
- 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
975
- has each one's line.
976
- 4. **The write.** `exodus video swipe write <breakdownId> --product <id>
977
- [--mode …] [--closeness …]`, paid on the member's own key. It takes four
978
- to nine minutes and waits by itself. Show the member the script, the
979
- direction, Kept and Changed, and what it cost. A refusal prints the
980
- writer's sentence and "Nothing was started.": tell the member, and offer to
981
- write again, which is paid too. If the wait gives up, the write may still
982
- finish: run `exodus video swipe list` before writing again. It shows the
983
- brand's newest swipes, and a refused one is marked with what it cost.
984
- 5. **The start.** `exodus video swipe start <swipeId>`. It buys the
985
- storyboard and its pictures; the voices and clips wait for the storyboard's
986
- yes. `--style <look>` changes the look, `--music` adds a music bed.
987
- `--title "<name>"` names the ad, for admins only: a beta tester leaves it
988
- off, or the CLI refuses it with one sentence naming it. With `--one-shot`
989
- it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
990
- member. A swipe that already has a video is refused, with its run; a
991
- second video from it needs `--again` and the member's yes to a second video.
992
- For a kind with a saved sheet (One-take UGC today), show the saved sheet
993
- one time before this start, as in step 4 (`exodus video swipe sheet
994
- <swipeId>`, free), in the same message as what the start buys and who
995
- pays (the line without `--yes`). On this path the saved sheet's yes is
996
- the start's yes: ask once, then run the line with `--yes` and the
997
- `--max-usd <n>` that line printed (its price's "at most"): a start that
998
- can now cost more is refused, and nothing is started. A reply that
999
- only changes a row is not that yes.
1421
+ For a member who asks for stops: the steps above, with one question before
1422
+ each of the four paid steps (the read of an ad, its template, the write, the
1423
+ start) in place of one yes for all. Run each one first without `--yes` (it
1424
+ sends nothing), put what it prints in the option (the table's "Step by step"
1425
+ row), and run the same line with `--yes` only after their yes.
1426
+
1427
+ 1. **Get the ad.** Step 1's breakdown line for one ad, first without `--yes`,
1428
+ then asked ("without asking" does not hold here): a video file, a link
1429
+ (Meta Ad Library, TikTok, Instagram or YouTube), or a video ad in the
1430
+ brand's swipe library by the id that `exodus video swipe find` prints
1431
+ (free). Then show the shot list and the script (`status --full`, free), so
1432
+ the member can say whether Exodus read their ad right. In "How it is
1433
+ filmed", every line but Measured, Cuts and Words is the video model's
1434
+ reading by eye, often wrong (the camera height was right 2 times in 9 in
1435
+ Exodus's checks): say those as what Exodus thinks it saw. Cuts counts jump
1436
+ cuts the model saw too; Measured does not prove the phone was put down.
1437
+ 2. **The template.** Step 1's template line, first without `--yes`, then
1438
+ asked. Show the kind, the look, why, and the "Also fits their ad: …" line
1439
+ when it prints one (the One-take UGC row of step 3). The swipe writes the
1440
+ kind it was matched to, or another named with `--kind` on the member's yes.
1441
+ For a kind this ad can't be made as (step 3's "The kind of ad"), stop here
1442
+ and make the video from that format with the ad's words ("From one sentence
1443
+ to a film").
1444
+ 3. **The choices**, as questions: the product, what to swipe (`--mode`, as
1445
+ step 4's write line says) and how close (`--closeness`, 2 if left off).
1446
+ 4. **The write.** Step 4's write line: its people's price goes in the option
1447
+ when the line without `--yes` prints one, and their yes line is the one it
1448
+ prints.
1449
+ 5. **The start.** `exodus video swipe start <swipeId>` buys the storyboard and
1450
+ its pictures; the voices and clips wait for the storyboard's yes. With
1451
+ `--one-shot` it buys the whole video with no stop: ask before passing it.
1452
+ `--style <look>` changes the look, `--music` adds a music bed, and `--wait`
1453
+ waits until the run needs the member. `--title "<name>"` names the ad, for
1454
+ admins only: a beta tester leaves it off, or the CLI refuses it with one
1455
+ sentence naming it. For a kind with a saved sheet, its question (step 4) is
1456
+ the start's question, with the `--max-usd <n>` the line printed.
1000
1457
  6. **Then** stop 3 (the storyboard) and the end, as above.
1001
1458
 
1002
1459
  ### Every swipe command
@@ -1004,23 +1461,27 @@ only after their yes.
1004
1461
  ```operator-guide
1005
1462
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
1006
1463
  break the ad down (team's keys); one read before costs nothing
1007
- exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
1008
- --full adds what it read: shots, script, cast, filming
1464
+ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands; --full: shots, script, cast, filming
1009
1465
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
1010
1466
  exodus video swipe products the brand's products and their ids
1011
- exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
1012
- the brand's version (member's key); waits for it
1467
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes [--people-max-usd <n>]] [--no-people]
1468
+ the brand's version (member's key); without --yes, its people's price
1013
1469
  exodus video swipe show <swipeId> one swipe again
1014
- exodus video swipe list the brand's newest swipes, each with when it was written and its product;
1015
- a refused one shows what it cost
1470
+ exodus video swipe list the brand's newest swipes, when written, product, a refusal's cost
1016
1471
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
1017
1472
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
1018
- start the run on the kind the swipe wrote; --again for a
1019
- second, paid video of a swipe that already has one
1020
- exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1021
- no dashboard page shows it yet
1473
+ the run on the kind the swipe wrote; --again: a second, paid video
1474
+ exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free)
1022
1475
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1476
+ exodus video swipe sheet set <swipeId> basedOn=look --yes --people-max-usd <n>
1477
+ their look: run it first without --yes for its price
1023
1478
  exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1479
+ exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1480
+ new people to pick from (member's keys; the price first); who=<n> picks one
1481
+ exodus video swipe sheet voices <swipeId> the voices that fit the person, best fit first, each with its
1482
+ sample (and its age and accent when known), and the one the
1483
+ row recommends, if any: one read of the voice list on the
1484
+ member's ElevenLabs key, no speech; voice=<n> picks one
1024
1485
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
1025
1486
  ```
1026
1487
 
@@ -1058,21 +1519,28 @@ CLI words it the way the run page does. On their own brands they can:
1058
1519
  file"). `--stop-at-script` prints that script and starts nothing.
1059
1520
  - `video status <runId>`: where the video is, in plain words (waiting in line,
1060
1521
  planning, drawing, storyboard ready for review, filming, ready with its link,
1061
- held for a scene they must make again or keep as it is on the video's page,
1062
- or stopped and why). `--json` prints the server's answer as it came; a held
1063
- video says `"stage": "failed"` with the held scenes in `cutHolds`.
1522
+ held for a scene they must make again or keep as it is, or stopped and why).
1523
+ `--json` prints the server's answer as it came; a held video says
1524
+ `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1525
+ also sends `cutHeldScenes` (each held scene's number and its sentence).
1526
+ - `video wait <runId>`: reads the video until it stops for them, is ready
1527
+ or stops, then prints where it stands and its page.
1064
1528
  - `video storyboard <runId>`: each scene's line and picture, while the
1065
1529
  storyboard waits for review.
1066
1530
  - `video approve <runId>`: approves the storyboard. At an audition stop,
1067
1531
  `video approve <runId> --audition <digest>` accepts the audition clips, and
1068
1532
  plain `video approve <runId>` pays for another try of the failed audition
1069
- takes ("The audition stop"). Nothing else.
1533
+ takes ("The audition stop"). When their finished video waits for them
1534
+ ("finish it"), `video approve <runId>` finishes it, as "End: watch and
1535
+ approve" says. Nothing else.
1070
1536
  - `video voices <runId>`: who speaks, their current voice, and the voices on
1071
1537
  the tester's own ElevenLabs account. `--set <character>=<voiceId>` picks one,
1072
1538
  until the storyboard is approved.
1073
1539
  - `video retry-frame <runId> --scene <n>`: redraws one scene's picture while
1074
1540
  the storyboard waits. No `--node`; the server finds the step.
1075
- - `video pull <runId> --out <dir>`: the finished video (`video.<ext>`), each
1541
+ - `video pull <runId> --out <dir>`: the finished video (`video.<ext>`) once
1542
+ it is ready (until then it says "The finished video isn't ready yet, so
1543
+ only the scene pieces came down."), each
1076
1544
  scene's clip (`scene-NN.<ext>`) and voice (`scene-NN.voice.<ext>`), and the
1077
1545
  music (`music.<ext>`), with a `manifest.json` holding only `runId`,
1078
1546
  `pulledAt`, `dashboardUrl`, `scenes` (`index`, `clip`, `voice`), `music` and
@@ -1080,6 +1548,14 @@ CLI words it the way the run page does. On their own brands they can:
1080
1548
  handover" below applies to them.
1081
1549
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
1082
1550
  to watch it on.
1551
+ - `video keep <runId> --scene <n>`: keeps a held scene's clip as it is, as
1552
+ "Use scene N as-is" on the video's page does, after their yes. It orders
1553
+ nothing; keeping the last held scene starts the cut. `status`, `wait` and a
1554
+ refused `approve` name every scene waiting on the member, each with what a
1555
+ check found, even while other scenes still film ("These scenes need you
1556
+ before your video can be finished:", `waitingScenes` in `--json`). Show
1557
+ those lines word for word: keep a scene only on their yes, and a remake is
1558
+ Try again on the video's page, which shows its price first.
1083
1559
  - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1084
1560
  which is refused with one sentence naming it. The run it starts answers the
1085
1561
  way start's does.
@@ -1118,6 +1594,11 @@ exodus workflow run <workflowId|name> --input <field>=@script.txt --voices @voic
1118
1594
  exodus workflow run <workflowId|name> --input <field>=@script.txt --voice-treatment @voice-treatment.json --wait
1119
1595
  same, with the video model speaking voices you WROTE
1120
1596
  exodus video status <runId> where it is, per scene
1597
+ exodus video wait <runId> waits until the run stops for the member, fails or is
1598
+ delivered (up to an hour), through the app's cut, and
1599
+ prints where the run stopped and the next step, as the
1600
+ first lines of `status` do; a server that stops
1601
+ answering ends it with exit 2, and the run goes on
1121
1602
  exodus video start --script <file> --conceit <kind> --style <look> [--direction "…"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice native] [--music] [--broll] [--one-shot] [--director] [--stop-at-script] [--rewrite-to-fit] [--wait]
1122
1603
  start from a script and the kinds the server offers.
1123
1604
  The file can be a plain transcript, a draft or a
@@ -1158,7 +1639,7 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
1158
1639
  --help` prints them:
1159
1640
 
1160
1641
  ```operator-guide
1161
- exodus video start --script <file> --conceit <kind> --style <look> [--direction "<note>"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice <native|voice-first>] [--source-record <file.json>] [--adaptation-plan <file|original>] [--music] [--broll] [--one-shot] [--director] [--wait] [--json]
1642
+ exodus video start --script <file> --conceit <kind> --style <look> [--direction "<note>"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice <native|voice-first>] [--source-record <file.json>] [--adaptation-plan <file|original>] [--music] [--broll] [--one-shot] [--director] [--yes --max-usd <n>] [--wait] [--json]
1162
1643
  Template starts also accept: [--requested-seconds <seconds>] [--pictures-per-scene <1|3>] [--product <brandProductId>] [--elements <json|@file>] [--voices <json|@file>] [--resume-script <saved-stop-response.json>]
1163
1644
  With --describe: [--product-context <text>] [--audience <text>] [--offer <text>] [--mechanism <text>]
1164
1645
  exodus video start --input-options [--conceit <template>] [--voice <native|voice-first>] [--voice-path <path>] [--video-model <id>] [--json]
@@ -1265,6 +1746,12 @@ exodus video pull <runId> --out ./ad-<runId> every piece + manifest
1265
1746
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
1266
1747
  redo one clip at the final watch
1267
1748
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1749
+ exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1750
+ only after the member's yes
1751
+ exodus video keep-going <runId> a video waiting at its estimate films on;
1752
+ only after the member's own yes
1753
+ exodus video stop-here <runId> a video waiting at its estimate orders nothing
1754
+ more; only on the member's own answer
1268
1755
  … make the cut (your choice of tool)
1269
1756
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1270
1757
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1309,16 +1796,67 @@ under it:
1309
1796
  it instead (`stop.missingScenes` in `--json`) and approval is refused until
1310
1797
  it has one. A scene whose picture the video service refused needs
1311
1798
  `retry-frame --note` before `retry-clip`; the clip redo alone resends the
1312
- refused picture. On a video started from the dashboard, the app makes the
1313
- cut itself; when a scene's clip still has a drawing fault after it was made
1799
+ refused picture. On a video the app cuts itself (one started from the
1800
+ dashboard, a swiped video, a beta tester's run: "End: watch and approve"),
1801
+ the app makes the cut. While it makes it, the stop block says "Every piece
1802
+ is made. The app makes the cut now; look again in a minute: exodus video
1803
+ status <runId>" and names no pull, upload or `retry-clip`: read `status`
1804
+ again in a minute. When a scene's clip still has a drawing fault after it was made
1314
1805
  again, the stop block says `Held:` and names the scene
1315
1806
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1316
- made again with `retry-clip`, or kept as it is on the video's page (the
1317
- link it prints). Keeping the last one starts the cut.
1807
+ made again with `retry-clip`, or kept as it is with `exodus video keep
1808
+ <runId> --scene <n>` or on the video's page (the link it prints). Keeping
1809
+ the last one starts the cut.
1810
+ A One-take take held for its words, for a picture that came out turned on
1811
+ its side or upside down, or for a product label that came out backwards and
1812
+ could not be fixed, is named under `Held:` with its own
1813
+ sentence, every reason it was held for (`stop.heldTakes` in `--json`), from
1814
+ the moment the take is made. It
1815
+ cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1816
+ and ask them to watch the take. With their yes, `exodus video keep <runId>
1817
+ --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1818
+ take starts the cut. Otherwise a new run films it again. On a One-shot run
1819
+ that cut is delivered by itself: say so before the last keep.
1820
+ A take held for its label has a sentence that begins "The label check
1821
+ read the product's label as mirror writing in take N", says why it was not
1822
+ fixed (a flip would turn the room around against the other takes, the take
1823
+ could not be flipped, or a second look could not make sure), and ends with
1824
+ its two ways out. Give the member both, in its own words. Keep it, on their
1825
+ yes (`exodus video keep <runId> --scene <n>`), and the film shows the label
1826
+ as it is in the take. Or start a new
1827
+ run, which films every take again at its full price: for a swiped video,
1828
+ `exodus video swipe start <swipeId> --again`, first without `--yes` for its
1829
+ price, then the line it prints, on their yes. The new start keeps none of
1830
+ the first start's flags: give it `--one-shot` and `--music` again when the
1831
+ first had them, in that dry line too (without `--one-shot` it stops at the
1832
+ storyboard).
1318
1833
  - paused: a builder checkpoint neither video verb resolves —
1319
1834
  `exodus workflow checkpoint <runId>` is the verb for that one.
1320
1835
  - failed: `status` shows how far it got, and a `--wait` that was running exits
1321
1836
  1 with the error. Tell the user; do not start another run on your own.
1837
+ Two stops of a One-take run have a way out, each after the user's yes:
1838
+ `exodus workflow repair <runId> retry`.
1839
+ - Kie failed a picture twice (its sentence says "Kie failed it" and what Kie
1840
+ said): the retry orders that picture again, at most twice more. Each
1841
+ order that draws is paid on their Kie key at Kie's price for that
1842
+ picture; an order Kie failed is not counted as paid. When the sentence
1843
+ says instead that a retry stops the same way, the orders may already be
1844
+ paid for: only a new start draws the picture (`exodus video swipe start
1845
+ <swipeId> --again` says its price before it pays for anything).
1846
+ - A picture no retry can order: its sentence says "A retry of this step
1847
+ stops the same way, since those orders may already be paid for. Start
1848
+ the video again instead: …". Do not retry: it stops the same way, and
1849
+ `status` offers no retry for it. From here, the new start of a swiped
1850
+ video is `exodus video swipe start <swipeId> --again`. Run it first
1851
+ without `--yes`: it sends nothing and prints the whole video's price (the
1852
+ pictures, the takes and the text calls are all paid again) and the line
1853
+ to run. Tell the member the price, and run that line only on their yes.
1854
+ The new start keeps none of the first start's flags: give it
1855
+ `--one-shot` and `--music` again when the first had them, in that dry
1856
+ line too (without `--one-shot` it stops at the storyboard).
1857
+ - The connection to the text model dropped twice: the retry asks again and
1858
+ keeps what was already written. The storyboard already asked once more
1859
+ by itself after the first drop.
1322
1860
  When the storyboard is the step that failed, `status` adds a "What happened
1323
1861
  to the storyboard" block: which parts of the plan were accepted, which part
1324
1862
  was turned down, and why (#1902). Relay it as written. On an admin key it may
@@ -1934,7 +2472,10 @@ length. Do not invent a number.
1934
2472
  `pull` writes a flat folder and a `manifest.json` that indexes it. The manifest
1935
2473
  is the data you decide from; the filenames are its values. Scene numbers are the
1936
2474
  run's own. Every `pull` re-downloads and overwrites every file, so running it
1937
- again is always safe.
2475
+ again is always safe. Once the run has a finished video, it writes that too,
2476
+ as `video.<ext>` ("End: watch and approve"), except while the app makes the
2477
+ cut again after a redo: the one on the run then is about to be replaced. When
2478
+ a different `video.<ext>` was already in the folder, it says it replaced it.
1938
2479
 
1939
2480
  ```
1940
2481
  storyboard.json the whole storyboard envelope (see below)
@@ -1949,6 +2490,7 @@ narration.mp3 one continuous narrator take of the whole script
1949
2490
  narration.json that take's settings, master-timeline words, and the
1950
2491
  per-scene ranges it was cut into
1951
2492
  music.<ext> the music bed
2493
+ video.<ext> the finished video, once the run has one
1952
2494
  manifest.json the index below
1953
2495
  ```
1954
2496
 
@@ -2028,6 +2570,8 @@ provenance which saved rulebook this run followed:
2028
2570
  rig is a copy. Names, ids and a version
2029
2571
  only — never the rules themselves
2030
2572
  failed[] files that did not download: {file, url, error}
2573
+ video the finished video's filename; null when it
2574
+ did not download. Absent when the run has none
2031
2575
  ```
2032
2576
 
2033
2577
  ### What each piece is