@koda-sl/baker-cli 0.151.0-dev.1a051172a → 0.151.0

package/dist/cli.js

@@ -36,7 +36,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-JBDSJZBZ.js";
+} from "./chunk-OO5BDH3J.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -4074,1041 +4074,296 @@ function getFieldDescriptions(fields) {
   return result;
 }
 
-// src/commands/ads/google/changes-window.ts
+// ../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;
-function isChangeScope(value) {
-  return value === "detail" || value === "summary";
-}
-function resolveChangesWindow(input) {
-  const scope = input.scope ?? "detail";
-  if (!isChangeScope(scope)) {
-    return {
-      ok: false,
-      error: {
-        code: "INVALID_SCOPE",
-        message: `Unknown scope '${scope}'. Use 'detail' (field-level changes, 30 days) or 'summary' (which resources changed, 90 days).`,
-        fix: {
-          action: "retry_with_flag",
-          explanation: "Pass --scope detail or --scope summary."
-        }
-      }
-    };
-  }
-  const days = input.days ?? DEFAULT_CHANGE_DAYS;
-  if (!Number.isInteger(days) || days < 1) {
-    return {
-      ok: false,
-      error: {
-        code: "INVALID_LOOKBACK",
-        message: `--days must be a whole number of days, got '${days}'.`,
-        fix: {
-          action: "retry_with_flag",
-          explanation: `Pass --days as a positive integer, e.g. --days ${DEFAULT_CHANGE_DAYS}.`
-        }
-      }
-    };
-  }
-  const max = CHANGE_SCOPE_MAX_DAYS[scope];
-  if (days > max) {
-    return { ok: false, error: lookbackTooLong(scope, days, max) };
-  }
-  return { ok: true, scope, days, hints: hintsFor(scope, days) };
-}
-function lookbackTooLong(scope, days, max) {
-  if (scope === "detail" && days <= CHANGE_SCOPE_MAX_DAYS.summary) {
-    return {
-      code: "LOOKBACK_TOO_LONG",
-      message: `Google keeps field-level change detail for ${max} days only; ${days} days is outside that window.`,
-      fix: {
-        action: "narrow_date_range",
-        explanation: `Re-run with --scope summary --days ${days} to reach back ${CHANGE_SCOPE_MAX_DAYS.summary} days. Summary tells you which campaigns, ad groups, ads and criteria changed and when, but not the old and new values \u2014 read the resource itself for current values.`
-      }
-    };
-  }
-  return {
-    code: "LOOKBACK_TOO_LONG",
-    message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
-    fix: {
-      action: "use_different_resource",
-      explanation: "Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters."
-    }
-  };
-}
-function hintsFor(scope, days) {
-  const hints = [];
-  if (scope === "detail") {
-    hints.push(
-      `Detailed history covers the last ${CHANGE_SCOPE_MAX_DAYS.detail} days. For anything older use --scope summary (reaches ${CHANGE_SCOPE_MAX_DAYS.summary} days, reports which resources changed but not their values).`
-    );
-  } else {
-    hints.push(
-      "Summary history reports which resources changed and when, not old and new values. To see what a changed resource looks like now, query it by resource_name."
-    );
-    if (days > CHANGE_SCOPE_MAX_DAYS.detail) {
-      hints.push(
-        `Changes inside the last ${CHANGE_SCOPE_MAX_DAYS.detail} days also have field-level detail \u2014 re-run with --scope detail for those.`
-      );
-    }
-  }
-  return hints;
+var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
+function isChangeLookbackWithinReach(days, scope) {
+  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
 }
 
-// src/commands/ads/google/correction-table.ts
-function buildCommand(query, ctx) {
-  return `baker ads google query "${query}" --customer-id ${ctx.customerId}`;
-}
-var CORRECTION_RULES = [
-  // 0. EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE — some resources (e.g. campaign_budget)
-  // require fields filtered in WHERE to also be selected. The error names the exact field,
-  // so add it to SELECT and retry. Kept first: field-specific rules below must not shadow
-  // this with an unrelated rewrite when the named field happens to match their pattern.
-  {
-    matchApiError: /must be present in SELECT clause:\s*'([\w.]+)'/i,
-    fix: (ctx) => {
-      const field = ctx.apiErrorMessage?.match(/must be present in SELECT clause:\s*'([\w.]+)'/i)?.[1];
-      if (!field) {
-        return {
-          action: "add_required_field",
-          explanation: "Add the field named in the error to the SELECT clause and retry"
-        };
-      }
-      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
-      return {
-        action: "add_required_field",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: `${field} is used in WHERE but this resource requires it in SELECT too \u2014 added it`
-      };
-    }
+// ../api/src/ads-google/limits.ts
+var GOOGLE_ADS_LIMITS = {
+  budget: {
+    nameMax: 255,
+    amountMicrosMin: 1
   },
-  // 1. bare keyword.text → ad_group_criterion.keyword.text (leaves <resource>.keyword.text untouched)
-  {
-    matchQuery: /(?<![\w.])keyword\.text\b/,
-    matchApiError: /keyword\.text/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/(?<![\w.])keyword\.text\b/g, "ad_group_criterion.keyword.text");
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Use ad_group_criterion.keyword.text \u2014 keywords are accessed through the criterion resource"
-      };
-    }
+  campaign: {
+    nameMax: 255
   },
-  // 2. bare keyword.match_type → ad_group_criterion.keyword.match_type (leaves <resource>.keyword.match_type untouched)
-  {
-    matchQuery: /(?<![\w.])keyword\.match_type\b/,
-    matchApiError: /keyword\.match_type/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(
-        /(?<![\w.])keyword\.match_type\b/g,
-        "ad_group_criterion.keyword.match_type"
-      );
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Use ad_group_criterion.keyword.match_type for keyword match type"
-      };
-    }
+  adGroup: {
+    nameMax: 255
   },
-  // 3. campaign_budget.* queried FROM campaign
-  {
-    matchQuery: /campaign_budget\.\w+.*FROM\s+campaign\b/i,
-    matchApiError: /campaign_budget.*not.*valid.*campaign|cannot.*select.*campaign_budget/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/FROM\s+campaign\b/i, "FROM campaign_budget");
-      return {
-        action: "use_different_resource",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "campaign_budget fields must be queried FROM campaign_budget, not FROM campaign"
-      };
-    }
+  keyword: {
+    textMax: 80,
+    wordsMax: 10
   },
-  // 4. CONTAINS → LIKE
-  {
-    matchQuery: /CONTAINS\s*\(/i,
-    matchApiError: /CONTAINS.*not.*supported|invalid.*operator.*CONTAINS/i,
-    fix: (ctx) => {
-      const match = ctx.originalQuery.match(/CONTAINS\s*\(\s*([^,]+),\s*'([^']+)'\s*\)/i);
-      if (match) {
-        const field = match[1]?.trim();
-        const value = match[2] ?? "";
-        const corrected = ctx.originalQuery.replace(
-          /CONTAINS\s*\(\s*[^,]+,\s*'[^']+'\s*\)/i,
-          `${field} LIKE '%${value}%'`
-        );
-        return {
-          action: "change_operator",
-          correctedCommand: buildCommand(corrected, ctx),
-          explanation: "GAQL uses LIKE '%value%' for substring matching, not CONTAINS()"
-        };
-      }
-      return {
-        action: "change_operator",
-        explanation: "Replace CONTAINS(field, 'value') with field LIKE '%value%'"
-      };
-    }
+  responsiveSearchAd: {
+    headlinesMin: 3,
+    headlinesMax: 15,
+    headlineTextMax: 30,
+    descriptionsMin: 2,
+    descriptionsMax: 4,
+    descriptionTextMax: 90,
+    pathMax: 15
   },
-  // 5. ad_group_criterion query without negative filter — auto-add the field
-  {
-    matchQuery: /FROM\s+ad_group_criterion\b(?!.*ad_group_criterion\.negative)/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT ad_group_criterion.negative, ");
-      return {
-        action: "add_required_field",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Added ad_group_criterion.negative to distinguish positive (targeting) from negative (blocking) keywords. Filter with WHERE ad_group_criterion.negative = FALSE for positives only."
-      };
-    }
+  responsiveDisplayAd: {
+    headlinesMin: 1,
+    headlinesMax: 5,
+    headlineTextMax: 30,
+    longHeadlineTextMax: 90,
+    descriptionsMin: 1,
+    descriptionsMax: 5,
+    descriptionTextMax: 90,
+    businessNameMax: 25
   },
-  // 6. Missing campaign.id in ad_group queries
-  {
-    matchQuery: /FROM\s+ad_group\b/i,
-    matchApiError: /campaign\.id.*required|must.*include.*campaign\.id/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
-      return {
-        action: "add_required_field",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Ad group queries require campaign.id in SELECT for parent context"
-      };
-    }
+  sharedSet: {
+    nameMax: 255
   },
-  // 6. Missing campaign.id in keyword_view queries
-  {
-    matchQuery: /FROM\s+keyword_view\b/i,
-    matchApiError: /campaign\.id.*required.*keyword/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
-      return {
-        action: "add_required_field",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Keyword view queries require campaign.id in SELECT"
-      };
-    }
+  asset: {
+    sitelinkLinkTextMax: 25,
+    sitelinkDescriptionMax: 35,
+    calloutTextMax: 25,
+    structuredSnippetHeaderMax: 25,
+    structuredSnippetValuesMin: 3,
+    structuredSnippetValuesMax: 10
   },
-  // 7. shopping_performance_view.product_* → segments.product_*
-  {
-    matchQuery: /shopping_performance_view\.product_\w+/,
-    matchApiError: /shopping_performance_view\.product/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/shopping_performance_view\.product_(\w+)/g, "segments.product_$1");
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Product fields are segments (segments.product_*), not fields on shopping_performance_view"
-      };
-    }
+  conversionAction: {
+    nameMax: 255
   },
-  // 8. Open-ended date range
-  {
-    matchQuery: /segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i,
-    matchApiError: /date.*range.*must.*finite|open.*ended/i,
-    fix: (ctx) => {
-      const match = ctx.originalQuery.match(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i);
-      const startDate = match?.[1] ?? "2024-01-01";
-      const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-      const corrected = ctx.originalQuery.replace(
-        /segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i,
-        `segments.date BETWEEN '${startDate}' AND '${today}'`
-      );
-      return {
-        action: "narrow_date_range",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Use BETWEEN with explicit end date \u2014 open-ended ranges are not supported"
-      };
-    }
-  },
-  // 9. Missing LIMIT
-  {
-    matchQuery: /^(?!.*\bLIMIT\b)/is,
-    fix: (ctx) => {
-      const corrected = `${ctx.originalQuery.trimEnd()} LIMIT 200`;
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Added LIMIT 200 to prevent excessive data transfer"
-      };
-    }
-  },
-  // 10a. Customer not found (wrong customer ID)
-  {
-    matchApiError: /CUSTOMER_NOT_FOUND|not.*found.*customer/i,
-    fix: () => ({
-      action: "reject",
-      explanation: "Customer ID not found. Run 'baker ads google accounts' to list valid customer IDs, then retry with a valid --customer-id."
-    })
-  },
-  // 10b. Not accessible / login-customer-id required
-  {
-    matchApiError: /not.*accessible|login.customer.id/i,
-    fix: (ctx) => ({
-      action: "reject",
-      correctedCommand: buildCommand(ctx.originalQuery, ctx),
-      explanation: "Account not accessible \u2014 may need a manager (MCC) login-customer-id. Run 'baker ads google accounts' to refresh the accounts cache, then retry."
-    })
-  },
-  // 11. Campaign type by name matching
-  {
-    matchQuery: /campaign\.name\s*LIKE\s*'%\s*(shopping|pmax|search|display|video)\s*%'/i,
-    fix: (ctx) => {
-      const match = ctx.originalQuery.match(/campaign\.name\s*LIKE\s*'%\s*(shopping|pmax|search|display|video)\s*%'/i);
-      const typeMap = {
-        shopping: "SHOPPING",
-        pmax: "PERFORMANCE_MAX",
-        search: "SEARCH",
-        display: "DISPLAY",
-        video: "VIDEO"
-      };
-      const channelType = typeMap[match?.[1]?.toLowerCase() ?? ""] ?? "SEARCH";
-      const corrected = ctx.originalQuery.replace(
-        /campaign\.name\s*LIKE\s*'%[^']*%'/i,
-        `campaign.advertising_channel_type = '${channelType}'`
-      );
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Filter by campaign.advertising_channel_type enum, not by name pattern"
-      };
-    }
-  },
-  // 12. Incompatible fields
-  {
-    matchApiError: /incompatible|mutually.*exclusive|cannot.*select.*together/i,
-    fix: () => ({
-      action: "split_query",
-      explanation: "These fields cannot be in the same query \u2014 split into separate queries and join client-side"
-    })
-  },
-  // 13. campaign.status = 'ACTIVE' → 'ENABLED'
-  {
-    matchQuery: /campaign\.status\s*=\s*'ACTIVE'/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/campaign\.status\s*=\s*'ACTIVE'/gi, "campaign.status = 'ENABLED'");
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Campaign status uses ENABLED, not ACTIVE"
-      };
-    }
-  },
-  // 14. ad_group.status = 'ACTIVE' → 'ENABLED'
-  {
-    matchQuery: /ad_group\.status\s*=\s*'ACTIVE'/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/ad_group\.status\s*=\s*'ACTIVE'/gi, "ad_group.status = 'ENABLED'");
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Ad group status uses ENABLED, not ACTIVE"
-      };
-    }
-  },
-  // 15. ad.final_urls → ad_group_ad.ad.final_urls
-  {
-    matchQuery: /\bad\.final_urls\b(?!.*ad_group_ad)/,
-    matchApiError: /ad\.final_urls/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/\bad\.final_urls\b/g, "ad_group_ad.ad.final_urls");
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Use the full path: ad_group_ad.ad.final_urls"
-      };
-    }
-  },
-  // 15b. asset.<type>_asset.final_urls → asset.final_urls (final URLs live on the asset
-  // itself; the typed sub-message only carries type-specific fields like link_text)
-  {
-    matchQuery: /asset\.\w+_asset\.final_(mobile_)?urls\b/,
-    matchApiError: /asset\.\w+_asset\.final_(mobile_)?urls/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/asset\.\w+_asset\.final_(mobile_)?urls\b/g, "asset.final_$1urls");
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "Final URLs are on the asset itself \u2014 use asset.final_urls, not asset.<type>_asset.final_urls"
-      };
-    }
-  },
-  // 16. Rate limit / quota
-  {
-    matchApiError: /RESOURCE_EXHAUSTED|quota.*exceeded|rate.*limit/i,
-    fix: () => ({
-      action: "wait_and_retry",
-      explanation: "API quota exceeded \u2014 wait 30 seconds before retrying"
-    })
-  },
-  // 17. WHERE on metrics
-  {
-    matchApiError: /cannot.*filter.*metric|WHERE.*metrics|prohibited.*where/i,
-    fix: () => ({
-      action: "reject",
-      explanation: "Cannot filter on metrics in WHERE clause \u2014 remove the metrics filter and filter results client-side"
-    })
-  },
-  // 18. ORDER BY field not in SELECT
-  {
-    matchApiError: /order.*by.*field.*not.*selected|must.*select.*field.*order/i,
-    fix: (ctx) => {
-      const orderMatch = ctx.originalQuery.match(/ORDER\s+BY\s+([\w.]+)/i);
-      const field = orderMatch?.[1] ?? "field";
-      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
-      return {
-        action: "add_required_field",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: `Add ${field} to SELECT \u2014 ORDER BY fields must be selected`
-      };
-    }
-  },
-  // 19. Results include REMOVED entities
-  {
-    matchApiError: /REMOVED.*entities|status.*filter/i,
-    fix: (ctx) => {
-      const resourceMatch = ctx.originalQuery.match(/FROM\s+(\w+)/i);
-      const resource = resourceMatch?.[1] ?? "campaign";
-      const hasWhere = /WHERE/i.test(ctx.originalQuery);
-      const suffix = hasWhere ? ` AND ${resource}.status != 'REMOVED'` : ` WHERE ${resource}.status != 'REMOVED'`;
-      const limitMatch = ctx.originalQuery.match(/(\s+LIMIT\s+\d+)/i);
-      let corrected;
-      if (limitMatch) {
-        corrected = ctx.originalQuery.replace(/(\s+LIMIT\s+\d+)/i, `${suffix}$1`);
-      } else {
-        corrected = ctx.originalQuery.trimEnd() + suffix;
-      }
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: `Add status filter to exclude REMOVED ${resource}s`
-      };
-    }
-  },
-  // 20a. change_event past its 30-day reach → change_status, which reaches 90 days.
-  // The enum prefix in the API message is what separates this from the change_status
-  // case below; a bare START_DATE_TOO_OLD falls through to the query-pattern pass,
-  // which routes on the resource the caller actually queried.
-  {
-    matchQuery: /FROM\s+change_event\b/i,
-    matchApiError: /ChangeEventError\.START_DATE_TOO_OLD/i,
-    fix: (ctx) => {
-      const limit = ctx.originalQuery.match(/LIMIT\s+(\d+)/i)?.[1] ?? "50";
-      const requested = ctx.originalQuery.match(/change_date_time\s*>=\s*'([^']+)'/i)?.[1]?.slice(0, 10);
-      const ninetyDaysAgo = new Date(Date.now() - 90 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
-      const start = requested && requested > ninetyDaysAgo ? requested : ninetyDaysAgo;
-      const corrected = `SELECT change_status.last_change_date_time, change_status.resource_type, change_status.resource_status, change_status.resource_name, change_status.campaign, change_status.ad_group FROM change_status WHERE change_status.last_change_date_time >= '${start}' ORDER BY change_status.last_change_date_time DESC LIMIT ${limit}`;
-      return {
-        action: "use_different_resource",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: `change_event only reaches back 30 days. change_status reaches 90 (from ${start}) but reports only which resources changed and whether they were added, changed or removed \u2014 no old/new values and no user email. Read a changed resource by its resource_name to see its current values.`
-      };
-    }
-  },
-  // 20b. Past 90 days no history resource reaches — infer the change from spend instead.
-  {
-    matchQuery: /FROM\s+change_status\b/i,
-    matchApiError: /ChangeStatusError\.START_DATE_TOO_OLD/i,
-    fix: () => ({
-      action: "use_different_resource",
-      explanation: "Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API."
-    })
-  },
-  // 20. change_event without date constraint
-  {
-    matchQuery: /FROM\s+change_event\b(?!.*change_date_time)/i,
-    matchApiError: /change_event.*date|date.*required.*change/i,
-    fix: (ctx) => {
-      const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
-      const hasWhere = /WHERE/i.test(ctx.originalQuery);
-      const suffix = hasWhere ? ` AND change_event.change_date_time >= '${sevenDaysAgo}'` : ` WHERE change_event.change_date_time >= '${sevenDaysAgo}'`;
-      const corrected = ctx.originalQuery.trimEnd() + suffix;
-      return {
-        action: "add_required_field",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "change_event queries require a date constraint on change_date_time"
-      };
-    }
-  },
-  // 21. resource_name = 'customers/X/Y/Z' → resource.id = Z
-  {
-    matchQuery: /(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i,
-    fix: (ctx) => {
-      const match = ctx.originalQuery.match(/(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i);
-      const resource = match?.[1] ?? "campaign";
-      const id = match?.[2] ?? "ID";
-      const corrected = ctx.originalQuery.replace(
-        /(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i,
-        `${resource}.id = ${id}`
-      );
-      return {
-        action: "retry_with_modified_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: `Simpler: use ${resource}.id = ${id} instead of resource_name path`
-      };
-    }
+  audience: {
+    nameMax: 255
   },
-  // 22. segments.click_type incompatibility
-  {
-    matchApiError: /click_type.*incompatible|cannot.*click_type/i,
-    fix: (ctx) => {
-      const corrected = ctx.originalQuery.replace(/,?\s*segments\.click_type/g, "");
-      return {
-        action: "split_query",
-        correctedCommand: buildCommand(corrected, ctx),
-        explanation: "segments.click_type is incompatible with other segments \u2014 remove it or query separately"
-      };
-    }
+  biddingStrategy: {
+    nameMax: 255
   },
-  // 23. Bare resource in SELECT
-  {
-    matchApiError: /cannot.*select.*bare.*resource|invalid.*field/i,
-    fix: () => ({
-      action: "retry_with_modified_query",
-      explanation: "Cannot SELECT a bare resource name \u2014 use resource.id, resource.name, or resource.resource_name"
-    })
+  label: {
+    nameMax: 255
   },
-  // 24. Authentication error
-  {
-    matchApiError: /unauthenticated|authentication.*required|invalid.*credentials/i,
-    fix: () => ({
-      action: "authenticate",
-      explanation: "Google Ads authentication failed \u2014 reconnect Google Ads in dashboard settings"
-    })
-  },
-  // 25. Timeout / deadline exceeded
-  {
-    matchApiError: /timeout|deadline.*exceeded|DEADLINE_EXCEEDED/i,
-    fix: (ctx) => ({
-      action: "retry_with_modified_query",
-      correctedCommand: buildCommand(ctx.originalQuery, ctx),
-      explanation: "Query timed out \u2014 narrow the date range, add more WHERE filters, or reduce LIMIT"
-    })
+  assetGroup: {
+    nameMax: 255,
+    headlinesMin: 3,
+    headlinesMax: 15,
+    headlineTextMax: 30,
+    longHeadlinesMin: 1,
+    longHeadlinesMax: 5,
+    longHeadlineTextMax: 90,
+    descriptionsMin: 2,
+    descriptionsMax: 5,
+    descriptionTextMax: 90,
+    businessNameMax: 25
   }
+};
+var KEYWORD_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
+var ADVERTISING_CHANNEL_TYPES = [
+  "SEARCH",
+  "DISPLAY",
+  "SHOPPING",
+  "VIDEO",
+  "PERFORMANCE_MAX",
+  "DEMAND_GEN",
+  "MULTI_CHANNEL",
+  "LOCAL",
+  "SMART",
+  "TRAVEL",
+  "HOTEL",
+  "DISCOVERY"
 ];
-
-// src/commands/ads/google/error-parser.ts
-function mapErrorCode(message) {
-  if (/must be present in SELECT clause/i.test(message)) return "MISSING_SELECT_FIELD";
-  if (/field.*not.*found|unrecognized.*field|not.*valid.*field/i.test(message)) return "FIELD_NOT_FOUND";
-  if (/not.*valid.*resource|cannot.*select.*from/i.test(message)) return "WRONG_RESOURCE";
-  if (/operator|CONTAINS|LIKE/i.test(message)) return "INVALID_OPERATOR";
-  if (/CUSTOMER_NOT_FOUND/i.test(message)) return "CUSTOMER_NOT_FOUND";
-  if (/login.customer.id|not.*accessible/i.test(message)) return "MISSING_MANAGER_ID";
-  if (/incompatible|mutually.*exclusive|PROHIBITED_SEGMENT_WITH_METRIC/i.test(message)) return "INCOMPATIBLE_FIELDS";
-  if (/unauthenticated|authentication/i.test(message)) return "AUTH_ERROR";
-  if (/permission/i.test(message)) return "PERMISSION_DENIED";
-  if (/RESOURCE_EXHAUSTED|quota|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
-  if (/timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
-  return "API_ERROR";
-}
-function isRetryable(code) {
-  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT";
-}
-function getRetryDelay(code) {
-  if (code === "QUOTA_EXCEEDED") return 3e4;
-  if (code === "TIMEOUT") return 5e3;
-  return void 0;
+var ADVERTISING_CHANNEL_SUB_TYPES = [
+  "SEARCH_MOBILE_APP",
+  "DISPLAY_MOBILE_APP",
+  "SEARCH_EXPRESS",
+  "DISPLAY_EXPRESS",
+  "SHOPPING_SMART_ADS",
+  "DISPLAY_GMAIL_AD",
+  "DISPLAY_SMART_CAMPAIGN",
+  "VIDEO_OUTSTREAM",
+  "VIDEO_ACTION",
+  "VIDEO_NON_SKIPPABLE",
+  "APP_CAMPAIGN",
+  "APP_CAMPAIGN_FOR_ENGAGEMENT",
+  "LOCAL_CAMPAIGN",
+  "SHOPPING_COMPARISON_LISTING_ADS",
+  "SEARCH_MOBILE_APP_ENGAGEMENT",
+  "TRAVEL_ACTIVITIES"
+];
+var BIDDING_STRATEGY_TYPES = [
+  "MANUAL_CPC",
+  "MAXIMIZE_CONVERSIONS",
+  "MAXIMIZE_CONVERSION_VALUE",
+  "TARGET_SPEND",
+  "TARGET_CPA",
+  "TARGET_ROAS",
+  "TARGET_IMPRESSION_SHARE",
+  "MANUAL_CPM",
+  "MANUAL_CPV",
+  "PERCENT_CPC"
+];
+var BUDGET_DELIVERY_METHODS = ["STANDARD", "ACCELERATED"];
+var AD_GROUP_TYPES = [
+  "SEARCH_STANDARD",
+  "DISPLAY_STANDARD",
+  "SHOPPING_PRODUCT_ADS",
+  "VIDEO_BUMPER",
+  "VIDEO_TRUE_VIEW_IN_STREAM",
+  "VIDEO_TRUE_VIEW_IN_DISPLAY",
+  "VIDEO_NON_SKIPPABLE_IN_STREAM",
+  "VIDEO_OUTSTREAM",
+  "DEMAND_GEN_AD"
+];
+var SHARED_SET_TYPES = [
+  "NEGATIVE_KEYWORDS",
+  "NEGATIVE_PLACEMENTS",
+  "ACCOUNT_LEVEL_NEGATIVE_KEYWORDS"
+];
+var STAGEABLE_CREATE_STATUSES2 = ["ENABLED", "PAUSED"];
+var PINNED_FIELDS = ["HEADLINE_1", "HEADLINE_2", "HEADLINE_3", "DESCRIPTION_1", "DESCRIPTION_2"];
+var CONVERSION_ACTION_CATEGORIES = [
+  "DEFAULT",
+  "PAGE_VIEW",
+  "PURCHASE",
+  "SIGNUP",
+  "LEAD",
+  "DOWNLOAD",
+  "ADD_TO_CART",
+  "BEGIN_CHECKOUT",
+  "SUBSCRIBE_PAID",
+  "PHONE_CALL_LEAD",
+  "SUBMIT_LEAD_FORM",
+  "BOOK_APPOINTMENT",
+  "REQUEST_QUOTE",
+  "CONTACT"
+];
+var CONVERSION_ACTION_TYPES = [
+  "WEBPAGE",
+  "UPLOAD_CLICKS",
+  "UPLOAD_CALLS",
+  "WEBSITE_CALL",
+  "GOOGLE_ANALYTICS_4_CUSTOM"
+];
+var CONVERSION_COUNTING_TYPES = ["ONE_PER_CLICK", "MANY_PER_CLICK"];
+var USER_LIST_TYPES = ["CRM_BASED", "RULE_BASED", "LOGICAL", "BASIC", "LOOKALIKE"];
+var ASSET_FIELD_TYPES = [
+  "SITELINK",
+  "CALLOUT",
+  "STRUCTURED_SNIPPET",
+  "CALL",
+  "PRICE",
+  "PROMOTION",
+  "MOBILE_APP",
+  "HEADLINE",
+  "DESCRIPTION",
+  "LOGO",
+  "MARKETING_IMAGE",
+  "BUSINESS_NAME"
+];
+var DEVICE_TYPES = ["MOBILE", "TABLET", "DESKTOP", "CONNECTED_TV", "OTHER"];
+var DAYS_OF_WEEK = ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"];
+var CAMPAIGN_OBJECTIVES = [
+  "SALES",
+  "LEADS",
+  "WEBSITE_TRAFFIC",
+  "PRODUCT_BRAND_CONSIDERATION",
+  "BRAND_AWARENESS_REACH",
+  "APP_PROMOTION",
+  "LOCAL_STORE_VISITS"
+];
+var MICROS_PER_UNIT = 1e6;
+function toMicros(amount) {
+  return Math.round(amount * MICROS_PER_UNIT);
 }
-function parseApiError(errorMessage, originalQuery, customerId) {
-  const ctx = {
-    originalQuery,
-    customerId,
-    apiErrorMessage: errorMessage
-  };
-  for (const rule of CORRECTION_RULES) {
-    if (rule.matchApiError?.test(errorMessage)) {
-      const fix = rule.fix(ctx);
-      const code2 = mapErrorCode(errorMessage);
-      return {
-        ok: false,
-        error: {
-          code: code2,
-          message: errorMessage,
-          fix,
-          retryable: isRetryable(code2),
-          retryAfterMs: getRetryDelay(code2)
-        }
-      };
-    }
+var PLAYBOOK_DAILY_BUDGET_FLOOR_MICROS = 10 * MICROS_PER_UNIT;
+var TEMP_REF_REGEX2 = /^g_temp_[A-Za-z0-9_-]{2,}$/;
+var NUMERIC_ID_REGEX2 = /^\d+$/;
+var RESOURCE_NAME_REGEX = /^customers\/\d+\/[A-Za-z]+\/[-\w~]+$/;
+var GEO_TARGET_CONSTANT_REGEX = /^geoTargetConstants\/\d+$/;
+var LANGUAGE_CONSTANT_REGEX = /^languageConstants\/\d+$/;
+
+// ../api/src/ads-google/ops.ts
+import { z as z12 } from "zod";
+var tempRefSchema2 = z12.string().regex(TEMP_REF_REGEX2, "expected a g_temp_* reference");
+var refSchema = z12.union([
+  z12.string().regex(RESOURCE_NAME_REGEX, "expected a customers/\u2026/\u2026/\u2026 resource name"),
+  z12.string().regex(NUMERIC_ID_REGEX2, "expected a numeric id"),
+  tempRefSchema2
+]);
+var targetRefSchema = refSchema;
+var microsSchema = z12.number().int().positive("expected a positive micros amount");
+var httpsUrlSchema2 = z12.string().url().refine((u) => u.startsWith("https://"), "final URLs must be https");
+var customerIdSchema = z12.string().regex(NUMERIC_ID_REGEX2, "customerId must be the bare numeric customer id");
+var stageableStatusSchema2 = z12.enum(STAGEABLE_CREATE_STATUSES2);
+var matchTypeSchema = z12.enum(KEYWORD_MATCH_TYPES);
+var keywordTextSchema = z12.string().min(1).max(GOOGLE_ADS_LIMITS.keyword.textMax).refine((t) => t.trim().split(/\s+/).length <= GOOGLE_ADS_LIMITS.keyword.wordsMax, "keyword exceeds 10 words");
+var budgetCreateSchema = z12.object({
+  name: z12.string().min(1).max(GOOGLE_ADS_LIMITS.budget.nameMax),
+  amountMicros: microsSchema,
+  deliveryMethod: z12.enum(BUDGET_DELIVERY_METHODS).default("STANDARD"),
+  explicitlyShared: z12.boolean().default(false)
+});
+var budgetUpdateSchema = z12.object({
+  name: z12.string().min(1).max(GOOGLE_ADS_LIMITS.budget.nameMax).optional(),
+  amountMicros: microsSchema.optional(),
+  deliveryMethod: z12.enum(BUDGET_DELIVERY_METHODS).optional()
+}).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
+var biddingConfigSchema = z12.object({
+  type: z12.enum(BIDDING_STRATEGY_TYPES),
+  targetCpaMicros: microsSchema.optional(),
+  targetRoas: z12.number().positive().optional(),
+  cpcBidCeilingMicros: microsSchema.optional(),
+  enhancedCpcEnabled: z12.boolean().optional()
+}).superRefine((p, ctx) => {
+  if (p.type === "TARGET_CPA" && p.targetCpaMicros === void 0) {
+    ctx.addIssue({ code: "custom", path: ["targetCpaMicros"], message: "TARGET_CPA needs targetCpaMicros" });
   }
-  for (const rule of CORRECTION_RULES) {
-    if (rule.matchQuery?.test(originalQuery)) {
-      const fix = rule.fix(ctx);
-      const code2 = mapErrorCode(errorMessage);
-      return {
-        ok: false,
-        error: {
-          code: code2,
-          message: errorMessage,
-          fix,
-          retryable: isRetryable(code2),
-          retryAfterMs: getRetryDelay(code2)
-        }
-      };
-    }
-  }
-  const code = mapErrorCode(errorMessage);
-  return {
-    ok: false,
-    error: {
-      code,
-      message: errorMessage,
-      fix: {
-        action: "reject",
-        explanation: "Unrecognized error \u2014 verify query syntax against Google Ads GAQL reference"
-      },
-      retryable: isRetryable(code),
-      retryAfterMs: getRetryDelay(code)
-    }
-  };
-}
-
-// src/commands/ads/google/changes.ts
-registerSchema({
-  command: "ads.google.changes",
-  description: "Read the account's change history. --scope detail (default) shows what changed and to what value, back 30 days; --scope summary shows which resources changed, back 90 days.",
-  args: {
-    "customer-id": {
-      type: "string",
-      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
-      required: false
-    },
-    days: {
-      type: "string",
-      description: `Lookback days (default: ${DEFAULT_CHANGE_DAYS}). Max ${CHANGE_SCOPE_MAX_DAYS.detail} with --scope detail, ${CHANGE_SCOPE_MAX_DAYS.summary} with --scope summary. Google keeps nothing older behind any API.`,
-      required: false,
-      default: DEFAULT_CHANGE_DAYS
-    },
-    scope: {
-      type: "string",
-      description: `detail|summary (default: detail). detail = old/new values plus who made the change, ${CHANGE_SCOPE_MAX_DAYS.detail} days. summary = which resources were added, changed or removed, ${CHANGE_SCOPE_MAX_DAYS.summary} days, without values.`,
-      required: false,
-      default: "detail"
-    },
-    "resource-type": {
-      type: "string",
-      description: "Filter by type: CAMPAIGN, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION",
-      required: false
-    },
-    limit: { type: "string", description: "Max change events (default: 50, max: 1000)", required: false, default: 50 },
-    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  if (p.type === "TARGET_ROAS" && p.targetRoas === void 0) {
+    ctx.addIssue({ code: "custom", path: ["targetRoas"], message: "TARGET_ROAS needs targetRoas" });
   }
 });
-var changesCommand = defineCommand20({
-  meta: {
-    name: "changes",
-    description: `Read the change history of a Google Ads account.
-
-Google keeps account history in two layers, and neither reaches past 90 days:
-  --scope detail  (default)  what changed, old \u2192 new value, who changed it   \u2014 last ${CHANGE_SCOPE_MAX_DAYS.detail} days
-  --scope summary            which resources were added, changed or removed  \u2014 last ${CHANGE_SCOPE_MAX_DAYS.summary} days
-
-For anything older, infer it from performance instead \u2014 a monthly spend trend per
-campaign shows what started or stopped, just not who did it.
-
-Examples:
-  baker ads google changes --customer-id 1234567890
-  baker ads google changes --customer-id 1234567890 --days 14 --resource-type CAMPAIGN
-  baker ads google changes --customer-id 1234567890 --days 60 --scope summary`
-  },
-  args: {
-    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
-    days: { type: "string", description: `Lookback days (default ${DEFAULT_CHANGE_DAYS})`, required: false },
-    scope: { type: "string", description: "detail (30 days) or summary (90 days)", required: false },
-    "resource-type": { type: "string", description: "Filter by resource type", required: false },
-    limit: { type: "string", description: "Max results (default 50)", required: false },
-    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
-    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
-  },
-  run: async ({ args }) => {
-    const customerId = await resolveCustomerId(args);
-    const window = resolveChangesWindow({
-      days: args.days ? Number(args.days) : void 0,
-      scope: args.scope
+var networkSettingsSchema = z12.object({
+  targetGoogleSearch: z12.boolean().optional(),
+  targetSearchNetwork: z12.boolean().optional(),
+  targetContentNetwork: z12.boolean().optional(),
+  targetPartnerSearchNetwork: z12.boolean().optional()
+});
+var dateSchema = z12.string().regex(/^\d{4}-\d{2}-\d{2}$/, "expected a YYYY-MM-DD date");
+var campaignCreateSchema2 = z12.object({
+  name: z12.string().min(1).max(GOOGLE_ADS_LIMITS.campaign.nameMax),
+  channelType: z12.enum(ADVERTISING_CHANNEL_TYPES),
+  channelSubType: z12.enum(ADVERTISING_CHANNEL_SUB_TYPES).optional(),
+  budget: refSchema,
+  /** Inline standard bidding, or a portfolio strategy ref via biddingStrategy. */
+  bidding: biddingConfigSchema.optional(),
+  biddingStrategy: refSchema.optional(),
+  networkSettings: networkSettingsSchema.optional(),
+  startDate: dateSchema.optional(),
+  endDate: dateSchema.optional(),
+  /** Advisory Google Ads UI objective — drives warnings, not sent to the API. */
+  objective: z12.enum(CAMPAIGN_OBJECTIVES).optional(),
+  status: stageableStatusSchema2.default("PAUSED")
+}).superRefine((p, ctx) => {
+  if (!p.bidding && !p.biddingStrategy) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["bidding"],
+      message: "set an inline bidding strategy or reference a portfolio biddingStrategy"
     });
-    if (!window.ok) {
-      writeJsonEnvelope({ ok: false, error: { ...window.error, retryable: false } });
-      process.exit(1);
-      return;
-    }
-    const body = {
-      customerId,
-      days: window.days,
-      scope: window.scope,
-      limit: args.limit ? Number(args.limit) : 50
-    };
-    const managerId = getManagerIdForCustomer(customerId);
-    if (managerId) body.managerId = managerId;
-    if (args["resource-type"]) body.resourceType = args["resource-type"];
-    if (args["no-cache"]) body.skipCache = true;
-    try {
-      const data = await apiPost("/api/ads/google/changes", body);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeAdsOutput(data, format);
-        return;
-      }
-      const first = data[0];
-      const fields = first ? Object.keys(first) : [];
-      const fieldDescs = getFieldDescriptions(fields);
-      writeJsonEnvelope({ ok: true, data, fields: fieldDescs, hints: window.hints });
-    } catch (err) {
-      if (err instanceof ApiError) {
-        writeAdsJson(parseApiError(err.message, "", customerId));
-        process.exit(1);
-      }
-      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
   }
-});
-
-// src/commands/ads/google/currency.ts
-import { defineCommand as defineCommand21 } from "citty";
-registerSchema({
-  command: "ads.google.currency",
-  description: "Get the currency code for a Google Ads account. Returns currency_code, customer_id, account_name, and access_type. Call this before interpreting cost_micros values.",
-  args: {
-    "customer-id": {
-      type: "string",
-      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
-      required: false
-    }
+  if (p.bidding && p.biddingStrategy) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["bidding"],
+      message: "use inline bidding OR a portfolio biddingStrategy, not both"
+    });
   }
-});
-var currencyCommand = defineCommand21({
-  meta: {
-    name: "currency",
-    description: `Get account currency code. Use this to interpret metrics.cost_micros values.
-
-Examples:
-  baker ads google currency --customer-id 1234567890`
-  },
-  args: {
-    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
-    "no-cache": { type: "boolean", description: "Skip cache", required: false }
-  },
-  run: async ({ args }) => {
-    const customerId = await resolveCustomerId(args);
-    const useCache = !args["no-cache"];
-    const cacheKey = `currency:${customerId}`;
-    if (useCache) {
-      const cached = cacheGet("accounts", cacheKey);
-      if (cached) {
-        writeAdsJson({ ok: true, data: cached.data, cached: true });
-        return;
-      }
-    }
-    try {
-      const params = { "customer-id": customerId };
-      const managerId = getManagerIdForCustomer(customerId);
-      if (managerId) params["manager-id"] = managerId;
-      if (!useCache) params["skip-cache"] = "true";
-      const raw = await apiGet("/api/ads/google/currency", params);
-      const data = {
-        currency_code: raw.currencyCode,
-        customer_id: raw.customerId
-      };
-      if (useCache) {
-        cacheSet("accounts", cacheKey, data, 24 * 60 * 60 * 1e3);
-      }
-      writeAdsJson({ ok: true, data });
-    } catch (err) {
-      if (err instanceof ApiError) {
-        writeAdsJson(parseApiError(err.message, "", customerId));
-        process.exit(1);
-      }
-      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
-  }
-});
-
-// src/commands/ads/google/draft.ts
-import { defineCommand as defineCommand22 } from "citty";
-
-// src/commands/ads/google/write-shared.ts
-import { readFileSync as readFileSync2 } from "fs";
-
-// ../api/src/ads-google/limits.ts
-var GOOGLE_ADS_LIMITS = {
-  budget: {
-    nameMax: 255,
-    amountMicrosMin: 1
-  },
-  campaign: {
-    nameMax: 255
-  },
-  adGroup: {
-    nameMax: 255
-  },
-  keyword: {
-    textMax: 80,
-    wordsMax: 10
-  },
-  responsiveSearchAd: {
-    headlinesMin: 3,
-    headlinesMax: 15,
-    headlineTextMax: 30,
-    descriptionsMin: 2,
-    descriptionsMax: 4,
-    descriptionTextMax: 90,
-    pathMax: 15
-  },
-  responsiveDisplayAd: {
-    headlinesMin: 1,
-    headlinesMax: 5,
-    headlineTextMax: 30,
-    longHeadlineTextMax: 90,
-    descriptionsMin: 1,
-    descriptionsMax: 5,
-    descriptionTextMax: 90,
-    businessNameMax: 25
-  },
-  sharedSet: {
-    nameMax: 255
-  },
-  asset: {
-    sitelinkLinkTextMax: 25,
-    sitelinkDescriptionMax: 35,
-    calloutTextMax: 25,
-    structuredSnippetHeaderMax: 25,
-    structuredSnippetValuesMin: 3,
-    structuredSnippetValuesMax: 10
-  },
-  conversionAction: {
-    nameMax: 255
-  },
-  audience: {
-    nameMax: 255
-  },
-  biddingStrategy: {
-    nameMax: 255
-  },
-  label: {
-    nameMax: 255
-  },
-  assetGroup: {
-    nameMax: 255,
-    headlinesMin: 3,
-    headlinesMax: 15,
-    headlineTextMax: 30,
-    longHeadlinesMin: 1,
-    longHeadlinesMax: 5,
-    longHeadlineTextMax: 90,
-    descriptionsMin: 2,
-    descriptionsMax: 5,
-    descriptionTextMax: 90,
-    businessNameMax: 25
-  }
-};
-var KEYWORD_MATCH_TYPES = ["EXACT", "PHRASE", "BROAD"];
-var ADVERTISING_CHANNEL_TYPES = [
-  "SEARCH",
-  "DISPLAY",
-  "SHOPPING",
-  "VIDEO",
-  "PERFORMANCE_MAX",
-  "DEMAND_GEN",
-  "MULTI_CHANNEL",
-  "LOCAL",
-  "SMART",
-  "TRAVEL",
-  "HOTEL",
-  "DISCOVERY"
-];
-var ADVERTISING_CHANNEL_SUB_TYPES = [
-  "SEARCH_MOBILE_APP",
-  "DISPLAY_MOBILE_APP",
-  "SEARCH_EXPRESS",
-  "DISPLAY_EXPRESS",
-  "SHOPPING_SMART_ADS",
-  "DISPLAY_GMAIL_AD",
-  "DISPLAY_SMART_CAMPAIGN",
-  "VIDEO_OUTSTREAM",
-  "VIDEO_ACTION",
-  "VIDEO_NON_SKIPPABLE",
-  "APP_CAMPAIGN",
-  "APP_CAMPAIGN_FOR_ENGAGEMENT",
-  "LOCAL_CAMPAIGN",
-  "SHOPPING_COMPARISON_LISTING_ADS",
-  "SEARCH_MOBILE_APP_ENGAGEMENT",
-  "TRAVEL_ACTIVITIES"
-];
-var BIDDING_STRATEGY_TYPES = [
-  "MANUAL_CPC",
-  "MAXIMIZE_CONVERSIONS",
-  "MAXIMIZE_CONVERSION_VALUE",
-  "TARGET_SPEND",
-  "TARGET_CPA",
-  "TARGET_ROAS",
-  "TARGET_IMPRESSION_SHARE",
-  "MANUAL_CPM",
-  "MANUAL_CPV",
-  "PERCENT_CPC"
-];
-var BUDGET_DELIVERY_METHODS = ["STANDARD", "ACCELERATED"];
-var AD_GROUP_TYPES = [
-  "SEARCH_STANDARD",
-  "DISPLAY_STANDARD",
-  "SHOPPING_PRODUCT_ADS",
-  "VIDEO_BUMPER",
-  "VIDEO_TRUE_VIEW_IN_STREAM",
-  "VIDEO_TRUE_VIEW_IN_DISPLAY",
-  "VIDEO_NON_SKIPPABLE_IN_STREAM",
-  "VIDEO_OUTSTREAM",
-  "DEMAND_GEN_AD"
-];
-var SHARED_SET_TYPES = [
-  "NEGATIVE_KEYWORDS",
-  "NEGATIVE_PLACEMENTS",
-  "ACCOUNT_LEVEL_NEGATIVE_KEYWORDS"
-];
-var STAGEABLE_CREATE_STATUSES2 = ["ENABLED", "PAUSED"];
-var PINNED_FIELDS = ["HEADLINE_1", "HEADLINE_2", "HEADLINE_3", "DESCRIPTION_1", "DESCRIPTION_2"];
-var CONVERSION_ACTION_CATEGORIES = [
-  "DEFAULT",
-  "PAGE_VIEW",
-  "PURCHASE",
-  "SIGNUP",
-  "LEAD",
-  "DOWNLOAD",
-  "ADD_TO_CART",
-  "BEGIN_CHECKOUT",
-  "SUBSCRIBE_PAID",
-  "PHONE_CALL_LEAD",
-  "SUBMIT_LEAD_FORM",
-  "BOOK_APPOINTMENT",
-  "REQUEST_QUOTE",
-  "CONTACT"
-];
-var CONVERSION_ACTION_TYPES = [
-  "WEBPAGE",
-  "UPLOAD_CLICKS",
-  "UPLOAD_CALLS",
-  "WEBSITE_CALL",
-  "GOOGLE_ANALYTICS_4_CUSTOM"
-];
-var CONVERSION_COUNTING_TYPES = ["ONE_PER_CLICK", "MANY_PER_CLICK"];
-var USER_LIST_TYPES = ["CRM_BASED", "RULE_BASED", "LOGICAL", "BASIC", "LOOKALIKE"];
-var ASSET_FIELD_TYPES = [
-  "SITELINK",
-  "CALLOUT",
-  "STRUCTURED_SNIPPET",
-  "CALL",
-  "PRICE",
-  "PROMOTION",
-  "MOBILE_APP",
-  "HEADLINE",
-  "DESCRIPTION",
-  "LOGO",
-  "MARKETING_IMAGE",
-  "BUSINESS_NAME"
-];
-var DEVICE_TYPES = ["MOBILE", "TABLET", "DESKTOP", "CONNECTED_TV", "OTHER"];
-var DAYS_OF_WEEK = ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"];
-var CAMPAIGN_OBJECTIVES = [
-  "SALES",
-  "LEADS",
-  "WEBSITE_TRAFFIC",
-  "PRODUCT_BRAND_CONSIDERATION",
-  "BRAND_AWARENESS_REACH",
-  "APP_PROMOTION",
-  "LOCAL_STORE_VISITS"
-];
-var MICROS_PER_UNIT = 1e6;
-function toMicros(amount) {
-  return Math.round(amount * MICROS_PER_UNIT);
-}
-var PLAYBOOK_DAILY_BUDGET_FLOOR_MICROS = 10 * MICROS_PER_UNIT;
-var TEMP_REF_REGEX2 = /^g_temp_[A-Za-z0-9_-]{2,}$/;
-var NUMERIC_ID_REGEX2 = /^\d+$/;
-var RESOURCE_NAME_REGEX = /^customers\/\d+\/[A-Za-z]+\/[-\w~]+$/;
-var GEO_TARGET_CONSTANT_REGEX = /^geoTargetConstants\/\d+$/;
-var LANGUAGE_CONSTANT_REGEX = /^languageConstants\/\d+$/;
-
-// ../api/src/ads-google/ops.ts
-import { z as z12 } from "zod";
-var tempRefSchema2 = z12.string().regex(TEMP_REF_REGEX2, "expected a g_temp_* reference");
-var refSchema = z12.union([
-  z12.string().regex(RESOURCE_NAME_REGEX, "expected a customers/\u2026/\u2026/\u2026 resource name"),
-  z12.string().regex(NUMERIC_ID_REGEX2, "expected a numeric id"),
-  tempRefSchema2
-]);
-var targetRefSchema = refSchema;
-var microsSchema = z12.number().int().positive("expected a positive micros amount");
-var httpsUrlSchema2 = z12.string().url().refine((u) => u.startsWith("https://"), "final URLs must be https");
-var customerIdSchema = z12.string().regex(NUMERIC_ID_REGEX2, "customerId must be the bare numeric customer id");
-var stageableStatusSchema2 = z12.enum(STAGEABLE_CREATE_STATUSES2);
-var matchTypeSchema = z12.enum(KEYWORD_MATCH_TYPES);
-var keywordTextSchema = z12.string().min(1).max(GOOGLE_ADS_LIMITS.keyword.textMax).refine((t) => t.trim().split(/\s+/).length <= GOOGLE_ADS_LIMITS.keyword.wordsMax, "keyword exceeds 10 words");
-var budgetCreateSchema = z12.object({
-  name: z12.string().min(1).max(GOOGLE_ADS_LIMITS.budget.nameMax),
-  amountMicros: microsSchema,
-  deliveryMethod: z12.enum(BUDGET_DELIVERY_METHODS).default("STANDARD"),
-  explicitlyShared: z12.boolean().default(false)
-});
-var budgetUpdateSchema = z12.object({
-  name: z12.string().min(1).max(GOOGLE_ADS_LIMITS.budget.nameMax).optional(),
-  amountMicros: microsSchema.optional(),
-  deliveryMethod: z12.enum(BUDGET_DELIVERY_METHODS).optional()
-}).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
-var biddingConfigSchema = z12.object({
-  type: z12.enum(BIDDING_STRATEGY_TYPES),
-  targetCpaMicros: microsSchema.optional(),
-  targetRoas: z12.number().positive().optional(),
-  cpcBidCeilingMicros: microsSchema.optional(),
-  enhancedCpcEnabled: z12.boolean().optional()
-}).superRefine((p, ctx) => {
-  if (p.type === "TARGET_CPA" && p.targetCpaMicros === void 0) {
-    ctx.addIssue({ code: "custom", path: ["targetCpaMicros"], message: "TARGET_CPA needs targetCpaMicros" });
-  }
-  if (p.type === "TARGET_ROAS" && p.targetRoas === void 0) {
-    ctx.addIssue({ code: "custom", path: ["targetRoas"], message: "TARGET_ROAS needs targetRoas" });
-  }
-});
-var networkSettingsSchema = z12.object({
-  targetGoogleSearch: z12.boolean().optional(),
-  targetSearchNetwork: z12.boolean().optional(),
-  targetContentNetwork: z12.boolean().optional(),
-  targetPartnerSearchNetwork: z12.boolean().optional()
-});
-var dateSchema = z12.string().regex(/^\d{4}-\d{2}-\d{2}$/, "expected a YYYY-MM-DD date");
-var campaignCreateSchema2 = z12.object({
-  name: z12.string().min(1).max(GOOGLE_ADS_LIMITS.campaign.nameMax),
-  channelType: z12.enum(ADVERTISING_CHANNEL_TYPES),
-  channelSubType: z12.enum(ADVERTISING_CHANNEL_SUB_TYPES).optional(),
-  budget: refSchema,
-  /** Inline standard bidding, or a portfolio strategy ref via biddingStrategy. */
-  bidding: biddingConfigSchema.optional(),
-  biddingStrategy: refSchema.optional(),
-  networkSettings: networkSettingsSchema.optional(),
-  startDate: dateSchema.optional(),
-  endDate: dateSchema.optional(),
-  /** Advisory Google Ads UI objective — drives warnings, not sent to the API. */
-  objective: z12.enum(CAMPAIGN_OBJECTIVES).optional(),
-  status: stageableStatusSchema2.default("PAUSED")
-}).superRefine((p, ctx) => {
-  if (!p.bidding && !p.biddingStrategy) {
-    ctx.addIssue({
-      code: "custom",
-      path: ["bidding"],
-      message: "set an inline bidding strategy or reference a portfolio biddingStrategy"
-    });
-  }
-  if (p.bidding && p.biddingStrategy) {
-    ctx.addIssue({
-      code: "custom",
-      path: ["bidding"],
-      message: "use inline bidding OR a portfolio biddingStrategy, not both"
-    });
-  }
-  if (p.channelType === "PERFORMANCE_MAX" && p.bidding && p.bidding.type === "MANUAL_CPC") {
-    ctx.addIssue({ code: "custom", path: ["bidding"], message: "Performance Max does not support Manual CPC" });
-  }
-  if (p.startDate && p.endDate && p.endDate <= p.startDate) {
-    ctx.addIssue({ code: "custom", path: ["endDate"], message: "endDate must be after startDate" });
+  if (p.channelType === "PERFORMANCE_MAX" && p.bidding && p.bidding.type === "MANUAL_CPC") {
+    ctx.addIssue({ code: "custom", path: ["bidding"], message: "Performance Max does not support Manual CPC" });
+  }
+  if (p.startDate && p.endDate && p.endDate <= p.startDate) {
+    ctx.addIssue({ code: "custom", path: ["endDate"], message: "endDate must be after startDate" });
   }
 });
 var campaignUpdateSchema2 = z12.object({
@@ -5432,250 +4687,1028 @@ var campaignCriterionAddSchema = z12.object({
       path: ["criterion", "endMinute"]
     });
   }
-});
-var GOOGLE_DRAFT_OP_KINDS = [
-  "google.budget.create",
-  "google.budget.update",
-  "google.campaign.create",
-  "google.campaign.update",
-  "google.campaign.pause",
-  "google.campaign.resume",
-  "google.campaign.remove",
-  "google.adGroup.create",
-  "google.adGroup.update",
-  "google.adGroup.pause",
-  "google.adGroup.resume",
-  "google.adGroup.remove",
-  "google.keyword.add",
-  "google.keyword.update",
-  "google.keyword.remove",
-  "google.negativeKeyword.add",
-  "google.negativeKeyword.remove",
-  "google.sharedSet.create",
-  "google.sharedSetMember.add",
-  "google.sharedSetMember.remove",
-  "google.campaignSharedSet.attach",
-  "google.campaignSharedSet.detach",
-  "google.ad.create",
-  "google.ad.update",
-  "google.ad.pause",
-  "google.ad.resume",
-  "google.ad.remove",
-  "google.asset.create",
-  "google.asset.update",
-  "google.assetLink.attach",
-  "google.assetLink.detach",
-  "google.assetGroup.create",
-  "google.assetGroup.update",
-  "google.audience.create",
-  "google.audienceCriterion.attach",
-  "google.audienceCriterion.detach",
-  "google.conversionAction.create",
-  "google.conversionAction.update",
-  "google.biddingStrategy.create",
-  "google.biddingStrategy.update",
-  "google.label.create",
-  "google.label.attach",
-  "google.campaignCriterion.add",
-  "google.campaignCriterion.remove"
+});
+var GOOGLE_DRAFT_OP_KINDS = [
+  "google.budget.create",
+  "google.budget.update",
+  "google.campaign.create",
+  "google.campaign.update",
+  "google.campaign.pause",
+  "google.campaign.resume",
+  "google.campaign.remove",
+  "google.adGroup.create",
+  "google.adGroup.update",
+  "google.adGroup.pause",
+  "google.adGroup.resume",
+  "google.adGroup.remove",
+  "google.keyword.add",
+  "google.keyword.update",
+  "google.keyword.remove",
+  "google.negativeKeyword.add",
+  "google.negativeKeyword.remove",
+  "google.sharedSet.create",
+  "google.sharedSetMember.add",
+  "google.sharedSetMember.remove",
+  "google.campaignSharedSet.attach",
+  "google.campaignSharedSet.detach",
+  "google.ad.create",
+  "google.ad.update",
+  "google.ad.pause",
+  "google.ad.resume",
+  "google.ad.remove",
+  "google.asset.create",
+  "google.asset.update",
+  "google.assetLink.attach",
+  "google.assetLink.detach",
+  "google.assetGroup.create",
+  "google.assetGroup.update",
+  "google.audience.create",
+  "google.audienceCriterion.attach",
+  "google.audienceCriterion.detach",
+  "google.conversionAction.create",
+  "google.conversionAction.update",
+  "google.biddingStrategy.create",
+  "google.biddingStrategy.update",
+  "google.label.create",
+  "google.label.attach",
+  "google.campaignCriterion.add",
+  "google.campaignCriterion.remove"
+];
+var googleDraftOpKindSchema = z12.enum(GOOGLE_DRAFT_OP_KINDS);
+function createOp2(kind, payload) {
+  return z12.object({ kind: z12.literal(kind), customerId: customerIdSchema, payload });
+}
+function updateOp2(kind, payload) {
+  return z12.object({ kind: z12.literal(kind), customerId: customerIdSchema, target: targetRefSchema, payload });
+}
+function targetOp(kind) {
+  return z12.object({ kind: z12.literal(kind), customerId: customerIdSchema, target: targetRefSchema });
+}
+var googleDraftOpInputSchema = z12.discriminatedUnion("kind", [
+  createOp2("google.budget.create", budgetCreateSchema),
+  updateOp2("google.budget.update", budgetUpdateSchema),
+  createOp2("google.campaign.create", campaignCreateSchema2),
+  updateOp2("google.campaign.update", campaignUpdateSchema2),
+  targetOp("google.campaign.pause"),
+  targetOp("google.campaign.resume"),
+  targetOp("google.campaign.remove"),
+  createOp2("google.adGroup.create", adGroupCreateSchema),
+  updateOp2("google.adGroup.update", adGroupUpdateSchema),
+  targetOp("google.adGroup.pause"),
+  targetOp("google.adGroup.resume"),
+  targetOp("google.adGroup.remove"),
+  createOp2("google.keyword.add", keywordAddSchema),
+  updateOp2("google.keyword.update", keywordUpdateSchema),
+  targetOp("google.keyword.remove"),
+  createOp2("google.negativeKeyword.add", negativeKeywordAddSchema),
+  targetOp("google.negativeKeyword.remove"),
+  createOp2("google.sharedSet.create", sharedSetCreateSchema),
+  createOp2("google.sharedSetMember.add", sharedSetMemberAddSchema),
+  targetOp("google.sharedSetMember.remove"),
+  createOp2("google.campaignSharedSet.attach", campaignSharedSetAttachSchema),
+  targetOp("google.campaignSharedSet.detach"),
+  createOp2("google.ad.create", adCreateSchema),
+  updateOp2("google.ad.update", adUpdateSchema),
+  targetOp("google.ad.pause"),
+  targetOp("google.ad.resume"),
+  targetOp("google.ad.remove"),
+  createOp2("google.asset.create", assetCreateSchema),
+  updateOp2("google.asset.update", assetUpdateSchema),
+  createOp2("google.assetLink.attach", assetLinkAttachSchema),
+  targetOp("google.assetLink.detach"),
+  createOp2("google.assetGroup.create", assetGroupCreateSchema),
+  updateOp2("google.assetGroup.update", assetGroupUpdateSchema),
+  createOp2("google.audience.create", audienceCreateSchema2),
+  createOp2("google.audienceCriterion.attach", audienceCriterionAttachSchema),
+  targetOp("google.audienceCriterion.detach"),
+  createOp2("google.conversionAction.create", conversionActionCreateSchema),
+  updateOp2("google.conversionAction.update", conversionActionUpdateSchema),
+  createOp2("google.biddingStrategy.create", biddingStrategyCreateSchema),
+  updateOp2("google.biddingStrategy.update", biddingStrategyUpdateSchema),
+  createOp2("google.label.create", labelCreateSchema),
+  createOp2("google.label.attach", labelAttachSchema),
+  createOp2("google.campaignCriterion.add", campaignCriterionAddSchema),
+  targetOp("google.campaignCriterion.remove")
+]);
+
+// ../api/src/ads-google/wire.ts
+import { z as z13 } from "zod";
+var googleWriteModeSchema = z13.enum(["live", "simulated"]);
+var googleDraftOpResultSchema = z13.object({
+  status: z13.enum(["applied", "simulated", "failed", "skipped"]),
+  resourceName: z13.string().optional(),
+  error: z13.string().optional(),
+  skippedBecause: z13.string().optional(),
+  executedAt: z13.number().optional()
+});
+var googleDraftStageRequestSchema = z13.object({
+  chatId: z13.string(),
+  op: googleDraftOpInputSchema
+});
+var googleDraftStageResponseSchema = z13.discriminatedUnion("staged", [
+  z13.object({
+    staged: z13.literal(true),
+    ref: z13.string(),
+    kind: googleDraftOpKindSchema,
+    mode: googleWriteModeSchema,
+    dependsOn: z13.array(z13.string()),
+    summary: z13.string(),
+    warnings: z13.array(z13.string()),
+    /** True when the op amended an already-staged op in place instead of appending a new one. */
+    amended: z13.boolean().optional()
+  }),
+  z13.object({
+    staged: z13.literal(false),
+    noop: z13.literal(true),
+    kind: googleDraftOpKindSchema,
+    mode: googleWriteModeSchema,
+    summary: z13.string(),
+    reason: z13.string()
+  })
+]);
+var googleDraftAmendRequestSchema = z13.object({
+  chatId: z13.string(),
+  ref: z13.string(),
+  patch: z13.record(z13.string(), z13.unknown())
+});
+var googleDraftShowRequestSchema = z13.object({
+  chatId: z13.string(),
+  ref: z13.string()
+});
+var GOOGLE_DRAFT_BATCH_MAX = 500;
+var googleDraftStageBatchRequestSchema = z13.object({
+  chatId: z13.string(),
+  ops: z13.array(googleDraftOpInputSchema).min(1).max(GOOGLE_DRAFT_BATCH_MAX)
+});
+var googleDraftStageBatchResponseSchema = z13.object({
+  staged: z13.literal(true),
+  mode: googleWriteModeSchema,
+  count: z13.number(),
+  ops: z13.array(
+    z13.object({
+      ref: z13.string(),
+      kind: googleDraftOpKindSchema,
+      dependsOn: z13.array(z13.string()),
+      summary: z13.string(),
+      warnings: z13.array(z13.string())
+    })
+  ),
+  skipped: z13.array(z13.object({ kind: googleDraftOpKindSchema, summary: z13.string(), reason: z13.string() })).optional()
+});
+var googleDraftOpViewSchema = z13.object({
+  ref: z13.string(),
+  kind: googleDraftOpKindSchema,
+  customerId: z13.string(),
+  target: z13.string().optional(),
+  dependsOn: z13.array(z13.string()),
+  summary: z13.string(),
+  stagedAt: z13.number(),
+  result: googleDraftOpResultSchema.optional()
+});
+var googleDraftShowResponseSchema = z13.object({
+  op: googleDraftOpViewSchema.extend({
+    payload: z13.unknown().optional(),
+    warnings: z13.array(z13.string()).optional(),
+    annotations: z13.unknown().optional()
+  })
+});
+var googleDraftListRequestSchema = z13.object({
+  chatId: z13.string()
+});
+var googleDraftAdvisorySchema = z13.object({
+  scope: z13.enum(["campaign", "adGroup"]),
+  message: z13.string()
+});
+var googleDraftStatusCollectionSchema = z13.object({
+  label: z13.string(),
+  added: z13.number(),
+  removed: z13.number(),
+  existing: z13.number()
+});
+var googleDraftChangeOperationSchema = z13.enum(["create", "update", "pause", "resume", "remove"]);
+var googleDraftStatusNodeSchema = z13.lazy(
+  () => z13.object({
+    entity: z13.string(),
+    name: z13.string(),
+    operation: googleDraftChangeOperationSchema.optional(),
+    existing: z13.boolean(),
+    collections: z13.array(googleDraftStatusCollectionSchema),
+    children: z13.array(googleDraftStatusNodeSchema),
+    warnings: z13.array(z13.string()).optional()
+  })
+);
+var googleDraftListResponseSchema = z13.object({
+  status: z13.enum(["active", "publishing", "applied", "discarded", "none"]),
+  mode: googleWriteModeSchema,
+  count: z13.number(),
+  ops: z13.array(googleDraftOpViewSchema),
+  /** Grouped campaign ▸ ad group ▸ ad tree for the readable CLI status view. */
+  tree: z13.array(googleDraftStatusNodeSchema).optional(),
+  /** Non-blocking completeness advisories for the whole draft. */
+  advisories: z13.array(googleDraftAdvisorySchema).optional()
+});
+var googleDraftRemoveRequestSchema = z13.object({
+  chatId: z13.string(),
+  ref: z13.string()
+});
+var googleDraftRemoveResponseSchema = z13.object({
+  /** The requested ref plus any dependents removed by cascade. */
+  removed: z13.array(z13.string())
+});
+var googleDraftClearRequestSchema = z13.object({
+  chatId: z13.string()
+});
+var googleDraftClearResponseSchema = z13.object({
+  cleared: z13.number()
+});
+var googleFieldErrorSchema = z13.object({
+  path: z13.string(),
+  message: z13.string()
+});
+var googleDraftErrorResponseSchema = z13.object({
+  code: z13.string(),
+  error: z13.string(),
+  fields: z13.array(googleFieldErrorSchema).optional()
+});
+
+// src/commands/ads/google/changes-window.ts
+function isChangeScope(value) {
+  return CHANGE_SCOPES.includes(value);
+}
+function resolveChangesWindow(input) {
+  const scope = input.scope ?? "detail";
+  if (!isChangeScope(scope)) {
+    return {
+      ok: false,
+      error: {
+        code: "INVALID_SCOPE",
+        message: `Unknown scope '${scope}'. Use 'detail' (field-level changes, 30 days) or 'summary' (which resources changed, 90 days).`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: "Pass --scope detail or --scope summary."
+        }
+      }
+    };
+  }
+  const days = input.days ?? DEFAULT_CHANGE_DAYS;
+  if (!Number.isInteger(days) || days < 1) {
+    return {
+      ok: false,
+      error: {
+        code: "INVALID_LOOKBACK",
+        message: `--days must be a whole number of days, got '${days}'.`,
+        fix: {
+          action: "retry_with_flag",
+          explanation: `Pass --days as a positive integer, e.g. --days ${DEFAULT_CHANGE_DAYS}.`
+        }
+      }
+    };
+  }
+  if (!isChangeLookbackWithinReach(days, scope)) {
+    return { ok: false, error: lookbackTooLong(scope, days, CHANGE_SCOPE_MAX_DAYS[scope]) };
+  }
+  return { ok: true, scope, days, hints: hintsFor(scope, days) };
+}
+function lookbackTooLong(scope, days, max) {
+  if (scope === "detail" && days <= CHANGE_SCOPE_MAX_DAYS.summary) {
+    return {
+      code: "LOOKBACK_TOO_LONG",
+      message: `Google keeps field-level change detail for ${max} days only; ${days} days is outside that window.`,
+      fix: {
+        action: "narrow_date_range",
+        explanation: `Re-run with --scope summary --days ${days} to reach back ${CHANGE_SCOPE_MAX_DAYS.summary} days. Summary tells you which campaigns, ad groups, ads and criteria changed and when, but not the old and new values \u2014 read the resource itself for current values.`
+      }
+    };
+  }
+  return {
+    code: "LOOKBACK_TOO_LONG",
+    message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days} days is outside that window.`,
+    fix: {
+      action: "use_different_resource",
+      explanation: "Do not abort \u2014 infer the change from performance instead. Query monthly metrics per campaign (SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS) to see which campaigns stopped or started spending. That shows what changed and when, though not who changed it. Older history exists only in the Google Ads web UI, which has no API \u2014 ask the user to check it if the 'who' matters."
+    }
+  };
+}
+function hintsFor(scope, days) {
+  const hints = [];
+  if (scope === "detail") {
+    hints.push(
+      `Detailed history covers the last ${CHANGE_SCOPE_MAX_DAYS.detail} days. For anything older use --scope summary (reaches ${CHANGE_SCOPE_MAX_DAYS.summary} days, reports which resources changed but not their values).`
+    );
+  } else {
+    hints.push(
+      "Summary history reports which resources changed and when, not old and new values. To see what a changed resource looks like now, query it by resource_name."
+    );
+    if (days > CHANGE_SCOPE_MAX_DAYS.detail) {
+      hints.push(
+        `Changes inside the last ${CHANGE_SCOPE_MAX_DAYS.detail} days also have field-level detail \u2014 re-run with --scope detail for those.`
+      );
+    }
+  }
+  return hints;
+}
+
+// src/commands/ads/google/correction-table.ts
+function buildCommand(query, ctx) {
+  return `baker ads google query "${query}" --customer-id ${ctx.customerId}`;
+}
+var CORRECTION_RULES = [
+  // 0. EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE — some resources (e.g. campaign_budget)
+  // require fields filtered in WHERE to also be selected. The error names the exact field,
+  // so add it to SELECT and retry. Kept first: field-specific rules below must not shadow
+  // this with an unrelated rewrite when the named field happens to match their pattern.
+  {
+    matchApiError: /must be present in SELECT clause:\s*'([\w.]+)'/i,
+    fix: (ctx) => {
+      const field = ctx.apiErrorMessage?.match(/must be present in SELECT clause:\s*'([\w.]+)'/i)?.[1];
+      if (!field) {
+        return {
+          action: "add_required_field",
+          explanation: "Add the field named in the error to the SELECT clause and retry"
+        };
+      }
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `${field} is used in WHERE but this resource requires it in SELECT too \u2014 added it`
+      };
+    }
+  },
+  // 1. bare keyword.text → ad_group_criterion.keyword.text (leaves <resource>.keyword.text untouched)
+  {
+    matchQuery: /(?<![\w.])keyword\.text\b/,
+    matchApiError: /keyword\.text/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/(?<![\w.])keyword\.text\b/g, "ad_group_criterion.keyword.text");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use ad_group_criterion.keyword.text \u2014 keywords are accessed through the criterion resource"
+      };
+    }
+  },
+  // 2. bare keyword.match_type → ad_group_criterion.keyword.match_type (leaves <resource>.keyword.match_type untouched)
+  {
+    matchQuery: /(?<![\w.])keyword\.match_type\b/,
+    matchApiError: /keyword\.match_type/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(
+        /(?<![\w.])keyword\.match_type\b/g,
+        "ad_group_criterion.keyword.match_type"
+      );
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use ad_group_criterion.keyword.match_type for keyword match type"
+      };
+    }
+  },
+  // 3. campaign_budget.* queried FROM campaign
+  {
+    matchQuery: /campaign_budget\.\w+.*FROM\s+campaign\b/i,
+    matchApiError: /campaign_budget.*not.*valid.*campaign|cannot.*select.*campaign_budget/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/FROM\s+campaign\b/i, "FROM campaign_budget");
+      return {
+        action: "use_different_resource",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "campaign_budget fields must be queried FROM campaign_budget, not FROM campaign"
+      };
+    }
+  },
+  // 4. CONTAINS → LIKE
+  {
+    matchQuery: /CONTAINS\s*\(/i,
+    matchApiError: /CONTAINS.*not.*supported|invalid.*operator.*CONTAINS/i,
+    fix: (ctx) => {
+      const match = ctx.originalQuery.match(/CONTAINS\s*\(\s*([^,]+),\s*'([^']+)'\s*\)/i);
+      if (match) {
+        const field = match[1]?.trim();
+        const value = match[2] ?? "";
+        const corrected = ctx.originalQuery.replace(
+          /CONTAINS\s*\(\s*[^,]+,\s*'[^']+'\s*\)/i,
+          `${field} LIKE '%${value}%'`
+        );
+        return {
+          action: "change_operator",
+          correctedCommand: buildCommand(corrected, ctx),
+          explanation: "GAQL uses LIKE '%value%' for substring matching, not CONTAINS()"
+        };
+      }
+      return {
+        action: "change_operator",
+        explanation: "Replace CONTAINS(field, 'value') with field LIKE '%value%'"
+      };
+    }
+  },
+  // 5. ad_group_criterion query without negative filter — auto-add the field
+  {
+    matchQuery: /FROM\s+ad_group_criterion\b(?!.*ad_group_criterion\.negative)/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT ad_group_criterion.negative, ");
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Added ad_group_criterion.negative to distinguish positive (targeting) from negative (blocking) keywords. Filter with WHERE ad_group_criterion.negative = FALSE for positives only."
+      };
+    }
+  },
+  // 6. Missing campaign.id in ad_group queries
+  {
+    matchQuery: /FROM\s+ad_group\b/i,
+    matchApiError: /campaign\.id.*required|must.*include.*campaign\.id/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Ad group queries require campaign.id in SELECT for parent context"
+      };
+    }
+  },
+  // 6. Missing campaign.id in keyword_view queries
+  {
+    matchQuery: /FROM\s+keyword_view\b/i,
+    matchApiError: /campaign\.id.*required.*keyword/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, "SELECT campaign.id, ");
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Keyword view queries require campaign.id in SELECT"
+      };
+    }
+  },
+  // 7. shopping_performance_view.product_* → segments.product_*
+  {
+    matchQuery: /shopping_performance_view\.product_\w+/,
+    matchApiError: /shopping_performance_view\.product/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/shopping_performance_view\.product_(\w+)/g, "segments.product_$1");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Product fields are segments (segments.product_*), not fields on shopping_performance_view"
+      };
+    }
+  },
+  // 8. Open-ended date range
+  {
+    matchQuery: /segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i,
+    matchApiError: /date.*range.*must.*finite|open.*ended/i,
+    fix: (ctx) => {
+      const match = ctx.originalQuery.match(/segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i);
+      const startDate = match?.[1] ?? "2024-01-01";
+      const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const corrected = ctx.originalQuery.replace(
+        /segments\.date\s*>=\s*'(\d{4}-\d{2}-\d{2})'/i,
+        `segments.date BETWEEN '${startDate}' AND '${today}'`
+      );
+      return {
+        action: "narrow_date_range",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use BETWEEN with explicit end date \u2014 open-ended ranges are not supported"
+      };
+    }
+  },
+  // 9. Missing LIMIT
+  {
+    matchQuery: /^(?!.*\bLIMIT\b)/is,
+    fix: (ctx) => {
+      const corrected = `${ctx.originalQuery.trimEnd()} LIMIT 200`;
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Added LIMIT 200 to prevent excessive data transfer"
+      };
+    }
+  },
+  // 10a. Customer not found (wrong customer ID)
+  {
+    matchApiError: /CUSTOMER_NOT_FOUND|not.*found.*customer/i,
+    fix: () => ({
+      action: "reject",
+      explanation: "Customer ID not found. Run 'baker ads google accounts' to list valid customer IDs, then retry with a valid --customer-id."
+    })
+  },
+  // 10b. Not accessible / login-customer-id required
+  {
+    matchApiError: /not.*accessible|login.customer.id/i,
+    fix: (ctx) => ({
+      action: "reject",
+      correctedCommand: buildCommand(ctx.originalQuery, ctx),
+      explanation: "Account not accessible \u2014 may need a manager (MCC) login-customer-id. Run 'baker ads google accounts' to refresh the accounts cache, then retry."
+    })
+  },
+  // 11. Campaign type by name matching
+  {
+    matchQuery: /campaign\.name\s*LIKE\s*'%\s*(shopping|pmax|search|display|video)\s*%'/i,
+    fix: (ctx) => {
+      const match = ctx.originalQuery.match(/campaign\.name\s*LIKE\s*'%\s*(shopping|pmax|search|display|video)\s*%'/i);
+      const typeMap = {
+        shopping: "SHOPPING",
+        pmax: "PERFORMANCE_MAX",
+        search: "SEARCH",
+        display: "DISPLAY",
+        video: "VIDEO"
+      };
+      const channelType = typeMap[match?.[1]?.toLowerCase() ?? ""] ?? "SEARCH";
+      const corrected = ctx.originalQuery.replace(
+        /campaign\.name\s*LIKE\s*'%[^']*%'/i,
+        `campaign.advertising_channel_type = '${channelType}'`
+      );
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Filter by campaign.advertising_channel_type enum, not by name pattern"
+      };
+    }
+  },
+  // 12. Incompatible fields
+  {
+    matchApiError: /incompatible|mutually.*exclusive|cannot.*select.*together/i,
+    fix: () => ({
+      action: "split_query",
+      explanation: "These fields cannot be in the same query \u2014 split into separate queries and join client-side"
+    })
+  },
+  // 13. campaign.status = 'ACTIVE' → 'ENABLED'
+  {
+    matchQuery: /campaign\.status\s*=\s*'ACTIVE'/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/campaign\.status\s*=\s*'ACTIVE'/gi, "campaign.status = 'ENABLED'");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Campaign status uses ENABLED, not ACTIVE"
+      };
+    }
+  },
+  // 14. ad_group.status = 'ACTIVE' → 'ENABLED'
+  {
+    matchQuery: /ad_group\.status\s*=\s*'ACTIVE'/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/ad_group\.status\s*=\s*'ACTIVE'/gi, "ad_group.status = 'ENABLED'");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Ad group status uses ENABLED, not ACTIVE"
+      };
+    }
+  },
+  // 15. ad.final_urls → ad_group_ad.ad.final_urls
+  {
+    matchQuery: /\bad\.final_urls\b(?!.*ad_group_ad)/,
+    matchApiError: /ad\.final_urls/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/\bad\.final_urls\b/g, "ad_group_ad.ad.final_urls");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Use the full path: ad_group_ad.ad.final_urls"
+      };
+    }
+  },
+  // 15b. asset.<type>_asset.final_urls → asset.final_urls (final URLs live on the asset
+  // itself; the typed sub-message only carries type-specific fields like link_text)
+  {
+    matchQuery: /asset\.\w+_asset\.final_(mobile_)?urls\b/,
+    matchApiError: /asset\.\w+_asset\.final_(mobile_)?urls/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/asset\.\w+_asset\.final_(mobile_)?urls\b/g, "asset.final_$1urls");
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "Final URLs are on the asset itself \u2014 use asset.final_urls, not asset.<type>_asset.final_urls"
+      };
+    }
+  },
+  // 16. Rate limit / quota
+  {
+    matchApiError: /RESOURCE_EXHAUSTED|quota.*exceeded|rate.*limit/i,
+    fix: () => ({
+      action: "wait_and_retry",
+      explanation: "API quota exceeded \u2014 wait 30 seconds before retrying"
+    })
+  },
+  // 17. WHERE on metrics
+  {
+    matchApiError: /cannot.*filter.*metric|WHERE.*metrics|prohibited.*where/i,
+    fix: () => ({
+      action: "reject",
+      explanation: "Cannot filter on metrics in WHERE clause \u2014 remove the metrics filter and filter results client-side"
+    })
+  },
+  // 18. ORDER BY field not in SELECT
+  {
+    matchApiError: /order.*by.*field.*not.*selected|must.*select.*field.*order/i,
+    fix: (ctx) => {
+      const orderMatch = ctx.originalQuery.match(/ORDER\s+BY\s+([\w.]+)/i);
+      const field = orderMatch?.[1] ?? "field";
+      const corrected = ctx.originalQuery.replace(/SELECT\s+/i, `SELECT ${field}, `);
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `Add ${field} to SELECT \u2014 ORDER BY fields must be selected`
+      };
+    }
+  },
+  // The change-history rules must stay ahead of rule 19: its `status.*filter`
+  // pattern also matches Google's change_status errors ("the change_status request
+  // is missing filters on ..."), and the first matching rule wins.
+  // 18a. change_event past its 30-day reach → change_status, which reaches 90 days.
+  // These three rules match on the error code only, never on the resource in the query.
+  // A `matchQuery` here would also fire in the query-pattern pass — the fallback used
+  // when no rule recognised the error — and answer every unrelated failure on a history
+  // query with "switch resources", which is never the real fix. The backend forwards the
+  // code as JSON (`"changeEventError":"START_DATE_TOO_OLD"`), so match that shape as well
+  // as the dotted enum spelling.
+  {
+    matchApiError: /changeEventError\W{0,4}START_DATE_TOO_OLD/i,
+    fix: (ctx) => {
+      const limit = ctx.originalQuery.match(/LIMIT\s+(\d+)/i)?.[1] ?? "50";
+      const requested = ctx.originalQuery.match(/change_date_time\s*>=\s*'([^']+)'/i)?.[1]?.slice(0, 10);
+      const oldestStart = new Date(Date.now() - 89 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+      const start = requested && requested > oldestStart ? requested : oldestStart;
+      const corrected = `SELECT change_status.last_change_date_time, change_status.resource_type, change_status.resource_status, change_status.resource_name, change_status.campaign, change_status.ad_group FROM change_status WHERE change_status.last_change_date_time >= '${start}' ORDER BY change_status.last_change_date_time DESC LIMIT ${limit}`;
+      return {
+        action: "use_different_resource",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `change_event only reaches back 30 days. change_status reaches 90 (from ${start}) but reports only which resources changed and whether they were added, changed or removed \u2014 no old/new values and no user email. Read a changed resource by its resource_name to see its current values.`
+      };
+    }
+  },
+  // 18b. Past 90 days no history resource reaches — infer the change from spend instead.
+  {
+    matchApiError: /changeStatusError\W{0,4}START_DATE_TOO_OLD/i,
+    fix: () => ({
+      action: "use_different_resource",
+      explanation: "Google's account history reaches back 90 days at most, and this query asks for more. Do not abort \u2014 infer the change from performance: SELECT campaign.name, segments.month, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_12_MONTHS shows which campaigns started or stopped spending and when, though not who changed them. Anything older with attribution exists only in the Google Ads web UI, which has no API."
+    })
+  },
+  // 18c. change_status rejects a date range it cannot bound. Google raises this both for
+  // a half-open range and for no date filter at all, so supply whichever end is missing.
+  {
+    matchApiError: /CHANGE_DATE_RANGE_INFINITE/i,
+    fix: (ctx) => {
+      const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const oldestStart = new Date(Date.now() - 89 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+      const hasLowerBound = /last_change_date_time\s*>=?/i.test(ctx.originalQuery);
+      const hasUpperBound = /last_change_date_time\s*<=?/i.test(ctx.originalQuery);
+      const bounds = [
+        ...hasLowerBound ? [] : [`change_status.last_change_date_time >= '${oldestStart}'`],
+        ...hasUpperBound ? [] : [`change_status.last_change_date_time <= '${today}'`]
+      ];
+      const hasWhere = /\bWHERE\b/i.test(ctx.originalQuery);
+      const clause = hasWhere ? ` AND ${bounds.join(" AND ")}` : ` WHERE ${bounds.join(" AND ")}`;
+      const corrected = /\s+(ORDER\s+BY|LIMIT)\b/i.test(ctx.originalQuery) ? ctx.originalQuery.replace(/(\s+)(ORDER\s+BY|LIMIT)\b/i, `${clause}$1$2`) : ctx.originalQuery.trimEnd() + clause;
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "change_status needs a date range bounded at both ends \u2014 added the missing bound(s) on last_change_date_time."
+      };
+    }
+  },
+  // 19. Results include REMOVED entities
+  {
+    matchApiError: /REMOVED.*entities|status.*filter/i,
+    fix: (ctx) => {
+      const resourceMatch = ctx.originalQuery.match(/FROM\s+(\w+)/i);
+      const resource = resourceMatch?.[1] ?? "campaign";
+      const hasWhere = /WHERE/i.test(ctx.originalQuery);
+      const suffix = hasWhere ? ` AND ${resource}.status != 'REMOVED'` : ` WHERE ${resource}.status != 'REMOVED'`;
+      const limitMatch = ctx.originalQuery.match(/(\s+LIMIT\s+\d+)/i);
+      let corrected;
+      if (limitMatch) {
+        corrected = ctx.originalQuery.replace(/(\s+LIMIT\s+\d+)/i, `${suffix}$1`);
+      } else {
+        corrected = ctx.originalQuery.trimEnd() + suffix;
+      }
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `Add status filter to exclude REMOVED ${resource}s`
+      };
+    }
+  },
+  // 20. change_event without date constraint
+  {
+    matchQuery: /FROM\s+change_event\b(?!.*change_date_time)/i,
+    matchApiError: /change_event.*date|date.*required.*change/i,
+    fix: (ctx) => {
+      const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1e3).toISOString().slice(0, 10);
+      const hasWhere = /WHERE/i.test(ctx.originalQuery);
+      const suffix = hasWhere ? ` AND change_event.change_date_time >= '${sevenDaysAgo}'` : ` WHERE change_event.change_date_time >= '${sevenDaysAgo}'`;
+      const corrected = ctx.originalQuery.trimEnd() + suffix;
+      return {
+        action: "add_required_field",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "change_event queries require a date constraint on change_date_time"
+      };
+    }
+  },
+  // 21. resource_name = 'customers/X/Y/Z' → resource.id = Z
+  {
+    matchQuery: /(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i,
+    fix: (ctx) => {
+      const match = ctx.originalQuery.match(/(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i);
+      const resource = match?.[1] ?? "campaign";
+      const id = match?.[2] ?? "ID";
+      const corrected = ctx.originalQuery.replace(
+        /(\w+)\.resource_name\s*=\s*'customers\/\d+\/\w+\/(\d+)'/i,
+        `${resource}.id = ${id}`
+      );
+      return {
+        action: "retry_with_modified_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: `Simpler: use ${resource}.id = ${id} instead of resource_name path`
+      };
+    }
+  },
+  // 22. segments.click_type incompatibility
+  {
+    matchApiError: /click_type.*incompatible|cannot.*click_type/i,
+    fix: (ctx) => {
+      const corrected = ctx.originalQuery.replace(/,?\s*segments\.click_type/g, "");
+      return {
+        action: "split_query",
+        correctedCommand: buildCommand(corrected, ctx),
+        explanation: "segments.click_type is incompatible with other segments \u2014 remove it or query separately"
+      };
+    }
+  },
+  // 23. Bare resource in SELECT
+  {
+    matchApiError: /cannot.*select.*bare.*resource|invalid.*field/i,
+    fix: () => ({
+      action: "retry_with_modified_query",
+      explanation: "Cannot SELECT a bare resource name \u2014 use resource.id, resource.name, or resource.resource_name"
+    })
+  },
+  // 24. Authentication error
+  {
+    matchApiError: /unauthenticated|authentication.*required|invalid.*credentials/i,
+    fix: () => ({
+      action: "authenticate",
+      explanation: "Google Ads authentication failed \u2014 reconnect Google Ads in dashboard settings"
+    })
+  },
+  // 25. Timeout / deadline exceeded
+  {
+    matchApiError: /timeout|deadline.*exceeded|DEADLINE_EXCEEDED/i,
+    fix: (ctx) => ({
+      action: "retry_with_modified_query",
+      correctedCommand: buildCommand(ctx.originalQuery, ctx),
+      explanation: "Query timed out \u2014 narrow the date range, add more WHERE filters, or reduce LIMIT"
+    })
+  }
 ];
-var googleDraftOpKindSchema = z12.enum(GOOGLE_DRAFT_OP_KINDS);
-function createOp2(kind, payload) {
-  return z12.object({ kind: z12.literal(kind), customerId: customerIdSchema, payload });
-}
-function updateOp2(kind, payload) {
-  return z12.object({ kind: z12.literal(kind), customerId: customerIdSchema, target: targetRefSchema, payload });
-}
-function targetOp(kind) {
-  return z12.object({ kind: z12.literal(kind), customerId: customerIdSchema, target: targetRefSchema });
-}
-var googleDraftOpInputSchema = z12.discriminatedUnion("kind", [
-  createOp2("google.budget.create", budgetCreateSchema),
-  updateOp2("google.budget.update", budgetUpdateSchema),
-  createOp2("google.campaign.create", campaignCreateSchema2),
-  updateOp2("google.campaign.update", campaignUpdateSchema2),
-  targetOp("google.campaign.pause"),
-  targetOp("google.campaign.resume"),
-  targetOp("google.campaign.remove"),
-  createOp2("google.adGroup.create", adGroupCreateSchema),
-  updateOp2("google.adGroup.update", adGroupUpdateSchema),
-  targetOp("google.adGroup.pause"),
-  targetOp("google.adGroup.resume"),
-  targetOp("google.adGroup.remove"),
-  createOp2("google.keyword.add", keywordAddSchema),
-  updateOp2("google.keyword.update", keywordUpdateSchema),
-  targetOp("google.keyword.remove"),
-  createOp2("google.negativeKeyword.add", negativeKeywordAddSchema),
-  targetOp("google.negativeKeyword.remove"),
-  createOp2("google.sharedSet.create", sharedSetCreateSchema),
-  createOp2("google.sharedSetMember.add", sharedSetMemberAddSchema),
-  targetOp("google.sharedSetMember.remove"),
-  createOp2("google.campaignSharedSet.attach", campaignSharedSetAttachSchema),
-  targetOp("google.campaignSharedSet.detach"),
-  createOp2("google.ad.create", adCreateSchema),
-  updateOp2("google.ad.update", adUpdateSchema),
-  targetOp("google.ad.pause"),
-  targetOp("google.ad.resume"),
-  targetOp("google.ad.remove"),
-  createOp2("google.asset.create", assetCreateSchema),
-  updateOp2("google.asset.update", assetUpdateSchema),
-  createOp2("google.assetLink.attach", assetLinkAttachSchema),
-  targetOp("google.assetLink.detach"),
-  createOp2("google.assetGroup.create", assetGroupCreateSchema),
-  updateOp2("google.assetGroup.update", assetGroupUpdateSchema),
-  createOp2("google.audience.create", audienceCreateSchema2),
-  createOp2("google.audienceCriterion.attach", audienceCriterionAttachSchema),
-  targetOp("google.audienceCriterion.detach"),
-  createOp2("google.conversionAction.create", conversionActionCreateSchema),
-  updateOp2("google.conversionAction.update", conversionActionUpdateSchema),
-  createOp2("google.biddingStrategy.create", biddingStrategyCreateSchema),
-  updateOp2("google.biddingStrategy.update", biddingStrategyUpdateSchema),
-  createOp2("google.label.create", labelCreateSchema),
-  createOp2("google.label.attach", labelAttachSchema),
-  createOp2("google.campaignCriterion.add", campaignCriterionAddSchema),
-  targetOp("google.campaignCriterion.remove")
-]);
 
-// ../api/src/ads-google/wire.ts
-import { z as z13 } from "zod";
-var googleWriteModeSchema = z13.enum(["live", "simulated"]);
-var googleDraftOpResultSchema = z13.object({
-  status: z13.enum(["applied", "simulated", "failed", "skipped"]),
-  resourceName: z13.string().optional(),
-  error: z13.string().optional(),
-  skippedBecause: z13.string().optional(),
-  executedAt: z13.number().optional()
-});
-var googleDraftStageRequestSchema = z13.object({
-  chatId: z13.string(),
-  op: googleDraftOpInputSchema
-});
-var googleDraftStageResponseSchema = z13.discriminatedUnion("staged", [
-  z13.object({
-    staged: z13.literal(true),
-    ref: z13.string(),
-    kind: googleDraftOpKindSchema,
-    mode: googleWriteModeSchema,
-    dependsOn: z13.array(z13.string()),
-    summary: z13.string(),
-    warnings: z13.array(z13.string()),
-    /** True when the op amended an already-staged op in place instead of appending a new one. */
-    amended: z13.boolean().optional()
-  }),
-  z13.object({
-    staged: z13.literal(false),
-    noop: z13.literal(true),
-    kind: googleDraftOpKindSchema,
-    mode: googleWriteModeSchema,
-    summary: z13.string(),
-    reason: z13.string()
-  })
-]);
-var googleDraftAmendRequestSchema = z13.object({
-  chatId: z13.string(),
-  ref: z13.string(),
-  patch: z13.record(z13.string(), z13.unknown())
-});
-var googleDraftShowRequestSchema = z13.object({
-  chatId: z13.string(),
-  ref: z13.string()
-});
-var GOOGLE_DRAFT_BATCH_MAX = 500;
-var googleDraftStageBatchRequestSchema = z13.object({
-  chatId: z13.string(),
-  ops: z13.array(googleDraftOpInputSchema).min(1).max(GOOGLE_DRAFT_BATCH_MAX)
-});
-var googleDraftStageBatchResponseSchema = z13.object({
-  staged: z13.literal(true),
-  mode: googleWriteModeSchema,
-  count: z13.number(),
-  ops: z13.array(
-    z13.object({
-      ref: z13.string(),
-      kind: googleDraftOpKindSchema,
-      dependsOn: z13.array(z13.string()),
-      summary: z13.string(),
-      warnings: z13.array(z13.string())
-    })
-  ),
-  skipped: z13.array(z13.object({ kind: googleDraftOpKindSchema, summary: z13.string(), reason: z13.string() })).optional()
-});
-var googleDraftOpViewSchema = z13.object({
-  ref: z13.string(),
-  kind: googleDraftOpKindSchema,
-  customerId: z13.string(),
-  target: z13.string().optional(),
-  dependsOn: z13.array(z13.string()),
-  summary: z13.string(),
-  stagedAt: z13.number(),
-  result: googleDraftOpResultSchema.optional()
-});
-var googleDraftShowResponseSchema = z13.object({
-  op: googleDraftOpViewSchema.extend({
-    payload: z13.unknown().optional(),
-    warnings: z13.array(z13.string()).optional(),
-    annotations: z13.unknown().optional()
-  })
-});
-var googleDraftListRequestSchema = z13.object({
-  chatId: z13.string()
-});
-var googleDraftAdvisorySchema = z13.object({
-  scope: z13.enum(["campaign", "adGroup"]),
-  message: z13.string()
-});
-var googleDraftStatusCollectionSchema = z13.object({
-  label: z13.string(),
-  added: z13.number(),
-  removed: z13.number(),
-  existing: z13.number()
-});
-var googleDraftChangeOperationSchema = z13.enum(["create", "update", "pause", "resume", "remove"]);
-var googleDraftStatusNodeSchema = z13.lazy(
-  () => z13.object({
-    entity: z13.string(),
-    name: z13.string(),
-    operation: googleDraftChangeOperationSchema.optional(),
-    existing: z13.boolean(),
-    collections: z13.array(googleDraftStatusCollectionSchema),
-    children: z13.array(googleDraftStatusNodeSchema),
-    warnings: z13.array(z13.string()).optional()
-  })
-);
-var googleDraftListResponseSchema = z13.object({
-  status: z13.enum(["active", "publishing", "applied", "discarded", "none"]),
-  mode: googleWriteModeSchema,
-  count: z13.number(),
-  ops: z13.array(googleDraftOpViewSchema),
-  /** Grouped campaign ▸ ad group ▸ ad tree for the readable CLI status view. */
-  tree: z13.array(googleDraftStatusNodeSchema).optional(),
-  /** Non-blocking completeness advisories for the whole draft. */
-  advisories: z13.array(googleDraftAdvisorySchema).optional()
-});
-var googleDraftRemoveRequestSchema = z13.object({
-  chatId: z13.string(),
-  ref: z13.string()
-});
-var googleDraftRemoveResponseSchema = z13.object({
-  /** The requested ref plus any dependents removed by cascade. */
-  removed: z13.array(z13.string())
-});
-var googleDraftClearRequestSchema = z13.object({
-  chatId: z13.string()
+// src/commands/ads/google/error-parser.ts
+function mapErrorCode(message) {
+  if (/must be present in SELECT clause/i.test(message)) return "MISSING_SELECT_FIELD";
+  if (/field.*not.*found|unrecognized.*field|not.*valid.*field/i.test(message)) return "FIELD_NOT_FOUND";
+  if (/not.*valid.*resource|cannot.*select.*from/i.test(message)) return "WRONG_RESOURCE";
+  if (/operator|CONTAINS|LIKE/i.test(message)) return "INVALID_OPERATOR";
+  if (/CUSTOMER_NOT_FOUND/i.test(message)) return "CUSTOMER_NOT_FOUND";
+  if (/login.customer.id|not.*accessible/i.test(message)) return "MISSING_MANAGER_ID";
+  if (/incompatible|mutually.*exclusive|PROHIBITED_SEGMENT_WITH_METRIC/i.test(message)) return "INCOMPATIBLE_FIELDS";
+  if (/unauthenticated|authentication/i.test(message)) return "AUTH_ERROR";
+  if (/permission/i.test(message)) return "PERMISSION_DENIED";
+  if (/RESOURCE_EXHAUSTED|quota|rate.*limit/i.test(message)) return "QUOTA_EXCEEDED";
+  if (/timeout|DEADLINE_EXCEEDED/i.test(message)) return "TIMEOUT";
+  return "API_ERROR";
+}
+function isRetryable(code) {
+  return code === "QUOTA_EXCEEDED" || code === "TIMEOUT";
+}
+function getRetryDelay(code) {
+  if (code === "QUOTA_EXCEEDED") return 3e4;
+  if (code === "TIMEOUT") return 5e3;
+  return void 0;
+}
+function parseApiError(errorMessage, originalQuery, customerId) {
+  const ctx = {
+    originalQuery,
+    customerId,
+    apiErrorMessage: errorMessage
+  };
+  for (const rule of CORRECTION_RULES) {
+    if (rule.matchApiError?.test(errorMessage)) {
+      const fix = rule.fix(ctx);
+      const code2 = mapErrorCode(errorMessage);
+      return {
+        ok: false,
+        error: {
+          code: code2,
+          message: errorMessage,
+          fix,
+          retryable: isRetryable(code2),
+          retryAfterMs: getRetryDelay(code2)
+        }
+      };
+    }
+  }
+  for (const rule of CORRECTION_RULES) {
+    if (rule.matchQuery?.test(originalQuery)) {
+      const fix = rule.fix(ctx);
+      const code2 = mapErrorCode(errorMessage);
+      return {
+        ok: false,
+        error: {
+          code: code2,
+          message: errorMessage,
+          fix,
+          retryable: isRetryable(code2),
+          retryAfterMs: getRetryDelay(code2)
+        }
+      };
+    }
+  }
+  const code = mapErrorCode(errorMessage);
+  return {
+    ok: false,
+    error: {
+      code,
+      message: errorMessage,
+      fix: {
+        action: "reject",
+        explanation: "Unrecognized error \u2014 verify query syntax against Google Ads GAQL reference"
+      },
+      retryable: isRetryable(code),
+      retryAfterMs: getRetryDelay(code)
+    }
+  };
+}
+
+// src/commands/ads/google/changes.ts
+registerSchema({
+  command: "ads.google.changes",
+  description: "Read the account's change history. --scope detail (default) shows what changed and to what value, back 30 days; --scope summary shows which resources changed, back 90 days.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    days: {
+      type: "string",
+      description: `Lookback days (default: ${DEFAULT_CHANGE_DAYS}). Max ${CHANGE_SCOPE_MAX_DAYS.detail} with --scope detail, ${CHANGE_SCOPE_MAX_DAYS.summary} with --scope summary. Google keeps nothing older behind any API.`,
+      required: false,
+      default: DEFAULT_CHANGE_DAYS
+    },
+    scope: {
+      type: "string",
+      description: `detail|summary (default: detail). detail = old/new values plus who made the change, ${CHANGE_SCOPE_MAX_DAYS.detail} days. summary = which resources were added, changed or removed, ${CHANGE_SCOPE_MAX_DAYS.summary} days, without values.`,
+      required: false,
+      default: "detail"
+    },
+    "resource-type": {
+      type: "string",
+      description: "Filter by type: CAMPAIGN, CAMPAIGN_CRITERION, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION. CAMPAIGN_CRITERION covers campaign-level negatives, location and audience exclusions.",
+      required: false
+    },
+    limit: { type: "string", description: "Max change events (default: 50, max: 1000)", required: false, default: 50 },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  }
 });
-var googleDraftClearResponseSchema = z13.object({
-  cleared: z13.number()
+var changesCommand = defineCommand20({
+  meta: {
+    name: "changes",
+    description: `Read the change history of a Google Ads account.
+
+Google keeps account history in two layers, and neither reaches past 90 days:
+  --scope detail  (default)  what changed, old \u2192 new value, who changed it   \u2014 last ${CHANGE_SCOPE_MAX_DAYS.detail} days
+  --scope summary            which resources were added, changed or removed  \u2014 last ${CHANGE_SCOPE_MAX_DAYS.summary} days
+
+For anything older, infer it from performance instead \u2014 a monthly spend trend per
+campaign shows what started or stopped, just not who did it.
+
+Examples:
+  baker ads google changes --customer-id 1234567890
+  baker ads google changes --customer-id 1234567890 --days 14 --resource-type CAMPAIGN
+  baker ads google changes --customer-id 1234567890 --days 60 --scope summary`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    days: { type: "string", description: `Lookback days (default ${DEFAULT_CHANGE_DAYS})`, required: false },
+    scope: { type: "string", description: "detail (30 days) or summary (90 days)", required: false },
+    "resource-type": { type: "string", description: "Filter by resource type", required: false },
+    limit: { type: "string", description: "Max results (default 50)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const window = resolveChangesWindow({
+      days: args.days ? Number(args.days) : void 0,
+      scope: args.scope
+    });
+    if (!window.ok) {
+      writeJsonEnvelope({ ok: false, error: { ...window.error, retryable: false } });
+      process.exit(1);
+      return;
+    }
+    const body = {
+      customerId,
+      days: window.days,
+      scope: window.scope,
+      limit: args.limit ? Number(args.limit) : 50
+    };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId) body.managerId = managerId;
+    if (args["resource-type"]) body.resourceType = args["resource-type"];
+    if (args["no-cache"]) body.skipCache = true;
+    try {
+      const data = await apiPost("/api/ads/google/changes", body);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      const first = data[0];
+      const fields = first ? Object.keys(first) : [];
+      const fieldDescs = getFieldDescriptions(fields);
+      writeJsonEnvelope({ ok: true, data, fields: fieldDescs, hints: window.hints });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
 });
-var googleFieldErrorSchema = z13.object({
-  path: z13.string(),
-  message: z13.string()
+
+// src/commands/ads/google/currency.ts
+import { defineCommand as defineCommand21 } from "citty";
+registerSchema({
+  command: "ads.google.currency",
+  description: "Get the currency code for a Google Ads account. Returns currency_code, customer_id, account_name, and access_type. Call this before interpreting cost_micros values.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    }
+  }
 });
-var googleDraftErrorResponseSchema = z13.object({
-  code: z13.string(),
-  error: z13.string(),
-  fields: z13.array(googleFieldErrorSchema).optional()
+var currencyCommand = defineCommand21({
+  meta: {
+    name: "currency",
+    description: `Get account currency code. Use this to interpret metrics.cost_micros values.
+
+Examples:
+  baker ads google currency --customer-id 1234567890`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `currency:${customerId}`;
+    if (useCache) {
+      const cached = cacheGet("accounts", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "customer-id": customerId };
+      const managerId = getManagerIdForCustomer(customerId);
+      if (managerId) params["manager-id"] = managerId;
+      if (!useCache) params["skip-cache"] = "true";
+      const raw = await apiGet("/api/ads/google/currency", params);
+      const data = {
+        currency_code: raw.currencyCode,
+        customer_id: raw.customerId
+      };
+      if (useCache) {
+        cacheSet("accounts", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
 });
 
+// src/commands/ads/google/draft.ts
+import { defineCommand as defineCommand22 } from "citty";
+
+// src/commands/ads/google/write-shared.ts
+import { readFileSync as readFileSync2 } from "fs";
+
 // src/commands/ads/google/draft-status.ts
 var OPERATION_LABELS = {
   create: "Creating",
@@ -27066,6 +27099,53 @@ var BUZZWORDS = [
   "drive results",
   "harness the power"
 ];
+var AUTONOMY_CLAIMS = [
+  "fully autonomous",
+  "completely autonomous",
+  "autonomous agent",
+  "autonomously",
+  "while you sleep",
+  "set it and forget it",
+  "set-it-and-forget-it",
+  "zero human input",
+  "no human intervention",
+  "without human intervention",
+  "hands-free",
+  "hands free",
+  "self-driving",
+  "runs itself",
+  "on autopilot",
+  "end-to-end automation",
+  "no manual work",
+  "eliminates manual",
+  "does the work for you",
+  "thinks for you",
+  "handles everything for you"
+];
+var AI_CONTROL_SIGNALS = [
+  "human in the loop",
+  "human-in-the-loop",
+  "human review",
+  "human oversight",
+  "approve",
+  "approval",
+  "you review",
+  "review before",
+  "review queue",
+  "confirm before",
+  "in control",
+  "you decide",
+  "override",
+  "audit log",
+  "audit trail",
+  "guardrail",
+  "dry run",
+  "rollback",
+  "roll back",
+  "undo",
+  "escalate",
+  "escalation"
+];
 var AI_PURPLE_HEXES = /* @__PURE__ */ new Set([
   "#7c3aed",
   "#8b5cf6",
@@ -27161,6 +27241,11 @@ var RULE_META = {
     severity: "warn",
     note: "SaaS filler ('supercharge your\u2026') is generic. Name names, use numbers, say the specific thing only this product proves."
   },
+  "agent-washing": {
+    family: "copy",
+    severity: "warn",
+    note: "The page claims autonomy but never says what the buyer controls. Name what it does on its own, what waits for approval, and what happens when it's wrong."
+  },
   "aphoristic-cadence": {
     family: "copy",
     severity: "warn",
@@ -27367,6 +27452,9 @@ var LINE_MATCHERS = [
     fmt: (m) => cap2(m, 0).slice(0, 100)
   }
 ];
+function includesPhraseAtWordStart(haystack, phrase) {
+  return new RegExp(`\\b${phrase.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`).test(haystack);
+}
 function stripHtmlToText(html) {
   return html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ").replace(/<!--[\s\S]*?-->/g, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ");
 }
@@ -27486,6 +27574,24 @@ var ANALYZERS = [
       return [{ id: "em-dash-overuse", snippet: `${count} em-dashes in body copy`, file }];
     }
   },
+  // Agent washing: an autonomy claim the page never scaffolds with a signal about
+  // who oversees the agent. Page-scope — the claim and the answer routinely live
+  // in different components, so a per-file check would fire on any hero that
+  // defers the trust story to a section below it.
+  //
+  // Both lists match at a word start (see `includesPhraseAtWordStart`). Matching
+  // bare substrings let "resources" satisfy "sources" and silently clear the
+  // finding, which is the failure mode this rule exists to catch.
+  {
+    scope: "page",
+    run: (text, file) => {
+      const lower = stripHtmlToText(text).toLowerCase();
+      const claim = AUTONOMY_CLAIMS.find((phrase) => includesPhraseAtWordStart(lower, phrase));
+      if (!claim) return [];
+      if (AI_CONTROL_SIGNALS.some((phrase) => includesPhraseAtWordStart(lower, phrase))) return [];
+      return [{ id: "agent-washing", snippet: `"${claim}" with no control or oversight signal on the page`, file }];
+    }
+  },
   // Marketing buzzwords. Fires at ≥1 → per file (keeps the offending file named).
   {
     scope: "file",
@@ -27728,7 +27834,7 @@ function describeCounts(findings) {
 // src/commands/landing/snapshot.ts
 import { mkdir as mkdir8, rename as rename2, writeFile as writeFile11 } from "fs/promises";
 import path25 from "path";
-var CRITIC_VERSION = "1";
+var CRITIC_VERSION = "2";
 function critiqueCacheDir(projectRoot) {
   return path25.join(projectRoot, ".cache", "landing-critique");
 }