@koda-sl/baker-cli 0.426.0 → 0.427.0-dev.ad97d3ceb

package/README.md

@@ -1803,6 +1803,22 @@ baker gsc sitemaps --site-url "https://example.com/"
 
 ---
 
+### Making ads (`baker creatives brief` / `ideas` / `make`)
+
+Ads start from what customers said. Three commands carry the process; the agent writes the ideas and the copy.
+
+```bash
+baker creatives brief [--adset <id>] [--account-id act_<id>]   # one read: viewer, account bottleneck, what works, taste, customer quotes, ideas on file
+baker creatives ideas [--full]                                 # check and rank src/creatives/_ideas/*.md; build_next
+baker creatives make <idea> [--slug <s>] [--adset <id>] [--reference <adId>] [--spec <beats.json>] [--from-idea]
+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`. `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. 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.
+
 ### Competitive Intelligence (`baker research`)
 
 Market and competitor research powered by DataForSEO and AI-powered Google Search grounding. Shows who's competing for keywords, search intent classification, competitor keyword strategies, keyword gaps, landing page performance, and open-ended AI research.
@@ -1934,6 +1950,16 @@ Every search or thread item carries verbatim `text`, `author`, `score`, `created
 
 ---
 
+### `baker research customers`
+
+Finds what real customers say and writes each quote as an insight in `src/content/insights/` (type, quote, source, date, `status: observed`). Sources: the company's reviews library, Reddit, and with `--web` pages from web research. A quote is kept only when it appears word for word in the text that was fetched; the model classifies quotes and never writes them.
+
+```bash
+baker research customers --focus "solar panels"     # reviews + Reddit
+baker research customers --query "payroll mistakes" --web --limit 15
+baker research customers --dry-run                   # print, write nothing
+```
+
 ### `baker research advertisers "keyword"`
 
 Returns a ranked list of **domains** competing for one keyword in Google, with average SERP position, relevance rating, estimated traffic value and visibility — domain economics, **NOT ad copy**. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor's actual ad copy use `baker winning-ads content <adId>` (Meta/LinkedIn only — Google SERP ad copy is not available anywhere in Baker).

package/dist/{chunk-ZH7YAR5N.js → chunk-GTHLEQHU.js}

@@ -24,9 +24,9 @@ import {
   shouldEscalate
 } from "./chunk-FQOKJYKN.js";
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -1408,7 +1408,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -2826,6 +2826,12 @@ var MODEL_ROLES = {
    * only and asked once per ad and viewer, so Flash; the calibration set (E8) decides.
    */
   viewerCheck: { kind: "text_generate", model: "~google/gemini-flash-latest" },
+  /**
+   * Picks the customer truths out of reviews, testimonials and threads (`baker research
+   * customers`): returns exact spans the code then checks against the source. Text only and
+   * one call per batch, so Flash.
+   */
+  customerInsights: { kind: "text_generate", model: "~google/gemini-flash-latest" },
   /**
    * The same viewer shown the FINISHED static ad at phone size for about three seconds, with no
    * brand and no brief: what is sold, whether it is for them, what to do next, what stopped them
@@ -2867,6 +2873,7 @@ var PLATE_JUDGE_MODEL = MODEL_ROLES.plateJudge.model;
 var AD_DESCRIBE_MODEL = MODEL_ROLES.adDescribe.model;
 var BLUEPRINT_ANALYSIS_MODEL = MODEL_ROLES.blueprintAnalysis.model;
 var VIEWER_CHECK_MODEL = MODEL_ROLES.viewerCheck.model;
+var CUSTOMER_INSIGHTS_MODEL = MODEL_ROLES.customerInsights.model;
 var GLANCE_CHECK_MODEL = MODEL_ROLES.glanceCheck.model;
 var TEXT_BOX_READER_MODEL = MODEL_ROLES.textBoxReader.model;
 var VIDEO_DECONSTRUCT_MODEL = MODEL_ROLES.videoDeconstruct.model;
@@ -6912,6 +6919,18 @@ function conceptProblems(spec) {
   }
   return problems;
 }
+var PLACEHOLDER = "[TODO";
+function unwrittenProblems(spec) {
+  const problems = [];
+  if (spec.scene.description.includes(PLACEHOLDER)) {
+    problems.push("The scene is still a placeholder: write what the viewer sees in `scene.description`.");
+  }
+  const lines = spec.copy.filter((line) => line.text.includes(PLACEHOLDER));
+  if (lines.length > 0) {
+    problems.push(`${lines.length} line(s) of copy are still placeholders: write each as it prints, or drop it.`);
+  }
+  return problems;
+}
 function readAdSpec(raw) {
   if (isAdSpec(raw)) return AdSpecSchema.parse(raw);
   const advertiser = raw?.reference?.advertiser;
@@ -18385,6 +18404,7 @@ export {
   AD_DESCRIBE_MODEL,
   BLUEPRINT_ANALYSIS_MODEL,
   VIEWER_CHECK_MODEL,
+  CUSTOMER_INSIGHTS_MODEL,
   GLANCE_CHECK_MODEL,
   VIDEO_DECONSTRUCT_MODEL,
   VOICEOVER_MODEL,
@@ -18456,6 +18476,7 @@ export {
   isAdSpec,
   conceptSummary,
   conceptProblems,
+  unwrittenProblems,
   readAdSpec,
   withRenderedLettering,
   conceptClassOf,
@@ -18543,4 +18564,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-ZH7YAR5N.js.map
+//# sourceMappingURL=chunk-GTHLEQHU.js.map