@koda-sl/baker-cli 0.319.0 → 0.321.0-dev.2d7a8f01b

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-WONWYE7B.js";
+} from "./chunk-OLAB3JMW.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -14808,6 +14808,14 @@ var analyticsQueryRequestSchema = z31.object({
    * came for — a deal a CRM posted names the person and carries no cookie.
    */
   anonId: z31.string().max(120).optional(),
+  /**
+   * `stream` and `session`: one person by any key the store recognises them
+   * by — a contact digest, a CRM id, a click id, a platform cookie — for the
+   * rows a system posted about somebody no browser has named yet. A browser
+   * wins when both are given.
+   */
+  personKind: z31.string().max(40).optional(),
+  personValue: z31.string().max(255).optional(),
   /**
    * `people` only: keep only the visitors who converted.
    *
@@ -14844,9 +14852,9 @@ var analyticsQueryRequestSchema = z31.object({
   message: "The 'page' preset needs --path",
   path: ["path"]
 }).refine(
-  (value) => value.preset !== "session" || typeof value.sessionId === "string" || typeof value.anonId === "string",
+  (value) => value.preset !== "session" || typeof value.sessionId === "string" || typeof value.anonId === "string" || typeof value.personValue === "string",
   {
-    message: "The 'session' preset needs --session or a browser id",
+    message: "The 'session' preset needs --session, a browser id or a person key",
     path: ["sessionId"]
   }
 ).refine((value) => value.property === void 0 || typeof value.eventName === "string", {
@@ -14877,6 +14885,13 @@ var analyticsTotalsSchema = z31.object({
    * {@link convertingSessions}, and of `sessions`.
    */
   conversions: z31.number().int().nonnegative(),
+  /**
+   * Conversions in the window that no landing earned — by people none of the
+   * company's pages saw. Not in `conversions`, which is a page metric; shown
+   * beside it so a deal a CRM reported is never a silent zero. Zero under any
+   * scope.
+   */
+  unplacedConversions: z31.number().int().nonnegative().default(0),
   /** Visits that produced at least one conversion. Never above `sessions`. */
   convertingSessions: z31.number().int().nonnegative(),
   /**
@@ -15369,8 +15384,14 @@ var analyticsConversionRowSchema = z31.object({
    * accident; saying so is what makes it findable.
    */
   countMode: z31.string(),
-  /** Counted the way each definition asked to be counted. */
+  /** Counted the way each definition asked to be counted, and credited to a landing. */
   conversions: z31.number(),
+  /**
+   * Times it happened that no landing earned: by people none of the company's
+   * pages saw, within 90 days. Zero under a landing or an ad scope, where the
+   * gap would mean something else. Absent on a row built before it existed.
+   */
+  unplaced: z31.number().default(0),
   /** Distinct visits that produced it, never mode-adjusted. The gap between the two is the repeat behaviour. */
   convertingVisits: z31.number(),
   /** Null when it has never fired. */
@@ -30352,6 +30373,7 @@ function mergeStoredWithCounts(stored, reported) {
       // would make it indistinguishable from one nobody has named.
       conversions: counted?.conversions ?? 0,
       convertingVisits: counted?.convertingVisits ?? 0,
+      unplaced: counted?.unplaced ?? 0,
       lastSeen: counted?.lastSeen ?? null,
       doors: counted?.doors ?? [],
       ...rows.some((row) => row.staged === true) ? { staged: true } : {}
@@ -41911,6 +41933,7 @@ function endCardCta(spec) {
   return declared.toLowerCase().replace(/[.!?]$/, "") === closing.replace(/[.!?]$/, "") ? null : declared;
 }
 var AD_CAST_ID = "customer";
+var AD_NARRATOR_ID = "ad_narrator";
 var AD_SET_ID = "set";
 function castedAvatarOnRoster(ad, roster) {
   if (ad.cast?.avatar) return null;
@@ -41966,9 +41989,9 @@ function adSpecCastElements(spec, avatar) {
   });
   return elements;
 }
-function motionPrompt(beat, toCamera, isClosingCard, place, physics) {
+function motionPrompt(beat, toCamera, isClosingCard, place) {
   if (isClosingCard) return BRAND_PLATE;
-  const shot = `${beat.show}${place}${physics}`;
+  const shot = `${beat.show}${place}`;
   if (toCamera) return shot;
   return `${shot} Nobody in frame is speaking: mouths CLOSED and STILL throughout, no talking, no lip movement. Whoever is in shot is looking, reacting or working \u2014 never addressing the camera.`;
 }
@@ -42016,11 +42039,9 @@ function beatsIntroducingSpeakerOffCamera(spec) {
     (beat, i) => lineIntroducesSpeaker(beat.say) && !beatToCamera(spec, beat, closesOnCard && i === last) ? [i] : []
   );
 }
-function wantsNativeSpeech(spec, closesOnCard) {
+function beatSpeaksNatively(spec, beat, isClosingCard) {
   if (!spec.cast || spec.voiceover === false) return false;
-  const last = spec.beats.length - 1;
-  const speaking = spec.beats.filter((_, i) => !(closesOnCard && i === last));
-  return speaking.length > 0 && speaking.every((beat) => beatToCamera(spec, beat, false) && beat.cast !== false);
+  return beatToCamera(spec, beat, isClosingCard) && beat.cast !== false;
 }
 function beatDialogue(spec, beat, window2) {
   if (spec.voiceover === false) return [];
@@ -42037,14 +42058,38 @@ function beatDialogue(spec, beat, window2) {
       // by definition never on camera — so every beat took the dubbed path: a clip generated
       // with one mouth and a separate ElevenLabs track laid over it. That is the mismatch
       // behind every "the mouth does not match" in this ad's history.
-      ...window2.nativeSpeech && !window2.isClosingCard ? { speaker: AD_CAST_ID } : {},
-      ...spec.voice?.description ? { voice_description: spec.voice.description } : {}
+      //
+      // A beat that is NOT hers names the ad's OWN narrator (`AD_NARRATOR_ID`), rather
+      // than leaving the label off. A different speaker is what breaks the phrase, and a
+      // phrase break is what keeps each beat its own clip: left unlabelled, the engine read
+      // the cutaway as her narrating over an insert in one continuous take and merged the
+      // beats around it into a single native read with the dubbed one laid on top.
+      speaker: window2.nativeSpeech ? AD_CAST_ID : AD_NARRATOR_ID,
+      // The narrator is cast from the ad's voice, and failing that from the CAST's own
+      // description. Naming a speaker of our own cost this: the engine casts an unnamed
+      // narrator by folding it into the lone presenter and reusing her casting, so the
+      // closing line inherited her persona for free. Named, it is a speaker in nobody's
+      // `cast`, and the engine's last-resort description for one of those is the literal
+      // "<speaker> voice" — so an ad with an avatar, a closing card and no `voice`
+      // (a perfectly ordinary spec) had its closing tagline cast off the words
+      // "ad_narrator voice".
+      ...narratorVoice(spec, window2.avatarVoice) ? { voice_description: narratorVoice(spec, window2.avatarVoice) } : {}
     }
   ];
 }
-function voiceoverMode(spec, nativeSpeech) {
+function narratorVoice(spec, avatarVoice) {
+  return spec.voice?.description?.trim() || avatarVoice?.trim() || spec.cast?.description?.trim() || void 0;
+}
+function nativeSpeechByBeat(spec, closesOnCard) {
+  const last = spec.beats.length - 1;
+  return spec.beats.map((beat, i) => beatSpeaksNatively(spec, beat, closesOnCard && i === last));
+}
+function voiceoverMode(spec, nativeByBeat, closesOnCard) {
   if (spec.voiceover === false) return "none";
-  return nativeSpeech ? "on_camera" : "voiceover";
+  const spoken = closesOnCard ? nativeByBeat.slice(0, -1) : nativeByBeat;
+  const native = spoken.filter(Boolean).length;
+  if (native === 0) return "voiceover";
+  return native === spoken.length ? "on_camera" : "mixed";
 }
 function castRole(spec) {
   if (!spec.cast) return void 0;
@@ -42061,7 +42106,8 @@ function adSpecToBlueprint(spec, opts = {}) {
   const currency = market ? CURRENCY_BY_MARKET[market.toLowerCase()] : void 0;
   const physics = frameRealismDirection({ currency, role: castRole(spec) });
   const closesOnCard = endCardWanted(spec);
-  const nativeSpeech = wantsNativeSpeech(spec, closesOnCard);
+  const nativeByBeat = nativeSpeechByBeat(spec, closesOnCard);
+  const spokenMode = voiceoverMode(spec, nativeByBeat, closesOnCard);
   let clock = 0;
   const scenes = spec.beats.map((beat, i) => {
     const isClosingCard = closesOnCard && i === total - 1;
@@ -42090,9 +42136,10 @@ function adSpecToBlueprint(spec, opts = {}) {
         start: Math.round(start * 100) / 100,
         end: Math.round(clock * 100) / 100,
         isClosingCard,
-        nativeSpeech
+        nativeSpeech: nativeByBeat[i] === true,
+        avatarVoice: opts.avatarVoice
       }),
-      motion_prompt: motionPrompt(beat, beatToCamera(spec, beat, isClosingCard), isClosingCard, place, physics),
+      motion_prompt: motionPrompt(beat, beatToCamera(spec, beat, isClosingCard), isClosingCard, place),
       start_frame_prompt: isClosingCard ? BRAND_PLATE : `${beat.show}${place}${physics}`
     };
   });
@@ -42104,9 +42151,9 @@ function adSpecToBlueprint(spec, opts = {}) {
       // the script itself, so an ad that never named a place still says where it is set.
       ...market ? { market } : {},
       voiceover: {
-        mode: voiceoverMode(spec, nativeSpeech),
+        mode: spokenMode,
         ...spokenVariety(spec, avatarAccent) ? { accent: spokenVariety(spec, avatarAccent) } : {},
-        ...spec.voice?.description ? { voice_description: spec.voice.description } : {}
+        ...narratorVoice(spec, opts.avatarVoice) ? { voice_description: narratorVoice(spec, opts.avatarVoice) } : {}
       },
       ...spec.cast ? {
         cast: [
@@ -42136,15 +42183,10 @@ function beatsTooShortToPlay(spec) {
 // src/engine/scaffold/ad-brand-overlay.ts
 var markFallback = (name) => name.trim() ? ` onerror="this.replaceWith(Object.assign(document.createElement('span'),{className:this.className+' brand-wordmark',textContent:${escapeHtml2(JSON.stringify(name.trim()))}}))"` : "";
 var escapeHtml2 = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-function firstHex(palette) {
-  const hex = (palette ?? []).find((h) => /^#?[0-9a-fA-F]{6}$/.test(h.trim()));
-  if (!hex) return null;
-  const trimmed = hex.trim();
-  return trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
-}
 function buildAdBrandOverlay(opts) {
-  const { logo, cta, cardAtS, cardDurationS, totalS, accent } = opts;
+  const { logo, cta, cardAtS, cardDurationS, totalS } = opts;
   if (!logo && !cta?.trim()) return "";
+  const inkClass = opts.markIsLight ? " on-dark" : "";
   const parts = [
     "<!-- Brand layer, emitted by `baker canvas scaffold-ad`. The mark and the closing",
     "     card are drawn HERE, by the composition \u2014 never generated as a picture, because",
@@ -42154,18 +42196,19 @@ function buildAdBrandOverlay(opts) {
   ];
   if (logo) {
     parts.push(
-      `<img class="clip brand-mark" src="${escapeHtml2(logo.file)}" alt="${escapeHtml2(logo.alt)}" data-start="0" data-dur="${totalS}"${markFallback(logo.alt)} />`
+      `<img class="clip brand-mark${inkClass}" src="${escapeHtml2(logo.file)}" alt="${escapeHtml2(logo.alt)}" data-start="0" data-dur="${totalS}"${markFallback(logo.alt)} />`
     );
   }
   const cardBits = [];
   if (logo) {
     cardBits.push(
-      `<img class="endcard-logo" src="${escapeHtml2(logo.file)}" alt="${escapeHtml2(logo.alt)}"${markFallback(logo.alt)} />`
+      `<img class="endcard-logo${inkClass}" src="${escapeHtml2(logo.file)}" alt="${escapeHtml2(logo.alt)}"${markFallback(logo.alt)} />`
     );
   }
   if (cta?.trim()) {
-    const style = accent ? ` style="background:${escapeHtml2(accent)}"` : "";
-    cardBits.push(`<div class="endcard-cta"${style}>${escapeHtml2(cta.trim())}</div>`);
+    cardBits.push(
+      `<div class="endcard-cta${opts.plateIsDark ? " on-dark-plate" : ""}">${escapeHtml2(cta.trim())}</div>`
+    );
   }
   parts.push(
     `<div class="clip endcard" data-start="${cardAtS}" data-dur="${cardDurationS}" data-role="cta">`,
@@ -42182,6 +42225,8 @@ function brandLayerDriver() {
     "    var els = Array.prototype.slice.call(document.querySelectorAll('.brand-mark, .endcard'));",
     "    if (!els.length) return;",
     "    els.forEach(function (el) { gsap.set(el, { visibility: 'hidden' }); });",
+    "    var card = document.querySelector('.endcard');",
+    "    var captions = document.getElementById('captions');",
     "    function attach(tl) {",
     "      if (!tl) return;",
     "      els.forEach(function (el) {",
@@ -42190,6 +42235,18 @@ function brandLayerDriver() {
     "        tl.set(el, { visibility: 'visible' }, at);",
     "        if (dur > 0) tl.set(el, { visibility: 'hidden' }, at + dur);",
     "      });",
+    "      // The closing card owns the frame it lands on. The caption track otherwise",
+    "      // keeps running underneath it, and what it captions there is the line spoken",
+    "      // OVER the card \u2014 the call to action, printed a second time in smaller letters",
+    "      // directly below the button that already says it. Hidden on the CONTAINER and",
+    "      // with `display`, because each caption group sets its own `visibility: visible`",
+    "      // and would win against anything set on its parent.",
+    "      if (card && captions) {",
+    "        var cardAt = parseFloat(card.getAttribute('data-start') || '0') || 0;",
+    "        var cardDur = parseFloat(card.getAttribute('data-dur') || '0') || 0;",
+    "        tl.set(captions, { display: 'none' }, cardAt);",
+    "        if (cardDur > 0) tl.set(captions, { display: '' }, cardAt + cardDur);",
+    "      }",
     "    }",
     "    var store = window.__timelines || {};",
     "    var main = store.main;",
@@ -42214,11 +42271,12 @@ function adBrandOverlayCss() {
     "         viewBox is wider than it is tall rendered clipped \u2014 the first real ad drew",
     "         `greenlea`. Constraining the height and letting the width follow keeps any",
     "         aspect ratio whole, and the max-width stops a very wide mark spanning the frame. */",
-    "      /* A LIGHT panel behind the mark, always. A brand mark is drawn to sit on white",
-    "         \u2014 this one is #1D5D47 on transparent \u2014 so a dark backing hid it on the corner",
-    "         and the brand-coloured closing plate erased it completely: the end card came",
-    "         out as an empty green frame with a single leaf floating in it. A near-white",
-    "         panel is the one background every mark in a brand kit is designed against. */",
+    "      /* A LIGHT panel behind the mark by DEFAULT. A brand mark is usually drawn to sit",
+    "         on white \u2014 the first one here was #1D5D47 on transparent \u2014 so a dark backing hid",
+    "         it on the corner and the brand-coloured closing plate erased it completely: the",
+    "         end card came out as an empty green frame with a single leaf floating in it. A",
+    "         near-white panel is the background most marks in a brand kit are designed",
+    "         against; the ones that are not get `.on-dark` below. */",
     "      .brand-mark { position: absolute; top: 90px; left: 56px; height: 52px; width: auto;",
     "        max-width: 420px; object-fit: contain; padding: 14px 22px; border-radius: 18px;",
     "        background: rgba(255,255,255,0.94);",
@@ -42232,6 +42290,14 @@ function adBrandOverlayCss() {
     "      .endcard-logo { width: 62%; height: auto; max-height: 300px; object-fit: contain;",
     "        padding: 46px 56px; border-radius: 40px; background: rgba(255,255,255,0.96);",
     "        box-shadow: 0 10px 40px rgba(0,0,0,0.28); }",
+    "      /* A mark whose own ink is LIGHT gets the opposite panel. The near-white panel",
+    "         above is right for the mark a brand kit usually ships \u2014 drawn to sit on white",
+    "         \u2014 and it erases the one it does not: a client's white `logo-dark.svg` rendered",
+    "         as an empty white box in the corner, and again 300px tall on the closing card.",
+    "         Which one a mark is gets MEASURED off the file (`markInkIsLight`), never read",
+    "         off its name: `logo-dark` names the background it is for in one brand kit and",
+    "         the ink itself in the next. */",
+    "      .brand-mark.on-dark, .endcard-logo.on-dark { background: rgba(16,20,18,0.92); }",
     "      /* The name, when the mark itself could not be drawn. */",
     "      .brand-wordmark { display: inline-block; font-family: 'Arial Black', 'Helvetica Neue', Arial, sans-serif;",
     "        font-weight: 900; color: #14231b; letter-spacing: -0.01em; }",
@@ -42246,10 +42312,17 @@ function adBrandOverlayCss() {
     "         first attempt led with 'BrandFont', which the overlay composition defines and",
     "         the caption composition does not: HyperFrames refuses an unmapped family and",
     "         the whole render died with `No deterministic font mapping for: BrandFont`. */",
+    "      /* The button is the OPPOSITE of the plate it sits on. Filling it with the brand",
+    "         colour made it invisible \u2014 the plate is filled with that same colour, so the",
+    "         button was brand-on-brand and its white copy read as another caption line \u2014",
+    "         and a fixed near-black fill is that defect mirrored, on the black plate an ad",
+    "         with no palette gets. The plate carries the brand; the button carries the",
+    "         contrast. Light copy on the near-black default, dark copy on the light one. */",
     "      .endcard-cta { font-family: 'Arial Black', 'Helvetica Neue', Arial, sans-serif;",
     "        font-size: 64px; font-weight: 900; text-transform: uppercase;",
     "        letter-spacing: 0.01em; color: #fff; padding: 28px 58px; border-radius: 56px;",
-    "        max-width: 900px; line-height: 1.15; background: rgba(0,0,0,0.82); }"
+    "        max-width: 900px; line-height: 1.15; background: rgba(0,0,0,0.82); }",
+    "      .endcard-cta.on-dark-plate { background: rgba(255,255,255,0.96); color: #14231b; }"
   ].join("\n");
 }
 function injectAdBrandOverlay(indexHtml, overlayHtml) {
@@ -42266,6 +42339,7 @@ function injectAdBrandOverlay(indexHtml, overlayHtml) {
 // src/engine/scaffold/ad-brand-source.ts
 import { readdir as readdir8, readFile as readFile15 } from "fs/promises";
 import path22 from "path";
+import sharp from "sharp";
 var BRAND_DIR = "src/brand";
 function paletteFromBrandDoc(markdown) {
   const seen = /* @__PURE__ */ new Set();
@@ -42274,15 +42348,33 @@ function paletteFromBrandDoc(markdown) {
     const hex = `#${match[1].toLowerCase()}`;
     if (seen.has(hex)) continue;
     seen.add(hex);
-    const r = Number.parseInt(hex.slice(1, 3), 16);
-    const g = Number.parseInt(hex.slice(3, 5), 16);
-    const b = Number.parseInt(hex.slice(5, 7), 16);
-    const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
-    if (luma > 236 || luma < 14) continue;
+    const luma = hexLuma(hex);
+    if (luma === null || luma > 236 || luma < 14) continue;
     out.push(hex);
   }
   return out;
 }
+function hexLuma(hex) {
+  const m = hex.trim().match(/^#?([0-9a-fA-F]{6})$/);
+  if (!m) return null;
+  const v = m[1];
+  const r = Number.parseInt(v.slice(0, 2), 16);
+  const g = Number.parseInt(v.slice(2, 4), 16);
+  const b = Number.parseInt(v.slice(4, 6), 16);
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function firstHex(palette) {
+  const hex = (palette ?? []).find((h) => /^#?[0-9a-fA-F]{6}$/.test(h.trim()));
+  if (!hex) return null;
+  const trimmed = hex.trim();
+  return trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
+}
+function plateIsDark(palette) {
+  const luma = hexLuma(firstHex(palette) ?? "");
+  return luma === null || luma < PLATE_DARK_LUMA;
+}
+var PLATE_DARK_LUMA = 140;
+var MARK_VARIANT_NAMES = /\b(mono|white|black|blanco|negro|negra|dark|light|oscuro|oscura|claro|clara|negativo|negativa|positivo|inverse|inverso|inversa|inv|reverse|reversed|alt|outline|transparent|watermark|icon|favicon|mark-only|isotipo|isotype)\b/;
 function pickBrandMark(files) {
   const usable = files.filter((f) => /\.(svg|png|webp)$/i.test(f));
   if (usable.length === 0) return null;
@@ -42291,10 +42383,10 @@ function pickBrandMark(files) {
     let s = 0;
     if (/\.(png|webp)$/.test(name)) s += 1;
     if (/\b(logo|wordmark|lockup)\b/.test(name)) s += 2;
-    if (/\b(mono|white|black|inverse|icon|favicon|mark-only|isotipo)\b/.test(name)) s -= 3;
+    if (MARK_VARIANT_NAMES.test(name)) s -= 3;
     return s;
   };
-  return [...usable].sort((a, b) => score(b) - score(a) || a.localeCompare(b))[0] ?? null;
+  return [...usable].sort((a, b) => score(b) - score(a) || a.length - b.length || a.localeCompare(b))[0] ?? null;
 }
 async function readBrandFromWorkspace(root = ".") {
   const found = {};
@@ -42349,6 +42441,27 @@ async function markDirectoryIsReal(dir) {
   }
   return true;
 }
+var INK_ALPHA = 128;
+function inkLuma(rgba) {
+  let sum = 0;
+  let count = 0;
+  for (let i = 0; i + 3 < rgba.length; i += 4) {
+    if (rgba[i + 3] < INK_ALPHA) continue;
+    sum += 0.2126 * rgba[i] + 0.7152 * rgba[i + 1] + 0.0722 * rgba[i + 2];
+    count += 1;
+  }
+  return count === 0 ? null : sum / count;
+}
+var LIGHT_INK_LUMA = 170;
+async function markInkIsLight(markPath) {
+  try {
+    const { data } = await sharp(markPath, { density: 144 }).resize(96, 96, { fit: "inside", withoutEnlargement: true }).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+    const luma = inkLuma(data);
+    return luma !== null && luma > LIGHT_INK_LUMA;
+  } catch {
+    return false;
+  }
+}
 
 // src/commands/canvas/composition-path.ts
 import { existsSync as existsSync5 } from "fs";
@@ -42412,6 +42525,11 @@ registerSchema({
     }
   }
 });
+function avatarVoiceBrief(avatar) {
+  if (!avatar) return void 0;
+  const parts = [avatar.subjectDescription, avatar.profile?.persona, avatar.profile?.speech].map((p) => p?.trim()).filter((p) => Boolean(p));
+  return parts.length > 0 ? parts.join("; ") : void 0;
+}
 var scaffoldAdCommand = defineCommand114({
   meta: {
     name: "scaffold-ad",
@@ -42654,7 +42772,12 @@ var scaffoldAdCommand = defineCommand114({
         spec.data.cast = { ...spec.data.cast, description: withoutCastName(spec.data.cast.description, names) };
       }
     }
-    const blueprint = adSpecToBlueprint(spec.data, { avatarAccent: avatar?.profile?.accent, videoModel: chosenVideoModel });
+    const avatarVoice = avatarVoiceBrief(avatar);
+    const blueprint = adSpecToBlueprint(spec.data, {
+      avatarAccent: avatar?.profile?.accent,
+      videoModel: chosenVideoModel,
+      ...avatarVoice ? { avatarVoice } : {}
+    });
     const slug = args4.slug ?? path24.basename(specPath).replace(/\.[^.]+$/, "");
     const outPath = args4.out ?? (args4.slug ? path24.join("src/creatives", slug, `${slug}.canvas.json`) : path24.join(path24.dirname(specPath), `${slug}.canvas.json`));
     const outDir = path24.dirname(outPath);
@@ -42704,6 +42827,19 @@ var scaffoldAdCommand = defineCommand114({
       // and rejected — it would swap the voice that matches the mouth and the directed
       // region for one cast off an English stock list. Only the on-camera voice; a
       // voiceover read has no rendered voice to keep and is still cast.
+      //
+      // The KNOWN RISK this carries, recorded here because it is decided here: keeping the
+      // rendered voice also means no pass unifies her beats, and each beat is its own
+      // generation, so nothing guarantees two of them sound like the same person. The
+      // reference image fixes the face; nothing fixes the voice. Measured on a finished
+      // three-beat ad (her, a cutaway, her): median speaking pitch 210.5 Hz and 216.2 Hz,
+      // near-identical spreads — the same voice as far as pitch can say — and the two
+      // extracts were then listened to side by side and judged to be the same person. Not
+      // proof for every ad: one listener, one ad, and pitch is one dimension of a voice.
+      //
+      // If it does show up, the fix is not to drop `keepRenderedVoice` — that brings back
+      // the stock voice this exists to avoid. It is to convert the LATER extracts onto the
+      // first beat of the same speaker, which keeps a voice the clip really produced.
       ...avatar ? { keepRenderedVoice: true } : {},
       ...spec.data.voiceover === false ? { staticTranscriptPath: path24.relative(outDir, transcriptPath) } : {}
     };
@@ -42711,11 +42847,13 @@ var scaffoldAdCommand = defineCommand114({
     const renderNode4 = canvas.nodes.find((n) => n.type === "hyperframe_render");
     const renderedDir = renderNode4 ? path24.join(outDir, String(renderNode4.params?.composition ?? "")) : null;
     let staged = null;
+    let markIsLight = false;
     if (logoPath && renderedDir) {
       const ext = path24.extname(logoPath) || ".png";
       try {
         await copyFile(logoPath, path24.join(renderedDir, `brand-mark${ext}`));
         staged = { file: `brand-mark${ext}`, alt: spec.data.brand?.name ?? "brand" };
+        markIsLight = await markInkIsLight(logoPath);
       } catch {
       }
     }
@@ -42726,7 +42864,10 @@ var scaffoldAdCommand = defineCommand114({
       cardAtS: closing.start_s,
       cardDurationS: closing.duration_s,
       totalS: blueprint.estimated_duration_s,
-      accent: firstHex(spec.data.brand?.palette)
+      markIsLight,
+      // The card's button is coloured against the plate the engine will fill from
+      // this same palette — including the black plate an ad with no palette gets.
+      plateIsDark: plateIsDark(spec.data.brand?.palette)
     }) : "";
     if (overlayHtml && renderedDir) {
       const indexPath = path24.join(renderedDir, "index.html");
@@ -42801,7 +42942,7 @@ var scaffoldAdCommand = defineCommand114({
           // ad with no palette and no mark anywhere in 28 seconds.
           `This spec has no ${!spec.data.brand?.palette?.length ? "`brand.palette`" : ""}${!spec.data.brand?.palette?.length && !spec.data.brand?.logo ? " and no " : ""}${!spec.data.brand?.logo ? "`brand.logo`" : ""}. Read src/brand/BRAND.md and re-run with them \u2014 a name alone leaves the ad in someone else's clothes.`
         ],
-        "`brand.palette` dresses the caption type and the closing button; `brand.logo` is the repo path to the mark, and it is DRAWN by the composition \u2014 top-left throughout and large on the closing card \u2014 never generated as a picture, so it cannot come back garbled. Give it whenever the client has one."
+        "`brand.palette` colours the closing plate the card sits on; `brand.logo` is the repo path to the mark, and it is DRAWN by the composition \u2014 top-left throughout and large on the closing card \u2014 never generated as a picture, so it cannot come back garbled. Give it whenever the client has one."
       ]
     });
   }
@@ -51301,9 +51442,9 @@ import { defineCommand as defineCommand169 } from "citty";
 import { defineCommand as defineCommand143 } from "citty";
 
 // src/lib/image/crop-sprite.ts
-import sharp from "sharp";
+import sharp2 from "sharp";
 function cropSprite(input, region) {
-  return sharp(input).extract({
+  return sharp2(input).extract({
     left: Math.round(region.x),
     top: Math.round(region.y),
     width: Math.round(region.width),
@@ -53563,7 +53704,7 @@ function solidifyEdges(data, saturationBoost = 0.25) {
 }
 
 // src/lib/image/image-processor.ts
-import sharp2 from "sharp";
+import sharp3 from "sharp";
 function hasGradient(data) {
   const uniqueColors = /* @__PURE__ */ new Set();
   for (let i = 0; i < data.length; i += 4) {
@@ -53595,10 +53736,10 @@ function createSvgRecolorer(target, palette) {
 async function processGradient(data, info) {
   if (!hasGradient(data)) return { data, info };
   const solidified = solidifyEdges(data, 0.1);
-  const blurred = await sharp2(solidified, {
+  const blurred = await sharp3(solidified, {
     raw: { channels: 4, width: info.width, height: info.height }
   }).png().blur(0.3).toBuffer();
-  const result = await sharp2(blurred).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+  const result = await sharp3(blurred).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
   return { data: result.data, info: result.info };
 }
 function isSvgBuffer(buffer) {
@@ -53607,13 +53748,13 @@ function isSvgBuffer(buffer) {
 }
 async function processInternal(inputBuffer, isSVG, options) {
   const stages = [];
-  const metadata = await sharp2(inputBuffer).metadata();
+  const metadata = await sharp3(inputBuffer).metadata();
   let alreadyTransparent = false;
   if (metadata.hasAlpha) {
-    const { data: alphaData } = await sharp2(inputBuffer).raw().toBuffer({ resolveWithObject: true });
+    const { data: alphaData } = await sharp3(inputBuffer).raw().toBuffer({ resolveWithObject: true });
     alreadyTransparent = hasTransparency(alphaData, 0.05);
   }
-  let { data: processedData, info } = await sharp2(inputBuffer).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+  let { data: processedData, info } = await sharp3(inputBuffer).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
   if (options.color) {
     stages.push("recolor");
     processedData = applyQuantization(processedData, 8);
@@ -53684,7 +53825,7 @@ async function processInternal(inputBuffer, isSVG, options) {
     processedData = result.data;
     info = result.info;
   }
-  let pipeline2 = sharp2(processedData, {
+  let pipeline2 = sharp3(processedData, {
     raw: { channels: 4, width: info.width, height: info.height }
   }).png();
   if (options.shrinkToContent) {
@@ -53697,12 +53838,12 @@ async function processInternal(inputBuffer, isSVG, options) {
 function applyResize(buffer, resize) {
   const transparent = { r: 0, g: 0, b: 0, alpha: 0 };
   if (resize.size) {
-    return sharp2(buffer).resize(resize.size.width, resize.size.height, {
+    return sharp3(buffer).resize(resize.size.width, resize.size.height, {
       fit: resize.fit ?? "contain",
       background: transparent
     }).toBuffer();
   }
-  return sharp2(buffer).resize(resize.width ?? null, resize.height ?? null, { fit: "inside", withoutEnlargement: false }).toBuffer();
+  return sharp3(buffer).resize(resize.width ?? null, resize.height ?? null, { fit: "inside", withoutEnlargement: false }).toBuffer();
 }
 async function processImage(inputBuffer, options = {}) {
   const stages = [];
@@ -53711,7 +53852,7 @@ async function processImage(inputBuffer, options = {}) {
     if (options.resize) {
       stages.push("resize");
       const resized = await applyResize(inputBuffer, options.resize);
-      const meta3 = await sharp2(resized).metadata();
+      const meta3 = await sharp3(resized).metadata();
       return {
         buffer: resized,
         format: "png",
@@ -53720,7 +53861,7 @@ async function processImage(inputBuffer, options = {}) {
         stages
       };
     }
-    const meta2 = await sharp2(inputBuffer).metadata();
+    const meta2 = await sharp3(inputBuffer).metadata();
     return {
       buffer: inputBuffer,
       format: "svg",
@@ -53732,7 +53873,7 @@ async function processImage(inputBuffer, options = {}) {
   let workingBuffer = inputBuffer;
   if (isSVG) {
     stages.push("rasterize-svg");
-    workingBuffer = await sharp2(inputBuffer).png({ compressionLevel: 0, force: true, palette: false, quality: 100 }).toBuffer();
+    workingBuffer = await sharp3(inputBuffer).png({ compressionLevel: 0, force: true, palette: false, quality: 100 }).toBuffer();
   }
   const pass = await processInternal(workingBuffer, isSVG, options);
   stages.push(...pass.stages);
@@ -53741,7 +53882,7 @@ async function processImage(inputBuffer, options = {}) {
     stages.push("resize");
     processed = await applyResize(processed, options.resize);
   }
-  const meta = await sharp2(processed).metadata();
+  const meta = await sharp3(processed).metadata();
   return {
     buffer: processed,
     format: "png",
@@ -57360,7 +57501,7 @@ function routeKey(route) {
 }
 
 // src/engine/landing-library/fidelity.ts
-import sharp3 from "sharp";
+import sharp4 from "sharp";
 var COMPARISON_SIZE = 32;
 function pixelSimilarity(a, b) {
   const length = Math.min(a.length, b.length);
@@ -57372,7 +57513,7 @@ function pixelSimilarity(a, b) {
   return 1 - total / (length * 255);
 }
 async function scoreFidelity(live, rendered) {
-  const [liveMeta, renderedMeta] = await Promise.all([sharp3(live).metadata(), sharp3(rendered).metadata()]);
+  const [liveMeta, renderedMeta] = await Promise.all([sharp4(live).metadata(), sharp4(rendered).metadata()]);
   const liveSize = { width: liveMeta.width ?? 0, height: liveMeta.height ?? 0 };
   const renderedSize = { width: renderedMeta.width ?? 0, height: renderedMeta.height ?? 0 };
   const [livePixels, renderedPixels] = await Promise.all([toGreyGrid(live), toGreyGrid(rendered)]);
@@ -57386,7 +57527,7 @@ async function scoreFidelity(live, rendered) {
   };
 }
 async function toGreyGrid(image) {
-  const raw = await sharp3(image).greyscale().resize(COMPARISON_SIZE, COMPARISON_SIZE, { fit: "fill" }).raw().toBuffer();
+  const raw = await sharp4(image).greyscale().resize(COMPARISON_SIZE, COMPARISON_SIZE, { fit: "fill" }).raw().toBuffer();
   return new Uint8Array(raw);
 }
 
@@ -57598,7 +57739,7 @@ var inPageCollectMotion = (selector) => {
 };
 
 // src/engine/landing-library/motionTake.ts
-import sharp4 from "sharp";
+import sharp5 from "sharp";
 
 // src/engine/landing-library/certificate.ts
 function formatDate(unixSeconds) {
@@ -58265,8 +58406,8 @@ async function hideFloatingFurniture(page, selector) {
   }, selector);
 }
 async function composeFilmstrip(frames) {
-  const scaled = await Promise.all(frames.map((frame) => sharp4(frame).resize({ width: FRAME_WIDTH }).png().toBuffer()));
-  const first = await sharp4(scaled[0]).metadata();
+  const scaled = await Promise.all(frames.map((frame) => sharp5(frame).resize({ width: FRAME_WIDTH }).png().toBuffer()));
+  const first = await sharp5(scaled[0]).metadata();
   const frameHeight = first.height ?? 300;
   const cellHeight = frameHeight + LABEL_HEIGHT;
   const rows = Math.ceil(scaled.length / GRID_COLUMNS);
@@ -58285,7 +58426,7 @@ async function composeFilmstrip(frames) {
       { input: frame, left: column * FRAME_WIDTH, top: row * cellHeight + LABEL_HEIGHT }
     ];
   });
-  return await sharp4({
+  return await sharp5({
     create: {
       width,
       height: cellHeight * rows,
@@ -58474,12 +58615,12 @@ var DEFAULT_SEGMENT_OPTIONS = {
 };
 
 // src/engine/landing-library/visualHash.ts
-import sharp5 from "sharp";
+import sharp6 from "sharp";
 var HASH_WIDTH = 9;
 var HASH_HEIGHT = 8;
 async function perceptualHash(image) {
   try {
-    const raw = await sharp5(image).greyscale().resize(HASH_WIDTH, HASH_HEIGHT, { fit: "fill" }).raw().toBuffer();
+    const raw = await sharp6(image).greyscale().resize(HASH_WIDTH, HASH_HEIGHT, { fit: "fill" }).raw().toBuffer();
     return bitsToHex(rowGradientBits(new Uint8Array(raw)));
   } catch {
     return null;
@@ -58993,7 +59134,7 @@ import { defineCommand as defineCommand176 } from "citty";
 // src/commands/landing/inspiration/shot.ts
 import { mkdir as mkdir13, writeFile as writeFile18 } from "fs/promises";
 import path42 from "path";
-import sharp6 from "sharp";
+import sharp7 from "sharp";
 var READABLE_SHOT = {
   maxWidth: 1440,
   maxHeight: 4e3,
@@ -59002,7 +59143,7 @@ var READABLE_SHOT = {
 };
 async function toReadableShot(original) {
   try {
-    return await sharp6(original).resize({
+    return await sharp7(original).resize({
       width: READABLE_SHOT.maxWidth,
       height: READABLE_SHOT.maxHeight,
       fit: "inside",