@koda-sl/baker-cli 0.452.0 → 0.453.0-dev.914a088e4

package/dist/draft-BT5ROZHA.js

@@ -0,0 +1,233 @@
+import {
+  handleMetaError
+} from "./chunk-VSA63D2N.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-XNMSJP2X.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import {
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-UW36KPPH.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/meta/draft-status.ts
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  partial: "published with failures",
+  discarded: "discarded",
+  none: "none"
+};
+function plural(count, word) {
+  return `${count} ${word}${count === 1 ? "" : "s"}`;
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status];
+  if (draft.status === "active" || draft.status === "discarded") {
+    return `Meta Ads \u2014 ${plural(draft.count, "change")} ${heading} \xB7 ${draft.mode}`;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of draft.ops) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  return `Meta Ads \u2014 ${heading} \xB7 ${summary} \xB7 ${draft.mode}`;
+}
+function resultPart(op) {
+  const result = op.result;
+  if (!result) {
+    return void 0;
+  }
+  if (result.status === "failed") {
+    return `\u2717 failed: ${result.error ?? "no reason recorded"}`;
+  }
+  if (result.status === "skipped") {
+    const because = result.skippedBecause;
+    if (because && op.dependsOn.includes(because)) {
+      return `\u2717 skipped: ${because} did not apply`;
+    }
+    return `\u2717 skipped: ${because ?? "a change it needs did not apply"}`;
+  }
+  const id = result.id ?? result.hash;
+  const applied = `\u2713 ${result.status}${id ? ` \u2192 ${id}` : ""}`;
+  const verification = result.verification;
+  if (verification && verification.status !== "confirmed") {
+    return `${applied} (read-back ${verification.status}${verification.note ? `: ${verification.note}` : ""})`;
+  }
+  return applied;
+}
+function opLine(op, showAccount) {
+  const parts = [op.ref, op.kind, op.summary];
+  if (op.target && op.target !== op.ref) {
+    parts.push(`target ${op.target}`);
+  }
+  if (showAccount) {
+    parts.push(`account ${op.accountId}`);
+  }
+  if (op.dependsOn.length > 0) {
+    parts.push(`after ${op.dependsOn.join(", ")}`);
+  }
+  const result = resultPart(op);
+  if (result) {
+    parts.push(result);
+  }
+  return `  ${parts.join(" \xB7 ").replace(/[\r\n]+/g, " ")}`;
+}
+function renderDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return "No staged Meta changes on this chat.";
+  }
+  const lines = [headingLine(draft)];
+  if (draft.status === "active") {
+    lines.push("Publishing makes every change real on the ad account.");
+  }
+  lines.push("");
+  const showAccount = new Set(draft.ops.map((op) => op.accountId)).size > 1;
+  for (const op of draft.ops) {
+    lines.push(opLine(op, showAccount));
+  }
+  if (draft.advisories.length > 0) {
+    lines.push("", "Advisories");
+    for (const advisory of draft.advisories) {
+      lines.push(`  ! ${advisory.ref}: ${advisory.message}`);
+    }
+  }
+  lines.push("", "Full staged payload for one op: baker ads meta draft show <ref> \xB7 raw envelope: --json");
+  return lines.join("\n");
+}
+
+// src/commands/ads/meta/draft.ts
+registerSchema({
+  command: "ads.meta.draft",
+  description: "Review every Meta op staged on this chat, one line each: ref \xB7 kind \xB7 summary \xB7 what it waits on, and after a publish \u2713 applied \u2192 id or \u2717 failed: <error>. `draft show <ref>` prints one op's full payload.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable list", required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/meta/draft", { chatId });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Show every Meta write op staged in this chat, one line each (ref \xB7 kind \xB7 summary \xB7 dependencies \xB7 post-publish result); --json for the raw envelope. Publishing reaches the real ad account, so review this before you finish. Example: baker ads meta draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat);
+  }
+});
+var showCommand = 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). Example: baker ads meta draft show meta_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref (meta_temp_* for creates, target id for updates)", required: true },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/ads/meta/draft/show", {
+        chatId,
+        ref: args.ref
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged Meta op. Removing a create cascades to everything that depends on it. Example: baker ads meta draft remove meta_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref (meta_temp_* for creates, target id for updates)", required: true }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/meta/draft/remove", {
+        chatId,
+        ref: args.ref
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Discard ALL staged Meta ops in this chat's draft \u2014 nothing will apply on publish. Example: baker ads meta draft clear"
+  },
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/meta/draft/clear", {
+        chatId
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var metaDraftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review and edit the Meta write ops staged in this chat BEFORE publish. Subcommands: list (default), show, remove, clear. Ops never hit Meta until the chat is published. `list` and `show` take --chat <id> to read an earlier chat's changes 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: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    chat: CHAT_READ_ARG
+  },
+  subCommands: { list: listCommand, show: showCommand, remove: removeCommand, clear: clearCommand },
+  // `default` (not `run`) dispatches the bare invocation: citty falls through to `run`
+  // after dispatching a subcommand, so a `run` here would list the draft a second time
+  // on every `draft list` / `draft remove` / `draft clear`.
+  default: "list"
+});
+export {
+  metaDraftCommand
+};
+//# sourceMappingURL=draft-BT5ROZHA.js.map

package/dist/draft-CQFIWAI4.js

@@ -0,0 +1,103 @@
+import {
+  draftAction,
+  draftList,
+  loadJsonArg,
+  requireTarget
+} from "./chunk-SZ2LLYSO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-XNMSJP2X.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/tag-manager/draft.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "tagManager.draft",
+  description: "Review and undo the Tag Manager changes staged on this chat. Use `list` to see everything staged, `show` to inspect one change in full before publish, `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 staged Tag Manager changes for 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 \u2014 the receipt to verify it looks right before publish (never truncated)."
+      },
+      args: {
+        ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false },
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftAction(
+          "/api/tag-manager/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-validates. Use this instead of remove + re-create."
+      },
+      args: {
+        ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", 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/tag-manager/draft/amend", {
+          ref: requireTarget(args, "change"),
+          patch: loadJsonArg(args, "patch")
+        });
+      }
+    }),
+    remove: defineCommand({
+      meta: { name: "remove", description: "Remove one staged change (cascades to anything depending on it)" },
+      args: { ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false } },
+      run: async ({ args }) => {
+        await draftAction("/api/tag-manager/draft/remove", {
+          ref: requireTarget(args, "change")
+        });
+      }
+    }),
+    clear: defineCommand({
+      meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
+      run: async () => {
+        await draftAction("/api/tag-manager/draft/clear", {});
+      }
+    })
+  }
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-CQFIWAI4.js.map

package/dist/draft-WJTBY4G5.js

@@ -0,0 +1,217 @@
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import {
+  failApi,
+  failValidation,
+  isTempId
+} from "./chunk-FSLFQHWG.js";
+import {
+  REMOVABLE_DRAFT_OP_KINDS
+} from "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-NU7JSWVA.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-WJTBY4G5.js.map