@koda-sl/baker-cli 0.498.0 → 0.500.0

package/dist/chunk-VAHDJ5CK.js

@@ -0,0 +1,344 @@
+import {
+  Phrases,
+  RULE_APPLIES,
+  RULE_STRENGTHS,
+  declaredRules,
+  readLearnedRules
+} from "./chunk-A3IQAONL.js";
+import {
+  readWorkspaceBrandDoc
+} from "./chunk-3YJNSUNF.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-E44NXCTL.js";
+import {
+  askAboutText,
+  rulesDigest,
+  selectRules
+} from "./chunk-7HZSORAB.js";
+import {
+  CREATIVE_FEEDBACK_REASON_LABELS
+} from "./chunk-5MSRVAUZ.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+
+// src/engine/creative-context/company.ts
+import { createHash } from "crypto";
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { z } from "zod";
+var text = z.string().transform((s) => s.trim()).pipe(z.string().min(1).max(300)).optional().catch(void 0);
+var Answer = z.object({
+  sells: text,
+  category: text,
+  industry: text,
+  buyer: z.enum(["consumer", "small_business", "enterprise"]).optional().catch(void 0),
+  country: z.string().transform((s) => s.trim().toUpperCase()).pipe(z.union([z.literal("").transform(() => null), z.string().regex(/^[A-Z]{2}$/)])).optional().catch(void 0),
+  humour: z.enum(["fits", "risky", "off_brand"]).optional().catch(void 0),
+  voice: z.enum(["playful", "peer", "neutral", "reassuring", "formal"]).optional().catch(void 0),
+  memes: z.enum(["fits", "off_brand"]).optional().catch(void 0),
+  memes_why: text,
+  brands: z.array(z.string()).transform(
+    (list) => list.map((s) => s.trim()).filter(Boolean).slice(0, 4)
+  ).catch([])
+});
+function parseCompanyReading(answer) {
+  const parsed = Answer.safeParse(answer);
+  if (!parsed.success || !parsed.data.category) return null;
+  const { brands, ...rest } = parsed.data;
+  return { ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)), brands };
+}
+var COMPANY_READING_MODEL = "google/gemini-3.5-flash-lite";
+var REQUEST = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  temperature: 0,
+  response_format: { type: "json_object" }
+};
+var PROMPT_VERSION = 5;
+var TIMEOUT_MS = 2e4;
+var COMPANY_CHARS = 12e3;
+function companyReadingPrompt(companyDoc, audience) {
+  const notes = [
+    audience?.personas ? `Its personas (who buys):
+${audience.personas}` : "",
+    audience?.voice ? `BRAND.md, how the brand speaks:
+${audience.voice}` : ""
+  ].filter(Boolean);
+  return `You read a company's own notes (COMPANY.md), in whatever language they are written, for the people who make its ads. Extract only what they say; never invent.
+
+"""
+${companyDoc.slice(0, COMPANY_CHARS)}
+"""
+${notes.length > 0 ? `
+${notes.join("\n\n")}
+` : ""}
+Answer only JSON:
+{
+ "sells": "what the company sells and to whom, one plain sentence of at most 20 words in the notes' own language, no brand names (e.g. 'Cursos de electricidad y fontaner\xEDa para desempleados que buscan un oficio estable')",
+ "category": "what it sells, 2-6 plain English words an ads library would file it under, no brand names (e.g. 'electrician training course', 'pet health insurance', 'ecommerce customer service AI'); for a company selling several lines, the line its notes lead with",
+ "industry": "the broader industry, 1-3 English words (e.g. 'vocational education', 'insurance', 'customer service software')",
+ "buyer": "consumer" | "small_business" | "enterprise",
+ "country": "the ISO country code it sells in, or '' when several",
+ "humour": "fits" | "risky" | "off_brand",
+ "voice": "playful" | "peer" | "neutral" | "reassuring" | "formal" (how the brand talks, from the BRAND.md voice and how it speaks on its site, ads and social, never from who buys: playful = witty, casual, irreverent, internet-native; peer = talks as an insider to its own crowd, developer-to-developer, builder to builder; neutral = plain, direct, informative with no personality signal; reassuring = warm, caring, guaranteeing, protecting, calming a fear about money, time or risk; formal = premium, institutional, solemn, corporate-confident),
+ "memes": "fits" | "off_brand" (does that voice run a meme or a reaction-face ad? playful and peer fit, enterprise included; neutral, reassuring and formal are off_brand, consumer brands included),
+ "memes_why": "the voice line that decides it, at most 20 words, quoting it (e.g. 'voice: "playful, a little irreverent"' or 'voice: "formal, premium, understated"')",
+ "brands": ["the company's own brand and product names, as an advertiser name would show them, at most 4"]
+}`;
+}
+var RUNS_MEMES = /* @__PURE__ */ new Set(["playful", "peer"]);
+function memeRegister(reading3) {
+  const memes = reading3?.voice ? RUNS_MEMES.has(reading3.voice) ? "fits" : "off_brand" : reading3?.memes;
+  if (!memes) return void 0;
+  const why = reading3?.memes_why;
+  return { memes, ...why ? { why } : {} };
+}
+function companyLine(reading3) {
+  if (!reading3) return "";
+  const what = reading3.sells ?? reading3.category ?? "";
+  return reading3.industry && what ? `${what} (${reading3.industry})` : what;
+}
+function firstLineSells(companyDoc) {
+  const first = companyDoc.split("\n").find((line) => line.trim() && !line.trim().startsWith("#")) ?? "";
+  if (/^\s*TODO\b/.test(first)) return "";
+  const what = first.replace(/^\s*[-*]\s+/, "").replace(/^\*\*[^*]+\*\*\s*[—–:-]?\s*/, "").split(/\s+for\s+|[,.;:(]|\s[—–-]\s/)[0];
+  return (what ?? "").trim().split(/\s+/).filter(Boolean).slice(0, SELLS_WORDS).join(" ");
+}
+var SELLS_WORDS = 6;
+var askModel = (root) => async (prompt) => {
+  const spent = [];
+  const answer = await askAboutText(COMPANY_READING_MODEL, prompt, (u) => spent.push(u), {
+    timeoutMs: TIMEOUT_MS,
+    request: REQUEST
+  }).catch(() => null);
+  await holdUnbilledSpend(path.join(root, "canvas", ".cache"), spent).catch(() => void 0);
+  return answer;
+};
+async function readCompanyReading(root, ask = askModel(root)) {
+  const doc = await readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => "");
+  const fallback = firstLineSells(doc);
+  if (!fallback) return null;
+  const prompt = companyReadingPrompt(doc, await audienceNotes(root));
+  const key = createHash("sha256").update(JSON.stringify([PROMPT_VERSION, COMPANY_READING_MODEL, prompt])).digest("hex").slice(0, 16);
+  const file = path.join(root, "canvas", ".cache", "company-reading", `${key}.json`);
+  const inFlight = reading.get(file);
+  if (inFlight) return await inFlight;
+  const read = readOrAsk(file, prompt, ask, fallback).finally(() => reading.delete(file));
+  reading.set(file, read);
+  return await read;
+}
+var PERSONA_CHARS = 600;
+var VOICE_CHARS = 800;
+async function audienceNotes(root) {
+  const dir = path.join(root, "src", "content", "personas");
+  const files = (await readdir(dir).catch(() => [])).filter((f) => f.endsWith(".md")).sort();
+  const personas = [];
+  for (const file of files.slice(0, 8)) {
+    const raw = await readFile(path.join(dir, file), "utf8").catch(() => "");
+    const front = /^---\n([\s\S]*?)\n---/.exec(raw)?.[1] ?? raw.slice(0, 300);
+    const lines = front.split("\n").filter((l) => /^\s*(title|name|role|job|description)\s*:/i.test(l));
+    const line = (lines.length > 0 ? lines.join("; ") : file.replace(/\.md$/, "")).slice(0, PERSONA_CHARS);
+    personas.push(`- ${line}`);
+  }
+  const brand = await readFile(path.join(root, "src", "brand", "BRAND.md"), "utf8").catch(() => "");
+  const section = /^##\s+[^\n]*\b(?:tone|voice)\b[^\n]*\n([\s\S]*?)(?=^##\s|(?![\s\S]))/im.exec(brand)?.[1] ?? "";
+  return { personas: personas.join("\n"), voice: section.trim().slice(0, VOICE_CHARS) };
+}
+var reading = /* @__PURE__ */ new Map();
+async function readOrAsk(file, prompt, ask, fallback) {
+  const cached = await readFile(file, "utf8").then((raw) => parseCompanyReading(JSON.parse(raw))).catch(() => null);
+  if (cached) return cached;
+  const answer = parseCompanyReading(await ask(prompt).catch(() => null));
+  if (!answer) return { sells: fallback, brands: [] };
+  await mkdir(path.dirname(file), { recursive: true });
+  await writeFile(file, `${JSON.stringify(answer, null, 2)}
+`, "utf8");
+  return answer;
+}
+
+// src/engine/creative-context/case-file.ts
+var CASE_FILE_CHARS = 3e3;
+function caseFileNotes(entries) {
+  const seen = /* @__PURE__ */ new Set();
+  const lines = [];
+  let used = 0;
+  for (const entry of entries) {
+    if (entry.verdict !== "rejected") continue;
+    const note = entry.note?.trim();
+    const reasons = entry.reasons.map((r) => CREATIVE_FEEDBACK_REASON_LABELS[r].toLowerCase()).join(", ");
+    const key = note ?? reasons;
+    if (!key || seen.has(key)) continue;
+    seen.add(key);
+    const line = `Rejected${reasons ? ` (${reasons})` : ""}${note ? `: "${note}"` : ""}`;
+    if (used + line.length > CASE_FILE_CHARS && lines.length > 0) break;
+    used += line.length;
+    lines.push(line);
+  }
+  return lines;
+}
+async function readCaseFile(slug, read = (body) => apiPost("/api/creatives/feedback", body)) {
+  const response = await read({ slug }).catch(() => null);
+  return response?.ok ? caseFileNotes(response.data.recent) : [];
+}
+
+// src/engine/creative-context/index.ts
+import path3 from "path";
+
+// src/engine/brand/brand-rules.ts
+import { createHash as createHash2 } from "crypto";
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import path2 from "path";
+import { z as z2 } from "zod";
+var BRAND_RULES_MODEL = "google/gemini-3.5-flash";
+var REQUEST2 = {
+  provider: { order: ["google-vertex"], allow_fallbacks: false },
+  seed: 0,
+  reasoning: { effort: "low" },
+  response_format: { type: "json_object" }
+};
+var PROMPT_VERSION2 = 2;
+var TIMEOUT_MS2 = 6e4;
+var BRAND_MD_CHARS = 6e4;
+var MAX_RULES = 60;
+var RULE_CHARS = 400;
+var optionalPhrases = Phrases.optional().catch(void 0);
+var Rule = z2.object({
+  text: z2.string().trim().min(1).max(RULE_CHARS),
+  strength: z2.enum(RULE_STRENGTHS).catch("must"),
+  applies: z2.enum(RULE_APPLIES).catch("any"),
+  forbid: optionalPhrases,
+  require: optionalPhrases,
+  allow: optionalPhrases
+});
+var Answer2 = z2.object({ rules: z2.array(z2.unknown()) });
+function parseBrandRules(answer) {
+  const parsed = Answer2.safeParse(answer);
+  if (!parsed.success) return null;
+  return parsed.data.rules.flatMap((raw) => {
+    const rule = Rule.safeParse(raw);
+    if (!rule.success) return [];
+    const { forbid, require: require2, allow, ...rest } = rule.data;
+    return [
+      {
+        ...rest,
+        ...forbid?.length ? { forbid } : {},
+        ...require2?.length ? { require: require2 } : {},
+        ...allow?.length ? { allow } : {}
+      }
+    ];
+  }).slice(0, MAX_RULES);
+}
+var RULE_HEADING = /rule|never|copy|voice|tone|logo|imag|photo|illustrat|legal|claim|checklist|reflex|prohibit|say|regla|nunca|voz|tono|imagen|foto|prohib|decir|règle|jamais|regel|stimme|bild|regra|imagem/i;
+function ruleSections(brandMd) {
+  const headings = [...brandMd.slice(0, BRAND_MD_CHARS).matchAll(/^#{2,4}\s+(.+)$/gm)].map((m) => (m[1] ?? "").trim()).filter((h) => RULE_HEADING.test(h));
+  const fence = /```generation-style/.test(brandMd) ? ["the ```generation-style block"] : [];
+  return [.../* @__PURE__ */ new Set([...headings, ...fence])];
+}
+var PRIVATE_QUOTE_LINE = "Never publish a customer quote or an identifiable customer conversation.";
+var PRIVATE_QUOTE_MEANT = "Never publish what a customer said in a private call, chat or note, nor a conversation that identifies them. A testimonial, review or case study the customer published or agreed to is not a private call: an ad may quote it.";
+function brandRulesPrompt(document) {
+  const brandMd = document.replaceAll(PRIVATE_QUOTE_LINE, PRIVATE_QUOTE_MEANT);
+  const sections = ruleSections(brandMd);
+  return [
+    "You read a company's brand guidelines (BRAND.md), written in any language, for the people who make its ads. List every standing rule they set that an ad, its words, its pictures, its people or its logo must follow. Extract only what they state; never invent a rule.",
+    "",
+    "Go through the document section by section: every bullet or sentence of a section about copy or wording, voice, what the brand never says, things to reject, legal risk or claims it may not make, a checklist before publishing, how its name, numbers or prices are written, which logo to use and what never to do to it, photography, illustration, imagery or a generation-style block is one rule; keep each, a style taste included (as a prefer), whatever language the section is in. Leave out only rules about web pages, components, code, spacing, typefaces, colours' hex values and where a colour goes on a page.",
+    ...sections.length > 0 ? [
+      "",
+      `Sections that most likely hold rules, each to be read to its end: ${sections.map((h) => `"${h}"`).join(", ")}.`
+    ] : [],
+    "",
+    `Return JSON only: {"rules": [{"text": string, "strength": "never" | "must" | "prefer", "applies": "copy" | "picture" | "cast" | "logo" | "voice" | "sound" | "subtitles" | "any", "forbid": string[], "require": string[], "allow": string[]}]}, at most ${MAX_RULES}, each rule once.`,
+    `- text: the rule quoted from the document in its own language, whole but short (one bullet, at most one sentence of why). It must make sense read alone, as an ad's reviewer reads it: when a bullet leans on its heading or table, name what it is about ("Brand red: never for text or buttons", not "Never text, never a button").`,
+    '- strength: "never" for a ban, "must" for something every ad has to do, "prefer" for a taste or a default.',
+    `- applies: "copy" for words, "picture" for what is shown, "cast" for who appears, "logo", "voice" or "sound" for a video's voice and audio, "subtitles", else "any".`,
+    '- forbid: the exact words the rule bans in every case, as the document quotes them ("\u2014" for em-dashes, "usted"); [] when the ban depends on the context or names no words. allow: the right spelling when the rule is about how a word is written or capitalised ("ZentIA"). require: words every ad must say; usually [].',
+    "",
+    "<brand_md>",
+    brandMd.slice(0, BRAND_MD_CHARS),
+    "</brand_md>"
+  ].join("\n");
+}
+function brandRulesReader(cacheDir, onSpend) {
+  return async (brandMd) => {
+    const prompt = brandRulesPrompt(brandMd);
+    const key = createHash2("sha256").update(JSON.stringify([PROMPT_VERSION2, BRAND_RULES_MODEL, prompt])).digest("hex");
+    const file = path2.join(cacheDir, "brand-rules", `${key}.json`);
+    const inFlight = reading2.get(file);
+    if (inFlight) return await inFlight;
+    if (failed.has(file)) return null;
+    const read = readOrAsk2(file, prompt, onSpend, cacheDir).then((rules) => {
+      if (rules === null) failed.add(file);
+      return rules;
+    }).finally(() => reading2.delete(file));
+    reading2.set(file, read);
+    return await read;
+  };
+}
+var reading2 = /* @__PURE__ */ new Map();
+var failed = /* @__PURE__ */ new Set();
+async function readOrAsk2(file, prompt, onSpend, cacheDir) {
+  const cached = parseBrandRules(await readFile2(file, "utf8").then(JSON.parse, () => null));
+  if (cached) return cached;
+  const spent = [];
+  const answer = await askAboutText(BRAND_RULES_MODEL, prompt, (u) => onSpend ? onSpend(u) : spent.push(u), {
+    timeoutMs: TIMEOUT_MS2,
+    request: REQUEST2
+  }).catch(() => null);
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const rules = parseBrandRules(answer);
+  if (rules) {
+    await mkdir2(path2.dirname(file), { recursive: true }).catch(() => void 0);
+    await writeFile2(file, JSON.stringify({ rules }), "utf8").catch(() => void 0);
+  }
+  return rules;
+}
+async function readWorkspaceBrandRules(root, opts = {}) {
+  const brandMd = await readFile2(path2.join(root, "src", "brand", "BRAND.md"), "utf8").catch(() => "");
+  if (!brandMd.trim()) return [];
+  const read = opts.read ?? brandRulesReader(path2.join(root, "canvas", ".cache"), opts.onSpend);
+  return await read(brandMd).catch(() => null) ?? [];
+}
+
+// src/engine/creative-context/index.ts
+async function readAllRules(root, readers = {}) {
+  const [declared, learned] = await Promise.all([
+    readWorkspaceBrandRules(root, {
+      ...readers.brandRules ? { read: readers.brandRules } : {},
+      ...readers.onSpend ? { onSpend: readers.onSpend } : {}
+    }),
+    readLearnedRules(root)
+  ]);
+  return [...learned, ...declaredRules(declared)];
+}
+async function readCreativeContext(root, target = {}, opts = {}) {
+  const readers = opts.readers ?? {};
+  const [company, brand, rules] = await Promise.all([
+    readCompanyReading(root, ...readers.company ? [readers.company] : []).catch(() => null),
+    readWorkspaceBrandDoc(root, {
+      ...readers.brand ? { read: readers.brand } : {},
+      ...readers.onSpend ? { onSpend: readers.onSpend } : {}
+    }).catch(() => null),
+    readAllRules(root, readers).catch(() => [])
+  ]);
+  const held = selectRules(rules, target, opts.waived);
+  return { company, brand, rules: held, rulesDigest: rulesDigest(held), caseFile: (slug) => readCaseFile(slug) };
+}
+var workspaceOfCreative = (creativeDir) => path3.resolve(creativeDir, "../../..");
+function avoidOf(rules, max = 5) {
+  return rules.filter((r) => r.strength === "never" && r.applies !== "voice" && r.applies !== "sound").slice(0, max).map((r) => r.text.length > 90 ? `${r.text.slice(0, 89)}\u2026` : r.text);
+}
+
+export {
+  memeRegister,
+  companyLine,
+  readCompanyReading,
+  readCaseFile,
+  readAllRules,
+  readCreativeContext,
+  workspaceOfCreative,
+  avoidOf
+};
+//# sourceMappingURL=chunk-VAHDJ5CK.js.map

package/dist/chunk-VM4IQ75N.js

@@ -0,0 +1,163 @@
+import {
+  failApi
+} from "./chunk-XYBSTW3P.js";
+import {
+  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
+  CREATIVE_PERFORMANCE_MAX_DAYS
+} from "./chunk-5MSRVAUZ.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+
+// src/commands/creatives/performance.ts
+import { readFileSync } from "fs";
+import path from "path";
+import { defineCommand } from "citty";
+import { parse as parseYaml } from "yaml";
+var DESCRIPTION = `How each Baker creative is doing in the live Meta ads that show it: spend, impressions, CTR, CPC, results, cost per result, frequency and a fatigue verdict, next to the angle, hook, mechanism and dominant slot its definition set out to test. Video creatives add hookRate (percent of impressions that watched 3 seconds) and holdRate (percent of those that reached a ThruPlay). Use it before briefing new creatives, to learn which angle and mechanism to make next and which creatives to replace.
+
+Start here:
+  baker creatives performance                      # every creative in an ad, last 30 days
+  baker creatives performance --slug spring-offer  # one creative
+  baker creatives performance --days 14 --full     # ids, last-7-day figures, a video's watch funnel, one row per ad
+
+Fatigue follows the Meta playbook (07-creative-audit.md): fresh, fading, fatigued, dead, or too_early (under 14 days or 1,000 impressions) and no_delivery. A low hook rate means the first 3 seconds need new hooks; a working hook with a low hold rate means the body loses people. A creative counts once a Session's publish created an ad with it.`;
+var ARGS = {
+  slug: { type: "string", description: "Only this creative (src/creatives/<slug>/)", required: false },
+  days: {
+    type: "string",
+    description: `Reporting window in days, ending today (1-${CREATIVE_PERFORMANCE_MAX_DAYS}, default ${CREATIVE_PERFORMANCE_DEFAULT_DAYS})`,
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Add ids, last-7-day CTR and cost per result, and one row per ad",
+    required: false,
+    default: false
+  }
+};
+registerSchema({ command: "creatives.performance", description: DESCRIPTION, args: ARGS });
+var INSIGHT_KEYS = [
+  "idea",
+  "message",
+  "evidence",
+  "angle",
+  "hook",
+  "mechanism",
+  "dominantSlot",
+  "persona",
+  "awareness",
+  "hypothesis"
+];
+var FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
+function insightValue(value) {
+  if (typeof value === "string") return value.trim() || null;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  return null;
+}
+function definitionInsights(markdown) {
+  const block = FRONTMATTER.exec(markdown)?.[1];
+  if (!block) return null;
+  let parsed;
+  try {
+    parsed = parseYaml(block);
+  } catch {
+    return null;
+  }
+  if (parsed === null || typeof parsed !== "object") return null;
+  const insights = {};
+  for (const [key, raw] of Object.entries(parsed)) {
+    if (!(INSIGHT_KEYS.includes(key) || key.startsWith("source") || key.startsWith("reference"))) continue;
+    const value = insightValue(raw);
+    if (value !== null) insights[key] = value;
+  }
+  return Object.keys(insights).length > 0 ? insights : null;
+}
+function readLocalDefinition(slug) {
+  try {
+    return readFileSync(path.join(process.cwd(), "src", "creatives", slug, "_definition.md"), "utf8");
+  } catch {
+    return null;
+  }
+}
+var COMPARED_FIELDS = [
+  { key: "angle", label: "angle", advice: "Brief the next creative on the cheapest angle with a new hook." },
+  { key: "mechanism", label: "mechanism", advice: "Brief the next creative on the cheapest mechanism." },
+  { key: "dominantSlot", label: "dominant slot", advice: "Lead the next creative with the cheapest dominant slot." }
+];
+function cheapestHint(creatives, { key, label, advice }) {
+  const byValue = /* @__PURE__ */ new Map();
+  for (const creative of creatives) {
+    const value = creative.definition?.[key];
+    if (!value || creative.costPerResult === null) continue;
+    const best = byValue.get(value);
+    if (!best || (best.costPerResult ?? Number.POSITIVE_INFINITY) > creative.costPerResult)
+      byValue.set(value, creative);
+  }
+  if (byValue.size < 2) return null;
+  const ranked = [...byValue.entries()].sort(([, a], [, b]) => (a.costPerResult ?? 0) - (b.costPerResult ?? 0)).map(
+    ([value, creative]) => `"${value}" ${creative.costPerResult}${creative.currency ? ` ${creative.currency}` : ""} (${creative.slug ?? creative.title})`
+  );
+  return `Cost per result by ${label}: ${ranked.join(", ")}. ${advice}`;
+}
+function withDefinitions(response, readDefinition) {
+  const creatives = response.data.creatives.map((creative) => {
+    const markdown = creative.slug ? readDefinition(creative.slug) : null;
+    const definition = markdown ? definitionInsights(markdown) : null;
+    return definition ? { ...creative, definition } : creative;
+  });
+  const hints = [...response.hints ?? []];
+  for (const field of COMPARED_FIELDS) {
+    const hint = cheapestHint(creatives, field);
+    if (hint) hints.push(hint);
+  }
+  const unnamed = creatives.filter((creative) => !creative.definition?.angle).map((c) => c.slug ?? c.title);
+  if (unnamed.length > 0) {
+    hints.push(
+      `No angle recorded for: ${unnamed.join(", ")}. Add angle and hook to src/creatives/<slug>/_definition.md so results show which angle works.`
+    );
+  }
+  return { ...response, data: { ...response.data, creatives }, ...hints.length > 0 ? { hints } : {} };
+}
+function syncedCreativesHint(slug) {
+  return `Live Meta read. Across every platform, from the synced copy (no rate limit, full history): baker ads performance creatives ranks them against their ad-group peers (madeInBaker names this creative), and baker ads performance live-in --creative ${slug ?? "<slug>"} lists the live campaigns showing it.`;
+}
+function parseDays(raw) {
+  if (raw === void 0) return void 0;
+  const days = Number(raw);
+  if (!Number.isInteger(days) || days < 1 || days > CREATIVE_PERFORMANCE_MAX_DAYS) {
+    throw new Error(`--days must be a whole number from 1 to ${CREATIVE_PERFORMANCE_MAX_DAYS}`);
+  }
+  return days;
+}
+var performanceCommand = defineCommand({
+  meta: { name: "performance", description: DESCRIPTION },
+  args: ARGS,
+  run: async ({ args }) => {
+    try {
+      const body = {};
+      const slug = args.slug;
+      if (slug) body.slug = slug;
+      const days = parseDays(args.days);
+      if (days !== void 0) body.days = days;
+      if (args.full) body.full = true;
+      const response = await apiPost("/api/creatives/performance", body);
+      const out = withDefinitions(response, readLocalDefinition);
+      writeJson({ ...out, hints: [...out.hints ?? [], syncedCreativesHint(slug)] });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+
+export {
+  definitionInsights,
+  withDefinitions,
+  parseDays,
+  performanceCommand
+};
+//# sourceMappingURL=chunk-VM4IQ75N.js.map

package/dist/chunk-VM4IQ75N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/performance.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  CREATIVE_PERFORMANCE_DEFAULT_DAYS,\n  CREATIVE_PERFORMANCE_MAX_DAYS,\n  type CreativePerformance,\n  type CreativesPerformanceRequest,\n  type CreativesPerformanceResponse,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { parse as parseYaml } from \"yaml\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\n\nconst DESCRIPTION = `How each Baker creative is doing in the live Meta ads that show it: spend, impressions, CTR, CPC, results, cost per result, frequency and a fatigue verdict, next to the angle, hook, mechanism and dominant slot its definition set out to test. Video creatives add hookRate (percent of impressions that watched 3 seconds) and holdRate (percent of those that reached a ThruPlay). Use it before briefing new creatives, to learn which angle and mechanism to make next and which creatives to replace.\n\nStart here:\n  baker creatives performance                      # every creative in an ad, last 30 days\n  baker creatives performance --slug spring-offer  # one creative\n  baker creatives performance --days 14 --full     # ids, last-7-day figures, a video's watch funnel, one row per ad\n\nFatigue follows the Meta playbook (07-creative-audit.md): fresh, fading, fatigued, dead, or too_early (under 14 days or 1,000 impressions) and no_delivery. A low hook rate means the first 3 seconds need new hooks; a working hook with a low hold rate means the body loses people. A creative counts once a Session's publish created an ad with it.`;\n\nconst ARGS = {\n  slug: { type: \"string\", description: \"Only this creative (src/creatives/<slug>/)\", required: false },\n  days: {\n    type: \"string\",\n    description: `Reporting window in days, ending today (1-${CREATIVE_PERFORMANCE_MAX_DAYS}, default ${CREATIVE_PERFORMANCE_DEFAULT_DAYS})`,\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description: \"Add ids, last-7-day CTR and cost per result, and one row per ad\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.performance\", description: DESCRIPTION, args: ARGS });\n\n/**\n * Frontmatter keys that say what a creative set out to test (angle, hook, the\n * mechanism it uses and the slot it leads with) and which reference\n * ad it adapted. Anything named `source…` or `reference…` is kept too, so\n * reference fields added to the collection later come through without a CLI\n * release.\n */\nconst INSIGHT_KEYS = [\n  \"idea\",\n  \"message\",\n  \"evidence\",\n  \"angle\",\n  \"hook\",\n  \"mechanism\",\n  \"dominantSlot\",\n  \"persona\",\n  \"awareness\",\n  \"hypothesis\",\n];\nconst FRONTMATTER = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/;\n\nfunction insightValue(value: unknown): string | null {\n  if (typeof value === \"string\") return value.trim() || null;\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  return null;\n}\n\n/** The insight fields of a `_definition.md`, or null when it names none. */\nexport function definitionInsights(markdown: string): Record<string, string> | null {\n  const block = FRONTMATTER.exec(markdown)?.[1];\n  if (!block) return null;\n  let parsed: unknown;\n  try {\n    parsed = parseYaml(block);\n  } catch {\n    return null;\n  }\n  if (parsed === null || typeof parsed !== \"object\") return null;\n  const insights: Record<string, string> = {};\n  for (const [key, raw] of Object.entries(parsed as Record<string, unknown>)) {\n    if (!(INSIGHT_KEYS.includes(key) || key.startsWith(\"source\") || key.startsWith(\"reference\"))) continue;\n    const value = insightValue(raw);\n    if (value !== null) insights[key] = value;\n  }\n  return Object.keys(insights).length > 0 ? insights : null;\n}\n\nfunction readLocalDefinition(slug: string): string | null {\n  try {\n    return readFileSync(path.join(process.cwd(), \"src\", \"creatives\", slug, \"_definition.md\"), \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Definition fields whose values are compared by cost per result, each with\n * the advice its hint closes on. `label` is how the hint names the field.\n */\nconst COMPARED_FIELDS = [\n  { key: \"angle\", label: \"angle\", advice: \"Brief the next creative on the cheapest angle with a new hook.\" },\n  { key: \"mechanism\", label: \"mechanism\", advice: \"Brief the next creative on the cheapest mechanism.\" },\n  { key: \"dominantSlot\", label: \"dominant slot\", advice: \"Lead the next creative with the cheapest dominant slot.\" },\n] as const;\n\nfunction cheapestHint(\n  creatives: readonly CreativePerformance[],\n  { key, label, advice }: (typeof COMPARED_FIELDS)[number],\n): string | null {\n  const byValue = new Map<string, CreativePerformance>();\n  for (const creative of creatives) {\n    const value = creative.definition?.[key];\n    if (!value || creative.costPerResult === null) continue;\n    const best = byValue.get(value);\n    if (!best || (best.costPerResult ?? Number.POSITIVE_INFINITY) > creative.costPerResult)\n      byValue.set(value, creative);\n  }\n  if (byValue.size < 2) return null;\n  const ranked = [...byValue.entries()]\n    .sort(([, a], [, b]) => (a.costPerResult ?? 0) - (b.costPerResult ?? 0))\n    .map(\n      ([value, creative]) =>\n        `\"${value}\" ${creative.costPerResult}${creative.currency ? ` ${creative.currency}` : \"\"} (${creative.slug ?? creative.title})`,\n    );\n  return `Cost per result by ${label}: ${ranked.join(\", \")}. ${advice}`;\n}\n\n/**\n * Adds each creative's definition (read from the local repo, where the agent\n * works) and the hints that need it: which angle, mechanism and dominant slot\n * are cheapest, and which creatives say nothing about what they test.\n */\nexport function withDefinitions(\n  response: CreativesPerformanceResponse,\n  readDefinition: (slug: string) => string | null,\n): CreativesPerformanceResponse {\n  const creatives = response.data.creatives.map((creative) => {\n    const markdown = creative.slug ? readDefinition(creative.slug) : null;\n    const definition = markdown ? definitionInsights(markdown) : null;\n    return definition ? { ...creative, definition } : creative;\n  });\n  const hints = [...(response.hints ?? [])];\n  for (const field of COMPARED_FIELDS) {\n    const hint = cheapestHint(creatives, field);\n    if (hint) hints.push(hint);\n  }\n  const unnamed = creatives.filter((creative) => !creative.definition?.angle).map((c) => c.slug ?? c.title);\n  if (unnamed.length > 0) {\n    hints.push(\n      `No angle recorded for: ${unnamed.join(\", \")}. Add angle and hook to src/creatives/<slug>/_definition.md so results show which angle works.`,\n    );\n  }\n  return { ...response, data: { ...response.data, creatives }, ...(hints.length > 0 ? { hints } : {}) };\n}\n\n/** This read is live Meta only; the synced copy ranks every platform's creatives and says where each runs. */\nfunction syncedCreativesHint(slug: string | undefined): string {\n  return `Live Meta read. Across every platform, from the synced copy (no rate limit, full history): baker ads performance creatives ranks them against their ad-group peers (madeInBaker names this creative), and baker ads performance live-in --creative ${slug ?? \"<slug>\"} lists the live campaigns showing it.`;\n}\n\nexport function parseDays(raw: string | undefined): number | undefined {\n  if (raw === undefined) return undefined;\n  const days = Number(raw);\n  if (!Number.isInteger(days) || days < 1 || days > CREATIVE_PERFORMANCE_MAX_DAYS) {\n    throw new Error(`--days must be a whole number from 1 to ${CREATIVE_PERFORMANCE_MAX_DAYS}`);\n  }\n  return days;\n}\n\nexport const performanceCommand = defineCommand({\n  meta: { name: \"performance\", description: DESCRIPTION },\n  args: ARGS,\n  run: async ({ args }) => {\n    try {\n      const body: CreativesPerformanceRequest = {};\n      const slug = args.slug as string | undefined;\n      if (slug) body.slug = slug;\n      const days = parseDays(args.days as string | undefined);\n      if (days !== undefined) body.days = days;\n      if (args.full) body.full = true;\n      const response = await apiPost<CreativesPerformanceResponse>(\"/api/creatives/performance\", body);\n      const out = withDefinitions(response, readLocalDefinition);\n      writeJson({ ...out, hints: [...(out.hints ?? []), syncedCreativesHint(slug)] });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}