@koda-sl/baker-cli 0.567.0 → 0.569.0

package/dist/chunk-H3PD2KOF.js

@@ -1,203 +0,0 @@
-import {
-  ACTION_TEMP_ID_PREFIX
-} from "./chunk-LXOTNL65.js";
-import {
-  ApiError
-} from "./chunk-QEREDRZO.js";
-import {
-  MissingChatIdError
-} from "./chunk-45D6WRCJ.js";
-import {
-  writeJson
-} from "./chunk-CCYZJMZ7.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-H3PD2KOF.js.map

package/dist/chunk-ILGRC7LJ.js

@@ -1,287 +0,0 @@
-import {
-  failWriteValidation,
-  parseDateFlag,
-  parseMoneyFlag
-} from "./chunk-UYZ4FUC7.js";
-import {
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-
-// src/commands/ads/meta/delivery-flags.ts
-function text(value) {
-  return typeof value === "string" && value.length > 0 ? value : void 0;
-}
-function frequencyCapFlag(value) {
-  const raw = text(value);
-  if (raw === void 0) {
-    return void 0;
-  }
-  const match = /^(\d+)\s*\/\s*(\d+)\s*d?$/i.exec(raw.trim());
-  if (!match) {
-    failWriteValidation(
-      `--frequency-cap takes N/D \u2014 at most N impressions per person every D days, e.g. 2/7 (got "${raw}")`
-    );
-  }
-  return [{ event: "IMPRESSIONS", interval_days: Number(match[2]), max_frequency: Number(match[1]) }];
-}
-var DAY_INDEX = { sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6 };
-function dayIndex(name, flag) {
-  const index = DAY_INDEX[name.slice(0, 3).toLowerCase()];
-  if (index === void 0) {
-    failWriteValidation(`${flag}: "${name}" is not a day \u2014 use Mon, Tue, \u2026 Sun`);
-  }
-  return index;
-}
-function scheduleDays(spec) {
-  if (/^(daily|every ?day|all)$/i.test(spec)) {
-    return [0, 1, 2, 3, 4, 5, 6];
-  }
-  return spec.split(",").flatMap((part) => {
-    const [from, to] = part.split("-").map((day) => day.trim());
-    if (!from) {
-      return [];
-    }
-    const start = dayIndex(from, "--schedule");
-    if (!to) {
-      return [start];
-    }
-    const end = dayIndex(to, "--schedule");
-    const days = [];
-    for (let day = start; days.length < 7; day = (day + 1) % 7) {
-      days.push(day);
-      if (day === end) break;
-    }
-    return days;
-  });
-}
-function hourMinute(value) {
-  const [hours = "", minutes = "0"] = value.split(":");
-  return Number(hours) * 60 + Number(minutes);
-}
-function scheduleBlock(raw, timezone) {
-  const match = /^(.+?)\s+(\d{1,2}(?::\d{2})?)\s*-\s*(\d{1,2}(?::\d{2})?)$/.exec(raw.trim());
-  if (!match?.[1] || !match[2] || !match[3]) {
-    failWriteValidation(
-      `--schedule takes "<days> <from>-<to>", e.g. "Mon-Fri 09-18" or "sat,sun 10:00-14:00" (got "${raw}")`
-    );
-  }
-  return {
-    days: scheduleDays(match[1]),
-    start_minute: hourMinute(match[2]),
-    end_minute: hourMinute(match[3]),
-    timezone_type: timezone
-  };
-}
-function dayPartingFromFlags(args, rawArgs) {
-  const blocks = repeatedValues(rawArgs, "schedule", args.schedule).map((block) => {
-    const { timezone_type: _clock, ...rest } = scheduleBlock(block, "USER");
-    return rest;
-  });
-  return blocks.length > 0 ? blocks : void 0;
-}
-function scheduleTimezone(value) {
-  const raw = text(value)?.toLowerCase();
-  if (raw === void 0 || raw === "viewer" || raw === "user") {
-    return "USER";
-  }
-  if (raw === "account" || raw === "advertiser") {
-    return "ADVERTISER";
-  }
-  failWriteValidation(`--schedule-timezone takes viewer or account (got "${raw}")`);
-}
-var ATTRIBUTION_EVENTS = {
-  click: "CLICK_THROUGH",
-  view: "VIEW_THROUGH",
-  engaged_view: "ENGAGED_VIDEO_VIEW",
-  engaged_video_view: "ENGAGED_VIDEO_VIEW"
-};
-function attributionFlag(value) {
-  const raw = text(value);
-  if (raw === void 0) {
-    return void 0;
-  }
-  return raw.split(",").map((window) => {
-    const match = /^(\d+)d_([a-z_]+)$/i.exec(window.trim());
-    const event = match?.[2] ? ATTRIBUTION_EVENTS[match[2].toLowerCase()] : void 0;
-    if (!match || !event) {
-      failWriteValidation(`--attribution takes windows like 7d_click,1d_view,1d_engaged_view (got "${window}")`);
-    }
-    return { event_type: event, window_days: Number(match[1]) };
-  });
-}
-function numberArg(value, flag) {
-  const raw = text(value);
-  if (raw === void 0) {
-    return void 0;
-  }
-  const n = Number(raw);
-  if (!Number.isFinite(n)) {
-    failWriteValidation(`${flag} must be a number`);
-  }
-  return n;
-}
-function adSetDeliveryFromFlags(args, rawArgs) {
-  const timezone = scheduleTimezone(args["schedule-timezone"]);
-  const blocks = repeatedValues(rawArgs, "schedule", args.schedule).map((block) => scheduleBlock(block, timezone));
-  if (args["schedule-timezone"] !== void 0 && blocks.length === 0) {
-    failWriteValidation(
-      "--schedule-timezone says whose clock --schedule follows, so it goes with --schedule \u2014 pass the hours again with it"
-    );
-  }
-  const delivery = {
-    minRoas: numberArg(args["min-roas"], "--min-roas"),
-    frequency_control_specs: frequencyCapFlag(args["frequency-cap"]),
-    adset_schedule: blocks.length > 0 ? blocks : void 0,
-    pacing: text(args.pacing)?.toLowerCase(),
-    dailyMinSpendTarget: parseMoneyFlag(args["daily-min-spend"], args.currency, "--daily-min-spend"),
-    dailySpendCap: parseMoneyFlag(args["daily-spend-cap"], args.currency, "--daily-spend-cap"),
-    lifetimeMinSpendTarget: parseMoneyFlag(args["lifetime-min-spend"], args.currency, "--lifetime-min-spend"),
-    lifetimeSpendCap: parseMoneyFlag(args["lifetime-spend-cap"], args.currency, "--lifetime-spend-cap"),
-    is_dynamic_creative: args["dynamic-creative"] === void 0 ? void 0 : Boolean(args["dynamic-creative"]),
-    attribution_spec: attributionFlag(args.attribution)
-  };
-  return Object.fromEntries(Object.entries(delivery).filter(([, value]) => value !== void 0));
-}
-function budgetBoost(raw, currency) {
-  const match = /^(.+?)\.\.(.+?)=\+?(\d+(?:\.\d{1,3})?)(%?)$/.exec(raw.trim());
-  if (!match?.[1] || !match[2] || !match[3]) {
-    failWriteValidation(
-      `--budget-boost takes START..END=+AMOUNT or START..END=+PERCENT%, e.g. 2027-11-27T00:00Z..2027-11-28T00:00Z=+50% (got "${raw}")`
-    );
-  }
-  const period = {
-    time_start: parseDateFlag(match[1], "--budget-boost start"),
-    time_end: parseDateFlag(match[2], "--budget-boost end")
-  };
-  return match[4] === "%" ? { ...period, increasePercent: Number(match[3]) } : { ...period, increase: parseMoneyFlag(match[3], currency, "--budget-boost") };
-}
-function budgetBoostsFromFlags(args, rawArgs) {
-  const boosts = repeatedValues(rawArgs, "budget-boost", args["budget-boost"]);
-  return boosts.length > 0 ? boosts.map((boost) => budgetBoost(boost, args.currency)) : void 0;
-}
-function boostMove(raw) {
-  const match = /^(\d+)=(.+?)\.\.(.+)$/.exec(raw.trim());
-  if (!match?.[1] || !match[2] || !match[3]) {
-    failWriteValidation(
-      `--move-boost takes ID=START..END, e.g. 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z (got "${raw}")`
-    );
-  }
-  return {
-    id: match[1],
-    time_start: parseDateFlag(match[2], "--move-boost start"),
-    time_end: parseDateFlag(match[3], "--move-boost end")
-  };
-}
-function boostEditsFromFlags(args, rawArgs) {
-  const removed = repeatedValues(rawArgs, "remove-boost", args["remove-boost"]).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean);
-  const moved = repeatedValues(rawArgs, "move-boost", args["move-boost"]);
-  return {
-    ...removed.length > 0 ? { removeBoosts: removed } : {},
-    ...moved.length > 0 ? { moveBoosts: moved.map(boostMove) } : {}
-  };
-}
-var boostEditArgs = {
-  "remove-boost": {
-    type: "string",
-    description: "Take one budget boost away, by its id from `baker ads meta high-demand-periods --campaign-id <id>` \u2014 repeatable or comma-separated. The others stay."
-  },
-  "move-boost": {
-    type: "string",
-    description: "Move one budget boost to another window, keeping its raise: ID=START..END, repeatable, at least 3 hours, on quarter hours. Meta has no boost update, so publish adds the same raise on the new window, then deletes the old boost. Example: --move-boost 1633135568548763=2027-11-27T06:00Z..2027-11-27T12:00Z"
-  }
-};
-var adSetDeliveryArgs = {
-  "min-roas": {
-    type: "string",
-    description: "Minimum ROAS for LOWEST_COST_WITH_MIN_ROAS bidding, as a multiple of spend: 2.5 = 250%. Needs --optimization-goal VALUE. Under a min-ROAS campaign budget every ad set needs its own. Example: --bid-strategy LOWEST_COST_WITH_MIN_ROAS --min-roas 2.5"
-  },
-  "frequency-cap": {
-    type: "string",
-    description: "At most N impressions per person every D days, as N/D \u2014 REACH and THRUPLAY goals only. Example: --frequency-cap 2/7"
-  },
-  schedule: {
-    type: "string",
-    description: 'Run ads only in these hours (dayparting), repeatable: "<days> <from>-<to>", whole hours. Needs --lifetime-budget and --end. Example: --schedule "Mon-Fri 09-18" --schedule "Sat 10-14"'
-  },
-  "schedule-timezone": {
-    type: "string",
-    description: "Whose clock --schedule follows: viewer (default) or account"
-  },
-  pacing: {
-    type: "string",
-    description: "standard (default) | no_pacing (accelerated \u2014 spends as fast as it can; LOWEST_COST_WITH_BID_CAP only) | day_parting (set by --schedule)"
-  },
-  "daily-min-spend": {
-    type: "string",
-    description: "Ad set spend limit under a DAILY campaign budget: spend at least this per day (best effort)"
-  },
-  "daily-spend-cap": {
-    type: "string",
-    description: "Ad set spend limit under a DAILY campaign budget: spend at most this per day. Example: --daily-spend-cap 15"
-  },
-  "lifetime-min-spend": {
-    type: "string",
-    description: "Ad set spend limit under a LIFETIME campaign budget: spend at least this in total"
-  },
-  "lifetime-spend-cap": {
-    type: "string",
-    description: "Ad set spend limit under a LIFETIME campaign budget: spend at most this in total"
-  },
-  attribution: {
-    type: "string",
-    description: "Attribution windows Meta optimizes on: 1d_click or 7d_click, plus 1d_view and/or 1d_engaged_view \u2014 conversion goals only; LINK_CLICKS, LANDING_PAGE_VIEWS and REACH take 1d_click alone. Fixed when the ad set is created: Meta refuses a change on a live ad set. Example: --attribution 7d_click,1d_view"
-  }
-};
-var budgetBoostArg = {
-  "budget-boost": {
-    type: "string",
-    description: "Raise the daily budget for a high-demand period, repeatable: START..END=+AMOUNT or START..END=+PERCENT% (max 800%), at least 3 hours, on quarter hours, all amounts or all percentages. Needs --daily-budget in the same command (the current one, on update). Example: --budget-boost 2027-11-27T00:00Z..2027-11-28T00:00Z=+50%"
-  }
-};
-var CLEAR_FLAGS = {
-  "daily-min-spend": "dailyMinSpendTarget",
-  "daily-spend-cap": "dailySpendCap",
-  "lifetime-min-spend": "lifetimeMinSpendTarget",
-  "lifetime-spend-cap": "lifetimeSpendCap",
-  schedule: "adset_schedule",
-  boosts: "budgetSchedules",
-  "budget-boost": "budgetSchedules"
-};
-var NOT_CLEARABLE = {
-  "min-roas": "a ROAS floor goes with ROAS goal bidding \u2014 switch --bid-strategy (e.g. LOWEST_COST_WITHOUT_CAP) and Baker drops the floor",
-  "frequency-cap": "Meta keeps a frequency cap on a reach ad set whatever is sent (an empty cap is accepted and ignored) \u2014 set another with --frequency-cap"
-};
-function clearFromFlags(rawArgs, entity) {
-  const names = repeatedValues(rawArgs, "clear", void 0).flatMap((value) => value.split(",")).map((value) => value.trim().toLowerCase()).filter(Boolean);
-  if (names.length === 0) return void 0;
-  const fields = names.map((name) => {
-    const why = NOT_CLEARABLE[name];
-    if (why) throw new Error(`--clear ${name}: ${why}`);
-    const field = CLEAR_FLAGS[name];
-    if (!field || entity === "campaign" && field !== "budgetSchedules") {
-      const takes = entity === "campaign" ? "boosts" : Object.keys(CLEAR_FLAGS).join(", ");
-      throw new Error(`--clear takes ${takes} \u2014 not "${name}"`);
-    }
-    return field;
-  });
-  return [...new Set(fields)];
-}
-var clearArg = {
-  clear: {
-    type: "string",
-    description: "Take a delivery control away (repeatable or comma-separated): daily-min-spend, daily-spend-cap, lifetime-min-spend, lifetime-spend-cap, schedule (back to standard pacing), boosts (every budget boost it has now). A ROAS floor goes by switching --bid-strategy; Meta keeps a reach ad set's frequency cap."
-  }
-};
-
-export {
-  dayPartingFromFlags,
-  adSetDeliveryFromFlags,
-  budgetBoostsFromFlags,
-  boostEditsFromFlags,
-  boostEditArgs,
-  adSetDeliveryArgs,
-  budgetBoostArg,
-  clearFromFlags,
-  clearArg
-};
-//# sourceMappingURL=chunk-ILGRC7LJ.js.map