@aicopycoders/exodus 2026.11.1200-beta.25 → 2026.11.1200-beta.27

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.
@@ -287,7 +287,9 @@ move someone (Micro-drama template only), or stop.
287
287
  (with the pilot stop, the pilot first), the expensive part. The CLI prints
288
288
  no price for them at this stop: say so, and approve on their yes. A storyboard the app's check stopped is
289
289
  refused with the reason. Tell the member, and on their yes approve again
290
- 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.
291
293
  - Redo a picture: `exodus video retry-frame <runId> --node <nodeId> --scene <n>
292
294
  --note "<what is wrong>"`, with the node id from the `Redo one frame:` line
293
295
  `status` printed. It redraws one picture. The CLI prints no price for it:
@@ -386,6 +386,12 @@ export interface CutSync {
386
386
  /** COP-357, fps30: the frame rate a film with the phone look is delivered at, by repeated frames. */
387
387
  export const DELIVERY_FPS: number;
388
388
 
389
+ /** The finished cut's frames on its own 24 fps clock: the joined picture's, or round(frames / speed) after a speed step. */
390
+ export function filmFrames(pictureSec: number, speed?: number | null): number;
391
+
392
+ /** #4817: the frames a film delivered at `deliverFps` has, so its picture runs as long as its sound (filmFrames after a speed step, else pictureSec), rounded up. */
393
+ export function deliveredFrames(pictureSec: number, speed: number | null, deliverFps: number): number;
394
+
389
395
  /** The bars checkVerdict holds a finished cut to. */
390
396
  export const CHECK_BARS: {
391
397
  voiceOverBedDb: number;
@@ -306,6 +306,22 @@ function wholeLinesOf(raw) {
306
306
  * motion is read back on FPS, and its caption check reads each caption on the frame the delivered file shows it on.
307
307
  */
308
308
  export const DELIVERY_FPS = 30;
309
+
310
+ /** The finished cut's frames on FPS: the joined picture's, or round(frames / speed) after a speed step, as its sound ends. */
311
+ export function filmFrames(pictureSec, speed = null) {
312
+ const frames = Math.round(pictureSec * FPS);
313
+ return speed ? Math.round(frames / speed + 1e-9) : frames;
314
+ }
315
+
316
+ /**
317
+ * #4817: the frames a film delivered at `deliverFps` has, so its picture runs as long as its sound: after a speed step
318
+ * the sound ends on filmFrames on FPS, with none it ends on pictureSec itself. Rounded up to a whole delivered frame, so
319
+ * the picture never ends before the sound, and never by a whole frame after it.
320
+ */
321
+ export function deliveredFrames(pictureSec, speed, deliverFps) {
322
+ const soundSec = speed ? filmFrames(pictureSec, speed) / FPS : Number(pictureSec.toFixed(6));
323
+ return Math.ceil(soundSec * deliverFps - 1e-9);
324
+ }
309
325
  export const LENS_SMUDGE = {
310
326
  /** Where the side is read: this far into the cut. */
311
327
  readAtSec: 1,
@@ -4905,8 +4921,11 @@ export function buildFfmpegArgs(timeline, { resolve, music, out, finish = null,
4905
4921
  videoLabel = "burned";
4906
4922
  }
4907
4923
  // COP-357, fps30: the finished picture, words and all, at the delivered rate by repeated frames; the clock above is FPS.
4924
+ // #4817: it ends on exactly the frames its sound needs (deliveredFrames), its last frame repeated when the graph
4925
+ // ends a frame early, as Debian's ffmpeg 5.1 (the worker's) does after the lens smudge's maskedmerge.
4908
4926
  if (finish?.deliverFps) {
4909
- filters.push(`[${videoLabel}]fps=${finish.deliverFps}[delivered]`);
4927
+ const frames = deliveredFrames(pictureSec, speed, finish.deliverFps);
4928
+ filters.push(`[${videoLabel}]fps=${finish.deliverFps},tpad=stop_mode=clone:stop=-1,trim=end_frame=${frames}[delivered]`);
4910
4929
  videoLabel = "delivered";
4911
4930
  }
4912
4931
 
@@ -5016,7 +5035,7 @@ export function buildFfmpegArgs(timeline, { resolve, music, out, finish = null,
5016
5035
  // COP-300: the faster sound padded or cut to the faster picture's own length, as each segment's is to its
5017
5036
  // picture's: `fps` ends the picture on round(frames / speed) frames, and atempo runs on past it. The cut can land
5018
5037
  // in a word's tail, so the last END_FADE_SAMPLES fade out, as each segment's edges do, and the end never clicks.
5019
- const end = Math.round(Math.round(pictureSec * FPS) / speed + 1e-9) * SAMPLES_PER_FRAME;
5038
+ const end = filmFrames(pictureSec, speed) * SAMPLES_PER_FRAME;
5020
5039
  filters.push(`[mix]atempo=${speed},apad,atrim=end_sample=${end},afade=t=out:ss=${end - END_FADE_SAMPLES}:ns=${END_FADE_SAMPLES}[mixfaster]`);
5021
5040
  audioLabel = "mixfaster";
5022
5041
  }
@@ -114,6 +114,9 @@ export interface CustomerRun {
114
114
  planHold?: {
115
115
  atBoard?: boolean;
116
116
  beforePictures: boolean;
117
+ notes?: string[];
118
+ acceptFindings?: boolean;
119
+ findings?: CustomerPlanFinding[];
117
120
  };
118
121
  place?: {
119
122
  name: string;
@@ -161,6 +164,12 @@ export interface CustomerStoryboard {
161
164
  stage: CustomerRunStage;
162
165
  scenes: CustomerRunScene[] | null;
163
166
  noPictureBeforeApproval?: true;
167
+ beforePictures?: true;
168
+ findings?: CustomerPlanFinding[];
169
+ }
170
+ export interface CustomerPlanFinding {
171
+ text: string;
172
+ scenes: number[];
164
173
  }
165
174
  export interface CustomerItem {
166
175
  sceneIndex: number;
@@ -97,6 +97,16 @@ function heldSceneChoiceLines(run, scenes, page) {
97
97
  : []),
98
98
  ];
99
99
  }
100
+ function findingLines(findings) {
101
+ return (findings ?? []).map((f) => {
102
+ const n = f.scenes;
103
+ const where = n.length === 0 ? "" : n.length === 1 ? `Scene ${n[0]}: ` : `Scenes ${n.slice(0, -1).join(", ")} and ${n[n.length - 1]}: `;
104
+ return ` ${where}${f.text}`;
105
+ });
106
+ }
107
+ function acceptFindingsLine(id) {
108
+ return `Go on anyway, accepting what the check found: exodus video approve ${id} --accept-findings`;
109
+ }
100
110
  export function customerAnswer(data) {
101
111
  return typeof data === "object" && data !== null && data.view === "customer"
102
112
  ? data
@@ -228,6 +238,16 @@ export function customerStageLines(run, page) {
228
238
  `Watch it here: ${page}`,
229
239
  ];
230
240
  case "review":
241
+ if (run.planHold?.acceptFindings) {
242
+ return [
243
+ ...(run.planHold.notes?.length ? run.planHold.notes : ["The app's check found a problem with this plan."]),
244
+ ...findingLines(run.planHold.findings),
245
+ ...(run.place?.imageUrl ? [`The place: ${run.place.imageUrl}`] : []),
246
+ `Read it: exodus video storyboard ${id}`,
247
+ acceptFindingsLine(id),
248
+ `If the check is right, stop this video on its page and start a new one with your script changed: ${page}`,
249
+ ];
250
+ }
231
251
  if (noPictureBeforeApproval(run) && run.place) {
232
252
  return [
233
253
  "Your script, place and voice are waiting for your yes. No take is filmed before you approve.",
@@ -311,13 +331,28 @@ export function customerStoryboardLines(board) {
311
331
  `Check where it is: exodus video status ${id}`,
312
332
  ];
313
333
  }
334
+ const scriptLines = (scenes) => scenes.flatMap((scene) => [` Scene ${scene.sceneIndex}`, ` ${scene.line ? `"${scene.line}"` : "No spoken line"}`]);
335
+ const found = board.findings?.length ? ["", "What the app's check found:", ...findingLines(board.findings)] : [];
336
+ const approve = board.findings?.length ? acceptFindingsLine(id) : `approve with: exodus video approve ${id}`;
314
337
  if (board.noPictureBeforeApproval) {
315
338
  return [
316
339
  "Script",
317
- ...board.scenes.flatMap((scene) => [` Scene ${scene.sceneIndex}`, ` ${scene.line ? `"${scene.line}"` : "No spoken line"}`]),
340
+ ...scriptLines(board.scenes),
341
+ ...found,
318
342
  "",
319
343
  "No take gets a picture before you approve.",
320
- `approve with: exodus video approve ${id}`,
344
+ approve,
345
+ `pick voices: exodus video voices ${id}`,
346
+ ];
347
+ }
348
+ if (board.beforePictures) {
349
+ return [
350
+ "Storyboard",
351
+ ...scriptLines(board.scenes),
352
+ ...found,
353
+ "",
354
+ "No scene pictures are drawn before you approve. Any pictures of the people or the place were drawn already, inside the price you were shown.",
355
+ approve,
321
356
  `pick voices: exodus video voices ${id}`,
322
357
  ];
323
358
  }
@@ -444,11 +444,12 @@ Options:
444
444
  --no-music Leave the music bed off (start), which it already is
445
445
  --broll Cut away to B-roll shots in the ad (start, with
446
446
  --conceit). Only for accounts with B-roll switched on
447
- --one-shot Make the whole video with no stop (start, with
447
+ --one-shot Make the whole video in one go (start, with
448
448
  --conceit). The app approves its own storyboard when
449
449
  its checks pass and goes straight on to the clips,
450
- which is the part that costs. Without it the run is
451
- Guided: it stops at the storyboard for your yes
450
+ which is the part that costs. When a check finds a
451
+ problem it stops at the storyboard for you. Without it
452
+ the run is Guided: it stops at the storyboard for your yes
452
453
  --review-storyboard Stop at the storyboard so you can approve it yourself
453
454
  (start, with --conceit). This is the default, so the
454
455
  flag changes nothing. Kept for scripts that pass it
@@ -4273,23 +4274,14 @@ export async function statusFlow(runId, json, deps) {
4273
4274
  lines.push(` picture: ${row.frame.lastRedo.label}`);
4274
4275
  for (const found of row.clip?.findings ?? []) {
4275
4276
  const finding = choiceMade(row.clip) ? { ...found, detail: heldChoiceMade(found.detail) } : found;
4276
- if (ONE_TAKE_PLAIN_FINDING_CODES.includes(finding.code)) {
4277
- if (finding.code === ONE_TAKE_LABEL_ALL_FLIPPED_CODE) {
4278
- if (allFlippedSaid)
4279
- continue;
4280
- allFlippedSaid = true;
4281
- }
4282
- lines.push(` ${finding.detail}`);
4283
- continue;
4284
- }
4285
- lines.push(` ${finding.code} (${finding.severity}): ${finding.detail}`);
4286
- const judgeSeverity = finding.judgeSeverity ?? finding.severity;
4287
- if (finding.judgeDetail) {
4288
- lines.push(` checker said (${judgeSeverity}): ${finding.judgeDetail}`);
4289
- }
4290
- else if (judgeSeverity !== finding.severity) {
4291
- lines.push(` checker rated it ${judgeSeverity}`);
4277
+ if (finding.code === ONE_TAKE_LABEL_ALL_FLIPPED_CODE) {
4278
+ if (allFlippedSaid)
4279
+ continue;
4280
+ allFlippedSaid = true;
4292
4281
  }
4282
+ lines.push(` ${finding.detail}`);
4283
+ if (finding.judgeDetail)
4284
+ lines.push(` checker said: ${finding.judgeDetail}`);
4293
4285
  }
4294
4286
  if (row.clip?.error)
4295
4287
  lines.push(` ${row.clip.error}`);
@@ -4309,7 +4301,7 @@ export async function statusFlow(runId, json, deps) {
4309
4301
  lines.push(" word timings: measured on the original voice (close, not frame-exact)");
4310
4302
  }
4311
4303
  for (const finding of row.frame?.findings ?? []) {
4312
- lines.push(` picture: ${finding.code} (${finding.severity}): ${finding.detail}`);
4304
+ lines.push(` picture: ${finding.detail}`);
4313
4305
  }
4314
4306
  }
4315
4307
  if (outputsOfNodeKind(run, "voiceover").some(isNarrationMaster)) {
@@ -4368,7 +4360,6 @@ export const ONE_TAKE_HEARD_AS_CODE = "one-take-words-heard-as";
4368
4360
  export const ONE_TAKE_LABEL_CODES = ["one-take-label-flipped", "one-take-label-unsure", "one-take-label-held", "one-take-label-flipped-all"];
4369
4361
  const ONE_TAKE_LABEL_ALL_FLIPPED_CODE = "one-take-label-flipped-all";
4370
4362
  export const ONE_TAKE_SAID_WRONG_CODES = ["one-take-said-wrong", "one-take-second-listen-failed"];
4371
- const ONE_TAKE_PLAIN_FINDING_CODES = [ONE_TAKE_HEARD_AS_CODE, ...ONE_TAKE_LABEL_CODES, ...ONE_TAKE_SAID_WRONG_CODES];
4372
4363
  const DIRECTOR_STATUS_WORDS = {
4373
4364
  reviewing: "Watching this run",
4374
4365
  waiting: "Waiting for redos to finish",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.25",
3
+ "version": "2026.11.1200-beta.27",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",