@koda-sl/baker-cli 0.513.0 → 0.514.0-dev.555f7007e

package/dist/chunk-RAQHUMKS.js

@@ -1,169 +0,0 @@
-import {
-  parseXApiError
-} from "./chunk-FIN4ZXGJ.js";
-import {
-  resolveXAccountId
-} from "./chunk-7NF73SCB.js";
-import {
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  X_DRAFT_BATCH_MAX,
-  xDraftOpInputSchema
-} from "./chunk-ZNNQK366.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-X7VQFLHI.js";
-import {
-  requireChatId
-} from "./chunk-LGK7UWBN.js";
-
-// src/commands/ads/x/write-shared.ts
-function failWriteValidation(message) {
-  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function failPreflight(fields) {
-  writeJsonEnvelope({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message: fields.map((f) => f.path ? `${f.path}: ${f.message}` : f.message).join("; "),
-      fields,
-      fix: {
-        action: "reject",
-        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is exactly as it was before this call."
-      }
-    }
-  });
-  process.exit(1);
-}
-function handleXWriteError(err, accountId) {
-  if (err instanceof ApiError) {
-    writeAdsJson(parseXApiError(err.message, accountId));
-    process.exit(1);
-  }
-  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-function decimalPlaces(value) {
-  const [mantissa, exponent] = String(value).trim().split(/e/i);
-  const written = (mantissa?.split(".")[1] ?? "").length;
-  return Math.max(0, written - (exponent ? Number(exponent) : 0));
-}
-function parseXMoney(value) {
-  if (value === void 0 || value === "") {
-    return { ok: true, micros: void 0 };
-  }
-  const amount = Number(value);
-  if (!Number.isFinite(amount) || amount <= 0) {
-    return { ok: false, reason: "must be a positive amount, for example 12.50" };
-  }
-  if (decimalPlaces(value) > 6) {
-    return { ok: false, reason: "is finer than X can express \u2014 it takes whole micros" };
-  }
-  return { ok: true, micros: Math.round(amount * 1e6) };
-}
-function microsFromArg(value, flag) {
-  const parsed = parseXMoney(value);
-  if (!parsed.ok) {
-    failWriteValidation(`${flag} ${parsed.reason}`);
-  }
-  return parsed.micros;
-}
-function csvArg(value) {
-  if (typeof value !== "string" || value.length === 0) {
-    return void 0;
-  }
-  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
-  return parts.length > 0 ? parts : void 0;
-}
-function compact(payload) {
-  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
-}
-function batchNudge(data) {
-  const count = data?.sameKindStaged;
-  if (!count) {
-    return [];
-  }
-  return [
-    `${count} other change${count === 1 ? "" : "s"} of this kind and payload ${count === 1 ? "is" : "are"} already staged \u2014 pass every id to one call (\`--ids a,b,c\`) instead of one call each.`
-  ];
-}
-async function stageXOp(raw, hints) {
-  const preflight = xDraftOpInputSchema.safeParse(raw);
-  if (!preflight.success) {
-    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
-  }
-  const accountId = String(raw.accountId ?? "\u2014");
-  try {
-    const chatId = requireChatId();
-    const response = await apiPost("/api/ads/x/draft/stage", { chatId, op: preflight.data });
-    const allHints = [...batchNudge(response.data), ...hints ?? []];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
-  } catch (err) {
-    handleXWriteError(err, accountId);
-  }
-}
-async function stageXOps(rawOps, hints) {
-  if (rawOps.length === 1 && rawOps[0]) {
-    await stageXOp(rawOps[0], hints);
-    return;
-  }
-  if (rawOps.length > X_DRAFT_BATCH_MAX) {
-    failWriteValidation(`at most ${X_DRAFT_BATCH_MAX} changes can be staged in one call`);
-  }
-  const ops = [];
-  for (const [index, raw] of rawOps.entries()) {
-    const preflight = xDraftOpInputSchema.safeParse(raw);
-    if (!preflight.success) {
-      failPreflight(
-        preflight.error.issues.map((issue) => ({
-          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(".")}` : ""}`,
-          message: issue.message
-        }))
-      );
-    }
-    ops.push(preflight.data);
-  }
-  const accountId = String(rawOps[0]?.accountId ?? "\u2014");
-  try {
-    const chatId = requireChatId();
-    const response = await apiPost("/api/ads/x/draft/stage-batch", { chatId, ops });
-    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);
-  } catch (err) {
-    handleXWriteError(err, accountId);
-  }
-}
-async function stageAccountId(args) {
-  return await resolveXAccountId(args);
-}
-function requireTarget(args, name) {
-  const value = args[name];
-  if (typeof value !== "string" || value.length === 0) {
-    failWriteValidation(`${name} is required`);
-  }
-  return value;
-}
-function requireTargets(args, name) {
-  const ids = csvArg(args[name]);
-  if (!ids) {
-    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
-  }
-  return ids;
-}
-
-export {
-  failWriteValidation,
-  microsFromArg,
-  csvArg,
-  compact,
-  stageXOp,
-  stageXOps,
-  stageAccountId,
-  requireTarget,
-  requireTargets
-};
-//# sourceMappingURL=chunk-RAQHUMKS.js.map

package/dist/chunk-SA22KXWT.js

@@ -1,163 +0,0 @@
-import {
-  failApi
-} from "./chunk-C6CBBZBO.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-ZNNQK366.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-SA22KXWT.js.map

package/dist/chunk-SIXU5PDF.js

@@ -1,66 +0,0 @@
-import {
-  recordIdeaLines
-} from "./chunk-K4FLWDEX.js";
-import {
-  anchorLines,
-  readIdeaAnchor
-} from "./chunk-DL2UJNJ7.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-EJGAJHLB.js";
-
-// src/commands/creatives/idea-hint.ts
-import path from "path";
-function present(fields) {
-  const said = Object.entries(fields).filter(([, v]) => v !== void 0 && !(Array.isArray(v) && v.length === 0));
-  return Object.fromEntries(said);
-}
-function anchorOut(view, full) {
-  const reference = view.reference ? {
-    ...present({ adId: view.reference.adId, advertiser: view.advertiser }),
-    carry: view.reference.carry,
-    mustKeep: view.reference.mustKeep
-  } : void 0;
-  const compact = present({
-    message: view.message,
-    language: view.language,
-    reference,
-    seriesLead: view.seriesLead,
-    accent: view.accent,
-    cast: view.cast,
-    who: view.who,
-    survives: view.survives
-  });
-  if (!full) return compact;
-  return {
-    ...compact,
-    ...present({ why: view.why, voices: view.voices, voiceIds: view.voiceIds, route: view.route }),
-    changes: view.changes
-  };
-}
-function ideaHint(view) {
-  return `Its idea: ${anchorLines(view).join(" \xB7 ").replace(
-    /[.!?…]+$/u,
-    ""
-  )}. An edit keeps it: change exactly what they named; a change of the idea they asked for is one line under "## Changes" in _definition.md, the reason after the dash.`;
-}
-function withAnchor(response, view, opts) {
-  return {
-    ...response,
-    data: { ...response.data, anchor: anchorOut(view, opts.full) },
-    hints: [ideaHint(view), ...response.hints ?? []]
-  };
-}
-async function readCreativeIdea(slug) {
-  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
-  const read = await readIdeaAnchor(path.join(root, "src", "creatives", slug));
-  if (!read) return null;
-  await recordIdeaLines(path.join(root, "canvas"), slug, anchorLines(read.view)).catch(() => void 0);
-  return read.view;
-}
-
-export {
-  withAnchor,
-  readCreativeIdea
-};
-//# sourceMappingURL=chunk-SIXU5PDF.js.map

package/dist/chunk-SWN6OHXG.js

@@ -1,148 +0,0 @@
-import {
-  RULES_DIR,
-  SAME_WORDS,
-  frontmatterOf,
-  parseIdea,
-  parseInsight
-} from "./chunk-A3IQAONL.js";
-import {
-  rememberedJev
-} from "./chunk-QPESDKZC.js";
-import {
-  holdUnbilledSpend
-} from "./chunk-E44NXCTL.js";
-
-// src/commands/creatives/ideas-judgments.ts
-var STATISTIC_QUESTION = `\`quote\` was filed as something a customer said. Is it instead a statistic about a group of people, a share or a figure from a survey, a study or an article ("39% of UK homeowners say\u2026", "a quarter of buyers\u2026", "1 in 3 owners\u2026"), rather than one person's own words about their own experience? A person giving their own number ("My bill dropped 40%") is their own words. The quote may be in any language.`;
-var STATISTIC_HELD = 0.65;
-var SAME_MESSAGE_QUESTION = `\`a\` and \`b\` are the messages of two ads. Do they make the same core promise to the viewer (the same benefit, the same reason to act), even when one adds a detail or a few words, says it in other words, or is in another language? Two messages that promise different things about the same product are not the same.`;
-var SAME_MESSAGE_HELD = 0.42;
-async function withStatisticsRead(insights, ask) {
-  const observed = insights.filter((i) => i.status === "observed");
-  if (observed.length === 0) return [...insights];
-  const answers = await ask(observed.map((i) => ({ instructions: { quote: i.quote, question: STATISTIC_QUESTION } })));
-  if (answers === null) return [...insights];
-  const statistics = new Set(observed.filter((_, i) => (answers[i] ?? 0) >= STATISTIC_HELD).map((i) => i.id));
-  return insights.map((i) => statistics.has(i.id) ? { ...i, status: "interpreted" } : i);
-}
-async function sameMessageRead(ideas, ask) {
-  const failed = ideas.filter((i) => i.status === "failed");
-  const pairs = failed.flatMap(
-    (f) => ideas.filter((i) => i.id !== f.id && !SAME_WORDS(i.message, f.message)).map((i) => [f.message, i.message])
-  );
-  if (pairs.length === 0) return SAME_WORDS;
-  const answers = await ask(pairs.map(([a, b]) => ({ instructions: { a, b, question: SAME_MESSAGE_QUESTION } })));
-  if (answers === null) return SAME_WORDS;
-  const same = new Set(
-    pairs.filter((_, i) => (answers[i] ?? 0) >= SAME_MESSAGE_HELD).map(([a, b]) => `${a}\0${b}`)
-  );
-  return (a, b) => SAME_WORDS(a, b) || same.has(`${a}\0${b}`) || same.has(`${b}\0${a}`);
-}
-
-// src/commands/creatives/ideas-workspace.ts
-import { readdir, readFile } from "fs/promises";
-import path from "path";
-var IDEAS_DIR = path.join("src", "creatives", "_ideas");
-var INSIGHTS_DIR = path.join("src", "content", "insights");
-async function markdownFiles(dir, recursive = false) {
-  const entries = await readdir(dir, { recursive }).catch(() => []);
-  return entries.filter((f) => f.endsWith(".md")).sort();
-}
-var idOf = (file) => file.replace(/\\/g, "/").replace(/\.md$/, "");
-function workspaceIdeasJudge(root) {
-  const cacheDir = path.join(root, "canvas", ".cache");
-  const spent = [];
-  return {
-    ask: rememberedJev(path.join(cacheDir, "ideas-answers.json"), (u) => spent.push(u)),
-    done: () => holdUnbilledSpend(cacheDir, spent.splice(0)).catch(() => void 0)
-  };
-}
-async function readInsights(root, opts = {}) {
-  const dir = path.join(root, INSIGHTS_DIR);
-  const insights = [];
-  for (const file of await markdownFiles(dir, true)) {
-    const insight = parseInsight(idOf(file), await readFile(path.join(dir, file), "utf8").catch(() => ""));
-    if (insight) insights.push(insight);
-  }
-  if (opts.ask) return withStatisticsRead(insights, opts.ask);
-  const judge = workspaceIdeasJudge(root);
-  const read = await withStatisticsRead(insights, judge.ask);
-  await judge.done();
-  return read;
-}
-async function readIdeas(root) {
-  const dir = path.join(root, IDEAS_DIR);
-  const ideas = [];
-  const unreadable = [];
-  for (const file of await markdownFiles(dir)) {
-    const id = idOf(file);
-    const parsed = parseIdea(id, await readFile(path.join(dir, file), "utf8").catch(() => ""));
-    if (parsed.idea) ideas.push(parsed.idea);
-    else unreadable.push({ id, problems: parsed.problems });
-  }
-  return { ideas, unreadable };
-}
-async function readPersonaIds(root) {
-  return (await markdownFiles(path.join(root, "src", "content", "personas"), true)).map(idOf);
-}
-var MAX_KNOWLEDGE_CHARS = 2e5;
-async function readKnowledgeCorpus(root) {
-  const parts = [];
-  const company = await readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => "");
-  if (company) parts.push(company);
-  const content = path.join(root, "src", "content");
-  const insights = path.relative(content, path.join(root, INSIGHTS_DIR));
-  const rules = path.relative(content, path.join(root, RULES_DIR));
-  const files = (await markdownFiles(content, true)).filter((f) => {
-    const file = f.replace(/\\/g, "/");
-    return !file.startsWith(`${insights}/`) && !file.startsWith(`${rules}/`);
-  });
-  for (const file of files) {
-    parts.push(await readFile(path.join(content, file), "utf8").catch(() => ""));
-    if (parts.join("").length > MAX_KNOWLEDGE_CHARS) break;
-  }
-  return parts.join("\n").slice(0, MAX_KNOWLEDGE_CHARS);
-}
-async function readCreativeRecords(root) {
-  const dir = path.join(root, "src", "creatives");
-  const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
-  const records = [];
-  for (const entry of entries) {
-    if (!entry.isDirectory() || entry.name.startsWith("_")) continue;
-    const raw = await readFile(path.join(dir, entry.name, "_definition.md"), "utf8").catch(() => null);
-    if (raw === null) continue;
-    const fm = frontmatterOf(raw) ?? {};
-    const pick = (key) => typeof fm[key] === "string" && fm[key] ? { [key]: fm[key] } : {};
-    records.push({
-      slug: entry.name,
-      ...pick("status"),
-      ...pick("idea"),
-      ...pick("awareness"),
-      ...pick("angle"),
-      ...pick("kind")
-    });
-  }
-  return records;
-}
-var SHOWN_STATUSES = /* @__PURE__ */ new Set(["rendered", "published"]);
-function coverageOf(ideas, creatives) {
-  const live = ideas.filter((i) => i.status === "built" || i.status === "testing" || i.status === "winner");
-  const awareness = new Set(live.map((i) => i.awareness));
-  for (const creative of creatives) {
-    if (creative.awareness && SHOWN_STATUSES.has(creative.status ?? "")) awareness.add(creative.awareness);
-  }
-  return { coveredAwareness: [...awareness].sort(), closersLive: live.filter((i) => i.job === "closer").length };
-}
-
-export {
-  sameMessageRead,
-  IDEAS_DIR,
-  workspaceIdeasJudge,
-  readInsights,
-  readIdeas,
-  readPersonaIds,
-  readKnowledgeCorpus,
-  readCreativeRecords,
-  coverageOf
-};
-//# sourceMappingURL=chunk-SWN6OHXG.js.map