@aicopycoders/exodus 2026.11.1100-beta.9 → 2026.11.1200-beta.1

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.
@@ -603,10 +603,26 @@ the member.
603
603
 
604
604
  The rows:
605
605
 
606
- - **The kind of ad.** The swipe writes the kind the template read and no
607
- other. When the member asks for another kind ("make it UGC instead"),
608
- leave this path for "From one sentence to a film", with the ad's words
609
- from `status --full`.
606
+ - **The kind of ad.** The swipe writes the kind the template read. When the
607
+ member asks for another kind ("make it UGC instead"), name it with
608
+ `--kind <key>` on the write or `"kind"` in the sheet. A kind this ad can't
609
+ be made as is refused before the write is paid, with the kinds it can be
610
+ made as: offer those, or leave this path for "From one sentence to a
611
+ film", with the ad's words from `status --full`.
612
+ - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
+ each 15 or 25 seconds of the script filmed as one long take. It is open to
614
+ admins only for now: for anyone else the CLI refuses it, so don't offer it
615
+ to them. Use it when
616
+ the member asks for a one-take UGC video or names Luke's UGC method, and
617
+ then the sheet's first line says the swipe makes one-take UGC. When the ad
618
+ is one person talking to the camera, you may name it as one option beside
619
+ the kind the swipe makes; never choose it unasked. On an ad it can't be
620
+ made from, the write refuses it and says why. It buys a face photo, a
621
+ picture of the room, a cut-out of the product and one take for each 15 or
622
+ 25 seconds of script, on the member's Kie key, and text calls on their
623
+ model key; it needs their ElevenLabs key and their Kie key. Its price is
624
+ the server's estimate, shown only where the CLI prints one; for a swipe it
625
+ prints none today.
610
626
  - **Persona.** Offer the three saved personas that fit the ad best, each with
611
627
  a short reason, then "show all <N>" (every persona not marked
612
628
  `[archived]`). Several may be picked: one video for each.
@@ -941,7 +957,7 @@ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown st
941
957
  --full adds what it read: shots, script, cast
942
958
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
943
959
  exodus video swipe products the brand's products and their ids
944
- exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--yes]
960
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
945
961
  the brand's version (member's key); waits for it
946
962
  exodus video swipe show <swipeId> one swipe again
947
963
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
@@ -263,6 +263,8 @@ export interface CutPace {
263
263
  /** The numbers the pace was checked at: PACE_BARS, or the format's own. */
264
264
  paceCheck?: { minWps: number; maxWps: number; minGapSec: number; maxGapSec: number; beatMaxSec: number; hookMaxGapSec: number };
265
265
  nameCheck?: true;
266
+ /** With pacePass, the speed the cut played at in place of 1.12. */
267
+ paceSpeed?: number;
266
268
  };
267
269
  /** `limited`: limitPeaks' limiter ran after the loudness pass. */
268
270
  loudness?: { lufs: number; truePeak: number; passes: 1 | 2; limited?: true };
@@ -503,6 +505,9 @@ export function scenesWithNoClip(options: {
503
505
  exists?: (file: string | null) => boolean;
504
506
  }): number[];
505
507
 
508
+ /** The pace record's note for a paceSpeed the cut does not use (pacePass off, or out of range), or null. */
509
+ export function paceSpeedNote(finishing: { pacePass?: unknown; paceSpeed?: unknown } | null | undefined): string | null;
510
+
506
511
  /** #3424: the sentence-gap cut, which scout's scribe.ts sentenceGapCuts mirrors. */
507
512
  export function sentenceGapCuts(
508
513
  words: Array<{ w: string; s: number; e: number }>,
@@ -75,9 +75,26 @@ const PUNCH_IN =
75
75
  /**
76
76
  * pacePass: the finished cut plays at `speed`, picture and sound, and every
77
77
  * second piece of the spine is a centre crop scaled up by `zoom`, a small zoom
78
- * step at each cut.
78
+ * step at each cut. The manifest's paceSpeed, within PACE_SPEED_RANGE, plays
79
+ * it at its own speed instead.
79
80
  */
80
81
  export const PACE_PASS = { speed: 1.12, zoom: 1.07 };
82
+ export const PACE_SPEED_RANGE = { min: 1.02, max: 1.25 };
83
+ const paceSpeedOk = (v) => Number.isFinite(v) && v >= PACE_SPEED_RANGE.min && v <= PACE_SPEED_RANGE.max;
84
+
85
+ /**
86
+ * The pace record's note for a paceSpeed the cut does not use (pacePass off,
87
+ * or not a speed in PACE_SPEED_RANGE), or null. The worker calls it too, for a
88
+ * run's stored paceSpeed that never reached the manifest.
89
+ */
90
+ export function paceSpeedNote(finishing) {
91
+ if (!isObject(finishing) || finishing.paceSpeed === undefined) return null;
92
+ const v = finishing.paceSpeed;
93
+ const shown = typeof v === "number" ? String(v) : JSON.stringify(v);
94
+ if (finishing.pacePass !== true) return `paceSpeed ${shown} is read only with pacePass, which is off, so it was not used`;
95
+ return paceSpeedOk(v) ? null
96
+ : `paceSpeed ${shown} is not a speed from ${PACE_SPEED_RANGE.min} to ${PACE_SPEED_RANGE.max}, so it was not used`;
97
+ }
81
98
  const PACE_ZOOM =
82
99
  `scale=${even(WIDTH * PACE_PASS.zoom)}:${even(HEIGHT * PACE_PASS.zoom)},crop=${WIDTH}:${HEIGHT},setsar=1`;
83
100
  const floorFrame = (t) => Math.floor(t * FPS + 1e-6) / FPS;
@@ -243,6 +260,7 @@ export function finishingOf(manifest) {
243
260
  ...(f.talkTrim === true ? { talkTrim: true } : {}),
244
261
  ...(on.captions && f.captionsByLine === true && f.captionColours === true ? { captionColours: true } : {}),
245
262
  ...(f.pacePass === true ? { pacePass: true } : {}),
263
+ ...(f.pacePass === true && paceSpeedOk(f.paceSpeed) ? { paceSpeed: f.paceSpeed } : {}),
246
264
  };
247
265
  if (!Object.values(on).some(Boolean) && Object.keys(added).length === 0) return null;
248
266
  const target = f.targetSeconds;
@@ -1500,15 +1518,15 @@ function markPunchIns(spine, sameShot) {
1500
1518
 
1501
1519
  const sameSpeaker = (prev, seg) => Boolean(prev.lastSpeaker && seg.firstSpeaker === prev.lastSpeaker);
1502
1520
 
1503
- /** pacePass: every second piece of the spine zooms, where no punch-in does already. Answers the cut's note. */
1504
- export function paceZooms(spine) {
1521
+ /** pacePass: every second piece of the spine zooms, where no punch-in does already. Answers the cut's note, which names `speed`. */
1522
+ export function paceZooms(spine, speed) {
1505
1523
  let zoomed = 0;
1506
1524
  spine.forEach((seg, k) => {
1507
1525
  if (k % 2 === 0 || seg.punchIn) return;
1508
1526
  seg.paceZoom = true;
1509
1527
  zoomed += 1;
1510
1528
  });
1511
- return `pacePass: the cut plays at ${PACE_PASS.speed}x and ${zoomed} piece${zoomed === 1 ? "" : "s"} zoom ${PACE_PASS.zoom}x`;
1529
+ return `pacePass: the cut plays at ${speed}x and ${zoomed} piece${zoomed === 1 ? "" : "s"} zoom ${PACE_PASS.zoom}x`;
1512
1530
  }
1513
1531
 
1514
1532
  /** cutPace: two pieces of one take, back to back. */
@@ -6678,6 +6696,8 @@ export function firstCut({ dir, out: outOpt, skip = new Set(), music: musicOn =
6678
6696
  // The finishing settings' part of the render: the speed, the burned
6679
6697
  // captions and cards, and where the mix goes before its loudness pass.
6680
6698
  const notes = [...(timeline.notes ?? [])];
6699
+ const unusedSpeed = paceSpeedNote(manifest.finishing);
6700
+ if (unusedSpeed) notes.push(unusedSpeed);
6681
6701
  if (finish?.captionColours && stagedText) notes.push("captionColours: the text stage draws these captions, so they stay one colour");
6682
6702
  const pictureSec = timeline.spine.reduce((sum, seg) => sum + seg.seconds, 0);
6683
6703
  // Template clocks are always real time, including runs with no action windows.
@@ -6688,9 +6708,10 @@ export function firstCut({ dir, out: outOpt, skip = new Set(), music: musicOn =
6688
6708
  const paced = finish?.pacePass === true && !template && !timeline.wholeVoice && !protectedMotion && !timeline.mapped &&
6689
6709
  manifest.templateMotion?.enabled !== true;
6690
6710
  if (finish?.pacePass && !paced) notes.push("this cut keeps a real-time clock, so pacePass did not speed it up or zoom it");
6691
- if (paced) notes.push(paceZooms(timeline.spine));
6711
+ const paceSpeed = finish?.paceSpeed ?? PACE_PASS.speed;
6712
+ if (paced) notes.push(paceZooms(timeline.spine, paceSpeed));
6692
6713
  const speed = paced
6693
- ? PACE_PASS.speed
6714
+ ? paceSpeed
6694
6715
  : finish?.cutPace && !template && !timeline.wholeVoice && !protectedMotion ? speedFor(pictureSec, finish.targetSeconds) : 1;
6695
6716
  if (finish?.cutPace && (template || protectedMotion)) notes.push("template/action/listening/ending clocks remain real time; cutPace does not accelerate the cut");
6696
6717
  if (timeline.sourceMap) {
@@ -97,6 +97,7 @@ export interface SwipeView {
97
97
  look?: string;
98
98
  memberScript?: string;
99
99
  };
100
+ kind?: string;
100
101
  outcome: {
101
102
  kind: "written";
102
103
  draft: SwipeDraft;
@@ -171,6 +172,7 @@ export interface WriteAsk {
171
172
  look?: string;
172
173
  scriptFile?: string;
173
174
  scriptText?: string;
175
+ kind?: string;
174
176
  }
175
177
  export interface StartAsk {
176
178
  style?: string;
@@ -273,7 +275,7 @@ export declare function swipeTemplateFlow(breakdownId: string, opts: SwipeRunOpt
273
275
  export declare function swipeProductsFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
274
276
  export declare const FIND_READ = 200;
275
277
  export declare const FIND_PAID_FLAGS: readonly ["yes", "wait", "file", "url", "ad", "again"];
276
- export declare const FIND_OTHER_FLAGS: readonly ["one-shot", "music", "mode", "closeness", "product", "look", "script", "style", "title", "sheet", "full", "status", "persona", "retry-refused"];
278
+ export declare const FIND_OTHER_FLAGS: readonly ["one-shot", "music", "mode", "closeness", "product", "look", "script", "style", "title", "sheet", "full", "status", "persona", "retry-refused", "kind"];
277
279
  export declare const FIND_KIND_LINE = "The kind of an ad is known only after it is read.";
278
280
  export declare const FIND_EMPTY_LIBRARY = "The swipe library has no ads yet for this brand.";
279
281
  export interface FindAsk {
@@ -320,7 +322,7 @@ export declare function alreadyStartedOf(res: ApiResponse<unknown>): {
320
322
  url: string;
321
323
  } | null;
322
324
  export declare function swipeStartFlow(swipeId: string, ask: StartAsk, opts: SwipeRunOptions, deps: VideoDeps, again?: boolean): Promise<FlowResult>;
323
- export declare const SHEET_FIELDS: readonly ["sources", "product", "personas", "mechanism", "guidance", "mode", "closeness", "look", "script", "characters", "finish", "oneShot", "style", "title", "music"];
325
+ export declare const SHEET_FIELDS: readonly ["sources", "product", "personas", "mechanism", "guidance", "mode", "closeness", "look", "script", "kind", "characters", "finish", "oneShot", "style", "title", "music"];
324
326
  export declare const SHEET_VIDEO_WARNING = 6;
325
327
  export interface SheetSource {
326
328
  key: string;
@@ -359,6 +361,7 @@ export interface SwipeSheet {
359
361
  start: StartAsk;
360
362
  notUsed: string[];
361
363
  moved: string[];
364
+ kind: string | null;
362
365
  }
363
366
  export interface SheetVideo {
364
367
  n: number;
@@ -372,6 +375,7 @@ export interface WrittenWith {
372
375
  closeness: number | null;
373
376
  look: string | null;
374
377
  scriptSha256: string | null;
378
+ kind?: string;
375
379
  }
376
380
  export type SheetStep = "breakdown" | "template" | "write" | "start";
377
381
  export interface SourcePending {
@@ -92,6 +92,7 @@ const SHEET_FLAGS = [
92
92
  ["script", 'set "script" in the sheet, or a persona\'s "script".'],
93
93
  ["style", 'set "style" in the sheet.'],
94
94
  ["title", 'set "title" in the sheet.'],
95
+ ["kind", 'set "kind" in the sheet.'],
95
96
  ["file", 'list the ad in the sheet\'s "sources".'],
96
97
  ["url", 'list the ad in the sheet\'s "sources".'],
97
98
  ["ad", 'list the ad in the sheet\'s "sources".'],
@@ -131,6 +132,11 @@ export function planSwipeCommand(rest, occurrences) {
131
132
  const opts = { json: on("json"), yes: on("yes"), wait: on("wait") };
132
133
  const usage = (line) => ({ kind: "usage", line });
133
134
  const [verb, id] = rest;
135
+ if (last("kind") !== undefined) {
136
+ const named = rest.find((word) => VERBS.includes(word));
137
+ if (named !== "write")
138
+ return usage(kindElsewhere(named));
139
+ }
134
140
  if (verb === undefined) {
135
141
  const given = ["file", "url", "ad"].filter((name) => value(name) !== undefined);
136
142
  if (given.length !== 1) {
@@ -216,7 +222,24 @@ export function planSwipeCommand(rest, occurrences) {
216
222
  const write = writeChoicesOf({ mode: value("mode"), closeness: value("closeness"), look: value("look"), script: value("script") }, CLI_WORDS.write);
217
223
  if ("problem" in write)
218
224
  return usage(write.problem);
219
- return { kind: "write", breakdownId: id, ask: { productId: product.trim(), ...write.ask }, opts };
225
+ const kind = value("kind");
226
+ if (kind === null || (kind !== undefined && !kind.trim()))
227
+ return usage(`video swipe write --kind needs the key of a kind of ad. ${KIND_CHECKED}`);
228
+ return { kind: "write", breakdownId: id, ask: { productId: product.trim(), ...write.ask, ...(kind !== undefined ? { kind: kind.trim() } : {}) }, opts };
229
+ }
230
+ const KIND_CHECKED = "A kind this ad can't be made as is refused, with the kinds it can be made as, before the write is paid.";
231
+ const templateKindLine = (template, kind) => kind ? `Kind of ad: ${template.kind.label}, the template's pick; the write uses ${kind}, the sheet's kind.` : `Kind of ad: ${template.kind.label}.`;
232
+ function kindElsewhere(verb) {
233
+ const onWrite = "the kind of ad is named when the swipe is written, with exodus video swipe write --kind <kind>.";
234
+ if (verb === "run")
235
+ return `video swipe run takes its choices from the sheet, not from --kind: ${SHEET_FLAGS.find(([flag]) => flag === "kind")[1]}`;
236
+ if (verb === "start")
237
+ return "video swipe start takes no --kind. A swipe starts on the kind it was written for; write it again with --kind.";
238
+ if (verb === "find")
239
+ return "video swipe find takes no --kind: it only lists the swipe library. Its flags are --brand, --limit and --json.";
240
+ if (verb === undefined)
241
+ return `video swipe --file, --url and --ad take no --kind: ${onWrite}`;
242
+ return `video swipe ${verb} takes no --kind: ${onWrite}`;
220
243
  }
221
244
  const CLI_WORDS = {
222
245
  write: { who: "video swipe write", flag: (name) => `--${name}`, set: (name, value) => `--${name} ${value}` },
@@ -697,6 +720,7 @@ export const FIND_OTHER_FLAGS = [
697
720
  "status",
698
721
  "persona",
699
722
  "retry-refused",
723
+ "kind",
700
724
  ];
701
725
  const TEXT_MAX = 400;
702
726
  export const FIND_KIND_LINE = "The kind of an ad is known only after it is read.";
@@ -804,8 +828,20 @@ function choiceLines(ask) {
804
828
  }
805
829
  if (ask.look)
806
830
  lines.push(`New look: ${ask.look}`);
831
+ if (ask.kind)
832
+ lines.push(kindLine(ask.kind));
807
833
  return lines;
808
834
  }
835
+ const kindLine = (kind) => `Kind of ad: ${kind}, in place of the one the template picked.`;
836
+ function kindDropped(swipe, asked) {
837
+ if (asked === undefined)
838
+ return null;
839
+ const written = swipe.outcome.kind === "written" ? swipe.outcome.draft.conceit : null;
840
+ if (swipe.kind === asked && (written === null || written === asked))
841
+ return null;
842
+ const how = written === asked ? `as ${asked}, but it did not keep the kind` : `${written ? `as ${written}` : "for the template's kind"}, not ${asked}`;
843
+ return `This server does not take a kind yet: swipe ${swipe._id} was written ${how}. Nothing was started.`;
844
+ }
809
845
  function requestOf(ask, memberScript) {
810
846
  switch (ask.mode) {
811
847
  case "their-format":
@@ -868,7 +904,12 @@ export async function swipeWriteFlow(breakdownId, ask, opts, deps) {
868
904
  return failed(`--script ${ask.scriptFile} is empty.`, json);
869
905
  if (!opts.yes)
870
906
  return needsYesResult("write", json, choiceLines(ask));
871
- const res = await deps.post(SWIPES_PATH, { breakdownId, productId: ask.productId, request: requestOf(ask, memberScript) });
907
+ const res = await deps.post(SWIPES_PATH, {
908
+ breakdownId,
909
+ productId: ask.productId,
910
+ request: requestOf(ask, memberScript),
911
+ ...(ask.kind ? { kind: ask.kind } : {}),
912
+ });
872
913
  if (!res.ok)
873
914
  return swipeError(res, json);
874
915
  const job = isRecord(res.data) ? res.data.job : undefined;
@@ -899,6 +940,9 @@ export async function swipeWriteFlow(breakdownId, ask, opts, deps) {
899
940
  if ("error" in result)
900
941
  return failed(`The write stopped: ${result.error} Nothing was started.`, json);
901
942
  const { swipe } = result;
943
+ const dropped = kindDropped(swipe, ask.kind);
944
+ if (dropped)
945
+ return failed(dropped, json, { kindDropped: true, swipeId: swipe._id });
902
946
  const written = swipe.outcome.kind === "written";
903
947
  if (json) {
904
948
  return { code: written ? 0 : 1, lines: [JSON.stringify(written ? { ok: true, swipe } : { ok: false, refused: true, swipe })] };
@@ -1024,6 +1068,7 @@ export const SHEET_FIELDS = [
1024
1068
  "closeness",
1025
1069
  "look",
1026
1070
  "script",
1071
+ "kind",
1027
1072
  "characters",
1028
1073
  "finish",
1029
1074
  "oneShot",
@@ -1137,6 +1182,10 @@ export function readSwipeSheet(sheetFile, deps) {
1137
1182
  return { problem: 'In the sheet, "product" must be a product id. exodus video swipe products lists them.' };
1138
1183
  }
1139
1184
  const productId = typeof raw.product === "string" && raw.product.trim() ? raw.product.trim() : null;
1185
+ if (raw.kind !== undefined && raw.kind !== null && (typeof raw.kind !== "string" || !raw.kind.trim())) {
1186
+ return { problem: `In the sheet, "kind" must be the key of a kind of ad, or null. ${KIND_CHECKED}` };
1187
+ }
1188
+ const named = typeof raw.kind === "string" ? { kind: raw.kind.trim() } : {};
1140
1189
  const given = (from, name) => {
1141
1190
  const value = from[name];
1142
1191
  if (value === undefined || value === null)
@@ -1168,10 +1217,10 @@ export function readSwipeSheet(sheetFile, deps) {
1168
1217
  if (typeof entry.script !== "string" || !entry.script.trim())
1169
1218
  return { problem: `Persona ${name} in the sheet: "script" needs a file.` };
1170
1219
  script = entry.script.trim();
1171
- const own = sheetWriteOf(sheetFile, { mode: "their-format", closeness: undefined, look: undefined, script }, (named) => `persona ${name}'s script ${named}`, deps);
1220
+ const own = sheetWriteOf(sheetFile, { mode: "their-format", closeness: undefined, look: undefined, script }, (file) => `persona ${name}'s script ${file}`, deps);
1172
1221
  if ("problem" in own)
1173
1222
  return own;
1174
- write = own;
1223
+ write = { ...own, ask: { ...own.ask, ...named } };
1175
1224
  }
1176
1225
  personas.push({ name, script, write });
1177
1226
  }
@@ -1180,10 +1229,10 @@ export function readSwipeSheet(sheetFile, deps) {
1180
1229
  let write = null;
1181
1230
  let unusedChoices = [];
1182
1231
  if (personas.length === 0 || personas.some((persona) => persona.write === null)) {
1183
- const checked = sheetWriteOf(sheetFile, top, (named) => `the sheet's script ${named}`, deps);
1232
+ const checked = sheetWriteOf(sheetFile, top, (file) => `the sheet's script ${file}`, deps);
1184
1233
  if ("problem" in checked)
1185
1234
  return checked;
1186
- write = checked;
1235
+ write = { ...checked, ask: { ...checked.ask, ...named } };
1187
1236
  }
1188
1237
  else {
1189
1238
  const theirFormat = typeof top.mode === "string" && parseSwipeMode(top.mode) === "their-format";
@@ -1269,6 +1318,7 @@ export function readSwipeSheet(sheetFile, deps) {
1269
1318
  start: start.ask,
1270
1319
  notUsed,
1271
1320
  moved: topMusic !== undefined ? ["music"] : [],
1321
+ kind: typeof raw.kind === "string" ? raw.kind.trim() : null,
1272
1322
  },
1273
1323
  };
1274
1324
  }
@@ -1314,6 +1364,7 @@ function writtenWithOf(write, productId) {
1314
1364
  closeness: write.ask.mode === "their-format" ? null : write.ask.closeness,
1315
1365
  look: write.ask.look ?? null,
1316
1366
  scriptSha256: write.scriptSha256,
1367
+ ...(write.ask.kind ? { kind: write.ask.kind } : {}),
1317
1368
  };
1318
1369
  }
1319
1370
  function changesSince(before, now) {
@@ -1328,6 +1379,8 @@ function changesSince(before, now) {
1328
1379
  changes.push(`look ${before.look ?? "none"}, now ${now.look ?? "none"}`);
1329
1380
  if (before.scriptSha256 !== now.scriptSha256)
1330
1381
  changes.push("the script");
1382
+ if ((before.kind ?? null) !== (now.kind ?? null))
1383
+ changes.push(`kind ${before.kind ?? "the template's"}, now ${now.kind ?? "the template's"}`);
1331
1384
  return changes;
1332
1385
  }
1333
1386
  function notUsedOf(sheet, personas) {
@@ -1368,6 +1421,7 @@ function sheetHeadLines(sheet, sheetFile, personas, product) {
1368
1421
  ...personas
1369
1422
  .filter((persona) => persona !== null && persona.script !== null)
1370
1423
  .map((persona) => `Persona ${persona.name}: ${modeOf("their-format").label}, from ${persona.script}.`),
1424
+ ...(!usesSheetWrite && sheet.kind ? [kindLine(sheet.kind)] : []),
1371
1425
  sheet.start.oneShot
1372
1426
  ? "One shot: the whole video with no stop. It stops only when a check finds a problem."
1373
1427
  : "It stops at each storyboard for the member's yes (oneShot is false or left out).",
@@ -1561,7 +1615,8 @@ function stateFromJson(raw) {
1561
1615
  ["whole", "hook", "their-format", "new-look"].includes(ww.mode) &&
1562
1616
  (ww.closeness === null || typeof ww.closeness === "number") &&
1563
1617
  text(ww.look) &&
1564
- text(ww.scriptSha256);
1618
+ text(ww.scriptSha256) &&
1619
+ (ww.kind === undefined || typeof ww.kind === "string");
1565
1620
  if (write.writtenWith !== null && !choices(write.writtenWith))
1566
1621
  return `${whereWrite} has a "writtenWith" this CLI did not write`;
1567
1622
  if (write.swipeId !== null && write.writtenWith === null)
@@ -1913,7 +1968,7 @@ async function runSheetSource(item, videos, ctx) {
1913
1968
  src.pending = null;
1914
1969
  src.lastError = null;
1915
1970
  touch(src);
1916
- say(` Kind of ad: ${template.kind.label}. Look: ${template.look.label}. The template was made before, so it cost nothing.`);
1971
+ say(` ${templateKindLine(template, sheet.kind)} Look: ${template.look.label}. The template was made before, so it cost nothing.`);
1917
1972
  }
1918
1973
  else {
1919
1974
  const at = stamp(deps);
@@ -1937,7 +1992,7 @@ async function runSheetSource(item, videos, ctx) {
1937
1992
  src.pending = null;
1938
1993
  src.lastError = null;
1939
1994
  touch(src);
1940
- say(` Kind of ad: ${view.kind.label}. Look: ${view.look.label}.`);
1995
+ say(` ${templateKindLine(view, sheet.kind)} Look: ${view.look.label}.`);
1941
1996
  }
1942
1997
  }
1943
1998
  }
@@ -2029,7 +2084,11 @@ async function runSheetSource(item, videos, ctx) {
2029
2084
  }
2030
2085
  write.pending = null;
2031
2086
  write.swipeId = swipe._id;
2032
- write.writtenWith = truth;
2087
+ const recorded = { ...truth };
2088
+ delete recorded.kind;
2089
+ if (typeof swipe.kind === "string")
2090
+ recorded.kind = swipe.kind;
2091
+ write.writtenWith = recorded;
2033
2092
  if (swipe.outcome.kind === "refused") {
2034
2093
  write.refused = swipe.outcome.why;
2035
2094
  for (const video of open)
@@ -2167,6 +2226,7 @@ function writtenWithOfSwipe(swipe) {
2167
2226
  closeness: mode === "their-format" ? null : (swipe.request.closeness ?? null),
2168
2227
  look: swipe.request.look ?? null,
2169
2228
  scriptSha256: mode === "their-format" && typeof script === "string" ? sha256Of(script) : null,
2229
+ ...(typeof swipe.kind === "string" ? { kind: swipe.kind } : {}),
2170
2230
  };
2171
2231
  }
2172
2232
  async function findPendingWrite(pending, breakdownId, want, ctx, who, entry) {
@@ -2182,6 +2242,10 @@ async function findPendingWrite(pending, breakdownId, want, ctx, who, entry) {
2182
2242
  }
2183
2243
  if (answer.status === "done" && isRecord(answer.swipe)) {
2184
2244
  const swipe = answer.swipe;
2245
+ const sameKind = (want.kind ?? null) === (pending.asked?.kind ?? null);
2246
+ const dropped = sameKind ? kindDropped(swipe, pending.asked?.kind) : null;
2247
+ if (dropped)
2248
+ return { stop: dropped };
2185
2249
  const truth = writtenWithOfSwipe(swipe);
2186
2250
  const scriptKnown = truth.mode !== "their-format" || truth.scriptSha256 !== null;
2187
2251
  const changes = changesSince(truth, want);
@@ -2214,7 +2278,7 @@ async function findPendingWrite(pending, breakdownId, want, ctx, who, entry) {
2214
2278
  const read = await readSwipe(row._id, deps);
2215
2279
  if ("problem" in read)
2216
2280
  return { stop: `Swipe ${row._id} could not be read to check it is the write sent before: ${read.problem} Nothing was sent again.` };
2217
- if (read.swipe.productId === want.productId && (read.swipe.request.look ?? null) === want.look) {
2281
+ if (read.swipe.productId === want.productId && (read.swipe.request.look ?? null) === want.look && (read.swipe.kind ?? null) === (want.kind ?? null)) {
2218
2282
  return { taken: { swipe: read.swipe, writtenWith: writtenWithOfSwipe(read.swipe) } };
2219
2283
  }
2220
2284
  }
@@ -2566,7 +2630,13 @@ async function sheetPaidFlow(sheet, sheetFile, videos, personas, state, lockNote
2566
2630
  ...planned.flatMap(({ item, steps }, i) => [`Ad ${i + 1}: ${item.key}`, ...plannedLines(steps)]),
2567
2631
  "",
2568
2632
  ...(needsYes
2569
- ? ["The CLI prints no price for these steps.", "Nothing that costs money was sent. On the member's yes, run the same command with --yes."]
2633
+ ? [
2634
+ ...(sheet.kind
2635
+ ? [`The sheet's kind, ${sheet.kind}, is checked against each ad at its write, after that ad's breakdown and template are paid.`]
2636
+ : []),
2637
+ "The CLI prints no price for these steps.",
2638
+ "Nothing that costs money was sent. On the member's yes, run the same command with --yes.",
2639
+ ]
2570
2640
  : ["Every step is done already. Nothing would be bought again."]),
2571
2641
  ],
2572
2642
  };
@@ -201,7 +201,7 @@ Usage:
201
201
  exodus video swipe status <breakdownId> [--wait] [--full] [--json]
202
202
  exodus video swipe template <breakdownId> [--yes] [--json]
203
203
  exodus video swipe products [--json]
204
- exodus video swipe write <breakdownId> --product <id> [--mode whole-ad|hook-only|their-format|new-look] [--closeness <1-5|mirror|close|same-beats|same-arc|pattern-only>] [--look <slug>] [--script <file>] [--yes] [--json]
204
+ exodus video swipe write <breakdownId> --product <id> [--mode whole-ad|hook-only|their-format|new-look] [--closeness <1-5|mirror|close|same-beats|same-arc|pattern-only>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes] [--json]
205
205
  exodus video swipe show <swipeId> [--json]
206
206
  exodus video swipe list [--json]
207
207
  exodus video swipe find [--brand "<name>"] [--limit <n>] [--json]
@@ -485,6 +485,10 @@ what it buys and who pays. The CLI prints no price for any of them.
485
485
  line; and the cast. No pictures
486
486
  --look <slug> The new look (swipe write --mode new-look)
487
487
  --script <file> Your own script (swipe write --mode their-format)
488
+ --kind <kind> A kind of ad in place of the one the template picked
489
+ (swipe write), by its key. A kind this ad can't be made
490
+ as is refused, with the kinds it can be made as, before
491
+ the write is paid. Every other swipe verb refuses it
488
492
  --style <look> A look other than the swipe's own (swipe start)
489
493
  --title "<name>" The ad's name (swipe start). Admin-only
490
494
  --again A second, paid video from a swipe that already has one
@@ -492,7 +496,7 @@ what it buys and who pays. The CLI prints no price for any of them.
492
496
  swipe whose video is there, and names that run
493
497
  --sheet <file> The whole swipe in one JSON file (swipe run): the ads
494
498
  (sources, each a url, an ad id or a file), the product,
495
- the personas, mode, closeness, look or script, the
499
+ the personas, mode, closeness, look or script, kind, the
496
500
  characters, oneShot, style, title and finish. One video
497
501
  for each ad and persona, each with its run's own cast:
498
502
  one breakdown and template per ad, one write per ad and
@@ -6088,6 +6092,7 @@ const VALUE_FLAGS = new Set([
6088
6092
  "persona",
6089
6093
  ]);
6090
6094
  const FIND_VALUE_FLAGS = new Set(["brand", "limit"]);
6095
+ const WRITE_VALUE_FLAGS = new Set(["kind"]);
6091
6096
  export function parsePositional(args = process.argv.slice(3)) {
6092
6097
  const read = (valueFlags) => {
6093
6098
  const out = [];
@@ -6110,6 +6115,9 @@ export function parsePositional(args = process.argv.slice(3)) {
6110
6115
  const asFind = read(FIND_VALUE_FLAGS);
6111
6116
  if (asFind[0] === "swipe" && asFind[1] === "find")
6112
6117
  return asFind;
6118
+ const asWrite = read(WRITE_VALUE_FLAGS);
6119
+ if (asWrite[0] === "swipe" && asWrite[1] === "write")
6120
+ return asWrite;
6113
6121
  return read(new Set());
6114
6122
  }
6115
6123
  function flagString(flags, name) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1100-beta.9",
3
+ "version": "2026.11.1200-beta.1",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",