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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1100-beta.10",
3
+ "version": "2026.11.1100-beta.11",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",