@koda-sl/baker-cli 0.448.0-dev.0d67e41b9 → 0.448.0-dev.ccc3c9a37

package/dist/chunk-C6U6UDHJ.js

@@ -1,106 +0,0 @@
-import {
-  cacheGet,
-  cacheSet,
-  handleConnectionError,
-  needsConnectionFix,
-  writeAdsJson
-} from "./chunk-VFIOJD5M.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-XBOK23HI.js";
-import {
-  getEnv
-} from "./chunk-NAWWC5I3.js";
-
-// src/commands/ads/x/output.ts
-var ACCOUNTS_CACHE_TTL_MS = 60 * 60 * 1e3;
-var NO_X_ACCOUNTS_EXPLANATION = "The X Ads connection is live, but X lists no ads accounts for it. That is usually an account X has not activated for advertising yet \u2014 most often one with no billing set up. It does not mean the connection failed, and reconnecting will not change it. An account X omits here still works everywhere else: take its id from the ads.x.com URL (ads.x.com/manager/<id>/\u2026) and pass --account-id <id>, or set BAKER_X_ADS_ACCOUNT_ID.";
-async function fetchXAccounts(useCache) {
-  if (useCache) {
-    const cached = cacheGet("x-accounts", "list");
-    if (cached) return cached.data;
-  }
-  const params = !useCache ? { "skip-cache": "true" } : void 0;
-  const data = await apiGet("/api/ads/x/accounts", params);
-  if (useCache) {
-    cacheSet("x-accounts", "list", data, ACCOUNTS_CACHE_TTL_MS);
-  }
-  return data;
-}
-async function resolveXAccountId(args) {
-  const fromArgs = args["account-id"];
-  const accountId = fromArgs || getEnv().BAKER_X_ADS_ACCOUNT_ID;
-  if (accountId) {
-    if (!/^[a-z0-9]+$/.test(accountId)) {
-      writeAdsJson({
-        ok: false,
-        error: {
-          code: "INVALID_ACCOUNT_ID",
-          message: "X Ads account ID must be a base36 string (lowercase letters and digits). Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID."
-        }
-      });
-      process.exit(1);
-    }
-    return accountId;
-  }
-  const useCache = !args["no-cache"];
-  try {
-    const accounts = await fetchXAccounts(useCache);
-    const [single] = accounts;
-    if (accounts.length === 1 && single) {
-      process.stderr.write(`Using account "${single.name}" (${single.id})
-`);
-      return single.id;
-    }
-    if (accounts.length === 0) {
-      writeAdsJson({
-        ok: false,
-        error: {
-          code: "INVALID_ACCOUNT_ID",
-          message: NO_X_ACCOUNTS_EXPLANATION,
-          fix: { action: "reject", explanation: NO_X_ACCOUNTS_EXPLANATION },
-          retryable: false
-        }
-      });
-      process.exit(1);
-    }
-    const list = accounts.map((a) => `  ${a.id}  ${a.name}`).join("\n");
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "MULTIPLE_ACCOUNTS",
-        message: `Multiple X Ads accounts found. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID:
-${list}`
-      }
-    });
-    process.exit(1);
-  } catch (err) {
-    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
-      handleConnectionError("x_ads", err.message);
-    }
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: "Could not auto-detect account. Pass --account-id or set BAKER_X_ADS_ACCOUNT_ID."
-      }
-    });
-    process.exit(1);
-  }
-}
-async function resolveXAccountTimezone(accountId, args) {
-  try {
-    const accounts = await fetchXAccounts(!args["no-cache"]);
-    return accounts.find((a) => a.id === accountId)?.timezone || "UTC";
-  } catch {
-    return "UTC";
-  }
-}
-
-export {
-  NO_X_ACCOUNTS_EXPLANATION,
-  resolveXAccountId,
-  resolveXAccountTimezone
-};
-//# sourceMappingURL=chunk-C6U6UDHJ.js.map

package/dist/chunk-CFHIW5QZ.js

@@ -1,297 +0,0 @@
-import {
-  REDDIT_LINK_REJECTED,
-  redditSearchHints,
-  redditSubredditsHints,
-  redditThreadHints
-} from "./chunk-NECTN6N7.js";
-import {
-  handleResearchError,
-  writeResearchJson
-} from "./chunk-WNFIJAUO.js";
-import {
-  repeatedValues
-} from "./chunk-ERSX3MKH.js";
-import {
-  RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS
-} from "./chunk-K6WVV74H.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-
-// src/commands/research/reddit.ts
-import { defineCommand } from "citty";
-var TIMEOUT_MS = 18e4;
-var TEXT_PREVIEW_CHARS = 1500;
-var ITEM_FIELDS = {
-  kind: "post or comment",
-  subreddit: "Where it was said",
-  title: "The post's title (on a comment: the post it answers)",
-  text: "Verbatim \u2014 quote this, exactly",
-  text_truncated: "The text was cut; re-run with --full before quoting the end of it",
-  author: "Reddit username, or null once the account is deleted",
-  score: "Points",
-  comment_count: "Posts only",
-  created: "Date written (UTC)",
-  permalink: "Cite THIS link \u2014 it is built from where the words actually are",
-  depth: "Thread comments: 0 answers the post, 1 answers a comment",
-  source: "reddit_api / reddit_web = live Reddit; archive = the Arctic Shift archive of Reddit"
-};
-registerSchema({
-  command: "research.reddit.search",
-  description: "Search Reddit posts or comments for the audience's own words. Returns verbatim text with a real permalink for each hit. Start here for voice-of-customer work on Reddit.",
-  args: {
-    query: {
-      type: "string",
-      description: "Words to match \u2014 the audience's phrasing, not a description of it",
-      required: true
-    },
-    subreddit: {
-      type: "string",
-      description: "Subreddits to search (up to 10): comma-separated (couriersofreddit,AmazonFlexUK) or the flag repeated. Needed for --kind comments",
-      required: false
-    },
-    kind: {
-      type: "string",
-      description: "posts (default) or comments \u2014 the replies are where most of the voice is",
-      required: false,
-      enum: ["posts", "comments"]
-    },
-    since: { type: "string", description: "Only things written on or after this day, YYYY-MM-DD", required: false },
-    limit: { type: "number", description: "Results to return (1-50, default 25)", required: false },
-    full: {
-      type: "boolean",
-      description: "Return every text whole instead of a preview",
-      required: false,
-      default: false
-    }
-  }
-});
-registerSchema({
-  command: "research.reddit.thread",
-  description: "Read one Reddit thread verbatim: the post and its best comments, each with its own permalink. Use it on any Reddit link before quoting it \u2014 it also exposes links that point somewhere other than they claim.",
-  args: {
-    target: {
-      type: "string",
-      description: "The thread's link (any Reddit form, including share links) or post id",
-      required: true
-    },
-    comments: { type: "number", description: "Comments to return, best first (0-200, default 40)", required: false },
-    full: {
-      type: "boolean",
-      description: "Return every text whole instead of a preview",
-      required: false,
-      default: false
-    }
-  }
-});
-registerSchema({
-  command: "research.reddit.subreddits",
-  description: "Find the subreddits where an audience talks about a topic, with member counts and whether they can be read. Run it before searching, instead of guessing subreddit names.",
-  args: {
-    query: { type: "string", description: 'The audience or topic, e.g. "amazon flex uk", "deliveroo"', required: true },
-    limit: { type: "number", description: "Subreddits to return (1-25, default 10)", required: false }
-  }
-});
-function searchReddit(body) {
-  return apiPost("/api/research/reddit/search", body, { timeoutMs: TIMEOUT_MS });
-}
-function findSubreddits(body) {
-  return apiPost("/api/research/reddit/subreddits", body, { timeoutMs: TIMEOUT_MS });
-}
-function row(item, full) {
-  const cut = !full && item.text.length > TEXT_PREVIEW_CHARS;
-  return {
-    kind: item.kind,
-    subreddit: item.subreddit,
-    title: item.title,
-    text: cut ? `${item.text.slice(0, TEXT_PREVIEW_CHARS)}\u2026` : item.text,
-    ...cut ? { text_truncated: true } : {},
-    author: item.author,
-    score: item.score,
-    ...item.kind === "post" ? { comment_count: item.commentCount } : {},
-    created: item.createdAt.slice(0, 10),
-    permalink: item.permalink,
-    ...item.depth !== null ? { depth: item.depth } : {}
-  };
-}
-function redditFix(code) {
-  if (code === "NOT_FOUND") return REDDIT_LINK_REJECTED;
-  if (code === "BAD_REQUEST" || code === "VALIDATION_ERROR") {
-    return { action: "retry_with_changes", explanation: "Follow the message above and run the command again." };
-  }
-  return {
-    action: "continue_without",
-    explanation: "Don't loop on it. Finish the job with the other sources, say plainly that Reddit is a gap in this research, and never stand in a summary's paraphrase for a Reddit quote."
-  };
-}
-function failValidation(message) {
-  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: redditFix("VALIDATION_ERROR") } });
-  process.exit(1);
-}
-function subredditsFromArgs(rawArgs, parsed) {
-  return repeatedValues(rawArgs, "subreddit", parsed).flatMap((value) => value.split(",")).map((name) => name.trim()).filter(Boolean);
-}
-var searchCommand = defineCommand({
-  meta: {
-    name: "search",
-    description: `Search Reddit for the audience's own words, verbatim, each with a permalink you can cite.
-
-Start here for Reddit voice-of-customer. Matches words, not meaning \u2014 search the way the audience writes, and quote a phrase to keep it together ('"right to work"').
-
-Examples:
-  baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK
-  baker research reddit search '"right to work"' --subreddit UKJobs,AmazonFlexUK
-  baker research reddit search "visa" --subreddit UberEATS --kind comments --since 2025-01-01
-  baker research reddit search "side hustle student deliveries"`
-  },
-  args: {
-    query: { type: "positional", description: "Words to match", required: false },
-    subreddit: {
-      type: "string",
-      description: "Subreddits (up to 10): comma-separated, or repeat the flag",
-      required: false
-    },
-    kind: { type: "string", description: "posts (default) or comments", required: false },
-    since: { type: "string", description: "YYYY-MM-DD", required: false },
-    limit: { type: "string", description: "1-50, default 25", required: false },
-    full: { type: "boolean", description: "Whole texts, not previews", required: false }
-  },
-  run: async ({ args, rawArgs }) => {
-    const query = args.query?.trim();
-    if (!query) failValidation('Say what to search for: baker research reddit search "<words>"');
-    const kind = args.kind ?? "posts";
-    if (kind !== "posts" && kind !== "comments") failValidation("--kind must be posts or comments");
-    const body = {
-      query,
-      kind,
-      subreddits: subredditsFromArgs(rawArgs, args.subreddit)
-    };
-    if (args.since) body.since = args.since;
-    if (args.limit) body.limit = Number(args.limit);
-    try {
-      const data = await searchReddit(body);
-      writeResearchJson({
-        ok: true,
-        data: data.results.map((item) => row(item, Boolean(args.full))),
-        source: data.source,
-        fields: ITEM_FIELDS,
-        hints: redditSearchHints({ resultCount: data.results.length, kind, source: data.source })
-      });
-    } catch (err) {
-      handleResearchError(err, redditFix);
-    }
-  }
-});
-var threadCommand = defineCommand({
-  meta: {
-    name: "thread",
-    description: `Read one Reddit thread verbatim \u2014 the post and its best comments, each with its own permalink.
-
-Run it on every Reddit link before you quote from it, including links a research summary gave you: it refuses a link whose post is somewhere other than the link claims.
-
-Examples:
-  baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/agency_still_hasnt_paid_me/"
-  baker research reddit thread "https://www.reddit.com/r/UberEATS/s/3TzXiyxaMD" --comments 100
-  baker research reddit thread 1abc2de --full`
-  },
-  args: {
-    target: { type: "positional", description: "Thread link or post id", required: false },
-    comments: { type: "string", description: "0-200, default 40", required: false },
-    full: { type: "boolean", description: "Whole texts, not previews", required: false }
-  },
-  run: async ({ args }) => {
-    const target = args.target?.trim();
-    if (!target) failValidation("Pass the thread's link or post id: baker research reddit thread <url>");
-    const commentsAsked = args.comments ? Number(args.comments) : RESEARCH_REDDIT_THREAD_DEFAULT_COMMENTS;
-    const body = { target, comments: commentsAsked };
-    try {
-      const data = await apiPost("/api/research/reddit/thread", body, {
-        timeoutMs: TIMEOUT_MS
-      });
-      const full = Boolean(args.full);
-      writeResearchJson({
-        ok: true,
-        data: { post: row(data.post, full), comments: data.comments.map((item) => row(item, full)) },
-        source: data.source,
-        fields: ITEM_FIELDS,
-        hints: redditThreadHints({
-          commentsShown: data.comments.length,
-          commentsAsked,
-          commentCount: data.post.commentCount,
-          source: data.source
-        })
-      });
-    } catch (err) {
-      handleResearchError(err, redditFix);
-    }
-  }
-});
-var subredditsCommand = defineCommand({
-  meta: {
-    name: "subreddits",
-    description: `Find the subreddits where an audience talks \u2014 name, members, and whether it can be read.
-
-Run it before \`reddit search\` instead of guessing names: a plausible-sounding subreddit can be dead (r/CouriersUK has one post), while the conversation sits in r/AmazonFlexUK or r/deliveroos.
-
-Examples:
-  baker research reddit subreddits "amazon flex uk"
-  baker research reddit subreddits "deliveroo" --limit 5`
-  },
-  args: {
-    query: { type: "positional", description: "Audience or topic", required: false },
-    limit: { type: "string", description: "1-25, default 10", required: false }
-  },
-  run: async ({ args }) => {
-    const query = args.query?.trim();
-    if (!query) failValidation('Say what to look for: baker research reddit subreddits "<audience or topic>"');
-    const body = { query };
-    if (args.limit) body.limit = Number(args.limit);
-    try {
-      const data = await findSubreddits(body);
-      writeResearchJson({
-        ok: true,
-        data: data.results,
-        source: data.source,
-        fields: {
-          name: "Pass this to --subreddit",
-          subscribers: "Members \u2014 size, not activity",
-          access: "public / restricted (readable, members post) / private (unreadable) / null when the source doesn't say",
-          description: "The subreddit's own summary",
-          url: "The subreddit"
-        },
-        hints: redditSubredditsHints({ resultCount: data.results.length })
-      });
-    } catch (err) {
-      handleResearchError(err, redditFix);
-    }
-  }
-});
-var redditCommand = defineCommand({
-  meta: {
-    name: "reddit",
-    description: `Read Reddit verbatim \u2014 the one site no page reader will open for us.
-
-Commands:
-  subreddits \u2014 Find where the audience talks (start here)
-  search     \u2014 Find posts or comments in the audience's own words
-  thread     \u2014 Read one thread: the post and its best comments
-
-Examples:
-  baker research reddit subreddits "amazon flex uk"
-  baker research reddit search "agency never paid" --subreddit couriersofreddit,AmazonFlexUK --kind comments
-  baker research reddit thread "https://www.reddit.com/r/AmazonFlexUK/comments/1abc2de/"
-Full guide: __tooling__/docs/tools/baker/research.md`
-  },
-  subCommands: { subreddits: subredditsCommand, search: searchCommand, thread: threadCommand }
-});
-
-export {
-  searchReddit,
-  findSubreddits,
-  subredditsFromArgs,
-  redditCommand
-};
-//# sourceMappingURL=chunk-CFHIW5QZ.js.map

package/dist/chunk-CYEO5ZIO.js

@@ -1,133 +0,0 @@
-// src/commands/ads/field-descriptions.ts
-var FIELD_DESCRIPTIONS = {
-  // Customer
-  "customer.id": "Google Ads account ID",
-  "customer.descriptive_name": "Account display name",
-  "customer.currency_code": "Account currency (e.g. USD, EUR)",
-  "customer.time_zone": "Account timezone (e.g. America/New_York)",
-  // Campaign
-  "campaign.id": "Unique campaign identifier",
-  "campaign.name": "Campaign display name",
-  "campaign.status": "ENABLED, PAUSED, or REMOVED",
-  "campaign.advertising_channel_type": "Campaign type: SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX, DEMAND_GEN",
-  "campaign.bidding_strategy_type": "Bidding strategy (TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, etc.)",
-  "campaign.primary_status": "Whether the campaign can serve: ELIGIBLE, PAUSED, REMOVED, ENDED, PENDING, MISCONFIGURED, LIMITED, LEARNING, NOT_ELIGIBLE. Unlike the keyword equivalent, LIMITED is a real value here \u2014 but Google publishes no reason-to-status mapping, so decide 'Limited by budget' from primary_status_reasons, not from this field.",
-  "campaign.primary_status_reasons": "Why the campaign is limited or not serving (repeated field \u2014 an array). BUDGET_CONSTRAINED is 'Limited by budget'; BUDGET_MISCONFIGURED is a broken budget setting, not a cap. Since 17 Aug 2026 a budget-limited campaign on a target-based strategy delivers toward its target instead of toward its recent actual cost, so BUDGET_CONSTRAINED is the flag that says a target above actual now costs money. BIDDING_STRATEGY_LEARNING means the bidding system is still adjusting to a change.",
-  "campaign.target_cpa.target_cpa_micros": "Target CPA in micros on a standalone Target CPA strategy",
-  "campaign.maximize_conversions.target_cpa_micros": "Target CPA in micros when the target is held inside a Maximize Conversions strategy \u2014 the shape Google uses on Search",
-  "campaign.target_roas.target_roas": "Target ROAS as a ratio (2.5 = 250%) on a standalone Target ROAS strategy",
-  "campaign.maximize_conversion_value.target_roas": "Target ROAS as a ratio when held inside a Maximize Conversion Value strategy",
-  "campaign.target_cpc.target_cpc_micros": "Target CPC in micros on a Demand Gen Target CPC strategy. Governed by the same August 2026 change as Target CPA/ROAS: on a budget-limited campaign it is what delivery moves toward, not a ceiling.",
-  "ad_group.target_cpc_micros": "Ad-group override of the campaign's Demand Gen target CPC, in micros",
-  "campaign.start_date": "Campaign start date (YYYY-MM-DD)",
-  "campaign.end_date": "Campaign end date (YYYY-MM-DD), blank if ongoing",
-  // Campaign budget
-  "campaign_budget.amount_micros": "Daily budget in micros (\xF7 1,000,000 for actual currency)",
-  // Ad group
-  "ad_group.id": "Unique ad group identifier",
-  "ad_group.name": "Ad group display name",
-  "ad_group.status": "ENABLED, PAUSED, or REMOVED",
-  "ad_group.type": "Ad group type (SEARCH_STANDARD, DISPLAY_STANDARD, etc.)",
-  // Ad group ad
-  "ad_group_ad.ad.id": "Unique ad identifier",
-  "ad_group_ad.ad.final_urls": "Landing page URLs (array)",
-  "ad_group_ad.ad.type": "Ad format (RESPONSIVE_SEARCH_AD, etc.)",
-  "ad_group_ad.status": "ENABLED, PAUSED, or REMOVED",
-  "ad_group_ad.ad.responsive_search_ad.headlines": "Ad headline variations (array)",
-  "ad_group_ad.ad.responsive_search_ad.descriptions": "Ad description variations (array)",
-  // Keywords
-  "ad_group_criterion.criterion_id": "Keyword criterion id \u2014 derived from text + match type, so every copy of the same keyword across ad groups shares it. Pair with ad_group.id to identify one copy (writes take customers/<cid>/adGroupCriteria/<adGroupId>~<criterionId>)",
-  "ad_group_criterion.keyword.text": "The keyword text",
-  "ad_group_criterion.keyword.match_type": "EXACT, PHRASE, or BROAD",
-  "ad_group_criterion.status": "ENABLED, PAUSED, or REMOVED",
-  "ad_group_criterion.quality_info.quality_score": "Quality score 1-10 (higher is better)",
-  "ad_group_criterion.quality_info.creative_quality_score": "Ad relevance bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE",
-  "ad_group_criterion.quality_info.post_click_quality_score": "Landing page experience bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE",
-  "ad_group_criterion.quality_info.search_predicted_ctr": "Expected click-through rate bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE",
-  "ad_group_criterion.primary_status": "Whether the keyword can serve: ELIGIBLE, PAUSED, REMOVED, PENDING, NOT_ELIGIBLE. There is no LIMITED value \u2014 Google Ads' 'Eligible (Limited)' is ELIGIBLE plus a limiting entry in primary_status_reasons, so read both.",
-  "ad_group_criterion.primary_status_reasons": "Why the keyword is in that status (array). AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID and AD_GROUP_CRITERION_LOW_QUALITY are the two that render as '(Limited)'; the CAMPAIGN_*/AD_GROUP_* entries just restate a paused or removed parent.",
-  "ad_group_criterion.system_serving_status": "ELIGIBLE or RARELY_SERVED (too few searches to show)",
-  "ad_group_criterion.approval_status": "Ad-approval state: APPROVED, DISAPPROVED, PENDING_REVIEW, UNDER_REVIEW",
-  "ad_group_criterion.disapproval_reasons": "Policy reasons the keyword was disapproved (array)",
-  "ad_group_criterion.cpc_bid_micros": "Max CPC bid set on this keyword, in micros (\xF7 1,000,000)",
-  "ad_group_criterion.effective_cpc_bid_micros": "Max CPC actually in force, in micros (\xF7 1,000,000) \u2014 the keyword's own bid, or the ad group's when the keyword has none",
-  "ad_group_criterion.effective_cpc_bid_source": "Where the effective max CPC comes from: ADGROUP, CRITERION, or CAMPAIGN_BIDDING_STRATEGY",
-  "ad_group_criterion.position_estimates.first_page_cpc_micros": "Bid estimated to reach the first page of results, in micros (\xF7 1,000,000). The number in Google Ads' 'Below first page bid (\u20AC3.63)' label \u2014 compare it against effective_cpc_bid_micros.",
-  "ad_group_criterion.position_estimates.top_of_page_cpc_micros": "Bid estimated to reach the top of the first page, in micros (\xF7 1,000,000)",
-  "ad_group_criterion.position_estimates.first_position_cpc_micros": "Bid estimated to reach the first ad position, in micros (\xF7 1,000,000)",
-  // Search terms
-  "search_term_view.search_term": "Actual user search query that triggered the ad",
-  "search_term_view.status": "Whether the search term is added, excluded, or none",
-  // Metrics
-  "metrics.impressions": "Times ads were shown (integer)",
-  "metrics.clicks": "Total clicks (integer)",
-  "metrics.cost_micros": "Total cost in micros (\xF7 1,000,000 for actual currency). Use 'currency' command for account currency.",
-  "metrics.cost": "Total cost in actual currency (already converted from micros)",
-  "metrics.conversions": "Conversion count (can be fractional from attribution models)",
-  "metrics.conversions_value": "Revenue from conversions in actual currency",
-  "metrics.all_conversions": "All conversions including view-through",
-  "metrics.all_conversions_value": "Total attributed revenue including view-through",
-  "metrics.ctr": "Click-through rate as decimal (0.05 = 5%)",
-  "metrics.average_cpc": "Average cost per click in micros (\xF7 1,000,000)",
-  "metrics.average_cpm": "Average cost per 1000 impressions in micros (\xF7 1,000,000)",
-  "metrics.search_impression_share": "Impression share as decimal (0.0\u20131.0)",
-  "metrics.search_budget_lost_impression_share": "Share of impressions lost because the budget ran out, as a decimal (0.0\u20131.0). The corroborating signal for a 'Limited by budget' campaign \u2014 a high value here alongside a target above actual cost per conversion is the combination that now raises spend.",
-  "metrics.cost_per_conversion": "Actual cost per conversion in micros (\xF7 1,000,000) \u2014 compare against the campaign's target",
-  "metrics.interaction_rate": "Interaction rate as decimal",
-  "metrics.video_views": "Total video views (integer)",
-  "metrics.video_view_rate": "Video view rate as decimal",
-  // Segments
-  "segments.date": "Date (YYYY-MM-DD format)",
-  "segments.device": "DESKTOP, MOBILE, TABLET, or OTHER",
-  "segments.day_of_week": "Day of week (MONDAY, TUESDAY, etc.)",
-  "segments.ad_network_type": "Network: SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, etc.",
-  "segments.product_title": "Shopping product title",
-  "segments.product_item_id": "Shopping product ID",
-  "segments.product_brand": "Shopping product brand",
-  "segments.product_type_l1": "Shopping product type (level 1)",
-  // Assets
-  "asset.type": "Asset type: IMAGE, YOUTUBE_VIDEO, TEXT, LEAD_FORM, etc.",
-  "asset.text_asset.text": "Text asset content",
-  "asset.image_asset.full_size.url": "Full-size image URL",
-  "asset.youtube_video_asset.youtube_video_id": "YouTube video ID",
-  "asset.youtube_video_asset.youtube_video_title": "YouTube video title",
-  "asset_group.name": "Asset group display name",
-  "asset_group.status": "ENABLED, PAUSED, or REMOVED",
-  "asset_group_asset.field_type": "Where the asset is used (HEADLINE, DESCRIPTION, LOGO, etc.)",
-  "asset_group_asset.performance_label": "Performance rating: BEST, GOOD, LOW, LEARNING",
-  // Change events (field-level detail, last 30 days)
-  "change_event.change_date_time": "When the change occurred (ISO 8601)",
-  "change_event.change_resource_type": "What was changed: CAMPAIGN, AD_GROUP, AD, etc.",
-  "change_event.resource_change_operation": "CREATE, UPDATE, or REMOVE",
-  "change_event.user_email": "Email of user who made the change",
-  // Change status (which resources changed, last 90 days — no values, no user)
-  "change_status.last_change_date_time": "When this resource last changed (ISO 8601)",
-  "change_status.resource_type": "What changed: CAMPAIGN, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION, etc.",
-  "change_status.resource_status": "ADDED, CHANGED, or REMOVED \u2014 not the old or new value",
-  "change_status.resource_name": "Identifier of the changed resource; query it to read its current values",
-  "change_status.campaign": "Resource name of the campaign the change belongs to",
-  "change_status.ad_group": "Resource name of the ad group the change belongs to",
-  "change_status.ad_group_ad": "Resource name of the changed ad",
-  "change_status.ad_group_criterion": "Resource name of the changed keyword or criterion",
-  "change_status.campaign_criterion": "Resource name of the changed campaign-level criterion",
-  // Landing pages
-  "landing_page_view.unexpanded_final_url": "Landing page URL",
-  // Geo
-  "geo_target_constant.name": "Geographic location name",
-  "geo_target_constant.resource_name": "Geo target resource identifier"
-};
-function getFieldDescriptions(fields) {
-  const result = {};
-  for (const field of fields) {
-    const desc = FIELD_DESCRIPTIONS[field];
-    if (desc) {
-      result[field] = desc;
-    }
-  }
-  return result;
-}
-
-export {
-  getFieldDescriptions
-};
-//# sourceMappingURL=chunk-CYEO5ZIO.js.map

package/dist/chunk-CYEO5ZIO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/field-descriptions.ts"],"sourcesContent":["const FIELD_DESCRIPTIONS: Record<string, string> = {\n  // Customer\n  \"customer.id\": \"Google Ads account ID\",\n  \"customer.descriptive_name\": \"Account display name\",\n  \"customer.currency_code\": \"Account currency (e.g. USD, EUR)\",\n  \"customer.time_zone\": \"Account timezone (e.g. America/New_York)\",\n\n  // Campaign\n  \"campaign.id\": \"Unique campaign identifier\",\n  \"campaign.name\": \"Campaign display name\",\n  \"campaign.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"campaign.advertising_channel_type\": \"Campaign type: SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX, DEMAND_GEN\",\n  \"campaign.bidding_strategy_type\": \"Bidding strategy (TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, etc.)\",\n  \"campaign.primary_status\":\n    \"Whether the campaign can serve: ELIGIBLE, PAUSED, REMOVED, ENDED, PENDING, MISCONFIGURED, LIMITED, LEARNING, NOT_ELIGIBLE. Unlike the keyword equivalent, LIMITED is a real value here — but Google publishes no reason-to-status mapping, so decide 'Limited by budget' from primary_status_reasons, not from this field.\",\n  \"campaign.primary_status_reasons\":\n    \"Why the campaign is limited or not serving (repeated field — an array). BUDGET_CONSTRAINED is 'Limited by budget'; BUDGET_MISCONFIGURED is a broken budget setting, not a cap. Since 17 Aug 2026 a budget-limited campaign on a target-based strategy delivers toward its target instead of toward its recent actual cost, so BUDGET_CONSTRAINED is the flag that says a target above actual now costs money. BIDDING_STRATEGY_LEARNING means the bidding system is still adjusting to a change.\",\n  \"campaign.target_cpa.target_cpa_micros\": \"Target CPA in micros on a standalone Target CPA strategy\",\n  \"campaign.maximize_conversions.target_cpa_micros\":\n    \"Target CPA in micros when the target is held inside a Maximize Conversions strategy — the shape Google uses on Search\",\n  \"campaign.target_roas.target_roas\": \"Target ROAS as a ratio (2.5 = 250%) on a standalone Target ROAS strategy\",\n  \"campaign.maximize_conversion_value.target_roas\":\n    \"Target ROAS as a ratio when held inside a Maximize Conversion Value strategy\",\n  \"campaign.target_cpc.target_cpc_micros\":\n    \"Target CPC in micros on a Demand Gen Target CPC strategy. Governed by the same August 2026 change as Target CPA/ROAS: on a budget-limited campaign it is what delivery moves toward, not a ceiling.\",\n  \"ad_group.target_cpc_micros\": \"Ad-group override of the campaign's Demand Gen target CPC, in micros\",\n  \"campaign.start_date\": \"Campaign start date (YYYY-MM-DD)\",\n  \"campaign.end_date\": \"Campaign end date (YYYY-MM-DD), blank if ongoing\",\n\n  // Campaign budget\n  \"campaign_budget.amount_micros\": \"Daily budget in micros (÷ 1,000,000 for actual currency)\",\n\n  // Ad group\n  \"ad_group.id\": \"Unique ad group identifier\",\n  \"ad_group.name\": \"Ad group display name\",\n  \"ad_group.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"ad_group.type\": \"Ad group type (SEARCH_STANDARD, DISPLAY_STANDARD, etc.)\",\n\n  // Ad group ad\n  \"ad_group_ad.ad.id\": \"Unique ad identifier\",\n  \"ad_group_ad.ad.final_urls\": \"Landing page URLs (array)\",\n  \"ad_group_ad.ad.type\": \"Ad format (RESPONSIVE_SEARCH_AD, etc.)\",\n  \"ad_group_ad.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"ad_group_ad.ad.responsive_search_ad.headlines\": \"Ad headline variations (array)\",\n  \"ad_group_ad.ad.responsive_search_ad.descriptions\": \"Ad description variations (array)\",\n\n  // Keywords\n  \"ad_group_criterion.criterion_id\":\n    \"Keyword criterion id — derived from text + match type, so every copy of the same keyword across ad groups shares it. Pair with ad_group.id to identify one copy (writes take customers/<cid>/adGroupCriteria/<adGroupId>~<criterionId>)\",\n  \"ad_group_criterion.keyword.text\": \"The keyword text\",\n  \"ad_group_criterion.keyword.match_type\": \"EXACT, PHRASE, or BROAD\",\n  \"ad_group_criterion.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"ad_group_criterion.quality_info.quality_score\": \"Quality score 1-10 (higher is better)\",\n  \"ad_group_criterion.quality_info.creative_quality_score\":\n    \"Ad relevance bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE\",\n  \"ad_group_criterion.quality_info.post_click_quality_score\":\n    \"Landing page experience bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE\",\n  \"ad_group_criterion.quality_info.search_predicted_ctr\":\n    \"Expected click-through rate bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE\",\n  \"ad_group_criterion.primary_status\":\n    \"Whether the keyword can serve: ELIGIBLE, PAUSED, REMOVED, PENDING, NOT_ELIGIBLE. There is no LIMITED value — Google Ads' 'Eligible (Limited)' is ELIGIBLE plus a limiting entry in primary_status_reasons, so read both.\",\n  \"ad_group_criterion.primary_status_reasons\":\n    \"Why the keyword is in that status (array). AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID and AD_GROUP_CRITERION_LOW_QUALITY are the two that render as '(Limited)'; the CAMPAIGN_*/AD_GROUP_* entries just restate a paused or removed parent.\",\n  \"ad_group_criterion.system_serving_status\": \"ELIGIBLE or RARELY_SERVED (too few searches to show)\",\n  \"ad_group_criterion.approval_status\": \"Ad-approval state: APPROVED, DISAPPROVED, PENDING_REVIEW, UNDER_REVIEW\",\n  \"ad_group_criterion.disapproval_reasons\": \"Policy reasons the keyword was disapproved (array)\",\n  \"ad_group_criterion.cpc_bid_micros\": \"Max CPC bid set on this keyword, in micros (÷ 1,000,000)\",\n  \"ad_group_criterion.effective_cpc_bid_micros\":\n    \"Max CPC actually in force, in micros (÷ 1,000,000) — the keyword's own bid, or the ad group's when the keyword has none\",\n  \"ad_group_criterion.effective_cpc_bid_source\":\n    \"Where the effective max CPC comes from: ADGROUP, CRITERION, or CAMPAIGN_BIDDING_STRATEGY\",\n  \"ad_group_criterion.position_estimates.first_page_cpc_micros\":\n    \"Bid estimated to reach the first page of results, in micros (÷ 1,000,000). The number in Google Ads' 'Below first page bid (€3.63)' label — compare it against effective_cpc_bid_micros.\",\n  \"ad_group_criterion.position_estimates.top_of_page_cpc_micros\":\n    \"Bid estimated to reach the top of the first page, in micros (÷ 1,000,000)\",\n  \"ad_group_criterion.position_estimates.first_position_cpc_micros\":\n    \"Bid estimated to reach the first ad position, in micros (÷ 1,000,000)\",\n\n  // Search terms\n  \"search_term_view.search_term\": \"Actual user search query that triggered the ad\",\n  \"search_term_view.status\": \"Whether the search term is added, excluded, or none\",\n\n  // Metrics\n  \"metrics.impressions\": \"Times ads were shown (integer)\",\n  \"metrics.clicks\": \"Total clicks (integer)\",\n  \"metrics.cost_micros\":\n    \"Total cost in micros (÷ 1,000,000 for actual currency). Use 'currency' command for account currency.\",\n  \"metrics.cost\": \"Total cost in actual currency (already converted from micros)\",\n  \"metrics.conversions\": \"Conversion count (can be fractional from attribution models)\",\n  \"metrics.conversions_value\": \"Revenue from conversions in actual currency\",\n  \"metrics.all_conversions\": \"All conversions including view-through\",\n  \"metrics.all_conversions_value\": \"Total attributed revenue including view-through\",\n  \"metrics.ctr\": \"Click-through rate as decimal (0.05 = 5%)\",\n  \"metrics.average_cpc\": \"Average cost per click in micros (÷ 1,000,000)\",\n  \"metrics.average_cpm\": \"Average cost per 1000 impressions in micros (÷ 1,000,000)\",\n  \"metrics.search_impression_share\": \"Impression share as decimal (0.0–1.0)\",\n  \"metrics.search_budget_lost_impression_share\":\n    \"Share of impressions lost because the budget ran out, as a decimal (0.0–1.0). The corroborating signal for a 'Limited by budget' campaign — a high value here alongside a target above actual cost per conversion is the combination that now raises spend.\",\n  \"metrics.cost_per_conversion\":\n    \"Actual cost per conversion in micros (÷ 1,000,000) — compare against the campaign's target\",\n  \"metrics.interaction_rate\": \"Interaction rate as decimal\",\n  \"metrics.video_views\": \"Total video views (integer)\",\n  \"metrics.video_view_rate\": \"Video view rate as decimal\",\n\n  // Segments\n  \"segments.date\": \"Date (YYYY-MM-DD format)\",\n  \"segments.device\": \"DESKTOP, MOBILE, TABLET, or OTHER\",\n  \"segments.day_of_week\": \"Day of week (MONDAY, TUESDAY, etc.)\",\n  \"segments.ad_network_type\": \"Network: SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, etc.\",\n  \"segments.product_title\": \"Shopping product title\",\n  \"segments.product_item_id\": \"Shopping product ID\",\n  \"segments.product_brand\": \"Shopping product brand\",\n  \"segments.product_type_l1\": \"Shopping product type (level 1)\",\n\n  // Assets\n  \"asset.type\": \"Asset type: IMAGE, YOUTUBE_VIDEO, TEXT, LEAD_FORM, etc.\",\n  \"asset.text_asset.text\": \"Text asset content\",\n  \"asset.image_asset.full_size.url\": \"Full-size image URL\",\n  \"asset.youtube_video_asset.youtube_video_id\": \"YouTube video ID\",\n  \"asset.youtube_video_asset.youtube_video_title\": \"YouTube video title\",\n  \"asset_group.name\": \"Asset group display name\",\n  \"asset_group.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"asset_group_asset.field_type\": \"Where the asset is used (HEADLINE, DESCRIPTION, LOGO, etc.)\",\n  \"asset_group_asset.performance_label\": \"Performance rating: BEST, GOOD, LOW, LEARNING\",\n\n  // Change events (field-level detail, last 30 days)\n  \"change_event.change_date_time\": \"When the change occurred (ISO 8601)\",\n  \"change_event.change_resource_type\": \"What was changed: CAMPAIGN, AD_GROUP, AD, etc.\",\n  \"change_event.resource_change_operation\": \"CREATE, UPDATE, or REMOVE\",\n  \"change_event.user_email\": \"Email of user who made the change\",\n\n  // Change status (which resources changed, last 90 days — no values, no user)\n  \"change_status.last_change_date_time\": \"When this resource last changed (ISO 8601)\",\n  \"change_status.resource_type\": \"What changed: CAMPAIGN, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION, etc.\",\n  \"change_status.resource_status\": \"ADDED, CHANGED, or REMOVED — not the old or new value\",\n  \"change_status.resource_name\": \"Identifier of the changed resource; query it to read its current values\",\n  \"change_status.campaign\": \"Resource name of the campaign the change belongs to\",\n  \"change_status.ad_group\": \"Resource name of the ad group the change belongs to\",\n  \"change_status.ad_group_ad\": \"Resource name of the changed ad\",\n  \"change_status.ad_group_criterion\": \"Resource name of the changed keyword or criterion\",\n  \"change_status.campaign_criterion\": \"Resource name of the changed campaign-level criterion\",\n\n  // Landing pages\n  \"landing_page_view.unexpanded_final_url\": \"Landing page URL\",\n\n  // Geo\n  \"geo_target_constant.name\": \"Geographic location name\",\n  \"geo_target_constant.resource_name\": \"Geo target resource identifier\",\n};\n\nexport function getFieldDescriptions(fields: string[]): Record<string, string> {\n  const result: Record<string, string> = {};\n  for (const field of fields) {\n    const desc = FIELD_DESCRIPTIONS[field];\n    if (desc) {\n      result[field] = desc;\n    }\n  }\n  return result;\n}\n"],"mappings":"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","names":[]}