@aicopycoders/exodus 2026.9.2000-beta.15 → 2026.9.2000-beta.17

package/assets/skills/exodus-video/scripts/first-cut.mjs

@@ -4,7 +4,8 @@
 // spine at the moment its cued line is spoken, a room-tone bed and the music
 // bed go underneath, and one MP4 comes out ready to upload. A reaction
 // cutaway is the exception: it is its own short beat in the spine right after
-// its cued line ends, heard with its own sound while the speaker is silent.
+// its cued line ends, heard with its own sound while the speaker is silent,
+// and its sound fades out quietly under the next line rather than stopping.
 //
 //   node first-cut.mjs <pulled-dir> [--out cut.mp4] [--skip 2,5] [--no-music]
 //
@@ -59,6 +60,13 @@ const ROOM_TONE =
 const MUSIC_VOLUME = 0.18;
 /** The longest a reaction beat holds the spine (#2357); older pulls carry 4 s reaction clips. */
 export const REACTION_MAX_SEC = 1.5;
+/**
+ * A reaction's laugh carries into the next line instead of stopping dead at
+ * the join (#2406): it starts well under the speaker, at this share of its own
+ * level (about -9 dB), and fades to silence over this long.
+ */
+export const REACTION_TAIL_SEC = 0.75;
+export const REACTION_TAIL_GAIN = 0.35;
 /**
  * The air a join keeps around its words (#2388): after one clip's last word, and
  * before the next clip's first, less when the same speaker carries on than when
@@ -262,6 +270,19 @@ function placeReaction(spine, counts, reaction) {
   return null;
 }
 
+/**
+ * The sound a reaction beat carries under the next segment (#2406): the clip's
+ * own sound past the beat when it has some (older 4 s pulls), else its last
+ * stretch replayed, so a clip exactly as long as its beat still fades out.
+ */
+function reactionTail(seg, next) {
+  const clipLen = seg.clipSeconds ?? seg.seconds;
+  const beatEnd = seg.inSec + seg.seconds;
+  const fromSec = Math.max(0, Math.min(beatEnd, clipLen - REACTION_TAIL_SEC));
+  const seconds = Math.min(REACTION_TAIL_SEC, next.seconds, clipLen - fromSec);
+  return { atSec: next.startSec, fromSec, seconds, gain: REACTION_TAIL_GAIN };
+}
+
 export function buildTimeline({ manifest, storyboard, skip, probe, exists, readWords }) {
   const plans = scenePlans(storyboard);
   const counts = lineWordCounts(storyboard);
@@ -375,6 +396,11 @@ export function buildTimeline({ manifest, storyboard, skip, probe, exists, readW
     seg.startSec = total;
     total += seg.seconds;
   }
+  spine.forEach((seg, k) => {
+    const next = spine[k + 1];
+    if (!seg.reaction || seg.audio !== "clip" || !next) return;
+    seg.reaction.tail = reactionTail(seg, next);
+  });
 
   for (const c of waiting.filter((w) => !w.reaction)) {
     const cue = c.cueLineId ? cueOffsetOnSpine(spine, counts, c.cueLineId) : null;
@@ -421,6 +447,7 @@ export function buildFfmpegArgs(timeline, { resolve, music, out }) {
   };
   const filters = [];
   const pairs = [];
+  const tails = [];
 
   for (const seg of timeline.spine) {
     const i =
@@ -442,12 +469,26 @@ export function buildFfmpegArgs(timeline, { resolve, music, out }) {
     filters.push(`${norm(`${i}:v`)}${fit.length ? `,${fit.join(",")}` : ""}[v${i}]`);
     // A segment split around a reaction beat starts partway into its sound too.
     const skipIn = inSec > 0.001 ? `atrim=start=${sec(inSec)},asetpts=PTS-STARTPTS,` : "";
-    const fitSound =
-      `${LOUDNORM},apad,atrim=0:${sec(seg.seconds)},afade=t=in:d=${EDGE_FADE_SEC},` +
+    const fitLength =
+      `apad,atrim=0:${sec(seg.seconds)},afade=t=in:d=${EDGE_FADE_SEC},` +
       `afade=t=out:st=${sec(seg.seconds - EDGE_FADE_SEC)}:d=${EDGE_FADE_SEC}`;
+    const fitSound = `${LOUDNORM},${fitLength}`;
     if (seg.audio === "narration") {
       const v = addInput("-i", resolve(seg.voice));
       filters.push(`[${v}:a]${stereo},${skipIn}${fitSound}[a${i}]`);
+    } else if (seg.audio === "clip" && seg.reaction?.tail) {
+      // The tail is cut from the same loudness-normalized sound as the beat,
+      // ducked, faded out, and laid in at the join; the next line's own sound
+      // plays at full level over it (#2406).
+      const t = seg.reaction.tail;
+      filters.push(`[${i}:a]${stereo},${skipIn}${LOUDNORM},asplit=2[as${i}][at${i}]`);
+      filters.push(`[as${i}]${fitLength}[a${i}]`);
+      filters.push(
+        `[at${i}]atrim=start=${sec(t.fromSec - inSec)}:duration=${sec(t.seconds)},asetpts=PTS-STARTPTS,` +
+          `volume=${t.gain},afade=t=in:d=${EDGE_FADE_SEC},afade=t=out:st=0:d=${sec(t.seconds)},` +
+          `adelay=delays=${Math.round(t.atSec * 1000)}:all=1[tail${i}]`,
+      );
+      tails.push(`[tail${i}]`);
     } else if (seg.audio === "clip") {
       filters.push(`[${i}:a]${stereo},${skipIn}${fitSound}[a${i}]`);
     } else {
@@ -479,7 +520,7 @@ export function buildFfmpegArgs(timeline, { resolve, music, out }) {
   });
 
   filters.push(`${ROOM_TONE}[room]`);
-  const beds = ["[room]"];
+  const beds = ["[room]", ...tails];
   if (music) {
     const m = addInput("-stream_loop", "-1", "-i", music);
     filters.push(`[${m}:a]${stereo},volume=${MUSIC_VOLUME}[bed]`);
@@ -571,11 +612,15 @@ export function inTheCut(timeline) {
     const label = seg.source === "clip" ? seg.file : `still ${seg.file}`;
     if (seg.reaction) {
       const sound = seg.audio === "clip" ? "its own sound" : "silent: the clip has no sound";
+      const tail = seg.reaction.tail;
+      const fades = tail
+        ? `, fading out under the next line at ${tail.atSec.toFixed(2)}s over ${tail.seconds.toFixed(2)}s`
+        : "";
       rows.push({
         n: seg.sceneIndex,
         line:
           `reaction ${seg.sceneIndex}: ${label} for ${seg.seconds.toFixed(1)}s after ` +
-          `${seg.reaction.cueLineId} in scene ${seg.reaction.cueSceneIndex}, ${sound}`,
+          `${seg.reaction.cueLineId} in scene ${seg.reaction.cueSceneIndex}, ${sound}${fades}`,
       });
       continue;
     }

package/dist/commands/ads.js

@@ -268,7 +268,7 @@ function windowBlock(label, stats) {
         `  spend:        ${spendCell(stats)}`,
         `  ctr:          ${ctrCell(stats)}`,
         `  cpc:          ${cpcCell(stats)}`,
-        `  impressions:  ${count(stats.impressions)} · clicks ${count(stats.clicks)}`,
+        `  impressions:  ${count(stats.impressions)} · reach ${count(stats.reach)} · clicks ${count(stats.clicks)}`,
     ];
 }
 function copyBlock(label, text) {

package/dist/commands/video.d.ts

@@ -30,6 +30,7 @@ export interface ClipQcTake {
         code: string;
         wording: string;
     }[];
+    heardText?: string;
 }
 export interface ClipQc {
     verdict: "pass" | "fail";
@@ -75,6 +76,7 @@ export type ArtifactSubset = {
     tailTrimmed?: boolean;
     rawStorageId?: string;
     voiceMode?: "voice-first";
+    voiceFirstBlockedBy?: string[];
 } | {
     type: "audio";
     sceneIndex?: number;
@@ -284,6 +286,7 @@ export interface ManifestScene {
     speechTrimmed: boolean | null;
     rawStorageId: string | null;
     voiceMode: "voice-first" | null;
+    voiceFirstBlockedBy: string[] | null;
     clipStatus: string;
     error: string | null;
     flagged: boolean;

package/dist/commands/video.js

@@ -21,6 +21,9 @@ function joinedOr(items) {
         return items[0] ?? "";
     return `${items.slice(0, -1).join(", ")} or ${items[items.length - 1]}`;
 }
+function cantSayNames(names) {
+    return `the recorded voice can't say ${joinedOr(names.map((n) => `"${n}"`))}`;
+}
 export const helpText = `
 exodus video — make a video ad from a saved workflow, pull every piece, upload your cut
 
@@ -194,7 +197,7 @@ export function qcWithoutJudgeWording(qc) {
         return qc;
     return {
         ...qc,
-        takes: qc.takes.map(({ judgeWording: _w, ...rest }) => rest),
+        takes: qc.takes.map(({ judgeWording: _w, heardText: _h, ...rest }) => rest),
     };
 }
 export const NO_TAKE_HISTORY_LINE = "no history recorded for this clip";
@@ -587,6 +590,7 @@ function clipFromArtifact(sceneIndex, artifact) {
         speechTrimmed: artifact.speechTrimmed === true,
         rawStorageId: artifact.rawStorageId ?? null,
         voiceMode: artifact.voiceMode ?? null,
+        voiceFirstBlockedBy: artifact.voiceFirstBlockedBy ?? null,
     };
 }
 function keyframeDownload(sceneIndex, imageUrl) {
@@ -897,6 +901,7 @@ export function planPull(run, items, opts) {
             speechTrimmed: clip ? clip.speechTrimmed : null,
             rawStorageId: clip ? clip.rawStorageId : null,
             voiceMode: clip ? clip.voiceMode : null,
+            voiceFirstBlockedBy: clip ? clip.voiceFirstBlockedBy : null,
             clipStatus: item?.status ?? "missing",
             error: item?.error ?? null,
             flagged: item?.flagged === true,
@@ -971,6 +976,7 @@ export function markPullFailure(manifest, failure) {
             scene.speechTrimmed = null;
             scene.rawStorageId = null;
             scene.voiceMode = null;
+            scene.voiceFirstBlockedBy = null;
         }
         if (scene.voice === failure.file)
             scene.voice = null;
@@ -1469,6 +1475,7 @@ export async function statusFlow(runId, json, deps) {
     }
     const revoicedByScene = new Set();
     const voiceFirstByScene = new Set();
+    const voiceFirstBlockedByScene = new Map();
     const timedOnOriginalVoice = new Set();
     for (const artifact of outputsOfNodeKind(run, "video")) {
         if (artifact.type === "video" &&
@@ -1476,6 +1483,11 @@ export async function statusFlow(runId, json, deps) {
             typeof artifact.sceneIndex === "number") {
             voiceFirstByScene.add(artifact.sceneIndex);
         }
+        if (artifact.type === "video" &&
+            artifact.voiceFirstBlockedBy?.length &&
+            typeof artifact.sceneIndex === "number") {
+            voiceFirstBlockedByScene.set(artifact.sceneIndex, artifact.voiceFirstBlockedBy);
+        }
         if (artifact.type === "video" && artifact.revoiced === true && typeof artifact.sceneIndex === "number") {
             revoicedByScene.add(artifact.sceneIndex);
             if ((artifact.words?.length ?? 0) > 0)
@@ -1546,6 +1558,10 @@ export async function statusFlow(runId, json, deps) {
                 lines.push("       voice: cast voice applied");
             if (voiceFirstByScene.has(sceneIndex))
                 lines.push("       clip: redone voice first");
+            const blockedBy = voiceFirstBlockedByScene.get(sceneIndex);
+            if (blockedBy) {
+                lines.push(`       clip: redone the usual way — ${cantSayNames(blockedBy)}`);
+            }
             if (timedOnOriginalVoice.has(sceneIndex)) {
                 lines.push("       word timings: measured on the original voice (close, not frame-exact)");
             }
@@ -1904,7 +1920,9 @@ export async function retryClipFlow(runId, target, { note, voiceFirst = false },
         lines: [
             voiceFirst
                 ? `Redoing scene ${plan.sceneIndex}'s clip on ${plan.nodeId}, voice first: the line is ` +
-                    "recorded in the character's own voice, then the clip is made to match it."
+                    "recorded in the character's own voice, then the clip is made to match it. " +
+                    "If the line has a made-up name the recorded voice can't say, the clip may be made " +
+                    `the usual way instead, and exodus video status ${runId} will say so.`
                 : `Redoing scene ${plan.sceneIndex}'s clip on ${plan.nodeId}.`,
             `triggerRunId: ${triggerRunId ?? "-"}`,
             ...(voiceFirst
@@ -2286,6 +2304,13 @@ export async function pullFlow(runId, dir, json, deps) {
         lines.push("", `Redone voice first (the line recorded, then the clip made to match it): ` +
             `scene${voiceFirst.length === 1 ? "" : "s"} ${voiceFirst.map((s) => s.sceneIndex).join(", ")}`);
     }
+    const redoneUsualWay = plan.manifest.scenes.filter((s) => s.voiceFirstBlockedBy?.length);
+    if (redoneUsualWay.length > 0) {
+        lines.push("", "Asked for voice first, but redone the usual way:");
+        for (const scene of redoneUsualWay) {
+            lines.push(`  scene ${scene.sceneIndex}: ${cantSayNames(scene.voiceFirstBlockedBy ?? [])}`);
+        }
+    }
     const flagged = plan.manifest.scenes.filter((s) => s.flagged);
     if (flagged.length > 0) {
         lines.push("", `${flagged.length} clip${flagged.length === 1 ? "" : "s"} came back flagged — usable, but look before you cut:`);

package/dist/lib/meta-ads.d.ts

@@ -22,6 +22,7 @@ export interface AdWindowStats {
     spend?: number | null;
     spendDisplay?: string | null;
     impressions?: number | null;
+    reach?: number | null;
     clicks?: number | null;
     currency?: string | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.9.2000-beta.15",
+  "version": "2026.9.2000-beta.17",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",