@koda-sl/baker-cli 0.495.0-dev.6b9c22aff → 0.495.0

package/dist/keywords-for-site-7UWPJYQF.js

@@ -0,0 +1,128 @@
+import {
+  keywordsForSiteHints
+} from "./chunk-JH2L5CQD.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-EGPYWJGZ.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-BDYLILMW.js";
+import "./chunk-SVM3DGAQ.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/keywords-for-site.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.keywords-for-site",
+  description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+  args: {
+    target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    sort: {
+      type: "string",
+      description: "Sort: search_volume, competition, cpc (default: search_volume)",
+      required: false
+    },
+    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  keyword: "Keyword the site targets",
+  search_volume: "Monthly search volume",
+  cpc: "Cost per click in USD",
+  competition: "LOW, MEDIUM, or HIGH",
+  competition_index: "Competition score 0-100"
+};
+var keywordsForSiteCommand = defineCommand({
+  meta: {
+    name: "keywords-for-site",
+    description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
+
+Examples:
+  baker research keywords-for-site "competitor.com"
+  baker research keywords-for-site "competitor.com" --type paid --limit 20
+  baker research keywords-for-site "competitor.com" --type organic --location uk`
+  },
+  args: {
+    target: { type: "positional", description: "Domain or URL to analyze", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    sort: { type: "string", description: "Sort: search_volume, competition, cpc", required: false },
+    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const target = args.target;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const sort = args.sort || void 0;
+    const type = args.type || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/keywords-for-site", {
+        target,
+        location,
+        language,
+        sort,
+        type,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      const hints = keywordsForSiteHints(data.length, queryContext, type);
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data,
+        fields: FIELDS,
+        note: RESEARCH_DATA_NOTE,
+        query_context: queryContext,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  keywordsForSiteCommand
+};
+//# sourceMappingURL=keywords-for-site-7UWPJYQF.js.map

package/dist/landing-CBVIOGJ5.js

@@ -0,0 +1,28 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/index.ts
+import { defineCommand } from "citty";
+var landingCommand = defineCommand({
+  meta: {
+    name: "landing",
+    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.
+
+Start here: \`baker landing critique <slug>\` after building or editing a landing.
+
+Subcommands:
+  baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
+  baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
+  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and positioning integrity (copy ranking a competitor above the client), tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
+  baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
+  },
+  subCommands: {
+    inspiration: () => import("./inspiration-QAL7NS7G.js").then((m) => m.inspirationCommand),
+    critique: () => import("./critique-NDDFSGPE.js").then((m) => m.critiqueCommand),
+    variant: () => import("./variant-BN72AP34.js").then((m) => m.variantCommand),
+    export: () => import("./export-AGDNQZKC.js").then((m) => m.exportCommand)
+  }
+});
+export {
+  landingCommand
+};
+//# sourceMappingURL=landing-CBVIOGJ5.js.map

package/dist/languages-XRTTEJ5P.js

@@ -0,0 +1,40 @@
+import {
+  GOOGLE_ADS_LANGUAGES
+} from "./chunk-BDYLILMW.js";
+import "./chunk-SVM3DGAQ.js";
+import {
+  writeAdsJson
+} from "./chunk-2VIZ4UUZ.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.languages",
+  description: "List all supported language IDs for --language flag in Google Ads keyword commands.",
+  args: {}
+});
+var FIELDS = {
+  id: "Language ID to pass as --language",
+  name: "Language name"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language IDs for --language flag."
+  },
+  run: () => {
+    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-XRTTEJ5P.js.map

package/dist/leads-LIJS6Y5W.js

@@ -0,0 +1,90 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-VB3XUR6A.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-2VIZ4UUZ.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-U6RONIJC.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiGet
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/leads.ts
+import { defineCommand } from "citty";
+var DAY_MS = 864e5;
+var leadsCommand = defineCommand({
+  meta: {
+    name: "leads",
+    description: `List Lead Gen Form responses (playbook \xA707).
+
+LinkedIn retains LGF responses for 90 days only \u2014 sync to your CRM via this
+endpoint or you'll lose them.
+
+Examples:
+  baker ads linkedin leads --account-id 503001492
+  baker ads linkedin leads --account-id 503001492 --campaign-id 1234
+  baker ads linkedin leads --account-id 503001492 --form-id 5678 --since-days 7
+  baker ads linkedin leads --account-id 503001492 --output csv`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "form-id": { type: "string", description: "Filter by Lead Gen Form ID" },
+    "campaign-id": { type: "string", description: "Filter by campaign ID" },
+    "since-days": { type: "string", description: "Only responses submitted in the last N days" },
+    "since-ms": {
+      type: "string",
+      description: "Only responses submitted at or after this epoch ms (alternative to --since-days)"
+    },
+    limit: { type: "string", description: "Max rows (default: 500)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["form-id"]) params["form-id"] = String(args["form-id"]);
+      if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
+      const sinceDays = args["since-days"] ? Number(args["since-days"]) : void 0;
+      const sinceMs = args["since-ms"] ? Number(args["since-ms"]) : sinceDays ? Date.now() - sinceDays * DAY_MS : void 0;
+      if (sinceMs) params["since-ms"] = String(sinceMs);
+      if (args.limit) params.limit = String(args.limit);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/leads", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        const flat = data.map((r) => ({
+          id: r.id,
+          formId: r.formId,
+          campaignUrn: r.campaignUrn,
+          submittedAt: r.submittedAt ? new Date(r.submittedAt).toISOString() : "",
+          answers: (r.answers ?? []).map((a) => `${a.question}: ${a.answer}`).join(" | ")
+        }));
+        writeAdsOutput(flat, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  leadsCommand
+};
+//# sourceMappingURL=leads-LIJS6Y5W.js.map

package/dist/leads-LIJS6Y5W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/leads.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { csvOrJson, handleLinkedinError, resolveAccountIdArg } from \"./shared.ts\";\n\ninterface LeadResponseRow {\n  id: string;\n  formId: string;\n  formUrn: string;\n  campaignUrn?: string;\n  submittedAt?: number;\n  answers?: Array<{ questionId: string; question: string; answer: string }>;\n  consentResponses?: Array<{ consentId: string; consentText?: string; agreed?: boolean }>;\n}\n\nconst DAY_MS = 86_400_000;\n\nexport const leadsCommand = defineCommand({\n  meta: {\n    name: \"leads\",\n    description: `List Lead Gen Form responses (playbook §07).\n\nLinkedIn retains LGF responses for 90 days only — sync to your CRM via this\nendpoint or you'll lose them.\n\nExamples:\n  baker ads linkedin leads --account-id 503001492\n  baker ads linkedin leads --account-id 503001492 --campaign-id 1234\n  baker ads linkedin leads --account-id 503001492 --form-id 5678 --since-days 7\n  baker ads linkedin leads --account-id 503001492 --output csv`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n    \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n    \"form-id\": { type: \"string\", description: \"Filter by Lead Gen Form ID\" },\n    \"campaign-id\": { type: \"string\", description: \"Filter by campaign ID\" },\n    \"since-days\": { type: \"string\", description: \"Only responses submitted in the last N days\" },\n    \"since-ms\": {\n      type: \"string\",\n      description: \"Only responses submitted at or after this epoch ms (alternative to --since-days)\",\n    },\n    limit: { type: \"string\", description: \"Max rows (default: 500)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"form-id\"]) params[\"form-id\"] = String(args[\"form-id\"]);\n      if (args[\"campaign-id\"]) params[\"campaign-id\"] = String(args[\"campaign-id\"]);\n      const sinceDays = args[\"since-days\"] ? Number(args[\"since-days\"]) : undefined;\n      const sinceMs = args[\"since-ms\"]\n        ? Number(args[\"since-ms\"])\n        : sinceDays\n          ? Date.now() - sinceDays * DAY_MS\n          : undefined;\n      if (sinceMs) params[\"since-ms\"] = String(sinceMs);\n      if (args.limit) params.limit = String(args.limit);\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n\n      const data = await apiGet<LeadResponseRow[]>(\"/api/ads/linkedin/leads\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        // Flatten the answers array for CSV/MD output.\n        const flat = data.map((r) => ({\n          id: r.id,\n          formId: r.formId,\n          campaignUrn: r.campaignUrn,\n          submittedAt: r.submittedAt ? new Date(r.submittedAt).toISOString() : \"\",\n          answers: (r.answers ?? []).map((a) => `${a.question}: ${a.answer}`).join(\" | \"),\n        }));\n        writeAdsOutput(flat as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAgB9B,IAAM,SAAS;AAER,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,IAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,IACvE,WAAW,EAAE,MAAM,UAAU,aAAa,6BAA6B;AAAA,IACvE,eAAe,EAAE,MAAM,UAAU,aAAa,wBAAwB;AAAA,IACtE,cAAc,EAAE,MAAM,UAAU,aAAa,8CAA8C;AAAA,IAC3F,YAAY;AAAA,MACV,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,0BAA0B;AAAA,IAChE,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,qBAAqB,SAAS,OAAO;AAAA,EAC9E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,SAAS,EAAG,QAAO,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC;AAC/D,UAAI,KAAK,aAAa,EAAG,QAAO,aAAa,IAAI,OAAO,KAAK,aAAa,CAAC;AAC3E,YAAM,YAAY,KAAK,YAAY,IAAI,OAAO,KAAK,YAAY,CAAC,IAAI;AACpE,YAAM,UAAU,KAAK,UAAU,IAC3B,OAAO,KAAK,UAAU,CAAC,IACvB,YACE,KAAK,IAAI,IAAI,YAAY,SACzB;AACN,UAAI,QAAS,QAAO,UAAU,IAAI,OAAO,OAAO;AAChD,UAAI,KAAK,MAAO,QAAO,QAAQ,OAAO,KAAK,KAAK;AAChD,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAE7C,YAAM,OAAO,MAAM,OAA0B,2BAA2B,MAAM;AAC9E,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAElB,cAAM,OAAO,KAAK,IAAI,CAAC,OAAO;AAAA,UAC5B,IAAI,EAAE;AAAA,UACN,QAAQ,EAAE;AAAA,UACV,aAAa,EAAE;AAAA,UACf,aAAa,EAAE,cAAc,IAAI,KAAK,EAAE,WAAW,EAAE,YAAY,IAAI;AAAA,UACrE,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,QAAQ,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,KAAK;AAAA,QAChF,EAAE;AACF,uBAAe,MAAmD,GAAG;AACrE;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/learn-N6QV7GXA.js

@@ -0,0 +1,204 @@
+import {
+  setDefinitionFields
+} from "./chunk-EJ4QCMM6.js";
+import {
+  IDEAS_DIR,
+  readIdeas
+} from "./chunk-MOFMOYUA.js";
+import "./chunk-Y46FE75E.js";
+import {
+  parseDays,
+  withDefinitions
+} from "./chunk-Z2GQREJY.js";
+import "./chunk-6UNOK7WV.js";
+import "./chunk-UFKO626N.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-XRIM7NYV.js";
+import "./chunk-FKYPAGKK.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-A6WKCV3V.js";
+import "./chunk-U7YR5CZL.js";
+import "./chunk-VI5YQQ63.js";
+import "./chunk-JX7BX2NB.js";
+import {
+  failApi
+} from "./chunk-ZDAVSTEE.js";
+import "./chunk-DAO63OOP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import {
+  apiPost
+} from "./chunk-6YLNY6CK.js";
+import "./chunk-D5NEIESR.js";
+import "./chunk-57KKVDDR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-QANGHND7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/learn.ts
+import { readFileSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/commands/creatives/learn-model.ts
+var MIN_IMPRESSIONS = 1e3;
+var SEEN_ENOUGH = 5e3;
+var WINNER_RATIO = 0.8;
+var WINNER_MIN_RESULTS = 3;
+var FAILED_RATIO = 1.5;
+var SILENT_SPEND = 2;
+var SETTLED = /* @__PURE__ */ new Set(["winner", "failed", "inconclusive"]);
+var round = (n) => Math.round(n * 100) / 100;
+function totals(creatives) {
+  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);
+  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);
+  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);
+  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);
+  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };
+}
+function verdict(result, usual) {
+  if (result.impressions < MIN_IMPRESSIONS) return "testing";
+  if (usual !== null) {
+    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return "failed";
+    const ratio = result.vsAccount;
+    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return "winner";
+    if (ratio !== null && ratio >= FAILED_RATIO) return "failed";
+  }
+  return result.impressions >= SEEN_ENOUGH ? "inconclusive" : "testing";
+}
+function ideaResult(own, usual, asOf) {
+  const mine = totals(own);
+  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;
+  return {
+    asOf,
+    creatives: own.length,
+    ...own[0]?.currency ? { currency: own[0].currency } : {},
+    spend: round(mine.spend),
+    impressions: mine.impressions,
+    results: mine.results,
+    costPerResult,
+    ctr: mine.ctr,
+    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null
+  };
+}
+function learnFromResults(ideas, creatives, asOf) {
+  const ideaOf = (c) => c.definition?.idea ?? null;
+  return ideas.flatMap((idea) => {
+    if (idea.status === "idea" || idea.status === "retired") return [];
+    const own = creatives.filter((c) => ideaOf(c) === idea.id);
+    if (own.length === 0) return [];
+    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));
+    const usual = rest.results > 0 ? rest.spend / rest.results : null;
+    const result = ideaResult(own, usual, asOf);
+    const to = verdict(result, usual);
+    if (to === "testing" && SETTLED.has(idea.status)) return [];
+    return [{ idea: idea.id, from: idea.status, to, result }];
+  });
+}
+
+// src/commands/creatives/learn.ts
+var DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.
+
+Start here:
+  baker creatives learn               # last 30 days, written onto the ideas
+  baker creatives learn --days 60
+  baker creatives learn --dry-run     # show the verdicts, write nothing
+
+A winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;
+var ARGS = {
+  days: { type: "string", required: false, description: "Reporting window in days (default 30)" },
+  "dry-run": { type: "boolean", required: false, default: false, description: "Show the verdicts; write nothing" }
+};
+registerSchema({ command: "creatives.learn", description: DESCRIPTION, args: ARGS });
+function learnEnvelope(learnings, written, unreadable = []) {
+  const winners = learnings.filter((l) => l.to === "winner").map((l) => l.idea);
+  const failed = learnings.filter((l) => l.to === "failed").map((l) => l.idea);
+  const hints = [];
+  if (unreadable.length > 0) {
+    hints.push(
+      `Could not read ${unreadable.join(", ")}, so their results were not written: fix what \`baker creatives ideas\` names, then run this again.`
+    );
+  }
+  if (learnings.length === 0) {
+    hints.push(
+      "No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative."
+    );
+  }
+  if (winners.length > 0) {
+    hints.push(
+      `Build on ${winners.join(", ")}: keep the message and make it in a new format or for a new persona before any new idea.`
+    );
+  }
+  if (failed.length > 0) {
+    hints.push(
+      `${failed.join(", ")} lost: never repeat their message; \`baker creatives ideas\` flags an idea that does.`
+    );
+  }
+  return {
+    ok: true,
+    data: {
+      written,
+      ideas: learnings.map((l) => ({
+        idea: l.idea,
+        status: l.from === l.to ? l.to : `${l.from} \u2192 ${l.to}`,
+        ...l.result
+      }))
+    },
+    hints
+  };
+}
+async function writeBack(root, learnings) {
+  for (const learning of learnings) {
+    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);
+    const raw = await readFile(file, "utf8");
+    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), "utf8");
+  }
+}
+function readDefinition(root, slug) {
+  try {
+    return readFileSync(path.join(root, "src", "creatives", slug, "_definition.md"), "utf8");
+  } catch {
+    return null;
+  }
+}
+function today() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+var learnCommand = defineCommand({
+  meta: { name: "learn", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    try {
+      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+      const days = parseDays(args.days);
+      const performance = withDefinitions(
+        await apiPost("/api/creatives/performance", days ? { days } : {}),
+        (slug) => readDefinition(root, slug)
+      );
+      const { ideas, unreadable } = await readIdeas(root);
+      const learnings = learnFromResults(ideas, performance.data.creatives, today());
+      const dryRun = args["dry-run"] === true;
+      if (!dryRun) await writeBack(root, learnings);
+      writeJson(
+        learnEnvelope(
+          learnings,
+          !dryRun && learnings.length > 0,
+          unreadable.map((u) => u.id)
+        )
+      );
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  learnCommand,
+  learnEnvelope
+};
+//# sourceMappingURL=learn-N6QV7GXA.js.map