@koda-sl/baker-cli 0.545.0-dev.2a6beac48 → 0.546.0

package/dist/chunk-WGJHVP7T.js

@@ -1,163 +0,0 @@
-import {
-  failApi
-} from "./chunk-ORLQEQDF.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-S47XHWFU.js";
-import {
-  apiPost
-} from "./chunk-B2OHCWYB.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-WCIS4FZH.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-WGJHVP7T.js.map

package/dist/chunk-WJ6UJBHB.js

@@ -1,91 +0,0 @@
-import {
-  leadVersion,
-  writeSeriesMemberCanvas
-} from "./chunk-VZGLL54O.js";
-import {
-  definitionFieldsOf,
-  setDefinitionFields,
-  setSpecMessage
-} from "./chunk-JBNT444M.js";
-import {
-  IDEAS_DIR
-} from "./chunk-LDFM37DM.js";
-
-// src/commands/creatives/make-series.ts
-import { mkdir, readFile, writeFile } from "fs/promises";
-import path from "path";
-import { parseDocument } from "yaml";
-var LEAD_ONLY = ["idea", "message", "evidence", "angle", "persona", "awareness", "hypothesis", "series", "title"];
-function withoutFields(raw, keys) {
-  const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---/);
-  if (!match) return raw;
-  const doc = parseDocument(match[1] ?? "");
-  if (doc.errors.length > 0) return raw;
-  for (const key of keys) doc.delete(key);
-  return `---
-${doc.toString()}---${raw.slice(match[0].length)}`;
-}
-async function makeSeriesAd(root, idea, slug, lead, evidence, deps) {
-  if (slug === lead) {
-    return {
-      code: "series_of_itself",
-      message: `"${slug}" is the lead itself.`,
-      fix: "Give the new ad its own --slug."
-    };
-  }
-  const version = await leadVersion(root, lead);
-  if ("refused" in version) return version.refused;
-  const dir = path.join(root, "src", "creatives", slug);
-  const definitionPath = path.join(dir, "_definition.md");
-  await mkdir(dir, { recursive: true });
-  await writeFile(path.join(dir, "prompt.json"), setSpecMessage(JSON.stringify(version.spec), idea.message), "utf8");
-  const leadDefinition = await readFile(path.join(root, "src", "creatives", lead, "_definition.md"), "utf8").catch(
-    () => "---\nkind: static\n---\n"
-  );
-  const definition = setDefinitionFields(withoutFields(leadDefinition, LEAD_ONLY), {
-    title: idea.message.slice(0, 120),
-    series: lead,
-    status: "draft",
-    ...definitionFieldsOf(idea, evidence)
-  });
-  await writeFile(definitionPath, definition, "utf8");
-  const made = await writeSeriesMemberCanvas(root, slug, { leadWords: true });
-  if (made === null || "refused" in made) {
-    return made?.refused ?? { code: "series_not_made", message: `"${slug}" could not be made in the series of "${lead}".` };
-  }
-  if (idea.status === "idea") {
-    const ideaPath = path.join(root, IDEAS_DIR, `${idea.id}.md`);
-    const raw = await readFile(ideaPath, "utf8").catch(() => null);
-    if (raw !== null) await writeFile(ideaPath, setDefinitionFields(raw, { status: "built" }), "utf8");
-  }
-  await deps.sync(dir);
-  return { slug, lead, leadRunId: version.lead.runId, canvasPath: made.canvasPath };
-}
-function seriesMadeEnvelope(made, idea) {
-  const lead = made.leadPlatforms ?? [];
-  const elsewhere = (idea.platforms ?? []).some((p) => !lead.includes(p));
-  return {
-    ok: true,
-    data: {
-      creative: made.slug,
-      idea: idea.id,
-      message: idea.message,
-      series: made.lead,
-      canvas_path: made.canvasPath
-    },
-    hints: [
-      `Write this ad's words in src/creatives/${made.slug}/prompt.json \`copy\`: one line for each of the lead's, in the same roles and about as long, saying this idea's message. Change nothing else: the picture, layout and colours are the lead's (${made.lead}), and every word you write replaces the lead's line in its place.`,
-      `When every ad of the series has its words: baker canvas run --series ${made.lead} (renders them all at once, each reviewed and corrected on its own).`,
-      ...elsewhere && lead.length > 0 ? [
-        `A series ad runs where its lead runs (${lead.join(", ")}), in its sizes; the idea names ${idea.platforms?.join(", ")}. To run it there, make it on its own: baker creatives make ${idea.id} --platforms ${idea.platforms?.join(",")}.`
-      ] : []
-    ]
-  };
-}
-
-export {
-  withoutFields,
-  makeSeriesAd,
-  seriesMadeEnvelope
-};
-//# sourceMappingURL=chunk-WJ6UJBHB.js.map

package/dist/chunk-WSYZT2QI.js

@@ -1,275 +0,0 @@
-import {
-  FLOW_ACCOUNT_ONLY_KINDS,
-  FLOW_AGENT_DESTINATION_KINDS,
-  FLOW_DELIVERY_SIDE_EFFECT_TYPES,
-  FLOW_RESOURCE_NODE_TYPES,
-  FLOW_SECRET_FIELDS,
-  flowCatalogEntry,
-  isFlowOauthSideEffect
-} from "./chunk-S47XHWFU.js";
-import {
-  apiPost
-} from "./chunk-B2OHCWYB.js";
-import {
-  writeJson
-} from "./chunk-WCIS4FZH.js";
-
-// src/commands/flows/shared.ts
-import { existsSync, readdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-var FLOWS_DIR = "src/lib/flow-engine/flows";
-function flowsDir() {
-  let dir = process.cwd();
-  for (let i = 0; i < 6; i++) {
-    const candidate = join(dir, FLOWS_DIR);
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-    const parent = join(dir, "..");
-    if (parent === dir) {
-      break;
-    }
-    dir = parent;
-  }
-  return join(process.cwd(), FLOWS_DIR);
-}
-function failLocal(message) {
-  writeJson({ ok: false, error: { code: "NOT_FOUND", message } });
-  process.exit(1);
-}
-function listFlowSlugs() {
-  const dir = flowsDir();
-  if (!existsSync(dir)) {
-    return [];
-  }
-  return readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith("_") && entry.name !== ".gitkeep").map((entry) => entry.name).sort();
-}
-function flowDataPath(slug) {
-  return join(flowsDir(), slug, "_data.json");
-}
-function writeFlowTree(slug, tree) {
-  writeFileSync(flowDataPath(slug), `${JSON.stringify(tree, null, 2)}
-`, "utf-8");
-}
-function walkNodes(node, acc = []) {
-  if (!node || typeof node !== "object") return acc;
-  acc.push(node);
-  if (Array.isArray(node.children)) {
-    for (const child of node.children) walkNodes(child, acc);
-  }
-  return acc;
-}
-function collectSideEffects(tree) {
-  return walkNodes(tree).flatMap(
-    (node) => Array.isArray(node.sideEffects) ? node.sideEffects.filter((sideEffect) => Boolean(sideEffect) && typeof sideEffect === "object").map((sideEffect) => ({ node, sideEffect })) : []
-  );
-}
-function sealedSideEffects(tree) {
-  return collectSideEffects(tree).flatMap(({ sideEffect }) => {
-    const { id, type, encryptedConfig } = sideEffect;
-    const sealed = typeof id === "string" && typeof type === "string" && FLOW_DELIVERY_SIDE_EFFECT_TYPES.includes(type) && typeof encryptedConfig === "string" && encryptedConfig.length > 0;
-    return sealed ? [{ sideEffectId: id, type, encryptedConfig }] : [];
-  });
-}
-function describeSettings(settings) {
-  if (typeof settings.email === "string") {
-    return `to ${settings.email}${typeof settings.subject === "string" ? ` \xB7 subject "${settings.subject}"` : ""}`;
-  }
-  return Object.entries(settings).filter(([, value]) => typeof value === "string" || typeof value === "number").map(([key, value]) => `${key}: ${String(value)}`).join(" \xB7 ");
-}
-function withSettings(rows, settingsById) {
-  return rows.map((row) => {
-    const settings = row.sideEffectId ? settingsById[row.sideEffectId] : void 0;
-    const described = settings ? describeSettings(settings) : "";
-    return described ? { ...row, status: `${row.status} \u2192 ${described}` } : row;
-  });
-}
-function flowExists(slug) {
-  return existsSync(join(flowsDir(), slug, "_data.json"));
-}
-function readFlowTree(slug) {
-  const path = join(flowsDir(), slug, "_data.json");
-  if (!existsSync(path)) {
-    failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
-  }
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"));
-  } catch (error) {
-    failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
-  }
-}
-function isConfigured(value) {
-  return typeof value === "string" && value.length > 0;
-}
-function nodeMeta(record) {
-  const nodeId = typeof record.id === "string" ? record.id : "";
-  const nodeName = typeof record.name === "string" ? record.name : void 0;
-  return { nodeId, ...nodeName ? { nodeName } : {} };
-}
-function widgetNodeStatus(record, meta) {
-  const nodeData = record.nodeData;
-  const nodeType = nodeData?.type;
-  if (typeof nodeType !== "string" || !FLOW_RESOURCE_NODE_TYPES.includes(nodeType)) {
-    return null;
-  }
-  const external = nodeData?.form?.external;
-  const selected = external != null && typeof external === "object";
-  const name = selected ? external.name : void 0;
-  return {
-    ...meta,
-    target: "node",
-    kind: nodeType,
-    status: selected ? `${nodeType} \u2014 selected${typeof name === "string" ? ` "${name}"` : ""}` : `${nodeType} \u2014 not selected`,
-    needsInput: !selected
-  };
-}
-function sideEffectNeedsInput(raw) {
-  const effect = raw;
-  const type = effect?.type;
-  if (typeof type !== "string" || !FLOW_DELIVERY_SIDE_EFFECT_TYPES.includes(type)) {
-    return false;
-  }
-  const configured = isConfigured(effect?.encryptedConfig);
-  if (!isFlowOauthSideEffect(type)) return !configured;
-  return !isConfigured(effect?.oauthProviderId) || !configured;
-}
-function trackingStatus(effect, type, meta) {
-  if (flowCatalogEntry("side-effect", type)?.owners?.tagIds !== "tags") return null;
-  const tags = Array.isArray(effect.tagIds) ? effect.tagIds.length : 0;
-  const event = typeof effect.eventName === "string" ? ` "${effect.eventName}"` : "";
-  return {
-    ...meta,
-    target: "sideEffect",
-    ...typeof effect.id === "string" ? { sideEffectId: effect.id } : {},
-    kind: type,
-    status: `${type}${event} \u2014 ${tags > 0 ? `[${tags} tag${tags === 1 ? "" : "s"}]` : "[no tag]"}`,
-    needsInput: false
-  };
-}
-function sideEffectStatus(raw, meta) {
-  const effect = raw;
-  const type = effect?.type;
-  if (typeof type !== "string") return null;
-  if (!FLOW_DELIVERY_SIDE_EFFECT_TYPES.includes(type)) {
-    return effect ? trackingStatus(effect, type, meta) : null;
-  }
-  const configured = isConfigured(effect?.encryptedConfig);
-  const oauth = isFlowOauthSideEffect(type);
-  const connected = isConfigured(effect?.oauthProviderId);
-  const needs = FLOW_SECRET_FIELDS[type];
-  const status = oauth ? `${type} \u2014 connection ${connected ? "[connected]" : "[needs connection]"}, config ${configured ? "[set]" : "[missing]"}` : configured ? `${type} \u2014 [configured]` : `${type} \u2014 [missing]${needs.length > 0 ? ` (needs: ${needs.join(", ")})` : ""}`;
-  return {
-    ...meta,
-    target: "sideEffect",
-    ...typeof effect?.id === "string" ? { sideEffectId: effect.id } : {},
-    kind: type,
-    status,
-    needsInput: sideEffectNeedsInput(effect)
-  };
-}
-function requestFlowInputCall(slug, status) {
-  const args = status.target === "node" ? `{ target: "node", flowSlug: "${slug}", nodeId: "${status.nodeId}", nodeType: "${status.kind}" }` : `{ target: "sideEffect", flowSlug: "${slug}", nodeId: "${status.nodeId}", sideEffectId: "${status.sideEffectId}", sideEffectType: "${status.kind}" }`;
-  const card = `request_flow_input with ${args}`;
-  const target = status.target === "node" ? `--node ${status.nodeId}` : `--side-effect ${status.sideEffectId}`;
-  const fallback = "only if nothing is connected or several could be meant";
-  if (status.kind === "email") {
-    return `baker flows connect ${slug} ${target} --email "<who receives each lead, comma-separated>" --subject "<New lead \u2014 the Form's name>"`;
-  }
-  if (status.kind === "httpWebhook") {
-    return `baker flows connect ${slug} ${target} --url <https address> \u2014 only a webhook that needs a token or password goes to the user: ${card}`;
-  }
-  if (status.kind === "hubspotForm") {
-    return `baker flows connect ${slug} ${target} --hubspot-form <formId from baker hubspot forms list> \u2014 ${fallback}: ${card}`;
-  }
-  if (status.kind === "hubspot" || status.kind === "hubspotMeeting") {
-    const list = status.kind === "hubspot" ? "forms view <id>" : "meetings view <slug>";
-    return `write \`baker hubspot ${list} --as-node\` into the step's form.external \u2014 ${fallback}: ${card}`;
-  }
-  if (FLOW_ACCOUNT_ONLY_KINDS.includes(status.kind)) {
-    return `baker flows connect ${slug} ${target} \u2014 ${fallback}: ${card}`;
-  }
-  if (FLOW_AGENT_DESTINATION_KINDS.includes(status.kind)) {
-    const sheet = status.kind === "googleSpreadsheet" ? ' (or --new-sheet "<title>" --columns "\u2026")' : "";
-    return `baker flows connect ${slug} ${target} --resource <id from baker flows options ${status.kind}>${sheet} \u2014 ${fallback}: ${card}`;
-  }
-  return card;
-}
-function collectConfigStatus(node, acc) {
-  if (!node || typeof node !== "object") {
-    return;
-  }
-  const record = node;
-  const meta = nodeMeta(record);
-  const widget = widgetNodeStatus(record, meta);
-  if (widget) {
-    acc.push(widget);
-  }
-  if (Array.isArray(record.sideEffects)) {
-    for (const raw of record.sideEffects) {
-      const status = sideEffectStatus(raw, meta);
-      if (status) {
-        acc.push(status);
-      }
-    }
-  }
-  if (Array.isArray(record.children)) {
-    for (const child of record.children) {
-      collectConfigStatus(child, acc);
-    }
-  }
-}
-function redactTree(node) {
-  if (Array.isArray(node)) {
-    return node.map(redactTree);
-  }
-  if (!node || typeof node !== "object") {
-    return node;
-  }
-  const out = {};
-  for (const [key, value] of Object.entries(node)) {
-    if (key === "encryptedConfig") {
-      out[key] = isConfigured(value) ? "[configured]" : value;
-    } else {
-      out[key] = redactTree(value);
-    }
-  }
-  return out;
-}
-function stepNameKey(name) {
-  return name.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[-\s]+/g, "_").toUpperCase();
-}
-function isUsableStepNameKey(key) {
-  return /^[\p{ID_Start}$_][\p{ID_Continue}$‌‍]*$/u.test(key);
-}
-async function readSettings(tree) {
-  const sealed = sealedSideEffects(tree);
-  if (sealed.length === 0) return {};
-  try {
-    const { data } = await apiPost("/api/flows/destinations/reveal", {
-      items: sealed.map(({ type, encryptedConfig }) => ({ type, encryptedConfig }))
-    });
-    return Object.fromEntries(sealed.map((item, index) => [item.sideEffectId, data.items[index] ?? null]));
-  } catch {
-    return null;
-  }
-}
-
-export {
-  flowsDir,
-  listFlowSlugs,
-  flowDataPath,
-  writeFlowTree,
-  walkNodes,
-  collectSideEffects,
-  withSettings,
-  flowExists,
-  readFlowTree,
-  sideEffectNeedsInput,
-  requestFlowInputCall,
-  collectConfigStatus,
-  redactTree,
-  stepNameKey,
-  isUsableStepNameKey,
-  readSettings
-};
-//# sourceMappingURL=chunk-WSYZT2QI.js.map