@koda-sl/baker-cli 0.440.0-dev.dab0aaba9 → 0.443.0-dev.edb8d8767

package/README.md

@@ -5832,7 +5832,7 @@ offered, or, for a viewer who does not know the brand, when the words say they a
 cart, a trial, a donation, a registration); who it is for is reported but never fails an ad alone. The viewer is the `viewer` recorded in
 `_definition.md`, else the one its `targetAdSet` reaches (as `baker ads meta adsets --audience` reads it), else
 the persona and `awareness` from the Knowledge, else a cold stranger. Not understood → exit 2 with
-`viewer_check_failed` and a `fix` naming what the viewer missed. Answers are cached per copy, scene and viewer.
+`viewer_check_failed` and a `fix` that starts with the one rewrite answering a missed offer (`Do this: make the biggest words say "<message>"`) and names what the viewer missed. After two failures of one ad in a chat turn the check no longer holds it back: the command answers `ok: true` with `understood: false` and what was missed, and `baker canvas run` renders it, printing the miss. The casting check is asked alongside the viewer. Answers are cached per copy, scene and viewer.
 `baker canvas run` makes the same check on a static ad before it spends (skipped for `--fix`, an autofix round, `--use-variant`, a re-layout and resumed runs, never for an edit of the words;
 `--skip-viewer-check` renders without it; a model outage lets the render through with a warning). `--full` adds
 the viewer's whole answer and how the viewer was chosen.
@@ -5879,7 +5879,7 @@ A completed render the review calls ready (`verdict` `ready` or `ready_with_note
 
 **Resuming an interrupted run.** A long `baker canvas run` (multi-clip video) that is killed mid-render — session end, sandbox pause — leaves a marker under the outputs dir. The next `baker canvas run` of the same canvas automatically **resumes** that run: it reuses the run id so still-running billed jobs re-attach instead of being abandoned and re-billed, and completed nodes come from the cache. A live render keeps its marker's heartbeat fresh, so a second `run` of the same canvas is refused while it is alive (checked with `kill(pid, 0)` plus the heartbeat, on Linux and macOS alike). Resume also works from a **different workspace or a fresh sandbox**: when no local marker survives, the run history is consulted for a resumable run of the same source (canvas, `prompt.json`, scenes, compositions and formats), and it is adopted when the backend says it may be: interrupted, stopped at a checkpoint, or a `running` row whose keepalive is older than the backend's staleness threshold. Ctrl-C / SIGTERM aborts gracefully — no new nodes dispatch, a resumable snapshot is flushed, and the marker survives. A clean completion (or a handled failure) clears the marker, so a normal re-run starts a fresh generation. Force a new run with `--fresh`, or pin a specific run with `--run-id <id>` (also the escape hatch to adopt a run that is reported as concurrently live). Independent same-layer nodes (e.g. video clips) fan out in parallel up to `--parallel`/`--concurrency` (default 8; env `BAKER_CANVAS_CONCURRENCY`).
 
-**Static ads: the run corrects a blocking defect itself.** When the review of a static ad finds a blocking defect, `baker canvas run` makes up to 2 more renders (`AUTO_FIX_ROUNDS` in `static-autofix.ts`) before it reports, correcting each defect at the layer that causes it: words or a logo where an interface covers them (Reels, Stories) or the frame cuts them are **placed and extended** (`withExtendedSizes`): a `static_place` node reads where everything sits and shrinks the ad (to 60% at most) into the size's safe area, and a `static_extend_merge` node has the ad's own model paint only the margins that leaves and lays the ad's own pixels back over the painting, so the model is never asked to move anything (a size already inside its area is passed on with nothing painted or billed, and one whose words sit too far out for a shrink to clear is laid out again instead); a defect the spec asked for (a second subject, stars with no named source, a concept that does not read) and any defect of a native screen corrects the spec first (`static-spec-repair.ts`: a model rewrites `prompt.json` for those findings alone, every line of the copy kept word for word), then draws the ad again from it (a native screen redraws free); a picture wrong as a whole or in three places or more is made again from its brief, told what the last one got wrong, but only in a round with another after it unless the brief caused the defect; anything else on the picture is a `--fix` of the chosen picture for its own findings (`correctionOf`: the words to erase, the line to re-letter or add), naming what the last edit was already asked for, while each re-laid size follows as an edit of its own last layout (`withSizesFollowingFix`), keeping what an earlier round fixed in it; anything else on a re-laid size alone edits just that size from its own last layout (`withRelayEdit`). A size a round did not touch (its file the same byte for byte) keeps the round before's verdict (`carryUnchanged`), so the review's second look at the same pixels never counts as a new defect. Each round is one render (a fix, or one request per re-laid size) and prints `[autofix] round N of 2: …` on stdout; the final JSON's hints start with "Corrected automatically before this result, …" and its review is of the corrected version. Blocking findings left after the rounds keep the hints below. A round that would only repeat the correction that just left its defect in place (a chosen option, `--use-variant`, is only ever corrected) is not run: that version is reported as it is. `--no-autofix` reports after the first render.
+**Static ads: the run corrects a blocking defect itself.** When the review of a static ad finds a blocking defect, `baker canvas run` makes up to 2 more renders (`AUTO_FIX_ROUNDS` in `static-autofix.ts`) before it reports, correcting each defect at the layer that causes it: words or a logo where an interface covers them (Reels, Stories) or the frame cuts them are **placed and extended** (`withExtendedSizes`): a `static_place` node reads where everything sits and shrinks the ad (to 60% at most) into the size's safe area, and a `static_extend_merge` node has the ad's own model paint only the margins that leaves and lays the ad's own pixels back over the painting, so the model is never asked to move anything (a size already inside its area is passed on with nothing painted or billed, and one whose words sit too far out for a shrink to clear is laid out again instead); a defect the spec asked for (a second subject, stars with no named source, a concept that does not read) and any defect of a native screen corrects the spec first (`static-spec-repair.ts`: a model rewrites `prompt.json` for those findings alone, every line of the copy kept word for word), then draws the ad again from it (a native screen redraws free); a picture wrong as a whole or in three places or more is made again from its brief, told what the last one got wrong, but only in a round with another after it unless the brief caused the defect; anything else on the picture is a `--fix` of the chosen picture for its own findings (`correctionOf`: the words to erase, the line to re-letter or add), naming what the last edit was already asked for, while each re-laid size the review flagged follows as an edit of its own last layout (`withSizesFollowingFix`), keeping what an earlier round fixed in it, and a size it found nothing blocking on is delivered as it was (`keep`, nothing in it made again or placed); anything else on a re-laid size alone edits just that size from its own last layout (`withRelayEdit`). A size a round did not touch (its file the same byte for byte) keeps the round before's verdict (`carryUnchanged`) and is not read again: the review reads only the sizes the round changed. Each round is one render (a fix, or one request per re-laid size) and prints `[autofix] round N of 2: …` on stdout; the final JSON's hints start with "Corrected automatically before this result, …" and its review is of the corrected version. Blocking findings left after the rounds keep the hints below. A round that would only repeat the correction that just left its defect in place (a chosen option, `--use-variant`, is only ever corrected) is not run: that version is reported as it is. `--no-autofix` reports after the first render.
 
 **Static ads: correct a version, or use another of its variants.** Correct a finished version with `--fix "<what to change>"`: one render takes that version (the last one, or `--from <run_id>`) as its first reference and changes only what you said, keeping the picture, the layout and every other word; it replaces the variants and the judge, and every size is made again from the corrected picture. **A `prompt.json` changed only in its words, their positions or its colours** since the version shown is made the same way, as an edit of that version (`[edit]` in the output, the instruction read off the change); three new options are asked for only with `--regenerate static_variants`. A `--fix` whose defect is still blocking afterwards is recorded, and asking for it again with the same words exits 2 with `no_progress`. When every blocking finding is on re-laid-out sizes, the first hint says to lay out those sizes again (`--regenerate adapt_<size>`) before any `--fix`. Every static run's hints say what it cost in credits and what for. There is no render limit per creative. Use another variant with `--use-variant <sha256>` (`--from <run_id>`, default the last render): when the person chose another of a version's variants over the judge's pick, every size is made again from that picture, and the only requests re-lay it out for each other size; `--regenerate adapt_9x16` lays out one size again from the same chosen picture when only that size came out wrong (after a `--fix` or `--use-variant`, from that corrected or chosen picture, so the size never brings back the uncorrected one; `--from <run_id>` names another version); `baker creatives feedback --slug <slug>` prints the choice (`variantChoice`) and the exact command.
 

package/dist/cli.js

@@ -73631,11 +73631,18 @@ function autoFixStep(canvas, review, opts = {}) {
     pictureFindings.filter((f) => !BRIEF.test(withoutSize(f.what))).flatMap((f) => correctionOf(f.what) ?? [])
   );
   if (changes.length === 0) return sizesOnly();
+  const flagged = new Set(blocking.flatMap((f) => sizesOf(f.what)));
+  const keep = relaid.map((r) => r.format).filter((format) => !flagged.has(format));
+  const remade = every.filter((size) => !keep.includes(size));
+  const kept = {
+    ...keep.length > 0 ? { keep } : {},
+    ...remade.length > 0 ? { extend: remade } : {}
+  };
   const asked = `Change only this: ${changes.join(" ")}`;
   const again = onPicture.filter((w) => persisting.has(w)).map((w) => w.replace(CATEGORY, "").replace(/\.$/, ""));
   const instruction = again.length > 0 ? `${asked} The last edit was already asked for this and Image 1 still shows it, so make it clearly: ${again.join("; ")}.` : asked;
   if (repeatsFailedFix(opts.lastFix, asked) || repeatsFailedFix(opts.lastFix, instruction)) return null;
-  return { kind: "fix", instruction, ...Object.keys(edits).length > 0 ? { relay: edits } : {}, ...afterNewPicture };
+  return { kind: "fix", instruction, ...Object.keys(edits).length > 0 ? { relay: edits } : {}, ...kept };
 }
 var unique = (lines) => [...new Set(lines)];
 function deliveredSizes(canvas) {
@@ -73936,19 +73943,19 @@ async function variantImage(canvasRoot, runId, sha2562, fetchRecord = fetchRunRe
 }
 
 // src/commands/canvas/static-run-review.ts
-import { readFile as readFile23 } from "fs/promises";
+import { readFile as readFile24 } from "fs/promises";
 
 // src/commands/canvas/glance-check.ts
 import sharp2 from "sharp";
-import { z as z65 } from "zod";
+import { z as z66 } from "zod";
 
 // src/commands/canvas/viewer-check.ts
 import { createHash as createHash4 } from "crypto";
-import { mkdir as mkdir8, readdir as readdir12, readFile as readFile22, stat as stat4, writeFile as writeFile13 } from "fs/promises";
-import path28 from "path";
+import { mkdir as mkdir9, readdir as readdir12, readFile as readFile23, stat as stat4, writeFile as writeFile14 } from "fs/promises";
+import path29 from "path";
 import { defineCommand as defineCommand138 } from "citty";
 import { parse as parseYaml3 } from "yaml";
-import { z as z64 } from "zod";
+import { z as z65 } from "zod";
 
 // src/commands/canvas/unbilled-spend.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -74082,17 +74089,76 @@ function castingCheckFailure(answer, slug) {
   };
 }
 
+// src/commands/canvas/turn-renders.ts
+import { mkdir as mkdir8, readFile as readFile22, writeFile as writeFile13 } from "fs/promises";
+import path28 from "path";
+import { z as z64 } from "zod";
+var RUNS_PER_TURN = 2;
+var VIEWER_FAILS_PER_TURN = 2;
+var LedgerSchema = z64.object({
+  turnId: z64.string(),
+  creatives: z64.record(
+    z64.string(),
+    z64.object({ runs: z64.number().default(0), verdict: z64.string().optional(), viewerFails: z64.number().optional() })
+  )
+});
+function turnRenderRefusal(ledger, turnId, slug) {
+  const entry = turnId !== void 0 && ledger?.turnId === turnId ? ledger.creatives[slug] : void 0;
+  if (!entry) return null;
+  if (entry.verdict === "ready" || entry.verdict === "ready_with_notes") {
+    return {
+      code: "CONFLICT",
+      message: `This ad is already ready in this turn (${entry.verdict}): its notes are not defects.`,
+      fix: "Show it now. A change the person asks for comes with their next message."
+    };
+  }
+  if (entry.runs >= RUNS_PER_TURN) {
+    return {
+      code: "CONFLICT",
+      message: `This ad was rendered twice in this turn, its automatic corrections included, and is still not ready.`,
+      fix: "Show the best version and say in one plain sentence what is left, in the person's words; they decide what changes next."
+    };
+  }
+  return null;
+}
+function recordTurnRender(ledger, turnId, slug, verdict2) {
+  const creatives = ledger?.turnId === turnId ? ledger.creatives : {};
+  return { turnId, creatives: { ...creatives, [slug]: { ...creatives[slug], runs: (creatives[slug]?.runs ?? 0) + 1, verdict: verdict2 } } };
+}
+function recordViewerFail(ledger, turnId, slug) {
+  const creatives = ledger?.turnId === turnId ? ledger.creatives : {};
+  const entry = creatives[slug] ?? { runs: 0 };
+  return { turnId, creatives: { ...creatives, [slug]: { ...entry, viewerFails: (entry.viewerFails ?? 0) + 1 } } };
+}
+function viewerChecksSpent(ledger, turnId, slug) {
+  const entry = turnId !== void 0 && ledger?.turnId === turnId ? ledger.creatives[slug] : void 0;
+  return (entry?.viewerFails ?? 0) >= VIEWER_FAILS_PER_TURN;
+}
+var ledgerPath = (cacheDir) => path28.join(cacheDir, "turn-renders.json");
+async function readTurnRenders(cacheDir) {
+  try {
+    const parsed = LedgerSchema.safeParse(JSON.parse(await readFile22(ledgerPath(cacheDir), "utf8")));
+    return parsed.success ? parsed.data : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function writeTurnRenders(cacheDir, ledger) {
+  await mkdir8(cacheDir, { recursive: true });
+  await writeFile13(ledgerPath(cacheDir), JSON.stringify(ledger), "utf8");
+}
+
 // src/commands/canvas/viewer-check.ts
 var VIEWER_QUESTIONS = ["offer", "for_whom", "next_step"];
 var VIEWER_CLARITY = ["clear", "guess", "unclear"];
-var ViewerReply = z64.object({ answer: z64.string().default(""), clarity: z64.enum(VIEWER_CLARITY) });
-var ViewerAnswerSchema = z64.object({
+var ViewerReply = z65.object({ answer: z65.string().default(""), clarity: z65.enum(VIEWER_CLARITY) });
+var ViewerAnswerSchema = z65.object({
   offer: ViewerReply,
   for_whom: ViewerReply,
   next_step: ViewerReply,
   /** The words that talk to the viewer as if they had already done something with the brand; "" when none. */
-  presumes: z64.string().default(""),
-  missing: z64.string().default("")
+  presumes: z65.string().default(""),
+  missing: z65.string().default("")
 });
 var VIEWER_REQUIRED_CLARITY = {
   offer: "clear",
@@ -74199,14 +74265,14 @@ function viewerCheckCacheKey(input, model) {
 }
 async function cachedAnswer(file) {
   try {
-    const parsed = ViewerAnswerSchema.safeParse(JSON.parse(await readFile22(file, "utf8")));
+    const parsed = ViewerAnswerSchema.safeParse(JSON.parse(await readFile23(file, "utf8")));
     return parsed.success ? parsed.data : null;
   } catch {
     return null;
   }
 }
 async function checkViewer(input, opts) {
-  const file = path28.join(opts.cacheDir, "viewer-check", `${viewerCheckCacheKey(input, opts.model)}.json`);
+  const file = path29.join(opts.cacheDir, "viewer-check", `${viewerCheckCacheKey(input, opts.model)}.json`);
   let answer = await cachedAnswer(file);
   const cached = answer !== null;
   const prompt = buildViewerPrompt(input);
@@ -74216,8 +74282,8 @@ async function checkViewer(input, opts) {
   }
   if (answer === null) return { status: "unavailable", input };
   if (!cached) {
-    await mkdir8(path28.dirname(file), { recursive: true });
-    await writeFile13(file, `${JSON.stringify(answer, null, 2)}
+    await mkdir9(path29.dirname(file), { recursive: true });
+    await writeFile14(file, `${JSON.stringify(answer, null, 2)}
 `, "utf8");
   }
   const verdict2 = judgeViewerAnswer(answer, input.intended);
@@ -74248,7 +74314,10 @@ function viewerCheckFailure(outcome2, slug) {
   const who = describeViewer(viewer);
   const missing = outcome2.answer.missing.trim();
   const unsaid = outcome2.verdict.missed.flatMap((m) => m.question === "presumes" ? [] : [QUESTION_WORDS[m.question]]);
+  const offer = outcome2.input.intended.offer?.trim();
+  const rewrite = offer && outcome2.verdict.missed.some((m) => m.question === "offer") ? [`Do this: make the biggest words say "${offer}", plainly, in the ad's language; keep the rest.`] : [];
   const fix = [
+    ...rewrite,
     ...unsaid.length > 0 ? [`Seen by ${who}, the words and picture alone do not say ${unsaid.join(" or ")}.`] : [`Seen by ${who}:`],
     ...outcome2.verdict.missed.map(missLine),
     ...missing ? [`They needed: ${missing}`] : [],
@@ -74267,17 +74336,17 @@ function viewerCheckFailure(outcome2, slug) {
     }
   };
 }
-var RecordedViewer = z64.object({
-  temperature: z64.enum(VIEWER_TEMPERATURE_VALUES),
-  knows: z64.array(z64.enum(VIEWER_KNOWS_VALUES)).default([]),
-  placements: z64.array(z64.string().min(1)).default(["automatic"]),
-  source: z64.enum(VIEWER_SOURCE_VALUES),
-  reasons: z64.array(z64.string()).default([]),
-  market: z64.object({
-    country: z64.string().min(2),
-    language: z64.string().optional(),
-    currency: z64.string().optional(),
-    address: z64.string().optional()
+var RecordedViewer = z65.object({
+  temperature: z65.enum(VIEWER_TEMPERATURE_VALUES),
+  knows: z65.array(z65.enum(VIEWER_KNOWS_VALUES)).default([]),
+  placements: z65.array(z65.string().min(1)).default(["automatic"]),
+  source: z65.enum(VIEWER_SOURCE_VALUES),
+  reasons: z65.array(z65.string()).default([]),
+  market: z65.object({
+    country: z65.string().min(2),
+    language: z65.string().optional(),
+    currency: z65.string().optional(),
+    address: z65.string().optional()
   }).optional()
 });
 var nameKey = (text3) => wordsOf(text3).join(" ");
@@ -74336,12 +74405,12 @@ async function resolveViewerAlone(sources, lookups) {
     notes
   };
 }
-var Frontmatter = z64.object({
-  viewer: z64.unknown().optional(),
-  targetAdSet: z64.union([z64.string(), z64.number()]).transform(String).optional(),
-  persona: z64.string().optional(),
-  awareness: z64.enum(AWARENESS_VALUES).optional().catch(void 0),
-  angle: z64.string().optional()
+var Frontmatter = z65.object({
+  viewer: z65.unknown().optional(),
+  targetAdSet: z65.union([z65.string(), z65.number()]).transform(String).optional(),
+  persona: z65.string().optional(),
+  awareness: z65.enum(AWARENESS_VALUES).optional().catch(void 0),
+  angle: z65.string().optional()
 });
 function frontmatterOf2(raw) {
   const block2 = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
@@ -74354,8 +74423,8 @@ function frontmatterOf2(raw) {
   }
 }
 async function readCreativeForViewerCheck(creativeDir) {
-  const spec = readAdSpec(JSON.parse(await readFile22(path28.join(creativeDir, "prompt.json"), "utf8")));
-  const definition = frontmatterOf2(await readFile22(path28.join(creativeDir, "_definition.md"), "utf8").catch(() => ""));
+  const spec = readAdSpec(JSON.parse(await readFile23(path29.join(creativeDir, "prompt.json"), "utf8")));
+  const definition = frontmatterOf2(await readFile23(path29.join(creativeDir, "_definition.md"), "utf8").catch(() => ""));
   const offer = spec.message?.trim() || definition.angle?.trim();
   const persona = spec.viewer?.who.trim() || definition.persona?.trim();
   const brand = spec.brand?.name?.trim();
@@ -74384,7 +74453,7 @@ function castPeople(spec) {
   return people.length > 0 ? { people } : {};
 }
 async function readPersonas(workspaceRoot) {
-  const dir = path28.join(workspaceRoot, "src", "content", "personas");
+  const dir = path29.join(workspaceRoot, "src", "content", "personas");
   let files;
   try {
     files = (await readdir12(dir, { recursive: true })).filter((f) => f.endsWith(".md"));
@@ -74393,7 +74462,7 @@ async function readPersonas(workspaceRoot) {
   }
   return await Promise.all(
     files.map(async (file) => {
-      const raw = await readFile22(path28.join(dir, file), "utf8");
+      const raw = await readFile23(path29.join(dir, file), "utf8");
       const block2 = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
       let segment;
       try {
@@ -74403,7 +74472,7 @@ async function readPersonas(workspaceRoot) {
       }
       const title = raw.match(/^#\s+(.+)$/m)?.[1]?.trim();
       return {
-        slug: path28.basename(file, ".md"),
+        slug: path29.basename(file, ".md"),
         ...title ? { title } : {},
         ...typeof segment === "string" && segment.trim() ? { segment: segment.trim() } : {}
       };
@@ -74442,8 +74511,8 @@ function liveViewerLookups(workspaceRoot) {
   return {
     adSetViewer: metaAdSetViewer,
     personas: () => readPersonas(workspaceRoot),
-    companyMarket: async () => marketFromCompanyDoc(await readFile22(path28.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => null)),
-    company: async () => (await readFile22(path28.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => "")).slice(0, 800)
+    companyMarket: async () => marketFromCompanyDoc(await readFile23(path29.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => null)),
+    company: async () => (await readFile23(path29.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => "")).slice(0, 800)
   };
 }
 function gatewayViewerModel(model, onSpend) {
@@ -74473,16 +74542,7 @@ async function viewerCheckBeforeRender(opts) {
   const who = describeViewer(resolved.viewer);
   const lines = resolved.notes.map((note) => `[viewer] ${note}`);
   if (opts.skip) return { viewer: resolved.viewer, lines: [...lines, `[viewer] not asked: ${SKIP_WORDS[opts.skip]}.`] };
-  const outcome2 = await checkViewer({ ...creative.ad, viewer: resolved.viewer }, opts);
-  if (outcome2.status === "unavailable") {
-    lines.push(
-      `[warn] viewer_check_unavailable: the viewer model did not answer, so this ad renders without the viewer check. Read the copy as ${who} before showing it, or run \`baker canvas viewer-check ${opts.slug}\` again.`
-    );
-    return { viewer: resolved.viewer, lines };
-  }
-  if (outcome2.status === "failed") return { viewer: resolved.viewer, lines, failure: viewerCheckFailure(outcome2, opts.slug) };
-  lines.push(`[viewer] ${who} understood it: ${outcome2.answer.offer.answer}${outcome2.cached ? " (cached)" : ""}.`);
-  const casting = await castingCheck(
+  const casting = (async () => castingCheck(
     {
       people: creative.ad.people ?? [],
       company: await opts.lookups.company?.().catch(() => "") ?? "",
@@ -74490,10 +74550,26 @@ async function viewerCheckBeforeRender(opts) {
       ...creative.ad.intended.persona ? { persona: creative.ad.intended.persona } : {}
     },
     { cacheDir: opts.cacheDir, model: opts.model, ask: opts.ask }
-  );
-  if (casting.status === "failed") return { viewer: resolved.viewer, lines, failure: castingCheckFailure(casting.answer, opts.slug) };
-  if (casting.status === "passed") lines.push(`[casting] the people cast pass as real customers${casting.cached ? " (cached)" : ""}.`);
-  if (casting.status === "unavailable") {
+  ))().catch(() => ({ status: "unavailable" }));
+  const outcome2 = await checkViewer({ ...creative.ad, viewer: resolved.viewer }, opts);
+  if (outcome2.status === "unavailable") {
+    lines.push(
+      `[warn] viewer_check_unavailable: the viewer model did not answer, so this ad renders without the viewer check. Read the copy as ${who} before showing it, or run \`baker canvas viewer-check ${opts.slug}\` again.`
+    );
+  } else if (outcome2.status === "failed" && !opts.spent) {
+    return { viewer: resolved.viewer, lines, failure: viewerCheckFailure(outcome2, opts.slug) };
+  } else if (outcome2.status === "failed") {
+    lines.push(
+      `[viewer] this ad failed the viewer check twice in this turn, so it renders as written. Tell the person what ${who} missed: ${outcome2.verdict.missed.map(missLine).join(" ")}`
+    );
+  } else {
+    lines.push(`[viewer] ${who} understood it: ${outcome2.answer.offer.answer}${outcome2.cached ? " (cached)" : ""}.`);
+  }
+  if (outcome2.status === "unavailable") return { viewer: resolved.viewer, lines };
+  const cast = await casting;
+  if (cast.status === "failed") return { viewer: resolved.viewer, lines, failure: castingCheckFailure(cast.answer, opts.slug) };
+  if (cast.status === "passed") lines.push(`[casting] the people cast pass as real customers${cast.cached ? " (cached)" : ""}.`);
+  if (cast.status === "unavailable") {
     lines.push("[warn] casting_check_unavailable: the model did not answer; check yourself that the people cast look like this company's real customers.");
   }
   return { viewer: resolved.viewer, lines };
@@ -74514,11 +74590,11 @@ var ARGS5 = {
 };
 registerSchema({ command: "canvas.viewer-check", description: DESCRIPTION2, args: ARGS5 });
 async function creativeDirOf(arg, workspaceRoot) {
-  const direct = path28.resolve(arg);
+  const direct = path29.resolve(arg);
   try {
-    return (await stat4(direct)).isDirectory() ? direct : path28.dirname(direct);
+    return (await stat4(direct)).isDirectory() ? direct : path29.dirname(direct);
   } catch {
-    return path28.join(workspaceRoot, "src", "creatives", arg);
+    return path29.join(workspaceRoot, "src", "creatives", arg);
   }
 }
 var viewerCheckCommand = defineCommand138({
@@ -74528,7 +74604,7 @@ var viewerCheckCommand = defineCommand138({
     const cwd = process.cwd();
     const workspaceRoot = findWorkspaceRoot(cwd) ?? cwd;
     const creativeDir = await creativeDirOf(String(args8.slug), workspaceRoot);
-    const slug = path28.basename(creativeDir);
+    const slug = path29.basename(creativeDir);
     let creative;
     try {
       creative = await readCreativeForViewerCheck(creativeDir);
@@ -74545,7 +74621,7 @@ var viewerCheckCommand = defineCommand138({
     }
     const resolved = await resolveViewer(creative.sources, liveViewerLookups(workspaceRoot));
     const input = { ...creative.ad, viewer: resolved.viewer };
-    const cacheDir = path28.join(workspaceRoot, "canvas", ".cache");
+    const cacheDir = path29.join(workspaceRoot, "canvas", ".cache");
     const spent = [];
     const outcome2 = await checkViewer(input, {
       cacheDir,
@@ -74562,6 +74638,19 @@ var viewerCheckCommand = defineCommand138({
       ...resolved.notes.length > 0 ? { notes: resolved.notes } : {}
     } : {};
     if (outcome2.status === "failed") {
+      const turnId = optionalTurnId();
+      const ledger = await readTurnRenders(cacheDir);
+      if (viewerChecksSpent(ledger, turnId, slug)) {
+        writeJson({
+          ok: true,
+          data: { checked: true, understood: false, viewer: who, missed: outcome2.verdict.missed, ...detail },
+          hints: [
+            `This ad failed the viewer check twice in this turn: render it as written (baker canvas run --slug ${slug}) and tell the person what ${who} missed: ${outcome2.verdict.missed.map(missLine).join(" ")}`
+          ]
+        });
+        return;
+      }
+      if (turnId) await writeTurnRenders(cacheDir, recordViewerFail(ledger, turnId, slug));
       const failure = viewerCheckFailure(outcome2, slug);
       writeJson({ ...failure, error: { ...failure.error, ...detail } });
       process.exit(2);
@@ -74604,9 +74693,9 @@ var GLANCE_REQUIRED = {
 var GLANCE_WIDTH = 400;
 var GlanceAnswerSchema = ViewerAnswerSchema.extend({
   /** What kind of product or service they take it for (D4). */
-  category: z65.object({ answer: z65.string().default(""), clarity: z65.enum(["clear", "guess", "unclear"]).default("unclear") }).default({ answer: "", clarity: "unclear" }),
-  stopped: z65.string().default(""),
-  me: z65.enum(["yes", "no", "unsure"]).default("unsure")
+  category: z66.object({ answer: z66.string().default(""), clarity: z66.enum(["clear", "guess", "unclear"]).default("unclear") }).default({ answer: "", clarity: "unclear" }),
+  stopped: z66.string().default(""),
+  me: z66.enum(["yes", "no", "unsure"]).default("unsure")
 });
 function wherePhrase2(placements) {
   const fullScreen = placements.length === 0 || placements.some((p) => /automatic|stor|reel/i.test(p));
@@ -74776,7 +74865,7 @@ function runCostHint(stats, kind) {
 async function textOf(ref2) {
   const r = ref2;
   try {
-    if (typeof r?.path === "string") return await readFile23(r.path, "utf8");
+    if (typeof r?.path === "string") return await readFile24(r.path, "utf8");
     if (typeof r?.url === "string") {
       const res = await fetch(r.url);
       return res.ok ? await res.text() : null;
@@ -74843,7 +74932,7 @@ async function reviewStaticRun(opts) {
   let native;
   let palette = [];
   try {
-    const spec = readAdSpec(JSON.parse(await readFile23(targets.promptPath, "utf8")));
+    const spec = readAdSpec(JSON.parse(await readFile24(targets.promptPath, "utf8")));
     copy = spec.copy.map((l) => l.text);
     lines = spec.copy.map((l) => ({ text: l.text, lettering: l.lettering, ...l.role ? { role: l.role } : {} }));
     if (spec.native) {
@@ -74877,8 +74966,10 @@ async function reviewStaticRun(opts) {
     () => null
   );
   const comparing = opts.previous ? nearIdenticalFindings(targets.images, opts.previous).catch(() => []) : Promise.resolve([]);
+  const untouched = opts.settled ? await samePictureSizes(targets.images, opts.settled.images) : [];
+  const changed = targets.images.filter((i) => !untouched.includes(i.format));
   const review = await reviewRenderedStatic({
-    images: targets.images,
+    images: changed.length > 0 ? changed : targets.images,
     copy,
     lines,
     palette,
@@ -74901,7 +74992,7 @@ async function reviewStaticRun(opts) {
   const glance = review === null ? null : glanced;
   const unchanged = review === null ? [] : compared;
   const fresh = review === null ? null : [...review, ...glance ?? [], ...unchanged];
-  const reviewed = fresh === null || !opts.settled ? fresh : carryUnchanged(fresh, opts.settled.review, await samePictureSizes(targets.images, opts.settled.images));
+  const reviewed = fresh === null || !opts.settled ? fresh : carryUnchanged(fresh, opts.settled.review, untouched);
   const verdict2 = staticVerdict(reviewed);
   const hints2 = verdictHints(verdict2);
   const sizeHints = verdict2 === "needs_fixes" ? sizeFixHints(opts.parsed, reviewed) : [];
@@ -75024,12 +75115,12 @@ function variantHints(judge, prefilter) {
 }
 
 // src/commands/canvas/static-spec-repair.ts
-import { readFile as readFile24, writeFile as writeFile14 } from "fs/promises";
+import { readFile as readFile25, writeFile as writeFile15 } from "fs/promises";
 import sharp3 from "sharp";
-import { z as z66 } from "zod";
-var Answer = z66.object({
-  changed: z66.string().min(1),
-  set: z66.array(z66.object({ path: z66.string().min(1), value: z66.unknown() }))
+import { z as z67 } from "zod";
+var Answer = z67.object({
+  changed: z67.string().min(1),
+  set: z67.array(z67.object({ path: z67.string().min(1), value: z67.unknown() }))
 });
 function withValueAt(root, path68, value2) {
   const [key, ...rest] = path68;
@@ -75083,7 +75174,7 @@ function buildSpecRepairPrompt(spec, findings, schema) {
 var REPAIR_TIMEOUT_MS = 15e4;
 var SHOWN_WIDTH = 768;
 async function repairSpec(opts) {
-  const text3 = await readFile24(opts.promptPath, "utf8").catch(() => null);
+  const text3 = await readFile25(opts.promptPath, "utf8").catch(() => null);
   if (text3 === null) return null;
   let before;
   try {
@@ -75095,57 +75186,11 @@ async function repairSpec(opts) {
   const prompt = buildSpecRepairPrompt(text3, opts.findings, adSpecJsonSchema());
   const repair = acceptRepair(before, await askAboutImages(RENDER_REVIEW_MODEL, shown ? [shown] : [], prompt, opts.onSpend, REPAIR_TIMEOUT_MS));
   if (!repair) return null;
-  await writeFile14(opts.promptPath, `${JSON.stringify(repair.spec, null, 2)}
+  await writeFile15(opts.promptPath, `${JSON.stringify(repair.spec, null, 2)}
 `, "utf8");
   return repair.changed;
 }
 
-// src/commands/canvas/turn-renders.ts
-import { mkdir as mkdir9, readFile as readFile25, writeFile as writeFile15 } from "fs/promises";
-import path29 from "path";
-import { z as z67 } from "zod";
-var RUNS_PER_TURN = 2;
-var LedgerSchema = z67.object({
-  turnId: z67.string(),
-  creatives: z67.record(z67.string(), z67.object({ runs: z67.number(), verdict: z67.string().optional() }))
-});
-function turnRenderRefusal(ledger, turnId, slug) {
-  const entry = turnId !== void 0 && ledger?.turnId === turnId ? ledger.creatives[slug] : void 0;
-  if (!entry) return null;
-  if (entry.verdict === "ready" || entry.verdict === "ready_with_notes") {
-    return {
-      code: "CONFLICT",
-      message: `This ad is already ready in this turn (${entry.verdict}): its notes are not defects.`,
-      fix: "Show it now. A change the person asks for comes with their next message."
-    };
-  }
-  if (entry.runs >= RUNS_PER_TURN) {
-    return {
-      code: "CONFLICT",
-      message: `This ad was rendered twice in this turn, its automatic corrections included, and is still not ready.`,
-      fix: "Show the best version and say in one plain sentence what is left, in the person's words; they decide what changes next."
-    };
-  }
-  return null;
-}
-function recordTurnRender(ledger, turnId, slug, verdict2) {
-  const creatives = ledger?.turnId === turnId ? ledger.creatives : {};
-  return { turnId, creatives: { ...creatives, [slug]: { runs: (creatives[slug]?.runs ?? 0) + 1, verdict: verdict2 } } };
-}
-var ledgerPath = (cacheDir) => path29.join(cacheDir, "turn-renders.json");
-async function readTurnRenders(cacheDir) {
-  try {
-    const parsed = LedgerSchema.safeParse(JSON.parse(await readFile25(ledgerPath(cacheDir), "utf8")));
-    return parsed.success ? parsed.data : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function writeTurnRenders(cacheDir, ledger) {
-  await mkdir9(cacheDir, { recursive: true });
-  await writeFile15(ledgerPath(cacheDir), JSON.stringify(ledger), "utf8");
-}
-
 // src/commands/canvas/run.ts
 var OPERATOR = "Operator only, agents never need it.";
 var runCommand = defineCommand139({
@@ -75412,6 +75457,12 @@ ${describeRewrites(prepared.rewrites)}
       change: instruction.replace(/^Change only this: /, ""),
       ...opts.relayAlso ? { also: opts.relayAlso } : {}
     });
+    const kept = delivered.filter((d) => opts.keepSizes?.includes(d.format));
+    if (kept.length > 0) {
+      parsed = withDeliveredSizes(parsed, Object.fromEntries(kept.map((d) => [d.format, d.path])));
+      process.stdout.write(`[fix] keeping ${kept.map((d) => d.format).join(", ")} as it was: nothing blocking on it
+`);
+    }
     if (!editInstruction) process.stdout.write(`[fix] correcting the version of run ${from}: ${instruction}
 `);
   }
@@ -75565,6 +75616,7 @@ ${describeRewrites(prepared.rewrites)}
       resumed: resumed && sameSource === true,
       asked: opts.skipViewerCheck === true
     }),
+    spent: viewerChecksSpent(await readTurnRenders(turnCache), turnId, creativeSlug),
     lookups: liveViewerLookups(path30.dirname(canvasRoot)),
     model: VIEWER_CHECK_MODEL,
     ask: gatewayViewerModel(VIEWER_CHECK_MODEL, (usage) => viewerUsage.push(usage))
@@ -75573,6 +75625,9 @@ ${describeRewrites(prepared.rewrites)}
 `);
   await holdUnbilledSpend(cacheDir, viewerUsage);
   if (viewerCheck?.failure) {
+    if (creativeSlug && turnId && viewerCheck.failure.error.code === "viewer_check_failed") {
+      await writeTurnRenders(turnCache, recordViewerFail(await readTurnRenders(turnCache), turnId, creativeSlug));
+    }
     process.stderr.write(`${JSON.stringify(viewerCheck.failure, null, 2)}
 `);
     process.exit(2);
@@ -75830,6 +75885,7 @@ ${describeRewrites(prepared.rewrites)}
         ...step.kind === "fix" ? {
           fix: step.instruction,
           ...step.relay ? { relayAlso: step.relay } : {},
+          ...step.keep ? { keepSizes: step.keep } : {},
           ...step.extend ? { extendSizes: step.extend } : {}
         } : step.kind === "extend" ? { extendSizes: step.sizes, extendOnly: true } : step.kind === "relayout" ? {
           ...step.extend ? { extendSizes: step.extend } : {},
@@ -80998,7 +81054,7 @@ function ideasHints(report) {
   if (next.length === 1) hints2.push(`Build: \`baker creatives make ${next[0]}\`.`);
   if (next.length > 1)
     hints2.push(
-      `Build ${next.join(", ")} at once: one \`creative-producer\` per idea, all spawned in one message, each given its idea id. Never build them one after another: each render takes about five minutes.`
+      `Build ${next.join(", ")} at once: one \`creative-producer\` per idea, all spawned in one message in the background, each given its idea id, and handle each as it returns. Never build them one after another: each render takes minutes.`
     );
   return hints2;
 }
@@ -81335,7 +81391,7 @@ function briefHints(parts) {
   }
   if (parts.customers.thin) {
     hints2.push(
-      `Only ${parts.customers.observed} customer quotes on file: run \`baker research customers\` before writing ideas, so they stand on what customers said.`
+      `Only ${parts.customers.observed} customer quotes on file: run \`baker research customers\` now, before writing ideas, so they stand on what customers said. It gathers reviews, Reddit and the web and writes the quotes with their sources in about a minute; never a subagent or web searches of your own for this.`
     );
   }
   if (parts.bottleneck && isAvailable(parts.bottleneck) && parts.bottleneck.verdict === "after_click") {