@koda-sl/baker-cli 0.503.0 → 0.505.0-dev.eb0521917

package/dist/chunk-2VPNX7EZ.js

@@ -1,203 +0,0 @@
-import {
-  ACTION_TEMP_ID_PREFIX
-} from "./chunk-JDJQKN27.js";
-import {
-  ApiError
-} from "./chunk-X7VQFLHI.js";
-import {
-  MissingChatIdError
-} from "./chunk-LGK7UWBN.js";
-import {
-  writeJson
-} from "./chunk-Q7US4OOA.js";
-
-// src/commands/actions/tagError.ts
-var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
-function splitSlugs(list) {
-  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
-}
-function actionTagFix(message) {
-  const match = UNKNOWN_TAG_RE.exec(message);
-  if (!match) {
-    return null;
-  }
-  const [, unknownList, validList] = match;
-  const unknownTags = splitSlugs(unknownList ?? "");
-  const validTags = splitSlugs(validList ?? "");
-  const first = unknownTags[0];
-  if (first === void 0 || validTags.length === 0) {
-    return null;
-  }
-  return {
-    action: "retry_with_a_valid_tag",
-    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
-    unknownTags,
-    validTags,
-    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
-    listCommand: "baker actions tags list"
-  };
-}
-
-// src/commands/actions/shared.ts
-function writeOk(data) {
-  writeJson({ ok: true, data: data ?? null });
-}
-function failValidation(message) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function apiFailure(err) {
-  if (err instanceof ApiError) {
-    const fix = err.fix ?? actionTagFix(err.message);
-    return { ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } };
-  }
-  if (err instanceof MissingChatIdError) {
-    const explanation = "This command stages its change on the chat this run belongs to, and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here.";
-    return { ok: false, error: { code: err.code, message: err.message, fix: { action: "reject", explanation } } };
-  }
-  return {
-    ok: false,
-    error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
-  };
-}
-function failApi(err) {
-  writeJson(apiFailure(err));
-  process.exit(1);
-}
-function generateTempId() {
-  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-function isTempId(id) {
-  return id.startsWith(ACTION_TEMP_ID_PREFIX);
-}
-function parseTagList(value) {
-  if (typeof value !== "string") {
-    return void 0;
-  }
-  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
-  return [...new Set(tags)];
-}
-var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
-function parsePriority(value, { allowClear }) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (typeof value !== "string") {
-    failValidation(
-      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
-    );
-  }
-  const trimmed = value.trim().toLowerCase();
-  if (trimmed === "") {
-    if (allowClear) {
-      return null;
-    }
-    return void 0;
-  }
-  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
-    return null;
-  }
-  if (ACTION_PRIORITIES.includes(trimmed)) {
-    return trimmed;
-  }
-  failValidation(
-    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
-  );
-}
-var FAN_OUT_NUDGE_THRESHOLD = 2;
-var FAN_OUT_THRESHOLD = 3;
-function buildCreateHints({
-  advisory,
-  name,
-  description,
-  tempId,
-  tags,
-  prioritySet,
-  draftCreateCount
-}) {
-  const hints = [];
-  const expanded = shellExpandedIn(`${name}
-${description}`);
-  if (expanded) {
-    hints.push(
-      `The text says \u201C${expanded}\u201D: the shell replaced a $ amount (like $0) inside double quotes before Baker saw it. Fix it now: baker actions update ${tempId} --description '<the text, with the amounts as you read them>' (and --name '\u2026' if the name has it) \u2014 single quotes keep $ as written.`
-    );
-  }
-  if (advisory) {
-    hints.push(
-      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
-    );
-  }
-  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
-    hints.push(
-      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
-    );
-  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
-    hints.push(
-      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
-    );
-  }
-  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
-  if (!description) {
-    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
-  }
-  if (!tags || tags.length === 0) {
-    hints.push(
-      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
-    );
-  }
-  if (!prioritySet) {
-    hints.push(
-      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
-    );
-  }
-  return hints;
-}
-var SHELL_PATH = /(?:^|[\s(])((?:\/usr)?\/bin\/(?:ba|z|da|k)?sh|-(?:ba|z|da|k)sh)\b/;
-var MONEY_WORD = "spend|spent|spending|budget|revenue|sales|cost|costs|cpa|cpc|cpm|cpl|roas|profit|paid|earned";
-var BARE_SHELL = new RegExp(
-  `(?:\\b(?:${MONEY_WORD}|at|to|from|was|were|is)\\s+(bash|zsh)\\b|(?:^|[\\s(])(bash|zsh)(?=\\.\\d|\\s+(?:${MONEY_WORD})\\b))`,
-  "gi"
-);
-function shellExpandedIn(text) {
-  const path = SHELL_PATH.exec(text)?.[1];
-  if (path) return path;
-  for (const match of text.matchAll(BARE_SHELL)) {
-    const name = match[1] ?? match[2];
-    if (name && name === name.toLowerCase()) return name;
-  }
-  return null;
-}
-var ACTIONS_LIST_DEFAULT_LIMIT = 500;
-function buildListHints({ returned, limit }) {
-  if (returned < limit) {
-    return [];
-  }
-  return [
-    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
-  ];
-}
-function buildGetHints(detail) {
-  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
-    return [];
-  }
-  return [
-    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
-  ];
-}
-
-export {
-  writeOk,
-  failValidation,
-  failApi,
-  generateTempId,
-  isTempId,
-  parseTagList,
-  ACTION_PRIORITIES,
-  parsePriority,
-  buildCreateHints,
-  ACTIONS_LIST_DEFAULT_LIMIT,
-  buildListHints,
-  buildGetHints
-};
-//# sourceMappingURL=chunk-2VPNX7EZ.js.map

package/dist/chunk-2WCAGWVZ.js

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