@koda-sl/baker-cli 0.540.0 → 0.541.0-dev.b27330e67

package/dist/chunk-35T6LCB2.js

@@ -1,197 +0,0 @@
-import {
-  mediaTagsCreateRequestSchema,
-  mediaTagsDeleteRequestSchema,
-  mediaTagsUpdateRequestSchema
-} from "./chunk-UREDSNQS.js";
-import {
-  ApiError,
-  apiGet,
-  apiPost
-} from "./chunk-C35UMKYG.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-TRXGJZDL.js";
-
-// src/lib/tags-command.ts
-import { defineCommand } from "citty";
-var OUTPUT_ARG = {
-  output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
-};
-var SHARED_POOL_HINT = "Custom tags are one pool shared by images, videos and testimonials \u2014 this change shows up in all three. Already applied: publishing or discarding this chat does not undo it.";
-function fail(err) {
-  const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
-  const message = err instanceof ApiError ? err.message : "Unexpected error";
-  writeJson({ ok: false, error: { code, message } });
-  process.exit(1);
-}
-function failInvalid(issue) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: issue?.message ?? "Invalid request" } });
-  process.exit(1);
-}
-function makeTagsCommand(command, label, endpoint) {
-  registerSchema({
-    command: `${command}.tags.list`,
-    description: `List the available ${label} tag taxonomy (built-in defaults + this company's custom tags).`,
-    args: OUTPUT_ARG
-  });
-  const listCommand = defineCommand({
-    meta: {
-      name: "list",
-      description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
-    },
-    args: OUTPUT_ARG,
-    run: async ({ args }) => {
-      try {
-        const { markdown } = await apiGet(endpoint);
-        if (args.output === "json") {
-          writeJson({ ok: true, data: { markdown } });
-          return;
-        }
-        process.stdout.write(`${markdown.trimEnd()}
-`);
-      } catch (err) {
-        const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
-        const message = err instanceof ApiError ? err.message : "Unexpected error";
-        if (args.output === "json") {
-          writeJson({ ok: false, error: { code, message } });
-        } else {
-          process.stderr.write(`Error: ${message}
-`);
-        }
-        process.exit(1);
-      }
-    }
-  });
-  const createArgs = {
-    name: { type: "positional", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
-    description: {
-      type: "string",
-      description: "What the tag means, so it gets applied consistently",
-      required: false
-    }
-  };
-  registerSchema({
-    command: `${command}.tags.create`,
-    description: "Create a custom media tag in the company's shared pool (images, videos and testimonials). Applies immediately. Use when no built-in or custom tag fits.",
-    args: {
-      name: { type: "string", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
-      description: createArgs.description
-    }
-  });
-  const createCommand = defineCommand({
-    meta: {
-      name: "create",
-      description: `Create a custom tag (shared by images, videos and testimonials). Applies immediately.
-
-Example: baker ${command} tags create "summer sale" --description "Assets for the summer sale campaign"`
-    },
-    args: createArgs,
-    run: async ({ args }) => {
-      const parsed = mediaTagsCreateRequestSchema.safeParse({
-        name: String(args.name ?? ""),
-        ...args.description ? { description: String(args.description) } : {}
-      });
-      if (!parsed.success) failInvalid(parsed.error.issues[0]);
-      try {
-        const data = await apiPost("/api/media-tags/create", parsed.data);
-        writeJson({
-          ok: true,
-          data,
-          hints: [
-            SHARED_POOL_HINT,
-            `Use it as \`--tags ${data.name}\`.`,
-            ...data.description ? [] : ["MISSING --description: add one with `tags update` so the tag is applied consistently."]
-          ]
-        });
-      } catch (err) {
-        fail(err);
-      }
-    }
-  });
-  registerSchema({
-    command: `${command}.tags.update`,
-    description: "Change what a custom tag means (its description). Built-in tags cannot be changed. Applies immediately.",
-    args: {
-      slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true },
-      description: { type: "string", description: "New description", required: true }
-    }
-  });
-  const updateCommand = defineCommand({
-    meta: {
-      name: "update",
-      description: `Change a custom tag's description. Built-in tags cannot be changed. Applies immediately.
-
-Example: baker ${command} tags update summer-sale --description "Assets for the 2026 summer sale"`
-    },
-    args: {
-      slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true },
-      description: { type: "string", description: "New description", required: true }
-    },
-    run: async ({ args }) => {
-      const parsed = mediaTagsUpdateRequestSchema.safeParse({
-        slug: String(args.slug ?? ""),
-        description: String(args.description ?? "")
-      });
-      if (!parsed.success) failInvalid(parsed.error.issues[0]);
-      try {
-        const data = await apiPost("/api/media-tags/update", parsed.data);
-        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
-      } catch (err) {
-        fail(err);
-      }
-    }
-  });
-  registerSchema({
-    command: `${command}.tags.delete`,
-    description: "Delete a custom tag from the company's shared pool. Built-in tags cannot be deleted. Applies immediately. Confirm with the user first.",
-    args: { slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true } }
-  });
-  const deleteCommand = defineCommand({
-    meta: {
-      name: "delete",
-      description: `Delete a custom tag (shared by images, videos and testimonials). Built-in tags cannot be deleted. Applies immediately \u2014 confirm with the user first.
-
-Example: baker ${command} tags delete summer-sale`
-    },
-    args: { slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true } },
-    run: async ({ args }) => {
-      const parsed = mediaTagsDeleteRequestSchema.safeParse({ slug: String(args.slug ?? "") });
-      if (!parsed.success) failInvalid(parsed.error.issues[0]);
-      try {
-        const data = await apiPost("/api/media-tags/delete", parsed.data);
-        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
-      } catch (err) {
-        fail(err);
-      }
-    }
-  });
-  return defineCommand({
-    meta: {
-      name: "tags",
-      description: `The ${label} tag taxonomy: built-in defaults plus the company's custom tags (one pool shared by images, videos and testimonials). Subcommands: list (default), create, update, delete.
-
-Examples:
-  baker ${command} tags                                   # list available tags
-  baker ${command} tags create "summer sale" --description "\u2026"
-  baker ${command} tags update summer-sale --description "\u2026"
-  baker ${command} tags delete summer-sale`
-    },
-    // Declared on the parent too: `default: "list"` dispatches the bare `tags --output json`
-    // form, and citty reads an undeclared flag's value as a subcommand name.
-    args: OUTPUT_ARG,
-    subCommands: {
-      list: listCommand,
-      create: createCommand,
-      update: updateCommand,
-      delete: deleteCommand
-    },
-    // `default`, never `run`: citty falls through to the parent's `run` after a subcommand.
-    default: "list"
-  });
-}
-
-export {
-  makeTagsCommand
-};
-//# sourceMappingURL=chunk-35T6LCB2.js.map

package/dist/chunk-3RWSYI6N.js

@@ -1,63 +0,0 @@
-import {
-  sheetDelimiter,
-  targetAccountsFrom
-} from "./chunk-HHQYP6RM.js";
-
-// src/commands/accounts/targets.ts
-import { parse } from "csv-parse/sync";
-var COLUMN_OF_HEADER = {
-  domain: "domain",
-  website: "domain",
-  url: "domain",
-  companydomain: "domain",
-  companywebsite: "domain",
-  name: "name",
-  company: "name",
-  companyname: "name",
-  account: "name",
-  accountname: "name",
-  tier: "tier"
-};
-var headerKey = (header) => header.toLowerCase().replace(/[\s_-]+/g, "");
-function csvEntries(text) {
-  const rows = parse(text, {
-    bom: true,
-    columns: true,
-    delimiter: sheetDelimiter(text),
-    skip_empty_lines: true,
-    relax_column_count: true,
-    trim: true
-  });
-  const columns = Object.keys(rows[0] ?? {}).flatMap((header) => {
-    const field = COLUMN_OF_HEADER[headerKey(header)];
-    return field ? [[header, field]] : [];
-  });
-  if (!columns.some(([, field]) => field === "domain")) {
-    throw new Error(
-      `The file has no domain column (found: ${Object.keys(rows[0] ?? {}).join(", ") || "nothing"}). Name one "domain" or "website".`
-    );
-  }
-  return rows.map((row) => {
-    const entry = {};
-    for (const [header, field] of columns) entry[field] ??= row[header] ?? "";
-    return entry;
-  });
-}
-function jsonEntries(text) {
-  const parsed = JSON.parse(text);
-  if (!Array.isArray(parsed)) {
-    throw new Error('The JSON file must be an array: ["acme.com", \u2026] or [{"domain": "acme.com", "tier": 1}, \u2026].');
-  }
-  return parsed.map(
-    (item) => typeof item === "string" ? { domain: item } : typeof item === "object" && item !== null ? item : {}
-  );
-}
-function readTargetsFile(path, text) {
-  const entries = path.toLowerCase().endsWith(".json") ? jsonEntries(text) : csvEntries(text);
-  return targetAccountsFrom(entries);
-}
-
-export {
-  readTargetsFile
-};
-//# sourceMappingURL=chunk-3RWSYI6N.js.map

package/dist/chunk-3V4R55B4.js

@@ -1,163 +0,0 @@
-import {
-  failApi
-} from "./chunk-EPW33OQJ.js";
-import {
-  CREATIVE_PERFORMANCE_DEFAULT_DAYS,
-  CREATIVE_PERFORMANCE_MAX_DAYS
-} from "./chunk-UREDSNQS.js";
-import {
-  apiPost
-} from "./chunk-C35UMKYG.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-TRXGJZDL.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-3V4R55B4.js.map

package/dist/chunk-3YHOU5IA.js

@@ -1,169 +0,0 @@
-import {
-  parseXApiError
-} from "./chunk-FIN4ZXGJ.js";
-import {
-  resolveXAccountId
-} from "./chunk-B52GKPH2.js";
-import {
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-EAHBTBVR.js";
-import {
-  X_DRAFT_BATCH_MAX,
-  xDraftOpInputSchema
-} from "./chunk-UREDSNQS.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-C35UMKYG.js";
-import {
-  requireChatId
-} from "./chunk-LBIF6FJY.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-3YHOU5IA.js.map