@koda-sl/baker-cli 0.476.0 → 0.477.0

package/dist/draft-RJ5HOJIR.js

@@ -1,217 +0,0 @@
-import {
-  CHAT_READ_ARG
-} from "./chunk-PFBQERWX.js";
-import {
-  failApi,
-  failValidation,
-  isTempId
-} from "./chunk-6SOB7QMD.js";
-import {
-  REMOVABLE_DRAFT_OP_KINDS
-} from "./chunk-PHY3AERY.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-JLCK7K6Y.js";
-import "./chunk-F4H6VVPE.js";
-import {
-  requireChatId,
-  resolveChatId
-} from "./chunk-G3UCXCC2.js";
-import {
-  registerSchema,
-  writeJson,
-  writeOutput
-} from "./chunk-IWLWY2UD.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/actions/draft.ts
-import { defineCommand } from "citty";
-var REMOVE_OP_KINDS = REMOVABLE_DRAFT_OP_KINDS;
-registerSchema({
-  command: "actions.draft.list",
-  description: "Review the action ops staged in THIS chat's draft before publish (creates/updates/completes/discards/links). Staged ops are invisible to `actions list`/`status` until the chat publishes \u2014 use this to verify what will apply and catch duplicates. Takes --chat <id> to read an earlier chat's staged ops instead. Start here: `baker actions draft --output md` for a one-row-per-op table; add --fields to pick columns.",
-  args: {
-    chat: { type: "string", description: CHAT_READ_ARG.description, required: false },
-    output: {
-      type: "string",
-      description: "Output format: json (default, full envelope with status/count/warnings) | md | files. md and files render one row per staged op.",
-      required: false,
-      enum: ["json", "md", "files"]
-    },
-    fields: {
-      type: "string",
-      description: "Comma-separated columns for md/files output, e.g. kind,name,ref,tags",
-      required: false
-    },
-    full: {
-      type: "boolean",
-      description: "Include each op's payload (description, note, reason, blocker) in md/files output",
-      required: false,
-      default: false
-    }
-  }
-});
-var OUTPUT_ARGS = {
-  output: { type: "string", description: "Output format: json|md|files", required: false, default: "json" },
-  fields: { type: "string", description: "Comma-separated field names to include (md/files)", required: false },
-  full: { type: "boolean", description: "Include each op's full payload", required: false, default: false }
-};
-function text(value) {
-  return typeof value === "string" ? value : "";
-}
-function draftOpNormalizer(record, full) {
-  const compact = {
-    kind: text(record.kind),
-    name: text(record.targetName),
-    ref: text(record.tempId) || text(record.targetActionId),
-    tags: Array.isArray(record.tags) ? record.tags.join(",") : ""
-  };
-  if (!full) {
-    return compact;
-  }
-  return {
-    ...compact,
-    description: text(record.description),
-    note: text(record.note),
-    reason: text(record.reason),
-    blocker: text(record.blockerTempId) || text(record.blockerActionId) || text(record.blockerName)
-  };
-}
-registerSchema({
-  command: "actions.draft.remove",
-  description: "Drop a single staged action op from this chat's draft before publish. For a tempId, removing the create cascades into its complete/link ops. For a real action ID, pass --op to say which op to drop. Use this to UNDO a staged op \u2014 never stage `complete` to delete an action.",
-  args: {
-    ref: { type: "string", description: "tempId (temp_*) or real action ID to drop from the draft", required: true },
-    op: {
-      type: "string",
-      description: "Required for real action IDs: which op to drop (update|complete|discard|assign|reopen)",
-      required: false
-    }
-  }
-});
-registerSchema({
-  command: "actions.draft.clear",
-  description: "Discard ALL staged action ops in this chat's draft before publish. Nothing applies on publish. Does not touch already-published actions.",
-  args: {}
-});
-var listCommand = defineCommand({
-  meta: {
-    name: "list",
-    description: "Show every action op staged in this chat's draft, with footgun warnings. Example: baker actions draft --output md"
-  },
-  args: { chat: CHAT_READ_ARG, ...OUTPUT_ARGS },
-  run: async ({ args }) => {
-    try {
-      const chatId = resolveChatId(args.chat);
-      const response = await apiPost("/api/actions/draft", { chatId });
-      const format = args.output === "md" || args.output === "files" ? args.output : "json";
-      if (format === "json") {
-        writeJson(response);
-        return;
-      }
-      writeOutput(
-        { ok: true, data: response.data.ops },
-        format,
-        args.fields ? args.fields.split(",") : void 0,
-        args.full,
-        draftOpNormalizer
-      );
-      process.stderr.write(`draft status: ${response.data.status}, ${response.data.count} op(s)
-`);
-      for (const warning of response.data.warnings) {
-        process.stderr.write(`warning: ${warning.tempId} \u2014 ${warning.name}
-`);
-      }
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-var removeCommand = defineCommand({
-  meta: {
-    name: "remove",
-    description: "Drop one staged op from the draft. Example: baker actions draft remove temp_abc123  |  baker actions draft remove jx7... --op complete"
-  },
-  args: {
-    ref: { type: "positional", description: "tempId or real action ID", required: false },
-    op: {
-      type: "string",
-      description: "Op kind for real IDs: update|complete|discard|assign|reopen",
-      required: false
-    }
-  },
-  run: async ({ args }) => {
-    try {
-      const ref = args.ref;
-      if (!ref) {
-        failValidation("A tempId or action ID is required.");
-      }
-      const chatId = requireChatId();
-      if (isTempId(ref)) {
-        await apiPost("/api/actions/draft-op/remove", {
-          chatId,
-          target: { kind: "tempId", tempId: ref }
-        });
-        writeJson({ ok: true, data: { removed: ref, kind: "tempId" } });
-        return;
-      }
-      validateConvexId(ref);
-      const op = args.op;
-      if (!op || !REMOVE_OP_KINDS.includes(op)) {
-        failValidation(
-          `Removing a staged op for a real action ID requires --op (one of: ${REMOVE_OP_KINDS.join("|")}).`
-        );
-      }
-      await apiPost("/api/actions/draft-op/remove", {
-        chatId,
-        target: { kind: "actionId", actionId: ref, opKind: op }
-      });
-      writeJson({ ok: true, data: { removed: ref, kind: "actionId", op } });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-var clearCommand = defineCommand({
-  meta: {
-    name: "clear",
-    description: "Discard every staged op in this chat's draft. Example: baker actions draft clear"
-  },
-  run: async () => {
-    try {
-      const chatId = requireChatId();
-      await apiPost("/api/actions/draft/clear", { chatId });
-      writeJson({ ok: true, data: { cleared: true } });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-var draftCommand = defineCommand({
-  meta: {
-    name: "draft",
-    description: "Review and edit the action ops staged in this chat BEFORE publish. Subcommands: list (default), remove, clear. Staged ops are invisible to `actions list`/`status` until publish, so check here before finishing. `list` takes --chat <id> to read an earlier chat's staged ops instead."
-  },
-  // Declared on the parent too: `default: "list"` dispatches the bare `draft --chat <id>` form, and
-  // citty prints help for a flag the parent does not know instead of forwarding it.
-  args: { chat: CHAT_READ_ARG, ...OUTPUT_ARGS },
-  subCommands: {
-    list: listCommand,
-    remove: removeCommand,
-    clear: clearCommand
-  },
-  // Bare `baker actions draft` (no subcommand) shows the staged ops. This must be
-  // `default`, not `run`: citty falls through to `run` after dispatching a subcommand,
-  // so a `run` here would also list the draft on every `remove` / `clear`.
-  default: "list"
-});
-export {
-  draftCommand,
-  draftOpNormalizer
-};
-//# sourceMappingURL=draft-RJ5HOJIR.js.map

package/dist/draft-RPCIHVRS.js

@@ -1,307 +0,0 @@
-import {
-  draftAction,
-  draftListAction,
-  failWriteValidation,
-  handleGoogleError,
-  loadJsonPayloads,
-  loadPatchArg,
-  requireTarget,
-  stageGoogleOps
-} from "./chunk-TJ5N6IVL.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-HDYF3EIN.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-L66QWXPF.js";
-import "./chunk-7VHPAGPK.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-CGOVXSSY.js";
-import "./chunk-KMMVQ2MR.js";
-import "./chunk-JQUPL6IQ.js";
-import "./chunk-3YNHIJCI.js";
-import "./chunk-VPBCR6DT.js";
-import "./chunk-6DE3EHEF.js";
-import "./chunk-XLZMKMKD.js";
-import {
-  CHAT_READ_ARG
-} from "./chunk-PFBQERWX.js";
-import "./chunk-XQIOCIDO.js";
-import {
-  GOOGLE_DRAFT_BATCH_MAX
-} from "./chunk-ML7DLFFY.js";
-import {
-  apiPost
-} from "./chunk-JLCK7K6Y.js";
-import "./chunk-F4H6VVPE.js";
-import {
-  requireChatId
-} from "./chunk-G3UCXCC2.js";
-import {
-  registerSchema
-} from "./chunk-IWLWY2UD.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/google/draft.ts
-import { defineCommand } from "citty";
-
-// src/commands/ads/google/draft-batch.ts
-function refuseOversized(count, what) {
-  if (count > GOOGLE_DRAFT_BATCH_MAX) {
-    failWriteValidation(
-      `${count} ${what} exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} \u2014 split the file and run the command once per part`
-    );
-  }
-}
-function stageFileOps(items, customerId) {
-  if (items.length === 0) {
-    failWriteValidation(
-      'pass --file with the ops to stage: a JSON array (or JSON Lines) of {"kind","customerId","target"?,"payload"?}'
-    );
-  }
-  refuseOversized(items.length, "ops");
-  return items.map((item, index) => {
-    if (typeof item.kind !== "string") {
-      failWriteValidation(
-        `item ${index} has no "kind" \u2014 every item is a whole op, e.g. {"kind":"google.keyword.add",\u2026}`
-      );
-    }
-    return item.customerId === void 0 && customerId ? { ...item, customerId } : item;
-  });
-}
-function amendBatchEntries(items) {
-  refuseOversized(items.length, "amends");
-  return items.map((item, index) => {
-    const { ref, patch } = item;
-    if (typeof ref !== "string" || ref.length === 0) {
-      failWriteValidation(`item ${index} has no "ref" \u2014 name the staged op (g_temp_* or its target) to amend`);
-    }
-    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
-      failWriteValidation(`item ${index} has no "patch" object \u2014 {"ref":"\u2026","patch":{\u2026fields to change\u2026}}`);
-    }
-    return { ref, patch };
-  });
-}
-
-// src/commands/ads/google/draft-validate.ts
-var QUIET = /* @__PURE__ */ new Set(["accepted", "applied"]);
-function changes(n) {
-  return n === 1 ? "1 change" : `${n} changes`;
-}
-function validationHints(data) {
-  const { refused, blocked, unchecked } = data.counts;
-  const hints = [];
-  if (refused > 0) {
-    hints.push(
-      `${changes(refused)} would fail at publish. Fix each refused op in place with \`draft amend <ref>\` (or \`draft remove <ref>\` if it should not exist), then run \`draft validate\` again before asking the user to publish. Never tell the user a refused change will go live.`
-    );
-  }
-  if (blocked > 0) {
-    hints.push(
-      `${changes(blocked)} would not apply only because a refused change they depend on fails \u2014 fixing the refused one clears them.`
-    );
-  }
-  if (data.publishHeld) {
-    hints.push(
-      "Baker would hold this whole publish: a refused change stops a first publish from sending anything. Fix it first."
-    );
-  }
-  if (unchecked > 0) {
-    hints.push(
-      `${changes(unchecked)} can only be checked by Google at publish (the reason is on each one). Nothing here says they will fail.`
-    );
-  }
-  if (refused + blocked === 0 && !data.publishHeld && data.ops.length > 0) {
-    hints.push(
-      "Google accepted every change it was asked about. The draft is ready for the user to review and publish."
-    );
-  }
-  return hints;
-}
-function validationEnvelope(data, full = false) {
-  const ops = full ? data.ops : data.ops.filter((op) => !QUIET.has(op.verdict));
-  return { ok: true, data: { ...data, ops }, hints: validationHints(data) };
-}
-
-// src/commands/ads/google/draft.ts
-var VALIDATE_DESCRIPTION = `Ask Google whether the whole staged draft would publish \u2014 without applying anything.
-
-Start here, after the last staged change and before telling the user the draft is ready:
-  baker ads google draft validate
-
-Every staged op is built, batched and sent exactly as publish sends it, with Google's validateOnly
-flag, so each verdict is the answer publish would get: accepted | refused | blocked (a change it
-depends on was refused) | unchecked (only publish can check it) | applied (an earlier publish did).
-Compact by default \u2014 counts, plus only the ops that need attention, each with Google's reason.
-Fix refused ops with \`draft amend <ref>\` and validate again.
-
-Examples:
-  baker ads google draft validate
-  baker ads google draft validate --full   # every op, with its built request and Google's raw answer`;
-registerSchema({
-  command: "ads.google.draft.validate",
-  description: VALIDATE_DESCRIPTION,
-  args: {
-    full: {
-      type: "boolean",
-      description: "List every op with its built request and Google's raw answer",
-      required: false
-    }
-  }
-});
-var STAGE_DESCRIPTION = `Stage many Google Ads changes from ONE file, in one call \u2014 any mix of kinds, up to 500 ops.
-
-Start here whenever a change touches more than a few rows (a keyword cleanup, bid changes, pausing
-ads, a list of negatives): write the ops to a file and stage them together instead of running one
-command per row.
-  baker ads google draft stage --file changes.json --customer-id 1234567890
-
-The file is a JSON array (or JSON Lines, one op per line). Each op is what the single commands
-build \u2014 kind, customerId (or --customer-id for all), target for a change to something that exists,
-payload. Read the shape for a kind with \`baker capabilities google-ads\`.
-  [
-    {"kind":"google.keyword.add","payload":{"adGroup":"customers/1234567890/adGroups/111","text":"solar panels","matchType":"PHRASE"}},
-    {"kind":"google.keyword.update","target":"customers/1234567890/adGroupCriteria/111~222","payload":{"status":"PAUSED"}},
-    {"kind":"google.negativeKeyword.add","payload":{"level":"campaign","parent":"222333","text":"free","matchType":"BROAD"}}
-  ]
-An op may name a g_temp_* ref an EARLIER call returned (a campaign or ad group staged before), but
-not another op in the same file \u2014 a ref exists only once its op is staged, so stage new parents first.
-All-or-nothing: one invalid op stages nothing. Ops already in effect come back as skipped.
-Then: baker ads google draft validate`;
-registerSchema({
-  command: "ads.google.draft.stage",
-  description: STAGE_DESCRIPTION,
-  args: {
-    file: {
-      type: "string",
-      description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline",
-      required: true
-    },
-    "customer-id": {
-      type: "string",
-      description: "10-digit customer id for every op that does not name its own",
-      required: false
-    }
-  }
-});
-var BULK_STAGE_HINTS = [
-  "Run `baker ads google draft validate` next: it asks Google about every staged op at once and lists only the ones it would refuse.",
-  'To fix several staged ops, amend them together: `baker ads google draft amend --file amends.json` with [{"ref":"\u2026","patch":{\u2026}}, \u2026].'
-];
-var draftCommand = defineCommand({
-  meta: {
-    name: "draft",
-    description: "Stage many ops from one file, or list, validate, remove, clear, amend, or show staged Google Ads write ops for this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
-  },
-  subCommands: {
-    stage: defineCommand({
-      meta: { name: "stage", description: STAGE_DESCRIPTION },
-      args: {
-        file: {
-          type: "string",
-          description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline"
-        },
-        "customer-id": { type: "string", description: "10-digit customer id for every op that does not name its own" }
-      },
-      run: async ({ args }) => {
-        const customerId = typeof args["customer-id"] === "string" ? args["customer-id"] : void 0;
-        await stageGoogleOps(stageFileOps(loadJsonPayloads(args.file), customerId), BULK_STAGE_HINTS);
-      }
-    }),
-    list: defineCommand({
-      meta: {
-        name: "list",
-        description: "Review everything staged as a campaign \u25B8 ad group \u25B8 ad tree (--json for the raw envelope)"
-      },
-      args: {
-        json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
-        chat: CHAT_READ_ARG
-      },
-      run: async ({ args }) => {
-        await draftListAction(args.json === true, args.chat);
-      }
-    }),
-    remove: defineCommand({
-      meta: { name: "remove", description: "Remove one staged op (cascades to dependents)" },
-      args: { ref: { type: "positional", description: "Staged op ref (g_temp_* or target)", required: false } },
-      run: async ({ args }) => {
-        await draftAction("/api/ads/google/draft/remove", { ref: requireTarget(args, "op") });
-      }
-    }),
-    clear: defineCommand({
-      meta: { name: "clear", description: "Discard all staged ops on this chat" },
-      run: async () => {
-        await draftAction("/api/ads/google/draft/clear", {});
-      }
-    }),
-    amend: defineCommand({
-      meta: {
-        name: "amend",
-        description: 'Update a staged op in place \u2014 merges a JSON patch into its payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create. Many at once: no ref, and --file holding [{"ref":"g_temp_\u2026","patch":{\u2026}}, \u2026] \u2014 all amended in one call, or none if any is refused.'
-      },
-      args: {
-        ref: {
-          type: "positional",
-          description: "Staged op ref (g_temp_*) or target id/resource name \u2014 leave out to amend many from --file",
-          required: false
-        },
-        file: {
-          type: "string",
-          description: 'JSON file with the patch object \u2014 or, with no ref, a JSON array of {"ref","patch"} amends'
-        },
-        patch: { type: "string", description: "Inline JSON patch object" }
-      },
-      run: async ({ args }) => {
-        const positional = Array.isArray(args._) ? args._[0] : void 0;
-        if (!(args.ref ?? positional) && typeof args.file === "string" && args.file.length > 0) {
-          const amends = amendBatchEntries(loadJsonPayloads(args.file));
-          await draftAction("/api/ads/google/draft/amend-batch", { amends });
-          return;
-        }
-        const ref = requireTarget(args, "op");
-        const patch = loadPatchArg(args);
-        await draftAction("/api/ads/google/draft/amend", { ref, patch });
-      }
-    }),
-    validate: defineCommand({
-      meta: { name: "validate", description: VALIDATE_DESCRIPTION },
-      args: {
-        full: { type: "boolean", description: "List every op with its built request and Google's raw answer" }
-      },
-      run: async ({ args }) => {
-        try {
-          const full = args.full === true;
-          const response = await apiPost(
-            "/api/ads/google/draft/validate",
-            { chatId: requireChatId(), full }
-          );
-          writeJsonEnvelope(response.ok && response.data ? validationEnvelope(response.data, full) : response);
-        } catch (err) {
-          handleGoogleError(err);
-        }
-      }
-    }),
-    show: defineCommand({
-      meta: {
-        name: "show",
-        description: "Print the full staged payload for one op \u2014 the receipt to verify a change looks right before publish (never truncated)."
-      },
-      args: {
-        ref: {
-          type: "positional",
-          description: "Staged op ref (g_temp_*) or target id/resource name",
-          required: false
-        },
-        chat: CHAT_READ_ARG
-      },
-      run: async ({ args }) => {
-        await draftAction("/api/ads/google/draft/show", { ref: requireTarget(args, "op") }, args.chat);
-      }
-    })
-  }
-});
-export {
-  BULK_STAGE_HINTS,
-  draftCommand
-};
-//# sourceMappingURL=draft-RPCIHVRS.js.map

package/dist/draft-UNCGJCUN.js

@@ -1,100 +0,0 @@
-import {
-  draftAction,
-  draftList,
-  loadJsonArg,
-  requireTarget
-} from "./chunk-NFDAIY6J.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-CGOVXSSY.js";
-import {
-  CHAT_READ_ARG
-} from "./chunk-PFBQERWX.js";
-import "./chunk-JLCK7K6Y.js";
-import "./chunk-F4H6VVPE.js";
-import "./chunk-G3UCXCC2.js";
-import {
-  registerSchema
-} from "./chunk-IWLWY2UD.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ga4/draft.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "ga4.draft",
-  description: "Review and undo the Google Analytics changes staged on this chat. Use `list` to see everything staged, `show` to inspect one change in full before the chat completes, `amend` to correct one in place, and `remove`/`clear` to drop them. `list` and `show` take --chat <id> to read an earlier chat's changes instead.",
-  args: {
-    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list", required: false },
-    chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
-  }
-});
-var draftCommand = defineCommand({
-  meta: {
-    name: "draft",
-    description: "List, show, amend, remove or clear the Google Analytics changes staged on this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
-  },
-  subCommands: {
-    list: defineCommand({
-      meta: { name: "list", description: "Review everything staged on this chat (--json for the raw envelope)" },
-      args: {
-        json: { type: "boolean", description: "Print the raw JSON envelope", required: false },
-        chat: CHAT_READ_ARG
-      },
-      run: async ({ args }) => {
-        await draftList(args.json === true, args.chat);
-      }
-    }),
-    show: defineCommand({
-      meta: {
-        name: "show",
-        description: "Print the full staged payload for one change, alongside how the property looks today \u2014 the receipt to verify it before the chat completes (never truncated)."
-      },
-      args: {
-        ref: { type: "positional", description: "Staged ref or target id", required: false },
-        chat: CHAT_READ_ARG
-      },
-      run: async ({ args }) => {
-        await draftAction(
-          "/api/ga4/draft/show",
-          { ref: requireTarget(args, "change") },
-          args.chat
-        );
-      }
-    }),
-    amend: defineCommand({
-      meta: {
-        name: "amend",
-        description: "Update a staged change in place \u2014 merges a JSON patch into its payload (objects deep-merge, null deletes a key, arrays/scalars replace) and re-runs every check. Use this instead of remove + re-create."
-      },
-      args: {
-        ref: { type: "positional", description: "Staged ref or target id", required: false },
-        patch: { type: "string", description: "Inline JSON patch object", required: false },
-        file: { type: "string", description: "JSON file with the patch object", required: false }
-      },
-      run: async ({ args }) => {
-        await draftAction("/api/ga4/draft/amend", {
-          ref: requireTarget(args, "change"),
-          patch: loadJsonArg(args, "patch")
-        });
-      }
-    }),
-    remove: defineCommand({
-      meta: { name: "remove", description: "Remove one staged change" },
-      args: { ref: { type: "positional", description: "Staged ref or target id", required: false } },
-      run: async ({ args }) => {
-        await draftAction("/api/ga4/draft/remove", {
-          ref: requireTarget(args, "change")
-        });
-      }
-    }),
-    clear: defineCommand({
-      meta: { name: "clear", description: "Discard all Google Analytics changes staged on this chat" },
-      run: async () => {
-        await draftAction("/api/ga4/draft/clear", {});
-      }
-    })
-  }
-});
-export {
-  draftCommand
-};
-//# sourceMappingURL=draft-UNCGJCUN.js.map