@koda-sl/baker-cli 0.306.0-dev.2b6124eb2 → 0.306.1-dev.bb28562ac

package/dist/cli.js

@@ -67,7 +67,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-UBNLCVGN.js";
+} from "./chunk-3TEVIAAV.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -120,7 +120,7 @@ import {
 } from "./chunk-WFWU3CHS.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand238, runMain } from "citty";
+import { defineCommand as defineCommand240, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -1438,6 +1438,7 @@ var TEMP_REF_PREFIX = "li_temp_";
 var TEMP_REF_REGEX = /^li_temp_[A-Za-z0-9_-]{4,}$/;
 var NUMERIC_ID_REGEX = /^\d+$/;
 var URN_REGEX = /^urn:li:[a-zA-Z]+:.+$/;
+var CONVERSION_URN_REGEX = /^urn:lla:llaPartnerConversion:\d+$/;
 var SPONSORED_ACCOUNT_URN_REGEX = /^urn:li:sponsoredAccount:\d+$/;
 var IMAGE_URN_REGEX = /^urn:li:image:.+$/;
 var VIDEO_URN_REGEX = /^urn:li:video:.+$/;
@@ -2017,12 +2018,44 @@ var LINKEDIN_DRAFT_OP_KINDS = [
   "audience.uploadList",
   "conversion.create",
   "conversion.update",
+  "conversion.associateCampaign",
+  "conversion.dissociateCampaign",
   "leadForm.create",
   "leadForm.update"
 ];
 var linkedinDraftOpKindSchema = z3.enum(LINKEDIN_DRAFT_OP_KINDS);
 var accountIdSchema = z3.string().regex(NUMERIC_ID_REGEX, "accountId must be the bare numeric ad account id");
 var updateTargetSchema = z3.union([z3.string().regex(URN_REGEX), z3.string().regex(NUMERIC_ID_REGEX), tempRefSchema]);
+var conversionCampaignTargetSchema = z3.union([
+  // LinkedIn's own namespace for a conversion rule is `urn:lla:` — it is what
+  // the `campaignConversions` key and the CAPI payload use, and what LinkedIn's
+  // docs show — while `conversions list` prints Baker's `urn:li:` spelling of
+  // the same rule. `URN_REGEX` is urn:li: only, so accept the other one here
+  // rather than have the agent translate between two names for one rule.
+  z3.string().regex(CONVERSION_URN_REGEX),
+  z3.string().regex(URN_REGEX),
+  z3.string().regex(NUMERIC_ID_REGEX),
+  tempRefSchema
+]);
+var conversionCampaignSchema = z3.object({
+  campaign: z3.union([z3.string().regex(URN_REGEX), z3.string().regex(NUMERIC_ID_REGEX), tempRefSchema])
+});
+function conversionCampaignOp(kind) {
+  return z3.object({
+    kind: z3.literal(kind),
+    accountId: accountIdSchema,
+    target: conversionCampaignTargetSchema,
+    payload: conversionCampaignSchema
+  }).superRefine((op, ctx) => {
+    if (TEMP_REF_REGEX.test(op.target)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["target"],
+        message: "a conversion rule staged in this same chat has no id yet, so it cannot be linked to a campaign \u2014 stage the rule with associateAllCampaigns, or link it once this chat has published"
+      });
+    }
+  });
+}
 function createOp(kind, payload) {
   return z3.object({ kind: z3.literal(kind), accountId: accountIdSchema, payload });
 }
@@ -2050,6 +2083,8 @@ var linkedinDraftOpInputSchema = z3.discriminatedUnion("kind", [
   createOp("audience.uploadList", audienceUploadListSchema),
   createOp("conversion.create", conversionCreateSchema),
   updateOp("conversion.update", conversionUpdateSchema),
+  conversionCampaignOp("conversion.associateCampaign"),
+  conversionCampaignOp("conversion.dissociateCampaign"),
   createOp("leadForm.create", leadFormCreateSchema),
   updateOp("leadForm.update", leadFormUpdateSchema)
 ]);
@@ -4435,6 +4470,15 @@ var avatarSummarySchema = z10.object({
   sheetUrl: z10.string().optional(),
   coverUrl: z10.string().optional(),
   errorMessage: z10.string().optional(),
+  /**
+   * The build is parked on a face nobody has picked yet.
+   *
+   * `generating` otherwise means a render is running. This is the one case where it
+   * does not, and it is the difference between "come back in thirty seconds" and
+   * "the user is looking at four portraits right now" — so anything that waits on an
+   * avatar has to read it, or it waits out its whole deadline on nothing.
+   */
+  needsFace: z10.boolean().optional(),
   /**
    * The chat this avatar was created in, when it was created in one.
    *
@@ -6185,6 +6229,24 @@ var imagesGroupResponseSchema = z19.object({
 });
 var imagesDeleteRequestSchema = z19.object({ id: z19.string().min(1, "Missing image ID") });
 var imagesDeleteResponseSchema = z19.object({ ok: z19.literal(true) });
+var imagesDescribeRequestSchema = z19.object({
+  id: z19.string().min(1, "Missing image ID"),
+  name: z19.string().min(1).optional(),
+  description: z19.string().min(1).optional(),
+  tags: z19.array(z19.string()).optional(),
+  /** Return the whole library row alongside the three fields that changed. */
+  full: z19.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 = z19.object({
+  id: z19.string(),
+  name: z19.string(),
+  description: z19.string(),
+  tags: z19.array(z19.string()),
+  /** Present only when the request asked for it. */
+  image: imagesGetResponseSchema.optional()
+});
 var imagesUpscaleRequestSchema = z19.object({ imageId: z19.string().min(1, "Missing image ID") });
 var imagesUpscaleResponseSchema = z19.object({
   imageId: z19.string(),
@@ -7112,6 +7174,24 @@ var videosIngestResponseSchema = z25.object({
   videoId: z25.string(),
   deduped: z25.boolean()
 });
+var videosDescribeRequestSchema = z25.object({
+  id: z25.string().min(1, "Missing video ID"),
+  name: z25.string().min(1).optional(),
+  description: z25.string().min(1).optional(),
+  tags: z25.array(z25.string()).optional(),
+  /** Return the whole library row alongside the three fields that changed. */
+  full: z25.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 = z25.object({
+  id: z25.string(),
+  name: z25.string(),
+  description: z25.string(),
+  tags: z25.array(z25.string()),
+  /** Present only when the request asked for it. */
+  video: videosGetResponseSchema.optional()
+});
 var videosDeleteRequestSchema = z25.object({ id: z25.string().min(1, "Missing video ID") });
 var videosDeleteResponseSchema = z25.object({ ok: z25.literal(true) });
 
@@ -7337,13 +7417,29 @@ var SURFACE_RULES = [
       /\bhotjar\b/i,
       /\bgtm\s+snippet\b/i,
       /\bcapi\b/i,
-      /\b(?:install|add|remove|swap|instalar|colocar)\b[\s\S]*\b(?:snippet|script|tag)\b/i
+      /\b(?:install|add|remove|swap|instalar|colocar|poner|anadir|agregar)\b[\s\S]*\b(?:snippet|script|tags?|etiquetas?|pixel)\b/i,
+      // The product's own word for this object, in both languages. A tracking
+      // script named in Spanish ("el código de seguimiento de HubSpot", "una
+      // etiqueta tipo hubspot") matched none of the signals above, so the one
+      // Task that most needed the redirect — file it, or show the form? — was
+      // filed. `tag-manager` is evaluated first and still claims the container.
+      /\btracking\s+(?:code|script|snippet|tag)\b/i,
+      /\bcodigos?\s+de\s+seguimiento\b/i,
+      /\bscripts?\s+de\s+seguimiento\b/i,
+      /\betiquetas?\s+(?:de\s+seguimiento|de\s+medicion|tipo\s+\w+)\b/i
     ],
     // Two vetoes. A structured snippet is a Google Ads extension, not a script
     // on the page — `ads-write` claims it above, and this stops both rules
     // being able to answer. Server-side delivery is infrastructure nobody here
     // can provision, the same call `tag-manager` already makes for sGTM.
-    except: [/\bstructured\s+snippets?\b/i, /\bserver-?\s?side\b/i, /\bhosting\b/i],
+    except: [
+      /\bstructured\s+snippets?\b/i,
+      /\bserver-?\s?side\b/i,
+      /\bhosting\b/i,
+      // A label on a campaign is an ad-platform object, and "etiqueta" is the
+      // Spanish for both it and the script this rule owns.
+      /\b(?:labels?|etiquetas?)\s+(?:de|en|a|to|on)\s+(?:las?\s+|los\s+|the\s+)?(?:campanas?|campaigns?|anuncios?|ads?|grupos?\s+de\s+anuncios|ad\s*groups?)\b/i
+    ],
     hint: "This is a tag or script on the site \u2014 it goes through the `request_tag_input` approval form in this chat, which also collects any secret values (guide: `__tooling__/docs/tools/baker/tags.md`). Show the form instead of filing a Task."
   },
   {
@@ -13365,10 +13461,52 @@ function mappingCommandFor(platform, proposed) {
 
 // ../api/src/analytics/websiteTag.ts
 import { z as z28 } from "zod";
+var websiteTagRequestSchema = z28.object({
+  measure: z28.enum(["campaigns", "outcomes", "all"]).optional()
+});
+var analyticsSitesRequestSchema = z28.object({
+  add: z28.array(z28.string()).optional(),
+  remove: z28.array(z28.string()).optional()
+});
+var analyticsSitesResponseSchema = z28.object({
+  /** Every declared website after the change, which is the answer to a bare read. */
+  origins: z28.array(z28.string()),
+  /** Normalized and actually new — an entry already present is reported in neither list. */
+  added: z28.array(z28.string()),
+  removed: z28.array(z28.string()),
+  /** Still-undeclared domains this company owns. See {@link suggestedPixelOrigins}. */
+  suggestedOrigins: z28.array(z28.string())
+});
 var websiteTagResponseSchema = z28.object({
   host: z28.string(),
   siteKey: z28.string(),
   origins: z28.array(z28.string()),
+  /** Echoed back, so a caller that asked for nothing can see what it got. */
+  measure: z28.enum(["campaigns", "outcomes", "all"]),
+  /**
+   * Whether `campaigns` scope can recognise anybody here — see
+   * {@link campaignsScopeCanMatch}. `false` means the default measures nobody
+   * on this company's install, however correctly the tag is pasted.
+   */
+  campaignsCanMatch: z28.boolean(),
+  /**
+   * Whether `host` is one of the company's own domains rather than Baker's.
+   *
+   * Worth answering because it is the difference between an install a content
+   * blocker removes and one it has no list entry for — the pixel takes its
+   * collect endpoint from its own `src`, so this decides the fate of the event
+   * stream and not just the script load. See {@link pixelHost}.
+   */
+  firstParty: z28.boolean(),
+  /**
+   * Websites this company plainly owns and has not declared — the registrable
+   * domains of its own landing domains. See {@link suggestedPixelOrigins}.
+   *
+   * A suggestion for somebody to accept, never a scope already granted: nothing
+   * in Baker reads this list, and `baker analytics sites --add` is what acts on
+   * it.
+   */
+  suggestedOrigins: z28.array(z28.string()),
   tag: z28.string(),
   tagManagerTag: z28.string(),
   brief: z28.string()
@@ -13586,6 +13724,7 @@ var analyticsPresetSchema = z29.enum([
   "stream"
 ]);
 var ANALYTICS_PRESETS = analyticsPresetSchema.options;
+var ANALYTICS_EVENT_DOORS = ["pages", "website", "server"];
 var analyticsQueryRequestSchema = z29.object({
   preset: analyticsPresetSchema,
   /** Lookback in days. Ignored when `startDate` is given. */
@@ -13644,9 +13783,7 @@ var analyticsQueryRequestSchema = z29.object({
    */
   adPlatform: z29.enum(AD_PLATFORMS).optional(),
   /**
-   * Read only what one collector produced: `site` for everything Baker
-   * measured itself, `systems` for what a client's own server posted to
-   * `POST /v1/events`.
+   * Read only what came in by one door. See {@link ANALYTICS_EVENT_DOORS}.
    *
    * Omit it for all of it, which is the default and the honest superset.
    * Only the reads where the split is a question somebody asks honour it —
@@ -13655,7 +13792,7 @@ var analyticsQueryRequestSchema = z29.object({
    * ingest row carries no `session_id`, deliberately, so there is no visit
    * for it to be counted in.
    */
-  eventOrigin: z29.enum(["site", "systems"]).optional(),
+  eventOrigin: z29.enum(ANALYTICS_EVENT_DOORS).optional(),
   /**
    * `stream` only: keep just one kind of event, named by the key
    * `conversions` hands back in its catalogue.
@@ -13889,9 +14026,27 @@ var analyticsLandingRowSchema = z29.object({
   /** Sessions that BEGAN here. The honest denominator for this page's rate. */
   entrances: z29.number().int().nonnegative(),
   visitors: z29.number().int().nonnegative(),
+  /**
+   * Conversions that fired ON this landing — rarely the number to show.
+   *
+   * A landing's outcome usually happens somewhere else: the client's checkout,
+   * their shop, a CRM days later. None of those rows carries a landing id, so
+   * this reads 0 for a page whose visits convert reliably.
+   */
   conversions: z29.number().int().nonnegative(),
   /** Visits that converted on this page at least once. */
   convertingSessions: z29.number().int().nonnegative(),
+  /**
+   * Conversions the attribution model credited to this landing — what the page
+   * is bought for, and what {@link conversionRate} is built from.
+   *
+   * Last non-direct click over a 90-day lookback, resolved per person, so it
+   * includes the sale a returning visitor made next week and the deal a CRM
+   * posted with no cookie at all.
+   */
+  creditedConversions: z29.number().int().nonnegative(),
+  /** People whose credited touch arrived here and who then converted. */
+  creditedVisitors: z29.number().int().nonnegative(),
   outboundClicks: z29.number().int().nonnegative(),
   /**
    * Converting visits per entrance. Null when nobody entered here at all.
@@ -14016,9 +14171,25 @@ var analyticsPageRowSchema = z29.object({
   pageViews: z29.number().int().nonnegative(),
   /** Sessions that began on this page — its value as a landing page. */
   entrances: z29.number().int().nonnegative(),
+  /**
+   * Conversions that fired ON this page — "which page converts".
+   *
+   * Almost never the number to put beside Entrances. A landing page's job is to
+   * start a visit that converts, and the conversion is usually somewhere else:
+   * the shop, the checkout, a CRM a week later. Read alone this makes every
+   * landing page of a real funnel report zero.
+   */
   conversions: z29.number().int().nonnegative(),
   /** Visits that converted on this page at least once. */
   convertingSessions: z29.number().int().nonnegative(),
+  /**
+   * Conversions the attribution model credited to this page — last non-direct
+   * click, 90-day lookback, resolved per person. The number a landing-page
+   * table means by "conversions", and the one the rate is built from.
+   */
+  creditedConversions: z29.number().int().nonnegative(),
+  /** People whose credited touch arrived here and who then converted. */
+  creditedVisitors: z29.number().int().nonnegative(),
   /** Converting visits per entrance, 0–1. Null when nobody landed here. */
   conversionRate: z29.number().min(0).max(1).nullable(),
   avgEngagementMs: z29.number().nonnegative().nullable()
@@ -14437,6 +14608,17 @@ var analyticsTimelineRowSchema = z29.object({
   eventType: z29.string(),
   /** `edge`, `beacon`, `server` — where the row was written from. */
   source: z29.string(),
+  /**
+   * `baker`, `external`, `export` — where the page was, which `source` does
+   * not say. The two together are what decide the row's door; see
+   * `ANALYTICS_EVENT_DOORS`.
+   *
+   * Defaulted rather than required: the column arrived after the corpus did
+   * and carries no default of its own, so a row older than it reads `""`, and
+   * that has to mean "Baker's, as everything was then" rather than fail the
+   * whole row's parse.
+   */
+  deployment: z29.string().default(""),
   environment: z29.string(),
   /** The build the page was published from. */
   release: z29.string(),
@@ -14776,6 +14958,13 @@ var analyticsVisitorRowSchema = z29.object({
   identityHash: z29.string(),
   identityKind: z29.string()
 });
+var analyticsMeasureScopeSchema = z29.object({
+  scope: z29.enum(["campaigns", "outcomes", "all", "unknown"]),
+  /** Every event the tag on the client's own site sent in this window. */
+  websiteEvents: z29.number(),
+  /** Browser ids it minted off-Baker. Any at all means the tag is on `all`. */
+  websiteNewVisitors: z29.number()
+});
 var analyticsQueryDataSchema = z29.object({
   preset: analyticsPresetSchema,
   window: analyticsWindowSchema,
@@ -14792,6 +14981,7 @@ var analyticsQueryDataSchema = z29.object({
   triggers: z29.array(analyticsTriggerRowSchema).optional(),
   releases: z29.array(analyticsReleaseRowSchema).optional(),
   paid: z29.array(analyticsPaidRowSchema).optional(),
+  measureScope: analyticsMeasureScopeSchema.optional(),
   deliveries: z29.array(analyticsDeliveryRowSchema).optional(),
   submissions: z29.array(analyticsSubmissionRowSchema).optional(),
   geo: z29.array(analyticsGeoRowSchema).optional(),
@@ -18229,6 +18419,24 @@ registerSchema({
     file: { type: "string", description: "JSON file with fields to change", required: false }
   }
 });
+registerSchema({
+  command: "ads.linkedin.conversions.associate-campaign",
+  description: "Count an existing conversion rule for one ad set. Which ad sets a rule counts for is a separate LinkedIn record, not a field on the rule \u2014 `conversions update` cannot change it, and `--associate-all-campaigns` exists only on create. Staged until publish.",
+  args: {
+    id: { type: "positional", description: "Conversion rule id or URN", required: true },
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Ad set (campaign) id or URN", required: true }
+  }
+});
+registerSchema({
+  command: "ads.linkedin.conversions.dissociate-campaign",
+  description: "Stop counting an existing conversion rule for one ad set. Staged until publish.",
+  args: {
+    id: { type: "positional", description: "Conversion rule id or URN", required: true },
+    ...writeAccountArgs,
+    campaign: { type: "string", description: "Ad set (campaign) id or URN", required: true }
+  }
+});
 registerSchema({
   command: "ads.linkedin.lead-forms.create",
   description: "Stage a new Lead Gen Form from a JSON file: {name, headline \u226460, description? \u2264160, privacyPolicyUrl, questions[] \u226412 (playbook: \u22644 for completion), thankYou?, legalDisclaimer?}. Staged until publish.",
@@ -19033,6 +19241,57 @@ Example: baker ads linkedin conversions update 104988516 --post-click-window 30
     });
   }
 });
+var CONVERSION_CAMPAIGN_EXPLAINER = `Which ad sets a conversion rule counts for is a separate LinkedIn record, not a field on the rule \u2014 \`conversions update\` cannot change it, and \`--associate-all-campaigns\` only exists on create.`;
+function conversionCampaignArgs() {
+  return {
+    id: { type: "positional", description: "Conversion rule id or URN", required: true },
+    ...accountArgs,
+    campaign: { type: "string", description: "Ad set (campaign) id or URN", required: true }
+  };
+}
+function requireCampaignArg(args) {
+  const campaign = args.campaign;
+  if (typeof campaign !== "string" || campaign.length === 0) {
+    failWriteValidation2("--campaign is required \u2014 pass the ad set id or URN this conversion should count for");
+  }
+  return campaign;
+}
+var conversionsAssociateCommand = defineCommand33({
+  meta: {
+    name: "associate-campaign",
+    description: `Count an existing conversion rule for one ad set. ${STAGED_NOTE}
+${CONVERSION_CAMPAIGN_EXPLAINER}
+Example: baker ads linkedin conversions associate-campaign 104988516 --campaign 337643194`
+  },
+  args: conversionCampaignArgs(),
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    await stageOp({
+      kind: "conversion.associateCampaign",
+      accountId,
+      target: requireTarget2(args, "conversion rule"),
+      payload: { campaign: requireCampaignArg(args) }
+    });
+  }
+});
+var conversionsDissociateCommand = defineCommand33({
+  meta: {
+    name: "dissociate-campaign",
+    description: `Stop counting an existing conversion rule for one ad set. ${STAGED_NOTE}
+${CONVERSION_CAMPAIGN_EXPLAINER}
+Example: baker ads linkedin conversions dissociate-campaign 104988516 --campaign 337643194`
+  },
+  args: conversionCampaignArgs(),
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    await stageOp({
+      kind: "conversion.dissociateCampaign",
+      accountId,
+      target: requireTarget2(args, "conversion rule"),
+      payload: { campaign: requireCampaignArg(args) }
+    });
+  }
+});
 var leadFormsCreateCommand = defineCommand33({
   meta: {
     name: "create",
@@ -20165,13 +20424,17 @@ var conversionsCommand2 = defineCommand43({
 Subcommands:
   list                \u2014 every rule on the account
   health              \u2014 playbook \xA707 5-point health check
-  create / update     \u2014 stage a conversion-rule write (applies on chat publish)`
+  create / update     \u2014 stage a conversion-rule write (applies on chat publish)
+  associate-campaign / dissociate-campaign
+                      \u2014 which ad sets a rule counts for (its own LinkedIn record, not a field on the rule)`
   },
   subCommands: {
     list: listCmd,
     health: healthCmd,
     create: conversionsCreateCommand,
-    update: conversionsUpdateCommand
+    update: conversionsUpdateCommand,
+    "associate-campaign": conversionsAssociateCommand,
+    "dissociate-campaign": conversionsDissociateCommand
   }
 });
 
@@ -27994,7 +28257,7 @@ one marked "Already counted", so a retry is visible without being counted.
 
 The same holds **across connections**, which is the reason to use it. If the page also
 reports this outcome with Baker's website tag, pass one string as \`event_id\` here and as
-\`eventId\` in \`window.baker.conversion(name, { eventId })\`: the browser event and the
+\`eventId\` in \`window.baker.track(name, { eventId })\`: the browser event and the
 server event are then one event and count once, whichever arrives first and whether or not
 the other ever does. Report an important outcome from both \u2014 a browser can be blocked, a
 server cannot \u2014 and always pair them with an id. Send no id and the two are two conversions,
@@ -28727,7 +28990,7 @@ function adHierarchyHints(data, platform) {
 }
 function sessionlessHint(data, origin) {
   if (data.totals.pageViews === 0 || data.totals.sessions > 0) return [];
-  if (origin === "systems") {
+  if (origin === "server") {
     return [
       "No sessions, because this report is scoped to events a client's own server posted and those carry no visit \u2014 a session would be an invented one. Every per-visitor rate here is null for the same reason; read the counts, and drop --origin for anything about behaviour."
     ];
@@ -28736,8 +28999,23 @@ function sessionlessHint(data, origin) {
     "Pages were served but no sessions were counted \u2014 visitors are declining analytics consent, so traffic is measurable and per-visitor behaviour is not. Say so rather than reporting zero visitors."
   ];
 }
+function measureScopeHint(data) {
+  const scope = data.measureScope?.scope;
+  if (scope === "all") {
+    return [
+      "This company's website tag measures EVERY visitor, not only the ones Baker's campaigns brought. So visits, views and conversions here describe the whole business \u2014 organic, email and direct included. Do not report these as what the campaigns produced; use the per-campaign and per-landing credit for that."
+    ];
+  }
+  if (scope === "outcomes") {
+    return [
+      "This company's website tag reports outcomes only, so no browsing on their own site is measured. Visits and views cover Baker pages alone, and a drop-off between a Baker page and a sale is invisible rather than absent."
+    ];
+  }
+  return [];
+}
 function buildAnalyticsHints(data, platform, origin) {
   const hints2 = [];
+  hints2.push(...measureScopeHint(data));
   for (const funnel of data.funnels ?? []) {
     const worst = funnel.worstStep;
     if (worst && worst.dropRate !== null && worst.dropRate >= SEVERE_STEP_DROP) {
@@ -29083,6 +29361,73 @@ function formatHint(data, format) {
   ];
 }
 
+// src/commands/analytics/websiteTagHints.ts
+function asTyped(origin) {
+  return origin.replace(/^https?:\/\//, "");
+}
+function suggestionHint(suggested) {
+  if (suggested.length === 0) return [];
+  const commands = suggested.map((origin) => `baker analytics sites --add ${asTyped(origin)}`).join("  \xB7  ");
+  return [
+    `Baker publishes landing pages on ${suggested.map(asTyped).join(", ")} for this company, and no declared website covers ${suggested.length === 1 ? "it" : "them"}. Declaring the domain covers every subdomain of it \u2014 the marketing site, the shop, the booking page, and the ones that do not exist yet: ${commands}`
+  ];
+}
+function websiteTagHints(response) {
+  const hints2 = [];
+  if (response.origins.length === 0) {
+    hints2.push(
+      "NO WEBSITE DECLARED \u2014 this tag will be ignored everywhere it is installed, silently, with no failing request to find. Declare the site before installing anything: baker analytics sites --add <the client's domain>. It takes effect at once and needs no republish."
+    );
+  }
+  hints2.push(...suggestionHint(response.suggestedOrigins));
+  if (response.firstParty) {
+    hints2.push(
+      `This tag loads from ${response.host} \u2014 the client's own domain, not Baker's \u2014 so the script and every event it sends travel first-party, which a content blocker has no list entry for. The trade is a dependency: if that domain is ever removed from Baker, this tag 404s and measurement stops. Re-run this command after any domain change.`
+    );
+  }
+  if (response.measure === "all") {
+    hints2.push(
+      "This tag measures the client's WHOLE WEBSITE \u2014 every visitor and every page view, not only the people your campaigns brought. Their reports will describe their business rather than their campaigns, and outcomes their site produces from organic, email and direct traffic will land in their conversion numbers. Only correct if somebody asked for that; otherwise re-run without --measure."
+    );
+  }
+  if (response.measure === "campaigns" && !response.campaignsCanMatch) {
+    hints2.push(
+      "THIS TAG WILL MEASURE NOBODY \u2014 and will look installed. `campaigns` scope recognises a visitor by a first-party cookie, and a browser does not carry one between two different registrable domains. This company's landings are not on a subdomain of the site this tag goes on, so no visitor can ever match. Two fixes: put the landings on a subdomain of the client's own domain (a custom domain in Baker), or install with --measure outcomes, which measures no browsing and reports the outcomes the site tells Baker about."
+    );
+  } else if (response.measure === "campaigns") {
+    hints2.push(
+      "This tag measures only visitors who have been on one of this company's Baker landing pages \u2014 their whole journey through the site, to the outcome. Anybody else is not measured at all. Use --measure all only if the client asked for their whole website measured."
+    );
+  }
+  hints2.push(
+    'Reporting an outcome is not the same as counting it. After a `window.baker.track("name")` call is live, name it with: baker analytics conversions --event page:<name> --name "<what to call it>". That applies immediately and counts everything already collected.'
+  );
+  return hints2;
+}
+function analyticsSitesHints(response) {
+  const hints2 = [];
+  if (response.origins.length === 0) {
+    hints2.push(
+      "No website is declared, so this company's measurement tag is ignored wherever it is installed \u2014 silently, with no failing request to find. Add one with: baker analytics sites --add <the client's domain>"
+    );
+  }
+  hints2.push(...suggestionHint(response.suggestedOrigins));
+  if (response.added.length > 0) {
+    hints2.push(
+      `Live now. A tag already installed on ${response.added.map(asTyped).join(", ")} starts being accepted immediately \u2014 there is no new tag to paste and nothing to publish. Only events sent from here on are kept; the ones refused before this were never stored and cannot be recovered.`
+    );
+  }
+  if (response.removed.length > 0) {
+    hints2.push(
+      `Measurement from ${response.removed.map(asTyped).join(", ")} will stop at once, with no error on that site \u2014 a tag still installed there goes quiet. Everything already collected from it is kept.`
+    );
+  }
+  hints2.push(
+    "One entry covers everything under it: example.com answers for www., go. and shop.eu. It never widens upward, so declaring go.example.com leaves example.com uncovered \u2014 declare the domain, not the subdomain you are installing on today."
+  );
+  return hints2;
+}
+
 // src/commands/analytics/index.ts
 var SHARED_ARGS = {
   days: { type: "string", description: "Lookback window in days (default: 30)", required: false },
@@ -29140,7 +29485,7 @@ var SHARED_ARGS = {
   },
   origin: {
     type: "string",
-    description: "Read one collector only: `site` for what Baker measured on its own pages, `systems` for what the client's own server posted to POST /v1/events. Omit it for both, which is the default and the honest superset. Reach for it when a number moved and nothing on the pages changed \u2014 a CRM replaying history lands in the same totals as a visitor, and this is the only thing that separates them. Honoured by overview, traffic, events and conversions; every session-scoped report ignores it, because a server-sent event carries no visit to be counted in",
+    description: "Read one door only: `pages` for a browser on a page Baker publishes, `website` for a browser on the client's OWN website (the measurement tag), `server` for what their server posted to POST /v1/events. Omit it for all three, which is the default and the honest superset. Reach for it when a number moved and nothing on the pages changed \u2014 a CRM replaying history and a tag on the client's own site both land in the same totals as a landing page visitor, and this is the only thing that separates them. Honoured by overview, traffic, events and conversions; every session-scoped report ignores it, because a server-sent event carries no visit to be counted in",
     required: false
   },
   output: {
@@ -29205,7 +29550,7 @@ function requestBody(args, options) {
     Object.entries(candidates).filter(([key, value]) => value !== void 0 && (value !== "" || key === "adValue"))
   );
 }
-var EVENT_ORIGINS = ["site", "systems"];
+var EVENT_ORIGINS = ANALYTICS_EVENT_DOORS;
 async function runPreset(args, options) {
   const origin = args.origin === void 0 ? "" : String(args.origin);
   if (origin !== "" && !EVENT_ORIGINS.includes(origin)) {
@@ -29213,7 +29558,7 @@ async function runPreset(args, options) {
       ok: false,
       error: {
         code: "VALIDATION_ERROR",
-        message: `Unknown --origin "${origin}". Use one of: ${EVENT_ORIGINS.join(", ")}, or omit it for both.`
+        message: `Unknown --origin "${origin}". Use one of: ${EVENT_ORIGINS.join(", ")}, or omit it for all three.`
       }
     });
     process.exit(1);
@@ -29811,7 +30156,13 @@ var websiteTagCommand = (() => {
   registerSchema({
     command: "analytics.website-tag",
     description: "The measurement tag for a website Baker does not publish, with this company's key in it",
-    args: {}
+    args: {
+      measure: {
+        type: "string",
+        required: false,
+        description: 'Whose activity to measure: "campaigns" (default), "outcomes" or "all"'
+      }
+    }
   });
   return defineCommand95({
     meta: {
@@ -29823,16 +30174,81 @@ Reach for it whenever measurement has to reach a page Baker did not build. What
 Three things worth knowing before you install it:
   the origins list                    \u2014 the key is IGNORED from any origin not on it, silently. An empty list means the tag will measure nothing.
   Tag Manager is usually the way in   \u2014 a Custom HTML tag on All Pages. If the client has a container connected, you can stage that yourself (baker tag-manager).
-  in a container, use tagManagerTag  \u2014 the response carries two tags. \`tag\` is for a page somebody can edit; \`tagManagerTag\` is the one to stage, because a container rebuilds a Custom HTML tag's script element from its src alone and drops the key, so \`tag\` measures nothing there, published and silent. Check it on the page afterwards: window.baker in the browser console.
+  in a container, use tagManagerTag   \u2014 the response carries two tags. \`tag\` is for a page somebody can edit; \`tagManagerTag\` is the one to stage, because a container rebuilds a Custom HTML tag's script element from its src alone and drops the key, so \`tag\` measures nothing there, published and silent. Check it on the page afterwards: window.baker in the browser console.
+  --measure decides the BILL          \u2014 the tag goes on every page whatever you do; this decides whose activity is measured. Leave it alone unless the client asked for their whole website.
+
+  --measure campaigns  (default)  people your Baker campaigns brought to the site. Their whole journey, through to the outcome. Nobody else is measured at all.
+  --measure outcomes              nobody's browsing. Only what the site reports with window.baker.track(...), and forms it wired to Baker.
+  --measure all                   every visitor and every page view of the whole website. Their reports then describe their business, not their campaigns, and outcomes from organic, email and direct land in their conversion numbers. A decision, never a default.
 
 Examples:
   baker analytics website-tag                   \u2014 the tag, the origins and the install brief
-  baker analytics events --origin site          \u2014 after it is live, what that website is reporting`
+  baker analytics website-tag --measure all     \u2014 measure their whole website, because they asked for that
+  baker analytics events --origin website       \u2014 after it is live, what that website is reporting`
     },
-    args: {},
-    run: async () => {
+    args: {
+      measure: {
+        type: "string",
+        description: 'Whose activity to measure: "campaigns" (default), "outcomes" or "all". Widening is a decision \u2014 see above.'
+      }
+    },
+    run: async (ctx) => {
       try {
-        writeJsonEnvelope(await apiPost("/api/analytics/website-tag", {}));
+        const measure = typeof ctx.args.measure === "string" ? ctx.args.measure : void 0;
+        const envelope = await apiPost(
+          "/api/analytics/website-tag",
+          measure ? { measure } : {}
+        );
+        writeJsonEnvelope({ ...envelope, hints: websiteTagHints(envelope.data) });
+      } catch (err) {
+        handleError(err);
+      }
+    }
+  });
+})();
+var sitesCommand = (() => {
+  registerSchema({
+    command: "analytics.sites",
+    description: "The websites this company's measurement tag is accepted from, and adding or removing one",
+    args: {
+      add: { type: "string", required: false, description: "Website address to accept measurement from" },
+      remove: { type: "string", required: false, description: "Website address to stop accepting measurement from" }
+    }
+  });
+  return defineCommand95({
+    meta: {
+      name: "sites",
+      description: `Which websites this company's measurement tag is accepted from \u2014 and the command that changes it.
+
+The site key ships in the source of every page it is pasted on, so this list is the whole of what stops a stranger who read it appending forged conversions to these numbers. A tag on a website that is NOT on this list is ignored, silently, with no failing request anywhere. That is the single most common reason an install measures nothing.
+
+One entry covers the estate under it: example.com answers for www.example.com, go.example.com and shop.eu.example.com. It never widens upward \u2014 declaring go.example.com does NOT cover example.com \u2014 so declare the DOMAIN, not the subdomain you happen to be installing on today.
+
+Start here:
+  baker analytics sites                              \u2014 what is declared now, and what is worth adding
+  baker analytics sites --add example.com            \u2014 accept measurement from that site and everything under it
+  baker analytics sites --remove old-site.com
+
+Examples:
+  baker analytics website-tag                        \u2014 get the tag; if its origins are empty, come here first
+  baker analytics sites --add foodforjoe.es          \u2014 one entry covering www., go. and shop.`
+    },
+    args: {
+      add: {
+        type: "string",
+        description: "Website address to accept measurement from, e.g. example.com \u2014 covers every subdomain of it. Repeat for several"
+      },
+      remove: { type: "string", description: "Website address to stop accepting measurement from" }
+    },
+    run: async (ctx) => {
+      try {
+        const raw = ctx.rawArgs;
+        const body = {
+          add: repeatedValues(raw, "add", ctx.args.add),
+          remove: repeatedValues(raw, "remove", ctx.args.remove)
+        };
+        const envelope = await apiPost("/api/analytics/sites", body);
+        writeJsonEnvelope({ ...envelope, hints: analyticsSitesHints(envelope.data) });
       } catch (err) {
         handleError(err);
       }
@@ -29882,7 +30298,7 @@ Examples:
   baker analytics website-tag                 \u2014 the tag for a website Baker does not publish, key included
   baker analytics sending-events              \u2014 the contract for a client's server to post its own events
   baker analytics arrivals --outcome rejected \u2014 what their server posted that we refused, and why
-  baker analytics events --origin systems     \u2014 the events their systems reported, not ours
+  baker analytics events --origin server      \u2014 the events their systems reported, not ours
 Full guide: __tooling__/docs/tools/baker/analytics.md`
   },
   subCommands: {
@@ -29909,6 +30325,7 @@ Full guide: __tooling__/docs/tools/baker/analytics.md`
     arrivals: arrivalsCommand,
     "sending-events": sendingEventsCommand,
     "website-tag": websiteTagCommand,
+    sites: sitesCommand,
     presets: presetsCommand
   }
 });
@@ -29924,6 +30341,11 @@ var CAST_FLAG_RULE = "Cast with `--avatar <handle>` on `baker studio generate`,
 var VERBATIM_RULE = "When you do write the description yourself \u2014 a hand-built canvas node, a landing image, anywhere `--avatar` does not exist \u2014 copy `subjectDescription` VERBATIM, word for word. Re-phrasing it per generation is the other reason a face drifts across a set.";
 var VIDEO_ROUTING = "In video, a photoreal presenter renders on `google/veo-3.1` (or `google/veo-3.1-fast`), never `bytedance/seedance-2.0` \u2014 it refuses photoreal human faces, AI-generated ones included. Scaffolding a video creative: `baker canvas scaffold-video \u2026 --real-face`.";
 function castingHints(avatar) {
+  if (avatar.status === "generating" && avatar.needsFace) {
+    return [
+      `The user is picking @${avatar.handle}'s face right now \u2014 portraits are on their screen and nothing renders until they answer. There is NOTHING to wait for and nothing to check: do not poll, do not block on it, do not ask about the face in a question of your own, and do not delete or recreate this avatar. Whatever you do next simply runs after they have chosen.`
+    ];
+  }
   if (avatar.status === "generating") {
     return [
       `Still building \u2014 a ~30s render that settles on its own, and this avatar is castable only once it reads \`ready\`. If the next thing you do needs it (a clip, a still, anything with --avatar), block on it: \`baker avatars get ${avatar.handle} --wait\` returns the moment it is ready. Otherwise do other work first and read it back with \`baker avatars get ${avatar.handle}\`. Never write your own sleep or poll loop, and never end the turn waiting \u2014 the user would have to come back and tell you it is ready.`
@@ -30403,17 +30825,18 @@ import { defineCommand as defineCommand98 } from "citty";
 // src/commands/avatars/wait.ts
 var WAIT_TIMEOUT_MS = 9e4;
 var WAIT_INTERVAL_MS = 3e3;
-function shouldKeepWaiting(status, elapsedMs) {
-  if (status === "ready") return { done: true, reason: "ready" };
-  if (status === "error" || status === "archived") return { done: true, reason: "settled" };
+function shouldKeepWaiting(avatar, elapsedMs) {
+  if (avatar.status === "ready") return { done: true, reason: "ready" };
+  if (avatar.status === "error" || avatar.status === "archived") return { done: true, reason: "settled" };
+  if (avatar.needsFace) return { done: true, reason: "needs-face" };
   if (elapsedMs >= WAIT_TIMEOUT_MS) return { done: false, reason: "expired" };
   return { done: false, reason: "building" };
 }
 async function waitForSheet(first, read, sleep4 = (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))) {
   const startedAt = Date.now();
   let latest = first;
-  while (!shouldKeepWaiting(latest.status, Date.now() - startedAt).done) {
-    if (shouldKeepWaiting(latest.status, Date.now() - startedAt).reason === "expired") return latest;
+  while (!shouldKeepWaiting(latest, Date.now() - startedAt).done) {
+    if (shouldKeepWaiting(latest, Date.now() - startedAt).reason === "expired") return latest;
     await sleep4(WAIT_INTERVAL_MS);
     latest = await read();
   }
@@ -34187,8 +34610,12 @@ function foldUnshownPhrases(phrases, keepRenderedVoice) {
   const claimed = /* @__PURE__ */ new Set();
   const kept = [];
   for (const phrase of phrases) {
+    if (!phrase.presenterShown) {
+      kept.push(phrase);
+      continue;
+    }
     const available = phrase.shownScenes.filter((scene) => !claimed.has(scene));
-    if (phrase.presenterShown && available.length > 0) {
+    if (available.length > 0) {
       for (const scene of available) claimed.add(scene);
       kept.push(phrase);
       continue;
@@ -46323,7 +46750,7 @@ function siteHints(sites) {
     resources: sites.map((site) => ({ id: site.siteUrl, label: site.permissionLevel }))
   });
 }
-var sitesCommand = defineCommand135({
+var sitesCommand2 = defineCommand135({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -46388,7 +46815,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/gsc.md`
   },
   subCommands: {
-    sites: sitesCommand,
+    sites: sitesCommand2,
     query: queryCommand3,
     sitemaps: sitemapsCommand
   }
@@ -47170,7 +47597,7 @@ Full guide: __tooling__/docs/tools/baker/hubspot.md`
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand164 } from "citty";
+import { defineCommand as defineCommand165 } from "citty";
 
 // src/commands/images/crop.ts
 import { defineCommand as defineCommand139 } from "citty";
@@ -47385,9 +47812,118 @@ var deleteCommand2 = defineCommand140({
   }
 });
 
-// src/commands/images/dimensions.ts
+// src/commands/images/describe.ts
 import { defineCommand as defineCommand141 } 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 = defineCommand141({
+  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 defineCommand142 } from "citty";
+
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
 function getDimensionsFromBuffer(buffer) {
@@ -47415,7 +47951,7 @@ registerSchema({
     }
   }
 });
-var dimensionsCommand = defineCommand141({
+var dimensionsCommand = defineCommand142({
   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"
@@ -47471,7 +48007,7 @@ var dimensionsCommand = defineCommand141({
 });
 
 // src/commands/images/download.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 
 // src/commands/images/downloadPaths.ts
 import { basename as basename2, extname as extname3, join as join6 } from "path";
@@ -47712,7 +48248,7 @@ function emitError3(err) {
   writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
-var downloadCommand = defineCommand142({
+var downloadCommand = defineCommand143({
   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"
@@ -47745,7 +48281,7 @@ var downloadCommand = defineCommand142({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 
 // src/commands/images/autoIngest.ts
 var AUTO_INGEST_MAX = {
@@ -47792,7 +48328,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand143({
+var extractCommand = defineCommand144({
   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"
@@ -47847,7 +48383,7 @@ var extractCommand = defineCommand143({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand145 } from "citty";
 
 // src/commands/images/providerHits.ts
 function asRecord3(value) {
@@ -47985,7 +48521,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var findCommand = defineCommand144({
+var findCommand = defineCommand145({
   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"
@@ -48058,7 +48594,7 @@ var findCommand = defineCommand144({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -48066,7 +48602,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand3 = defineCommand145({
+var getCommand3 = defineCommand146({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -48102,7 +48638,7 @@ var getCommand3 = defineCommand145({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand147 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -48134,7 +48670,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand146({
+var gifCommand = defineCommand147({
   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"
@@ -48181,7 +48717,7 @@ var gifCommand = defineCommand146({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand148 } 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."
@@ -48221,7 +48757,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand147({
+var googleCommand2 = defineCommand148({
   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"
@@ -48294,7 +48830,7 @@ var googleCommand2 = defineCommand147({
 });
 
 // src/commands/images/group.ts
-import { defineCommand as defineCommand148 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 
 // src/commands/mediaGroup.ts
 async function runMediaGroupLookup(input) {
@@ -48347,7 +48883,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand = defineCommand148({
+var groupCommand = defineCommand149({
   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>"
@@ -48367,7 +48903,7 @@ var groupCommand = defineCommand148({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand149 } from "citty";
+import { defineCommand as defineCommand150 } from "citty";
 
 // src/commands/images/brandVerification.ts
 function brandToken(domain) {
@@ -48464,7 +49000,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var iconCommand = defineCommand149({
+var iconCommand = defineCommand150({
   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'"
@@ -48534,7 +49070,7 @@ var iconCommand = defineCommand149({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand150 } from "citty";
+import { defineCommand as defineCommand151 } from "citty";
 var SOURCE_VALUES = imageSourceSchema.options.join(" | ");
 registerSchema({
   command: "images.ingest",
@@ -48549,7 +49085,7 @@ registerSchema({
     fields: { type: "string", description: "Comma-separated field names to include", required: false }
   }
 });
-var ingestCommand = defineCommand150({
+var ingestCommand = defineCommand151({
   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"
@@ -48618,7 +49154,7 @@ var ingestCommand = defineCommand150({
 });
 
 // src/commands/images/layerize.ts
-import { defineCommand as defineCommand151 } from "citty";
+import { defineCommand as defineCommand152 } 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.",
@@ -48682,7 +49218,7 @@ async function pollUntilSettled(imageId, maxWait) {
   }
   return null;
 }
-var layerizeCommand = defineCommand151({
+var layerizeCommand = defineCommand152({
   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'"
@@ -48751,7 +49287,7 @@ registerSchema({
     full: { type: "boolean", description: "Include geometry and typography for every layer", required: false }
   }
 });
-var layersCommand = defineCommand151({
+var layersCommand = defineCommand152({
   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"
@@ -48791,7 +49327,7 @@ var layersCommand = defineCommand151({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand152 } from "citty";
+import { defineCommand as defineCommand153 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -48817,7 +49353,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand152({
+var libraryCommand = defineCommand153({
   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"
@@ -48880,7 +49416,7 @@ var libraryCommand = defineCommand152({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand153 } from "citty";
+import { defineCommand as defineCommand154 } 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.",
@@ -48908,7 +49444,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var logoCommand = defineCommand153({
+var logoCommand = defineCommand154({
   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"
@@ -48981,7 +49517,7 @@ var logoCommand = defineCommand153({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand154 } from "citty";
+import { defineCommand as defineCommand155 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -49713,7 +50249,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand2 = defineCommand154({
+var normalizeCommand2 = defineCommand155({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -49768,7 +50304,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand155 } from "citty";
+import { defineCommand as defineCommand156 } 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.",
@@ -49788,7 +50324,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand155({
+var pinterestCommand = defineCommand156({
   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'"
@@ -49845,7 +50381,7 @@ var pinterestCommand = defineCommand155({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand156 } from "citty";
+import { defineCommand as defineCommand157 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -49864,7 +50400,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var screenshotCommand = defineCommand156({
+var screenshotCommand = defineCommand157({
   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"
@@ -49928,7 +50464,7 @@ var screenshotCommand = defineCommand156({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand157 } from "citty";
+import { defineCommand as defineCommand158 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -49944,7 +50480,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand157({
+var searchCommand = defineCommand158({
   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"
@@ -50004,7 +50540,7 @@ var searchCommand = defineCommand157({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand158 } from "citty";
+import { defineCommand as defineCommand159 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -50036,7 +50572,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand158({
+var stickerCommand = defineCommand159({
   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"
@@ -50083,7 +50619,7 @@ var stickerCommand = defineCommand158({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand159 } from "citty";
+import { defineCommand as defineCommand160 } 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."
@@ -50163,7 +50699,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 = defineCommand159({
+var stockCommand = defineCommand160({
   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"
@@ -50238,7 +50774,7 @@ var stockCommand = defineCommand159({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand160 } from "citty";
+import { defineCommand as defineCommand161 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -50247,7 +50783,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand160({
+  return defineCommand161({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -50283,7 +50819,7 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand3 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { defineCommand as defineCommand161 } from "citty";
+import { defineCommand as defineCommand162 } from "citty";
 registerSchema({
   command: "images.upload",
   description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
@@ -50321,7 +50857,7 @@ registerSchema({
 function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand = defineCommand161({
+var uploadCommand = defineCommand162({
   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'"
@@ -50414,7 +50950,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand162 } from "citty";
+import { defineCommand as defineCommand163 } 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).",
@@ -50429,7 +50965,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var upscaleCommand = defineCommand162({
+var upscaleCommand = defineCommand163({
   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"
@@ -50484,7 +51020,7 @@ var upscaleCommand = defineCommand162({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand163 } from "citty";
+import { defineCommand as defineCommand164 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -50513,7 +51049,7 @@ function emitReady(ingestResult, doc, args) {
     args.full === true
   );
 }
-var useCommand = defineCommand163({
+var useCommand = defineCommand164({
   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"
@@ -50562,7 +51098,7 @@ var useCommand = defineCommand163({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand164({
+var imagesCommand = defineCommand165({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -50591,6 +51127,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)
@@ -50628,6 +51165,7 @@ Full guide: __tooling__/docs/tools/baker/images.md`
     search: searchCommand,
     upload: uploadCommand,
     delete: deleteCommand2,
+    describe: describeCommand,
     download: downloadCommand,
     normalize: normalizeCommand2,
     crop: cropCommand,
@@ -50640,12 +51178,12 @@ Full guide: __tooling__/docs/tools/baker/images.md`
 });
 
 // src/commands/landing/index.ts
-import { defineCommand as defineCommand176 } from "citty";
+import { defineCommand as defineCommand177 } from "citty";
 
 // src/commands/landing/critique.ts
 import { readdir as readdir14, readFile as readFile30, stat as stat9 } from "fs/promises";
 import path37 from "path";
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand166 } from "citty";
 
 // src/engine/landing/lib/constants.ts
 var OVERUSED_FONTS = /* @__PURE__ */ new Set([
@@ -51953,7 +52491,7 @@ function fail6(code, message, fix) {
   );
   process.exit(2);
 }
-var critiqueCommand2 = defineCommand165({
+var critiqueCommand2 = defineCommand166({
   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."
@@ -52087,10 +52625,10 @@ async function isDir2(p) {
 }
 
 // src/commands/landing/inspiration/index.ts
-import { defineCommand as defineCommand174 } from "citty";
+import { defineCommand as defineCommand175 } from "citty";
 
 // src/commands/landing/inspiration/add.ts
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand167 } from "citty";
 
 // src/commands/landing/inspiration/shared.ts
 var INSPIRATION_HINTS = {
@@ -52172,7 +52710,7 @@ registerSchema({
     note: { type: "string", description: "Why this page is worth keeping", required: false }
   }
 });
-var addCommand = defineCommand166({
+var addCommand = defineCommand167({
   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'"
@@ -52214,7 +52752,7 @@ var addCommand = defineCommand166({
 // src/commands/landing/inspiration/code.ts
 import { mkdir as mkdir11, writeFile as writeFile15 } from "fs/promises";
 import path38 from "path";
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand168 } 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.",
@@ -52223,7 +52761,7 @@ registerSchema({
     full: { type: "boolean", description: "Print the markup inline as well as writing it", required: false }
   }
 });
-var codeCommand = defineCommand167({
+var codeCommand = defineCommand168({
   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."
@@ -52269,7 +52807,7 @@ var codeCommand = defineCommand167({
 });
 
 // src/commands/landing/inspiration/favorites.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand169 } 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.",
@@ -52283,7 +52821,7 @@ registerSchema({
     }
   }
 });
-var favoritesCommand = defineCommand168({
+var favoritesCommand = defineCommand169({
   meta: {
     name: "favorites",
     description: "List this company's saved reference sections. Example: baker landing inspiration favorites --type hero,pricing"
@@ -52363,7 +52901,7 @@ registerSchema({
     note: { type: "string", description: "Why this is worth keeping", required: false }
   }
 });
-var favoriteCommand = defineCommand168({
+var favoriteCommand = defineCommand169({
   meta: {
     name: "favorite",
     description: "Save a reference section to this company. Example: baker landing inspiration favorite k57abc\u2026"
@@ -52401,7 +52939,7 @@ registerSchema({
     page: { type: "boolean", description: "Treat the id as a page rather than a section", required: false }
   }
 });
-var unfavoriteCommand = defineCommand168({
+var unfavoriteCommand = defineCommand169({
   meta: {
     name: "unfavorite",
     description: "Remove a reference section from this company's saved set. Example: baker landing inspiration unfavorite k57abc\u2026"
@@ -52423,7 +52961,7 @@ var unfavoriteCommand = defineCommand168({
 });
 
 // src/commands/landing/inspiration/page.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand170 } 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.",
@@ -52440,7 +52978,7 @@ registerSchema({
     }
   }
 });
-var pageCommand2 = defineCommand169({
+var pageCommand2 = defineCommand170({
   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."
@@ -52503,7 +53041,7 @@ var pageCommand2 = defineCommand169({
 });
 
 // src/commands/landing/inspiration/scrape.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 
 // src/engine/landing-library/proxyFailure.ts
 var PROXY_STATUS = 407;
@@ -54643,7 +55181,7 @@ registerSchema({
     report: { type: "boolean", description: "Write report.html. `--no-report` to skip", required: false }
   }
 });
-var scrapeCommand = defineCommand170({
+var scrapeCommand = defineCommand171({
   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"
@@ -54752,7 +55290,7 @@ var scrapeCommand = defineCommand170({
 
 // src/commands/landing/inspiration/search.ts
 import path43 from "path";
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 
 // src/commands/landing/inspiration/shot.ts
 import { mkdir as mkdir13, writeFile as writeFile18 } from "fs/promises";
@@ -54889,7 +55427,7 @@ async function downloadShots(results) {
   );
   return saved;
 }
-var searchCommand2 = defineCommand171({
+var searchCommand2 = defineCommand172({
   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"
@@ -54987,7 +55525,7 @@ var searchCommand2 = defineCommand171({
 });
 
 // src/commands/landing/inspiration/sequences.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand173 } from "citty";
 var COMPACT_TRANSITIONS = 12;
 var COMPACT_ENDS = 5;
 var MAX_PAGES = 50;
@@ -55061,7 +55599,7 @@ function sequencesHints(data, { scope, full }) {
   if (scope === "favorites") hints2.push(...favoritesScopeHints(data.favoritesHealth, data.pagesReturned));
   return hints2;
 }
-var sequencesCommand = defineCommand172({
+var sequencesCommand = defineCommand173({
   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."
@@ -55111,7 +55649,7 @@ var sequencesCommand = defineCommand172({
 
 // src/commands/landing/inspiration/view.ts
 import path44 from "path";
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand174 } 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.",
@@ -55124,7 +55662,7 @@ registerSchema({
     }
   }
 });
-var viewCommand2 = defineCommand173({
+var viewCommand2 = defineCommand174({
   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."
@@ -55208,7 +55746,7 @@ var viewCommand2 = defineCommand173({
 });
 
 // src/commands/landing/inspiration/index.ts
-var inspirationCommand = defineCommand174({
+var inspirationCommand = defineCommand175({
   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.
@@ -55256,7 +55794,7 @@ Full guide: __tooling__/docs/tools/baker/landing.md`
 import { randomUUID as randomUUID2 } from "crypto";
 import { mkdir as mkdir14, readdir as readdir15, readFile as readFile31, stat as stat10, writeFile as writeFile19 } from "fs/promises";
 import path45 from "path";
-import { defineCommand as defineCommand175 } from "citty";
+import { defineCommand as defineCommand176 } 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.",
@@ -55484,7 +56022,7 @@ async function writeVariant(opts) {
   await writeFile19(path45.join(variantDir, "_images", ".gitkeep"), "", "utf8");
   return written;
 }
-var variantCommand = defineCommand175({
+var variantCommand = defineCommand176({
   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."
@@ -55564,7 +56102,7 @@ var variantCommand = defineCommand175({
 });
 
 // src/commands/landing/index.ts
-var landingCommand = defineCommand176({
+var landingCommand = defineCommand177({
   meta: {
     name: "landing",
     description: `Design-quality tools for landing pages (src/pages/<slug>/).
@@ -55584,7 +56122,7 @@ Subcommands:
 });
 
 // src/commands/mcp/index.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand178 } from "citty";
 
 // src/commands/mcp/platforms.ts
 function readsKey(label) {
@@ -55653,7 +56191,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 = defineCommand177({
+var connectedCommand = defineCommand178({
   meta: {
     name: "connected",
     description: `Everything this chat can reach \u2014 managed integrations, custom MCP servers, and connected platforms.
@@ -55712,7 +56250,7 @@ registerSchema({
   description: "List the custom MCP servers this company's chats see (org + company + your own user scope).",
   args: {}
 });
-var listCommand15 = defineCommand177({
+var listCommand15 = defineCommand178({
   meta: { name: "list", description: "List custom MCP servers visible to this company's chats." },
   run: async () => {
     try {
@@ -55749,7 +56287,7 @@ registerSchema({
     header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
   }
 });
-var addCommand2 = defineCommand177({
+var addCommand2 = defineCommand178({
   meta: {
     name: "add",
     description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.
@@ -55801,7 +56339,7 @@ registerSchema({
   description: "Remove a company custom MCP server by name.",
   args: { name: { type: "string", description: "Server name to remove", required: true } }
 });
-var removeCommand5 = defineCommand177({
+var removeCommand5 = defineCommand178({
   meta: {
     name: "remove",
     description: `Remove a company custom MCP server by name.
@@ -55823,7 +56361,7 @@ Example:
     }
   }
 });
-var mcpCommand = defineCommand177({
+var mcpCommand = defineCommand178({
   meta: {
     name: "mcp",
     description: `Third-party tools for this company \u2014 see what's connected, register custom HTTPS MCP endpoints.
@@ -55849,10 +56387,10 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand191 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand178 } from "citty";
+import { defineCommand as defineCommand179 } 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.';
@@ -56054,7 +56592,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand178({
+var advertisersCommand = defineCommand179({
   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).
@@ -56110,7 +56648,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand179 } from "citty";
+import { defineCommand as defineCommand180 } 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).",
@@ -56133,7 +56671,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand179({
+var autocompleteCommand = defineCommand180({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -56188,7 +56726,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand180 } from "citty";
+import { defineCommand as defineCommand181 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -56245,7 +56783,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand180({
+var countriesCommand = defineCommand181({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -56256,7 +56794,7 @@ var countriesCommand = defineCommand180({
 });
 
 // src/commands/research/fetch.ts
-import { defineCommand as defineCommand181 } from "citty";
+import { defineCommand as defineCommand182 } from "citty";
 var CONTENT_PREVIEW_CHARS = 2e4;
 var TIMEOUT_MS = 18e4;
 registerSchema({
@@ -56329,7 +56867,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 = defineCommand181({
+var fetchCommand = defineCommand182({
   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.
@@ -56406,7 +56944,7 @@ Examples:
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand182 } from "citty";
+import { defineCommand as defineCommand183 } 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.",
@@ -56429,7 +56967,7 @@ var FIELDS7 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand182({
+var intentCommand = defineCommand183({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -56477,7 +57015,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand183 } from "citty";
+import { defineCommand as defineCommand184 } 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.",
@@ -56506,7 +57044,7 @@ var FIELDS8 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand183({
+var keywordGapCommand = defineCommand184({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -56581,7 +57119,7 @@ Examples:
 });
 
 // src/commands/research/keyword-metrics.ts
-import { defineCommand as defineCommand184 } from "citty";
+import { defineCommand as defineCommand185 } from "citty";
 
 // src/commands/research/keyword-metrics-rows.ts
 var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
@@ -56661,7 +57199,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
   }
 });
-var keywordMetricsCommand = defineCommand184({
+var keywordMetricsCommand = defineCommand185({
   meta: {
     name: "keyword-metrics",
     description: `Volume, CPC and competition for keywords you name. No domain required.
@@ -56743,7 +57281,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand185 } from "citty";
+import { defineCommand as defineCommand186 } 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.",
@@ -56776,7 +57314,7 @@ var FIELDS9 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand185({
+var keywordsForSiteCommand = defineCommand186({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -56838,7 +57376,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand186 } from "citty";
+import { defineCommand as defineCommand187 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -56868,7 +57406,7 @@ var FIELDS10 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand186({
+var languagesCommand2 = defineCommand187({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -56879,7 +57417,7 @@ var languagesCommand2 = defineCommand186({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand187 } from "citty";
+import { defineCommand as defineCommand188 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -56898,7 +57436,7 @@ var FIELDS11 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand187({
+var lighthouseCommand = defineCommand188({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -56936,7 +57474,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand188 } from "citty";
+import { defineCommand as defineCommand189 } 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).",
@@ -56962,7 +57500,7 @@ var FIELDS12 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand188({
+var relevantPagesCommand = defineCommand189({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -57009,7 +57547,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand189 } from "citty";
+import { defineCommand as defineCommand190 } 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).",
@@ -57060,7 +57598,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand189({
+var webCommand = defineCommand190({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -57122,7 +57660,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand190({
+var researchCommand = defineCommand191({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -57169,10 +57707,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand199 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand192 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -57328,7 +57866,7 @@ registerSchema({
     }
   }
 });
-var createCommand3 = defineCommand191({
+var createCommand3 = defineCommand192({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -57387,7 +57925,7 @@ var createCommand3 = defineCommand191({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand193 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -57395,7 +57933,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand3 = defineCommand192({
+var deleteCommand3 = defineCommand193({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -57424,7 +57962,7 @@ var deleteCommand3 = defineCommand192({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand194 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -57433,7 +57971,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand4 = defineCommand193({
+var getCommand4 = defineCommand194({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -57472,7 +58010,7 @@ var getCommand4 = defineCommand193({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand195 } 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.",
@@ -57480,7 +58018,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var listCommand16 = defineCommand194({
+var listCommand16 = defineCommand195({
   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."
@@ -57505,7 +58043,7 @@ var listCommand16 = defineCommand194({
 // src/commands/scheduled-actions/templates.ts
 import { readFile as readFile32 } from "fs/promises";
 import path46 from "path";
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand196 } 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.",
@@ -57560,7 +58098,7 @@ registerSchema({
     }
   }
 });
-var templatesCommand = defineCommand195({
+var templatesCommand = defineCommand196({
   meta: {
     name: "templates",
     description: `The recipes this company can run \u2014 Baker's own plus theirs, with what each one produces.
@@ -57652,7 +58190,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand196 } from "citty";
+import { defineCommand as defineCommand197 } 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.",
@@ -57660,7 +58198,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand196({
+var triggerCommand = defineCommand197({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -57697,7 +58235,7 @@ var triggerCommand = defineCommand196({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -57728,7 +58266,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand4 = defineCommand197({
+var updateCommand4 = defineCommand198({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Examples: baker scheduled-actions update <id> --enabled false | baker scheduled-actions update <id> --mode publish"
@@ -57806,7 +58344,7 @@ var updateCommand4 = defineCommand197({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand198({
+var scheduledActionsCommand = defineCommand199({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger, templates.
@@ -57835,14 +58373,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand200 } 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 = defineCommand199({
+var schemaCommand2 = defineCommand200({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -57886,10 +58424,10 @@ var schemaCommand2 = defineCommand199({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand209 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand201 } from "citty";
 
 // src/commands/studio/batch.ts
 function projectBatch(generation, full) {
@@ -58366,7 +58904,7 @@ function costHintsFor(body) {
   }
   return hints2;
 }
-var animateCommand = defineCommand200({
+var animateCommand = defineCommand201({
   meta: {
     name: "animate",
     description: "Render a clip. With an image the look is already fixed, so the prompt describes MOVEMENT \u2014 what the camera does, what the subject does, in what order. With --from text there is no image and the prompt is the whole shot.\n\nA rendered clip is NOT usable anywhere until you keep it: `baker studio keep <id> --slot N` is what puts it in the video library. Takes nobody keeps are never ingested, which is what makes a rejected batch cheap.\n\nFor anything longer than 15 seconds, or to build on footage that already exists, use --model bytedance/seedance-2.5: it renders 4-30s and is the only model that reads an existing clip or an existing soundtrack.\n\nExamples:\n  baker studio animate 'slow push in, model turns to camera and smiles' --image j57abc123def456ghi789\n  baker studio animate 'she looks to camera and says: \"Hola, soy Elena\"' --avatar elena --quality 720p --aspect-ratio 9:16\n  baker studio animate 'handheld drift right, steam rising from the cup' --image './out/hero.png' --duration 6 --quality 1080p\n  baker studio animate 'product rotates once on a turntable' --image j57abc\u2026,j57def\u2026 --from references\n  baker studio animate 'she keeps walking, camera stays with her, then she stops and looks up' --image j57abc\u2026 --from references --from-clip j57batch\u2026:0 --model bytedance/seedance-2.5 --duration 20\n  baker studio animate 'hold on the product, then a slow push-in' --from references --from-video j57vid\u2026 --model bytedance/seedance-2.5\n  baker studio animate 'slow drone pull-back over a solar farm at golden hour, no people' --from text --model bytedance/seedance-2.5 --duration 12"
@@ -58490,7 +59028,7 @@ var animateCommand = defineCommand200({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand202 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -58626,7 +59164,7 @@ function buildGenerateBody(args, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand201({
+var generateCommand = defineCommand202({
   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]]'"
@@ -58709,7 +59247,7 @@ var generateCommand = defineCommand201({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand203 } 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.",
@@ -58718,7 +59256,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand202({
+var getCommand5 = defineCommand203({
   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"
@@ -58747,7 +59285,7 @@ var getCommand5 = defineCommand202({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand203 } from "citty";
+import { defineCommand as defineCommand204 } 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",
@@ -58772,7 +59310,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand203({
+var improveCommand = defineCommand204({
   meta: {
     name: "improve",
     description: `${DESCRIPTION}
@@ -58816,7 +59354,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand205 } 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.",
@@ -58826,7 +59364,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand204({
+var keepCommand = defineCommand205({
   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"
@@ -58877,7 +59415,7 @@ var keepCommand = defineCommand204({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand206 } 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.",
@@ -58888,7 +59426,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand17 = defineCommand205({
+var listCommand17 = defineCommand206({
   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"
@@ -58922,7 +59460,7 @@ var listCommand17 = defineCommand205({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand207 } 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",
@@ -59009,7 +59547,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand206({
+var modelsCommand = defineCommand207({
   meta: {
     name: "models",
     description: `${DESCRIPTION2}
@@ -59056,13 +59594,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand208 } 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 = defineCommand207({
+var skillsCommand = defineCommand208({
   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"
@@ -59086,7 +59624,7 @@ var skillsCommand = defineCommand207({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand208({
+var studioCommand = defineCommand209({
   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.
@@ -59129,10 +59667,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand209 } from "citty";
+import { defineCommand as defineCommand210 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync18 } from "fs";
@@ -59255,13 +59793,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand5 = defineCommand209({
+var draftCommand5 = defineCommand210({
   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: defineCommand209({
+    list: defineCommand210({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -59274,7 +59812,7 @@ var draftCommand5 = defineCommand209({
         await draftList2(args.json === true, args.chat);
       }
     }),
-    show: defineCommand209({
+    show: defineCommand210({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -59291,7 +59829,7 @@ var draftCommand5 = defineCommand209({
         );
       }
     }),
-    amend: defineCommand209({
+    amend: defineCommand210({
       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."
@@ -59308,7 +59846,7 @@ var draftCommand5 = defineCommand209({
         });
       }
     }),
-    remove: defineCommand209({
+    remove: defineCommand210({
       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 }) => {
@@ -59317,7 +59855,7 @@ var draftCommand5 = defineCommand209({
         });
       }
     }),
-    clear: defineCommand209({
+    clear: defineCommand210({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -59327,7 +59865,7 @@ var draftCommand5 = defineCommand209({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand211 } 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.",
@@ -59368,7 +59906,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand210({
+var containersCommand = defineCommand211({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -59385,7 +59923,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand210({
+var readCommand = defineCommand211({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -59427,7 +59965,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -59483,10 +60021,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand211({
+  return defineCommand212({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand211({
+      create: defineCommand212({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -59508,7 +60046,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand211({
+      update: defineCommand212({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -59528,7 +60066,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand211({
+      delete: defineCommand212({
         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 },
@@ -59569,7 +60107,7 @@ function builtinTypes(args) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand211({
+var builtinCommand = defineCommand212({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -59579,7 +60117,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand211({
+    enable: defineCommand212({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -59593,7 +60131,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand211({
+    disable: defineCommand212({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -59611,7 +60149,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand212({
+var tagManagerCommand = defineCommand213({
   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.
@@ -59648,7 +60186,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand214 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -59687,6 +60225,12 @@ function renderEffectiveEntry(entry) {
   return configLines.length > 0 ? `${header}
 ${configLines.join("\n")}` : header;
 }
+function tagsListHints() {
+  return [
+    "To create, edit or delete a tag, call the `request_tag_input` approval form (tool `mcp__baker_ui__request_tag_input`, server `baker_ui`) \u2014 it is attached to every turn of this chat and collects any secret values itself.",
+    "Do NOT conclude the form is unavailable from your tool list: call it, and report what it returns. And never file a tag change as a Task \u2014 a Task hands the user work this chat can stage in one call."
+  ];
+}
 
 // src/commands/tags/index.ts
 registerSchema({
@@ -59700,16 +60244,21 @@ async function listTags(json) {
   try {
     const chatId = requireChatId();
     const response = await apiPost("/api/tags/list", { chatId });
+    const hints2 = tagsListHints();
     if (json) {
-      writeJson({ ok: true, data: response });
+      writeJson({ ok: true, data: response, hints: hints2 });
       return;
     }
     if (response.tags.length === 0) {
-      process.stdout.write("No tags configured. Propose one with the request_tag_input tool (baker_ui).\n");
-      return;
+      process.stdout.write("No tags configured.\n");
+    } else {
+      process.stdout.write(`${response.tags.map(renderEffectiveEntry).join("\n")}
+`);
     }
-    process.stdout.write(`${response.tags.map(renderEffectiveEntry).join("\n")}
+    for (const hint of hints2) {
+      process.stderr.write(`${hint}
 `);
+    }
   } catch (err) {
     failApi3(err);
   }
@@ -59717,7 +60266,7 @@ async function listTags(json) {
 var listArgs10 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand18 = defineCommand213({
+var listCommand18 = defineCommand214({
   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"
@@ -59731,12 +60280,12 @@ async function listDraft4(chat) {
   try {
     const chatId = resolveChatId(chat);
     const response = await apiPost("/api/tags/draft", { chatId });
-    writeJson({ ok: true, data: response });
+    writeJson({ ok: true, data: response, hints: tagsListHints() });
   } catch (err) {
     failApi3(err);
   }
 }
-var draftCommand6 = defineCommand213({
+var draftCommand6 = defineCommand214({
   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."
@@ -59746,7 +60295,7 @@ var draftCommand6 = defineCommand213({
     await listDraft4(args.chat);
   }
 });
-var tagsCommand4 = defineCommand213({
+var tagsCommand4 = defineCommand214({
   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.
@@ -59775,10 +60324,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -59786,7 +60335,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand214({
+var getCommand6 = defineCommand215({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -59823,7 +60372,7 @@ var getCommand6 = defineCommand214({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -59980,7 +60529,7 @@ function buildListParams(args) {
   }
   return params;
 }
-var listCommand19 = defineCommand215({
+var listCommand19 = defineCommand216({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -60040,7 +60589,7 @@ var listCommand19 = defineCommand215({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -60119,7 +60668,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand3 = defineCommand216({
+var searchCommand3 = defineCommand217({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -60183,7 +60732,7 @@ var searchCommand3 = defineCommand216({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand217({
+var testimonialsCommand = defineCommand218({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -60205,10 +60754,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand219 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -60222,7 +60771,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand218({
+var deleteCommand4 = defineCommand219({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -60262,8 +60811,83 @@ var deleteCommand4 = defineCommand218({
   }
 });
 
+// src/commands/videos/describe.ts
+import { defineCommand as defineCommand220 } 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 = defineCommand220({
+  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 defineCommand219 } from "citty";
+import { defineCommand as defineCommand221 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -60271,7 +60895,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand219({
+var getCommand7 = defineCommand221({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -60308,7 +60932,7 @@ var getCommand7 = defineCommand219({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand222 } 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)",
@@ -60317,7 +60941,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand220({
+var groupCommand2 = defineCommand222({
   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>"
@@ -60340,7 +60964,7 @@ var groupCommand2 = defineCommand220({
 import { mkdtemp as mkdtemp3, rm as rm9, stat as stat11 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
 import path47 from "path";
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -60504,7 +61128,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand221({
+var ingestCommand2 = defineCommand223({
   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"
@@ -60766,7 +61390,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -60776,7 +61400,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand222({
+var searchCommand4 = defineCommand224({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -60828,7 +61452,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile33, stat as stat12 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -60870,7 +61494,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand223({
+var uploadCommand2 = defineCommand225({
   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"
@@ -60954,10 +61578,10 @@ var uploadCommand2 = defineCommand223({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand224({
+var videosCommand = defineCommand226({
   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
@@ -60965,6 +61589,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`
@@ -60975,16 +61600,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 defineCommand237 } from "citty";
+import { defineCommand as defineCommand239 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList2(value) {
@@ -61037,7 +61663,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand225({
+var advertisersCommand2 = defineCommand227({
   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'
@@ -61095,7 +61721,7 @@ var advertisersCommand2 = defineCommand225({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand228 } 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.",
@@ -61141,7 +61767,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand226({
+var briefCommand = defineCommand228({
   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`
@@ -61177,7 +61803,7 @@ var briefCommand = defineCommand226({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand229 } 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.",
@@ -61190,7 +61816,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand227({
+var contentCommand = defineCommand229({
   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"
@@ -61239,7 +61865,7 @@ var contentCommand = defineCommand227({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand230 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList2(input.advertiser);
@@ -61291,7 +61917,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand228({
+var feedCommand = defineCommand230({
   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"
@@ -61376,7 +62002,7 @@ var feedCommand = defineCommand228({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand229 } from "citty";
+import { defineCommand as defineCommand231 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -61391,7 +62017,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand229({
+var followCommand = defineCommand231({
   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'
@@ -61438,7 +62064,7 @@ var followCommand = defineCommand229({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand230 } from "citty";
+import { defineCommand as defineCommand232 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -61471,7 +62097,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand230({
+var followCompetitorsCommand = defineCommand232({
   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"'
@@ -61546,7 +62172,7 @@ var followCompetitorsCommand = defineCommand230({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand231 } from "citty";
+import { defineCommand as defineCommand233 } 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.",
@@ -61600,7 +62226,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand231({
+var followingCommand = defineCommand233({
   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"
@@ -61636,7 +62262,7 @@ var followingCommand = defineCommand231({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand234 } 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.",
@@ -61675,7 +62301,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand232({
+var patternsCommand = defineCommand234({
   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"
@@ -61731,7 +62357,7 @@ var patternsCommand = defineCommand232({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand233 } from "citty";
+import { defineCommand as defineCommand235 } 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.",
@@ -61839,7 +62465,7 @@ function buildSearchBody2(args) {
   }
   return body;
 }
-var searchCommand5 = defineCommand233({
+var searchCommand5 = defineCommand235({
   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"
@@ -61954,7 +62580,7 @@ var searchCommand5 = defineCommand233({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand236 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -61982,7 +62608,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand234({
+  return defineCommand236({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -62031,7 +62657,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand237 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -62039,7 +62665,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand235({
+var unfollowCommand = defineCommand237({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -62060,7 +62686,7 @@ var unfollowCommand = defineCommand235({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand236 } from "citty";
+import { defineCommand as defineCommand238 } 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.",
@@ -62070,7 +62696,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand236({
+var winnersCommand = defineCommand238({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -62120,7 +62746,7 @@ var winnersCommand = defineCommand236({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand237({
+var winningAdsCommand = defineCommand239({
   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.
@@ -62358,7 +62984,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand238({
+var main = defineCommand240({
   meta: {
     name: "baker",
     version: getCliVersion(),