@koda-sl/baker-cli 0.440.0-dev.dab0aaba9 → 0.444.0-dev.cac1750ec

package/dist/cli.js

@@ -198,7 +198,7 @@ import {
   withoutCastName,
   wordCount,
   ytDlpBlockSignal
-} from "./chunk-APTNJ2EY.js";
+} from "./chunk-GY352NRN.js";
 import {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -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") {
@@ -81374,7 +81430,8 @@ function briefHints(parts) {
   return hints2;
 }
 async function readBrief(root, args8) {
-  const [company, offers, viewer, insights, ideas, performance, feedback, accountId] = await Promise.all([
+  const account = metaAccountId(args8.accountId).catch(() => null);
+  const [company, offers, viewer, insights, ideas, performance, feedback, accountId, bottleneck, market] = await Promise.all([
     companyStatus(root),
     readOffers(root),
     readViewer(root, args8.adset),
@@ -81387,10 +81444,8 @@ async function readBrief(root, args8) {
       )
     ),
     section(() => apiPost("/api/creatives/feedback", {})),
-    metaAccountId(args8.accountId).catch(() => null)
-  ]);
-  const [bottleneck, market] = await Promise.all([
-    accountId ? section(() => readBottleneck(accountId)) : null,
+    account,
+    account.then((id) => id ? section(() => readBottleneck(id)) : null),
     section(() => readMarket(root))
   ]);
   return { company, offers, viewer, insights, ideas, performance, feedback, accountId, bottleneck, market };
@@ -82172,8 +82227,9 @@ function makeEnvelope(made) {
         `Rewrite before running: ${made.unsourcedCopy.map((l) => JSON.stringify(l)).join(", ")} claim a figure nothing the company wrote holds (the reference's promise, not ours).`
       ] : [],
       `Write the copy lines and the scene in src/creatives/${made.slug}/prompt.json${made.reference ? ": the drafted lines are the reference's, so keep one only if the Knowledge says it (badges, ratings and guarantees too)" : ""}. Say the message in the customer's words${quote ? ` ("${quote.slice(0, 80)}")` : ""}; keep \`message\` as it is.`,
-      `Then: baker canvas run ${made.canvasPath}`,
-      ...made.scaffoldHints.slice(0, 4)
+      `Then: baker canvas run ${made.canvasPath} (it validates and asks the viewer itself: nothing to run before it).`,
+      // The scaffold's own next steps name a separate validate; the run does it (dev, Oct 2026: five validates before one run).
+      ...made.scaffoldHints.filter((h) => !/canvas (?:validate|viewer-check)/.test(h)).slice(0, 4)
     ]
   };
 }