@koda-sl/baker-cli 0.475.0 → 0.476.0-dev.68b9f00aa

package/dist/{chunk-NDITGFPZ.js → chunk-RKXH5JHW.js}

@@ -20,7 +20,7 @@ import {
   topologicalLayers,
   validateCanvas,
   validateCanvasDeep
-} from "./chunk-WJOQ6IEK.js";
+} from "./chunk-E3OUPTS3.js";
 import {
   FRAME_CUT,
   bandViolations,
@@ -35,13 +35,13 @@ import {
   roleKey,
   shownBoxes,
   withWordmark
-} from "./chunk-MZQBL7QU.js";
+} from "./chunk-5NV2TEH7.js";
 import {
   frameGround,
   nativeSurfaceHtml,
   readAdSpec,
   readInterfaceWords
-} from "./chunk-D7KNUZ6Z.js";
+} from "./chunk-ABMOJ5AY.js";
 import {
   AD_FORMAT_PLATFORMS,
   DEFAULT_MUSIC_SECONDS,
@@ -59,7 +59,7 @@ import {
   imagePictureCredits,
   modelIdsAccepted,
   resolveAdaptFormats
-} from "./chunk-2XQ5HU6D.js";
+} from "./chunk-QK5PEHFX.js";
 import {
   AudioRef,
   FontRef,
@@ -5178,4 +5178,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-NDITGFPZ.js.map
+//# sourceMappingURL=chunk-RKXH5JHW.js.map

package/dist/{chunk-7VHPAGPK.js → chunk-SEPPFM5S.js}

@@ -1,6 +1,6 @@
 import {
   NUMERIC_ID_REGEX
-} from "./chunk-ML7DLFFY.js";
+} from "./chunk-I2DNBEV6.js";
 
 // ../api/src/ads-google/change-history.ts
 var CHANGE_SCOPES = ["detail", "summary"];
@@ -225,4 +225,4 @@ export {
   googleKeywordForecastRequestSchema,
   urlOptionsHints
 };
-//# sourceMappingURL=chunk-7VHPAGPK.js.map
+//# sourceMappingURL=chunk-SEPPFM5S.js.map

package/dist/{chunk-MCDU24JX.js → chunk-SI23M3JX.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-BC2BXRXY.js";
 import {
   flowNodeTriggers
-} from "./chunk-PHY3AERY.js";
+} from "./chunk-NRAE3HJ7.js";
 
 // ../api/src/analytics/flowEventKeys.ts
 function flowNodes(node, acc = []) {
@@ -54,4 +54,4 @@ export {
   flowNodes,
   flowEventKeys
 };
-//# sourceMappingURL=chunk-MCDU24JX.js.map
+//# sourceMappingURL=chunk-SI23M3JX.js.map

package/dist/{chunk-FEELV5IV.js → chunk-SQ7DRYCC.js}

@@ -1,7 +1,7 @@
 import {
   GEO_TARGET_COUNTRIES,
   LANGUAGE_CONSTANTS
-} from "./chunk-ML7DLFFY.js";
+} from "./chunk-I2DNBEV6.js";
 
 // src/geo-context.ts
 function toOptions(names) {
@@ -147,4 +147,4 @@ export {
   buildResearchQueryContext,
   warnDefaults
 };
-//# sourceMappingURL=chunk-FEELV5IV.js.map
+//# sourceMappingURL=chunk-SQ7DRYCC.js.map

package/dist/{chunk-WOLE67OJ.js → chunk-U3OFW35R.js}

@@ -5,11 +5,11 @@ import {
 import {
   GENERIC_FAMILIES,
   resolveBrandFaces
-} from "./chunk-2YXY56FK.js";
+} from "./chunk-CJABW4F7.js";
 import {
   LOGO_FILE,
   readWorkspaceBrandDoc
-} from "./chunk-RCWEJUSF.js";
+} from "./chunk-3IYJ4ERJ.js";
 import {
   holdUnbilledSpend
 } from "./chunk-KMMVQ2MR.js";
@@ -62,7 +62,7 @@ import {
   staticRenderNodes,
   trimmedRenderBand,
   wordCount
-} from "./chunk-WJOQ6IEK.js";
+} from "./chunk-E3OUPTS3.js";
 import {
   ACTOR_SHEET_MODEL,
   AD_SPEC_SCHEMA,
@@ -101,7 +101,7 @@ import {
   unwrittenProblems,
   winningMechanisms,
   withRenderedLettering
-} from "./chunk-D7KNUZ6Z.js";
+} from "./chunk-ABMOJ5AY.js";
 import {
   AD_DESCRIBE_MODEL,
   AD_IMAGE_MODEL,
@@ -129,7 +129,7 @@ import {
   platformFormats,
   supportedAspectRatios,
   supportsLastFrame
-} from "./chunk-2XQ5HU6D.js";
+} from "./chunk-QK5PEHFX.js";
 import {
   askAboutText
 } from "./chunk-X3PVW3RM.js";
@@ -146,7 +146,7 @@ import {
 } from "./chunk-VPBCR6DT.js";
 import {
   brandTokensSchema
-} from "./chunk-PHY3AERY.js";
+} from "./chunk-NRAE3HJ7.js";
 import {
   optionalConnection
 } from "./chunk-G3UCXCC2.js";
@@ -953,20 +953,20 @@ function conceptSeed(bp, fit, scrub) {
       ...fit.recognition ? { recognition: fit.recognition } : {}
     };
   }
-  const loadBearing = (Array.isArray(bp.load_bearing) ? bp.load_bearing : []).flatMap((l) => {
+  const loadBearing2 = (Array.isArray(bp.load_bearing) ? bp.load_bearing : []).flatMap((l) => {
     const element = plainText(l?.element, scrub);
     const needed = plainText(l?.needs, scrub);
     const needs = needed ? { needs: needed } : {};
     return element ? [{ element, ...needs, have: "missing" }] : [];
   });
-  if (loadBearing.length === 0) return {};
+  if (loadBearing2.length === 0) return {};
   const why = bp.why_it_wins && typeof bp.why_it_wins === "object" ? bp.why_it_wins : {};
   const layers = Object.fromEntries(
     ["disguise", "voice", "trigger", "attention", "logic"].flatMap(
       (k) => plainText(why[k], scrub) ? [[k, plainText(why[k], scrub)]] : []
     )
   );
-  return { concept: { why_it_wins: layers, load_bearing: loadBearing, verdict: "adapt" } };
+  return { concept: { why_it_wins: layers, load_bearing: loadBearing2, verdict: "adapt" } };
 }
 var REFERENCE_KIND = {
   person: "identity",
@@ -5662,6 +5662,126 @@ function voiceGenderModel(cacheDir, onSpend) {
   };
 }
 
+// src/commands/creatives/thinking.ts
+var THINKING_HEADING = "## Thinking";
+var OPEN = "[TODO";
+var question = (text) => `${OPEN}: ${text}]`;
+function firstRead(reference) {
+  const layers = reference.fit?.why_it_wins ?? {};
+  const read = [
+    reference.why ? `- Picked because: ${reference.why}` : "",
+    layers.disguise ? `- Looks like: ${layers.disguise}` : "",
+    layers.attention ? `- Stops the scroll with: ${layers.attention}` : "",
+    layers.trigger ? `- Triggers: ${layers.trigger}` : "",
+    layers.voice ? `- Voice: ${layers.voice}` : "",
+    layers.logic ? `- Convinces by: ${layers.logic}` : "",
+    reference.fit?.recognition ? `- Recognised as: ${reference.fit.recognition}` : ""
+  ].filter(Boolean);
+  return read.length > 0 ? `First read, from the check that picked it:
+
+${read.join("\n")}
+
+` : "";
+}
+function loadBearing(reference) {
+  const elements = reference.fit?.load_bearing ?? [];
+  if (elements.length === 0) return "";
+  const lines = elements.map((e) => `- ${e.element}: ${e.have}${e.ours ? ` (ours: ${e.ours})` : ""}`);
+  return `The check named these as load-bearing:
+
+${lines.join("\n")}
+
+`;
+}
+function thinkingOutline(input) {
+  const { idea, reference } = input;
+  const sections = [];
+  if (reference) {
+    sections.push(
+      [
+        "What the ad is",
+        question(
+          `describe proven ad ${reference.adId} as a viewer meets it in the feed, lever by lever (.claude/skills/creative-canvas-ads/references/reading-a-winner.md): the photo (camera, lens, filter, grain, flash, light, framing), the person (who, face, expression, gaze, hair, body, clothes, how attractive or ordinary), the setting and props, the words and the type, the composition, the tone, and what it pretends to be (a meme, a screenshot, a post, an ad).`
+        )
+      ],
+      [
+        "Why it won",
+        `${firstRead(reference)}${question(
+          "go past that read, lever by lever. Which pattern interrupt stopped the thumb in the first half-second: a face too close, a body, an attractive person, a look that is wrong for an ad (a filter, a flash photo, a fisheye selfie, a cheap screenshot) or too polished, an odd scale, a joke, a meme people know, a trend of right now? Which feeling did it hit: humour, desire, envy, fear, outrage, nostalgia, cuteness, being seen? What made them believe it, and what made them click? Name the one detail doing the work, then the two that support it. Keep apart what you can see, what the library measured, and what you suppose."
+        )}`
+      ]
+    );
+  } else {
+    sections.push([
+      "Why it should work",
+      question(
+        "no proven ad fits, so this is a bet. What should stop this viewer, and why should they believe it? Say what would prove the bet wrong."
+      )
+    ]);
+  }
+  sections.push(
+    [
+      "Does it fit our audience",
+      question(
+        `our viewer is ${idea.who.replace(/[-_]/g, " ")}. Would they get the joke, recognise the format, see themselves in it? What in it would fall flat or put them off, and what do they care about that it does not say yet?`
+      )
+    ],
+    [
+      "The hook, ours",
+      question(
+        `our message is "${idea.message}". Write the hook ${reference ? "the reference's hook becomes" : "that opens it"} for us, in our customers' words, and say why it should stop this viewer. Give the two or three you weighed and why this one won.`
+      )
+    ],
+    [
+      "The angle and the call to action",
+      question(
+        `the angle the ${reference ? "reference wins on" : "idea takes"} (pain, desire, fear of loss, status, identity, savings, convenience, proof, authority, urgency, us against them, contrarian) and ours (the idea says "${idea.angle}"): why it is the right one for this viewer at this stage. Then the call to action: what we ask, how big an ask it is for this viewer, what lowers the risk (an offer, a guarantee, a free step), and where and how it shows (a button, a line, a native ask like "comment X", or none).`
+      )
+    ],
+    [
+      "Who appears",
+      question(
+        "a real customer's testimonial (which one, and their real words), the founder or someone of the team (only a real person, from the company's own pictures), an expert, an invented peer of the viewer, or nobody but the product? Say why that face sells this message to this viewer, and why the others would not."
+      )
+    ]
+  );
+  if (reference) {
+    sections.push([
+      "What survives and what changes",
+      `${loadBearing(reference)}${question(
+        "the few details that, removed, would kill what made it win: keep those, carried by our own people, product and words. Everything that is the other company's (its words, logo, claims, people, products) changes. Say what each of ours replaces."
+      )}`
+    ]);
+  }
+  sections.push([
+    "The plan",
+    question(
+      `the ad we will make, as the viewer will see it: the scene, every line of copy, who is in it, the format (${idea.format}) and the sizes. Then write exactly this into prompt.json: the render reads prompt.json, not this page.`
+    )
+  ]);
+  return [THINKING_HEADING, "", ...sections.flatMap(([title, body]) => [`### ${title}`, "", body, ""])].join("\n");
+}
+function withThinking(definition, outline) {
+  if (definition.split("\n").some((line) => line.trim() === THINKING_HEADING)) return definition;
+  return `${definition.trimEnd()}
+
+${outline.trimEnd()}
+`;
+}
+function unthoughtSections(definition) {
+  const start = definition.split("\n").findIndex((line) => line.trim() === THINKING_HEADING);
+  if (start === -1) return [];
+  const open = [];
+  let title = null;
+  for (const line of definition.split("\n").slice(start + 1)) {
+    if (/^##\s/.test(line)) break;
+    const heading = /^###\s+(.+?)\s*$/.exec(line);
+    if (heading?.[1]) title = heading[1];
+    else if (title && line.includes(OPEN) && !open.includes(title)) open.push(title);
+  }
+  return open;
+}
+
 // src/commands/canvas/style-projection.ts
 import { readFile as readFile9, writeFile as writeFile6 } from "fs/promises";
 function findBlueprintProjection(canvas) {
@@ -6489,6 +6609,19 @@ ${adSpecErrorText(e)}`, {
       fix: `Fix ${path13.join(canvasDir, "prompt.json")} so it parses as JSON (and, for a static ad, matches the ad spec the message names), then re-run.`
     });
   }
+  if (opts.gate) {
+    const definition = await readFile13(path13.join(canvasDir, "_definition.md"), "utf8").catch(() => "");
+    const open = unthoughtSections(definition);
+    if (open.length > 0) {
+      throw new CanvasPrepareError(
+        "definition_not_thought",
+        `_definition.md's thinking still has questions open: ${open.join(", ")}. The thinking decides the ad, so it comes before the render.`,
+        {
+          fix: `Answer each open question in ${path13.join(canvasDir, "_definition.md")} (replace its [TODO: \u2026] with your answer, for this company and this viewer), then write prompt.json from "The plan" and re-run.`
+        }
+      );
+    }
+  }
   const gate = opts.gate && isStaticBriefCanvas(canvas) ? await staticSpecGate(canvas, canvasDir) : null;
   if (gate) throw new CanvasPrepareError(gate.code, gate.problems.join(" "), { fix: gate.fix });
   let scenes;
@@ -6659,9 +6792,11 @@ export {
   computeSourceSha,
   cachedJev,
   voiceGenderModel,
+  thinkingOutline,
+  withThinking,
   renderStyleProjectionFromValue,
   CanvasPrepareError,
   prepareCanvas,
   exitOnPrepareError
 };
-//# sourceMappingURL=chunk-WOLE67OJ.js.map
+//# sourceMappingURL=chunk-U3OFW35R.js.map