@koda-sl/baker-cli 0.563.0-dev.25ca3cbc8 → 0.564.0

package/dist/draft-WOE7KQ7T.js

@@ -0,0 +1,315 @@
+import {
+  failWriteValidation,
+  schemaArgs
+} from "./chunk-ULIQNJ5J.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  chatgptFailure
+} from "./chunk-OASXBRXQ.js";
+import {
+  amendDraftRefs,
+  draftRefs,
+  removeDraftRefs
+} from "./chunk-2DAWUWA4.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/draft.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/chatgpt/draft-status.ts
+var OPERATION_LABELS = {
+  create: { staged: "Creating", done: "Created", notDone: "Not created" },
+  update: { staged: "Updating", done: "Updated", notDone: "Not updated" },
+  pause: { staged: "Pausing", done: "Paused", notDone: "Not paused" },
+  resume: { staged: "Resuming", done: "Resumed", notDone: "Not resumed" },
+  archive: { staged: "Archiving", done: "Archived", notDone: "Not archived" }
+};
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  discarded: "discarded"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  if (!label) {
+    return node.existing ? "on ChatGPT Ads" : "staged";
+  }
+  if (node.outcome === "applied") {
+    return label.done;
+  }
+  return node.outcome ? `${label.notDone} (${node.outcome})` : label.staged;
+}
+function renderNode(node, depth, out) {
+  const indent = "  ".repeat(depth);
+  out.push(`${indent}${node.entity}: ${node.name} \u2014 ${badge(node)}`);
+  for (const warning of node.warnings ?? []) {
+    out.push(`${indent}  ! ${warning}`);
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, out);
+  }
+}
+function didNotApply(op) {
+  return op.result?.status === "failed" || op.result?.status === "skipped";
+}
+function didApply(op) {
+  return op.result?.status === "applied" || op.result?.status === "simulated";
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status] ?? draft.status;
+  if (draft.status !== "applied" && draft.status !== "publishing") {
+    return `ChatGPT Ads: ${draft.count} change${draft.count === 1 ? "" : "s"} ${heading}`;
+  }
+  const applied = draft.ops.filter(didApply).length;
+  const failed = draft.ops.filter(didNotApply).length;
+  return `ChatGPT Ads: ${heading} \xB7 ${applied} applied${failed > 0 ? `, ${failed} failed` : ""}`;
+}
+function renderChatgptDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return "No ChatGPT Ads changes staged";
+  }
+  const out = [headingLine(draft), ""];
+  for (const node of draft.tree ?? []) {
+    renderNode(node, 0, out);
+  }
+  const summaryByRef = new Map(draft.ops.map((op) => [op.ref, op.summary]));
+  const problems = draft.ops.filter(didNotApply).map((op) => {
+    if (op.result?.status === "failed") {
+      return `\u2717 ${op.summary} \u2014 failed: ${op.result.error ?? "ChatGPT Ads gave no reason"}`;
+    }
+    const waitedOn = op.result?.skippedBecause;
+    const parent = (waitedOn && summaryByRef.get(waitedOn)) ?? "a change that did not apply";
+    return `\u2717 ${op.summary} \u2014 skipped: waiting on ${parent}, which did not apply`;
+  });
+  if (problems.length > 0) {
+    out.push("", ...problems);
+  }
+  return out.join("\n");
+}
+
+// src/commands/ads/chatgpt/draft.ts
+async function run(call) {
+  try {
+    writeJsonEnvelope({ ok: true, data: await call() });
+  } catch (err) {
+    writeJsonEnvelope({ ...chatgptFailure(err, CHATGPT_ADS_REFERENCE.overview) });
+    process.exit(1);
+  }
+}
+var LIST_ARGS = {
+  json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+  full: DRAFT_FULL_ARG,
+  chat: CHAT_READ_ARG
+};
+registerSchema({
+  command: "ads.chatgpt.draft",
+  description: "Review everything staged for ChatGPT Ads on this chat as a Campaign \u25B8 Ad group \u25B8 Ad tree. After a publish this is the authoritative record: `published \xB7 N applied`, or a `\u2717 \u2026 failed:` line per change that did not land, with ChatGPT Ads' reason.",
+  args: schemaArgs(LIST_ARGS)
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign \u25B8 Ad group \u25B8 Ad tree. Example: baker ads chatgpt draft"
+  },
+  args: LIST_ARGS,
+  run: async ({ args }) => {
+    try {
+      const full = args.full === true;
+      const draft = await apiPost("/api/ads/chatgpt/draft", {
+        chatId: resolveChatId(args.chat),
+        ...full ? { full: true } : {}
+      });
+      if (args.json === true || full) {
+        writeJsonEnvelope({ ok: true, data: draft });
+        return;
+      }
+      process.stdout.write(`${renderChatgptDraftStatus(draft)}
+`);
+    } catch (err) {
+      writeJsonEnvelope({ ...chatgptFailure(err, CHATGPT_ADS_REFERENCE.overview) });
+      process.exit(1);
+    }
+  }
+});
+var SHOW_ARGS = {
+  ref: {
+    type: "positional",
+    description: "Op ref (chatgpt_temp_* for creates), or the target id for a staged update",
+    required: true
+  },
+  chat: CHAT_READ_ARG
+};
+registerSchema({
+  command: "ads.chatgpt.draft.show",
+  description: "The full staged payload, warnings and before-snapshot for one change \u2014 the receipt to check before publishing.",
+  args: schemaArgs(SHOW_ARGS)
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show one staged change in full. Example: baker ads chatgpt draft show chatgpt_temp_ab12"
+  },
+  args: SHOW_ARGS,
+  run: async ({ args }) => {
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/show", {
+        chatId: resolveChatId(args.chat),
+        ref: String(args.ref)
+      })
+    );
+  }
+});
+var AMEND_ARGS = {
+  ref: {
+    type: "positional",
+    description: "Op ref(s) or target id(s) \u2014 several, space- or comma-separated, before the patch",
+    required: true
+  },
+  patch: { type: "positional", description: "JSON object, or @path to a file holding one", required: true }
+};
+registerSchema({
+  command: "ads.chatgpt.draft.amend",
+  description: "Change staged ops in place instead of removing and re-staging them \u2014 one, or many with the same patch in one call. The patch merges into the payload (JSON merge-patch: `null` deletes a key; money is in micros) and the whole op re-validates.",
+  args: schemaArgs(AMEND_ARGS)
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: `Change a staged op in place. Money in the payload is micros: 20 = 20000000.
+
+Examples:
+  baker ads chatgpt draft amend chatgpt_temp_ab12 '{"dailyBudgetMicros": 30000000}'
+  baker ads chatgpt draft amend chatgpt_temp_ab12 chatgpt_temp_cd34 chatgpt_temp_ef56 '{"status":"active"}'`
+  },
+  args: AMEND_ARGS,
+  run: async ({ args }) => {
+    const positionals = Array.isArray(args._) ? args._ : [];
+    const refs = draftRefs(positionals.slice(0, -1));
+    const raw = String(positionals.at(-1) ?? args.patch);
+    let patch;
+    try {
+      patch = JSON.parse(raw.startsWith("@") ? readFileSync(raw.slice(1), "utf8") : raw);
+    } catch {
+      failWriteValidation("patch must be a JSON object, or @path to a file holding one");
+    }
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+      failWriteValidation("patch must be a JSON object");
+    }
+    if (refs.length > 1) {
+      await amendDraftRefs("/api/ads/chatgpt/draft/amend", refs, patch);
+      return;
+    }
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/amend", {
+        chatId: requireChatId(),
+        ref: String(args.ref),
+        patch
+      })
+    );
+  }
+});
+var REMOVE_ARGS = {
+  ref: {
+    type: "positional",
+    description: "Op ref(s) or target id(s) \u2014 several, space- or comma-separated",
+    required: true
+  }
+};
+registerSchema({
+  command: "ads.chatgpt.draft.remove",
+  description: "Drop staged ChatGPT Ads changes \u2014 one, or many in one call. Removing a create also drops everything staged under it.",
+  args: schemaArgs(REMOVE_ARGS)
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop staged changes (and what depends on them) \u2014 one, or many in one call. Example: baker ads chatgpt draft remove chatgpt_temp_ab12 chatgpt_temp_cd34"
+  },
+  args: REMOVE_ARGS,
+  run: async ({ args }) => {
+    const refs = draftRefs(args._);
+    if (refs.length > 1) {
+      await removeDraftRefs("/api/ads/chatgpt/draft/remove", refs);
+      return;
+    }
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/remove", {
+        chatId: requireChatId(),
+        ref: String(args.ref)
+      })
+    );
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.draft.clear",
+  description: "Drop every staged ChatGPT Ads change on this chat. Nothing reached ChatGPT Ads, so nothing needs reversing.",
+  args: {}
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Drop every staged ChatGPT Ads change on this chat. Example: baker ads chatgpt draft clear"
+  },
+  args: {},
+  run: async () => {
+    await run(
+      () => apiPost("/api/ads/chatgpt/draft/clear", {
+        chatId: requireChatId()
+      })
+    );
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: `Review and edit the ChatGPT Ads changes staged on this chat.
+
+Nothing staged has reached ChatGPT Ads. Everything applies when the chat is
+published, and discarding the chat drops all of it.
+
+Examples:
+  baker ads chatgpt draft                               \u2014 the Campaign \u25B8 Ad group \u25B8 Ad tree
+  baker ads chatgpt draft show chatgpt_temp_ab12        \u2014 one change in full
+  baker ads chatgpt draft list --full                   \u2014 every change in full, in one call
+  baker ads chatgpt draft amend chatgpt_temp_ab12 '{"name":"New"}'
+  baker ads chatgpt draft remove chatgpt_temp_ab12
+  baker ads chatgpt draft clear`
+  },
+  subCommands: {
+    list: listCommand,
+    show: showCommand,
+    amend: amendCommand,
+    remove: removeCommand,
+    clear: clearCommand
+  },
+  // A parent must never declare `run`: citty falls through to it after the
+  // matched subcommand, so every edit would also print the whole draft.
+  args: LIST_ARGS,
+  default: "list"
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-WOE7KQ7T.js.map

package/dist/engine/index.js

@@ -8,15 +8,15 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "../chunk-3U4DQRFG.js";
-import "../chunk-4JZ3NS43.js";
-import "../chunk-J7IYLOPV.js";
-import "../chunk-J4LQ6GK5.js";
+} from "../chunk-DWPOAU4Z.js";
+import "../chunk-HBRXFQQV.js";
+import "../chunk-X3GWGFZP.js";
+import "../chunk-GWLP45WQ.js";
 import "../chunk-DGCUPJZD.js";
-import "../chunk-KHVZZTWD.js";
-import "../chunk-FZJB77OK.js";
-import "../chunk-IZMSISEN.js";
-import "../chunk-UQA3ASVK.js";
+import "../chunk-6QINKM6T.js";
+import "../chunk-H3HA22Z3.js";
+import "../chunk-DLM5OSHM.js";
+import "../chunk-MCJ5I5LR.js";
 import "../chunk-2WZI36D3.js";
 import "../chunk-65Y3RCWP.js";
 import "../chunk-E56V3RFO.js";

package/dist/experiments-SSXYFZRC.js

@@ -0,0 +1,236 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp
+} from "./chunk-SKW7CDXE.js";
+import {
+  handleLinkedinError
+} from "./chunk-QML3FCJC.js";
+import "./chunk-CDTAKCJR.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-4H6XLX7E.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-E56V3RFO.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-7BV5QN2P.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiGet
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/experiments.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads linkedin draft`.";
+var accountArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" }
+};
+var STOP_AT = {
+  "end-date": "AUTO_STOP_AT_END_DATE",
+  winner: "AUTO_STOP_AT_WINNER",
+  never: "AUTO_STOP_DISABLED"
+};
+function stopAtArg(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const mapped = STOP_AT[String(value)];
+  if (!mapped) {
+    failWriteValidation(`--stop-at must be one of ${Object.keys(STOP_AT).join("|")}`);
+  }
+  return mapped;
+}
+function numberArg(value, flag) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    failWriteValidation(`${flag} must be a whole number`);
+  }
+  return parsed;
+}
+var experimentsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the ad account's A/B tests, newest first: name, state (what was asked), running (what LinkedIn is doing: PENDING|RUNNING|ON_HOLD|STOPPED|ENDED), metric, dates and the two versions (ad sets + traffic split). Runs by default."
+  },
+  args: { ...accountArgs },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsGetCommand = defineCommand({
+  meta: {
+    name: "get",
+    description: "One A/B test with LinkedIn's setup checks (an ERROR keeps it from running \u2014 e.g. NO_ACTIVE_CREATIVES; a WARNING may skew it) and its latest result: the winning version, p-value, and each version's confidence interval for the metric. `result: null` until LinkedIn computes the first one (daily)."
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id from `experiments`", required: true },
+    ...accountArgs
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/experiments", {
+        "account-id": bareAccountId(args),
+        id: requireTarget(args, "A/B test")
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var experimentsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage an A/B test between two ad sets of the SAME campaign: LinkedIn splits the audience so each member sees only one version, and calls a winner on the metric. ${STAGED_NOTE}
+Rules LinkedIn enforces: exactly 2 ad sets, same campaign, that campaign must NOT share its budget across ad sets, at most 90 days, confidence 51\u201399 (90+ recommended), each ad set needs an active ad. Best practice: two new ad sets identical but for the one thing tested, equal budgets, 3+ weeks.
+Examples:
+  baker ads linkedin experiments create --name "Image vs video" --version-a li_temp_x1 --version-b li_temp_x2 --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments create --name "Headline test" --version-a 896802423 --name-a "Pain" --version-b 896812053 --name-b "Gain" --metric CPM --start 2026-11-01 --end 2026-12-01 --stop-at winner --confidence 95`
+  },
+  args: {
+    ...accountArgs,
+    name: { type: "string", description: "Test name (\u2264100)", required: true },
+    description: { type: "string", description: "What is being tested" },
+    "version-a": { type: "string", description: "Ad set id/URN or li_temp_* ref for version A", required: true },
+    "version-b": { type: "string", description: "Ad set id/URN or li_temp_* ref for version B", required: true },
+    "name-a": { type: "string", description: "Version A label (default A)" },
+    "name-b": { type: "string", description: "Version B label (default B)" },
+    "weight-a": { type: "string", description: "Version A share of the audience, 1\u201399 (default 50; B gets the rest)" },
+    metric: { type: "string", description: "CPC|CPM|CPV (video ad sets)|CPMS (message ads)", required: true },
+    confidence: { type: "string", description: "51\u201399 (default 90)" },
+    start: { type: "string", description: "Start date (ISO or epoch ms)", required: true },
+    end: { type: "string", description: "End date (\u226490 days after start)", required: true },
+    "stop-at": {
+      type: "string",
+      description: "end-date (default, pauses both) | winner | never (ad sets keep running)"
+    },
+    draft: { type: "boolean", description: "Create it set up but not running" }
+  },
+  run: async ({ args }) => {
+    const weightA = numberArg(args["weight-a"], "--weight-a") ?? 50;
+    await stageOp({
+      kind: "experiment.create",
+      accountId: bareAccountId(args),
+      payload: {
+        name: args.name,
+        description: args.description,
+        keyMetric: args.metric ? String(args.metric).toUpperCase() : void 0,
+        confidence: numberArg(args.confidence, "--confidence"),
+        start: parseDateFlag(args.start, "--start"),
+        end: parseDateFlag(args.end, "--end"),
+        autoStop: stopAtArg(args["stop-at"]),
+        state: args.draft ? "DRAFT" : void 0,
+        cells: [
+          { name: args["name-a"] ?? "A", campaign: args["version-a"], trafficWeight: weightA },
+          { name: args["name-b"] ?? "B", campaign: args["version-b"], trafficWeight: 100 - weightA }
+        ]
+      }
+    });
+  }
+});
+var experimentsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage changes to an A/B test. Once it has started only the name, description, end date (still \u226490 days from start), confidence and when it stops can change \u2014 the versions are fixed. ${STAGED_NOTE}
+Example: baker ads linkedin experiments update 5633011 --end 2026-12-15 --stop-at winner`
+  },
+  args: {
+    id: { type: "positional", description: "A/B test id", required: true },
+    ...accountArgs,
+    name: { type: "string", description: "New name" },
+    description: { type: "string", description: "New description" },
+    end: { type: "string", description: "New end date" },
+    confidence: { type: "string", description: "51\u201399" },
+    "stop-at": { type: "string", description: "end-date|winner|never" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "experiment.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "A/B test"),
+      payload: {
+        name: args.name,
+        description: args.description,
+        end: parseDateFlag(args.end, "--end"),
+        confidence: numberArg(args.confidence, "--confidence"),
+        autoStop: stopAtArg(args["stop-at"])
+      }
+    });
+  }
+});
+function experimentStateCommand(name, state, what) {
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${what}. ${STAGED_NOTE}
+Example: baker ads linkedin experiments ${name} 5633011`
+    },
+    args: {
+      id: { type: "positional", description: "A/B test id", required: true },
+      ...accountArgs
+    },
+    run: async ({ args }) => {
+      await stageOp({
+        kind: "experiment.update",
+        accountId: bareAccountId(args),
+        target: requireTarget(args, "A/B test"),
+        payload: { state }
+      });
+    }
+  });
+}
+var experimentsCommand = defineCommand({
+  meta: {
+    name: "experiments",
+    description: `LinkedIn A/B tests: two ad sets of one campaign shown to separate halves of the audience, with a winner called on CPC/CPM/CPV/CPMS.
+Examples:
+  baker ads linkedin experiments                       # list
+  baker ads linkedin experiments get 5633011           # setup checks + result
+  baker ads linkedin experiments create --name "Image vs video" --version-a <ad set> --version-b <ad set> --metric CPC --start 2026-11-01 --end 2026-11-28
+  baker ads linkedin experiments pause|start|end 5633011`
+  },
+  subCommands: {
+    list: experimentsListCommand,
+    get: experimentsGetCommand,
+    create: experimentsCreateCommand,
+    update: experimentsUpdateCommand,
+    start: experimentStateCommand("start", "ACTIVE", "starting (or resuming) an A/B test"),
+    pause: experimentStateCommand("pause", "PAUSED", "pausing an A/B test \u2014 both ad sets pause, the end date stays"),
+    end: experimentStateCommand("end", "CANCELED", "ending an A/B test for good")
+  },
+  args: { ...accountArgs },
+  default: "list"
+});
+export {
+  experimentsCommand
+};
+//# sourceMappingURL=experiments-SSXYFZRC.js.map