@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/chunk-LXUEWTHJ.js

@@ -1,788 +0,0 @@
-import {
-  holdUnbilledSpend
-} from "./chunk-PNHDM76R.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-NMMKTPGI.js";
-import {
-  adSetViewerRows
-} from "./chunk-Z4NYXXTP.js";
-import {
-  requireCredentialsFromEnv
-} from "./chunk-G32FXVQ6.js";
-import {
-  readAdSpec
-} from "./chunk-Z5AUNK6P.js";
-import {
-  askAboutText
-} from "./chunk-FR345TDN.js";
-import {
-  VIEWER_CHECK_MODEL
-} from "./chunk-KY4MPR6R.js";
-import {
-  HttpClient
-} from "./chunk-QTERC4PG.js";
-import {
-  AWARENESS_VALUES,
-  VIEWER_KNOWS_VALUES,
-  VIEWER_SOURCE_VALUES,
-  VIEWER_TEMPERATURE_VALUES,
-  describeMarket,
-  marketFromCompanyDoc,
-  viewerFromKnowledge
-} from "./chunk-PDJZMQ7F.js";
-import {
-  optionalTurnId
-} from "./chunk-SXRSLUW7.js";
-import {
-  writeJson
-} from "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.js";
-
-// src/commands/canvas/viewer-check.ts
-import { createHash as createHash2 } from "crypto";
-import { mkdir as mkdir3, readdir, readFile as readFile3, stat, writeFile as writeFile3 } from "fs/promises";
-import path3 from "path";
-import { defineCommand } from "citty";
-import { parse as parseYaml } from "yaml";
-import { z as z3 } from "zod";
-
-// src/commands/canvas/casting-check.ts
-import { createHash } from "crypto";
-import { mkdir, readFile, writeFile } from "fs/promises";
-import path from "path";
-import { z } from "zod";
-var CastingAnswerSchema = z.object({
-  passes: z.boolean(),
-  why: z.string().default(""),
-  instead: z.string().default("")
-});
-function buildCastingPrompt(input) {
-  return [
-    "An ad is about to be made with these people in it:",
-    ...input.people.map((p) => `- ${p}`),
-    "",
-    `The company: ${input.company.trim() || "(not written down)"}`,
-    ...input.persona ? [`The ad is for: ${input.persona}`] : [],
-    ...input.market ? [`It runs for ${input.market}.`] : [],
-    "",
-    "Would each of these people pass, to someone scrolling there, as a real customer of this company (or, for a testimonial, someone who really used it)? Judge age, look, setting and origin against who actually buys this, where the ad runs. A model-like face selling to people who are not models does not pass.",
-    'Reply with only this JSON: {"passes":true|false,"why":"<one sentence>","instead":"<who would pass, in a few words, when one does not>"}'
-  ].join("\n");
-}
-function cacheKey(input, model) {
-  return createHash("sha256").update(JSON.stringify({ prompt: buildCastingPrompt(input), model })).digest("hex");
-}
-function parseOrNull(raw) {
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-async function castingCheck(input, opts) {
-  if (input.people.length === 0) return { status: "skipped" };
-  const file = path.join(opts.cacheDir, "casting-check", `${cacheKey(input, opts.model)}.json`);
-  const cachedRaw = await readFile(file, "utf8").catch(() => null);
-  const cachedParse = cachedRaw ? CastingAnswerSchema.safeParse(parseOrNull(cachedRaw)) : null;
-  if (cachedParse?.success) return { status: cachedParse.data.passes ? "passed" : "failed", answer: cachedParse.data, cached: true };
-  const prompt = buildCastingPrompt(input);
-  for (let attempt = 0; attempt < 2; attempt++) {
-    const parsed = CastingAnswerSchema.safeParse(await opts.ask(prompt));
-    if (!parsed.success) continue;
-    await mkdir(path.dirname(file), { recursive: true });
-    await writeFile(file, `${JSON.stringify(parsed.data, null, 2)}
-`, "utf8");
-    return { status: parsed.data.passes ? "passed" : "failed", answer: parsed.data, cached: false };
-  }
-  return { status: "unavailable" };
-}
-function castingCheckFailure(answer, slug) {
-  return {
-    ok: false,
-    error: {
-      code: "casting_check_failed",
-      message: `Not rendered: the people cast would not pass as this company's real customers. ${answer.why}`.trim(),
-      fix: [
-        answer.instead ? `Cast ${answer.instead} instead:` : "Cast someone who would:",
-        "`baker avatars list` for the company's avatars (pass the one that fits with `--avatar` on the scaffold, or set its identity sheet URL from `baker avatars get <handle>` as the PERSON reference's `image` in prompt.json), or `baker avatars create` from the persona (age, origin, setting, accent for this market).",
-        `Then \`baker canvas run --slug ${slug}\` again.`
-      ].join(" ")
-    }
-  };
-}
-
-// src/commands/canvas/turn-renders.ts
-import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
-import path2 from "path";
-import { z as z2 } from "zod";
-var RUNS_PER_TURN = 2;
-var VIEWER_FAILS_PER_TURN = 2;
-var AD_TURN_MS = 8 * 6e4;
-var ROUND_MS = {
-  respec: 6e4,
-  extend: 8e4,
-  relayout: 1e5,
-  fix: 15e4,
-  regenerate: 22e4
-};
-var RENDER_MS = 15e4;
-var LedgerSchema = z2.object({
-  turnId: z2.string(),
-  creatives: z2.record(
-    z2.string(),
-    z2.object({
-      runs: z2.number().default(0),
-      verdict: z2.string().optional(),
-      viewerFails: z2.number().optional(),
-      spentMs: z2.number().optional()
-    })
-  )
-});
-var SHOW_AS_IT_STANDS = `Show the best version as a version ("Version 3"), never a file path or a run id, and say in one plain sentence what is left, in the person's words. End there: no question and no options; their next message says what changes.`;
-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.spentMs ?? 0) + RENDER_MS > AD_TURN_MS) {
-    return {
-      code: "CONFLICT",
-      message: `This ad has had its ${AD_TURN_MS / 6e4} minutes in this turn, its automatic corrections included, and is still not ready.`,
-      fix: SHOW_AS_IT_STANDS
-    };
-  }
-  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_AS_IT_STANDS
-    };
-  }
-  return null;
-}
-function recordTurnRender(ledger, turnId, slug, verdict, tookMs) {
-  const creatives = ledger?.turnId === turnId ? ledger.creatives : {};
-  const entry = creatives[slug];
-  const spentMs = (entry?.spentMs ?? 0) + (tookMs ?? 0);
-  return {
-    turnId,
-    creatives: {
-      ...creatives,
-      [slug]: { ...entry, runs: (entry?.runs ?? 0) + 1, verdict, ...spentMs > 0 ? { spentMs } : {} }
-    }
-  };
-}
-function roundFitsTurn(ledger, turnId, slug, renderMs, kind) {
-  const entry = turnId !== void 0 && slug !== void 0 && ledger?.turnId === turnId ? ledger.creatives[slug] : void 0;
-  return (entry?.spentMs ?? 0) + renderMs + ROUND_MS[kind] <= AD_TURN_MS;
-}
-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) => path2.join(cacheDir, "turn-renders.json");
-async function readTurnRenders(cacheDir) {
-  try {
-    const parsed = LedgerSchema.safeParse(JSON.parse(await readFile2(ledgerPath(cacheDir), "utf8")));
-    return parsed.success ? parsed.data : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function writeTurnRenders(cacheDir, ledger) {
-  await mkdir2(cacheDir, { recursive: true });
-  await writeFile2(ledgerPath(cacheDir), JSON.stringify(ledger), "utf8");
-}
-
-// src/commands/creatives/company-offer.ts
-var MARKET_QUERY_WORDS = 6;
-function marketQuery(companyDoc) {
-  const first = companyDoc.split("\n").find((line) => line.trim() && !line.trim().startsWith("#")) ?? "";
-  if (/^\s*TODO\b/.test(first)) return "";
-  const what = first.replace(/^\s*[-*]\s+/, "").replace(/^\*\*[^*]+\*\*\s*[—–:-]?\s*/, "").split(/\s+for\s+|[,.;:(]|\s[—–-]\s/)[0];
-  return (what ?? "").trim().split(/\s+/).filter(Boolean).slice(0, MARKET_QUERY_WORDS).join(" ");
-}
-
-// src/commands/canvas/viewer-check.ts
-var VIEWER_QUESTIONS = ["offer", "for_whom", "next_step"];
-var VIEWER_CLARITY = ["clear", "guess", "unclear"];
-var ViewerReply = z3.object({ answer: z3.string().default(""), clarity: z3.enum(VIEWER_CLARITY) });
-var ViewerAnswerSchema = z3.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: z3.string().default(""),
-  missing: z3.string().default("")
-});
-var VIEWER_REQUIRED_CLARITY = {
-  offer: "clear",
-  for_whom: "unclear",
-  next_step: "guess"
-};
-var RANK = { unclear: 0, guess: 1, clear: 2 };
-var ENGLISH_FUNCTION_WORDS = new Set(
-  "a an the and or but of to for with in on at by from as is are be your you our we it its this that who what how".split(" ")
-);
-var OTHER_FUNCTION_WORDS = new Set(
-  "de del la el los las y o para por con en que un una tu su sus le les des et pour avec du au der die das und f\xFCr mit ein eine zu von il lo gli per con di da em os as do dos um uma".split(
-    " "
-  )
-);
-var wordsOf = (text) => text.normalize("NFD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean);
-var stemOf = (word) => word.length <= 4 ? word.replace(/s$/, "") : word.slice(0, 4);
-function contentStems(text) {
-  return new Set(
-    wordsOf(text).filter((w) => w.length >= 3 && !ENGLISH_FUNCTION_WORDS.has(w) && !OTHER_FUNCTION_WORDS.has(w)).map(stemOf)
-  );
-}
-function looksEnglish(text) {
-  const words = wordsOf(text);
-  const english = words.filter((w) => ENGLISH_FUNCTION_WORDS.has(w)).length;
-  const other = words.filter((w) => OTHER_FUNCTION_WORDS.has(w)).length;
-  if (english !== other) return english > other;
-  return /^[\x20-\x7e]*$/.test(text);
-}
-var writtenAsBelief = (text) => wordsOf(text).some((w) => ["i", "my", "me", "mine"].includes(w));
-function misread(said, meant, sells) {
-  if (!meant || !said.trim() || !looksEnglish(meant) || !looksEnglish(said) || writtenAsBelief(meant)) return false;
-  const meantStems = /* @__PURE__ */ new Set([...contentStems(meant), ...sells && looksEnglish(sells) ? contentStems(sells) : []]);
-  if (meantStems.size === 0) return false;
-  return ![...contentStems(said)].some((stem) => meantStems.has(stem));
-}
-function judgeViewerAnswer(answer, intended, required = VIEWER_REQUIRED_CLARITY) {
-  const missed = [];
-  for (const question of VIEWER_QUESTIONS) {
-    const reply = answer[question];
-    const meant = question === "offer" ? intended.offer : question === "for_whom" ? intended.persona : void 0;
-    const withIntended = meant ? { intended: meant } : {};
-    if (RANK[reply.clarity] < RANK[required[question]]) {
-      missed.push({
-        question,
-        reason: reply.clarity === "unclear" ? "unclear" : "guessed",
-        viewerSaid: reply.answer,
-        ...withIntended
-      });
-    } else if (question === "offer" && misread(reply.answer, meant, intended.sells)) {
-      missed.push({ question, reason: "misread", viewerSaid: reply.answer, ...withIntended });
-    }
-  }
-  if (answer.presumes.trim()) missed.push({ question: "presumes", reason: "presumed", viewerSaid: answer.presumes.trim() });
-  return { pass: missed.length === 0, missed };
-}
-var SMALL_PRINT = /^(fine_print|legal|disclaimer|footnote)$/;
-function wherePhrase(placements) {
-  const fullScreen = placements.length === 0 || placements.some((p) => /automatic|stor|reel/i.test(p));
-  return fullScreen ? "full screen through Instagram or Facebook Stories and Reels, thumb ready to swipe" : "through your Instagram or Facebook feed";
-}
-function knowledgePhrase(viewer, offer) {
-  const brand = "the advertiser";
-  if (!viewer.knows.includes("brand")) return `You have never heard of ${brand} and know nothing about what it sells.`;
-  const offerPart = viewer.knows.includes("offer") ? offer ? ` You know what they offer: ${offer}.` : " You know what they offer." : " You do not know what they are offering right now.";
-  const product = viewer.knows.includes("product") ? " You have used what they sell." : "";
-  return `You have come across ${brand} before.${offerPart}${product}`;
-}
-function buildViewerPrompt(input) {
-  const brand = "the advertiser";
-  const stranger = !input.viewer.knows.includes("brand");
-  const read = input.copy.filter((line) => !SMALL_PRINT.test((line.role ?? "").trim().toLowerCase().replace(/[\s-]+/g, "_")));
-  const words = read.length > 0 ? read.map((line) => `- "${line.text}"${line.on ? ` (written on the ${line.on})` : ""}`).join("\n") : "- none: the picture is the whole ad";
-  return [
-    `${input.viewer.market ? `You are ${describeMarket(input.viewer.market)}.` : "You live where this ad runs and read its language natively."} You are scrolling ${wherePhrase(input.viewer.placements)}. ${knowledgePhrase(input.viewer, input.intended.offer)}`,
-    `An ad from an advertiser whose name means nothing to you holds you for about three seconds: you take in the picture and read the biggest words, not every line. This is what you see, plus the platform's usual button under it (such as "Learn more"):`,
-    "",
-    `Picture: ${input.scene.trim()}`,
-    "Words on it:",
-    words,
-    "",
-    "Answer as this person, from those words, that picture and what you already know. Do not fill gaps with what ads like this usually sell.",
-    `For each question give your answer in English and how sure you are: "clear" when the words or the picture say it outright, or you already know it; "guess" when you are piecing it together from someone else's story or review, a list of perks, a statistic or the advertiser's name; "unclear" when you cannot tell.`,
-    "offer: what is being offered?",
-    "for_whom: who is it for?",
-    "next_step: what would you do next if you wanted it?",
-    ...stranger ? [
-      `presumes: quote the words that say you have already done something with ${brand} (bought, signed up, started a trial, an order or a registration, donated, left something in a basket); words that only speak to you, or say what you would get, do not count; "" when none do.`
-    ] : [],
-    'missing: in one short sentence, what you would need to be told to get it; "" when nothing.',
-    "",
-    `Reply with only this JSON: {"offer":{"answer":"","clarity":"clear|guess|unclear"},"for_whom":{"answer":"","clarity":"clear|guess|unclear"},"next_step":{"answer":"","clarity":"clear|guess|unclear"},${stranger ? '"presumes":"",' : ""}"missing":""}`
-  ].join("\n");
-}
-function viewerCheckCacheKey(input, model) {
-  const { temperature, knows, placements, market } = input.viewer;
-  const canonical = {
-    prompt: buildViewerPrompt({ ...input, viewer: { ...input.viewer, reasons: [] } }),
-    viewer: { temperature, knows: [...knows].sort(), placements: [...placements].sort(), ...market ? { market } : {} },
-    intended: input.intended,
-    model
-  };
-  return createHash2("sha256").update(JSON.stringify(canonical)).digest("hex");
-}
-async function cachedAnswer(file) {
-  try {
-    const parsed = ViewerAnswerSchema.safeParse(JSON.parse(await readFile3(file, "utf8")));
-    return parsed.success ? parsed.data : null;
-  } catch {
-    return null;
-  }
-}
-async function checkViewer(input, opts) {
-  const file = path3.join(opts.cacheDir, "viewer-check", `${viewerCheckCacheKey(input, opts.model)}.json`);
-  let answer = await cachedAnswer(file);
-  const cached = answer !== null;
-  const prompt = buildViewerPrompt(input);
-  for (let attempt = 0; answer === null && attempt < 2; attempt++) {
-    const parsed = ViewerAnswerSchema.safeParse(await opts.ask(prompt));
-    if (parsed.success) answer = parsed.data;
-  }
-  if (answer === null) return { status: "unavailable", input };
-  if (!cached) {
-    await mkdir3(path3.dirname(file), { recursive: true });
-    await writeFile3(file, `${JSON.stringify(answer, null, 2)}
-`, "utf8");
-  }
-  const verdict = judgeViewerAnswer(answer, input.intended);
-  const judged = { input, answer, verdict, cached };
-  return verdict.pass ? { ...judged, status: "passed" } : { ...judged, status: "failed" };
-}
-function describeViewer(viewer) {
-  const known = viewer.knows.map((k) => `the ${k}`);
-  const knows = known.length > 0 ? `who knows ${known.length > 1 ? `${known.slice(0, -1).join(", ")} and ${known.at(-1)}` : known[0]}` : "who knows nothing about the brand yet";
-  return `a ${viewer.temperature} viewer ${knows}, on ${viewer.placements.join(", ") || "automatic"} placements`;
-}
-var QUESTION_WORDS = {
-  offer: "what is offered",
-  for_whom: "who it is for",
-  next_step: "what to do next"
-};
-function missLine(miss) {
-  if (miss.question === "presumes") {
-    return `The words talk to them as if they had already done something with the brand: "${miss.viewerSaid}". They have not.`;
-  }
-  const said = miss.viewerSaid.trim() ? `"${miss.viewerSaid.trim()}"` : "nothing";
-  const how = miss.reason === "misread" ? `was sure it is ${said}` : miss.reason === "guessed" ? `could only guess ${said}` : `could not tell (said ${said})`;
-  const question = QUESTION_WORDS[miss.question];
-  return `${question.charAt(0).toUpperCase()}${question.slice(1)}: they ${how}${miss.intended ? `; the ad means "${miss.intended}"` : ""}.`;
-}
-function viewerCheckFailure(outcome, slug) {
-  const { viewer } = outcome.input;
-  const who = describeViewer(viewer);
-  const missing = outcome.answer.missing.trim();
-  const unsaid = outcome.verdict.missed.flatMap((m) => m.question === "presumes" ? [] : [QUESTION_WORDS[m.question]]);
-  const offer = outcome.input.intended.offer?.trim();
-  const rewrite = offer && outcome.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}:`],
-    ...outcome.verdict.missed.map(missLine),
-    ...missing ? [`They needed: ${missing}`] : [],
-    "Rewrite the copy in prompt.json so the words on the ad say it plainly (name the offer and who it is for; a stranger reads only what is printed), then re-run.",
-    // The run asks the viewer itself, from the same cache: a separate check is one more wait (dev, Oct 2026).
-    `Then run the same \`baker canvas run\` again: it checks the new copy before it spends (or \`baker canvas viewer-check ${slug}\` alone).`,
-    "If this ad will run to people who already know the brand, record that viewer in _definition.md (`targetAdSet` and `viewer`, from `baker ads meta adsets --audience`) instead of rewriting."
-  ].join(" ");
-  return {
-    ok: false,
-    error: {
-      code: "viewer_check_failed",
-      message: `Not rendered: ${who} would not understand this ad.`,
-      fix,
-      viewer,
-      missed: outcome.verdict.missed
-    }
-  };
-}
-var RecordedViewer = z3.object({
-  temperature: z3.enum(VIEWER_TEMPERATURE_VALUES),
-  knows: z3.array(z3.enum(VIEWER_KNOWS_VALUES)).default([]),
-  placements: z3.array(z3.string().min(1)).default(["automatic"]),
-  source: z3.enum(VIEWER_SOURCE_VALUES),
-  reasons: z3.array(z3.string()).default([]),
-  market: z3.object({
-    country: z3.string().min(2),
-    language: z3.string().optional(),
-    currency: z3.string().optional(),
-    address: z3.string().optional()
-  }).optional()
-});
-var nameKey = (text) => wordsOf(text).join(" ");
-function personaSegments(persona, entries) {
-  const describe = (entry) => entry.segment ?? entry.title ?? entry.slug;
-  if (!persona?.trim()) return entries.map(describe);
-  const wanted = nameKey(persona);
-  const match = entries.find(
-    (entry) => [entry.slug.replace(/[-_]/g, " "), entry.title, entry.segment].some((name) => name && nameKey(name) === wanted)
-  );
-  return [match ? describe(match) : persona.trim()];
-}
-async function resolveViewer(sources, lookups) {
-  const resolved = await resolveViewerAlone(sources, lookups);
-  if (resolved.viewer.market || !lookups.companyMarket) return resolved;
-  const market = await lookups.companyMarket().catch(() => void 0);
-  return market ? { ...resolved, viewer: { ...resolved.viewer, market } } : resolved;
-}
-async function resolveViewerAlone(sources, lookups) {
-  const notes = [];
-  if (sources.recorded !== void 0) {
-    const recorded = RecordedViewer.safeParse(sources.recorded);
-    if (recorded.success) return { viewer: recorded.data, from: "recorded", notes };
-    notes.push("The viewer recorded in _definition.md is not in the shape `baker ads meta adsets --audience` prints; it was skipped.");
-  }
-  if (sources.targetAdSet) {
-    try {
-      const fromAdSet = await lookups.adSetViewer(sources.targetAdSet);
-      if (fromAdSet) return { viewer: fromAdSet, from: "ad_set", notes };
-      notes.push(`Ad set ${sources.targetAdSet} is not in any connected Meta ad account.`);
-    } catch (e) {
-      notes.push(`Could not read ad set ${sources.targetAdSet} (${e instanceof Error ? e.message : String(e)}).`);
-    }
-  }
-  let entries = [];
-  try {
-    entries = await lookups.personas();
-  } catch (e) {
-    notes.push(`Could not read the personas in the Knowledge (${e instanceof Error ? e.message : String(e)}).`);
-  }
-  const personas = personaSegments(sources.persona, entries);
-  if (personas.length > 0 || sources.awareness) {
-    return { viewer: viewerFromKnowledge({ personas, awareness: sources.awareness }), from: "knowledge", notes };
-  }
-  return {
-    viewer: {
-      temperature: "cold",
-      knows: [],
-      placements: ["automatic"],
-      source: "knowledge",
-      reasons: [
-        "Nothing says who will see this ad (no viewer or targetAdSet in _definition.md, no persona in the Knowledge), so it is checked against a cold stranger who has never heard of the brand."
-      ]
-    },
-    from: "default",
-    notes
-  };
-}
-var Frontmatter = z3.object({
-  viewer: z3.unknown().optional(),
-  targetAdSet: z3.union([z3.string(), z3.number()]).transform(String).optional(),
-  persona: z3.string().optional(),
-  awareness: z3.enum(AWARENESS_VALUES).optional().catch(void 0),
-  angle: z3.string().optional()
-});
-function frontmatterOf(raw) {
-  const block = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
-  if (!block) return {};
-  try {
-    const parsed = Frontmatter.safeParse(parseYaml(block));
-    return parsed.success ? parsed.data : {};
-  } catch {
-    return {};
-  }
-}
-async function readCreativeForViewerCheck(creativeDir) {
-  const spec = readAdSpec(JSON.parse(await readFile3(path3.join(creativeDir, "prompt.json"), "utf8")));
-  const definition = frontmatterOf(await readFile3(path3.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();
-  const sells = marketQuery(await readFile3(path3.resolve(creativeDir, "../../../COMPANY.md"), "utf8").catch(() => ""));
-  return {
-    ad: {
-      copy: spec.copy.map((line) => ({
-        text: line.text,
-        ...line.lettering === "in_scene" && line.on ? { on: line.on } : {},
-        ...line.role ? { role: line.role } : {}
-      })),
-      scene: spec.scene.description,
-      ...brand ? { brand } : {},
-      intended: { ...offer ? { offer } : {}, ...persona ? { persona } : {}, ...sells ? { sells } : {} },
-      ...castPeople(spec)
-    },
-    sources: {
-      ...definition.viewer !== void 0 ? { recorded: definition.viewer } : {},
-      ...definition.targetAdSet ? { targetAdSet: definition.targetAdSet } : {},
-      ...definition.persona?.trim() ? { persona: definition.persona.trim() } : {},
-      ...definition.awareness ? { awareness: definition.awareness } : {}
-    }
-  };
-}
-function castPeople(spec) {
-  const people = spec.references.filter((r) => r.role === "identity" && (r.avatar || r.image) && !/^ANIMAL_/.test(r.id)).map((r) => r.what);
-  return people.length > 0 ? { people } : {};
-}
-async function readPersonas(workspaceRoot) {
-  const dir = path3.join(workspaceRoot, "src", "content", "personas");
-  let files;
-  try {
-    files = (await readdir(dir, { recursive: true })).filter((f) => f.endsWith(".md"));
-  } catch {
-    return [];
-  }
-  return await Promise.all(
-    files.map(async (file) => {
-      const raw = await readFile3(path3.join(dir, file), "utf8");
-      const block = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1];
-      let segment;
-      try {
-        segment = block ? parseYaml(block)?.segment : void 0;
-      } catch {
-        segment = void 0;
-      }
-      const title = raw.match(/^#\s+(.+)$/m)?.[1]?.trim();
-      return {
-        slug: path3.basename(file, ".md"),
-        ...title ? { title } : {},
-        ...typeof segment === "string" && segment.trim() ? { segment: segment.trim() } : {}
-      };
-    })
-  );
-}
-function bakerRead() {
-  const creds = requireCredentialsFromEnv();
-  const http = new HttpClient({ baseUrl: creds.url, apiKey: creds.apiKey, timeoutMs: 6e4, maxRetries: 1 });
-  return (apiPath, params) => http.getJson(params ? `${apiPath}?${new URLSearchParams(params)}` : apiPath);
-}
-async function metaAccountIds(read) {
-  const named = process.env.BAKER_META_AD_ACCOUNT_ID;
-  if (named) return [named];
-  const accounts = await read("/api/ads/meta/accounts");
-  return accounts.flatMap((a) => {
-    const id = a.externalId ?? a.id;
-    return typeof id === "string" && id ? [id] : [];
-  });
-}
-async function metaAdSetViewer(adSetId) {
-  const read = bakerRead();
-  for (const account of (await metaAccountIds(read)).slice(0, 5)) {
-    const params = { "account-id": account.startsWith("act_") ? account : `act_${account}` };
-    const adSet = (await read("/api/ads/meta/adsets", params)).find((row) => String(row.id) === adSetId);
-    if (!adSet) continue;
-    const [audiences, campaigns] = await Promise.all([
-      read("/api/ads/meta/audiences", params).catch(() => []),
-      read("/api/ads/meta/campaigns", params).catch(() => [])
-    ]);
-    return adSetViewerRows([adSet], audiences, campaigns)[0]?.viewer ?? null;
-  }
-  return null;
-}
-function liveViewerLookups(workspaceRoot) {
-  return {
-    adSetViewer: metaAdSetViewer,
-    personas: () => readPersonas(workspaceRoot),
-    companyMarket: async () => marketFromCompanyDoc(await readFile3(path3.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => null)),
-    company: async () => (await readFile3(path3.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => "")).slice(0, 800)
-  };
-}
-function gatewayViewerModel(model, onSpend) {
-  return (prompt) => askAboutText(model, prompt, onSpend);
-}
-var SKIP_WORDS = {
-  fix: "a correction of a version already checked",
-  resume: "a resumed render, checked when it started",
-  asked: "--skip-viewer-check"
-};
-function viewerCheckSkip(run) {
-  if (run.fix || run.useVariant || run.relaid || run.autoFixRound > 0) return "fix";
-  if (run.resumed) return "resume";
-  return run.asked ? "asked" : null;
-}
-async function viewerCheckBeforeRender(opts) {
-  let creative;
-  try {
-    creative = await readCreativeForViewerCheck(opts.creativeDir);
-  } catch (e) {
-    return {
-      viewer: null,
-      lines: [`[warn] viewer_check_skipped: prompt.json could not be read for the viewer check (${e instanceof Error ? e.message : String(e)}).`]
-    };
-  }
-  const resolved = await resolveViewer(creative.sources, opts.lookups);
-  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 casting = (async () => castingCheck(
-    {
-      people: creative.ad.people ?? [],
-      company: await opts.lookups.company?.().catch(() => "") ?? "",
-      ...resolved.viewer.market ? { market: describeMarket(resolved.viewer.market) } : {},
-      ...creative.ad.intended.persona ? { persona: creative.ad.intended.persona } : {}
-    },
-    { cacheDir: opts.cacheDir, model: opts.model, ask: opts.ask }
-  ))().catch(() => ({ status: "unavailable" }));
-  const outcome = await checkViewer({ ...creative.ad, viewer: resolved.viewer }, opts);
-  if (outcome.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 (outcome.status === "failed" && !opts.spent) {
-    return { viewer: resolved.viewer, lines, failure: viewerCheckFailure(outcome, opts.slug) };
-  } else if (outcome.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: ${outcome.verdict.missed.map(missLine).join(" ")}`
-    );
-  } else {
-    lines.push(`[viewer] ${who} understood it: ${outcome.answer.offer.answer}${outcome.cached ? " (cached)" : ""}.`);
-  }
-  if (outcome.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 };
-}
-var DESCRIPTION = "Would the person this ad reaches understand it? A model plays the viewer the creative is for (the `viewer` in _definition.md, else the one its `targetAdSet` reaches, else the persona and awareness in the Knowledge, else a cold stranger) and says, from prompt.json's copy and scene alone, what is offered, to whom and what to do next; the answer is compared with prompt.json's `message`. Start here after writing the copy, before rendering: baker canvas viewer-check spring-offer. `baker canvas run` makes the same check before it spends, from the same cache, and refuses a static ad the viewer would not understand (exit 2, `viewer_check_failed`, `fix` saying what they missed). Output is compact; --full adds the viewer's whole answer and why that viewer was chosen.";
-var ARGS = {
-  slug: {
-    type: "positional",
-    required: true,
-    description: "The creative: its slug (src/creatives/<slug>/), or the path to its folder, canvas or prompt.json."
-  },
-  full: {
-    type: "boolean",
-    required: false,
-    default: false,
-    description: "Add the viewer's whole answer, what the ad means to say, and how the viewer was resolved."
-  }
-};
-registerSchema({ command: "canvas.viewer-check", description: DESCRIPTION, args: ARGS });
-async function creativeDirOf(arg, workspaceRoot) {
-  const direct = path3.resolve(arg);
-  try {
-    return (await stat(direct)).isDirectory() ? direct : path3.dirname(direct);
-  } catch {
-    return path3.join(workspaceRoot, "src", "creatives", arg);
-  }
-}
-var viewerCheckCommand = defineCommand({
-  meta: { name: "viewer-check", description: DESCRIPTION },
-  args: ARGS,
-  async run({ args }) {
-    const cwd = process.cwd();
-    const workspaceRoot = findWorkspaceRoot(cwd) ?? cwd;
-    const creativeDir = await creativeDirOf(String(args.slug), workspaceRoot);
-    const slug = path3.basename(creativeDir);
-    let creative;
-    try {
-      creative = await readCreativeForViewerCheck(creativeDir);
-    } catch (e) {
-      writeJson({
-        ok: false,
-        error: {
-          code: "NOT_FOUND",
-          message: `No readable prompt.json in ${creativeDir} (${e instanceof Error ? e.message : String(e)}).`,
-          fix: "Pass the creative's slug (src/creatives/<slug>/) or its folder; its prompt.json must parse."
-        }
-      });
-      process.exit(1);
-    }
-    const resolved = await resolveViewer(creative.sources, liveViewerLookups(workspaceRoot));
-    const input = { ...creative.ad, viewer: resolved.viewer };
-    const cacheDir = path3.join(workspaceRoot, "canvas", ".cache");
-    const spent = [];
-    const outcome = await checkViewer(input, {
-      cacheDir,
-      model: VIEWER_CHECK_MODEL,
-      ask: gatewayViewerModel(VIEWER_CHECK_MODEL, (usage) => spent.push(usage))
-    });
-    await holdUnbilledSpend(cacheDir, spent);
-    const who = describeViewer(resolved.viewer);
-    const detail = args.full ? {
-      viewer_profile: resolved.viewer,
-      viewer_from: resolved.from,
-      intended: input.intended,
-      ...outcome.status !== "unavailable" ? { answer: outcome.answer } : {},
-      ...resolved.notes.length > 0 ? { notes: resolved.notes } : {}
-    } : {};
-    if (outcome.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: outcome.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: ${outcome.verdict.missed.map(missLine).join(" ")}`
-          ]
-        });
-        return;
-      }
-      if (turnId) await writeTurnRenders(cacheDir, recordViewerFail(ledger, turnId, slug));
-      const failure = viewerCheckFailure(outcome, slug);
-      writeJson({ ...failure, error: { ...failure.error, ...detail } });
-      process.exit(2);
-    }
-    if (outcome.status === "unavailable") {
-      writeJson({
-        ok: true,
-        data: { checked: false, viewer: who, ...detail },
-        hints: [
-          "The viewer model did not answer (no gateway key here, or it failed twice). Read the copy as this viewer yourself, or run the check again."
-        ]
-      });
-      return;
-    }
-    writeJson({
-      ok: true,
-      data: {
-        checked: true,
-        understood: true,
-        viewer: who,
-        offer: outcome.answer.offer.answer,
-        for_whom: outcome.answer.for_whom.answer,
-        next_step: outcome.answer.next_step.answer,
-        ...outcome.cached ? { cached: true } : {},
-        ...detail
-      },
-      hints: [
-        resolved.from === "default" ? "Checked against a cold stranger because nothing says who will see this ad: record `targetAdSet` and `viewer` in _definition.md (`baker ads meta adsets --audience`) when it will run in a known ad set." : `Checked against ${who}. Render it: baker canvas run --slug ${slug}`
-      ]
-    });
-  }
-});
-
-export {
-  turnRenderRefusal,
-  recordTurnRender,
-  roundFitsTurn,
-  recordViewerFail,
-  viewerChecksSpent,
-  readTurnRenders,
-  writeTurnRenders,
-  marketQuery,
-  VIEWER_QUESTIONS,
-  VIEWER_CLARITY,
-  ViewerAnswerSchema,
-  VIEWER_REQUIRED_CLARITY,
-  looksEnglish,
-  misread,
-  judgeViewerAnswer,
-  buildViewerPrompt,
-  viewerCheckCacheKey,
-  checkViewer,
-  describeViewer,
-  viewerCheckFailure,
-  personaSegments,
-  resolveViewer,
-  readCreativeForViewerCheck,
-  readPersonas,
-  liveViewerLookups,
-  gatewayViewerModel,
-  viewerCheckSkip,
-  viewerCheckBeforeRender,
-  viewerCheckCommand
-};
-//# sourceMappingURL=chunk-LXUEWTHJ.js.map