@koda-sl/baker-cli 0.296.0 → 0.297.0

package/dist/cli.js

@@ -109,7 +109,7 @@ import {
 } from "./chunk-DZUVUGEP.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand237, runMain } from "citty";
+import { defineCommand as defineCommand239, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -6155,6 +6155,24 @@ var imagesGroupResponseSchema = z18.object({
 });
 var imagesDeleteRequestSchema = z18.object({ id: z18.string().min(1, "Missing image ID") });
 var imagesDeleteResponseSchema = z18.object({ ok: z18.literal(true) });
+var imagesDescribeRequestSchema = z18.object({
+  id: z18.string().min(1, "Missing image ID"),
+  name: z18.string().min(1).optional(),
+  description: z18.string().min(1).optional(),
+  tags: z18.array(z18.string()).optional(),
+  /** Return the whole library row alongside the three fields that changed. */
+  full: z18.boolean().optional()
+}).refine((body) => body.name !== void 0 || body.description !== void 0 || body.tags !== void 0, {
+  message: "Pass at least one of name, description or tags"
+});
+var imagesDescribeResponseSchema = z18.object({
+  id: z18.string(),
+  name: z18.string(),
+  description: z18.string(),
+  tags: z18.array(z18.string()),
+  /** Present only when the request asked for it. */
+  image: imagesGetResponseSchema.optional()
+});
 var imagesUpscaleRequestSchema = z18.object({ imageId: z18.string().min(1, "Missing image ID") });
 var imagesUpscaleResponseSchema = z18.object({
   imageId: z18.string(),
@@ -7078,6 +7096,24 @@ var videosIngestResponseSchema = z24.object({
   videoId: z24.string(),
   deduped: z24.boolean()
 });
+var videosDescribeRequestSchema = z24.object({
+  id: z24.string().min(1, "Missing video ID"),
+  name: z24.string().min(1).optional(),
+  description: z24.string().min(1).optional(),
+  tags: z24.array(z24.string()).optional(),
+  /** Return the whole library row alongside the three fields that changed. */
+  full: z24.boolean().optional()
+}).refine((body) => body.name !== void 0 || body.description !== void 0 || body.tags !== void 0, {
+  message: "Pass at least one of name, description or tags"
+});
+var videosDescribeResponseSchema = z24.object({
+  id: z24.string(),
+  name: z24.string(),
+  description: z24.string(),
+  tags: z24.array(z24.string()),
+  /** Present only when the request asked for it. */
+  video: videosGetResponseSchema.optional()
+});
 var videosDeleteRequestSchema = z24.object({ id: z24.string().min(1, "Missing video ID") });
 var videosDeleteResponseSchema = z24.object({ ok: z24.literal(true) });
 
@@ -45204,7 +45240,7 @@ Full guide: __tooling__/docs/tools/baker/hubspot.md`
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand163 } from "citty";
+import { defineCommand as defineCommand164 } from "citty";
 
 // src/commands/images/crop.ts
 import { defineCommand as defineCommand138 } from "citty";
@@ -45419,9 +45455,118 @@ var deleteCommand2 = defineCommand139({
   }
 });
 
-// src/commands/images/dimensions.ts
+// src/commands/images/describe.ts
 import { defineCommand as defineCommand140 } from "citty";
 
+// src/lib/describeArgs.ts
+function describeTags(rawArgs, parsed) {
+  const given = repeatedValues(rawArgs, "tags", parsed);
+  if (given.length === 0) return void 0;
+  return given.flatMap((chunk) => chunk.split(",").map((tag) => tag.trim())).filter(Boolean);
+}
+function describeHints(noun, body) {
+  const search = noun === "images" ? "baker images library" : "baker videos search";
+  const hints2 = [];
+  if (body.description !== void 0) {
+    hints2.push(
+      `The semantic index rebuilds in the background \u2014 a \`${search}\` run right now may still rank on the old description.`
+    );
+  }
+  if (body.tags !== void 0) {
+    hints2.push(`--tags replaced the whole tag set. Run \`baker ${noun} get <id>\` first if you meant to add to it.`);
+  }
+  return hints2.length > 0 ? hints2 : void 0;
+}
+function describeFields(args, rawArgs) {
+  const fields = {};
+  if (args.description) fields.description = args.description;
+  if (args.name) fields.name = args.name;
+  const tags = describeTags(rawArgs, args.tags);
+  if (tags !== void 0) fields.tags = tags;
+  return fields;
+}
+function describeErrorFix(code, noun) {
+  if (code !== "CONFLICT") return void 0;
+  return `Poll \`baker ${noun} get <id>\` until \`status\` reads "ready", then run this again. Do not retry immediately \u2014 the answer will not change until the analysis lands.`;
+}
+
+// src/commands/images/describe.ts
+var DESCRIPTION_HELP = "What the image actually shows, in the words someone would search for it by. This is what `baker images library` retrieves on.";
+registerSchema({
+  command: "images.describe",
+  description: "Correct a library image's stored name, description or tags. Start here when an image's description is wrong \u2014 it is what semantic search reads.",
+  args: {
+    id: { type: "string", description: "Image ID", required: true },
+    description: { type: "string", description: DESCRIPTION_HELP, required: false },
+    name: { type: "string", description: "Short human label for the image", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the image \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
+  }
+});
+var describeCommand = defineCommand140({
+  meta: {
+    name: "describe",
+    description: `Correct what the library says an image is. Only the fields you pass change; the rest keep their current values.
+
+Start here when a search keeps missing an image you know is there, or when the AI description got the subject wrong.
+
+Example: baker images describe j571abc123 --description "Founder speaking on stage at SaaStr, blue backdrop" --tags event,team`
+  },
+  args: {
+    id: { type: "positional", description: "Image ID", required: false },
+    "image-id": { type: "string", description: "Image ID (alternative to positional)", required: false },
+    description: { type: "string", description: DESCRIPTION_HELP, required: false },
+    name: { type: "string", description: "Short human label for the image", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the image \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row", required: false, default: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const id = args.id || args["image-id"];
+    if (!id) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Image ID is required" } });
+      process.exit(1);
+    }
+    const fields = describeFields(args, rawArgs);
+    if (fields.name === void 0 && fields.description === void 0 && fields.tags === void 0) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Nothing to change",
+          fix: "Pass at least one of --description, --name or --tags."
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      validateConvexId(id);
+      const body = { id, ...fields };
+      if (args.full) body.full = true;
+      const data = await apiPost("/api/images/describe", body);
+      writeJson({ ok: true, data, hints: describeHints("images", fields) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const fix = describeErrorFix(err.code, "images");
+        writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/images/dimensions.ts
+import { defineCommand as defineCommand141 } from "citty";
+
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
 function getDimensionsFromBuffer(buffer) {
@@ -45449,7 +45594,7 @@ registerSchema({
     }
   }
 });
-var dimensionsCommand = defineCommand140({
+var dimensionsCommand = defineCommand141({
   meta: {
     name: "dimensions",
     description: "Read image dimensions without decoding the full file.\n\nExample: baker images dimensions ./logo.png\nExample: baker images dimensions https://acme.com/hero.png"
@@ -45505,7 +45650,7 @@ var dimensionsCommand = defineCommand140({
 });
 
 // src/commands/images/download.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 
 // src/commands/images/downloadPaths.ts
 import { basename as basename2, extname as extname3, join as join6 } from "path";
@@ -45746,7 +45891,7 @@ function emitError3(err) {
   writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
-var downloadCommand = defineCommand141({
+var downloadCommand = defineCommand142({
   meta: {
     name: "download",
     description: "Download image URLs and/or library images to local files \u2014 the missing first half of `source \u2192 download \u2192 normalize \u2192 place`. Never use `curl` for this.\n\nExamples:\n  baker images download https://media.withbaker.com/\u2026/logo.webp\n  baker images download j57abc123 j57def456 --out src/pages/pricing/_images/\n  baker images download https://\u2026/hero.png --out ./hero.png"
@@ -45779,7 +45924,7 @@ var downloadCommand = defineCommand141({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 
 // src/commands/images/autoIngest.ts
 var AUTO_INGEST_MAX = {
@@ -45826,7 +45971,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand142({
+var extractCommand = defineCommand143({
   meta: {
     name: "extract",
     description: "Pull every image from a single URL via Firecrawl. ~$0.001/scrape. Cap auto-ingest at 20.\n\nExample: baker images extract https://stripe.com --auto-ingest 5"
@@ -45881,7 +46026,7 @@ var extractCommand = defineCommand142({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 
 // src/commands/images/providerHits.ts
 function asRecord3(value) {
@@ -46019,7 +46164,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var findCommand = defineCommand143({
+var findCommand = defineCommand144({
   meta: {
     name: "find",
     description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs.\n\nExample: baker images find 'office' --sources library,pexels --limit 20"
@@ -46092,7 +46237,7 @@ var findCommand = defineCommand143({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand145 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -46100,7 +46245,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand3 = defineCommand144({
+var getCommand3 = defineCommand145({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -46136,7 +46281,7 @@ var getCommand3 = defineCommand144({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -46168,7 +46313,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand145({
+var gifCommand = defineCommand146({
   meta: {
     name: "gif",
     description: "Search Giphy for GIFs / reaction memes \u2014 built for paid-social creative (Meta, TikTok, LinkedIn, X). Free API. Each hit carries WebP + GIF + MP4 URLs in providerMeta so you can pick the right format per platform.\n\nExample: baker images gif 'this is fine' --limit 10\nExample: baker images gif 'office reaction' --rating pg --auto-ingest 2\nExample: baker images gif --trending --limit 25"
@@ -46215,7 +46360,7 @@ var gifCommand = defineCommand145({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand147 } from "citty";
 var GOOGLE_ERROR_FIX = {
   action: "use_different_resource",
   explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
@@ -46255,7 +46400,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand146({
+var googleCommand2 = defineCommand147({
   meta: {
     name: "google",
     description: "Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). \u26A0 Source unverified \u2014 watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20"
@@ -46328,7 +46473,7 @@ var googleCommand2 = defineCommand146({
 });
 
 // src/commands/images/group.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand148 } from "citty";
 
 // src/commands/mediaGroup.ts
 async function runMediaGroupLookup(input) {
@@ -46381,7 +46526,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand = defineCommand147({
+var groupCommand = defineCommand148({
   meta: {
     name: "group",
     description: "List every asset that arrived in the same set \u2014 the slides of one Instagram carousel, the images off one scraped page. Start here whenever a hit looks like part of a sequence: carousel slides are authored to be read in order and usually only make sense together. Takes an image or a video id, since one carousel can contain both. Example: baker images group <imageId>"
@@ -46401,7 +46546,7 @@ var groupCommand = defineCommand147({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand148 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 
 // src/commands/images/brandVerification.ts
 function brandToken(domain) {
@@ -46498,7 +46643,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var iconCommand = defineCommand148({
+var iconCommand = defineCommand149({
   meta: {
     name: "icon",
     description: "Icon via Iconify (simple-icons, logos, lucide, devicon, heroicons, tabler, phosphor, material-symbols, \u2026). Free CDN, no API key.\n\nExample: baker images icon react --set devicon\nExample: baker images icon lucide:check --color '#0a0a0a'"
@@ -46568,7 +46713,7 @@ var iconCommand = defineCommand148({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand149 } from "citty";
+import { defineCommand as defineCommand150 } from "citty";
 var SOURCE_VALUES = imageSourceSchema.options.join(" | ");
 registerSchema({
   command: "images.ingest",
@@ -46583,7 +46728,7 @@ registerSchema({
     fields: { type: "string", description: "Comma-separated field names to include", required: false }
   }
 });
-var ingestCommand = defineCommand149({
+var ingestCommand = defineCommand150({
   meta: {
     name: "ingest",
     description: "Download a remote URL and store it in the library. Hash-deduped on bytes + externalId.\n\nExample: baker images ingest https://images.pexels.com/photos/13219418/pexels-photo-13219418.jpeg --source pexels --external-id 13219418"
@@ -46652,7 +46797,7 @@ var ingestCommand = defineCommand149({
 });
 
 // src/commands/images/layerize.ts
-import { defineCommand as defineCommand150 } from "citty";
+import { defineCommand as defineCommand151 } from "citty";
 registerSchema({
   command: "images.layerize",
   description: "Split a library image into editable layers: transparent PNG cutouts for each element, plus any headline recovered as EDITABLE TEXT with its font, size, colour and position. Waits for completion by default. Costs credits.",
@@ -46716,7 +46861,7 @@ async function pollUntilSettled(imageId, maxWait) {
   }
   return null;
 }
-var layerizeCommand = defineCommand150({
+var layerizeCommand = defineCommand151({
   meta: {
     name: "layerize",
     description: "Split a library image into editable layers \u2014 transparent cutouts per element, plus any baked-in headline recovered as editable text with its typography.\n\nStart here: baker images layerize j571abc123def\nExample: baker images layerize j571abc123def --full\nExample: baker images layerize j571abc123def --instructions 'keep the product and its shadow together'"
@@ -46785,7 +46930,7 @@ registerSchema({
     full: { type: "boolean", description: "Include geometry and typography for every layer", required: false }
   }
 });
-var layersCommand = defineCommand150({
+var layersCommand = defineCommand151({
   meta: {
     name: "layers",
     description: "Read the layers of an image that has already been split. Free \u2014 no provider call.\n\nStart here: baker images layers j571abc123def\nExample: baker images layers j571abc123def --full"
@@ -46825,7 +46970,7 @@ var layersCommand = defineCommand150({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand151 } from "citty";
+import { defineCommand as defineCommand152 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -46851,7 +46996,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand151({
+var libraryCommand = defineCommand152({
   meta: {
     name: "library",
     description: "Search the company image library (hybrid BM25 + vector + Cohere rerank). Use this BEFORE any external provider.\n\nExample: baker images library 'hero banner' --aspect-ratio 16:9 --source magnific"
@@ -46914,7 +47059,7 @@ var libraryCommand = defineCommand151({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand152 } from "citty";
+import { defineCommand as defineCommand153 } from "citty";
 registerSchema({
   command: "images.logo",
   description: "Brand logo lookup via Brandfetch. Auto-ingests by default. Returns `brandMatch` \u2014 Brandfetch's own verdict on whose brand the domain is (confirmed | mismatch | unverified). Branch on it: `mismatch` means the mark is another company's, so do not place it. `confirmed` verifies the record, not the artwork \u2014 read the ingested row back to check the mark itself.",
@@ -46942,7 +47087,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var logoCommand = defineCommand152({
+var logoCommand = defineCommand153({
   meta: {
     name: "logo",
     description: "Brand logo via Brandfetch. Returns up to 5 variants (icon, light/dark logo, light/dark symbol) plus `brandMatch`. Auto-ingests the first variant.\n\nStart here: check `brandMatch.verdict`.\n  mismatch   \u2192 the mark belongs to `brandMatch.name`, a different company. Do not place it.\n  unverified \u2192 nothing confirmed whose logo this is. Treat as unchecked.\n  confirmed  \u2192 Brandfetch has this brand's record. That verifies the record, NOT the artwork \u2014 a confirmed domain has served another company's logo before.\n\n\u26A0 Whatever the verdict, read the ingested row back with `baker images get <imageId>` and check `textInImage`/`subject` before placing it. That is the only check that looks at the mark.\n\nExample: baker images logo stripe.com --variant logo"
@@ -47015,7 +47160,7 @@ var logoCommand = defineCommand152({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand153 } from "citty";
+import { defineCommand as defineCommand154 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -47747,7 +47892,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand2 = defineCommand153({
+var normalizeCommand2 = defineCommand154({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -47802,7 +47947,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand154 } from "citty";
+import { defineCommand as defineCommand155 } from "citty";
 registerSchema({
   command: "images.pinterest",
   description: "Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing \u2014 Pinterest is unverified, trademark-bearing web content.",
@@ -47822,7 +47967,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand154({
+var pinterestCommand = defineCommand155({
   meta: {
     name: "pinterest",
     description: "Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery \u2014 lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. \u26A0 Unverified, trademark-bearing web content \u2014 inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\n\nExamples:\n  baker images pinterest 'scandinavian living room'\n  baker images pinterest 'minimalist skincare product photography' --limit 20\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'"
@@ -47879,7 +48024,7 @@ var pinterestCommand = defineCommand154({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand155 } from "citty";
+import { defineCommand as defineCommand156 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -47898,7 +48043,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var screenshotCommand = defineCommand155({
+var screenshotCommand = defineCommand156({
   meta: {
     name: "screenshot",
     description: "Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\n\nExample: baker images screenshot https://stripe.com --full-page"
@@ -47962,7 +48107,7 @@ var screenshotCommand = defineCommand155({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand156 } from "citty";
+import { defineCommand as defineCommand157 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -47978,7 +48123,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand156({
+var searchCommand = defineCommand157({
   meta: {
     name: "search",
     description: "Semantic search images by text query. Uses hybrid BM25 + vector + reranking. Example: baker images search 'hero banner' --aspect-ratio 16:9 --tags logo"
@@ -48038,7 +48183,7 @@ var searchCommand = defineCommand156({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand157 } from "citty";
+import { defineCommand as defineCommand158 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -48070,7 +48215,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand157({
+var stickerCommand = defineCommand158({
   meta: {
     name: "sticker",
     description: "Search Giphy's sticker corpus \u2014 transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\n\nExample: baker images sticker 'thumbs up' --limit 10\nExample: baker images sticker celebration --rating g --auto-ingest 3\nExample: baker images sticker --trending --limit 25"
@@ -48117,7 +48262,7 @@ var stickerCommand = defineCommand157({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand158 } from "citty";
+import { defineCommand as defineCommand159 } from "citty";
 var STOCK_ERROR_FIX = {
   action: "use_different_resource",
   explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
@@ -48197,7 +48342,7 @@ function partialLibraryHints(errors, hitCount) {
     `These results are partial: ${names} did not answer, so they come from the remaining library alone. Treat a thin result as unproven rather than as "stock does not have this", and report the outage rather than re-running the search.`
   ];
 }
-var stockCommand = defineCommand158({
+var stockCommand = defineCommand159({
   meta: {
     name: "stock",
     description: "Stock search across the free libraries \u2014 Pexels photographs plus Pixabay photographs, illustrations and vectors. No per-request cost. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'hero photo of a kitchen' --orientation landscape --size large\n  baker images stock 'flat office workers' --type illustration\n  baker images stock 'leaf outline mark' --type vector\n  baker images stock 'smiling carpenter portrait' --orientation portrait"
@@ -48272,7 +48417,7 @@ var stockCommand = defineCommand158({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand159 } from "citty";
+import { defineCommand as defineCommand160 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -48281,7 +48426,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand159({
+  return defineCommand160({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -48317,7 +48462,7 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand3 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { defineCommand as defineCommand160 } from "citty";
+import { defineCommand as defineCommand161 } from "citty";
 registerSchema({
   command: "images.upload",
   description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
@@ -48355,7 +48500,7 @@ registerSchema({
 function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand = defineCommand160({
+var uploadCommand = defineCommand161({
   meta: {
     name: "upload",
     description: "Upload an image to the library \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: reads bytes, sends to /api/images/upload, content-type auto-detected from extension.\nRemote: dispatches to /api/images/ingest with hash-dedup on bytes + externalId.\n\nExamples:\n  baker images upload ./logo.png --source uploaded\n  baker images upload ./cert.png --context 'ISO 27001 badge \u2014 enterprise tier'\n  baker images upload https://acme.com/hero.png --source firecrawl --context 'Acme competitor pricing hero'"
@@ -48448,7 +48593,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand161 } from "citty";
+import { defineCommand as defineCommand162 } from "citty";
 registerSchema({
   command: "images.upscale",
   description: "Upscale a library image via the backend (Replicate, cost-tracked). Waits for completion by default. The image must be status 'ready' and raster (not SVG/AVIF).",
@@ -48463,7 +48608,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var upscaleCommand = defineCommand161({
+var upscaleCommand = defineCommand162({
   meta: {
     name: "upscale",
     description: "Upscale a library image via the Convex backend (Replicate, cost-tracked at $0.05/image). Waits for completion by default.\n\nExample: baker images upscale j571abc123def\nExample: baker images upscale j571abc123def --max-wait 0   # fire-and-forget"
@@ -48518,7 +48663,7 @@ var upscaleCommand = defineCommand161({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand162 } from "citty";
+import { defineCommand as defineCommand163 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -48547,7 +48692,7 @@ function emitReady(ingestResult, doc, args) {
     args.full === true
   );
 }
-var useCommand = defineCommand162({
+var useCommand = defineCommand163({
   meta: {
     name: "use",
     description: "Sugar over `ingest`: download \u2192 store \u2192 wait until describe + embed complete \u2192 return ready library record.\n\nExample: baker images use https://cdn.example.com/hero.png --source uploaded"
@@ -48596,7 +48741,7 @@ var useCommand = defineCommand162({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand163({
+var imagesCommand = defineCommand164({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -48625,6 +48770,7 @@ Library writes (run on the Convex backend):
   baker images get <id>                                Get a single record
   baker images group <id>                              Every image that arrived in the same set (carousel, page scrape)
   baker images delete <id>                             Delete a record
+  baker images describe <id> --description "\u2026"         Correct a wrong name/description/tags \u2014 what library search reads on
 
 Local transforms (operate on files in the sandbox, before upload):
   baker images download <url|imageId\u2026> [--out \u2026]      Remote URL or library image \u2192 local file (never use curl)
@@ -48662,6 +48808,7 @@ Full guide: __tooling__/docs/tools/baker/images.md`
     search: searchCommand,
     upload: uploadCommand,
     delete: deleteCommand2,
+    describe: describeCommand,
     download: downloadCommand,
     normalize: normalizeCommand2,
     crop: cropCommand,
@@ -48674,12 +48821,12 @@ Full guide: __tooling__/docs/tools/baker/images.md`
 });
 
 // src/commands/landing/index.ts
-import { defineCommand as defineCommand175 } from "citty";
+import { defineCommand as defineCommand176 } from "citty";
 
 // src/commands/landing/critique.ts
 import { readdir as readdir12, readFile as readFile27, stat as stat8 } from "fs/promises";
 import path34 from "path";
-import { defineCommand as defineCommand164 } from "citty";
+import { defineCommand as defineCommand165 } from "citty";
 
 // src/engine/landing/lib/constants.ts
 var OVERUSED_FONTS = /* @__PURE__ */ new Set([
@@ -49987,7 +50134,7 @@ function fail6(code, message, fix) {
   );
   process.exit(2);
 }
-var critiqueCommand2 = defineCommand164({
+var critiqueCommand2 = defineCommand165({
   meta: {
     name: "critique",
     description: "Start here: `baker landing critique <slug>` after building or editing a landing. Deterministic design-quality critic (ADVISORY \u2014 findings never fail it). Flags the known AI design tells (gradient text, overused fonts, side-tab borders, cream palettes, buzzword copy, broken images) and positioning integrity (a concession ranking a competitor above the client, a rival named in a comparison) tiered block/warn/advisory, respecting the client's BRAND.md as the allowlist. Also records the critique that publishing requires \u2014 run it before finishing a landing."
@@ -50121,10 +50268,10 @@ async function isDir2(p) {
 }
 
 // src/commands/landing/inspiration/index.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand174 } from "citty";
 
 // src/commands/landing/inspiration/add.ts
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand166 } from "citty";
 
 // src/commands/landing/inspiration/shared.ts
 var INSPIRATION_HINTS = {
@@ -50206,7 +50353,7 @@ registerSchema({
     note: { type: "string", description: "Why this page is worth keeping", required: false }
   }
 });
-var addCommand = defineCommand165({
+var addCommand = defineCommand166({
   meta: {
     name: "add",
     description: "Add someone else's landing page to the reference library. Example: baker landing inspiration add https://linear.app --note 'the client likes this density'"
@@ -50248,7 +50395,7 @@ var addCommand = defineCommand165({
 // src/commands/landing/inspiration/code.ts
 import { mkdir as mkdir10, writeFile as writeFile14 } from "fs/promises";
 import path35 from "path";
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand167 } from "citty";
 registerSchema({
   command: "landing.inspiration.code",
   description: "Write a reference section's standalone HTML+CSS to .baker/inspiration/<id>/ so you can read how it is built. Reference only \u2014 the structure is the lesson, the words are not yours to reuse.",
@@ -50257,7 +50404,7 @@ registerSchema({
     full: { type: "boolean", description: "Print the markup inline as well as writing it", required: false }
   }
 });
-var codeCommand = defineCommand166({
+var codeCommand = defineCommand167({
   meta: {
     name: "code",
     description: "Write one reference section's standalone markup to disk. Example: baker landing inspiration code k57abc\u2026 \u2014 read it for structure, then build your own."
@@ -50303,7 +50450,7 @@ var codeCommand = defineCommand166({
 });
 
 // src/commands/landing/inspiration/favorites.ts
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand168 } from "citty";
 registerSchema({
   command: "landing.inspiration.favorites",
   description: "List the reference sections this company has saved. This is what `search` looks at by default, so it is the client's own taste profile \u2014 read it before proposing a direction.",
@@ -50317,7 +50464,7 @@ registerSchema({
     }
   }
 });
-var favoritesCommand = defineCommand167({
+var favoritesCommand = defineCommand168({
   meta: {
     name: "favorites",
     description: "List this company's saved reference sections. Example: baker landing inspiration favorites --type hero,pricing"
@@ -50397,7 +50544,7 @@ registerSchema({
     note: { type: "string", description: "Why this is worth keeping", required: false }
   }
 });
-var favoriteCommand = defineCommand167({
+var favoriteCommand = defineCommand168({
   meta: {
     name: "favorite",
     description: "Save a reference section to this company. Example: baker landing inspiration favorite k57abc\u2026"
@@ -50435,7 +50582,7 @@ registerSchema({
     page: { type: "boolean", description: "Treat the id as a page rather than a section", required: false }
   }
 });
-var unfavoriteCommand = defineCommand167({
+var unfavoriteCommand = defineCommand168({
   meta: {
     name: "unfavorite",
     description: "Remove a reference section from this company's saved set. Example: baker landing inspiration unfavorite k57abc\u2026"
@@ -50457,7 +50604,7 @@ var unfavoriteCommand = defineCommand167({
 });
 
 // src/commands/landing/inspiration/page.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand169 } from "citty";
 registerSchema({
   command: "landing.inspiration.page",
   description: "Show a whole reference page as a sequence: every section top to bottom with its type and the idea behind it. This is the view to use when the question is how a good page is ORDERED rather than what one section looks like.",
@@ -50474,7 +50621,7 @@ registerSchema({
     }
   }
 });
-var pageCommand2 = defineCommand168({
+var pageCommand2 = defineCommand169({
   meta: {
     name: "page",
     description: "Show how a reference page sequences its sections. Example: baker landing inspiration page j91xyz\u2026 \u2014 the blueprint, not the pixels."
@@ -50537,7 +50684,7 @@ var pageCommand2 = defineCommand168({
 });
 
 // src/commands/landing/inspiration/scrape.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand170 } from "citty";
 
 // src/engine/landing-library/proxyFailure.ts
 var PROXY_STATUS = 407;
@@ -52677,7 +52824,7 @@ registerSchema({
     report: { type: "boolean", description: "Write report.html. `--no-report` to skip", required: false }
   }
 });
-var scrapeCommand = defineCommand169({
+var scrapeCommand = defineCommand170({
   meta: {
     name: "scrape",
     description: "Capture a landing page to a directory, now. Example: baker landing inspiration scrape https://linear.app --out .baker/inspiration/linear.app"
@@ -52786,7 +52933,7 @@ var scrapeCommand = defineCommand169({
 
 // src/commands/landing/inspiration/search.ts
 import path40 from "path";
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 
 // src/commands/landing/inspiration/shot.ts
 import { mkdir as mkdir12, writeFile as writeFile17 } from "fs/promises";
@@ -52923,7 +53070,7 @@ async function downloadShots(results) {
   );
   return saved;
 }
-var searchCommand2 = defineCommand170({
+var searchCommand2 = defineCommand171({
   meta: {
     name: "search",
     description: "Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all"
@@ -53021,7 +53168,7 @@ var searchCommand2 = defineCommand170({
 });
 
 // src/commands/landing/inspiration/sequences.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 var COMPACT_TRANSITIONS = 12;
 var COMPACT_ENDS = 5;
 var MAX_PAGES = 50;
@@ -53095,7 +53242,7 @@ function sequencesHints(data, { scope, full }) {
   if (scope === "favorites") hints2.push(...favoritesScopeHints(data.favoritesHealth, data.pagesReturned));
   return hints2;
 }
-var sequencesCommand = defineCommand171({
+var sequencesCommand = defineCommand172({
   meta: {
     name: "sequences",
     description: "What section follows what, across many real pages at once. Example: baker landing inspiration sequences 'developer tool pricing page' --scope all \u2014 the evidence for how to order a page you are about to build."
@@ -53145,7 +53292,7 @@ var sequencesCommand = defineCommand171({
 
 // src/commands/landing/inspiration/view.ts
 import path41 from "path";
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand173 } from "citty";
 registerSchema({
   command: "landing.inspiration.view",
   description: "Everything known about one section: composition, motion, design tokens, the copy it uses, why it works, and what must change to make it yours. Downloads the desktop and mobile screenshots plus the motion filmstrip so you can look at them.",
@@ -53158,7 +53305,7 @@ registerSchema({
     }
   }
 });
-var viewCommand2 = defineCommand172({
+var viewCommand2 = defineCommand173({
   meta: {
     name: "view",
     description: "Full detail for one reference section. Example: baker landing inspiration view k57abc\u2026 \u2014 read the screenshots it saves before you build."
@@ -53242,7 +53389,7 @@ var viewCommand2 = defineCommand172({
 });
 
 // src/commands/landing/inspiration/index.ts
-var inspirationCommand = defineCommand173({
+var inspirationCommand = defineCommand174({
   meta: {
     name: "inspiration",
     description: `Reference library of real landing-page sections \u2014 look at how good pages actually solve a problem before you design one.
@@ -53290,7 +53437,7 @@ Full guide: __tooling__/docs/tools/baker/landing.md`
 import { randomUUID as randomUUID2 } from "crypto";
 import { mkdir as mkdir13, readdir as readdir13, readFile as readFile28, stat as stat9, writeFile as writeFile18 } from "fs/promises";
 import path42 from "path";
-import { defineCommand as defineCommand174 } from "citty";
+import { defineCommand as defineCommand175 } from "citty";
 registerSchema({
   command: "landing.variant",
   description: "Create a new variant of a page, for an A/B test. The variant shares the page's sections instead of copying them, so the only difference between the two is the one you fork \u2014 which is the only way the test measures what you think it measures. Run `baker experiment plan` FIRST: most pages cannot settle most questions.",
@@ -53518,7 +53665,7 @@ async function writeVariant(opts) {
   await writeFile18(path42.join(variantDir, "_images", ".gitkeep"), "", "utf8");
   return written;
 }
-var variantCommand = defineCommand174({
+var variantCommand = defineCommand175({
   meta: {
     name: "variant",
     description: "Create a new variant of a page, for an A/B test. The variant SHARES the page's sections and forks only the component you name, so the two versions differ by exactly the thing you are testing. It is a version of that page, not a page of its own: it is never indexed, never listed, and has no public URL \u2014 both versions answer at the page's own address. Run `baker experiment plan` first \u2014 most pages do not have the traffic to settle most questions."
@@ -53598,7 +53745,7 @@ var variantCommand = defineCommand174({
 });
 
 // src/commands/landing/index.ts
-var landingCommand = defineCommand175({
+var landingCommand = defineCommand176({
   meta: {
     name: "landing",
     description: `Design-quality tools for landing pages (src/pages/<slug>/).
@@ -53618,7 +53765,7 @@ Subcommands:
 });
 
 // src/commands/mcp/index.ts
-import { defineCommand as defineCommand176 } from "citty";
+import { defineCommand as defineCommand177 } from "citty";
 
 // src/commands/mcp/platforms.ts
 function readsKey(label) {
@@ -53687,7 +53834,7 @@ registerSchema({
   description: "List everything this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, \u2026), custom MCP servers, and the platforms the company signed in to (HubSpot, Google Ads, GA4, Search Console, Tag Manager) which you read through their own `baker` commands. Start here when the user mentions an external tool or platform.",
   args: {}
 });
-var connectedCommand = defineCommand176({
+var connectedCommand = defineCommand177({
   meta: {
     name: "connected",
     description: `Everything this chat can reach \u2014 managed integrations, custom MCP servers, and connected platforms.
@@ -53746,7 +53893,7 @@ registerSchema({
   description: "List the custom MCP servers this company's chats see (org + company + your own user scope).",
   args: {}
 });
-var listCommand15 = defineCommand176({
+var listCommand15 = defineCommand177({
   meta: { name: "list", description: "List custom MCP servers visible to this company's chats." },
   run: async () => {
     try {
@@ -53783,7 +53930,7 @@ registerSchema({
     header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
   }
 });
-var addCommand2 = defineCommand176({
+var addCommand2 = defineCommand177({
   meta: {
     name: "add",
     description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.
@@ -53835,7 +53982,7 @@ registerSchema({
   description: "Remove a company custom MCP server by name.",
   args: { name: { type: "string", description: "Server name to remove", required: true } }
 });
-var removeCommand5 = defineCommand176({
+var removeCommand5 = defineCommand177({
   meta: {
     name: "remove",
     description: `Remove a company custom MCP server by name.
@@ -53857,7 +54004,7 @@ Example:
     }
   }
 });
-var mcpCommand = defineCommand176({
+var mcpCommand = defineCommand177({
   meta: {
     name: "mcp",
     description: `Third-party tools for this company \u2014 see what's connected, register custom HTTPS MCP endpoints.
@@ -53883,10 +54030,10 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand189 } from "citty";
+import { defineCommand as defineCommand190 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand178 } from "citty";
 
 // src/commands/research/hints.ts
 var AD_COPY_ROUTE = 'This returns competing DOMAINS and their SERP economics \u2014 no ad copy, no headlines, no creative. For the actual copy of a competitor\'s ads: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). That corpus is Meta and LinkedIn only \u2014 Google SERP ad copy is not available through any Baker command, so do not keep querying for it here.';
@@ -54088,7 +54235,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand177({
+var advertisersCommand = defineCommand178({
   meta: {
     name: "advertisers",
     description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker winning-ads content <adId>\` (Meta/LinkedIn only).
@@ -54144,7 +54291,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand178 } from "citty";
+import { defineCommand as defineCommand179 } from "citty";
 registerSchema({
   command: "research.autocomplete",
   description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -54167,7 +54314,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand178({
+var autocompleteCommand = defineCommand179({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -54222,7 +54369,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand179 } from "citty";
+import { defineCommand as defineCommand180 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -54279,7 +54426,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand179({
+var countriesCommand = defineCommand180({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -54290,7 +54437,7 @@ var countriesCommand = defineCommand179({
 });
 
 // src/commands/research/fetch.ts
-import { defineCommand as defineCommand180 } from "citty";
+import { defineCommand as defineCommand181 } from "citty";
 var CONTENT_PREVIEW_CHARS = 2e4;
 var TIMEOUT_MS = 18e4;
 registerSchema({
@@ -54363,7 +54510,7 @@ function fetchFix(code) {
     explanation: "This read failed. Don't build a retry ladder around it \u2014 finish the rest of the job with what you can reach and name this page as a gap."
   };
 }
-var fetchCommand = defineCommand180({
+var fetchCommand = defineCommand181({
   meta: {
     name: "fetch",
     description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you \u2014 you never have to retry, wait, or drive a browser yourself.
@@ -54440,7 +54587,7 @@ Examples:
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand181 } from "citty";
+import { defineCommand as defineCommand182 } from "citty";
 registerSchema({
   command: "research.intent",
   description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. IMPORTANT: If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
@@ -54463,7 +54610,7 @@ var FIELDS7 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand181({
+var intentCommand = defineCommand182({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -54511,7 +54658,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand182 } from "citty";
+import { defineCommand as defineCommand183 } from "citty";
 registerSchema({
   command: "research.keyword-gap",
   description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. 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.",
@@ -54540,7 +54687,7 @@ var FIELDS8 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand182({
+var keywordGapCommand = defineCommand183({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -54615,7 +54762,7 @@ Examples:
 });
 
 // src/commands/research/keyword-metrics.ts
-import { defineCommand as defineCommand183 } from "citty";
+import { defineCommand as defineCommand184 } from "citty";
 
 // src/commands/research/keyword-metrics-rows.ts
 var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
@@ -54695,7 +54842,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
   }
 });
-var keywordMetricsCommand = defineCommand183({
+var keywordMetricsCommand = defineCommand184({
   meta: {
     name: "keyword-metrics",
     description: `Volume, CPC and competition for keywords you name. No domain required.
@@ -54777,7 +54924,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand184 } from "citty";
+import { defineCommand as defineCommand185 } 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.",
@@ -54810,7 +54957,7 @@ var FIELDS9 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand184({
+var keywordsForSiteCommand = defineCommand185({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -54872,7 +55019,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand185 } from "citty";
+import { defineCommand as defineCommand186 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -54902,7 +55049,7 @@ var FIELDS10 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand185({
+var languagesCommand2 = defineCommand186({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -54913,7 +55060,7 @@ var languagesCommand2 = defineCommand185({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand186 } from "citty";
+import { defineCommand as defineCommand187 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -54932,7 +55079,7 @@ var FIELDS11 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand186({
+var lighthouseCommand = defineCommand187({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -54970,7 +55117,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand187 } from "citty";
+import { defineCommand as defineCommand188 } 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).",
@@ -54996,7 +55143,7 @@ var FIELDS12 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand187({
+var relevantPagesCommand = defineCommand188({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -55043,7 +55190,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand188 } from "citty";
+import { defineCommand as defineCommand189 } 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).",
@@ -55094,7 +55241,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand188({
+var webCommand = defineCommand189({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -55156,7 +55303,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand189({
+var researchCommand = defineCommand190({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -55203,10 +55350,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand191 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -55362,7 +55509,7 @@ registerSchema({
     }
   }
 });
-var createCommand3 = defineCommand190({
+var createCommand3 = defineCommand191({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -55421,7 +55568,7 @@ var createCommand3 = defineCommand190({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand192 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -55429,7 +55576,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand3 = defineCommand191({
+var deleteCommand3 = defineCommand192({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -55458,7 +55605,7 @@ var deleteCommand3 = defineCommand191({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand193 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -55467,7 +55614,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand4 = defineCommand192({
+var getCommand4 = defineCommand193({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -55506,7 +55653,7 @@ var getCommand4 = defineCommand192({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand194 } 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.",
@@ -55514,7 +55661,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var listCommand16 = defineCommand193({
+var listCommand16 = defineCommand194({
   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."
@@ -55539,7 +55686,7 @@ var listCommand16 = defineCommand193({
 // src/commands/scheduled-actions/templates.ts
 import { readFile as readFile29 } from "fs/promises";
 import path43 from "path";
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand195 } 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.",
@@ -55594,7 +55741,7 @@ registerSchema({
     }
   }
 });
-var templatesCommand = defineCommand194({
+var templatesCommand = defineCommand195({
   meta: {
     name: "templates",
     description: `The recipes this company can run \u2014 Baker's own plus theirs, with what each one produces.
@@ -55686,7 +55833,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand196 } 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.",
@@ -55694,7 +55841,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand195({
+var triggerCommand = defineCommand196({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -55731,7 +55878,7 @@ var triggerCommand = defineCommand195({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand196 } from "citty";
+import { defineCommand as defineCommand197 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -55762,7 +55909,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand4 = defineCommand196({
+var updateCommand4 = defineCommand197({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Examples: baker scheduled-actions update <id> --enabled false | baker scheduled-actions update <id> --mode publish"
@@ -55840,7 +55987,7 @@ var updateCommand4 = defineCommand196({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand197({
+var scheduledActionsCommand = defineCommand198({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger, templates.
@@ -55869,14 +56016,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand199 } 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 = defineCommand198({
+var schemaCommand2 = defineCommand199({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -55920,10 +56067,10 @@ var schemaCommand2 = defineCommand198({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand208 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand200 } from "citty";
 
 // src/commands/studio/batch.ts
 function projectBatch(generation, full) {
@@ -56374,7 +56521,7 @@ function costHintsFor(body) {
   }
   return hints2;
 }
-var animateCommand = defineCommand199({
+var animateCommand = defineCommand200({
   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"
@@ -56493,7 +56640,7 @@ var animateCommand = defineCommand199({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand201 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -56629,7 +56776,7 @@ function buildGenerateBody(args, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand200({
+var generateCommand = defineCommand201({
   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]]'"
@@ -56707,7 +56854,7 @@ var generateCommand = defineCommand200({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand202 } 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.",
@@ -56716,7 +56863,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand201({
+var getCommand5 = defineCommand202({
   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"
@@ -56745,7 +56892,7 @@ var getCommand5 = defineCommand201({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand203 } 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",
@@ -56770,7 +56917,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand202({
+var improveCommand = defineCommand203({
   meta: {
     name: "improve",
     description: `${DESCRIPTION}
@@ -56814,7 +56961,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand203 } from "citty";
+import { defineCommand as defineCommand204 } 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.",
@@ -56824,7 +56971,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand203({
+var keepCommand = defineCommand204({
   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"
@@ -56875,7 +57022,7 @@ var keepCommand = defineCommand203({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand205 } 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.",
@@ -56886,7 +57033,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand17 = defineCommand204({
+var listCommand17 = defineCommand205({
   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"
@@ -56920,7 +57067,7 @@ var listCommand17 = defineCommand204({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand206 } 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",
@@ -57007,7 +57154,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand205({
+var modelsCommand = defineCommand206({
   meta: {
     name: "models",
     description: `${DESCRIPTION2}
@@ -57054,13 +57201,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand207 } 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 = defineCommand206({
+var skillsCommand = defineCommand207({
   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"
@@ -57084,7 +57231,7 @@ var skillsCommand = defineCommand206({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand207({
+var studioCommand = defineCommand208({
   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.
@@ -57127,10 +57274,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand209 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync18 } from "fs";
@@ -57253,13 +57400,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand5 = defineCommand208({
+var draftCommand5 = defineCommand209({
   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: defineCommand208({
+    list: defineCommand209({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -57272,7 +57419,7 @@ var draftCommand5 = defineCommand208({
         await draftList2(args.json === true, args.chat);
       }
     }),
-    show: defineCommand208({
+    show: defineCommand209({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -57289,7 +57436,7 @@ var draftCommand5 = defineCommand208({
         );
       }
     }),
-    amend: defineCommand208({
+    amend: defineCommand209({
       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."
@@ -57306,7 +57453,7 @@ var draftCommand5 = defineCommand208({
         });
       }
     }),
-    remove: defineCommand208({
+    remove: defineCommand209({
       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 }) => {
@@ -57315,7 +57462,7 @@ var draftCommand5 = defineCommand208({
         });
       }
     }),
-    clear: defineCommand208({
+    clear: defineCommand209({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -57325,7 +57472,7 @@ var draftCommand5 = defineCommand208({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand209 } from "citty";
+import { defineCommand as defineCommand210 } 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.",
@@ -57366,7 +57513,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand209({
+var containersCommand = defineCommand210({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -57383,7 +57530,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand209({
+var readCommand = defineCommand210({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -57425,7 +57572,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand211 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -57481,10 +57628,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand210({
+  return defineCommand211({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand210({
+      create: defineCommand211({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -57506,7 +57653,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand210({
+      update: defineCommand211({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -57526,7 +57673,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand210({
+      delete: defineCommand211({
         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 },
@@ -57567,7 +57714,7 @@ function builtinTypes(args) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand210({
+var builtinCommand = defineCommand211({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -57577,7 +57724,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand210({
+    enable: defineCommand211({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -57591,7 +57738,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand210({
+    disable: defineCommand211({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -57609,7 +57756,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand211({
+var tagManagerCommand = defineCommand212({
   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.
@@ -57646,7 +57793,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -57715,7 +57862,7 @@ async function listTags(json) {
 var listArgs10 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand18 = defineCommand212({
+var listCommand18 = defineCommand213({
   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"
@@ -57734,7 +57881,7 @@ async function listDraft4(chat) {
     failApi3(err);
   }
 }
-var draftCommand6 = defineCommand212({
+var draftCommand6 = defineCommand213({
   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."
@@ -57744,7 +57891,7 @@ var draftCommand6 = defineCommand212({
     await listDraft4(args.chat);
   }
 });
-var tagsCommand4 = defineCommand212({
+var tagsCommand4 = defineCommand213({
   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.
@@ -57773,10 +57920,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand214 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -57784,7 +57931,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand213({
+var getCommand6 = defineCommand214({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -57821,7 +57968,7 @@ var getCommand6 = defineCommand213({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -57978,7 +58125,7 @@ function buildListParams(args) {
   }
   return params;
 }
-var listCommand19 = defineCommand214({
+var listCommand19 = defineCommand215({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -58038,7 +58185,7 @@ var listCommand19 = defineCommand214({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -58117,7 +58264,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand3 = defineCommand215({
+var searchCommand3 = defineCommand216({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -58181,7 +58328,7 @@ var searchCommand3 = defineCommand215({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand216({
+var testimonialsCommand = defineCommand217({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -58203,10 +58350,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -58220,7 +58367,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand217({
+var deleteCommand4 = defineCommand218({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -58260,8 +58407,83 @@ var deleteCommand4 = defineCommand217({
   }
 });
 
+// src/commands/videos/describe.ts
+import { defineCommand as defineCommand219 } 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",
+  description: "Correct a library video's stored name, description or tags. Start here when a clip's description is wrong \u2014 it is what semantic search reads.",
+  args: {
+    id: { type: "string", description: "Video ID", required: true },
+    description: { type: "string", description: DESCRIPTION_HELP2, required: false },
+    name: { type: "string", description: "Short human label for the clip", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the clip \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
+  }
+});
+var describeCommand2 = defineCommand219({
+  meta: {
+    name: "describe",
+    description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
+
+Start here when a search keeps missing a clip you know is there, or when the AI description got the subject wrong.
+
+Example: baker videos describe j571abc123 --description "Customer explaining how onboarding cut their setup from a week to a day" --tags testimonial`
+  },
+  args: {
+    id: { type: "positional", description: "Video ID", required: false },
+    "video-id": { type: "string", description: "Video ID (alternative to positional)", required: false },
+    description: { type: "string", description: DESCRIPTION_HELP2, required: false },
+    name: { type: "string", description: "Short human label for the clip", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the clip \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row", required: false, default: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const id = args.id || args["video-id"];
+    if (!id) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Video ID is required" } });
+      process.exit(1);
+    }
+    const fields = describeFields(args, rawArgs);
+    if (fields.name === void 0 && fields.description === void 0 && fields.tags === void 0) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Nothing to change",
+          fix: "Pass at least one of --description, --name or --tags."
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      validateConvexId(id);
+      const body = { id, ...fields };
+      if (args.full) body.full = true;
+      const data = await apiPost("/api/videos/describe", body);
+      writeJson({ ok: true, data, hints: describeHints("videos", fields) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const fix = describeErrorFix(err.code, "videos");
+        writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -58269,7 +58491,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand218({
+var getCommand7 = defineCommand220({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -58306,7 +58528,7 @@ var getCommand7 = defineCommand218({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand221 } 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)",
@@ -58315,7 +58537,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand219({
+var groupCommand2 = defineCommand221({
   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>"
@@ -58338,7 +58560,7 @@ var groupCommand2 = defineCommand219({
 import { mkdtemp as mkdtemp2, rm as rm8, stat as stat10 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
 import path44 from "path";
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand222 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -58502,7 +58724,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand220({
+var ingestCommand2 = defineCommand222({
   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"
@@ -58764,7 +58986,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -58774,7 +58996,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand221({
+var searchCommand4 = defineCommand223({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -58826,7 +59048,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile30, stat as stat11 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -58868,7 +59090,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand222({
+var uploadCommand2 = defineCommand224({
   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"
@@ -58952,10 +59174,10 @@ var uploadCommand2 = defineCommand222({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand223({
+var videosCommand = defineCommand225({
   meta: {
     name: "videos",
-    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, delete, tags.
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, describe, delete, tags.
 
 Examples:
   baker videos search "product demo" --limit 5
@@ -58963,6 +59185,7 @@ Examples:
   baker videos get <video-id>
   baker videos upload ./demo.mp4
   baker videos ingest https://www.youtube.com/watch?v=abc123
+  baker videos describe <video-id> --description "Customer testimonial, 30s"
   baker videos delete <video-id> --dry-run
   baker videos tags
 Full guide: __tooling__/docs/tools/baker/videos.md`
@@ -58973,16 +59196,17 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
     search: searchCommand4,
     upload: uploadCommand2,
     ingest: ingestCommand2,
+    describe: describeCommand2,
     delete: deleteCommand4,
     tags: tagsCommand6
   }
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand236 } from "citty";
+import { defineCommand as defineCommand238 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList2(value) {
@@ -59035,7 +59259,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand224({
+var advertisersCommand2 = defineCommand226({
   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'
@@ -59093,7 +59317,7 @@ var advertisersCommand2 = defineCommand224({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand227 } 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.",
@@ -59139,7 +59363,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand225({
+var briefCommand = defineCommand227({
   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`
@@ -59175,7 +59399,7 @@ var briefCommand = defineCommand225({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand228 } 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.",
@@ -59188,7 +59412,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand226({
+var contentCommand = defineCommand228({
   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"
@@ -59237,7 +59461,7 @@ var contentCommand = defineCommand226({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand229 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList2(input.advertiser);
@@ -59289,7 +59513,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand227({
+var feedCommand = defineCommand229({
   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"
@@ -59374,7 +59598,7 @@ var feedCommand = defineCommand227({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand230 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -59389,7 +59613,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand228({
+var followCommand = defineCommand230({
   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'
@@ -59436,7 +59660,7 @@ var followCommand = defineCommand228({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand229 } from "citty";
+import { defineCommand as defineCommand231 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -59469,7 +59693,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand229({
+var followCompetitorsCommand = defineCommand231({
   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"'
@@ -59544,7 +59768,7 @@ var followCompetitorsCommand = defineCommand229({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand230 } from "citty";
+import { defineCommand as defineCommand232 } 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.",
@@ -59598,7 +59822,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand230({
+var followingCommand = defineCommand232({
   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"
@@ -59634,7 +59858,7 @@ var followingCommand = defineCommand230({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand231 } from "citty";
+import { defineCommand as defineCommand233 } 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.",
@@ -59673,7 +59897,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand231({
+var patternsCommand = defineCommand233({
   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"
@@ -59729,7 +59953,7 @@ var patternsCommand = defineCommand231({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand234 } 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.",
@@ -59837,7 +60061,7 @@ function buildSearchBody2(args) {
   }
   return body;
 }
-var searchCommand5 = defineCommand232({
+var searchCommand5 = defineCommand234({
   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"
@@ -59952,7 +60176,7 @@ var searchCommand5 = defineCommand232({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand233 } from "citty";
+import { defineCommand as defineCommand235 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -59980,7 +60204,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand233({
+  return defineCommand235({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -60029,7 +60253,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand236 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -60037,7 +60261,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand234({
+var unfollowCommand = defineCommand236({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -60058,7 +60282,7 @@ var unfollowCommand = defineCommand234({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand237 } 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.",
@@ -60068,7 +60292,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand235({
+var winnersCommand = defineCommand237({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -60118,7 +60342,7 @@ var winnersCommand = defineCommand235({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand236({
+var winningAdsCommand = defineCommand238({
   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.
@@ -60356,7 +60580,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand237({
+var main = defineCommand239({
   meta: {
     name: "baker",
     version: getCliVersion(),