@koda-sl/baker-cli 0.463.0 → 0.465.0

package/dist/chunk-DKI7TGBU.js

@@ -1,159 +0,0 @@
-import {
-  failApi
-} from "./chunk-5FJB35TV.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-ZJVHZHYP.js";
-import {
-  apiPost
-} from "./chunk-TU6CHBNF.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-V2PX6XX5.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 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);
-      writeJson(withDefinitions(response, readLocalDefinition));
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-
-export {
-  definitionInsights,
-  withDefinitions,
-  parseDays,
-  performanceCommand
-};
-//# sourceMappingURL=chunk-DKI7TGBU.js.map

package/dist/chunk-DN4QLYWZ.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-ZJVHZHYP.js";
-import {
-  apiPost
-} from "./chunk-TU6CHBNF.js";
-import {
-  writeJson
-} from "./chunk-V2PX6XX5.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-DN4QLYWZ.js.map

package/dist/chunk-E2DDC5Z7.js

@@ -1,98 +0,0 @@
-import {
-  isRemoteUrl
-} from "./chunk-36TJTBOG.js";
-import {
-  detectImageContentType,
-  uploadLocalImage
-} from "./chunk-ZAFW36TU.js";
-import {
-  IMAGE_GENERATE_MODELS,
-  MODEL_REGISTRY,
-  VIDEO_GENERATE_MODELS
-} from "./chunk-CHSNHVYF.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-TU6CHBNF.js";
-
-// src/commands/studio/modelOptions.ts
-function unionOfStringEnum(node, models, param) {
-  const values = /* @__PURE__ */ new Set();
-  for (const model of models) {
-    const schema = MODEL_REGISTRY[node][model]?.params[param];
-    if (schema?.kind === "string") for (const value of schema.enum ?? []) values.add(value);
-  }
-  return [...values];
-}
-function unionOfNumberEnum(node, models, param) {
-  const values = /* @__PURE__ */ new Set();
-  for (const model of models) {
-    const schema = MODEL_REGISTRY[node][model]?.params[param];
-    if (schema?.kind === "number") for (const value of schema.enum ?? []) values.add(value);
-  }
-  return [...values].sort((a, b) => a - b);
-}
-var IMAGE_MODEL_IDS = [...IMAGE_GENERATE_MODELS];
-var VIDEO_MODEL_IDS = [...VIDEO_GENERATE_MODELS];
-var IMAGE_SIZES = unionOfStringEnum("image_generate", IMAGE_GENERATE_MODELS, "image_size");
-var IMAGE_QUALITIES = unionOfStringEnum("image_generate", IMAGE_GENERATE_MODELS, "quality");
-var CLIP_RESOLUTIONS = unionOfStringEnum("video_generate", VIDEO_GENERATE_MODELS, "resolution");
-var CLIP_DURATIONS = unionOfNumberEnum("video_generate", VIDEO_GENERATE_MODELS, "duration");
-var CLIP_PERSON_GENERATION = unionOfStringEnum("video_generate", VIDEO_GENERATE_MODELS, "person_generation");
-
-// src/commands/studio/references.ts
-var LIBRARY_ID_RE = /^[a-z0-9]{16,}$/i;
-var FILE_EXTENSION_RE = /\.[a-z0-9]{2,5}$/i;
-var PATH_HINT_RE = /[/\\]/;
-function classify(entry) {
-  if (isRemoteUrl(entry)) return { kind: "url", value: entry };
-  if (PATH_HINT_RE.test(entry) || FILE_EXTENSION_RE.test(entry)) return { kind: "path", value: entry };
-  if (LIBRARY_ID_RE.test(entry)) return { kind: "id", value: entry };
-  throw new ApiError(
-    "VALIDATION_ERROR",
-    `"${entry}" is not a library image id, a file path, or an image URL. Pass a comma-separated mix of those.`
-  );
-}
-function parseImageRefs(spec) {
-  return spec.split(",").map((entry) => entry.trim()).filter(Boolean).map(classify);
-}
-var defaultDeps = {
-  ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path) => uploadLocalImage({ file: path, contentType: detectImageContentType(path), source: "uploaded" })
-};
-async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
-  const refs = parseImageRefs(spec);
-  if (limit && refs.length > limit.max) {
-    throw new ApiError("VALIDATION_ERROR", limit.refuse(refs.length));
-  }
-  const imageIds = [];
-  const added = [];
-  for (const ref of refs) {
-    if (ref.kind === "id") {
-      imageIds.push(ref.value);
-      continue;
-    }
-    const { imageId } = ref.kind === "url" ? await deps.ingest(ref.value) : await deps.upload(ref.value).catch(uploadFailure(ref.value));
-    imageIds.push(imageId);
-    added.push(imageId);
-  }
-  return { imageIds, added };
-}
-function uploadFailure(path) {
-  return (error) => {
-    if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path}" as an image.`);
-  };
-}
-
-export {
-  IMAGE_MODEL_IDS,
-  VIDEO_MODEL_IDS,
-  IMAGE_SIZES,
-  IMAGE_QUALITIES,
-  CLIP_RESOLUTIONS,
-  CLIP_DURATIONS,
-  CLIP_PERSON_GENERATION,
-  resolveLibraryImageIds
-};
-//# sourceMappingURL=chunk-E2DDC5Z7.js.map