@koda-sl/baker-cli 0.270.1-dev.1f1c09c80 → 0.272.0-dev.1f1c09c80

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-SZJWEOW2.js";
+} from "./chunk-4IJX4R4J.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -27320,6 +27320,17 @@ var RecurringElement = z27.object({
    * slot emits a TODO for somebody to drop one by hand.
    */
   source_image: z27.string().optional(),
+  /**
+   * The supplied picture is ALREADY a multi-view reference sheet, so no sheet is
+   * built from it.
+   *
+   * A cast Avatar's identity sheet is exactly that: a rendered turnaround of one
+   * person, which is what `buildElementSheets` exists to produce. Fanning it into a
+   * second sheet paid for an image generation to make a generation of a generation,
+   * and every frame then grounded on the copy rather than on the avatar's own
+   * identity — which is the drift the sheet is supposed to prevent.
+   */
+  source_is_sheet: z27.boolean().optional(),
   // Scenes the element appears in. Either a bare list of scene indices (both
   // edges) or per-{scene,edge} entries. Both forms are accepted and merged.
   scenes: z27.array(z27.number()).optional(),
@@ -27493,6 +27504,7 @@ function buildElementSlots(elements) {
       description: el.description,
       sameAs: el.same_as ?? void 0,
       castId: el.cast_id ?? void 0,
+      sourceIsSheet: el.source_is_sheet === true,
       presence: presenceOf(el)
     });
   });
@@ -27536,8 +27548,12 @@ var SHEET_SUBJECT_TYPE = {
   product: "product",
   location: "location"
 };
-function buildElementSheets(slots, nodes) {
+function buildElementSheets(slots, nodes, sheetModel) {
   for (const slot of slots) {
+    if (slot.sourceIsSheet) {
+      slot.sheetBacked = true;
+      continue;
+    }
     const subjectType = SHEET_SUBJECT_TYPE[slot.type.toLowerCase()];
     if (!subjectType) continue;
     if (slot.sameAs) continue;
@@ -27551,7 +27567,7 @@ function buildElementSheets(slots, nodes) {
       // The lone dropped ingest is the source; the sheet fans it into a turnaround.
       inputs: { references: [slot.ref] },
       params: {
-        model: ACTOR_SHEET_MODEL,
+        model: sheetModel ?? ACTOR_SHEET_MODEL,
         // The clean-plate clause mirrors the frame prompts' CLEAN PLATE block: a sheet
         // that comes back with a fake camera app baked in (P2-22) poisons EVERY frame
         // grounded on it, so the suppression must live on the sheet too.
@@ -29616,7 +29632,7 @@ function scaffoldVideoCanvas(input, elementsInput, opts) {
       }
     });
   });
-  buildElementSheets(slots, nodes);
+  buildElementSheets(slots, nodes, opts.sheetModel);
   const { clips, voTracks, vo_segments, talking_scenes, routes } = buildTimeline(blueprint, slots, opts, nodes);
   const outAspect = resolveAspect(blueprint.source?.aspect_ratio, opts.aspect, genAspectsFor(opts.videoModel));
   let videoRef = buildSpine(clips, opts.seamDedup ?? "head", canvasDims(outAspect.outAr), nodes);
@@ -30515,10 +30531,10 @@ function runDirsToPrune(entries, keep, currentRunId) {
   return runs.slice(0, Math.max(0, runs.length - keep));
 }
 async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
-  const { readdir: readdir11 } = await import("fs/promises");
+  const { readdir: readdir12 } = await import("fs/promises");
   let entries;
   try {
-    entries = await readdir11(outputsDir);
+    entries = await readdir12(outputsDir);
   } catch {
     return;
   }
@@ -30811,7 +30827,7 @@ async function restoreRunSnapshot(manifest, targetDir, opts = {}) {
 
 // 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 { mkdtemp, readdir as readdir6, readFile as readFile11, rm as rm5 } from "fs/promises";
 import { tmpdir } from "os";
 import path15 from "path";
 import { promisify as promisify2 } from "util";
@@ -30819,6 +30835,9 @@ import { z as z28 } from "zod";
 var RENDER_REVIEW_MODEL = "gemini-pro-latest";
 var RENDER_REVIEW_FRAMES = 12;
 var RENDER_REVIEW_WIDTH = 1024;
+function sceneAt(windows, atS) {
+  return windows.find((w) => atS >= w.startS && atS < w.endS)?.file;
+}
 function reviewFrameTimes(durationS, frames) {
   const n = Math.max(2, frames);
   const last = Math.max(0, durationS - 0.15);
@@ -30921,19 +30940,23 @@ function collapseRepeats(frames) {
   }
   return [...seen.values()];
 }
-function classifyFrameFindings(frames) {
+function classifyFrameFindings(frames, windows = []) {
   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}`
-  }));
+  const findings = rest.map((f) => {
+    const scene = sceneAt(windows, f.at[0]);
+    return {
+      severity: "blocking",
+      what: `At ${f.at.map((s) => `${s}s`).join(", ")}${scene ? ` (${scene})` : ""}: ${f.what}`,
+      ...scene ? { scene } : {}
+    };
+  });
   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.`
+      what: `Malformed hands or limbs in ${at.length} of ${frames.length} sampled frames (${at.map((s) => `${s}s${sceneAt(windows, s) ? ` \u2192 ${sceneAt(windows, 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;
@@ -31058,7 +31081,7 @@ async function reviewRenderedVideo(opts) {
     }));
     const unread = perFrame.filter((f) => f.json === null).length;
     if (unread === perFrame.length && reel === null) return null;
-    const findings = [...classifyFrameFindings(perFrame), ...classifyReelFindings(reel)];
+    const findings = [...classifyFrameFindings(perFrame, opts.windows ?? []), ...classifyReelFindings(reel)];
     if (unread > 0) {
       findings.push({
         severity: "warning",
@@ -31070,6 +31093,24 @@ async function reviewRenderedVideo(opts) {
     await rm5(dir, { recursive: true, force: true });
   }
 }
+async function sceneWindowsBeside(canvasPath) {
+  const dir = path15.join(path15.dirname(canvasPath), "scenes");
+  const files = await readdir6(dir).catch(() => null);
+  if (!files) return [];
+  const windows = [];
+  for (const name of files.filter((f) => f.endsWith(".json")).sort()) {
+    const raw = await readFile11(path15.join(dir, name), "utf-8").catch(() => null);
+    if (!raw) continue;
+    try {
+      const scene = JSON.parse(raw);
+      if (typeof scene.start_s === "number" && typeof scene.end_s === "number") {
+        windows.push({ file: `scenes/${name}`, startS: scene.start_s, endS: scene.end_s });
+      }
+    } catch {
+    }
+  }
+  return windows;
+}
 
 // src/commands/canvas/run.ts
 var runCommand = defineCommand100({
@@ -31357,10 +31398,13 @@ ${describeRewrites(healed.rewrites)}
 `));
     }
     const reviewable = videoPathFromOutput(result.output);
-    const review = reviewable ? await reviewRenderedVideo({ video: reviewable }) : null;
+    const review = reviewable ? await reviewRenderedVideo({ video: reviewable, windows: await sceneWindowsBeside(filePath) }) : 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}`)
+      ...review.map((f) => `${f.severity === "blocking" ? "MUST FIX" : "SHOULD FIX"} \u2014 ${f.what}`),
+      ...review.some((f) => f.scene) ? [
+        `Fix them, then re-run: edit the \`show\` of the scene files named above \u2014 a shot with a person handling equipment is where limbs and objects go wrong, so widen it, move the hands out of frame, or drop the person from that beat. Re-running re-renders ONLY the scenes you edited; everything else comes from the cache (this run: ${result.stats?.cached_nodes ?? 0} of ${result.stats?.total_nodes ?? 0} nodes were cached).`
+      ] : []
     ] : [];
     process.stdout.write(
       `${JSON.stringify(
@@ -31905,7 +31949,7 @@ function isValidScaffoldSlug(slug) {
 }
 
 // src/commands/canvas/sync-definition.ts
-import { readdir as readdir6, readFile as readFile13, stat as stat3 } from "fs/promises";
+import { readdir as readdir7, readFile as readFile13, stat as stat3 } from "fs/promises";
 import path20 from "path";
 import { defineCommand as defineCommand102 } from "citty";
 
@@ -32011,7 +32055,7 @@ async function resolveCanvasPath(inputPath) {
   }
   let entries;
   try {
-    entries = await readdir6(dir);
+    entries = await readdir7(dir);
   } catch {
     return null;
   }
@@ -32658,14 +32702,25 @@ function adSpecCastElements(spec, avatar) {
   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 [];
   const sheet = avatar?.sheetUrl?.trim();
-  return [{ type: "person", label: "customer", description, scenes, ...sheet ? { source_image: sheet } : {} }];
+  return [
+    {
+      type: "person",
+      label: "customer",
+      description,
+      scenes,
+      // An avatar's identity sheet IS the turnaround the engine would otherwise render,
+      // so it is handed over as one. Left unmarked, the run paid to generate a sheet OF
+      // a sheet and every frame grounded on the copy instead of the avatar.
+      ...sheet ? { source_image: sheet, source_is_sheet: true } : {}
+    }
+  ];
 }
 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 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. Hands are kept simple: no close-up of fingers manipulating small parts, no hand gripping the edge of an object, and each person has exactly TWO arms and TWO legs, all attached and all visible or all out of frame. Anyone working does so the way the trade actually does it: nobody stands or kneels on the equipment being installed, nothing is fitted overhanging an edge or floating unsupported, and every part rests on the structure that would really carry it." + (currency ? ` If a currency is unavoidably visible it is ${currency}.` : "");
   const closesOnCard = endCardWanted(spec);
   let clock = 0;
   const scenes = spec.beats.map((beat, i) => {
@@ -32826,9 +32881,13 @@ function adBrandOverlayCss() {
     "      /* 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. */",
-    "      /* Declares its own family: rendered without one it inherited the document",
-    "         default and the call to action came out in Times, beside sans-serif captions. */",
-    "      .endcard-cta { font-family: 'BrandFont', 'Arial Black', 'Helvetica Neue', Arial, sans-serif;",
+    "      /* The SAME family the caption track uses, and only names the compiler maps.",
+    "         Declaring one matters \u2014 rendered without it the call to action inherited the",
+    "         document default and came out in Times beside sans-serif captions. But the",
+    "         first attempt led with 'BrandFont', which the overlay composition defines and",
+    "         the caption composition does not: HyperFrames refuses an unmapped family and",
+    "         the whole render died with `No deterministic font mapping for: BrandFont`. */",
+    "      .endcard-cta { font-family: 'Arial Black', 'Helvetica Neue', Arial, sans-serif;",
     "        font-size: 64px; font-weight: 900; text-transform: uppercase;",
     "        letter-spacing: 0.01em; color: #fff; padding: 28px 58px; border-radius: 56px;",
     "        max-width: 900px; line-height: 1.15; background: rgba(0,0,0,0.82); }"
@@ -32846,7 +32905,7 @@ function injectAdBrandOverlay(indexHtml, overlayHtml) {
 }
 
 // src/engine/scaffold/ad-brand-source.ts
-import { readdir as readdir7, readFile as readFile15 } from "fs/promises";
+import { readdir as readdir8, readFile as readFile15 } from "fs/promises";
 import path22 from "path";
 var BRAND_DIR = "src/brand";
 function paletteFromBrandDoc(markdown) {
@@ -32886,7 +32945,7 @@ async function readBrandFromWorkspace(root = ".") {
     if (palette.length > 0) found.palette = palette;
   }
   const dir = path22.join(root, BRAND_DIR, "logos");
-  const files = await readdir7(dir).catch(() => null);
+  const files = await readdir8(dir).catch(() => null);
   if (files) {
     const mark = pickBrandMark(files);
     if (mark) found.logo = path22.join(BRAND_DIR, "logos", mark);
@@ -33035,6 +33094,9 @@ var scaffoldAdCommand = defineCommand104({
     const logoPath = spec.data.brand?.logo?.trim();
     const opts = {
       imageModel: AD_IMAGE_MODEL,
+      // The sheet on the SAME model as the frames it feeds. A sheet from another
+      // generator hands every frame a look its own model then reinterprets.
+      sheetModel: AD_IMAGE_MODEL,
       videoModel: DEFAULT_VIDEO_GENERATE_MODEL,
       overlayCompositionPath: path24.relative(outDir, compositionDest),
       captionsCompositionPath: path24.relative(outDir, captionsDest),
@@ -33165,7 +33227,7 @@ function routeVideoModel(input) {
 
 // src/engine/nodes/local/lib/sceneDetect.ts
 import { execFile as execFile3 } from "child_process";
-import { mkdtemp as mkdtemp2, readdir as readdir8, readFile as readFile17, rm as rm6 } from "fs/promises";
+import { mkdtemp as mkdtemp2, readdir as readdir9, readFile as readFile17, rm as rm6 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join2 } from "path";
 import { promisify as promisify3 } from "util";
@@ -33239,7 +33301,7 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
       ],
       { encoding: "utf-8", maxBuffer: 32 * 1024 * 1024, timeout: timeoutMs }
     );
-    const csvName = (await readdir8(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
+    const csvName = (await readdir9(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
     if (!csvName) return [];
     return parsePySceneDetectCsvCuts(await readFile17(join2(outDir, csvName), "utf-8"));
   } finally {
@@ -42298,7 +42360,7 @@ Full guide: __tooling__/docs/tools/baker/images.md`
 import { defineCommand as defineCommand167 } from "citty";
 
 // src/commands/landing/critique.ts
-import { readdir as readdir10, stat as stat6 } from "fs/promises";
+import { readdir as readdir11, stat as stat6 } from "fs/promises";
 import path31 from "path";
 import { defineCommand as defineCommand157 } from "citty";
 
@@ -43285,7 +43347,7 @@ async function writeCritiqueSnapshot(projectRoot, snapshot) {
 }
 
 // src/commands/landing/source-version.ts
-import { readdir as readdir9, readFile as readFile24, stat as stat5 } from "fs/promises";
+import { readdir as readdir10, readFile as readFile24, stat as stat5 } from "fs/promises";
 import path30 from "path";
 async function landingSourceRelPaths(landingDir) {
   const rel = [];
@@ -43326,7 +43388,7 @@ async function isFile(p) {
 async function walkAstro(dir) {
   let entries;
   try {
-    entries = await readdir9(dir, { withFileTypes: true });
+    entries = await readdir10(dir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -43452,7 +43514,7 @@ async function critiqueOne(projectRoot, slug, brand) {
 }
 async function listLandingSlugs(projectRoot) {
   try {
-    const entries = await readdir10(path31.join(projectRoot, "src", "pages"), { withFileTypes: true });
+    const entries = await readdir11(path31.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 [];