@koda-sl/baker-cli 0.455.0 → 0.456.0

package/dist/themes-2ZV7OCJ3.js

@@ -0,0 +1,94 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-QM6T4BFA.js";
+import {
+  failWriteValidation,
+  listFlag,
+  requireCustomerId
+} from "./chunk-4KCKNAVW.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-XY7BZSDQ.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-F2S5BLPE.js";
+import "./chunk-7VHPAGPK.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-VFIOJD5M.js";
+import "./chunk-WTOYCUKH.js";
+import "./chunk-DZSIUEGH.js";
+import "./chunk-VAJBWA2U.js";
+import "./chunk-HRYOZUSK.js";
+import "./chunk-VVZBBKRC.js";
+import "./chunk-YBMVHGY3.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/themes.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" },
+  keywords: { type: "string", description: "Comma-separated keywords to place" },
+  "ad-groups": {
+    type: "string",
+    description: "Comma-separated existing ad group ids (or resource names) to sort them into \u2014 read them with `ad-groups list`"
+  }
+};
+registerSchema({
+  command: "ads.google.keywords.themes",
+  description: "Which existing ad group each keyword belongs in, by Google's reading of the ad groups' themes (Keyword Planner GenerateAdGroupThemes). Start here: `baker ads google keywords themes --customer-id 1234567890 --keywords \"solar panels,heat pumps\" --ad-groups 111,222`. Returns suggestions (keyword \u2192 suggested keyword, match type, ad group) and unusable_ad_groups (ones Google could not read a theme from).",
+  args: Object.fromEntries(
+    Object.entries(ARGS).map(([name, arg]) => [
+      name,
+      { type: arg.type, description: arg.description, required: false }
+    ])
+  )
+});
+var themesCommand = defineCommand({
+  meta: {
+    name: "themes",
+    description: `Sort keywords into the existing ad groups whose theme fits them (Keyword Planner).
+
+Example:
+  baker ads google keywords themes --customer-id 1234567890 --keywords "solar panels,heat pumps" --ad-groups 111,222`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    const keywords = listFlag(args.keywords);
+    const adGroups = listFlag(args["ad-groups"]);
+    if (!keywords?.length || !adGroups?.length) failWriteValidation("pass --keywords and --ad-groups");
+    const managerId = getManagerIdForCustomer(customerId);
+    try {
+      const { data } = await apiPost(
+        "/api/ads/google/keywords/themes",
+        {
+          customerId,
+          ...managerId ? { managerId } : {},
+          keywords,
+          adGroups
+        }
+      );
+      const hints = data.unusable_ad_groups.length > 0 ? [
+        `${data.unusable_ad_groups.length} ad group(s) gave Google no theme to match against (removed, empty or under a removed campaign) \u2014 they received no keywords.`
+      ] : [];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+export {
+  themesCommand
+};
+//# sourceMappingURL=themes-2ZV7OCJ3.js.map

package/dist/themes-2ZV7OCJ3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/keywords/themes.ts"],"sourcesContent":["import type { GoogleAdGroupThemesResponse } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../../client.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../../cache.ts\";\nimport { writeJsonEnvelope } from \"../../output.ts\";\nimport { exitWithServiceReadError } from \"../service-read-errors.ts\";\nimport { failWriteValidation, listFlag, requireCustomerId } from \"../write-shared.ts\";\n\nconst ARGS = {\n  \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits, no dashes)\" },\n  keywords: { type: \"string\", description: \"Comma-separated keywords to place\" },\n  \"ad-groups\": {\n    type: \"string\",\n    description:\n      \"Comma-separated existing ad group ids (or resource names) to sort them into — read them with `ad-groups list`\",\n  },\n} as const;\n\nregisterSchema({\n  command: \"ads.google.keywords.themes\",\n  description:\n    \"Which existing ad group each keyword belongs in, by Google's reading of the ad groups' themes (Keyword Planner GenerateAdGroupThemes). Start here: `baker ads google keywords themes --customer-id 1234567890 --keywords \\\"solar panels,heat pumps\\\" --ad-groups 111,222`. Returns suggestions (keyword → suggested keyword, match type, ad group) and unusable_ad_groups (ones Google could not read a theme from).\",\n  args: Object.fromEntries(\n    Object.entries(ARGS).map(([name, arg]) => [\n      name,\n      { type: arg.type, description: arg.description, required: false },\n    ]),\n  ),\n});\n\nexport const themesCommand = defineCommand({\n  meta: {\n    name: \"themes\",\n    description: `Sort keywords into the existing ad groups whose theme fits them (Keyword Planner).\n\nExample:\n  baker ads google keywords themes --customer-id 1234567890 --keywords \"solar panels,heat pumps\" --ad-groups 111,222`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    const keywords = listFlag(args.keywords);\n    const adGroups = listFlag(args[\"ad-groups\"]);\n    if (!keywords?.length || !adGroups?.length) failWriteValidation(\"pass --keywords and --ad-groups\");\n    const managerId = getManagerIdForCustomer(customerId);\n    try {\n      const { data } = await apiPost<{ ok: true; data: GoogleAdGroupThemesResponse }>(\n        \"/api/ads/google/keywords/themes\",\n        {\n          customerId,\n          ...(managerId ? { managerId } : {}),\n          keywords,\n          adGroups,\n        },\n      );\n      const hints =\n        data.unusable_ad_groups.length > 0\n          ? [\n              `${data.unusable_ad_groups.length} ad group(s) gave Google no theme to match against (removed, empty or under a removed campaign) — they received no keywords.`,\n            ]\n          : [];\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      exitWithServiceReadError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAQ9B,IAAM,OAAO;AAAA,EACX,eAAe,EAAE,MAAM,UAAU,aAAa,gDAAgD;AAAA,EAC9F,UAAU,EAAE,MAAM,UAAU,aAAa,oCAAoC;AAAA,EAC7E,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AACF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,OAAO;AAAA,IACX,OAAO,QAAQ,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;AAAA,MACxC;AAAA,MACA,EAAE,MAAM,IAAI,MAAM,aAAa,IAAI,aAAa,UAAU,MAAM;AAAA,IAClE,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,kBAAkB,IAAI;AACzC,UAAM,WAAW,SAAS,KAAK,QAAQ;AACvC,UAAM,WAAW,SAAS,KAAK,WAAW,CAAC;AAC3C,QAAI,CAAC,UAAU,UAAU,CAAC,UAAU,OAAQ,qBAAoB,iCAAiC;AACjG,UAAM,YAAY,wBAAwB,UAAU;AACpD,QAAI;AACF,YAAM,EAAE,KAAK,IAAI,MAAM;AAAA,QACrB;AAAA,QACA;AAAA,UACE;AAAA,UACA,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,UACjC;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,QACJ,KAAK,mBAAmB,SAAS,IAC7B;AAAA,QACE,GAAG,KAAK,mBAAmB,MAAM;AAAA,MACnC,IACA,CAAC;AACP,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,+BAAyB,GAAG;AAAA,IAC9B;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/{top-companies-S2Y4I5HF.js → top-companies-VTLR6GTW.js}

@@ -3,7 +3,7 @@ import {
   daysAgoIso,
   handleLinkedinError,
   todayIso
-} from "./chunk-YWK4UBVU.js";
+} from "./chunk-V5QJBDBC.js";
 import {
   TABLE_OUTPUT_FORMATS,
   outputFormatRefusal,
@@ -14,11 +14,11 @@ import {
 import {
   NO_CACHE_ARG
 } from "./chunk-X7ZODEXJ.js";
-import "./chunk-RZTNH2TX.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -105,4 +105,4 @@ Examples:
 export {
   topCompaniesCommand
 };
-//# sourceMappingURL=top-companies-S2Y4I5HF.js.map
+//# sourceMappingURL=top-companies-VTLR6GTW.js.map

package/dist/{translate-BTUMXQSK.js → translate-UMTKAUJ3.js}

@@ -1,6 +1,6 @@
 import {
   withoutFields
-} from "./chunk-MVYLY2SF.js";
+} from "./chunk-KN7DFVKW.js";
 import {
   claimNewCreativeInWorkspace,
   creativeLimitRefusal
@@ -10,15 +10,11 @@ import {
   runBaker,
   seriesLeadsAbove,
   writeSeriesMemberCanvas
-} from "./chunk-WKS6ZDUP.js";
+} from "./chunk-BSOWFWEU.js";
 import {
   parseDefinitionStrategyFields
-} from "./chunk-3V57D7GE.js";
-import "./chunk-GQ7JE7A7.js";
-import {
-  setDefinitionFields
-} from "./chunk-LYBXCXJB.js";
-import "./chunk-3KEWXALS.js";
+} from "./chunk-XJRBFLBD.js";
+import "./chunk-MCWYIEWI.js";
 import {
   isCustomersWords,
   isSignatureLine,
@@ -28,10 +24,14 @@ import {
   maybeSigned,
   sameTag,
   tagSlug
-} from "./chunk-PKC6QBYJ.js";
+} from "./chunk-EZWYX343.js";
+import "./chunk-UZUHXN7H.js";
+import {
+  setDefinitionFields
+} from "./chunk-LYBXCXJB.js";
 import "./chunk-4QEY2L6U.js";
-import "./chunk-OU5YA2QX.js";
-import "./chunk-K5H3XOYQ.js";
+import "./chunk-DT2XXF6O.js";
+import "./chunk-LI6PGY3L.js";
 import "./chunk-F2S5BLPE.js";
 import {
   holdUnbilledSpend
@@ -59,11 +59,11 @@ import {
 import "./chunk-HRYOZUSK.js";
 import "./chunk-VVZBBKRC.js";
 import "./chunk-YBMVHGY3.js";
-import "./chunk-RZTNH2TX.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import "./chunk-XBOK23HI.js";
 import "./chunk-IFWP3ZDO.js";
 import {
@@ -595,4 +595,4 @@ var translateCommand = defineCommand({
 export {
   translateCommand
 };
-//# sourceMappingURL=translate-BTUMXQSK.js.map
+//# sourceMappingURL=translate-UMTKAUJ3.js.map

package/dist/{triggers-T47AIYVB.js → triggers-Y7ZMMY3C.js}

@@ -1,13 +1,13 @@
 import {
   failApi
-} from "./chunk-KHV5GALI.js";
+} from "./chunk-QNDLOCAI.js";
 import {
   triggerCatalogSchema
-} from "./chunk-RZTNH2TX.js";
+} from "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -138,4 +138,4 @@ export {
   shapeTriggerCatalog,
   triggersCommand
 };
-//# sourceMappingURL=triggers-T47AIYVB.js.map
+//# sourceMappingURL=triggers-Y7ZMMY3C.js.map

package/dist/{unlink-XRKX6DVP.js → unlink-HZCFLXH4.js}

@@ -2,12 +2,12 @@ import {
   failApi,
   failValidation,
   writeOk
-} from "./chunk-PAQ3T6OT.js";
-import "./chunk-RZTNH2TX.js";
+} from "./chunk-YRVDCIJ2.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost,
   validateConvexId
@@ -64,4 +64,4 @@ var unlinkCommand = defineCommand({
 export {
   unlinkCommand
 };
-//# sourceMappingURL=unlink-XRKX6DVP.js.map
+//# sourceMappingURL=unlink-HZCFLXH4.js.map

package/dist/{unstage-77RAGX3F.js → unstage-562HOOE7.js}

@@ -2,12 +2,12 @@ import {
   failApi,
   failValidation,
   validateScheduledAgentRef
-} from "./chunk-KHV5GALI.js";
-import "./chunk-RZTNH2TX.js";
+} from "./chunk-QNDLOCAI.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -81,4 +81,4 @@ export {
   unstageBody,
   unstageCommand
 };
-//# sourceMappingURL=unstage-77RAGX3F.js.map
+//# sourceMappingURL=unstage-562HOOE7.js.map

package/dist/{update-R3QSTHUD.js → update-ATSXY5UN.js}

@@ -14,12 +14,12 @@ import {
   slackBody,
   validateScheduledAgentRef,
   writeOk
-} from "./chunk-KHV5GALI.js";
-import "./chunk-RZTNH2TX.js";
+} from "./chunk-QNDLOCAI.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -139,4 +139,4 @@ var updateCommand = defineCommand({
 export {
   updateCommand
 };
-//# sourceMappingURL=update-R3QSTHUD.js.map
+//# sourceMappingURL=update-ATSXY5UN.js.map

package/dist/{update-RJLMUP7I.js → update-DKU2UDFA.js}

@@ -14,11 +14,11 @@ import {
 } from "./chunk-PWGWMIIJ.js";
 import {
   AVATAR_HANDLE_PATTERN
-} from "./chunk-RZTNH2TX.js";
+} from "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import "./chunk-XBOK23HI.js";
 import "./chunk-IFWP3ZDO.js";
 import "./chunk-NAWWC5I3.js";
@@ -152,4 +152,4 @@ var updateCommand = defineCommand({
 export {
   updateCommand
 };
-//# sourceMappingURL=update-RJLMUP7I.js.map
+//# sourceMappingURL=update-DKU2UDFA.js.map

package/dist/{update-YRO5IHDX.js → update-I5A5TOZJ.js}

@@ -6,12 +6,12 @@ import {
   parsePriority,
   parseTagList,
   writeOk
-} from "./chunk-PAQ3T6OT.js";
-import "./chunk-RZTNH2TX.js";
+} from "./chunk-YRVDCIJ2.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost,
   validateConvexId
@@ -95,4 +95,4 @@ var updateCommand = defineCommand({
 export {
   updateCommand
 };
-//# sourceMappingURL=update-YRO5IHDX.js.map
+//# sourceMappingURL=update-I5A5TOZJ.js.map

package/dist/{update-NQIRRGOW.js → update-ZF3VFYLB.js}

@@ -2,12 +2,12 @@ import {
   failApi,
   failValidation,
   writeOk
-} from "./chunk-PAQ3T6OT.js";
-import "./chunk-RZTNH2TX.js";
+} from "./chunk-YRVDCIJ2.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiPost
 } from "./chunk-XBOK23HI.js";
@@ -60,4 +60,4 @@ var tagsUpdateCommand = defineCommand({
 export {
   tagsUpdateCommand
 };
-//# sourceMappingURL=update-NQIRRGOW.js.map
+//# sourceMappingURL=update-ZF3VFYLB.js.map

package/dist/{upload-KWFKNKAF.js → upload-SIAI6NMH.js}

@@ -1,17 +1,17 @@
 import {
   runVideoIngest
-} from "./chunk-YCWIGXH6.js";
+} from "./chunk-GP7QUF5A.js";
 import "./chunk-FKOECEVC.js";
 import {
   detectVideoContentType,
   uploadLocalVideo
 } from "./chunk-KNY76UGC.js";
 import "./chunk-VVZBBKRC.js";
-import "./chunk-RZTNH2TX.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   ApiError
 } from "./chunk-XBOK23HI.js";
@@ -123,4 +123,4 @@ var uploadCommand = defineCommand({
 export {
   uploadCommand
 };
-//# sourceMappingURL=upload-KWFKNKAF.js.map
+//# sourceMappingURL=upload-SIAI6NMH.js.map

package/dist/{url-options-GGXAL3J4.js → url-options-JSX6HBZL.js}

@@ -5,17 +5,17 @@ import {
 import "./chunk-EDLZGTGN.js";
 import {
   parseApiError
-} from "./chunk-GX6VAHY7.js";
+} from "./chunk-5FWMRTNB.js";
 import {
   urlOptionsHints
-} from "./chunk-XCM6XWOB.js";
+} from "./chunk-7VHPAGPK.js";
 import {
   getManagerIdForCustomer,
   resolveCustomerId,
   writeAdsJson,
   writeJsonEnvelope
 } from "./chunk-VFIOJD5M.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-ML7DLFFY.js";
 import {
   ApiError,
   apiPost
@@ -35,7 +35,10 @@ function observedTemplates(report) {
   const values = [
     report.account.final_url_suffix,
     report.account.tracking_url_template,
-    ...report.campaigns.overrides.flatMap((campaign) => [campaign.final_url_suffix, campaign.tracking_url_template])
+    ...[...report.campaigns.overrides, ...report.ad_groups.overrides, ...report.ads.overrides].flatMap((entity) => [
+      entity.final_url_suffix,
+      entity.tracking_url_template
+    ])
   ];
   return values.flatMap((value) => value.state === "set" ? [value.value] : []);
 }
@@ -66,7 +69,7 @@ function mappingHints(report) {
 // src/commands/ads/google/url-options.ts
 registerSchema({
   command: "ads.google.url-options",
-  description: "Report the Google Ads URL/tracking options in force: the account-level final URL suffix and tracking template, plus every campaign that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.",
+  description: "Report the Google Ads URL/tracking options in force at every level: the account-level final URL suffix and tracking template, plus every campaign, ad group and ad that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.",
   args: {
     "customer-id": {
       type: "string",
@@ -84,7 +87,7 @@ registerSchema({
 var urlOptionsCommand = defineCommand({
   meta: {
     name: "url-options",
-    description: `Show the URL/tracking options in force \u2014 account-level final URL suffix and tracking template, plus campaign overrides.
+    description: `Show the URL/tracking options in force \u2014 account-level final URL suffix and tracking template, plus the campaigns, ad groups and ads that override them (the most specific level wins).
 
 Start here for any "add utm_\u2026 / tracking parameter / agency tag" question: it tells you which level already carries one.
 Each value is tagged: set | not_set (Google carries no value there) | not_read (never observed \u2014 NOT a finding).
@@ -124,4 +127,4 @@ Examples:
 export {
   urlOptionsCommand
 };
-//# sourceMappingURL=url-options-GGXAL3J4.js.map
+//# sourceMappingURL=url-options-JSX6HBZL.js.map

package/dist/url-options-JSX6HBZL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/url-options.ts","../src/commands/ads/google/mapping-hints.ts"],"sourcesContent":["import { type GoogleUrlOptionsResponse, urlOptionsHints } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { getManagerIdForCustomer } from \"../cache.ts\";\nimport { resolveCustomerId, writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { parseApiError } from \"./error-parser.ts\";\nimport { mappingHints } from \"./mapping-hints.ts\";\n\nregisterSchema({\n  command: \"ads.google.url-options\",\n  description:\n    \"Report the Google Ads URL/tracking options in force at every level: the account-level final URL suffix and tracking template, plus every campaign, ad group and ad that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.\",\n  args: {\n    \"customer-id\": {\n      type: \"string\",\n      description: \"Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"List every campaign read, including those with no override of their own.\",\n      required: false,\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the read cache\", required: false },\n  },\n});\n\nexport const urlOptionsCommand = defineCommand({\n  meta: {\n    name: \"url-options\",\n    description: `Show the URL/tracking options in force — account-level final URL suffix and tracking template, plus the campaigns, ad groups and ads that override them (the most specific level wins).\n\nStart here for any \"add utm_… / tracking parameter / agency tag\" question: it tells you which level already carries one.\nEach value is tagged: set | not_set (Google carries no value there) | not_read (never observed — NOT a finding).\nJudgment on which level to use and what to put in it: /google-ads-playbook → 18-naming-utm.md.\n\nExamples:\n  baker ads google url-options --customer-id 1234567890\n  baker ads google url-options --customer-id 1234567890 --full`,\n  },\n  args: {\n    \"customer-id\": { type: \"string\", description: \"Google Ads customer ID (10 digits)\", required: false },\n    full: { type: \"boolean\", description: \"List every campaign read, not only the overriding ones\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip the read cache\", required: false },\n  },\n  run: async ({ args }) => {\n    const customerId = await resolveCustomerId(args);\n    try {\n      const managerId = getManagerIdForCustomer(customerId);\n      const data = await apiPost<GoogleUrlOptionsResponse>(\"/api/ads/google/url-options\", {\n        customerId,\n        ...(managerId ? { managerId } : {}),\n        ...(args.full ? { full: true } : {}),\n        ...(args[\"no-cache\"] ? { skipCache: true } : {}),\n      });\n      const hints = [...urlOptionsHints(data), ...mappingHints(data)];\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        // `err.code` is what tells `parseApiError` a missing Google Ads connection\n        // apart from a fixable query error. Dropped, a never-connected account gets\n        // the query-correction path instead — and since the query here is empty, the\n        // \"add a LIMIT\" rule matches and hands the agent a `correctedCommand` it is\n        // told to run, sending it off to execute an empty GAQL query instead of\n        // asking the user to connect.\n        writeAdsJson(parseApiError(err.message, \"\", customerId, err.code));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n","/**\n * The bridge between a Google tracking template and Baker's reading of it.\n *\n * These two facts sat one command apart and nothing joined them: `url-options`\n * reports that the account's URLs carry `searchword={keyword}`, and\n * `baker analytics map` is what makes Baker read `searchword` as a keyword.\n * Until it is told, the values are not stored at all — only the fact that the\n * name appeared — so every keyword report for that account is empty and reads\n * as \"this campaign brought no keywords\" rather than \"nobody has said what\n * `searchword` is\".\n *\n * The template is the client's own answer, already written down, so this is\n * naming what arrives rather than proposing a change to their account — which\n * `baker analytics` refuses to do and this does not do either.\n */\nimport type { GoogleUrlOptionsResponse } from \"@baker/api/ads-google\";\nimport type { AdParamRole } from \"@baker/api/analytics\";\nimport { mappingCommandFor, proposeMappingFromTemplate } from \"@baker/api/analytics\";\n\n/** Every template and suffix this report actually observed, at any level. */\nfunction observedTemplates(report: GoogleUrlOptionsResponse): string[] {\n  const values = [\n    report.account.final_url_suffix,\n    report.account.tracking_url_template,\n    ...[...report.campaigns.overrides, ...report.ad_groups.overrides, ...report.ads.overrides].flatMap((entity) => [\n      entity.final_url_suffix,\n      entity.tracking_url_template,\n    ]),\n  ];\n  return values.flatMap((value) => (value.state === \"set\" ? [value.value] : []));\n}\n\nexport function mappingHints(report: GoogleUrlOptionsResponse): string[] {\n  const proposed: Record<string, AdParamRole> = {};\n  const unexplained = new Map<string, string>();\n\n  for (const template of observedTemplates(report)) {\n    const proposal = proposeMappingFromTemplate(template, \"google\");\n    Object.assign(proposed, proposal.proposed);\n    for (const param of proposal.unexplained) unexplained.set(param.name, param.value);\n  }\n\n  const hints: string[] = [];\n  const command = mappingCommandFor(\"google\", proposed);\n  if (command !== \"\") {\n    hints.push(\n      `These URLs carry campaign parameters Baker does not read yet: ${Object.keys(proposed).join(\", \")}. Until it is told, their values are not stored at all — only that the name appeared — so every keyword and campaign breakdown for this account will come back empty rather than wrong. The placeholders say what each one is, so run: ${command}`,\n    );\n  }\n  if (unexplained.size > 0) {\n    const named = [...unexplained].map(([name, value]) => `${name}=${value}`).join(\", \");\n    hints.push(\n      `These carry something no placeholder explains: ${named}. Do not guess — if it is a dimension, map it by name with \\`baker analytics map --platform google --set <name>=<role>\\`; if it is a session token or a cache buster, \\`=ignore\\` stops it being listed as something to deal with.`,\n    );\n  }\n  return hints;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;;;ACmB9B,SAAS,kBAAkB,QAA4C;AACrE,QAAM,SAAS;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,OAAO,QAAQ;AAAA,IACf,GAAG,CAAC,GAAG,OAAO,UAAU,WAAW,GAAG,OAAO,UAAU,WAAW,GAAG,OAAO,IAAI,SAAS,EAAE,QAAQ,CAAC,WAAW;AAAA,MAC7G,OAAO;AAAA,MACP,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AACA,SAAO,OAAO,QAAQ,CAAC,UAAW,MAAM,UAAU,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAE;AAC/E;AAEO,SAAS,aAAa,QAA4C;AACvE,QAAM,WAAwC,CAAC;AAC/C,QAAM,cAAc,oBAAI,IAAoB;AAE5C,aAAW,YAAY,kBAAkB,MAAM,GAAG;AAChD,UAAM,WAAW,2BAA2B,UAAU,QAAQ;AAC9D,WAAO,OAAO,UAAU,SAAS,QAAQ;AACzC,eAAW,SAAS,SAAS,YAAa,aAAY,IAAI,MAAM,MAAM,MAAM,KAAK;AAAA,EACnF;AAEA,QAAM,QAAkB,CAAC;AACzB,QAAM,UAAU,kBAAkB,UAAU,QAAQ;AACpD,MAAI,YAAY,IAAI;AAClB,UAAM;AAAA,MACJ,iEAAiE,OAAO,KAAK,QAAQ,EAAE,KAAK,IAAI,CAAC,oPAA0O,OAAO;AAAA,IACpV;AAAA,EACF;AACA,MAAI,YAAY,OAAO,GAAG;AACxB,UAAM,QAAQ,CAAC,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,KAAK,IAAI;AACnF,UAAM;AAAA,MACJ,kDAAkD,KAAK;AAAA,IACzD;AAAA,EACF;AACA,SAAO;AACT;;;AD/CA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,YAAY,EAAE,MAAM,WAAW,aAAa,uBAAuB,UAAU,MAAM;AAAA,EACrF;AACF,CAAC;AAEM,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,MAAM;AAAA,IACJ,eAAe,EAAE,MAAM,UAAU,aAAa,sCAAsC,UAAU,MAAM;AAAA,IACpG,MAAM,EAAE,MAAM,WAAW,aAAa,0DAA0D,UAAU,MAAM;AAAA,IAChH,YAAY,EAAE,MAAM,WAAW,aAAa,uBAAuB,UAAU,MAAM;AAAA,EACrF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,aAAa,MAAM,kBAAkB,IAAI;AAC/C,QAAI;AACF,YAAM,YAAY,wBAAwB,UAAU;AACpD,YAAM,OAAO,MAAM,QAAkC,+BAA+B;AAAA,QAClF;AAAA,QACA,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;AAAA,QACjC,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAAA,QAClC,GAAI,KAAK,UAAU,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;AAAA,MAChD,CAAC;AACD,YAAM,QAAQ,CAAC,GAAG,gBAAgB,IAAI,GAAG,GAAG,aAAa,IAAI,CAAC;AAC9D,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAO3B,qBAAa,cAAc,IAAI,SAAS,IAAI,YAAY,IAAI,IAAI,CAAC;AACjE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,mBAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,SAAS,mBAAmB,EAAE,CAAC;AACzF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/{url-params-IMC43AIM.js → url-params-AZUI3CW3.js}

@@ -1,17 +1,17 @@
 import {
   handleLinkedinError,
   resolveAccountIdArg
-} from "./chunk-YWK4UBVU.js";
+} from "./chunk-V5QJBDBC.js";
 import {
   writeAdsJson
 } from "./chunk-VFIOJD5M.js";
 import {
   LINKEDIN_TRACKING_PARAMS_AD_SET_MAX
-} from "./chunk-RZTNH2TX.js";
+} from "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiGet
 } from "./chunk-XBOK23HI.js";
@@ -95,4 +95,4 @@ export {
   hints,
   urlParamsCommand
 };
-//# sourceMappingURL=url-params-IMC43AIM.js.map
+//# sourceMappingURL=url-params-AZUI3CW3.js.map

package/dist/{validate-Y6R6F5T3.js → validate-MC4EIQI5.js}

@@ -4,10 +4,10 @@ import {
 import {
   exitOnPrepareError,
   prepareCanvas
-} from "./chunk-PKC6QBYJ.js";
+} from "./chunk-EZWYX343.js";
 import "./chunk-4QEY2L6U.js";
-import "./chunk-OU5YA2QX.js";
-import "./chunk-K5H3XOYQ.js";
+import "./chunk-DT2XXF6O.js";
+import "./chunk-LI6PGY3L.js";
 import "./chunk-F2S5BLPE.js";
 import "./chunk-WTOYCUKH.js";
 import "./chunk-DZSIUEGH.js";
@@ -28,11 +28,11 @@ import "./chunk-VAJBWA2U.js";
 import "./chunk-HRYOZUSK.js";
 import "./chunk-VVZBBKRC.js";
 import "./chunk-YBMVHGY3.js";
-import "./chunk-RZTNH2TX.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import "./chunk-IFWP3ZDO.js";
 import "./chunk-NAWWC5I3.js";
 import "./chunk-NU7JSWVA.js";
@@ -86,4 +86,4 @@ var validateCommand = defineCommand({
 export {
   validateCommand
 };
-//# sourceMappingURL=validate-Y6R6F5T3.js.map
+//# sourceMappingURL=validate-MC4EIQI5.js.map

package/dist/{videos-U2FPMNFS.js → videos-S7BYFSU3.js}

@@ -24,16 +24,16 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
     get: () => import("./get-6WEYKOY6.js").then((m) => m.getCommand),
     group: () => import("./group-EFZ3AJIE.js").then((m) => m.groupCommand),
     search: () => import("./search-OQNGSMUH.js").then((m) => m.searchCommand),
-    upload: () => import("./upload-KWFKNKAF.js").then((m) => m.uploadCommand),
-    ingest: () => import("./ingest-NYP2ZAAK.js").then((m) => m.ingestCommand),
+    upload: () => import("./upload-SIAI6NMH.js").then((m) => m.uploadCommand),
+    ingest: () => import("./ingest-VNRTFD4Y.js").then((m) => m.ingestCommand),
     fetch: () => import("./fetch-XF76JABV.js").then((m) => m.fetchCommand),
     describe: () => import("./describe-6NVOWIBE.js").then((m) => m.describeCommand),
     delete: () => import("./delete-MRM2S4Z5.js").then((m) => m.deleteCommand),
-    retry: () => import("./retry-LSCVGZM5.js").then((m) => m.retryCommand),
-    tags: () => import("./tags-BQFPK55V.js").then((m) => m.tagsCommand)
+    retry: () => import("./retry-WMGEUJPB.js").then((m) => m.retryCommand),
+    tags: () => import("./tags-2MX3332V.js").then((m) => m.tagsCommand)
   }
 });
 export {
   videosCommand
 };
-//# sourceMappingURL=videos-U2FPMNFS.js.map
+//# sourceMappingURL=videos-S7BYFSU3.js.map

package/dist/{web-AHTOJNQY.js → web-5R7LHKIT.js}

@@ -1,16 +1,16 @@
 import {
   webDepthHints
-} from "./chunk-46TPPYCI.js";
+} from "./chunk-X5VHGXFB.js";
 import {
   handleResearchError,
   writeResearchHints,
   writeResearchJson
 } from "./chunk-WNFIJAUO.js";
-import "./chunk-RZTNH2TX.js";
+import "./chunk-45OQOUJA.js";
 import "./chunk-GXDLWBOY.js";
 import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
 import {
   apiGet,
   apiPost
@@ -137,4 +137,4 @@ Examples:
 export {
   webCommand
 };
-//# sourceMappingURL=web-AHTOJNQY.js.map
+//# sourceMappingURL=web-5R7LHKIT.js.map

package/dist/{winning-ads-TUYN2BST.js → winning-ads-PDCY4YW5.js}

@@ -50,7 +50,7 @@ Full guide: __tooling__/docs/tools/baker/winning-ads.md`
     content: () => import("./content-3ZPP4SW2.js").then((m) => m.contentCommand),
     fit: () => import("./fit-7237F5EB.js").then((m) => m.fitCommand),
     unfollow: () => import("./unfollow-CBVPGPF7.js").then((m) => m.unfollowCommand),
-    refresh: () => import("./refresh-PSXGRCJE.js").then((m) => m.refreshCommand),
+    refresh: () => import("./refresh-HVBCC2ZI.js").then((m) => m.refreshCommand),
     hooks: () => import("./seeds-N6FF5S4T.js").then((m) => m.hooksCommand),
     mechanisms: () => import("./seeds-N6FF5S4T.js").then((m) => m.mechanismsCommand),
     formats: () => import("./seeds-N6FF5S4T.js").then((m) => m.formatsCommand)
@@ -59,4 +59,4 @@ Full guide: __tooling__/docs/tools/baker/winning-ads.md`
 export {
   winningAdsCommand
 };
-//# sourceMappingURL=winning-ads-TUYN2BST.js.map
+//# sourceMappingURL=winning-ads-PDCY4YW5.js.map

package/dist/{write-commands-CT74VHH6.js → write-commands-MFRZD6Q6.js}

@@ -12,12 +12,12 @@ import {
   stageOp,
   stageStatusChange,
   upper
-} from "./chunk-L27H2R2N.js";
+} from "./chunk-2ZY7HON7.js";
 import {
   buildCustomConversionRule
 } from "./chunk-GOJXKIFQ.js";
 import "./chunk-KLNKEVIY.js";
-import "./chunk-T4DD5YMP.js";
+import "./chunk-XY7BZSDQ.js";
 import "./chunk-4NZ47VXO.js";
 import "./chunk-D5FY4FAK.js";
 import "./chunk-F2S5BLPE.js";
@@ -28,7 +28,7 @@ import "./chunk-VAJBWA2U.js";
 import "./chunk-HRYOZUSK.js";
 import "./chunk-VVZBBKRC.js";
 import "./chunk-YBMVHGY3.js";
-import "./chunk-ZJWUBJYQ.js";
+import "./chunk-XQIOCIDO.js";
 import "./chunk-XBOK23HI.js";
 import "./chunk-IFWP3ZDO.js";
 import "./chunk-NAWWC5I3.js";
@@ -734,4 +734,4 @@ export {
   customConversionsCreateCommand,
   mediaUploadCommand
 };
-//# sourceMappingURL=write-commands-CT74VHH6.js.map
+//# sourceMappingURL=write-commands-MFRZD6Q6.js.map