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

package/dist/scaffold-static-ad-SUEYXLOR.js

@@ -0,0 +1,948 @@
+import {
+  isValidScaffoldSlug,
+  resolveCastAvatars,
+  resolveScaffoldStaticAdPaths
+} from "./chunk-7OFNN4CT.js";
+import {
+  fail,
+  fileExists,
+  loadAssetText,
+  parseElements,
+  resolveModel
+} from "./chunk-ZNBDKK4Y.js";
+import {
+  buildBackendClient
+} from "./chunk-Y5ZGWLWP.js";
+import "./chunk-DIY6QR3E.js";
+import {
+  syncCreativeDefinitionBestEffort
+} from "./chunk-TCNNOLVZ.js";
+import "./chunk-EZUG6WE2.js";
+import "./chunk-WN4KX7GE.js";
+import "./chunk-PWGWMIIJ.js";
+import "./chunk-W3ZHJJVT.js";
+import "./chunk-IVIJJXXT.js";
+import "./chunk-WS2GMOSG.js";
+import "./chunk-Q6ULQMWG.js";
+import "./chunk-KKJ4KJCW.js";
+import "./chunk-3ACMDRSE.js";
+import {
+  enforceNewCreativeLimit
+} from "./chunk-MLU6STIN.js";
+import "./chunk-IKGWQBKJ.js";
+import {
+  buildCreativeDefinition,
+  describeBlueprintIntent,
+  parseDefinitionViewerFields,
+  resolveFormatList,
+  resolvePlatform,
+  setDefinitionViewer,
+  titleFromSlug
+} from "./chunk-ICM2OXZV.js";
+import "./chunk-URIYUZIN.js";
+import {
+  brandBlock,
+  brandHeadlineFont,
+  castAvatarsOnStaticElements,
+  computeSourceSha,
+  findBrandRoot,
+  pickImageModel,
+  readNamedTypefaces,
+  readStaticBrandKit,
+  scaffoldStaticAd,
+  staticAdReport,
+  staticAdSpec,
+  staticAvatarsNotCast,
+  webFontUrl
+} from "./chunk-2CD5ZP7M.js";
+import "./chunk-73QKIIIR.js";
+import {
+  describeViewer,
+  liveViewerLookups,
+  resolveViewer
+} from "./chunk-HXTGYOQC.js";
+import "./chunk-27NMXSC3.js";
+import {
+  LIBRARY_PLATFORMS,
+  conceptFromFit,
+  fetchLibraryReference,
+  fitHints,
+  libraryReferenceBlock,
+  mergeReferenceIntoBlueprint,
+  readCachedFit,
+  referenceDescribeContext,
+  resolveSourcePlatform
+} from "./chunk-OC5IJSIW.js";
+import {
+  fetchJson,
+  lookupGoogleCss
+} from "./chunk-7GPDUS3P.js";
+import "./chunk-75VNSKS3.js";
+import "./chunk-ZJ47BR6X.js";
+import "./chunk-NFSLRRIE.js";
+import "./chunk-F2S5BLPE.js";
+import "./chunk-K3PN7TN5.js";
+import {
+  findWorkspaceRoot,
+  resolveRelativeCanvasPaths
+} from "./chunk-HIPDMQZ6.js";
+import {
+  ValidationError,
+  createEngineFromEnv,
+  defaultRegistry,
+  validateCanvasDeep
+} from "./chunk-HMEFD2CG.js";
+import "./chunk-RRUJQVWA.js";
+import "./chunk-W3B4BHQU.js";
+import {
+  conceptClassOf,
+  conceptProblems,
+  readAdSpec
+} from "./chunk-CLMM6P6B.js";
+import "./chunk-4SJDDGPV.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-HO3IUJ4K.js";
+import {
+  AD_DESCRIBE_MODEL,
+  AD_FORMAT_PLATFORMS,
+  AD_PLATFORMS,
+  BLUEPRINT_ANALYSIS_MODEL,
+  deliverySet
+} from "./chunk-OBDAYP2P.js";
+import "./chunk-RX6F3GEA.js";
+import {
+  VIEWER_KNOWS_VALUES,
+  VIEWER_TEMPERATURE_VALUES,
+  marketFromCompanyDoc
+} from "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-VAJBWA2U.js";
+import {
+  sha256Hex,
+  toModelSafeImage
+} from "./chunk-OTFHEHIU.js";
+import "./chunk-VVZBBKRC.js";
+import {
+  MAX_REMOTE_IMAGE_BYTES,
+  fetchExternalBytes
+} from "./chunk-YBMVHGY3.js";
+import "./chunk-XWH7CCBL.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-WYCVJIHD.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-XML7AJM3.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/scaffold-static-ad.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/commands/canvas/scaffold-viewer.ts
+function flagText(value) {
+  const text = typeof value === "string" || typeof value === "number" ? String(value).trim() : "";
+  return text || void 0;
+}
+function narrows(placements) {
+  return placements.some((placement) => placement !== "automatic");
+}
+function flagList(value) {
+  const list = (flagText(value) ?? "").split(",").map((item) => item.trim()).filter(Boolean);
+  return list.length > 0 ? list : void 0;
+}
+var isTemperature = (value) => VIEWER_TEMPERATURE_VALUES.includes(value);
+var isKnows = (value) => VIEWER_KNOWS_VALUES.includes(value);
+function viewerFields(flags) {
+  const temperature = flagText(flags["viewer-temperature"]);
+  if (temperature !== void 0 && !isTemperature(temperature)) {
+    return { ok: false, message: `--viewer-temperature must be one of ${VIEWER_TEMPERATURE_VALUES.join(", ")}` };
+  }
+  const knows = flagList(flags["viewer-knows"]);
+  if (knows && !knows.every(isKnows)) {
+    return { ok: false, message: `--viewer-knows takes ${VIEWER_KNOWS_VALUES.join(", ")}` };
+  }
+  const placements = flagList(flags["viewer-placements"]);
+  return {
+    ok: true,
+    fields: {
+      ...temperature ? { temperature } : {},
+      ...knows ? { knows: knows.filter(isKnows) } : {},
+      ...placements ? { placements } : {}
+    }
+  };
+}
+function givenViewer(fields) {
+  if (!fields.temperature) return void 0;
+  return {
+    temperature: fields.temperature,
+    knows: fields.knows ?? [],
+    placements: fields.placements ?? ["automatic"],
+    source: "knowledge",
+    reasons: ["No ad set was read: this viewer was given when the ad was scaffolded, from the Knowledge."]
+  };
+}
+var FIELD_WORDS = {
+  temperature: "Temperature",
+  knows: "What they know",
+  placements: "Placements"
+};
+function correctedViewer(read, fields) {
+  const stated = Object.keys(FIELD_WORDS).filter((key) => fields[key] !== void 0);
+  if (stated.length === 0) return read;
+  return {
+    ...read,
+    ...fields,
+    reasons: [...read.reasons, ...stated.map((key) => `${FIELD_WORDS[key]} given when the ad was scaffolded.`)]
+  };
+}
+var EVERY_PLACEMENT = "so the sizes keep clear of every placement";
+async function readAdSet(adSetId, adSetViewer, notes) {
+  try {
+    const viewer = await adSetViewer(adSetId);
+    if (viewer) return viewer;
+    notes.push(`Ad set ${adSetId} is not in any connected Meta ad account, ${EVERY_PLACEMENT}.`);
+  } catch (e) {
+    notes.push(`Could not read ad set ${adSetId} (${e instanceof Error ? e.message : String(e)}), ${EVERY_PLACEMENT}.`);
+  }
+  return void 0;
+}
+async function recordedViewer(definition, adSetViewer) {
+  const { targetAdSet, viewer: recorded } = parseDefinitionViewerFields(definition);
+  if (!targetAdSet && recorded === void 0) return { ok: true, record: false, notes: [] };
+  const resolved = await resolveViewer({ recorded, targetAdSet }, { adSetViewer, personas: async () => [] });
+  const viewer = resolved.from === "recorded" || resolved.from === "ad_set" ? resolved.viewer : void 0;
+  return outcome(targetAdSet, viewer, false, resolved.notes);
+}
+function outcome(targetAdSet, viewer, record, notes) {
+  return {
+    ok: true,
+    ...targetAdSet ? { targetAdSet } : {},
+    ...viewer ? { viewer } : {},
+    record,
+    ...viewer && narrows(viewer.placements) ? { adPlacements: viewer.placements } : {},
+    notes
+  };
+}
+async function scaffoldViewer(flags, existingDefinition, adSetViewer) {
+  const targetAdSet = flagText(flags["target-adset"]);
+  const given = viewerFields(flags);
+  if (!given.ok) return given;
+  const { fields } = given;
+  if (!targetAdSet && !fields.temperature && (fields.knows || fields.placements)) {
+    return {
+      ok: false,
+      message: "--viewer-knows and --viewer-placements describe a viewer: pass --viewer-temperature too"
+    };
+  }
+  if (!targetAdSet && !fields.temperature && existingDefinition !== null) {
+    return await recordedViewer(existingDefinition, adSetViewer);
+  }
+  const notes = [];
+  const read = targetAdSet ? await readAdSet(targetAdSet, adSetViewer, notes) : void 0;
+  const viewer = read ? correctedViewer(read, fields) : givenViewer(fields);
+  return outcome(targetAdSet, viewer, targetAdSet !== void 0 || viewer !== void 0, notes);
+}
+
+// src/commands/canvas/scaffold-static-ad.ts
+function toCanvasRelative(canvasDir, file) {
+  const rel = path.relative(canvasDir, file).split(path.sep).join("/");
+  return rel.startsWith(".") ? rel : `./${rel}`;
+}
+async function uploadSourceAsReference(source, isUrl, client) {
+  let bytes;
+  if (isUrl) {
+    try {
+      ({ buffer: bytes } = await fetchExternalBytes(source, { maxBytes: MAX_REMOTE_IMAGE_BYTES }));
+    } catch (e) {
+      throw new Error(`failed to download source image (${e instanceof Error ? e.message : String(e)})`);
+    }
+  } else {
+    bytes = await readFile(source);
+  }
+  const safe = await toModelSafeImage(bytes);
+  const sha256 = sha256Hex(safe.bytes);
+  const { putUrl, publicUrl } = await client.presignAssetUpload(sha256, safe.mime, void 0, "source");
+  const putRes = await fetch(putUrl, {
+    method: "PUT",
+    body: new Uint8Array(safe.bytes),
+    headers: { "Content-Type": safe.mime }
+  });
+  if (!putRes.ok) throw new Error(`source upload failed (${putRes.status})`);
+  return publicUrl;
+}
+async function brandFace(root, kit, toCanvas) {
+  const font = await brandHeadlineFont({
+    file: kit.headlineFont,
+    named: await readNamedTypefaces(root),
+    resolveUrl: (family, weight) => webFontUrl(family, weight, { lookupGoogleCss, fetchJson })
+  });
+  if (!font) return null;
+  return "path" in font.slot ? { ...font, slot: { path: toCanvas(font.slot.path) } } : font;
+}
+function staticTextNote(report) {
+  if (report.text_forward) {
+    return "The reference pictures nothing but copy, so this ad is its words on the brand's colours: keep prompt.json's `references` empty unless the concept wants a picture.";
+  }
+  const face = report.font ? `in ${report.font}, shown to it as a specimen` : "in the face `brand.typeface` names (the brand has no font file)";
+  return `The copy is set by the image model: every line of \`copy\` in prompt.json, exactly as written, once. A line marked \`"lettering": "designed"\` is set ${face}; a line marked \`"in_scene"\` is lettered on the object it names (\`on\`), the way \`look\` says. Edit the copy in prompt.json; every run compiles the render prompts from it again and the review reads every word back against it.`;
+}
+function staticFormatsNote(report, genModel) {
+  const set = report.placements === null && report.platforms === null ? " Pass --platforms meta,tiktok,google_display,\u2026 for every size where the ad runs." : "";
+  const banners = report.banners.length > 0 ? ` The fixed banners ${report.banners.join(", ")} are not made from the picture: make them apart, from the delivered sizes, before staging a display campaign.` : "";
+  const plan = report.format_plan;
+  const made = {
+    master: (format) => `${format} is the chosen picture (rendered at ${plan.master.renderRatio})`,
+    relayout: (format) => `${format} is the chosen ad re-laid out for that frame by the image model (one billed request): the same words, people, product and logo, re-scaled for the frame, inside its safe area`,
+    crop: (format) => `${format} is cut from it, every word kept inside its safe area (free)`,
+    adapt: (format) => `${format} is adapted from it by the reframe model (one billed request)`
+  };
+  const how = plan.sizes.map((f) => made[f.from]?.(f.format) ?? f.format).join("; ");
+  const again = plan.sizes.some((s) => s.from === "relayout") ? "" : " No size is rendered again.";
+  return `Delivers ${report.output_formats.join(", ")}, each at its exact size, all from one picture (${genModel}): ${how}.${again}${set}${banners}`;
+}
+function viewerOutput(who) {
+  return {
+    ...who.targetAdSet ? { target_adset: who.targetAdSet } : {},
+    ...who.viewer ? {
+      viewer: {
+        temperature: who.viewer.temperature,
+        knows: who.viewer.knows,
+        placements: who.viewer.placements,
+        source: who.viewer.source
+      }
+    } : {}
+  };
+}
+function viewerNote(who) {
+  if (!who.viewer) {
+    return "Nobody said who sees this ad: pass --target-adset <id> (or, with no ad account, --viewer-temperature from the Knowledge) so the sizes keep clear of its placements and every run checks the ad against that viewer. Until then it is checked against a cold stranger.";
+  }
+  const sizes = who.adPlacements ? `the sizes keep clear of ${who.adPlacements.join(", ")}` : "the sizes keep clear of every placement (Advantage+)";
+  return `Made for ${describeViewer(who.viewer)}: write prompt.json's \`viewer\` for them, ${sizes}, and every run checks the ad against this viewer before it spends.`;
+}
+var DESCRIBE_FOCUS = "FIRST, WHY THIS AD WINS, in layers, in `why_it_wins` { disguise (what it pretends to be: a note, a tweet, a newspaper, a chat, a plain ad), voice (who speaks, and how), trigger (the emotion or need it pulls: a free gift, a hidden loss, status, curiosity), attention (what stops the scroll), logic (why it convinces: reciprocity, social proof, a comparison, a price anchor) }, one short phrase each; and in `load_bearing` the 1-4 elements it stops working without (never decoration), each { element, needs: what it takes to carry it } (a free gift, a real peer's face, priced tiers, a native disguise). THEN the LAYOUT: the column/row grid, which region holds what (describe each by what fills it and where it sits, never by percentages or pixel figures), any panel splits, and for EVERY text block its string verbatim, its size relative to the other text (x_large | large | medium | small), weight, case, colour in words, and placement, including small bottom-corner fine print, and whether it is lettered on something in the scene (`surface`). Also: the EXPRESSION and emotion of every person/animal (capture exaggerated or AI-edited faces), the ad_intent, logos by brand, and all visible text verbatim. The TYPOGRAPHY as a first-class identity signal: for EVERY distinct typeface record a `fonts` entry (which text blocks use it, its classification, a best-guess family or close lookalike, its weight/case/styling), and whether the advertiser's LOGO appears in more than one lockup (a square/icon MARK and a horizontal WORDMARK are two assets: capture BOTH). Capture as a photographer would describe it in words (phone or studio, the height and angle, the light and its direction), never as lens or exposure figures. CRITICAL: name the MECHANISM, the one device that makes THIS ad work on a stranger rather than a generic ad (VERBAL: a rhyme, pun, repetition, antithesis; VISUAL: an unexpected crop or scale, a visual gag, a before/after or comparison, bold negative space; STRUCTURAL: an unusual hook, order or reveal). Record every device in `winning_mechanisms` as { kind: verbal|visual|structural, device, why_it_works } and the strongest one in `mechanism`. And read WHO the ad is for, in `audience`: the viewer it speaks to, their awareness stage, how warm they must already be, and whether the copy only works if they already know this brand or offer (`presumes_brand_knowledge`), so a rebuild for a different audience knows what to change";
+var SELECT_SYSTEM = 'You identify the MAIN, identity-critical visual elements of an advertisement from its JSON blueprint \u2014 the things a faithful reproduction must supply as REAL reference images instead of letting a model invent them. Output ONLY a JSON object of the form { "elements": [ ... ] }, no prose.';
+var SELECT_PROMPT = `AD BLUEPRINT (from image_describe):
+{{blueprint}}
+
+From this blueprint, list ONLY the elements that are prominent, important, and identity-bearing \u2014 the ones a reproduction must ground in a real asset:
+- the brand logo/wordmark (from brands_logos with function_in_image = advertiser_brand) -> type "logo". A brand often ships its logo in TWO lockups \u2014 a square/icon MARK and a horizontal WORDMARK \u2014 and an ad may use both (e.g. an icon in a product mock plus the wordmark in the sign-off). When more than one distinct lockup of the SAME advertiser appears, emit a SEPARATE logo element for each (label them by lockup, e.g. LOGO_MARK and LOGO_WORDMARK) so the reproduction can drop the right file in each slot instead of stretching one logo to cover both.
+- trust/rating/certification/app-store/review badges (brands_logos with function_in_image = trust_badge | review_platform | certification_or_seal | app_store_badge | payment_method) -> type "badge"
+- a showcased/hero product or package (a foreground entry in subjects that the ad is selling) -> type "product"
+- a foreground person (from people) \u2014 keep it when its identity matters OR it is the emotional/hero focal point of the ad, even a generic one with no brand identity -> type "person". Describe them as a castable, invented everyday person (age band, look, wardrobe, expression) \u2014 never the source person's identity: unless a company avatar is cast, the render draws this person from your words alone
+- a foreground animal/character (from subjects) \u2014 keep it when it carries a specific expression OR it is the emotional/hero focal point, even a generic one -> type "animal"
+  (For an animal: a free-generated muzzle or teeth reads as AI and grows artifacts \u2014 malformed mouths, foam \u2014 so the emotional hero needs the STRONGEST real grounding, not the weakest; "it's just a generic dog/person" is never a reason to drop either.)
+
+DROP background extras, decorative props, generic scenery, and anything small or incidental. Keep at most ~6. If there are none, return an empty list.
+
+For each kept element return: { "type": one of logo|product|person|animal|badge, "label": a short UPPER_SNAKE_CASE name (e.g. LOGO, PRODUCT, HERO_DOG, TRUSTPILOT), "description": a concrete reusable description to source/shoot the real asset (include the exact expression for a living subject, and its castable attributes \u2014 breed/species for an animal, apparent age band, apparent origin/ethnicity, and wardrobe/setting for a person \u2014 so it can be recast to fit OUR audience/market), "expression": the facial expression for a living subject or null, "reason": why it is identity-critical, "locator": the blueprint entry this element came from as { "collection": one of "subjects" | "people" | "brands_logos", "index": its 0-based position in that array } (people -> people; logos/badges -> brands_logos; products/animals/objects -> subjects). Output ONLY the JSON object.`;
+function resolveModels(args) {
+  return {
+    describeModel: resolveModel("image_describe", args["describe-model"], AD_DESCRIBE_MODEL),
+    selectModel: resolveModel("text_generate", args["select-model"], BLUEPRINT_ANALYSIS_MODEL),
+    // The render model: `--gen-model`, else the router's model for the concept (decided once
+    // the blueprint is read, `renderModelFor`). Resolved here only so a bad override fails for free.
+    genModel: args["gen-model"] ? resolveModel("image_generate", args["gen-model"], String(args["gen-model"])) : void 0
+  };
+}
+var PLATFORM_PLACEMENTS = {
+  meta: "meta_feed_stories",
+  google: "google_demandgen",
+  linkedin: "linkedin",
+  tiktok: "tiktok",
+  youtube: "youtube",
+  x: void 0,
+  other: void 0
+};
+function resolvePlacements(placementsFlag, definitionPlatform) {
+  const flag = placementsFlag?.trim();
+  if (flag === void 0 || flag === "") return { ok: true, placements: PLATFORM_PLACEMENTS[definitionPlatform] };
+  if (flag === "none") return { ok: true, placements: void 0 };
+  if (AD_FORMAT_PLATFORMS.includes(flag)) return { ok: true, placements: flag };
+  return {
+    ok: false,
+    message: `--placements "${flag}" is not a valid placement set. Use one of: ${AD_FORMAT_PLATFORMS.join(", ")}, or "none" for a single base ad.`
+  };
+}
+function resolvePlatforms(flag) {
+  const names = (flag ?? "").split(",").map((n) => n.trim()).filter(Boolean);
+  if (names.length === 0) return { ok: true, platforms: void 0 };
+  const { unknown, formats, banners } = deliverySet(names);
+  if (unknown.length > 0) {
+    return { ok: false, message: `--platforms names ${unknown.join(", ")}, which is no platform here. Use any of: ${AD_PLATFORMS.join(", ")}.` };
+  }
+  if (formats.length === 0 && banners.length > 0) {
+    return {
+      ok: false,
+      message: `--platforms ${names.join(",")} requires only fixed-size banners (${banners.map((b) => b.format).join(", ")}), which are never made from the picture: add a platform with a feed or story size (meta, google_display, \u2026).`
+    };
+  }
+  return { ok: true, platforms: names };
+}
+async function validateScaffoldedStaticAd(canvas, canvasDir) {
+  const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(canvas, canvasDir), defaultRegistry());
+  if (validation.ok) return { blocking: [], hints: [], estimatedCredits: validation.estimatedCredits };
+  const overCap = validation.issues.filter((i) => i.code === "PROMPT_OVER_MODEL_LIMIT");
+  return {
+    blocking: validation.issues.filter((i) => i.code !== "PROMPT_OVER_MODEL_LIMIT"),
+    hints: overCap.map((i) => `${i.code}: ${i.message} Trim prompt.json, then \`baker canvas validate\`.`)
+  };
+}
+function buildDescribeCanvas(imageSource, imageIsUrl, describeModel, selectModel, context) {
+  const originalParams = imageIsUrl ? { source: "url", url: imageSource, expect: "image" } : { source: "path", path: imageSource, expect: "image" };
+  return {
+    schema: "baker-canvas/1",
+    metadata: { name: "static-ad describe pass" },
+    nodes: [
+      { id: "original", type: "ingest", params: originalParams },
+      {
+        id: "describe",
+        type: "image_describe",
+        inputs: { image: "$ref:original.asset" },
+        params: { model: describeModel, max_tokens: 9e3, ...context ? { context } : {}, focus: DESCRIBE_FOCUS }
+      },
+      {
+        id: "select",
+        type: "text_generate",
+        inputs: { blueprint: "$ref:describe.description" },
+        params: {
+          model: selectModel,
+          max_tokens: 4e3,
+          temperature: 0,
+          response_format: "json_object",
+          system: SELECT_SYSTEM,
+          prompt: SELECT_PROMPT
+        }
+      }
+    ]
+    // No declared output: runVisionPasses reads both node outputs after the run.
+  };
+}
+async function runVisionPasses(canvas) {
+  const engine = createEngineFromEnv({ log: (line) => process.stderr.write(`${line}
+`) });
+  let outputsByNode;
+  let creditsSpent;
+  try {
+    const result = await engine.run(canvas, {});
+    outputsByNode = result.outputs_by_node;
+    creditsSpent = result.stats?.total_credits;
+  } catch (e) {
+    if (e instanceof ValidationError) return fail("validation", JSON.stringify(e.issues));
+    return fail("describe", e instanceof Error ? e.message : String(e));
+  }
+  try {
+    const blueprint = JSON.parse(await loadAssetText(outputsByNode.describe?.description, "describe output"));
+    const elements = parseElements(await loadAssetText(outputsByNode.select?.text, "selection output"));
+    return { blueprint, elements, creditsSpent };
+  } catch (e) {
+    return fail("read_outputs", e instanceof Error ? e.message : String(e));
+  }
+}
+var SOURCE_AD_ID_DESCRIPTION = "The winners-library ad this creative adapts (the `ad_id` from `baker winning-ads search`). The library's read of that ad (container, layout, colours, text blocks with their roles, persuasion mechanism, offer) is fetched and written into prompt.json as `reference`, the describe pass is told it so the two reads agree, and the source is recorded on the creative from this scaffold on. With it, the image is optional: the library's picture is used when none is given. Pass it whenever the reference came from the library.";
+var PLATFORMS_DESCRIPTION = `Where the ad runs, comma-separated platforms or placements (e.g. \`meta,tiktok\`, \`google_display\`, \`meta_reels\`): every size they require is delivered, each kept clear of its own placement's interface (a 9:16 for TikTok keeps clear of TikTok's buttons). Platforms: ${AD_PLATFORMS.join(", ")}. Wins over --placements. Fixed banner sizes (728x90\u2026) are listed in the report, not made.`;
+var SOURCE_PLATFORM_DESCRIPTION = `Which platform the library ad is on: ${LIBRARY_PLATFORMS.join("|")} (default meta).`;
+var TARGET_ADSET_DESCRIPTION = "The Meta ad set this ad will run in (an id from `baker ads meta adsets`). Who it reaches is read off its targeting, as `baker ads meta adsets --audience` reads it, and recorded in _definition.md as `targetAdSet` and `viewer`; the sizes and the render brief keep clear of its placements, and every run checks the ad against that viewer. Free, read before anything is billed. Start here whenever the ad is for a known ad set.";
+var VIEWER_TEMPERATURE_DESCRIPTION = "With no ad set to read (no ad account, or not decided yet): how warm the viewer is, from the Knowledge (personas, funnel): cold (never heard of the brand), warm (knows the brand), hot (a customer). Recorded as `viewer` with `source: knowledge`. With --target-adset it corrects the temperature read off the ad set.";
+var VIEWER_KNOWS_DESCRIPTION = "What the viewer already knows, comma-separated from brand,offer,product (e.g. `brand,offer`). Needs --viewer-temperature or --target-adset.";
+var VIEWER_PLACEMENTS_DESCRIPTION = "Where the viewer meets the ad, comma-separated Meta placements (e.g. `instagram_feed,facebook_feed`, `instagram_stories`); default automatic (Advantage+, Reels included). The sizes keep clear of these placements' interface. Needs --viewer-temperature or --target-adset.";
+var SOURCE_ADVERTISER_ID_DESCRIPTION = "The library advertiser id of the reference (the `advertiser_id` beside the ad in search results). Defaults to the one the library returns for the ad.";
+registerSchema({
+  command: "canvas.scaffold-static-ad",
+  description: "Turn a reference image into a runnable static-ad canvas: billed image_describe + element-selection passes, then a canvas on which the image model renders the finished ad from prompt.json. Start here for a static ad adapted from a winning ad: pass `--source-ad-id <ad_id> --source-platform <platform>` from the search result, so the library's structured read grounds the describe pass (and so prompt.json) and the source is recorded on the creative; the image may then be omitted. A person in one ad is an invented, realistic person drawn from the description; `--avatar <handle>` (`baker avatars list`) only when the same actor must recur across ads.",
+  args: {
+    file: {
+      type: "positional",
+      required: false,
+      description: "Path or http(s) URL to the reference image. Optional with --source-ad-id: the library's picture is used."
+    },
+    "source-ad-id": { type: "string", required: false, description: SOURCE_AD_ID_DESCRIPTION },
+    "source-platform": {
+      type: "string",
+      required: false,
+      description: SOURCE_PLATFORM_DESCRIPTION,
+      enum: [...LIBRARY_PLATFORMS]
+    },
+    "source-advertiser-id": { type: "string", required: false, description: SOURCE_ADVERTISER_ID_DESCRIPTION },
+    context: {
+      type: "string",
+      required: false,
+      description: "Known provenance (advertiser, category, market, their brand palette) to ground the describe pass"
+    },
+    slug: {
+      type: "string",
+      required: false,
+      description: "Creative slug: writes src/creatives/<slug>/<slug>.canvas.json, prompt.json and _definition.md"
+    },
+    title: { type: "string", required: false, description: "Creative title for _definition.md (default: title-cased slug)" },
+    platform: {
+      type: "string",
+      required: false,
+      description: "Ad platform for _definition.md and the default placement set (meta|google|linkedin|tiktok|youtube|x|other; default meta)"
+    },
+    advertiser: {
+      type: "string",
+      required: false,
+      description: "Source advertiser name for _definition.md (default: the library ad's advertiser when --source-ad-id is given)"
+    },
+    placements: {
+      type: "string",
+      required: false,
+      description: "Formats delivered: meta_feed|meta_feed_stories|meta_all|linkedin|google_demandgen|tiktok|youtube, or none for a single base ad (default from --platform)"
+    },
+    platforms: { type: "string", required: false, description: PLATFORMS_DESCRIPTION },
+    aspect: { type: "string", required: false, description: "Force the lead format (else inferred from the image)" },
+    "target-adset": { type: "string", required: false, description: TARGET_ADSET_DESCRIPTION },
+    "viewer-temperature": {
+      type: "string",
+      required: false,
+      description: VIEWER_TEMPERATURE_DESCRIPTION,
+      enum: [...VIEWER_TEMPERATURE_VALUES]
+    },
+    "viewer-knows": { type: "string", required: false, description: VIEWER_KNOWS_DESCRIPTION },
+    "viewer-placements": { type: "string", required: false, description: VIEWER_PLACEMENTS_DESCRIPTION },
+    takes: {
+      type: "string",
+      required: false,
+      description: "Variants of the finished ad rendered (one request each) and judged, 1-3 (default 3). 1 skips the judge."
+    },
+    avatar: {
+      type: "string",
+      required: false,
+      description: "Cast company avatars as the ad's people, comma-separated in detection order (`marta` or `marta,joan`)"
+    },
+    out: { type: "string", required: false, description: "Output canvas path (default <image-dir>/static-ad.canvas.json)" },
+    "describe-model": { type: "string", required: false, description: "Override the image_describe model id" },
+    "select-model": { type: "string", required: false, description: "Override the element-selection text_generate model id" },
+    "gen-model": { type: "string", required: false, description: "Override the image_generate model id" }
+  }
+});
+async function lookupReference(args) {
+  const adId = args["source-ad-id"] ? String(args["source-ad-id"]).trim() : "";
+  if (!adId) return { status: "none" };
+  const platformResult = resolveSourcePlatform(args["source-platform"] ? String(args["source-platform"]) : void 0);
+  if (!platformResult.ok) return fail("invalid_source_platform", platformResult.message);
+  const platform = platformResult.platform;
+  const advertiserId = args["source-advertiser-id"] ? String(args["source-advertiser-id"]).trim() : void 0;
+  try {
+    const ad = await fetchLibraryReference(adId, platform);
+    return {
+      status: "grounded",
+      reference: libraryReferenceBlock(ad, { adId, platform, advertiserId }),
+      mediaUrl: ad.media_url ?? void 0
+    };
+  } catch (e) {
+    return { status: "unavailable", adId, platform, message: e instanceof Error ? e.message : String(e) };
+  }
+}
+async function scaffoldFromSpec(args, slug) {
+  if (!slug) return fail("missing_slug", "--spec needs --slug: an ad started from a spec is a creative.");
+  const specPath = path.resolve(process.cwd(), String(args.spec));
+  let started;
+  try {
+    started = readAdSpec(JSON.parse(await readFile(specPath, "utf8")));
+  } catch (e) {
+    return fail("invalid_spec", `${specPath} is not an ad spec: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  const outPath = path.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`);
+  const dir = path.dirname(outPath);
+  const blueprintPath = path.join(dir, "prompt.json");
+  const definitionPath = path.join(dir, "_definition.md");
+  await enforceNewCreativeLimit(slug, outPath);
+  const existingDefinition = await fileExists(definitionPath) ? await readFile(definitionPath, "utf8") : null;
+  const who = await scaffoldViewer(args, existingDefinition, liveViewerLookups(process.cwd()).adSetViewer);
+  if (!who.ok) return fail("invalid_viewer", who.message);
+  await mkdir(dir, { recursive: true });
+  const workspaceRoot = await findBrandRoot(dir) ?? process.cwd();
+  const kit = await readStaticBrandKit(workspaceRoot);
+  const market = who.viewer?.market ?? marketFromCompanyDoc(await readFile(path.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => null));
+  const brand = brandBlock(kit);
+  const platform = resolvePlatform(args.platform ? String(args.platform) : void 0);
+  const placementsResult = resolvePlacements(args.placements ? String(args.placements) : void 0, platform);
+  if (!placementsResult.ok) return fail("invalid_placements", placementsResult.message);
+  const font = await brandFace(workspaceRoot, kit, (file) => toCanvasRelative(dir, file));
+  const genModel = pickImageModel(conceptClassOf(started), "generate");
+  const opts = {
+    genModel,
+    blueprintPath: "./prompt.json",
+    placements: placementsResult.placements,
+    ...who.adPlacements ? { adPlacements: who.adPlacements } : {},
+    brand: { logoPath: kit.logo ? toCanvasRelative(dir, kit.logo) : void 0, ...font ? { font } : {} }
+  };
+  const report = staticAdReport({}, [], { ...opts, spec: started });
+  const spec = {
+    ...started,
+    ...brand ? { brand: { ...brand, ...started.brand } } : {},
+    formats: report.output_formats,
+    logo: Boolean(kit.logo),
+    ...market ? { viewer: { ...started.viewer ?? { who: "the people this ad is for" }, market } } : {}
+  };
+  await writeFile(blueprintPath, `${JSON.stringify(spec, null, 2)}
+`, "utf8");
+  const canvas = scaffoldStaticAd({}, [], { ...opts, spec });
+  const validation = await validateScaffoldedStaticAd(canvas, dir);
+  if (validation.blocking.length > 0) return fail("validation", validation.blocking.map((i) => i.message).join("; "));
+  await writeFile(outPath, `${JSON.stringify(canvas, null, 2)}
+`, "utf8");
+  const title = args.title ? String(args.title) : titleFromSlug(slug);
+  const recorded = who.record ? { targetAdSet: who.targetAdSet, viewer: who.viewer } : {};
+  if (existingDefinition === null) {
+    const formats = resolveFormatList(report.output_formats);
+    await writeFile(definitionPath, buildCreativeDefinition({ title, kind: "static", platform, formats, ...recorded }), "utf8");
+  }
+  await syncCreativeDefinitionBestEffort({
+    slug,
+    title,
+    platform,
+    formats: resolveFormatList(report.output_formats),
+    canvas,
+    sourceSha: await computeSourceSha(outPath)
+  });
+  process.stdout.write(
+    `${JSON.stringify(
+      {
+        ok: true,
+        canvas_path: outPath,
+        prompt_path: blueprintPath,
+        definition_path: definitionPath,
+        output: canvas.output,
+        hints: [...who.notes, ...validation.hints],
+        ...viewerOutput(who),
+        output_formats: report.output_formats,
+        stats: { total_nodes: canvas.nodes.length, describe_credits_spent: 0, run_estimated_credits: validation.estimatedCredits }
+      },
+      null,
+      2
+    )}
+`
+  );
+}
+var scaffoldStaticAdCommand = defineCommand({
+  meta: {
+    name: "scaffold-static-ad",
+    description: "Turn a source/inspiration image into a runnable static-ad canvas. Runs billed passes \u2014 image_describe (read into prompt.json, the ad spec you rewrite) and an AI selection of the image's MAIN identity elements \u2014 then scaffolds a canvas on which the image model renders the FINISHED ad: up to three variants, one request each, from a brief compiled from prompt.json, the copy quoted verbatim, the brand's typeface shown as a specimen and the logo from src/brand/logos/ as a reference (only when prompt.json has \"logo\": true). A prefilter drops variants whose words or placement fail the checks, and a judge compares the rest pairwise against the brief; the chosen picture is delivered at the lead format (4:5 for a feed) and every other placement format is that ad re-laid out for its own frame by one image request, with the chosen picture as the reference: the same words, people, product and logo, re-scaled for the frame, never cut or shrunk onto a background. The run reads every word back and refuses to call the ad ready when one is off. No copy means the picture is the ad. Pass --placements none for a single base ad, or a preset to pick the set. Edit prompt.json and drop the real assets, then `baker canvas run` it. A person who appears in this one ad is drawn as an invented, realistic person from the description \u2014 no slot to fill; pass `--avatar <handle>` (`baker avatars list`) only when the same actor has to recur across several ads. Never a photo of anyone real. A reference from the library: pass `--source-ad-id <ad_id> --source-platform <platform>` so its structured read grounds the describe pass and the source is recorded on the creative."
+  },
+  args: {
+    file: {
+      type: "positional",
+      required: false,
+      description: "Path or http(s) URL to the source/inspiration image (optional with --source-ad-id)"
+    },
+    "source-ad-id": { type: "string", description: SOURCE_AD_ID_DESCRIPTION },
+    spec: {
+      type: "string",
+      description: "Start from an ad spec (a prompt.json) instead of a reference picture: no describe pass, no source. `baker creatives make` writes one from an idea when no proven ad fits. Needs --slug."
+    },
+    "source-platform": { type: "string", description: SOURCE_PLATFORM_DESCRIPTION },
+    "source-advertiser-id": { type: "string", description: SOURCE_ADVERTISER_ID_DESCRIPTION },
+    context: { type: "string", description: "Known provenance (advertiser, category, market) to ground the describe" },
+    out: { type: "string", description: "Output canvas path (default <image-dir>/static-ad.canvas.json)" },
+    slug: {
+      type: "string",
+      description: "Creative slug \u2014 writes the canvas to src/creatives/<slug>/<slug>.canvas.json (repo convention)"
+    },
+    title: { type: "string", description: "Creative title for _definition.md (default: title-cased slug)" },
+    platform: {
+      type: "string",
+      description: "Ad platform (meta|google|linkedin|tiktok|youtube|x|other; default meta). Sets _definition.md AND, unless --placements is given, the formats the ad is delivered in (meta \u2192 4:5+9:16, google \u2192 1:1+4:5+16:9, linkedin \u2192 1:1, tiktok \u2192 9:16, youtube \u2192 16:9; x/other \u2192 one format)."
+    },
+    advertiser: {
+      type: "string",
+      description: "Source advertiser recorded in _definition.md (default: the library ad's advertiser)"
+    },
+    "describe-model": { type: "string", description: "Override the image_describe model id" },
+    "select-model": { type: "string", description: "Override the text_generate model id for element selection" },
+    "gen-model": { type: "string", description: "Override the image_generate model id" },
+    aspect: {
+      type: "string",
+      description: "Force the ad's lead format (else inferred from the image). Delivered exactly: the ad renders at the model's nearest shape and is cropped to it."
+    },
+    "target-adset": { type: "string", description: TARGET_ADSET_DESCRIPTION },
+    "viewer-temperature": { type: "string", description: VIEWER_TEMPERATURE_DESCRIPTION },
+    "viewer-knows": { type: "string", description: VIEWER_KNOWS_DESCRIPTION },
+    "viewer-placements": { type: "string", description: VIEWER_PLACEMENTS_DESCRIPTION },
+    placements: {
+      type: "string",
+      description: "Formats the ad is delivered in. One of meta_feed | meta_feed_stories | meta_all | linkedin | google_demandgen | tiktok | youtube, or `none` for a single base ad. Default: derived from --platform (meta \u2192 feed + stories). Every format is made from the one chosen picture: the picture itself (the 4:5 when it is delivered), or that ad re-laid out for the format's own frame (one billed request per format)."
+    },
+    platforms: { type: "string", description: PLATFORMS_DESCRIPTION },
+    takes: {
+      type: "string",
+      description: "Variants of the finished ad to render (one request each) and judge, 1-3 (default 3). 1 skips the judge."
+    },
+    avatar: {
+      type: "string",
+      description: "Cast company avatars as the ad's people \u2014 pass this when the same actor has to recur across several ads (a one-off person needs none: they are drawn from the description). One handle, or several comma-separated in the order the people were detected (`--avatar marta` / `--avatar marta,joan`). Each person slot grounds on that avatar's identity sheet and prompt.json describes them in the avatar's own words, so the ad shows the company's cast instead of the source ad's. `baker avatars list` shows who there is; checked before anything is billed."
+    }
+  },
+  async run({ args }) {
+    const slug = args.slug ? String(args.slug) : void 0;
+    if (slug && !isValidScaffoldSlug(slug)) {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "invalid_slug", message: "--slug must be lowercase kebab (a-z, 0-9, hyphens), max 100 chars" } }, null, 2)}
+`
+      );
+      process.exit(2);
+    }
+    if (args.spec) return scaffoldFromSpec(args, slug);
+    const lookup = await lookupReference(args);
+    if (lookup.status === "unavailable") {
+      process.stderr.write(
+        `[warn] winners-library ad ${lookup.adId} (${lookup.platform}) could not be read (${lookup.message}); scaffolding without its structured read
+`
+      );
+    }
+    const reference = lookup.status === "grounded" ? lookup.reference : void 0;
+    const fileArg = args.file ? String(args.file) : void 0;
+    const sourceFile = fileArg ?? (lookup.status === "grounded" ? lookup.mediaUrl : void 0);
+    if (!sourceFile) {
+      if (lookup.status === "none") return fail("missing_source", "Pass the reference image, or --source-ad-id <ad_id> to use a library ad.");
+      if (lookup.status === "unavailable") return fail("source_unavailable", `No image given and the library ad could not be read (${lookup.message}).`);
+      return fail("source_unavailable", `The library holds no picture for ad ${reference?.ad_id}; pass the image.`);
+    }
+    const { imageIsUrl, imageSource, outPath, blueprintPath, definitionPath, referencesDir } = resolveScaffoldStaticAdPaths(sourceFile, args.out ? String(args.out) : void 0, process.cwd(), slug);
+    if (slug) await enforceNewCreativeLimit(slug, outPath);
+    const existingDefinition = definitionPath && await fileExists(definitionPath) ? await readFile(definitionPath, "utf8") : null;
+    const who = await scaffoldViewer(args, existingDefinition, liveViewerLookups(process.cwd()).adSetViewer);
+    if (!who.ok) return fail("invalid_viewer", who.message);
+    const fitRoot = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const fit = reference || lookup.status === "unavailable" ? await readCachedFit(fitRoot, reference?.platform ?? (lookup.status === "unavailable" ? lookup.platform : "meta"), reference?.ad_id ?? (lookup.status === "unavailable" ? lookup.adId : "")) : null;
+    const fitProblems = fit ? fitHints(fit, reference?.ad_id ?? "").filter((h) => h.startsWith("Pick another reference")) : [];
+    if (fitProblems.length > 0) return fail("concept_does_not_fit", fitProblems.join(" "));
+    await mkdir(path.dirname(outPath), { recursive: true });
+    let models;
+    try {
+      models = resolveModels(args);
+    } catch (e) {
+      return fail("unknown_model", e instanceof Error ? e.message : String(e));
+    }
+    const { describeModel, selectModel } = models;
+    const cast = await resolveCastAvatars(args.avatar);
+    if ("error" in cast) return fail("avatar", cast.error);
+    let durableSourceUrl;
+    if (referencesDir) {
+      const client = buildBackendClient();
+      if (client) {
+        try {
+          durableSourceUrl = await uploadSourceAsReference(imageSource, imageIsUrl, client);
+        } catch (e) {
+          return fail("source_unavailable", e instanceof Error ? e.message : String(e));
+        }
+      }
+    }
+    const describeCanvas = buildDescribeCanvas(
+      durableSourceUrl ?? imageSource,
+      durableSourceUrl !== void 0 || imageIsUrl,
+      describeModel,
+      selectModel,
+      referenceDescribeContext(reference, args.context ? String(args.context) : void 0)
+    );
+    const vision = await runVisionPasses(describeCanvas);
+    const { creditsSpent } = vision;
+    const blueprint = mergeReferenceIntoBlueprint(vision.blueprint, reference);
+    const persona = existingDefinition?.match(/^persona:\s*"?([^"\n]+)"?\s*$/m)?.[1];
+    const elements = castAvatarsOnStaticElements(vision.elements, cast.avatars, persona);
+    const uncast = staticAvatarsNotCast(elements, cast.handles);
+    const canvasDir = path.dirname(outPath);
+    const workspaceRoot = await findBrandRoot(canvasDir) ?? process.cwd();
+    const kit = await readStaticBrandKit(workspaceRoot);
+    const market = who.viewer?.market ?? marketFromCompanyDoc(await readFile(path.join(workspaceRoot, "COMPANY.md"), "utf8").catch(() => null));
+    const brand = brandBlock(kit);
+    let canvasImagePath = imageSource;
+    let canvasImageIsUrl = imageIsUrl;
+    let canvasBlueprintPath = blueprintPath;
+    if (referencesDir) {
+      canvasBlueprintPath = "./prompt.json";
+      if (durableSourceUrl) {
+        canvasImagePath = durableSourceUrl;
+        canvasImageIsUrl = true;
+      }
+    }
+    const definitionPlatform = resolvePlatform(args.platform ? String(args.platform) : void 0);
+    const placementsResult = resolvePlacements(
+      args.placements ? String(args.placements) : void 0,
+      definitionPlatform
+    );
+    if (!placementsResult.ok) return fail("invalid_placements", placementsResult.message);
+    const placements = placementsResult.placements;
+    const platformsResult = resolvePlatforms(args.platforms ? String(args.platforms) : void 0);
+    if (!platformsResult.ok) return fail("invalid_platforms", platformsResult.message);
+    const relative = (file) => file ? toCanvasRelative(canvasDir, file) : void 0;
+    const takes = args.takes !== void 0 ? Number.parseInt(String(args.takes), 10) : void 0;
+    if (takes !== void 0 && !(takes >= 1 && takes <= 3)) return fail("invalid_takes", "--takes must be 1, 2 or 3");
+    const font = await brandFace(workspaceRoot, kit, (file) => toCanvasRelative(canvasDir, file));
+    const genModel = models.genModel ?? pickImageModel(conceptClassOf(staticAdSpec(blueprint, elements)), "generate");
+    const opts = {
+      genModel,
+      imagePath: canvasImagePath,
+      imageIsUrl: canvasImageIsUrl,
+      blueprintPath: canvasBlueprintPath,
+      aspectRatio: args.aspect ? String(args.aspect) : void 0,
+      placements,
+      ...platformsResult.platforms ? { platforms: platformsResult.platforms } : {},
+      ...who.adPlacements ? { adPlacements: who.adPlacements } : {},
+      brand: { logoPath: relative(kit.logo), ...font ? { font } : {} },
+      takes
+    };
+    let canvas;
+    let report;
+    let conceptNotes = [];
+    try {
+      report = staticAdReport(blueprint, elements, { ...opts, spec: staticAdSpec(blueprint, elements, { logo: Boolean(kit.logo) }) });
+      const spec = staticAdSpec(blueprint, elements, {
+        brand,
+        formats: report.output_formats,
+        logo: Boolean(kit.logo),
+        ...fit ? { fit: conceptFromFit(fit, reference?.ad_id ?? "") } : {},
+        ...market ? { market } : {}
+      });
+      await writeFile(blueprintPath, `${JSON.stringify(spec, null, 2)}
+`, "utf8");
+      conceptNotes = conceptProblems(spec).map(
+        (p) => `CONCEPT: ${p} Then \`baker canvas run\`; until then it refuses to render.`
+      );
+      if (!fit && reference) {
+        conceptNotes.push(
+          `No fit was made of this reference: \`baker winning-ads fit ${reference.ad_id}\` says what it wins on and what we have for it, and re-scaffolding seeds prompt.json's \`concept\` from it.`
+        );
+      }
+      canvas = scaffoldStaticAd(blueprint, elements, { ...opts, spec });
+    } catch (e) {
+      return fail("scaffold", e instanceof Error ? e.message : String(e));
+    }
+    const validation = await validateScaffoldedStaticAd(canvas, path.dirname(outPath));
+    if (validation.blocking.length > 0) {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.blocking } }, null, 2)}
+`
+      );
+      process.exit(2);
+    }
+    await writeFile(outPath, `${JSON.stringify(canvas, null, 2)}
+`, "utf8");
+    const sourceFields = reference ? {
+      sourceAdId: reference.ad_id,
+      sourcePlatform: reference.platform,
+      ...reference.advertiser_id ? { sourceAdvertiserId: reference.advertiser_id } : {}
+    } : lookup.status === "unavailable" ? {
+      sourceAdId: lookup.adId,
+      sourcePlatform: lookup.platform,
+      ...args["source-advertiser-id"] ? { sourceAdvertiserId: String(args["source-advertiser-id"]).trim() } : {}
+    } : {};
+    const recorded = who.record ? { targetAdSet: who.targetAdSet, viewer: who.viewer } : {};
+    if (definitionPath && existingDefinition !== null && who.record) {
+      await writeFile(definitionPath, setDefinitionViewer(existingDefinition, recorded), "utf8");
+    }
+    if (definitionPath && existingDefinition === null) {
+      await writeFile(
+        definitionPath,
+        buildCreativeDefinition({
+          title: args.title ? String(args.title) : titleFromSlug(slug ?? ""),
+          kind: "static",
+          platform: definitionPlatform,
+          formats: resolveFormatList(report.output_formats),
+          sourceReferenceUrl: durableSourceUrl ?? (imageIsUrl ? imageSource : void 0),
+          sourceAdvertiser: args.advertiser ? String(args.advertiser) : reference?.advertiser ?? (args.context ? String(args.context) : void 0),
+          ...sourceFields,
+          sourceKind: "image",
+          ...recorded,
+          description: describeBlueprintIntent(blueprint)
+        }),
+        "utf8"
+      );
+    }
+    if (slug) {
+      await syncCreativeDefinitionBestEffort({
+        slug,
+        title: args.title ? String(args.title) : titleFromSlug(slug),
+        platform: definitionPlatform,
+        formats: resolveFormatList(report.output_formats),
+        sourceReferenceUrl: durableSourceUrl ?? (imageIsUrl ? imageSource : void 0),
+        ...sourceFields,
+        canvas,
+        sourceSha: await computeSourceSha(outPath)
+      });
+    }
+    const hints = [
+      ...who.notes,
+      ...lookup.status === "unavailable" ? [
+        `REFERENCE NOT READ: the winners library could not return ad ${lookup.adId} (${lookup.message}). prompt.json is read from the picture alone and has no \`reference\` block; the source ids are still recorded. Check the ad id and platform, or continue from the picture.`
+      ] : [],
+      ...uncast.length ? [
+        `NOT CAST: ${uncast.map((h) => `\`${h}\``).join(", ")} \u2014 the element selection found fewer people than avatars passed, so ${uncast.length === 1 ? "this avatar plays" : "these avatars play"} nobody in this ad. Tell the user who is cast and who is not.`
+      ] : [],
+      ...validation.hints,
+      ...conceptNotes,
+      ...report.describe_gaps.map(
+        (gap) => gap === "winning_mechanisms" ? "The describe pass named no winning mechanism. Look at the source ad, add a `mechanism` entry to prompt.json ({ device, why_it_works }) and rebuild that device for our brand; a rewrite without it keeps the look and loses what made the ad work." : "The describe pass recorded no typefaces. The designed lines are set in the brand's font when one loads (src/brand/fonts/, tokens.json or BRAND.md); with none, name our face in prompt.json's `brand.typeface` (for example \"a heavy geometric sans\"), or they are set in a plain sans."
+      )
+    ];
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          canvas_path: outPath,
+          prompt_path: blueprintPath,
+          definition_path: definitionPath ?? void 0,
+          source_reference: durableSourceUrl ?? void 0,
+          ...reference ? {
+            reference: {
+              ad_id: reference.ad_id,
+              platform: reference.platform,
+              advertiser_id: reference.advertiser_id,
+              format_pattern: reference.format_pattern,
+              mechanism: reference.message.mechanism
+            }
+          } : {},
+          output: canvas.output,
+          ...hints.length ? { hints } : {},
+          models: { describe: describeModel, select: selectModel, gen: opts.genModel },
+          aspect_ratio: report.aspect_ratio,
+          placements: report.placements,
+          ...viewerOutput(who),
+          output_formats: report.output_formats,
+          stats: {
+            total_nodes: canvas.nodes.length,
+            describe_credits_spent: creditsSpent,
+            run_estimated_credits: validation.estimatedCredits
+          },
+          checklist: {
+            edit_prompt: `Edit ${path.basename(blueprintPath)}: it is the ad spec, read from your image, to rewrite into the ad you want. \`viewer\` (who sees it and what they already know), \`message\` (the one thing it tells them), \`copy\` (each line, \`in_scene\` or \`designed\`), \`scene\`, \`references\` (one picture each, by role), \`colors\` (each tied to an object, from the brand) and an optional \`direction\`. You never write a model prompt: every render prompt is compiled from this file and shown on its node.${reference ? " Its `reference` block is the library's read of the source ad (container, layout, mechanism, offer, text blocks): keep it as the account of why the ad won, and rebuild it for our brand." : ""}`,
+            mechanism: report.winning_mechanisms,
+            rebuild_the_mechanism: "`mechanism` is WHY the source ad works. Rebuild each device for our brand in prompt.json's copy and scene (a rhyme stays a rhyme in our words, a before/after stays a before/after of our product); never copy the source's literal copy.",
+            assets_to_supply: report.elements,
+            summary: report.summary,
+            text: staticTextNote(report),
+            font: report.font,
+            in_scene_text: report.in_scene_text,
+            logo: report.logo.why,
+            takes: report.takes === 1 ? "1 finished ad is rendered and used as it is (no judge)." : `${report.takes} variants of the finished ad are rendered, one request each on its own direction. A prefilter drops any whose words or placement fail the checks, and the judge compares the rest pairwise against the brief (words, picture, space, one idea, the brief itself, brand); the winner becomes the ad and the others stay in the run as options the person can switch to (\`baker canvas run --use-variant\`).`,
+            pictures: "The reference's own people, products, animals and badges are not slots to fill: they are the source's world. A person is drawn from the description, or cast from a company Avatar (--avatar <handle>) when they recur across ads; never a found photo. To show our own product or another picture, add it to prompt.json's `references` with its `image` (a path from this folder, or a URL): every run wires it.",
+            formats: staticFormatsNote(report, opts.genModel),
+            viewer: viewerNote(who),
+            note: `Populate as you go: for each [TODO] ingest slot, source its real asset and wire it into the slot right away, one at a time. The logo is optional and never a slot to fill: it is given to the model only when prompt.json has \`"logo": true\` and src/brand/logos/ has the real file; never fetch or draw a stand-in. When every slot is filled, \`baker canvas validate\` then \`baker canvas run\`. Running generates billed images: it is not free.`
+          }
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  PLATFORM_PLACEMENTS,
+  buildDescribeCanvas,
+  resolvePlacements,
+  resolvePlatforms,
+  scaffoldStaticAdCommand,
+  uploadSourceAsReference,
+  validateScaffoldedStaticAd
+};
+//# sourceMappingURL=scaffold-static-ad-SUEYXLOR.js.map