@aicopycoders/exodus 2026.9.2000-beta.16 → 2026.9.2000-beta.18

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

@@ -75,6 +75,8 @@ export const REACTION_TAIL_GAIN = 0.35;
 export const JOIN_TAIL_SEC = 0.15;
 export const JOIN_LEAD_SAME_SPEAKER_SEC = 0.1;
 export const JOIN_LEAD_NEW_SPEAKER_SEC = 0.25;
+/** The gap a cut keeps from an extra heard sound it leaves out (#2541). */
+const EXTRA_CLEARANCE_SEC = 0.05;
 
 /** The word rule the planner sized every line with (scout models.ts wordCount). */
 export function wordCount(text) {
@@ -90,6 +92,27 @@ export function lineWordCounts(storyboard) {
   return counts;
 }
 
+const wordToken = (word) => String(word ?? "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "");
+
+/**
+ * #2541: the indexes of the heard words that deliver the first and last
+ * scripted word, matching the script in order at its earliest delivery, or null
+ * when the whole script is not heard that way.
+ */
+export function scriptedSpan(words, lineTexts) {
+  const script = lineTexts.flatMap((text) => (text ?? "").split(/\s+/)).map(wordToken).filter(Boolean);
+  if (script.length === 0) return null;
+  let first = -1;
+  let j = 0;
+  for (const token of script) {
+    while (j < words.length && wordToken(words[j].w) !== token) j++;
+    if (j === words.length) return null;
+    if (first < 0) first = j;
+    j++;
+  }
+  return { first, last: j - 1 };
+}
+
 const CUTAWAY_KINDS = new Set(["cutaway", "insert"]);
 
 const hasText = (value) => typeof value === "string" && value.trim().length > 0;
@@ -199,26 +222,48 @@ export function cueEndInSegment(seg, counts, cueLineId) {
  * and leaves the ad's first lead-in and last tail alone; a clip whose closing
  * line cues a reaction is not the ad's end, since the beat follows it. Trims
  * land on whole frames so the picture and its sound stay the same length.
+ *
+ * The beat is measured from the clip's scripted words when the script is heard
+ * in order, and a cut stops short of a sound made up before or after the line
+ * ("Hmm", "Um"), even at the ad's own edges (#2541). Sounds inside the line stay.
  */
-function trimJoins(spine, reactionCues) {
+function trimJoins(spine, reactionCues, lineTexts) {
   spine.forEach((seg, k) => {
     if (seg.source !== "clip" || seg.audio !== "clip" || !seg.words?.length) return;
     const prev = spine[k - 1];
     const sameSpeaker = Boolean(prev?.lastSpeaker) && prev.lastSpeaker === seg.firstSpeaker;
     const lead = sameSpeaker ? JOIN_LEAD_SAME_SPEAKER_SEC : JOIN_LEAD_NEW_SPEAKER_SEC;
-    const firstWord = Math.min(...seg.words.map((w) => w.s));
-    const lastWord = Math.max(...seg.words.map((w) => w.e));
-    const inSec = prev ? Math.max(0, floorFrame(firstWord - lead)) : 0;
+    const span = scriptedSpan(seg.words, seg.lineIds.map((id) => lineTexts.get(id)));
+    const line = span ? seg.words.slice(span.first, span.last + 1) : seg.words;
+    const before = span ? seg.words.slice(0, span.first) : [];
+    const after = span ? seg.words.slice(span.last + 1) : [];
+    const firstWord = Math.min(...line.map((w) => w.s));
+    const lastWord = Math.max(...line.map((w) => w.e));
+    let inSec = prev ? Math.max(0, floorFrame(firstWord - lead)) : 0;
+    if (before.length > 0) {
+      const clear = ceilFrame(Math.max(...before.map((w) => w.e)) + EXTRA_CLEARANCE_SEC);
+      inSec = Math.max(inSec, Math.min(clear, floorFrame(firstWord)));
+    }
     const endsAd = k === spine.length - 1 && !reactionCues.has(seg.lineIds.at(-1));
-    const outSec = endsAd ? seg.seconds : Math.min(seg.seconds, ceilFrame(lastWord + JOIN_TAIL_SEC));
+    let outSec = endsAd
+      ? after.length > 0 ? ceilFrame(lastWord + TAIL_AIR_SEC) : seg.seconds
+      : ceilFrame(lastWord + JOIN_TAIL_SEC);
+    if (after.length > 0) {
+      const clear = floorFrame(Math.min(...after.map((w) => w.s)) - EXTRA_CLEARANCE_SEC);
+      outSec = Math.min(outSec, Math.max(clear, ceilFrame(lastWord)));
+    }
+    outSec = Math.min(seg.seconds, outSec);
     if (outSec <= inSec) return;
     const how = [];
     if (inSec > 0) how.push(`lead-in trimmed ${inSec.toFixed(2)}s`);
     if (outSec < seg.seconds) how.push(`tail trimmed ${(seg.seconds - outSec).toFixed(2)}s`);
     if (how.length === 0) return;
+    const kept = seg.words.filter((w) => w.s < outSec && w.e > inSec);
+    if (before.some((w) => !kept.includes(w))) how.push("extra sound before the line trimmed");
+    if (after.some((w) => !kept.includes(w))) how.push("extra sound after the line trimmed");
     seg.inSec = inSec;
     seg.seconds = outSec - inSec;
-    seg.words = seg.words.map((w) => ({ ...w, s: w.s - inSec, e: w.e - inSec }));
+    seg.words = kept.map((w) => ({ ...w, s: w.s - inSec, e: w.e - inSec }));
     seg.note = `${seg.note} (${how.join(", ")})`;
   });
 }
@@ -385,7 +430,8 @@ export function buildTimeline({ manifest, storyboard, skip, probe, exists, readW
   // Joins are closed first so a reaction beat lands right after its cue line
   // ends in the trimmed clip. Reactions change the spine, so they go in before
   // any overlay is placed on it.
-  trimJoins(spine, new Set(waiting.filter((w) => w.reaction).map((w) => w.cueLineId)));
+  const lineTexts = new Map((storyboard?.script ?? []).map((line) => [line?.lineId, line?.text]));
+  trimJoins(spine, new Set(waiting.filter((w) => w.reaction).map((w) => w.cueLineId)), lineTexts);
   for (const c of waiting.filter((w) => w.reaction)) {
     if (!c.cueLineId || placeReaction(spine, counts, c) === null) {
       dropped.push({ n: c.sceneIndex, reason: `cutaway ${c.sceneIndex}: ${noCue(c)}` });

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.16",
+  "version": "2026.9.2000-beta.18",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",