@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/chunk-6FWVRXDW.js

@@ -1,64 +0,0 @@
-import {
-  REF_PREFIX
-} from "./chunk-5NLUTJCQ.js";
-
-// src/commands/canvas/node-preview.ts
-var MAX_PARAMS_PREVIEW_LENGTH = 4e3;
-var SPEC_KEYS = [
-  "model",
-  "format",
-  "mode",
-  "aspect_ratio",
-  "image_size",
-  "resolution",
-  "duration",
-  "subject_type",
-  "font_size",
-  "expect",
-  "source",
-  "path",
-  "url"
-];
-var BODY_KEYS = ["prompt", "text", "subject_description"];
-function scalarField(params, key) {
-  const value = params[key];
-  if (typeof value === "number") return String(value);
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed && !trimmed.startsWith(REF_PREFIX) ? trimmed : void 0;
-}
-function compactJson(params) {
-  try {
-    const json = JSON.stringify(params);
-    return json && json !== "{}" ? json : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function cap(text) {
-  return text.length > MAX_PARAMS_PREVIEW_LENGTH ? `${text.slice(0, MAX_PARAMS_PREVIEW_LENGTH - 1)}\u2026` : text;
-}
-function nodeParamsPreview(params, deps) {
-  const refsLine = deps && deps.length > 0 ? `refs: ${deps.join(", ")}` : void 0;
-  if (!params || typeof params !== "object") return refsLine;
-  const own = params;
-  const nested = (key) => own[key] && typeof own[key] === "object" && !Array.isArray(own[key]) ? own[key] : {};
-  const record = { ...nested("paint"), ...nested("words"), ...own };
-  const spec = [];
-  for (const key of SPEC_KEYS) {
-    const value = scalarField(record, key);
-    if (value !== void 0) spec.push(`${key}: ${value}`);
-  }
-  if (refsLine) spec.push(refsLine);
-  const body = BODY_KEYS.map((key) => scalarField(record, key)).find(Boolean);
-  const header = spec.join("\n");
-  const composed = header && body ? `${header}
-
-${body}` : header || body || compactJson(record);
-  return composed ? cap(composed) : void 0;
-}
-
-export {
-  nodeParamsPreview
-};
-//# sourceMappingURL=chunk-6FWVRXDW.js.map

package/dist/chunk-6MXM6DA6.js

@@ -1,225 +0,0 @@
-import {
-  metaDraftOpInputSchema
-} from "./chunk-GC5P4KWY.js";
-import {
-  handleMetaError,
-  resolveAccountIdArg
-} from "./chunk-QY7EK6Q4.js";
-import {
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-import {
-  adCopyHints,
-  booleanWordPositionalError,
-  payloadFix
-} from "./chunk-P4MXGSSJ.js";
-import {
-  withHints
-} from "./chunk-D5FY4FAK.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-QYH2UZAK.js";
-import {
-  describeOpPayload
-} from "./chunk-R7XDGNZD.js";
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import {
-  requireChatId
-} from "./chunk-45D6WRCJ.js";
-import {
-  payloadArg
-} from "./chunk-CCYZJMZ7.js";
-
-// src/commands/ads/meta/write-shared.ts
-import { readFileSync } from "fs";
-function fileArg(kind, description) {
-  return {
-    file: payloadArg(
-      {
-        type: "string",
-        description: `${description} \u2014 run \`baker schema\` on this command for every field the payload takes`
-      },
-      () => describeOpPayload(metaDraftOpInputSchema, kind)
-    )
-  };
-}
-async function bareAccountId(args) {
-  return (await resolveAccountIdArg(args)).replace(/^act_/, "");
-}
-function failWriteValidation(message) {
-  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function refuseDeleteByUpdate(payload, group) {
-  if (payload.status === "DELETED") {
-    failWriteValidation(
-      `update does not delete \u2014 deleting is permanent. Use \`baker ads meta ${group} delete <id>\` if the user asked to delete; otherwise pause or archive.`
-    );
-  }
-}
-function loadJsonFileArg(path) {
-  if (typeof path !== "string" || path.length === 0) {
-    return {};
-  }
-  const inline = /^\s*\{/.test(path);
-  const source = inline ? "inline JSON" : path;
-  try {
-    const parsed = JSON.parse(inline ? path : readFileSync(path, "utf8"));
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${source} must contain a JSON object`);
-    }
-    return parsed;
-  } catch (err) {
-    if (err instanceof SyntaxError) {
-      failWriteValidation(`${source} is not valid JSON: ${err.message}`);
-    }
-    throw err;
-  }
-}
-function mergePayload(file, flags) {
-  const merged = { ...file };
-  for (const [key, value] of Object.entries(flags)) {
-    if (value !== void 0) {
-      merged[key] = value;
-    }
-  }
-  return merged;
-}
-function parseMoneyFlag(amount, currency, flag) {
-  if (amount === void 0 || amount === null || amount === "") {
-    return void 0;
-  }
-  if (currency === void 0 || currency === null || currency === "") {
-    return { amount: String(amount) };
-  }
-  if (typeof currency !== "string" || currency.length !== 3) {
-    failWriteValidation(`${flag} got an invalid --currency (expected a 3-letter code like USD)`);
-  }
-  return { amount: String(amount), currencyCode: currency.toUpperCase() };
-}
-function parseDateFlag(value, flag) {
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
-  }
-  const raw = String(value);
-  if (/^\d{10,}$/.test(raw)) {
-    return Number(raw);
-  }
-  const parsed = Date.parse(raw);
-  if (Number.isNaN(parsed)) {
-    failWriteValidation(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);
-  }
-  return parsed;
-}
-function listFlag(value) {
-  if (typeof value !== "string" || value.trim().length === 0) {
-    return void 0;
-  }
-  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
-  return items.length > 0 ? items : void 0;
-}
-function repeatedListFlag(rawArgs, flag, parsed) {
-  const items = repeatedValues(rawArgs, flag, parsed).flatMap((value) => value.split(",")).map((item) => item.trim()).filter(Boolean);
-  return items.length > 0 ? items : void 0;
-}
-function upper(value) {
-  return typeof value === "string" && value.length > 0 ? value.toUpperCase() : void 0;
-}
-function numberFlag(value, flag) {
-  if (value === void 0 || value === null || value === "") {
-    return void 0;
-  }
-  const n = Number(value);
-  if (!Number.isFinite(n)) {
-    failWriteValidation(`${flag} must be a number`);
-  }
-  return n;
-}
-function requireTarget(args, entity) {
-  const inverted = booleanWordPositionalError(args, entity);
-  if (inverted !== void 0) {
-    failWriteValidation(inverted);
-  }
-  const positional = Array.isArray(args._) ? args._[0] : void 0;
-  const target = args.id ?? args.target ?? args.ref ?? positional;
-  if (typeof target !== "string" || target.length === 0) {
-    failWriteValidation(`pass the ${entity} id as the positional argument`);
-  }
-  return target;
-}
-function preflightOp(raw) {
-  const preflight = metaDraftOpInputSchema.safeParse(raw);
-  if (!preflight.success) {
-    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "VALIDATION_ERROR",
-        message: fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; "),
-        fields,
-        fix: payloadFix("meta-ads", metaDraftOpInputSchema, raw)
-      }
-    });
-    process.exit(1);
-  }
-  return preflight.data;
-}
-async function stageOp(raw, extraHints = []) {
-  const op = preflightOp(raw);
-  try {
-    const chatId = requireChatId();
-    const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op });
-    const copyHints = await adCopyHints(op);
-    writeJsonEnvelope(withHints(response, [...copyHints, ...extraHints]));
-  } catch (err) {
-    handleMetaError(err);
-  }
-}
-async function stageOps(raws) {
-  const ops = raws.map(preflightOp);
-  const chatId = requireChatId();
-  const staged = [];
-  for (const op of ops) {
-    try {
-      const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op });
-      staged.push(response.data);
-    } catch (err) {
-      if (staged.length > 0) {
-        process.stderr.write(`staged before the refusal: ${staged.map((entry) => entry.ref).join(", ")}
-`);
-      }
-      handleMetaError(err);
-    }
-  }
-  writeJsonEnvelope({ ok: true, data: staged });
-}
-async function stageStatusChange(input) {
-  await stageOp({
-    kind: input.kind,
-    accountId: input.accountId,
-    target: input.target,
-    payload: { status: input.status }
-  });
-}
-
-export {
-  fileArg,
-  bareAccountId,
-  failWriteValidation,
-  refuseDeleteByUpdate,
-  loadJsonFileArg,
-  mergePayload,
-  parseMoneyFlag,
-  parseDateFlag,
-  listFlag,
-  repeatedListFlag,
-  upper,
-  numberFlag,
-  requireTarget,
-  stageOp,
-  stageOps,
-  stageStatusChange
-};
-//# sourceMappingURL=chunk-6MXM6DA6.js.map

package/dist/chunk-73MLPGI2.js

@@ -1,66 +0,0 @@
-import {
-  recordIdeaLines
-} from "./chunk-OIORUNKH.js";
-import {
-  anchorLines,
-  readIdeaAnchor
-} from "./chunk-QFVZIQRQ.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-XB4NKZAQ.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-73MLPGI2.js.map

package/dist/chunk-7OVPQX4X.js

@@ -1,163 +0,0 @@
-import {
-  failApi
-} from "./chunk-4AEAL63J.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-RCNAKWK7.js";
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-CCYZJMZ7.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-7OVPQX4X.js.map