@koda-sl/baker-cli 0.449.0-dev.b6179c7f5 → 0.454.0-dev.c94fef7ea

package/README.md

@@ -1814,7 +1814,7 @@ baker creatives make <idea> [--slug <s>] [--adset <id>] [--reference <adId>] [--
 baker creatives learn [--days <n>] [--dry-run]                 # what each idea's ads did, written back onto the idea
 ```
 
-- `brief` returns a verdict, not raw numbers: `account.bottleneck` is `hook`, `after_click`, `none` or `too_little_data`. A part that cannot be read says `unavailable`; the market search gets 10 seconds, so a slow ad library leaves it out rather than holding the brief. With no ideas on file, its hint lists the values `awareness`, `angle` and `format` take. `market` says what competitors' ads already say (the followed brands, else the library), how sophisticated the market is, and which awareness stages nobody speaks to.
+- `brief` returns a verdict, not raw numbers: `account.bottleneck` is `hook`, `after_click`, `none` or `too_little_data`. A part that cannot be read says `unavailable`; the market searches (the followed brands, and the library for what COMPANY.md's first line says the company sells, in a few words) run at once and get 12 seconds, so a slow ad library leaves them out rather than holding the brief. With no ideas on file, its hint lists the values `awareness`, `angle` and `format` take. `market` says what competitors' ads already say (the followed brands, else the library), how sophisticated the market is, and which awareness stages nobody speaks to.
 - `ideas` is free and local. An idea's `evidence` resolves to `src/content/insights/` entries, or it is an `explore` bet. Numbers must be in the Knowledge or our own customers' quotes (a Reddit, forum or web quote never sources a claim), no two ideas may share an angle and format, and a review or testimonial format needs a quote from our own customer.
 - `learn` pools each built idea's creatives, judges them against the rest of the account's cost per result and writes `status` (`winner`, `failed`, `inconclusive`, `testing`) and a frozen `result` onto the idea. `ideas` then warns when a new idea repeats a failed one.
 - `make` builds one idea. A static searches the idea's container for ads made for our viewer, checks the closest three with `winning-ads fit` and scaffolds from the first that fits. For a new creative it starts scaffolding the best-ranked one while the fits are asked (kept when it fits, stopped and removed whole when another or none is kept), so the reference's describe pass no longer waits for them. A creative whose ad is already written is never built over (`ALREADY_MADE`): edit its `prompt.json`, or pass `--slug` for another ad of the same idea. A video idea takes its beats spec. Either way it records the idea on `_definition.md`, sets `prompt.json`'s `message` and syncs the definition. Drafted copy lines claiming a figure the company never wrote come back first in `hints`. When no proven ad fits (or with `--from-idea`), a static starts from the idea itself: `prompt.json` holds the message and placeholders, and `canvas run` refuses to render until the scene and copy are written.
@@ -6600,7 +6600,7 @@ With `--slug`, `data.variantChoice` (`runId`, `option`, `sha256`) says which var
 Record what the person said about one version in a chat: an approval, or a rejection with reasons and their own words. It is stored like the Approve / Not this one buttons, as the verdict of the person who wrote the chat's latest message (`recordedFor: "sender"`), or of the chat itself when nobody has written in it (`"chat"`). One verdict per person per version or option: a later one replaces theirs. Must run from a chat.
 
 ```bash
-baker creatives feedback record --slug spring-offer --run r_01K… --verdict rejected \
+baker creatives feedback record --slug spring-offer --verdict rejected \
   --reasons text_mistakes,weak_hook --note "the price is 49 not 59"
 baker creatives feedback record --slug spring-offer --run r_01K… --option 2 --verdict approved
 ```
@@ -6608,7 +6608,7 @@ baker creatives feedback record --slug spring-offer --run r_01K… --option 2 --
 | Flag | Effect |
 |---|---|
 | `--slug <slug>` | Required. The creative (`src/creatives/<slug>/`). |
-| `--run <r_…>` | Required. The version. |
+| `--run <r_…>` | The version. Left out, the one the creative shows now (its last render in this workspace). |
 | `--verdict approved\|rejected` | Required. |
 | `--option <o>` | One option of a version that made several: its label, its number (`2`) or its slot. |
 | `--reasons <a,b>` | Comma-separated: `text_mistakes`, `logo_or_brand_wrong`, `weak_hook`, `wrong_message`, `looks_fake`, `not_our_style`, `voice_or_sound`, `pacing`, `other`. The two video reasons: `voice_or_sound` (the voiceover, music or mix) and `pacing` (too slow, too fast, the hook lands late). A rejection needs reasons or a note. |
@@ -6621,7 +6621,7 @@ After a rejection, `hints[]` restates what to change, starting from that version
 Choose the version of a creative to keep, or only some of its options, the way choosing it in Baker does: the creative shows that version as the chosen one, and the choice records the chat sender's approval (`source: "selection"`). Naming options replaces the earlier pick. It does not add the image to the library; that is `baker creatives publish`, which, given `--run-id`, also counts as choosing that version.
 
 ```bash
-baker creatives select --slug spring-offer --run r_01K…
+baker creatives select --slug spring-offer                      # the version it shows now
 baker creatives select --slug spring-offer --run r_01K… --options "beach,2"
 ```
 

package/dist/{chunk-Y33XAZ5M.js → chunk-MYOTW5GV.js}

@@ -6754,13 +6754,19 @@ var Viewer = z7.object({
   /** Who will see the ad, in the words a marketer would use. */
   who: z7.string().trim().min(1),
   market: Market.optional(),
-  /** What they already know about the brand and the offer. */
-  knows: z7.string().optional(),
+  /** What they already know about the brand and the offer; a list (as _definition.md keeps it) reads as one line. */
+  knows: z7.preprocess((v) => Array.isArray(v) ? v.map(String).join("; ") || void 0 : v, z7.string().optional()),
   temperature: z7.enum(["cold", "warm", "hot"]).optional(),
   /** Where they meet it (feed, Stories, Reels). */
   placement: z7.string().optional()
 }).strict();
-var Scene = z7.object({
+var withoutFormatName = (v) => {
+  if (!v || typeof v !== "object" || Array.isArray(v) || typeof v.concept !== "string")
+    return v;
+  const { concept: _format, ...scene } = v;
+  return scene;
+};
+var SceneFields = z7.object({
   description: z7.string().trim().min(1),
   /** A photograph, a designed graphic, or an illustration. */
   look: z7.enum(["photo", "designed", "illustration"]),
@@ -6770,6 +6776,7 @@ var Scene = z7.object({
   /** How the frame is arranged, by what fills each part of it. */
   layout: z7.string().optional()
 }).strict();
+var Scene = z7.preprocess(withoutFormatName, SceneFields);
 var Brand = z7.object({
   name: z7.string().optional(),
   /** The words the brand's logo prints (its wordmark), so a check reads them as the logo, never as copy. */
@@ -6847,7 +6854,10 @@ var AdSpecSchema = z7.object({
   /** An optional note on direction for this concept. */
   direction: z7.string().optional(),
   /** The device the ad is built on, and why it works on a stranger. Judged, never drawn. */
-  mechanism: z7.array(Mechanism).default([]),
+  mechanism: z7.preprocess(
+    (v) => v && typeof v === "object" && !Array.isArray(v) ? [v] : v,
+    z7.array(Mechanism).default([])
+  ),
   /** Why the reference won and what this ad keeps of it (schema /3). */
   concept: Concept.optional(),
   /**
@@ -16042,6 +16052,22 @@ function everySizeChecks(opts) {
     onSpend: opts.onSpend
   };
 }
+async function confirmBlocking(findings, stills, formats, ask2) {
+  const claims = findings.filter((f) => f.severity === "blocking");
+  if (claims.length === 0 || stills.length === 0) return [...findings];
+  const prompt = [
+    `These are the finished sizes of one ad, in order: ${formats.map((f, i) => `Image ${i + 1} is the ${f}`).join("; ")}.`,
+    "A reviewer reported each claim below. Look again at the size each one names (and, for a claim comparing sizes, at the others) and answer true only when the defect is plainly there for someone looking at it on a phone.",
+    "Answer false when the thing is not there, when it is an ordinary part of the scene (a second house, a neighbour's roof, a reflection), or when the sizes it compares show the same thing.",
+    ...claims.map((c, i) => `${i + 1}. ${c.what}`),
+    `Reply with only this JSON: {"answers":[true|false, ...]}, one answer per claim, in order.`
+  ].join("\n");
+  const answer = await ask2([...stills], prompt).catch(() => null);
+  const answers = answer?.answers;
+  if (!Array.isArray(answers) || answers.length !== claims.length) return [...findings];
+  const unconfirmed = new Set(claims.filter((_, i) => answers[i] === false));
+  return findings.map((f) => unconfirmed.has(f) ? { ...f, severity: "warning" } : f);
+}
 async function reviewRenderedStatic(opts) {
   const { measured, originals, stills, thumbs } = await loadDelivered(opts.images);
   if (measured.length === 0) return null;
@@ -16072,7 +16098,14 @@ async function reviewRenderedStatic(opts) {
   if (answer === null) return unreviewed(shape, measuredText);
   const text2 = read ? measuredText : copyFindings(answer, opts.copy, formats, opts.scrolled);
   const boxesByFormat = read ? Object.fromEntries(checks.flatMap((c, i) => c.status === "checked" ? [[formats[i] ?? "", c.boxes]] : [])) : {};
-  return [...shape, ...text2, ...corroborateEdgeClaims(classifyStaticFindings(answer), boxesByFormat, lines)];
+  const judged = corroborateEdgeClaims(classifyStaticFindings(answer), boxesByFormat, lines);
+  const confirmed = await confirmBlocking(
+    judged,
+    stills,
+    formats,
+    (images, prompt) => askAboutStills(images, prompt, opts.onSpend)
+  );
+  return [...shape, ...text2, ...confirmed];
 }
 
 // src/engine/nodes/local/staticNative.ts
@@ -18698,4 +18731,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-Y33XAZ5M.js.map
+//# sourceMappingURL=chunk-MYOTW5GV.js.map