@koda-sl/baker-cli 0.373.0-dev.5cf4f1409 → 0.374.0-dev.c6366e1f6

package/dist/cli.js

@@ -133,7 +133,7 @@ import {
 } from "./chunk-7YNOGIWQ.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand249, runMain } from "citty";
+import { defineCommand as defineCommand250, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -161,8 +161,8 @@ function cacheFlagForParser(argv) {
 }
 function rewriteBeforeDoubleDash(argv, rewrite) {
   const end = argv.indexOf("--");
-  const limit = end === -1 ? argv.length : end;
-  return argv.flatMap((token, index) => index >= limit ? [token] : rewrite(token));
+  const limit2 = end === -1 ? argv.length : end;
+  return argv.flatMap((token, index) => index >= limit2 ? [token] : rewrite(token));
 }
 
 // src/commands/actions/index.ts
@@ -1492,7 +1492,7 @@ var audienceCreateSchema = z3.object({
   }
 });
 var ENGAGEMENT_LOOKBACK_DAYS = [7, 14, 28, 30, 60, 90, 180, 365];
-var WEBSITE_LOOKBACK_DAYS = ENGAGEMENT_LOOKBACK_DAYS.filter((days) => days >= 14 && days <= 180);
+var WEBSITE_LOOKBACK_DAYS = ENGAGEMENT_LOOKBACK_DAYS.filter((days2) => days2 >= 14 && days2 <= 180);
 var EVENT_LOOKBACK_DAYS = [730];
 var WEBSITE_SOURCE_PLATFORM = "LINKEDIN_WEBSITE_RETARGETING";
 var TRIGGER_SOURCE_TYPE_BY_PLATFORM = { [WEBSITE_SOURCE_PLATFORM]: "WEBSITE" };
@@ -1578,9 +1578,9 @@ function retargetingConfigProblems(raw) {
   const expectedTriggerSource = TRIGGER_SOURCE_TYPE_BY_PLATFORM[sourcePlatform] ?? sourcePlatform;
   for (const rule of rules.data) {
     problems.push(...ruleProblems(rule, sourcePlatform ? expectedTriggerSource : void 0));
-    const days = rule.timeFrame.timeSpan.duration;
-    if (!allowed.includes(days)) {
-      problems.push(`lookback ${days} days is not offered for ${sourcePlatform} \u2014 use ${allowed.join(", ")}`);
+    const days2 = rule.timeFrame.timeSpan.duration;
+    if (!allowed.includes(days2)) {
+      problems.push(`lookback ${days2} days is not offered for ${sourcePlatform} \u2014 use ${allowed.join(", ")}`);
     }
   }
   const shapes = new Set(rules.data.map((rule) => `${rule.engagementTrigger}|${rule.timeFrame.timeSpan.duration}`));
@@ -7143,12 +7143,12 @@ function parseClause(clause) {
   return { error: `"${clause}" has no operator this understands. ${EXPRESSION_HELP}` };
 }
 function parseConditionsExpression(expression) {
-  const split = splitClauses(expression);
-  if ("error" in split) {
-    return { ok: false, error: split.error };
+  const split2 = splitClauses(expression);
+  if ("error" in split2) {
+    return { ok: false, error: split2.error };
   }
   const rules = [];
-  for (const clause of split.clauses) {
+  for (const clause of split2.clauses) {
     if (clause.length === 0) {
       return { ok: false, error: `An empty rule. ${EXPRESSION_HELP}` };
     }
@@ -7161,7 +7161,7 @@ function parseConditionsExpression(expression) {
   if (rules.length > MAX_CONDITION_RULES) {
     return { ok: false, error: `At most ${MAX_CONDITION_RULES} rules.` };
   }
-  return { ok: true, conditions: { match: split.match, rules } };
+  return { ok: true, conditions: { match: split2.match, rules } };
 }
 
 // ../api/src/scheduledAgents.ts
@@ -8618,12 +8618,12 @@ function advisoryHint(name, description) {
   return executable ? { kind: "executable", ...executable } : null;
 }
 var ACTIONS_LIST_DEFAULT_LIMIT = 500;
-function buildListHints({ returned, limit }) {
-  if (returned < limit) {
+function buildListHints({ returned, limit: limit2 }) {
+  if (returned < limit2) {
     return [];
   }
   return [
-    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
+    `This list is capped at ${limit2} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit2 * 2} (or narrow with --status / --search).`
   ];
 }
 
@@ -9402,9 +9402,9 @@ function resolveWindow(args5) {
     const todayStart = startOfLocalDay(new Date(now));
     return { fromMs: todayStart - DAY_MS, toMs: todayStart };
   }
-  const days = /^(\d+)d$/.exec(since);
-  if (days) {
-    return { fromMs: now - Number(days[1]) * DAY_MS, toMs: now };
+  const days2 = /^(\d+)d$/.exec(since);
+  if (days2) {
+    return { fromMs: now - Number(days2[1]) * DAY_MS, toMs: now };
   }
   return failValidation(`--since must be one of: today | yesterday | <N>d (e.g. 7d). Got: ${since}`);
 }
@@ -9802,15 +9802,15 @@ import { defineCommand as defineCommand19 } from "citty";
 function listed(resources) {
   return resources.map((resource) => resource.label ? `${resource.id} (${resource.label})` : resource.id).join("; ");
 }
-function connectedResourceHints({ plural, singular, flag: flag2, resources }) {
+function connectedResourceHints({ plural, singular, flag: flag3, resources }) {
   if (resources.length === 0) {
     return [];
   }
   if (resources.length === 1) {
-    return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag2}.`];
+    return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag3}.`];
   }
   return [
-    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ${flag2} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
+    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ${flag3} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
   ];
 }
 
@@ -10033,8 +10033,8 @@ var CHANGE_SCOPE_MAX_DAYS = {
 };
 var DEFAULT_CHANGE_DAYS = 7;
 var MAX_CHANGE_DAYS = CHANGE_SCOPE_MAX_DAYS.summary;
-function isChangeLookbackWithinReach(days, scope) {
-  return days <= CHANGE_SCOPE_MAX_DAYS[scope];
+function isChangeLookbackWithinReach(days2, scope) {
+  return days2 <= CHANGE_SCOPE_MAX_DAYS[scope];
 }
 
 // ../api/src/ads-google/geo-constants.ts
@@ -10467,8 +10467,8 @@ function equivalentBetween(literal, now) {
     const unit = rolling[2];
     if (n < 1) return null;
     if (unit === "DAYS" || unit === "WEEKS") {
-      const days = unit === "DAYS" ? n : n * 7;
-      return range(utcDate(year, today.getUTCMonth(), today.getUTCDate() - days), yesterday);
+      const days2 = unit === "DAYS" ? n : n * 7;
+      return range(utcDate(year, today.getUTCMonth(), today.getUTCDate() - days2), yesterday);
     }
     const months = unit === "MONTHS" ? n : n * 12;
     return range(monthsBefore(today, months), yesterday);
@@ -10514,13 +10514,13 @@ function resolveChangesWindow(input) {
       }
     };
   }
-  const days = input.days ?? DEFAULT_CHANGE_DAYS;
-  if (!Number.isInteger(days) || days < 1) {
+  const days2 = input.days ?? DEFAULT_CHANGE_DAYS;
+  if (!Number.isInteger(days2) || days2 < 1) {
     return {
       ok: false,
       error: {
         code: "INVALID_LOOKBACK",
-        message: `--days must be a whole number of days, got '${days}'.`,
+        message: `--days must be a whole number of days, got '${days2}'.`,
         fix: {
           action: "retry_with_flag",
           explanation: `Pass --days as a positive integer, e.g. --days ${DEFAULT_CHANGE_DAYS}.`
@@ -10528,32 +10528,32 @@ function resolveChangesWindow(input) {
       }
     };
   }
-  if (!isChangeLookbackWithinReach(days, scope)) {
-    return { ok: false, error: lookbackTooLong(scope, days, CHANGE_SCOPE_MAX_DAYS[scope]) };
+  if (!isChangeLookbackWithinReach(days2, scope)) {
+    return { ok: false, error: lookbackTooLong(scope, days2, CHANGE_SCOPE_MAX_DAYS[scope]) };
   }
-  return { ok: true, scope, days, hints: hintsFor(scope, days) };
+  return { ok: true, scope, days: days2, hints: hintsFor(scope, days2) };
 }
-function lookbackTooLong(scope, days, max) {
-  if (scope === "detail" && days <= CHANGE_SCOPE_MAX_DAYS.summary) {
+function lookbackTooLong(scope, days2, max) {
+  if (scope === "detail" && days2 <= 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.`,
+      message: `Google keeps field-level change detail for ${max} days only; ${days2} 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.`
+        explanation: `Re-run with --scope summary --days ${days2} 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.`,
+    message: `Google's account history API reaches back ${CHANGE_SCOPE_MAX_DAYS.summary} days at most; ${days2} 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 (${monthlySpendTrendQuery()}) 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) {
+function hintsFor(scope, days2) {
   const hints2 = [];
   if (scope === "detail") {
     hints2.push(
@@ -10563,7 +10563,7 @@ function hintsFor(scope, days) {
     hints2.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) {
+    if (days2 > CHANGE_SCOPE_MAX_DAYS.detail) {
       hints2.push(
         `Changes inside the last ${CHANGE_SCOPE_MAX_DAYS.detail} days also have field-level detail \u2014 re-run with --scope detail for those.`
       );
@@ -11009,11 +11009,11 @@ var CORRECTION_RULES = [
   {
     matchApiError: /changeEventError\W{0,4}START_DATE_TOO_OLD/i,
     fix: (ctx) => {
-      const limit = ctx.originalQuery.match(/LIMIT\s+(\d+)/i)?.[1] ?? "50";
+      const limit2 = 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}`;
+      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 ${limit2}`;
       return {
         action: "use_different_resource",
         correctedCommand: buildCommand(corrected, ctx),
@@ -11405,8 +11405,8 @@ import { defineCommand as defineCommand22 } from "citty";
 import { readFileSync as readFileSync2 } from "fs";
 
 // src/lib/repeatedFlags.ts
-function repeatedFlagValues(rawArgs, flag2) {
-  const long = `--${flag2}`;
+function repeatedFlagValues(rawArgs, flag3) {
+  const long = `--${flag3}`;
   const inline = `${long}=`;
   const values = [];
   for (let i = 0; i < rawArgs.length; i++) {
@@ -11424,9 +11424,9 @@ function repeatedFlagValues(rawArgs, flag2) {
   }
   return values;
 }
-function repeatedValues(rawArgs, flag2, parsed) {
+function repeatedValues(rawArgs, flag3, parsed) {
   if (rawArgs !== void 0) {
-    const fromLine = repeatedFlagValues(rawArgs, flag2);
+    const fromLine = repeatedFlagValues(rawArgs, flag3);
     if (fromLine.length > 0) return fromLine;
   }
   if (Array.isArray(parsed)) return parsed.filter((v) => typeof v === "string");
@@ -11452,8 +11452,8 @@ function booleanWordPositionalError(args5, entity) {
   }
   const value = word.toLowerCase();
   const raised = Object.keys(args5).filter((key) => key !== "_" && args5[key] === true);
-  const named = raised.length > 0 ? raised.map((flag2) => `--${flag2}`).join(" or ") : "a boolean flag";
-  const fix = raised.length > 0 ? raised.map((flag2) => `--${flag2}=${value}`).join(" or ") : `--<flag>=${value}`;
+  const named = raised.length > 0 ? raised.map((flag3) => `--${flag3}`).join(" or ") : "a boolean flag";
+  const fix = raised.length > 0 ? raised.map((flag3) => `--${flag3}=${value}`).join(" or ") : `--<flag>=${value}`;
   const negated = raised.length === 1 && value === "false" ? ` (or --no-${raised[0]})` : "";
   return `"${word}" was read as the ${entity} target, not as a value for ${named}. A boolean flag written with a space is set to TRUE and the word is dropped \u2014 attach it instead: ${fix}${negated}.`;
 }
@@ -12061,19 +12061,19 @@ function requireTarget(args5, entity) {
   }
   return target2;
 }
-function requireStringFlag(value, flag2) {
+function requireStringFlag(value, flag3) {
   if (typeof value !== "string" || value.length === 0) {
-    failWriteValidation(`${flag2} is required`);
+    failWriteValidation(`${flag3} is required`);
   }
   return value;
 }
-function microsFlag(value, flag2) {
+function microsFlag(value, flag3) {
   if (value === void 0 || value === null || value === "") {
     return void 0;
   }
   const num4 = Number(value);
   if (Number.isNaN(num4) || num4 <= 0) {
-    failWriteValidation(`${flag2} must be a positive amount (major currency units, e.g. 50 or 50.00)`);
+    failWriteValidation(`${flag3} must be a positive amount (major currency units, e.g. 50 or 50.00)`);
   }
   return toMicros(num4);
 }
@@ -13000,13 +13000,13 @@ function buildStatusScope(statusFields, includePaused) {
 }
 function expandPreset(preset, params2, now = /* @__PURE__ */ new Date()) {
   const dateRange = params2.dateRange ?? preset.defaultDateRange;
-  const limit = params2.limit ?? preset.defaultLimit;
+  const limit2 = params2.limit ?? preset.defaultLimit;
   if (preset.gaqlTemplate.includes("{dateRange}") && !isValidDateRange(dateRange)) {
     return { query: "", dateRangeError: dateRangeError(dateRange, now) };
   }
   const statusScope = buildStatusScope(preset.statusFields, params2.includePaused ?? false);
   const range = dateRange.trim();
-  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{limit\}/g, String(limit)).replace(/\{statusScope\}/g, statusScope);
+  const query = preset.gaqlTemplate.replace(/DURING\s+\{dateRange\}/g, BETWEEN_RE.test(range) ? range : `DURING ${range}`).replace(/\{dateRange\}/g, range).replace(/\{limit\}/g, String(limit2)).replace(/\{statusScope\}/g, statusScope);
   return { query };
 }
 
@@ -13126,7 +13126,7 @@ function addRequiredAncestorFields(query) {
     ]
   };
 }
-function applyAutoFixes(query, limit) {
+function applyAutoFixes(query, limit2) {
   let corrected = query;
   const warnings = [];
   if (/(?<![\w.])keyword\.text\b/.test(corrected)) {
@@ -13157,7 +13157,7 @@ function applyAutoFixes(query, limit) {
     warnings.push({ code: "ENUM_CORRECTED", message: "ad_group.status ACTIVE \u2192 ENABLED" });
   }
   if (!/\bLIMIT\b/i.test(corrected)) {
-    const effectiveLimit = limit ?? 200;
+    const effectiveLimit = limit2 ?? 200;
     corrected = `${corrected.trimEnd()} LIMIT ${effectiveLimit}`;
     if (!isSingleRowRead(corrected)) {
       warnings.push({ code: "AUTO_LIMIT", message: `Added LIMIT ${effectiveLimit}. Use --limit to override.` });
@@ -13275,7 +13275,7 @@ function rejectContainsCall(query, customerId) {
     }
   };
 }
-function validatePreflight(query, customerId, limit) {
+function validatePreflight(query, customerId, limit2) {
   const warnings = [];
   const corrected = query;
   const firstWord = corrected.trim().split(/\s+/)[0]?.toUpperCase();
@@ -13351,7 +13351,7 @@ function validatePreflight(query, customerId, limit) {
       message: "ad_group_criterion returns BOTH positive and negative keywords. Add ad_group_criterion.negative to SELECT or filter with WHERE ad_group_criterion.negative = FALSE (positives) / TRUE (negatives). Use --preset positive-keywords or negative-keywords instead."
     });
   }
-  const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected, limit);
+  const { query: autoFixed, warnings: autoFixWarnings } = applyAutoFixes(corrected, limit2);
   warnings.push(...autoFixWarnings);
   const analysis = analyzeServingChain(autoFixed);
   if (!analysis) return { valid: true, correctedQuery: autoFixed, warnings };
@@ -13620,12 +13620,12 @@ function writeRowsToFile(filePath, rows, fields, append) {
     writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
   }
 }
-function effectiveRowLimit(finalQuery, limit, all = false) {
+function effectiveRowLimit(finalQuery, limit2, all = false) {
   if (isSingleRowRead(finalQuery)) return void 0;
   const match = finalQuery.match(/\bLIMIT\s+(\d+)/i);
   const statementLimit = match?.[1] ? Number(match[1]) : void 0;
   if (all) return statementLimit;
-  return statementLimit === void 0 ? limit : Math.min(limit, statementLimit);
+  return statementLimit === void 0 ? limit2 : Math.min(limit2, statementLimit);
 }
 function warningLines(warnings, format) {
   return warnings.map((w) => {
@@ -13743,7 +13743,7 @@ function outputResults(rows, fieldDescs, warnings, args5, cached, read) {
   }
   writeRows(format, rows, resultColumns(read.gaql, rows), warningLines(allWarnings, format));
 }
-function resolveGaql(args5, limit) {
+function resolveGaql(args5, limit2) {
   if (args5.preset) {
     const preset = getPreset(args5.preset);
     if (!preset) {
@@ -13756,7 +13756,7 @@ function resolveGaql(args5, limit) {
     }
     const expanded = expandPreset(preset, {
       dateRange: args5["date-range"],
-      limit,
+      limit: limit2,
       includePaused: Boolean(args5["include-paused"])
     });
     if (expanded.dateRangeError) {
@@ -13908,8 +13908,8 @@ async function fetchAllPages(gaql, body, args5, servingOptions) {
     fileColumns: fileColumns ?? []
   };
 }
-async function executeQuery(finalQuery, args5, customerId, limit, warnings, useCache, cacheKey) {
-  const body = { customerId, query: finalQuery, pageSize: limit };
+async function executeQuery(finalQuery, args5, customerId, limit2, warnings, useCache, cacheKey) {
+  const body = { customerId, query: finalQuery, pageSize: limit2 };
   const managerId = getManagerIdForCustomer(customerId);
   if (managerId) body.managerId = managerId;
   if (args5.cursor) body.pageToken = args5.cursor;
@@ -13924,7 +13924,7 @@ async function executeQuery(finalQuery, args5, customerId, limit, warnings, useC
   if (args5.out) {
     const truncation = completenessWarnings({
       rowCount: totalRowsWritten,
-      effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args5.all)),
+      effectiveLimit: effectiveRowLimit(finalQuery, limit2, Boolean(args5.all)),
       all: Boolean(args5.all),
       hasMore: Boolean(lastPageToken)
     });
@@ -13966,7 +13966,7 @@ async function executeQuery(finalQuery, args5, customerId, limit, warnings, useC
     false,
     {
       gaql: finalQuery,
-      effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args5.all)),
+      effectiveLimit: effectiveRowLimit(finalQuery, limit2, Boolean(args5.all)),
       all: Boolean(args5.all),
       nextCursor: lastPageToken
     }
@@ -13978,8 +13978,8 @@ function shouldReadCache(args5) {
 var DEFAULT_QUERY_LIMIT = 200;
 function parseQueryLimit(raw) {
   if (raw === void 0 || raw === null || raw === "") return { ok: true, limit: DEFAULT_QUERY_LIMIT };
-  const limit = Number(raw);
-  if (Number.isInteger(limit) && limit >= 1 && limit <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit };
+  const limit2 = Number(raw);
+  if (Number.isInteger(limit2) && limit2 >= 1 && limit2 <= GOOGLE_ADS_QUERY_MAX_PAGE_SIZE) return { ok: true, limit: limit2 };
   return {
     ok: false,
     error: {
@@ -14002,13 +14002,13 @@ async function validateArgs(args5) {
     writeAdsJson(parsedLimit.error);
     process.exit(1);
   }
-  const { limit } = parsedLimit;
+  const { limit: limit2 } = parsedLimit;
   const customerId = await resolveCustomerId(args5);
-  const gaql = resolveGaql(args5, limit);
+  const gaql = resolveGaql(args5, limit2);
   if (!gaql) {
     process.exit(1);
   }
-  const preflight = validatePreflight(gaql, customerId, limit);
+  const preflight = validatePreflight(gaql, customerId, limit2);
   if (!preflight.valid && preflight.error) {
     writeAdsJson(preflight.error);
     process.exit(1);
@@ -14016,7 +14016,7 @@ async function validateArgs(args5) {
   const finalQuery = preflight.correctedQuery ?? gaql;
   return {
     customerId,
-    limit,
+    limit: limit2,
     finalQuery,
     warnings: [...preflight.warnings, ...servingScopeWarnings(args5, finalQuery)],
     useCache: !args5["no-cache"],
@@ -14093,7 +14093,7 @@ Examples:
     }
     const validated = await validateArgs(args5);
     if (!validated) return;
-    const { customerId, limit, finalQuery, warnings, useCache, cacheKey } = validated;
+    const { customerId, limit: limit2, finalQuery, warnings, useCache, cacheKey } = validated;
     if (shouldReadCache(args5)) {
       const cached = cacheGet("queries", cacheKey);
       if (cached) {
@@ -14111,7 +14111,7 @@ Examples:
           true,
           {
             gaql: finalQuery,
-            effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args5.all)),
+            effectiveLimit: effectiveRowLimit(finalQuery, limit2, Boolean(args5.all)),
             all: Boolean(args5.all)
           }
         );
@@ -14119,7 +14119,7 @@ Examples:
       }
     }
     try {
-      await executeQuery(finalQuery, args5, customerId, limit, warnings, useCache, cacheKey);
+      await executeQuery(finalQuery, args5, customerId, limit2, warnings, useCache, cacheKey);
     } catch (err) {
       handleQueryError(err, finalQuery, customerId);
     }
@@ -17722,12 +17722,12 @@ function skipBlanks(value, at) {
   while (value[i] === " " || value[i] === "	") i++;
   return i;
 }
-function readQuotedField(value, open, flag2) {
+function readQuotedField(value, open, flag3) {
   let text2 = "";
   let j = open + 1;
   while (!(value[j] === '"' && value[j + 1] !== '"')) {
     if (j >= value.length) {
-      failWriteValidation(`--${flag2} has a quote with no closing quote: ${value} \u2014 ${AD_COPY_LIST_USAGE}`);
+      failWriteValidation(`--${flag3} has a quote with no closing quote: ${value} \u2014 ${AD_COPY_LIST_USAGE}`);
     }
     text2 += value[j];
     j += value[j] === '"' ? 2 : 1;
@@ -17735,18 +17735,18 @@ function readQuotedField(value, open, flag2) {
   const after = skipBlanks(value, j + 1);
   if (after < value.length && value[after] !== ",") {
     failWriteValidation(
-      `--${flag2}: text follows the closing quote of "${text2}" \u2014 a quoted item must end at a comma. To put a quote inside an item, double it ("") or ${AD_COPY_LIST_USAGE}`
+      `--${flag3}: text follows the closing quote of "${text2}" \u2014 a quoted item must end at a comma. To put a quote inside an item, double it ("") or ${AD_COPY_LIST_USAGE}`
     );
   }
   return { text: text2, next: after + 1 };
 }
-function splitQuotedList(value, flag2) {
+function splitQuotedList(value, flag3) {
   const fields = [];
   let i = 0;
   while (i <= value.length) {
     const start = skipBlanks(value, i);
     if (value[start] === '"') {
-      const { text: text2, next } = readQuotedField(value, start, flag2);
+      const { text: text2, next } = readQuotedField(value, start, flag3);
       fields.push({ text: text2, quoted: true });
       i = next;
     } else {
@@ -17768,53 +17768,53 @@ function jsonStringArray(value) {
     return void 0;
   }
 }
-function parseCopyList(value, flag2) {
+function parseCopyList(value, flag3) {
   let items;
   if (Array.isArray(value)) {
     items = value.filter((v) => typeof v === "string").map((v) => ({ text: v.trim(), splitAtComma: false }));
   } else if (typeof value === "string") {
     const trimmed = value.trim();
     const json = jsonStringArray(trimmed);
-    items = json ? json.map((v) => ({ text: v.trim(), splitAtComma: false })) : splitQuotedList(trimmed, flag2);
+    items = json ? json.map((v) => ({ text: v.trim(), splitAtComma: false })) : splitQuotedList(trimmed, flag3);
   } else {
     return void 0;
   }
   const kept = items.filter((item) => item.text.length > 0);
   return kept.length > 0 ? kept : void 0;
 }
-function copyListFlag(value, flag2) {
-  return parseCopyList(value, flag2)?.map((item) => item.text);
+function copyListFlag(value, flag3) {
+  return parseCopyList(value, flag3)?.map((item) => item.text);
 }
-function refuseDashLedValue(rawArgs, flag2) {
+function refuseDashLedValue(rawArgs, flag3) {
   for (let i = 0; i < rawArgs.length - 1; i++) {
     if (rawArgs[i] === "--") return;
     const value = rawArgs[i + 1];
-    if (rawArgs[i] === `--${flag2}` && value?.startsWith("-")) {
+    if (rawArgs[i] === `--${flag3}` && value?.startsWith("-")) {
       failWriteValidation(
-        `--${flag2} is followed by "${value}", which starts with a dash and is read as another flag, not as copy. Join copy that starts with a dash to its flag with =: --${flag2}="${value}"`
+        `--${flag3} is followed by "${value}", which starts with a dash and is read as another flag, not as copy. Join copy that starts with a dash to its flag with =: --${flag3}="${value}"`
       );
     }
   }
 }
 function withRepeatedCopyFlags(args5, rawArgs) {
   const out = { ...args5 };
-  for (const flag2 of AD_COPY_LIST_FLAGS) {
-    refuseDashLedValue(rawArgs ?? [], flag2);
-    const values = repeatedFlagValues(rawArgs ?? [], flag2);
+  for (const flag3 of AD_COPY_LIST_FLAGS) {
+    refuseDashLedValue(rawArgs ?? [], flag3);
+    const values = repeatedFlagValues(rawArgs ?? [], flag3);
     if (values.length > 1) {
-      out[flag2] = values;
+      out[flag3] = values;
     }
   }
   return out;
 }
 function copyListSplitHints(args5) {
   const hints2 = [];
-  for (const flag2 of AD_COPY_LIST_FLAGS) {
-    const items = parseCopyList(args5[flag2], flag2) ?? [];
+  for (const flag3 of AD_COPY_LIST_FLAGS) {
+    const items = parseCopyList(args5[flag3], flag3) ?? [];
     const fragments = items.filter((item, index) => index > 0 && item.splitAtComma && new RegExp("^\\p{Ll}", "u").test(item.text));
     if (fragments.length > 0) {
       hints2.push(
-        `--${flag2}: ${fragments.map((f) => `"${f.text}"`).join(", ")} starts in lowercase \u2014 it looks like the end of one item cut at a comma. Check the staged copy; if it was one item, fix this op in place with \`draft amend <ref>\` (the ref this response returned) rather than staging it again, which would leave the cut copy staged too \u2014 ${AD_COPY_LIST_USAGE}.`
+        `--${flag3}: ${fragments.map((f) => `"${f.text}"`).join(", ")} starts in lowercase \u2014 it looks like the end of one item cut at a comma. Check the staged copy; if it was one item, fix this op in place with \`draft amend <ref>\` (the ref this response returned) rather than staging it again, which would leave the cut copy staged too \u2014 ${AD_COPY_LIST_USAGE}.`
       );
     }
   }
@@ -18365,11 +18365,11 @@ function urlCustomParametersFromFlags(args5, rawArgs) {
     failWriteValidation("--clear-custom-params removes every parameter \u2014 pass it OR --custom-param, not both");
   }
   return entries.map((entry) => {
-    const split = entry.indexOf("=");
-    if (split <= 0) {
+    const split2 = entry.indexOf("=");
+    if (split2 <= 0) {
       failWriteValidation(`--custom-param "${entry}" must be key=value (e.g. --custom-param season=summer)`);
     }
-    return { key: entry.slice(0, split), value: entry.slice(split + 1) };
+    return { key: entry.slice(0, split2), value: entry.slice(split2 + 1) };
   });
 }
 var geoTargetTypeArgs = {
@@ -18382,13 +18382,13 @@ var geoTargetTypeArgs = {
     description: "How EXCLUDED locations are matched \u2014 PRESENCE (default: excludes people in the location) or PRESENCE_OR_INTEREST (also excludes people interested in it)."
   }
 };
-function enumFlag(value, flag2, allowed) {
+function enumFlag(value, flag3, allowed) {
   if (typeof value !== "string" || value.length === 0) {
     return void 0;
   }
   const upper2 = value.toUpperCase();
   if (!allowed.includes(upper2)) {
-    failWriteValidation(`${flag2} must be one of ${allowed.join(" | ")}`);
+    failWriteValidation(`${flag3} must be one of ${allowed.join(" | ")}`);
   }
   return upper2;
 }
@@ -19108,8 +19108,8 @@ var FORMAT_CONTENT_FLAGS = {
   // same silent drop this gate exists for, on the one format that reads no flags at all.
   call: []
 };
-function formatsReading(flag2) {
-  return Object.entries(FORMAT_CONTENT_FLAGS).filter(([, flags]) => flags.includes(flag2)).map(([format]) => format);
+function formatsReading(flag3) {
+  return Object.entries(FORMAT_CONTENT_FLAGS).filter(([, flags]) => flags.includes(flag3)).map(([format]) => format);
 }
 function assertFlagsFitFormat(args5, format) {
   const allowed = FORMAT_CONTENT_FLAGS[format];
@@ -19117,14 +19117,14 @@ function assertFlagsFitFormat(args5, format) {
     return;
   }
   const stray = Object.keys(adContentArgs).filter(
-    (flag2) => flag2 !== "format" && args5[flag2] !== void 0 && !allowed.includes(flag2)
+    (flag3) => flag3 !== "format" && args5[flag3] !== void 0 && !allowed.includes(flag3)
   );
   if (stray.length === 0) {
     return;
   }
-  const detail = stray.map((flag2) => {
-    const elsewhere = formatsReading(flag2);
-    return elsewhere.length > 0 ? `--${flag2} (${elsewhere.join(" / ")})` : `--${flag2}`;
+  const detail = stray.map((flag3) => {
+    const elsewhere = formatsReading(flag3);
+    return elsewhere.length > 0 ? `--${flag3} (${elsewhere.join(" / ")})` : `--${flag3}`;
   }).join(", ");
   failWriteValidation(
     `a ${format} ad has no ${stray.map((f) => `--${f}`).join(", ")} \u2014 passing it here would stage the change without it. Formats that take it: ${detail}. Check the format with \`baker ads google query "SELECT ad_group_ad.ad.type FROM ad_group_ad WHERE ad_group_ad.ad.id = <id>"\`.`
@@ -19203,10 +19203,10 @@ var adContentArgs = {
   "final-url": { type: "string", description: "Comma-separated final URLs" }
 };
 function assertNoContentFlags(args5) {
-  const passed = Object.keys(adContentArgs).filter((flag2) => flag2 !== "format" && args5[flag2] !== void 0);
+  const passed = Object.keys(adContentArgs).filter((flag3) => flag3 !== "format" && args5[flag3] !== void 0);
   if (passed.length > 0) {
     failWriteValidation(
-      `${passed.map((flag2) => `--${flag2}`).join(", ")} only build an ad's content alongside --format (responsiveSearch | responsiveDisplay | call | app | video | demandGen | demandGenVideo) \u2014 add it, or pass --file with the complete content`
+      `${passed.map((flag3) => `--${flag3}`).join(", ")} only build an ad's content alongside --format (responsiveSearch | responsiveDisplay | call | app | video | demandGen | demandGenVideo) \u2014 add it, or pass --file with the complete content`
     );
   }
 }
@@ -19929,8 +19929,8 @@ function resolveAccountIdArg2(args5) {
 function todayIso2() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
-function daysAgoIso2(days) {
-  return new Date(Date.now() - days * DAY_MS2).toISOString().slice(0, 10);
+function daysAgoIso2(days2) {
+  return new Date(Date.now() - days2 * DAY_MS2).toISOString().slice(0, 10);
 }
 function csvOrJson2(args5) {
   return args5.output ?? "json";
@@ -20004,7 +20004,7 @@ function loadPatchArg2(args5) {
     throw err;
   }
 }
-function parseMoneyFlag(amount, currency, flag2) {
+function parseMoneyFlag(amount, currency, flag3) {
   if (amount === void 0 || amount === null || amount === "") {
     return void 0;
   }
@@ -20012,11 +20012,11 @@ function parseMoneyFlag(amount, currency, flag2) {
     return { amount: String(amount) };
   }
   if (typeof currency !== "string" || currency.length !== 3) {
-    failWriteValidation2(`${flag2} got an invalid --currency (expected a 3-letter code like EUR)`);
+    failWriteValidation2(`${flag3} got an invalid --currency (expected a 3-letter code like EUR)`);
   }
   return { amount: String(amount), currencyCode: currency.toUpperCase() };
 }
-function parseDateFlag(value, flag2) {
+function parseDateFlag(value, flag3) {
   if (value === void 0 || value === null || value === "") {
     return void 0;
   }
@@ -20026,11 +20026,11 @@ function parseDateFlag(value, flag2) {
   }
   const parsed = Date.parse(raw);
   if (Number.isNaN(parsed)) {
-    failWriteValidation2(`${flag2} must be an ISO date (2026-07-10) or epoch milliseconds`);
+    failWriteValidation2(`${flag3} must be an ISO date (2026-07-10) or epoch milliseconds`);
   }
   return parsed;
 }
-function parseOnOffFlag(value, flag2) {
+function parseOnOffFlag(value, flag3) {
   if (value === void 0 || value === null || value === "") {
     return void 0;
   }
@@ -20041,7 +20041,7 @@ function parseOnOffFlag(value, flag2) {
   if (raw === "off" || raw === "false") {
     return false;
   }
-  failWriteValidation2(`${flag2} must be on|off`);
+  failWriteValidation2(`${flag3} must be on|off`);
 }
 function parseLocaleFlag(value) {
   if (value === void 0 || value === null || value === "") {
@@ -21227,13 +21227,13 @@ Examples:
     }
   });
 }
-function trackingPairs(value, flag2) {
+function trackingPairs(value, flag3) {
   const raw = value === void 0 ? [] : Array.isArray(value) ? value : [value];
   return raw.flatMap(
     (entry) => String(entry).split("&").filter((pair) => pair.length > 0).map((pair) => {
       const at = pair.indexOf("=");
       if (at < 1 || at === pair.length - 1) {
-        failWriteValidation2(`${flag2} expects key=value pairs \u2014 got "${pair}"`);
+        failWriteValidation2(`${flag3} expects key=value pairs \u2014 got "${pair}"`);
       }
       return [pair.slice(0, at).trim(), pair.slice(at + 1).trim()];
     })
@@ -21569,9 +21569,9 @@ var CREATIVE_AMEND_CONTENT_FLAGS = [
 ];
 function creativeContentPatch(args5) {
   const patch = {};
-  for (const [flag2, key] of CREATIVE_AMEND_CONTENT_FLAGS) {
-    if (args5[flag2] !== void 0) {
-      patch[key] = args5[flag2];
+  for (const [flag3, key] of CREATIVE_AMEND_CONTENT_FLAGS) {
+    if (args5[flag3] !== void 0) {
+      patch[key] = args5[flag3];
     }
   }
   if (args5.cta !== void 0) {
@@ -22226,11 +22226,11 @@ function resolveDateRange(args5) {
     return { start, end };
   }
   const lastDaysRaw = args5["last-days"];
-  const days = lastDaysRaw ? Number(lastDaysRaw) : 7;
-  if (!Number.isFinite(days) || days < 1 || days > 730) {
+  const days2 = lastDaysRaw ? Number(lastDaysRaw) : 7;
+  if (!Number.isFinite(days2) || days2 < 1 || days2 > 730) {
     handleLinkedinError(new Error(`Invalid --last-days "${lastDaysRaw}". Use a positive number \u2264 730.`));
   }
-  return { start: daysAgoIso2(days), end: todayIso2() };
+  return { start: daysAgoIso2(days2), end: todayIso2() };
 }
 function resolveScopeIds(args5, level) {
   if (level === "account") {
@@ -22358,7 +22358,7 @@ Examples \u2014 common AI questions:
     }
     const range = resolveDateRange(args5);
     const metrics = commaSplit(args5.metrics);
-    const limit = args5.limit ? Number(args5.limit) : 1e3;
+    const limit2 = args5.limit ? Number(args5.limit) : 1e3;
     const request = {
       level,
       ids,
@@ -22368,7 +22368,7 @@ Examples \u2014 common AI questions:
       start: range.start,
       end: range.end,
       granularity,
-      limit
+      limit: limit2
     };
     try {
       const data = await apiPost("/api/ads/linkedin/analytics", {
@@ -23160,8 +23160,8 @@ function numberOf2(v) {
   }
   return 0;
 }
-function topByImpressions(rows, limit) {
-  return [...rows].sort((a, b) => numberOf2(b.impressions) - numberOf2(a.impressions)).slice(0, limit);
+function topByImpressions(rows, limit2) {
+  return [...rows].sort((a, b) => numberOf2(b.impressions) - numberOf2(a.impressions)).slice(0, limit2);
 }
 var demographicsCommand = defineCommand45({
   meta: {
@@ -23252,11 +23252,11 @@ function resolveRange(args5) {
   if (start) {
     return { start, end };
   }
-  const days = args5["last-days"] ? Number(args5["last-days"]) : 30;
-  if (!Number.isFinite(days) || days < 1) {
+  const days2 = args5["last-days"] ? Number(args5["last-days"]) : 30;
+  if (!Number.isFinite(days2) || days2 < 1) {
     handleLinkedinError(new Error("Invalid --last-days; must be a positive integer."));
   }
-  return { start: daysAgoIso2(days), end: todayIso2() };
+  return { start: daysAgoIso2(days2), end: todayIso2() };
 }
 
 // src/commands/ads/linkedin/draft.ts
@@ -25842,7 +25842,7 @@ function mergePayload3(file, flags) {
   }
   return merged;
 }
-function parseMoneyFlag2(amount, currency, flag2) {
+function parseMoneyFlag2(amount, currency, flag3) {
   if (amount === void 0 || amount === null || amount === "") {
     return void 0;
   }
@@ -25850,11 +25850,11 @@ function parseMoneyFlag2(amount, currency, flag2) {
     return { amount: String(amount) };
   }
   if (typeof currency !== "string" || currency.length !== 3) {
-    failWriteValidation3(`${flag2} got an invalid --currency (expected a 3-letter code like USD)`);
+    failWriteValidation3(`${flag3} got an invalid --currency (expected a 3-letter code like USD)`);
   }
   return { amount: String(amount), currencyCode: currency.toUpperCase() };
 }
-function parseDateFlag2(value, flag2) {
+function parseDateFlag2(value, flag3) {
   if (value === void 0 || value === null || value === "") {
     return void 0;
   }
@@ -25864,7 +25864,7 @@ function parseDateFlag2(value, flag2) {
   }
   const parsed = Date.parse(raw);
   if (Number.isNaN(parsed)) {
-    failWriteValidation3(`${flag2} must be an ISO date (2026-07-10) or epoch milliseconds`);
+    failWriteValidation3(`${flag3} must be an ISO date (2026-07-10) or epoch milliseconds`);
   }
   return parsed;
 }
@@ -25878,13 +25878,13 @@ function listFlag2(value) {
 function upper(value) {
   return typeof value === "string" && value.length > 0 ? value.toUpperCase() : void 0;
 }
-function numberFlag(value, flag2) {
+function numberFlag(value, flag3) {
   if (value === void 0 || value === null || value === "") {
     return void 0;
   }
   const n = Number(value);
   if (!Number.isFinite(n)) {
-    failWriteValidation3(`${flag2} must be a number`);
+    failWriteValidation3(`${flag3} must be a number`);
   }
   return n;
 }
@@ -27313,8 +27313,8 @@ function shouldAutoAsync(body) {
     return true;
   }
   if (body.since && body.until) {
-    const days = (Date.parse(body.until) - Date.parse(body.since)) / 864e5;
-    if (days > 90) {
+    const days2 = (Date.parse(body.until) - Date.parse(body.since)) / 864e5;
+    if (days2 > 90) {
       return true;
     }
   }
@@ -27783,14 +27783,14 @@ async function runStats(args5) {
   if (!pixelId) {
     handleMetaError(new Error("--pixel-id is required when --stats is set"));
   }
-  const days = args5.days ? Number(args5.days) : 7;
-  if (!Number.isInteger(days) || days <= 0 || days > 90) {
+  const days2 = args5.days ? Number(args5.days) : 7;
+  if (!Number.isInteger(days2) || days2 <= 0 || days2 > 90) {
     handleMetaError(new Error("--days must be a positive integer \u2264 90"));
   }
   const params2 = {
     "pixel-id": pixelId,
     aggregation: args5.aggregation ?? "event",
-    "start-time": daysAgoIso(days),
+    "start-time": daysAgoIso(days2),
     "end-time": todayIso()
   };
   if (args5["no-cache"]) params2["skip-cache"] = "true";
@@ -28450,10 +28450,10 @@ function parseXMoney(value) {
   }
   return { ok: true, micros: Math.round(amount * 1e6) };
 }
-function microsFromArg(value, flag2) {
+function microsFromArg(value, flag3) {
   const parsed = parseXMoney(value);
   if (!parsed.ok) {
-    failWriteValidation4(`${flag2} ${parsed.reason}`);
+    failWriteValidation4(`${flag3} ${parsed.reason}`);
   }
   return parsed.micros;
 }
@@ -30237,14 +30237,14 @@ function resolveQueryFromArgs(args5, timeZone) {
     granularity = args5.granularity ?? preset.granularity;
     placement = args5.placement ?? preset.placement;
     const requested = args5.days ? Number(args5.days) : preset.defaultDays;
-    const days = Math.min(SYNC_MAX_DAYS, Math.max(1, requested));
+    const days2 = Math.min(SYNC_MAX_DAYS, Math.max(1, requested));
     if (requested > SYNC_MAX_DAYS) {
       hints2.push(
-        `Sync stats cover at most ${SYNC_MAX_DAYS} days, so '${preset.name}' was shortened to the last ${days}. For the full window run: baker ads x stats job --entity ${entity} --entity-ids <ids> --metric-groups ${metricGroups?.join(",")} --start-time <start> --end-time <end>`
+        `Sync stats cover at most ${SYNC_MAX_DAYS} days, so '${preset.name}' was shortened to the last ${days2}. For the full window run: baker ads x stats job --entity ${entity} --entity-ids <ids> --metric-groups ${metricGroups?.join(",")} --start-time <start> --end-time <end>`
       );
     }
     const floor = granularity === "DAY" ? (d) => accountMidnightIso(d, timeZone) : isoHourFloor;
-    startTime ??= floor(days);
+    startTime ??= floor(days2);
     endTime ??= floor(0);
   }
   const entityIds = parseCsv5(args5["entity-ids"]);
@@ -31549,32 +31549,32 @@ function isUsableStepNameKey(key) {
 // src/commands/analytics/conversionArgs.ts
 var ConversionArgsError = class extends Error {
 };
-function allValues(flag2, argv) {
+function allValues(flag3, argv) {
   const values = [];
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
-    if (arg === flag2) {
+    if (arg === flag3) {
       const next = argv[i + 1];
       if (next !== void 0 && !next.startsWith("--")) values.push(next);
       continue;
     }
-    if (arg.startsWith(`${flag2}=`)) values.push(arg.slice(flag2.length + 1));
+    if (arg.startsWith(`${flag3}=`)) values.push(arg.slice(flag3.length + 1));
   }
   return values.map((value) => value.trim()).filter((value) => value !== "");
 }
-function onlyOnce(value, flag2, argv) {
+function onlyOnce(value, flag3, argv) {
   if (value === void 0) return void 0;
-  const given = argv.filter((arg) => arg === flag2 || arg.startsWith(`${flag2}=`)).length;
+  const given = argv.filter((arg) => arg === flag3 || arg.startsWith(`${flag3}=`)).length;
   if (given > 1) {
     throw new ConversionArgsError(
-      `${flag2} was given ${given} times and only the last would have been used. It takes one value.`
+      `${flag3} was given ${given} times and only the last would have been used. It takes one value.`
     );
   }
   const trimmed = String(value).trim();
   return trimmed === "" ? void 0 : trimmed;
 }
-function repeatable(flag2, cittyValue, argv) {
-  const fromArgv = allValues(flag2, argv);
+function repeatable(flag3, cittyValue, argv) {
+  const fromArgv = allValues(flag3, argv);
   if (fromArgv.length > 0) return fromArgv;
   if (cittyValue === void 0) return [];
   const trimmed = String(cittyValue).trim();
@@ -31614,11 +31614,11 @@ function checkEventKeys(eventKeys) {
 }
 function readDays(raw) {
   if (raw === void 0) return void 0;
-  const days = Number(raw);
-  if (!Number.isFinite(days) || days <= 0) {
+  const days2 = Number(raw);
+  if (!Number.isFinite(days2) || days2 <= 0) {
     throw new ConversionArgsError("--days must be a positive number of days.");
   }
-  return days;
+  return days2;
 }
 function parseConversionsArgs(raw, argv) {
   const countMode = onlyOnce(raw["count-mode"], "--count-mode", argv);
@@ -32564,8 +32564,8 @@ var SET_FLAGS = ["--source-event", "--platform", "--tag", "--event"];
 function parseSendsArgs(raw, argv, now = Date.now()) {
   const set = parseSetFlags(raw, argv, now);
   const remove = onlyOnce(raw.remove, "--remove", argv);
-  const days = raw.days === void 0 ? void 0 : Number(raw.days);
-  if (days !== void 0 && (!Number.isInteger(days) || days <= 0 || days > 400)) {
+  const days2 = raw.days === void 0 ? void 0 : Number(raw.days);
+  if (days2 !== void 0 && (!Number.isInteger(days2) || days2 <= 0 || days2 > 400)) {
     throw new ConversionArgsError("--days must be a whole number of days, from 1 to 400.");
   }
   const uploads = onlyOnce(raw.uploads, "--uploads", argv);
@@ -32580,17 +32580,17 @@ function parseSendsArgs(raw, argv, now = Date.now()) {
   return {
     ...set === void 0 ? {} : { set },
     ...remove === void 0 ? {} : { remove },
-    ...days === void 0 ? {} : { days },
+    ...days2 === void 0 ? {} : { days: days2 },
     ...uploads === void 0 ? {} : { uploads },
     ...raw.failed === true ? { failedOnly: true } : {},
     ...raw.skipped === true ? { skippedOnly: true } : {},
     full: raw.full === true
   };
 }
-function flagValueAt(argv, flag2, index) {
+function flagValueAt(argv, flag3, index) {
   const arg = argv[index] ?? "";
-  if (arg === flag2) return argv[index + 1];
-  return arg.startsWith(`${flag2}=`) ? arg.slice(flag2.length + 1) : void 0;
+  if (arg === flag3) return argv[index + 1];
+  return arg.startsWith(`${flag3}=`) ? arg.slice(flag3.length + 1) : void 0;
 }
 function parseParameterArgs(argv) {
   const parameters = {};
@@ -32621,7 +32621,7 @@ function parseSetFlags(raw, argv, now) {
     "--tag": onlyOnce(raw.tag, "--tag", argv),
     "--event": onlyOnce(raw.event, "--event", argv)
   };
-  const given = SET_FLAGS.filter((flag2) => values[flag2] !== void 0);
+  const given = SET_FLAGS.filter((flag3) => values[flag3] !== void 0);
   const set = raw.set === true;
   if (!set) {
     if (given.length > 0) {
@@ -32631,7 +32631,7 @@ function parseSetFlags(raw, argv, now) {
     }
     return void 0;
   }
-  const missing = SET_FLAGS.filter((flag2) => values[flag2] === void 0);
+  const missing = SET_FLAGS.filter((flag3) => values[flag3] === void 0);
   if (missing.length > 0) {
     throw new ConversionArgsError(
       `--set needs ${SET_FLAGS.join(", ")}; missing ${missing.join(", ")}. Copy --tag from platforms[].tags of a plain \`baker analytics sends\`, never from memory.`
@@ -33286,15 +33286,15 @@ registerSchema({
   description: "Where events reach Baker from a server: the client's own server door, and HubSpot events Baker reads \u2014 what each one watches and reads, and how it is doing",
   args: args3
 });
-function flagValueAt2(argv, flag2, index) {
+function flagValueAt2(argv, flag3, index) {
   const arg = argv[index] ?? "";
-  if (arg === flag2) return argv[index + 1];
-  return arg.startsWith(`${flag2}=`) ? arg.slice(flag2.length + 1) : void 0;
+  if (arg === flag3) return argv[index + 1];
+  return arg.startsWith(`${flag3}=`) ? arg.slice(flag3.length + 1) : void 0;
 }
-function parseRepeated(argv, flag2) {
+function parseRepeated(argv, flag3) {
   const values = [];
   for (let index = 0; index < argv.length; index += 1) {
-    const value = flagValueAt2(argv, flag2, index);
+    const value = flagValueAt2(argv, flag3, index);
     if (value !== void 0) values.push(value);
   }
   return values;
@@ -34178,10 +34178,10 @@ Examples:
           });
           process.exit(1);
         }
-        const days = raw.days === void 0 ? void 0 : Number(raw.days);
+        const days2 = raw.days === void 0 ? void 0 : Number(raw.days);
         const response = await apiPost("/api/analytics/tracking", {
           ...platform ? { platform } : {},
-          ...days !== void 0 && Number.isFinite(days) ? { days } : {}
+          ...days2 !== void 0 && Number.isFinite(days2) ? { days: days2 } : {}
         });
         writeJsonEnvelope(response);
       } catch (err) {
@@ -34412,12 +34412,12 @@ Examples:
     args: args5,
     run: async ({ args: raw }) => {
       try {
-        const limit = raw.limit === void 0 ? void 0 : Number(raw.limit);
+        const limit2 = raw.limit === void 0 ? void 0 : Number(raw.limit);
         const response = await apiPost("/api/analytics/arrivals", {
           ...raw.mode ? { mode: String(raw.mode) } : {},
           ...raw.outcome ? { outcome: String(raw.outcome) } : {},
           ...raw.event ? { eventName: String(raw.event) } : {},
-          ...limit !== void 0 && Number.isFinite(limit) ? { limit } : {},
+          ...limit2 !== void 0 && Number.isFinite(limit2) ? { limit: limit2 } : {},
           ...raw.full ? { full: true } : {}
         });
         writeJsonEnvelope(response);
@@ -34869,8 +34869,8 @@ function parseGuardrails(value) {
 }
 function buildProfilePatch(args5) {
   const patch = {};
-  for (const [flag2, field] of TEXT_FIELDS) {
-    const value = args5[flag2];
+  for (const [flag3, field] of TEXT_FIELDS) {
+    const value = args5[flag3];
     if (typeof value === "string") {
       Object.assign(patch, { [field]: value.trim() });
     }
@@ -35726,7 +35726,7 @@ function undisambiguatedSubsets(faces) {
   if (new Set(faces.map((face) => face.subset)).size < 2) return [];
   return [...new Set(faces.filter((face) => !face.unicodeRange).map((face) => face.subset))];
 }
-function suggestFamilies(wanted, catalogue, limit = 5) {
+function suggestFamilies(wanted, catalogue, limit2 = 5) {
   const key = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
   const target2 = key(wanted);
   if (!target2) return [];
@@ -35739,7 +35739,7 @@ function suggestFamilies(wanted, catalogue, limit = 5) {
     const shared = words2.filter((w) => w.length > 2 && candidate.includes(w)).length;
     return { family, score: shared > 0 ? 3 + (words2.length - shared) : Number.POSITIVE_INFINITY };
   }).filter((c) => Number.isFinite(c.score)).sort((a, b) => a.score - b.score || a.family.localeCompare(b.family));
-  return scored.slice(0, limit).map((c) => c.family);
+  return scored.slice(0, limit2).map((c) => c.family);
 }
 function asFontsourceMeta(body) {
   if (typeof body !== "object" || body === null) return null;
@@ -35876,16 +35876,16 @@ function googleFontRequests(css) {
   }
   return out;
 }
-function resolveFetchWeights(flag2, declared) {
-  if (flag2) {
-    return String(flag2).split(",").map((w) => Number(w.trim())).filter((w) => Number.isInteger(w) && w >= 100 && w <= 900);
+function resolveFetchWeights(flag3, declared) {
+  if (flag3) {
+    return String(flag3).split(",").map((w) => Number(w.trim())).filter((w) => Number.isInteger(w) && w >= 100 && w <= 900);
   }
   return declared?.length ? declared : [400];
 }
 var DEFAULT_SUBSETS = ["latin"];
-function resolveFetchSubsets(flag2, selfHosted) {
-  const asked = String(flag2 ?? "").split(",").map((subset) => subset.trim()).filter(Boolean);
-  const named = flag2 ? [...new Set(asked)] : selfHosted;
+function resolveFetchSubsets(flag3, selfHosted) {
+  const asked = String(flag3 ?? "").split(",").map((subset) => subset.trim()).filter(Boolean);
+  const named = flag3 ? [...new Set(asked)] : selfHosted;
   return named.length > 0 ? named : [...DEFAULT_SUBSETS];
 }
 function resolveFetchStyles(italic, selfHosted) {
@@ -41631,11 +41631,11 @@ function classifyAudio(volumedetect, hasAudioStream) {
 }
 var RENDER_REVIEW_UNAVAILABLE = "The render was NOT reviewed \u2014 no model gateway key in this environment. Watch it yourself before sending it on.";
 var REVIEW_CONCURRENCY = 3;
-async function mapWithLimit(items, limit, fn) {
+async function mapWithLimit(items, limit2, fn) {
   const out = new Array(items.length);
   let next = 0;
   await Promise.all(
-    Array.from({ length: Math.min(limit, items.length) }, async () => {
+    Array.from({ length: Math.min(limit2, items.length) }, async () => {
       for (let i = next++; i < items.length; i = next++) {
         out[i] = await fn(items[i]);
       }
@@ -42958,8 +42958,8 @@ async function resolveCastAvatar(handle) {
     };
   }
 }
-async function resolveCastAvatars(flag2) {
-  const handles = String(flag2 ?? "").split(",").map((h) => h.trim()).filter(Boolean);
+async function resolveCastAvatars(flag3) {
+  const handles = String(flag3 ?? "").split(",").map((h) => h.trim()).filter(Boolean);
   const avatars = [];
   for (const handle of handles) {
     const resolved = await resolveCastAvatar(handle);
@@ -43072,7 +43072,7 @@ function fail3(code, message) {
   process.exit(2);
 }
 function resolveModels(args5) {
-  const pick = (flag2, kind, fallback) => args5[flag2] ? String(args5[flag2]) : resolveModel(kind, fallback);
+  const pick = (flag3, kind, fallback) => args5[flag3] ? String(args5[flag3]) : resolveModel(kind, fallback);
   return {
     describeModel: pick("describe-model", "image_describe", "~google/gemini-pro-latest"),
     selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
@@ -43090,13 +43090,13 @@ var PLATFORM_PLACEMENTS = {
   other: void 0
 };
 function resolvePlacements(placementsFlag, definitionPlatform) {
-  const flag2 = placementsFlag?.trim();
-  if (flag2 === void 0 || flag2 === "") return { ok: true, placements: PLATFORM_PLACEMENTS[definitionPlatform] };
-  if (flag2 === "none") return { ok: true, placements: void 0 };
-  if (AD_FORMAT_PLATFORMS.includes(flag2)) return { ok: true, placements: flag2 };
+  const flag3 = placementsFlag?.trim();
+  if (flag3 === void 0 || flag3 === "") return { ok: true, placements: PLATFORM_PLACEMENTS[definitionPlatform] };
+  if (flag3 === "none") return { ok: true, placements: void 0 };
+  if (AD_FORMAT_PLATFORMS.includes(flag3)) return { ok: true, placements: flag3 };
   return {
     ok: false,
-    message: `--placements "${flag2}" is not a valid placement set. Use one of: ${AD_FORMAT_PLATFORMS.join(", ")}, or "none" for a single base ad.`
+    message: `--placements "${flag3}" is not a valid placement set. Use one of: ${AD_FORMAT_PLATFORMS.join(", ")}, or "none" for a single base ad.`
   };
 }
 function regionCount(layout) {
@@ -45111,7 +45111,7 @@ function parseBudget(raw) {
   throw new Error(`--budget must be one of ${VIDEO_BUDGETS.join(", ")} (got "${v}")`);
 }
 function resolveModels2(args5) {
-  const pick = (flag2, kind, fallback) => args5[flag2] ? String(args5[flag2]) : resolveModel2(kind, fallback);
+  const pick = (flag3, kind, fallback) => args5[flag3] ? String(args5[flag3]) : resolveModel2(kind, fallback);
   return {
     // Flash by default: ~2-3× faster per call than Pro, which keeps each
     // per-scene deconstruct step well inside the action time budget and turns a
@@ -45886,9 +45886,9 @@ var listCommand13 = defineCommand121({
         }
         body.status = args5.status;
       }
-      const limit = parseBoundedInt(args5.limit, "limit", 1, 100);
-      if (limit !== void 0) {
-        body.limit = limit;
+      const limit2 = parseBoundedInt(args5.limit, "limit", 1, 100);
+      if (limit2 !== void 0) {
+        body.limit = limit2;
       }
       if (args5.full) {
         body.full = true;
@@ -45985,9 +45985,9 @@ var transcriptCommand = defineCommand121({
   run: async ({ args: args5 }) => {
     try {
       const body = { chatId: args5.id };
-      const limit = parseBoundedInt(args5.limit, "limit", 1, 1e3);
-      if (limit !== void 0) {
-        body.limit = limit;
+      const limit2 = parseBoundedInt(args5.limit, "limit", 1, 1e3);
+      if (limit2 !== void 0) {
+        body.limit = limit2;
       }
       if (args5.full) {
         body.full = true;
@@ -46786,12 +46786,12 @@ function count(value, unit) {
   return `about ${value} ${unit}${value === 1 ? "" : "s"}`;
 }
 function describeWait(earliestDecisionAt, now) {
-  const days = (earliestDecisionAt - now) / DAY_MS5;
-  if (days <= 0) return "any moment now";
-  if (days < 1) return "within a day";
-  if (days < 14) return count(Math.round(days), "day");
-  if (days < 60) return count(Math.round(days / 7), "week");
-  return count(Math.round(days / 30), "month");
+  const days2 = (earliestDecisionAt - now) / DAY_MS5;
+  if (days2 <= 0) return "any moment now";
+  if (days2 < 1) return "within a day";
+  if (days2 < 14) return count(Math.round(days2), "day");
+  if (days2 < 60) return count(Math.round(days2 / 7), "week");
+  return count(Math.round(days2 / 30), "month");
 }
 function roughCount(count2) {
   if (count2 < 10) return `about ${Math.max(1, Math.round(count2)).toLocaleString("en-US")}`;
@@ -47933,12 +47933,12 @@ var historyCommand = defineCommand124({
     limit: { type: "string", description: "At most this many, newest first", required: false }
   },
   run: async ({ args: args5 }) => {
-    const limit = args5.limit === void 0 ? void 0 : Number(args5.limit);
-    if (limit !== void 0 && !(Number.isInteger(limit) && limit > 0)) fail5("`--limit` is a whole number above zero");
+    const limit2 = args5.limit === void 0 ? void 0 : Number(args5.limit);
+    if (limit2 !== void 0 && !(Number.isInteger(limit2) && limit2 > 0)) fail5("`--limit` is a whole number above zero");
     try {
       const response = await apiPost("/api/experiments/history", {
         ...args5.landing ? { landingSlug: String(args5.landing) } : {},
-        ...limit === void 0 ? {} : { limit }
+        ...limit2 === void 0 ? {} : { limit: limit2 }
       });
       writeJsonEnvelope({
         ok: true,
@@ -50419,8 +50419,8 @@ function parseFunnelArgs(raw) {
       "Give one of --steps, --step, --remove-step, --preset, --add-trigger or --remove-trigger, not two."
     );
   }
-  const days = raw.days === void 0 ? void 0 : Number(raw.days);
-  if (days !== void 0 && (!Number.isInteger(days) || days <= 0 || days > 400)) {
+  const days2 = raw.days === void 0 ? void 0 : Number(raw.days);
+  if (days2 !== void 0 && (!Number.isInteger(days2) || days2 <= 0 || days2 > 400)) {
     throw new FunnelArgsError("--days must be a whole number of days, from 1 to 400.");
   }
   return {
@@ -50432,7 +50432,7 @@ function parseFunnelArgs(raw) {
     ...removeTrigger === void 0 ? {} : { removeTrigger },
     templates: raw.templates === true,
     moments: raw.moments === true,
-    ...days === void 0 ? {} : { days }
+    ...days2 === void 0 ? {} : { days: days2 }
   };
 }
 function funnelWrite(args5) {
@@ -50552,19 +50552,19 @@ function parsePreset(raw) {
   }
   return raw;
 }
-function parseWayIn(stepKey, eventKey, flag2) {
+function parseWayIn(stepKey, eventKey, flag3) {
   if (stepKey === void 0) return void 0;
   if (typeof stepKey !== "string" || stepKey.trim() === "") {
-    throw new FunnelArgsError(`${flag2} takes the key of the step to change: \`${flag2} lead\`.`);
+    throw new FunnelArgsError(`${flag3} takes the key of the step to change: \`${flag3} lead\`.`);
   }
   if (typeof eventKey !== "string" || eventKey.trim() === "") {
-    throw new FunnelArgsError(`${flag2} needs --event, naming what gets somebody there.`, {
+    throw new FunnelArgsError(`${flag3} needs --event, naming what gets somebody there.`, {
       action: "read_the_moments",
-      explanation: `Run \`baker funnel --moments\` and copy an \`events[].eventKey\` \u2014 a Form's own outcome is listed there at zero before anybody has filled it in. Then: \`${flag2} ${stepKey.trim()} --event "<key>"\`.`
+      explanation: `Run \`baker funnel --moments\` and copy an \`events[].eventKey\` \u2014 a Form's own outcome is listed there at zero before anybody has filled it in. Then: \`${flag3} ${stepKey.trim()} --event "<key>"\`.`
     });
   }
   const key = eventKey.trim();
-  if (flag2 === "--add-trigger" && parseEventKey(key) === null) {
+  if (flag3 === "--add-trigger" && parseEventKey(key) === null) {
     throw new FunnelArgsError(`"${key}" is not an event key, so nothing would ever reach that step through it.`, {
       action: "read_the_moments",
       explanation: "Run `baker funnel --moments` and copy an `events[].eventKey`. They look like form:<form>:<step>:<trigger>, submit:<form>, page:<name> or view:<landing>."
@@ -50830,29 +50830,29 @@ function requireTarget5(args5, entity) {
   }
   return target2;
 }
-function readJsonSource(args5, flag2) {
-  const inline = args5[flag2];
+function readJsonSource(args5, flag3) {
+  const inline = args5[flag3];
   const file = args5.file;
   const raw = typeof file === "string" && file.length > 0 ? readFileSync17(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
   if (raw === void 0) {
-    failValidation3(`pass --${flag2} with inline JSON or --file with a path to a JSON file`);
+    failValidation3(`pass --${flag3} with inline JSON or --file with a path to a JSON file`);
   }
   try {
     return JSON.parse(raw);
   } catch {
-    return failValidation3(`--${flag2} is not valid JSON`);
+    return failValidation3(`--${flag3} is not valid JSON`);
   }
 }
-function asObject(value, flag2, index) {
+function asObject(value, flag3, index) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     failValidation3(
-      index === void 0 ? `--${flag2} must be a JSON object` : `--${flag2}[${index}] must be a JSON object`
+      index === void 0 ? `--${flag3} must be a JSON object` : `--${flag3}[${index}] must be a JSON object`
     );
   }
   return value;
 }
-function loadJsonArg(args5, flag2 = "json") {
-  return asObject(readJsonSource(args5, flag2), flag2);
+function loadJsonArg(args5, flag3 = "json") {
+  return asObject(readJsonSource(args5, flag3), flag3);
 }
 function loadJsonPayloads(args5) {
   const parsed = readJsonSource(args5, "json");
@@ -51702,18 +51702,18 @@ var RETENTION_BY_MONTHS = {
   "38": "THIRTY_EIGHT_MONTHS",
   "50": "FIFTY_MONTHS"
 };
-function retentionValue(input, flag2) {
+function retentionValue(input, flag3) {
   const normalized = input.trim();
   const mapped = RETENTION_BY_MONTHS[normalized] ?? (Object.values(RETENTION_BY_MONTHS).includes(normalized.toUpperCase()) ? normalized.toUpperCase() : void 0);
   if (!mapped) {
-    failValidation3(`--${flag2} must be one of 2, 14, 26, 38 or 50 (months)`);
+    failValidation3(`--${flag3} must be one of 2, 14, 26, 38 or 50 (months)`);
   }
   return mapped;
 }
-function booleanArg(input, flag2) {
+function booleanArg(input, flag3) {
   if (input === "true") return true;
   if (input === "false") return false;
-  return failValidation3(`--${flag2} must be true or false`);
+  return failValidation3(`--${flag3} must be true or false`);
 }
 var dataRetentionCommand = defineCommand136({
   meta: {
@@ -52049,10 +52049,10 @@ Examples:
       },
       run: async ({ args: args5 }) => {
         const payload = {};
-        for (const [flag2, field] of Object.entries(MEASUREMENT_FLAGS)) {
-          const value = args5[flag2];
+        for (const [flag3, field] of Object.entries(MEASUREMENT_FLAGS)) {
+          const value = args5[flag3];
           if (typeof value === "string") {
-            payload[field] = booleanArg(value, flag2);
+            payload[field] = booleanArg(value, flag3);
           }
         }
         if (typeof args5["search-parameters"] === "string" && args5["search-parameters"].length > 0) {
@@ -52624,13 +52624,13 @@ var listCommand15 = defineCommand142({
   run: async ({ args: args5 }) => {
     try {
       const body = {};
-      const limit = parseBoundedInt2(args5.limit, "limit", 1, 200);
-      if (limit !== void 0) {
-        body.limit = limit;
+      const limit2 = parseBoundedInt2(args5.limit, "limit", 1, 200);
+      if (limit2 !== void 0) {
+        body.limit = limit2;
       }
-      const days = parseBoundedInt2(args5.days, "days", 1, 365);
-      if (days !== void 0) {
-        body.days = days;
+      const days2 = parseBoundedInt2(args5.days, "days", 1, 365);
+      if (days2 !== void 0) {
+        body.days = days2;
       }
       if (args5.category) {
         if (!CATEGORIES.includes(args5.category)) {
@@ -53015,20 +53015,20 @@ var formsSubmissionsCommand = defineCommand143({
   },
   run: async ({ args: args5 }) => {
     try {
-      const days = args5.days === void 0 ? 30 : Number(args5.days);
-      if (!Number.isInteger(days) || days < 1 || days > 365) {
+      const days2 = args5.days === void 0 ? 30 : Number(args5.days);
+      if (!Number.isInteger(days2) || days2 < 1 || days2 > 365) {
         throw new ApiError("VALIDATION_ERROR", "--days must be a whole number between 1 and 365.");
       }
       const response = await apiPost("/api/hubspot/forms/submissions", {
         formId: args5.formId,
-        days,
+        days: days2,
         ...args5.full ? { full: true } : {}
       });
       const { inWindow, total, truncated, lastSubmittedAt } = response.data;
       const hints2 = [];
       if (inWindow === 0) {
         hints2.push(
-          total === 0 ? "This form has received nothing at all \u2014 check it is the form actually embedded on the page before concluding the campaign is at fault." : `No leads in the last ${days} days, though the form has ${total} older submission(s). It worked once and has gone quiet.`
+          total === 0 ? "This form has received nothing at all \u2014 check it is the form actually embedded on the page before concluding the campaign is at fault." : `No leads in the last ${days2} days, though the form has ${total} older submission(s). It worked once and has gone quiet.`
         );
       }
       if (truncated) {
@@ -53215,15 +53215,15 @@ var contactsSummaryCommand = defineCommand143({
   },
   run: async ({ args: args5 }) => {
     try {
-      const days = args5.days === void 0 ? 30 : Number(args5.days);
-      if (!Number.isInteger(days) || days < 1 || days > 365) {
+      const days2 = args5.days === void 0 ? 30 : Number(args5.days);
+      if (!Number.isInteger(days2) || days2 < 1 || days2 > 365) {
         throw new ApiError("VALIDATION_ERROR", "--days must be a whole number between 1 and 365.");
       }
-      const response = await apiPost("/api/hubspot/contacts/summary", { days });
+      const response = await apiPost("/api/hubspot/contacts/summary", { days: days2 });
       const { total, withOwner, withoutOwner, byStage, truncated } = response.data;
       const hints2 = [];
       if (total === 0) {
-        hints2.push(`No contacts were created in the last ${days} days \u2014 nothing reached the CRM in that window.`);
+        hints2.push(`No contacts were created in the last ${days2} days \u2014 nothing reached the CRM in that window.`);
       } else if (withOwner === 0) {
         hints2.push(
           `None of these ${total} contacts has anyone assigned. That is the strongest available signal that the leads are arriving and nobody is picking them up \u2014 worth raising with the user.`
@@ -54308,7 +54308,7 @@ function emptyResultHints({ provider, hitCount, activeFilters, subject }) {
   return hints2;
 }
 function activeFilterFlags(args5, candidates) {
-  return candidates.filter((flag2) => args5[flag2] !== void 0 && args5[flag2] !== "").map((flag2) => `--${flag2}`);
+  return candidates.filter((flag3) => args5[flag3] !== void 0 && args5[flag3] !== "").map((flag3) => `--${flag3}`);
 }
 
 // src/commands/images/find.ts
@@ -58661,8 +58661,8 @@ var favoritesCommand = defineCommand174({
       const params2 = {};
       const types = splitList2(args5.type);
       if (types) params2.type = types.join(",");
-      const limit = parseNumber(args5.limit);
-      if (limit !== void 0) params2.limit = String(limit);
+      const limit2 = parseNumber(args5.limit);
+      if (limit2 !== void 0) params2.limit = String(limit2);
       const data = await apiGet("/api/landing-inspiration/favorites", params2);
       const sections = Array.isArray(data?.sections) ? data.sections : [];
       const full = args5.full;
@@ -60147,8 +60147,8 @@ var inPageSegment = (options) => {
   };
   const leaves = [];
   const all = document.querySelectorAll("*");
-  const limit = Math.min(all.length, options.maxElements);
-  for (let i = 0; i < limit; i++) {
+  const limit2 = Math.min(all.length, options.maxElements);
+  for (let i = 0; i < limit2; i++) {
     const element = all[i];
     if (!element) continue;
     const tag = element.tagName.toLowerCase();
@@ -61233,8 +61233,8 @@ function buildSearchBody(args5) {
   if (minCraft !== void 0) body.minCraftScore = minCraft;
   const minFidelity = parseNumber(args5["min-fidelity"]);
   if (minFidelity !== void 0) body.minFidelity = minFidelity;
-  const limit = parseNumber(args5.limit);
-  body.limit = limit ?? 8;
+  const limit2 = parseNumber(args5.limit);
+  body.limit = limit2 ?? 8;
   body.scope = args5.scope === "all" ? "all" : "favorites";
   return body;
 }
@@ -61381,8 +61381,8 @@ function buildSequencesBody(args5) {
   const sectionType = splitList2(args5["section-type"]);
   if (sectionType) body.sectionType = sectionType;
   body.scope = args5.scope === "all" ? "all" : "favorites";
-  const limit = parseNumber(args5.limit);
-  if (limit !== void 0) body.limit = limit;
+  const limit2 = parseNumber(args5.limit);
+  if (limit2 !== void 0) body.limit = limit2;
   else if (args5.full) body.limit = MAX_PAGES;
   return body;
 }
@@ -62439,7 +62439,7 @@ Examples:
     const keyword = args5.keyword;
     const location2 = args5.location || void 0;
     const language = args5.language || void 0;
-    const limit = args5.limit ? Number(args5.limit) : void 0;
+    const limit2 = args5.limit ? Number(args5.limit) : void 0;
     const skipCache = args5["no-cache"] ? true : void 0;
     const queryContext = buildResearchQueryContext(location2, language);
     try {
@@ -62447,7 +62447,7 @@ Examples:
         keyword,
         location: location2,
         language,
-        limit,
+        limit: limit2,
         skipCache
       });
       warnDefaults(queryContext);
@@ -62517,7 +62517,7 @@ Examples:
     const keyword = args5.keyword;
     const location2 = args5.location || void 0;
     const language = args5.language || void 0;
-    const limit = args5.limit ? Number(args5.limit) : void 0;
+    const limit2 = args5.limit ? Number(args5.limit) : void 0;
     const skipCache = args5["no-cache"] ? true : void 0;
     const queryContext = buildResearchQueryContext(location2, language);
     try {
@@ -62525,7 +62525,7 @@ Examples:
         keyword,
         location: location2,
         language,
-        limit,
+        limit: limit2,
         skipCache
       });
       warnDefaults(queryContext);
@@ -62896,7 +62896,7 @@ Examples:
     const location2 = args5.location || void 0;
     const language = args5.language || void 0;
     const type = args5.type || void 0;
-    const limit = args5.limit ? Number(args5.limit) : void 0;
+    const limit2 = args5.limit ? Number(args5.limit) : void 0;
     const offset = args5.offset ? Number(args5.offset) : void 0;
     const skipCache = args5["no-cache"] ? true : void 0;
     const queryContext = buildResearchQueryContext(location2, language);
@@ -62907,12 +62907,12 @@ Examples:
         location: location2,
         language,
         type,
-        limit,
+        limit: limit2,
         offset,
         skipCache
       });
       const currentOffset = offset ?? 0;
-      const currentLimit = limit ?? 50;
+      const currentLimit = limit2 ?? 50;
       const hasMore = currentOffset + result.data.length < result.total_count;
       warnDefaults(queryContext);
       const format = args5.output || "json";
@@ -63165,7 +63165,7 @@ Examples:
     const language = args5.language || void 0;
     const sort = args5.sort || void 0;
     const type = args5.type || void 0;
-    const limit = args5.limit ? Number(args5.limit) : void 0;
+    const limit2 = args5.limit ? Number(args5.limit) : void 0;
     const skipCache = args5["no-cache"] ? true : void 0;
     const queryContext = buildResearchQueryContext(location2, language);
     try {
@@ -63175,7 +63175,7 @@ Examples:
         language,
         sort,
         type,
-        limit,
+        limit: limit2,
         skipCache
       });
       warnDefaults(queryContext);
@@ -63346,7 +63346,7 @@ Examples:
     const target2 = args5.target;
     const location2 = args5.location || void 0;
     const language = args5.language || void 0;
-    const limit = args5.limit ? Number(args5.limit) : void 0;
+    const limit2 = args5.limit ? Number(args5.limit) : void 0;
     const skipCache = args5["no-cache"] ? true : void 0;
     const queryContext = buildResearchQueryContext(location2, language);
     try {
@@ -63354,7 +63354,7 @@ Examples:
         target: target2,
         location: location2,
         language,
-        limit,
+        limit: limit2,
         skipCache
       });
       warnDefaults(queryContext);
@@ -63700,13 +63700,13 @@ function refuseMisusedKinds(kind, args5) {
 function refuseStrayFlags(kind, args5) {
   const allowed = new Set(TRIGGER_TARGETS[kind].map((target2) => TRIGGER_TARGET_FIELDS[target2.field].flag));
   const stray = TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag).filter(
-    (flag2) => !allowed.has(flag2) && flagText(args5, flag2) !== void 0 && !(kind === "experiment.started" && flag2 === "experiment")
+    (flag3) => !allowed.has(flag3) && flagText(args5, flag3) !== void 0 && !(kind === "experiment.started" && flag3 === "experiment")
   );
   if (stray.length === 0) {
     return;
   }
   failValidation4(
-    `${stray.map((flag2) => `--${flag2}`).join(", ")} does not narrow ${kind}. ${allowed.size > 0 ? `It can be pointed with ${[...allowed].map((flag2) => `--${flag2}`).join(", ")}.` : "It runs every time it happens \u2014 narrow it with --when rules over its payload instead."}`
+    `${stray.map((flag3) => `--${flag3}`).join(", ")} does not narrow ${kind}. ${allowed.size > 0 ? `It can be pointed with ${[...allowed].map((flag3) => `--${flag3}`).join(", ")}.` : "It runs every time it happens \u2014 narrow it with --when rules over its payload instead."}`
   );
 }
 var NARROWING_FLAGS = [...TRIGGER_TARGET_FIELD_IDS.map((field) => TRIGGER_TARGET_FIELDS[field].flag), "config"];
@@ -63714,11 +63714,11 @@ function refuseNarrowingWithoutKind(args5, kind, given) {
   if (kind) {
     return;
   }
-  const stray = NARROWING_FLAGS.filter((flag2) => flagText(args5, flag2) !== void 0);
+  const stray = NARROWING_FLAGS.filter((flag3) => flagText(args5, flag3) !== void 0);
   if (stray.length === 0) {
     return;
   }
-  const flags = stray.map((flag2) => `--${flag2}`).join(", ");
+  const flags = stray.map((flag3) => `--${flag3}`).join(", ");
   failValidation4(
     given > 0 ? `${flags} does not narrow --cron or --run-at: a time trigger runs every time it comes round. Use --trigger <kind> with ${flags} instead, or leave ${flags} off.` : `${flags} narrows a trigger, and no trigger was given. Pass --trigger <kind> too \u2014 the item's whole trigger, with ${flags} \u2014 or leave ${flags} off.`
   );
@@ -63809,13 +63809,13 @@ var REACTION_ARGS = {
     required: false
   }
 };
-function wholeNumber(raw, flag2, { min }) {
+function wholeNumber(raw, flag3, { min }) {
   if (raw === void 0) {
     return void 0;
   }
   const value = Number(raw);
   if (!Number.isInteger(value) || value < min) {
-    failValidation4(`${flag2} must be a whole number of at least ${min}.`);
+    failValidation4(`${flag3} must be a whole number of at least ${min}.`);
   }
   return value;
 }
@@ -64285,31 +64285,31 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
     delete: { type: "string", description: "Remove one of this company's own, by id", required: false }
   },
   run: async ({ args: args5 }) => {
-    const flag2 = (key) => {
+    const flag3 = (key) => {
       const value = args5[key];
       return typeof value === "string" ? value.trim() : "";
     };
     try {
-      const save = flag2("save");
-      const publish = flag2("publish");
-      const remove = flag2("delete");
+      const save = flag3("save");
+      const publish = flag3("publish");
+      const remove = flag3("delete");
       if ([save, publish, remove].filter((id) => id.length > 0).length > 1) {
         failValidation4("Pass one of --save, --publish or --delete at a time.");
       }
       if (save.length > 0) {
-        const briefFile = flag2("brief-file");
-        const brief2 = briefFile.length > 0 ? await readFile32(path46.resolve(briefFile), "utf8") : flag2("brief");
+        const briefFile = flag3("brief-file");
+        const brief2 = briefFile.length > 0 ? await readFile32(path46.resolve(briefFile), "utf8") : flag3("brief");
         if (brief2.trim().length === 0) {
           failValidation4("--brief-file (preferred) or --brief is required: the brief is the recipe.");
         }
         const response2 = await apiPost("/api/marketplace/save", {
           chatId: requireChatId(),
           slug: save,
-          name: flag2("name"),
-          category: flag2("recipe-category"),
-          tagline: flag2("tagline"),
+          name: flag3("name"),
+          category: flag3("recipe-category"),
+          tagline: flag3("tagline"),
           prompt: brief2,
-          frequency: flag2("frequency")
+          frequency: flag3("frequency")
         });
         writeJson(response2);
         return;
@@ -64330,7 +64330,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
         writeJson(response2);
         return;
       }
-      const category = flag2("category");
+      const category = flag3("category");
       const response = await apiPost("/api/marketplace/list", {
         ...category.length > 0 ? { category } : {},
         ...args5.drafts === true ? { drafts: true } : {}
@@ -64622,6 +64622,165 @@ var schemaCommand2 = defineCommand208({
   }
 });
 
+// src/commands/shopify/index.ts
+import { defineCommand as defineCommand210 } from "citty";
+
+// src/commands/shopify/buyers.ts
+import { defineCommand as defineCommand209 } from "citty";
+
+// src/commands/shopify/buyerHints.ts
+var AUDIENCE_PATH = "To reach more people like your buyers on Meta, stage an audience of the store's purchasers (`baker ads meta audiences create --subtype WEBSITE`) and a lookalike of it (`--subtype LOOKALIKE`). Baker cannot upload a list of buyers to an ad platform.";
+var MIN_ORDERS_TO_SCALE = 5;
+function storeFactsHint(currency) {
+  return `These are the store's own orders: build the answer on them and quote their numbers${currency ? ` in ${currency}` : ""}. If Knowledge describes other products or markets, say the two disagree and ask which is current \u2014 never drop these numbers for it.`;
+}
+var percent2 = (value) => `${Math.round(value * 100)}%`;
+function buyerHistoryHints(history, basis) {
+  const hints2 = [];
+  if (history.state === "importing") {
+    hints2.push(
+      `Baker is still bringing in this store's past orders (${history.orders} so far): older periods, repeat buyers and cohorts are incomplete \u2014 say so rather than reporting a drop.`
+    );
+  }
+  if (history.state === "failed") {
+    hints2.push("Baker couldn't finish bringing in this store's past orders; older periods may be incomplete.");
+  }
+  if (basis === "last_60_days") {
+    hints2.push(
+      "Shopify gives Baker this store's last 60 days of orders only: older behaviour is not here, and a buyer whose earlier orders are older counts as new."
+    );
+  }
+  return hints2;
+}
+function countriesHints(answer) {
+  const hints2 = buyerHistoryHints(answer.history, answer.basis);
+  if (answer.total.orders === 0) {
+    hints2.push("No orders were placed in this period.");
+    return hints2;
+  }
+  hints2.push(storeFactsHint(answer.currency));
+  const money = (amount) => `${answer.currency ?? ""} ${amount}`.trim();
+  const growing = answer.rows.filter((row) => row.orders >= MIN_ORDERS_TO_SCALE && (row.ordersGrowth ?? 0) > 0).sort((a, b) => (b.ordersGrowth ?? 0) - (a.ordersGrowth ?? 0))[0];
+  if (growing && answer.level === "country") {
+    hints2.push(
+      `Scale ${growing.name}: its orders grew ${percent2(growing.ordersGrowth ?? 0)} against the period before (${growing.orders} orders, ${money(growing.net)}). Check which campaigns already target it (\`baker ads meta campaigns\`, \`baker ads google query --preset campaign-performance\`) before staging a change.`
+    );
+  }
+  const average = answer.total.averageOrder;
+  const promising = answer.rows.filter((row) => row.orders < MIN_ORDERS_TO_SCALE && average > 0 && row.averageOrder >= 1.5 * average).sort((a, b) => b.averageOrder - a.averageOrder)[0];
+  if (promising && answer.level === "country") {
+    hints2.push(
+      `Test ${promising.name}: its average order is ${money(promising.averageOrder)}, ${(promising.averageOrder / average).toFixed(1)}\xD7 the store's, from only ${promising.orders} orders \u2014 a small budget there would show whether it scales.`
+    );
+  }
+  if (answer.unknown && answer.total.orders > 0 && answer.unknown.orders / answer.total.orders > 0.25) {
+    const lack = answer.level === "country" ? "have no address Baker could read (Unknown)" : `name no ${answer.level} on their address (${answer.unknown.name})`;
+    hints2.push(
+      `${answer.unknown.orders} of these orders ${lack}: say so rather than leaving them out of a place's share.`
+    );
+  }
+  return hints2;
+}
+function bestSellersHints(answer) {
+  const hints2 = buyerHistoryHints(answer.history, answer.basis);
+  const leader = answer.repeat?.[0];
+  if (leader && leader.buyersAgain > 0) {
+    hints2.push(
+      `Lead a landing with "${leader.title}" (find it with \`baker shopify products --search\`): ${percent2(leader.share)} of the buyers whose first order held it came back.`
+    );
+  }
+  const top = answer.products?.[0];
+  if (top && top.units > 0) {
+    hints2.push(
+      `"${top.title}" is the best seller (${top.units} units). For which first buys bring buyers back, run \`baker shopify best-sellers --view repeat\`; for what is losing steam, \`--view momentum\`.`
+    );
+  }
+  const losing = answer.momentum?.[0];
+  if (losing) {
+    hints2.push(
+      `"${losing.title}" sold ${losing.units} against ${losing.previousUnits} the period before: check its stock (\`baker shopify stock\`) and the ads that promote it before cutting it.`
+    );
+  }
+  const sellers = answer.products ?? answer.variants ?? [];
+  if (sellers.some((row) => row.units > 0)) hints2.push(storeFactsHint(answer.currency));
+  const withRefunds = sellers.filter((row) => row.refundedUnits > 0).sort((a, b) => b.refundRate - a.refundRate).slice(0, 5);
+  if (withRefunds.length > 0) {
+    const money = (amount) => `${answer.currency ?? ""} ${amount}`.trim();
+    hints2.push(
+      `Refunds: ${withRefunds.map((row) => `"${row.title}" ${percent2(row.refundRate)} of units (${money(row.refunded)})`).join(", ")}. Only a product not named here had no refunds in the period.`
+    );
+  }
+  const refunded = answer.products?.find((row) => row.units >= 5 && row.refundRate >= 0.2);
+  if (refunded) {
+    hints2.push(
+      `"${refunded.title}" comes back often (${percent2(refunded.refundRate)} of units refunded): don't lead a campaign with it before finding out why.`
+    );
+  }
+  return hints2;
+}
+function bestBuyersHint(best) {
+  if (!best || best.buyers === 0) return [];
+  const countries = best.topCountries.map((country) => country.name).join(", ");
+  const products = best.topFirstProducts.map((product) => `"${product.title}"`).join(", ");
+  if (!countries && !products) return [];
+  return [
+    `Find more buyers like your best (${best.buyers}): ${countries ? `target ${countries}` : ""}${countries && products ? "; " : ""}${products ? `lead with ${products}, what their first orders held` : ""}.`
+  ];
+}
+function segmentsHints(answer) {
+  const hints2 = buyerHistoryHints(answer.history, answer.basis);
+  hints2.push(...bestBuyersHint(answer.segments.find((segment) => segment.segment === "best")));
+  const atRisk = answer.segments.find((segment) => segment.segment === "at_risk");
+  if (atRisk && atRisk.buyers > 0) {
+    hints2.push(
+      `${atRisk.buyers} repeat buyers have not ordered in ${Math.round(2 * answer.thresholds.gapDays)} days (At risk): a win-back offer to them is worth more than a new buyer of the same value.`
+    );
+  }
+  if (answer.buyers > 0) hints2.push(AUDIENCE_PATH);
+  return hints2;
+}
+function buyersHints(answer) {
+  const hints2 = buyerHistoryHints(answer.history, answer.basis);
+  if (answer.summary.orders === 0) {
+    hints2.push("No orders were placed in this period.");
+    return hints2;
+  }
+  hints2.push(storeFactsHint(answer.currency));
+  if (answer.acquisition?.by === "campaign" && answer.acquisition.rows.length > 0) {
+    hints2.push(
+      "Compare each campaign's lifetime value with what it cost for the same dates (`baker ads meta insights`, `baker ads google query --preset campaign-performance`): Baker keeps no ad spend."
+    );
+  }
+  if (!answer.acquisition) {
+    hints2.push(
+      "For lifetime value by the campaign or channel that brought each buyer, add `--by campaign` or `--by channel`."
+    );
+  }
+  if (answer.summary.guestOrders > 0 && answer.summary.guestOrders >= answer.summary.orders / 2) {
+    hints2.push(
+      `${answer.summary.guestOrders} of ${answer.summary.orders} orders were placed as guests: they count in sales, never as buyers, so repeat rates read low.`
+    );
+  }
+  if (answer.summary.buyers > 0) hints2.push(AUDIENCE_PATH);
+  return hints2;
+}
+function cohortsHints(answer) {
+  const hints2 = buyerHistoryHints(answer.history, answer.basis);
+  const reached = answer.cohorts.filter((cohort) => cohort.retention.m3 !== null && cohort.size >= 5);
+  if (reached.length >= 2) {
+    const best = [...reached].sort((a, b) => (b.retention.m3 ?? 0) - (a.retention.m3 ?? 0))[0];
+    if (best) {
+      hints2.push(
+        `Buyers who first ordered in ${best.month} came back best (${percent2(best.retention.m3 ?? 0)} ordered again in their third month): look at what was running then (\`baker shopify buyers --by campaign\`).`
+      );
+    }
+  }
+  return hints2;
+}
+
+// ../api/src/shopify/buyers.ts
+import { z as z51 } from "zod";
+
 // ../api/src/shopify/wire.ts
 import { z as z50 } from "zod";
 var SHOPIFY_NOT_CONNECTED_MESSAGE = "No Shopify store is connected for this company.";
@@ -64999,13 +65158,42 @@ var shopifyStockResponseSchema = z50.object({
   /** More products in that group than `limit`. */
   more: z50.object({ outOfStock: z50.boolean(), partlyOut: z50.boolean() })
 });
-var shopifySalesBySchema = z50.enum(["day", "product", "campaign", "landing"]);
+var shopifySalesBySchema = z50.enum([
+  "day",
+  "product",
+  "campaign",
+  "landing",
+  "weekday",
+  "hour",
+  "month",
+  "month_of_year"
+]);
+var SHOPIFY_SALES_TIMING_BY = ["weekday", "hour", "month", "month_of_year"];
 var SHOPIFY_SALES_MAX_DAYS = 395;
+var SHOPIFY_SALES_TIMING_MAX_DAYS = 3650;
 var shopifySalesRequestSchema = z50.object({
-  days: z50.coerce.number().int().min(1).max(SHOPIFY_SALES_MAX_DAYS).optional(),
+  days: z50.coerce.number().int().min(1).max(SHOPIFY_SALES_TIMING_MAX_DAYS).optional(),
+  /** Every order the store has (timing breakdowns only). */
+  all: flag.optional(),
   by: shopifySalesBySchema.optional(),
   limit: z50.coerce.number().int().min(1).max(100).optional(),
   full: flag.optional()
+}).superRefine((request, ctx) => {
+  if (SHOPIFY_SALES_TIMING_BY.includes(request.by ?? "day")) return;
+  if (request.all) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["all"],
+      message: "all is only for --by weekday, hour, month or month_of_year"
+    });
+  }
+  if ((request.days ?? 0) > SHOPIFY_SALES_MAX_DAYS) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["days"],
+      message: `by day, product, campaign or landing reads up to ${SHOPIFY_SALES_MAX_DAYS} days`
+    });
+  }
 });
 var shopifySalesCreditSchema = z50.enum([
   "campaign",
@@ -65028,6 +65216,8 @@ var shopifySalesRowSchema = z50.object({
   /** By product: units sold and given back. */
   units: z50.number().optional(),
   refundedUnits: z50.number().optional(),
+  /** By weekday, hour or month: the buyers who ordered. */
+  buyers: z50.number().optional(),
   // --full
   source: z50.string().optional(),
   medium: z50.string().optional(),
@@ -65048,7 +65238,13 @@ var shopifySalesTotalsSchema = z50.object({
 var shopifySalesReportingSchema = z50.enum(["shopify_channel", "baker", "undecided"]);
 var shopifySalesResponseSchema = z50.object({
   store: shopifyStoreStateSchema,
-  window: z50.object({ days: z50.number(), from: z50.string(), to: z50.string() }),
+  /** `days` is "all" with `all`; `timezone` names the store's time a timing breakdown was read in. */
+  window: z50.object({
+    days: z50.union([z50.number(), z50.literal("all")]),
+    from: z50.string(),
+    to: z50.string(),
+    timezone: z50.string().optional()
+  }),
   by: shopifySalesBySchema,
   /** The store's currency; null when nothing sold in the window. */
   currency: z50.string().nullable(),
@@ -65063,8 +65259,442 @@ var shopifySalesResponseSchema = z50.object({
   ordersUnreadable: z50.literal(true).optional()
 });
 
-// src/commands/shopify/index.ts
-import { defineCommand as defineCommand209 } from "citty";
+// ../api/src/shopify/buyers.ts
+var flag2 = z51.enum(["true", "false"]).transform((value) => value === "true");
+var SHOPIFY_STORE_WINDOW_MAX_DAYS = 3650;
+var days = z51.coerce.number().int().min(1).max(SHOPIFY_STORE_WINDOW_MAX_DAYS);
+var countryCode2 = z51.string().regex(/^[A-Za-z]{2}$/, "a two-letter country code, like DE").transform((value) => value.toUpperCase());
+var limit = z51.coerce.number().int().min(1).max(100);
+var windowRequest = {
+  days: days.optional(),
+  /** Every order the store has. */
+  all: flag2.optional(),
+  country: countryCode2.optional(),
+  full: flag2.optional()
+};
+var shopifyStoreWindowSchema = z51.object({
+  from: z51.string().nullable(),
+  to: z51.string(),
+  days: z51.union([z51.number(), z51.literal("all")]),
+  timezone: z51.string()
+});
+var shopifyBuyerHistorySchema = z51.object({
+  state: z51.enum(["importing", "done", "failed", "none"]),
+  reach: z51.enum(["all", "60_days"]).nullable(),
+  /** The day of the oldest order Baker holds (YYYY-MM-DD). */
+  from: z51.string().nullable(),
+  /** Orders brought in so far. */
+  orders: z51.number()
+});
+var shopifyBuyerBasisSchema = z51.enum(["all_orders", "last_60_days"]);
+var answerCommon = {
+  store: shopifyStoreStateSchema,
+  window: shopifyStoreWindowSchema,
+  /** The store's currency; null when it has no orders yet. */
+  currency: z51.string().nullable(),
+  /** Orders in another currency (the store changed currency), never added to these. */
+  otherCurrencies: z51.array(z51.object({ currency: z51.string(), orders: z51.number(), net: z51.number() })).optional(),
+  history: shopifyBuyerHistorySchema,
+  basis: shopifyBuyerBasisSchema
+};
+var shopifyPlaceSchema = z51.object({
+  country: z51.string(),
+  countryName: z51.string(),
+  region: z51.string(),
+  city: z51.string()
+});
+var shopifyBuyerSegmentSchema = z51.enum(["best", "loyal", "at_risk", "new", "one_time"]);
+var shopifySegmentThresholdsSchema = z51.object({
+  /** The store's typical days between a repeat buyer's orders (90 with too few to go on). */
+  gapDays: z51.number(),
+  /** The lifetime net that puts a buyer in the top fifth. */
+  netP80: z51.number()
+});
+var shopifySegmentRowSchema = z51.object({
+  segment: shopifyBuyerSegmentSchema,
+  label: z51.string(),
+  /** The rule in words, with this store's numbers. */
+  rule: z51.string(),
+  buyers: z51.number(),
+  /** Of every buyer, 0–1. */
+  share: z51.number(),
+  net: z51.number(),
+  averageOrders: z51.number(),
+  averageDaysSinceLastOrder: z51.number(),
+  topCountries: z51.array(z51.object({ code: z51.string(), name: z51.string(), buyers: z51.number() })),
+  /** The products their first orders held most often. */
+  topFirstProducts: z51.array(z51.object({ title: z51.string(), buyers: z51.number(), productId: z51.string().optional() }))
+});
+var shopifySegmentsRequestSchema = z51.object({ ...windowRequest });
+var shopifySegmentsResponseSchema = z51.object({
+  ...answerCommon,
+  thresholds: shopifySegmentThresholdsSchema,
+  buyers: z51.number(),
+  segments: z51.array(shopifySegmentRowSchema)
+});
+var shopifyBuyersSortSchema = z51.enum(["net", "orders", "recent", "first"]);
+var shopifyAcquisitionBySchema = z51.enum(["campaign", "channel"]);
+var shopifyBuyersRequestSchema = z51.object({
+  ...windowRequest,
+  segment: shopifyBuyerSegmentSchema.optional(),
+  /** Lifetime value by the campaign or channel of each buyer's first order. */
+  by: shopifyAcquisitionBySchema.optional(),
+  /** Only buyers whose first order came through this channel (a key from `by=channel`). */
+  channel: z51.string().max(200).optional(),
+  sort: shopifyBuyersSortSchema.optional(),
+  limit: limit.optional(),
+  offset: z51.coerce.number().int().min(0).max(1e5).optional()
+});
+var shopifyBuyersSummarySchema = z51.object({
+  /** Buyers who ordered in the period. */
+  buyers: z51.number(),
+  /** Of them, whose first order was in the period. */
+  newBuyers: z51.number(),
+  returningBuyers: z51.number(),
+  /** Orders with no customer: counted in money, never a buyer. */
+  guestOrders: z51.number(),
+  orders: z51.number(),
+  net: z51.number(),
+  averageOrder: z51.number(),
+  /** Orders that were their buyer's first, and the rest (Shopify's new vs returning). */
+  newOrders: z51.number(),
+  returningOrders: z51.number(),
+  newNet: z51.number(),
+  returningNet: z51.number(),
+  /** Of every buyer up to the period's end, the share who ordered again (0–1). */
+  repeatRate: z51.number(),
+  /** Median days from a buyer's first order to their second; null when nobody ordered twice. */
+  medianDaysToSecond: z51.number().nullable()
+});
+var shopifyCameFromSchema = z51.object({
+  channel: z51.string(),
+  label: z51.string(),
+  campaign: z51.string().optional(),
+  // --full
+  source: z51.string().optional(),
+  medium: z51.string().optional(),
+  clickPlatform: z51.string().optional(),
+  landingId: z51.string().optional()
+});
+var shopifyBuyerRowSchema = z51.object({
+  number: z51.number(),
+  /** "Customer #1042". */
+  label: z51.string(),
+  place: shopifyPlaceSchema.nullable(),
+  orders: z51.number(),
+  net: z51.number(),
+  firstOrderAt: z51.string(),
+  lastOrderAt: z51.string(),
+  segment: shopifyBuyerSegmentSchema,
+  cameFrom: shopifyCameFromSchema,
+  // --full
+  gross: z51.number().optional(),
+  refunded: z51.number().optional(),
+  ordersWithDiscount: z51.number().optional(),
+  averageDaysBetweenOrders: z51.number().nullable().optional()
+});
+var shopifyAcquisitionRowSchema = z51.object({
+  key: z51.string(),
+  label: z51.string(),
+  buyers: z51.number(),
+  /** What their first orders came to. */
+  firstNet: z51.number(),
+  /** What they have spent since, to date. */
+  lifetimeNet: z51.number(),
+  lifetimePerBuyer: z51.number(),
+  averageOrders: z51.number(),
+  repeatRate: z51.number(),
+  // --full
+  source: z51.string().optional(),
+  medium: z51.string().optional(),
+  campaign: z51.string().optional(),
+  clickPlatform: z51.string().optional()
+});
+var shopifyBuyersResponseSchema = z51.object({
+  ...answerCommon,
+  summary: shopifyBuyersSummarySchema,
+  thresholds: shopifySegmentThresholdsSchema,
+  segments: z51.array(z51.object({ segment: shopifyBuyerSegmentSchema, label: z51.string(), buyers: z51.number() })),
+  /** Buyers matching the filters, before the limit. */
+  total: z51.number(),
+  buyers: z51.array(shopifyBuyerRowSchema),
+  acquisition: z51.object({ by: shopifyAcquisitionBySchema, rows: z51.array(shopifyAcquisitionRowSchema) }).optional()
+});
+var shopifyBuyerNumberSchema = z51.string().trim().transform((value) => value.replace(/^customer\s*/i, "").replace(/^#/, "")).pipe(z51.string().regex(/^\d+$/, "a buyer's number, like 1042 or #1042")).transform((value) => Number(value)).pipe(z51.number().int().min(1).max(4e9));
+var shopifyBuyerRequestSchema = z51.object({ number: shopifyBuyerNumberSchema, full: flag2.optional() });
+var SHOPIFY_BUYER_GONE_MESSAGE = "This buyer is no longer in Baker.";
+var shopifyBuyerOrderSchema = z51.object({
+  name: z51.string(),
+  /** When it was placed, in the store's time (YYYY-MM-DD HH:MM). */
+  placedAt: z51.string(),
+  net: z51.number(),
+  gross: z51.number(),
+  refunded: z51.number(),
+  products: z51.array(z51.object({ title: z51.string(), quantity: z51.number() })),
+  discountCodes: z51.array(z51.string()),
+  place: shopifyPlaceSchema.nullable(),
+  /** Placed before Baker measured the store: counted, credited to no campaign. */
+  beforeBaker: z51.boolean(),
+  // --full
+  orderId: z51.string().optional(),
+  items: z51.array(z51.object({ productId: z51.string(), variantId: z51.string(), quantity: z51.number(), amount: z51.number() })).optional(),
+  refundedItems: z51.array(z51.object({ productId: z51.string(), variantId: z51.string(), quantity: z51.number(), amount: z51.number() })).optional(),
+  cameFrom: shopifyCameFromSchema.optional()
+});
+var shopifyBuyerProfileSchema = z51.object({
+  number: z51.number(),
+  label: z51.string(),
+  place: shopifyPlaceSchema.nullable(),
+  orders: z51.number(),
+  gross: z51.number(),
+  refunded: z51.number(),
+  net: z51.number(),
+  averageOrder: z51.number(),
+  /** Average days between their orders; null with one order. */
+  averageDaysBetweenOrders: z51.number().nullable(),
+  firstOrderAt: z51.string(),
+  lastOrderAt: z51.string(),
+  ordersWithDiscount: z51.number(),
+  segment: shopifyBuyerSegmentSchema,
+  segmentLabel: z51.string(),
+  cameFrom: shopifyCameFromSchema
+});
+var shopifyBuyerResponseSchema = z51.object({
+  ...answerCommon,
+  buyer: shopifyBuyerProfileSchema,
+  /** Newest first. */
+  orders: z51.array(shopifyBuyerOrderSchema),
+  products: z51.array(
+    z51.object({ title: z51.string(), quantity: z51.number(), orders: z51.number(), productId: z51.string().optional() })
+  )
+});
+var shopifyCountriesRequestSchema = z51.object({
+  ...windowRequest,
+  /** Inside one region of `country` (its code or name): its cities. */
+  region: z51.string().max(100).optional(),
+  /** Only orders holding this product (its id or handle); money is that product's lines. */
+  product: z51.string().max(255).optional(),
+  limit: limit.optional()
+});
+var shopifyPlaceRowSchema = z51.object({
+  /** A country code, a region code (or name) or a city. */
+  key: z51.string(),
+  name: z51.string(),
+  orders: z51.number(),
+  buyers: z51.number(),
+  newBuyers: z51.number(),
+  net: z51.number(),
+  averageOrder: z51.number(),
+  /** Of the total's net, 0–1. */
+  share: z51.number(),
+  /** Net against the period before; null when there was none before. */
+  growth: z51.number().nullable(),
+  ordersGrowth: z51.number().nullable(),
+  /** The currency its buyers paid in most. */
+  paidIn: z51.string(),
+  // --full
+  previousNet: z51.number().optional(),
+  previousOrders: z51.number().optional()
+});
+var shopifyCountriesResponseSchema = z51.object({
+  ...answerCommon,
+  level: z51.enum(["country", "region", "city"]),
+  country: z51.string().optional(),
+  region: z51.string().optional(),
+  product: z51.object({ id: z51.string(), title: z51.string() }).optional(),
+  total: shopifyPlaceRowSchema,
+  /** Named places, best first; with `unknown` and `other` they add up to `total`. */
+  rows: z51.array(shopifyPlaceRowSchema),
+  /** Orders whose address Baker could not read. Always shown, never folded into `other`. */
+  unknown: shopifyPlaceRowSchema.nullable(),
+  /** Places past the limit, together. */
+  other: shopifyPlaceRowSchema.nullable()
+});
+var shopifyBestSellersViewSchema = z51.enum(["products", "variants", "trend", "together", "repeat", "momentum"]);
+var shopifyBestSellersSortSchema = z51.enum(["units", "revenue", "orders"]);
+var shopifyBestSellersRequestSchema = z51.object({
+  ...windowRequest,
+  view: shopifyBestSellersViewSchema.optional(),
+  sort: shopifyBestSellersSortSchema.optional(),
+  /** Only this product (its id or handle): its variants, its trend. */
+  product: z51.string().max(255).optional(),
+  limit: limit.optional()
+});
+var shopifyBestSellerRowSchema = z51.object({
+  title: z51.string(),
+  /** The option's own title, by variant. */
+  variantTitle: z51.string().optional(),
+  units: z51.number(),
+  refundedUnits: z51.number(),
+  orders: z51.number(),
+  buyers: z51.number(),
+  revenue: z51.number(),
+  refunded: z51.number(),
+  /** Refunded units of units ordered, 0–1. */
+  refundRate: z51.number(),
+  /** Units against the period before; null when none sold before. */
+  growth: z51.number().nullable(),
+  // --full
+  productId: z51.string().optional(),
+  variantId: z51.string().optional(),
+  previousUnits: z51.number().optional(),
+  previousRevenue: z51.number().optional()
+});
+var shopifyTrendRowSchema = z51.object({
+  /** YYYY-MM, in the store's time. */
+  month: z51.string(),
+  title: z51.string(),
+  units: z51.number(),
+  revenue: z51.number(),
+  productId: z51.string().optional()
+});
+var shopifyTogetherRowSchema = z51.object({
+  first: z51.string(),
+  second: z51.string(),
+  /** Orders holding both. */
+  orders: z51.number(),
+  /** Of the orders holding the first, the share that also held the second (0–1). */
+  confidence: z51.number(),
+  firstId: z51.string().optional(),
+  secondId: z51.string().optional()
+});
+var shopifyRepeatRowSchema = z51.object({
+  title: z51.string(),
+  /** Buyers whose first order held it. */
+  buyers: z51.number(),
+  /** Of them, who ordered again. */
+  buyersAgain: z51.number(),
+  share: z51.number(),
+  medianDaysToSecond: z51.number().nullable(),
+  productId: z51.string().optional()
+});
+var shopifyMomentumRowSchema = z51.object({
+  title: z51.string(),
+  units: z51.number(),
+  previousUnits: z51.number(),
+  /** Units against the period before (−0.4 = 40% fewer). */
+  change: z51.number(),
+  revenue: z51.number(),
+  productId: z51.string().optional()
+});
+var shopifyBestSellersResponseSchema = z51.object({
+  ...answerCommon,
+  view: shopifyBestSellersViewSchema,
+  sort: shopifyBestSellersSortSchema,
+  product: z51.object({ id: z51.string(), title: z51.string() }).optional(),
+  products: z51.array(shopifyBestSellerRowSchema).optional(),
+  variants: z51.array(shopifyBestSellerRowSchema).optional(),
+  trend: z51.array(shopifyTrendRowSchema).optional(),
+  together: z51.array(shopifyTogetherRowSchema).optional(),
+  repeat: z51.array(shopifyRepeatRowSchema).optional(),
+  momentum: z51.array(shopifyMomentumRowSchema).optional()
+});
+var shopifyCohortsRequestSchema = z51.object({
+  months: z51.coerce.number().int().min(3).max(36).optional(),
+  country: countryCode2.optional(),
+  full: flag2.optional()
+});
+var shopifyCohortMonthSchema = z51.object({
+  /** Months since the first order: 0 is the month they first bought. */
+  offset: z51.number(),
+  activeBuyers: z51.number(),
+  orders: z51.number(),
+  net: z51.number(),
+  /** Of the cohort, who ordered in that month (0–1). */
+  retention: z51.number(),
+  /** What the cohort spent up to that month, per buyer. */
+  cumulativeNetPerBuyer: z51.number()
+});
+var shopifyCohortSchema = z51.object({
+  /** The month of their first order, YYYY-MM in the store's time. */
+  month: z51.string(),
+  size: z51.number(),
+  /** Who ordered again 1, 2, 3, 6 and 12 months after; null for a month not reached yet. */
+  retention: z51.object({
+    m1: z51.number().nullable(),
+    m2: z51.number().nullable(),
+    m3: z51.number().nullable(),
+    m6: z51.number().nullable(),
+    m12: z51.number().nullable()
+  }),
+  netPerBuyerAt12: z51.number().nullable(),
+  // --full
+  matrix: z51.array(shopifyCohortMonthSchema).optional()
+});
+var shopifyCohortsResponseSchema = z51.object({
+  ...answerCommon,
+  months: z51.number(),
+  cohorts: z51.array(shopifyCohortSchema)
+});
+
+// src/commands/shopify/refusal.ts
+var CONTINUE2 = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else.";
+function shopifyRefusal(code, message) {
+  if (code !== "NOT_FOUND") return null;
+  if (message.includes(SHOPIFY_NOT_CONNECTED_MESSAGE)) {
+    return {
+      code: "NO_SHOPIFY_CONNECTION",
+      fix: {
+        action: "request_connection",
+        explanation: 'AGENT INSTRUCTION: no Shopify store is connected, and only the user can connect it. Call the `request_connection` tool with { platform: "shopify", reason } \u2014 reason in their words, e.g. "so I can use your real products and prices" \u2014 and they connect it inside the chat; then run this command again. ' + CONTINUE2
+      }
+    };
+  }
+  if (message.includes(SHOPIFY_NOT_OFFERED_MESSAGE)) {
+    return {
+      code: "SHOPIFY_NOT_AVAILABLE",
+      fix: {
+        action: "continue_without",
+        explanation: "Do not call `request_connection` for Shopify and do not tell the user to connect it: a Shopify store cannot be connected on this Baker yet. Answer from the knowledge vault and the client's own website instead (`baker images extract <store url>` for product photos, `baker research fetch <url>` for a product page), say the product facts are unverified, and finish the rest of the task."
+      }
+    };
+  }
+  return null;
+}
+
+// src/commands/shopify/common.ts
+var PRODUCT_NOT_FOUND_HINT = "Find it with `baker shopify products --search <words>`. If `baker shopify store` shows products Baker couldn't read or products still coming in, it may be one of those \u2014 say so rather than that it doesn't exist.";
+function fail9(err) {
+  if (err instanceof ApiError) {
+    const refusal = shopifyRefusal(err.code, err.message);
+    if (refusal) {
+      writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
+      process.exit(1);
+    }
+    if (err.code === "NOT_FOUND" && err.message === SHOPIFY_BUYER_GONE_MESSAGE) {
+      writeJson({
+        ok: false,
+        error: { code: err.code, message: err.message },
+        hints: [
+          "Their store asked Baker to erase this buyer, or they were merged into another one: say the buyer is no longer in Baker, and never guess who they were."
+        ]
+      });
+      process.exit(1);
+    }
+    if (err.code === "NOT_FOUND" && err.message.startsWith(SHOPIFY_PRODUCT_NOT_FOUND_PREFIX)) {
+      writeJson({ ok: false, error: { code: err.code, message: err.message }, hints: [PRODUCT_NOT_FOUND_HINT] });
+      process.exit(1);
+    }
+  }
+  failApi(err);
+}
+function emit2(data, meta, hints2) {
+  writeJson({ ok: true, data, meta, ...hints2.length > 0 ? { hints: hints2 } : {} });
+}
+function params(entries) {
+  const out = {};
+  for (const [name, value] of Object.entries(entries)) {
+    if (value === void 0 || value === "" || value === false) continue;
+    out[name] = String(value);
+  }
+  return out;
+}
+var fullArg = {
+  type: "boolean",
+  description: "Everything Baker keeps, not just what answers the question",
+  required: false,
+  default: false
+};
 
 // src/commands/shopify/hints.ts
 var RECONNECT = 'Baker has lost access to this Shopify store, so these products may be out of date. Say so, and ask the user to reconnect with `request_connection` { platform: "shopify" } \u2014 the card offers Reconnect.';
@@ -65249,7 +65879,7 @@ function productHints(product, store) {
   }
   return hints2;
 }
-function stockHints(answer, limit) {
+function stockHints(answer, limit2) {
   const hints2 = [];
   const any = answer.outOfStock.length > 0 || answer.partlyOut.length > 0;
   const unfinished = answer.more.outOfStock || answer.more.partlyOut;
@@ -65260,9 +65890,9 @@ function stockHints(answer, limit) {
     );
   } else if (!unfinished) hints2.push("Nothing is out of stock.");
   if (unfinished) {
-    const full = answer.more.outOfStock && answer.outOfStock.length >= limit || answer.more.partlyOut && answer.partlyOut.length >= limit;
+    const full = answer.more.outOfStock && answer.outOfStock.length >= limit2 || answer.more.partlyOut && answer.partlyOut.length >= limit2;
     hints2.push(
-      full ? `More than ${limit} products in a list; raise \`--limit\` (up to 200) or ${pageThrough}.` : `Baker didn't check every product in one go, so these lists may be missing some \u2014 don't say nothing else is out of stock; ${pageThrough}.`
+      full ? `More than ${limit2} products in a list; raise \`--limit\` (up to 200) or ${pageThrough}.` : `Baker didn't check every product in one go, so these lists may be missing some \u2014 don't say nothing else is out of stock; ${pageThrough}.`
     );
   }
   const big = answer.partlyOut.find((row) => row.outOptionsMore);
@@ -65297,6 +65927,12 @@ function storeHints(summary) {
   }
   return hints2;
 }
+function timingHints(answer) {
+  const peak = [...answer.rows].sort((a, b) => b.orders - a.orders)[0];
+  if (!peak || peak.orders === 0) return [];
+  const zone = answer.window.timezone ? `, ${answer.window.timezone}` : "";
+  return [`Most orders are placed on ${peak.label} (store time${zone}): weight budgets and sends towards it.`];
+}
 function salesHints(answer) {
   const hints2 = [];
   if (answer.ordersUnreadable) {
@@ -65313,6 +65949,9 @@ function salesHints(answer) {
     hints2.push("No orders were paid in this period.");
     return hints2;
   }
+  if (answer.by === "weekday" || answer.by === "hour" || answer.by === "month_of_year") {
+    return [...hints2, ...timingHints(answer)];
+  }
   const notBaker = ["meta", "google"].filter((family) => answer.salesReporting[family] !== "baker");
   if (notBaker.length > 0) {
     const names = notBaker.map((family) => family === "meta" ? "Meta" : "Google").join(" and ");
@@ -65335,64 +65974,303 @@ function salesHints(answer) {
   return hints2;
 }
 
-// src/commands/shopify/refusal.ts
-var CONTINUE2 = "Keep going with the wider task: say which part you could not read, skip it, and finish everything else.";
-function shopifyRefusal(code, message) {
-  if (code !== "NOT_FOUND") return null;
-  if (message.includes(SHOPIFY_NOT_CONNECTED_MESSAGE)) {
-    return {
-      code: "NO_SHOPIFY_CONNECTION",
-      fix: {
-        action: "request_connection",
-        explanation: 'AGENT INSTRUCTION: no Shopify store is connected, and only the user can connect it. Call the `request_connection` tool with { platform: "shopify", reason } \u2014 reason in their words, e.g. "so I can use your real products and prices" \u2014 and they connect it inside the chat; then run this command again. ' + CONTINUE2
-      }
-    };
-  }
-  if (message.includes(SHOPIFY_NOT_OFFERED_MESSAGE)) {
-    return {
-      code: "SHOPIFY_NOT_AVAILABLE",
-      fix: {
-        action: "continue_without",
-        explanation: "Do not call `request_connection` for Shopify and do not tell the user to connect it: a Shopify store cannot be connected on this Baker yet. Answer from the knowledge vault and the client's own website instead (`baker images extract <store url>` for product photos, `baker research fetch <url>` for a product page), say the product facts are unverified, and finish the rest of the task."
-      }
-    };
+// src/commands/shopify/buyers.ts
+var PERIOD_NOTE = "Orders placed in the period, in the store's own time, with what was refunded on them since (Shopify's own reports date a refund when it happens instead, so a short period can differ by the refunds that cross its edges).";
+var periodArgs = {
+  days: { type: "number", description: "The last N days, 1-3650 (default 365)", required: false },
+  all: { type: "boolean", description: "Every order the store has", required: false, default: false },
+  country: {
+    type: "string",
+    description: "Only orders to this country: its two-letter code, like DE",
+    required: false
   }
-  return null;
+};
+var periodFlags = {
+  days: { type: "string", description: "The last N days, 1-3650 (default 365)", required: false },
+  all: { type: "boolean", description: "Every order the store has", required: false, default: false },
+  country: { type: "string", description: "Only orders to this country (two-letter code, like DE)", required: false }
+};
+function split(answer) {
+  const { store, window: window2, history, basis, ...data } = answer;
+  return { data, meta: { store, window: window2, history, basis } };
 }
-
-// src/commands/shopify/index.ts
-var PRODUCT_NOT_FOUND_HINT = "Find it with `baker shopify products --search <words>`. If `baker shopify store` shows products Baker couldn't read or products still coming in, it may be one of those \u2014 say so rather than that it doesn't exist.";
-function fail9(err) {
-  if (err instanceof ApiError) {
-    const refusal = shopifyRefusal(err.code, err.message);
-    if (refusal) {
-      writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
-      process.exit(1);
+registerSchema({
+  command: "shopify.buyers",
+  description: `Start here for 'who buys from us', 'how many come back' and 'which campaign brings the best customers': the store's buyers in the period \u2014 how many, how many were new, repeat rate, days to a second order, guest orders \u2014 their segments (best, loyal, at risk, new, one-time, by this store's own rhythm) and the top buyers as numbered customers with their country, lifetime spend and the channel of their first order. --by campaign|channel adds lifetime value per acquisition campaign or channel (Baker keeps no ad spend: read it with the ads commands for the same dates). ${PERIOD_NOTE} A buyer is a Shopify customer: guest orders count in money, never as buyers.`,
+  args: {
+    ...periodArgs,
+    segment: {
+      type: "string",
+      description: "Only one segment's buyers: best | loyal | at_risk | new | one_time",
+      required: false,
+      enum: ["best", "loyal", "at_risk", "new", "one_time"]
+    },
+    by: {
+      type: "string",
+      description: "Lifetime value by the campaign or channel of each buyer's first order",
+      required: false,
+      enum: ["campaign", "channel"]
+    },
+    channel: {
+      type: "string",
+      description: "Only buyers who first came through this channel (a key from --by channel)",
+      required: false
+    },
+    sort: {
+      type: "string",
+      description: "net (lifetime spend, default) | orders | recent (last order) | first (first order)",
+      required: false,
+      enum: ["net", "orders", "recent", "first"]
+    },
+    limit: { type: "number", description: "Buyers listed, 1-100 (default 10)", required: false },
+    offset: { type: "number", description: "Skip this many buyers (paging)", required: false },
+    full: {
+      ...fullArg,
+      description: "Add each buyer's gross, refunds, orders with a discount, days between orders and first-order campaign"
     }
-    if (err.code === "NOT_FOUND" && err.message.startsWith(SHOPIFY_PRODUCT_NOT_FOUND_PREFIX)) {
-      writeJson({ ok: false, error: { code: err.code, message: err.message }, hints: [PRODUCT_NOT_FOUND_HINT] });
-      process.exit(1);
+  }
+});
+var buyersCommand = defineCommand209({
+  meta: {
+    name: "buyers",
+    description: "Who buys: buyers, new and returning, repeat rate, segments and the top buyers. Start here: baker shopify buyers --days 90 --by channel"
+  },
+  args: {
+    ...periodFlags,
+    segment: { type: "string", description: "best | loyal | at_risk | new | one_time", required: false },
+    by: { type: "string", description: "campaign | channel", required: false },
+    channel: { type: "string", description: "A channel key from --by channel", required: false },
+    sort: { type: "string", description: "net | orders | recent | first", required: false },
+    limit: { type: "string", description: "Buyers listed, 1-100", required: false },
+    offset: { type: "string", description: "Skip this many buyers", required: false },
+    full: { type: "boolean", description: "Add each buyer's detail", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/buyers",
+        params({
+          days: args5.days,
+          all: args5.all,
+          country: args5.country,
+          segment: args5.segment,
+          by: args5.by,
+          channel: args5.channel,
+          sort: args5.sort,
+          limit: args5.limit,
+          offset: args5.offset,
+          full: args5.full
+        })
+      );
+      const { data, meta } = split(answer);
+      emit2(data, meta, [...storeStateHints(answer.store), ...buyersHints(answer)]);
+    } catch (err) {
+      fail9(err);
     }
   }
-  failApi(err);
-}
-function emit2(data, meta, hints2) {
-  writeJson({ ok: true, data, meta, ...hints2.length > 0 ? { hints: hints2 } : {} });
-}
-function params(entries) {
-  const out = {};
-  for (const [name, value] of Object.entries(entries)) {
-    if (value === void 0 || value === "" || value === false) continue;
-    out[name] = String(value);
+});
+registerSchema({
+  command: "shopify.buyer",
+  description: "One buyer by their number (1042, #1042 or 'Customer #1042'): where they are, how many orders and how much they spent net of refunds, average order, days between orders, first and last order, discount use, segment and how they first came \u2014 then every order (date in the store's time, products and quantities, net, refunded, discount codes, city), newest first, and what they bought. Never a name or an email. A buyer their store asked Baker to erase, or merged into another, answers 'This buyer is no longer in Baker'.",
+  args: {
+    number: { type: "positional", description: "The buyer's number: 1042, #1042 or 'Customer #1042'", required: true },
+    full: { ...fullArg, description: "Add each order's id, lines with their amounts, refunded lines and campaign" }
   }
-  return out;
-}
-var fullArg = {
-  type: "boolean",
-  description: "Everything Baker keeps, not just what answers the question",
-  required: false,
-  default: false
-};
+});
+var buyerCommand = defineCommand209({
+  meta: {
+    name: "buyer",
+    description: "One buyer's history by number. Example: baker shopify buyer 1042"
+  },
+  args: {
+    number: { type: "positional", description: "1042, #1042 or 'Customer #1042'", required: true },
+    full: { type: "boolean", description: "Add ids, lines and campaigns", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/buyer",
+        params({ number: args5.number, full: args5.full })
+      );
+      const { data, meta } = split(answer);
+      emit2(data, meta, [...storeStateHints(answer.store), ...buyerHistoryHints(answer.history, answer.basis)]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+registerSchema({
+  command: "shopify.countries",
+  description: `Start here for 'where do our buyers come from' and 'which countries should we push': orders, buyers, new buyers, net, average order, share and growth against the period before, by country \u2014 or by region inside --country (straight by city for a country whose addresses carry no region, like Germany), or by city inside --country and --region \u2014 with the currency buyers paid in. Orders whose address Baker could not read are 'Unknown' ('No region given' / 'No city given' inside a country), always shown; the rows, that row and 'Other' add up to the total. --product narrows to the orders holding one product, with that product's money. ${PERIOD_NOTE}`,
+  args: {
+    ...periodArgs,
+    region: { type: "string", description: "Inside --country, one region (code or name): its cities", required: false },
+    product: { type: "string", description: "Only orders holding this product: its id or handle", required: false },
+    limit: { type: "number", description: "Places listed, 1-100 (default 25; the rest are 'Other')", required: false },
+    full: { ...fullArg, description: "Add the period before's net and orders per place" }
+  }
+});
+var countriesCommand2 = defineCommand209({
+  meta: {
+    name: "countries",
+    description: "Where buyers are: orders, buyers and net by country, region or city, with growth. Start here: baker shopify countries --days 90"
+  },
+  args: {
+    ...periodFlags,
+    region: { type: "string", description: "A region inside --country", required: false },
+    product: { type: "string", description: "A product's id or handle", required: false },
+    limit: { type: "string", description: "Places listed, 1-100", required: false },
+    full: { type: "boolean", description: "Add the period before", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/countries",
+        params({
+          days: args5.days,
+          all: args5.all,
+          country: args5.country,
+          region: args5.region,
+          product: args5.product,
+          limit: args5.limit,
+          full: args5.full
+        })
+      );
+      const { data, meta } = split(answer);
+      emit2(data, meta, [...storeStateHints(answer.store), ...countriesHints(answer)]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+registerSchema({
+  command: "shopify.bestSellers",
+  description: `Start here for 'what sells best' and 'which product should we lead with': best sellers by units ordered (before anything came back) beside refunded units, orders, buyers, revenue (the lines' price after discounts, before tax and shipping), refunds, refund rate and growth. --view variants (one product's options, with --product), trend (top products by month), together (products bought in one order), repeat (first buys whose buyers came back most) or momentum (products selling 30% or more below the period before). ${PERIOD_NOTE} For the catalog itself use \`baker shopify products\`.`,
+  args: {
+    ...periodArgs,
+    view: {
+      type: "string",
+      description: "products (default) | variants | trend | together | repeat | momentum",
+      required: false,
+      enum: ["products", "variants", "trend", "together", "repeat", "momentum"]
+    },
+    sort: {
+      type: "string",
+      description: "units (default) | revenue | orders",
+      required: false,
+      enum: ["units", "revenue", "orders"]
+    },
+    product: { type: "string", description: "One product (id or handle): its variants or its trend", required: false },
+    limit: { type: "number", description: "Rows, 1-100 (default 10; 5 products for trend)", required: false },
+    full: { ...fullArg, description: "Add product and variant ids and the period before" }
+  }
+});
+var bestSellersCommand = defineCommand209({
+  meta: {
+    name: "best-sellers",
+    description: "What sells: best sellers, variants, trend, bought together, repeat leaders, losing momentum. Start here: baker shopify best-sellers --days 90"
+  },
+  args: {
+    ...periodFlags,
+    view: {
+      type: "string",
+      description: "products | variants | trend | together | repeat | momentum",
+      required: false
+    },
+    sort: { type: "string", description: "units | revenue | orders", required: false },
+    product: { type: "string", description: "A product's id or handle", required: false },
+    limit: { type: "string", description: "Rows, 1-100", required: false },
+    full: { type: "boolean", description: "Add ids and the period before", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/best-sellers",
+        params({
+          days: args5.days,
+          all: args5.all,
+          country: args5.country,
+          view: args5.view,
+          sort: args5.sort,
+          product: args5.product,
+          limit: args5.limit,
+          full: args5.full
+        })
+      );
+      const { data, meta } = split(answer);
+      emit2(data, meta, [...storeStateHints(answer.store), ...bestSellersHints(answer)]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+registerSchema({
+  command: "shopify.cohorts",
+  description: "Buyers grouped by the month of their first order (the last --months, default 12): how many, the share who ordered again 1, 2, 3, 6 and 12 months later, and what they spent per buyer by month 12. Months not reached yet are null. Use it for 'are buyers coming back more than they used to' and lifetime value over time.",
+  args: {
+    months: { type: "number", description: "Cohorts, the last 3-36 months (default 12)", required: false },
+    country: { type: "string", description: "Only orders to this country (two-letter code)", required: false },
+    full: {
+      ...fullArg,
+      description: "Add every month of every cohort: active buyers, orders, net, cumulative net per buyer"
+    }
+  }
+});
+var cohortsCommand = defineCommand209({
+  meta: {
+    name: "cohorts",
+    description: "Buyers by first-order month: who came back and what they spent. Example: baker shopify cohorts --months 12"
+  },
+  args: {
+    months: { type: "string", description: "The last 3-36 months", required: false },
+    country: { type: "string", description: "A two-letter country code", required: false },
+    full: { type: "boolean", description: "Every month of every cohort", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/cohorts",
+        params({ months: args5.months, country: args5.country, full: args5.full })
+      );
+      const { data, meta } = split(answer);
+      emit2(data, meta, [...storeStateHints(answer.store), ...cohortsHints(answer)]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+registerSchema({
+  command: "shopify.segments",
+  description: "Every buyer at the period's end by segment \u2014 best buyers, loyal, at risk, new and one-time \u2014 with how many, their share, net, average orders, days since their last order, the countries they are in and the products their first orders held. Each segment's rule is given in words with this store's own numbers (its typical gap between orders and the spend of its top fifth). Start here for 'who are our best customers' and 'who should we win back'.",
+  args: {
+    ...periodArgs,
+    full: { ...fullArg, description: "Add the first products' ids" }
+  }
+});
+var segmentsCommand = defineCommand209({
+  meta: {
+    name: "segments",
+    description: "Buyers by segment: best, loyal, at risk, new, one-time. Example: baker shopify segments"
+  },
+  args: {
+    ...periodFlags,
+    full: { type: "boolean", description: "Add product ids", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/segments",
+        params({ days: args5.days, all: args5.all, country: args5.country, full: args5.full })
+      );
+      const { data, meta } = split(answer);
+      emit2(data, meta, [...storeStateHints(answer.store), ...segmentsHints(answer)]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+
+// src/commands/shopify/index.ts
 registerSchema({
   command: "shopify.store",
   description: 'Start here for the connected Shopify store: its name, currency, home country, how many products and collections it has, how many products are out of stock or partly out, the prices by country it sells at (only when it has more than one), where its buy links send a shopper (`buyDestination`: checkout, store_cart or product_page), its languages and policies, whether it asks for a password, and the link to the Products page in Baker. `capped: true` means a count stopped at its ceiling (100 out of stock or partly out, 500 collections): say "100 or more", never the number as exact. `meta.store` says whether Baker\'s copy is complete and whether Baker can still reach the store.',
@@ -65490,14 +66368,24 @@ registerSchema({
 });
 registerSchema({
   command: "shopify.sales",
-  description: "Start here for 'how much did we sell', 'which campaigns or pages brought sales' and 'which products sold most': the connected store's orders, sales, refunds and net, in the store's currency. --by day (default) and --by product count each sale, addition and refund in the period it happened; --by campaign and --by landing take the orders paid in the period and credit each to the campaign or Baker page that brought its buyer, with what was added to and refunded on it since \u2014 so the rows add up to `totals` exactly, with named rows for sales from before Baker measured the store and sales from no campaign. A sale counts when it is paid, at what was received. `salesReporting` says who reports the sales to Meta and Google: `undecided` and `shopify_channel` mean Baker only reports them, and only a manager can change that in Brain \u2192 Store.",
+  description: "Start here for 'how much did we sell', 'which campaigns or pages brought sales' and 'which products sold most': the connected store's orders, sales, refunds and net, in the store's currency. --by day (default) and --by product count each sale, addition and refund in the period it happened; --by campaign and --by landing take the orders paid in the period and credit each to the campaign or Baker page that brought its buyer, with what was added to and refunded on it since \u2014 so the rows add up to `totals` exactly, with named rows for sales from before Baker measured the store and sales from no campaign. A sale counts when it is paid, at what was received. `salesReporting` says who reports the sales to Meta and Google: `undecided` and `shopify_channel` mean Baker only reports them, and only a manager can change that in Brain \u2192 Store. --by weekday|hour|month|month_of_year says when buyers order, in the store's own time, from the store's whole order history (orders placed in the period, with what was refunded on them since): use it for when to run or schedule campaigns; only these take --days up to 3650 or --all.",
   args: {
-    days: { type: "number", description: "The last N days, 1-395 (default 30)", required: false },
+    days: {
+      type: "number",
+      description: "The last N days: 1-395 by day, product, campaign or landing; 1-3650 by weekday, hour or month (default 30)",
+      required: false
+    },
+    all: {
+      type: "boolean",
+      description: "Every order the store has (by weekday, hour, month or month_of_year only)",
+      required: false,
+      default: false
+    },
     by: {
       type: "string",
-      description: "day | product | campaign | landing (default day)",
+      description: "day | product | campaign | landing | weekday | hour | month | month_of_year (default day)",
       required: false,
-      enum: ["day", "product", "campaign", "landing"]
+      enum: ["day", "product", "campaign", "landing", "weekday", "hour", "month", "month_of_year"]
     },
     limit: {
       type: "number",
@@ -65510,14 +66398,28 @@ registerSchema({
     }
   }
 });
-var salesCommand = defineCommand209({
+var salesCommand = defineCommand210({
   meta: {
     name: "sales",
-    description: "What the store sold: orders, sales, refunds and net, by day, product, campaign or landing. Example: baker shopify sales --days 7 --by campaign"
+    description: "What the store sold: orders, sales, refunds and net, by day, product, campaign or landing \u2014 or when buyers order (weekday, hour, month). Example: baker shopify sales --days 7 --by campaign"
   },
   args: {
-    days: { type: "string", description: "The last N days, 1-395 (default 30)", required: false },
-    by: { type: "string", description: "day | product | campaign | landing (default day)", required: false },
+    days: {
+      type: "string",
+      description: "The last N days (1-395; up to 3650 by weekday, hour or month)",
+      required: false
+    },
+    all: {
+      type: "boolean",
+      description: "Every order (by weekday, hour or month only)",
+      required: false,
+      default: false
+    },
+    by: {
+      type: "string",
+      description: "day | product | campaign | landing | weekday | hour | month | month_of_year (default day)",
+      required: false
+    },
     limit: { type: "string", description: "Rows of a breakdown, 1-100", required: false },
     full: { type: "boolean", description: "Add sources, campaigns and ids per row", required: false, default: false }
   },
@@ -65525,7 +66427,7 @@ var salesCommand = defineCommand209({
     try {
       const answer = await apiGet(
         "/api/shopify/sales",
-        params({ days: args5.days, by: args5.by, limit: args5.limit, full: args5.full })
+        params({ days: args5.days, all: args5.all, by: args5.by, limit: args5.limit, full: args5.full })
       );
       const { store, salesReporting, history, ...data } = answer;
       emit2(data, { store, salesReporting, history }, [...storeStateHints(store), ...salesHints(answer)]);
@@ -65534,7 +66436,7 @@ var salesCommand = defineCommand209({
     }
   }
 });
-var storeCommand = defineCommand209({
+var storeCommand = defineCommand210({
   meta: {
     name: "store",
     description: "The connected Shopify store: currency, countries, how many products, what is out of stock. Example: baker shopify store"
@@ -65551,7 +66453,7 @@ var storeCommand = defineCommand209({
     }
   }
 });
-var productsCommand = defineCommand209({
+var productsCommand = defineCommand210({
   meta: {
     name: "products",
     description: 'What the store sells, with price and stock. Example: baker shopify products --search "snowboard" --stock out_of_stock'
@@ -65597,7 +66499,7 @@ var productsCommand = defineCommand209({
     }
   }
 });
-var productCommand = defineCommand209({
+var productCommand = defineCommand210({
   meta: {
     name: "product",
     description: "One product: options with buy links, prices by country, stock, photo imageIds, video playbackIds. Accepts an id, handle or link. Example: baker shopify product the-complete-snowboard --content"
@@ -65660,7 +66562,7 @@ var productCommand = defineCommand209({
     }
   }
 });
-var collectionsCommand = defineCommand209({
+var collectionsCommand = defineCommand210({
   meta: {
     name: "collections",
     description: "The store's collections, with the handles --collection takes. Example: baker shopify collections --full"
@@ -65685,7 +66587,7 @@ var collectionsCommand = defineCommand209({
     }
   }
 });
-var stockCommand2 = defineCommand209({
+var stockCommand2 = defineCommand210({
   meta: {
     name: "stock",
     description: "Every product with options out of stock, naming them. Example: baker shopify stock"
@@ -65702,18 +66604,18 @@ var stockCommand2 = defineCommand209({
         params({ collection: args5.collection, limit: args5.limit, full: args5.full })
       );
       const { store, ...data } = answer;
-      const limit = Number(args5.limit ?? 50);
-      emit2(data, { store }, [...storeStateHints(store), ...stockHints(answer, Number.isFinite(limit) ? limit : 50)]);
+      const limit2 = Number(args5.limit ?? 50);
+      emit2(data, { store }, [...storeStateHints(store), ...stockHints(answer, Number.isFinite(limit2) ? limit2 : 50)]);
     } catch (err) {
       fail9(err);
     }
   }
 });
-var shopifyCommand = defineCommand209({
+var shopifyCommand = defineCommand210({
   meta: {
     name: "shopify",
     description: `Read the connected Shopify store as Baker keeps it \u2014 products, prices by country, stock, collections,
-product photos and what it sold. Read-only: nothing here changes the store.
+product photos, what it sold, and who buys, where and what. Read-only: nothing here changes the store.
 
 Examples:
   baker shopify store                                # currency, countries, how many products, what is out of stock
@@ -65728,6 +66630,13 @@ Examples:
   baker shopify stock                                # every product with options out of stock
   baker shopify collections                          # collections, with handles for --collection
   baker shopify sales --days 7 --by campaign         # what sold and which campaigns brought it (--by day|product|landing)
+  baker shopify sales --all --by weekday             # when buyers order, in the store's time (--by hour|month|month_of_year)
+  baker shopify countries --days 90                  # where buyers are, with growth (--country DE for its regions)
+  baker shopify best-sellers --days 90               # what sells (--view variants|trend|together|repeat|momentum)
+  baker shopify buyers --days 90 --by channel        # who buys, repeat rate, segments, value by acquisition channel
+  baker shopify buyer 1042                           # one numbered customer's orders
+  baker shopify segments                             # best, loyal, at risk, new, one-time \u2014 and who to find more of
+  baker shopify cohorts --months 12                  # buyers by first-order month: who came back
 
 Product photos are already in the image library: place them by imageId
 (baker images download <imageIds> --out src/pages/<page>/_images/), never by a cdn.shopify.com link.
@@ -65744,15 +66653,21 @@ Full guide: __tooling__/docs/tools/baker/shopify.md`
     product: productCommand,
     collections: collectionsCommand,
     stock: stockCommand2,
-    sales: salesCommand
+    sales: salesCommand,
+    buyers: buyersCommand,
+    buyer: buyerCommand,
+    countries: countriesCommand2,
+    "best-sellers": bestSellersCommand,
+    cohorts: cohortsCommand,
+    segments: segmentsCommand
   }
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand219 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand211 } from "citty";
 
 // src/commands/studio/spokenPace.ts
 var WORDS_PER_SECOND3 = SPOKEN_WORDS_PER_SECOND;
@@ -65763,9 +66678,9 @@ function wordsThatFit(seconds) {
 function spokenPaceHint(prompt, seconds, model) {
   const words2 = spokenWords(prompt);
   if (words2 === 0) return null;
-  const split = model ? splitScriptFor(words2, model) : null;
-  if (split) {
-    return `The line is ${words2} words \u2014 about ${Math.ceil(words2 / WORDS_PER_SECOND3)}s of speech \u2014 and ${model} renders at most ${split.maxSeconds}s (~${Math.floor(split.maxSeconds * WORDS_PER_SECOND3)} words). It will not refuse and it will not cut: it will RUSH, swallowing syllables. Split the script into ${split.clips} takes of roughly ${split.wordsPerClip} words each, rendered separately and cut together \u2014 break it where the thought breaks, not mid-sentence. Or move to a model that renders longer (bytedance/seedance-2.5 goes to 30s).`;
+  const split2 = model ? splitScriptFor(words2, model) : null;
+  if (split2) {
+    return `The line is ${words2} words \u2014 about ${Math.ceil(words2 / WORDS_PER_SECOND3)}s of speech \u2014 and ${model} renders at most ${split2.maxSeconds}s (~${Math.floor(split2.maxSeconds * WORDS_PER_SECOND3)} words). It will not refuse and it will not cut: it will RUSH, swallowing syllables. Split the script into ${split2.clips} takes of roughly ${split2.wordsPerClip} words each, rendered separately and cut together \u2014 break it where the thought breaks, not mid-sentence. Or move to a model that renders longer (bytedance/seedance-2.5 goes to 30s).`;
   }
   if (!seconds) return null;
   const fits = wordsThatFit(seconds);
@@ -65980,10 +66895,10 @@ var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
   upload: (path48) => uploadLocalImage({ file: path48, contentType: detectImageContentType(path48), source: "uploaded" })
 };
-async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
+async function resolveLibraryImageIds(spec, limit2, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
-  if (limit && refs.length > limit.max) {
-    throw new ApiError("VALIDATION_ERROR", limit.refuse(refs.length));
+  if (limit2 && refs.length > limit2.max) {
+    throw new ApiError("VALIDATION_ERROR", limit2.refuse(refs.length));
   }
   const imageIds = [];
   const added = [];
@@ -66265,7 +67180,7 @@ async function adByHandHintFor(body) {
     return null;
   }
 }
-var animateCommand = defineCommand210({
+var animateCommand = defineCommand211({
   meta: {
     name: "animate",
     description: "Render a clip. With an image the look is already fixed, so the prompt describes MOVEMENT \u2014 what the camera does, what the subject does, in what order. With --from text there is no image and the prompt is the whole shot.\n\nA rendered clip is NOT usable anywhere until you keep it: `baker studio keep <id> --slot N` is what puts it in the video library. Takes nobody keeps are never ingested, which is what makes a rejected batch cheap.\n\nFor anything longer than 15 seconds, or to build on footage that already exists, use --model bytedance/seedance-2.5: it renders 4-30s and is the only model that reads an existing clip or an existing soundtrack.\n\nExamples:\n  baker studio animate 'slow push in, model turns to camera and smiles' --image j57abc123def456ghi789\n  baker studio animate 'she looks to camera and says: \"Hola, soy Elena\"' --avatar elena --quality 720p --aspect-ratio 9:16\n  baker studio animate 'handheld drift right, steam rising from the cup' --image './out/hero.png' --duration 6 --quality 1080p\n  baker studio animate 'product rotates once on a turntable' --image j57abc\u2026,j57def\u2026 --from references\n  baker studio animate 'she keeps walking, camera stays with her, then she stops and looks up' --image j57abc\u2026 --from references --from-clip j57batch\u2026:0 --model bytedance/seedance-2.5 --duration 20\n  baker studio animate 'hold on the product, then a slow push-in' --from references --from-video j57vid\u2026 --model bytedance/seedance-2.5\n  baker studio animate 'slow drone pull-back over a solar farm at golden hour, no people' --from text --model bytedance/seedance-2.5 --duration 12"
@@ -66390,7 +67305,7 @@ var animateCommand = defineCommand210({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -66478,11 +67393,11 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-function parseJsonArg(raw, flag2) {
+function parseJsonArg(raw, flag3) {
   try {
     return JSON.parse(raw);
   } catch {
-    throw new ApiError("VALIDATION_ERROR", `--${flag2} must be valid JSON (got: ${raw})`);
+    throw new ApiError("VALIDATION_ERROR", `--${flag3} must be valid JSON (got: ${raw})`);
   }
 }
 function referenceLimitFor(model) {
@@ -66526,7 +67441,7 @@ function buildGenerateBody(args5, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand211({
+var generateCommand = defineCommand212({
   meta: {
     name: "generate",
     description: "Start here to make an image. Renders 1-8 takes of one brief, ingests each into the media library as it lands, and shows the batch in the dashboard Studio next to the ones the client ran.\n\nModel choice: google/gemini-3.1-flash-image-preview (default \u2014 fast, best at editing a reference and at extreme ratios), google/gemini-3-pro-image-preview (highest fidelity, slower), openai/gpt-image-2 (photoreal and the cleanest in-image text \u2014 no --image-size, no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/flat marks with palette control).\n\n--reference is the biggest quality lever there is: a real logo, product shot, Pinterest pin or sandbox screenshot beats any amount of adjectives.\n\nExamples:\n  baker studio generate 'matte black bottle on wet marble, hard studio light, 35mm' --aspect-ratio 3:2 --count 3\n  baker studio generate 'this bottle on a sunlit kitchen counter' --reference './src/brand/product.png,https://\u2026/kitchen.jpg'\n  baker studio generate 'founder-style selfie, kitchen background, natural light' --skill ugc-selfie-hook\n  baker studio generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
@@ -66609,7 +67524,7 @@ var generateCommand = defineCommand211({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 registerSchema({
   command: "studio.get",
   description: "Read one Studio batch: every take, where it lives, and why a take is missing. This is how you pick up a batch that was still rendering when the start command returned.",
@@ -66618,7 +67533,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand212({
+var getCommand5 = defineCommand213({
   meta: {
     name: "get",
     description: "Read one Studio batch \u2014 the takes, their urls, whether each is in the library, and the reason for any that failed.\n\nExample: baker studio get j57abc123def456ghi789\nExample: baker studio get j57abc123def456ghi789 --full"
@@ -66647,7 +67562,7 @@ var getCommand5 = defineCommand212({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand214 } from "citty";
 var DESCRIPTION2 = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
 registerSchema({
   command: "studio.improve",
@@ -66672,7 +67587,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand213({
+var improveCommand = defineCommand214({
   meta: {
     name: "improve",
     description: `${DESCRIPTION2}
@@ -66716,7 +67631,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 registerSchema({
   command: "studio.keep",
   description: "Mark one take as the keeper. For an image this stars it, so the client reviewing the batch sees which one you used. For a CLIP it is the step that puts it in the video library \u2014 until then the clip cannot be used in a canvas, a landing, or an ad.",
@@ -66726,7 +67641,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand214({
+var keepCommand = defineCommand215({
   meta: {
     name: "keep",
     description: "Mark one take as the keeper. An image gets starred (it was already in the library); a clip gets INGESTED into the video library, which is what makes it usable anywhere else.\n\nExample: baker studio keep j57abc123def456ghi789 --slot 2\nExample: baker studio keep j57abc123def456ghi789 --slot 2 --undo"
@@ -66777,7 +67692,7 @@ var keepCommand = defineCommand214({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 registerSchema({
   command: "studio.list",
   description: "Recent Studio batches for THIS conversation, newest first \u2014 what you have already generated, so you re-use a take instead of paying for it twice. `--all` widens it to everything the company generated, including what people ran themselves in the dashboard.",
@@ -66788,7 +67703,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand18 = defineCommand215({
+var listCommand18 = defineCommand216({
   meta: {
     name: "list",
     description: "Recent Studio batches, newest first. Scoped to this conversation unless you pass --all.\n\nExample: baker studio list\nExample: baker studio list --kind video --limit 5\nExample: baker studio list --all   # includes batches the client ran in the dashboard"
@@ -66822,7 +67737,7 @@ var listCommand18 = defineCommand215({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } from "citty";
 var DESCRIPTION3 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
 registerSchema({
   command: "studio.models",
@@ -66909,7 +67824,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand216({
+var modelsCommand = defineCommand217({
   meta: {
     name: "models",
     description: `${DESCRIPTION3}
@@ -66956,13 +67871,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } from "citty";
 registerSchema({
   command: "studio.skills",
   description: "The craft directions `studio generate --skill <id>` accepts. Each one carries directed art direction plus the model, shape and take count it wants, so you pick a look by name instead of writing the boilerplate yourself.",
   args: {}
 });
-var skillsCommand = defineCommand217({
+var skillsCommand = defineCommand218({
   meta: {
     name: "skills",
     description: "List the craft directions available to `baker studio generate --skill <id>` \u2014 what each one is for, whether it wants a reference image, and the model/shape/count it defaults to.\n\nExample: baker studio skills"
@@ -66986,7 +67901,7 @@ var skillsCommand = defineCommand217({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand218({
+var studioCommand = defineCommand219({
   meta: {
     name: "studio",
     description: `Make new imagery and clips. Every batch is recorded and shows up in the dashboard Studio for the client to review, labelled with this conversation.
@@ -67029,10 +67944,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync20 } from "fs";
@@ -67048,21 +67963,21 @@ function requireTarget6(args5, entity) {
   }
   return target2;
 }
-function loadJsonArg2(args5, flag2 = "json") {
-  const inline = args5[flag2];
+function loadJsonArg2(args5, flag3 = "json") {
+  const inline = args5[flag3];
   const file = args5.file;
   const raw = typeof file === "string" && file.length > 0 ? readFileSync20(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
   if (raw === void 0) {
-    failValidation5(`pass --${flag2} with inline JSON or --file with a path to a JSON file`);
+    failValidation5(`pass --${flag3} with inline JSON or --file with a path to a JSON file`);
   }
   try {
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failValidation5(`--${flag2} must be a JSON object`);
+      failValidation5(`--${flag3} must be a JSON object`);
     }
     return parsed;
   } catch {
-    return failValidation5(`--${flag2} is not valid JSON`);
+    return failValidation5(`--${flag3} is not valid JSON`);
   }
 }
 var RETRYABLE_CODES2 = /* @__PURE__ */ new Set(["RATE_LIMITED", "UNAVAILABLE", "INTERNAL_ERROR", "NETWORK_ERROR", "TIMEOUT"]);
@@ -67155,13 +68070,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand5 = defineCommand219({
+var draftCommand5 = defineCommand220({
   meta: {
     name: "draft",
     description: "List, show, amend, remove, or clear staged Tag Manager changes for this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
   },
   subCommands: {
-    list: defineCommand219({
+    list: defineCommand220({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -67174,7 +68089,7 @@ var draftCommand5 = defineCommand219({
         await draftList2(args5.json === true, args5.chat);
       }
     }),
-    show: defineCommand219({
+    show: defineCommand220({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -67191,7 +68106,7 @@ var draftCommand5 = defineCommand219({
         );
       }
     }),
-    amend: defineCommand219({
+    amend: defineCommand220({
       meta: {
         name: "amend",
         description: "Update a staged change in place \u2014 merges a JSON patch into its payload (objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create."
@@ -67208,7 +68123,7 @@ var draftCommand5 = defineCommand219({
         });
       }
     }),
-    remove: defineCommand219({
+    remove: defineCommand220({
       meta: { name: "remove", description: "Remove one staged change (cascades to anything depending on it)" },
       args: { ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false } },
       run: async ({ args: args5 }) => {
@@ -67217,7 +68132,7 @@ var draftCommand5 = defineCommand219({
         });
       }
     }),
-    clear: defineCommand219({
+    clear: defineCommand220({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -67227,7 +68142,7 @@ var draftCommand5 = defineCommand219({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand221 } from "citty";
 registerSchema({
   command: "tagManager.containers",
   description: "List the Google Tag Manager containers this company's connection can reach. Every container the company connected is flagged `connected: true` \u2014 there can be several, and Baker may read and change all of them. Start here to confirm which containers you are managing.",
@@ -67268,7 +68183,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand220({
+var containersCommand = defineCommand221({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -67285,7 +68200,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand220({
+var readCommand = defineCommand221({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -67327,7 +68242,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand222 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -67383,10 +68298,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand221({
+  return defineCommand222({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand221({
+      create: defineCommand222({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -67408,7 +68323,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand221({
+      update: defineCommand222({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -67428,7 +68343,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand221({
+      delete: defineCommand222({
         meta: { name: "delete", description: `Stage the deletion of a ${noun} (pass its id or path)` },
         args: {
           id: { type: "positional", description: `${noun} id or path`, required: false },
@@ -67469,7 +68384,7 @@ function builtinTypes(args5) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand221({
+var builtinCommand = defineCommand222({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -67479,7 +68394,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand221({
+    enable: defineCommand222({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -67493,7 +68408,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand221({
+    disable: defineCommand222({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -67511,7 +68426,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand222({
+var tagManagerCommand = defineCommand223({
   meta: {
     name: "tag-manager",
     description: `Read and change what lives inside the client's Google Tag Manager container \u2014 tags, triggers, variables, folders and built-in variables.
@@ -67548,7 +68463,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -67628,7 +68543,7 @@ async function listTags(json) {
 var listArgs11 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand19 = defineCommand223({
+var listCommand19 = defineCommand224({
   meta: {
     name: "list",
     description: "Effective tags for this chat (production + staged), with each tag's full readable config (secrets excluded) \u2014 reuse a stored value to pre-fill a change rather than asking the user. Refs printed here are what flow side-effect tagIds should use. Example: baker tags list"
@@ -67647,7 +68562,7 @@ async function listDraft4(chat) {
     failApi3(err);
   }
 }
-var draftCommand6 = defineCommand223({
+var draftCommand6 = defineCommand224({
   meta: {
     name: "draft",
     description: "Review the tag changes staged in this chat (read-only). Staged changes were approved via request_tag_input and apply when the chat is published; to amend or drop one, propose a follow-up change through the same tool (a delete on a tag_temp_* ref drops the staged create). Takes --chat <id> to read an earlier chat's staged changes instead."
@@ -67657,7 +68572,7 @@ var draftCommand6 = defineCommand223({
     await listDraft4(args5.chat);
   }
 });
-var tagsCommand4 = defineCommand223({
+var tagsCommand4 = defineCommand224({
   meta: {
     name: "tags",
     description: `Read the client's marketing/analytics tags (Meta pixel, GA4, Google Ads, GTM, Clarity, Hotjar, \u2026) \u2014 production tags plus the changes staged in this chat.
@@ -67686,10 +68601,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand228 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -67697,7 +68612,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand224({
+var getCommand6 = defineCommand225({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -67734,7 +68649,7 @@ var getCommand6 = defineCommand224({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -67883,15 +68798,15 @@ var PARAM_NAMES = {
 };
 function buildListParams(args5) {
   const params2 = {};
-  for (const [flag2, param] of Object.entries(PARAM_NAMES)) {
-    const value = args5[flag2];
+  for (const [flag3, param] of Object.entries(PARAM_NAMES)) {
+    const value = args5[flag3];
     if (value !== void 0 && value !== "") {
       params2[param] = String(value);
     }
   }
   return params2;
 }
-var listCommand20 = defineCommand225({
+var listCommand20 = defineCommand226({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -67951,7 +68866,7 @@ var listCommand20 = defineCommand225({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -68030,7 +68945,7 @@ function buildSearchRequest(query, args5) {
   }
   return body;
 }
-var searchCommand3 = defineCommand226({
+var searchCommand3 = defineCommand227({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -68094,7 +69009,7 @@ var searchCommand3 = defineCommand226({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand227({
+var testimonialsCommand = defineCommand228({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -68116,10 +69031,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand236 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand229 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -68133,7 +69048,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand228({
+var deleteCommand4 = defineCommand229({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -68174,7 +69089,7 @@ var deleteCommand4 = defineCommand228({
 });
 
 // src/commands/videos/describe.ts
-import { defineCommand as defineCommand229 } from "citty";
+import { defineCommand as defineCommand230 } from "citty";
 var DESCRIPTION_HELP2 = "What the clip actually shows, in the words someone would search for it by. This is what `baker videos search` retrieves on.";
 registerSchema({
   command: "videos.describe",
@@ -68191,7 +69106,7 @@ registerSchema({
     full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
   }
 });
-var describeCommand2 = defineCommand229({
+var describeCommand2 = defineCommand230({
   meta: {
     name: "describe",
     description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
@@ -68249,7 +69164,7 @@ Example: baker videos describe j571abc123 --description "Customer explaining how
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand230 } from "citty";
+import { defineCommand as defineCommand231 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -68257,7 +69172,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand230({
+var getCommand7 = defineCommand231({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -68294,7 +69209,7 @@ var getCommand7 = defineCommand230({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand231 } from "citty";
+import { defineCommand as defineCommand232 } from "citty";
 registerSchema({
   command: "videos.group",
   description: "List every clip and image that arrived in the same set as this video (carousel slides, one page)",
@@ -68303,7 +69218,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand231({
+var groupCommand2 = defineCommand232({
   meta: {
     name: "group",
     description: "List every asset that arrived in the same set as this clip \u2014 the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>"
@@ -68326,7 +69241,7 @@ var groupCommand2 = defineCommand231({
 import { mkdtemp as mkdtemp3, rm as rm9, stat as stat11 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
 import path47 from "path";
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand233 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -68490,7 +69405,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand232({
+var ingestCommand2 = defineCommand233({
   meta: {
     name: "ingest",
     description: "Add a video to the library from a URL. A direct file URL is handed straight to Baker, which fetches it. A page URL (YouTube, TikTok, Vimeo, Instagram) is downloaded here first, then uploaded \u2014 and a direct URL that Baker cannot fetch falls back to that same path automatically.\n\nExample: baker videos ingest https://www.youtube.com/watch?v=abc123"
@@ -68752,7 +69667,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand233 } from "citty";
+import { defineCommand as defineCommand234 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -68762,7 +69677,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand233({
+var searchCommand4 = defineCommand234({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -68814,7 +69729,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile33, stat as stat12 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand235 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -68856,7 +69771,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand234({
+var uploadCommand2 = defineCommand235({
   meta: {
     name: "upload",
     description: "Upload a video to Baker \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: auto-detects content type and uploads via Mux direct upload.\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\n\nExamples:\n  baker videos upload ./demo.mp4\n  baker videos upload https://www.youtube.com/watch?v=abc123"
@@ -68940,7 +69855,7 @@ var uploadCommand2 = defineCommand234({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand235({
+var videosCommand = defineCommand236({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, describe, delete, tags.
@@ -68969,10 +69884,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand248 } from "citty";
+import { defineCommand as defineCommand249 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand236 } from "citty";
+import { defineCommand as defineCommand237 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList3(value) {
@@ -69025,7 +69940,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand236({
+var advertisersCommand2 = defineCommand237({
   meta: {
     name: "advertisers",
     description: 'List corpus advertisers by name or domain. Find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id / winners. Example: baker winning-ads advertisers "Deel" --output md'
@@ -69083,7 +69998,7 @@ var advertisersCommand2 = defineCommand236({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand237 } from "citty";
+import { defineCommand as defineCommand238 } from "citty";
 registerSchema({
   command: "winning-ads.brief",
   description: "Generate a creative brief grounded in strategically-similar winning ads. Optionally describe the target creative with --dna (JSON) and steer with --notes.",
@@ -69129,7 +70044,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand237({
+var briefCommand = defineCommand238({
   meta: {
     name: "brief",
     description: `Generate a creative brief from winning references. Example: baker winning-ads brief --dna '{"angle":"cost savings"}' --notes "B2B, LinkedIn video" --k 8`
@@ -69165,7 +70080,7 @@ var briefCommand = defineCommand237({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand238 } from "citty";
+import { defineCommand as defineCommand239 } from "citty";
 registerSchema({
   command: "winning-ads.content",
   description: "Read what's INSIDE one winning ad: the spoken transcript, the on-screen text, and the ad copy. Use this after `search`/`winners`/`feed` return a shortlist \u2014 pass an ad_id to understand a reference before reproducing it. Add --full for speech, pacing, and soundtrack detail. Video ads carry the transcript/on-screen text; static ads carry only the copy.",
@@ -69178,7 +70093,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand238({
+var contentCommand = defineCommand239({
   meta: {
     name: "content",
     description: "Read the transcript + on-screen text + copy of one winning ad. Example: baker winning-ads content adg_123 --platform meta --full --output md"
@@ -69227,7 +70142,7 @@ var contentCommand = defineCommand238({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand239 } from "citty";
+import { defineCommand as defineCommand240 } from "citty";
 function buildFeedParams(input) {
   const params2 = {};
   const advertiser = splitList3(input.advertiser);
@@ -69279,7 +70194,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand2 = defineCommand239({
+var feedCommand2 = defineCommand240({
   meta: {
     name: "feed",
     description: "Winners across every brand you follow (browse, then trim per advertiser). Example: baker winning-ads feed --per-advertiser 5 --output md"
@@ -69364,7 +70279,7 @@ var feedCommand2 = defineCommand239({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand240 } from "citty";
+import { defineCommand as defineCommand241 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -69379,7 +70294,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand240({
+var followCommand = defineCommand241({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks every platform we can resolve. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -69426,7 +70341,7 @@ var followCommand = defineCommand240({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand241 } from "citty";
+import { defineCommand as defineCommand242 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -69459,7 +70374,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand241({
+var followCompetitorsCommand = defineCommand242({
   meta: {
     name: "follow-competitors",
     description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
@@ -69534,7 +70449,7 @@ var followCompetitorsCommand = defineCommand241({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand242 } from "citty";
+import { defineCommand as defineCommand243 } from "citty";
 registerSchema({
   command: "winning-ads.following",
   description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts. A brand still adding has counts that are a lie in progress; one with `discovery_failed` has counts that are short because we couldn't finish looking, which is not the same as it running no ads.",
@@ -69588,7 +70503,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand242({
+var followingCommand = defineCommand243({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md"
@@ -69624,7 +70539,7 @@ var followingCommand = defineCommand242({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand243 } from "citty";
+import { defineCommand as defineCommand244 } from "citty";
 registerSchema({
   command: "winning-ads.patterns",
   description: "Mine what separates two cohorts of ads: pass a comma-list of winning ad ids (--winners) and a comma-list of weaker ad ids (--duds). Returns the discriminating DNA fields.",
@@ -69663,7 +70578,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand243({
+var patternsCommand = defineCommand244({
   meta: {
     name: "patterns",
     description: "Discover what separates winning ads from weak ones. Example: baker winning-ads patterns --winners a_1,a_2,a_3 --duds a_9,a_8 --output md"
@@ -69719,7 +70634,7 @@ var patternsCommand = defineCommand243({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand244 } from "citty";
+import { defineCommand as defineCommand245 } from "citty";
 registerSchema({
   command: "winning-ads.search",
   description: "Search the ad-dna corpus of scored winning ads. Returns a lean shortlist (advertiser, summary, scores, media_url) to pick a reference to reproduce.",
@@ -69857,7 +70772,7 @@ function reportSearchError(err) {
   }
   reportError2(err);
 }
-var searchCommand5 = defineCommand244({
+var searchCommand5 = defineCommand245({
   meta: {
     name: "search",
     description: "Search winning reference ads. Example: baker winning-ads search 'B2B SaaS before/after AI automation' --platform meta --format static --winner-category winner --exclude-advertiser adv_123 --output md"
@@ -69977,7 +70892,7 @@ var searchCommand5 = defineCommand244({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand245 } from "citty";
+import { defineCommand as defineCommand246 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -70005,7 +70920,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand245({
+  return defineCommand246({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -70054,7 +70969,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand246 } from "citty";
+import { defineCommand as defineCommand247 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -70062,7 +70977,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand246({
+var unfollowCommand = defineCommand247({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -70083,7 +70998,7 @@ var unfollowCommand = defineCommand246({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand247 } from "citty";
+import { defineCommand as defineCommand248 } from "citty";
 registerSchema({
   command: "winning-ads.winners",
   description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
@@ -70093,7 +71008,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand247({
+var winnersCommand = defineCommand248({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -70143,7 +71058,7 @@ var winnersCommand = defineCommand247({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand248({
+var winningAdsCommand = defineCommand249({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -70335,16 +71250,16 @@ function commandFor(root, argv) {
   return resolved ? command : null;
 }
 function suggestFlag(unknown, command) {
-  const flag2 = closestFlag(unknown, command);
-  if (!flag2) {
+  const flag3 = closestFlag(unknown, command);
+  if (!flag3) {
     return null;
   }
   const args5 = argsOf(command) ?? {};
-  const name = flag2.slice(2);
+  const name = flag3.slice(2);
   const def = args5[name] ?? args5[camel(name)];
   const described = def && typeof def === "object" ? def.description : void 0;
   const description = typeof described === "string" ? described.split(/(?<!\b(?:e\.g|i\.e|vs))\.\s/)[0]?.trim().replace(/\.$/, "") : "";
-  return description ? { flag: flag2, description } : { flag: flag2 };
+  return description ? { flag: flag3, description } : { flag: flag3 };
 }
 function suggestionText(suggestion) {
   if (!suggestion) {
@@ -70362,7 +71277,7 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion, hasSchema) {
       message: `${list} ${unknown.length > 1 ? "are not options" : "is not an option"} of \`baker ${commandPath}\`.`,
       fix: {
         action: hasSchema ? "check_schema" : "check_help",
-        explanation: (unknown.some((flag2) => flag2 === "--output" || flag2.startsWith("--output=")) ? OUTPUT_EXPLANATION : "") + suggestionText(suggestion) + `Run \`${hasSchema ? `baker schema ${commandPath}` : `baker ${commandPath} --help`}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
+        explanation: (unknown.some((flag3) => flag3 === "--output" || flag3.startsWith("--output=")) ? OUTPUT_EXPLANATION : "") + suggestionText(suggestion) + `Run \`${hasSchema ? `baker schema ${commandPath}` : `baker ${commandPath} --help`}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
       },
       retryable: false
     }
@@ -70420,13 +71335,13 @@ function declaredArg(command, name) {
 }
 function envelopeRequests(argv) {
   const end = argv.indexOf("--");
-  const limit = end === -1 ? argv.length : end;
+  const limit2 = end === -1 ? argv.length : end;
   const found = [];
-  for (let index = 0; index < limit; index++) {
+  for (let index = 0; index < limit2; index++) {
     const token = argv[index];
     if (token === `${FLAG}=${ENVELOPE}`) {
       found.push({ index, length: 1 });
-    } else if (token === FLAG && argv[index + 1] === ENVELOPE && index + 1 < limit) {
+    } else if (token === FLAG && argv[index + 1] === ENVELOPE && index + 1 < limit2) {
       found.push({ index, length: 2 });
       index++;
     }
@@ -70470,7 +71385,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand249({
+var main = defineCommand250({
   meta: {
     name: "baker",
     version: getCliVersion(),