@koda-sl/baker-cli 0.274.0 → 0.275.0

package/dist/cli.js

@@ -109,7 +109,7 @@ import {
 } from "./chunk-DZUVUGEP.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand229, runMain } from "citty";
+import { defineCommand as defineCommand230, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -6048,6 +6048,43 @@ var researchFetchResponseSchema = z18.object({
   truncated: z18.boolean(),
   provider: z18.literal("firecrawl")
 });
+var RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS = 700;
+var RESEARCH_KEYWORD_METRICS_MAX_KEYWORD_CHARS = 80;
+var researchKeywordMetricsRequestSchema = z18.object({
+  keywords: z18.array(z18.string().min(1).max(RESEARCH_KEYWORD_METRICS_MAX_KEYWORD_CHARS)).min(1).max(RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS),
+  /** Country code (`mx`, `br`, …) or a DataForSEO location code. */
+  location: z18.union([z18.string(), z18.number()]).optional(),
+  language: z18.string().optional(),
+  /**
+   * Ask for DataForSEO's own panel-derived volume alongside Google's. Off by
+   * default because it doubles the price of the request — and because the
+   * Google number is the one every other Baker surface quotes.
+   */
+  includeClickstream: z18.boolean().default(false),
+  skipCache: z18.boolean().optional()
+});
+var monthlySearchSchema = z18.object({
+  year: z18.number(),
+  month: z18.number(),
+  search_volume: z18.number()
+});
+var researchKeywordMetricsRowSchema = z18.object({
+  keyword: z18.string(),
+  search_volume: z18.number().nullable(),
+  cpc: z18.number().nullable(),
+  low_top_of_page_bid: z18.number().nullable(),
+  high_top_of_page_bid: z18.number().nullable(),
+  competition: z18.string().nullable(),
+  competition_index: z18.number().nullable(),
+  keyword_difficulty: z18.number().nullable(),
+  main_intent: z18.string().nullable(),
+  monthly_searches: z18.array(monthlySearchSchema),
+  /** Populated only when `includeClickstream` was set. */
+  clickstream_search_volume: z18.number().nullable()
+});
+var researchKeywordMetricsResponseSchema = z18.object({
+  data: z18.array(researchKeywordMetricsRowSchema)
+});
 
 // ../api/src/scheduledTaskModes.ts
 var TASK_MODES = {
@@ -48150,7 +48187,7 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand181 } from "citty";
+import { defineCommand as defineCommand182 } from "citty";
 
 // src/commands/research/advertisers.ts
 import { defineCommand as defineCommand170 } from "citty";
@@ -48221,6 +48258,25 @@ function webDepthHints({
   }
   return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];
 }
+function keywordMetricsHints({
+  rows,
+  asked,
+  clickstream,
+  queryContext
+}) {
+  if (rows.length === 0) {
+    return noSerpRowsHints(0, queryContext);
+  }
+  const provenance = "DataForSEO resells Google's Keyword Planner volume \u2014 planner_search_volume here is the SAME number `baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing sources is not corroboration." + (clickstream ? " clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting." : " For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: `baker gsc query` for what already reaches the site, or the account's own search terms.");
+  const hints2 = [provenance];
+  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);
+  if (empty.length > 0) {
+    hints2.push(
+      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ${empty.join(", ")}. That is missing coverage, NOT zero demand \u2014 do not report them as unsearched, and do not re-query them reworded. \`baker research autocomplete\` on the head term is the way to find the phrasing that market uses.`
+    );
+  }
+  return hints2;
+}
 
 // src/commands/research/output.ts
 var RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
@@ -48862,8 +48918,170 @@ Examples:
   }
 });
 
-// src/commands/research/keywords-for-site.ts
+// src/commands/research/keyword-metrics.ts
 import { defineCommand as defineCommand176 } from "citty";
+
+// src/commands/research/keyword-metrics-rows.ts
+var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
+function toOutputRow(row, options) {
+  const out = {
+    source: KEYWORD_METRICS_SOURCE,
+    keyword: row.keyword,
+    planner_search_volume: row.search_volume,
+    planner_cpc: row.cpc,
+    planner_low_top_of_page_bid: row.low_top_of_page_bid,
+    planner_high_top_of_page_bid: row.high_top_of_page_bid,
+    planner_competition: row.competition,
+    planner_competition_index: row.competition_index
+  };
+  if (options.clickstream) {
+    out.clickstream_search_volume = row.clickstream_search_volume;
+  }
+  if (options.full) {
+    out.keyword_difficulty = row.keyword_difficulty;
+    out.main_intent = row.main_intent;
+    out.planner_monthly_searches = row.monthly_searches;
+  }
+  return out;
+}
+function keywordMetricsFields(options) {
+  const fields = {
+    source: `Always "${KEYWORD_METRICS_SOURCE}". Every planner_ column below is Google's Keyword Planner ESTIMATE of total market volume, resold by DataForSEO \u2014 the same number \`baker ads google keywords metrics\` returns, not an independent measurement of it. Columns without the planner_ prefix are DataForSEO's own.`,
+    keyword: "The keyword asked for. A row with every metric null means DataForSEO holds no data on it \u2014 not that nobody searches it.",
+    planner_search_volume: "ESTIMATE: average monthly searches across the whole market, last 12 months",
+    planner_cpc: "ESTIMATE: average cost per click in USD (a single blended figure, not a top-of-page range)",
+    planner_low_top_of_page_bid: "ESTIMATE: low-range top-of-page bid in USD",
+    planner_high_top_of_page_bid: "ESTIMATE: high-range top-of-page bid in USD",
+    planner_competition: "ESTIMATE: competition level \u2014 LOW, MEDIUM or HIGH",
+    planner_competition_index: "ESTIMATE: competition index 0-100 (higher = more advertisers)"
+  };
+  if (options.clickstream) {
+    fields.clickstream_search_volume = "DataForSEO's OWN volume estimate, from clickstream panels \u2014 not Google's, and the only number here that is a genuine second opinion on demand. Expect it to differ from planner_search_volume; that is the point.";
+  }
+  if (options.full) {
+    fields.keyword_difficulty = "DataForSEO's 0-100 estimate of how hard ranking in the organic top 10 would be";
+    fields.main_intent = "DataForSEO's intent classification: informational, navigational, commercial or transactional";
+    fields.planner_monthly_searches = "ESTIMATE: 12-month volume breakdown ({year, month, search_volume})";
+  }
+  return fields;
+}
+
+// src/commands/research/keyword-metrics.ts
+registerSchema({
+  command: "research.keyword-metrics",
+  description: "Search volume, CPC, top-of-page bids and competition for a list of keywords YOU name \u2014 no domain needed. This is the command for sizing a market you have keywords for; the domain-bound ones (keywords-for-site, keyword-gap) answer a different question and should not be used as a workaround for this one. The volume is Google's Keyword Planner figure resold by DataForSEO, so it is NOT a second opinion on `baker ads google keywords metrics` \u2014 for that, pass --clickstream. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+  args: {
+    keywords: {
+      type: "string",
+      description: `Comma-separated keywords (max ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS}, 80 chars each)`,
+      required: true
+    },
+    location: {
+      type: "string",
+      description: "Country code (us, mx, br, es...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. DEFAULTS TO en (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    clickstream: {
+      type: "boolean",
+      description: "Also return DataForSEO's own panel-derived volume (clickstream_search_volume), the only genuinely independent estimate of demand available here. Costs 2x.",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Add keyword difficulty, search intent and the 12-month volume trend to each row",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var keywordMetricsCommand = defineCommand176({
+  meta: {
+    name: "keyword-metrics",
+    description: `Volume, CPC and competition for keywords you name. No domain required.
+
+Numbers are Keyword Planner ESTIMATES of total market volume, resold by DataForSEO \u2014 every column carrying one is named planner_. Pass --clickstream for DataForSEO's own independent estimate alongside.
+
+Examples:
+  baker research keyword-metrics "chatbot whatsapp,agente whatsapp ecommerce" --location mx --language es
+  baker research keyword-metrics "chatbot whatsapp" --location br --language pt --clickstream
+  baker research keyword-metrics "crm software,best crm" --full --output md`
+  },
+  args: {
+    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    clickstream: { type: "boolean", description: "Add DataForSEO's own volume estimate (costs 2x)", required: false },
+    full: { type: "boolean", description: "Add difficulty, intent and the 12-month trend", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const keywords = args.keywords.split(",").map((k) => k.trim()).filter(Boolean);
+    if (keywords.length === 0) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword" }
+      });
+      process.exit(1);
+    }
+    if (keywords.length > RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS) {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `Maximum ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} keywords per request`,
+          fix: {
+            action: "retry_with_changes",
+            explanation: `You sent ${keywords.length}. Split the list into batches of ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} and run the command once per batch \u2014 each batch is a separate charge, so batch by priority.`
+          }
+        }
+      });
+      process.exit(1);
+    }
+    const location2 = args.location || void 0;
+    const language = args.language || void 0;
+    const clickstream = Boolean(args.clickstream);
+    const full = Boolean(args.full);
+    const queryContext = buildResearchQueryContext(location2, language);
+    try {
+      const result = await apiPost("/api/research/keyword-metrics", {
+        keywords,
+        location: location2,
+        language,
+        includeClickstream: clickstream,
+        skipCache: args["no-cache"] ? true : void 0
+      });
+      const columns = { clickstream, full };
+      const rows = result.data.map((row) => toOutputRow(row, columns));
+      const hints2 = keywordMetricsHints({ rows: result.data, asked: keywords, clickstream, queryContext });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput(rows, format);
+        writeResearchHints([...hints2, RESEARCH_DATA_NOTE], format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data: rows,
+        fields: keywordMetricsFields(columns),
+        note: RESEARCH_DATA_NOTE,
+        hints: hints2,
+        query_context: queryContext
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+
+// src/commands/research/keywords-for-site.ts
+import { defineCommand as defineCommand177 } from "citty";
 registerSchema({
   command: "research.keywords-for-site",
   description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
@@ -48896,7 +49114,7 @@ var FIELDS9 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand176({
+var keywordsForSiteCommand = defineCommand177({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -48958,7 +49176,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand178 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -48988,7 +49206,7 @@ var FIELDS10 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand177({
+var languagesCommand2 = defineCommand178({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -48999,7 +49217,7 @@ var languagesCommand2 = defineCommand177({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand178 } from "citty";
+import { defineCommand as defineCommand179 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -49018,7 +49236,7 @@ var FIELDS11 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand178({
+var lighthouseCommand = defineCommand179({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -49056,7 +49274,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand179 } from "citty";
+import { defineCommand as defineCommand180 } from "citty";
 registerSchema({
   command: "research.relevant-pages",
   description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -49082,7 +49300,7 @@ var FIELDS12 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand179({
+var relevantPagesCommand = defineCommand180({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -49129,7 +49347,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand180 } from "citty";
+import { defineCommand as defineCommand181 } from "citty";
 registerSchema({
   command: "research.web",
   description: "Search the web with AI to answer marketing questions \u2014 competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).",
@@ -49180,7 +49398,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand180({
+var webCommand = defineCommand181({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -49242,7 +49460,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand181({
+var researchCommand = defineCommand182({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -49253,6 +49471,7 @@ Commands:
   advertisers        \u2014 Who's bidding on a keyword?
   autocomplete       \u2014 Google Autocomplete suggestions
   intent             \u2014 Google Search intent classification
+  keyword-metrics    \u2014 Volume/CPC/competition for keywords you name (no domain)
   keywords-for-site  \u2014 Keywords a domain bids on
   keyword-gap        \u2014 Keywords they have that we don't
   relevant-pages     \u2014 Top pages of a competitor domain
@@ -49266,6 +49485,7 @@ Examples:
   baker research fetch "https://competitor.com/pricing"
   baker research advertisers "running shoes"
   baker research intent "buy running shoes,best running shoes 2026"
+  baker research keyword-metrics "chatbot whatsapp,crm whatsapp" --location mx --language es
   baker research keywords-for-site "competitor.com"
   baker research keyword-gap "them.com" "us.com"
 Full guide: __tooling__/docs/tools/baker/research.md`
@@ -49277,6 +49497,7 @@ Full guide: __tooling__/docs/tools/baker/research.md`
     autocomplete: autocompleteCommand,
     countries: countriesCommand,
     intent: intentCommand,
+    "keyword-metrics": keywordMetricsCommand,
     "keywords-for-site": keywordsForSiteCommand,
     "keyword-gap": keywordGapCommand,
     languages: languagesCommand2,
@@ -49286,10 +49507,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand189 } from "citty";
+import { defineCommand as defineCommand190 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand182 } from "citty";
+import { defineCommand as defineCommand183 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -49445,7 +49666,7 @@ registerSchema({
     }
   }
 });
-var createCommand3 = defineCommand182({
+var createCommand3 = defineCommand183({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -49504,7 +49725,7 @@ var createCommand3 = defineCommand182({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand183 } from "citty";
+import { defineCommand as defineCommand184 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -49512,7 +49733,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand3 = defineCommand183({
+var deleteCommand3 = defineCommand184({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -49541,7 +49762,7 @@ var deleteCommand3 = defineCommand183({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand184 } from "citty";
+import { defineCommand as defineCommand185 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -49550,7 +49771,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand4 = defineCommand184({
+var getCommand4 = defineCommand185({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -49589,7 +49810,7 @@ var getCommand4 = defineCommand184({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand185 } from "citty";
+import { defineCommand as defineCommand186 } from "citty";
 registerSchema({
   command: "scheduled-actions.list",
   description: "List published scheduled actions. Includes draft state when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged schedules instead.",
@@ -49597,7 +49818,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var listCommand15 = defineCommand185({
+var listCommand15 = defineCommand186({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged schedules instead."
@@ -49622,7 +49843,7 @@ var listCommand15 = defineCommand185({
 // src/commands/scheduled-actions/templates.ts
 import { readFile as readFile23 } from "fs/promises";
 import path36 from "path";
-import { defineCommand as defineCommand186 } from "citty";
+import { defineCommand as defineCommand187 } from "citty";
 registerSchema({
   command: "scheduled-actions.templates",
   description: "The recipes available to this company: the ones Baker ships plus the ones they wrote themselves, each with its id, what it produces and how often it is meant to run. Read this before proposing a company's automation, so every recipe you name is one that exists. Also how a company gets a recipe of its own \u2014 save a brief, prove it runs, then publish it.",
@@ -49677,7 +49898,7 @@ registerSchema({
     }
   }
 });
-var templatesCommand = defineCommand186({
+var templatesCommand = defineCommand187({
   meta: {
     name: "templates",
     description: `The recipes this company can run \u2014 Baker's own plus theirs, with what each one produces.
@@ -49769,7 +49990,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand187 } from "citty";
+import { defineCommand as defineCommand188 } from "citty";
 registerSchema({
   command: "scheduled-actions.trigger",
   description: "Immediately trigger a published scheduled action. Does not require BAKER_CHAT_ID and rejects temp_sched_* IDs.",
@@ -49777,7 +49998,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand187({
+var triggerCommand = defineCommand188({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -49814,7 +50035,7 @@ var triggerCommand = defineCommand187({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand188 } from "citty";
+import { defineCommand as defineCommand189 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -49845,7 +50066,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand3 = defineCommand188({
+var updateCommand3 = defineCommand189({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Examples: baker scheduled-actions update <id> --enabled false | baker scheduled-actions update <id> --mode publish"
@@ -49923,7 +50144,7 @@ var updateCommand3 = defineCommand188({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand189({
+var scheduledActionsCommand = defineCommand190({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger, templates.
@@ -49952,14 +50173,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand191 } from "citty";
 function narrowToFamily(commandName, available) {
   const segments = commandName.split(".");
   const prefix = segments[0] === "ads" && segments[1] ? `ads.${segments[1]}.` : `${segments[0]}.`;
   const siblings = available.filter((name) => name.startsWith(prefix));
   return siblings.length > 0 ? siblings : available;
 }
-var schemaCommand2 = defineCommand190({
+var schemaCommand2 = defineCommand191({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -50003,10 +50224,10 @@ var schemaCommand2 = defineCommand190({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand200 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand192 } from "citty";
 
 // src/commands/studio/batch.ts
 function projectBatch(generation, full) {
@@ -50457,7 +50678,7 @@ function costHintsFor(body) {
   }
   return hints2;
 }
-var animateCommand = defineCommand191({
+var animateCommand = defineCommand192({
   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 '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"
@@ -50576,7 +50797,7 @@ var animateCommand = defineCommand191({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand193 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -50712,7 +50933,7 @@ function buildGenerateBody(args, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand192({
+var generateCommand = defineCommand193({
   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]]'"
@@ -50790,7 +51011,7 @@ var generateCommand = defineCommand192({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand194 } 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.",
@@ -50799,7 +51020,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand193({
+var getCommand5 = defineCommand194({
   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"
@@ -50828,7 +51049,7 @@ var getCommand5 = defineCommand193({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand195 } from "citty";
 var DESCRIPTION = "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",
@@ -50853,7 +51074,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand194({
+var improveCommand = defineCommand195({
   meta: {
     name: "improve",
     description: `${DESCRIPTION}
@@ -50897,7 +51118,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand196 } 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.",
@@ -50907,7 +51128,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand195({
+var keepCommand = defineCommand196({
   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"
@@ -50958,7 +51179,7 @@ var keepCommand = defineCommand195({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand196 } from "citty";
+import { defineCommand as defineCommand197 } 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.",
@@ -50969,7 +51190,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand16 = defineCommand196({
+var listCommand16 = defineCommand197({
   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"
@@ -51003,7 +51224,7 @@ var listCommand16 = defineCommand196({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 var DESCRIPTION2 = "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",
@@ -51090,7 +51311,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand197({
+var modelsCommand = defineCommand198({
   meta: {
     name: "models",
     description: `${DESCRIPTION2}
@@ -51137,13 +51358,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand199 } 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 = defineCommand198({
+var skillsCommand = defineCommand199({
   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"
@@ -51167,7 +51388,7 @@ var skillsCommand = defineCommand198({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand199({
+var studioCommand = defineCommand200({
   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.
@@ -51210,10 +51431,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand203 } from "citty";
+import { defineCommand as defineCommand204 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand201 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync16 } from "fs";
@@ -51336,13 +51557,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand4 = defineCommand200({
+var draftCommand4 = defineCommand201({
   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: defineCommand200({
+    list: defineCommand201({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -51355,7 +51576,7 @@ var draftCommand4 = defineCommand200({
         await draftList2(args.json === true, args.chat);
       }
     }),
-    show: defineCommand200({
+    show: defineCommand201({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -51372,7 +51593,7 @@ var draftCommand4 = defineCommand200({
         );
       }
     }),
-    amend: defineCommand200({
+    amend: defineCommand201({
       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."
@@ -51389,7 +51610,7 @@ var draftCommand4 = defineCommand200({
         });
       }
     }),
-    remove: defineCommand200({
+    remove: defineCommand201({
       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 }) => {
@@ -51398,7 +51619,7 @@ var draftCommand4 = defineCommand200({
         });
       }
     }),
-    clear: defineCommand200({
+    clear: defineCommand201({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -51408,7 +51629,7 @@ var draftCommand4 = defineCommand200({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand202 } 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.",
@@ -51449,7 +51670,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand201({
+var containersCommand = defineCommand202({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -51466,7 +51687,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand201({
+var readCommand = defineCommand202({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -51508,7 +51729,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand203 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -51564,10 +51785,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand202({
+  return defineCommand203({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand202({
+      create: defineCommand203({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -51589,7 +51810,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand202({
+      update: defineCommand203({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -51609,7 +51830,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand202({
+      delete: defineCommand203({
         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 },
@@ -51650,7 +51871,7 @@ function builtinTypes(args) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand202({
+var builtinCommand = defineCommand203({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -51660,7 +51881,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand202({
+    enable: defineCommand203({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -51674,7 +51895,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand202({
+    disable: defineCommand203({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -51692,7 +51913,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand203({
+var tagManagerCommand = defineCommand204({
   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.
@@ -51729,7 +51950,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand205 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -51798,7 +52019,7 @@ async function listTags(json) {
 var listArgs9 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand17 = defineCommand204({
+var listCommand17 = defineCommand205({
   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"
@@ -51817,7 +52038,7 @@ async function listDraft3(chat) {
     failApi3(err);
   }
 }
-var draftCommand5 = defineCommand204({
+var draftCommand5 = defineCommand205({
   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."
@@ -51827,7 +52048,7 @@ var draftCommand5 = defineCommand204({
     await listDraft3(args.chat);
   }
 });
-var tagsCommand4 = defineCommand204({
+var tagsCommand4 = defineCommand205({
   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.
@@ -51856,10 +52077,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand209 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand206 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -51867,7 +52088,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand205({
+var getCommand6 = defineCommand206({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -51904,7 +52125,7 @@ var getCommand6 = defineCommand205({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand207 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -52061,7 +52282,7 @@ function buildListParams(args) {
   }
   return params;
 }
-var listCommand18 = defineCommand206({
+var listCommand18 = defineCommand207({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -52121,7 +52342,7 @@ var listCommand18 = defineCommand206({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand208 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -52200,7 +52421,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand3 = defineCommand207({
+var searchCommand3 = defineCommand208({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -52264,7 +52485,7 @@ var searchCommand3 = defineCommand207({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand208({
+var testimonialsCommand = defineCommand209({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -52286,10 +52507,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand209 } from "citty";
+import { defineCommand as defineCommand210 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -52303,7 +52524,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand209({
+var deleteCommand4 = defineCommand210({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -52344,7 +52565,7 @@ var deleteCommand4 = defineCommand209({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand211 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -52352,7 +52573,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand210({
+var getCommand7 = defineCommand211({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -52389,7 +52610,7 @@ var getCommand7 = defineCommand210({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand212 } 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)",
@@ -52398,7 +52619,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand211({
+var groupCommand2 = defineCommand212({
   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>"
@@ -52421,7 +52642,7 @@ var groupCommand2 = defineCommand211({
 import { mkdtemp as mkdtemp2, rm as rm7, stat as stat7 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
 import path37 from "path";
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -52585,7 +52806,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand212({
+var ingestCommand2 = defineCommand213({
   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"
@@ -52847,7 +53068,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand214 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -52857,7 +53078,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand213({
+var searchCommand4 = defineCommand214({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -52909,7 +53130,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile24, stat as stat8 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -52951,7 +53172,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand214({
+var uploadCommand2 = defineCommand215({
   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"
@@ -53035,7 +53256,7 @@ var uploadCommand2 = defineCommand214({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand215({
+var videosCommand = defineCommand216({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, delete, tags.
@@ -53062,10 +53283,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand229 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList2(value) {
@@ -53118,7 +53339,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand216({
+var advertisersCommand2 = defineCommand217({
   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'
@@ -53176,7 +53397,7 @@ var advertisersCommand2 = defineCommand216({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } 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.",
@@ -53222,7 +53443,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand217({
+var briefCommand = defineCommand218({
   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`
@@ -53258,7 +53479,7 @@ var briefCommand = defineCommand217({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand219 } 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.",
@@ -53271,7 +53492,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand218({
+var contentCommand = defineCommand219({
   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"
@@ -53320,7 +53541,7 @@ var contentCommand = defineCommand218({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList2(input.advertiser);
@@ -53372,7 +53593,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand219({
+var feedCommand = defineCommand220({
   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"
@@ -53457,7 +53678,7 @@ var feedCommand = defineCommand219({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand221 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -53472,7 +53693,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand220({
+var followCommand = defineCommand221({
   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'
@@ -53519,7 +53740,7 @@ var followCommand = defineCommand220({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand222 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -53552,7 +53773,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand221({
+var followCompetitorsCommand = defineCommand222({
   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"'
@@ -53627,7 +53848,7 @@ var followCompetitorsCommand = defineCommand221({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand223 } 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.",
@@ -53681,7 +53902,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand222({
+var followingCommand = defineCommand223({
   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"
@@ -53717,7 +53938,7 @@ var followingCommand = defineCommand222({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand224 } 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.",
@@ -53756,7 +53977,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand223({
+var patternsCommand = defineCommand224({
   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"
@@ -53812,7 +54033,7 @@ var patternsCommand = defineCommand223({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand225 } 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.",
@@ -53920,7 +54141,7 @@ function buildSearchBody2(args) {
   }
   return body;
 }
-var searchCommand5 = defineCommand224({
+var searchCommand5 = defineCommand225({
   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"
@@ -54035,7 +54256,7 @@ var searchCommand5 = defineCommand224({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -54063,7 +54284,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand225({
+  return defineCommand226({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -54112,7 +54333,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -54120,7 +54341,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand226({
+var unfollowCommand = defineCommand227({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -54141,7 +54362,7 @@ var unfollowCommand = defineCommand226({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand228 } 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.",
@@ -54151,7 +54372,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand227({
+var winnersCommand = defineCommand228({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -54201,7 +54422,7 @@ var winnersCommand = defineCommand227({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand228({
+var winningAdsCommand = defineCommand229({
   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.
@@ -54439,7 +54660,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand229({
+var main = defineCommand230({
   meta: {
     name: "baker",
     version: getCliVersion(),