@koda-sl/baker-cli 0.571.0-dev.6a3439a0a → 0.572.0-dev.61ba69c66

package/dist/draft-A7ZQPUFS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/draft.ts","../src/commands/ads/google/draft-batch.ts","../src/commands/ads/google/draft-validate.ts","../src/commands/ads/google/draft-where.ts"],"sourcesContent":["import type { GoogleDraftListResponse, GoogleDraftValidateResponse } from \"@baker/api/ads-google\";\nimport type { GoogleDraftImportResponse } from \"@baker/api/ads-google/wire\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHAT_READ_ARG, DRAFT_FULL_ARG } from \"../../chat-arg.ts\";\nimport { draftRefs, removeDraftRefs } from \"../../draft-refs.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { amendBatchEntries, stageFileOps } from \"./draft-batch.ts\";\nimport { validationEnvelope } from \"./draft-validate.ts\";\nimport { parseDraftWhere, selectDraftRefs } from \"./draft-where.ts\";\nimport {\n  draftAction,\n  draftListAction,\n  failWriteValidation,\n  handleGoogleError,\n  loadJsonPayloads,\n  loadPatchArg,\n  requireTarget,\n  stageGoogleOps,\n} from \"./write-shared.ts\";\n\nconst VALIDATE_DESCRIPTION = `Ask Google whether the whole staged draft would publish — without applying anything.\n\nStart here, after the last staged change and before telling the user the draft is ready:\n  baker ads google draft validate\n\nEvery staged op is built, batched and sent exactly as publish sends it, with Google's validateOnly\nflag, so each verdict is the answer publish would get: accepted | refused | blocked (a change it\ndepends on was refused) | unchecked (only publish can check it) | applied (an earlier publish did).\nCompact by default — counts, plus only the ops that need attention, each with Google's reason.\nFix refused ops with \\`draft amend <ref>\\` and validate again.\n\nIt also reads Baker's day of Google Ads changes, shared by every company. When the draft does\nnot all fit in what is left, the answer carries dailyLimit: operations, room and fitsAt (ISO, when\nall of it should have gone). Publish still works: Baker sends what Google Ads takes and the rest\nagain on its own. Never mention the limit, a quota or operation counts to the user, and never ask\nthem to cut down or split their work for it; say only that some changes go live over the next\nhours, and by when.\n\nExamples:\n  baker ads google draft validate\n  baker ads google draft validate --full   # every op, with its built request and Google's raw answer`;\n\nregisterSchema({\n  command: \"ads.google.draft.validate\",\n  description: VALIDATE_DESCRIPTION,\n  args: {\n    full: {\n      type: \"boolean\",\n      description: \"List every op with its built request and Google's raw answer\",\n      required: false,\n    },\n  },\n});\n\nconst STAGE_DESCRIPTION = `Stage many Google Ads changes from ONE file, in one call — any mix of kinds, up to 500 ops.\n\nStart here whenever a change touches more than a few rows (a keyword cleanup, bid changes, pausing\nads, a list of negatives): write the ops to a file and stage them together instead of running one\ncommand per row.\n  baker ads google draft stage --file changes.json --customer-id 1234567890\n\nThe file is a JSON array (or JSON Lines, one op per line). Each op is what the single commands\nbuild — kind, customerId (or --customer-id for all), target for a change to something that exists,\npayload. Read the shape for a kind with \\`baker capabilities google-ads\\`.\n  [\n    {\"kind\":\"google.keyword.add\",\"payload\":{\"adGroup\":\"customers/1234567890/adGroups/111\",\"text\":\"solar panels\",\"matchType\":\"PHRASE\"}},\n    {\"kind\":\"google.keyword.update\",\"target\":\"customers/1234567890/adGroupCriteria/111~222\",\"payload\":{\"status\":\"PAUSED\"}},\n    {\"kind\":\"google.negativeKeyword.add\",\"payload\":{\"level\":\"campaign\",\"parent\":\"222333\",\"text\":\"free\",\"matchType\":\"BROAD\"}}\n  ]\nAn op may name a g_temp_* ref an EARLIER call returned (a campaign or ad group staged before), but\nnot another op in the same file — a ref exists only once its op is staged, so stage new parents first.\nAll-or-nothing: one invalid op stages nothing. Ops already in effect come back as skipped.\nThen: baker ads google draft validate`;\n\nregisterSchema({\n  command: \"ads.google.draft.stage\",\n  description: STAGE_DESCRIPTION,\n  args: {\n    file: {\n      type: \"string\",\n      description: \"JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline\",\n      required: true,\n    },\n    \"customer-id\": {\n      type: \"string\",\n      description: \"10-digit customer id for every op that does not name its own\",\n      required: false,\n    },\n  },\n});\n\nconst IMPORT_DESCRIPTION = `Move another unpublished chat's staged Google Ads changes into this chat, in one call — and out of that chat, so the two can never publish the same change twice.\n\nStart here when the user wants another chat's changes brought into this one (\"bring over\", \"merge\",\n\"include what the other chat prepared\", \"all of them except …\"):\n  baker ads google draft import --from-chat <chat-id>\n  baker ads google draft import --from-chat <chat-id> --exclude g_temp_a,customers/123/adGroupAds/4~5\n  baker ads google draft import --from-chat <chat-id> --refs g_temp_b\n\nEvery op moves exactly as it was staged — same ref, same payload, nothing retyped — so never copy\nanother chat's changes with \\`draft show --chat\\` and re-stage them. An op moves with the creates it\ndepends on and the ops that depend on it (an asset and the link that attaches it go together).\nThe other chat must be unpublished — still open, or its publish failed (a discarded chat's Google Ads\nchanges are gone with it); its other work (Knowledge, Tasks) stays where it is. A published chat's changes its publish could not apply come\nwith \\`baker chats import --from-chat <chat-id> --failed\\` instead. Find chat ids\nwith \\`baker chats list\\`, and refs with \\`baker ads google draft list --chat <chat-id> --json\\`.\nThen: baker ads google draft validate`;\n\nregisterSchema({\n  command: \"ads.google.draft.import\",\n  description: IMPORT_DESCRIPTION,\n  args: {\n    \"from-chat\": {\n      type: \"string\",\n      description: \"The other unpublished chat (open, or its publish failed) whose staged changes move here\",\n      required: true,\n    },\n    refs: {\n      type: \"string\",\n      description: \"Comma-separated refs to move (default: all); what they depend on comes too\",\n      required: false,\n    },\n    exclude: {\n      type: \"string\",\n      description: \"Comma-separated refs to leave in the other chat, with the ops that depend on them\",\n      required: false,\n    },\n  },\n});\n\nconst LIST_DESCRIPTION =\n  \"Review everything staged as a campaign ▸ ad group ▸ ad tree (--json for the raw envelope, --full for every op's payload too)\";\n\nregisterSchema({\n  command: \"ads.google.draft.list\",\n  description: LIST_DESCRIPTION,\n  args: {\n    json: { type: \"boolean\", description: \"Print the raw JSON envelope instead of the readable tree\", required: false },\n    full: { type: \"boolean\", description: DRAFT_FULL_ARG.description, required: false },\n    chat: { type: \"string\", description: CHAT_READ_ARG.description, required: false },\n  },\n});\n\nconst WHERE_ARGS = {\n  where: {\n    type: \"string\",\n    description:\n      \"Select staged ops instead of naming refs: comma-separated key=value — kind (op kind), under (a campaign/ad group ref or resource name the op sits under), or any payload field (matchType, text, level, parent…); `|` for alternatives\",\n    required: false,\n  },\n  \"dry-run\": { type: \"boolean\", description: \"Print the refs that would change, and change nothing\", required: false },\n} as const;\n\nconst REMOVE_DESCRIPTION = `Remove staged ops — one, many, or every op a selector matches, in one call. Each removal cascades to the ops that depend on it.\n\n  baker ads google draft remove g_temp_a\n  baker ads google draft remove g_temp_a g_temp_b g_temp_c     # or g_temp_a,g_temp_b,g_temp_c\n  baker ads google draft remove --where 'kind=google.negativeKeyword.add,text=twilio|baileys'\n  baker ads google draft remove --where kind=google.keyword.add,under=g_temp_c1 --dry-run\n\nPrints one summary: every op removed (cascades listed once), and any ref the draft did not hold.`;\n\nconst REMOVE_ARGS = {\n  ref: {\n    type: \"positional\",\n    description: \"Staged op ref(s) (g_temp_* or target) — several, space- or comma-separated\",\n    required: false,\n  },\n  ...WHERE_ARGS,\n} as const;\n\nregisterSchema({ command: \"ads.google.draft.remove\", description: REMOVE_DESCRIPTION, args: REMOVE_ARGS });\n\nconst AMEND_DESCRIPTION = `Update staged ops in place — merges a JSON patch into each payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create.\n\n  baker ads google draft amend g_temp_a --patch '{\"cpcBidMicros\":1500000}'\n  baker ads google draft amend g_temp_a g_temp_b --patch '{\"status\":\"ENABLED\"}'      # same patch, many refs\n  baker ads google draft amend --where kind=google.keyword.add,under=g_temp_c1,matchType=EXACT --patch '{\"matchType\":\"BROAD\"}'\n  baker ads google draft amend --file amends.json      # [{\"ref\":\"g_temp_…\",\"patch\":{…}}, …] — a patch per ref\n\nMany refs are amended in one call, all or none: one refused amend changes nothing.`;\n\nconst AMEND_ARGS = {\n  ref: {\n    type: \"positional\",\n    description:\n      \"Staged op ref(s) (g_temp_*) or target id/resource name — several, space- or comma-separated, take the same patch; leave out to amend many from --file\",\n    required: false,\n  },\n  file: {\n    type: \"string\",\n    description: 'JSON file with the patch object — or, with no ref, a JSON array of {\"ref\",\"patch\"} amends',\n    required: false,\n  },\n  patch: { type: \"string\", description: \"Inline JSON patch object\", required: false },\n  ...WHERE_ARGS,\n} as const;\n\nregisterSchema({ command: \"ads.google.draft.amend\", description: AMEND_DESCRIPTION, args: AMEND_ARGS });\n\n/**\n * The refs `--where` selects from the staged draft, or undefined without it. Exits with the reason\n * when it cannot select: a malformed selector, refs passed too, or nothing staged that matches.\n */\nasync function refsWhere(args: Record<string, unknown>): Promise<string[] | undefined> {\n  if (typeof args.where !== \"string\") return undefined;\n  const where = parseDraftWhere(args.where);\n  if (\"error\" in where) failWriteValidation(where.error);\n  if (draftRefs(args._).length > 0) failWriteValidation(\"pass refs or --where, not both\");\n  let ops: GoogleDraftListResponse[\"ops\"] = [];\n  try {\n    const response = await apiPost<{ ok: boolean; data?: GoogleDraftListResponse }>(\"/api/ads/google/draft\", {\n      chatId: requireChatId(),\n      full: true,\n    });\n    ops = response.data?.ops ?? [];\n  } catch (err) {\n    handleGoogleError(err);\n  }\n  const refs = selectDraftRefs(ops, where);\n  if (refs.length === 0) {\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"NOT_FOUND\",\n        message: `--where ${args.where} matches no staged op`,\n        fix: \"Read the staged ops' kinds and payload fields with `baker ads google draft list --full`, then adjust the selector.\",\n      },\n    });\n    process.exit(1);\n  }\n  return refs;\n}\n\n/** `--dry-run`: the refs the command would change, printed instead of changing them. */\nfunction printDryRun(refs: string[]): void {\n  writeJsonEnvelope({\n    ok: true,\n    data: { matched: refs.length, refs },\n    hints: [\"Nothing changed. Run it again without --dry-run to apply it.\"],\n  });\n}\n\n/** The refs a comma-separated flag names: undefined when the flag is absent, null when it names none. */\nfunction refList(value: unknown): string[] | undefined | null {\n  if (typeof value !== \"string\") return undefined;\n  const refs = value\n    .split(\",\")\n    .map((ref) => ref.trim())\n    .filter((ref) => ref.length > 0);\n  return refs.length > 0 ? refs : null;\n}\n\n/** What the agent needs after a move: the next step, and what the other chat now holds. */\nexport function importHints(fromChatId: string, data: GoogleDraftImportResponse): string[] {\n  const source =\n    data.sourceRemaining > 0\n      ? `Chat ${fromChatId} still has ${data.sourceRemaining} Google Ads change(s) staged, which publish with that chat.`\n      : `Chat ${fromChatId} has no Google Ads changes staged any more, so publishing it cannot apply these twice. Its other work stays there — never tell the user to discard it for this.`;\n  return [source, \"Run `baker ads google draft validate` next.\"];\n}\n\n/** After a bulk stage: what to do next, and the reminder that the file — not a loop — is the tool. */\nexport const BULK_STAGE_HINTS = [\n  \"Run `baker ads google draft validate` next: it asks Google about every staged op at once and lists only the ones it would refuse.\",\n  'To fix several staged ops, amend them together: `baker ads google draft amend --file amends.json` with [{\"ref\":\"…\",\"patch\":{…}}, …].',\n];\n\n/** Review and undo staged Google Ads ops on this chat's draft; `list`/`show` can also read another chat's. */\nexport const draftCommand = defineCommand({\n  meta: {\n    name: \"draft\",\n    description:\n      \"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; `import --from-chat <id>` moves another unpublished chat's staged changes here (open, or its publish failed).\",\n  },\n  subCommands: {\n    stage: defineCommand({\n      meta: { name: \"stage\", description: STAGE_DESCRIPTION },\n      args: {\n        file: {\n          type: \"string\",\n          description: \"JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline\",\n        },\n        \"customer-id\": { type: \"string\", description: \"10-digit customer id for every op that does not name its own\" },\n      },\n      run: async ({ args }) => {\n        const customerId = typeof args[\"customer-id\"] === \"string\" ? args[\"customer-id\"] : undefined;\n        await stageGoogleOps(stageFileOps(loadJsonPayloads(args.file), customerId), BULK_STAGE_HINTS);\n      },\n    }),\n    import: defineCommand({\n      meta: { name: \"import\", description: IMPORT_DESCRIPTION },\n      args: {\n        \"from-chat\": {\n          type: \"string\",\n          description: \"The other unpublished chat (open, or its publish failed) whose staged changes move here\",\n        },\n        refs: { type: \"string\", description: \"Comma-separated refs to move (default: all)\" },\n        exclude: { type: \"string\", description: \"Comma-separated refs to leave in the other chat\" },\n      },\n      run: async ({ args }) => {\n        const fromChatId = typeof args[\"from-chat\"] === \"string\" ? args[\"from-chat\"].trim() : \"\";\n        if (!fromChatId) {\n          writeJsonEnvelope({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: \"--from-chat is required\",\n              fix: \"Name the other chat: baker ads google draft import --from-chat <chat-id> (ids from `baker chats list`).\",\n            },\n          });\n          process.exit(1);\n        }\n        const refs = refList(args.refs);\n        const exclude = refList(args.exclude);\n        const empty = refs === null ? \"--refs\" : exclude === null ? \"--exclude\" : undefined;\n        if (empty) {\n          // An empty selection must never widen to \"every change\": the move takes them out of the other chat.\n          writeJsonEnvelope({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: `${empty} names no change`,\n              fix: `Pass the refs, comma-separated (from \\`baker ads google draft list --chat ${fromChatId} --json\\`), or leave ${empty} off to move every change.`,\n            },\n          });\n          process.exit(1);\n        }\n        try {\n          const response = await apiPost<{ ok: boolean; data?: GoogleDraftImportResponse }>(\n            \"/api/ads/google/draft/import\",\n            { chatId: requireChatId(), fromChatId, refs: refs ?? undefined, exclude: exclude ?? undefined },\n          );\n          writeJsonEnvelope(\n            response.ok && response.data ? { ...response, hints: importHints(fromChatId, response.data) } : response,\n          );\n        } catch (err) {\n          handleGoogleError(err);\n        }\n      },\n    }),\n    list: defineCommand({\n      meta: {\n        name: \"list\",\n        description: LIST_DESCRIPTION,\n      },\n      args: {\n        json: { type: \"boolean\", description: \"Print the raw JSON envelope instead of the readable tree\" },\n        full: DRAFT_FULL_ARG,\n        chat: CHAT_READ_ARG,\n      },\n      run: async ({ args }) => {\n        await draftListAction(args.json === true, args.chat, args.full === true);\n      },\n    }),\n    remove: defineCommand({\n      meta: { name: \"remove\", description: REMOVE_DESCRIPTION },\n      args: REMOVE_ARGS,\n      run: async ({ args }) => {\n        const selected = await refsWhere(args);\n        const refs = selected ?? draftRefs(args._);\n        if (args[\"dry-run\"] === true) {\n          printDryRun(refs);\n          return;\n        }\n        if (selected || refs.length > 1) {\n          await removeDraftRefs(\"/api/ads/google/draft/remove\", refs);\n          return;\n        }\n        await draftAction(\"/api/ads/google/draft/remove\", { ref: requireTarget(args, \"op\") });\n      },\n    }),\n    clear: defineCommand({\n      meta: { name: \"clear\", description: \"Discard all staged ops on this chat\" },\n      run: async () => {\n        await draftAction(\"/api/ads/google/draft/clear\", {});\n      },\n    }),\n    amend: defineCommand({\n      meta: { name: \"amend\", description: AMEND_DESCRIPTION },\n      args: AMEND_ARGS,\n      run: async ({ args }) => {\n        const selected = await refsWhere(args);\n        const positional = Array.isArray(args._) ? args._[0] : undefined;\n        if (!selected && !(args.ref ?? positional) && typeof args.file === \"string\" && args.file.length > 0) {\n          const amends = amendBatchEntries(loadJsonPayloads(args.file));\n          if (args[\"dry-run\"] === true) {\n            printDryRun(amends.map((amend) => amend.ref));\n            return;\n          }\n          await draftAction(\"/api/ads/google/draft/amend-batch\", { amends });\n          return;\n        }\n        const refs = selected ?? draftRefs(args._);\n        if (args[\"dry-run\"] === true) {\n          printDryRun(refs);\n          return;\n        }\n        if (selected || refs.length > 1) {\n          const patch = loadPatchArg(args);\n          await draftAction(\"/api/ads/google/draft/amend-batch\", { amends: refs.map((ref) => ({ ref, patch })) });\n          return;\n        }\n        const ref = requireTarget(args, \"op\");\n        const patch = loadPatchArg(args);\n        await draftAction(\"/api/ads/google/draft/amend\", { ref, patch });\n      },\n    }),\n    validate: defineCommand({\n      meta: { name: \"validate\", description: VALIDATE_DESCRIPTION },\n      args: {\n        full: { type: \"boolean\", description: \"List every op with its built request and Google's raw answer\" },\n      },\n      run: async ({ args }) => {\n        try {\n          const full = args.full === true;\n          const response = await apiPost<{ ok: boolean; data?: GoogleDraftValidateResponse }>(\n            \"/api/ads/google/draft/validate\",\n            { chatId: requireChatId(), full },\n          );\n          writeJsonEnvelope(response.ok && response.data ? validationEnvelope(response.data, full) : response);\n        } catch (err) {\n          handleGoogleError(err);\n        }\n      },\n    }),\n    show: defineCommand({\n      meta: {\n        name: \"show\",\n        description:\n          \"Print the full staged payload for one op — the receipt to verify a change looks right before publish (never truncated).\",\n      },\n      args: {\n        ref: {\n          type: \"positional\",\n          description: \"Staged op ref (g_temp_*) or target id/resource name\",\n          required: false,\n        },\n        chat: CHAT_READ_ARG,\n      },\n      run: async ({ args }) => {\n        await draftAction(\"/api/ads/google/draft/show\", { ref: requireTarget(args, \"op\") }, args.chat);\n      },\n    }),\n  },\n});\n","import { GOOGLE_DRAFT_BATCH_MAX } from \"@baker/api/ads-google\";\nimport { failWriteValidation } from \"./write-shared.ts\";\n\n/**\n * The bulk halves of `draft`: one file of many changes, staged or amended in ONE request. A bulk\n * change done as a loop of single commands is one request, one rate-limit hit and one tool call per\n * row — production saw 1,284 such calls — while a file is one of each for up to 500 rows.\n */\n\nfunction refuseOversized(count: number, what: string): void {\n  if (count > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(\n      `${count} ${what} exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split the file and run the command once per part`,\n    );\n  }\n}\n\n/**\n * `draft stage --file` items → ops: each item is a whole op (`kind`, `customerId`, `target` for a\n * change to something that exists, `payload`); `--customer-id` fills the account on items that leave\n * it out, so a one-account file need not repeat it. The ops are preflighted by `stageGoogleOps`.\n */\nexport function stageFileOps(\n  items: ReadonlyArray<Record<string, unknown>>,\n  customerId: string | undefined,\n): Array<Record<string, unknown>> {\n  if (items.length === 0) {\n    failWriteValidation(\n      'pass --file with the ops to stage: a JSON array (or JSON Lines) of {\"kind\",\"customerId\",\"target\"?,\"payload\"?}',\n    );\n  }\n  refuseOversized(items.length, \"ops\");\n  return items.map((item, index) => {\n    if (typeof item.kind !== \"string\") {\n      failWriteValidation(\n        `item ${index} has no \"kind\" — every item is a whole op, e.g. {\"kind\":\"google.keyword.add\",…}`,\n      );\n    }\n    return item.customerId === undefined && customerId ? { ...item, customerId } : item;\n  });\n}\n\n/** `draft amend --file` items → the amend batch: each `{ ref, patch }` exactly as `draft amend <ref>` takes it. */\nexport function amendBatchEntries(\n  items: ReadonlyArray<Record<string, unknown>>,\n): Array<{ ref: string; patch: Record<string, unknown> }> {\n  refuseOversized(items.length, \"amends\");\n  return items.map((item, index) => {\n    const { ref, patch } = item;\n    if (typeof ref !== \"string\" || ref.length === 0) {\n      failWriteValidation(`item ${index} has no \"ref\" — name the staged op (g_temp_* or its target) to amend`);\n    }\n    if (patch === null || typeof patch !== \"object\" || Array.isArray(patch)) {\n      failWriteValidation(`item ${index} has no \"patch\" object — {\"ref\":\"…\",\"patch\":{…fields to change…}}`);\n    }\n    return { ref, patch: patch as Record<string, unknown> };\n  });\n}\n","import type { GoogleDraftOpVerdict, GoogleDraftValidateResponse } from \"@baker/api/ads-google\";\n\n/** Verdicts that need nothing from the agent — counted, never listed in the compact view. */\nconst QUIET: ReadonlySet<GoogleDraftOpVerdict[\"verdict\"]> = new Set([\"accepted\", \"applied\"]);\n\nfunction changes(n: number): string {\n  return n === 1 ? \"1 change\" : `${n} changes`;\n}\n\n/** What to do next, read off the counts — the agent decides from these without re-reading every op. */\nfunction validationHints(data: GoogleDraftValidateResponse): string[] {\n  const { refused, blocked, unchecked } = data.counts;\n  const hints: string[] = [];\n  if (refused > 0) {\n    hints.push(\n      `${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.`,\n    );\n  }\n  if (blocked > 0) {\n    hints.push(\n      `${changes(blocked)} would not apply only because a refused change they depend on fails — fixing the refused one clears them.`,\n    );\n  }\n  if (data.publishHeld) {\n    hints.push(\n      \"Baker would hold this whole publish: a refused change stops a first publish from sending anything. Fix it first.\",\n    );\n  }\n  if (unchecked > 0) {\n    hints.push(\n      `${changes(unchecked)} can only be checked by Google at publish (the reason is on each one). Nothing here says they will fail.`,\n    );\n  }\n  if (refused + blocked === 0 && !data.publishHeld && data.ops.length > 0) {\n    hints.push(\n      \"Google accepted every change it was asked about. The draft is ready for the user to review and publish.\",\n    );\n  }\n  if (data.dailyLimit) {\n    hints.push(\n      `Not every change may go live the moment the user publishes: Baker sends what Google Ads takes then and the rest again on its own, all by about ${data.dailyLimit.fitsAt}, with nothing for the user to do. If you tell the user anything, say only that some changes will go live over the next hours and by when, in their time zone. Never mention a daily limit, quota, allowance or number of operations, and never ask them to cut down or split their work for it.`,\n    );\n  }\n  return hints;\n}\n\n/**\n * The `draft validate` envelope. Compact by default: counts for everything, and only the ops that\n * need attention listed — a 300-keyword draft that Google accepts reads as one line, not 300.\n * `full` keeps every op with its built request and Google's raw answer.\n */\nexport function validationEnvelope(\n  data: GoogleDraftValidateResponse,\n  full = false,\n): { ok: true; data: GoogleDraftValidateResponse; hints: string[] } {\n  const ops = full ? data.ops : data.ops.filter((op) => !QUIET.has(op.verdict));\n  return { ok: true, data: { ...data, ops }, hints: validationHints(data) };\n}\n","import type { GoogleDraftListResponse } from \"@baker/api/ads-google\";\n\n/**\n * `draft remove|amend --where kind=…,under=…,<payload field>=…` — pick staged ops by what they are\n * instead of by ref, so a cleanup over a whole campaign (\"every EXACT keyword under it → BROAD\") is\n * one command, not a draft dump, a script and a call per op.\n */\n\ntype DraftOp = GoogleDraftListResponse[\"ops\"][number];\n\nexport interface DraftWhere {\n  /** Op kinds, `google.` prefix optional. */\n  kinds: string[];\n  /** Refs or resource names the op sits under: through its staged parents, or named in its payload. */\n  under: string[];\n  /** Top-level payload fields and the values (any of, case-insensitive) they must hold. */\n  fields: Record<string, string[]>;\n}\n\n/** Parse the selector, or say what is wrong with it. `|` separates alternatives: `matchType=EXACT|PHRASE`. */\nexport function parseDraftWhere(value: string): DraftWhere | { error: string } {\n  const where: DraftWhere = { kinds: [], under: [], fields: {} };\n  const pairs = value\n    .split(\",\")\n    .map((pair) => pair.trim())\n    .filter(Boolean);\n  if (pairs.length === 0) return { error: \"--where names no condition\" };\n  for (const pair of pairs) {\n    const eq = pair.indexOf(\"=\");\n    const key = pair.slice(0, eq).trim();\n    const values = pair\n      .slice(eq + 1)\n      .split(\"|\")\n      .map((v) => v.trim())\n      .filter(Boolean);\n    if (eq <= 0 || values.length === 0) return { error: `--where condition \"${pair}\" is not key=value` };\n    if (key === \"kind\") where.kinds.push(...values.map((k) => (k.startsWith(\"google.\") ? k : `google.${k}`)));\n    else if (key === \"under\") where.under.push(...values);\n    else where.fields[key] = [...(where.fields[key] ?? []), ...values];\n  }\n  return where;\n}\n\nfunction payloadOf(op: DraftOp): Record<string, unknown> {\n  return typeof op.payload === \"object\" && op.payload !== null ? (op.payload as Record<string, unknown>) : {};\n}\n\n/** Everything an op sits under: its staged parents up the chain, and the ids its payload names. */\nfunction parentsOf(op: DraftOp, byRef: Map<string, DraftOp>): Set<string> {\n  const seen = new Set<string>();\n  const queue = [op];\n  for (let current = queue.shift(); current; current = queue.shift()) {\n    const named = Object.values(payloadOf(current)).filter((v): v is string => typeof v === \"string\");\n    for (const parent of [...current.dependsOn, ...named]) {\n      if (seen.has(parent)) continue;\n      seen.add(parent);\n      const staged = byRef.get(parent);\n      if (staged) queue.push(staged);\n    }\n  }\n  return seen;\n}\n\n/** The refs of the staged ops the selector matches, in staging order. */\nexport function selectDraftRefs(ops: readonly DraftOp[], where: DraftWhere): string[] {\n  const byRef = new Map(ops.map((op) => [op.ref, op]));\n  return ops\n    .filter((op) => {\n      if (where.kinds.length > 0 && !where.kinds.includes(op.kind)) return false;\n      if (where.under.length > 0) {\n        const parents = parentsOf(op, byRef);\n        if (!where.under.some((ref) => parents.has(ref))) return false;\n      }\n      const payload = payloadOf(op);\n      return Object.entries(where.fields).every(([key, values]) => {\n        const actual = payload[key];\n        if (typeof actual !== \"string\" && typeof actual !== \"number\" && typeof actual !== \"boolean\") return false;\n        return values.some((v) => v.toLowerCase() === String(actual).toLowerCase());\n      });\n    })\n    .map((op) => op.ref);\n}\n"],"mappings":"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","names":["patch","ref"]}

package/dist/draft-ILXHFWTT.js

@@ -0,0 +1,134 @@
+import {
+  draftAction,
+  draftList,
+  loadJsonArg,
+  requireTarget
+} from "./chunk-S7D4GTYY.js";
+import {
+  amendDraftRefs,
+  draftRefs,
+  removeDraftRefs
+} from "./chunk-XZO6ONVI.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-VF3W7CI7.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.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 },
+    full: { type: "boolean", description: DRAFT_FULL_ARG.description, 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, --full for every change's payload too)"
+      },
+      args: {
+        json: { type: "boolean", description: "Print the raw JSON envelope", required: false },
+        full: DRAFT_FULL_ARG,
+        chat: CHAT_READ_ARG
+      },
+      run: async ({ args }) => {
+        await draftList(args.json === true, args.chat, args.full === true);
+      }
+    }),
+    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. Many refs take the same patch in one call: draft amend <ref> <ref> --patch '{\u2026}'."
+      },
+      args: {
+        ref: {
+          type: "positional",
+          description: "Staged ref(s) or target id(s) \u2014 several, space- or comma-separated",
+          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 }) => {
+        const refs = draftRefs(args._);
+        if (refs.length > 1) {
+          await amendDraftRefs("/api/ga4/draft/amend", refs, loadJsonArg(args, "patch"));
+          return;
+        }
+        await draftAction("/api/ga4/draft/amend", {
+          ref: requireTarget(args, "change"),
+          patch: loadJsonArg(args, "patch")
+        });
+      }
+    }),
+    remove: defineCommand({
+      meta: {
+        name: "remove",
+        description: "Remove staged changes \u2014 one, or many in one call: baker ga4 draft remove <ref> <ref> \u2026"
+      },
+      args: {
+        ref: {
+          type: "positional",
+          description: "Staged ref(s) or target id(s) \u2014 several, space- or comma-separated",
+          required: false
+        }
+      },
+      run: async ({ args }) => {
+        const refs = draftRefs(args._);
+        if (refs.length > 1) {
+          await removeDraftRefs("/api/ga4/draft/remove", refs);
+          return;
+        }
+        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-ILXHFWTT.js.map

package/dist/draft-NUFU5YME.js

@@ -0,0 +1,374 @@
+import {
+  failWriteValidation
+} from "./chunk-VHOOAQY4.js";
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import "./chunk-ASJMLTMX.js";
+import {
+  amendDraftRefs,
+  draftRefs,
+  removeDraftRefs
+} from "./chunk-XZO6ONVI.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-VF3W7CI7.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import "./chunk-YOHGEF2N.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-IMS53EQU.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-6LUDG5AB.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/draft.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/x/draft-status.ts
+var OPERATION_LABELS = {
+  create: "Creating",
+  update: "Updating",
+  pause: "Pausing",
+  resume: "Resuming",
+  remove: "Removing"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  return label ?? (node.existing ? "on X" : "staged");
+}
+function collectionLine(collection) {
+  const parts = [];
+  if (collection.added > 0) {
+    parts.push(`+${collection.added}`);
+  }
+  if (collection.existing > 0) {
+    parts.push(`${collection.existing} existing`);
+  }
+  if (collection.removed > 0) {
+    parts.push(`-${collection.removed}`);
+  }
+  return parts.length > 0 ? `${collection.label}: ${parts.join(", ")}` : void 0;
+}
+function accountsInTree(nodes) {
+  const accounts = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    accounts.add(node.accountId);
+    for (const child of node.children) {
+      walk(child);
+    }
+  };
+  for (const node of nodes) {
+    walk(node);
+  }
+  return accounts;
+}
+function renderNode(node, depth, showAccount, out) {
+  const indent = "  ".repeat(depth);
+  const account = showAccount ? ` [${node.accountId}]` : "";
+  out.push(`${indent}${node.entity}: ${node.name} \u2014 ${badge(node)}${account}`);
+  for (const collection of node.collections) {
+    const line = collectionLine(collection);
+    if (line) {
+      out.push(`${indent}  ${line}`);
+    }
+  }
+  for (const warning of node.warnings ?? []) {
+    out.push(`${indent}  ! ${warning}`);
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, showAccount, out);
+  }
+}
+var NO_CHANGES = "No X Ads changes staged";
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  discarded: "discarded"
+};
+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 `X Ads: ${draft.count} change${draft.count === 1 ? "" : "s"} ${heading}`;
+  }
+  const applied = draft.ops.filter(didApply).length;
+  const failed = draft.ops.filter(didNotApply).length;
+  return `X Ads: ${heading} \xB7 ${applied} applied${failed > 0 ? `, ${failed} failed` : ""}`;
+}
+function problemLines(draft) {
+  return draft.ops.filter(didNotApply).map((op) => {
+    const reason = op.result?.error ?? `skipped: waiting on ${op.result?.skippedBecause ?? "a change that did not apply"}`;
+    return `\u2717 ${op.summary} \u2014 failed: ${reason}`;
+  });
+}
+function renderDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return NO_CHANGES;
+  }
+  const out = [headingLine(draft), ""];
+  const tree = draft.tree ?? [];
+  const showAccount = accountsInTree(tree).size > 1;
+  for (const node of tree) {
+    renderNode(node, 0, showAccount, out);
+  }
+  const problems = problemLines(draft);
+  if (problems.length > 0) {
+    out.push("", ...problems);
+  }
+  return out.join("\n");
+}
+
+// src/commands/ads/x/draft.ts
+function handleDraftError(err) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, "\u2014"));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+registerSchema({
+  command: "ads.x.draft",
+  description: "Review everything staged for X 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 op that did not land.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable tree", required: false },
+    full: { type: "boolean", description: DRAFT_FULL_ARG.description, required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft(json, chat, full = false) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/x/draft", {
+      chatId,
+      ...full ? { full: true } : {}
+    });
+    if (json || full || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}
+`);
+  } catch (err) {
+    handleDraftError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign \u25B8 Ad group \u25B8 Ad tree. Example: baker ads x draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+    full: DRAFT_FULL_ARG,
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat, args.full === true);
+  }
+});
+registerSchema({
+  command: "ads.x.draft.show",
+  description: "The full staged payload, warnings and before-snapshot for one op \u2014 the receipt to check before publishing.",
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref (x_temp_* for creates, the target id for updates)",
+      required: true
+    },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show one staged op in full. Example: baker ads x draft show x_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref, or the target id for a staged update", required: true },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/ads/x/draft/show", {
+        chatId,
+        ref: String(args.ref)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.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) and the whole op re-validates.",
+  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 }
+  }
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: `Change a staged op in place.
+
+Examples:
+  baker ads x draft amend x_temp_abc '{"dailyBudgetAmountLocalMicro": 20000000}'
+  baker ads x draft amend x_temp_abc x_temp_def '{"entityStatus":"ACTIVE"}'   # many refs, one patch`
+  },
+  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", required: true }
+  },
+  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/x/draft/amend", refs, patch);
+      return;
+    }
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/amend", {
+        chatId,
+        ref: String(args.ref),
+        patch
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+var REMOVE_REF_ARG = {
+  ref: {
+    type: "positional",
+    description: "Op ref(s) or target id(s) \u2014 several, space- or comma-separated",
+    required: true
+  }
+};
+registerSchema({
+  command: "ads.x.draft.remove",
+  description: "Drop staged X ops \u2014 one, or many in one call. Removing a create cascades to everything staged that depends on it.",
+  args: REMOVE_REF_ARG
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop staged ops \u2014 one, or many in one call (cascades to their dependents). Example: baker ads x draft remove x_temp_abc123 x_temp_def456"
+  },
+  args: REMOVE_REF_ARG,
+  run: async ({ args }) => {
+    const refs = draftRefs(args._);
+    if (refs.length > 1) {
+      await removeDraftRefs("/api/ads/x/draft/remove", refs);
+      return;
+    }
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/remove", {
+        chatId,
+        ref: String(args.ref)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.draft.clear",
+  description: "Drop every staged X op on this chat. Nothing reached X, so nothing needs reversing.",
+  args: {}
+});
+var clearCommand = defineCommand({
+  meta: { name: "clear", description: "Drop every staged X op on this chat. Example: baker ads x draft clear" },
+  args: {},
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/clear", { chatId });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: `Review and edit the X Ads changes staged on this chat.
+
+Nothing staged has reached X. Everything applies when the chat is published,
+and discarding the chat reverses all of it.
+
+Examples:
+  baker ads x draft                       \u2014 the Campaign \u25B8 Ad group \u25B8 Ad tree
+  baker ads x draft show x_temp_abc123    \u2014 one op in full
+  baker ads x draft list --full           \u2014 every op in full, in one call
+  baker ads x draft amend x_temp_abc '{"name":"New"}'
+  baker ads x draft remove x_temp_abc123
+  baker ads x 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 running
+  // the matched subcommand, so every edit would also trigger a full list.
+  args: { json: { type: "boolean", description: "Raw JSON envelope" }, full: DRAFT_FULL_ARG, chat: CHAT_READ_ARG },
+  default: "list"
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-NUFU5YME.js.map