@koda-sl/baker-cli 0.263.0-dev.ac71c8123 → 0.265.0-dev.1f1c09c80

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-ZK5S7JV2.js";
+} from "./chunk-SZJWEOW2.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -67,7 +67,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-2VM2J6MB.js";
+} from "./chunk-RHEQTHT7.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -83,29 +83,31 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-TBEVU7XF.js";
+} from "./chunk-XAUTT2Q6.js";
 import {
   ApiError,
   apiGet,
   apiPost,
   validateConvexId
-} from "./chunk-ECPNYXOA.js";
+} from "./chunk-P2PEABMQ.js";
 import {
   installStreamTaps,
   logInvocation
-} from "./chunk-GXRUZ4LP.js";
+} from "./chunk-2IUN3S3E.js";
 import {
   captureBudgetMs,
   captureProxyCredentials,
   captureVimeoCookie,
+  frameVisionKey,
   getEnv,
+  hasFrameVisionKey,
   isProxyFailure,
   plannedRoutes,
   refuseNonPublicUrl,
   requireChatId,
   resolveChatId,
   shouldEscalate
-} from "./chunk-POYXIDOD.js";
+} from "./chunk-WFWU3CHS.js";
 
 // src/cli.ts
 import { defineCommand as defineCommand228, runMain } from "citty";
@@ -9784,11 +9786,11 @@ function rawTextEntries(value) {
   const values = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
   return values.filter((v) => typeof v === "string").flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
-function rawFileEntries(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function rawFileEntries(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return [];
   }
-  return readFileSync2(path39, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path40, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args) {
   const defaultMatch = typeof args["match-type"] === "string" ? args["match-type"].toUpperCase() : void 0;
@@ -9811,19 +9813,19 @@ function keywordEntries(args) {
   }
   return entries;
 }
-function loadJsonFileArg(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadJsonFileArg(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync2(path39, "utf8"));
+    const parsed = JSON.parse(readFileSync2(path40, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${path39} must contain a JSON object`);
+      failWriteValidation(`${path40} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation(`${path39} is not valid JSON: ${err.message}`);
+      failWriteValidation(`${path40} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -9953,10 +9955,10 @@ async function stageUpdate(kind, customerId, target, payload, hints) {
 async function stageTarget(kind, customerId, target, hints) {
   await stageGoogleOp({ kind, customerId, target }, hints);
 }
-async function draftAction(path39, body, chat) {
+async function draftAction(path40, body, chat) {
   try {
     const chatId = resolveChatId(chat);
-    const response = await apiPost(path39, { chatId, ...body });
+    const response = await apiPost(path40, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -15170,19 +15172,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadJsonFileArg2(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync4(path39, "utf8"));
+    const parsed = JSON.parse(readFileSync4(path40, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path39} must contain a JSON object`);
+      failWriteValidation2(`${path40} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path39} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path40} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -15267,15 +15269,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadTargetingFileArg(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path39);
+  const parsed = loadJsonFileArg2(path40);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path39} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path40} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -15310,14 +15312,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell2) => cell2.trim());
 }
-function parseListFileArg(path39, maxRows) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function parseListFileArg(path40, maxRows) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return void 0;
   }
-  const raw = readFileSync4(path39, "utf8");
+  const raw = readFileSync4(path40, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path39} needs a header row and at least one data row`);
+    failWriteValidation2(`${path40} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -15336,7 +15338,7 @@ function parseListFileArg(path39, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path39} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path40} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -15432,11 +15434,11 @@ function readPositionals(args) {
 function splitIdList(raw) {
   return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function idsFileEntries(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function idsFileEntries(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return [];
   }
-  return readFileSync4(path39, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  return readFileSync4(path40, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
 }
 function requireTargets(args, entity) {
   const positionals = readPositionals(args);
@@ -18057,9 +18059,9 @@ function compactRow(row) {
     ...destination.postUrn ? { postUrn: destination.postUrn } : {}
   };
 }
-function readPath(row, path39) {
+function readPath(row, path40) {
   let current = row;
-  for (const segment of path39.split(".")) {
+  for (const segment of path40.split(".")) {
     const record = asRecord2(current);
     if (!record) return void 0;
     current = record[segment];
@@ -18069,10 +18071,10 @@ function readPath(row, path39) {
 function projectFields(rows, paths) {
   return rows.map((row) => {
     const projected = {};
-    for (const path39 of paths) {
-      const value = readPath(row, path39);
+    for (const path40 of paths) {
+      const value = readPath(row, path40);
       if (value !== void 0) {
-        projected[path39] = value;
+        projected[path40] = value;
       }
     }
     return projected;
@@ -19372,11 +19374,11 @@ var updateStatusSchema = z25.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path39) {
+function validateDailyBudgetFloor(money, ctx, path40) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path39, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path40, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -20045,19 +20047,19 @@ function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg3(path39) {
-  if (typeof path39 !== "string" || path39.length === 0) {
+function loadJsonFileArg3(path40) {
+  if (typeof path40 !== "string" || path40.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync8(path39, "utf8"));
+    const parsed = JSON.parse(readFileSync8(path40, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path39} must contain a JSON object`);
+      failWriteValidation3(`${path40} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path39} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path40} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -20610,10 +20612,10 @@ function duplicateCommand2(entity, label) {
       replace: { type: "boolean", description: "Pause the original once the copy publishes" }
     },
     run: async ({ args }) => {
-      const { apiPost: apiPost2 } = await import("./client-7QIDRQXG.js");
-      const { requireChatId: requireChatId2 } = await import("./env-HZNFGXAR.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-MWMAXN4M.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-NFLXWGHK.js");
+      const { apiPost: apiPost2 } = await import("./client-KOUPT7HU.js");
+      const { requireChatId: requireChatId2 } = await import("./env-C7YXL6C6.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-ALQGBDPQ.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-UKJH3PS7.js");
       try {
         const accountId = bareAccountId2(args);
         const chatId = requireChatId2();
@@ -24666,11 +24668,11 @@ function unwrap(response) {
   }
   return response.data;
 }
-async function readAvatars(path39, params) {
-  return unwrap(await apiGet(path39, params));
+async function readAvatars(path40, params) {
+  return unwrap(await apiGet(path40, params));
 }
-async function writeAvatars(path39, body) {
-  return unwrap(await apiPost(path39, body));
+async function writeAvatars(path40, body) {
+  return unwrap(await apiPost(path40, body));
 }
 
 // src/commands/avatars/create.ts
@@ -25514,12 +25516,12 @@ function missingFontFiles(urls, available) {
 function planFontAdoption(sources, families) {
   const wanted = new Map(families.map((family) => [normalizeFamily(family), family]));
   const byFamily = /* @__PURE__ */ new Map();
-  for (const { path: path39, source } of sources) {
-    const dir = posix.dirname(path39);
+  for (const { path: path40, source } of sources) {
+    const dir = posix.dirname(path40);
     for (const face of declaredFontFaces(source)) {
       if (!wanted.has(face.family)) continue;
       const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
-      perFile.set(path39, [...perFile.get(path39) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      perFile.set(path40, [...perFile.get(path40) ?? [], rebaseFontFaceSrc(face.block, dir)]);
       byFamily.set(face.family, perFile);
     }
   }
@@ -26531,12 +26533,12 @@ async function probeDuration(filePath) {
 }
 
 // src/commands/canvas/rerun.ts
-import path16 from "path";
+import path17 from "path";
 import { defineCommand as defineCommand101 } from "citty";
 
 // src/commands/canvas/run.ts
-import { readFile as readFile11 } from "fs/promises";
-import path15 from "path";
+import { readFile as readFile12 } from "fs/promises";
+import path16 from "path";
 import { defineCommand as defineCommand100 } from "citty";
 
 // src/commands/canvas/normalize-paths.ts
@@ -29568,13 +29570,19 @@ function emitCaptionChain(blueprint, tracks, clock, opts, videoRef, nodes) {
   const overlaidNode = nodes.find((n) => n.id === "overlaid");
   if (overlaidNode) {
     overlaidNode.inputs = { ...overlaidNode.inputs, transcript: "$ref:captions_transcribe.transcript" };
+    if (opts.captionWordsPerGroup) {
+      overlaidNode.params = { ...overlaidNode.params, words_per_group: opts.captionWordsPerGroup };
+    }
     return { videoRef };
   }
   nodes.push({
     id: "captions",
     type: "hyperframe_render",
     inputs: { background: videoRef, transcript: "$ref:captions_transcribe.transcript" },
-    params: { composition: opts.captionsCompositionPath }
+    params: {
+      composition: opts.captionsCompositionPath,
+      ...opts.captionWordsPerGroup ? { words_per_group: opts.captionWordsPerGroup } : {}
+    }
   });
   return { videoRef: "$ref:captions.video", videoNode: "captions" };
 }
@@ -30787,6 +30795,258 @@ async function restoreRunSnapshot(manifest, targetDir, opts = {}) {
   return { canvasPath: path14.resolve(resolvedTarget, manifest.canvas.path), restored, upToDate };
 }
 
+// src/engine/nodes/local/lib/render-review.ts
+import { execFile as execFile2 } from "child_process";
+import { mkdtemp, readFile as readFile11, rm as rm5 } from "fs/promises";
+import { tmpdir } from "os";
+import path15 from "path";
+import { promisify as promisify2 } from "util";
+import { z as z28 } from "zod";
+var RENDER_REVIEW_MODEL = "gemini-pro-latest";
+var RENDER_REVIEW_FRAMES = 12;
+var RENDER_REVIEW_WIDTH = 1024;
+function reviewFrameTimes(durationS, frames) {
+  const n = Math.max(2, frames);
+  const last = Math.max(0, durationS - 0.15);
+  const step = last / (n - 1);
+  return Array.from({ length: n }, (_, i) => Math.round(i * step * 100) / 100);
+}
+function buildFrameGrabArgs(video, atS, out) {
+  return [
+    "-v",
+    "error",
+    "-ss",
+    String(atS),
+    "-i",
+    video,
+    "-frames:v",
+    "1",
+    "-vf",
+    `scale=${RENDER_REVIEW_WIDTH}:-2`,
+    out,
+    "-y"
+  ];
+}
+var FrameReview = z28.object({
+  /** Something in shot that could not happen, or is being done wrong. */
+  impossible: z28.array(z28.string()).default([]),
+  /** Objects present in frame that belong to no part of the scene. */
+  strays: z28.array(z28.string()).default([])
+});
+var ReelReview = z28.object({
+  /** Whether the people the script treats as one person stay one person. */
+  cast_is_consistent: z28.boolean().default(true),
+  cast_note: z28.string().default(""),
+  /** Whether the advertiser's mark is visible anywhere. */
+  brand_mark_visible: z28.boolean().default(false),
+  /** Whether the last frames close the ad rather than trailing off. */
+  ends_on_a_close: z28.boolean().default(false),
+  ending_note: z28.string().default("")
+});
+function buildFrameReviewPrompt(opts) {
+  const subject = opts.subject ? ` The advertiser is ${opts.subject}.` : "";
+  return `This is ONE frame from a video advertisement.${subject}
+
+Answer only about what is visible in THIS frame. Do not judge whether the ad is good, and do not comment on style, mood or lighting.
+
+1. IMPOSSIBLE OR WRONG. Is anything shown that could not physically happen, or that shows the job being done incorrectly? Judge the PROCEDURE, not only the physics: equipment resting where it would never rest, a component fitted to nothing, someone handling a part in a way that would damage it, an object at the wrong scale beside a person, a body with a limb missing or duplicated.
+2. STRAYS. Is any object present that belongs to no part of the scene \u2014 floating, unattached, or cut off from whatever should hold it?
+
+Report only what you can actually see. An empty list is the right answer for a clean frame. Keep each item under twelve words.
+
+Reply with only this JSON: {"impossible":[],"strays":[]}`;
+}
+function buildReelReviewPrompt(opts) {
+  const subject = opts.subject ? ` The advertiser is ${opts.subject}.` : "";
+  const script = opts.script ? `
+
+The voiceover says, in order:
+${opts.script}` : "";
+  return `These frames are sampled in order from one video advertisement.${subject}` + script + `
+
+Answer only about what is visible.
+
+1. CAST. Do the people stay the same people? If the script speaks about one customer and the frames show different faces in that role, say so and count them.
+2. BRAND. Is the advertiser's logo or wordmark visible in ANY frame? Answer yes only if you can actually see a mark \u2014 a colour is not a mark.
+3. ENDING. Do the final frames close the advertisement \u2014 a call to action, a mark, a card \u2014 or does the picture simply carry on and stop?
+
+Reply with only this JSON:
+{"cast_is_consistent":true,"cast_note":"","brand_mark_visible":false,"ends_on_a_close":false,"ending_note":""}`;
+}
+function parseReviewJson(raw) {
+  const fenced = raw.match(/```(?:json)?\s*([\s\S]*?)```/);
+  const body = (fenced?.[1] ?? raw).trim();
+  const start = body.indexOf("{");
+  const end = body.lastIndexOf("}");
+  if (start === -1 || end === -1 || end < start) return null;
+  try {
+    return JSON.parse(body.slice(start, end + 1));
+  } catch {
+    return null;
+  }
+}
+var normalise = (s) => s.toLowerCase().replace(/[^a-z0-9 ]/g, " ").replace(/\s+/g, " ").trim();
+var ANATOMY = /\b(finger|fingers|hand|hands|thumb|limb|leg|legs|arm|arms|foot|feet|anatomy)\b/i;
+function collapseRepeats(frames) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const frame of frames) {
+    const parsed = FrameReview.safeParse(frame.json);
+    if (!parsed.success) continue;
+    for (const item of [...parsed.data.impossible, ...parsed.data.strays]) {
+      const text2 = item.trim();
+      const key = normalise(text2);
+      if (!key) continue;
+      const hit = seen.get(key);
+      if (hit) hit.at.push(frame.at);
+      else seen.set(key, { what: text2, at: [frame.at] });
+    }
+  }
+  return [...seen.values()];
+}
+function classifyFrameFindings(frames) {
+  const seen = collapseRepeats(frames);
+  const anatomy = seen.filter((f) => ANATOMY.test(f.what));
+  const rest = seen.filter((f) => !ANATOMY.test(f.what));
+  const findings = rest.map((f) => ({
+    severity: "blocking",
+    what: `At ${f.at.map((s) => `${s}s`).join(", ")}: ${f.what}`
+  }));
+  if (anatomy.length > 0) {
+    const at = [...new Set(anatomy.flatMap((f) => f.at))].sort((a, b) => a - b);
+    findings.push({
+      severity: "blocking",
+      what: `Malformed hands or limbs in ${at.length} of ${frames.length} sampled frames (${at.map((s) => `${s}s`).join(", ")}): ${anatomy.map((f) => f.what).join(" ")} Re-render those beats \u2014 keep hands out of frame, or away from the object being held.`
+    });
+  }
+  return findings;
+}
+function classifyReelFindings(json) {
+  const parsed = ReelReview.safeParse(json);
+  if (!parsed.success) return [];
+  const r = parsed.data;
+  const findings = [];
+  if (!r.cast_is_consistent) {
+    findings.push({
+      severity: "blocking",
+      what: `The cast changes between shots${r.cast_note.trim() ? `: ${r.cast_note.trim()}` : ""}. One customer played by several faces reads as stock footage. Ground the frames on one identity (\`baker avatars\`) or write the beats so the subject is never the same person twice.`
+    });
+  }
+  if (!r.brand_mark_visible) {
+    findings.push({
+      severity: "warning",
+      what: "No brand mark is visible in any frame. `baker canvas scaffold-ad` draws one from `brand.logo` (the repo path in src/brand/BRAND.md) \u2014 top-left throughout and large on the closing card \u2014 so a mark missing here means the spec carried no logo, or the path did not resolve and the scaffold said so."
+    });
+  }
+  if (!r.ends_on_a_close) {
+    findings.push({
+      severity: "warning",
+      what: `The video does not close${r.ending_note.trim() ? `: ${r.ending_note.trim()}` : ""} \u2014 it runs on and stops. Give the last beat a call to action, and keep its shot short enough that the picture ends with the read.`
+    });
+  }
+  return findings;
+}
+function videoPathFromOutput(output) {
+  const refs = Array.isArray(output) ? output : [output];
+  let found = null;
+  for (const ref of refs) {
+    const r = ref;
+    if (!r || typeof r !== "object") continue;
+    const isVideo = r.kind === "video" || typeof r.mime === "string" && r.mime.startsWith("video/");
+    if (isVideo && typeof r.path === "string" && r.path) found = r.path;
+  }
+  return found;
+}
+var RENDER_REVIEW_UNAVAILABLE = "The render was NOT reviewed \u2014 no frame-vision key in this environment. Watch it yourself before sending it on.";
+var REVIEW_CONCURRENCY = 3;
+async function mapWithLimit(items, limit, fn) {
+  const out = new Array(items.length);
+  let next = 0;
+  await Promise.all(
+    Array.from({ length: Math.min(limit, items.length) }, async () => {
+      for (let i = next++; i < items.length; i = next++) {
+        out[i] = await fn(items[i]);
+      }
+    })
+  );
+  return out;
+}
+var execFileAsync2 = promisify2(execFile2);
+async function videoDuration(video) {
+  try {
+    const { stdout } = await execFileAsync2(
+      "ffprobe",
+      ["-v", "error", "-show_entries", "format=duration", "-of", "default=nw=1:nk=1", video],
+      { timeout: 2e4 }
+    );
+    const seconds = Number.parseFloat(stdout.trim());
+    return Number.isFinite(seconds) && seconds > 0 ? seconds : null;
+  } catch {
+    return null;
+  }
+}
+async function ask(images, prompt) {
+  const key = frameVisionKey();
+  if (!key) return null;
+  const parts = [{ text: prompt }];
+  for (const b64 of images) parts.push({ inline_data: { mime_type: "image/jpeg", data: b64 } });
+  try {
+    const response = await fetch(
+      `https://generativelanguage.googleapis.com/v1beta/models/${RENDER_REVIEW_MODEL}:generateContent`,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json", "x-goog-api-key": key },
+        body: JSON.stringify({ contents: [{ parts }] }),
+        signal: AbortSignal.timeout(18e4)
+      }
+    );
+    if (!response.ok) return null;
+    const body = await response.json();
+    const text2 = body.candidates?.[0]?.content?.parts?.map((p) => p.text ?? "").join("");
+    return text2 ? parseReviewJson(text2) : null;
+  } catch {
+    return null;
+  }
+}
+async function reviewRenderedVideo(opts) {
+  if (!hasFrameVisionKey()) return null;
+  const duration = await videoDuration(opts.video);
+  if (duration === null) return null;
+  const dir = await mkdtemp(path15.join(tmpdir(), "baker-review-"));
+  try {
+    const grabbed = [];
+    for (const [i, at] of reviewFrameTimes(duration, RENDER_REVIEW_FRAMES).entries()) {
+      const out = path15.join(dir, `f${String(i).padStart(2, "0")}.jpg`);
+      try {
+        await execFileAsync2("ffmpeg", buildFrameGrabArgs(opts.video, at, out), { timeout: 3e4 });
+        grabbed.push({ at, image: await readFile11(out, { encoding: "base64" }) });
+      } catch {
+      }
+    }
+    if (grabbed.length === 0) return null;
+    const reel = await ask(
+      grabbed.map((f) => f.image),
+      buildReelReviewPrompt({ subject: opts.subject, script: opts.script })
+    );
+    const framePrompt = buildFrameReviewPrompt({ subject: opts.subject });
+    const perFrame = await mapWithLimit(grabbed, REVIEW_CONCURRENCY, async (f) => ({
+      at: f.at,
+      json: await ask([f.image], framePrompt)
+    }));
+    const unread = perFrame.filter((f) => f.json === null).length;
+    if (unread === perFrame.length && reel === null) return null;
+    const findings = [...classifyFrameFindings(perFrame), ...classifyReelFindings(reel)];
+    if (unread > 0) {
+      findings.push({
+        severity: "warning",
+        what: `${unread} of ${perFrame.length} frames could not be reviewed \u2014 that part of the video is unchecked.`
+      });
+    }
+    return findings;
+  } finally {
+    await rm5(dir, { recursive: true, force: true });
+  }
+}
+
 // src/commands/canvas/run.ts
 var runCommand = defineCommand100({
   meta: { name: "run", description: "Validate and execute a canvas JSON file." },
@@ -30864,8 +31124,8 @@ function resolveMaxCredits(...candidates) {
   return void 0;
 }
 async function executeCanvasRun(opts) {
-  const filePath = path15.resolve(opts.file);
-  const raw = await readFile11(filePath, "utf8");
+  const filePath = path16.resolve(opts.file);
+  const raw = await readFile12(filePath, "utf8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -30887,7 +31147,7 @@ ${describeRewrites(healed.rewrites)}
 `
     );
   }
-  parsed = resolveRelativeCanvasPaths(parsed, path15.dirname(filePath));
+  parsed = resolveRelativeCanvasPaths(parsed, path16.dirname(filePath));
   try {
     await syncStyleProjection(parsed, (line) => process.stderr.write(`${line}
 `));
@@ -30993,7 +31253,7 @@ ${describeRewrites(healed.rewrites)}
   const canvasSha = sha256Hex(Buffer.from(canvasText));
   const creativeSlug = creativeSlugFromCanvasPath(filePath) ?? void 0;
   const client = opts.record === false ? null : buildBackendClient();
-  const outputsDir = opts.outputsDir ? path15.resolve(opts.outputsDir) : path15.resolve("canvas");
+  const outputsDir = opts.outputsDir ? path16.resolve(opts.outputsDir) : path16.resolve("canvas");
   const { runId, resumed, source, concurrentRunId } = await resolveRunId({
     explicitRunId: opts.runId,
     fresh: opts.fresh === true,
@@ -31027,7 +31287,7 @@ ${describeRewrites(healed.rewrites)}
   const canvasSnapshotUrl = client && creativeSlug ? await uploadRunSnapshot(client, { canvasPath: filePath, raw: canvasText, creativeSlug, parsed }) ?? void 0 : void 0;
   const recordMeta = {
     creativeSlug,
-    canvasPath: path15.relative(process.cwd(), filePath) || void 0,
+    canvasPath: path16.relative(process.cwd(), filePath) || void 0,
     canvasSha,
     // The fingerprint the dashboard compares against the current source to flag
     // "edited since last render". Computed from the on-disk canvas.json +
@@ -31072,6 +31332,12 @@ ${describeRewrites(healed.rewrites)}
       await pruneOldRuns(outputsDir, keepRuns, result.run_id, (line) => process.stdout.write(`${line}
 `));
     }
+    const reviewable = videoPathFromOutput(result.output);
+    const review = reviewable ? await reviewRenderedVideo({ video: reviewable }) : null;
+    const hints = reviewable ? review === null ? [RENDER_REVIEW_UNAVAILABLE] : review.length === 0 ? ["Reviewed the finished video frame by frame \u2014 nothing to report."] : [
+      `Reviewed the finished video and found ${review.length} thing${review.length === 1 ? "" : "s"} to fix. Show the user what is wrong before you show them the ad.`,
+      ...review.map((f) => `${f.severity === "blocking" ? "MUST FIX" : "SHOULD FIX"} \u2014 ${f.what}`)
+    ] : [];
     process.stdout.write(
       `${JSON.stringify(
         {
@@ -31079,7 +31345,9 @@ ${describeRewrites(healed.rewrites)}
           run_id: result.run_id,
           outputs_dir: result.outputs_dir,
           output: result.output,
-          stats: result.stats
+          stats: result.stats,
+          ...review ? { review } : {},
+          ...hints.length ? { hints } : {}
         },
         null,
         2
@@ -31214,7 +31482,7 @@ var rerunCommand = defineCommand101({
     if (latest.canvasSha && manifest.canvasSha !== latest.canvasSha) {
       fail2("snapshot_mismatch", `snapshot manifest for run ${latest.runId} does not match its recorded canvas sha`);
     }
-    const targetDir = path16.resolve("src", "creatives", slug);
+    const targetDir = path17.resolve("src", "creatives", slug);
     let restoredCanvasPath;
     try {
       const restore = await restoreRunSnapshot(manifest, targetDir, { force: args["force-remote"] === true });
@@ -31263,12 +31531,12 @@ async function fetchManifest(url) {
 }
 
 // src/commands/canvas/scaffold-static-ad.ts
-import { access, mkdir as mkdir6, readFile as readFile13, writeFile as writeFile8 } from "fs/promises";
-import path20 from "path";
+import { access, mkdir as mkdir6, readFile as readFile14, writeFile as writeFile8 } from "fs/promises";
+import path21 from "path";
 import { defineCommand as defineCommand103 } from "citty";
 
 // src/engine/scaffold/staticAd.ts
-import { z as z28 } from "zod";
+import { z as z29 } from "zod";
 var GEN_ASPECT_RATIOS = /* @__PURE__ */ new Set(["1:1", "4:5", "9:16", "16:9", "4:3", "3:4", "2:3", "3:2", "21:9"]);
 var DEFAULT_ASPECT_RATIO = "9:16";
 var SHEET_SUBJECT_TYPE2 = {
@@ -31280,24 +31548,24 @@ var ACTOR_SHEET_IMAGE_SIZE = "4K";
 var ADAPT_MODEL = "google/gemini-3-pro-image-preview";
 var ADAPT_IMAGE_SIZE = "2K";
 var ADAPT_GUIDANCE = "Keep the headline, logo, CTA, and hero subject fully visible in every ratio. Reproduce every text string verbatim \u2014 no dropped, added, or altered characters \u2014 and preserve the exact brand-color treatment (e.g. a black\u2192red word pivot), never flattening it.";
-var Blueprint = z28.object({
-  meta: z28.object({ estimated_aspect_ratio: z28.string().optional() }).loose().optional(),
-  text_content: z28.array(z28.object({ text: z28.string().optional() }).loose()).optional()
+var Blueprint = z29.object({
+  meta: z29.object({ estimated_aspect_ratio: z29.string().optional() }).loose().optional(),
+  text_content: z29.array(z29.object({ text: z29.string().optional() }).loose()).optional()
 }).loose();
-var ElementLocator = z28.object({
-  collection: z28.enum(["subjects", "people", "brands_logos"]),
-  index: z28.number().int().nonnegative()
+var ElementLocator = z29.object({
+  collection: z29.enum(["subjects", "people", "brands_logos"]),
+  index: z29.number().int().nonnegative()
 }).loose();
-var MainElement = z28.object({
+var MainElement = z29.object({
   // logo | product | person | animal | badge | other
-  type: z28.string(),
-  label: z28.string().optional(),
-  description: z28.string().optional(),
-  expression: z28.string().nullable().optional(),
-  reason: z28.string().optional(),
+  type: z29.string(),
+  label: z29.string().optional(),
+  description: z29.string().optional(),
+  expression: z29.string().nullable().optional(),
+  reason: z29.string().optional(),
   locator: ElementLocator.optional()
 }).loose();
-var MainElements = z28.array(MainElement);
+var MainElements = z29.array(MainElement);
 function sanitizeId2(raw, fallback) {
   const id = raw.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
   return /^[a-z]/.test(id) ? id : `${fallback}_${id}`.replace(/_+$/g, "") || fallback;
@@ -31546,7 +31814,7 @@ function staticAdReport(input, elementsInput, opts) {
 }
 
 // src/commands/canvas/creative-definition.ts
-import path17 from "path";
+import path18 from "path";
 var PLATFORM_VALUES = ["meta", "google", "linkedin", "tiktok", "youtube", "x", "other"];
 var FORMAT_VALUES = ["1:1", "4:5", "9:16", "16:9", "1.91:1"];
 function titleFromSlug(slug) {
@@ -31594,16 +31862,16 @@ function buildCreativeDefinition(input) {
 }
 
 // src/commands/canvas/scaffold-static-ad-paths.ts
-import path18 from "path";
+import path19 from "path";
 function resolveScaffoldStaticAdPaths(rawFile, out, cwd = process.cwd(), slug) {
   const file = rawFile.trim();
   const imageIsUrl = /^https?:\/\//i.test(file);
-  const imageSource = imageIsUrl ? file : path18.resolve(cwd, file);
-  const outPath = out ? path18.resolve(cwd, out) : slug ? path18.join(cwd, "src", "creatives", slug, `${slug}.canvas.json`) : imageIsUrl ? path18.join(cwd, "static-ad.canvas.json") : path18.join(path18.dirname(imageSource), "static-ad.canvas.json");
-  const blueprintPath = path18.join(path18.dirname(outPath), "prompt.json");
-  const creativeDir = slug ? path18.dirname(outPath) : null;
-  const definitionPath = creativeDir ? path18.join(creativeDir, "_definition.md") : null;
-  const referencesDir = creativeDir ? path18.join(creativeDir, "references") : null;
+  const imageSource = imageIsUrl ? file : path19.resolve(cwd, file);
+  const outPath = out ? path19.resolve(cwd, out) : slug ? path19.join(cwd, "src", "creatives", slug, `${slug}.canvas.json`) : imageIsUrl ? path19.join(cwd, "static-ad.canvas.json") : path19.join(path19.dirname(imageSource), "static-ad.canvas.json");
+  const blueprintPath = path19.join(path19.dirname(outPath), "prompt.json");
+  const creativeDir = slug ? path19.dirname(outPath) : null;
+  const definitionPath = creativeDir ? path19.join(creativeDir, "_definition.md") : null;
+  const referencesDir = creativeDir ? path19.join(creativeDir, "references") : null;
   return { imageIsUrl, imageSource, outPath, blueprintPath, creativeDir, definitionPath, referencesDir };
 }
 var SCAFFOLD_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
@@ -31613,8 +31881,8 @@ function isValidScaffoldSlug(slug) {
 }
 
 // src/commands/canvas/sync-definition.ts
-import { readdir as readdir6, readFile as readFile12, stat as stat3 } from "fs/promises";
-import path19 from "path";
+import { readdir as readdir6, readFile as readFile13, stat as stat3 } from "fs/promises";
+import path20 from "path";
 import { defineCommand as defineCommand102 } from "citty";
 
 // src/commands/canvas/definition-graph.ts
@@ -31707,15 +31975,15 @@ async function syncCreativeDefinitionBestEffort(input) {
   }
 }
 async function resolveCanvasPath(inputPath) {
-  const resolved = path19.resolve(inputPath);
+  const resolved = path20.resolve(inputPath);
   let dir = resolved;
   try {
     if ((await stat3(resolved)).isFile()) {
       if (resolved.endsWith(".canvas.json")) return resolved;
-      dir = path19.dirname(resolved);
+      dir = path20.dirname(resolved);
     }
   } catch {
-    dir = resolved.endsWith(".canvas.json") ? path19.dirname(resolved) : resolved;
+    dir = resolved.endsWith(".canvas.json") ? path20.dirname(resolved) : resolved;
   }
   let entries;
   try {
@@ -31726,7 +31994,7 @@ async function resolveCanvasPath(inputPath) {
   const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
   const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
   const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
-  return chosen ? path19.join(dir, chosen) : null;
+  return chosen ? path20.join(dir, chosen) : null;
 }
 var syncDefinitionCommand = defineCommand102({
   meta: {
@@ -31749,7 +32017,7 @@ var syncDefinitionCommand = defineCommand102({
     if (!slug) return;
     let canvas;
     try {
-      canvas = JSON.parse(await readFile12(canvasPath, "utf8"));
+      canvas = JSON.parse(await readFile13(canvasPath, "utf8"));
     } catch {
       return;
     }
@@ -31776,7 +32044,7 @@ async function uploadSourceAsReference(source, isUrl, client) {
       throw new Error(`failed to download source image (${e instanceof Error ? e.message : String(e)})`);
     }
   } else {
-    bytes = await readFile13(source);
+    bytes = await readFile14(source);
   }
   const safe = await toModelSafeImage(bytes);
   const sha256 = sha256Hex(safe.bytes);
@@ -31831,7 +32099,7 @@ DROP background extras, decorative props, generic scenery, and anything small or
 For each kept element return: { "type": one of logo|product|person|animal|badge, "label": a short UPPER_SNAKE_CASE name (e.g. LOGO, PRODUCT, HERO_DOG, TRUSTPILOT), "description": a concrete reusable description to source/shoot the real asset (include the exact expression for a living subject, and its castable attributes \u2014 breed/species for an animal, apparent age band, apparent origin/ethnicity, and wardrobe/setting for a person \u2014 so it can be recast to fit OUR audience/market), "expression": the facial expression for a living subject or null, "reason": why it is identity-critical, "locator": the blueprint entry this element came from as { "collection": one of "subjects" | "people" | "brands_logos", "index": its 0-based position in that array } (people -> people; logos/badges -> brands_logos; products/animals/objects -> subjects). Output ONLY the JSON object.`;
 async function loadAssetText(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile13(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile14(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -32007,7 +32275,7 @@ var scaffoldStaticAdCommand = defineCommand103({
       process.cwd(),
       slug
     );
-    await mkdir6(path20.dirname(outPath), { recursive: true });
+    await mkdir6(path21.dirname(outPath), { recursive: true });
     const { describeModel, selectModel, layoutModel, genModel } = resolveModels(args);
     let durableSourceUrl;
     if (referencesDir) {
@@ -32127,7 +32395,7 @@ var scaffoldStaticAdCommand = defineCommand103({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path20.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
+            edit_prompt: `Edit ${path21.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
             assets_to_supply: report.elements,
             font_slot: report.includes_font ? "Drop a brand font at the [TODO] brandfont path (the describe pass recorded the ad's typefaces under `fonts` in prompt.json \u2014 match those). The font is wired into the render as a TYPE SPECIMEN reference so generated text takes the brand letterforms. Delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             actor_sheets: report.actor_sheets.length > 0 ? `Each living hero (${report.actor_sheets.join(", ")}) is fused into a generated multi-view reference sheet (image_reference_sheet) that the render grounds on \u2014 so drop ONE clean photo at that hero's ingest and the sheet builds the consistent turnaround. Pass --skip-actor-sheets to ground on the lone photo instead.` : "none (no person/animal heroes detected, or --skip-actor-sheets)",
@@ -32144,49 +32412,56 @@ var scaffoldStaticAdCommand = defineCommand103({
 });
 
 // src/commands/canvas/scaffold-ad.ts
-import { cp, mkdir as mkdir7, readFile as readFile14, writeFile as writeFile9 } from "fs/promises";
-import path22 from "path";
+import { copyFile, cp, mkdir as mkdir7, readFile as readFile15, writeFile as writeFile9 } from "fs/promises";
+import path23 from "path";
 import { defineCommand as defineCommand104 } from "citty";
 
 // src/engine/scaffold/ad-spec.ts
-import { z as z29 } from "zod";
+import { z as z30 } from "zod";
 var oneClause = (line) => (line.match(/[.!?](\s|$)/g) ?? []).length <= 1;
-var Beat = z29.object({
+var Beat = z30.object({
   /**
    * The line the voice says in this beat — ONE clause, ending in its own
    * punctuation. It becomes the caption card verbatim.
    */
-  say: z29.string().min(1).refine(oneClause, "a beat is one clause: split a second sentence into its own beat"),
+  say: z30.string().min(1).refine(oneClause, "a beat is one clause: split a second sentence into its own beat"),
   /** What is on screen while it is said, as a shot brief for the video model. */
-  show: z29.string().min(1),
+  show: z30.string().min(1),
   /**
    * Set only when this beat's subject is talking to camera. Off by default, and
    * the default is load-bearing: a person visibly speaking under a voice that is
    * not theirs reads as bad dubbing, which is what sank the first cut of this.
    */
-  on_camera: z29.boolean().optional()
+  on_camera: z30.boolean().optional(),
+  /**
+   * Whether the ad's recurring person is in this shot. Defaults to true whenever the
+   * spec declares a `cast`, because an ad is usually about one person and defaulting
+   * the other way is how continuity gets forgotten. Set false for a beat they are not
+   * in — a fitter on a roof, a product close-up.
+   */
+  cast: z30.boolean().optional()
 });
-var AdSpec = z29.object({
-  format: z29.object({
-    aspect_ratio: z29.string().default("9:16"),
-    resolution: z29.string().default("720p")
+var AdSpec = z30.object({
+  format: z30.object({
+    aspect_ratio: z30.string().default("9:16"),
+    resolution: z30.string().default("720p")
   }).default({ aspect_ratio: "9:16", resolution: "720p" }),
-  brand: z29.object({
-    name: z29.string().optional(),
+  brand: z30.object({
+    name: z30.string().optional(),
     /** Figures to lift typographically — the one gold number every ad has. */
-    highlight: z29.array(z29.string()).optional(),
+    highlight: z30.array(z30.string()).optional(),
     /**
      * Brand hex colours, most important first. They dress the brand plate and
      * the type — never the scenes: pushing hex into a shot brief makes the
      * model paint the whole frame that colour, which reads as a filter.
      */
-    palette: z29.array(z29.string()).optional(),
+    palette: z30.array(z30.string()).optional(),
     /** Repo path to the brand mark, so the CTA carries it instead of a name in a font. */
-    logo: z29.string().optional()
+    logo: z30.string().optional()
   }).optional(),
-  voice: z29.object({
-    description: z29.string().min(1),
-    language: z29.string().optional()
+  voice: z30.object({
+    description: z30.string().min(1),
+    language: z30.string().optional()
   }).optional(),
   /**
    * Where the ad is set, as a place a model can picture: "Spain", "Mexico",
@@ -32197,7 +32472,20 @@ var AdSpec = z29.object({
    * houses — sash windows, slate roofs, English suburbs — in every single frame,
    * from briefs that were otherwise perfectly good.
    */
-  market: z29.string().min(1).optional(),
+  market: z30.string().min(1).optional(),
+  /**
+   * The one person the ad is about.
+   *
+   * Declared once and grounded on every beat they appear in, because the engine already
+   * builds a reference sheet from this and tells each frame to render THE SAME
+   * individual. Without it each beat invents its own face: a 28-second ad came back
+   * with five different men playing one customer, which reads as a stock-footage
+   * collage rather than a story.
+   */
+  cast: z30.object({
+    /** Who they are, plainly: age, build, hair, wardrobe, the register of the ad. */
+    description: z30.string().min(1)
+  }).optional(),
   /**
    * A bed, described in words. Omitted leaves the ad dry — the engine only wires
    * music when asked, and silence is a legitimate choice.
@@ -32206,8 +32494,27 @@ var AdSpec = z29.object({
    * scroll-stopper and has to read clean. That is the engine's rule, not this
    * one, and it is why the prompt is all this needs to carry.
    */
-  music: z29.string().min(1).optional(),
-  beats: z29.array(Beat).min(2)
+  music: z30.string().min(1).optional(),
+  /**
+   * How the ad closes.
+   *
+   * On by default whenever the spec carries a brand, because an ad that stops instead
+   * of closing is what shipped: the last caption fell four seconds before the last
+   * frame and the picture simply ran out on a man shuffling paper. The closing beat's
+   * PICTURE becomes a flat brand plate — the engine already refuses to generate one as
+   * a photograph, since a video model garbles a wordmark — and the mark and the call to
+   * action are drawn over it by the composition.
+   *
+   * `false` opts out, for an ad that genuinely ends on its footage.
+   */
+  end_card: z30.union([
+    z30.literal(false),
+    z30.object({
+      /** The words on the button. Defaults to the last beat's line. */
+      cta: z30.string().min(1).optional()
+    })
+  ]).optional(),
+  beats: z30.array(Beat).min(2)
 });
 function narrativeRole(index, total) {
   if (index === 0) return "hook";
@@ -32248,14 +32555,34 @@ function beatSeconds(line) {
   const allowed = [...SEEDANCE_DURATIONS].sort((a, b) => a - b);
   return allowed.find((d) => d >= spoken) ?? allowed[allowed.length - 1];
 }
+var BRAND_PLATE = "A solid flat brand colour plate \u2014 an end card. No people, no objects, no scenery, no text of any kind.";
+function endCardWanted(spec) {
+  if (spec.end_card === false) return false;
+  return Boolean(spec.brand?.name || spec.brand?.logo);
+}
+function endCardCta(spec) {
+  if (!endCardWanted(spec)) return null;
+  const declared = spec.end_card === false ? void 0 : spec.end_card?.cta;
+  return declared?.trim() || (spec.beats[spec.beats.length - 1]?.say ?? "").trim() || null;
+}
+function adSpecCastElements(spec) {
+  const description = spec.cast?.description?.trim();
+  if (!description) return [];
+  const lastIndex = spec.beats.length - 1;
+  const scenes = spec.beats.map((beat, i) => ({ beat, i })).filter(({ beat, i }) => beat.cast !== false && !(endCardWanted(spec) && i === lastIndex)).map(({ i }) => i);
+  if (scenes.length === 0) return [];
+  return [{ type: "person", label: "customer", description, scenes }];
+}
 function adSpecToBlueprint(spec) {
   const total = spec.beats.length;
   const market = marketFor(spec);
   const place = market ? ` Set in ${market}: the architecture, streets and styling are ${market}'s.` : "";
   const currency = market ? CURRENCY_BY_MARKET[market.toLowerCase()] : void 0;
   const physics = " Everything obeys real-world physics: paper, card and screens are OPAQUE with nothing showing through from behind, every object is at believable real-world scale next to the people handling it, and every object has its real-world form and construction \u2014 a phone has ONE screen and it is on the front. NO readable text or numbers anywhere in frame \u2014 phone screens, documents and signage stay illegible or out of focus, because any figure the model invents will contradict the script." + (currency ? ` If a currency is unavoidably visible it is ${currency}.` : "");
+  const closesOnCard = endCardWanted(spec);
   let clock = 0;
   const scenes = spec.beats.map((beat, i) => {
+    const isClosingCard = closesOnCard && i === total - 1;
     const duration = beatSeconds(beat.say);
     const start = clock;
     clock += duration;
@@ -32263,7 +32590,7 @@ function adSpecToBlueprint(spec) {
       start_s: Math.round(start * 100) / 100,
       end_s: Math.round(clock * 100) / 100,
       duration_s: duration,
-      summary: beat.say,
+      summary: isClosingCard ? `${BRAND_PLATE} ${beat.say}` : beat.say,
       narrative_role: narrativeRole(i, total),
       // The read is built from per-scene dialogue, not from the global
       // transcript: emitting only the transcript scaffolds a SILENT ad. And
@@ -32279,12 +32606,12 @@ function adSpecToBlueprint(spec) {
           ...spec.voice?.description ? { voice_description: spec.voice.description } : {}
         }
       ],
-      motion_prompt: beat.on_camera ? `${beat.show}${place}${physics}` : (
+      motion_prompt: isClosingCard ? BRAND_PLATE : beat.on_camera ? `${beat.show}${place}${physics}` : (
         // The subject must not be forming words: the voice belongs to the
         // narration, and a mouth moving under it reads as dubbing.
         `${beat.show}${place}${physics} Nobody in frame is speaking \u2014 mouths closed, no dialogue.`
       ),
-      start_frame_prompt: `${beat.show}${place}${physics}`
+      start_frame_prompt: isClosingCard ? BRAND_PLATE : `${beat.show}${place}${physics}`
     };
   });
   return {
@@ -32310,20 +32637,80 @@ function adSpecToBlueprint(spec) {
   };
 }
 
+// src/engine/scaffold/ad-brand-overlay.ts
+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;
+  if (!logo && !cta?.trim()) return "";
+  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",
+    "     a video model garbles a wordmark every time. Restyle freely; keep the `clip`",
+    "     class and the data-start/data-dur attributes, which is how the runtime times them. -->"
+  ];
+  if (logo) {
+    parts.push(
+      `<img class="ov clip pos-top-left brand-mark" src="${escapeHtml2(logo.file)}" alt="${escapeHtml2(logo.alt)}" data-start="0" data-dur="${totalS}" />`
+    );
+  }
+  const cardBits = [];
+  if (logo) {
+    cardBits.push(`<img class="endcard-logo" src="${escapeHtml2(logo.file)}" alt="${escapeHtml2(logo.alt)}" />`);
+  }
+  if (cta?.trim()) {
+    const style = accent ? ` style="background:${escapeHtml2(accent)}"` : "";
+    cardBits.push(`<div class="endcard-cta"${style}>${escapeHtml2(cta.trim())}</div>`);
+  }
+  parts.push(
+    `<div class="ov clip pos-center endcard" data-start="${cardAtS}" data-dur="${cardDurationS}" data-role="cta">`,
+    ...cardBits.map((b) => `  ${b}`),
+    "</div>"
+  );
+  return parts.join("\n");
+}
+function adBrandOverlayCss() {
+  return [
+    "      /* --- brand layer (baker canvas scaffold-ad) --- */",
+    "      .brand-mark { width: 220px; height: auto; opacity: 0.92;",
+    "        filter: drop-shadow(0 2px 8px rgba(0,0,0,0.45)); }",
+    "      .endcard { display: flex; flex-direction: column; align-items: center; gap: 56px;",
+    "        width: 100%; max-width: 1080px; padding: 0 60px; text-align: center; }",
+    "      .endcard-logo { width: 620px; max-width: 78%; height: auto; }",
+    "      /* Capped and wrapping, not sized to its content: measured in a real browser,",
+    "         `GET YOUR FREE QUOTE` renders 948px wide against a 1080px canvas, so the next",
+    "         slightly longer call to action runs off the frame. Two lines beat an edge. */",
+    "      .endcard-cta { 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); }"
+  ].join("\n");
+}
+function injectAdBrandOverlay(indexHtml, overlayHtml) {
+  if (!overlayHtml.trim()) return indexHtml;
+  const withCss = indexHtml.replace("    </style>", `${adBrandOverlayCss()}
+    </style>`);
+  return withCss.replace("<!--OVERLAYS-->", () => overlayHtml);
+}
+
 // src/commands/canvas/composition-path.ts
 import { existsSync as existsSync4 } from "fs";
-import path21 from "path";
+import path22 from "path";
 function resolveShippedCanvasDir(name, startDir, exists = existsSync4, maxDepth = 8) {
-  const rel = path21.join("canvas", name);
+  const rel = path22.join("canvas", name);
   let dir = startDir;
   for (let i = 0; i < maxDepth; i++) {
-    const candidate = path21.join(dir, rel);
-    if (exists(path21.join(candidate, "meta.json"))) return candidate;
-    const parent = path21.dirname(dir);
+    const candidate = path22.join(dir, rel);
+    if (exists(path22.join(candidate, "meta.json"))) return candidate;
+    const parent = path22.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path21.resolve(startDir, "../../../", rel);
+  return path22.resolve(startDir, "../../../", rel);
 }
 
 // src/commands/canvas/scaffold-ad.ts
@@ -32369,7 +32756,7 @@ var scaffoldAdCommand = defineCommand104({
     const specPath = args.spec;
     let parsed;
     try {
-      parsed = JSON.parse(await readFile14(specPath, "utf-8"));
+      parsed = JSON.parse(await readFile15(specPath, "utf-8"));
     } catch (e) {
       writeJson({
         ok: false,
@@ -32396,29 +32783,59 @@ var scaffoldAdCommand = defineCommand104({
       return;
     }
     const blueprint = adSpecToBlueprint(spec.data);
-    const slug = args.slug ?? path22.basename(specPath).replace(/\.[^.]+$/, "");
-    const outPath = args.out ?? (args.slug ? path22.join("src/creatives", slug, `${slug}.canvas.json`) : path22.join(path22.dirname(specPath), `${slug}.canvas.json`));
-    const outDir = path22.dirname(outPath);
+    const slug = args.slug ?? path23.basename(specPath).replace(/\.[^.]+$/, "");
+    const outPath = args.out ?? (args.slug ? path23.join("src/creatives", slug, `${slug}.canvas.json`) : path23.join(path23.dirname(specPath), `${slug}.canvas.json`));
+    const outDir = path23.dirname(outPath);
     await mkdir7(outDir, { recursive: true });
-    const compositionDest = path22.join(outDir, "video-overlay-composition");
-    const captionsDest = path22.join(outDir, "tiktok-captions-composition");
+    const compositionDest = path23.join(outDir, "video-overlay-composition");
+    const captionsDest = path23.join(outDir, "tiktok-captions-composition");
     await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
     await cp(SHIPPED_CAPTIONS_DIR, captionsDest, { recursive: true });
-    const blueprintPath = path22.join(outDir, "prompt.json");
-    const blueprintStylePath = path22.join(outDir, "prompt.style.json");
+    const blueprintPath = path23.join(outDir, "prompt.json");
+    const blueprintStylePath = path23.join(outDir, "prompt.style.json");
     await writeSceneFiles(outDir, blueprint);
     await writeFile9(blueprintStylePath, renderStyleProjectionFromValue(blueprint), "utf8");
+    const logoPath = spec.data.brand?.logo?.trim();
+    let staged = null;
+    if (logoPath) {
+      const ext = path23.extname(logoPath) || ".png";
+      const dest = path23.join(compositionDest, `brand-mark${ext}`);
+      try {
+        await copyFile(logoPath, dest);
+        staged = { file: `brand-mark${ext}`, alt: spec.data.brand?.name ?? "brand" };
+      } catch {
+      }
+    }
+    const closing = blueprint.scenes[blueprint.scenes.length - 1];
+    const overlayHtml = endCardWanted(spec.data) && closing ? buildAdBrandOverlay({
+      logo: staged,
+      cta: endCardCta(spec.data),
+      cardAtS: closing.start_s,
+      cardDurationS: closing.duration_s,
+      totalS: blueprint.estimated_duration_s,
+      accent: firstHex(spec.data.brand?.palette)
+    }) : "";
+    if (overlayHtml) {
+      const indexPath = path23.join(compositionDest, "index.html");
+      const html = await readFile15(indexPath, "utf-8");
+      await writeFile9(indexPath, injectAdBrandOverlay(html, overlayHtml), "utf-8");
+    }
     const opts = {
       imageModel: AD_IMAGE_MODEL,
       videoModel: DEFAULT_VIDEO_GENERATE_MODEL,
-      overlayCompositionPath: path22.relative(outDir, compositionDest),
-      captionsCompositionPath: path22.relative(outDir, captionsDest),
-      blueprintPath: path22.relative(outDir, blueprintPath),
-      blueprintStylePath: path22.relative(outDir, blueprintStylePath),
+      overlayCompositionPath: path23.relative(outDir, compositionDest),
+      captionsCompositionPath: path23.relative(outDir, captionsDest),
+      blueprintPath: path23.relative(outDir, blueprintPath),
+      blueprintStylePath: path23.relative(outDir, blueprintStylePath),
       aspect: spec.data.format.aspect_ratio,
-      resolution: spec.data.format.resolution
+      resolution: spec.data.format.resolution,
+      // A beat is one clause and one card, so the cap has to clear a whole clause.
+      // The composition's default of 3 is TikTok karaoke styling; applied to an ad
+      // it overrode the clause rule on every line and rendered "IS STANDARD. WE".
+      // 8 is the composition's own maximum and clears every beat measured here.
+      captionWordsPerGroup: 8
     };
-    const canvas = scaffoldVideoCanvas(blueprint, [], opts);
+    const canvas = scaffoldVideoCanvas(blueprint, adSpecCastElements(spec.data), opts);
     await writeFile9(outPath, `${JSON.stringify(canvas, null, 2)}
 `, "utf-8");
     writeJson({
@@ -32427,18 +32844,28 @@ var scaffoldAdCommand = defineCommand104({
       hints: [
         `Wrote ${spec.data.beats.length} beats to ${outPath}. Run it with \`baker canvas run ${outPath}\`.`,
         `These beats run about ${blueprint.estimated_duration_s}s. If the ask was longer, add beats \u2014 the length is the sum of the lines, so a 25s ad needs roughly 25s of script and cannot be stretched by holding shots.`,
+        ...logoPath && !staged ? [`Could not read the logo at \`${logoPath}\` \u2014 the ad has no mark on screen. Give the path as it appears in src/brand/BRAND.md, relative to the workspace root.`] : [],
+        ...staged ? ["The brand mark is drawn by the composition \u2014 top-left throughout, and large on the closing card. It is never generated as a picture, so it cannot come back garbled."] : [],
+        ...endCardWanted(spec.data) ? ["The last beat closes on a flat brand plate with the call to action over it, instead of one more photograph."] : [],
         "The caption cards are your `say` lines verbatim \u2014 read them back before running; that is the copy the viewer sees.",
         "Every clip renders with nobody speaking unless a beat set `on_camera`. If a beat needs a presenter talking, set it there rather than describing it in `show`.",
-        "If the spec carried no `brand`, read src/brand/BRAND.md and re-run with its palette and logo \u2014 an unbranded ad is the client's message in someone else's clothes."
+        ...spec.data.brand?.palette?.length && spec.data.brand?.logo ? [] : [
+          // Keyed on what is MISSING, not on whether `brand` exists at all. The
+          // previous wording fired only when the spec carried no brand — so a spec
+          // holding `brand.name` and nothing else sailed through and rendered an
+          // 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."
       ]
     });
   }
 });
 
 // src/commands/canvas/scaffold-video.ts
-import { access as access2, cp as cp2, mkdir as mkdir8, readFile as readFile17, rm as rm6, writeFile as writeFile10 } from "fs/promises";
-import { tmpdir as tmpdir2 } from "os";
-import path24 from "path";
+import { access as access2, cp as cp2, mkdir as mkdir8, readFile as readFile18, rm as rm7, writeFile as writeFile10 } from "fs/promises";
+import { tmpdir as tmpdir3 } from "os";
+import path25 from "path";
 import { defineCommand as defineCommand105 } from "citty";
 
 // src/engine/scaffold/lib/model-router.ts
@@ -32477,12 +32904,12 @@ function routeVideoModel(input) {
 }
 
 // src/engine/nodes/local/lib/sceneDetect.ts
-import { execFile as execFile2 } from "child_process";
-import { mkdtemp, readdir as readdir7, readFile as readFile15, rm as rm5 } from "fs/promises";
-import { tmpdir } from "os";
+import { execFile as execFile3 } from "child_process";
+import { mkdtemp as mkdtemp2, readdir as readdir7, readFile as readFile16, rm as rm6 } from "fs/promises";
+import { tmpdir as tmpdir2 } from "os";
 import { join as join2 } from "path";
-import { promisify as promisify2 } from "util";
-var execFileAsync2 = promisify2(execFile2);
+import { promisify as promisify3 } from "util";
+var execFileAsync3 = promisify3(execFile3);
 var PYSCENEDETECT_THRESHOLD = 18;
 var PYSCENEDETECT_MIN_SCENE_LEN_S = 0.25;
 var PYSCENEDETECT_RECHECK_THRESHOLD = 27;
@@ -32533,9 +32960,9 @@ function parsePySceneDetectCsvCuts(csv) {
   return [...new Set(cuts)].sort((a, b) => a - b);
 }
 async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs) {
-  const outDir = await mkdtemp(join2(tmpdir(), "baker-scenedetect-"));
+  const outDir = await mkdtemp2(join2(tmpdir2(), "baker-scenedetect-"));
   try {
-    await execFileAsync2(
+    await execFileAsync3(
       "scenedetect",
       [
         "--input",
@@ -32554,9 +32981,9 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
     );
     const csvName = (await readdir7(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
     if (!csvName) return [];
-    return parsePySceneDetectCsvCuts(await readFile15(join2(outDir, csvName), "utf-8"));
+    return parsePySceneDetectCsvCuts(await readFile16(join2(outDir, csvName), "utf-8"));
   } finally {
-    await rm5(outDir, { recursive: true, force: true });
+    await rm6(outDir, { recursive: true, force: true });
   }
 }
 async function detectSceneCutsPySceneDetect(filePath, opts = {}) {
@@ -32578,8 +33005,8 @@ async function detectSceneCutsPySceneDetect(filePath, opts = {}) {
 }
 
 // src/commands/canvas/gitignore.ts
-import { appendFile, readFile as readFile16 } from "fs/promises";
-import path23 from "path";
+import { appendFile, readFile as readFile17 } from "fs/promises";
+import path24 from "path";
 function missingGitignoreEntries(existing, entries) {
   const present2 = new Set(
     existing.split("\n").map((l) => l.trim().replace(/\/+$/, "")).filter((l) => l.length > 0 && !l.startsWith("#"))
@@ -32587,10 +33014,10 @@ function missingGitignoreEntries(existing, entries) {
   return entries.filter((e) => !present2.has(e.trim().replace(/\/+$/, "")));
 }
 async function ensureGitignore(dir, entries) {
-  const file = path23.join(dir, ".gitignore");
+  const file = path24.join(dir, ".gitignore");
   let existing;
   try {
-    existing = await readFile16(file, "utf8");
+    existing = await readFile17(file, "utf8");
   } catch {
     return;
   }
@@ -32629,7 +33056,7 @@ ONE PERSON, MULTIPLE LOOKS: if a single individual plays MULTIPLE personas or wa
 For each kept element return: { "type": one of person|animal|product|logo|badge|location, "label": a short UPPER_SNAKE_CASE name (e.g. HERO, CREATOR_SKEPTIC, INSURANCE_CARD, LOGO), "description": a concrete reusable description to source/shoot the real asset \u2014 for a person/animal give a NEUTRAL castable role (e.g. "hero pet-owner, woman in her 30s" or "a small beagle"), NOT the original individual's literal face/identity: we RECAST with a FRESH person/animal, so never tell the agent to reuse the original. "expression": a living subject's typical expression or null, "cast_id": the global.cast id if it maps to one else null, "same_as": the label of another element this is the SAME individual as (different wardrobe/persona) else null, "scenes": the 0-based indices of ONLY the scenes where the element is ACTUALLY VISIBLE ON SCREEN \u2014 judged from that scene's start_frame_prompt / end_frame_prompt subjects and its action_detail, NOT from who is merely speaking. A narrator heard over b-roll is NOT present in that b-roll scene; a dog-running cutaway does NOT contain the couch creator just because she talks across it. Do NOT pad the list \u2014 an element wrongly listed in a scene makes the reproduction render the wrong subject there (e.g. the creator appearing in a pure-dog b-roll). When in doubt, leave a scene OUT. Output ONLY the JSON object.`;
 async function loadAssetText2(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile17(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile18(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -32648,7 +33075,7 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text2 = transcript?.trim();
   if (!text2 || text2 === "[]") return {};
-  const compositionPath = path24.join(outDir, "tiktok-captions-composition");
+  const compositionPath = path25.join(outDir, "tiktok-captions-composition");
   await cp2(SHIPPED_CAPTIONS_DIR2, compositionPath, { recursive: true });
   return { compositionPath };
 }
@@ -32666,11 +33093,11 @@ function patchCompositionHtml(html, dims) {
   return html.replace(/(<meta\s+name="viewport"\s+content="width=)\d+(,\s*height=)\d+(")/i, `$1${dims.w}$2${dims.h}$3`).replace(/(width:\s*)\d+(px;\s*height:\s*)\d+(px;)/i, `$1${dims.w}$2${dims.h}$3`).replace(/(data-width=")\d+(")/i, `$1${dims.w}$2`).replace(/(data-height=")\d+(")/i, `$1${dims.h}$2`);
 }
 async function stampCompositionDims(compositionDir, dims) {
-  const metaPath = path24.join(compositionDir, "meta.json");
-  const rawMeta = await readFile17(metaPath, "utf8");
+  const metaPath = path25.join(compositionDir, "meta.json");
+  const rawMeta = await readFile18(metaPath, "utf8");
   await writeFile10(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
-  const htmlPath = path24.join(compositionDir, "index.html");
-  const rawHtml = await readFile17(htmlPath, "utf8");
+  const htmlPath = path25.join(compositionDir, "index.html");
+  const rawHtml = await readFile18(htmlPath, "utf8");
   await writeFile10(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
 }
 function parseElements2(raw) {
@@ -32718,7 +33145,7 @@ var VIDEO_EXT_BY_MIME = {
   "video/x-matroska": ".mkv"
 };
 function referenceVideoExt(url, contentType) {
-  const fromPath = path24.extname(new URL(url).pathname).toLowerCase();
+  const fromPath = path25.extname(new URL(url).pathname).toLowerCase();
   if (fromPath && fromPath.length <= 5) return fromPath;
   const mime = (contentType ?? "").split(";")[0]?.trim().toLowerCase();
   return mime && VIDEO_EXT_BY_MIME[mime] || ".mp4";
@@ -32744,7 +33171,7 @@ function videoDefinitionDescription(blueprint) {
   return typeof product === "string" && product.trim() ? product.trim() : void 0;
 }
 async function materializeReferenceVideo(fileArg2) {
-  if (!/^https?:\/\//i.test(fileArg2)) return path24.resolve(fileArg2);
+  if (!/^https?:\/\//i.test(fileArg2)) return path25.resolve(fileArg2);
   let bytes;
   let contentType;
   try {
@@ -32756,8 +33183,8 @@ async function materializeReferenceVideo(fileArg2) {
     throw new Error(`failed to download reference video: ${e instanceof Error ? e.message : String(e)}`);
   }
   if (bytes.length === 0) throw new Error("reference video download was empty");
-  const dest = path24.join(
-    tmpdir2(),
+  const dest = path25.join(
+    tmpdir3(),
     `baker-ref-${sha256Hex(bytes).slice(0, 16)}${referenceVideoExt(fileArg2, contentType)}`
   );
   await writeFile10(dest, bytes);
@@ -32976,11 +33403,11 @@ var scaffoldVideoCommand = defineCommand105({
     } catch (e) {
       return fail4("download", e instanceof Error ? e.message : String(e));
     }
-    const base = path24.basename(videoPath, path24.extname(videoPath));
-    const outPath = args.out ? path24.resolve(String(args.out)) : slug ? path24.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path24.join(path24.dirname(videoPath), `${base}.video.canvas.json`);
-    const outDir = path24.dirname(outPath);
-    const blueprintPath = path24.join(outDir, "prompt.json");
-    const blueprintStylePath = path24.join(outDir, "prompt.style.json");
+    const base = path25.basename(videoPath, path25.extname(videoPath));
+    const outPath = args.out ? path25.resolve(String(args.out)) : slug ? path25.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path25.join(path25.dirname(videoPath), `${base}.video.canvas.json`);
+    const outDir = path25.dirname(outPath);
+    const blueprintPath = path25.join(outDir, "prompt.json");
+    const blueprintStylePath = path25.join(outDir, "prompt.style.json");
     const frames = args.frames === "reuse" ? "reuse" : "generate";
     const maxScenes = args["max-scenes"] ? Number(args["max-scenes"]) : void 0;
     if (Number.isFinite(maxScenes)) {
@@ -33025,12 +33452,12 @@ var scaffoldVideoCommand = defineCommand105({
 `
       );
     }
-    const compositionDest = path24.join(outDir, "video-overlay-composition");
+    const compositionDest = path25.join(outDir, "video-overlay-composition");
     await cp2(SHIPPED_COMPOSITION_DIR2, compositionDest, { recursive: true });
     await stampCompositionDims(compositionDest, outDims);
-    const indexPath = path24.join(compositionDest, "index.html");
+    const indexPath = path25.join(compositionDest, "index.html");
     const overlayHtml = buildOverlayHtml(blueprint, { captionsActive: Boolean(transcript) });
-    const indexHtml = await readFile17(indexPath, "utf8");
+    const indexHtml = await readFile18(indexPath, "utf8");
     const injected = indexHtml.replace("<!--OVERLAYS-->", () => overlayHtml);
     if (injected === indexHtml && overlayHtml.trim()) {
       fail4(
@@ -33044,10 +33471,10 @@ var scaffoldVideoCommand = defineCommand105({
     const opts = {
       imageModel,
       videoModel,
-      overlayCompositionPath: path24.relative(outDir, compositionDest),
-      captionsCompositionPath: captions.compositionPath ? path24.relative(outDir, captions.compositionPath) : void 0,
-      blueprintPath: path24.relative(outDir, blueprintPath),
-      blueprintStylePath: path24.relative(outDir, blueprintStylePath),
+      overlayCompositionPath: path25.relative(outDir, compositionDest),
+      captionsCompositionPath: captions.compositionPath ? path25.relative(outDir, captions.compositionPath) : void 0,
+      blueprintPath: path25.relative(outDir, blueprintPath),
+      blueprintStylePath: path25.relative(outDir, blueprintStylePath),
       frames,
       ambient: Boolean(args.ambient),
       seamDedup: resolveSeamDedup(args["seam-dedup"]),
@@ -33063,7 +33490,7 @@ var scaffoldVideoCommand = defineCommand105({
       return fail4("scaffold", e instanceof Error ? e.message : String(e));
     }
     if (captions.compositionPath && !canvas.nodes.some((n) => n.id === "captions")) {
-      await rm6(captions.compositionPath, { recursive: true, force: true });
+      await rm7(captions.compositionPath, { recursive: true, force: true });
     }
     const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(canvas, outDir), defaultRegistry());
     if (!validation.ok) {
@@ -33075,7 +33502,7 @@ var scaffoldVideoCommand = defineCommand105({
     await writeFile10(outPath, `${JSON.stringify(canvas, null, 2)}
 `, "utf8");
     await writeFile10(
-      path24.join(outDir, REBUILD_FILE),
+      path25.join(outDir, REBUILD_FILE),
       `${JSON.stringify({ elements, opts }, null, 2)}
 `,
       "utf8"
@@ -33100,7 +33527,7 @@ var scaffoldVideoCommand = defineCommand105({
     await ensureGitignore(process.cwd(), ["canvas/", ".context/"]);
     const sourceRef = videoSourceReference(blueprint, fileArg2);
     if (slug) {
-      const definitionPath = path24.join(outDir, "_definition.md");
+      const definitionPath = path25.join(outDir, "_definition.md");
       if (!await fileExists2(definitionPath)) {
         await writeFile10(
           definitionPath,
@@ -33155,7 +33582,7 @@ var scaffoldVideoCommand = defineCommand105({
             graph: canvas.metadata?.video?.graph_stats
           },
           checklist: {
-            edit_prompt: `The blueprint is split so you edit ONE small file at a time \u2014 never a giant one. Per-scene content (a scene's dialogue, action, frame prompts, overlays) lives in \`scenes/sNN.json\` \u2014 edit the single scene you want to change. Global cast/palette/brand/copy lives in \`${path24.basename(blueprintPath)}\`. \`baker canvas validate\`/\`run\` re-assemble the blueprint and re-flow every edited scene back into the render (and regenerate ${path24.basename(blueprintStylePath)}, the projection each frame's target_blueprint reads) \u2014 so your scene edits reach the render automatically. Never hand-edit the inlined node prompts in the canvas or the derived ${path24.basename(blueprintStylePath)}; both are regenerated.`,
+            edit_prompt: `The blueprint is split so you edit ONE small file at a time \u2014 never a giant one. Per-scene content (a scene's dialogue, action, frame prompts, overlays) lives in \`scenes/sNN.json\` \u2014 edit the single scene you want to change. Global cast/palette/brand/copy lives in \`${path25.basename(blueprintPath)}\`. \`baker canvas validate\`/\`run\` re-assemble the blueprint and re-flow every edited scene back into the render (and regenerate ${path25.basename(blueprintStylePath)}, the projection each frame's target_blueprint reads) \u2014 so your scene edits reach the render automatically. Never hand-edit the inlined node prompts in the canvas or the derived ${path25.basename(blueprintStylePath)}; both are regenerated.`,
             recurring_elements_to_supply: report.elements,
             voices_to_confirm: report.dialogue.map((d) => ({
               scene: d.scene,
@@ -33192,8 +33619,8 @@ var scaffoldVideoCommand = defineCommand105({
 });
 
 // src/commands/canvas/set-prompt.ts
-import { readFile as readFile18, writeFile as writeFile11 } from "fs/promises";
-import path25 from "path";
+import { readFile as readFile19, writeFile as writeFile11 } from "fs/promises";
+import path26 from "path";
 import { defineCommand as defineCommand106 } from "citty";
 function setNodePrompt(canvas, nodeId, text2) {
   const nodes = canvas?.nodes;
@@ -33221,17 +33648,17 @@ var setPromptCommand = defineCommand106({
     "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
   },
   async run({ args }) {
-    const filePath = path25.resolve(String(args.file));
+    const filePath = path26.resolve(String(args.file));
     let canvas;
     try {
-      canvas = JSON.parse(await readFile18(filePath, "utf8"));
+      canvas = JSON.parse(await readFile19(filePath, "utf8"));
     } catch (e) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "parse", message: String(e) } }, null, 2)}
 `);
       process.exit(2);
     }
     let text2;
-    if (args["text-file"]) text2 = await readFile18(path25.resolve(String(args["text-file"])), "utf8");
+    if (args["text-file"]) text2 = await readFile19(path26.resolve(String(args["text-file"])), "utf8");
     else if (args.text !== void 0) text2 = String(args.text);
     else {
       process.stderr.write(
@@ -33252,7 +33679,7 @@ var setPromptCommand = defineCommand106({
       process.exit(2);
       return;
     }
-    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path25.dirname(filePath)), defaultRegistry());
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path26.dirname(filePath)), defaultRegistry());
     if (!validation.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.issues } }, null, 2)}
 `);
@@ -33267,8 +33694,8 @@ var setPromptCommand = defineCommand106({
 });
 
 // src/commands/canvas/validate.ts
-import { readFile as readFile19 } from "fs/promises";
-import path26 from "path";
+import { readFile as readFile20 } from "fs/promises";
+import path27 from "path";
 import { defineCommand as defineCommand107 } from "citty";
 var validateCommand = defineCommand107({
   meta: {
@@ -33277,8 +33704,8 @@ var validateCommand = defineCommand107({
   },
   args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
   async run({ args }) {
-    const filePath = path26.resolve(String(args.file));
-    const raw = await readFile19(filePath, "utf8");
+    const filePath = path27.resolve(String(args.file));
+    const raw = await readFile20(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -33290,7 +33717,7 @@ var validateCommand = defineCommand107({
     }
     const healed = await healAbsoluteCanvasPaths(filePath, parsed);
     parsed = healed.canvas;
-    parsed = resolveRelativeCanvasPaths(parsed, path26.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path27.dirname(filePath));
     let styleProjection = "not_applicable";
     try {
       styleProjection = await syncStyleProjection(parsed, (line) => process.stderr.write(`${line}
@@ -33716,7 +34143,7 @@ import { defineCommand as defineCommand112 } from "citty";
 import { defineCommand as defineCommand111 } from "citty";
 
 // src/commands/images/api.ts
-import { readFile as readFile20 } from "fs/promises";
+import { readFile as readFile21 } from "fs/promises";
 import { basename, extname } from "path";
 var imageProcessingTimeoutMs = 18e4;
 var imageReadyPollIntervalMs = 2e3;
@@ -33730,7 +34157,7 @@ var mimeMap = {
   ".avif": "image/avif"
 };
 var defaultImageApiDeps = {
-  readFile: readFile20,
+  readFile: readFile21,
   post: apiPost,
   get: apiGet,
   sleep: (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))
@@ -33992,12 +34419,12 @@ function collectSideEffects(tree) {
   );
 }
 function readFlowTree(slug) {
-  const path39 = join3(flowsDir(), slug, "_data.json");
-  if (!existsSync5(path39)) {
+  const path40 = join3(flowsDir(), slug, "_data.json");
+  if (!existsSync5(path40)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync9(path39, "utf-8"));
+    return JSON.parse(readFileSync9(path40, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -34389,10 +34816,10 @@ function parseValueExpression(raw) {
   return parts.map(parsePart);
 }
 function trackingFieldIds() {
-  const path39 = join4(flowsDir(), "..", "tracking.ts");
-  if (!existsSync6(path39)) return null;
+  const path40 = join4(flowsDir(), "..", "tracking.ts");
+  if (!existsSync6(path40)) return null;
   try {
-    const source = readFileSync10(path39, "utf-8");
+    const source = readFileSync10(path40, "utf-8");
     const block2 = source.match(/TRACKING_FIELD_IDS\s*=\s*\[([\s\S]*?)\]\s*as const/)?.[1];
     if (!block2) return null;
     const ids = [...block2.matchAll(/"(tracking\.[a-z0-9_]+)"/g)].map((match) => match[1]);
@@ -34944,13 +35371,13 @@ function specsFromFile(parsed) {
     return `${destField}${type}=${entry?.value ?? ""}`;
   });
 }
-function readSpecFile(path39) {
+function readSpecFile(path40) {
   let raw;
   try {
-    raw = path39 === "-" ? readFileSync11(0, "utf-8") : readFileSync11(path39, "utf-8");
+    raw = path40 === "-" ? readFileSync11(0, "utf-8") : readFileSync11(path40, "utf-8");
   } catch (error) {
     refuse(
-      `Could not read ${path39 === "-" ? "the mapping from stdin" : `"${path39}"`}: ${error instanceof Error ? error.message : String(error)}`
+      `Could not read ${path40 === "-" ? "the mapping from stdin" : `"${path40}"`}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   let parsed;
@@ -34958,7 +35385,7 @@ function readSpecFile(path39) {
     parsed = JSON.parse(raw);
   } catch (error) {
     refuse(
-      `${path39 === "-" ? "stdin" : `"${path39}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      `${path40 === "-" ? "stdin" : `"${path40}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
       'Expected { "map": { "<destField>": "<value>", \u2026 } }'
     );
   }
@@ -35212,18 +35639,18 @@ var ARRAY_FIELDS = [
   "tagIds"
 ];
 var ARRAY_OWNERS = ["", "body"];
-function dropUnsetOptionals(sideEffect, path39) {
+function dropUnsetOptionals(sideEffect, path40) {
   return OPTIONAL_STRINGS.flatMap((key) => {
     if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
     delete sideEffect[key];
-    return [{ path: path39, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+    return [{ path: path40, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
   });
 }
-function fillNulledArrays(target, prefix, path39) {
+function fillNulledArrays(target, prefix, path40) {
   return ARRAY_FIELDS.flatMap((key) => {
     if (!(key in target) || target[key] !== null) return [];
     target[key] = [];
-    return [{ path: path39, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+    return [{ path: path40, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
   });
 }
 function sideEffectsOf(node) {
@@ -35233,13 +35660,13 @@ function sideEffectsOf(node) {
   );
 }
 function normalizeSideEffect(sideEffect, where) {
-  const path39 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const path40 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
   const arrays = ARRAY_OWNERS.flatMap((owner) => {
     const target = owner ? sideEffect[owner] : sideEffect;
     if (!target || typeof target !== "object") return [];
-    return fillNulledArrays(target, owner ? `${owner}.` : "", path39);
+    return fillNulledArrays(target, owner ? `${owner}.` : "", path40);
   });
-  return [...dropUnsetOptionals(sideEffect, path39), ...arrays];
+  return [...dropUnsetOptionals(sideEffect, path40), ...arrays];
 }
 function normalizeFlowTree(tree) {
   const changes = [];
@@ -35777,10 +36204,10 @@ async function stageOps(ops) {
     handleError2(err);
   }
 }
-async function draftAction2(path39, body, chat) {
+async function draftAction2(path40, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path39, { chatId, ...body });
+    const data = await apiPost(path40, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -38177,7 +38604,7 @@ function cropSprite(input, region) {
 
 // src/lib/image/io.ts
 import { randomBytes } from "crypto";
-import { glob as fsGlob, readFile as readFile21, rename, stat as stat4, writeFile as writeFile12 } from "fs/promises";
+import { glob as fsGlob, readFile as readFile22, rename, stat as stat4, writeFile as writeFile12 } from "fs/promises";
 import { dirname as dirname2, extname as extname2, join as join5, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
@@ -38210,11 +38637,11 @@ async function readImageBuffer(pathOrUrl) {
     const { buffer } = await fetchExternalBytes(pathOrUrl, { maxBytes: MAX_REMOTE_IMAGE_BYTES });
     return buffer;
   }
-  return readFile21(pathOrUrl);
+  return readFile22(pathOrUrl);
 }
-async function isDirectory(path39) {
+async function isDirectory(path40) {
   try {
-    const s = await stat4(path39);
+    const s = await stat4(path40);
     return s.isDirectory();
   } catch {
     return false;
@@ -38516,13 +38943,13 @@ function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDi
 }
 function disambiguate(paths) {
   const taken = /* @__PURE__ */ new Set();
-  return paths.map((path39) => {
-    if (!taken.has(path39)) {
-      taken.add(path39);
-      return path39;
+  return paths.map((path40) => {
+    if (!taken.has(path40)) {
+      taken.add(path40);
+      return path40;
     }
-    const ext = extname3(path39);
-    const stem = path39.slice(0, path39.length - ext.length);
+    const ext = extname3(path40);
+    const stem = path40.slice(0, path40.length - ext.length);
     let n = 2;
     while (taken.has(`${stem}-${n}${ext}`)) n += 1;
     const unique = `${stem}-${n}${ext}`;
@@ -38649,10 +39076,10 @@ async function runDownloads(plan) {
   const paths = disambiguate(fetched.map((item) => item.path));
   const downloaded = [];
   for (const [index, item] of fetched.entries()) {
-    const path39 = paths[index] ?? item.path;
+    const path40 = paths[index] ?? item.path;
     try {
-      await atomicWrite(path39, item.buffer);
-      downloaded.push({ input: item.input, output: path39, bytes: item.buffer.length, contentType: item.contentType });
+      await atomicWrite(path40, item.buffer);
+      downloaded.push({ input: item.input, output: path40, bytes: item.buffer.length, contentType: item.contentType });
     } catch (err) {
       failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
     }
@@ -41612,7 +42039,7 @@ import { defineCommand as defineCommand167 } from "citty";
 
 // src/commands/landing/critique.ts
 import { readdir as readdir9, stat as stat6 } from "fs/promises";
-import path29 from "path";
+import path30 from "path";
 import { defineCommand as defineCommand157 } from "citty";
 
 // src/engine/landing/lib/constants.ts
@@ -42580,13 +43007,13 @@ function describeCounts(findings) {
 
 // src/commands/landing/snapshot.ts
 import { mkdir as mkdir9, rename as rename2, writeFile as writeFile13 } from "fs/promises";
-import path27 from "path";
+import path28 from "path";
 var CRITIC_VERSION = "2";
 function critiqueCacheDir(projectRoot) {
-  return path27.join(projectRoot, ".cache", "landing-critique");
+  return path28.join(projectRoot, ".cache", "landing-critique");
 }
 function snapshotPath(projectRoot, slug) {
-  return path27.join(critiqueCacheDir(projectRoot), `${slug}.json`);
+  return path28.join(critiqueCacheDir(projectRoot), `${slug}.json`);
 }
 async function writeCritiqueSnapshot(projectRoot, snapshot) {
   await mkdir9(critiqueCacheDir(projectRoot), { recursive: true });
@@ -42598,21 +43025,21 @@ async function writeCritiqueSnapshot(projectRoot, snapshot) {
 }
 
 // src/commands/landing/source-version.ts
-import { readdir as readdir8, readFile as readFile22, stat as stat5 } from "fs/promises";
-import path28 from "path";
+import { readdir as readdir8, readFile as readFile23, stat as stat5 } from "fs/promises";
+import path29 from "path";
 async function landingSourceRelPaths(landingDir) {
   const rel = [];
-  if (await isFile(path28.join(landingDir, "index.astro"))) rel.push("index.astro");
-  const componentsDir = path28.join(landingDir, "_components");
+  if (await isFile(path29.join(landingDir, "index.astro"))) rel.push("index.astro");
+  const componentsDir = path29.join(landingDir, "_components");
   for (const abs of await walkAstro(componentsDir)) {
-    rel.push(path28.relative(landingDir, abs).split(path28.sep).join("/"));
+    rel.push(path29.relative(landingDir, abs).split(path29.sep).join("/"));
   }
   return rel.sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
 }
 async function readLandingSources(landingDir) {
   const rel = await landingSourceRelPaths(landingDir);
   const out = [];
-  for (const r of rel) out.push({ path: r, text: await readFile22(path28.join(landingDir, r), "utf8") });
+  for (const r of rel) out.push({ path: r, text: await readFile23(path29.join(landingDir, r), "utf8") });
   return out;
 }
 async function computeLandingSourceSha(landingDir) {
@@ -42621,7 +43048,7 @@ async function computeLandingSourceSha(landingDir) {
   for (const r of rel) {
     let bytes;
     try {
-      bytes = await readFile22(path28.join(landingDir, r));
+      bytes = await readFile23(path29.join(landingDir, r));
     } catch {
       bytes = Buffer.alloc(0);
     }
@@ -42645,7 +43072,7 @@ async function walkAstro(dir) {
   }
   const out = [];
   for (const entry of entries) {
-    const abs = path28.join(dir, entry.name);
+    const abs = path29.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...await walkAstro(abs));
     else if (entry.isFile() && entry.name.endsWith(".astro")) out.push(abs);
   }
@@ -42706,7 +43133,7 @@ var critiqueCommand2 = defineCommand157({
           { availableSlugs: await listLandingSlugs(projectRoot) }
         );
       }
-      if (!await isDir(path29.resolve(projectRoot, "src", "pages", slug))) {
+      if (!await isDir(path30.resolve(projectRoot, "src", "pages", slug))) {
         fail5("NOT_FOUND", `No landing at src/pages/${slug}/`, {
           availableSlugs: await listLandingSlugs(projectRoot)
         });
@@ -42745,7 +43172,7 @@ var critiqueCommand2 = defineCommand157({
   }
 });
 async function critiqueOne(projectRoot, slug, brand) {
-  const landingDir = path29.resolve(projectRoot, "src", "pages", slug);
+  const landingDir = path30.resolve(projectRoot, "src", "pages", slug);
   const [sources, sourceSha] = await Promise.all([readLandingSources(landingDir), computeLandingSourceSha(landingDir)]);
   const report = critiqueLanding({ slug, sources, brand });
   let snapshotFailed = false;
@@ -42765,7 +43192,7 @@ async function critiqueOne(projectRoot, slug, brand) {
 }
 async function listLandingSlugs(projectRoot) {
   try {
-    const entries = await readdir9(path29.join(projectRoot, "src", "pages"), { withFileTypes: true });
+    const entries = await readdir9(path30.join(projectRoot, "src", "pages"), { withFileTypes: true });
     return entries.filter((e) => e.isDirectory() && !e.name.startsWith("_") && !e.name.startsWith(".")).map((e) => e.name).sort();
   } catch {
     return [];
@@ -42917,7 +43344,7 @@ var addCommand = defineCommand158({
 
 // src/commands/landing/inspiration/code.ts
 import { mkdir as mkdir10, writeFile as writeFile14 } from "fs/promises";
-import path30 from "path";
+import path31 from "path";
 import { defineCommand as defineCommand159 } from "citty";
 registerSchema({
   command: "landing.inspiration.code",
@@ -42940,9 +43367,9 @@ var codeCommand = defineCommand159({
     try {
       const id = args.id;
       const data = await apiGet("/api/landing-inspiration/section-code", { id });
-      const dir = path30.join(process.cwd(), ".baker", "inspiration", id);
+      const dir = path31.join(process.cwd(), ".baker", "inspiration", id);
       await mkdir10(dir, { recursive: true });
-      const file = path30.join(dir, "section.html");
+      const file = path31.join(dir, "section.html");
       await writeFile14(file, data.html);
       const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
       const fidelity = fidelityHint(data.fidelity);
@@ -42952,7 +43379,7 @@ var codeCommand = defineCommand159({
         ok: true,
         data: {
           id,
-          file: path30.relative(process.cwd(), file),
+          file: path31.relative(process.cwd(), file),
           bytes: data.html.length,
           fidelity: data.fidelity,
           reproduction_notes: data.reproductionNotes,
@@ -43384,7 +43811,7 @@ function classifyCaptureFailure(error) {
 
 // src/engine/landing-library/run.ts
 import { mkdir as mkdir11, writeFile as writeFile16 } from "fs/promises";
-import path32 from "path";
+import path33 from "path";
 
 // ../proxy/src/preflight.ts
 import http from "http";
@@ -43614,7 +44041,7 @@ ${used.inheritedSeed}
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Section from ${escapeHtml2(extracted.host)}</title>
+<title>Section from ${escapeHtml3(extracted.host)}</title>
 <style>
 ${css}
 </style>
@@ -43626,7 +44053,7 @@ ${wrapInLayoutContext(extracted.html, extracted.layoutContext)}
 `;
   return { html, css, assetUrls: extracted.assetUrls, stats: used.stats };
 }
-function escapeHtml2(value) {
+function escapeHtml3(value) {
   return value.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c] ?? c);
 }
 var SECTION_ROOT_ATTRIBUTE = "data-baker-section-root";
@@ -44800,13 +45227,13 @@ async function renderBundleToPng(browser, html, viewportWidth, options = {}) {
 
 // src/engine/landing-library/report.ts
 import { writeFile as writeFile15 } from "fs/promises";
-import path31 from "path";
+import path32 from "path";
 async function writeCaptureReport(manifest, outDir) {
-  const file = path31.join(outDir, "report.html");
+  const file = path32.join(outDir, "report.html");
   await writeFile15(file, renderReport(manifest));
   return file;
 }
-function escapeHtml3(value) {
+function escapeHtml4(value) {
   return value.replace(
     /[&<>"']/g,
     (character) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[character] ?? character
@@ -44831,18 +45258,18 @@ function renderSection3(section) {
   const shot = (label, src, note) => {
     if (!src) return `<figure class="shot empty"><figcaption>${label} \u2014 none</figcaption></figure>`;
     return `<figure class="shot">
-        <figcaption>${label}${note ? ` <span class="note">${escapeHtml3(note)}</span>` : ""}</figcaption>
-        <a href="${escapeHtml3(src)}" target="_blank" rel="noopener"><img src="${escapeHtml3(src)}" alt="" loading="lazy"></a>
+        <figcaption>${label}${note ? ` <span class="note">${escapeHtml4(note)}</span>` : ""}</figcaption>
+        <a href="${escapeHtml4(src)}" target="_blank" rel="noopener"><img src="${escapeHtml4(src)}" alt="" loading="lazy"></a>
       </figure>`;
   };
   return `<section class="card">
     <header>
       <h2><span class="index">${String(section.index).padStart(2, "0")}</span> ${section.rect.width}\xD7${section.rect.height}</h2>
       <span class="badge ${tone}">fidelity ${formatFidelity(section.fidelity)}</span>
-      ${section.fidelityNote ? `<span class="badge warn">${escapeHtml3(section.fidelityNote)}</span>` : ""}
-      ${section.motion.hasMotion ? `<span class="badge motion">${escapeHtml3(section.motion.summary)}</span>` : ""}
+      ${section.fidelityNote ? `<span class="badge warn">${escapeHtml4(section.fidelityNote)}</span>` : ""}
+      ${section.motion.hasMotion ? `<span class="badge motion">${escapeHtml4(section.motion.summary)}</span>` : ""}
     </header>
-    <p class="preview">${escapeHtml3(section.textPreview.slice(0, 220)) || "<em>no text</em>"}</p>
+    <p class="preview">${escapeHtml4(section.textPreview.slice(0, 220)) || "<em>no text</em>"}</p>
     <div class="shots">
       ${shot("Live", section.desktopShot)}
       ${shot("Reproduction", rendered, "rendered from the extracted bundle")}
@@ -44850,8 +45277,8 @@ function renderSection3(section) {
     </div>
     ${section.motionFilmstrip ? `<div class="filmstrip">${shot("Motion \u2014 six frames, left to right", section.motionFilmstrip)}</div>` : ""}
     <footer>
-      <code>${escapeHtml3(section.selector)}</code>
-      ${section.bundle ? `<a href="${escapeHtml3(section.bundle)}" target="_blank" rel="noopener">open the standalone bundle \u2192</a>` : ""}
+      <code>${escapeHtml4(section.selector)}</code>
+      ${section.bundle ? `<a href="${escapeHtml4(section.bundle)}" target="_blank" rel="noopener">open the standalone bundle \u2192</a>` : ""}
     </footer>
   </section>`;
 }
@@ -44863,7 +45290,7 @@ function renderReport(manifest) {
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Capture report \u2014 ${escapeHtml3(manifest.title || manifest.url)}</title>
+<title>Capture report \u2014 ${escapeHtml4(manifest.title || manifest.url)}</title>
 <style>
   :root { color-scheme: light dark; --line: #e5e7eb; --muted: #6b7280; --bg: #fafafa; --card: #fff; }
   @media (prefers-color-scheme: dark) {
@@ -44905,8 +45332,8 @@ function renderReport(manifest) {
 </style>
 </head>
 <body>
-<h1>${escapeHtml3(manifest.title || "Capture report")}</h1>
-<p class="sub"><a href="${escapeHtml3(manifest.finalUrl)}" target="_blank" rel="noopener">${escapeHtml3(manifest.finalUrl)}</a> \xB7 captured ${escapeHtml3(manifest.capturedAt)}</p>
+<h1>${escapeHtml4(manifest.title || "Capture report")}</h1>
+<p class="sub"><a href="${escapeHtml4(manifest.finalUrl)}" target="_blank" rel="noopener">${escapeHtml4(manifest.finalUrl)}</a> \xB7 captured ${escapeHtml4(manifest.capturedAt)}</p>
 
 <div class="stats">
   <div class="stat"><b>${manifest.sections.length}</b><span>sections</span></div>
@@ -44981,32 +45408,32 @@ async function reproducePage(args) {
   const { browser, page, outDir, pageUrl, livePageShot } = args;
   const built = await buildSectionBundle(page, "body", pageUrl).catch(() => null);
   if (!built) return { bundle: null, fidelity: null };
-  await writeFile16(path32.join(outDir, "page.html"), built.html);
+  await writeFile16(path33.join(outDir, "page.html"), built.html);
   const rendered = await renderBundleToPng(browser, built.html, DESKTOP_VIEWPORT.width, {
     wholePage: true,
     timeoutMs: 6e4
   });
   if (!rendered || !livePageShot) return { bundle: "page.html", fidelity: null };
-  await writeFile16(path32.join(outDir, "page-rendered.png"), rendered);
+  await writeFile16(path33.join(outDir, "page-rendered.png"), rendered);
   const { score, note } = await scoreFidelity(livePageShot, rendered);
   return { bundle: "page.html", fidelity: score, ...note ? { fidelityNote: note } : {} };
 }
 async function captureOneSection(args) {
   const { browser, page, candidate, sectionsDir, outDir, pageUrl, withCode } = args;
-  const dir = path32.join(sectionsDir, String(candidate.index).padStart(2, "0"));
+  const dir = path33.join(sectionsDir, String(candidate.index).padStart(2, "0"));
   await mkdir11(dir, { recursive: true });
   const desktop = await captureSection(page, candidate);
-  if (desktop) await writeFile16(path32.join(dir, "desktop.png"), desktop);
+  if (desktop) await writeFile16(path33.join(dir, "desktop.png"), desktop);
   const visualHash = desktop ? await perceptualHash(desktop) : null;
   const motion = await collectMotion(page, candidate.selector);
   const built = withCode ? await buildSectionBundle(page, candidate.selector, pageUrl) : null;
   let fidelity = null;
   let fidelityNote;
   if (built) {
-    await writeFile16(path32.join(dir, "section.html"), built.html);
+    await writeFile16(path33.join(dir, "section.html"), built.html);
     const rendered = await renderBundleToPng(browser, built.html, DESKTOP_VIEWPORT.width);
     if (rendered && desktop) {
-      await writeFile16(path32.join(dir, "section-rendered.png"), rendered);
+      await writeFile16(path33.join(dir, "section-rendered.png"), rendered);
       const result = await scoreFidelity(desktop, rendered);
       fidelity = result.score;
       fidelityNote = result.note;
@@ -45014,9 +45441,9 @@ async function captureOneSection(args) {
   }
   return {
     ...candidate,
-    desktopShot: desktop ? path32.relative(outDir, path32.join(dir, "desktop.png")) : null,
+    desktopShot: desktop ? path33.relative(outDir, path33.join(dir, "desktop.png")) : null,
     mobileShot: null,
-    bundle: built ? path32.relative(outDir, path32.join(dir, "section.html")) : null,
+    bundle: built ? path33.relative(outDir, path33.join(dir, "section.html")) : null,
     fidelity,
     ...fidelityNote ? { fidelityNote } : {},
     ...built ? { cssStats: built.stats } : {},
@@ -45035,9 +45462,9 @@ async function captureMobileShots(args) {
     for (const section of sections) {
       const shot = await captureSectionOnMobile(mobile.page, section);
       if (!shot) continue;
-      const file = path32.join(sectionsDir, String(section.index).padStart(2, "0"), "mobile.png");
+      const file = path33.join(sectionsDir, String(section.index).padStart(2, "0"), "mobile.png");
       await writeFile16(file, shot);
-      section.mobileShot = path32.relative(outDir, file);
+      section.mobileShot = path33.relative(outDir, file);
     }
   } finally {
     await mobile.context.close();
@@ -45052,10 +45479,10 @@ async function captureMotionTakes(args) {
   const filmOne = async (section) => {
     const take = await captureMotionTake(browser, pageUrl, section.selector).catch(() => null);
     if (!take) return;
-    const dir = path32.join(sectionsDir, String(section.index).padStart(2, "0"));
-    const file = path32.join(dir, "motion-filmstrip.png");
+    const dir = path33.join(sectionsDir, String(section.index).padStart(2, "0"));
+    const file = path33.join(dir, "motion-filmstrip.png");
     await writeFile16(file, take.filmstrip);
-    section.motionFilmstrip = path32.relative(outDir, file);
+    section.motionFilmstrip = path33.relative(outDir, file);
     log(`  [${section.index}] ${section.motion.summary}`);
   };
   const queue = [...moving];
@@ -45112,7 +45539,7 @@ async function captureAlternateViews(args) {
 async function reproduceWholePage(args) {
   const { browser, page, outDir, pageUrl, withCode, log } = args;
   const fullPage = await page.screenshot({ type: "png", fullPage: true }).catch(() => null);
-  if (fullPage) await writeFile16(path32.join(outDir, "full-page.png"), fullPage);
+  if (fullPage) await writeFile16(path33.join(outDir, "full-page.png"), fullPage);
   if (!withCode) return { bundle: null, fidelity: null };
   const reproduction = await reproducePage({ browser, page, outDir, pageUrl, livePageShot: fullPage });
   log(`page reproduction: ${reproduction.fidelity === null ? "unavailable" : reproduction.fidelity.toFixed(2)}`);
@@ -45183,7 +45610,7 @@ async function openViaLadder(args) {
 async function scrapeLanding(options) {
   const timeoutMs = options.timeoutMs ?? 45e3;
   const log = options.onProgress ?? (() => void 0);
-  const sectionsDir = path32.join(options.outDir, "sections");
+  const sectionsDir = path33.join(options.outDir, "sections");
   const nonPublic = refuseNonPublicUrl(options.url);
   if (nonPublic) {
     throw new BlockedPageError({
@@ -45245,7 +45672,7 @@ async function scrapeLanding(options) {
       security: prepared.security,
       captureTier: tier
     };
-    await writeFile16(path32.join(options.outDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
+    await writeFile16(path33.join(options.outDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
 `);
     if (options.report !== false) {
       const reportPath = await writeCaptureReport(manifest, options.outDir);
@@ -45260,28 +45687,28 @@ async function scrapeLanding(options) {
 
 // src/commands/landing/inspiration/captureOut.ts
 import { existsSync as existsSync9 } from "fs";
-import path33 from "path";
+import path34 from "path";
 var SCRATCH_DIR = ".baker";
 function isWithin(parent, target) {
-  const relative = path33.relative(parent, target);
-  return relative === "" || !relative.startsWith("..") && !path33.isAbsolute(relative);
+  const relative = path34.relative(parent, target);
+  return relative === "" || !relative.startsWith("..") && !path34.isAbsolute(relative);
 }
 function findRepoRoot(from) {
-  let dir = path33.resolve(from);
+  let dir = path34.resolve(from);
   for (; ; ) {
-    if (existsSync9(path33.join(dir, ".git"))) return dir;
-    const parent = path33.dirname(dir);
+    if (existsSync9(path34.join(dir, ".git"))) return dir;
+    const parent = path34.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
 }
 function checkCaptureOut(out, options) {
   const { cwd, repoRoot } = options;
-  const resolved = path33.resolve(cwd, out);
+  const resolved = path34.resolve(cwd, out);
   if (repoRoot === null || !isWithin(repoRoot, resolved)) return { ok: true };
-  const scratch = path33.join(repoRoot, SCRATCH_DIR);
+  const scratch = path34.join(repoRoot, SCRATCH_DIR);
   if (isWithin(scratch, resolved)) return { ok: true };
-  const suggestion = path33.posix.join(SCRATCH_DIR, "teardowns", path33.basename(resolved) || "capture");
+  const suggestion = path34.posix.join(SCRATCH_DIR, "teardowns", path34.basename(resolved) || "capture");
   return {
     ok: false,
     error: {
@@ -45455,12 +45882,12 @@ var scrapeCommand = defineCommand162({
 });
 
 // src/commands/landing/inspiration/search.ts
-import path35 from "path";
+import path36 from "path";
 import { defineCommand as defineCommand163 } from "citty";
 
 // src/commands/landing/inspiration/shot.ts
 import { mkdir as mkdir12, writeFile as writeFile17 } from "fs/promises";
-import path34 from "path";
+import path35 from "path";
 import sharp6 from "sharp";
 var READABLE_SHOT = {
   maxWidth: 1440,
@@ -45486,9 +45913,9 @@ async function downloadReadableShot(url, file) {
     const response = await fetch(url);
     if (!response.ok) return null;
     const shot = await toReadableShot(Buffer.from(await response.arrayBuffer()));
-    await mkdir12(path34.dirname(file), { recursive: true });
+    await mkdir12(path35.dirname(file), { recursive: true });
     await writeFile17(file, shot);
-    return path34.relative(process.cwd(), file);
+    return path35.relative(process.cwd(), file);
   } catch {
     return null;
   }
@@ -45580,13 +46007,13 @@ function buildSearchBody(args) {
   return body;
 }
 async function downloadShots(results) {
-  const dir = path35.join(process.cwd(), ".baker", "inspiration");
+  const dir = path36.join(process.cwd(), ".baker", "inspiration");
   const saved = /* @__PURE__ */ new Map();
   await Promise.all(
     results.map(async (result) => {
       const file = await downloadReadableShot(
         result.desktopShotUrl,
-        path35.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
+        path36.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
       );
       if (file) saved.set(result.id, file);
     })
@@ -45814,7 +46241,7 @@ var sequencesCommand = defineCommand164({
 });
 
 // src/commands/landing/inspiration/view.ts
-import path36 from "path";
+import path37 from "path";
 import { defineCommand as defineCommand165 } from "citty";
 registerSchema({
   command: "landing.inspiration.view",
@@ -45847,12 +46274,12 @@ var viewCommand2 = defineCommand165({
       const id = args.id;
       const data = await apiGet("/api/landing-inspiration/section", { id });
       const section = data.section;
-      const dir = path36.join(process.cwd(), ".baker", "inspiration", id);
+      const dir = path37.join(process.cwd(), ".baker", "inspiration", id);
       const ext = READABLE_SHOT.extension;
       const [desktop, mobile, filmstrip] = await Promise.all([
-        downloadReadableShot(section.desktopShotUrl, path36.join(dir, `desktop.${ext}`)),
-        downloadReadableShot(section.mobileShotUrl, path36.join(dir, `mobile.${ext}`)),
-        downloadReadableShot(section.motionFilmstripUrl, path36.join(dir, `motion-filmstrip.${ext}`))
+        downloadReadableShot(section.desktopShotUrl, path37.join(dir, `desktop.${ext}`)),
+        downloadReadableShot(section.mobileShotUrl, path37.join(dir, `mobile.${ext}`)),
+        downloadReadableShot(section.motionFilmstripUrl, path37.join(dir, `motion-filmstrip.${ext}`))
       ]);
       const full = args.full;
       const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
@@ -47701,8 +48128,8 @@ var listCommand15 = defineCommand184({
 });
 
 // src/commands/scheduled-actions/templates.ts
-import { readFile as readFile23 } from "fs/promises";
-import path37 from "path";
+import { readFile as readFile24 } from "fs/promises";
+import path38 from "path";
 import { defineCommand as defineCommand185 } from "citty";
 registerSchema({
   command: "scheduled-actions.templates",
@@ -47805,7 +48232,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
       }
       if (save.length > 0) {
         const briefFile = flag("brief-file");
-        const brief = briefFile.length > 0 ? await readFile23(path37.resolve(briefFile), "utf8") : flag("brief");
+        const brief = briefFile.length > 0 ? await readFile24(path38.resolve(briefFile), "utf8") : flag("brief");
         if (brief.trim().length === 0) {
           failValidation4("--brief-file (preferred) or --brief is required: the brief is the recipe.");
         }
@@ -48276,7 +48703,7 @@ function parseImageRefs(spec) {
 }
 var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path39) => uploadLocalImage({ file: path39, contentType: detectImageContentType(path39), source: "uploaded" })
+  upload: (path40) => uploadLocalImage({ file: path40, contentType: detectImageContentType(path40), source: "uploaded" })
 };
 async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
@@ -48296,10 +48723,10 @@ async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   }
   return { imageIds, added };
 }
-function uploadFailure(path39) {
+function uploadFailure(path40) {
   return (error) => {
     if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path39}" as an image.`);
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path40}" as an image.`);
   };
 }
 
@@ -49371,10 +49798,10 @@ async function stageOp4(op) {
     handleError5(err);
   }
 }
-async function draftAction3(path39, body, chat) {
+async function draftAction3(path40, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path39, { chatId, ...body });
+    const data = await apiPost(path40, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -50479,9 +50906,9 @@ var groupCommand2 = defineCommand210({
 });
 
 // src/commands/videos/ingest.ts
-import { mkdtemp as mkdtemp2, rm as rm7, stat as stat7 } from "fs/promises";
-import { tmpdir as tmpdir3 } from "os";
-import path38 from "path";
+import { mkdtemp as mkdtemp3, rm as rm8, stat as stat7 } from "fs/promises";
+import { tmpdir as tmpdir4 } from "os";
+import path39 from "path";
 import { defineCommand as defineCommand211 } from "citty";
 
 // src/lib/streamUpload.ts
@@ -50832,7 +51259,7 @@ function ingestUrl(args) {
 }
 async function downloadThenIngest(args, country) {
   const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp2(path38.join(tmpdir3(), "videos-ingest-"));
+  const workDir = await mkdtemp3(path39.join(tmpdir4(), "videos-ingest-"));
   try {
     const probe = await probeYtDlp({ url: args.url, country, vimeoCookie, cookieDir: workDir });
     if (isAudioOnly(probe.info)) {
@@ -50889,7 +51316,7 @@ async function downloadThenIngest(args, country) {
       ...reducedQuality ? { reducedQuality: true } : {}
     };
   } finally {
-    await rm7(workDir, { recursive: true, force: true }).catch(() => {
+    await rm8(workDir, { recursive: true, force: true }).catch(() => {
     });
   }
 }
@@ -50968,7 +51395,7 @@ var searchCommand4 = defineCommand212({
 var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 
 // src/commands/videos/upload.ts
-import { readFile as readFile24, stat as stat8 } from "fs/promises";
+import { readFile as readFile25, stat as stat8 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
 import { defineCommand as defineCommand213 } from "citty";
 var MIME_MAP = {
@@ -51065,7 +51492,7 @@ var uploadCommand2 = defineCommand213({
         originalFilename,
         descriptionContext
       });
-      const fileBuffer = await readFile24(filePath);
+      const fileBuffer = await readFile25(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -52452,7 +52879,7 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion) {
   };
 }
 function commandPathOf(root, argv) {
-  const path39 = [];
+  const path40 = [];
   let command = root;
   for (const token of argv) {
     if (token === "--" || token.startsWith("-")) {
@@ -52463,10 +52890,10 @@ function commandPathOf(root, argv) {
     if (next === void 0 || typeof next !== "object") {
       break;
     }
-    path39.push(token);
+    path40.push(token);
     command = next;
   }
-  return path39.join(" ");
+  return path40.join(" ");
 }
 function refuseUnknownFlags(root, argv) {
   const unknown = findUnknownFlags(root, argv);