@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/chunk-6I7SYEYN.js

@@ -0,0 +1,166 @@
+import {
+  HEADLINE_SET_FLOOR,
+  SAME_CLAIM_HELD,
+  TELL_QUESTIONS,
+  copySentences,
+  sameClaimQuestion,
+  tellQuestionsFor
+} from "./chunk-4NZ47VXO.js";
+import {
+  rememberedJev
+} from "./chunk-I3DIZWN5.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-AUSKKFVH.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-HDHWIEJJ.js";
+import {
+  CAPABILITY_SURFACE_SPECS
+} from "./chunk-UI6BKYQD.js";
+
+// src/commands/capabilities/fix.ts
+function capabilityFix(surface) {
+  const spec = CAPABILITY_SURFACE_SPECS[surface];
+  return {
+    action: `baker capabilities ${surface}`,
+    explanation: `Do not guess another field name. \`baker capabilities ${surface}\` lists every ${spec.label} change with its required and optional fields and the exact values each field accepts, plus what cannot be changed here at all and why. Read it, then either re-stage correctly or tell the user this part is out of reach \u2014 and carry on with the rest of the job either way.`
+  };
+}
+
+// src/commands/ads/boolean-word-positional.ts
+var BOOLEAN_WORD = /^(true|false)$/i;
+function booleanWordPositionalError(args, entity) {
+  const positionals = Array.isArray(args._) ? args._ : [];
+  const word = positionals.find((value2) => typeof value2 === "string" && BOOLEAN_WORD.test(value2));
+  if (word === void 0) {
+    return void 0;
+  }
+  const value = word.toLowerCase();
+  const raised = Object.keys(args).filter((key) => key !== "_" && args[key] === true);
+  const named = raised.length > 0 ? raised.map((flag) => `--${flag}`).join(" or ") : "a boolean flag";
+  const fix = raised.length > 0 ? raised.map((flag) => `--${flag}=${value}`).join(" or ") : `--<flag>=${value}`;
+  const negated = raised.length === 1 && value === "false" ? ` (or --no-${raised[0]})` : "";
+  return `"${word}" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped \u2014 attach it instead: ${fix}${negated}.`;
+}
+
+// src/commands/ads/copy-hints.ts
+import path from "path";
+
+// src/engine/copy-tells/judge.ts
+var SAMPLE_MAX = 60;
+var sample = (text) => text.length <= SAMPLE_MAX ? text : `${text.slice(0, SAMPLE_MAX)}\u2026`;
+async function judgedCopyTells(input, ask) {
+  const sentences = input.texts.flatMap((t) => copySentences(t));
+  const pairs = (input.headlineSets ?? []).map((set) => set.map((h) => h.trim()).filter(Boolean)).filter((set) => set.length >= HEADLINE_SET_FLOOR).flatMap((set, s) => set.flatMap((a, i) => set.slice(i + 1).map((b) => ({ set: s, a, b }))));
+  const questions = [...sentences.flatMap(tellQuestionsFor), ...pairs.map(({ a, b }) => sameClaimQuestion(a, b))];
+  if (questions.length === 0) return [];
+  const answers = await ask(questions);
+  if (answers === null) return null;
+  const tells = [];
+  TELL_QUESTIONS.forEach((tell, t) => {
+    const hits = sentences.filter((_, s) => (answers[s * TELL_QUESTIONS.length + t] ?? 0) >= tell.threshold);
+    if (hits.length > 0) tells.push({ id: tell.id, count: hits.length, sample: sample(hits[0]?.text ?? "") });
+  });
+  const offset = sentences.length * TELL_QUESTIONS.length;
+  const cycled = pairs.filter((_, p) => (answers[offset + p] ?? 0) >= SAME_CLAIM_HELD);
+  for (const set of new Set(cycled.map((p) => p.set))) {
+    const inSet = cycled.filter((p) => p.set === set);
+    const { a, b } = inSet[0] ?? { a: "", b: "" };
+    tells.push({ id: "synonym-cycling", count: inSet.length, sample: sample(`"${a}" / "${b}"`) });
+  }
+  return tells;
+}
+
+// src/commands/ads/copy-hints.ts
+var COPY_KEYS = /* @__PURE__ */ new Set([
+  "headline",
+  "headlines",
+  "longheadline",
+  "longheadlines",
+  "shortheadline",
+  "shortheadlines",
+  "description",
+  "descriptions",
+  "primarytext",
+  "primarytexts",
+  "message",
+  "messages",
+  "commentary",
+  "body",
+  "bodies",
+  "text",
+  "calltoaction",
+  "linkdescription",
+  "sitelinktext",
+  "callout",
+  "callouts",
+  "introtext"
+]);
+var HEADLINE_SET_KEYS = /* @__PURE__ */ new Set(["headlines", "longheadlines", "shortheadlines"]);
+var MAX_HINTS = 5;
+var SYNONYM_PAIR_FLOOR = 2;
+function asStrings(value) {
+  const one = (v) => {
+    const text = typeof v === "string" ? v : v !== null && typeof v === "object" ? v.text : "";
+    return typeof text === "string" && text.trim() ? text : void 0;
+  };
+  const values = Array.isArray(value) ? value : [value];
+  return values.map(one).filter((v) => v !== void 0);
+}
+function collectCopy(value, depth = 0) {
+  const texts = [];
+  const headlineSets = [];
+  if (depth > 4 || value === null || typeof value !== "object") return { texts, headlineSets };
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const nested = collectCopy(item, depth + 1);
+      texts.push(...nested.texts);
+      headlineSets.push(...nested.headlineSets);
+    }
+    return { texts, headlineSets };
+  }
+  for (const [key, raw] of Object.entries(value)) {
+    const normalized = key.toLowerCase().replace(/[_-]/g, "");
+    const strings = COPY_KEYS.has(normalized) ? asStrings(raw) : [];
+    if (strings.length > 0) {
+      texts.push(...strings);
+      if (HEADLINE_SET_KEYS.has(normalized) && strings.length > 1) headlineSets.push(strings);
+      continue;
+    }
+    const nested = collectCopy(raw, depth + 1);
+    texts.push(...nested.texts);
+    headlineSets.push(...nested.headlineSets);
+  }
+  return { texts, headlineSets };
+}
+function hintFor(tell) {
+  if (tell.id === "synonym-cycling") {
+    return `AI COPY TELL \u2014 ${tell.count} headline pairs are the same claim reworded (${tell.sample}). A cycled set gives the auction nothing to choose between: make each headline a different claim, not a different verb.`;
+  }
+  return `AI COPY TELL (${tell.id}) \u2014 "${tell.sample}". This construction reads as machine-written; rewrite it as a plain, specific claim before publishing.`;
+}
+async function adCopyHints(payload, ask) {
+  const { texts, headlineSets } = collectCopy(payload);
+  if (texts.length === 0) return [];
+  const cacheDir = path.join(findWorkspaceRoot(process.cwd()) ?? process.cwd(), "canvas", ".cache");
+  const spent = [];
+  const judged = await judgedCopyTells(
+    { texts: texts.flatMap((t) => t.split("\n")), headlineSets },
+    ask ?? rememberedJev(path.join(cacheDir, "copy-tells.json"), (u) => spent.push(u))
+  ).catch(() => null);
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const cycled = (judged ?? []).filter((t) => t.id === "synonym-cycling" && t.count >= SYNONYM_PAIR_FLOOR).sort((a, b) => b.count - a.count).slice(0, 1);
+  const tells = [...cycled, ...(judged ?? []).filter((t) => t.id !== "synonym-cycling")];
+  tells.sort(
+    (a, b) => (b.id === "synonym-cycling" ? 1 : 0) - (a.id === "synonym-cycling" ? 1 : 0) || b.count - a.count
+  );
+  return tells.slice(0, MAX_HINTS).map(hintFor);
+}
+
+export {
+  capabilityFix,
+  booleanWordPositionalError,
+  adCopyHints
+};
+//# sourceMappingURL=chunk-6I7SYEYN.js.map

package/dist/chunk-6I7SYEYN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/capabilities/fix.ts","../src/commands/ads/boolean-word-positional.ts","../src/commands/ads/copy-hints.ts","../src/engine/copy-tells/judge.ts"],"sourcesContent":["import type { CapabilitySurfaceId } from \"@baker/api/capabilities\";\nimport { CAPABILITY_SURFACE_SPECS } from \"@baker/api/capabilities\";\n\n/**\n * A rejected change should say where the real contract is.\n *\n * The expensive version of \"this field is not valid\" is an agent trying four\n * spellings of a field that never existed, staging a bogus op, and cleaning it\n * up again — several turns, none of them work. The validation message already\n * names what was wrong with THIS attempt; this names the one call that lists\n * every field the change accepts and every value each one takes, so the next\n * attempt is informed rather than another guess.\n */\nexport function capabilityFix(surface: CapabilitySurfaceId): { action: string; explanation: string } {\n  const spec = CAPABILITY_SURFACE_SPECS[surface];\n  return {\n    action: `baker capabilities ${surface}`,\n    explanation:\n      `Do not guess another field name. \\`baker capabilities ${surface}\\` lists every ${spec.label} change with its ` +\n      \"required and optional fields and the exact values each field accepts, plus what cannot be changed here at all \" +\n      \"and why. Read it, then either re-stage correctly or tell the user this part is out of reach — and carry on \" +\n      \"with the rest of the job either way.\",\n  };\n}\n","/**\n * `--flag false` — the natural way to type a negation — is a citty trap, not a typo we can honour:\n * a boolean flag written with a space parses as the flag set to **TRUE** plus a stray positional\n * nobody consumes. The word does the OPPOSITE of what was typed and nothing fails, because the\n * target still resolves and the command still reports \"staged\". No layer downstream can catch it —\n * an inverted boolean is a valid op — so it has to be caught where the positionals are read.\n *\n * This is the same rule on every ad surface (it is citty's parse, not a platform's), but each\n * surface owns its own error envelope, so this returns the message and the caller fails with it.\n */\n\nconst BOOLEAN_WORD = /^(true|false)$/i;\n\n/**\n * The refusal message for a bare `true`/`false` sitting in the positionals, or `undefined` when\n * there is none. `entity` is the surface's own noun for what the positional addresses (\"campaign\",\n * \"ad set\", …), so the message reads as that command's vocabulary.\n */\nexport function booleanWordPositionalError(args: Record<string, unknown>, entity: string): string | undefined {\n  const positionals = Array.isArray(args._) ? args._ : [];\n  const word = positionals.find((value): value is string => typeof value === \"string\" && BOOLEAN_WORD.test(value));\n  if (word === undefined) {\n    return undefined;\n  }\n  const value = word.toLowerCase();\n  // Every flag citty just set to true, so the fix is copy-pasteable. Which one the word was meant for\n  // is unknowable from parsed args — it need not even follow that flag on the command line — so with\n  // several raised we list them all rather than inventing a single culprit the user never typed.\n  const raised = Object.keys(args).filter((key) => key !== \"_\" && args[key] === true);\n  const named = raised.length > 0 ? raised.map((flag) => `--${flag}`).join(\" or \") : \"a boolean flag\";\n  const fix = raised.length > 0 ? raised.map((flag) => `--${flag}=${value}`).join(\" or \") : `--<flag>=${value}`;\n  const negated = raised.length === 1 && value === \"false\" ? ` (or --no-${raised[0]})` : \"\";\n  return `\"${word}\" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped — attach it instead: ${fix}${negated}.`;\n}\n","/**\n * AI copy tells on staged ad copy → `hints[]`.\n *\n * Ad text is the surface where a tell costs real money and the one place we had\n * no copy check at all: staging validated character limits and policy, never\n * whether the words read like a model wrote them.\n *\n * ADVISORY BY CONSTRUCTION. These are hints, never errors — an ad refused over a\n * fallible prose heuristic costs more than a tell that ships, and the agent can\n * act on a hint in the same turn. Nothing here can fail a staged write.\n *\n * Thresholds differ from the landing gate on purpose. A landing needs a CLUSTER\n * before a tell means anything (`COPY_TELL_GATES`); a 30-character headline has\n * no room for a cluster, so one occurrence is the signal. The exclusion list\n * below is where most of the judgment lives.\n *\n * The tells that read the words are asked of the decision model, in whatever\n * language the ad is written; when it cannot answer, nothing is reported rather\n * than a guess.\n */\n\nimport path from \"node:path\";\nimport type { CopyTell } from \"../../engine/copy-tells/detect.ts\";\nimport { judgedCopyTells } from \"../../engine/copy-tells/judge.ts\";\nimport { type AskNouls, rememberedJev } from \"../../engine/lib/remembered-nouls.ts\";\nimport type { ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { holdUnbilledSpend } from \"../canvas/unbilled-spend.ts\";\n\n/*\n * The tells that are a shape (`structuralCopyTells`) do not apply to ad copy, and\n * none is hinted. Each is a real convention in this medium, so reporting it would\n * train the agent to ignore hints:\n *   - `title-case-heading` — English search ads are conventionally Title Case.\n *   - `staccato-drama` — \"Compara. Ahorra. Cambia.\" is ad rhythm, not drama.\n *   - `emoji` — deliberate and effective in Meta and LinkedIn primary text.\n *   - `curly-quote` — inserted automatically by every editor copy is pasted from.\n *   - `inline-header-list` — a markdown shape that ad fields cannot hold.\n */\n\n/**\n * Payload keys whose values are copy a human will read in the ad. Every platform\n * names its primary text differently in `@baker/api` — Meta stages it as\n * `message`, LinkedIn as `commentary` — so the concept appears here under each\n * of its contract names, not under one invented one.\n */\nconst COPY_KEYS = new Set([\n  \"headline\",\n  \"headlines\",\n  \"longheadline\",\n  \"longheadlines\",\n  \"shortheadline\",\n  \"shortheadlines\",\n  \"description\",\n  \"descriptions\",\n  \"primarytext\",\n  \"primarytexts\",\n  \"message\",\n  \"messages\",\n  \"commentary\",\n  \"body\",\n  \"bodies\",\n  \"text\",\n  \"calltoaction\",\n  \"linkdescription\",\n  \"sitelinktext\",\n  \"callout\",\n  \"callouts\",\n  \"introtext\",\n]);\n\n/** Keys holding a SET of headlines, where synonym cycling is meaningful. */\nconst HEADLINE_SET_KEYS = new Set([\"headlines\", \"longheadlines\", \"shortheadlines\"]);\n\n/**\n * At most this many hints, so copy advice never crowds out the staging result.\n *\n * Five, not three: a heavily model-written ad routinely carries six tells, and a\n * cap of three showed the agent half the diagnosis. Since it already has the copy\n * in front of it, fixing six constructions in one pass is cheaper than three\n * re-stagings that each reveal the next batch.\n */\nconst MAX_HINTS = 5;\n/** Two near-duplicate pairs; one pair in a 15-headline RSA is not a pattern. */\nconst SYNONYM_PAIR_FLOOR = 2;\n\n/**\n * The copy under a copy key, whether it is a plain string or a Google text\n * asset. Google stages EVERY ad text as `{ text, pinnedField? }`\n * (`adTextAssetSchema` in `@baker/api/ads-google`), so reading only strings here\n * would skip the whole Google surface — headlines, descriptions, long headline.\n */\nfunction asStrings(value: unknown): string[] {\n  const one = (v: unknown): string | undefined => {\n    const text = typeof v === \"string\" ? v : v !== null && typeof v === \"object\" ? (v as { text?: unknown }).text : \"\";\n    return typeof text === \"string\" && text.trim() ? text : undefined;\n  };\n  const values = Array.isArray(value) ? value : [value];\n  return values.map(one).filter((v): v is string => v !== undefined);\n}\n\n/** Walk a staged-op payload of unknown shape and pull out the human-readable\n * copy fields plus any headline sets. Depth-limited — payloads are shallow, and\n * an unbounded walk on a hostile shape is a hang, not a hint. */\nfunction collectCopy(value: unknown, depth = 0): { texts: string[]; headlineSets: string[][] } {\n  const texts: string[] = [];\n  const headlineSets: string[][] = [];\n  if (depth > 4 || value === null || typeof value !== \"object\") return { texts, headlineSets };\n\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      const nested = collectCopy(item, depth + 1);\n      texts.push(...nested.texts);\n      headlineSets.push(...nested.headlineSets);\n    }\n    return { texts, headlineSets };\n  }\n\n  for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n    const normalized = key.toLowerCase().replace(/[_-]/g, \"\");\n    const strings = COPY_KEYS.has(normalized) ? asStrings(raw) : [];\n    if (strings.length > 0) {\n      texts.push(...strings);\n      if (HEADLINE_SET_KEYS.has(normalized) && strings.length > 1) headlineSets.push(strings);\n      continue;\n    }\n    // A copy key holding neither a string nor a text asset (`call_to_action`)\n    // still gets walked — a matched key must never swallow the subtree.\n    const nested = collectCopy(raw, depth + 1);\n    texts.push(...nested.texts);\n    headlineSets.push(...nested.headlineSets);\n  }\n  return { texts, headlineSets };\n}\n\nfunction hintFor(tell: CopyTell): string {\n  if (tell.id === \"synonym-cycling\") {\n    return `AI COPY TELL — ${tell.count} headline pairs are the same claim reworded (${tell.sample}). A cycled set gives the auction nothing to choose between: make each headline a different claim, not a different verb.`;\n  }\n  return `AI COPY TELL (${tell.id}) — \"${tell.sample}\". This construction reads as machine-written; rewrite it as a plain, specific claim before publishing.`;\n}\n\n/**\n * Inspect a staged ad-copy payload and return advisory hints about AI writing\n * tells. Never throws; returns `[]` when the copy reads clean or the payload\n * carries no copy at all. `ask` is the decision model (the real one, its answers\n * kept in the workspace's canvas cache and its spend billed with the next run,\n * unless given).\n */\nexport async function adCopyHints(payload: unknown, ask?: AskNouls): Promise<string[]> {\n  const { texts, headlineSets } = collectCopy(payload);\n  if (texts.length === 0) return [];\n\n  const cacheDir = path.join(findWorkspaceRoot(process.cwd()) ?? process.cwd(), \"canvas\", \".cache\");\n  const spent: ReviewUsage[] = [];\n  // A line break in ad text is the author's, never a wrap: each line is read on its own.\n  const judged = await judgedCopyTells(\n    { texts: texts.flatMap((t) => t.split(\"\\n\")), headlineSets },\n    ask ?? rememberedJev(path.join(cacheDir, \"copy-tells.json\"), (u) => spent.push(u)),\n  ).catch(() => null);\n  await holdUnbilledSpend(cacheDir, spent).catch(() => undefined);\n\n  // The floor is per headline set (one per ad); only the most cycled set is hinted.\n  const cycled = (judged ?? [])\n    .filter((t) => t.id === \"synonym-cycling\" && t.count >= SYNONYM_PAIR_FLOOR)\n    .sort((a, b) => b.count - a.count)\n    .slice(0, 1);\n  const tells: CopyTell[] = [...cycled, ...(judged ?? []).filter((t) => t.id !== \"synonym-cycling\")];\n\n  // Loudest first: the cycled-headline finding is a set-level defect, and the\n  // rest sort by how often the tell fired.\n  tells.sort(\n    (a, b) => (b.id === \"synonym-cycling\" ? 1 : 0) - (a.id === \"synonym-cycling\" ? 1 : 0) || b.count - a.count,\n  );\n  return tells.slice(0, MAX_HINTS).map(hintFor);\n}\n","/**\n * The AI copy tells in a piece of copy that are a reading of its words, and synonym cycling in a\n * set of headlines, asked of the decision model (Jev) in one fanned-out set of requests, in\n * whatever language the copy is written. Raw counts, like `structuralCopyTells`: the caller gates.\n */\nimport type { AskNouls } from \"../lib/remembered-nouls.ts\";\nimport type { CopyTell } from \"./detect.ts\";\nimport { HEADLINE_SET_FLOOR } from \"./patterns.ts\";\nimport { SAME_CLAIM_HELD, sameClaimQuestion, TELL_QUESTIONS, tellQuestionsFor } from \"./questions.ts\";\nimport { copySentences } from \"./sentences.ts\";\n\nconst SAMPLE_MAX = 60;\nconst sample = (text: string) => (text.length <= SAMPLE_MAX ? text : `${text.slice(0, SAMPLE_MAX)}…`);\n\n/**\n * Every judged tell in `texts` (one count per sentence that carries it) and, for each headline set\n * of at least `HEADLINE_SET_FLOOR`, one `synonym-cycling` tell counting that set's pairs that are\n * one claim reworded. Null when the model could not answer: the caller reports nothing rather than\n * guess.\n */\nexport async function judgedCopyTells(\n  input: { texts: readonly string[]; headlineSets?: ReadonlyArray<readonly string[]> },\n  ask: AskNouls,\n): Promise<CopyTell[] | null> {\n  const sentences = input.texts.flatMap((t) => copySentences(t));\n  const pairs = (input.headlineSets ?? [])\n    .map((set) => set.map((h) => h.trim()).filter(Boolean))\n    .filter((set) => set.length >= HEADLINE_SET_FLOOR)\n    .flatMap((set, s) => set.flatMap((a, i) => set.slice(i + 1).map((b) => ({ set: s, a, b }))));\n  const questions = [...sentences.flatMap(tellQuestionsFor), ...pairs.map(({ a, b }) => sameClaimQuestion(a, b))];\n  if (questions.length === 0) return [];\n  const answers = await ask(questions);\n  if (answers === null) return null;\n\n  const tells: CopyTell[] = [];\n  TELL_QUESTIONS.forEach((tell, t) => {\n    const hits = sentences.filter((_, s) => (answers[s * TELL_QUESTIONS.length + t] ?? 0) >= tell.threshold);\n    if (hits.length > 0) tells.push({ id: tell.id, count: hits.length, sample: sample(hits[0]?.text ?? \"\") });\n  });\n  const offset = sentences.length * TELL_QUESTIONS.length;\n  const cycled = pairs.filter((_, p) => (answers[offset + p] ?? 0) >= SAME_CLAIM_HELD);\n  for (const set of new Set(cycled.map((p) => p.set))) {\n    const inSet = cycled.filter((p) => p.set === set);\n    const { a, b } = inSet[0] ?? { a: \"\", b: \"\" };\n    tells.push({ id: \"synonym-cycling\", count: inSet.length, sample: sample(`\"${a}\" / \"${b}\"`) });\n  }\n  return tells;\n}\n"],"mappings":"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","names":["value"]}

package/dist/chunk-6O7ISBC7.js

@@ -0,0 +1,65 @@
+import {
+  applyFieldMask,
+  compactWinningAd,
+  fullWinningAd,
+  winningAdNormalizer,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/winning-ads/adRows.ts
+var EVERY_SIGNAL = {
+  dna: {
+    visual: "-",
+    container: "-",
+    mechanism: "-",
+    audience_temperature: "-",
+    funnel_stage: "-",
+    advertiser_size: "-",
+    presumes_brand_knowledge: true,
+    brand_knowledge_reason: "-"
+  },
+  baker_uses: { companies: 1, ours: true, approved: 1, rejected: 1 },
+  source: "followed",
+  stage: "-",
+  survived_test: true
+};
+var COMPACT_FIELDS = new Set(Object.keys(compactWinningAd(EVERY_SIGNAL)));
+var ALL_FIELDS = Object.keys(fullWinningAd(EVERY_SIGNAL));
+function adFields(requested, full) {
+  if (!requested) return { fields: void 0, full };
+  const fields = requested.map((f) => f.trim()).filter(Boolean);
+  const invalid = fields.filter((f) => !ALL_FIELDS.includes(f));
+  if (invalid.length > 0) return { invalid, valid: ALL_FIELDS };
+  return { fields, full: full || fields.some((f) => !COMPACT_FIELDS.has(f)) };
+}
+function adFieldPlan(fields, full) {
+  const plan = adFields(fields ? String(fields).split(",") : void 0, Boolean(full));
+  if (!("invalid" in plan)) return plan;
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `Unknown --fields: ${plan.invalid.join(", ")}`,
+      fix: {
+        action: "retry_with_valid_values",
+        explanation: "Pass only fields an ad row carries.",
+        flag: "--fields",
+        invalidValues: plan.invalid,
+        validValues: plan.valid
+      }
+    }
+  });
+  process.exit(1);
+}
+function adRows(raw, plan) {
+  return raw.map((r) => {
+    const row = winningAdNormalizer(r, plan.full);
+    return plan.fields ? applyFieldMask(row, plan.fields) : row;
+  });
+}
+
+export {
+  adFieldPlan,
+  adRows
+};
+//# sourceMappingURL=chunk-6O7ISBC7.js.map

package/dist/chunk-6O7ISBC7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/adRows.ts"],"sourcesContent":["import { applyFieldMask, compactWinningAd, fullWinningAd, winningAdNormalizer, writeJson } from \"../../output.ts\";\n\n/**\n * The rows `search`, `feed`, `winners` and `ads` print: one ad each, compact\n * unless `--full`, cut to `--fields` in every output. Before, the JSON a\n * `feed`, `winners` or `ads` call prints ignored `--fields`, so an agent that\n * asked for three columns still read every row whole.\n */\n\nexport type AdFieldPlan = { fields: string[] | undefined; full: boolean };\n\n// A row with every optional signal set: its keys are every field an ad row can carry.\nconst EVERY_SIGNAL: Record<string, unknown> = {\n  dna: {\n    visual: \"-\",\n    container: \"-\",\n    mechanism: \"-\",\n    audience_temperature: \"-\",\n    funnel_stage: \"-\",\n    advertiser_size: \"-\",\n    presumes_brand_knowledge: true,\n    brand_knowledge_reason: \"-\",\n  },\n  baker_uses: { companies: 1, ours: true, approved: 1, rejected: 1 },\n  source: \"followed\",\n  stage: \"-\",\n  survived_test: true,\n};\nconst COMPACT_FIELDS = new Set(Object.keys(compactWinningAd(EVERY_SIGNAL)));\nconst ALL_FIELDS = Object.keys(fullWinningAd(EVERY_SIGNAL));\n\n/**\n * The `--fields` asked for, read the way an agent types them: names trimmed,\n * the full row when a name only `--full` carries is asked for, and a name no\n * row carries refused with the ones that exist. Before, each of those printed\n * an empty column.\n */\nexport function adFields(\n  requested: string[] | undefined,\n  full: boolean,\n): AdFieldPlan | { invalid: string[]; valid: string[] } {\n  if (!requested) return { fields: undefined, full };\n  const fields = requested.map((f) => f.trim()).filter(Boolean);\n  const invalid = fields.filter((f) => !ALL_FIELDS.includes(f));\n  if (invalid.length > 0) return { invalid, valid: ALL_FIELDS };\n  return { fields, full: full || fields.some((f) => !COMPACT_FIELDS.has(f)) };\n}\n\n/** The `--fields` plan of a command, or the refusal of a name no row carries (exits). */\nexport function adFieldPlan(fields: unknown, full: unknown): AdFieldPlan {\n  const plan = adFields(fields ? String(fields).split(\",\") : undefined, Boolean(full));\n  if (!(\"invalid\" in plan)) return plan;\n  writeJson({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: `Unknown --fields: ${plan.invalid.join(\", \")}`,\n      fix: {\n        action: \"retry_with_valid_values\",\n        explanation: \"Pass only fields an ad row carries.\",\n        flag: \"--fields\",\n        invalidValues: plan.invalid,\n        validValues: plan.valid,\n      },\n    },\n  });\n  process.exit(1);\n}\n\nexport function adRows(raw: readonly unknown[], plan: AdFieldPlan): Record<string, unknown>[] {\n  return raw.map((r) => {\n    const row = winningAdNormalizer(r as Record<string, unknown>, plan.full);\n    return plan.fields ? applyFieldMask(row, plan.fields) : row;\n  });\n}\n"],"mappings":";;;;;;;;;AAYA,IAAM,eAAwC;AAAA,EAC5C,KAAK;AAAA,IACH,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,WAAW;AAAA,IACX,sBAAsB;AAAA,IACtB,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,0BAA0B;AAAA,IAC1B,wBAAwB;AAAA,EAC1B;AAAA,EACA,YAAY,EAAE,WAAW,GAAG,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE;AAAA,EACjE,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,eAAe;AACjB;AACA,IAAM,iBAAiB,IAAI,IAAI,OAAO,KAAK,iBAAiB,YAAY,CAAC,CAAC;AAC1E,IAAM,aAAa,OAAO,KAAK,cAAc,YAAY,CAAC;AAQnD,SAAS,SACd,WACA,MACsD;AACtD,MAAI,CAAC,UAAW,QAAO,EAAE,QAAQ,QAAW,KAAK;AACjD,QAAM,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO;AAC5D,QAAM,UAAU,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,SAAS,CAAC,CAAC;AAC5D,MAAI,QAAQ,SAAS,EAAG,QAAO,EAAE,SAAS,OAAO,WAAW;AAC5D,SAAO,EAAE,QAAQ,MAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC,EAAE;AAC5E;AAGO,SAAS,YAAY,QAAiB,MAA4B;AACvE,QAAM,OAAO,SAAS,SAAS,OAAO,MAAM,EAAE,MAAM,GAAG,IAAI,QAAW,QAAQ,IAAI,CAAC;AACnF,MAAI,EAAE,aAAa,MAAO,QAAO;AACjC,YAAU;AAAA,IACR,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,qBAAqB,KAAK,QAAQ,KAAK,IAAI,CAAC;AAAA,MACrD,KAAK;AAAA,QACH,QAAQ;AAAA,QACR,aAAa;AAAA,QACb,MAAM;AAAA,QACN,eAAe,KAAK;AAAA,QACpB,aAAa,KAAK;AAAA,MACpB;AAAA,IACF;AAAA,EACF,CAAC;AACD,UAAQ,KAAK,CAAC;AAChB;AAEO,SAAS,OAAO,KAAyB,MAA8C;AAC5F,SAAO,IAAI,IAAI,CAAC,MAAM;AACpB,UAAM,MAAM,oBAAoB,GAA8B,KAAK,IAAI;AACvE,WAAO,KAAK,SAAS,eAAe,KAAK,KAAK,MAAM,IAAI;AAAA,EAC1D,CAAC;AACH;","names":[]}

package/dist/chunk-752S7JF6.js

@@ -0,0 +1,35 @@
+import {
+  ApiError
+} from "./chunk-HREWXNTO.js";
+import {
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/winning-ads/shared.ts
+function splitList(value) {
+  if (!value) {
+    return [];
+  }
+  return value.split(",").map((v) => v.trim()).filter(Boolean);
+}
+function reportError(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var PLATFORM_NAMES = {
+  meta: "Meta",
+  linkedin: "LinkedIn",
+  tiktok: "TikTok",
+  google: "Google Ads"
+};
+
+export {
+  splitList,
+  reportError,
+  PLATFORM_NAMES
+};
+//# sourceMappingURL=chunk-752S7JF6.js.map

package/dist/chunk-752S7JF6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/shared.ts"],"sourcesContent":["import type { AdLibraryPlatform } from \"@baker/api/ad-library\";\nimport { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\n\n/** Split a comma list into trimmed, non-empty tokens. */\nexport function splitList(value: string | undefined): string[] {\n  if (!value) {\n    return [];\n  }\n  return value\n    .split(\",\")\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\n/** Emit the `{ ok: false, error }` envelope and exit non-zero. */\nexport function reportError(err: unknown): never {\n  if (err instanceof ApiError) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\n/** Each platform as people name it, for hints. */\nexport const PLATFORM_NAMES: Record<AdLibraryPlatform, string> = {\n  meta: \"Meta\",\n  linkedin: \"LinkedIn\",\n  tiktok: \"TikTok\",\n  google: \"Google Ads\",\n};\n"],"mappings":";;;;;;;;AAKO,SAAS,UAAU,OAAqC;AAC7D,MAAI,CAAC,OAAO;AACV,WAAO,CAAC;AAAA,EACV;AACA,SAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACnB;AAGO,SAAS,YAAY,KAAqB;AAC/C,MAAI,eAAe,UAAU;AAC3B,cAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,UAAQ,KAAK,CAAC;AAChB;AAGO,IAAM,iBAAoD;AAAA,EAC/D,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AACV;","names":[]}

package/dist/chunk-77DN7R35.js

@@ -0,0 +1,228 @@
+import {
+  NUMERIC_ID_REGEX
+} from "./chunk-XX6ZMCY5.js";
+
+// ../api/src/ads-google/change-history.ts
+var CHANGE_SCOPES = ["detail", "summary"];
+var CHANGE_SCOPE_MAX_DAYS = {
+  detail: 30,
+  summary: 90
+};
+var DEFAULT_CHANGE_DAYS = 7;
+var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
+function isChangeLookbackWithinReach(days, scope) {
+  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
+}
+
+// ../api/src/ads-google/keyword-planning.ts
+import { z } from "zod";
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+var micros = z.number().int().positive();
+var FORECAST_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
+var googleForecastBiddingSchema = z.discriminatedUnion("strategy", [
+  z.object({ strategy: z.literal("MANUAL_CPC"), maxCpcBidMicros: micros, dailyBudgetMicros: micros.optional() }),
+  z.object({
+    strategy: z.literal("MAXIMIZE_CLICKS"),
+    dailyTargetSpendMicros: micros,
+    maxCpcBidCeilingMicros: micros.optional()
+  }),
+  z.object({ strategy: z.literal("MAXIMIZE_CONVERSIONS"), dailyTargetSpendMicros: micros })
+]);
+var googleKeywordForecastRequestSchema = z.object({
+  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
+  managerId: z.string().optional(),
+  /** One forecast ad group per entry; most forecasts are a single group. */
+  adGroups: z.array(
+    z.object({
+      keywords: z.array(z.object({ text: z.string().trim().min(1).max(80), matchType: z.enum(FORECAST_MATCH_TYPES) })).min(1)
+    })
+  ).min(1),
+  locationIds: z.array(z.string().regex(NUMERIC_ID_REGEX)).optional(),
+  languageId: z.string().regex(NUMERIC_ID_REGEX).optional(),
+  bidding: googleForecastBiddingSchema,
+  /** Must start in the future and end within a year. Without them Baker forecasts the 30 days from tomorrow. */
+  startDate: z.string().regex(ISO_DATE).optional(),
+  endDate: z.string().regex(ISO_DATE).optional(),
+  currencyCode: z.string().length(3).optional()
+}).refine((body) => body.startDate === void 0 === (body.endDate === void 0), {
+  message: "Give both --start and --end, or neither (the forecast then covers the 30 days from tomorrow)",
+  path: ["endDate"]
+});
+var KEYWORD_FORECAST_SOURCE = "keyword_planner_forecast";
+var googleKeywordForecastResponseSchema = z.object({
+  source: z.literal(KEYWORD_FORECAST_SOURCE),
+  period: z.object({ startDate: z.string(), endDate: z.string() }),
+  forecast_clicks: z.number().nullable(),
+  forecast_cost_micros: z.number().nullable(),
+  forecast_conversions: z.number().nullable(),
+  forecast_average_cpc_micros: z.number().nullable(),
+  forecast_average_cpa_micros: z.number().nullable()
+});
+var googleAdGroupThemesRequestSchema = z.object({
+  customerId: z.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
+  managerId: z.string().optional(),
+  keywords: z.array(z.string().trim().min(1)).min(1),
+  /** Existing ad groups to sort the keywords into: numeric ids or `customers/{cid}/adGroups/{id}`. */
+  adGroups: z.array(z.string().min(1)).min(1)
+});
+var googleAdGroupThemesResponseSchema = z.object({
+  suggestions: z.array(
+    z.object({
+      keyword: z.string(),
+      suggested_keyword: z.string(),
+      match_type: z.string(),
+      ad_group: z.string(),
+      campaign: z.string()
+    })
+  ),
+  unusable_ad_groups: z.array(z.object({ ad_group: z.string(), campaign: z.string() }))
+});
+
+// ../api/src/ads-google/url-options.ts
+import { z as z2 } from "zod";
+var URL_OPTION_LEVELS = ["account", "campaign", "ad_group", "ad"];
+var googleUrlOptionValueSchema = z2.discriminatedUnion("state", [
+  z2.object({ state: z2.literal("set"), value: z2.string() }),
+  z2.object({ state: z2.literal("not_set") }),
+  z2.object({ state: z2.literal("not_read"), reason: z2.string() })
+]);
+var googleUrlOptionsRequestSchema = z2.object({
+  customerId: z2.string().regex(NUMERIC_ID_REGEX, "customerId must be the bare numeric customer id"),
+  managerId: z2.string().optional(),
+  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */
+  full: z2.boolean().optional(),
+  skipCache: z2.boolean().optional()
+});
+var googleUrlOptionsCampaignSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  status: z2.string(),
+  final_url_suffix: googleUrlOptionValueSchema,
+  tracking_url_template: googleUrlOptionValueSchema
+});
+var googleUrlOptionsAdGroupSchema = z2.object({
+  id: z2.string(),
+  name: z2.string(),
+  status: z2.string(),
+  campaign_id: z2.string(),
+  final_url_suffix: googleUrlOptionValueSchema,
+  tracking_url_template: googleUrlOptionValueSchema
+});
+var googleUrlOptionsAdSchema = z2.object({
+  id: z2.string(),
+  status: z2.string(),
+  ad_group_id: z2.string(),
+  campaign_id: z2.string(),
+  final_url_suffix: googleUrlOptionValueSchema,
+  tracking_url_template: googleUrlOptionValueSchema
+});
+var googleUrlOptionsResponseSchema = z2.object({
+  customer_id: z2.string(),
+  account: z2.object({
+    level: z2.literal("account"),
+    read: z2.boolean(),
+    final_url_suffix: googleUrlOptionValueSchema,
+    tracking_url_template: googleUrlOptionValueSchema
+  }),
+  campaigns: z2.object({
+    level: z2.literal("campaign"),
+    read: z2.boolean(),
+    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */
+    campaigns_read: z2.number().int().nonnegative(),
+    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */
+    campaigns_without_override: z2.number().int().nonnegative(),
+    overrides: z2.array(googleUrlOptionsCampaignSchema),
+    /** Compact mode only: campaigns read but not listed because they carry no override. */
+    omitted: z2.number().int().nonnegative()
+  }),
+  /**
+   * Ad groups and ads that carry an override of their own — read by asking Google only for the
+   * entities whose suffix or template IS NOT NULL, so an account of thousands of ads costs one page.
+   * `read: true` with no overrides is a finding: nothing at this level overrides the levels above.
+   * `truncated` means more overriding entities exist than one page listed.
+   */
+  ad_groups: z2.object({
+    level: z2.literal("ad_group"),
+    read: z2.boolean(),
+    overrides: z2.array(googleUrlOptionsAdGroupSchema),
+    truncated: z2.boolean()
+  }),
+  ads: z2.object({
+    level: z2.literal("ad"),
+    read: z2.boolean(),
+    overrides: z2.array(googleUrlOptionsAdSchema),
+    truncated: z2.boolean()
+  }),
+  /** Levels this command could not read. Nothing here may be reported as "not configured". */
+  levels_not_read: z2.array(z2.object({ level: z2.enum(URL_OPTION_LEVELS), reason: z2.string() }))
+});
+var ACCOUNT_URL_OPTIONS_LOCATION = "Google Ads UI \u2192 Admin \u2192 Account settings \u2192 Tracking (account-level tracking template and final URL suffix)";
+var ACCOUNT_URL_OPTIONS_STAGE_COMMAND = 'baker ads google account update --customer-id <id> --final-url-suffix "utm_agency=baker"';
+function isSet(value) {
+  return value.state === "set";
+}
+function entityOverrideHints(label, plural, field, level) {
+  if (!level.read) return [];
+  const hints = [];
+  const overriding = level.overrides.filter((entity) => isSet(entity.final_url_suffix));
+  if (overriding.length > 0) {
+    const named = overriding.slice(0, 5).map((entity) => entity.name || entity.id).join(", ");
+    hints.push(
+      `${overriding.length} ${label}(s) set their own final URL suffix (${named}${overriding.length > 5 ? ", \u2026" : ""}). It REPLACES the campaign and account suffix for every click through it, so an account-wide parameter must be added to theirs too.`
+    );
+  }
+  if (level.truncated) {
+    hints.push(
+      `More ${plural} override the URL options than one page lists \u2014 read them all with \`baker ads google query\` on ${field}.final_url_suffix IS NOT NULL --all before saying which ones do.`
+    );
+  }
+  return hints;
+}
+function urlOptionsHints(report) {
+  const hints = [];
+  const { account, campaigns } = report;
+  if (!account.read) {
+    hints.push(
+      "The account level did NOT read \u2014 its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging."
+    );
+  } else if (account.final_url_suffix.state === "not_set") {
+    hints.push(
+      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=\u2026) belongs at the account level so it reaches every ad \u2014 stage it with \`${ACCOUNT_URL_OPTIONS_STAGE_COMMAND}\` (applies at Publish; the user sees it under ${ACCOUNT_URL_OPTIONS_LOCATION}).`
+    );
+  }
+  if (!campaigns.read) {
+    hints.push(
+      "Campaign-level URL options did NOT read \u2014 do not report that no campaign overrides exist. Re-run before concluding."
+    );
+  } else {
+    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));
+    if (overriding.length > 0) {
+      const named = overriding.slice(0, 5).map((c) => c.name || c.id).join(", ");
+      hints.push(
+        `A campaign's final URL suffix REPLACES the account-level one for that campaign \u2014 it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? ", \u2026" : ""}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`
+      );
+    }
+  }
+  hints.push(...entityOverrideHints("ad group", "ad groups", "ad_group", report.ad_groups));
+  hints.push(...entityOverrideHints("ad", "ads", "ad_group_ad.ad", report.ads));
+  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== "account");
+  if (overridingLevelsNotRead.length > 0) {
+    hints.push(
+      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(", ")}. A suffix set there still wins over the levels above it.`
+    );
+  }
+  if (campaigns.omitted > 0) {
+    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed \u2014 pass --full.`);
+  }
+  return hints;
+}
+
+export {
+  CHANGE_SCOPES,
+  CHANGE_SCOPE_MAX_DAYS,
+  DEFAULT_CHANGE_DAYS,
+  isChangeLookbackWithinReach,
+  googleKeywordForecastRequestSchema,
+  urlOptionsHints
+};
+//# sourceMappingURL=chunk-77DN7R35.js.map

package/dist/chunk-77DN7R35.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/ads-google/change-history.ts","../../api/src/ads-google/keyword-planning.ts","../../api/src/ads-google/url-options.ts"],"sourcesContent":["/**\n * How far back Google's account history actually reaches, shared by the CLI and the\n * backend so the two layers cannot disagree about the limit.\n *\n * `change_event` carries field-level detail — old → new value and the user who made the\n * change — for the last 30 days. `change_status` reaches 90 days but only reports which\n * resources were added, changed or removed. Past 90 days there is no API at all; the\n * change has to be inferred from performance, or read from the Google Ads web UI.\n */\n\nexport const CHANGE_SCOPES = [\"detail\", \"summary\"] as const;\n\nexport type ChangeScope = (typeof CHANGE_SCOPES)[number];\n\nexport const CHANGE_SCOPE_MAX_DAYS: Record<ChangeScope, number> = {\n  detail: 30,\n  summary: 90,\n};\n\nexport const DEFAULT_CHANGE_DAYS = 7;\n\n/** Longest lookback any history resource can serve. */\nexport const MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;\n\nexport function isChangeLookbackWithinReach(days: number, scope: ChangeScope): boolean {\n  return days <= CHANGE_SCOPE_MAX_DAYS[scope];\n}\n\n/** The cheapest scope that can serve `days`, or null when nothing reaches that far. */\nexport function changeScopeForDays(days: number): ChangeScope | null {\n  return CHANGE_SCOPES.find((scope) => isChangeLookbackWithinReach(days, scope)) ?? null;\n}\n\n/**\n * Why a lookback was refused, and what to do instead. Callers that bypass the CLI get\n * this straight from the API, so it has to carry the way out of the window rather than\n * just the limit that was breached.\n */\nexport function changeLookbackMessage(days: number, scope: ChangeScope): string {\n  const reachable = changeScopeForDays(days);\n  if (reachable && reachable !== scope) {\n    return `Google keeps field-level change detail for ${CHANGE_SCOPE_MAX_DAYS.detail} days only, and ${days} days is outside that window. Use scope \"${reachable}\" to reach back ${CHANGE_SCOPE_MAX_DAYS[reachable]} days — it reports which resources changed, without the old and new values.`;\n  }\n  return `Google's account history reaches back ${MAX_CHANGE_DAYS} days at most, and ${days} days is outside that window. Infer the change from monthly spend per campaign instead; anything older with attribution exists only in the Google Ads web interface, which has no API.`;\n}\n","/**\n * Keyword Planner reads beyond ideas and historical volume: a forecast for a set of keywords\n * (`GenerateKeywordForecastMetrics`, v25 shape) and ad-group themes (`GenerateAdGroupThemes`,\n * which existing ad group each keyword belongs in).\n *\n * The v25 forecast takes a campaign to forecast — languages, locations, ONE bidding strategy and\n * ad groups of keywords — and answers with one set of campaign-level estimates. It has no network\n * choice, no per-keyword bids and no negatives; those were the pre-v18 keyword-plan shape.\n */\nimport { z } from \"zod\";\nimport { NUMERIC_ID_REGEX } from \"./limits\";\n\nconst ISO_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\nconst micros = z.number().int().positive();\n\nexport const FORECAST_MATCH_TYPES = [\"EXACT\", \"PHRASE\", \"BROAD\"] as const;\n\nexport const googleForecastBiddingSchema = z.discriminatedUnion(\"strategy\", [\n  z.object({ strategy: z.literal(\"MANUAL_CPC\"), maxCpcBidMicros: micros, dailyBudgetMicros: micros.optional() }),\n  z.object({\n    strategy: z.literal(\"MAXIMIZE_CLICKS\"),\n    dailyTargetSpendMicros: micros,\n    maxCpcBidCeilingMicros: micros.optional(),\n  }),\n  z.object({ strategy: z.literal(\"MAXIMIZE_CONVERSIONS\"), dailyTargetSpendMicros: micros }),\n]);\nexport type GoogleForecastBidding = z.infer<typeof googleForecastBiddingSchema>;\n\nexport const googleKeywordForecastRequestSchema = z\n  .object({\n    customerId: z.string().regex(NUMERIC_ID_REGEX, \"customerId must be the bare numeric customer id\"),\n    managerId: z.string().optional(),\n    /** One forecast ad group per entry; most forecasts are a single group. */\n    adGroups: z\n      .array(\n        z.object({\n          keywords: z\n            .array(z.object({ text: z.string().trim().min(1).max(80), matchType: z.enum(FORECAST_MATCH_TYPES) }))\n            .min(1),\n        }),\n      )\n      .min(1),\n    locationIds: z.array(z.string().regex(NUMERIC_ID_REGEX)).optional(),\n    languageId: z.string().regex(NUMERIC_ID_REGEX).optional(),\n    bidding: googleForecastBiddingSchema,\n    /** Must start in the future and end within a year. Without them Baker forecasts the 30 days from tomorrow. */\n    startDate: z.string().regex(ISO_DATE).optional(),\n    endDate: z.string().regex(ISO_DATE).optional(),\n    currencyCode: z.string().length(3).optional(),\n  })\n  .refine((body) => (body.startDate === undefined) === (body.endDate === undefined), {\n    message: \"Give both --start and --end, or neither (the forecast then covers the 30 days from tomorrow)\",\n    path: [\"endDate\"],\n  });\nexport type GoogleKeywordForecastRequest = z.infer<typeof googleKeywordForecastRequestSchema>;\n\nexport const KEYWORD_FORECAST_SOURCE = \"keyword_planner_forecast\" as const;\n\n/** Every number is Google's prediction for the whole forecast period — never an account result. */\nexport const googleKeywordForecastResponseSchema = z.object({\n  source: z.literal(KEYWORD_FORECAST_SOURCE),\n  period: z.object({ startDate: z.string(), endDate: z.string() }),\n  forecast_clicks: z.number().nullable(),\n  forecast_cost_micros: z.number().nullable(),\n  forecast_conversions: z.number().nullable(),\n  forecast_average_cpc_micros: z.number().nullable(),\n  forecast_average_cpa_micros: z.number().nullable(),\n});\nexport type GoogleKeywordForecastResponse = z.infer<typeof googleKeywordForecastResponseSchema>;\n\nexport const googleAdGroupThemesRequestSchema = z.object({\n  customerId: z.string().regex(NUMERIC_ID_REGEX, \"customerId must be the bare numeric customer id\"),\n  managerId: z.string().optional(),\n  keywords: z.array(z.string().trim().min(1)).min(1),\n  /** Existing ad groups to sort the keywords into: numeric ids or `customers/{cid}/adGroups/{id}`. */\n  adGroups: z.array(z.string().min(1)).min(1),\n});\nexport type GoogleAdGroupThemesRequest = z.infer<typeof googleAdGroupThemesRequestSchema>;\n\nexport const googleAdGroupThemesResponseSchema = z.object({\n  suggestions: z.array(\n    z.object({\n      keyword: z.string(),\n      suggested_keyword: z.string(),\n      match_type: z.string(),\n      ad_group: z.string(),\n      campaign: z.string(),\n    }),\n  ),\n  unusable_ad_groups: z.array(z.object({ ad_group: z.string(), campaign: z.string() })),\n});\nexport type GoogleAdGroupThemesResponse = z.infer<typeof googleAdGroupThemesResponseSchema>;\n","/**\n * `ads.google.url-options` — the URL/tracking options in force on an account.\n *\n * Google returns a field ONLY when it holds a value: an unset `final_url_suffix`\n * is not `\"\"`, it is a key that never appears in the row. Reported naively, that\n * is indistinguishable from a read that never happened — and a false \"no suffix\n * is configured\" has already been written into a client's knowledge base from\n * exactly that ambiguity.\n *\n * So every value here is a tagged union, never a bare string:\n *\n * - `{ state: \"set\", value }`   — observed, holds this value\n * - `{ state: \"not_set\" }`      — observed, Google carries no value at this level\n * - `{ state: \"not_read\", reason }` — never observed; says nothing about the account\n *\n * and every level Baker did NOT read is listed explicitly in `levels_not_read`\n * rather than silently omitted. Absence is only a finding when it is `not_set`.\n */\nimport { z } from \"zod\";\nimport { NUMERIC_ID_REGEX } from \"./limits\";\n\n/** Google resolves URL options most-specific-first; these are the levels that can carry one. */\nexport const URL_OPTION_LEVELS = [\"account\", \"campaign\", \"ad_group\", \"ad\"] as const;\nexport type GoogleUrlOptionLevel = (typeof URL_OPTION_LEVELS)[number];\n\nexport const googleUrlOptionValueSchema = z.discriminatedUnion(\"state\", [\n  z.object({ state: z.literal(\"set\"), value: z.string() }),\n  z.object({ state: z.literal(\"not_set\") }),\n  z.object({ state: z.literal(\"not_read\"), reason: z.string() }),\n]);\nexport type GoogleUrlOptionValue = z.infer<typeof googleUrlOptionValueSchema>;\n\nexport const googleUrlOptionsRequestSchema = z.object({\n  customerId: z.string().regex(NUMERIC_ID_REGEX, \"customerId must be the bare numeric customer id\"),\n  managerId: z.string().optional(),\n  /** Compact by default: only campaigns that actually override the account. `full` lists every campaign. */\n  full: z.boolean().optional(),\n  skipCache: z.boolean().optional(),\n});\nexport type GoogleUrlOptionsRequest = z.infer<typeof googleUrlOptionsRequestSchema>;\n\nexport const googleUrlOptionsCampaignSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.string(),\n  final_url_suffix: googleUrlOptionValueSchema,\n  tracking_url_template: googleUrlOptionValueSchema,\n});\nexport type GoogleUrlOptionsCampaign = z.infer<typeof googleUrlOptionsCampaignSchema>;\n\nexport const googleUrlOptionsAdGroupSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  status: z.string(),\n  campaign_id: z.string(),\n  final_url_suffix: googleUrlOptionValueSchema,\n  tracking_url_template: googleUrlOptionValueSchema,\n});\nexport type GoogleUrlOptionsAdGroup = z.infer<typeof googleUrlOptionsAdGroupSchema>;\n\nexport const googleUrlOptionsAdSchema = z.object({\n  id: z.string(),\n  status: z.string(),\n  ad_group_id: z.string(),\n  campaign_id: z.string(),\n  final_url_suffix: googleUrlOptionValueSchema,\n  tracking_url_template: googleUrlOptionValueSchema,\n});\nexport type GoogleUrlOptionsAd = z.infer<typeof googleUrlOptionsAdSchema>;\n\nexport const googleUrlOptionsResponseSchema = z.object({\n  customer_id: z.string(),\n  account: z.object({\n    level: z.literal(\"account\"),\n    read: z.boolean(),\n    final_url_suffix: googleUrlOptionValueSchema,\n    tracking_url_template: googleUrlOptionValueSchema,\n  }),\n  campaigns: z.object({\n    level: z.literal(\"campaign\"),\n    read: z.boolean(),\n    /** Campaigns actually observed. 0 with `read: true` means the account has no non-removed campaigns. */\n    campaigns_read: z.number().int().nonnegative(),\n    /** Campaigns observed to carry no override of their own — an explicit finding, not an omission. */\n    campaigns_without_override: z.number().int().nonnegative(),\n    overrides: z.array(googleUrlOptionsCampaignSchema),\n    /** Compact mode only: campaigns read but not listed because they carry no override. */\n    omitted: z.number().int().nonnegative(),\n  }),\n  /**\n   * Ad groups and ads that carry an override of their own — read by asking Google only for the\n   * entities whose suffix or template IS NOT NULL, so an account of thousands of ads costs one page.\n   * `read: true` with no overrides is a finding: nothing at this level overrides the levels above.\n   * `truncated` means more overriding entities exist than one page listed.\n   */\n  ad_groups: z.object({\n    level: z.literal(\"ad_group\"),\n    read: z.boolean(),\n    overrides: z.array(googleUrlOptionsAdGroupSchema),\n    truncated: z.boolean(),\n  }),\n  ads: z.object({\n    level: z.literal(\"ad\"),\n    read: z.boolean(),\n    overrides: z.array(googleUrlOptionsAdSchema),\n    truncated: z.boolean(),\n  }),\n  /** Levels this command could not read. Nothing here may be reported as \"not configured\". */\n  levels_not_read: z.array(z.object({ level: z.enum(URL_OPTION_LEVELS), reason: z.string() })),\n});\nexport type GoogleUrlOptionsResponse = z.infer<typeof googleUrlOptionsResponseSchema>;\n\n/** Where Google keeps the account-level fields, verbatim, for an agent relaying it to a marketer. */\nexport const ACCOUNT_URL_OPTIONS_LOCATION =\n  \"Google Ads UI → Admin → Account settings → Tracking (account-level tracking template and final URL suffix)\";\n\n/**\n * How the account-level value is staged: `google.customer.update` rides the same `GoogleAdsService.Mutate`\n * batch as every other staged op (`customerOperation`), so it applies at Publish like the rest.\n */\nexport const ACCOUNT_URL_OPTIONS_STAGE_COMMAND =\n  'baker ads google account update --customer-id <id> --final-url-suffix \"utm_agency=baker\"';\n\nfunction isSet(value: GoogleUrlOptionValue): value is { state: \"set\"; value: string } {\n  return value.state === \"set\";\n}\n\n/** What an ad-group or ad level's overrides mean for an account-wide parameter. */\nfunction entityOverrideHints(\n  label: string,\n  plural: string,\n  field: string,\n  level: GoogleUrlOptionsResponse[\"ad_groups\"] | GoogleUrlOptionsResponse[\"ads\"],\n): string[] {\n  if (!level.read) return [];\n  const hints: string[] = [];\n  const overriding: Array<{ id: string; name?: string; final_url_suffix: GoogleUrlOptionValue }> =\n    level.overrides.filter((entity) => isSet(entity.final_url_suffix));\n  if (overriding.length > 0) {\n    const named = overriding\n      .slice(0, 5)\n      .map((entity) => entity.name || entity.id)\n      .join(\", \");\n    hints.push(\n      `${overriding.length} ${label}(s) set their own final URL suffix (${named}${overriding.length > 5 ? \", …\" : \"\"}). It REPLACES the campaign and account suffix for every click through it, so an account-wide parameter must be added to theirs too.`,\n    );\n  }\n  if (level.truncated) {\n    hints.push(\n      `More ${plural} override the URL options than one page lists — read them all with \\`baker ads google query\\` on ${field}.final_url_suffix IS NOT NULL --all before saying which ones do.`,\n    );\n  }\n  return hints;\n}\n\n/**\n * Post-read nudges. The account level is the right home for an account-wide parameter\n * (agency/partner tagging), so a missing account suffix is the finding worth surfacing —\n * and a level that failed to read must never be reported as unset.\n */\nexport function urlOptionsHints(report: GoogleUrlOptionsResponse): string[] {\n  const hints: string[] = [];\n  const { account, campaigns } = report;\n\n  if (!account.read) {\n    hints.push(\n      \"The account level did NOT read — its URL options are unknown, not empty. Re-run before telling the user anything about account-wide tagging.\",\n    );\n  } else if (account.final_url_suffix.state === \"not_set\") {\n    hints.push(\n      `No account-level final URL suffix is set. An account-wide parameter (agency/partner tagging such as utm_agency=…) belongs at the account level so it reaches every ad — stage it with \\`${ACCOUNT_URL_OPTIONS_STAGE_COMMAND}\\` (applies at Publish; the user sees it under ${ACCOUNT_URL_OPTIONS_LOCATION}).`,\n    );\n  }\n\n  if (!campaigns.read) {\n    hints.push(\n      \"Campaign-level URL options did NOT read — do not report that no campaign overrides exist. Re-run before concluding.\",\n    );\n  } else {\n    // `overrides` carries every campaign under --full, not just the overriding ones,\n    // so name the ones that actually set a suffix. Saying \"campaigns listed under\n    // `overrides`\" would tell the agent that campaigns inheriting fine are broken.\n    const overriding = campaigns.overrides.filter((c) => isSet(c.final_url_suffix));\n    if (overriding.length > 0) {\n      const named = overriding\n        .slice(0, 5)\n        .map((c) => c.name || c.id)\n        .join(\", \");\n      hints.push(\n        `A campaign's final URL suffix REPLACES the account-level one for that campaign — it does not merge. ${overriding.length} campaign(s) set their own (${named}${overriding.length > 5 ? \", …\" : \"\"}) and will not pick up an account-wide parameter until their own suffix carries it too. Every other campaign read here inherits the account level normally.`,\n      );\n    }\n  }\n\n  hints.push(...entityOverrideHints(\"ad group\", \"ad groups\", \"ad_group\", report.ad_groups));\n  hints.push(...entityOverrideHints(\"ad\", \"ads\", \"ad_group_ad.ad\", report.ads));\n\n  // Precedence is account → campaign → ad group → ad, most specific winning, so\n  // \"a suffix set there still wins\" only holds for levels BELOW the ones that read.\n  // `account` is the least specific — a campaign, ad-group or ad suffix overrides it —\n  // and it joins `levels_not_read` whenever the customer read fails, which would hand\n  // the agent the precedence backwards. Its own \"did NOT read\" hint above covers it.\n  const overridingLevelsNotRead = report.levels_not_read.filter((level) => level.level !== \"account\");\n  if (overridingLevelsNotRead.length > 0) {\n    hints.push(\n      `Not read at this level: ${overridingLevelsNotRead.map((l) => l.level).join(\", \")}. A suffix set there still wins over the levels above it.`,\n    );\n  }\n\n  if (campaigns.omitted > 0) {\n    hints.push(`${campaigns.omitted} campaign(s) read with no override of their own are not listed — pass --full.`);\n  }\n\n  return hints;\n}\n"],"mappings":"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","names":["z","z"]}