@koda-sl/baker-cli 0.501.0-dev.6e96f50b9 → 0.502.0

package/dist/rules-R47FOFVB.js

@@ -0,0 +1,217 @@
+import {
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-B2POVFR2.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/rules.ts
+import { defineCommand } from "citty";
+function compactRule(row) {
+  return {
+    id: row.id,
+    name: row.name,
+    status: row.status,
+    does: row.description,
+    ...row.disable_error_code ? { disable_error_code: row.disable_error_code } : {},
+    updated_time: row.updated_time
+  };
+}
+function ruleListHints(rows) {
+  const hints = [];
+  if (rows.length === 0) {
+    hints.push(
+      'No automated rules on this account. Stage one with `baker ads meta rules create --name \u2026 --apply-to ad --when "cost_per_result>20" --action pause`.'
+    );
+  }
+  const issues = rows.filter((row) => row.status === "HAS_ISSUES");
+  if (issues.length > 0) {
+    hints.push(
+      `${issues.map((row) => row.name ?? row.id).join(", ")} ${issues.length === 1 ? "has" : "have"} been stopped by Meta (HAS_ISSUES) \u2014 read it with --rule-id and fix the spec with \`rules update\`.`
+    );
+  }
+  if (rows.length > 0) {
+    hints.push(
+      "`rules history --rule-id <id>` shows what a rule did and when; `rules preview <id>` what it would act on now."
+    );
+  }
+  return hints;
+}
+registerSchema({
+  command: "ads.meta.rules",
+  description: "List the automated rules on a Meta ad account (Ads Manager \u2192 Automated rules): each rule's status and what it does, in words. --rule-id reads one; --full adds its evaluation_spec, execution_spec and schedule_spec in the shape `rules update --file` takes (money in major units of the account currency).",
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    "rule-id": { type: "string", description: "Read one rule", required: false },
+    full: { type: "boolean", description: "Include the specs and timestamps", required: false }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List automated rules. Runs by default. Example: baker ads meta rules --account-id act_123 \xB7 one rule in full: baker ads meta rules --rule-id 1132635173044914 --full"
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID" },
+    "rule-id": { type: "string", description: "Read one rule" },
+    full: { type: "boolean", description: "Include the specs and timestamps" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["rule-id"]) params["rule-id"] = String(args["rule-id"]);
+      const rows = await apiGet("/api/ads/meta/rules", params);
+      const full = Boolean(args.full) || Boolean(args["rule-id"]);
+      writeJsonEnvelope({ ok: true, data: full ? rows : rows.map(compactRule), hints: ruleListHints(rows) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+function compactHistory(row) {
+  const changes = (row.results ?? []).flatMap(
+    (result) => (result.actions ?? []).map((action) => ({
+      object_id: result.object_id,
+      action: action.action,
+      ...action.field ? { field: action.field } : {},
+      ...action.old_value !== void 0 ? { from: action.old_value } : {},
+      ...action.new_value !== void 0 ? { to: action.new_value } : {}
+    }))
+  );
+  return {
+    timestamp: row.timestamp,
+    rule_id: row.rule_id,
+    ...row.is_manual ? { manual: true } : {},
+    changes,
+    ...row.exception_message ? { error: row.exception_message } : {}
+  };
+}
+registerSchema({
+  command: "ads.meta.rules.history",
+  description: "What automated rules did and when: each run with the objects it changed (PAUSED, CHANGED_BUDGET, \u2026, old \u2192 new value). Without --rule-id, every rule on the account, newest first.",
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    "rule-id": { type: "string", description: "One rule's runs", required: false },
+    "object-id": { type: "string", description: "Only runs that touched this ad, ad set or campaign", required: false },
+    action: { type: "string", description: "Only this action, e.g. PAUSED, CHANGED_BUDGET", required: false },
+    "hide-no-changes": { type: "boolean", description: "Drop runs that changed nothing", required: false },
+    limit: { type: "string", description: "Max runs (default 50)", required: false },
+    full: { type: "boolean", description: "Include the rule's specs at each run", required: false }
+  }
+});
+var historyCommand = defineCommand({
+  meta: {
+    name: "history",
+    description: "What rules did and when. Example: baker ads meta rules history --rule-id 1132635173044914 --hide-no-changes \xB7 every rule: baker ads meta rules history --account-id act_123"
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID" },
+    "rule-id": { type: "string", description: "One rule's runs" },
+    "object-id": { type: "string", description: "Only runs that touched this object" },
+    action: { type: "string", description: "Only this action (PAUSED, CHANGED_BUDGET, \u2026)" },
+    "hide-no-changes": { type: "boolean", description: "Drop runs that changed nothing" },
+    limit: { type: "string", description: "Max runs (default 50)" },
+    full: { type: "boolean", description: "Include the rule's specs at each run" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      for (const key of ["rule-id", "object-id", "action", "limit"]) {
+        if (args[key]) params[key] = String(args[key]);
+      }
+      if (args["hide-no-changes"]) params["hide-no-changes"] = "true";
+      const rows = await apiGet("/api/ads/meta/rules/history", params);
+      const hints = rows.length === 0 ? [
+        "No runs recorded. A daily rule first runs just after midnight in the ad account's time zone; a switched-off rule never runs."
+      ] : [];
+      writeJsonEnvelope({ ok: true, data: args.full ? rows : rows.map(compactHistory), hints });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.rules.preview",
+  description: "Which ads, ad sets or campaigns a live schedule rule would act on right now, by Meta's own evaluation. Changes nothing.",
+  args: {
+    id: { type: "positional", description: "Rule id", required: true },
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false }
+  }
+});
+var previewCommand = defineCommand({
+  meta: {
+    name: "preview",
+    description: "What a rule would act on right now (changes nothing). Example: baker ads meta rules preview 1132635173044914"
+  },
+  args: {
+    id: { type: "positional", description: "Rule id", required: true },
+    "account-id": { type: "string", description: "Meta ad account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const data = await apiGet("/api/ads/meta/rules/preview", {
+        "account-id": accountId,
+        "rule-id": String(args.id)
+      });
+      const hints = data.matched.length === 0 ? ["Nothing matches right now \u2014 the rule would change nothing if it ran now."] : [];
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var rulesCommand = defineCommand({
+  meta: {
+    name: "rules",
+    description: `Meta automated rules \u2014 Meta's own automation, which runs on Meta with no Baker involvement once created.
+Use one for a standing "if this metric crosses that line, do X" that needs no judgement; use a Baker scheduled agent when the call needs reasoning.
+
+Examples:
+  baker ads meta rules --account-id act_123                                     # every rule, what it does
+  baker ads meta rules --rule-id 1132635173044914                                # one rule with its specs
+  baker ads meta rules history --rule-id 1132635173044914 --hide-no-changes      # what it did
+  baker ads meta rules preview 1132635173044914                                  # what it would act on now
+  baker ads meta rules create --name "Stop expensive ads" --apply-to ad --when "cost_per_result>20" --action pause
+  baker ads meta rules update 1132635173044914 --name "Stop very expensive ads"
+  baker ads meta rules disable|enable|delete 1132635173044914
+  baker ads meta rules run 1132635173044914                                     # run it once, at publish`
+  },
+  subCommands: {
+    list: listCommand,
+    history: historyCommand,
+    preview: previewCommand,
+    create: () => import("./rule-writes-BVHLNJLE.js").then((m) => m.rulesCreateCommand),
+    update: () => import("./rule-writes-BVHLNJLE.js").then((m) => m.rulesUpdateCommand),
+    enable: () => import("./rule-writes-BVHLNJLE.js").then((m) => m.rulesEnableCommand),
+    disable: () => import("./rule-writes-BVHLNJLE.js").then((m) => m.rulesDisableCommand),
+    delete: () => import("./rule-writes-BVHLNJLE.js").then((m) => m.rulesDeleteCommand),
+    run: () => import("./rule-writes-BVHLNJLE.js").then((m) => m.rulesRunCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID" },
+    "rule-id": { type: "string", description: "Read one rule" },
+    full: { type: "boolean", description: "Include the specs and timestamps" }
+  },
+  default: "list"
+});
+export {
+  compactHistory,
+  compactRule,
+  ruleListHints,
+  rulesCommand
+};
+//# sourceMappingURL=rules-R47FOFVB.js.map

package/dist/rules-Y3BH7SO5.js

@@ -0,0 +1,97 @@
+import {
+  readCreativeSpecs,
+  rulesHints,
+  rulesView,
+  waiverCounts
+} from "./chunk-QVQKCVP7.js";
+import {
+  readAllRules
+} from "./chunk-VAHDJ5CK.js";
+import "./chunk-A3IQAONL.js";
+import "./chunk-3YJNSUNF.js";
+import "./chunk-E44NXCTL.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-EJGAJHLB.js";
+import {
+  selectRules
+} from "./chunk-7HZSORAB.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/rules.ts
+import { defineCommand } from "citty";
+var LIST_DESCRIPTION = `The company's standing rules for every ad: the brand's own (BRAND.md) and the ones a person taught, each with its id, strength (never | must | prefer), what it is about, its words, the person's own words and where it came from. \`baker creatives brief\` carries them too.
+Start here: baker creatives rules list
+  baker creatives rules list --kind video --product cubbo-engage   # the rules one ad is held to
+  baker creatives rules list --all                                 # retired ones and every scope too`;
+var LIST_ARGS = {
+  kind: {
+    type: "string",
+    description: "static | video: only the rules an ad of this kind is held to",
+    required: false
+  },
+  product: {
+    type: "string",
+    description: "A product slug (src/content/products/<slug>.md): only the rules an ad of it is held to",
+    required: false
+  },
+  all: {
+    type: "boolean",
+    description: "Every rule, retired ones and every scope included",
+    required: false,
+    default: false
+  },
+  full: { type: "boolean", description: "Each rule and the person's words whole", required: false, default: false }
+};
+registerSchema({ command: "creatives.rules.list", description: LIST_DESCRIPTION, args: LIST_ARGS });
+var listCommand = defineCommand({
+  meta: { name: "list", description: LIST_DESCRIPTION },
+  args: LIST_ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const kind = args.kind === "static" || args.kind === "video" ? args.kind : void 0;
+    const product = typeof args.product === "string" && args.product ? args.product : void 0;
+    const [rules, specs] = await Promise.all([readAllRules(root), readCreativeSpecs(root)]);
+    const active = selectRules(rules, { ...kind ? { kind } : {}, ...product ? { product } : {} });
+    const shown = args.all === true ? rules : active;
+    const hints = rulesHints(active, waiverCounts(specs));
+    writeJson({
+      ok: true,
+      data: { rules: rulesView(shown, { full: args.full === true }), active: active.length, total: rules.length },
+      ...hints.length > 0 ? { hints } : {}
+    });
+  }
+});
+var rulesCommand = defineCommand({
+  meta: {
+    name: "rules",
+    description: "The company's standing rules for every ad: list them, add one the person agreed to, retire one."
+  },
+  subCommands: {
+    list: listCommand,
+    add: () => import("./rules-add-GSPFBNYU.js").then((m) => m.rulesAddCommand),
+    retire: () => import("./rules-add-GSPFBNYU.js").then((m) => m.rulesRetireCommand)
+  },
+  default: "list"
+});
+export {
+  rulesCommand
+};
+//# sourceMappingURL=rules-Y3BH7SO5.js.map