@koda-sl/baker-cli 0.481.0-dev.2d33e194f → 0.482.0-dev.a5555ab55

package/dist/chunk-GM46ZEYP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/viewer-check.ts","../src/commands/canvas/casting-check.ts","../src/commands/canvas/turn-renders.ts"],"sourcesContent":["/**\n * Would the person this ad reaches understand it?\n *\n * A static ad is judged by who sees it. A production Session shipped a whiteboard reading\n * \"Reasons I joined the Club®\" to a prospecting ad set: a stranger does not know there is a\n * club, what it is, or that it is about driving jobs. Every check the run had passed it,\n * because they asked whether the words were spelled right, not whether anyone could tell\n * what was on offer. The same words would have been fine for someone who had been to the\n * site.\n *\n * So before anything is rendered, a model plays the viewer the ad set reaches (what they\n * already know, where they scroll) and says, from the words and the picture alone, what is\n * offered, to whom, and what to do next. The decision model (Jev), not the viewer, compares that\n * with what the concept means to say, in whatever language each is written. The viewer decides:\n * there is no rule about temperature.\n */\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { VIEWER_CHECK_MODEL } from \"@baker/canvas-contract\";\nimport { defineCommand } from \"citty\";\nimport { parse as parseYaml } from \"yaml\";\nimport { z } from \"zod\";\nimport { askJev } from \"../../engine/nodes/local/lib/jev.ts\";\nimport { askAboutText, type ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { readAdSpec } from \"../../engine/scaffold/static-ad-spec.ts\";\nimport { requireCredentialsFromEnv } from \"../../engine/client/env.ts\";\nimport { HttpClient } from \"../../engine/client/http.ts\";\nimport { optionalTurnId } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  AWARENESS_VALUES,\n  type Awareness,\n  describeMarket,\n  marketFromCompanyDoc,\n  type ViewerMarket,\n  viewerFromKnowledge,\n  VIEWER_KNOWS_VALUES,\n  VIEWER_SOURCE_VALUES,\n  VIEWER_TEMPERATURE_VALUES,\n  type ViewerProfile,\n} from \"../../viewer-profile.ts\";\nimport { readAudienceNames } from \"../../audience-names.ts\";\nimport { rememberedJev } from \"../../engine/lib/remembered-nouls.ts\";\nimport { adSetViewerRows, audienceNamesOf } from \"../ads/meta/adset-viewers.ts\";\nimport { companyLine, readCompanyReading } from \"../../engine/creative-context/company.ts\";\nimport { briefRules } from \"../../engine/creative-rules/select.ts\";\nimport { heldRules } from \"./rule-gate.ts\";\nimport { findWorkspaceRoot } from \"./normalize-paths.ts\";\nimport { holdUnbilledSpend } from \"./unbilled-spend.ts\";\nimport { type CastingOutcome, castingCheck, castingCheckFailure } from \"./casting-check.ts\";\nimport { readTurnRenders, recordViewerFail, updateTurnRenders, viewerChecksSpent } from \"./turn-renders.ts\";\n\nexport const VIEWER_QUESTIONS = [\"offer\", \"for_whom\", \"next_step\"] as const;\nexport type ViewerQuestion = (typeof VIEWER_QUESTIONS)[number];\n\nexport const VIEWER_CLARITY = [\"clear\", \"guess\", \"unclear\"] as const;\nexport type ViewerClarity = (typeof VIEWER_CLARITY)[number];\n\nconst ViewerReply = z.object({ answer: z.string().default(\"\"), clarity: z.enum(VIEWER_CLARITY) });\n\n/** What the viewer model answers: each question with how sure it is, and what it would need to be told. */\nexport const ViewerAnswerSchema = z.object({\n  offer: ViewerReply,\n  for_whom: ViewerReply,\n  next_step: ViewerReply,\n  /** The words that talk to the viewer as if they had already done something with the brand; \"\" when none. */\n  presumes: z.string().default(\"\"),\n  missing: z.string().default(\"\"),\n});\nexport type ViewerAnswer = z.infer<typeof ViewerAnswerSchema>;\n\n/** What the concept means the viewer to take away (`prompt.json` `message`, the persona it is written for). */\nexport type ViewerIntended = {\n  offer?: string;\n  persona?: string;\n  /** What the company sells, in a few words (COMPANY.md's first line): a viewer sure of it read the offer. */\n  sells?: string;\n};\n\nexport type ViewerMiss =\n  | {\n      question: ViewerQuestion;\n      /** `unclear`: they could not tell. `guessed`: they had to infer it. `misread`: they were sure, and wrong. */\n      reason: \"unclear\" | \"guessed\" | \"misread\";\n      viewerSaid: string;\n      intended?: string;\n    }\n  | {\n      /** The ad talks to them as someone who already bought, signed up, tried or gave; they have not. */\n      question: \"presumes\";\n      reason: \"presumed\";\n      /** The words that presume it. */\n      viewerSaid: string;\n    };\n\nexport type ViewerVerdict = { pass: boolean; missed: ViewerMiss[] };\n\n/**\n * The least each answer must reach. What is offered has to be said by the ad; what to do\n * next may be inferred (the platform's button carries it). Who it is for is asked, and goes\n * into the fix, but never fails an ad alone: on E8 (BENCH.md) it decided no ad that did not\n * work and failed ads that did, where the offer itself says who it is for (an Audi finance\n * deal). One table so the calibration set moves a threshold here, not in the judge.\n */\nexport const VIEWER_REQUIRED_CLARITY: Readonly<Record<ViewerQuestion, ViewerClarity>> = {\n  offer: \"clear\",\n  for_whom: \"unclear\",\n  next_step: \"guess\",\n};\n\nconst RANK: Readonly<Record<ViewerClarity, number>> = { unclear: 0, guess: 1, clear: 2 };\n\n/** A reply at least as sure as `least`. Pure. */\nexport const sureEnough = (clarity: ViewerClarity, least: ViewerClarity): boolean => RANK[clarity] >= RANK[least];\n\n/**\n * At or above this, the decision model says the viewer read the offer the ad means. Measured on\n * 30 readings in 9 languages (scripts/viewer-read-evals): read 0.77–0.98, misread 0.26 or less.\n */\nexport const OFFER_READ = 0.5;\n\nconst READ_QUESTION =\n  \"A viewer said an ad offers `viewer_said`; the ad means `meant`. Does `viewer_said` name the same thing on offer as `meant`, in other words or in another language? A general kind of thing that covers it counts (delivery driver jobs for van driving work).\";\nconst SELLS_QUESTION =\n  \"A viewer said an ad offers `viewer_said`. Is `viewer_said` about what `company_sells` describes: the same product or service, a part of it, or a step toward buying it (a quote, a survey, a trial), in any language?\";\n\n/** For each reading, the probability it names what the ad means (or what the company sells); null when no judgment came back. */\nexport type ReadJudge = (\n  pairs: ReadonlyArray<{ said: string; meant: string; sells?: string }>,\n) => Promise<number[] | null>;\n\n/**\n * The decision model as the judge, its spend reported to `onSpend`: one Noul against what the ad\n * means and one against what the company sells, the higher kept. A message written as a promise\n * or a belief names no product, and a viewer who named the product read it (Dev, Oct 2026).\n */\nexport function jevReadJudge(onSpend?: (usage: ReviewUsage) => void): ReadJudge {\n  return async (pairs) => {\n    const questions = pairs.flatMap((p): Array<{ instructions: Record<string, string> }> => [\n      { instructions: { viewer_said: p.said, meant: p.meant, question: READ_QUESTION } },\n      ...(p.sells ? [{ instructions: { viewer_said: p.said, company_sells: p.sells, question: SELLS_QUESTION } }] : []),\n    ]);\n    const answers = await askJev(questions, onSpend);\n    if (answers === null) return null;\n    let next = 0;\n    return pairs.map((p) => {\n      const meant = answers[next++] ?? 0;\n      return p.sells ? Math.max(meant, answers[next++] ?? 0) : meant;\n    });\n  };\n}\n\n/**\n * Which of the viewer's readings name something other than what the ad means: the decision model\n * reads both in whatever language each is written (the viewer answers in English; the ad's message\n * is in the ad's). A pair with nothing to compare, or no judgment at all, is never a misreading: the\n * check does not refuse an ad on a guess. One request for every pair.\n */\nexport async function misreadings(\n  pairs: ReadonlyArray<{ said: string; meant?: string | undefined; sells?: string | undefined }>,\n  judge: ReadJudge,\n): Promise<boolean[]> {\n  const asked = pairs.flatMap((p, i) =>\n    p.said.trim() && p.meant?.trim()\n      ? [{ i, pair: { said: p.said.trim(), meant: p.meant.trim(), ...(p.sells?.trim() ? { sells: p.sells.trim() } : {}) } }]\n      : [],\n  );\n  const out = pairs.map(() => false);\n  if (asked.length === 0) return out;\n  const judged = await judge(asked.map((a) => a.pair)).catch(() => null);\n  if (judged === null) return out;\n  asked.forEach((a, k) => {\n    const p = judged[k];\n    out[a.i] = p !== undefined && p < OFFER_READ;\n  });\n  return out;\n}\n\n/** Whether the viewer understood the ad well enough, and what they missed. Pure. */\nexport function judgeViewerAnswer(\n  answer: ViewerAnswer,\n  intended: ViewerIntended,\n  required: Readonly<Record<ViewerQuestion, ViewerClarity>> = VIEWER_REQUIRED_CLARITY,\n  /** The decision model said the viewer, sure of the offer, named something else (`misreadings`). */\n  offerMisread = false,\n): ViewerVerdict {\n  const missed: ViewerMiss[] = [];\n  for (const question of VIEWER_QUESTIONS) {\n    const reply = answer[question];\n    const meant = question === \"offer\" ? intended.offer : question === \"for_whom\" ? intended.persona : undefined;\n    const withIntended = meant ? { intended: meant } : {};\n    if (RANK[reply.clarity] < RANK[required[question]]) {\n      missed.push({\n        question,\n        reason: reply.clarity === \"unclear\" ? \"unclear\" : \"guessed\",\n        viewerSaid: reply.answer,\n        ...withIntended,\n      });\n    } else if (question === \"offer\" && offerMisread) {\n      // Only the offer is compared: who an ad is for is said in too many ways\n      // (\"unemployed men 25-45\" vs \"people looking for driving work\") to hold against an ad.\n      missed.push({ question, reason: \"misread\", viewerSaid: reply.answer, ...withIntended });\n    }\n  }\n  if (answer.presumes.trim()) missed.push({ question: \"presumes\", reason: \"presumed\", viewerSaid: answer.presumes.trim() });\n  return { pass: missed.length === 0, missed };\n}\n\n// --- The viewer's question ---\n\n/** One line of the ad's copy, the thing in the picture it is written on when lettered in the scene, and its role. */\nexport type ViewerCopyLine = { text: string; on?: string; role?: string };\n\n/** Roles a glance never reads: the small print. */\nconst SMALL_PRINT = /^(fine_print|legal|disclaimer|footnote)$/;\n\n/** Everything the viewer check reads: what is on the ad, who sees it, and what it means to say. */\nexport type ViewerCheckInput = {\n  copy: ViewerCopyLine[];\n  /** The picture, in words (`prompt.json` scene). */\n  scene: string;\n  /** The advertiser's name, which the platform prints above every ad. */\n  brand?: string;\n  viewer: ViewerProfile;\n  intended: ViewerIntended;\n};\n\n/** Where the viewer meets the ad. Advantage+ (\"automatic\") includes Stories and Reels. */\nfunction wherePhrase(placements: readonly string[]): string {\n  const fullScreen = placements.length === 0 || placements.some((p) => /automatic|stor|reel/i.test(p));\n  return fullScreen\n    ? \"full screen through Instagram or Facebook Stories and Reels, thumb ready to swipe\"\n    : \"through your Instagram or Facebook feed\";\n}\n\n/**\n * What the viewer already knows, in their own terms. Only a viewer who knows the offer is told it.\n * The advertiser is never named: a stranger does not know whose ad it is, so the words must say it.\n */\nfunction knowledgePhrase(viewer: ViewerProfile, offer: string | undefined): string {\n  const brand = \"the advertiser\";\n  if (!viewer.knows.includes(\"brand\")) return `You have never heard of ${brand} and know nothing about what it sells.`;\n  const offerPart = viewer.knows.includes(\"offer\")\n    ? offer\n      ? ` You know what they offer: ${offer}.`\n      : \" You know what they offer.\"\n    : \" You do not know what they are offering right now.\";\n  const product = viewer.knows.includes(\"product\") ? \" You have used what they sell.\" : \"\";\n  return `You have come across ${brand} before.${offerPart}${product}`;\n}\n\n/**\n * The viewer model's prompt. Written to the reader guidance for Gemini 3 text models\n * (`.context/prompting-google-gemini-image.md` §2, §7): short, the purpose stated, the data\n * first and the question last, the answer a fixed JSON the code grades — the model is never\n * asked whether the ad \"works\", only what it understood. Pure.\n */\nexport function buildViewerPrompt(input: ViewerCheckInput): string {\n  const brand = \"the advertiser\";\n  // Only a stranger can be talked to as a returning customer by mistake: retargeting copy\n  // (\"still in your cart\", \"thanks for your donation last winter\") is right for the viewer who knows the brand.\n  const stranger = !input.viewer.knows.includes(\"brand\");\n  // A glance reads the big words and skips the small print.\n  const read = input.copy.filter((line) => !SMALL_PRINT.test((line.role ?? \"\").trim().toLowerCase().replace(/[\\s-]+/g, \"_\")));\n  const words =\n    read.length > 0\n      ? read.map((line) => `- \"${line.text}\"${line.on ? ` (written on the ${line.on})` : \"\"}`).join(\"\\n\")\n      : \"- none: the picture is the whole ad\";\n  return [\n    `${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)}`,\n    `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\"):`,\n    \"\",\n    `Picture: ${input.scene.trim()}`,\n    \"Words on it:\",\n    words,\n    \"\",\n    \"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.\",\n    '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.',\n    \"offer: what is being offered?\",\n    \"for_whom: who is it for?\",\n    \"next_step: what would you do next if you wanted it?\",\n    ...(stranger\n      ? [\n          `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.`,\n        ]\n      : []),\n    'missing: in one short sentence, what you would need to be told to get it; \"\" when nothing.',\n    \"\",\n    `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\":\"\"}`,\n  ].join(\"\\n\");\n}\n\n/**\n * The cache key of one viewer check: the words, the picture, the viewer (what they know and\n * where they scroll, not how that was explained), what the ad means to say, the model, and\n * the prompt itself, so a rewritten prompt asks again. Pure.\n */\nexport function viewerCheckCacheKey(input: ViewerCheckInput, model: string): string {\n  const { temperature, knows, placements, market } = input.viewer;\n  const canonical = {\n    prompt: buildViewerPrompt({ ...input, viewer: { ...input.viewer, reasons: [] } }),\n    viewer: { temperature, knows: [...knows].sort(), placements: [...placements].sort(), ...(market ? { market } : {}) },\n    intended: input.intended,\n    model,\n  };\n  return createHash(\"sha256\").update(JSON.stringify(canonical)).digest(\"hex\");\n}\n\n/** The model boundary: the parsed JSON reply to one prompt, or null when no model answered. */\nexport type AskViewerModel = (prompt: string) => Promise<unknown>;\n\ntype JudgedViewerCheck = {\n  input: ViewerCheckInput;\n  answer: ViewerAnswer;\n  verdict: ViewerVerdict;\n  /** The answer came from the cache: nothing was asked or paid for. */\n  cached: boolean;\n};\n\nexport type ViewerCheckOutcome =\n  | (JudgedViewerCheck & { status: \"passed\" })\n  | (JudgedViewerCheck & { status: \"failed\" })\n  | { status: \"unavailable\"; input: ViewerCheckInput };\n\nasync function cachedAnswer(file: string): Promise<ViewerAnswer | null> {\n  try {\n    const parsed = ViewerAnswerSchema.safeParse(JSON.parse(await readFile(file, \"utf8\")));\n    return parsed.success ? parsed.data : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Ask the viewer, or read the answer this exact ad and viewer already got, and grade it.\n * The answer is what is cached, not the verdict, so a change to the judge re-grades for\n * free. A model that does not answer (twice) or answers out of shape is `unavailable`:\n * the caller lets the render through and says it was not checked.\n */\nexport async function checkViewer(\n  input: ViewerCheckInput,\n  opts: {\n    cacheDir: string;\n    model: string;\n    ask: AskViewerModel;\n    /** Whether the viewer read the offer the ad means (`misreadings`); the decision model unless given. */\n    judge?: ReadJudge;\n  },\n): Promise<ViewerCheckOutcome> {\n  const file = path.join(opts.cacheDir, \"viewer-check\", `${viewerCheckCacheKey(input, opts.model)}.json`);\n  let answer = await cachedAnswer(file);\n  const cached = answer !== null;\n  const prompt = buildViewerPrompt(input);\n  for (let attempt = 0; answer === null && attempt < 2; attempt++) {\n    const parsed = ViewerAnswerSchema.safeParse(await opts.ask(prompt));\n    if (parsed.success) answer = parsed.data;\n  }\n  if (answer === null) return { status: \"unavailable\", input };\n  if (!cached) {\n    await mkdir(path.dirname(file), { recursive: true });\n    await writeFile(file, `${JSON.stringify(answer, null, 2)}\\n`, \"utf8\");\n  }\n  // Only a viewer sure enough of the offer can have misread it.\n  const sure = sureEnough(answer.offer.clarity, VIEWER_REQUIRED_CLARITY.offer);\n  const [offerMisread = false] = sure\n    ? await misreadings(\n        [{ said: answer.offer.answer, meant: input.intended.offer, sells: input.intended.sells }],\n        opts.judge ?? jevReadJudge(),\n      )\n    : [];\n  const verdict = judgeViewerAnswer(answer, input.intended, VIEWER_REQUIRED_CLARITY, offerMisread);\n  const judged = { input, answer, verdict, cached };\n  return verdict.pass ? { ...judged, status: \"passed\" } : { ...judged, status: \"failed\" };\n}\n\n/** The viewer in one phrase, for the agent: \"a cold viewer who knows nothing about the brand yet, on automatic placements\". */\nexport function describeViewer(viewer: ViewerProfile): string {\n  const known = viewer.knows.map((k) => `the ${k}`);\n  const knows =\n    known.length > 0\n      ? `who knows ${known.length > 1 ? `${known.slice(0, -1).join(\", \")} and ${known.at(-1)}` : known[0]}`\n      : \"who knows nothing about the brand yet\";\n  return `a ${viewer.temperature} viewer ${knows}, on ${viewer.placements.join(\", \") || \"automatic\"} placements`;\n}\n\nconst QUESTION_WORDS: Readonly<Record<ViewerQuestion, string>> = {\n  offer: \"what is offered\",\n  for_whom: \"who it is for\",\n  next_step: \"what to do next\",\n};\n\nfunction missLine(miss: ViewerMiss): string {\n  if (miss.question === \"presumes\") {\n    return `The words talk to them as if they had already done something with the brand: \"${miss.viewerSaid}\". They have not.`;\n  }\n  const said = miss.viewerSaid.trim() ? `\"${miss.viewerSaid.trim()}\"` : \"nothing\";\n  const how =\n    miss.reason === \"misread\"\n      ? `was sure it is ${said}`\n      : miss.reason === \"guessed\"\n        ? `could only guess ${said}`\n        : `could not tell (said ${said})`;\n  const question = QUESTION_WORDS[miss.question];\n  return `${question.charAt(0).toUpperCase()}${question.slice(1)}: they ${how}${miss.intended ? `; the ad means \"${miss.intended}\"` : \"\"}.`;\n}\n\n/** The `{ ok: false, error }` a failed check prints: what the viewer missed, and the rewrite that fixes it. Pure. */\nexport function viewerCheckFailure(\n  outcome: Extract<ViewerCheckOutcome, { status: \"failed\" }>,\n  slug: string,\n): { ok: false; error: { code: \"viewer_check_failed\"; message: string; fix: string; viewer: ViewerProfile; missed: ViewerMiss[] } } {\n  const { viewer } = outcome.input;\n  const who = describeViewer(viewer);\n  const missing = outcome.answer.missing.trim();\n  const unsaid = outcome.verdict.missed.flatMap((m) => (m.question === \"presumes\" ? [] : [QUESTION_WORDS[m.question]]));\n  // The one rewrite that answers a missed offer, so it takes one edit, not seven (dev, Oct 2026).\n  const offer = outcome.input.intended.offer?.trim();\n  const rewrite =\n    offer && outcome.verdict.missed.some((m) => m.question === \"offer\")\n      ? [`Do this: make the biggest words say \"${offer}\", plainly, in the ad's language; keep the rest.`]\n      : [];\n  const fix = [\n    ...rewrite,\n    ...(unsaid.length > 0 ? [`Seen by ${who}, the words and picture alone do not say ${unsaid.join(\" or \")}.`] : [`Seen by ${who}:`]),\n    ...outcome.verdict.missed.map(missLine),\n    ...(missing ? [`They needed: ${missing}`] : []),\n    \"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.\",\n    // The run asks the viewer itself, from the same cache: a separate check is one more wait (dev, Oct 2026).\n    `Then run the same \\`baker canvas run\\` again: it checks the new copy before it spends (or \\`baker canvas viewer-check ${slug}\\` alone).`,\n    \"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.\",\n  ].join(\" \");\n  return {\n    ok: false,\n    error: {\n      code: \"viewer_check_failed\",\n      message: `Not rendered: ${who} would not understand this ad.`,\n      fix,\n      viewer,\n      missed: outcome.verdict.missed,\n    },\n  };\n}\n\n// --- Who sees the ad ---\n\n/** The `viewer` a `_definition.md` records, as `baker ads meta adsets --audience` prints it. */\nconst RecordedViewer = z.object({\n  temperature: z.enum(VIEWER_TEMPERATURE_VALUES),\n  knows: z.array(z.enum(VIEWER_KNOWS_VALUES)).default([]),\n  placements: z.array(z.string().min(1)).default([\"automatic\"]),\n  source: z.enum(VIEWER_SOURCE_VALUES),\n  reasons: z.array(z.string()).default([]),\n  market: z\n    .object({\n      country: z.string().min(2),\n      language: z.string().optional(),\n      currency: z.string().optional(),\n      address: z.string().optional(),\n    })\n    .optional(),\n});\n\n/** What a creative says about who will see it: `_definition.md`'s `viewer`, `targetAdSet`, `persona`, `awareness`. */\nexport type ViewerSources = { recorded?: unknown; targetAdSet?: string; persona?: string; awareness?: Awareness };\n\n/** One persona in the Knowledge (`src/content/personas/`): its file name, title and `segment`. */\nexport type PersonaEntry = { slug: string; title?: string; segment?: string };\n\n/** The reads resolving a viewer may need. Injected so the order is tested without an ad account. */\nexport type ViewerLookups = {\n  /** The viewer the ad set reaches (`classifyAudience`), or null when no connected account holds it. */\n  adSetViewer: (adSetId: string) => Promise<ViewerProfile | null>;\n  personas: () => Promise<PersonaEntry[]>;\n  /** The market COMPANY.md names (`marketFromCompanyDoc`), for a viewer read with none. */\n  companyMarket?: () => Promise<ViewerMarket | undefined>;\n  /** What the company sells, from its reading, for the casting check. */\n  company?: () => Promise<string>;\n  /** The company's rules about who appears that hold for this ad (its scope, its waivers), for the casting check. */\n  castRules?: (creativeDir: string) => Promise<string[]>;\n};\n\nexport type ResolvedViewer = {\n  viewer: ViewerProfile;\n  from: \"recorded\" | \"ad_set\" | \"knowledge\" | \"default\";\n  /** What could not be read on the way, in the order it was tried. */\n  notes: string[];\n};\n\n/** A name as it compares: accents and case off, words only (\"Pet-owners\" and \"pet owners\" alike). */\nconst nameKey = (text: string): string =>\n  text\n    .normalize(\"NFD\")\n    .replace(/\\p{M}/gu, \"\")\n    .toLowerCase()\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter(Boolean)\n    .join(\" \");\n\n/**\n * The segments the concept is written for: the persona the creative names, matched to its\n * entry in the Knowledge by file name, title or segment (or taken as written when none\n * matches); every persona on file when it names none. Pure.\n */\nexport function personaSegments(persona: string | undefined, entries: readonly PersonaEntry[]): string[] {\n  const describe = (entry: PersonaEntry) => entry.segment ?? entry.title ?? entry.slug;\n  if (!persona?.trim()) return entries.map(describe);\n  const wanted = nameKey(persona);\n  const match = entries.find((entry) =>\n    [entry.slug.replace(/[-_]/g, \" \"), entry.title, entry.segment].some((name) => name && nameKey(name) === wanted),\n  );\n  return [match ? describe(match) : persona.trim()];\n}\n\n/**\n * The viewer an ad is checked against, in this order: the one recorded in `_definition.md`;\n * the one its `targetAdSet` reaches; the one the Knowledge describes (personas and the\n * concept's awareness); a cold stranger, saying so.\n */\nexport async function resolveViewer(sources: ViewerSources, lookups: ViewerLookups): Promise<ResolvedViewer> {\n  const resolved = await resolveViewerAlone(sources, lookups);\n  if (resolved.viewer.market || !lookups.companyMarket) return resolved;\n  const market = await lookups.companyMarket().catch(() => undefined);\n  return market ? { ...resolved, viewer: { ...resolved.viewer, market } } : resolved;\n}\n\nasync function resolveViewerAlone(sources: ViewerSources, lookups: ViewerLookups): Promise<ResolvedViewer> {\n  const notes: string[] = [];\n  if (sources.recorded !== undefined) {\n    const recorded = RecordedViewer.safeParse(sources.recorded);\n    if (recorded.success) return { viewer: recorded.data, from: \"recorded\", notes };\n    notes.push(\"The viewer recorded in _definition.md is not in the shape `baker ads meta adsets --audience` prints; it was skipped.\");\n  }\n  if (sources.targetAdSet) {\n    try {\n      const fromAdSet = await lookups.adSetViewer(sources.targetAdSet);\n      if (fromAdSet) return { viewer: fromAdSet, from: \"ad_set\", notes };\n      notes.push(`Ad set ${sources.targetAdSet} is not in any connected Meta ad account.`);\n    } catch (e) {\n      notes.push(`Could not read ad set ${sources.targetAdSet} (${e instanceof Error ? e.message : String(e)}).`);\n    }\n  }\n  let entries: PersonaEntry[] = [];\n  try {\n    entries = await lookups.personas();\n  } catch (e) {\n    notes.push(`Could not read the personas in the Knowledge (${e instanceof Error ? e.message : String(e)}).`);\n  }\n  const personas = personaSegments(sources.persona, entries);\n  if (personas.length > 0 || sources.awareness) {\n    return { viewer: viewerFromKnowledge({ personas, awareness: sources.awareness }), from: \"knowledge\", notes };\n  }\n  return {\n    viewer: {\n      temperature: \"cold\",\n      knows: [],\n      placements: [\"automatic\"],\n      source: \"knowledge\",\n      reasons: [\n        \"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.\",\n      ],\n    },\n    from: \"default\",\n    notes,\n  };\n}\n\n// --- Reading a creative ---\n\n/** The ad as the viewer check reads it, before the viewer is known, and the people it casts (D2). */\nexport type CreativeAd = Omit<ViewerCheckInput, \"viewer\"> & { people?: string[] };\n\nconst Frontmatter = z.object({\n  viewer: z.unknown().optional(),\n  targetAdSet: z.union([z.string(), z.number()]).transform(String).optional(),\n  persona: z.string().optional(),\n  awareness: z.enum(AWARENESS_VALUES).optional().catch(undefined),\n  angle: z.string().optional(),\n});\n\nfunction frontmatterOf(raw: string): z.infer<typeof Frontmatter> {\n  const block = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/)?.[1];\n  if (!block) return {};\n  try {\n    const parsed = Frontmatter.safeParse(parseYaml(block));\n    return parsed.success ? parsed.data : {};\n  } catch {\n    return {};\n  }\n}\n\n/**\n * A creative folder read for the viewer check: the words, the picture and the brand from\n * `prompt.json` (an ad spec or an older blueprint, through `readAdSpec`), what the ad means\n * to say (`message`, else the definition's `angle`; the spec's viewer, else the `persona`),\n * and what `_definition.md` says about who will see it. Throws when `prompt.json` cannot be\n * read: there is no ad to check.\n */\nexport async function readCreativeForViewerCheck(creativeDir: string): Promise<{ ad: CreativeAd; sources: ViewerSources }> {\n  const spec = readAdSpec(JSON.parse(await readFile(path.join(creativeDir, \"prompt.json\"), \"utf8\")));\n  const definition = frontmatterOf(await readFile(path.join(creativeDir, \"_definition.md\"), \"utf8\").catch(() => \"\"));\n  const offer = spec.message?.trim() || definition.angle?.trim();\n  const persona = spec.viewer?.who.trim() || definition.persona?.trim();\n  const brand = spec.brand?.name?.trim();\n  // src/creatives/<slug>/ → the workspace, whose company reading says what it sells.\n  const sells = (await readCompanyReading(path.resolve(creativeDir, \"../../..\")))?.sells;\n  return {\n    ad: {\n      copy: spec.copy.map((line) => ({\n        text: line.text,\n        ...(line.lettering === \"in_scene\" && line.on ? { on: line.on } : {}),\n        ...(line.role ? { role: line.role } : {}),\n      })),\n      scene: spec.scene.description,\n      ...(brand ? { brand } : {}),\n      intended: { ...(offer ? { offer } : {}), ...(persona ? { persona } : {}), ...(sells ? { sells } : {}) },\n      ...castPeople(spec),\n    },\n    sources: {\n      ...(definition.viewer !== undefined ? { recorded: definition.viewer } : {}),\n      ...(definition.targetAdSet ? { targetAdSet: definition.targetAdSet } : {}),\n      ...(definition.persona?.trim() ? { persona: definition.persona.trim() } : {}),\n      ...(definition.awareness ? { awareness: definition.awareness } : {}),\n    },\n  };\n}\n\n/** The people a spec casts (from an avatar, or a picture of ours), in words, for the casting check. */\nfunction castPeople(spec: ReturnType<typeof readAdSpec>): { people?: string[] } {\n  const people = spec.references\n    .filter((r) => r.role === \"identity\" && (r.avatar || r.image) && !/^ANIMAL_/.test(r.id))\n    .map((r) => r.what);\n  return people.length > 0 ? { people } : {};\n}\n\n/** The personas in the Knowledge (`src/content/personas/**.md`), each with its `segment` and `# title`. */\nexport async function readPersonas(workspaceRoot: string): Promise<PersonaEntry[]> {\n  const dir = path.join(workspaceRoot, \"src\", \"content\", \"personas\");\n  let files: string[];\n  try {\n    files = (await readdir(dir, { recursive: true })).filter((f) => f.endsWith(\".md\"));\n  } catch {\n    return [];\n  }\n  return await Promise.all(\n    files.map(async (file) => {\n      const raw = await readFile(path.join(dir, file), \"utf8\");\n      const block = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/)?.[1];\n      let segment: unknown;\n      try {\n        segment = block ? (parseYaml(block) as { segment?: unknown } | null)?.segment : undefined;\n      } catch {\n        segment = undefined;\n      }\n      const title = raw.match(/^#\\s+(.+)$/m)?.[1]?.trim();\n      return {\n        slug: path.basename(file, \".md\"),\n        ...(title ? { title } : {}),\n        ...(typeof segment === \"string\" && segment.trim() ? { segment: segment.trim() } : {}),\n      };\n    }),\n  );\n}\n\n// --- Live reads ---\n\ntype MetaRow = Record<string, unknown>;\n\n/** One read of the Baker API, as the viewer lookups make it. */\ntype BakerRead = <T>(apiPath: string, params?: Record<string, string>) => Promise<T>;\n\n/**\n * Reads through the canvas engine's client, built from the connection alone: the CLI's\n * `apiGet` validates every optional override and ends the process on a malformed one, and\n * the render reads only the connection (`requireConnection`) so an unrelated override cannot\n * stop it. A missing connection throws here, and the lookup says so as a note.\n */\nfunction bakerRead(): BakerRead {\n  const creds = requireCredentialsFromEnv();\n  const http = new HttpClient({ baseUrl: creds.url, apiKey: creds.apiKey, timeoutMs: 60_000, maxRetries: 1 });\n  return (apiPath, params) => http.getJson(params ? `${apiPath}?${new URLSearchParams(params)}` : apiPath);\n}\n\n/** The Meta ad accounts to look an ad set up in: the one the Runtime names, else the connected ones. */\nasync function metaAccountIds(read: BakerRead): Promise<string[]> {\n  const named = process.env.BAKER_META_AD_ACCOUNT_ID;\n  if (named) return [named];\n  const accounts = await read<Array<{ externalId?: unknown; id?: unknown }>>(\"/api/ads/meta/accounts\");\n  return accounts.flatMap((a) => {\n    const id = a.externalId ?? a.id;\n    return typeof id === \"string\" && id ? [id] : [];\n  });\n}\n\n/** The viewer one Meta ad set reaches, read as `baker ads meta adsets --audience` reads it. */\nasync function metaAdSetViewer(adSetId: string, workspaceRoot: string): Promise<ViewerProfile | null> {\n  const read = bakerRead();\n  for (const account of (await metaAccountIds(read)).slice(0, 5)) {\n    const params = { \"account-id\": account.startsWith(\"act_\") ? account : `act_${account}` };\n    const adSet = (await read<MetaRow[]>(\"/api/ads/meta/adsets\", params)).find((row) => String(row.id) === adSetId);\n    if (!adSet) continue;\n    // The audience list and the objectives only sharpen the read, as in `adsets --audience`.\n    const [audiences, campaigns] = await Promise.all([\n      read<MetaRow[]>(\"/api/ads/meta/audiences\", params).catch(() => []),\n      read<MetaRow[]>(\"/api/ads/meta/campaigns\", params).catch(() => []),\n    ]);\n    const cacheDir = path.join(workspaceRoot, \"canvas\", \".cache\");\n    const spent: ReviewUsage[] = [];\n    const readName = await readAudienceNames(\n      audienceNamesOf([adSet], audiences),\n      rememberedJev(path.join(cacheDir, \"audience-names.json\"), (u) => spent.push(u)),\n    );\n    await holdUnbilledSpend(cacheDir, spent).catch(() => undefined);\n    return adSetViewerRows([adSet], audiences, campaigns, readName)[0]?.viewer ?? null;\n  }\n  return null;\n}\n\n/** The rules the casting question is told at most: who appears is a few lines of any brand's rules. */\nconst CAST_RULES = 8;\n\n/** The reads a real check makes: the Meta ad set through the API, the personas from the workspace. */\nexport function liveViewerLookups(workspaceRoot: string): ViewerLookups {\n  return {\n    adSetViewer: (adSetId) => metaAdSetViewer(adSetId, workspaceRoot),\n    personas: () => readPersonas(workspaceRoot),\n    companyMarket: async () =>\n      marketFromCompanyDoc(await readFile(path.join(workspaceRoot, \"COMPANY.md\"), \"utf8\").catch(() => null)),\n    company: async () => companyLine(await readCompanyReading(workspaceRoot)),\n    // Who appears, as the rules that hold for this ad say: a person's on its picture or cast, the brand's on\n    // its cast only (a brand document's picture rules are often its web design system's: `briefRules`).\n    castRules: async (creativeDir) =>\n      briefRules((await heldRules(creativeDir)).rules)\n        .filter((r) => r.applies === \"cast\" || (r.origin === \"learned\" && r.applies === \"picture\"))\n        .slice(0, CAST_RULES)\n        .map((r) => r.text),\n  };\n}\n\n/** The viewer model through the gateway, its spend reported to `onSpend`. */\nexport function gatewayViewerModel(model: string, onSpend?: (usage: ReviewUsage) => void): AskViewerModel {\n  return (prompt) => askAboutText(model, prompt, onSpend);\n}\n\n// --- Before a render ---\n\n/** Why a render goes without asking the viewer: a correction or a resumed render of an ad already checked, or the person's own call. */\nexport type ViewerCheckSkip = \"fix\" | \"resume\" | \"asked\" | null;\n\nconst SKIP_WORDS: Readonly<Record<Exclude<ViewerCheckSkip, null>, string>> = {\n  fix: \"a correction of a version already checked\",\n  resume: \"a resumed render, checked when it started\",\n  asked: \"--skip-viewer-check\",\n};\n\n/**\n * Why this render goes without asking the viewer, or null to ask: a correction (`--fix`, an autofix\n * round), a chosen option and a re-layout keep words already checked; an edit of the words is\n * asked about, since what it changed is what the viewer reads. Pure.\n */\nexport function viewerCheckSkip(run: {\n  fix: boolean;\n  useVariant: boolean;\n  relaid: boolean;\n  autoFixRound: number;\n  resumed: boolean;\n  asked: boolean;\n}): ViewerCheckSkip {\n  if (run.fix || run.useVariant || run.relaid || run.autoFixRound > 0) return \"fix\";\n  if (run.resumed) return \"resume\";\n  return run.asked ? \"asked\" : null;\n}\n\nexport type PreRenderViewerCheck = {\n  /** Who the ad is checked against, for the review after the render; null when the ad could not be read. */\n  viewer: ViewerProfile | null;\n  /** What to print on the run log. */\n  lines: string[];\n  /** Set when the viewer would not understand the ad, or its people would not pass: print it and exit 2, before anything is spent. */\n  failure?: ReturnType<typeof viewerCheckFailure> | ReturnType<typeof castingCheckFailure>;\n};\n\n/**\n * The check `baker canvas run` makes on a static ad before it spends: resolve the viewer,\n * ask them (from the cache when this ad and viewer were asked before), and refuse the\n * render when they would not understand it. A correction, a resumed render and an explicit\n * skip still resolve the viewer (the review after the render reads it) but ask nothing. A\n * model that does not answer lets the render through, saying so.\n */\nexport async function viewerCheckBeforeRender(opts: {\n  creativeDir: string;\n  cacheDir: string;\n  slug: string;\n  skip: ViewerCheckSkip;\n  /** This ad already failed the viewer twice in this turn (`viewerChecksSpent`): a miss is said, never held against the render. */\n  spent?: boolean;\n  lookups: ViewerLookups;\n  model: string;\n  ask: AskViewerModel;\n  /** Whether the viewer read the offer (`misreadings`); the decision model unless given. */\n  judge?: ReadJudge;\n}): Promise<PreRenderViewerCheck> {\n  let creative: Awaited<ReturnType<typeof readCreativeForViewerCheck>>;\n  try {\n    creative = await readCreativeForViewerCheck(opts.creativeDir);\n  } catch (e) {\n    return {\n      viewer: null,\n      lines: [`[warn] viewer_check_skipped: prompt.json could not be read for the viewer check (${e instanceof Error ? e.message : String(e)}).`],\n    };\n  }\n  const resolved = await resolveViewer(creative.sources, opts.lookups);\n  const who = describeViewer(resolved.viewer);\n  const lines = resolved.notes.map((note) => `[viewer] ${note}`);\n  if (opts.skip) return { viewer: resolved.viewer, lines: [...lines, `[viewer] not asked: ${SKIP_WORDS[opts.skip]}.`] };\n  // Who is cast, against who buys and where it runs (D2): asked alongside the viewer, never after it.\n  const casting = (async () =>\n    castingCheck(\n      {\n        people: creative.ad.people ?? [],\n        company: (await opts.lookups.company?.().catch(() => \"\")) ?? \"\",\n        rules: (await opts.lookups.castRules?.(opts.creativeDir).catch(() => [])) ?? [],\n        ...(resolved.viewer.market ? { market: describeMarket(resolved.viewer.market) } : {}),\n        ...(creative.ad.intended.persona ? { persona: creative.ad.intended.persona } : {}),\n      },\n      { cacheDir: opts.cacheDir, model: opts.model, ask: opts.ask },\n    ))().catch((): CastingOutcome => ({ status: \"unavailable\" }));\n  const outcome = await checkViewer({ ...creative.ad, viewer: resolved.viewer }, opts);\n  if (outcome.status === \"unavailable\") {\n    lines.push(\n      `[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.`,\n    );\n  } else if (outcome.status === \"failed\" && !opts.spent) {\n    return { viewer: resolved.viewer, lines, failure: viewerCheckFailure(outcome, opts.slug) };\n  } else if (outcome.status === \"failed\") {\n    lines.push(\n      `[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(\" \")}`,\n    );\n  } else {\n    lines.push(`[viewer] ${who} understood it: ${outcome.answer.offer.answer}${outcome.cached ? \" (cached)\" : \"\"}.`);\n  }\n  if (outcome.status === \"unavailable\") return { viewer: resolved.viewer, lines };\n  const cast = await casting;\n  if (cast.status === \"failed\") return { viewer: resolved.viewer, lines, failure: castingCheckFailure(cast.answer, opts.slug) };\n  if (cast.status === \"passed\") lines.push(`[casting] the people cast pass as real customers${cast.cached ? \" (cached)\" : \"\"}.`);\n  if (cast.status === \"unavailable\") {\n    lines.push(\"[warn] casting_check_unavailable: the model did not answer; check yourself that the people cast look like this company's real customers.\");\n  }\n  return { viewer: resolved.viewer, lines };\n}\n\n// --- `baker canvas viewer-check <slug>` ---\n\nconst DESCRIPTION =\n  \"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.\";\n\nconst ARGS = {\n  slug: {\n    type: \"positional\",\n    required: true,\n    description: \"The creative: its slug (src/creatives/<slug>/), or the path to its folder, canvas or prompt.json.\",\n  },\n  full: {\n    type: \"boolean\",\n    required: false,\n    default: false,\n    description: \"Add the viewer's whole answer, what the ad means to say, and how the viewer was resolved.\",\n  },\n} as const;\n\nregisterSchema({ command: \"canvas.viewer-check\", description: DESCRIPTION, args: ARGS });\n\n/** The creative folder an argument names: a path to it (or a file in it), else `src/creatives/<slug>/`. */\nasync function creativeDirOf(arg: string, workspaceRoot: string): Promise<string> {\n  const direct = path.resolve(arg);\n  try {\n    return (await stat(direct)).isDirectory() ? direct : path.dirname(direct);\n  } catch {\n    return path.join(workspaceRoot, \"src\", \"creatives\", arg);\n  }\n}\n\nexport const viewerCheckCommand = defineCommand({\n  meta: { name: \"viewer-check\", description: DESCRIPTION },\n  args: ARGS,\n  async run({ args }) {\n    const cwd = process.cwd();\n    const workspaceRoot = findWorkspaceRoot(cwd) ?? cwd;\n    const creativeDir = await creativeDirOf(String(args.slug), workspaceRoot);\n    const slug = path.basename(creativeDir);\n    let creative: Awaited<ReturnType<typeof readCreativeForViewerCheck>>;\n    try {\n      creative = await readCreativeForViewerCheck(creativeDir);\n    } catch (e) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No readable prompt.json in ${creativeDir} (${e instanceof Error ? e.message : String(e)}).`,\n          fix: \"Pass the creative's slug (src/creatives/<slug>/) or its folder; its prompt.json must parse.\",\n        },\n      });\n      process.exit(1);\n    }\n    const resolved = await resolveViewer(creative.sources, liveViewerLookups(workspaceRoot));\n    const input: ViewerCheckInput = { ...creative.ad, viewer: resolved.viewer };\n    const cacheDir = path.join(workspaceRoot, \"canvas\", \".cache\");\n    const spent: ReviewUsage[] = [];\n    const outcome = await checkViewer(input, {\n      cacheDir,\n      model: VIEWER_CHECK_MODEL,\n      ask: gatewayViewerModel(VIEWER_CHECK_MODEL, (usage) => spent.push(usage)),\n      judge: jevReadJudge((usage) => spent.push(usage)),\n    });\n    // No run record carries this check: the next render of this workspace bills it.\n    await holdUnbilledSpend(cacheDir, spent);\n    const who = describeViewer(resolved.viewer);\n    const detail = args.full\n      ? {\n          viewer_profile: resolved.viewer,\n          viewer_from: resolved.from,\n          intended: input.intended,\n          ...(outcome.status !== \"unavailable\" ? { answer: outcome.answer } : {}),\n          ...(resolved.notes.length > 0 ? { notes: resolved.notes } : {}),\n        }\n      : {};\n    if (outcome.status === \"failed\") {\n      const turnId = optionalTurnId();\n      const ledger = await readTurnRenders(cacheDir);\n      // Failed twice in this turn already: the render goes ahead, and the person hears what was missed.\n      if (viewerChecksSpent(ledger, turnId, slug)) {\n        writeJson({\n          ok: true,\n          data: { checked: true, understood: false, viewer: who, missed: outcome.verdict.missed, ...detail },\n          hints: [\n            `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(\" \")}`,\n          ],\n        });\n        return;\n      }\n      if (turnId) await updateTurnRenders(cacheDir, (current) => recordViewerFail(current, turnId, slug));\n      const failure = viewerCheckFailure(outcome, slug);\n      writeJson({ ...failure, error: { ...failure.error, ...detail } });\n      process.exit(2);\n    }\n    if (outcome.status === \"unavailable\") {\n      writeJson({\n        ok: true,\n        data: { checked: false, viewer: who, ...detail },\n        hints: [\n          \"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.\",\n        ],\n      });\n      return;\n    }\n    writeJson({\n      ok: true,\n      data: {\n        checked: true,\n        understood: true,\n        viewer: who,\n        offer: outcome.answer.offer.answer,\n        for_whom: outcome.answer.for_whom.answer,\n        next_step: outcome.answer.next_step.answer,\n        ...(outcome.cached ? { cached: true } : {}),\n        ...detail,\n      },\n      hints: [\n        resolved.from === \"default\"\n          ? \"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.\"\n          : `Checked against ${who}. Render it: baker canvas run --slug ${slug}`,\n      ],\n    });\n  },\n});\n","/**\n * Would the people in this ad pass as real customers of this company, where it runs?\n *\n * Audited Sept 2026: casting came from the reference ad's stranger or from whichever avatar was\n * passed first: a 24-year-old model in a hoodie selling trade courses to unemployed adults\n * changing careers, a Spanish face on a Mexican ad. Before a static ad renders, a text model reads\n * who is cast (each person's description, from the avatar), what the company sells, who the ad\n * is for and where it runs, and says whether each would pass as a real customer, and who would\n * instead. Cached by the question, so asking again is free; a model that does not answer lets\n * the render through, saying so.\n */\nimport { createHash } from \"node:crypto\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\n\nexport const CastingAnswerSchema = z.object({\n  passes: z.boolean(),\n  why: z.string().default(\"\"),\n  instead: z.string().default(\"\"),\n});\nexport type CastingAnswer = z.infer<typeof CastingAnswerSchema>;\n\nexport type CastingInput = {\n  /** Each person cast, in words (the avatar's own description). */\n  people: string[];\n  /** What the company sells, from COMPANY.md. */\n  company: string;\n  /** Where the ad runs, as the viewer would be (`describeMarket`). */\n  market?: string;\n  /** Who the ad is for. */\n  persona?: string;\n  /** The company's own rules about who appears in its ads, in their words. */\n  rules?: readonly string[];\n};\n\n/** The casting question, the answer a fixed JSON the code reads. Pure. */\nexport function buildCastingPrompt(input: CastingInput): string {\n  return [\n    \"An ad is about to be made with these people in it:\",\n    ...input.people.map((p) => `- ${p}`),\n    \"\",\n    `The company: ${input.company.trim() || \"(not written down)\"}`,\n    ...(input.persona ? [`The ad is for: ${input.persona}`] : []),\n    ...(input.market ? [`It runs for ${input.market}.`] : []),\n    ...(input.rules && input.rules.length > 0\n      ? [\"The company's own rules about who appears in its ads:\", ...input.rules.map((r) => `- ${r}`)]\n      : []),\n    \"\",\n    \"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, and a person a rule rules out does not pass. A rule about how or where a person is shown (their size, framing, a round photo, inside a mockup) is not this question: the finished ad is checked against it.\",\n    'Reply with only this JSON: {\"passes\":true|false,\"why\":\"<one sentence>\",\"instead\":\"<who would pass, in a few words, when one does not>\"}',\n  ].join(\"\\n\");\n}\n\nexport type CastingOutcome =\n  | { status: \"passed\" | \"failed\"; answer: CastingAnswer; cached: boolean }\n  | { status: \"unavailable\" }\n  | { status: \"skipped\" };\n\nfunction cacheKey(input: CastingInput, model: string): string {\n  return createHash(\"sha256\").update(JSON.stringify({ prompt: buildCastingPrompt(input), model })).digest(\"hex\");\n}\n\nfunction parseOrNull(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return null;\n  }\n}\n\n/** Ask, or read the answer this exact question already got. Nobody cast: nothing to check. */\nexport async function castingCheck(\n  input: CastingInput,\n  opts: { cacheDir: string; model: string; ask: (prompt: string) => Promise<unknown> },\n): Promise<CastingOutcome> {\n  if (input.people.length === 0) return { status: \"skipped\" };\n  const file = path.join(opts.cacheDir, \"casting-check\", `${cacheKey(input, opts.model)}.json`);\n  const cachedRaw = await readFile(file, \"utf8\").catch(() => null);\n  // A write cut short leaves half a file: that is a miss, never a failed run.\n  const cachedParse = cachedRaw ? CastingAnswerSchema.safeParse(parseOrNull(cachedRaw)) : null;\n  if (cachedParse?.success) return { status: cachedParse.data.passes ? \"passed\" : \"failed\", answer: cachedParse.data, cached: true };\n  const prompt = buildCastingPrompt(input);\n  for (let attempt = 0; attempt < 2; attempt++) {\n    const parsed = CastingAnswerSchema.safeParse(await opts.ask(prompt));\n    if (!parsed.success) continue;\n    await mkdir(path.dirname(file), { recursive: true });\n    await writeFile(file, `${JSON.stringify(parsed.data, null, 2)}\\n`, \"utf8\");\n    return { status: parsed.data.passes ? \"passed\" : \"failed\", answer: parsed.data, cached: false };\n  }\n  return { status: \"unavailable\" };\n}\n\n/** The `{ ok: false, error }` a failed casting check prints. Pure. */\nexport function castingCheckFailure(answer: CastingAnswer, slug: string) {\n  return {\n    ok: false as const,\n    error: {\n      code: \"casting_check_failed\" as const,\n      message: `Not rendered: the people cast would not pass as this company's real customers. ${answer.why}`.trim(),\n      fix: [\n        answer.instead ? `Cast ${answer.instead} instead:` : \"Cast someone who would:\",\n        \"`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).\",\n        `Then \\`baker canvas run --slug ${slug}\\` again.`,\n      ].join(\" \"),\n    },\n  };\n}\n","/**\n * How many times each ad was rendered in this chat turn, and how the last one ended, so a turn\n * stops spending time on an ad that is done or cannot be finished. Dev, Oct 2026: a producer\n * re-rendered a `ready_with_notes` ad four more times to chase its notes, and another re-ran an ad\n * whose concept could not be kept truthfully until the turn ran out. The run's own autofix rounds\n * are one render here: only the commands an agent starts count.\n */\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { canonicalize } from \"@baker/canvas-contract\";\nimport { z } from \"zod\";\nimport { updateLockedFile } from \"../../engine/lib/file-lock.ts\";\nimport type { StaticVerdict } from \"../../engine/nodes/local/lib/static-review.ts\";\nimport type { AutoFixStep } from \"./static-autofix.ts\";\n\n/** Renders an agent may start for one ad in one turn, its autofix rounds included in each. */\nconst RUNS_PER_TURN = 2;\n\n/**\n * Viewer checks one ad may fail in one turn before it renders anyway, what the viewer missed said\n * with it. Dev, Oct 2026: a producer rewrote one ad's copy for seven checks, then sat blocked.\n */\nconst VIEWER_FAILS_PER_TURN = 2;\n\n/**\n * The time one ad may take in one turn, its renders and their correction rounds together. Past it the\n * ad is shown as it stands: the person's next message says what changes. Dev, Oct 2026: two autofix\n * rounds and a second render held one producer 21 minutes on one ad, the other two long finished.\n * 12, not 8: three rounds, each from the best attempt so far, finish what two left (prod, Oct 2026:\n * ads shown \"Needs fixes\" until the person asked again, twice).\n */\nconst AD_TURN_MS = 12 * 60_000;\n\n/** About how long each correction round takes, its review included (dev, Oct 2026 runs). */\nconst ROUND_MS: Record<AutoFixStep[\"kind\"], number> = {\n  respec: 60_000,\n  extend: 80_000,\n  relayout: 100_000,\n  fix: 150_000,\n  regenerate: 220_000,\n};\n\n/** About how long a render an agent starts takes before its first review (dev, Oct 2026 runs). */\nconst RENDER_MS = 150_000;\n\nconst LedgerSchema = z.object({\n  turnId: z.string(),\n  creatives: z.record(\n    z.string(),\n    z.object({\n      runs: z.number().default(0),\n      verdict: z.string().optional(),\n      viewerFails: z.number().optional(),\n      spentMs: z.number().optional(),\n      lastCorrection: z.boolean().optional(),\n    }),\n  ),\n});\nexport type TurnRenders = z.infer<typeof LedgerSchema>;\ntype Entry = TurnRenders[\"creatives\"][string];\n\n/** Whether `entry` has had its renders or its time in this turn. */\nconst budgetSpent = (entry: Entry): boolean =>\n  (entry.spentMs ?? 0) + RENDER_MS > AD_TURN_MS || entry.runs >= RUNS_PER_TURN;\n\n/**\n * Whether an ad past its budget may still have one correction: it still needs fixes and has not had\n * that one yet. Zernio, Oct 2026: automatic rounds failing one check took 9.5 minutes, and the\n * `--fix` the agent then ran was refused for time, the ad shown broken. Bounded: once a turn.\n */\nconst lastCorrectionDue = (entry: Entry, correction: boolean | undefined): boolean =>\n  correction === true && entry.verdict === \"needs_fixes\" && entry.lastCorrection !== true;\n\nexport type TurnRenderRefusal = { code: \"CONFLICT\"; message: string; fix: string };\n\nconst SHOW_AS_IT_STANDS =\n  \"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.\";\n\n/**\n * Whether a run may still turn out to be a correction of the version shown (`turnRenderRefusal`),\n * known before the run reads or spends anything: a `--fix`, a `--regenerate`, or a prompt.json\n * changed since that version (an edit of its words or colours). Run again with nothing changed, a\n * ready ad is refused at once. `--use-variant` is the person's choice among the options, never a\n * defect: it comes with their next message, in a new turn. Pure.\n */\nexport function mayBeCorrection(\n  run: { fix?: string; regenerate?: string; useVariant?: string },\n  shownPrompt: unknown,\n  promptOnDisk: unknown,\n): boolean {\n  if (run.fix !== undefined || run.regenerate !== undefined) return true;\n  return shownPrompt !== undefined && promptOnDisk != null && canonicalize(shownPrompt) !== canonicalize(promptOnDisk);\n}\n\n/**\n * Why this ad gets no further render in this turn, or null. A ready ad is never rendered anew (that\n * chased notes four renders deep), but a `correction` of the version shown (a `--fix`, a size laid\n * out again, prompt.json's words or colours edited: one edit grown on top of it) may answer a real\n * defect the agent sees, within the same renders and time as any other. Production, Oct 2026: an ad\n * with its logo drawn twice, `ready_with_notes`, could not be corrected and was saved as it was. An ad\n * that still needs fixes gets one correction past its budget (`lastCorrectionDue`). Pure.\n */\nexport function turnRenderRefusal(\n  ledger: TurnRenders | undefined,\n  turnId: string | undefined,\n  slug: string,\n  opts: { correction?: boolean; shape?: \"plate\" | \"relayout\" } = {},\n): TurnRenderRefusal | null {\n  const entry = turnId !== undefined && ledger?.turnId === turnId ? ledger.creatives[slug] : undefined;\n  if (!entry) return null;\n  if ((entry.verdict === \"ready\" || entry.verdict === \"ready_with_notes\") && opts.correction !== true) {\n    return {\n      code: \"CONFLICT\",\n      message: `This ad is already ready in this turn (${entry.verdict}): its notes are not defects, and new options are not made for them.`,\n      fix: `Show it now. Only a real defect you can name in it (a logo drawn twice, a word wrong) is corrected in this turn: \\`baker canvas run --slug <slug> --fix \"<what to change>\"\\`, or \\`--regenerate ${opts.shape === \"relayout\" ? \"adapt\" : \"format\"}_<size>\\` for one size. Any other change comes with the person's next message.`,\n    };\n  }\n  if (budgetSpent(entry) && lastCorrectionDue(entry, opts.correction)) return null;\n  if ((entry.spentMs ?? 0) + RENDER_MS > AD_TURN_MS) {\n    return {\n      code: \"CONFLICT\",\n      message: `This ad has had its ${AD_TURN_MS / 60_000} minutes in this turn, its automatic corrections included, and is still not ready.`,\n      fix: SHOW_AS_IT_STANDS,\n    };\n  }\n  if (entry.runs >= RUNS_PER_TURN) {\n    return {\n      code: \"CONFLICT\",\n      message: `This ad was rendered twice in this turn, its automatic corrections included, and is still not ready.`,\n      fix: SHOW_AS_IT_STANDS,\n    };\n  }\n  return null;\n}\n\n/**\n * The ledger with one more render of `slug` that ended `verdict` after `tookMs`; a new turn starts it\n * afresh. A render started past the ad's budget was its one last correction, and is marked spent. Pure.\n */\nexport function recordTurnRender(\n  ledger: TurnRenders | undefined,\n  turnId: string,\n  slug: string,\n  verdict: StaticVerdict,\n  tookMs?: number,\n): TurnRenders {\n  const creatives = ledger?.turnId === turnId ? ledger.creatives : {};\n  const entry = creatives[slug];\n  const spentMs = (entry?.spentMs ?? 0) + (tookMs ?? 0);\n  return {\n    turnId,\n    creatives: {\n      ...creatives,\n      [slug]: {\n        ...entry,\n        runs: (entry?.runs ?? 0) + 1,\n        verdict,\n        ...(spentMs > 0 ? { spentMs } : {}),\n        ...(entry && budgetSpent(entry) ? { lastCorrection: true } : {}),\n      },\n    },\n  };\n}\n\n/**\n * Whether a correction round of `kind` still fits `slug`'s time in this turn, this render having\n * taken `renderMs` so far. Outside a chat turn only this render counts. Pure.\n */\nexport function roundFitsTurn(\n  ledger: TurnRenders | undefined,\n  turnId: string | undefined,\n  slug: string | undefined,\n  renderMs: number,\n  kind: AutoFixStep[\"kind\"],\n): boolean {\n  const entry = turnId !== undefined && slug !== undefined && ledger?.turnId === turnId ? ledger.creatives[slug] : undefined;\n  return (entry?.spentMs ?? 0) + renderMs + ROUND_MS[kind] <= AD_TURN_MS;\n}\n\n/** The ledger with one more failed viewer check of `slug`; a new turn starts it afresh. Pure. */\nexport function recordViewerFail(ledger: TurnRenders | undefined, turnId: string, slug: string): TurnRenders {\n  const creatives = ledger?.turnId === turnId ? ledger.creatives : {};\n  const entry = creatives[slug] ?? { runs: 0 };\n  return { turnId, creatives: { ...creatives, [slug]: { ...entry, viewerFails: (entry.viewerFails ?? 0) + 1 } } };\n}\n\n/** Whether `slug` failed the viewer check often enough in this turn to render without being held back again. Pure. */\nexport function viewerChecksSpent(ledger: TurnRenders | undefined, turnId: string | undefined, slug: string): boolean {\n  const entry = turnId !== undefined && ledger?.turnId === turnId ? ledger.creatives[slug] : undefined;\n  return (entry?.viewerFails ?? 0) >= VIEWER_FAILS_PER_TURN;\n}\n\nconst ledgerPath = (cacheDir: string) => path.join(cacheDir, \"turn-renders.json\");\n\nexport async function readTurnRenders(cacheDir: string): Promise<TurnRenders | undefined> {\n  try {\n    const parsed = LedgerSchema.safeParse(JSON.parse(await readFile(ledgerPath(cacheDir), \"utf8\")));\n    return parsed.success ? parsed.data : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Change the record under a lock, written whole through a rename: `--series` runs every ad's render\n * as its own process at once, and a plain read-then-write let each one overwrite the others' entries.\n */\nexport async function updateTurnRenders(\n  cacheDir: string,\n  change: (ledger: TurnRenders | undefined) => TurnRenders,\n): Promise<void> {\n  await updateLockedFile(ledgerPath(cacheDir), async () => JSON.stringify(change(await readTurnRenders(cacheDir))));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,SAAS,cAAAA,mBAAkB;AAC3B,SAAS,SAAAC,QAAO,SAAS,YAAAC,WAAU,MAAM,aAAAC,kBAAiB;AAC1D,OAAOC,WAAU;AAEjB,SAAS,qBAAqB;AAC9B,SAAS,SAAS,iBAAiB;AACnC,SAAS,KAAAC,UAAS;;;ACXlB,SAAS,kBAAkB;AAC3B,SAAS,OAAO,UAAU,iBAAiB;AAC3C,OAAO,UAAU;AACjB,SAAS,SAAS;AAEX,IAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,QAAQ,EAAE,QAAQ;AAAA,EAClB,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE;AAAA,EAC1B,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE;AAChC,CAAC;AAiBM,SAAS,mBAAmB,OAA6B;AAC9D,SAAO;AAAA,IACL;AAAA,IACA,GAAG,MAAM,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AAAA,IACnC;AAAA,IACA,gBAAgB,MAAM,QAAQ,KAAK,KAAK,oBAAoB;AAAA,IAC5D,GAAI,MAAM,UAAU,CAAC,kBAAkB,MAAM,OAAO,EAAE,IAAI,CAAC;AAAA,IAC3D,GAAI,MAAM,SAAS,CAAC,eAAe,MAAM,MAAM,GAAG,IAAI,CAAC;AAAA,IACvD,GAAI,MAAM,SAAS,MAAM,MAAM,SAAS,IACpC,CAAC,yDAAyD,GAAG,MAAM,MAAM,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,IAC7F,CAAC;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAOA,SAAS,SAAS,OAAqB,OAAuB;AAC5D,SAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,UAAU,EAAE,QAAQ,mBAAmB,KAAK,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,KAAK;AAC/G;AAEA,SAAS,YAAY,KAAsB;AACzC,MAAI;AACF,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,eAAsB,aACpB,OACA,MACyB;AACzB,MAAI,MAAM,OAAO,WAAW,EAAG,QAAO,EAAE,QAAQ,UAAU;AAC1D,QAAM,OAAO,KAAK,KAAK,KAAK,UAAU,iBAAiB,GAAG,SAAS,OAAO,KAAK,KAAK,CAAC,OAAO;AAC5F,QAAM,YAAY,MAAM,SAAS,MAAM,MAAM,EAAE,MAAM,MAAM,IAAI;AAE/D,QAAM,cAAc,YAAY,oBAAoB,UAAU,YAAY,SAAS,CAAC,IAAI;AACxF,MAAI,aAAa,QAAS,QAAO,EAAE,QAAQ,YAAY,KAAK,SAAS,WAAW,UAAU,QAAQ,YAAY,MAAM,QAAQ,KAAK;AACjI,QAAM,SAAS,mBAAmB,KAAK;AACvC,WAAS,UAAU,GAAG,UAAU,GAAG,WAAW;AAC5C,UAAM,SAAS,oBAAoB,UAAU,MAAM,KAAK,IAAI,MAAM,CAAC;AACnE,QAAI,CAAC,OAAO,QAAS;AACrB,UAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,UAAM,UAAU,MAAM,GAAG,KAAK,UAAU,OAAO,MAAM,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AACzE,WAAO,EAAE,QAAQ,OAAO,KAAK,SAAS,WAAW,UAAU,QAAQ,OAAO,MAAM,QAAQ,MAAM;AAAA,EAChG;AACA,SAAO,EAAE,QAAQ,cAAc;AACjC;AAGO,SAAS,oBAAoB,QAAuB,MAAc;AACvE,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,kFAAkF,OAAO,GAAG,GAAG,KAAK;AAAA,MAC7G,KAAK;AAAA,QACH,OAAO,UAAU,QAAQ,OAAO,OAAO,cAAc;AAAA,QACrD;AAAA,QACA,kCAAkC,IAAI;AAAA,MACxC,EAAE,KAAK,GAAG;AAAA,IACZ;AAAA,EACF;AACF;;;ACpGA,SAAS,YAAAC,iBAAgB;AACzB,OAAOC,WAAU;AAEjB,SAAS,KAAAC,UAAS;AAMlB,IAAM,gBAAgB;AAMtB,IAAM,wBAAwB;AAS9B,IAAM,aAAa,KAAK;AAGxB,IAAM,WAAgD;AAAA,EACpD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,KAAK;AAAA,EACL,YAAY;AACd;AAGA,IAAM,YAAY;AAElB,IAAM,eAAeC,GAAE,OAAO;AAAA,EAC5B,QAAQA,GAAE,OAAO;AAAA,EACjB,WAAWA,GAAE;AAAA,IACXA,GAAE,OAAO;AAAA,IACTA,GAAE,OAAO;AAAA,MACP,MAAMA,GAAE,OAAO,EAAE,QAAQ,CAAC;AAAA,MAC1B,SAASA,GAAE,OAAO,EAAE,SAAS;AAAA,MAC7B,aAAaA,GAAE,OAAO,EAAE,SAAS;AAAA,MACjC,SAASA,GAAE,OAAO,EAAE,SAAS;AAAA,MAC7B,gBAAgBA,GAAE,QAAQ,EAAE,SAAS;AAAA,IACvC,CAAC;AAAA,EACH;AACF,CAAC;AAKD,IAAM,cAAc,CAAC,WAClB,MAAM,WAAW,KAAK,YAAY,cAAc,MAAM,QAAQ;AAOjE,IAAM,oBAAoB,CAAC,OAAc,eACvC,eAAe,QAAQ,MAAM,YAAY,iBAAiB,MAAM,mBAAmB;AAIrF,IAAM,oBACJ;AASK,SAAS,gBACd,KACA,aACA,cACS;AACT,MAAI,IAAI,QAAQ,UAAa,IAAI,eAAe,OAAW,QAAO;AAClE,SAAO,gBAAgB,UAAa,gBAAgB,QAAQ,aAAa,WAAW,MAAM,aAAa,YAAY;AACrH;AAUO,SAAS,kBACd,QACA,QACA,MACA,OAA+D,CAAC,GACtC;AAC1B,QAAM,QAAQ,WAAW,UAAa,QAAQ,WAAW,SAAS,OAAO,UAAU,IAAI,IAAI;AAC3F,MAAI,CAAC,MAAO,QAAO;AACnB,OAAK,MAAM,YAAY,WAAW,MAAM,YAAY,uBAAuB,KAAK,eAAe,MAAM;AACnG,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,0CAA0C,MAAM,OAAO;AAAA,MAChE,KAAK,mMAAmM,KAAK,UAAU,aAAa,UAAU,QAAQ;AAAA,IACxP;AAAA,EACF;AACA,MAAI,YAAY,KAAK,KAAK,kBAAkB,OAAO,KAAK,UAAU,EAAG,QAAO;AAC5E,OAAK,MAAM,WAAW,KAAK,YAAY,YAAY;AACjD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,uBAAuB,aAAa,GAAM;AAAA,MACnD,KAAK;AAAA,IACP;AAAA,EACF;AACA,MAAI,MAAM,QAAQ,eAAe;AAC/B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS;AAAA,MACT,KAAK;AAAA,IACP;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,iBACd,QACA,QACA,MACA,SACA,QACa;AACb,QAAM,YAAY,QAAQ,WAAW,SAAS,OAAO,YAAY,CAAC;AAClE,QAAM,QAAQ,UAAU,IAAI;AAC5B,QAAM,WAAW,OAAO,WAAW,MAAM,UAAU;AACnD,SAAO;AAAA,IACL;AAAA,IACA,WAAW;AAAA,MACT,GAAG;AAAA,MACH,CAAC,IAAI,GAAG;AAAA,QACN,GAAG;AAAA,QACH,OAAO,OAAO,QAAQ,KAAK;AAAA,QAC3B;AAAA,QACA,GAAI,UAAU,IAAI,EAAE,QAAQ,IAAI,CAAC;AAAA,QACjC,GAAI,SAAS,YAAY,KAAK,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAAA,MAChE;AAAA,IACF;AAAA,EACF;AACF;AAMO,SAAS,cACd,QACA,QACA,MACA,UACA,MACS;AACT,QAAM,QAAQ,WAAW,UAAa,SAAS,UAAa,QAAQ,WAAW,SAAS,OAAO,UAAU,IAAI,IAAI;AACjH,UAAQ,OAAO,WAAW,KAAK,WAAW,SAAS,IAAI,KAAK;AAC9D;AAGO,SAAS,iBAAiB,QAAiC,QAAgB,MAA2B;AAC3G,QAAM,YAAY,QAAQ,WAAW,SAAS,OAAO,YAAY,CAAC;AAClE,QAAM,QAAQ,UAAU,IAAI,KAAK,EAAE,MAAM,EAAE;AAC3C,SAAO,EAAE,QAAQ,WAAW,EAAE,GAAG,WAAW,CAAC,IAAI,GAAG,EAAE,GAAG,OAAO,cAAc,MAAM,eAAe,KAAK,EAAE,EAAE,EAAE;AAChH;AAGO,SAAS,kBAAkB,QAAiC,QAA4B,MAAuB;AACpH,QAAM,QAAQ,WAAW,UAAa,QAAQ,WAAW,SAAS,OAAO,UAAU,IAAI,IAAI;AAC3F,UAAQ,OAAO,eAAe,MAAM;AACtC;AAEA,IAAM,aAAa,CAAC,aAAqBC,MAAK,KAAK,UAAU,mBAAmB;AAEhF,eAAsB,gBAAgB,UAAoD;AACxF,MAAI;AACF,UAAM,SAAS,aAAa,UAAU,KAAK,MAAM,MAAMC,UAAS,WAAW,QAAQ,GAAG,MAAM,CAAC,CAAC;AAC9F,WAAO,OAAO,UAAU,OAAO,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,eAAsB,kBACpB,UACA,QACe;AACf,QAAM,iBAAiB,WAAW,QAAQ,GAAG,YAAY,KAAK,UAAU,OAAO,MAAM,gBAAgB,QAAQ,CAAC,CAAC,CAAC;AAClH;;;AF9JO,IAAM,mBAAmB,CAAC,SAAS,YAAY,WAAW;AAG1D,IAAM,iBAAiB,CAAC,SAAS,SAAS,SAAS;AAG1D,IAAM,cAAcC,GAAE,OAAO,EAAE,QAAQA,GAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,SAASA,GAAE,KAAK,cAAc,EAAE,CAAC;AAGzF,IAAM,qBAAqBA,GAAE,OAAO;AAAA,EACzC,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AAAA;AAAA,EAEX,UAAUA,GAAE,OAAO,EAAE,QAAQ,EAAE;AAAA,EAC/B,SAASA,GAAE,OAAO,EAAE,QAAQ,EAAE;AAChC,CAAC;AAoCM,IAAM,0BAA2E;AAAA,EACtF,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AACb;AAEA,IAAM,OAAgD,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,EAAE;AAGhF,IAAM,aAAa,CAAC,SAAwB,UAAkC,KAAK,OAAO,KAAK,KAAK,KAAK;AAMzG,IAAM,aAAa;AAE1B,IAAM,gBACJ;AACF,IAAM,iBACJ;AAYK,SAAS,aAAa,SAAmD;AAC9E,SAAO,OAAO,UAAU;AACtB,UAAM,YAAY,MAAM,QAAQ,CAAC,MAAuD;AAAA,MACtF,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,OAAO,EAAE,OAAO,UAAU,cAAc,EAAE;AAAA,MACjF,GAAI,EAAE,QAAQ,CAAC,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,EAAE,OAAO,UAAU,eAAe,EAAE,CAAC,IAAI,CAAC;AAAA,IACjH,CAAC;AACD,UAAM,UAAU,MAAM,OAAO,WAAW,OAAO;AAC/C,QAAI,YAAY,KAAM,QAAO;AAC7B,QAAI,OAAO;AACX,WAAO,MAAM,IAAI,CAAC,MAAM;AACtB,YAAM,QAAQ,QAAQ,MAAM,KAAK;AACjC,aAAO,EAAE,QAAQ,KAAK,IAAI,OAAO,QAAQ,MAAM,KAAK,CAAC,IAAI;AAAA,IAC3D,CAAC;AAAA,EACH;AACF;AAQA,eAAsB,YACpB,OACA,OACoB;AACpB,QAAM,QAAQ,MAAM;AAAA,IAAQ,CAAC,GAAG,MAC9B,EAAE,KAAK,KAAK,KAAK,EAAE,OAAO,KAAK,IAC3B,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,KAAK,GAAG,OAAO,EAAE,MAAM,KAAK,GAAG,GAAI,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,EAAE,IAAI,CAAC,EAAG,EAAE,CAAC,IACnH,CAAC;AAAA,EACP;AACA,QAAM,MAAM,MAAM,IAAI,MAAM,KAAK;AACjC,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,SAAS,MAAM,MAAM,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,MAAM,IAAI;AACrE,MAAI,WAAW,KAAM,QAAO;AAC5B,QAAM,QAAQ,CAAC,GAAG,MAAM;AACtB,UAAM,IAAI,OAAO,CAAC;AAClB,QAAI,EAAE,CAAC,IAAI,MAAM,UAAa,IAAI;AAAA,EACpC,CAAC;AACD,SAAO;AACT;AAGO,SAAS,kBACd,QACA,UACA,WAA4D,yBAE5D,eAAe,OACA;AACf,QAAM,SAAuB,CAAC;AAC9B,aAAW,YAAY,kBAAkB;AACvC,UAAM,QAAQ,OAAO,QAAQ;AAC7B,UAAM,QAAQ,aAAa,UAAU,SAAS,QAAQ,aAAa,aAAa,SAAS,UAAU;AACnG,UAAM,eAAe,QAAQ,EAAE,UAAU,MAAM,IAAI,CAAC;AACpD,QAAI,KAAK,MAAM,OAAO,IAAI,KAAK,SAAS,QAAQ,CAAC,GAAG;AAClD,aAAO,KAAK;AAAA,QACV;AAAA,QACA,QAAQ,MAAM,YAAY,YAAY,YAAY;AAAA,QAClD,YAAY,MAAM;AAAA,QAClB,GAAG;AAAA,MACL,CAAC;AAAA,IACH,WAAW,aAAa,WAAW,cAAc;AAG/C,aAAO,KAAK,EAAE,UAAU,QAAQ,WAAW,YAAY,MAAM,QAAQ,GAAG,aAAa,CAAC;AAAA,IACxF;AAAA,EACF;AACA,MAAI,OAAO,SAAS,KAAK,EAAG,QAAO,KAAK,EAAE,UAAU,YAAY,QAAQ,YAAY,YAAY,OAAO,SAAS,KAAK,EAAE,CAAC;AACxH,SAAO,EAAE,MAAM,OAAO,WAAW,GAAG,OAAO;AAC7C;AAQA,IAAM,cAAc;AAcpB,SAAS,YAAY,YAAuC;AAC1D,QAAM,aAAa,WAAW,WAAW,KAAK,WAAW,KAAK,CAAC,MAAM,uBAAuB,KAAK,CAAC,CAAC;AACnG,SAAO,aACH,sFACA;AACN;AAMA,SAAS,gBAAgB,QAAuB,OAAmC;AACjF,QAAM,QAAQ;AACd,MAAI,CAAC,OAAO,MAAM,SAAS,OAAO,EAAG,QAAO,2BAA2B,KAAK;AAC5E,QAAM,YAAY,OAAO,MAAM,SAAS,OAAO,IAC3C,QACE,8BAA8B,KAAK,MACnC,+BACF;AACJ,QAAM,UAAU,OAAO,MAAM,SAAS,SAAS,IAAI,mCAAmC;AACtF,SAAO,wBAAwB,KAAK,WAAW,SAAS,GAAG,OAAO;AACpE;AAQO,SAAS,kBAAkB,OAAiC;AACjE,QAAM,QAAQ;AAGd,QAAM,WAAW,CAAC,MAAM,OAAO,MAAM,SAAS,OAAO;AAErD,QAAM,OAAO,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,YAAY,MAAM,KAAK,QAAQ,IAAI,KAAK,EAAE,YAAY,EAAE,QAAQ,WAAW,GAAG,CAAC,CAAC;AAC1H,QAAM,QACJ,KAAK,SAAS,IACV,KAAK,IAAI,CAAC,SAAS,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,oBAAoB,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,IAAI,IAChG;AACN,SAAO;AAAA,IACL,GAAG,MAAM,OAAO,SAAS,WAAW,eAAe,MAAM,OAAO,MAAM,CAAC,MAAM,6DAA6D,sBAAsB,YAAY,MAAM,OAAO,UAAU,CAAC,KAAK,gBAAgB,MAAM,QAAQ,MAAM,SAAS,KAAK,CAAC;AAAA,IAC5P;AAAA,IACA;AAAA,IACA,YAAY,MAAM,MAAM,KAAK,CAAC;AAAA,IAC9B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,WACA;AAAA,MACE,2EAA2E,KAAK;AAAA,IAClF,IACA,CAAC;AAAA,IACL;AAAA,IACA;AAAA,IACA,wMAAwM,WAAW,mBAAmB,EAAE;AAAA,EAC1O,EAAE,KAAK,IAAI;AACb;AAOO,SAAS,oBAAoB,OAAyB,OAAuB;AAClF,QAAM,EAAE,aAAa,OAAO,YAAY,OAAO,IAAI,MAAM;AACzD,QAAM,YAAY;AAAA,IAChB,QAAQ,kBAAkB,EAAE,GAAG,OAAO,QAAQ,EAAE,GAAG,MAAM,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC;AAAA,IAChF,QAAQ,EAAE,aAAa,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,GAAG,YAAY,CAAC,GAAG,UAAU,EAAE,KAAK,GAAG,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC,EAAG;AAAA,IACnH,UAAU,MAAM;AAAA,IAChB;AAAA,EACF;AACA,SAAOC,YAAW,QAAQ,EAAE,OAAO,KAAK,UAAU,SAAS,CAAC,EAAE,OAAO,KAAK;AAC5E;AAkBA,eAAe,aAAa,MAA4C;AACtE,MAAI;AACF,UAAM,SAAS,mBAAmB,UAAU,KAAK,MAAM,MAAMC,UAAS,MAAM,MAAM,CAAC,CAAC;AACpF,WAAO,OAAO,UAAU,OAAO,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQA,eAAsB,YACpB,OACA,MAO6B;AAC7B,QAAM,OAAOC,MAAK,KAAK,KAAK,UAAU,gBAAgB,GAAG,oBAAoB,OAAO,KAAK,KAAK,CAAC,OAAO;AACtG,MAAI,SAAS,MAAM,aAAa,IAAI;AACpC,QAAM,SAAS,WAAW;AAC1B,QAAM,SAAS,kBAAkB,KAAK;AACtC,WAAS,UAAU,GAAG,WAAW,QAAQ,UAAU,GAAG,WAAW;AAC/D,UAAM,SAAS,mBAAmB,UAAU,MAAM,KAAK,IAAI,MAAM,CAAC;AAClE,QAAI,OAAO,QAAS,UAAS,OAAO;AAAA,EACtC;AACA,MAAI,WAAW,KAAM,QAAO,EAAE,QAAQ,eAAe,MAAM;AAC3D,MAAI,CAAC,QAAQ;AACX,UAAMC,OAAMD,MAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,UAAME,WAAU,MAAM,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAAA,EACtE;AAEA,QAAM,OAAO,WAAW,OAAO,MAAM,SAAS,wBAAwB,KAAK;AAC3E,QAAM,CAAC,eAAe,KAAK,IAAI,OAC3B,MAAM;AAAA,IACJ,CAAC,EAAE,MAAM,OAAO,MAAM,QAAQ,OAAO,MAAM,SAAS,OAAO,OAAO,MAAM,SAAS,MAAM,CAAC;AAAA,IACxF,KAAK,SAAS,aAAa;AAAA,EAC7B,IACA,CAAC;AACL,QAAM,UAAU,kBAAkB,QAAQ,MAAM,UAAU,yBAAyB,YAAY;AAC/F,QAAM,SAAS,EAAE,OAAO,QAAQ,SAAS,OAAO;AAChD,SAAO,QAAQ,OAAO,EAAE,GAAG,QAAQ,QAAQ,SAAS,IAAI,EAAE,GAAG,QAAQ,QAAQ,SAAS;AACxF;AAGO,SAAS,eAAe,QAA+B;AAC5D,QAAM,QAAQ,OAAO,MAAM,IAAI,CAAC,MAAM,OAAO,CAAC,EAAE;AAChD,QAAM,QACJ,MAAM,SAAS,IACX,aAAa,MAAM,SAAS,IAAI,GAAG,MAAM,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,QAAQ,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,KACjG;AACN,SAAO,KAAK,OAAO,WAAW,WAAW,KAAK,QAAQ,OAAO,WAAW,KAAK,IAAI,KAAK,WAAW;AACnG;AAEA,IAAM,iBAA2D;AAAA,EAC/D,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AACb;AAEA,SAAS,SAAS,MAA0B;AAC1C,MAAI,KAAK,aAAa,YAAY;AAChC,WAAO,iFAAiF,KAAK,UAAU;AAAA,EACzG;AACA,QAAM,OAAO,KAAK,WAAW,KAAK,IAAI,IAAI,KAAK,WAAW,KAAK,CAAC,MAAM;AACtE,QAAM,MACJ,KAAK,WAAW,YACZ,kBAAkB,IAAI,KACtB,KAAK,WAAW,YACd,oBAAoB,IAAI,KACxB,wBAAwB,IAAI;AACpC,QAAM,WAAW,eAAe,KAAK,QAAQ;AAC7C,SAAO,GAAG,SAAS,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,SAAS,MAAM,CAAC,CAAC,UAAU,GAAG,GAAG,KAAK,WAAW,mBAAmB,KAAK,QAAQ,MAAM,EAAE;AACxI;AAGO,SAAS,mBACd,SACA,MACkI;AAClI,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,MAAM,eAAe,MAAM;AACjC,QAAM,UAAU,QAAQ,OAAO,QAAQ,KAAK;AAC5C,QAAM,SAAS,QAAQ,QAAQ,OAAO,QAAQ,CAAC,MAAO,EAAE,aAAa,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAE;AAEpH,QAAM,QAAQ,QAAQ,MAAM,SAAS,OAAO,KAAK;AACjD,QAAM,UACJ,SAAS,QAAQ,QAAQ,OAAO,KAAK,CAAC,MAAM,EAAE,aAAa,OAAO,IAC9D,CAAC,wCAAwC,KAAK,kDAAkD,IAChG,CAAC;AACP,QAAM,MAAM;AAAA,IACV,GAAG;AAAA,IACH,GAAI,OAAO,SAAS,IAAI,CAAC,WAAW,GAAG,4CAA4C,OAAO,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,GAAG;AAAA,IAC/H,GAAG,QAAQ,QAAQ,OAAO,IAAI,QAAQ;AAAA,IACtC,GAAI,UAAU,CAAC,gBAAgB,OAAO,EAAE,IAAI,CAAC;AAAA,IAC7C;AAAA;AAAA,IAEA,yHAAyH,IAAI;AAAA,IAC7H;AAAA,EACF,EAAE,KAAK,GAAG;AACV,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,iBAAiB,GAAG;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,QAAQ,QAAQ,QAAQ;AAAA,IAC1B;AAAA,EACF;AACF;AAKA,IAAM,iBAAiBL,GAAE,OAAO;AAAA,EAC9B,aAAaA,GAAE,KAAK,yBAAyB;AAAA,EAC7C,OAAOA,GAAE,MAAMA,GAAE,KAAK,mBAAmB,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EACtD,YAAYA,GAAE,MAAMA,GAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC;AAAA,EAC5D,QAAQA,GAAE,KAAK,oBAAoB;AAAA,EACnC,SAASA,GAAE,MAAMA,GAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EACvC,QAAQA,GACL,OAAO;AAAA,IACN,SAASA,GAAE,OAAO,EAAE,IAAI,CAAC;AAAA,IACzB,UAAUA,GAAE,OAAO,EAAE,SAAS;AAAA,IAC9B,UAAUA,GAAE,OAAO,EAAE,SAAS;AAAA,IAC9B,SAASA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,CAAC,EACA,SAAS;AACd,CAAC;AA6BD,IAAM,UAAU,CAAC,SACf,KACG,UAAU,KAAK,EACf,QAAQ,WAAC,UAAM,IAAE,GAAE,EAAE,EACrB,YAAY,EACZ,MAAM,iBAAiB,EACvB,OAAO,OAAO,EACd,KAAK,GAAG;AAON,SAAS,gBAAgB,SAA6B,SAA4C;AACvG,QAAM,WAAW,CAAC,UAAwB,MAAM,WAAW,MAAM,SAAS,MAAM;AAChF,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO,QAAQ,IAAI,QAAQ;AACjD,QAAM,SAAS,QAAQ,OAAO;AAC9B,QAAM,QAAQ,QAAQ;AAAA,IAAK,CAAC,UAC1B,CAAC,MAAM,KAAK,QAAQ,SAAS,GAAG,GAAG,MAAM,OAAO,MAAM,OAAO,EAAE,KAAK,CAAC,SAAS,QAAQ,QAAQ,IAAI,MAAM,MAAM;AAAA,EAChH;AACA,SAAO,CAAC,QAAQ,SAAS,KAAK,IAAI,QAAQ,KAAK,CAAC;AAClD;AAOA,eAAsB,cAAc,SAAwB,SAAiD;AAC3G,QAAM,WAAW,MAAM,mBAAmB,SAAS,OAAO;AAC1D,MAAI,SAAS,OAAO,UAAU,CAAC,QAAQ,cAAe,QAAO;AAC7D,QAAM,SAAS,MAAM,QAAQ,cAAc,EAAE,MAAM,MAAM,MAAS;AAClE,SAAO,SAAS,EAAE,GAAG,UAAU,QAAQ,EAAE,GAAG,SAAS,QAAQ,OAAO,EAAE,IAAI;AAC5E;AAEA,eAAe,mBAAmB,SAAwB,SAAiD;AACzG,QAAM,QAAkB,CAAC;AACzB,MAAI,QAAQ,aAAa,QAAW;AAClC,UAAM,WAAW,eAAe,UAAU,QAAQ,QAAQ;AAC1D,QAAI,SAAS,QAAS,QAAO,EAAE,QAAQ,SAAS,MAAM,MAAM,YAAY,MAAM;AAC9E,UAAM,KAAK,sHAAsH;AAAA,EACnI;AACA,MAAI,QAAQ,aAAa;AACvB,QAAI;AACF,YAAM,YAAY,MAAM,QAAQ,YAAY,QAAQ,WAAW;AAC/D,UAAI,UAAW,QAAO,EAAE,QAAQ,WAAW,MAAM,UAAU,MAAM;AACjE,YAAM,KAAK,UAAU,QAAQ,WAAW,2CAA2C;AAAA,IACrF,SAAS,GAAG;AACV,YAAM,KAAK,yBAAyB,QAAQ,WAAW,KAAK,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC,IAAI;AAAA,IAC5G;AAAA,EACF;AACA,MAAI,UAA0B,CAAC;AAC/B,MAAI;AACF,cAAU,MAAM,QAAQ,SAAS;AAAA,EACnC,SAAS,GAAG;AACV,UAAM,KAAK,iDAAiD,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC,IAAI;AAAA,EAC5G;AACA,QAAM,WAAW,gBAAgB,QAAQ,SAAS,OAAO;AACzD,MAAI,SAAS,SAAS,KAAK,QAAQ,WAAW;AAC5C,WAAO,EAAE,QAAQ,oBAAoB,EAAE,UAAU,WAAW,QAAQ,UAAU,CAAC,GAAG,MAAM,aAAa,MAAM;AAAA,EAC7G;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,MACN,aAAa;AAAA,MACb,OAAO,CAAC;AAAA,MACR,YAAY,CAAC,WAAW;AAAA,MACxB,QAAQ;AAAA,MACR,SAAS;AAAA,QACP;AAAA,MACF;AAAA,IACF;AAAA,IACA,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAOA,IAAM,cAAcA,GAAE,OAAO;AAAA,EAC3B,QAAQA,GAAE,QAAQ,EAAE,SAAS;AAAA,EAC7B,aAAaA,GAAE,MAAM,CAACA,GAAE,OAAO,GAAGA,GAAE,OAAO,CAAC,CAAC,EAAE,UAAU,MAAM,EAAE,SAAS;AAAA,EAC1E,SAASA,GAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,WAAWA,GAAE,KAAK,gBAAgB,EAAE,SAAS,EAAE,MAAM,MAAS;AAAA,EAC9D,OAAOA,GAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAED,SAAS,cAAc,KAA0C;AAC/D,QAAM,QAAQ,IAAI,MAAM,6BAA6B,IAAI,CAAC;AAC1D,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,MAAI;AACF,UAAM,SAAS,YAAY,UAAU,UAAU,KAAK,CAAC;AACrD,WAAO,OAAO,UAAU,OAAO,OAAO,CAAC;AAAA,EACzC,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AASA,eAAsB,2BAA2B,aAA0E;AACzH,QAAM,OAAO,WAAW,KAAK,MAAM,MAAME,UAASC,MAAK,KAAK,aAAa,aAAa,GAAG,MAAM,CAAC,CAAC;AACjG,QAAM,aAAa,cAAc,MAAMD,UAASC,MAAK,KAAK,aAAa,gBAAgB,GAAG,MAAM,EAAE,MAAM,MAAM,EAAE,CAAC;AACjH,QAAM,QAAQ,KAAK,SAAS,KAAK,KAAK,WAAW,OAAO,KAAK;AAC7D,QAAM,UAAU,KAAK,QAAQ,IAAI,KAAK,KAAK,WAAW,SAAS,KAAK;AACpE,QAAM,QAAQ,KAAK,OAAO,MAAM,KAAK;AAErC,QAAM,SAAS,MAAM,mBAAmBA,MAAK,QAAQ,aAAa,UAAU,CAAC,IAAI;AACjF,SAAO;AAAA,IACL,IAAI;AAAA,MACF,MAAM,KAAK,KAAK,IAAI,CAAC,UAAU;AAAA,QAC7B,MAAM,KAAK;AAAA,QACX,GAAI,KAAK,cAAc,cAAc,KAAK,KAAK,EAAE,IAAI,KAAK,GAAG,IAAI,CAAC;AAAA,QAClE,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;AAAA,MACzC,EAAE;AAAA,MACF,OAAO,KAAK,MAAM;AAAA,MAClB,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,MACzB,UAAU,EAAE,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAI,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC,GAAI,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAAA,MACtG,GAAG,WAAW,IAAI;AAAA,IACpB;AAAA,IACA,SAAS;AAAA,MACP,GAAI,WAAW,WAAW,SAAY,EAAE,UAAU,WAAW,OAAO,IAAI,CAAC;AAAA,MACzE,GAAI,WAAW,cAAc,EAAE,aAAa,WAAW,YAAY,IAAI,CAAC;AAAA,MACxE,GAAI,WAAW,SAAS,KAAK,IAAI,EAAE,SAAS,WAAW,QAAQ,KAAK,EAAE,IAAI,CAAC;AAAA,MAC3E,GAAI,WAAW,YAAY,EAAE,WAAW,WAAW,UAAU,IAAI,CAAC;AAAA,IACpE;AAAA,EACF;AACF;AAGA,SAAS,WAAW,MAA4D;AAC9E,QAAM,SAAS,KAAK,WACjB,OAAO,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,UAAU,EAAE,UAAU,CAAC,WAAW,KAAK,EAAE,EAAE,CAAC,EACtF,IAAI,CAAC,MAAM,EAAE,IAAI;AACpB,SAAO,OAAO,SAAS,IAAI,EAAE,OAAO,IAAI,CAAC;AAC3C;AAGA,eAAsB,aAAa,eAAgD;AACjF,QAAM,MAAMA,MAAK,KAAK,eAAe,OAAO,WAAW,UAAU;AACjE,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,QAAQ,KAAK,EAAE,WAAW,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC;AAAA,EACnF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACA,SAAO,MAAM,QAAQ;AAAA,IACnB,MAAM,IAAI,OAAO,SAAS;AACxB,YAAM,MAAM,MAAMD,UAASC,MAAK,KAAK,KAAK,IAAI,GAAG,MAAM;AACvD,YAAM,QAAQ,IAAI,MAAM,6BAA6B,IAAI,CAAC;AAC1D,UAAI;AACJ,UAAI;AACF,kBAAU,QAAS,UAAU,KAAK,GAAoC,UAAU;AAAA,MAClF,QAAQ;AACN,kBAAU;AAAA,MACZ;AACA,YAAM,QAAQ,IAAI,MAAM,aAAa,IAAI,CAAC,GAAG,KAAK;AAClD,aAAO;AAAA,QACL,MAAMA,MAAK,SAAS,MAAM,KAAK;AAAA,QAC/B,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,QACzB,GAAI,OAAO,YAAY,YAAY,QAAQ,KAAK,IAAI,EAAE,SAAS,QAAQ,KAAK,EAAE,IAAI,CAAC;AAAA,MACrF;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAeA,SAAS,YAAuB;AAC9B,QAAM,QAAQ,0BAA0B;AACxC,QAAM,OAAO,IAAI,WAAW,EAAE,SAAS,MAAM,KAAK,QAAQ,MAAM,QAAQ,WAAW,KAAQ,YAAY,EAAE,CAAC;AAC1G,SAAO,CAAC,SAAS,WAAW,KAAK,QAAQ,SAAS,GAAG,OAAO,IAAI,IAAI,gBAAgB,MAAM,CAAC,KAAK,OAAO;AACzG;AAGA,eAAe,eAAe,MAAoC;AAChE,QAAM,QAAQ,QAAQ,IAAI;AAC1B,MAAI,MAAO,QAAO,CAAC,KAAK;AACxB,QAAM,WAAW,MAAM,KAAoD,wBAAwB;AACnG,SAAO,SAAS,QAAQ,CAAC,MAAM;AAC7B,UAAM,KAAK,EAAE,cAAc,EAAE;AAC7B,WAAO,OAAO,OAAO,YAAY,KAAK,CAAC,EAAE,IAAI,CAAC;AAAA,EAChD,CAAC;AACH;AAGA,eAAe,gBAAgB,SAAiB,eAAsD;AACpG,QAAM,OAAO,UAAU;AACvB,aAAW,YAAY,MAAM,eAAe,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG;AAC9D,UAAM,SAAS,EAAE,cAAc,QAAQ,WAAW,MAAM,IAAI,UAAU,OAAO,OAAO,GAAG;AACvF,UAAM,SAAS,MAAM,KAAgB,wBAAwB,MAAM,GAAG,KAAK,CAAC,QAAQ,OAAO,IAAI,EAAE,MAAM,OAAO;AAC9G,QAAI,CAAC,MAAO;AAEZ,UAAM,CAAC,WAAW,SAAS,IAAI,MAAM,QAAQ,IAAI;AAAA,MAC/C,KAAgB,2BAA2B,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;AAAA,MACjE,KAAgB,2BAA2B,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;AAAA,IACnE,CAAC;AACD,UAAM,WAAWA,MAAK,KAAK,eAAe,UAAU,QAAQ;AAC5D,UAAM,QAAuB,CAAC;AAC9B,UAAM,WAAW,MAAM;AAAA,MACrB,gBAAgB,CAAC,KAAK,GAAG,SAAS;AAAA,MAClC,cAAcA,MAAK,KAAK,UAAU,qBAAqB,GAAG,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;AAAA,IAChF;AACA,UAAM,kBAAkB,UAAU,KAAK,EAAE,MAAM,MAAM,MAAS;AAC9D,WAAO,gBAAgB,CAAC,KAAK,GAAG,WAAW,WAAW,QAAQ,EAAE,CAAC,GAAG,UAAU;AAAA,EAChF;AACA,SAAO;AACT;AAGA,IAAM,aAAa;AAGZ,SAAS,kBAAkB,eAAsC;AACtE,SAAO;AAAA,IACL,aAAa,CAAC,YAAY,gBAAgB,SAAS,aAAa;AAAA,IAChE,UAAU,MAAM,aAAa,aAAa;AAAA,IAC1C,eAAe,YACb,qBAAqB,MAAMD,UAASC,MAAK,KAAK,eAAe,YAAY,GAAG,MAAM,EAAE,MAAM,MAAM,IAAI,CAAC;AAAA,IACvG,SAAS,YAAY,YAAY,MAAM,mBAAmB,aAAa,CAAC;AAAA;AAAA;AAAA,IAGxE,WAAW,OAAO,gBAChB,YAAY,MAAM,UAAU,WAAW,GAAG,KAAK,EAC5C,OAAO,CAAC,MAAM,EAAE,YAAY,UAAW,EAAE,WAAW,aAAa,EAAE,YAAY,SAAU,EACzF,MAAM,GAAG,UAAU,EACnB,IAAI,CAAC,MAAM,EAAE,IAAI;AAAA,EACxB;AACF;AAGO,SAAS,mBAAmB,OAAe,SAAwD;AACxG,SAAO,CAAC,WAAW,aAAa,OAAO,QAAQ,OAAO;AACxD;AAOA,IAAM,aAAuE;AAAA,EAC3E,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO;AACT;AAOO,SAAS,gBAAgB,KAOZ;AAClB,MAAI,IAAI,OAAO,IAAI,cAAc,IAAI,UAAU,IAAI,eAAe,EAAG,QAAO;AAC5E,MAAI,IAAI,QAAS,QAAO;AACxB,SAAO,IAAI,QAAQ,UAAU;AAC/B;AAkBA,eAAsB,wBAAwB,MAYZ;AAChC,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,2BAA2B,KAAK,WAAW;AAAA,EAC9D,SAAS,GAAG;AACV,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,CAAC,oFAAoF,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC,IAAI;AAAA,IAC5I;AAAA,EACF;AACA,QAAM,WAAW,MAAM,cAAc,SAAS,SAAS,KAAK,OAAO;AACnE,QAAM,MAAM,eAAe,SAAS,MAAM;AAC1C,QAAM,QAAQ,SAAS,MAAM,IAAI,CAAC,SAAS,YAAY,IAAI,EAAE;AAC7D,MAAI,KAAK,KAAM,QAAO,EAAE,QAAQ,SAAS,QAAQ,OAAO,CAAC,GAAG,OAAO,uBAAuB,WAAW,KAAK,IAAI,CAAC,GAAG,EAAE;AAEpH,QAAM,WAAW,YACf;AAAA,IACE;AAAA,MACE,QAAQ,SAAS,GAAG,UAAU,CAAC;AAAA,MAC/B,SAAU,MAAM,KAAK,QAAQ,UAAU,EAAE,MAAM,MAAM,EAAE,KAAM;AAAA,MAC7D,OAAQ,MAAM,KAAK,QAAQ,YAAY,KAAK,WAAW,EAAE,MAAM,MAAM,CAAC,CAAC,KAAM,CAAC;AAAA,MAC9E,GAAI,SAAS,OAAO,SAAS,EAAE,QAAQ,eAAe,SAAS,OAAO,MAAM,EAAE,IAAI,CAAC;AAAA,MACnF,GAAI,SAAS,GAAG,SAAS,UAAU,EAAE,SAAS,SAAS,GAAG,SAAS,QAAQ,IAAI,CAAC;AAAA,IAClF;AAAA,IACA,EAAE,UAAU,KAAK,UAAU,OAAO,KAAK,OAAO,KAAK,KAAK,IAAI;AAAA,EAC9D,GAAG,EAAE,MAAM,OAAuB,EAAE,QAAQ,cAAc,EAAE;AAC9D,QAAM,UAAU,MAAM,YAAY,EAAE,GAAG,SAAS,IAAI,QAAQ,SAAS,OAAO,GAAG,IAAI;AACnF,MAAI,QAAQ,WAAW,eAAe;AACpC,UAAM;AAAA,MACJ,mIAAmI,GAAG,0DAA0D,KAAK,IAAI;AAAA,IAC3M;AAAA,EACF,WAAW,QAAQ,WAAW,YAAY,CAAC,KAAK,OAAO;AACrD,WAAO,EAAE,QAAQ,SAAS,QAAQ,OAAO,SAAS,mBAAmB,SAAS,KAAK,IAAI,EAAE;AAAA,EAC3F,WAAW,QAAQ,WAAW,UAAU;AACtC,UAAM;AAAA,MACJ,+GAA+G,GAAG,YAAY,QAAQ,QAAQ,OAAO,IAAI,QAAQ,EAAE,KAAK,GAAG,CAAC;AAAA,IAC9K;AAAA,EACF,OAAO;AACL,UAAM,KAAK,YAAY,GAAG,mBAAmB,QAAQ,OAAO,MAAM,MAAM,GAAG,QAAQ,SAAS,cAAc,EAAE,GAAG;AAAA,EACjH;AACA,MAAI,QAAQ,WAAW,cAAe,QAAO,EAAE,QAAQ,SAAS,QAAQ,MAAM;AAC9E,QAAM,OAAO,MAAM;AACnB,MAAI,KAAK,WAAW,SAAU,QAAO,EAAE,QAAQ,SAAS,QAAQ,OAAO,SAAS,oBAAoB,KAAK,QAAQ,KAAK,IAAI,EAAE;AAC5H,MAAI,KAAK,WAAW,SAAU,OAAM,KAAK,mDAAmD,KAAK,SAAS,cAAc,EAAE,GAAG;AAC7H,MAAI,KAAK,WAAW,eAAe;AACjC,UAAM,KAAK,0IAA0I;AAAA,EACvJ;AACA,SAAO,EAAE,QAAQ,SAAS,QAAQ,MAAM;AAC1C;AAIA,IAAM,cACJ;AAEF,IAAM,OAAO;AAAA,EACX,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AAAA,EACA,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,IACT,aAAa;AAAA,EACf;AACF;AAEA,eAAe,EAAE,SAAS,uBAAuB,aAAa,aAAa,MAAM,KAAK,CAAC;AAGvF,eAAe,cAAc,KAAa,eAAwC;AAChF,QAAM,SAASA,MAAK,QAAQ,GAAG;AAC/B,MAAI;AACF,YAAQ,MAAM,KAAK,MAAM,GAAG,YAAY,IAAI,SAASA,MAAK,QAAQ,MAAM;AAAA,EAC1E,QAAQ;AACN,WAAOA,MAAK,KAAK,eAAe,OAAO,aAAa,GAAG;AAAA,EACzD;AACF;AAEO,IAAM,qBAAqB,cAAc;AAAA,EAC9C,MAAM,EAAE,MAAM,gBAAgB,aAAa,YAAY;AAAA,EACvD,MAAM;AAAA,EACN,MAAM,IAAI,EAAE,KAAK,GAAG;AAClB,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,gBAAgB,kBAAkB,GAAG,KAAK;AAChD,UAAM,cAAc,MAAM,cAAc,OAAO,KAAK,IAAI,GAAG,aAAa;AACxE,UAAM,OAAOA,MAAK,SAAS,WAAW;AACtC,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,2BAA2B,WAAW;AAAA,IACzD,SAAS,GAAG;AACV,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS,8BAA8B,WAAW,KAAK,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC;AAAA,UACjG,KAAK;AAAA,QACP;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM,WAAW,MAAM,cAAc,SAAS,SAAS,kBAAkB,aAAa,CAAC;AACvF,UAAM,QAA0B,EAAE,GAAG,SAAS,IAAI,QAAQ,SAAS,OAAO;AAC1E,UAAM,WAAWA,MAAK,KAAK,eAAe,UAAU,QAAQ;AAC5D,UAAM,QAAuB,CAAC;AAC9B,UAAM,UAAU,MAAM,YAAY,OAAO;AAAA,MACvC;AAAA,MACA,OAAO;AAAA,MACP,KAAK,mBAAmB,oBAAoB,CAAC,UAAU,MAAM,KAAK,KAAK,CAAC;AAAA,MACxE,OAAO,aAAa,CAAC,UAAU,MAAM,KAAK,KAAK,CAAC;AAAA,IAClD,CAAC;AAED,UAAM,kBAAkB,UAAU,KAAK;AACvC,UAAM,MAAM,eAAe,SAAS,MAAM;AAC1C,UAAM,SAAS,KAAK,OAChB;AAAA,MACE,gBAAgB,SAAS;AAAA,MACzB,aAAa,SAAS;AAAA,MACtB,UAAU,MAAM;AAAA,MAChB,GAAI,QAAQ,WAAW,gBAAgB,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,MACrE,GAAI,SAAS,MAAM,SAAS,IAAI,EAAE,OAAO,SAAS,MAAM,IAAI,CAAC;AAAA,IAC/D,IACA,CAAC;AACL,QAAI,QAAQ,WAAW,UAAU;AAC/B,YAAM,SAAS,eAAe;AAC9B,YAAM,SAAS,MAAM,gBAAgB,QAAQ;AAE7C,UAAI,kBAAkB,QAAQ,QAAQ,IAAI,GAAG;AAC3C,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,MAAM,EAAE,SAAS,MAAM,YAAY,OAAO,QAAQ,KAAK,QAAQ,QAAQ,QAAQ,QAAQ,GAAG,OAAO;AAAA,UACjG,OAAO;AAAA,YACL,qGAAqG,IAAI,8BAA8B,GAAG,YAAY,QAAQ,QAAQ,OAAO,IAAI,QAAQ,EAAE,KAAK,GAAG,CAAC;AAAA,UACtM;AAAA,QACF,CAAC;AACD;AAAA,MACF;AACA,UAAI,OAAQ,OAAM,kBAAkB,UAAU,CAAC,YAAY,iBAAiB,SAAS,QAAQ,IAAI,CAAC;AAClG,YAAM,UAAU,mBAAmB,SAAS,IAAI;AAChD,gBAAU,EAAE,GAAG,SAAS,OAAO,EAAE,GAAG,QAAQ,OAAO,GAAG,OAAO,EAAE,CAAC;AAChE,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI,QAAQ,WAAW,eAAe;AACpC,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,MAAM,EAAE,SAAS,OAAO,QAAQ,KAAK,GAAG,OAAO;AAAA,QAC/C,OAAO;AAAA,UACL;AAAA,QACF;AAAA,MACF,CAAC;AACD;AAAA,IACF;AACA,cAAU;AAAA,MACR,IAAI;AAAA,MACJ,MAAM;AAAA,QACJ,SAAS;AAAA,QACT,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,OAAO,QAAQ,OAAO,MAAM;AAAA,QAC5B,UAAU,QAAQ,OAAO,SAAS;AAAA,QAClC,WAAW,QAAQ,OAAO,UAAU;AAAA,QACpC,GAAI,QAAQ,SAAS,EAAE,QAAQ,KAAK,IAAI,CAAC;AAAA,QACzC,GAAG;AAAA,MACL;AAAA,MACA,OAAO;AAAA,QACL,SAAS,SAAS,YACd,4MACA,mBAAmB,GAAG,wCAAwC,IAAI;AAAA,MACxE;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;","names":["createHash","mkdir","readFile","writeFile","path","z","readFile","path","z","z","path","readFile","z","createHash","readFile","path","mkdir","writeFile"]}

package/dist/chunk-H5HDZ7IC.js

@@ -0,0 +1,139 @@
+import {
+  brandVerificationHints
+} from "./chunk-IVIJJXXT.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-MJQBXFW6.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/images/logo.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.logo",
+  description: "Brand logo lookup via Brandfetch. Auto-ingests by default. Returns `brandMatch` \u2014 Brandfetch's own verdict on whose brand the domain is (confirmed | mismatch | unverified). Branch on it: `mismatch` means the mark is another company's, so do not place it. `confirmed` verifies the record, not the artwork \u2014 read the ingested row back to check the mark itself.",
+  args: {
+    domain: { type: "string", description: "Brand domain (e.g. stripe.com)", required: true },
+    variant: { type: "string", description: "icon | logo | symbol", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Ingest top N hits (0-${AUTO_INGEST_MAX.logo}). Defaults to 1 (the first variant). Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants, so ${AUTO_INGEST_MAX.logo} ingests every one. Keep it at 1+ \u2014 the ingested row is the only way to check the mark is the brand you asked for.`,
+      required: false
+    },
+    "no-auto-ingest": {
+      type: "boolean",
+      description: "Skip auto-ingest (equivalent to --auto-ingest 0). Leaves the returned mark unverifiable.",
+      required: false,
+      default: false
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested logo variants (e.g. 'Stripe \u2014 payments integration partner', 'Acme competitor brand mark')",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var logoCommand = defineCommand({
+  meta: {
+    name: "logo",
+    description: "Brand logo via Brandfetch. Returns up to 5 variants (icon, light/dark logo, light/dark symbol) plus `brandMatch`. Auto-ingests the first variant.\n\nStart here: check `brandMatch.verdict`.\n  mismatch   \u2192 the mark belongs to `brandMatch.name`, a different company. Do not place it.\n  unverified \u2192 nothing confirmed whose logo this is. Treat as unchecked.\n  confirmed  \u2192 Brandfetch has this brand's record. That verifies the record, NOT the artwork \u2014 a confirmed domain has served another company's logo before.\n\n\u26A0 Whatever the verdict, read the ingested row back with `baker images get <imageId>` and check `textInImage`/`subject` before placing it. That is the only check that looks at the mark.\n\nExample: baker images logo stripe.com --variant logo"
+  },
+  args: {
+    domain: { type: "positional", description: "Brand domain", required: false },
+    variant: { type: "string", description: "icon|logo|symbol", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Ingest top N (0-${AUTO_INGEST_MAX.logo}, default 1)`,
+      required: false
+    },
+    "no-auto-ingest": { type: "boolean", description: "Skip auto-ingest", required: false },
+    context: { type: "string", description: "Description context hint applied to ingested logos", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const domain = args.domain;
+      if (!domain) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Domain is required" } });
+        process.exit(1);
+      }
+      const body = { domain };
+      if (args.variant) body.variant = args.variant;
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.logo);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants for a domain, so --auto-ingest ${AUTO_INGEST_MAX.logo} already ingests every one. Re-run with a value in 0-${AUTO_INGEST_MAX.logo}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      } else if (args["no-auto-ingest"]) {
+        body.autoIngest = 0;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/logo", body);
+      const hints = [
+        // `brandMatch` is Brandfetch's own answer to whose brand this domain is,
+        // so the warning can now be graded instead of fired blind: loud on a
+        // mismatch, honest about what a confirmation does and does not cover.
+        ...brandVerificationHints({
+          domain,
+          ingested: data.ingested,
+          hitCount: data.hits.length,
+          brandMatch: data.brandMatch
+        }),
+        ...emptyResultHints({ provider: "logo", hitCount: data.hits.length, activeFilters: [], subject: domain })
+      ];
+      writeProviderHits(data, data.hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+async function fetchBrandLogo(domain) {
+  try {
+    const body = { domain, variant: "logo" };
+    const data = await apiPost("/api/images/logo", body);
+    if (data?.brandMatch?.verdict === "mismatch") return null;
+    return data?.ingested?.[0]?.imageUrl ?? data?.hits?.find((h) => h.imageUrl)?.imageUrl ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  logoCommand,
+  fetchBrandLogo
+};
+//# sourceMappingURL=chunk-H5HDZ7IC.js.map