@koda-sl/baker-cli 0.135.1-dev.6a3e6978d → 0.136.0-dev.3ffe27f0b

package/README.md

@@ -2154,11 +2154,13 @@ baker videos tags
 
 Semantic search testimonials. For landing pages, query the product/offer and USP before filtering by rating so selected quotes match what the landing sells.
 
+Search reranks over the whole corpus with no language preference, so a corpus dominated by one language returns that language even for another-language query. Pass `--language <code>` to scope to a market. When results skew to one language and none was requested, the command emits a hint (in the `hints` array for `--output json`, on stderr for `--output md`/`files`).
+
 ```bash
 baker testimonials search "great service"
 baker testimonials search "fast delivery" --rating-min 4 --tags quality
 baker testimonials search "competitor support" --source trustpilot --sentiment negative --rating-max 2
-baker testimonials search "[product/offer] for [persona] that delivers [USP/outcome]" --rating-min 4 --output md --full --limit 12
+baker testimonials search "[product/offer] for [persona] that delivers [USP/outcome]" --rating-min 4 --language en --output md --full --limit 12
 ```
 
 ### `baker testimonials get <id>`
@@ -4058,6 +4060,8 @@ It then scaffolds a canvas that ingests `prompt.json`, wires **one `[TODO]` inge
 
 **Automatic placement fan-out.** By default the canvas doesn't stop at one ratio: the hero renders once at the platform's primary ratio, then an `image_aspect_adapt` node recomposes it into that platform's full placement set, and the canvas `output` points at the adapted images. The placement set is derived from `--platform` (`meta` → 4:5 + 9:16, `google` → 1:1 + 4:5 + 16:9, `linkedin` → 1:1, `tiktok` → 9:16, `youtube` → 16:9); override it with `--placements <preset>` or disable it with `--placements none` for a single base ad. The hero ratio passes through the adapt node **free**; each other ratio is a billed recomposition — and because adaptation re-generates, every ratio should be eyeballed for text and brand-color fidelity before publish (`ad-formats.md` in the scaffold skill covers this).
 
+The checklist `note` reminds you to fill **logo** slots from the company's committed brand logo in `src/brand/logos/` (per `BRAND.md`) — **not** from `baker images logo <domain>`, whose Brandfetch CDN often serves an outdated mark (a common cause of an old logo shipping on a live ad).
+
 The generation prompt is **model-aware and typography-hardened** (a static ad is the only path that bakes text *into* the image — video frames are clean plates). It resolves the image model's profile, so for **gpt-image** the exclusions (no invented badges/watermark) are hoisted to the very *end* of the prompt where the model reads them as pure exclusions rather than composition, and it quotes every blueprint string with an instruction to render each **once, verbatim**, lock brand names letter-by-letter, and keep type crisp and legible — the fix for the #1 static-ad defect (garbled/duplicated/dropped copy). Run `baker canvas critique` on the scaffolded canvas for an advisory read on text-legibility risk, identity grounding, and brand-type fidelity before you spend.
 
 ```bash

package/dist/cli.js

@@ -20335,7 +20335,7 @@ var scaffoldStaticAdCommand = defineCommand91({
             font_slot: report.includes_font ? "Drop a brand font at the [TODO] brandfont path (the describe pass recorded the ad's typefaces under `fonts` in prompt.json \u2014 match those). The font is wired into the render as a TYPE SPECIMEN reference so generated text takes the brand letterforms. Delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             actor_sheets: report.actor_sheets.length > 0 ? `Each living hero (${report.actor_sheets.join(", ")}) is fused into a generated multi-view reference sheet (image_reference_sheet) that the render grounds on \u2014 so drop ONE clean photo at that hero's ingest and the sheet builds the consistent turnaround. Pass --skip-actor-sheets to ground on the lone photo instead.` : "none (no person/animal heroes detected, or --skip-actor-sheets)",
             placements: report.placements === null ? `Single format (${report.aspect_ratio}). Pass --placements meta_feed_stories|meta_all|linkedin|\u2026 to auto-fan-out to a platform's set.` : `Auto-fans the approved hero out to ${report.placements} \u2192 ${report.output_formats.join(", ")}. The hero ratio (${report.aspect_ratio}) passes through free; each other ratio is a billed render, AI-recomposed (not cropped). Re-read the copy and confirm the brand-color treatment on EVERY ratio before publishing \u2014 adaptation re-generates and can silently mangle text or flatten a color device. Pass --placements none for a single base ad.`,
-            note: "Populate as you go: for each [TODO] ingest slot, source its real asset and wire it into the slot right away \u2014 one at a time, not all sourced first then reconciled at the end. When every slot is filled, `baker canvas validate` then `baker canvas run`. Running generates a billed image \u2014 it is not free."
+            note: "Populate as you go: for each [TODO] ingest slot, source its real asset and wire it into the slot right away \u2014 one at a time, not all sourced first then reconciled at the end. For any LOGO slot, use the company's committed brand logo from `src/brand/logos/` (per BRAND.md's Logos map) \u2014 do NOT re-fetch it with `baker images logo <domain>` when a brand logo exists, because the Brandfetch CDN often serves an OUTDATED mark and that is how an old logo ships on a live ad. When every slot is filled, `baker canvas validate` then `baker canvas run`. Running generates a billed image \u2014 it is not free."
           }
         },
         null,
@@ -27037,6 +27037,25 @@ var listCommand10 = defineCommand154({
 
 // src/commands/testimonials/search.ts
 import { defineCommand as defineCommand155 } from "citty";
+function languageBiasHint(results, requestedLanguage) {
+  if (requestedLanguage) {
+    return null;
+  }
+  const withLang = results.filter((r) => typeof r.language === "string" && r.language.length > 0);
+  if (withLang.length < 3) {
+    return null;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const r of withLang) {
+    const lang = r.language;
+    counts.set(lang, (counts.get(lang) ?? 0) + 1);
+  }
+  const [topLang, topCount] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? ["", 0];
+  if (topLang && topCount / withLang.length >= 0.8) {
+    return `Results skew ${topLang} (${topCount}/${withLang.length}). If you're sourcing quotes for a specific market, pass --language <code> (e.g. --language en) so the ad's language matches its audience.`;
+  }
+  return null;
+}
 registerSchema({
   command: "testimonials.search",
   description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
@@ -27067,6 +27086,34 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
+function buildSearchRequest(query, args) {
+  const body = { query };
+  if (args.limit !== void 0) {
+    body.limit = Number(args.limit);
+  }
+  if (args.source) {
+    body.source = args.source;
+  }
+  if (args["rating-min"] !== void 0) {
+    body.rating_min = Number(args["rating-min"]);
+  }
+  if (args["rating-max"] !== void 0) {
+    body.rating_max = Number(args["rating-max"]);
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  if (args.sentiment) {
+    body.sentiment = args.sentiment;
+  }
+  if (args.language) {
+    body.language = args.language;
+  }
+  if (args.tags) {
+    body.tags = args.tags.split(",").filter(Boolean);
+  }
+  return body;
+}
 var searchCommand2 = defineCommand155({
   meta: {
     name: "search",
@@ -27093,39 +27140,21 @@ var searchCommand2 = defineCommand155({
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
         process.exit(1);
       }
-      const body = { query };
-      if (args.limit !== void 0) {
-        body.limit = Number(args.limit);
-      }
-      if (args.source) {
-        body.source = args.source;
-      }
-      if (args["rating-min"] !== void 0) {
-        body.rating_min = Number(args["rating-min"]);
-      }
-      if (args["rating-max"] !== void 0) {
-        body.rating_max = Number(args["rating-max"]);
-      }
-      if (args.status) {
-        body.status = args.status;
-      }
-      if (args.sentiment) {
-        body.sentiment = args.sentiment;
-      }
-      if (args.language) {
-        body.language = args.language;
-      }
-      if (args.tags) {
-        body.tags = args.tags.split(",").filter(Boolean);
-      }
+      const body = buildSearchRequest(query, args);
       const data = await apiPost("/api/testimonials/search", body);
+      const hint = languageBiasHint(data, body.language);
+      const outputFormat = args.output || "json";
       writeOutput(
-        { ok: true, data },
-        args.output || "json",
+        { ok: true, data, ...hint ? { hints: [hint] } : {} },
+        outputFormat,
         args.fields ? args.fields.split(",") : void 0,
         args.full,
         testimonialNormalizer
       );
+      if (hint && outputFormat !== "json") {
+        process.stderr.write(`${hint}
+`);
+      }
     } catch (err) {
       if (err instanceof ApiError) {
         writeJson({ ok: false, error: { code: err.code, message: err.message } });