@koda-sl/baker-cli 0.253.0 → 0.259.0-dev.dcbb0c10b

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-SJPRTSGY.js";
+} from "./chunk-R4MBS2OI.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -67,7 +67,7 @@ import {
   resolveAccountIdArg,
   resolveEffectiveStatus,
   todayIso
-} from "./chunk-P6ZNIFAQ.js";
+} from "./chunk-2VM2J6MB.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -83,17 +83,17 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-5I66YT7A.js";
+} from "./chunk-TBEVU7XF.js";
 import {
   ApiError,
   apiGet,
   apiPost,
   validateConvexId
-} from "./chunk-3FBQKD7O.js";
+} from "./chunk-ECPNYXOA.js";
 import {
   installStreamTaps,
   logInvocation
-} from "./chunk-2IB3IL4K.js";
+} from "./chunk-GXRUZ4LP.js";
 import {
   captureBudgetMs,
   captureProxyCredentials,
@@ -105,10 +105,10 @@ import {
   requireChatId,
   resolveChatId,
   shouldEscalate
-} from "./chunk-DZUVUGEP.js";
+} from "./chunk-POYXIDOD.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand227, runMain } from "citty";
+import { defineCommand as defineCommand228, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -3682,6 +3682,7 @@ var avatarProfileSchema = z7.object({
   subjectDescription: z7.string().trim().min(1).max(2e3),
   persona: z7.string().trim().max(2e3).optional(),
   speech: z7.string().trim().max(2e3).optional(),
+  accent: z7.string().trim().max(2e3).optional(),
   motion: z7.string().trim().max(2e3).optional(),
   wardrobe: z7.string().trim().max(2e3).optional(),
   setting: z7.string().trim().max(2e3).optional(),
@@ -3697,7 +3698,6 @@ var avatarSummarySchema = z7.object({
   /** The identity sheet to wire into `--reference`. Absent until the build settles. */
   sheetUrl: z7.string().optional(),
   coverUrl: z7.string().optional(),
-  hasVoice: z7.boolean(),
   errorMessage: z7.string().optional()
 });
 var avatarDetailSchema = avatarSummarySchema.extend({
@@ -4292,7 +4292,7 @@ var FLOW_NODE_CATALOG = [
         }
       }
     },
-    gotcha: "`fieldtype` is one of: checkbox, date_picker, date_time_range, email, hidden, input, multi_select, number, phone, select, textarea. `select`/`multi_select` need non-empty `options`; `phone` needs `defaultCountry`; a field rendered by your own code is declared `hidden`. A field your page validates itself (postal code against a service area, VAT number, order reference) also needs `testValue` \u2014 the Form's own checks invent `TestValue` otherwise and never get past that step. A field holding something that has no business on a dashboard the client's whole team can open \u2014 a date of birth, a policy or account number, a salary, anything medical or legal \u2014 takes `sensitive: true`: an email or phone is masked already, everything else is reported verbatim unless marked. A contact field that is not the visitor's own (a manager's address, the office number) takes `identity: \"none\"`, or two people are filed as one.",
+    gotcha: "`fieldtype` is one of: checkbox, date_picker, date_time_range, email, hidden, input, multi_select, number, phone, select, textarea. `select`/`multi_select` need non-empty `options`; `phone` needs `defaultCountry`; a field rendered by your own code is declared `hidden`. A field your page validates itself (postal code against a service area, VAT number, order reference) also needs `testValue` \u2014 the Form's own checks invent `TestValue` otherwise and never get past that step.",
     reference: NODE_REF("customForm")
   },
   {
@@ -7411,7 +7411,11 @@ registerSchema({
   command: "actions.status",
   description: "Resolve one or more Work Action refs by real action ID or temp_* ref in a single batch call. When BAKER_CHAT_ID is set, a temp_* ref still staged in THIS chat resolves to status 'draft' (not 'not_found') \u2014 staged ops only become published actions on chat publish.",
   args: {
-    refs: { type: "string", description: "One or more action refs: real action IDs or temp_* refs", required: true }
+    ref: {
+      type: "positional",
+      description: "One or more action refs: real action IDs or temp_* refs (space-separated)",
+      required: true
+    }
   }
 });
 var statusCommand = defineCommand11({
@@ -9780,11 +9784,11 @@ function rawTextEntries(value) {
   const values = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
   return values.filter((v) => typeof v === "string").flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
-function rawFileEntries(path38) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function rawFileEntries(path39) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return [];
   }
-  return readFileSync2(path38, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path39, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args) {
   const defaultMatch = typeof args["match-type"] === "string" ? args["match-type"].toUpperCase() : void 0;
@@ -9807,19 +9811,19 @@ function keywordEntries(args) {
   }
   return entries;
 }
-function loadJsonFileArg(path38) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function loadJsonFileArg(path39) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync2(path38, "utf8"));
+    const parsed = JSON.parse(readFileSync2(path39, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${path38} must contain a JSON object`);
+      failWriteValidation(`${path39} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation(`${path38} is not valid JSON: ${err.message}`);
+      failWriteValidation(`${path39} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -9949,10 +9953,10 @@ async function stageUpdate(kind, customerId, target, payload, hints) {
 async function stageTarget(kind, customerId, target, hints) {
   await stageGoogleOp({ kind, customerId, target }, hints);
 }
-async function draftAction(path38, body, chat) {
+async function draftAction(path39, body, chat) {
   try {
     const chatId = resolveChatId(chat);
-    const response = await apiPost(path38, { chatId, ...body });
+    const response = await apiPost(path39, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -12316,10 +12320,10 @@ var analyticsPresetSchema = z24.enum([
    */
   "geo",
   /**
-   * Which machines are fetching this site.
+   * Which machines are fetching this site, and whether they are genuine.
    *
-   * Every other preset here excludes them, which is correct — a crawler is not
-   * an audience — and a verify check now enforces that rather than trusting it. The rows are kept, though, and this is what
+   * Every other preset here ends "and exclude the bots", which is correct — a
+   * crawler is not an audience. The rows are kept, though, and this is what
    * they are kept for: whether Google is still crawling a page that was
    * republished, whether Meta fetched the link preview before spend went
    * behind the URL, and how much of the traffic is now AI answer engines.
@@ -12989,6 +12993,12 @@ var analyticsBotRowSchema = z24.object({
   bot: z24.string(),
   /** `search` | `ai` | `social` | `seo` | `monitoring` | `tool` | `automation`. */
   category: z24.string(),
+  /**
+   * Cloudflare confirmed it by the network it came from, rather than believing
+   * its user agent. A page fetched only by unverified self-declared Googlebots
+   * was not crawled by Google.
+   */
+  verified: z24.boolean(),
   hits: z24.number().int().nonnegative(),
   pages: z24.number().int().nonnegative(),
   lastSeen: z24.string(),
@@ -15160,19 +15170,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path38) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function loadJsonFileArg2(path39) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync4(path38, "utf8"));
+    const parsed = JSON.parse(readFileSync4(path39, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path38} must contain a JSON object`);
+      failWriteValidation2(`${path39} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path38} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path39} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -15257,15 +15267,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path38) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function loadTargetingFileArg(path39) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path38);
+  const parsed = loadJsonFileArg2(path39);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path38} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path39} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -15300,14 +15310,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell2) => cell2.trim());
 }
-function parseListFileArg(path38, maxRows) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function parseListFileArg(path39, maxRows) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return void 0;
   }
-  const raw = readFileSync4(path38, "utf8");
+  const raw = readFileSync4(path39, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path38} needs a header row and at least one data row`);
+    failWriteValidation2(`${path39} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -15326,7 +15336,7 @@ function parseListFileArg(path38, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path38} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path39} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -15422,11 +15432,11 @@ function readPositionals(args) {
 function splitIdList(raw) {
   return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function idsFileEntries(path38) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function idsFileEntries(path39) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return [];
   }
-  return readFileSync4(path38, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  return readFileSync4(path39, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
 }
 function requireTargets(args, entity) {
   const positionals = readPositionals(args);
@@ -18047,9 +18057,9 @@ function compactRow(row) {
     ...destination.postUrn ? { postUrn: destination.postUrn } : {}
   };
 }
-function readPath(row, path38) {
+function readPath(row, path39) {
   let current = row;
-  for (const segment of path38.split(".")) {
+  for (const segment of path39.split(".")) {
     const record = asRecord2(current);
     if (!record) return void 0;
     current = record[segment];
@@ -18059,10 +18069,10 @@ function readPath(row, path38) {
 function projectFields(rows, paths) {
   return rows.map((row) => {
     const projected = {};
-    for (const path38 of paths) {
-      const value = readPath(row, path38);
+    for (const path39 of paths) {
+      const value = readPath(row, path39);
       if (value !== void 0) {
-        projected[path38] = value;
+        projected[path39] = value;
       }
     }
     return projected;
@@ -19260,14 +19270,6 @@ var CTA_TYPES2 = [
   "BUY_TICKETS",
   "NO_BUTTON"
 ];
-var LEAD_FORM_CTA_TYPES = [
-  "APPLY_NOW",
-  "DOWNLOAD",
-  "GET_QUOTE",
-  "LEARN_MORE",
-  "SIGN_UP",
-  "SUBSCRIBE"
-];
 var AD_FORMATS2 = ["SINGLE_IMAGE", "CAROUSEL", "SINGLE_VIDEO"];
 var ENROLL_STATUSES = ["OPT_IN", "OPT_OUT"];
 var STAGEABLE_CREATE_STATUSES3 = ["ACTIVE", "PAUSED"];
@@ -19370,11 +19372,11 @@ var updateStatusSchema = z25.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path38) {
+function validateDailyBudgetFloor(money, ctx, path39) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path38, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path39, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -19690,23 +19692,7 @@ var descriptionSchema = z25.string().min(1).max(META_LIMITS.creative.description
 var callToActionSchema = z25.object({
   type: z25.enum(CTA_TYPES2),
   /** Overrides the base link for the CTA button; defaults to the ad's link. */
-  link: httpsUrlSchema3.optional(),
-  /**
-   * The instant form the button opens — Meta's `call_to_action.value.lead_gen_form_id`.
-   * This is the ONLY place an instant form is named: the ad set says leads open
-   * on the ad (`destination_type: ON_AD`), and the creative says which form.
-   * Without it Meta refuses every ad in that ad set with subcode 3390001,
-   * "Choose or create an instant form for your leads campaign".
-   */
-  lead_gen_form_id: z25.string().regex(NUMERIC_ID_REGEX3).optional()
-}).superRefine((p, ctx) => {
-  if (p.lead_gen_form_id && !LEAD_FORM_CTA_TYPES.some((allowed) => allowed === p.type)) {
-    ctx.addIssue({
-      code: "custom",
-      path: ["type"],
-      message: `${p.type} cannot open an instant form \u2014 Meta refuses it (subcode 1856030). Use one of ${LEAD_FORM_CTA_TYPES.join(", ")}, or drop lead_gen_form_id if this ad should go to the website.`
-    });
-  }
+  link: httpsUrlSchema3.optional()
 });
 var creativeEnhancementsSchema = z25.object({
   standardEnhancements: z25.enum(ENROLL_STATUSES).optional(),
@@ -19804,19 +19790,6 @@ var carouselCreativeSchema2 = z25.object({
   link: httpsUrlSchema3.optional(),
   call_to_action: callToActionSchema.optional(),
   cards: z25.array(carouselCardSchema).min(META_LIMITS.creative.carouselCardsMin).max(META_LIMITS.creative.carouselCardsMax)
-}).superRefine((p, ctx) => {
-  const forms = new Set(
-    [p.call_to_action?.lead_gen_form_id, ...p.cards.map((card) => card.call_to_action?.lead_gen_form_id)].filter(
-      Boolean
-    )
-  );
-  if (forms.size > 1) {
-    ctx.addIssue({
-      code: "custom",
-      path: ["cards"],
-      message: `every card of a carousel must open the SAME instant form \u2014 this one names ${[...forms].join(" and ")}`
-    });
-  }
 });
 var dynamicImageSchema = z25.object({ ...imageMediaFields }).refine((p) => countImageRefs(p) === 1, "each dynamic image needs exactly one reference");
 var dynamicVideoSchema = z25.object({
@@ -20072,19 +20045,19 @@ function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg3(path38) {
-  if (typeof path38 !== "string" || path38.length === 0) {
+function loadJsonFileArg3(path39) {
+  if (typeof path39 !== "string" || path39.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync8(path38, "utf8"));
+    const parsed = JSON.parse(readFileSync8(path39, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path38} must contain a JSON object`);
+      failWriteValidation3(`${path39} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path38} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path39} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -20323,10 +20296,7 @@ var adSetWriteArgs = {
   "daily-budget": { type: "string", description: "Daily budget (ABO; omit if the campaign uses CBO)" },
   "lifetime-budget": { type: "string", description: "Lifetime budget (needs --end)" },
   "bid-amount": { type: "string", description: "Bid amount (required for COST_CAP / bid-cap strategies)" },
-  "bid-strategy": {
-    type: "string",
-    description: "LOWEST_COST_WITHOUT_CAP (auto-bid) | LOWEST_COST_WITH_BID_CAP | COST_CAP \u2014 needs --bid-amount. Omit and Baker sets auto-bid; never leave it to Meta, whose default is a bid cap that then fails without an amount."
-  },
+  "bid-strategy": { type: "string", description: "Bid strategy override" },
   currency: { type: "string", description: "3-letter currency (defaults to the account currency)" },
   start: { type: "string", description: "Start time" },
   end: { type: "string", description: "End time" },
@@ -20393,7 +20363,7 @@ function creativePayloadFromFlags(args) {
     headline: args.headline,
     description: args.description,
     caption: args.caption,
-    call_to_action: creativeCta(args),
+    call_to_action: args.cta ? { type: upper(args.cta) } : void 0,
     imageHash: args["image-hash"],
     imageRef: args["image-ref"],
     videoId: args["video-id"],
@@ -20403,26 +20373,6 @@ function creativePayloadFromFlags(args) {
     enhancements
   };
 }
-function ctaPatchFromFlags(args) {
-  const patch = {
-    ...args.cta ? { type: String(upper(args.cta)) } : {},
-    ...args["lead-form"] === void 0 ? {} : { lead_gen_form_id: String(args["lead-form"]) }
-  };
-  return Object.keys(patch).length > 0 ? patch : void 0;
-}
-function creativeCta(args) {
-  const patch = ctaPatchFromFlags(args);
-  return patch ? { type: "SIGN_UP", ...patch } : void 0;
-}
-function creativeContentPatch2(file, args) {
-  const cta = ctaPatchFromFlags(args);
-  if (!cta) {
-    return void 0;
-  }
-  const fileContent = file.content ?? {};
-  const fileCta = fileContent.call_to_action ?? {};
-  return { ...fileContent, call_to_action: { ...fileCta, ...cta } };
-}
 function parseEnroll(value) {
   const raw = String(value).toLowerCase();
   if (raw === "on" || raw === "true" || raw === "opt_in") return "OPT_IN";
@@ -20449,10 +20399,6 @@ Example: baker ads meta creatives create --page 555 --message "Save now" --link
     description: { type: "string", description: "Description" },
     caption: { type: "string", description: "Display URL / caption" },
     cta: { type: "string", description: "Call-to-action type (SHOP_NOW|LEARN_MORE|SIGN_UP|\u2026)" },
-    "lead-form": {
-      type: "string",
-      description: "Instant form id the button opens \u2014 REQUIRED for an ad set that collects leads on the ad. List them with `baker ads meta lead-forms`. With a form, --cta must be APPLY_NOW|DOWNLOAD|GET_QUOTE|LEARN_MORE|SIGN_UP|SUBSCRIBE"
-    },
     "image-hash": { type: "string", description: "Meta ad-image hash (already uploaded)" },
     "image-ref": { type: "string", description: "meta_temp_* ref of a staged media upload" },
     "video-id": { type: "string", description: "Meta video id (already uploaded)" },
@@ -20486,11 +20432,6 @@ Amending a staged (meta_temp_*) creative merges fields into the create. Example:
     ...accountArgs2,
     name: { type: "string", description: "New name" },
     status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED" },
-    cta: { type: "string", description: "Call-to-action type (staged creatives only)" },
-    "lead-form": {
-      type: "string",
-      description: "Instant form id the button opens (staged creatives only) \u2014 `baker ads meta lead-forms` lists them"
-    },
     file: {
       type: "string",
       description: "JSON file with fields to change (content only merges into a staged creative)"
@@ -20498,15 +20439,7 @@ Amending a staged (meta_temp_*) creative merges fields into the create. Example:
   },
   run: async ({ args }) => {
     const accountId = bareAccountId2(args);
-    const file = loadJsonFileArg3(args.file);
-    const payload = mergePayload3(file, {
-      name: args.name,
-      status: upper(args.status),
-      // A creative's content is immutable on Meta, so this only ever lands on a
-      // creative still staged in this chat — which is exactly the fix path when
-      // staging an ad refuses it for naming no instant form.
-      content: creativeContentPatch2(file, args)
-    });
+    const payload = mergePayload3(loadJsonFileArg3(args.file), { name: args.name, status: upper(args.status) });
     await stageOp2({
       kind: "adCreative.update",
       accountId,
@@ -20677,10 +20610,10 @@ function duplicateCommand2(entity, label) {
       replace: { type: "boolean", description: "Pause the original once the copy publishes" }
     },
     run: async ({ args }) => {
-      const { apiPost: apiPost2 } = await import("./client-32DO7WEZ.js");
-      const { requireChatId: requireChatId2 } = await import("./env-FWMZXMQK.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-WRHUJR74.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-T66YQ6MB.js");
+      const { apiPost: apiPost2 } = await import("./client-7QIDRQXG.js");
+      const { requireChatId: requireChatId2 } = await import("./env-HZNFGXAR.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-MWMAXN4M.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-NFLXWGHK.js");
       try {
         const accountId = bareAccountId2(args);
         const chatId = requireChatId2();
@@ -23696,7 +23629,7 @@ var ANALYTICS_PRESET_INFO = [
   },
   {
     name: "flow",
-    description: "One Form in depth: conversions counted at the node that produced them, step-to-step paths for a branching Form, the per-step table, every trigger raised, and each marked conversion by name. Read convertedSessions rather than submits \u2014 a Form whose scheduling widget sits mid-flow never emits a submit and reports zero on every other report. An empty `conversions` array means nobody has marked what this Form is for, so the numbers rest on a built-in guess; mark it in the Forms builder or with `conversions: [{ triggerId }]` on the node. `flowDestinations` is the other half and is evidence rather than a count: which Forms demonstrably handed something over in this window. Read it against the scaffold's `flow-no-destination` warning before acting on one \u2014 the stored picture of a Form is only rewritten when it is published, so a destination added since then shows there and not in the tree.",
+    description: "One Form in depth: conversions counted at the node that produced them, step-to-step paths for a branching Form, the per-step table, every trigger raised, and each marked conversion by name. Read convertedSessions rather than submits \u2014 a Form whose scheduling widget sits mid-flow never emits a submit and reports zero on every other report. An empty `conversions` array means nobody has marked what this Form is for, so the numbers rest on a built-in guess; mark it in the Forms builder or with `conversions: [{ triggerId }]` on the node.",
     playbook: "flow-builder \u2014 fix the branch or the step that loses people"
   },
   {
@@ -23731,7 +23664,7 @@ var ANALYTICS_PRESET_INFO = [
   },
   {
     name: "bots",
-    description: "Which machines fetch this site. Every other report here excludes them; this one reads them. Answers whether Google is still crawling a page after it was republished, whether Meta fetched a link preview before spend went behind the URL, and how much of the traffic is now AI answer engines.",
+    description: "Which machines fetch this site and whether they are genuine. Every other report here excludes them; this one reads them. Answers whether Google is still crawling a page after it was republished, whether Meta fetched a link preview before spend went behind the URL, and how much of the traffic is now AI answer engines.",
     playbook: "landing \u2014 a page that stopped being crawled stops ranking, weeks before the traffic shows it"
   },
   {
@@ -24175,7 +24108,7 @@ var funnelCommand = presetCommand({
 var flowCommand = presetCommand({
   name: "flow",
   preset: "flow",
-  description: "One Form in depth: how many people it converted, where they went between steps, the per-step table, and every trigger it raised. Every count is DISTINCT VISITS, so quote shares against `funnels[].visits` \u2014 the visits that opened the Form \u2014 and never against `starts`, which is only the visits that touched it. The gap between the two is people who read the Form and left, and on most Forms it is the largest loss there is. Read `flowSummary.convertedSessions`, not `submits` \u2014 a Form that books a call on a scheduling node in the MIDDLE of the flow never emits a submit, so it reports zero submits and every one of its real bookings as conversions. `flowPaths` is the flow as edges between steps, bracketed by __flow_start__, __flow_converted__ and __flow_exit__, which is how a branching Form is read at all: a per-step table cannot say that of the people who left step two, forty went to the booking branch and ninety went nowhere. `flowDestinations` is the other half and is evidence rather than a count: which Forms demonstrably handed something over in this window. Read it against the scaffold's `flow-no-destination` warning before acting on one \u2014 the stored picture of a Form is only rewritten when it is published, so a destination added since then shows there and not in the tree.",
+  description: "One Form in depth: how many people it converted, where they went between steps, the per-step table, and every trigger it raised. Every count is DISTINCT VISITS, so quote shares against `funnels[].visits` \u2014 the visits that opened the Form \u2014 and never against `starts`, which is only the visits that touched it. The gap between the two is people who read the Form and left, and on most Forms it is the largest loss there is. Read `flowSummary.convertedSessions`, not `submits` \u2014 a Form that books a call on a scheduling node in the MIDDLE of the flow never emits a submit, so it reports zero submits and every one of its real bookings as conversions. `flowPaths` is the flow as edges between steps, bracketed by __flow_start__, __flow_converted__ and __flow_exit__, which is how a branching Form is read at all: a per-step table cannot say that of the people who left step two, forty went to the booking branch and ninety went nowhere.",
   extraArgs: { flow: { type: "string", description: "Form slug (default: every Form)", required: false } },
   resolve: (args) => ({ preset: "flow", flowSlug: args.flow ? String(args.flow) : void 0 })
 });
@@ -24517,7 +24450,8 @@ import { defineCommand as defineCommand94 } from "citty";
 import { defineCommand as defineCommand89 } from "citty";
 
 // src/commands/avatars/casting.ts
-var VERBATIM_RULE = "Copy `subjectDescription` into the prompt VERBATIM, word for word. Re-phrasing it per generation is the other reason a face drifts across a set \u2014 treat it as an identifier that happens to read as prose.";
+var CAST_FLAG_RULE = "Cast with `--avatar <handle>` on `baker studio generate` and `baker studio animate`. Do NOT hand-roll it by pasting `subjectDescription` into the prompt or by passing the sheet through `--reference` \u2014 both render something that merely resembles them. `--avatar` is also the ONLY thing that carries their pinned VOICE and how they speak into a clip; without it the video model invents a different voice, and no later step can put theirs back.";
+var VERBATIM_RULE = "When you do write the description yourself \u2014 a 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") {
@@ -24541,7 +24475,8 @@ function castingHints(avatar) {
     ];
   }
   return [
-    `Ready to cast. Ground every render on the identity sheet, never on a source photo: \`baker images generate "<your scene>" --reference ${avatar.sheetUrl}\`.`,
+    `Ready to cast: \`baker studio generate "<your scene>" --avatar ${avatar.handle}\` for a still, \`baker studio animate "<the motion, and the line they say>" --avatar ${avatar.handle}\` for a clip.`,
+    CAST_FLAG_RULE,
     VERBATIM_RULE,
     VIDEO_ROUTING
   ];
@@ -24553,7 +24488,6 @@ function rosterRow(avatar) {
     status: avatar.status,
     likeness: avatar.likeness,
     sheetUrl: avatar.sheetUrl ?? null,
-    hasVoice: avatar.hasVoice,
     avatarId: avatar.avatarId,
     ...avatar.errorMessage ? { errorMessage: avatar.errorMessage } : {}
   };
@@ -24581,10 +24515,19 @@ function rosterHints(roster, statusFilter) {
   }
   return hints;
 }
-function creationHints(created) {
+function thinProfileHint(profile, handle) {
+  const missing = ["motion", "persona", "speech", "accent", "wardrobe", "setting"].filter(
+    (field) => !profile?.[field]?.trim()
+  );
+  if (missing.length === 0) return null;
+  return `MISSING ${missing.map((field) => `--${field}`).join(" ")}. A bare subject description holds the face still and nothing else, so clips of @${handle} come out stiff and generic \u2014 measured, filling these in nearly doubled the movement in the same brief. --accent is the one nobody guesses and the only one that fails silently: it decides the accent the avatar SPEAKS with in every clip, so name the region the user is writing to you from ("Spanish from Spain, Madrid accent") \u2014 "Spanish" on its own renders as no accent at all. The user almost certainly told you how this person talks and carries themselves; put it in: \`baker avatars update ${handle} ${missing.map((field) => `--${field} "\u2026"`).join(" ")}\`.`;
+}
+function creationHints(created, profile) {
+  const thin = thinProfileHint(profile, created.handle);
   const hints = [
+    ...thin ? [thin] : [],
     ...castingHints({ handle: created.handle, status: created.status }),
-    `Once it is ready, every render grounds on its identity sheet (\`--reference <sheetUrl>\`) and reuses the subject description you just wrote, word for word. Those two things are what keep the face identical across a set.`
+    `Once it is ready, cast it with \`--avatar ${created.handle}\` on \`baker studio generate\` / \`baker studio animate\` \u2014 that flag is what grounds the render on its identity sheet and, for a clip, what makes it speak in this avatar's own voice.`
   ];
   if (created.likeness === "licensed") {
     hints.push(
@@ -24670,6 +24613,7 @@ var TEXT_FIELDS = [
   ["subject", "subjectDescription"],
   ["persona", "persona"],
   ["speech", "speech"],
+  ["accent", "accent"],
   ["motion", "motion"],
   ["wardrobe", "wardrobe"],
   ["setting", "setting"]
@@ -24722,11 +24666,11 @@ function unwrap(response) {
   }
   return response.data;
 }
-async function readAvatars(path38, params) {
-  return unwrap(await apiGet(path38, params));
+async function readAvatars(path39, params) {
+  return unwrap(await apiGet(path39, params));
 }
-async function writeAvatars(path38, body) {
-  return unwrap(await apiPost(path38, body));
+async function writeAvatars(path39, body) {
+  return unwrap(await apiPost(path39, body));
 }
 
 // src/commands/avatars/create.ts
@@ -24758,7 +24702,12 @@ registerSchema({
       required: true
     },
     persona: { type: "string", description: "Who they are on camera \u2014 role, attitude, energy", required: false },
-    speech: { type: "string", description: "How they speak \u2014 pace, register, accent, verbal habits", required: false },
+    speech: { type: "string", description: "How they speak \u2014 pace, register, verbal habits", required: false },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish', 'British English, London'. Name the region \u2014 an adjective like 'clear Spanish accent' is read by the video model as NO accent, and the clip comes out sounding like nowhere. Set it whenever the avatar will speak; the user's own language is the default to assume, not English.",
+      required: false
+    },
     motion: { type: "string", description: "Body language and gesture in video", required: false },
     wardrobe: { type: "string", description: "Default outfit when the brief does not name one", required: false },
     setting: { type: "string", description: "Default surroundings when the brief leaves them open", required: false },
@@ -24792,6 +24741,11 @@ var createCommand2 = defineCommand89({
     subject: { type: "string", description: "The person, plainly described \u2014 reused verbatim", required: false },
     persona: { type: "string", description: "Who they are on camera", required: false },
     speech: { type: "string", description: "How they speak", required: false },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM \u2014 name the region, e.g. 'Spanish from Spain, Madrid accent'",
+      required: false
+    },
     motion: { type: "string", description: "Body language in video", required: false },
     wardrobe: { type: "string", description: "Default outfit", required: false },
     setting: { type: "string", description: "Default surroundings", required: false },
@@ -24854,7 +24808,7 @@ var createCommand2 = defineCommand89({
         ...chatIdFromEnv() ? { chatId: chatIdFromEnv() } : {}
       };
       const data = await writeAvatars("/api/avatars", body);
-      writeJson({ ok: true, data, hints: creationHints(data) });
+      writeJson({ ok: true, data, hints: creationHints(data, body.profile) });
     } catch (err) {
       failAvatarApi(err, handle);
     }
@@ -25560,12 +25514,12 @@ function missingFontFiles(urls, available) {
 function planFontAdoption(sources, families) {
   const wanted = new Map(families.map((family) => [normalizeFamily(family), family]));
   const byFamily = /* @__PURE__ */ new Map();
-  for (const { path: path38, source } of sources) {
-    const dir = posix.dirname(path38);
+  for (const { path: path39, source } of sources) {
+    const dir = posix.dirname(path39);
     for (const face of declaredFontFaces(source)) {
       if (!wanted.has(face.family)) continue;
       const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
-      perFile.set(path38, [...perFile.get(path38) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      perFile.set(path39, [...perFile.get(path39) ?? [], rebaseFontFaceSrc(face.block, dir)]);
       byFamily.set(face.family, perFile);
     }
   }
@@ -26287,7 +26241,7 @@ Subcommands:
 });
 
 // src/commands/canvas/index.ts
-import { defineCommand as defineCommand107 } from "citty";
+import { defineCommand as defineCommand108 } from "citty";
 
 // src/commands/canvas/catalog.ts
 import { defineCommand as defineCommand97 } from "citty";
@@ -29986,7 +29940,7 @@ function buildVideoTodo(report, overlayCount, floatingCount, opts, blueprint) {
       ]
     },
     transitions: "Scene-to-scene cuts the deconstruct flagged as fade/whip/zoom/dissolve/swipe are reproduced as an ffmpeg xfade at the boundary (everything else stays a hard cut). The overlap is consumed from extra generated footage, so the picture stays exactly on the audio timeline. To change a transition, edit the scene's `transition_out.type` in prompt.json and re-scaffold, or hand-edit the `spine` node's ffmpeg args. For a richer HERO cut (whip-pan, glitch, light-leak, gravitational-lens\u2026), the overlay layer can run a Hyperframes shader/CSS transition instead \u2014 see references/hyperframes/blueprints-and-transitions.md (pick 2\u20133 transition types total; the motion IS the handoff).",
-    overlay_capabilities: 'The overlay layer (video-overlay-composition/index.html) is a REAL Hyperframes composition, not a plain text layer \u2014 our hyperframe_render node runs the genuine `npx hyperframes` renderer. So it can do far more than fade/slide/pop: (1) PULL a ready-made block \u2014 `npx hyperframes catalog --type block` then `npx hyperframes add <id>` into the composition dir, and nest it with a <div data-composition-src="compositions/<id>.html" data-start data-track-index data-width data-height> clip (~97 blocks: lower-thirds, social-proof cards, stat counters, charts, code, logo stings); (2) animate with the named GSAP motion-rule vocabulary (kinetic-beat-slam, svg-path-draw, counting-dynamic-scale, multi-phase-camera\u2026); (3) frame a talking head as a video-call/PIP/split. The whole engine + how to build new effects is documented in references/hyperframes/ (start at README.md \u2192 catalog.md, motion-rules.md). Reach for this whenever the reference\'s graphics are richer than plain text.',
+    overlay_capabilities: 'The overlay layer (video-overlay-composition/index.html) is a REAL Hyperframes composition, not a plain text layer \u2014 our hyperframe_render node runs the genuine `npx hyperframes` renderer. So it can do far more than fade/slide/pop: (1) PULL a ready-made block \u2014 `npx hyperframes catalog --type block` then `npx hyperframes add <id>` into the composition dir, and nest it with a <div data-composition-src="compositions/<id>.html" data-start data-track-index data-width data-height> clip (~154 blocks: lower-thirds, social-proof cards, stat counters, charts, code, logo stings); (2) animate with the named GSAP motion-rule vocabulary (kinetic-beat-slam, svg-path-draw, counting-dynamic-scale, multi-phase-camera\u2026); (3) frame a talking head as a video-call/PIP/split. The whole engine + how to build new effects is documented in references/hyperframes/ (start at README.md \u2192 catalog.md, motion-rules.md). Reach for this whenever the reference\'s graphics are richer than plain text.',
     caption_system: "Sound-off feed = burned-in captions carry the message. The deconstruct produced a word-level transcript \u2014 drive a real caption track off it (karaoke highlight \u2192 themed \u2192 kinetic), not hand-typed text. Floor: `npx hyperframes add caption-highlight` (TikTok karaoke); escalate by content register (caption-kinetic-slam for hype, caption-editorial-emphasis for premium, caption-neon-glow for AI/crypto). Group on meaning, sync within 80ms. Full ladder + transcript contract: references/hyperframes/captions-and-audio.md.",
     talking_head_overlay: "For a scene where a presenter shows something (screen-share, app demo, product, a 'video call' look), frame the talking-head clip in the overlay composition: presenter full-bleed \u2192 shrinks to a rounded corner PIP pill while a content card takes the stage (or split/stack/overlay-glass-card). The pattern, the #video-wrap\u2192corner-pill tween, the glass call card, and the corner-coord presets are in references/hyperframes/talking-head-and-overlays.md. A ready exemplar ships as the `video-call-composition` move \u2014 copy it next to your canvas, drop brand fonts in the dir, point a `hyperframe_render` at it with the presenter clip as its `background`.",
     text_overlays: {
@@ -32189,11 +32143,241 @@ var scaffoldStaticAdCommand = defineCommand103({
   }
 });
 
+// src/commands/canvas/scaffold-ad.ts
+import { cp, mkdir as mkdir7, readFile as readFile14, writeFile as writeFile9 } from "fs/promises";
+import path22 from "path";
+import { defineCommand as defineCommand104 } from "citty";
+
+// src/engine/scaffold/ad-spec.ts
+import { z as z29 } from "zod";
+var oneClause = (line) => (line.match(/[.!?](\s|$)/g) ?? []).length <= 1;
+var Beat = z29.object({
+  /**
+   * The line the voice says in this beat — ONE clause, ending in its own
+   * punctuation. It becomes the caption card verbatim.
+   */
+  say: z29.string().min(1).refine(oneClause, "a beat is one clause: split a second sentence into its own beat"),
+  /** What is on screen while it is said, as a shot brief for the video model. */
+  show: z29.string().min(1),
+  /**
+   * Set only when this beat's subject is talking to camera. Off by default, and
+   * the default is load-bearing: a person visibly speaking under a voice that is
+   * not theirs reads as bad dubbing, which is what sank the first cut of this.
+   */
+  on_camera: z29.boolean().optional()
+});
+var AdSpec = z29.object({
+  format: z29.object({
+    aspect_ratio: z29.string().default("9:16"),
+    resolution: z29.string().default("720p")
+  }).default({ aspect_ratio: "9:16", resolution: "720p" }),
+  brand: z29.object({
+    name: z29.string().optional(),
+    /** Figures to lift typographically — the one gold number every ad has. */
+    highlight: z29.array(z29.string()).optional()
+  }).optional(),
+  voice: z29.object({
+    description: z29.string().min(1),
+    language: z29.string().optional()
+  }).optional(),
+  /**
+   * A bed, described in words. Omitted leaves the ad dry — the engine only wires
+   * music when asked, and silence is a legitimate choice.
+   *
+   * The bed never plays over the first beat: the opening line is the
+   * scroll-stopper and has to read clean. That is the engine's rule, not this
+   * one, and it is why the prompt is all this needs to carry.
+   */
+  music: z29.string().min(1).optional(),
+  beats: z29.array(Beat).min(2)
+});
+function narrativeRole(index, total) {
+  if (index === 0) return "hook";
+  if (index === total - 1) return "cta";
+  return index < total / 2 ? "problem" : "proof";
+}
+function estimateSeconds(line) {
+  const words2 = line.trim().split(/\s+/).length;
+  return Math.max(1.6, Math.round(words2 / 2.6 * 10) / 10);
+}
+function adSpecToBlueprint(spec) {
+  const total = spec.beats.length;
+  let clock = 0;
+  const scenes = spec.beats.map((beat, i) => {
+    const duration = estimateSeconds(beat.say);
+    const start = clock;
+    clock += duration;
+    return {
+      start_s: Math.round(start * 100) / 100,
+      end_s: Math.round(clock * 100) / 100,
+      duration_s: duration,
+      summary: beat.say,
+      narrative_role: narrativeRole(i, total),
+      // The read is built from per-scene dialogue, not from the global
+      // transcript: emitting only the transcript scaffolds a SILENT ad. And
+      // `on_camera` is the engine's own switch for "this line is narration" —
+      // absent, it guesses from who is in frame, which is how a still photograph
+      // once got lip-synced.
+      dialogue: [
+        {
+          line: beat.say,
+          start_s: Math.round(start * 100) / 100,
+          end_s: Math.round(clock * 100) / 100,
+          on_camera: beat.on_camera === true,
+          ...spec.voice?.description ? { voice_description: spec.voice.description } : {}
+        }
+      ],
+      motion_prompt: beat.on_camera ? beat.show : (
+        // The subject must not be forming words: the voice belongs to the
+        // narration, and a mouth moving under it reads as dubbing.
+        `${beat.show} Nobody in frame is speaking \u2014 mouths closed, no dialogue.`
+      ),
+      start_frame_prompt: beat.show
+    };
+  });
+  return {
+    global: {
+      transcript: spec.beats.map((b) => b.say).join(" "),
+      voiceover: {
+        // Narration over the picture. Never `on_camera`: that is what tells the
+        // engine a mouth is a lip-sync candidate.
+        mode: "voiceover",
+        ...spec.voice?.description ? { voice_description: spec.voice.description } : {}
+      },
+      ...spec.brand?.name ? { brand: { name: spec.brand.name } } : {},
+      ...spec.music ? { music: { music_prompt: spec.music } } : {}
+    },
+    scenes
+  };
+}
+
+// src/commands/canvas/composition-path.ts
+import { existsSync as existsSync4 } from "fs";
+import path21 from "path";
+function resolveShippedCanvasDir(name, startDir, exists = existsSync4, maxDepth = 8) {
+  const rel = path21.join("canvas", name);
+  let dir = startDir;
+  for (let i = 0; i < maxDepth; i++) {
+    const candidate = path21.join(dir, rel);
+    if (exists(path21.join(candidate, "meta.json"))) return candidate;
+    const parent = path21.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return path21.resolve(startDir, "../../../", rel);
+}
+
+// src/commands/canvas/scaffold-ad.ts
+var SHIPPED_COMPOSITION_DIR = resolveShippedCanvasDir("video-overlay-composition", import.meta.dirname);
+var SHIPPED_CAPTIONS_DIR = resolveShippedCanvasDir("tiktok-captions-composition", import.meta.dirname);
+registerSchema({
+  command: "canvas.scaffold-ad",
+  description: "Build a captioned vertical ad from a WRITTEN SPEC \u2014 no reference video. Start here when someone asks for an ad, a promo or a UGC-style clip and there is nothing to copy: `scaffold-video` reproduces a video you already have, this one writes a new one. You supply a spec of BEATS, and a beat is one line the voice says plus one shot the viewer sees while it is said. Everything else \u2014 the read, the caption cards, the clips, the music, the render \u2014 is derived from that pair, so the ad cannot drift out of sync with itself.",
+  args: {
+    spec: {
+      type: "string",
+      required: true,
+      description: "Path to the ad spec JSON. Shape: { format?, brand?, voice?, beats: [{ say, show, on_camera? }] }. `say` is ONE clause ending in its own punctuation \u2014 it becomes a caption card verbatim, so two sentences in one beat produce a card holding both. `show` is the shot brief for that line. Set `on_camera` ONLY when that beat's subject talks to camera."
+    },
+    slug: {
+      type: "string",
+      required: false,
+      description: "Creative slug \u2014 writes to src/creatives/<slug>/<slug>.canvas.json"
+    },
+    out: {
+      type: "string",
+      required: false,
+      description: "Output canvas path (default <spec-dir>/<name>.canvas.json)"
+    }
+  }
+});
+var scaffoldAdCommand = defineCommand104({
+  meta: {
+    name: "scaffold-ad",
+    description: 'Build a captioned vertical ad from a written spec, with no reference video to copy.\n\nA spec is a list of BEATS. One beat = one line the voice says + one shot on screen while it is said. That pairing is what keeps the ad honest: the caption card IS the line, so it can never end mid-sentence, and the picture can never drift from the read.\n\nTwo rules the spec enforces for you, both learned the expensive way:\n  \u2022 `say` is ONE clause with its own punctuation. Two sentences in a beat is rejected.\n  \u2022 Nobody in shot is speaking unless you set `on_camera` on that beat. A person visibly talking under a voice that is not theirs reads as bad dubbing.\n\nExample spec:\n  { "beats": [\n      { "say": "Mientras t\xFA sigues pagando la luz a precio de oro,", "show": "Aerial over Spanish rooftops at golden hour." },\n      { "say": "Haz clic en el enlace y reserva tu estudio gratuito.", "show": "A couple walking home at sunset." } ] }\n\nThen: baker canvas run <the canvas it writes>'
+  },
+  args: {
+    spec: { type: "string", required: true, description: "Path to the ad spec JSON" },
+    slug: {
+      type: "string",
+      required: false,
+      description: "Creative slug \u2014 writes to src/creatives/<slug>/<slug>.canvas.json"
+    },
+    out: { type: "string", required: false, description: "Output canvas path" }
+  },
+  async run({ args }) {
+    const specPath = args.spec;
+    let parsed;
+    try {
+      parsed = JSON.parse(await readFile14(specPath, "utf-8"));
+    } catch (e) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `Could not read the ad spec at ${specPath}: ${e instanceof Error ? e.message : String(e)}`,
+          fix: "Write the spec first \u2014 a JSON file with a `beats` array, each beat holding `say` (one clause) and `show` (the shot)."
+        }
+      });
+      process.exit(1);
+      return;
+    }
+    const spec = AdSpec.safeParse(parsed);
+    if (!spec.success) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `That ad spec is not usable: ${spec.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`,
+          fix: "A beat is ONE line and ONE shot. If a beat holds two sentences, split it into two beats \u2014 the line becomes a caption card verbatim, and a card holding two sentences is the defect this refuses."
+        }
+      });
+      process.exit(1);
+      return;
+    }
+    const blueprint = adSpecToBlueprint(spec.data);
+    const slug = args.slug ?? path22.basename(specPath).replace(/\.[^.]+$/, "");
+    const outPath = args.out ?? (args.slug ? path22.join("src/creatives", slug, `${slug}.canvas.json`) : path22.join(path22.dirname(specPath), `${slug}.canvas.json`));
+    const outDir = path22.dirname(outPath);
+    await mkdir7(outDir, { recursive: true });
+    const compositionDest = path22.join(outDir, "video-overlay-composition");
+    const captionsDest = path22.join(outDir, "tiktok-captions-composition");
+    await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
+    await cp(SHIPPED_CAPTIONS_DIR, captionsDest, { recursive: true });
+    const blueprintPath = path22.join(outDir, "prompt.json");
+    const blueprintStylePath = path22.join(outDir, "prompt.style.json");
+    await writeSceneFiles(outDir, blueprint);
+    await writeFile9(blueprintStylePath, renderStyleProjectionFromValue(blueprint), "utf8");
+    const opts = {
+      imageModel: DEFAULT_IMAGE_GENERATE_MODEL,
+      videoModel: DEFAULT_VIDEO_GENERATE_MODEL,
+      overlayCompositionPath: path22.relative(outDir, compositionDest),
+      captionsCompositionPath: path22.relative(outDir, captionsDest),
+      blueprintPath: path22.relative(outDir, blueprintPath),
+      blueprintStylePath: path22.relative(outDir, blueprintStylePath),
+      aspect: spec.data.format.aspect_ratio,
+      resolution: spec.data.format.resolution
+    };
+    const canvas = scaffoldVideoCanvas(blueprint, [], opts);
+    await writeFile9(outPath, `${JSON.stringify(canvas, null, 2)}
+`, "utf-8");
+    writeJson({
+      ok: true,
+      data: { canvas: outPath, beats: spec.data.beats.length, slug },
+      hints: [
+        `Wrote ${spec.data.beats.length} beats to ${outPath}. Run it with \`baker canvas run ${outPath}\`.`,
+        "The caption cards are your `say` lines verbatim \u2014 read them back before running; that is the copy the viewer sees.",
+        "Every clip renders with nobody speaking unless a beat set `on_camera`. If a beat needs a presenter talking, set it there rather than describing it in `show`."
+      ]
+    });
+  }
+});
+
 // src/commands/canvas/scaffold-video.ts
-import { access as access2, cp, mkdir as mkdir7, readFile as readFile16, rm as rm6, writeFile as writeFile9 } from "fs/promises";
+import { access as access2, cp as cp2, mkdir as mkdir8, readFile as readFile17, rm as rm6, writeFile as writeFile10 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import path23 from "path";
-import { defineCommand as defineCommand104 } from "citty";
+import path24 from "path";
+import { defineCommand as defineCommand105 } from "citty";
 
 // src/engine/scaffold/lib/model-router.ts
 var SEEDANCE = "bytedance/seedance-2.0";
@@ -32232,7 +32416,7 @@ function routeVideoModel(input) {
 
 // src/engine/nodes/local/lib/sceneDetect.ts
 import { execFile as execFile2 } from "child_process";
-import { mkdtemp, readdir as readdir7, readFile as readFile14, rm as rm5 } from "fs/promises";
+import { mkdtemp, readdir as readdir7, readFile as readFile15, rm as rm5 } from "fs/promises";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
 import { promisify as promisify2 } from "util";
@@ -32308,7 +32492,7 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
     );
     const csvName = (await readdir7(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
     if (!csvName) return [];
-    return parsePySceneDetectCsvCuts(await readFile14(join2(outDir, csvName), "utf-8"));
+    return parsePySceneDetectCsvCuts(await readFile15(join2(outDir, csvName), "utf-8"));
   } finally {
     await rm5(outDir, { recursive: true, force: true });
   }
@@ -32331,25 +32515,9 @@ async function detectSceneCutsPySceneDetect(filePath, opts = {}) {
   return cuts;
 }
 
-// src/commands/canvas/composition-path.ts
-import { existsSync as existsSync4 } from "fs";
-import path21 from "path";
-function resolveShippedCanvasDir(name, startDir, exists = existsSync4, maxDepth = 8) {
-  const rel = path21.join("canvas", name);
-  let dir = startDir;
-  for (let i = 0; i < maxDepth; i++) {
-    const candidate = path21.join(dir, rel);
-    if (exists(path21.join(candidate, "meta.json"))) return candidate;
-    const parent = path21.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return path21.resolve(startDir, "../../../", rel);
-}
-
 // src/commands/canvas/gitignore.ts
-import { appendFile, readFile as readFile15 } from "fs/promises";
-import path22 from "path";
+import { appendFile, readFile as readFile16 } from "fs/promises";
+import path23 from "path";
 function missingGitignoreEntries(existing, entries) {
   const present2 = new Set(
     existing.split("\n").map((l) => l.trim().replace(/\/+$/, "")).filter((l) => l.length > 0 && !l.startsWith("#"))
@@ -32357,10 +32525,10 @@ function missingGitignoreEntries(existing, entries) {
   return entries.filter((e) => !present2.has(e.trim().replace(/\/+$/, "")));
 }
 async function ensureGitignore(dir, entries) {
-  const file = path22.join(dir, ".gitignore");
+  const file = path23.join(dir, ".gitignore");
   let existing;
   try {
-    existing = await readFile15(file, "utf8");
+    existing = await readFile16(file, "utf8");
   } catch {
     return;
   }
@@ -32374,8 +32542,8 @@ ${missing.join("\n")}
 }
 
 // src/commands/canvas/scaffold-video.ts
-var SHIPPED_COMPOSITION_DIR = resolveShippedCanvasDir("video-overlay-composition", import.meta.dirname);
-var SHIPPED_CAPTIONS_DIR = resolveShippedCanvasDir("tiktok-captions-composition", import.meta.dirname);
+var SHIPPED_COMPOSITION_DIR2 = resolveShippedCanvasDir("video-overlay-composition", import.meta.dirname);
+var SHIPPED_CAPTIONS_DIR2 = resolveShippedCanvasDir("tiktok-captions-composition", import.meta.dirname);
 function resolveModel2(kind, preferred) {
   const ids = Object.keys(MODEL_REGISTRY[kind]);
   return ids.includes(preferred) ? preferred : ids[0] ?? preferred;
@@ -32399,7 +32567,7 @@ ONE PERSON, MULTIPLE LOOKS: if a single individual plays MULTIPLE personas or wa
 For each kept element return: { "type": one of person|animal|product|logo|badge|location, "label": a short UPPER_SNAKE_CASE name (e.g. HERO, CREATOR_SKEPTIC, INSURANCE_CARD, LOGO), "description": a concrete reusable description to source/shoot the real asset \u2014 for a person/animal give a NEUTRAL castable role (e.g. "hero pet-owner, woman in her 30s" or "a small beagle"), NOT the original individual's literal face/identity: we RECAST with a FRESH person/animal, so never tell the agent to reuse the original. "expression": a living subject's typical expression or null, "cast_id": the global.cast id if it maps to one else null, "same_as": the label of another element this is the SAME individual as (different wardrobe/persona) else null, "scenes": the 0-based indices of ONLY the scenes where the element is ACTUALLY VISIBLE ON SCREEN \u2014 judged from that scene's start_frame_prompt / end_frame_prompt subjects and its action_detail, NOT from who is merely speaking. A narrator heard over b-roll is NOT present in that b-roll scene; a dog-running cutaway does NOT contain the couch creator just because she talks across it. Do NOT pad the list \u2014 an element wrongly listed in a scene makes the reproduction render the wrong subject there (e.g. the creator appearing in a pure-dog b-roll). When in doubt, leave a scene OUT. Output ONLY the JSON object.`;
 async function loadAssetText2(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile16(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile17(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -32418,8 +32586,8 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text2 = transcript?.trim();
   if (!text2 || text2 === "[]") return {};
-  const compositionPath = path23.join(outDir, "tiktok-captions-composition");
-  await cp(SHIPPED_CAPTIONS_DIR, compositionPath, { recursive: true });
+  const compositionPath = path24.join(outDir, "tiktok-captions-composition");
+  await cp2(SHIPPED_CAPTIONS_DIR2, compositionPath, { recursive: true });
   return { compositionPath };
 }
 function patchCompositionMeta(metaJson, dims) {
@@ -32436,12 +32604,12 @@ function patchCompositionHtml(html, dims) {
   return html.replace(/(<meta\s+name="viewport"\s+content="width=)\d+(,\s*height=)\d+(")/i, `$1${dims.w}$2${dims.h}$3`).replace(/(width:\s*)\d+(px;\s*height:\s*)\d+(px;)/i, `$1${dims.w}$2${dims.h}$3`).replace(/(data-width=")\d+(")/i, `$1${dims.w}$2`).replace(/(data-height=")\d+(")/i, `$1${dims.h}$2`);
 }
 async function stampCompositionDims(compositionDir, dims) {
-  const metaPath = path23.join(compositionDir, "meta.json");
-  const rawMeta = await readFile16(metaPath, "utf8");
-  await writeFile9(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
-  const htmlPath = path23.join(compositionDir, "index.html");
-  const rawHtml = await readFile16(htmlPath, "utf8");
-  await writeFile9(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
+  const metaPath = path24.join(compositionDir, "meta.json");
+  const rawMeta = await readFile17(metaPath, "utf8");
+  await writeFile10(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
+  const htmlPath = path24.join(compositionDir, "index.html");
+  const rawHtml = await readFile17(htmlPath, "utf8");
+  await writeFile10(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
 }
 function parseElements2(raw) {
   const parsed = JSON.parse(raw);
@@ -32488,7 +32656,7 @@ var VIDEO_EXT_BY_MIME = {
   "video/x-matroska": ".mkv"
 };
 function referenceVideoExt(url, contentType) {
-  const fromPath = path23.extname(new URL(url).pathname).toLowerCase();
+  const fromPath = path24.extname(new URL(url).pathname).toLowerCase();
   if (fromPath && fromPath.length <= 5) return fromPath;
   const mime = (contentType ?? "").split(";")[0]?.trim().toLowerCase();
   return mime && VIDEO_EXT_BY_MIME[mime] || ".mp4";
@@ -32514,7 +32682,7 @@ function videoDefinitionDescription(blueprint) {
   return typeof product === "string" && product.trim() ? product.trim() : void 0;
 }
 async function materializeReferenceVideo(fileArg2) {
-  if (!/^https?:\/\//i.test(fileArg2)) return path23.resolve(fileArg2);
+  if (!/^https?:\/\//i.test(fileArg2)) return path24.resolve(fileArg2);
   let bytes;
   let contentType;
   try {
@@ -32526,11 +32694,11 @@ async function materializeReferenceVideo(fileArg2) {
     throw new Error(`failed to download reference video: ${e instanceof Error ? e.message : String(e)}`);
   }
   if (bytes.length === 0) throw new Error("reference video download was empty");
-  const dest = path23.join(
+  const dest = path24.join(
     tmpdir2(),
     `baker-ref-${sha256Hex(bytes).slice(0, 16)}${referenceVideoExt(fileArg2, contentType)}`
   );
-  await writeFile9(dest, bytes);
+  await writeFile10(dest, bytes);
   return dest;
 }
 function resolveSeamDedup(raw) {
@@ -32654,7 +32822,7 @@ async function runAnalysisPasses(deconstructCanvas, selectModel) {
     return fail4("deconstruct", e instanceof Error ? e.message : String(e));
   }
 }
-var scaffoldVideoCommand = defineCommand104({
+var scaffoldVideoCommand = defineCommand105({
   meta: {
     name: "scaffold-video",
     description: "Turn a reference video into a runnable reproduction canvas in one command. Runs billed passes \u2014 video_deconstruct (the full scene-by-scene blueprint + transcript, baked to a split, editable blueprint: a global prompt.json plus one small scenes/sNN.json per scene) and an AI selection of the video's RECURRING identity elements (person/animal/product/logo) \u2014 then scaffolds a pipeline where every scene boundary is a static-ad-grade frame (the blueprint as target_blueprint, a reference legend, the real frame as anchor) and each recurring element gets ONE shared [TODO] ingest slot wired into every frame it appears in. The clips feed Seedance an ultra-detailed motion brief (action, camera, dialogue, transcript). Edit a scene's scenes/sNN.json (or prompt.json for global cast/palette/brand), drop the real source images, then `baker canvas run`."
@@ -32746,11 +32914,11 @@ var scaffoldVideoCommand = defineCommand104({
     } catch (e) {
       return fail4("download", e instanceof Error ? e.message : String(e));
     }
-    const base = path23.basename(videoPath, path23.extname(videoPath));
-    const outPath = args.out ? path23.resolve(String(args.out)) : slug ? path23.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path23.join(path23.dirname(videoPath), `${base}.video.canvas.json`);
-    const outDir = path23.dirname(outPath);
-    const blueprintPath = path23.join(outDir, "prompt.json");
-    const blueprintStylePath = path23.join(outDir, "prompt.style.json");
+    const base = path24.basename(videoPath, path24.extname(videoPath));
+    const outPath = args.out ? path24.resolve(String(args.out)) : slug ? path24.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path24.join(path24.dirname(videoPath), `${base}.video.canvas.json`);
+    const outDir = path24.dirname(outPath);
+    const blueprintPath = path24.join(outDir, "prompt.json");
+    const blueprintStylePath = path24.join(outDir, "prompt.style.json");
     const frames = args.frames === "reuse" ? "reuse" : "generate";
     const maxScenes = args["max-scenes"] ? Number(args["max-scenes"]) : void 0;
     if (Number.isFinite(maxScenes)) {
@@ -32774,10 +32942,10 @@ var scaffoldVideoCommand = defineCommand104({
       process.stderr.write(`\u{1F3AC} Photoreal on-camera cast detected \u2192 generating clips on ${videoModel} (dodges Seedance's real-person filter).
 `);
     }
-    await mkdir7(outDir, { recursive: true });
+    await mkdir8(outDir, { recursive: true });
     const annotated = annotateBlueprintWithElements(blueprint, elements);
     await writeSceneFiles(outDir, annotated);
-    await writeFile9(blueprintStylePath, renderStyleProjectionFromValue(annotated), "utf8");
+    await writeFile10(blueprintStylePath, renderStyleProjectionFromValue(annotated), "utf8");
     let aspect;
     try {
       aspect = resolveAspect(
@@ -32795,12 +32963,12 @@ var scaffoldVideoCommand = defineCommand104({
 `
       );
     }
-    const compositionDest = path23.join(outDir, "video-overlay-composition");
-    await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
+    const compositionDest = path24.join(outDir, "video-overlay-composition");
+    await cp2(SHIPPED_COMPOSITION_DIR2, compositionDest, { recursive: true });
     await stampCompositionDims(compositionDest, outDims);
-    const indexPath = path23.join(compositionDest, "index.html");
+    const indexPath = path24.join(compositionDest, "index.html");
     const overlayHtml = buildOverlayHtml(blueprint, { captionsActive: Boolean(transcript) });
-    const indexHtml = await readFile16(indexPath, "utf8");
+    const indexHtml = await readFile17(indexPath, "utf8");
     const injected = indexHtml.replace("<!--OVERLAYS-->", () => overlayHtml);
     if (injected === indexHtml && overlayHtml.trim()) {
       fail4(
@@ -32808,16 +32976,16 @@ var scaffoldVideoCommand = defineCommand104({
         `video-overlay-composition/index.html is missing the <!--OVERLAYS--> marker \u2014 cannot inject the overlay layer`
       );
     }
-    await writeFile9(indexPath, injected, "utf8");
+    await writeFile10(indexPath, injected, "utf8");
     const captions = await stageCaptions(outDir, transcript);
     if (captions.compositionPath) await stampCompositionDims(captions.compositionPath, outDims);
     const opts = {
       imageModel,
       videoModel,
-      overlayCompositionPath: path23.relative(outDir, compositionDest),
-      captionsCompositionPath: captions.compositionPath ? path23.relative(outDir, captions.compositionPath) : void 0,
-      blueprintPath: path23.relative(outDir, blueprintPath),
-      blueprintStylePath: path23.relative(outDir, blueprintStylePath),
+      overlayCompositionPath: path24.relative(outDir, compositionDest),
+      captionsCompositionPath: captions.compositionPath ? path24.relative(outDir, captions.compositionPath) : void 0,
+      blueprintPath: path24.relative(outDir, blueprintPath),
+      blueprintStylePath: path24.relative(outDir, blueprintStylePath),
       frames,
       ambient: Boolean(args.ambient),
       seamDedup: resolveSeamDedup(args["seam-dedup"]),
@@ -32842,10 +33010,10 @@ var scaffoldVideoCommand = defineCommand104({
       todo.blocking_validation_issues = validation.issues;
       meta.todo = todo;
     }
-    await writeFile9(outPath, `${JSON.stringify(canvas, null, 2)}
+    await writeFile10(outPath, `${JSON.stringify(canvas, null, 2)}
 `, "utf8");
-    await writeFile9(
-      path23.join(outDir, REBUILD_FILE),
+    await writeFile10(
+      path24.join(outDir, REBUILD_FILE),
       `${JSON.stringify({ elements, opts }, null, 2)}
 `,
       "utf8"
@@ -32870,9 +33038,9 @@ var scaffoldVideoCommand = defineCommand104({
     await ensureGitignore(process.cwd(), ["canvas/", ".context/"]);
     const sourceRef = videoSourceReference(blueprint, fileArg2);
     if (slug) {
-      const definitionPath = path23.join(outDir, "_definition.md");
+      const definitionPath = path24.join(outDir, "_definition.md");
       if (!await fileExists2(definitionPath)) {
-        await writeFile9(
+        await writeFile10(
           definitionPath,
           buildCreativeDefinition({
             title: titleFromSlug(slug),
@@ -32925,7 +33093,7 @@ var scaffoldVideoCommand = defineCommand104({
             graph: canvas.metadata?.video?.graph_stats
           },
           checklist: {
-            edit_prompt: `The blueprint is split so you edit ONE small file at a time \u2014 never a giant one. Per-scene content (a scene's dialogue, action, frame prompts, overlays) lives in \`scenes/sNN.json\` \u2014 edit the single scene you want to change. Global cast/palette/brand/copy lives in \`${path23.basename(blueprintPath)}\`. \`baker canvas validate\`/\`run\` re-assemble the blueprint and re-flow every edited scene back into the render (and regenerate ${path23.basename(blueprintStylePath)}, the projection each frame's target_blueprint reads) \u2014 so your scene edits reach the render automatically. Never hand-edit the inlined node prompts in the canvas or the derived ${path23.basename(blueprintStylePath)}; both are regenerated.`,
+            edit_prompt: `The blueprint is split so you edit ONE small file at a time \u2014 never a giant one. Per-scene content (a scene's dialogue, action, frame prompts, overlays) lives in \`scenes/sNN.json\` \u2014 edit the single scene you want to change. Global cast/palette/brand/copy lives in \`${path24.basename(blueprintPath)}\`. \`baker canvas validate\`/\`run\` re-assemble the blueprint and re-flow every edited scene back into the render (and regenerate ${path24.basename(blueprintStylePath)}, the projection each frame's target_blueprint reads) \u2014 so your scene edits reach the render automatically. Never hand-edit the inlined node prompts in the canvas or the derived ${path24.basename(blueprintStylePath)}; both are regenerated.`,
             recurring_elements_to_supply: report.elements,
             voices_to_confirm: report.dialogue.map((d) => ({
               scene: d.scene,
@@ -32962,9 +33130,9 @@ var scaffoldVideoCommand = defineCommand104({
 });
 
 // src/commands/canvas/set-prompt.ts
-import { readFile as readFile17, writeFile as writeFile10 } from "fs/promises";
-import path24 from "path";
-import { defineCommand as defineCommand105 } from "citty";
+import { readFile as readFile18, writeFile as writeFile11 } from "fs/promises";
+import path25 from "path";
+import { defineCommand as defineCommand106 } from "citty";
 function setNodePrompt(canvas, nodeId, text2) {
   const nodes = canvas?.nodes;
   if (!Array.isArray(nodes)) throw new Error("canvas has no nodes array");
@@ -32979,7 +33147,7 @@ function setNodePrompt(canvas, nodeId, text2) {
   newNodes[idx] = newNode;
   return { ...canvas, nodes: newNodes };
 }
-var setPromptCommand = defineCommand105({
+var setPromptCommand = defineCommand106({
   meta: {
     name: "set-prompt",
     description: "Safely set a node's params.prompt (a frame description, motion prompt, etc.) without hand-editing the JSON. Prefer --text-file for multi-line/accented copy \u2014 it preserves UTF-8 exactly, unlike shell-quoted jq."
@@ -32991,17 +33159,17 @@ var setPromptCommand = defineCommand105({
     "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
   },
   async run({ args }) {
-    const filePath = path24.resolve(String(args.file));
+    const filePath = path25.resolve(String(args.file));
     let canvas;
     try {
-      canvas = JSON.parse(await readFile17(filePath, "utf8"));
+      canvas = JSON.parse(await readFile18(filePath, "utf8"));
     } catch (e) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "parse", message: String(e) } }, null, 2)}
 `);
       process.exit(2);
     }
     let text2;
-    if (args["text-file"]) text2 = await readFile17(path24.resolve(String(args["text-file"])), "utf8");
+    if (args["text-file"]) text2 = await readFile18(path25.resolve(String(args["text-file"])), "utf8");
     else if (args.text !== void 0) text2 = String(args.text);
     else {
       process.stderr.write(
@@ -33022,14 +33190,14 @@ var setPromptCommand = defineCommand105({
       process.exit(2);
       return;
     }
-    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path24.dirname(filePath)), defaultRegistry());
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path25.dirname(filePath)), defaultRegistry());
     if (!validation.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.issues } }, null, 2)}
 `);
       process.exit(2);
       return;
     }
-    await writeFile10(filePath, `${JSON.stringify(updated, null, 2)}
+    await writeFile11(filePath, `${JSON.stringify(updated, null, 2)}
 `, "utf8");
     process.stdout.write(`${JSON.stringify({ ok: true, node: String(args.node), bytes: text2.length }, null, 2)}
 `);
@@ -33037,18 +33205,18 @@ var setPromptCommand = defineCommand105({
 });
 
 // src/commands/canvas/validate.ts
-import { readFile as readFile18 } from "fs/promises";
-import path25 from "path";
-import { defineCommand as defineCommand106 } from "citty";
-var validateCommand = defineCommand106({
+import { readFile as readFile19 } from "fs/promises";
+import path26 from "path";
+import { defineCommand as defineCommand107 } from "citty";
+var validateCommand = defineCommand107({
   meta: {
     name: "validate",
     description: "Validate a canvas JSON file (no execution). Includes a per-node cost preview and runs each node's deep validators (composition meta checks for hyperframe_render/_snapshot)."
   },
   args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
   async run({ args }) {
-    const filePath = path25.resolve(String(args.file));
-    const raw = await readFile18(filePath, "utf8");
+    const filePath = path26.resolve(String(args.file));
+    const raw = await readFile19(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -33060,7 +33228,7 @@ var validateCommand = defineCommand106({
     }
     const healed = await healAbsoluteCanvasPaths(filePath, parsed);
     parsed = healed.canvas;
-    parsed = resolveRelativeCanvasPaths(parsed, path25.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path26.dirname(filePath));
     let styleProjection = "not_applicable";
     try {
       styleProjection = await syncStyleProjection(parsed, (line) => process.stderr.write(`${line}
@@ -33113,7 +33281,7 @@ var validateCommand = defineCommand106({
 });
 
 // src/commands/canvas/index.ts
-var canvasCommand = defineCommand107({
+var canvasCommand = defineCommand108({
   meta: {
     name: "canvas",
     description: `Run Baker creative canvas JSON files locally. Local nodes execute in-process; remote nodes POST to the Convex backend gateway.
@@ -33128,7 +33296,8 @@ Subcommands:
   baker canvas sync-definition <path> \u2014 push a creative's current node-graph + input thumbnails to the dashboard without rendering (runs automatically on canvas/prompt edits)
   baker canvas catalog                \u2014 print the agent-facing node + composition catalog (JSON Schema)
   baker canvas inspect <run_id>       \u2014 one-page summary of a completed run
-  baker canvas scaffold-video <video>                \u2014 turn a reference video into a runnable reproduction canvas (deconstruct + recurring-element detection)
+  baker canvas scaffold-ad --spec <spec.json>        \u2014 DEFAULT for a new ad: write beats (one spoken line + one shot each), get the whole runnable canvas
+  baker canvas scaffold-video <video>                \u2014 reproduce a video the USER gave you (an ad you found is inspiration, not a copy target)
   baker canvas scaffold-static-ad <image>            \u2014 turn a source image into a runnable static-ad canvas (describe + element detection)
 Full guide: __tooling__/docs/tools/baker/canvas.md`
   },
@@ -33139,6 +33308,7 @@ Full guide: __tooling__/docs/tools/baker/canvas.md`
     critique: critiqueCommand,
     catalog: catalogCommand,
     inspect: inspectCommand,
+    "scaffold-ad": scaffoldAdCommand,
     "scaffold-video": scaffoldVideoCommand,
     "scaffold-static-ad": scaffoldStaticAdCommand,
     "set-prompt": setPromptCommand,
@@ -33147,7 +33317,7 @@ Full guide: __tooling__/docs/tools/baker/canvas.md`
 });
 
 // src/commands/capabilities/index.ts
-import { defineCommand as defineCommand108 } from "citty";
+import { defineCommand as defineCommand109 } from "citty";
 registerSchema({
   command: "capabilities",
   description: "Start here, before promising the user anything on an ad platform, in Analytics, or in Tag Manager. Answers three questions in one call: what is connected and with what access, what a write on each surface actually does when it lands, and what CANNOT be done here and why. Run it with no arguments for every surface; name one surface to also get the exact fields every change on it accepts.",
@@ -33190,7 +33360,7 @@ function capabilityHints(surfaces) {
   }
   return hints;
 }
-var runCapabilities = defineCommand108({
+var runCapabilities = defineCommand109({
   meta: {
     name: "capabilities",
     description: `What Baker can and cannot do for this company, before any work starts.
@@ -33246,7 +33416,7 @@ Full guide: __tooling__/docs/tools/baker/capabilities.md`
 var capabilitiesCommand = runCapabilities;
 
 // src/commands/chats/index.ts
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand110 } from "citty";
 var STATUS_GROUPS = ["active", "archived", "all"];
 var REPO_SURFACES = ["knowledge", "company", "brand", "landings", "flows", "creatives"];
 function parseBoundedInt(raw, name, min, max) {
@@ -33268,7 +33438,7 @@ registerSchema({
     full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
   }
 });
-var listCommand11 = defineCommand109({
+var listCommand11 = defineCommand110({
   meta: { name: "list", description: "List other Sessions on this account, newest first." },
   args: {
     status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
@@ -33323,7 +33493,7 @@ registerSchema({
     }
   }
 });
-var viewCommand = defineCommand109({
+var viewCommand = defineCommand110({
   meta: {
     name: "view",
     description: "Inspect one Session's full effects \u2014 git content + actions/tags/ads, kickoff, commits."
@@ -33367,7 +33537,7 @@ registerSchema({
     }
   }
 });
-var transcriptCommand = defineCommand109({
+var transcriptCommand = defineCommand110({
   meta: { name: "transcript", description: "Read another Session's conversation." },
   args: {
     id: { type: "positional", description: "The Session id", required: true },
@@ -33419,7 +33589,7 @@ registerSchema({
     }
   }
 });
-var diffCommand = defineCommand109({
+var diffCommand = defineCommand110({
   meta: { name: "diff", description: "See a published Session's real file-level changes." },
   args: {
     id: { type: "positional", description: "The Session id", required: true },
@@ -33463,7 +33633,7 @@ var diffCommand = defineCommand109({
     }
   }
 });
-var chatsCommand = defineCommand109({
+var chatsCommand = defineCommand110({
   meta: {
     name: "chats",
     description: `Inspect other Sessions on this account (read-only): list them, view what they produced, read their conversation, and see their real file changes \u2014 so you can reuse past work for a new goal.
@@ -33478,13 +33648,13 @@ Full guide: __tooling__/docs/tools/baker/chats.md`
 });
 
 // src/commands/creatives/index.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 
 // src/commands/creatives/publish.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand111 } from "citty";
 
 // src/commands/images/api.ts
-import { readFile as readFile19 } from "fs/promises";
+import { readFile as readFile20 } from "fs/promises";
 import { basename, extname } from "path";
 var imageProcessingTimeoutMs = 18e4;
 var imageReadyPollIntervalMs = 2e3;
@@ -33498,7 +33668,7 @@ var mimeMap = {
   ".avif": "image/avif"
 };
 var defaultImageApiDeps = {
-  readFile: readFile19,
+  readFile: readFile20,
   post: apiPost,
   get: apiGet,
   sleep: (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))
@@ -33628,7 +33798,7 @@ async function publishCreative(args, deps = defaultImageApiDeps) {
     chatId: chatIdFromEnv2()
   });
 }
-var publishCommand = defineCommand110({
+var publishCommand = defineCommand111({
   meta: {
     name: "publish",
     description: "Publish a final static creative image to Baker Creatives and print the creative reference JSON."
@@ -33686,7 +33856,7 @@ var publishCommand = defineCommand110({
 });
 
 // src/commands/creatives/index.ts
-var creativesCommand3 = defineCommand111({
+var creativesCommand3 = defineCommand112({
   meta: {
     name: "creatives",
     description: `Publish static ad creatives as first-class Baker outputs.
@@ -33703,11 +33873,11 @@ Full guide: __tooling__/docs/tools/baker/creatives.md`
 });
 
 // src/commands/flows/index.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand117 } from "citty";
 
 // src/commands/flows/add.ts
 import { randomUUID } from "crypto";
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand113 } from "citty";
 
 // src/commands/flows/shared.ts
 import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync9, writeFileSync as writeFileSync3 } from "fs";
@@ -33760,12 +33930,12 @@ function collectSideEffects(tree) {
   );
 }
 function readFlowTree(slug) {
-  const path38 = join3(flowsDir(), slug, "_data.json");
-  if (!existsSync5(path38)) {
+  const path39 = join3(flowsDir(), slug, "_data.json");
+  if (!existsSync5(path39)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync9(path38, "utf-8"));
+    return JSON.parse(readFileSync9(path39, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -33917,7 +34087,7 @@ registerSchema({
     parent: { type: "string", description: "Parent node id. Omit to append to the root's children.", required: false }
   }
 });
-var addNodeCommand = defineCommand112({
+var addNodeCommand = defineCommand113({
   meta: {
     name: "add-node",
     description: 'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name "Contact Info"'
@@ -34013,7 +34183,7 @@ registerSchema({
     }
   }
 });
-var addSideEffectCommand = defineCommand112({
+var addSideEffectCommand = defineCommand113({
   meta: {
     name: "add-side-effect",
     description: "Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet"
@@ -34095,7 +34265,7 @@ var addSideEffectCommand = defineCommand112({
 
 // src/commands/flows/map.ts
 import { readFileSync as readFileSync11 } from "fs";
-import { defineCommand as defineCommand113 } from "citty";
+import { defineCommand as defineCommand114 } from "citty";
 
 // src/commands/flows/value-expression.ts
 import { existsSync as existsSync6, readFileSync as readFileSync10 } from "fs";
@@ -34157,10 +34327,10 @@ function parseValueExpression(raw) {
   return parts.map(parsePart);
 }
 function trackingFieldIds() {
-  const path38 = join4(flowsDir(), "..", "tracking.ts");
-  if (!existsSync6(path38)) return null;
+  const path39 = join4(flowsDir(), "..", "tracking.ts");
+  if (!existsSync6(path39)) return null;
   try {
-    const source = readFileSync10(path38, "utf-8");
+    const source = readFileSync10(path39, "utf-8");
     const block2 = source.match(/TRACKING_FIELD_IDS\s*=\s*\[([\s\S]*?)\]\s*as const/)?.[1];
     if (!block2) return null;
     const ids = [...block2.matchAll(/"(tracking\.[a-z0-9_]+)"/g)].map((match) => match[1]);
@@ -34712,13 +34882,13 @@ function specsFromFile(parsed) {
     return `${destField}${type}=${entry?.value ?? ""}`;
   });
 }
-function readSpecFile(path38) {
+function readSpecFile(path39) {
   let raw;
   try {
-    raw = path38 === "-" ? readFileSync11(0, "utf-8") : readFileSync11(path38, "utf-8");
+    raw = path39 === "-" ? readFileSync11(0, "utf-8") : readFileSync11(path39, "utf-8");
   } catch (error) {
     refuse(
-      `Could not read ${path38 === "-" ? "the mapping from stdin" : `"${path38}"`}: ${error instanceof Error ? error.message : String(error)}`
+      `Could not read ${path39 === "-" ? "the mapping from stdin" : `"${path39}"`}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   let parsed;
@@ -34726,7 +34896,7 @@ function readSpecFile(path38) {
     parsed = JSON.parse(raw);
   } catch (error) {
     refuse(
-      `${path38 === "-" ? "stdin" : `"${path38}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      `${path39 === "-" ? "stdin" : `"${path39}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
       'Expected { "map": { "<destField>": "<value>", \u2026 } }'
     );
   }
@@ -34868,7 +35038,7 @@ async function mapOptions(args, fromFile, into) {
     destinationFields: hubspotForm ? await hubspotFieldCatalog(hubspotForm) : void 0
   };
 }
-var mapCommand2 = defineCommand113({
+var mapCommand2 = defineCommand114({
   meta: {
     name: "map",
     description: "Map form fields onto any value a side effect sends \u2014 never hand-write a mapping. Start here: baker flows map contact --from map.json --write"
@@ -34966,7 +35136,7 @@ var mapCommand2 = defineCommand113({
 });
 
 // src/commands/flows/normalize.ts
-import { defineCommand as defineCommand114 } from "citty";
+import { defineCommand as defineCommand115 } from "citty";
 var OPTIONAL_STRINGS = ["oauthProviderId"];
 var ARRAY_FIELDS = [
   "fieldMapping",
@@ -34980,18 +35150,18 @@ var ARRAY_FIELDS = [
   "tagIds"
 ];
 var ARRAY_OWNERS = ["", "body"];
-function dropUnsetOptionals(sideEffect, path38) {
+function dropUnsetOptionals(sideEffect, path39) {
   return OPTIONAL_STRINGS.flatMap((key) => {
     if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
     delete sideEffect[key];
-    return [{ path: path38, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+    return [{ path: path39, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
   });
 }
-function fillNulledArrays(target, prefix, path38) {
+function fillNulledArrays(target, prefix, path39) {
   return ARRAY_FIELDS.flatMap((key) => {
     if (!(key in target) || target[key] !== null) return [];
     target[key] = [];
-    return [{ path: path38, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+    return [{ path: path39, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
   });
 }
 function sideEffectsOf(node) {
@@ -35001,13 +35171,13 @@ function sideEffectsOf(node) {
   );
 }
 function normalizeSideEffect(sideEffect, where) {
-  const path38 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const path39 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
   const arrays = ARRAY_OWNERS.flatMap((owner) => {
     const target = owner ? sideEffect[owner] : sideEffect;
     if (!target || typeof target !== "object") return [];
-    return fillNulledArrays(target, owner ? `${owner}.` : "", path38);
+    return fillNulledArrays(target, owner ? `${owner}.` : "", path39);
   });
-  return [...dropUnsetOptionals(sideEffect, path38), ...arrays];
+  return [...dropUnsetOptionals(sideEffect, path39), ...arrays];
 }
 function normalizeFlowTree(tree) {
   const changes = [];
@@ -35035,7 +35205,7 @@ registerSchema({
     }
   }
 });
-var normalizeCommand = defineCommand114({
+var normalizeCommand = defineCommand115({
   meta: {
     name: "normalize",
     description: "Repair the shapes a form file is allowed to get slightly wrong. Example: baker flows normalize contact --write"
@@ -35066,7 +35236,7 @@ var normalizeCommand = defineCommand114({
 });
 
 // src/commands/flows/schema.ts
-import { defineCommand as defineCommand115 } from "citty";
+import { defineCommand as defineCommand116 } from "citty";
 registerSchema({
   command: "flows.schema",
   description: "The shape of one node or side-effect type: a pasteable skeleton, who fills each part, and the reference file with the craft. Start here before authoring anything in a form's _data.json.",
@@ -35091,7 +35261,7 @@ function triggerHints(triggers) {
     `A side effect on this step carries \`triggerId: "${triggers.completion}"\`, and \`baker flows add-side-effect\` writes it for you. The trigger belongs to the STEP, not to the side-effect type: one that does not match is valid, ships, and never runs.` + (others.length > 0 ? ` Other moments this step raises: ${others.join(", ")}.` : "")
   ];
 }
-var schemaCommand = defineCommand115({
+var schemaCommand = defineCommand116({
   meta: {
     name: "schema",
     description: "Show a node or side-effect type's shape. Start here: baker flows schema node customForm \xB7 baker flows schema side-effect googleSpreadsheet \xB7 baker flows schema (lists both)"
@@ -35225,7 +35395,7 @@ function displayName(slug) {
   const name = tree.displayName;
   return typeof name === "string" && name.trim() ? name.trim() : slug;
 }
-var listCommand12 = defineCommand116({
+var listCommand12 = defineCommand117({
   meta: {
     name: "list",
     description: "List Forms in this workspace with the count of confidential fields still needing setup. Example: baker flows list"
@@ -35246,7 +35416,7 @@ var listCommand12 = defineCommand116({
     });
   }
 });
-var showCommand3 = defineCommand116({
+var showCommand3 = defineCommand117({
   meta: {
     name: "show",
     description: "Show a Form's confidential fields and their configuration status (never secret values). Example: baker flows show contact"
@@ -35274,7 +35444,7 @@ var showCommand3 = defineCommand116({
     });
   }
 });
-var flowsCommand = defineCommand116({
+var flowsCommand = defineCommand117({
   meta: {
     name: "flows",
     description: `Read and shape this workspace's Forms (flows).
@@ -35308,10 +35478,10 @@ Full guide: __tooling__/docs/tools/baker/flows.md`
 });
 
 // src/commands/ga4/index.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand124 } from "citty";
 
 // src/commands/ga4/audit.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand118 } from "citty";
 
 // src/commands/ga4/resolve.ts
 async function fetchProperties(useCache = true) {
@@ -35377,7 +35547,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var auditCommand2 = defineCommand117({
+var auditCommand2 = defineCommand118({
   meta: {
     name: "audit",
     description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
@@ -35432,7 +35602,7 @@ Examples:
 });
 
 // src/commands/ga4/config.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand119 } from "citty";
 
 // src/commands/ga4/shared.ts
 import { readFileSync as readFileSync12 } from "fs";
@@ -35545,10 +35715,10 @@ async function stageOps(ops) {
     handleError2(err);
   }
 }
-async function draftAction2(path38, body, chat) {
+async function draftAction2(path39, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path38, { chatId, ...body });
+    const data = await apiPost(path39, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -35628,7 +35798,7 @@ function configHints(config) {
   }
   return hints;
 }
-var configCommand = defineCommand118({
+var configCommand = defineCommand119({
   meta: {
     name: "config",
     description: `Read how the property is configured to measure \u2014 key events, custom definitions, custom events, retention
@@ -35660,7 +35830,7 @@ Examples:
 });
 
 // src/commands/ga4/draft.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand120 } from "citty";
 registerSchema({
   command: "ga4.draft",
   description: "Review and undo the Google Analytics changes staged on this chat. Use `list` to see everything staged, `show` to inspect one change in full before the chat completes, `amend` to correct one in place, and `remove`/`clear` to drop them. `list` and `show` take --chat <id> to read an earlier chat's changes instead.",
@@ -35669,13 +35839,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand3 = defineCommand119({
+var draftCommand3 = defineCommand120({
   meta: {
     name: "draft",
     description: "List, show, amend, remove or clear the Google Analytics changes staged on this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
   },
   subCommands: {
-    list: defineCommand119({
+    list: defineCommand120({
       meta: { name: "list", description: "Review everything staged on this chat (--json for the raw envelope)" },
       args: {
         json: { type: "boolean", description: "Print the raw JSON envelope", required: false },
@@ -35685,7 +35855,7 @@ var draftCommand3 = defineCommand119({
         await draftList(args.json === true, args.chat);
       }
     }),
-    show: defineCommand119({
+    show: defineCommand120({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change, alongside how the property looks today \u2014 the receipt to verify it before the chat completes (never truncated)."
@@ -35702,7 +35872,7 @@ var draftCommand3 = defineCommand119({
         );
       }
     }),
-    amend: defineCommand119({
+    amend: defineCommand120({
       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-runs every check. Use this instead of remove + re-create."
@@ -35719,7 +35889,7 @@ var draftCommand3 = defineCommand119({
         });
       }
     }),
-    remove: defineCommand119({
+    remove: defineCommand120({
       meta: { name: "remove", description: "Remove one staged change" },
       args: { ref: { type: "positional", description: "Staged ref or target id", required: false } },
       run: async ({ args }) => {
@@ -35728,7 +35898,7 @@ var draftCommand3 = defineCommand119({
         });
       }
     }),
-    clear: defineCommand119({
+    clear: defineCommand120({
       meta: { name: "clear", description: "Discard all Google Analytics changes staged on this chat" },
       run: async () => {
         await draftAction2("/api/ga4/draft/clear", {});
@@ -35738,7 +35908,7 @@ var draftCommand3 = defineCommand119({
 });
 
 // src/commands/ga4/properties.ts
-import { defineCommand as defineCommand120 } from "citty";
+import { defineCommand as defineCommand121 } from "citty";
 registerSchema({
   command: "ga4.properties",
   description: "List the GA4 properties this company connected \u2014 there can be several, and every one of them is yours to query. Returns the property IDs the query and audit commands take. Run this first to find property IDs.",
@@ -35754,7 +35924,7 @@ function propertyHints(properties) {
     resources: properties.map((property) => ({ id: property.externalId, label: property.name }))
   });
 }
-var propertiesCommand = defineCommand120({
+var propertiesCommand = defineCommand121({
   meta: {
     name: "properties",
     description: `List accessible GA4 properties.
@@ -35804,7 +35974,7 @@ Examples:
 // src/commands/ga4/query.ts
 import { appendFileSync as appendFileSync2, existsSync as existsSync7, readFileSync as readFileSync13, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve2 } from "path";
-import { defineCommand as defineCommand121 } from "citty";
+import { defineCommand as defineCommand122 } from "citty";
 
 // src/commands/ga4/presets.ts
 var GA4_PRESETS = [
@@ -35939,7 +36109,7 @@ function handleError3(err) {
   });
   process.exit(1);
 }
-var queryCommand2 = defineCommand121({
+var queryCommand2 = defineCommand122({
   meta: {
     name: "query",
     description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
@@ -36010,7 +36180,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/ga4/write-commands.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand123 } from "citty";
 var PROPERTY_ARG_DESCRIPTION = "GA4 property id (optional only when one property is connected \u2014 run `baker ga4 properties`)";
 var propertyArg = { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false };
 function createJsonDescription(noun) {
@@ -36028,7 +36198,7 @@ registerSchema({
     "property-id": { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false }
   }
 });
-var keyEventCommand = defineCommand122({
+var keyEventCommand = defineCommand123({
   meta: {
     name: "key-event",
     description: `Stage key-event (conversion) changes
@@ -36041,7 +36211,7 @@ Examples:
   baker ga4 key-event delete 4185`
   },
   subCommands: {
-    create: defineCommand122({
+    create: defineCommand123({
       meta: {
         name: "create",
         description: "Stage a new key event. Needs eventName and countingMethod (ONCE_PER_EVENT or ONCE_PER_SESSION); defaultValue sets a monetary value when the event does not send one."
@@ -36062,7 +36232,7 @@ Examples:
         );
       }
     }),
-    update: defineCommand122({
+    update: defineCommand123({
       meta: {
         name: "update",
         description: "Stage a change to an existing key event (pass its id). Only countingMethod and defaultValue can change \u2014 Google will not rename a key event."
@@ -36082,7 +36252,7 @@ Examples:
         });
       }
     }),
-    delete: defineCommand122({
+    delete: defineCommand123({
       meta: {
         name: "delete",
         description: "Stage removing a key event, so the event stops counting as a conversion. The event itself keeps being collected. Irreversible once the chat completes \u2014 confirm with the user first."
@@ -36130,7 +36300,7 @@ for (const { kind, noun, createHint } of DEFINITIONS) {
 }
 function definitionCommand(definition) {
   const { command, kind, noun, example } = definition;
-  return defineCommand122({
+  return defineCommand123({
     meta: {
       name: command,
       description: `Stage ${noun} changes
@@ -36142,7 +36312,7 @@ Examples:
   baker ga4 ${command} archive 12`
     },
     subCommands: {
-      create: defineCommand122({
+      create: defineCommand123({
         meta: { name: "create", description: `Stage a new ${noun} (or a JSON array of them, staged together)` },
         args: {
           json: { type: "string", description: createJsonDescription(noun), required: false },
@@ -36160,7 +36330,7 @@ Examples:
           );
         }
       }),
-      update: defineCommand122({
+      update: defineCommand123({
         meta: {
           name: "update",
           description: `Stage a change to an existing ${noun} (pass its id). The parameter name and scope cannot change \u2014 archive and recreate for that.`
@@ -36180,7 +36350,7 @@ Examples:
           });
         }
       }),
-      archive: defineCommand122({
+      archive: defineCommand123({
         meta: {
           name: "archive",
           description: `Stage archiving a ${noun} (pass its id). It stops collecting and leaves reporting; past data stays. Irreversible once the chat completes \u2014 confirm with the user first.`
@@ -36225,7 +36395,7 @@ var dataStreamArg = {
 function withStream(args) {
   return typeof args["data-stream"] === "string" ? { dataStream: args["data-stream"] } : {};
 }
-var customEventCommand = defineCommand122({
+var customEventCommand = defineCommand123({
   meta: {
     name: "custom-event",
     description: `Stage custom events \u2014 new events built from events the site already sends
@@ -36236,7 +36406,7 @@ Examples:
   baker ga4 custom-event delete 7`
   },
   subCommands: {
-    create: defineCommand122({
+    create: defineCommand123({
       meta: {
         name: "create",
         description: "Stage a new custom event. Conditions match the source event: use field `event_name` to match the event itself, or any parameter name to match its value."
@@ -36259,7 +36429,7 @@ Examples:
         );
       }
     }),
-    update: defineCommand122({
+    update: defineCommand123({
       meta: { name: "update", description: "Stage a change to an existing custom event (pass its id)" },
       args: {
         id: { type: "positional", description: "Custom event rule id", required: false },
@@ -36278,7 +36448,7 @@ Examples:
         });
       }
     }),
-    delete: defineCommand122({
+    delete: defineCommand123({
       meta: {
         name: "delete",
         description: "Stage removing a custom event (pass its id). The event stops being created from then on; data already collected under it stays. Confirm with the user first."
@@ -36333,7 +36503,7 @@ function booleanArg(input, flag) {
   if (input === "false") return false;
   return failValidation3(`--${flag} must be true or false`);
 }
-var dataRetentionCommand = defineCommand122({
+var dataRetentionCommand = defineCommand123({
   meta: {
     name: "data-retention",
     description: `Stage a change to how long Google Analytics keeps data
@@ -36343,7 +36513,7 @@ Examples:
   baker ga4 data-retention set --event-data 14 --user-data 14 --reset-on-activity true`
   },
   subCommands: {
-    set: defineCommand122({
+    set: defineCommand123({
       meta: { name: "set", description: "Stage the retention window (months)" },
       args: {
         "event-data": { type: "string", description: "2, 14, 26, 38 or 50", required: false },
@@ -36379,7 +36549,7 @@ registerSchema({
     "property-id": { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false }
   }
 });
-var audienceCommand = defineCommand122({
+var audienceCommand = defineCommand123({
   meta: {
     name: "audience",
     description: `Stage audience changes (saved groups of users, for retargeting and analysis)
@@ -36411,7 +36581,7 @@ Examples:
   baker ga4 audience archive 8813`
   },
   subCommands: {
-    create: defineCommand122({
+    create: defineCommand123({
       meta: { name: "create", description: createJsonDescription("audience") },
       args: {
         json: { type: "string", description: createJsonDescription("audience"), required: false },
@@ -36429,7 +36599,7 @@ Examples:
         );
       }
     }),
-    update: defineCommand122({
+    update: defineCommand123({
       meta: {
         name: "update",
         description: "Stage a new name or description (pass the audience id). Who is in it cannot be changed."
@@ -36450,7 +36620,7 @@ Examples:
         });
       }
     }),
-    archive: defineCommand122({
+    archive: defineCommand123({
       meta: {
         name: "archive",
         description: "Stage retiring an audience. Cannot be undone \u2014 the users it gathered do not come back."
@@ -36479,7 +36649,7 @@ registerSchema({
     "property-id": { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false }
   }
 });
-var propertyCommand = defineCommand122({
+var propertyCommand = defineCommand123({
   meta: {
     name: "property",
     description: `Stage a change to the property's own settings
@@ -36489,7 +36659,7 @@ Examples:
   baker ga4 property set --name "Acme \u2014 Web" --industry REAL_ESTATE`
   },
   subCommands: {
-    set: defineCommand122({
+    set: defineCommand123({
       meta: { name: "set", description: "Stage the property name and/or industry category" },
       args: {
         name: { type: "string", description: "New property display name", required: false },
@@ -36529,7 +36699,7 @@ registerSchema({
     "property-id": { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false }
   }
 });
-var adsLinkCommand = defineCommand122({
+var adsLinkCommand = defineCommand123({
   meta: {
     name: "ads-link",
     description: `Stage linking this property to a Google Ads account
@@ -36544,7 +36714,7 @@ Examples:
   baker ga4 ads-link delete L1234`
   },
   subCommands: {
-    create: defineCommand122({
+    create: defineCommand123({
       meta: { name: "create", description: "Stage linking the property to a Google Ads account" },
       args: {
         "customer-id": { type: "string", description: "Google Ads customer id (123-456-7890)", required: false },
@@ -36563,7 +36733,7 @@ Examples:
         await stageOp3({ kind: "ga4.googleAdsLink.create", payload, ...withProperty(args) });
       }
     }),
-    update: defineCommand122({
+    update: defineCommand123({
       meta: {
         name: "update",
         description: "Stage the ads-personalisation setting on an existing link (pass its id)"
@@ -36585,7 +36755,7 @@ Examples:
         });
       }
     }),
-    delete: defineCommand122({
+    delete: defineCommand123({
       meta: {
         name: "delete",
         description: "Stage unlinking. Stops conversion imports and strands every audience on this property."
@@ -36636,7 +36806,7 @@ var MEASUREMENT_FLAGS = {
   "page-changes": "pageChangesEnabled",
   "form-interactions": "formInteractionsEnabled"
 };
-var enhancedMeasurementCommand = defineCommand122({
+var enhancedMeasurementCommand = defineCommand123({
   meta: {
     name: "enhanced-measurement",
     description: `Stage the automatic events GA4 collects on a website stream
@@ -36650,7 +36820,7 @@ Examples:
   baker ga4 enhanced-measurement set --video false`
   },
   subCommands: {
-    set: defineCommand122({
+    set: defineCommand123({
       meta: { name: "set", description: "Stage which automatic events the website stream collects" },
       args: {
         scrolls: { type: "string", description: "true|false", required: false },
@@ -36693,7 +36863,7 @@ Examples:
 });
 
 // src/commands/ga4/index.ts
-var ga4Command = defineCommand123({
+var ga4Command = defineCommand124({
   meta: {
     name: "ga4",
     description: `Google Analytics 4. Report on a property, audit its config, and change what it measures.
@@ -36742,12 +36912,12 @@ Full guide: __tooling__/docs/tools/baker/ga4.md`
 });
 
 // src/commands/gsc/index.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand128 } from "citty";
 
 // src/commands/gsc/query.ts
 import { appendFileSync as appendFileSync3, existsSync as existsSync8, readFileSync as readFileSync14, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve3 } from "path";
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand125 } from "citty";
 
 // src/commands/gsc/presets.ts
 var GSC_PRESETS = [
@@ -36941,7 +37111,7 @@ function handleError4(err) {
   });
   process.exit(1);
 }
-var queryCommand3 = defineCommand124({
+var queryCommand3 = defineCommand125({
   meta: {
     name: "query",
     description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
@@ -37019,7 +37189,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/gsc/sitemaps.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand126 } from "citty";
 registerSchema({
   command: "gsc.sitemaps",
   description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
@@ -37028,7 +37198,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitemapsCommand = defineCommand125({
+var sitemapsCommand = defineCommand126({
   meta: {
     name: "sitemaps",
     description: `List sitemaps for a site. Check health and errors.
@@ -37081,7 +37251,7 @@ Examples:
 });
 
 // src/commands/gsc/sites.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand127 } from "citty";
 registerSchema({
   command: "gsc.sites",
   description: "List the Search Console sites this company connected \u2014 there can be several, and every one of them is yours to query. Returns the site URLs the query and sitemaps commands take.",
@@ -37097,7 +37267,7 @@ function siteHints(sites) {
     resources: sites.map((site) => ({ id: site.siteUrl, label: site.permissionLevel }))
   });
 }
-var sitesCommand = defineCommand126({
+var sitesCommand = defineCommand127({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -37145,7 +37315,7 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-var gscCommand = defineCommand127({
+var gscCommand = defineCommand128({
   meta: {
     name: "gsc",
     description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
@@ -37169,7 +37339,7 @@ Full guide: __tooling__/docs/tools/baker/gsc.md`
 });
 
 // src/commands/history/index.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand129 } from "citty";
 registerSchema({
   command: "history.list",
   description: "Start here: unified account history (audit log) \u2014 everything that changed on this account, newest first: publishes, chat lifecycle, backlog actions, team changes, setup links, tags, schedules, ad-platform writes, followed advertisers, media, creatives, reports, domains, and integrations. Use it to see what happened recently before planning work. Compact by default; add --full for raw metadata per entry.",
@@ -37224,7 +37394,7 @@ function parseBoundedInt2(raw, name, min, max) {
   }
   return value;
 }
-var listCommand13 = defineCommand128({
+var listCommand13 = defineCommand129({
   meta: {
     name: "list",
     description: "List recent account changes (unified audit log), newest first."
@@ -37270,7 +37440,7 @@ var listCommand13 = defineCommand128({
     }
   }
 });
-var historyCommand = defineCommand128({
+var historyCommand = defineCommand129({
   meta: {
     name: "history",
     description: `Unified account history (audit log): what changed, who did it, and when.
@@ -37280,7 +37450,7 @@ Full guide: __tooling__/docs/tools/baker/history.md`
 });
 
 // src/commands/hubspot/index.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand130 } from "citty";
 var EMBED_TYPES = ["legacy", "v4", "unknown"];
 function failNotConnected(err) {
   if (err instanceof ApiError && err.code === "FORBIDDEN" && err.message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
@@ -37434,7 +37604,7 @@ registerSchema({
     }
   }
 });
-var formsListCommand = defineCommand129({
+var formsListCommand = defineCommand130({
   meta: {
     name: "list",
     description: "List HubSpot forms with embed type and post-submit action. Example: baker hubspot forms list --redirecting-only"
@@ -37479,7 +37649,7 @@ var formsListCommand = defineCommand129({
     }
   }
 });
-var formsViewCommand = defineCommand129({
+var formsViewCommand = defineCommand130({
   meta: {
     name: "view",
     description: "Show one HubSpot form's fields and configuration. Example: baker hubspot forms view 1a2b3c"
@@ -37531,7 +37701,7 @@ var formsViewCommand = defineCommand129({
     }
   }
 });
-var meetingsListCommand = defineCommand129({
+var meetingsListCommand = defineCommand130({
   meta: {
     name: "list",
     description: "List HubSpot meeting links (calendars). Example: baker hubspot meetings list"
@@ -37573,7 +37743,7 @@ var meetingsListCommand = defineCommand129({
     }
   }
 });
-var meetingsViewCommand = defineCommand129({
+var meetingsViewCommand = defineCommand130({
   meta: {
     name: "view",
     description: "Show one HubSpot meeting link's booking fields. Example: baker hubspot meetings view discovery-call"
@@ -37617,7 +37787,7 @@ var meetingsViewCommand = defineCommand129({
     }
   }
 });
-var formsSubmissionsCommand = defineCommand129({
+var formsSubmissionsCommand = defineCommand130({
   meta: {
     name: "submissions",
     description: "How many leads a form received, and when. Example: baker hubspot forms submissions <formId> --days 30"
@@ -37666,7 +37836,7 @@ var formsSubmissionsCommand = defineCommand129({
     }
   }
 });
-var workflowsListCommand = defineCommand129({
+var workflowsListCommand = defineCommand130({
   meta: {
     name: "list",
     description: "List HubSpot workflows. Example: baker hubspot workflows list --enabled-only"
@@ -37731,7 +37901,7 @@ function workflowViewHints(workflow) {
   }
   return hints;
 }
-var workflowsViewCommand = defineCommand129({
+var workflowsViewCommand = defineCommand130({
   meta: {
     name: "view",
     description: "Read one workflow's real configuration \u2014 enrolment, branches in order, and what each step writes. Example: baker hubspot workflows view 121183594 --full"
@@ -37758,7 +37928,7 @@ var workflowsViewCommand = defineCommand129({
     }
   }
 });
-var pipelinesListCommand = defineCommand129({
+var pipelinesListCommand = defineCommand130({
   meta: {
     name: "list",
     description: "List HubSpot deal pipelines and their stages. Example: baker hubspot pipelines list"
@@ -37775,7 +37945,7 @@ var pipelinesListCommand = defineCommand129({
     }
   }
 });
-var contactsSummaryCommand = defineCommand129({
+var contactsSummaryCommand = defineCommand130({
   meta: {
     name: "summary",
     description: "Whether recent leads are being worked, as counts. Example: baker hubspot contacts summary --days 30"
@@ -37845,7 +38015,7 @@ function contactLookupHints(data) {
   }
   return hints;
 }
-var contactsLookupCommand = defineCommand129({
+var contactsLookupCommand = defineCommand130({
   meta: {
     name: "lookup",
     description: "Find one contact by email and see whether it was worked. Example: baker hubspot contacts lookup a@b.com"
@@ -37869,27 +38039,27 @@ var contactsLookupCommand = defineCommand129({
     }
   }
 });
-var contactsCommand = defineCommand129({
+var contactsCommand = defineCommand130({
   meta: { name: "contacts", description: "Contacts on the connected HubSpot account." },
   subCommands: { summary: contactsSummaryCommand, lookup: contactsLookupCommand }
 });
-var formsCommand = defineCommand129({
+var formsCommand = defineCommand130({
   meta: { name: "forms", description: "HubSpot forms on the connected account." },
   subCommands: { list: formsListCommand, view: formsViewCommand, submissions: formsSubmissionsCommand }
 });
-var workflowsCommand = defineCommand129({
+var workflowsCommand = defineCommand130({
   meta: { name: "workflows", description: "HubSpot workflows on the connected account." },
   subCommands: { list: workflowsListCommand, view: workflowsViewCommand }
 });
-var pipelinesCommand = defineCommand129({
+var pipelinesCommand = defineCommand130({
   meta: { name: "pipelines", description: "HubSpot deal pipelines on the connected account." },
   subCommands: { list: pipelinesListCommand }
 });
-var meetingsCommand = defineCommand129({
+var meetingsCommand = defineCommand130({
   meta: { name: "meetings", description: "HubSpot meeting links (calendars) on the connected account." },
   subCommands: { list: meetingsListCommand, view: meetingsViewCommand }
 });
-var hubspotCommand = defineCommand129({
+var hubspotCommand = defineCommand130({
   meta: {
     name: "hubspot",
     description: `Read the connected HubSpot account \u2014 forms, the leads they received, workflows, deal pipelines and
@@ -37927,10 +38097,10 @@ Full guide: __tooling__/docs/tools/baker/hubspot.md`
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand155 } from "citty";
+import { defineCommand as defineCommand156 } from "citty";
 
 // src/commands/images/crop.ts
-import { defineCommand as defineCommand130 } from "citty";
+import { defineCommand as defineCommand131 } from "citty";
 
 // src/lib/image/crop-sprite.ts
 import sharp from "sharp";
@@ -37945,7 +38115,7 @@ function cropSprite(input, region) {
 
 // src/lib/image/io.ts
 import { randomBytes } from "crypto";
-import { glob as fsGlob, readFile as readFile20, rename, stat as stat4, writeFile as writeFile11 } from "fs/promises";
+import { glob as fsGlob, readFile as readFile21, rename, stat as stat4, writeFile as writeFile12 } from "fs/promises";
 import { dirname as dirname2, extname as extname2, join as join5, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
@@ -37978,11 +38148,11 @@ async function readImageBuffer(pathOrUrl) {
     const { buffer } = await fetchExternalBytes(pathOrUrl, { maxBytes: MAX_REMOTE_IMAGE_BYTES });
     return buffer;
   }
-  return readFile20(pathOrUrl);
+  return readFile21(pathOrUrl);
 }
-async function isDirectory(path38) {
+async function isDirectory(path39) {
   try {
-    const s = await stat4(path38);
+    const s = await stat4(path39);
     return s.isDirectory();
   } catch {
     return false;
@@ -38001,7 +38171,7 @@ async function atomicWrite(targetPath, data) {
   const absolute = resolve4(targetPath);
   const dir = dirname2(absolute);
   const tmp = join5(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
-  await writeFile11(tmp, data);
+  await writeFile12(tmp, data);
   await rename(tmp, absolute);
 }
 
@@ -38052,7 +38222,7 @@ function emitError2(err) {
   }
   process.exit(1);
 }
-var cropCommand = defineCommand130({
+var cropCommand = defineCommand131({
   meta: {
     name: "crop",
     description: "Crop a rectangular region from an image.\n\nExample: baker images crop sprite.png --x 0 --y 0 --width 64 --height 64 --output icon.png"
@@ -38088,7 +38258,7 @@ var cropCommand = defineCommand130({
 });
 
 // src/commands/images/delete.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand132 } from "citty";
 registerSchema({
   command: "images.delete",
   description: "Delete an image by ID",
@@ -38102,7 +38272,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand2 = defineCommand131({
+var deleteCommand2 = defineCommand132({
   meta: {
     name: "delete",
     description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run"
@@ -38143,7 +38313,7 @@ var deleteCommand2 = defineCommand131({
 });
 
 // src/commands/images/dimensions.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand133 } from "citty";
 
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
@@ -38172,7 +38342,7 @@ registerSchema({
     }
   }
 });
-var dimensionsCommand = defineCommand132({
+var dimensionsCommand = defineCommand133({
   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"
@@ -38228,7 +38398,7 @@ var dimensionsCommand = defineCommand132({
 });
 
 // src/commands/images/download.ts
-import { defineCommand as defineCommand133 } from "citty";
+import { defineCommand as defineCommand134 } from "citty";
 
 // src/commands/images/downloadPaths.ts
 import { basename as basename2, extname as extname3, join as join6 } from "path";
@@ -38284,13 +38454,13 @@ function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDi
 }
 function disambiguate(paths) {
   const taken = /* @__PURE__ */ new Set();
-  return paths.map((path38) => {
-    if (!taken.has(path38)) {
-      taken.add(path38);
-      return path38;
+  return paths.map((path39) => {
+    if (!taken.has(path39)) {
+      taken.add(path39);
+      return path39;
     }
-    const ext = extname3(path38);
-    const stem = path38.slice(0, path38.length - ext.length);
+    const ext = extname3(path39);
+    const stem = path39.slice(0, path39.length - ext.length);
     let n = 2;
     while (taken.has(`${stem}-${n}${ext}`)) n += 1;
     const unique = `${stem}-${n}${ext}`;
@@ -38417,10 +38587,10 @@ async function runDownloads(plan) {
   const paths = disambiguate(fetched.map((item) => item.path));
   const downloaded = [];
   for (const [index, item] of fetched.entries()) {
-    const path38 = paths[index] ?? item.path;
+    const path39 = paths[index] ?? item.path;
     try {
-      await atomicWrite(path38, item.buffer);
-      downloaded.push({ input: item.input, output: path38, bytes: item.buffer.length, contentType: item.contentType });
+      await atomicWrite(path39, item.buffer);
+      downloaded.push({ input: item.input, output: path39, bytes: item.buffer.length, contentType: item.contentType });
     } catch (err) {
       failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
     }
@@ -38453,7 +38623,7 @@ function emitError3(err) {
   writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
-var downloadCommand = defineCommand133({
+var downloadCommand = defineCommand134({
   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"
@@ -38486,7 +38656,7 @@ var downloadCommand = defineCommand133({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand135 } from "citty";
 
 // src/commands/images/autoIngest.ts
 var AUTO_INGEST_MAX = {
@@ -38533,7 +38703,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand134({
+var extractCommand = defineCommand135({
   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"
@@ -38588,7 +38758,7 @@ var extractCommand = defineCommand134({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand135 } from "citty";
+import { defineCommand as defineCommand136 } from "citty";
 
 // src/commands/images/providerHits.ts
 function asRecord3(value) {
@@ -38726,7 +38896,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var findCommand = defineCommand135({
+var findCommand = defineCommand136({
   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,magnific --limit 20"
@@ -38799,7 +38969,7 @@ var findCommand = defineCommand135({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand137 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -38807,7 +38977,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand3 = defineCommand136({
+var getCommand3 = defineCommand137({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -38843,7 +39013,7 @@ var getCommand3 = defineCommand136({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand137 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -38875,7 +39045,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand137({
+var gifCommand = defineCommand138({
   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"
@@ -38922,7 +39092,7 @@ var gifCommand = defineCommand137({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand138 } from "citty";
+import { defineCommand as defineCommand139 } 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."
@@ -38962,7 +39132,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand138({
+var googleCommand2 = defineCommand139({
   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"
@@ -39035,7 +39205,7 @@ var googleCommand2 = defineCommand138({
 });
 
 // src/commands/images/group.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 
 // src/commands/mediaGroup.ts
 async function runMediaGroupLookup(input) {
@@ -39088,7 +39258,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand = defineCommand139({
+var groupCommand = defineCommand140({
   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>"
@@ -39108,7 +39278,7 @@ var groupCommand = defineCommand139({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand141 } from "citty";
 
 // src/commands/images/brandVerification.ts
 function brandToken(domain) {
@@ -39205,7 +39375,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var iconCommand = defineCommand140({
+var iconCommand = defineCommand141({
   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'"
@@ -39275,7 +39445,7 @@ var iconCommand = defineCommand140({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 var SOURCE_VALUES = imageSourceSchema.options.join(" | ");
 registerSchema({
   command: "images.ingest",
@@ -39290,7 +39460,7 @@ registerSchema({
     fields: { type: "string", description: "Comma-separated field names to include", required: false }
   }
 });
-var ingestCommand = defineCommand141({
+var ingestCommand = defineCommand142({
   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://img.freepik.com/free-photo/xyz.jpg --source magnific --external-id 12345"
@@ -39359,7 +39529,7 @@ var ingestCommand = defineCommand141({
 });
 
 // src/commands/images/layerize.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand143 } 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.",
@@ -39423,7 +39593,7 @@ async function pollUntilSettled(imageId, maxWait) {
   }
   return null;
 }
-var layerizeCommand = defineCommand142({
+var layerizeCommand = defineCommand143({
   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'"
@@ -39492,7 +39662,7 @@ registerSchema({
     full: { type: "boolean", description: "Include geometry and typography for every layer", required: false }
   }
 });
-var layersCommand = defineCommand142({
+var layersCommand = defineCommand143({
   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"
@@ -39532,7 +39702,7 @@ var layersCommand = defineCommand142({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -39558,7 +39728,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand143({
+var libraryCommand = defineCommand144({
   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"
@@ -39621,7 +39791,7 @@ var libraryCommand = defineCommand143({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand145 } 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.",
@@ -39649,7 +39819,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var logoCommand = defineCommand144({
+var logoCommand = defineCommand145({
   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"
@@ -39722,7 +39892,7 @@ var logoCommand = defineCommand144({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -40454,7 +40624,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand2 = defineCommand145({
+var normalizeCommand2 = defineCommand146({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -40509,7 +40679,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand147 } 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.",
@@ -40529,7 +40699,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand146({
+var pinterestCommand = defineCommand147({
   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'"
@@ -40586,7 +40756,7 @@ var pinterestCommand = defineCommand146({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand148 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -40605,7 +40775,7 @@ registerSchema({
     full: { type: "boolean", description: "Include full metadata", required: false, default: false }
   }
 });
-var screenshotCommand = defineCommand147({
+var screenshotCommand = defineCommand148({
   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"
@@ -40669,7 +40839,7 @@ var screenshotCommand = defineCommand147({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand148 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -40685,7 +40855,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand148({
+var searchCommand = defineCommand149({
   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"
@@ -40745,7 +40915,7 @@ var searchCommand = defineCommand148({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand149 } from "citty";
+import { defineCommand as defineCommand150 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -40777,7 +40947,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand149({
+var stickerCommand = defineCommand150({
   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"
@@ -40824,7 +40994,7 @@ var stickerCommand = defineCommand149({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand150 } from "citty";
+import { defineCommand as defineCommand151 } 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."
@@ -40901,7 +41071,7 @@ function buildStockRequest(query, args) {
   if (args.context) body.descriptionContext = args.context;
   return body;
 }
-var stockCommand = defineCommand150({
+var stockCommand = defineCommand151({
   meta: {
     name: "stock",
     description: "Stock search via Magnific \u2014 Freepik's developer API (~250M assets: photos, vectors, illustrations, icons, PSDs). $0.002/req. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'flat office workers' --type vector\n  baker images stock 'hero photo of a kitchen' --type photo --orientation landscape --ai exclude\n  baker images stock 'brand pattern' --color '#0a0a0a' --license freemium --auto-ingest 2"
@@ -40974,7 +41144,7 @@ var stockCommand = defineCommand150({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand151 } from "citty";
+import { defineCommand as defineCommand152 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -40983,7 +41153,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand151({
+  return defineCommand152({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -41019,7 +41189,7 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand3 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { defineCommand as defineCommand152 } from "citty";
+import { defineCommand as defineCommand153 } from "citty";
 registerSchema({
   command: "images.upload",
   description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
@@ -41057,7 +41227,7 @@ registerSchema({
 function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand = defineCommand152({
+var uploadCommand = defineCommand153({
   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'"
@@ -41150,7 +41320,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand153 } from "citty";
+import { defineCommand as defineCommand154 } 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).",
@@ -41165,7 +41335,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var upscaleCommand = defineCommand153({
+var upscaleCommand = defineCommand154({
   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"
@@ -41220,7 +41390,7 @@ var upscaleCommand = defineCommand153({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand154 } from "citty";
+import { defineCommand as defineCommand155 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -41249,7 +41419,7 @@ function emitReady(ingestResult, doc, args) {
     args.full === true
   );
 }
-var useCommand = defineCommand154({
+var useCommand = defineCommand155({
   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"
@@ -41298,7 +41468,7 @@ var useCommand = defineCommand154({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand155({
+var imagesCommand = defineCommand156({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -41376,12 +41546,12 @@ Full guide: __tooling__/docs/tools/baker/images.md`
 });
 
 // src/commands/landing/index.ts
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand167 } from "citty";
 
 // src/commands/landing/critique.ts
 import { readdir as readdir9, stat as stat6 } from "fs/promises";
-import path28 from "path";
-import { defineCommand as defineCommand156 } from "citty";
+import path29 from "path";
+import { defineCommand as defineCommand157 } from "citty";
 
 // src/engine/landing/lib/constants.ts
 var OVERUSED_FONTS = /* @__PURE__ */ new Set([
@@ -42347,40 +42517,40 @@ function describeCounts(findings) {
 }
 
 // src/commands/landing/snapshot.ts
-import { mkdir as mkdir8, rename as rename2, writeFile as writeFile12 } from "fs/promises";
-import path26 from "path";
+import { mkdir as mkdir9, rename as rename2, writeFile as writeFile13 } from "fs/promises";
+import path27 from "path";
 var CRITIC_VERSION = "2";
 function critiqueCacheDir(projectRoot) {
-  return path26.join(projectRoot, ".cache", "landing-critique");
+  return path27.join(projectRoot, ".cache", "landing-critique");
 }
 function snapshotPath(projectRoot, slug) {
-  return path26.join(critiqueCacheDir(projectRoot), `${slug}.json`);
+  return path27.join(critiqueCacheDir(projectRoot), `${slug}.json`);
 }
 async function writeCritiqueSnapshot(projectRoot, snapshot) {
-  await mkdir8(critiqueCacheDir(projectRoot), { recursive: true });
+  await mkdir9(critiqueCacheDir(projectRoot), { recursive: true });
   const dest = snapshotPath(projectRoot, snapshot.slug);
   const tmp = `${dest}.tmp`;
-  await writeFile12(tmp, `${JSON.stringify(snapshot, null, 2)}
+  await writeFile13(tmp, `${JSON.stringify(snapshot, null, 2)}
 `, "utf8");
   await rename2(tmp, dest);
 }
 
 // src/commands/landing/source-version.ts
-import { readdir as readdir8, readFile as readFile21, stat as stat5 } from "fs/promises";
-import path27 from "path";
+import { readdir as readdir8, readFile as readFile22, stat as stat5 } from "fs/promises";
+import path28 from "path";
 async function landingSourceRelPaths(landingDir) {
   const rel = [];
-  if (await isFile(path27.join(landingDir, "index.astro"))) rel.push("index.astro");
-  const componentsDir = path27.join(landingDir, "_components");
+  if (await isFile(path28.join(landingDir, "index.astro"))) rel.push("index.astro");
+  const componentsDir = path28.join(landingDir, "_components");
   for (const abs of await walkAstro(componentsDir)) {
-    rel.push(path27.relative(landingDir, abs).split(path27.sep).join("/"));
+    rel.push(path28.relative(landingDir, abs).split(path28.sep).join("/"));
   }
   return rel.sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
 }
 async function readLandingSources(landingDir) {
   const rel = await landingSourceRelPaths(landingDir);
   const out = [];
-  for (const r of rel) out.push({ path: r, text: await readFile21(path27.join(landingDir, r), "utf8") });
+  for (const r of rel) out.push({ path: r, text: await readFile22(path28.join(landingDir, r), "utf8") });
   return out;
 }
 async function computeLandingSourceSha(landingDir) {
@@ -42389,7 +42559,7 @@ async function computeLandingSourceSha(landingDir) {
   for (const r of rel) {
     let bytes;
     try {
-      bytes = await readFile21(path27.join(landingDir, r));
+      bytes = await readFile22(path28.join(landingDir, r));
     } catch {
       bytes = Buffer.alloc(0);
     }
@@ -42413,7 +42583,7 @@ async function walkAstro(dir) {
   }
   const out = [];
   for (const entry of entries) {
-    const abs = path27.join(dir, entry.name);
+    const abs = path28.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...await walkAstro(abs));
     else if (entry.isFile() && entry.name.endsWith(".astro")) out.push(abs);
   }
@@ -42450,7 +42620,7 @@ function fail5(code, message, fix) {
   );
   process.exit(2);
 }
-var critiqueCommand2 = defineCommand156({
+var critiqueCommand2 = defineCommand157({
   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) 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."
@@ -42474,7 +42644,7 @@ var critiqueCommand2 = defineCommand156({
           { availableSlugs: await listLandingSlugs(projectRoot) }
         );
       }
-      if (!await isDir(path28.resolve(projectRoot, "src", "pages", slug))) {
+      if (!await isDir(path29.resolve(projectRoot, "src", "pages", slug))) {
         fail5("NOT_FOUND", `No landing at src/pages/${slug}/`, {
           availableSlugs: await listLandingSlugs(projectRoot)
         });
@@ -42513,7 +42683,7 @@ var critiqueCommand2 = defineCommand156({
   }
 });
 async function critiqueOne(projectRoot, slug, brand) {
-  const landingDir = path28.resolve(projectRoot, "src", "pages", slug);
+  const landingDir = path29.resolve(projectRoot, "src", "pages", slug);
   const [sources, sourceSha] = await Promise.all([readLandingSources(landingDir), computeLandingSourceSha(landingDir)]);
   const report = critiqueLanding({ slug, sources, brand });
   let snapshotFailed = false;
@@ -42533,7 +42703,7 @@ async function critiqueOne(projectRoot, slug, brand) {
 }
 async function listLandingSlugs(projectRoot) {
   try {
-    const entries = await readdir9(path28.join(projectRoot, "src", "pages"), { withFileTypes: true });
+    const entries = await readdir9(path29.join(projectRoot, "src", "pages"), { withFileTypes: true });
     return entries.filter((e) => e.isDirectory() && !e.name.startsWith("_") && !e.name.startsWith(".")).map((e) => e.name).sort();
   } catch {
     return [];
@@ -42559,10 +42729,10 @@ async function isDir(p) {
 }
 
 // src/commands/landing/inspiration/index.ts
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand166 } from "citty";
 
 // src/commands/landing/inspiration/add.ts
-import { defineCommand as defineCommand157 } from "citty";
+import { defineCommand as defineCommand158 } from "citty";
 
 // src/commands/landing/inspiration/shared.ts
 var INSPIRATION_HINTS = {
@@ -42644,7 +42814,7 @@ registerSchema({
     note: { type: "string", description: "Why this page is worth keeping", required: false }
   }
 });
-var addCommand = defineCommand157({
+var addCommand = defineCommand158({
   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'"
@@ -42684,9 +42854,9 @@ var addCommand = defineCommand157({
 });
 
 // src/commands/landing/inspiration/code.ts
-import { mkdir as mkdir9, writeFile as writeFile13 } from "fs/promises";
-import path29 from "path";
-import { defineCommand as defineCommand158 } from "citty";
+import { mkdir as mkdir10, writeFile as writeFile14 } from "fs/promises";
+import path30 from "path";
+import { defineCommand as defineCommand159 } 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.",
@@ -42695,7 +42865,7 @@ registerSchema({
     full: { type: "boolean", description: "Print the markup inline as well as writing it", required: false }
   }
 });
-var codeCommand = defineCommand158({
+var codeCommand = defineCommand159({
   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."
@@ -42708,10 +42878,10 @@ var codeCommand = defineCommand158({
     try {
       const id = args.id;
       const data = await apiGet("/api/landing-inspiration/section-code", { id });
-      const dir = path29.join(process.cwd(), ".baker", "inspiration", id);
-      await mkdir9(dir, { recursive: true });
-      const file = path29.join(dir, "section.html");
-      await writeFile13(file, data.html);
+      const dir = path30.join(process.cwd(), ".baker", "inspiration", id);
+      await mkdir10(dir, { recursive: true });
+      const file = path30.join(dir, "section.html");
+      await writeFile14(file, data.html);
       const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
       const fidelity = fidelityHint(data.fidelity);
       if (fidelity) hints.push(fidelity);
@@ -42720,7 +42890,7 @@ var codeCommand = defineCommand158({
         ok: true,
         data: {
           id,
-          file: path29.relative(process.cwd(), file),
+          file: path30.relative(process.cwd(), file),
           bytes: data.html.length,
           fidelity: data.fidelity,
           reproduction_notes: data.reproductionNotes,
@@ -42741,7 +42911,7 @@ var codeCommand = defineCommand158({
 });
 
 // src/commands/landing/inspiration/favorites.ts
-import { defineCommand as defineCommand159 } from "citty";
+import { defineCommand as defineCommand160 } 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.",
@@ -42755,7 +42925,7 @@ registerSchema({
     }
   }
 });
-var favoritesCommand = defineCommand159({
+var favoritesCommand = defineCommand160({
   meta: {
     name: "favorites",
     description: "List this company's saved reference sections. Example: baker landing inspiration favorites --type hero,pricing"
@@ -42835,7 +43005,7 @@ registerSchema({
     note: { type: "string", description: "Why this is worth keeping", required: false }
   }
 });
-var favoriteCommand = defineCommand159({
+var favoriteCommand = defineCommand160({
   meta: {
     name: "favorite",
     description: "Save a reference section to this company. Example: baker landing inspiration favorite k57abc\u2026"
@@ -42873,7 +43043,7 @@ registerSchema({
     page: { type: "boolean", description: "Treat the id as a page rather than a section", required: false }
   }
 });
-var unfavoriteCommand = defineCommand159({
+var unfavoriteCommand = defineCommand160({
   meta: {
     name: "unfavorite",
     description: "Remove a reference section from this company's saved set. Example: baker landing inspiration unfavorite k57abc\u2026"
@@ -42895,7 +43065,7 @@ var unfavoriteCommand = defineCommand159({
 });
 
 // src/commands/landing/inspiration/page.ts
-import { defineCommand as defineCommand160 } from "citty";
+import { defineCommand as defineCommand161 } 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.",
@@ -42912,7 +43082,7 @@ registerSchema({
     }
   }
 });
-var pageCommand2 = defineCommand160({
+var pageCommand2 = defineCommand161({
   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."
@@ -42975,7 +43145,7 @@ var pageCommand2 = defineCommand160({
 });
 
 // src/commands/landing/inspiration/scrape.ts
-import { defineCommand as defineCommand161 } from "citty";
+import { defineCommand as defineCommand162 } from "citty";
 
 // src/engine/landing-library/proxyFailure.ts
 var PROXY_STATUS = 407;
@@ -43151,8 +43321,8 @@ function classifyCaptureFailure(error) {
 }
 
 // src/engine/landing-library/run.ts
-import { mkdir as mkdir10, writeFile as writeFile15 } from "fs/promises";
-import path31 from "path";
+import { mkdir as mkdir11, writeFile as writeFile16 } from "fs/promises";
+import path32 from "path";
 
 // ../proxy/src/preflight.ts
 import http from "http";
@@ -44567,11 +44737,11 @@ async function renderBundleToPng(browser, html, viewportWidth, options = {}) {
 }
 
 // src/engine/landing-library/report.ts
-import { writeFile as writeFile14 } from "fs/promises";
-import path30 from "path";
+import { writeFile as writeFile15 } from "fs/promises";
+import path31 from "path";
 async function writeCaptureReport(manifest, outDir) {
-  const file = path30.join(outDir, "report.html");
-  await writeFile14(file, renderReport(manifest));
+  const file = path31.join(outDir, "report.html");
+  await writeFile15(file, renderReport(manifest));
   return file;
 }
 function escapeHtml3(value) {
@@ -44749,32 +44919,32 @@ async function reproducePage(args) {
   const { browser, page, outDir, pageUrl, livePageShot } = args;
   const built = await buildSectionBundle(page, "body", pageUrl).catch(() => null);
   if (!built) return { bundle: null, fidelity: null };
-  await writeFile15(path31.join(outDir, "page.html"), built.html);
+  await writeFile16(path32.join(outDir, "page.html"), built.html);
   const rendered = await renderBundleToPng(browser, built.html, DESKTOP_VIEWPORT.width, {
     wholePage: true,
     timeoutMs: 6e4
   });
   if (!rendered || !livePageShot) return { bundle: "page.html", fidelity: null };
-  await writeFile15(path31.join(outDir, "page-rendered.png"), rendered);
+  await writeFile16(path32.join(outDir, "page-rendered.png"), rendered);
   const { score, note } = await scoreFidelity(livePageShot, rendered);
   return { bundle: "page.html", fidelity: score, ...note ? { fidelityNote: note } : {} };
 }
 async function captureOneSection(args) {
   const { browser, page, candidate, sectionsDir, outDir, pageUrl, withCode } = args;
-  const dir = path31.join(sectionsDir, String(candidate.index).padStart(2, "0"));
-  await mkdir10(dir, { recursive: true });
+  const dir = path32.join(sectionsDir, String(candidate.index).padStart(2, "0"));
+  await mkdir11(dir, { recursive: true });
   const desktop = await captureSection(page, candidate);
-  if (desktop) await writeFile15(path31.join(dir, "desktop.png"), desktop);
+  if (desktop) await writeFile16(path32.join(dir, "desktop.png"), desktop);
   const visualHash = desktop ? await perceptualHash(desktop) : null;
   const motion = await collectMotion(page, candidate.selector);
   const built = withCode ? await buildSectionBundle(page, candidate.selector, pageUrl) : null;
   let fidelity = null;
   let fidelityNote;
   if (built) {
-    await writeFile15(path31.join(dir, "section.html"), built.html);
+    await writeFile16(path32.join(dir, "section.html"), built.html);
     const rendered = await renderBundleToPng(browser, built.html, DESKTOP_VIEWPORT.width);
     if (rendered && desktop) {
-      await writeFile15(path31.join(dir, "section-rendered.png"), rendered);
+      await writeFile16(path32.join(dir, "section-rendered.png"), rendered);
       const result = await scoreFidelity(desktop, rendered);
       fidelity = result.score;
       fidelityNote = result.note;
@@ -44782,9 +44952,9 @@ async function captureOneSection(args) {
   }
   return {
     ...candidate,
-    desktopShot: desktop ? path31.relative(outDir, path31.join(dir, "desktop.png")) : null,
+    desktopShot: desktop ? path32.relative(outDir, path32.join(dir, "desktop.png")) : null,
     mobileShot: null,
-    bundle: built ? path31.relative(outDir, path31.join(dir, "section.html")) : null,
+    bundle: built ? path32.relative(outDir, path32.join(dir, "section.html")) : null,
     fidelity,
     ...fidelityNote ? { fidelityNote } : {},
     ...built ? { cssStats: built.stats } : {},
@@ -44803,9 +44973,9 @@ async function captureMobileShots(args) {
     for (const section of sections) {
       const shot = await captureSectionOnMobile(mobile.page, section);
       if (!shot) continue;
-      const file = path31.join(sectionsDir, String(section.index).padStart(2, "0"), "mobile.png");
-      await writeFile15(file, shot);
-      section.mobileShot = path31.relative(outDir, file);
+      const file = path32.join(sectionsDir, String(section.index).padStart(2, "0"), "mobile.png");
+      await writeFile16(file, shot);
+      section.mobileShot = path32.relative(outDir, file);
     }
   } finally {
     await mobile.context.close();
@@ -44820,10 +44990,10 @@ async function captureMotionTakes(args) {
   const filmOne = async (section) => {
     const take = await captureMotionTake(browser, pageUrl, section.selector).catch(() => null);
     if (!take) return;
-    const dir = path31.join(sectionsDir, String(section.index).padStart(2, "0"));
-    const file = path31.join(dir, "motion-filmstrip.png");
-    await writeFile15(file, take.filmstrip);
-    section.motionFilmstrip = path31.relative(outDir, file);
+    const dir = path32.join(sectionsDir, String(section.index).padStart(2, "0"));
+    const file = path32.join(dir, "motion-filmstrip.png");
+    await writeFile16(file, take.filmstrip);
+    section.motionFilmstrip = path32.relative(outDir, file);
     log(`  [${section.index}] ${section.motion.summary}`);
   };
   const queue = [...moving];
@@ -44880,7 +45050,7 @@ async function captureAlternateViews(args) {
 async function reproduceWholePage(args) {
   const { browser, page, outDir, pageUrl, withCode, log } = args;
   const fullPage = await page.screenshot({ type: "png", fullPage: true }).catch(() => null);
-  if (fullPage) await writeFile15(path31.join(outDir, "full-page.png"), fullPage);
+  if (fullPage) await writeFile16(path32.join(outDir, "full-page.png"), fullPage);
   if (!withCode) return { bundle: null, fidelity: null };
   const reproduction = await reproducePage({ browser, page, outDir, pageUrl, livePageShot: fullPage });
   log(`page reproduction: ${reproduction.fidelity === null ? "unavailable" : reproduction.fidelity.toFixed(2)}`);
@@ -44951,7 +45121,7 @@ async function openViaLadder(args) {
 async function scrapeLanding(options) {
   const timeoutMs = options.timeoutMs ?? 45e3;
   const log = options.onProgress ?? (() => void 0);
-  const sectionsDir = path31.join(options.outDir, "sections");
+  const sectionsDir = path32.join(options.outDir, "sections");
   const nonPublic = refuseNonPublicUrl(options.url);
   if (nonPublic) {
     throw new BlockedPageError({
@@ -44971,7 +45141,7 @@ async function scrapeLanding(options) {
   const withMotion = options.motion !== false && !escalated;
   const renderBrowser = options.code === false ? null : await launchBrowser();
   try {
-    await mkdir10(sectionsDir, { recursive: true });
+    await mkdir11(sectionsDir, { recursive: true });
     const sections = await captureSections({
       browser: renderBrowser ?? browser,
       page,
@@ -45013,7 +45183,7 @@ async function scrapeLanding(options) {
       security: prepared.security,
       captureTier: tier
     };
-    await writeFile15(path31.join(options.outDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
+    await writeFile16(path32.join(options.outDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
 `);
     if (options.report !== false) {
       const reportPath = await writeCaptureReport(manifest, options.outDir);
@@ -45028,28 +45198,28 @@ async function scrapeLanding(options) {
 
 // src/commands/landing/inspiration/captureOut.ts
 import { existsSync as existsSync9 } from "fs";
-import path32 from "path";
+import path33 from "path";
 var SCRATCH_DIR = ".baker";
 function isWithin(parent, target) {
-  const relative = path32.relative(parent, target);
-  return relative === "" || !relative.startsWith("..") && !path32.isAbsolute(relative);
+  const relative = path33.relative(parent, target);
+  return relative === "" || !relative.startsWith("..") && !path33.isAbsolute(relative);
 }
 function findRepoRoot(from) {
-  let dir = path32.resolve(from);
+  let dir = path33.resolve(from);
   for (; ; ) {
-    if (existsSync9(path32.join(dir, ".git"))) return dir;
-    const parent = path32.dirname(dir);
+    if (existsSync9(path33.join(dir, ".git"))) return dir;
+    const parent = path33.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
 }
 function checkCaptureOut(out, options) {
   const { cwd, repoRoot } = options;
-  const resolved = path32.resolve(cwd, out);
+  const resolved = path33.resolve(cwd, out);
   if (repoRoot === null || !isWithin(repoRoot, resolved)) return { ok: true };
-  const scratch = path32.join(repoRoot, SCRATCH_DIR);
+  const scratch = path33.join(repoRoot, SCRATCH_DIR);
   if (isWithin(scratch, resolved)) return { ok: true };
-  const suggestion = path32.posix.join(SCRATCH_DIR, "teardowns", path32.basename(resolved) || "capture");
+  const suggestion = path33.posix.join(SCRATCH_DIR, "teardowns", path33.basename(resolved) || "capture");
   return {
     ok: false,
     error: {
@@ -45115,7 +45285,7 @@ registerSchema({
     report: { type: "boolean", description: "Write report.html. `--no-report` to skip", required: false }
   }
 });
-var scrapeCommand = defineCommand161({
+var scrapeCommand = defineCommand162({
   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"
@@ -45223,12 +45393,12 @@ var scrapeCommand = defineCommand161({
 });
 
 // src/commands/landing/inspiration/search.ts
-import path34 from "path";
-import { defineCommand as defineCommand162 } from "citty";
+import path35 from "path";
+import { defineCommand as defineCommand163 } from "citty";
 
 // src/commands/landing/inspiration/shot.ts
-import { mkdir as mkdir11, writeFile as writeFile16 } from "fs/promises";
-import path33 from "path";
+import { mkdir as mkdir12, writeFile as writeFile17 } from "fs/promises";
+import path34 from "path";
 import sharp6 from "sharp";
 var READABLE_SHOT = {
   maxWidth: 1440,
@@ -45254,9 +45424,9 @@ async function downloadReadableShot(url, file) {
     const response = await fetch(url);
     if (!response.ok) return null;
     const shot = await toReadableShot(Buffer.from(await response.arrayBuffer()));
-    await mkdir11(path33.dirname(file), { recursive: true });
-    await writeFile16(file, shot);
-    return path33.relative(process.cwd(), file);
+    await mkdir12(path34.dirname(file), { recursive: true });
+    await writeFile17(file, shot);
+    return path34.relative(process.cwd(), file);
   } catch {
     return null;
   }
@@ -45348,20 +45518,20 @@ function buildSearchBody(args) {
   return body;
 }
 async function downloadShots(results) {
-  const dir = path34.join(process.cwd(), ".baker", "inspiration");
+  const dir = path35.join(process.cwd(), ".baker", "inspiration");
   const saved = /* @__PURE__ */ new Map();
   await Promise.all(
     results.map(async (result) => {
       const file = await downloadReadableShot(
         result.desktopShotUrl,
-        path34.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
+        path35.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
       );
       if (file) saved.set(result.id, file);
     })
   );
   return saved;
 }
-var searchCommand2 = defineCommand162({
+var searchCommand2 = defineCommand163({
   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"
@@ -45459,7 +45629,7 @@ var searchCommand2 = defineCommand162({
 });
 
 // src/commands/landing/inspiration/sequences.ts
-import { defineCommand as defineCommand163 } from "citty";
+import { defineCommand as defineCommand164 } from "citty";
 var COMPACT_TRANSITIONS = 12;
 var COMPACT_ENDS = 5;
 var MAX_PAGES = 50;
@@ -45533,7 +45703,7 @@ function sequencesHints(data, { scope, full }) {
   if (scope === "favorites") hints.push(...favoritesScopeHints(data.favoritesHealth, data.pagesReturned));
   return hints;
 }
-var sequencesCommand = defineCommand163({
+var sequencesCommand = defineCommand164({
   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."
@@ -45582,8 +45752,8 @@ var sequencesCommand = defineCommand163({
 });
 
 // src/commands/landing/inspiration/view.ts
-import path35 from "path";
-import { defineCommand as defineCommand164 } from "citty";
+import path36 from "path";
+import { defineCommand as defineCommand165 } 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.",
@@ -45596,7 +45766,7 @@ registerSchema({
     }
   }
 });
-var viewCommand2 = defineCommand164({
+var viewCommand2 = defineCommand165({
   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."
@@ -45615,12 +45785,12 @@ var viewCommand2 = defineCommand164({
       const id = args.id;
       const data = await apiGet("/api/landing-inspiration/section", { id });
       const section = data.section;
-      const dir = path35.join(process.cwd(), ".baker", "inspiration", id);
+      const dir = path36.join(process.cwd(), ".baker", "inspiration", id);
       const ext = READABLE_SHOT.extension;
       const [desktop, mobile, filmstrip] = await Promise.all([
-        downloadReadableShot(section.desktopShotUrl, path35.join(dir, `desktop.${ext}`)),
-        downloadReadableShot(section.mobileShotUrl, path35.join(dir, `mobile.${ext}`)),
-        downloadReadableShot(section.motionFilmstripUrl, path35.join(dir, `motion-filmstrip.${ext}`))
+        downloadReadableShot(section.desktopShotUrl, path36.join(dir, `desktop.${ext}`)),
+        downloadReadableShot(section.mobileShotUrl, path36.join(dir, `mobile.${ext}`)),
+        downloadReadableShot(section.motionFilmstripUrl, path36.join(dir, `motion-filmstrip.${ext}`))
       ]);
       const full = args.full;
       const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
@@ -45680,7 +45850,7 @@ var viewCommand2 = defineCommand164({
 });
 
 // src/commands/landing/inspiration/index.ts
-var inspirationCommand = defineCommand165({
+var inspirationCommand = defineCommand166({
   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.
@@ -45725,7 +45895,7 @@ Full guide: __tooling__/docs/tools/baker/landing.md`
 });
 
 // src/commands/landing/index.ts
-var landingCommand = defineCommand166({
+var landingCommand = defineCommand167({
   meta: {
     name: "landing",
     description: `Design-quality tools for landing pages (src/pages/<slug>/).
@@ -45743,7 +45913,7 @@ Subcommands:
 });
 
 // src/commands/mcp/index.ts
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand168 } from "citty";
 
 // src/commands/mcp/platforms.ts
 function readsKey(label) {
@@ -45812,7 +45982,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 = defineCommand167({
+var connectedCommand = defineCommand168({
   meta: {
     name: "connected",
     description: `Everything this chat can reach \u2014 managed integrations, custom MCP servers, and connected platforms.
@@ -45871,7 +46041,7 @@ registerSchema({
   description: "List the custom MCP servers this company's chats see (org + company + your own user scope).",
   args: {}
 });
-var listCommand14 = defineCommand167({
+var listCommand14 = defineCommand168({
   meta: { name: "list", description: "List custom MCP servers visible to this company's chats." },
   run: async () => {
     try {
@@ -45908,7 +46078,7 @@ registerSchema({
     header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
   }
 });
-var addCommand2 = defineCommand167({
+var addCommand2 = defineCommand168({
   meta: {
     name: "add",
     description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.
@@ -45960,7 +46130,7 @@ registerSchema({
   description: "Remove a company custom MCP server by name.",
   args: { name: { type: "string", description: "Server name to remove", required: true } }
 });
-var removeCommand4 = defineCommand167({
+var removeCommand4 = defineCommand168({
   meta: {
     name: "remove",
     description: `Remove a company custom MCP server by name.
@@ -45982,7 +46152,7 @@ Example:
     }
   }
 });
-var mcpCommand = defineCommand167({
+var mcpCommand = defineCommand168({
   meta: {
     name: "mcp",
     description: `Third-party tools for this company \u2014 see what's connected, register custom HTTPS MCP endpoints.
@@ -46008,10 +46178,10 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand179 } from "citty";
+import { defineCommand as defineCommand180 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand169 } 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.';
@@ -46194,7 +46364,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand168({
+var advertisersCommand = defineCommand169({
   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).
@@ -46250,7 +46420,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand170 } 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).",
@@ -46273,7 +46443,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand169({
+var autocompleteCommand = defineCommand170({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -46328,7 +46498,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -46385,7 +46555,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand170({
+var countriesCommand = defineCommand171({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -46396,7 +46566,7 @@ var countriesCommand = defineCommand170({
 });
 
 // src/commands/research/fetch.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 var CONTENT_PREVIEW_CHARS = 2e4;
 var TIMEOUT_MS = 18e4;
 registerSchema({
@@ -46469,7 +46639,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 = defineCommand171({
+var fetchCommand = defineCommand172({
   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.
@@ -46546,7 +46716,7 @@ Examples:
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand173 } 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.",
@@ -46569,7 +46739,7 @@ var FIELDS7 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand172({
+var intentCommand = defineCommand173({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -46617,7 +46787,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand174 } 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.",
@@ -46646,7 +46816,7 @@ var FIELDS8 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand173({
+var keywordGapCommand = defineCommand174({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -46721,7 +46891,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand174 } from "citty";
+import { defineCommand as defineCommand175 } 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.",
@@ -46754,7 +46924,7 @@ var FIELDS9 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand174({
+var keywordsForSiteCommand = defineCommand175({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -46816,7 +46986,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand175 } from "citty";
+import { defineCommand as defineCommand176 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -46846,7 +47016,7 @@ var FIELDS10 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand175({
+var languagesCommand2 = defineCommand176({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -46857,7 +47027,7 @@ var languagesCommand2 = defineCommand175({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand176 } from "citty";
+import { defineCommand as defineCommand177 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -46876,7 +47046,7 @@ var FIELDS11 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand176({
+var lighthouseCommand = defineCommand177({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -46914,7 +47084,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand178 } 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).",
@@ -46940,7 +47110,7 @@ var FIELDS12 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand177({
+var relevantPagesCommand = defineCommand178({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -46987,7 +47157,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand178 } from "citty";
+import { defineCommand as defineCommand179 } 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).",
@@ -47038,7 +47208,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand178({
+var webCommand = defineCommand179({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -47100,7 +47270,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand179({
+var researchCommand = defineCommand180({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -47144,10 +47314,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand187 } from "citty";
+import { defineCommand as defineCommand188 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand180 } from "citty";
+import { defineCommand as defineCommand181 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -47294,7 +47464,7 @@ registerSchema({
     }
   }
 });
-var createCommand3 = defineCommand180({
+var createCommand3 = defineCommand181({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -47353,7 +47523,7 @@ var createCommand3 = defineCommand180({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand181 } from "citty";
+import { defineCommand as defineCommand182 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -47361,7 +47531,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand3 = defineCommand181({
+var deleteCommand3 = defineCommand182({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -47390,7 +47560,7 @@ var deleteCommand3 = defineCommand181({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand182 } from "citty";
+import { defineCommand as defineCommand183 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -47399,7 +47569,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand4 = defineCommand182({
+var getCommand4 = defineCommand183({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -47438,7 +47608,7 @@ var getCommand4 = defineCommand182({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand183 } from "citty";
+import { defineCommand as defineCommand184 } 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.",
@@ -47446,7 +47616,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var listCommand15 = defineCommand183({
+var listCommand15 = defineCommand184({
   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."
@@ -47469,9 +47639,9 @@ var listCommand15 = defineCommand183({
 });
 
 // src/commands/scheduled-actions/templates.ts
-import { readFile as readFile22 } from "fs/promises";
-import path36 from "path";
-import { defineCommand as defineCommand184 } from "citty";
+import { readFile as readFile23 } from "fs/promises";
+import path37 from "path";
+import { defineCommand as defineCommand185 } 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.",
@@ -47526,7 +47696,7 @@ registerSchema({
     }
   }
 });
-var templatesCommand = defineCommand184({
+var templatesCommand = defineCommand185({
   meta: {
     name: "templates",
     description: `The recipes this company can run \u2014 Baker's own plus theirs, with what each one produces.
@@ -47573,7 +47743,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
       }
       if (save.length > 0) {
         const briefFile = flag("brief-file");
-        const brief = briefFile.length > 0 ? await readFile22(path36.resolve(briefFile), "utf8") : flag("brief");
+        const brief = briefFile.length > 0 ? await readFile23(path37.resolve(briefFile), "utf8") : flag("brief");
         if (brief.trim().length === 0) {
           failValidation4("--brief-file (preferred) or --brief is required: the brief is the recipe.");
         }
@@ -47618,7 +47788,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand185 } from "citty";
+import { defineCommand as defineCommand186 } 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.",
@@ -47626,7 +47796,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand185({
+var triggerCommand = defineCommand186({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -47663,7 +47833,7 @@ var triggerCommand = defineCommand185({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand186 } from "citty";
+import { defineCommand as defineCommand187 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -47694,7 +47864,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand3 = defineCommand186({
+var updateCommand3 = defineCommand187({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Examples: baker scheduled-actions update <id> --enabled false | baker scheduled-actions update <id> --mode publish"
@@ -47772,7 +47942,7 @@ var updateCommand3 = defineCommand186({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand187({
+var scheduledActionsCommand = defineCommand188({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger, templates.
@@ -47801,14 +47971,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand188 } from "citty";
+import { defineCommand as defineCommand189 } 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 = defineCommand188({
+var schemaCommand2 = defineCommand189({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -47852,10 +48022,10 @@ var schemaCommand2 = defineCommand188({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand189 } from "citty";
+import { defineCommand as defineCommand190 } from "citty";
 
 // src/commands/studio/batch.ts
 function projectBatch(generation, full) {
@@ -48044,7 +48214,7 @@ function parseImageRefs(spec) {
 }
 var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path38) => uploadLocalImage({ file: path38, contentType: detectImageContentType(path38), source: "uploaded" })
+  upload: (path39) => uploadLocalImage({ file: path39, contentType: detectImageContentType(path39), source: "uploaded" })
 };
 async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
@@ -48064,10 +48234,10 @@ async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   }
   return { imageIds, added };
 }
-function uploadFailure(path38) {
+function uploadFailure(path39) {
   return (error) => {
     if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path38}" as an image.`);
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path39}" as an image.`);
   };
 }
 
@@ -48090,7 +48260,7 @@ registerSchema({
     },
     image: {
       type: "string",
-      description: "Comma-separated source images: library image ids, local file paths, and/or image URLs. Required unless --from text. With the default --from frame this must be exactly ONE image (the opening frame) \u2014 several are refused rather than silently reduced to the first. With --from references, up to 9 on Seedance 2.0 and 30 on Seedance 2.5.",
+      description: "Comma-separated source images: library image ids, local file paths, and/or image URLs. Required unless --from text or --avatar (the avatar is the source). With the default --from frame this must be exactly ONE image (the opening frame) \u2014 several are refused rather than silently reduced to the first. With --from references, up to 9 on Seedance 2.0 and 30 on Seedance 2.5.",
       required: false
     },
     from: {
@@ -48306,13 +48476,18 @@ function costHintsFor(body) {
   }
   return hints;
 }
-var animateCommand = defineCommand189({
+var animateCommand = defineCommand190({
   meta: {
     name: "animate",
-    description: "Render a clip. With an image the look is already fixed, so the prompt describes MOVEMENT \u2014 what the camera does, what the subject does, in what order. With --from text there is no image and the prompt is the whole shot.\n\nA rendered clip is NOT usable anywhere until you keep it: `baker studio keep <id> --slot N` is what puts it in the video library. Takes nobody keeps are never ingested, which is what makes a rejected batch cheap.\n\nFor anything longer than 15 seconds, or to build on footage that already exists, use --model bytedance/seedance-2.5: it renders 4-30s and is the only model that reads an existing clip or an existing soundtrack.\n\nExamples:\n  baker studio animate 'slow push in, model turns to camera and smiles' --image j57abc123def456ghi789\n  baker studio animate 'handheld drift right, steam rising from the cup' --image './out/hero.png' --duration 6 --quality 1080p\n  baker studio animate 'product rotates once on a turntable' --image j57abc\u2026,j57def\u2026 --from references\n  baker studio animate 'she keeps walking, camera stays with her, then she stops and looks up' --image j57abc\u2026 --from references --from-clip j57batch\u2026:0 --model bytedance/seedance-2.5 --duration 20\n  baker studio animate 'hold on the product, then a slow push-in' --from references --from-video j57vid\u2026 --model bytedance/seedance-2.5\n  baker studio animate 'slow drone pull-back over a solar farm at golden hour, no people' --from text --model bytedance/seedance-2.5 --duration 12"
+    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"
   },
   args: {
     prompt: { type: "positional", description: "What MOVES", required: false },
+    avatar: {
+      type: "string",
+      description: "Cast an avatar by short name \u2014 grounds the clip on their identity sheet AND gives it their voice",
+      required: false
+    },
     image: {
       type: "string",
       description: "Comma-separated library image ids, local file paths, and/or image URLs",
@@ -48377,13 +48552,13 @@ var animateCommand = defineCommand189({
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A prompt is required" } });
         process.exit(1);
       }
-      if (!args.image && args.from !== "text") {
+      if (!args.image && !args.avatar && args.from !== "text") {
         writeJson({
           ok: false,
           error: {
             code: "VALIDATION_ERROR",
-            message: "--image is required unless you pass --from text: a clip normally animates a still, so it needs the image to start from",
-            fix: "Pass --image <id|path|url>, or --from text to render from the prompt alone."
+            message: "--image is required unless you pass --from text or --avatar: a clip normally animates a still, so it needs the image to start from",
+            fix: "Pass --image <id|path|url>, --avatar <handle> to build the shot around one of your avatars, or --from text to render from the prompt alone."
           }
         });
         process.exit(1);
@@ -48425,7 +48600,7 @@ var animateCommand = defineCommand189({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand191 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -48561,12 +48736,17 @@ function buildGenerateBody(args, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand190({
+var generateCommand = defineCommand191({
   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]]'"
   },
   args: {
+    avatar: {
+      type: "string",
+      description: "Cast an avatar by short name \u2014 grounds the image on their identity sheet",
+      required: false
+    },
     prompt: { type: "positional", description: "What to generate", required: false },
     model: { type: "string", description: "Model id (default google/gemini-3.1-flash-image-preview)", required: false },
     "aspect-ratio": { type: "string", description: "Aspect ratio (default 1:1)", required: false },
@@ -48639,7 +48819,7 @@ var generateCommand = defineCommand190({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand192 } 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.",
@@ -48648,7 +48828,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand191({
+var getCommand5 = defineCommand192({
   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"
@@ -48677,7 +48857,7 @@ var getCommand5 = defineCommand191({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand193 } 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",
@@ -48702,7 +48882,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand192({
+var improveCommand = defineCommand193({
   meta: {
     name: "improve",
     description: `${DESCRIPTION}
@@ -48746,7 +48926,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand194 } 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.",
@@ -48756,7 +48936,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand193({
+var keepCommand = defineCommand194({
   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"
@@ -48807,7 +48987,7 @@ var keepCommand = defineCommand193({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand195 } 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.",
@@ -48818,7 +48998,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand16 = defineCommand194({
+var listCommand16 = defineCommand195({
   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"
@@ -48852,7 +49032,7 @@ var listCommand16 = defineCommand194({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand196 } 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",
@@ -48939,7 +49119,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand195({
+var modelsCommand = defineCommand196({
   meta: {
     name: "models",
     description: `${DESCRIPTION2}
@@ -48986,13 +49166,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand196 } from "citty";
+import { defineCommand as defineCommand197 } 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 = defineCommand196({
+var skillsCommand = defineCommand197({
   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"
@@ -49016,7 +49196,7 @@ var skillsCommand = defineCommand196({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand197({
+var studioCommand = defineCommand198({
   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.
@@ -49059,10 +49239,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand202 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand199 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync15 } from "fs";
@@ -49129,10 +49309,10 @@ async function stageOp4(op) {
     handleError5(err);
   }
 }
-async function draftAction3(path38, body, chat) {
+async function draftAction3(path39, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path38, { chatId, ...body });
+    const data = await apiPost(path39, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -49185,13 +49365,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand4 = defineCommand198({
+var draftCommand4 = defineCommand199({
   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: defineCommand198({
+    list: defineCommand199({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -49204,7 +49384,7 @@ var draftCommand4 = defineCommand198({
         await draftList2(args.json === true, args.chat);
       }
     }),
-    show: defineCommand198({
+    show: defineCommand199({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -49221,7 +49401,7 @@ var draftCommand4 = defineCommand198({
         );
       }
     }),
-    amend: defineCommand198({
+    amend: defineCommand199({
       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."
@@ -49238,7 +49418,7 @@ var draftCommand4 = defineCommand198({
         });
       }
     }),
-    remove: defineCommand198({
+    remove: defineCommand199({
       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 }) => {
@@ -49247,7 +49427,7 @@ var draftCommand4 = defineCommand198({
         });
       }
     }),
-    clear: defineCommand198({
+    clear: defineCommand199({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -49257,7 +49437,7 @@ var draftCommand4 = defineCommand198({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand200 } 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.",
@@ -49298,7 +49478,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand199({
+var containersCommand = defineCommand200({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -49315,7 +49495,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand199({
+var readCommand = defineCommand200({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -49357,7 +49537,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand201 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -49413,10 +49593,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand200({
+  return defineCommand201({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand200({
+      create: defineCommand201({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -49438,7 +49618,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand200({
+      update: defineCommand201({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -49458,7 +49638,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand200({
+      delete: defineCommand201({
         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 },
@@ -49499,7 +49679,7 @@ function builtinTypes(args) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand200({
+var builtinCommand = defineCommand201({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -49509,7 +49689,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand200({
+    enable: defineCommand201({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -49523,7 +49703,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand200({
+    disable: defineCommand201({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -49541,7 +49721,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand201({
+var tagManagerCommand = defineCommand202({
   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.
@@ -49578,7 +49758,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand203 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -49647,7 +49827,7 @@ async function listTags(json) {
 var listArgs9 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand17 = defineCommand202({
+var listCommand17 = defineCommand203({
   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"
@@ -49666,7 +49846,7 @@ async function listDraft3(chat) {
     failApi3(err);
   }
 }
-var draftCommand5 = defineCommand202({
+var draftCommand5 = defineCommand203({
   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."
@@ -49676,7 +49856,7 @@ var draftCommand5 = defineCommand202({
     await listDraft3(args.chat);
   }
 });
-var tagsCommand4 = defineCommand202({
+var tagsCommand4 = defineCommand203({
   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.
@@ -49705,10 +49885,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand207 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand203 } from "citty";
+import { defineCommand as defineCommand204 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -49716,7 +49896,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand203({
+var getCommand6 = defineCommand204({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -49753,7 +49933,7 @@ var getCommand6 = defineCommand203({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand205 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -49888,7 +50068,7 @@ function buildListParams(args) {
   }
   return params;
 }
-var listCommand18 = defineCommand204({
+var listCommand18 = defineCommand205({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -49940,7 +50120,7 @@ var listCommand18 = defineCommand204({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand206 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -50019,7 +50199,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand3 = defineCommand205({
+var searchCommand3 = defineCommand206({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -50083,7 +50263,7 @@ var searchCommand3 = defineCommand205({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand206({
+var testimonialsCommand = defineCommand207({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -50105,10 +50285,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand214 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand208 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -50122,7 +50302,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand207({
+var deleteCommand4 = defineCommand208({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -50163,7 +50343,7 @@ var deleteCommand4 = defineCommand207({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand209 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -50171,7 +50351,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand208({
+var getCommand7 = defineCommand209({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -50208,7 +50388,7 @@ var getCommand7 = defineCommand208({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand209 } from "citty";
+import { defineCommand as defineCommand210 } 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)",
@@ -50217,7 +50397,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand209({
+var groupCommand2 = defineCommand210({
   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>"
@@ -50239,8 +50419,8 @@ var groupCommand2 = defineCommand209({
 // src/commands/videos/ingest.ts
 import { mkdtemp as mkdtemp2, rm as rm7, stat as stat7 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import path37 from "path";
-import { defineCommand as defineCommand210 } from "citty";
+import path38 from "path";
+import { defineCommand as defineCommand211 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -50404,7 +50584,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand210({
+var ingestCommand2 = defineCommand211({
   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"
@@ -50590,7 +50770,7 @@ function ingestUrl(args) {
 }
 async function downloadThenIngest(args, country) {
   const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp2(path37.join(tmpdir3(), "videos-ingest-"));
+  const workDir = await mkdtemp2(path38.join(tmpdir3(), "videos-ingest-"));
   try {
     const probe = await probeYtDlp({ url: args.url, country, vimeoCookie, cookieDir: workDir });
     if (isAudioOnly(probe.info)) {
@@ -50666,7 +50846,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -50676,7 +50856,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand211({
+var searchCommand4 = defineCommand212({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -50726,9 +50906,9 @@ var searchCommand4 = defineCommand211({
 var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 
 // src/commands/videos/upload.ts
-import { readFile as readFile23, stat as stat8 } from "fs/promises";
+import { readFile as readFile24, stat as stat8 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -50770,7 +50950,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand212({
+var uploadCommand2 = defineCommand213({
   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"
@@ -50823,7 +51003,7 @@ var uploadCommand2 = defineCommand212({
         originalFilename,
         descriptionContext
       });
-      const fileBuffer = await readFile23(filePath);
+      const fileBuffer = await readFile24(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -50854,7 +51034,7 @@ var uploadCommand2 = defineCommand212({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand213({
+var videosCommand = defineCommand214({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, delete, tags.
@@ -50881,10 +51061,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList2(value) {
@@ -50937,7 +51117,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand214({
+var advertisersCommand2 = defineCommand215({
   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'
@@ -50995,7 +51175,7 @@ var advertisersCommand2 = defineCommand214({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } 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.",
@@ -51041,7 +51221,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand215({
+var briefCommand = defineCommand216({
   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`
@@ -51077,7 +51257,7 @@ var briefCommand = defineCommand215({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } 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.",
@@ -51090,7 +51270,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand216({
+var contentCommand = defineCommand217({
   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"
@@ -51139,7 +51319,7 @@ var contentCommand = defineCommand216({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList2(input.advertiser);
@@ -51191,7 +51371,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand217({
+var feedCommand = defineCommand218({
   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"
@@ -51276,7 +51456,7 @@ var feedCommand = defineCommand217({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand219 } from "citty";
 var PLATFORMS = ["meta", "linkedin"];
 registerSchema({
   command: "winning-ads.follow",
@@ -51291,7 +51471,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand218({
+var followCommand = defineCommand219({
   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 both Meta + LinkedIn. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -51338,7 +51518,7 @@ var followCommand = defineCommand218({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 var PLATFORMS2 = ["meta", "linkedin"];
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -51371,7 +51551,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand219({
+var followCompetitorsCommand = defineCommand220({
   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"'
@@ -51446,7 +51626,7 @@ var followCompetitorsCommand = defineCommand219({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand221 } 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.",
@@ -51500,7 +51680,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand220({
+var followingCommand = defineCommand221({
   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"
@@ -51536,7 +51716,7 @@ var followingCommand = defineCommand220({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand222 } 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.",
@@ -51575,7 +51755,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand221({
+var patternsCommand = defineCommand222({
   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"
@@ -51631,7 +51811,7 @@ var patternsCommand = defineCommand221({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand223 } 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.",
@@ -51739,7 +51919,7 @@ function buildSearchBody2(args) {
   }
   return body;
 }
-var searchCommand5 = defineCommand222({
+var searchCommand5 = defineCommand223({
   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"
@@ -51854,7 +52034,7 @@ var searchCommand5 = defineCommand222({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -51882,7 +52062,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand223({
+  return defineCommand224({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -51931,7 +52111,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -51939,7 +52119,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand224({
+var unfollowCommand = defineCommand225({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -51960,7 +52140,7 @@ var unfollowCommand = defineCommand224({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand226 } 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.",
@@ -51970,7 +52150,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand225({
+var winnersCommand = defineCommand226({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -52020,7 +52200,7 @@ var winnersCommand = defineCommand225({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand226({
+var winningAdsCommand = defineCommand227({
   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.
@@ -52210,7 +52390,7 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion) {
   };
 }
 function commandPathOf(root, argv) {
-  const path38 = [];
+  const path39 = [];
   let command = root;
   for (const token of argv) {
     if (token === "--" || token.startsWith("-")) {
@@ -52221,10 +52401,10 @@ function commandPathOf(root, argv) {
     if (next === void 0 || typeof next !== "object") {
       break;
     }
-    path38.push(token);
+    path39.push(token);
     command = next;
   }
-  return path38.join(" ");
+  return path39.join(" ");
 }
 function refuseUnknownFlags(root, argv) {
   const unknown = findUnknownFlags(root, argv);
@@ -52258,7 +52438,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand227({
+var main = defineCommand228({
   meta: {
     name: "baker",
     version: getCliVersion(),