@koda-sl/baker-cli 0.380.0-dev.d26778d3f → 0.381.0-dev.3442c3753

package/dist/cli.js

@@ -133,7 +133,7 @@ import {
 } from "./chunk-7YNOGIWQ.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand255, runMain } from "citty";
+import { defineCommand as defineCommand256, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -5111,6 +5111,20 @@ var FLOW_SIDE_EFFECT_CATALOG = [
     reference: SIDE_EFFECT_REF("httpWebhook")
   },
   crmSideEffect("googleSpreadsheet", "Appends a row to a Google Sheet.", "columnMapping", MAP_FIRST),
+  {
+    kind: "side-effect",
+    type: "shopifyCustomer",
+    summary: "Adds a sign-up to the connected Shopify store with the consent they ticked.",
+    skeleton: {
+      ...SIDE_EFFECT_ENVELOPE,
+      type: "shopifyCustomer",
+      customer: { email: null, phone: null, acceptsEmailMarketing: null, acceptsSmsMarketing: null },
+      offer: null
+    },
+    owners: { customer: "agent", offer: "agent" },
+    gotcha: "Map email to an email field with baker flows map. Email and SMS consent each need their own optional, visible, initially unticked checkbox; SMS also needs phone. No connection secret is needed. An optional offer names a published sign-up offer; read baker shopify signup-offers. Show its code with ShopifySignupCode.",
+    reference: SIDE_EFFECT_REF("shopifyCustomer")
+  },
   crmSideEffect("hubspotForm", "Submits to a HubSpot form endpoint.", "fieldMapping", MAP_FIRST),
   crmSideEffect("pipedrive", "Creates or updates a Pipedrive record.", "fieldMapping", MAP_FIRST),
   crmSideEffect("goHighlevelContact", "Creates or updates a GoHighLevel contact.", "fieldMapping", MAP_FIRST),
@@ -7099,6 +7113,69 @@ var STORE_EVENTS = {
   }
 };
 var STORE_EVENT_NAMES = Object.keys(STORE_EVENTS);
+var STORE_FIELD_LABELS = {
+  baker_source: "Comes from",
+  store: "Store",
+  title: "Product",
+  handle: "Product address",
+  status: "Status",
+  published: "On the store",
+  price: "Price",
+  price_max: "Highest price",
+  currency: "Currency",
+  collections: "Collections",
+  tags: "Tags",
+  product_type: "Product type",
+  vendor: "Brand",
+  product_url: "Product page",
+  whole_product: "Whole product out of stock",
+  options_out: "Options out of stock",
+  options_out_count: "How many options are out",
+  options_count: "How many options it has",
+  promoted_by: "Ads found",
+  promotions_checked: "Where Baker looked for ads",
+  whole_product_was_out: "Whole product was out of stock",
+  options_back: "Options back in stock",
+  still_out_count: "Options still out of stock",
+  stock_holds: "Ads Baker paused",
+  reason: "Why",
+  changed: "What changed",
+  before_title: "Name before",
+  before_price: "Price before",
+  before_status: "Status before",
+  before_published: "On the store before",
+  price_changes: "Price changes",
+  collection: "Collection",
+  product_count: "Products",
+  before_product_count: "Products before",
+  order_name: "Order",
+  ordered_at: "Ordered at",
+  shopify_source: "Sold through",
+  visitor_from: "Shopper came from",
+  campaign_from: "Campaign",
+  customer: "Customer",
+  country: "Country",
+  accepts_email: "Accepts email",
+  orders: "Orders",
+  account_state: "Account",
+  total: "Total",
+  items_count: "Items",
+  products: "Products",
+  product_handles: "Product addresses",
+  known_customer: "Known customer",
+  discount_codes_count: "Discount codes",
+  started_at: "Started at",
+  last_activity_at: "Last active at",
+  window_hours: "Hours looked at",
+  window_start: "From",
+  window_end: "To",
+  expected_orders: "Usual orders",
+  revenue: "Sales",
+  expected_revenue: "Usual sales",
+  drop_percent: "Drop (%)",
+  baseline_days: "Days compared"
+};
+var FIELD_LABELS = new Map(Object.entries(STORE_FIELD_LABELS));
 
 // ../api/src/scheduledAgentRules.ts
 var CONDITION_OPERATORS = {
@@ -8541,9 +8618,9 @@ function parsePriority(value, { allowClear }) {
     `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
   );
 }
-function looksScheduled(name, description) {
+function looksScheduled(name, description2) {
   const haystack = fold(`${name}
-${description}`);
+${description2}`);
   return SCHEDULE_SIGNALS.some((re2) => re2.test(haystack));
 }
 var CAMPAIGN_ENTITY = String.raw`(?:campaigns?|campanas?|ad\s*sets?|adsets?|ad\s*groups?|adgroups?|ads?|anuncios?|conjuntos?\s+de\s+anuncios|grupos?\s+de\s+anuncios)`;
@@ -8701,10 +8778,10 @@ var SURFACE_RULES = [
 var FAN_OUT_NUDGE_THRESHOLD = 2;
 var FAN_OUT_THRESHOLD = 3;
 var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled agent instead \u2014 baker scheduled-agents create --cron "0 9 * * MON" (or --run-at, or --trigger for a reaction rather than a clock; guide: `__tooling__/docs/tools/baker/scheduled-agents.md`). Do not capture "set up a schedule" as a Work Action.';
-function looksExecutable(name, description) {
+function looksExecutable(name, description2) {
   const foldedName = fold(name);
   const full = `${foldedName}
-${fold(description)}`;
+${fold(description2)}`;
   for (const rule of SURFACE_RULES) {
     const haystack = rule.nameOnly ? foldedName : full;
     if (rule.except?.some((re2) => re2.test(full))) {
@@ -8724,7 +8801,7 @@ ${fold(description)}`;
 }
 function buildCreateHints({
   name,
-  description,
+  description: description2,
   tempId,
   tags,
   prioritySet,
@@ -8732,13 +8809,13 @@ function buildCreateHints({
 }) {
   const hints2 = [];
   const expanded = shellExpandedIn(`${name}
-${description}`);
+${description2}`);
   if (expanded) {
     hints2.push(
       `The text says \u201C${expanded}\u201D: the shell replaced a $ amount (like $0) inside double quotes before Baker saw it. Fix it now: baker actions update ${tempId} --description '<the text, with the amounts as you read them>' (and --name '\u2026' if the name has it) \u2014 single quotes keep $ as written.`
     );
   }
-  const advisory = advisoryHint(name, description);
+  const advisory = advisoryHint(name, description2);
   if (advisory) {
     hints2.push(
       `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
@@ -8754,7 +8831,7 @@ ${description}`);
     );
   }
   hints2.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
-  if (!description) {
+  if (!description2) {
     hints2.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
   }
   if (!tags || tags.length === 0) {
@@ -8772,11 +8849,11 @@ ${description}`);
 function shellExpandedIn(text2) {
   return /(?:^|[\s(])((?:\/usr)?\/bin\/(?:ba|z|da|k)?sh|-?(?:ba|z|da|k)sh)\b/.exec(text2)?.[1] ?? null;
 }
-function advisoryHint(name, description) {
-  if (looksScheduled(name, description)) {
+function advisoryHint(name, description2) {
+  if (looksScheduled(name, description2)) {
     return { kind: "scheduled", hint: SCHEDULED_HINT };
   }
-  const executable = looksExecutable(name, description);
+  const executable = looksExecutable(name, description2);
   return executable ? { kind: "executable", ...executable } : null;
 }
 var ACTIONS_LIST_DEFAULT_LIMIT = 500;
@@ -8862,9 +8939,9 @@ function parseSkillFrontmatter(md) {
   const lines = extractFrontmatterLines(md);
   if (!lines) return null;
   const name = readField(lines, "name");
-  const description = readField(lines, "description");
-  if (!name || !description) return null;
-  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
+  const description2 = readField(lines, "description");
+  if (!name || !description2) return null;
+  const trimmed = description2.length > DESCRIPTION_MAX ? `${description2.slice(0, DESCRIPTION_MAX)}\u2026` : description2;
   return { name, description: trimmed };
 }
 function findSkillsDir(startDir) {
@@ -14989,6 +15066,7 @@ var DESTINATION_NAMES = {
   googleSpreadsheet: "Google Sheets",
   hubspotForm: "HubSpot Form",
   goHighlevelContact: "GoHighLevel",
+  shopifyCustomer: "Shopify",
   crmble: "Crmble"
 };
 function destinationKey(type) {
@@ -19550,9 +19628,9 @@ var assetGroupsCommand = defineCommand31({
     ])
   }
 });
-function fileCreateCommand(name, kind, description, hints2) {
+function fileCreateCommand(name, kind, description2, hints2) {
   return defineCommand31({
-    meta: { name, description },
+    meta: { name, description: description2 },
     args: { ...customerIdArg, ...fileArg },
     run: async ({ args: args5 }) => {
       const customerId = requireCustomerId(args5);
@@ -37870,8 +37948,8 @@ function castAvatarsOnElements(elementsInput, avatars) {
     if (!avatar) return el;
     next += 1;
     if (el.label) byLabel.set(el.label, avatar);
-    const description = avatar.subjectDescription?.trim();
-    return { ...el, ...description ? { description } : {}, source_image: avatar.sheetUrl, source_is_sheet: true };
+    const description2 = avatar.subjectDescription?.trim();
+    return { ...el, ...description2 ? { description: description2 } : {}, source_image: avatar.sheetUrl, source_is_sheet: true };
   });
   return cast.map((el) => {
     const avatar = el.same_as ? byLabel.get(el.same_as) : void 0;
@@ -38166,7 +38244,7 @@ function buildFramePrompt(edge, sceneIndex, framePrompt, present2, hasAnchor, mo
       "- ORIGINAL_FRAME \u2014 use ONLY for composition: framing, camera angle, shot size, subject placement, pose, and proportions. IGNORE its text, logo, brand name, colors, AND the identity of every person/animal/object in it \u2014 those come from the labeled reference images above, never from this frame. It is a DIFFERENT brand's footage with DIFFERENT actors, here ONLY to anchor where things sit and how the shot is framed (e.g. a profile/side angle stays a profile/side angle), never who they are or what palette to use."
     ] : []
   ].join("\n");
-  const description = framePrompt?.trim() || `the ${edge} frame of scene ${sceneIndex + 1} \u2014 describe the full composition, subjects, setting, action, lighting, and palette here. (Edit this line to change ONLY this frame.)`;
+  const description2 = framePrompt?.trim() || `the ${edge} frame of scene ${sceneIndex + 1} \u2014 describe the full composition, subjects, setting, action, lighting, and palette here. (Edit this line to change ONLY this frame.)`;
   const isHookFrame = sceneIndex === 0 && edge === "start";
   const cleanPlateBlock = [
     "CRITICAL \u2014 RENDER A CLEAN PLATE WITH ZERO TEXT OR GRAPHIC OVERLAYS:",
@@ -38244,7 +38322,7 @@ function buildFramePrompt(edge, sceneIndex, framePrompt, present2, hasAnchor, mo
       ""
     ] : [],
     "FRAME DESCRIPTION (this frame's editable prompt):",
-    description,
+    description2,
     "",
     "Render exactly what the FRAME DESCRIPTION and the SHARED AD SPEC specify \u2014 this is the authoritative ad: its cast identity (via the reference images), palette, brand, and intent are law. Keep every recurring element identical to its reference image across all frames. Again: clean plate only \u2014 no rendered text, and no icons/stickers/emojis/badges (those live on the overlay layer).",
     "",
@@ -39100,8 +39178,8 @@ function localizeNumeralsForNative(text2, langCode) {
   if (!langCode || !INTEGER_SPELLERS[langCode]) return text2;
   return text2.replace(/(?<![\w.,-])\d{1,9}(?![\w.,-])/g, (m) => spellNumber(langCode, Number.parseInt(m, 10)));
 }
-function parseVoiceTraits(description) {
-  const d = description.toLowerCase();
+function parseVoiceTraits(description2) {
+  const d = description2.toLowerCase();
   const out = {};
   if (/\b(female|woman|women|girl|lady)\b/.test(d)) out.gender = "female";
   else if (/\b(male|man|men|guy|boy)\b/.test(d)) out.gender = "male";
@@ -39312,11 +39390,11 @@ function makeVoiceFactory(blueprint, canonical2, nodes, voiceLanguage, pinnedVoi
     const existing = bySpeaker.get(speaker);
     if (existing) return existing;
     const id = sanitizeId(`voice_${speaker}`, `voice_${bySpeaker.size}`);
-    const description = describe(speaker);
-    const traits = parseVoiceTraits(description);
+    const description2 = describe(speaker);
+    const traits = parseVoiceTraits(description2);
     if (voiceLanguage) traits.language = voiceLanguage;
     nodes.push(
-      pinnedVoiceId ? { id, type: "voice_select", params: { description, voice_id: pinnedVoiceId, ...traits } } : { id, type: "voice_select", params: { description, ...traits } }
+      pinnedVoiceId ? { id, type: "voice_select", params: { description: description2, voice_id: pinnedVoiceId, ...traits } } : { id, type: "voice_select", params: { description: description2, ...traits } }
     );
     bySpeaker.set(speaker, id);
     return id;
@@ -42608,8 +42686,8 @@ function castAvatarsOnStaticElements(elementsInput, avatars) {
     const avatar = isPerson(el) ? avatars[next] : void 0;
     if (!avatar) return el;
     next += 1;
-    const description = avatar.subjectDescription?.trim();
-    return { ...el, ...description ? { description } : {}, source_image: avatar.sheetUrl };
+    const description2 = avatar.subjectDescription?.trim();
+    return { ...el, ...description2 ? { description: description2 } : {}, source_image: avatar.sheetUrl };
   });
 }
 function staticAvatarsNotCast(elementsInput, handles) {
@@ -43915,8 +43993,8 @@ function adSpecCastElements(spec, avatar) {
       ...spec.set?.image?.trim() ? { source_image: spec.set.image.trim() } : {}
     });
   }
-  const description = (avatar?.subjectDescription ?? spec.cast?.description)?.trim();
-  if (!description) return elements;
+  const description2 = (avatar?.subjectDescription ?? spec.cast?.description)?.trim();
+  if (!description2) return elements;
   const scenes = spec.beats.map((beat, i) => ({ beat, i })).filter(({ beat, i }) => beat.cast !== false && !(endCardWanted(spec) && i === lastIndex)).map(({ i }) => i);
   if (scenes.length === 0) return elements;
   const sheet = avatar?.sheetUrl?.trim();
@@ -43926,7 +44004,7 @@ function adSpecCastElements(spec, avatar) {
     // Same id the dialogue names as speaker: that pairing is what lets the engine see
     // the presenter as present in a scene and route it to native audio.
     cast_id: AD_CAST_ID,
-    description,
+    description: description2,
     scenes,
     // An avatar's identity sheet IS the turnaround the engine would otherwise render,
     // so it is handed over as one. Left unmarked, the run paid to generate a sheet OF
@@ -48922,6 +49000,9 @@ var ADS_MATCHING = [
   "country"
 ];
 var MAPPING_SLOTS = {
+  shopifyCustomer: [
+    { kind: "record", key: "customer", allowed: ["email", "phone", "acceptsEmailMarketing", "acceptsSmsMarketing"] }
+  ],
   googleSpreadsheet: [{ kind: "list", key: "columnMapping", addressedBy: "column" }],
   hubspotForm: [
     {
@@ -64096,13 +64177,13 @@ var createCommand3 = defineCommand197({
     try {
       refuseAutoPublish(args5);
       const name = args5.name;
-      const description = args5.description;
+      const description2 = args5.description;
       const prompt = args5.prompt;
       const template = typeof args5.template === "string" ? args5.template.trim() : "";
       if (template.length === 0 && (!name || name.trim().length === 0)) {
         failValidation4("--name is required. Or pass --template to use a recipe's name.");
       }
-      if (template.length === 0 && (!description || description.trim().length === 0)) {
+      if (template.length === 0 && (!description2 || description2.trim().length === 0)) {
         failValidation4("--description is required. Or pass --template to use a recipe's line.");
       }
       if (template.length === 0 && (!prompt || prompt.trim().length === 0)) {
@@ -64113,7 +64194,7 @@ var createCommand3 = defineCommand197({
       const body = {
         chatId: requireChatId(),
         ...name?.trim() ? { name } : {},
-        ...description?.trim() ? { description } : {},
+        ...description2?.trim() ? { description: description2 } : {},
         enabled: !args5.disabled,
         ...trigger,
         ...prompt ? { prompt } : {},
@@ -64793,7 +64874,7 @@ var schemaCommand2 = defineCommand208({
 });
 
 // src/commands/shopify/index.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 
 // src/commands/shopify/buyers.ts
 import { defineCommand as defineCommand209 } from "citty";
@@ -65129,7 +65210,7 @@ var shopifyVariantSchema = z50.object({
   compareAtPrice: shopifyPriceSchema.optional(),
   stock: shopifyOptionStockSchema,
   quantity: z50.number().optional(),
-  /** The link for the page's buy button: never build a Shopify link by hand. Absent when the option can't be bought. */
+  /** The option's buy link for ads, emails and messages (a landing places `<ShopifyProduct>` instead): never build a Shopify link by hand. Absent when the option can't be bought. */
   buyUrl: z50.string().optional(),
   buyUrlKind: shopifyBuyDestinationSchema.optional(),
   /** Why there is no buy link. */
@@ -65244,7 +65325,7 @@ var shopifyProductDetailSchema = z50.object({
   handle: z50.string(),
   /** The product's page in Baker — the link to share with the user. */
   url: z50.string(),
-  /** The product's page on the online store: to look at, never a buy button's link (that is each option's `buyUrl`). */
+  /** The product's page on the online store: to look at, never a buy button's link (that is each option's `buyUrl`, or `<ShopifyProduct>` on a landing). */
   storeUrl: z50.string().optional(),
   availability: shopifyAvailabilitySchema.optional(),
   status: shopifyProductStatusSchema.optional(),
@@ -65820,7 +65901,8 @@ var shopifyWriteEntitySchema = z52.enum([
   "discountCode",
   "urlRedirect",
   "marketingActivity",
-  "webPixel"
+  "webPixel",
+  "signupOffer"
 ]);
 var shopifyDraftOpKindSchema = z52.enum([
   "shopify.product.update",
@@ -65841,7 +65923,9 @@ var shopifyDraftOpKindSchema = z52.enum([
   "shopify.urlRedirect.delete",
   "shopify.marketingActivity.upsert",
   "shopify.marketingActivity.delete",
-  "shopify.webPixel.update"
+  "shopify.webPixel.update",
+  "shopify.signupOffer.set",
+  "shopify.signupOffer.end"
 ]);
 var shopifyDecimalSchema = z52.string().regex(/^\d{1,12}(\.\d{1,4})?$/, 'write amounts as a decimal string, e.g. "19.95"');
 var tagSchema = z52.string().trim().min(1).max(255);
@@ -65963,6 +66047,27 @@ var marketingUpsertSchema = z52.object({
     medium: z52.string().trim().min(1).max(255)
   }).strict()
 }).strict();
+var signupOfferHandleSchema = z52.string().regex(/^[a-z0-9][a-z0-9-]{1,39}$/, "2\u201340 lowercase letters, digits and dashes, e.g. welcome-10");
+var signupOfferSetSchema = z52.object({
+  /** What the store's staff see in front of each code, and the Store page's row. */
+  name: z52.string().trim().min(1).max(80),
+  value: discountValueSchema,
+  appliesTo: discountAppliesToSchema,
+  minimumSubtotal: shopifyDecimalSchema.optional(),
+  /** Each code's life, from the moment it is given. */
+  validForDays: z52.number().int().min(1).max(365),
+  /** The offer stops giving codes after this; no code outlives it. */
+  endsAt: isoDateTimeSchema.optional(),
+  /** How many codes the offer gives in all. */
+  maxCodes: z52.number().int().min(1).max(1e5).optional(),
+  /** The start of every code (WELCOME-7Q2M9XKD); default: the handle in capitals. */
+  codePrefix: z52.string().regex(/^[A-Z0-9]{2,12}$/, "2\u201312 capital letters or digits, e.g. WELCOME").optional(),
+  combinesWith: z52.object({
+    productDiscounts: z52.boolean().optional(),
+    orderDiscounts: z52.boolean().optional(),
+    shippingDiscounts: z52.boolean().optional()
+  }).strict().optional()
+}).strict();
 var emptySchema = z52.object({}).strict();
 var opFields = {
   /** Optional caller-chosen ref for a create, so later ops in the batch can name it (`shopify_temp_…`). */
@@ -66008,7 +66113,19 @@ var shopifyDraftOpInputSchema = z52.discriminatedUnion("kind", [
     payload: emptySchema.optional(),
     ...opFields
   }),
-  z52.object({ kind: z52.literal("shopify.webPixel.update"), payload: emptySchema.optional(), ...opFields })
+  z52.object({ kind: z52.literal("shopify.webPixel.update"), payload: emptySchema.optional(), ...opFields }),
+  z52.object({
+    kind: z52.literal("shopify.signupOffer.set"),
+    target: signupOfferHandleSchema,
+    payload: signupOfferSetSchema,
+    ...opFields
+  }),
+  z52.object({
+    kind: z52.literal("shopify.signupOffer.end"),
+    target: signupOfferHandleSchema,
+    payload: emptySchema.optional(),
+    ...opFields
+  })
 ]);
 var PAYLOAD_KEYS = new Map(
   shopifyDraftOpInputSchema.options.map((option) => {
@@ -66226,7 +66343,7 @@ var fullArg = {
 
 // src/commands/shopify/hints.ts
 var RECONNECT = 'Baker has lost access to this Shopify store, so these products may be out of date. Say so, and ask the user to reconnect with `request_connection` { platform: "shopify" } \u2014 the card offers Reconnect.';
-var OWN_STOREFRONT = "This store sells through its own storefront, not a Shopify online store: Baker has no store page links for its products \u2014 link to the product pages on the client's own site, and ask the user for them if you don't know them.";
+var OWN_STOREFRONT = "This store sells through its own storefront, not a Shopify online store: Baker links to its product pages once the website's address is set in Brain \u2192 Store (`buyUrlKind` says where each link goes); until then, link to the product pages on the client's own site, and ask the user for them if you don't know them.";
 function day(iso) {
   return iso ? iso.slice(0, 10) : null;
 }
@@ -66334,17 +66451,17 @@ function stockHintsFor(product) {
 }
 var BUY_NOTES = {
   password_protected: "The store asks for a password before anyone can see it: a shopper following a buy link meets it first \u2014 tell the user before sending traffic.",
-  subscription_optional: "It can also be bought by subscription, but a buy link can only add it once \u2014 say so if the page promotes the subscription.",
-  own_storefront: "The store sells through its own storefront: buy links go straight to Shopify's checkout.",
+  subscription_optional: "It can also be bought by subscription: on a landing `<ShopifyProduct>` offers the plans; a `buyUrl` elsewhere adds it once.",
+  own_storefront: "The store sells through its own website: `buyUrlKind` says where each link goes \u2014 its product page, or its cart page once its developers confirm it in Brain \u2192 Store.",
   details_pending: "Baker hasn't read this product's details yet (subscriptions among them): its buy links may change.",
-  subscription_only: "It's sold only by subscription, which a buy link can't carry: its buy link is the product page, where the shopper picks the plan."
+  subscription_only: "It's sold only by subscription: on a landing `<ShopifyProduct>` offers the plans; a `buyUrl` elsewhere is its product page, where the shopper picks one."
 };
 function buyHints(product) {
   const hints2 = [];
   if (product.variants.some((variant) => variant.buyUrl)) {
     hints2.push(
-      `Use each option's \`buyUrl\` for the page's buy button \u2014 never build a Shopify link yourself (it follows the store's setting: ${product.buyDestination.replace("_", " ")}; \`--quantity <n>\` sets how many).`,
-      "Keep that `buyUrl` on the button: never `storeUrl` (a page to look at, not a buy link), and never drop or replace the buy button to get a page past its checks. The options to sell are `variants[]` alone \u2014 one buy button per option, each with its own `buyUrl`, never a size or colour picker made up from a size chart or other details. When the shopper must choose on the store, link the option's `productPage` (from `--full`)."
+      `On a landing, place \`<ShopifyProduct product="${product.handle}" />\` (and \`<ShopifyBuyButton product="${product.handle}">\` for a second button): it shows the options, price and stock, and its button hands the shopper to the store. Never put a \`buyUrl\` on a landing yourself, and never build an option picker. See /landing \`.claude/skills/landing/references/verticals/ecommerce.md\`.`,
+      `\`buyUrl\` is for links outside a landing \u2014 an ad, an email, a message: one per option; never \`storeUrl\` (a page to look at), never a Shopify link built yourself (it follows the store's setting: ${product.buyDestination.replace("_", " ")}; \`--quantity <n>\` sets how many).`
     );
   }
   const notes = new Set(product.variants.flatMap((variant) => variant.notes ?? []));
@@ -66811,9 +66928,24 @@ var WARNINGS = "Read the warnings above before telling the user this is ready.";
 var DISCOUNT = "The code works only after the chat is published; don't announce it as live or share it as working yet.";
 var EMPTY_COLLECTION = "The new collection has no products yet: add them with `baker shopify change collection add <collection> <product\u2026>`.";
 var COLLECTION_DELETE = "Its address stops working when it is deleted: keep old links alive with `baker shopify change redirect create --from /collections/<handle> --to <page>` (ask the user where they should land).";
+function repointedRedirects(ops) {
+  const removed = ops.flatMap(
+    (op) => op.kind === "shopify.urlRedirect.delete" && op.ref.startsWith("urlRedirect:") ? [op.ref.slice("urlRedirect:".length)] : []
+  );
+  return removed.flatMap((path49) => {
+    const made = ops.find(
+      (op) => op.kind === "shopify.urlRedirect.create" && op.summary.startsWith(`Redirect ${path49} to `)
+    );
+    if (!made) return [];
+    const to = made.summary.slice(`Redirect ${path49} to `.length);
+    return [
+      `${path49} still redirects after publish, now to ${to}: tell the user the old link goes there, not that its redirect is removed.`
+    ];
+  });
+}
 function stageHints(data) {
   if (!data.staged) return [];
-  const hints2 = [STAGED];
+  const hints2 = [STAGED, ...repointedRedirects(data.ops)];
   if (data.ops.some((op) => op.warnings.length > 0)) hints2.push(WARNINGS);
   if (data.ops.some((op) => op.kind === "shopify.discountCode.create")) hints2.push(DISCOUNT);
   if (data.ops.some((op) => op.kind === "shopify.collection.delete")) hints2.push(COLLECTION_DELETE);
@@ -67154,18 +67286,18 @@ var collectionUpdate = leaf(
     () => target3(args5, "collection")
   )
 );
-function collectionVerb(verb, kind, description) {
+function collectionVerb(verb, kind, description2) {
   return leaf(
     `shopify.change.collection.${verb}`,
-    { name: verb, description },
+    { name: verb, description: description2 },
     { collection: TARGET("Collection id, handle, link or a shopify_temp_ ref staged in this chat") },
     async (args5) => await stage([{ kind, target: target3(args5, "collection") }])
   );
 }
-function membership(verb, kind, description) {
+function membership(verb, kind, description2) {
   return leaf(
     `shopify.change.collection.${verb}`,
-    { name: verb, description },
+    { name: verb, description: description2 },
     {
       collection: TARGET("Collection id, handle, link or a shopify_temp_ ref"),
       products: TARGET("Products (ids, handles or links), space separated")
@@ -67215,6 +67347,75 @@ function discountPayload(args5) {
     combinesWith: combinesOf(args5.combines)
   });
 }
+function signupOfferFlagsProblem(args5) {
+  if (typeof args5.name !== "string" || args5.name.trim() === "")
+    return 'Add --name "<what shoppers and store staff see, e.g. 10% off>": every sign-up offer needs a name.';
+  if (args5["valid-days"] === void 0)
+    return "Add --valid-days <1-365>: how many days each code lasts after it is given.";
+  return void 0;
+}
+function signupOfferPayload(args5) {
+  return defined({
+    name: args5.name,
+    value: discountValue(args5),
+    appliesTo: appliesToOf(args5),
+    minimumSubtotal: args5.minimum,
+    validForDays: numberOf3(args5["valid-days"]),
+    endsAt: args5.ends,
+    maxCodes: numberOf3(args5["max-codes"]),
+    codePrefix: args5.prefix,
+    combinesWith: combinesOf(args5.combines)
+  });
+}
+var signupOfferSet = leaf(
+  "shopify.change.signupOffer.set",
+  {
+    name: "set",
+    description: 'Stage a sign-up offer. Changes money: ask the exact approval question returned by this command. Example: baker shopify change signup-offer set welcome-10 --name "Welcome" --percent 10 --valid-days 14 --max-codes 1000'
+  },
+  {
+    handle: TARGET("Offer handle, e.g. welcome-10"),
+    name: {
+      type: "string",
+      description: 'Offer name shoppers and store staff see (required), e.g. "10% off"',
+      required: false
+    },
+    percent: { type: "string", description: "Percentage off (choose percent or amount)", required: false },
+    amount: { type: "string", description: "Amount off in the store currency", required: false },
+    products: { type: "string", description: "Product handles or ids, comma separated", required: false },
+    collections: { type: "string", description: "Collection handles or ids, comma separated", required: false },
+    minimum: { type: "string", description: "Minimum subtotal", required: false },
+    "valid-days": { type: "string", description: "Each code lasts 1\u2013365 days (required)", required: false },
+    ends: { type: "string", description: "Offer end as ISO date and time; no code outlives it", required: false },
+    "max-codes": { type: "string", description: "Total codes the offer may give, 1\u2013100000", required: false },
+    prefix: { type: "string", description: "Code prefix: 2\u201312 uppercase letters or digits", required: false },
+    combines: {
+      type: "string",
+      description: "Comma-separated product,order,shipping discounts to combine",
+      required: false
+    },
+    ...JSON_ARGS
+  },
+  async (args5) => await stageFor(
+    "shopify.signupOffer.set",
+    args5,
+    () => {
+      const problem = signupOfferFlagsProblem(args5);
+      if (problem) failValidation3(problem);
+      return signupOfferPayload(args5);
+    },
+    () => target3(args5, "offer handle")
+  )
+);
+var signupOfferEnd = leaf(
+  "shopify.change.signupOffer.end",
+  {
+    name: "end",
+    description: "End a sign-up offer at Publish. Existing codes keep their terms. Example: baker shopify change signup-offer end welcome-10"
+  },
+  { handle: TARGET("Offer handle") },
+  async (args5) => await stage([{ kind: "shopify.signupOffer.end", target: target3(args5, "offer handle") }])
+);
 var discountCreate = leaf(
   "shopify.change.discount.create",
   {
@@ -67340,7 +67541,7 @@ var measurementReconnect = leaf(
   {},
   async () => await stage([{ kind: "shopify.webPixel.update" }])
 );
-var group = (name, description, subCommands) => defineCommand211({ meta: { name, description }, subCommands });
+var group = (name, description2, subCommands) => defineCommand211({ meta: { name, description: description2 }, subCommands });
 var changeCommand = defineCommand211({
   meta: {
     name: "change",
@@ -67357,6 +67558,7 @@ change can be put back with \`baker shopify undo\`. Prices and discounts need th
   baker shopify change measurement reconnect`
   },
   subCommands: {
+    "signup-offer": group("signup-offer", "Stage or end a sign-up offer", { set: signupOfferSet, end: signupOfferEnd }),
     product: group("product", "Change a product's title, description, SEO, tags or type", { update: productUpdate }),
     variant: group("variant", "Change an option's SKU, barcode, weight or price", { update: variantUpdate }),
     field: group("field", "Set or remove a custom field", { set: fieldSet, remove: fieldRemove }),
@@ -67567,12 +67769,46 @@ import { defineCommand as defineCommand213 } from "citty";
 // src/commands/shopify/landingLinks.ts
 import { readdir as readdir16, readFile as readFile33, stat as stat11 } from "fs/promises";
 import path47 from "path";
+import { parse } from "@astrojs/compiler/sync";
 var PAGES_MAX = 300;
 var FILE_BYTES_MAX = 256 * 1024;
 function escaped(text2) {
   return text2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function evidenceIn(text2, keys) {
+var BUY_COMPONENTS = /* @__PURE__ */ new Set(["ShopifyProduct", "ShopifyBuyButton"]);
+var STRING_LITERAL = /^\s*(["'`])([^"'`]*)\1\s*$/;
+var ITEM_PRODUCT = /\bproduct\s*:\s*(["'`])([^"'`]*)\1/g;
+function namedBy(attribute) {
+  if (attribute.name === "product") {
+    if (attribute.kind === "quoted" || attribute.kind === "template-literal") return [attribute.value];
+    if (attribute.kind === "expression") return [STRING_LITERAL.exec(attribute.value)?.[2] ?? ""];
+  }
+  if (attribute.name === "items" && attribute.kind === "expression") {
+    return [...attribute.value.matchAll(ITEM_PRODUCT)].map((match) => match[2] ?? "");
+  }
+  return [];
+}
+function componentProducts(node, into) {
+  if (node.type === "component" && BUY_COMPONENTS.has(node.name)) {
+    for (const attribute of node.attributes) into.push(...namedBy(attribute));
+  }
+  if ("children" in node) for (const child of node.children) componentProducts(child, into);
+  return into;
+}
+function buyComponentProducts(file) {
+  if (!file.path.endsWith(".astro")) return [];
+  try {
+    return componentProducts(parse(file.text, void 0).ast, []);
+  } catch {
+    return [];
+  }
+}
+function namesProduct(file, keys) {
+  const wanted = new Set([keys.handle.toLowerCase(), ...keys.productId ? [keys.productId] : []].filter(Boolean));
+  return buyComponentProducts(file).some((named) => wanted.has(named.trim().toLowerCase()));
+}
+function evidenceIn(file, keys) {
+  const { text: text2 } = file;
   const evidence = [];
   if (keys.buyUrls.some((url) => url && text2.includes(url))) evidence.push("buy_link");
   const page = new RegExp(`/products/${escaped(keys.handle)}(?![A-Za-z0-9_-])`, "i");
@@ -67581,19 +67817,20 @@ function evidenceIn(text2, keys) {
     (id) => new RegExp(`(?:/cart/(?:\\d+:\\d+,)*${id}:|variant=${id}(?!\\d))`).test(text2)
   );
   if (option) evidence.push("variant_id");
+  if (namesProduct(file, keys)) evidence.push("buy_button");
   return evidence;
 }
 function landingLinksOf(pages, keys) {
   const bySlug = /* @__PURE__ */ new Map();
   for (const page of pages) {
-    const found = new Set(page.files.flatMap((file) => evidenceIn(file.text, keys)));
+    const found = new Set(page.files.flatMap((file) => evidenceIn(file, keys)));
     if (found.size === 0) continue;
     const slug = page.slug.replace(/--\d+$/, "");
     const held = bySlug.get(slug) ?? /* @__PURE__ */ new Set();
     for (const evidence of found) held.add(evidence);
     bySlug.set(slug, held);
   }
-  const order = ["buy_link", "product_page", "variant_id"];
+  const order = ["buy_link", "product_page", "variant_id", "buy_button"];
   return [...bySlug].map(([slug, evidence]) => ({ slug, evidence: order.filter((entry) => evidence.has(entry)) }));
 }
 async function isDir4(target4) {
@@ -67848,6 +68085,7 @@ var promotionsCommand = defineCommand213({
       const scan = await readWorkspacePages(process.cwd());
       const linked = scan ? landingLinksOf(scan.pages, {
         handle: product.handle,
+        productId: product.productId,
         variantIds: product.variants.map((variant) => variant.variantId),
         buyUrls: product.variants.flatMap((variant) => variant.buyUrl ? [variant.buyUrl] : [])
       }) : void 0;
@@ -67893,8 +68131,96 @@ var stockHoldsCommand = defineCommand213({
   }
 });
 
-// src/commands/shopify/tracking.ts
+// ../api/src/shopify/signups.ts
+import { z as z53 } from "zod";
+var SIGNUP_CODE_PATTERN = /^[A-Z0-9]{2,12}-[0-9A-HJKMNP-TV-Z]{8}$/;
+var SIGNUP_STATES = [
+  "waiting",
+  "ready",
+  "used",
+  "expired",
+  "already",
+  "ended",
+  "none",
+  "unavailable"
+];
+var CODE_STATES = /* @__PURE__ */ new Set(["ready", "used", "expired"]);
+var shopifySignupReplySchema = z53.object({
+  state: z53.enum(SIGNUP_STATES),
+  code: z53.string().regex(SIGNUP_CODE_PATTERN).optional(),
+  endsAt: z53.string().min(1).max(40).optional()
+}).strict().refine(
+  (reply) => CODE_STATES.has(reply.state) ? reply.code !== void 0 && reply.endsAt !== void 0 : true,
+  "a code state carries the code and when it ends"
+).refine(
+  (reply) => CODE_STATES.has(reply.state) ? true : reply.code === void 0 && reply.endsAt === void 0,
+  "only the browser the code was given to is told it"
+);
+var shopifySignupResponseSchema = z53.union([
+  z53.object({ ok: z53.literal(true), signup: shopifySignupReplySchema }).passthrough(),
+  z53.object({ error: z53.string(), signup: shopifySignupReplySchema }).passthrough()
+]);
+var signupOfferStatusSchema = z53.enum(["active", "ended", "staged"]);
+var shopifySignupOfferViewSchema = z53.object({
+  handle: z53.string(),
+  name: z53.string(),
+  /** "10% off everything, each code valid 14 days, at most 1,000 codes". */
+  summary: z53.string(),
+  status: signupOfferStatusSchema,
+  validForDays: z53.number(),
+  endsAt: z53.string().optional(),
+  maxCodes: z53.number().optional(),
+  codesGiven: z53.number()
+});
+var shopifySignupOffersResponseSchema = z53.object({
+  /** The company has a store connection Baker can use (connected, not waiting on a reconnect). */
+  connected: z53.boolean(),
+  /** The store allows Baker to add customers (sign-ups work). */
+  canAddCustomers: z53.boolean(),
+  /** The store allows Baker to make discount codes (offers give codes). */
+  canGiveCodes: z53.boolean(),
+  offers: z53.array(shopifySignupOfferViewSchema),
+  /** Sign-ups the store didn't take in the last 7 days: for a missing permission, and for anything else. */
+  refusedLast7Days: z53.object({ permission: z53.number(), other: z53.number() })
+});
+
+// src/commands/shopify/signupOffers.ts
 import { defineCommand as defineCommand214 } from "citty";
+var description = "Start here for landing sign-ups: published and this chat's staged offers, codes given and store permissions. Example: baker shopify signup-offers. Forms name an offer handle; terms are staged with baker shopify change signup-offer set.";
+registerSchema({ command: "shopify.signupOffers", description, args: {} });
+var signupOffersCommand = defineCommand214({
+  meta: { name: "signup-offers", description },
+  async run() {
+    try {
+      const data = shopifySignupOffersResponseSchema.parse(
+        await apiGet("/api/shopify/signup-offers", params({ chatId: optionalChatId() }))
+      );
+      const hints2 = [];
+      if (!data.canAddCustomers)
+        hints2.push(
+          'Sign-ups cannot be added to the store yet: call request_connection with { platform: "shopify", reason: "Add sign-ups from your landing" }. Keep building the page; the Form works once allowed.'
+        );
+      if (!data.canGiveCodes)
+        hints2.push(
+          "Codes need the store to allow discounts: use request_connection for Shopify and keep building the page."
+        );
+      if (data.offers.some((offer) => offer.status === "ended"))
+        hints2.push(
+          "Forms naming ended offers still add customers but give no code: stage a new offer or remove offer from the Form."
+        );
+      if (data.offers.length === 0)
+        hints2.push(
+          "No sign-up offer exists yet. Omit offer for sign-ups without a code, or stage one after the user approves its terms."
+        );
+      writeJson({ ok: true, hints: hints2, data });
+    } catch (error) {
+      fail9(error);
+    }
+  }
+});
+
+// src/commands/shopify/tracking.ts
+import { defineCommand as defineCommand215 } from "citty";
 var audit = leaf(
   "shopify.tracking.audit",
   {
@@ -67911,7 +68237,7 @@ var audit = leaf(
     }
   }
 );
-var trackingCommand2 = defineCommand214({
+var trackingCommand2 = defineCommand215({
   meta: { name: "tracking", description: "Check how the store is measured: baker shopify tracking audit" },
   subCommands: { audit }
 });
@@ -67954,7 +68280,7 @@ registerSchema({
 });
 registerSchema({
   command: "shopify.product",
-  description: "One product of the connected store \u2014 accepts its id, its handle, a link to it on the store, in Baker or in Shopify admin. Returns its options with price, stock and `buyUrl` (the link for a page's buy button, one per option \u2014 never build a Shopify link yourself, never use `storeUrl` for it), prices by country, the options out of stock, its collections, its photos' library imageIds to place on a landing (`baker images download <imageIds> --out src/pages/<page>/_images/`) or pass to a creative, its videos' playbackIds (`<Video playbackId=\u2026/>`), and `contentSummary`: what else Baker keeps about it. Start here for a landing from a product: add `--content` for the formatted description, every custom field by its name (a size chart, care instructions), the rating, subscriptions and translations; `--field <name>` returns one field whole. `--out-of-stock` lists only the options out of stock.",
+  description: "One product of the connected store \u2014 accepts its id, its handle, a link to it on the store, in Baker or in Shopify admin. Returns its options with price, stock and `buyUrl` (each option's buy link for ads, emails and messages; on a landing use `<ShopifyProduct>` instead \u2014 never build a Shopify link yourself, never use `storeUrl` for it), prices by country, the options out of stock, its collections, its photos' library imageIds to place on a landing (`baker images download <imageIds> --out src/pages/<page>/_images/`) or pass to a creative, its videos' playbackIds (`<Video playbackId=\u2026/>`), and `contentSummary`: what else Baker keeps about it. Start here for a landing from a product: add `--content` for the formatted description, every custom field by its name (a size chart, care instructions), the rating, subscriptions and translations; `--field <name>` returns one field whole. `--out-of-stock` lists only the options out of stock.",
   args: {
     ref: { type: "positional", description: "Product id, handle, or a link to the product", required: true },
     "variants-cursor": {
@@ -68044,7 +68370,7 @@ registerSchema({
     }
   }
 });
-var salesCommand = defineCommand215({
+var salesCommand = defineCommand216({
   meta: {
     name: "sales",
     description: "What the store sold: orders, sales, refunds and net, by day, product, campaign or landing \u2014 or when buyers order (weekday, hour, month). Example: baker shopify sales --days 7 --by campaign"
@@ -68082,7 +68408,7 @@ var salesCommand = defineCommand215({
     }
   }
 });
-var storeCommand = defineCommand215({
+var storeCommand = defineCommand216({
   meta: {
     name: "store",
     description: "The connected Shopify store: currency, countries, how many products, what is out of stock. Example: baker shopify store"
@@ -68100,7 +68426,7 @@ var storeCommand = defineCommand215({
     }
   }
 });
-var productsCommand = defineCommand215({
+var productsCommand = defineCommand216({
   meta: {
     name: "products",
     description: 'What the store sells, with price and stock. Example: baker shopify products --search "snowboard" --stock out_of_stock'
@@ -68146,7 +68472,7 @@ var productsCommand = defineCommand215({
     }
   }
 });
-var productCommand = defineCommand215({
+var productCommand = defineCommand216({
   meta: {
     name: "product",
     description: "One product: options with buy links, prices by country, stock, photo imageIds, video playbackIds. Accepts an id, handle or link. Example: baker shopify product the-complete-snowboard --content"
@@ -68209,7 +68535,7 @@ var productCommand = defineCommand215({
     }
   }
 });
-var collectionsCommand = defineCommand215({
+var collectionsCommand = defineCommand216({
   meta: {
     name: "collections",
     description: "The store's collections, with the handles --collection takes. Example: baker shopify collections --full"
@@ -68234,7 +68560,7 @@ var collectionsCommand = defineCommand215({
     }
   }
 });
-var stockCommand2 = defineCommand215({
+var stockCommand2 = defineCommand216({
   meta: {
     name: "stock",
     description: "Every product with options out of stock, naming them. Example: baker shopify stock"
@@ -68258,7 +68584,7 @@ var stockCommand2 = defineCommand215({
     }
   }
 });
-var shopifyCommand = defineCommand215({
+var shopifyCommand = defineCommand216({
   meta: {
     name: "shopify",
     description: `Read the connected Shopify store as Baker keeps it \u2014 products, prices by country, stock, collections,
@@ -68295,13 +68621,14 @@ Examples:
 Product photos are already in the image library: place them by imageId
 (baker images download <imageIds> --out src/pages/<page>/_images/), never by a cdn.shopify.com link.
 Product videos are in the video library: place them with <Video playbackId="\u2026" />.
-A page's buy button uses the option's buyUrl, one button per option \u2014 never build a Shopify link
-yourself, and never use storeUrl (a page to look at) for it.
+On a landing, the buy button is <ShopifyProduct product="\u2026"/> \u2014 never a buyUrl or a Shopify link
+written by hand. buyUrl is for ads, emails and messages; never use storeUrl (a page to look at) for it.
 NO_SHOPIFY_CONNECTION means no store is connected: follow error.fix. SHOPIFY_NOT_AVAILABLE means it cannot be
 connected here yet: carry on without it.
 Full guide: __tooling__/docs/tools/baker/shopify.md`
   },
   subCommands: {
+    "signup-offers": signupOffersCommand,
     store: storeCommand,
     products: productsCommand,
     product: productCommand,
@@ -68325,10 +68652,10 @@ Full guide: __tooling__/docs/tools/baker/shopify.md`
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } from "citty";
 
 // src/commands/studio/spokenPace.ts
 var WORDS_PER_SECOND3 = SPOKEN_WORDS_PER_SECOND;
@@ -68841,7 +69168,7 @@ async function adByHandHintFor(body) {
     return null;
   }
 }
-var animateCommand = defineCommand216({
+var animateCommand = defineCommand217({
   meta: {
     name: "animate",
     description: "Render a clip. With an image the look is already fixed, so the prompt describes MOVEMENT \u2014 what the camera does, what the subject does, in what order. With --from text there is no image and the prompt is the whole shot.\n\nA rendered clip is NOT usable anywhere until you keep it: `baker studio keep <id> --slot N` is what puts it in the video library. Takes nobody keeps are never ingested, which is what makes a rejected batch cheap.\n\nFor anything longer than 15 seconds, or to build on footage that already exists, use --model bytedance/seedance-2.5: it renders 4-30s and is the only model that reads an existing clip or an existing soundtrack.\n\nExamples:\n  baker studio animate 'slow push in, model turns to camera and smiles' --image j57abc123def456ghi789\n  baker studio animate 'she looks to camera and says: \"Hola, soy Elena\"' --avatar elena --quality 720p --aspect-ratio 9:16\n  baker studio animate 'handheld drift right, steam rising from the cup' --image './out/hero.png' --duration 6 --quality 1080p\n  baker studio animate 'product rotates once on a turntable' --image j57abc\u2026,j57def\u2026 --from references\n  baker studio animate 'she keeps walking, camera stays with her, then she stops and looks up' --image j57abc\u2026 --from references --from-clip j57batch\u2026:0 --model bytedance/seedance-2.5 --duration 20\n  baker studio animate 'hold on the product, then a slow push-in' --from references --from-video j57vid\u2026 --model bytedance/seedance-2.5\n  baker studio animate 'slow drone pull-back over a solar farm at golden hour, no people' --from text --model bytedance/seedance-2.5 --duration 12"
@@ -68966,7 +69293,7 @@ var animateCommand = defineCommand216({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -69102,7 +69429,7 @@ function buildGenerateBody(args5, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand217({
+var generateCommand = defineCommand218({
   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]]'"
@@ -69185,7 +69512,7 @@ var generateCommand = defineCommand217({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand219 } 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.",
@@ -69194,7 +69521,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand218({
+var getCommand5 = defineCommand219({
   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"
@@ -69223,7 +69550,7 @@ var getCommand5 = defineCommand218({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 var DESCRIPTION2 = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
 registerSchema({
   command: "studio.improve",
@@ -69248,7 +69575,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand219({
+var improveCommand = defineCommand220({
   meta: {
     name: "improve",
     description: `${DESCRIPTION2}
@@ -69292,7 +69619,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand221 } 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.",
@@ -69302,7 +69629,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand220({
+var keepCommand = defineCommand221({
   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"
@@ -69353,7 +69680,7 @@ var keepCommand = defineCommand220({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand222 } 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.",
@@ -69364,7 +69691,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand18 = defineCommand221({
+var listCommand18 = defineCommand222({
   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"
@@ -69398,7 +69725,7 @@ var listCommand18 = defineCommand221({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 var DESCRIPTION3 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
 registerSchema({
   command: "studio.models",
@@ -69485,7 +69812,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand222({
+var modelsCommand = defineCommand223({
   meta: {
     name: "models",
     description: `${DESCRIPTION3}
@@ -69532,13 +69859,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand224 } 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 = defineCommand223({
+var skillsCommand = defineCommand224({
   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"
@@ -69562,7 +69889,7 @@ var skillsCommand = defineCommand223({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand224({
+var studioCommand = defineCommand225({
   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.
@@ -69605,10 +69932,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand229 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync20 } from "fs";
@@ -69731,13 +70058,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand6 = defineCommand225({
+var draftCommand6 = defineCommand226({
   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: defineCommand225({
+    list: defineCommand226({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -69750,7 +70077,7 @@ var draftCommand6 = defineCommand225({
         await draftList2(args5.json === true, args5.chat);
       }
     }),
-    show: defineCommand225({
+    show: defineCommand226({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -69767,7 +70094,7 @@ var draftCommand6 = defineCommand225({
         );
       }
     }),
-    amend: defineCommand225({
+    amend: defineCommand226({
       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."
@@ -69784,7 +70111,7 @@ var draftCommand6 = defineCommand225({
         });
       }
     }),
-    remove: defineCommand225({
+    remove: defineCommand226({
       meta: { name: "remove", description: "Remove one staged change (cascades to anything depending on it)" },
       args: { ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false } },
       run: async ({ args: args5 }) => {
@@ -69793,7 +70120,7 @@ var draftCommand6 = defineCommand225({
         });
       }
     }),
-    clear: defineCommand225({
+    clear: defineCommand226({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -69803,7 +70130,7 @@ var draftCommand6 = defineCommand225({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand227 } 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.",
@@ -69844,7 +70171,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand226({
+var containersCommand = defineCommand227({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -69861,7 +70188,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand226({
+var readCommand = defineCommand227({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -69903,7 +70230,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand228 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -69959,10 +70286,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand227({
+  return defineCommand228({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand227({
+      create: defineCommand228({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -69984,7 +70311,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand227({
+      update: defineCommand228({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -70004,7 +70331,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand227({
+      delete: defineCommand228({
         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 },
@@ -70045,7 +70372,7 @@ function builtinTypes(args5) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand227({
+var builtinCommand = defineCommand228({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -70055,7 +70382,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand227({
+    enable: defineCommand228({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -70069,7 +70396,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand227({
+    disable: defineCommand228({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -70087,7 +70414,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand228({
+var tagManagerCommand = defineCommand229({
   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.
@@ -70124,7 +70451,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand229 } from "citty";
+import { defineCommand as defineCommand230 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -70204,7 +70531,7 @@ async function listTags(json) {
 var listArgs11 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand19 = defineCommand229({
+var listCommand19 = defineCommand230({
   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"
@@ -70223,7 +70550,7 @@ async function listDraft4(chat) {
     failApi3(err);
   }
 }
-var draftCommand7 = defineCommand229({
+var draftCommand7 = defineCommand230({
   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."
@@ -70233,7 +70560,7 @@ var draftCommand7 = defineCommand229({
     await listDraft4(args5.chat);
   }
 });
-var tagsCommand4 = defineCommand229({
+var tagsCommand4 = defineCommand230({
   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.
@@ -70262,10 +70589,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand233 } from "citty";
+import { defineCommand as defineCommand234 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand230 } from "citty";
+import { defineCommand as defineCommand231 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -70273,7 +70600,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand230({
+var getCommand6 = defineCommand231({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -70310,7 +70637,7 @@ var getCommand6 = defineCommand230({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand231 } from "citty";
+import { defineCommand as defineCommand232 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -70467,7 +70794,7 @@ function buildListParams(args5) {
   }
   return params2;
 }
-var listCommand20 = defineCommand231({
+var listCommand20 = defineCommand232({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -70527,7 +70854,7 @@ var listCommand20 = defineCommand231({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand233 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -70606,7 +70933,7 @@ function buildSearchRequest(query, args5) {
   }
   return body;
 }
-var searchCommand3 = defineCommand232({
+var searchCommand3 = defineCommand233({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -70670,7 +70997,7 @@ var searchCommand3 = defineCommand232({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand233({
+var testimonialsCommand = defineCommand234({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -70692,10 +71019,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand241 } from "citty";
+import { defineCommand as defineCommand242 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand235 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -70709,7 +71036,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand234({
+var deleteCommand4 = defineCommand235({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -70750,7 +71077,7 @@ var deleteCommand4 = defineCommand234({
 });
 
 // src/commands/videos/describe.ts
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand236 } from "citty";
 var DESCRIPTION_HELP2 = "What the clip actually shows, in the words someone would search for it by. This is what `baker videos search` retrieves on.";
 registerSchema({
   command: "videos.describe",
@@ -70767,7 +71094,7 @@ registerSchema({
     full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
   }
 });
-var describeCommand2 = defineCommand235({
+var describeCommand2 = defineCommand236({
   meta: {
     name: "describe",
     description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
@@ -70825,7 +71152,7 @@ Example: baker videos describe j571abc123 --description "Customer explaining how
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand236 } from "citty";
+import { defineCommand as defineCommand237 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -70833,7 +71160,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand236({
+var getCommand7 = defineCommand237({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -70870,7 +71197,7 @@ var getCommand7 = defineCommand236({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand237 } from "citty";
+import { defineCommand as defineCommand238 } 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)",
@@ -70879,7 +71206,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand237({
+var groupCommand2 = defineCommand238({
   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>"
@@ -70902,7 +71229,7 @@ var groupCommand2 = defineCommand237({
 import { mkdtemp as mkdtemp3, rm as rm9, stat as stat12 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
 import path48 from "path";
-import { defineCommand as defineCommand238 } from "citty";
+import { defineCommand as defineCommand239 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -71066,7 +71393,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand238({
+var ingestCommand2 = defineCommand239({
   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"
@@ -71328,7 +71655,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand239 } from "citty";
+import { defineCommand as defineCommand240 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -71338,7 +71665,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand239({
+var searchCommand4 = defineCommand240({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -71390,7 +71717,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile34, stat as stat13 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand240 } from "citty";
+import { defineCommand as defineCommand241 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -71432,7 +71759,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand240({
+var uploadCommand2 = defineCommand241({
   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"
@@ -71516,7 +71843,7 @@ var uploadCommand2 = defineCommand240({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand241({
+var videosCommand = defineCommand242({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, describe, delete, tags.
@@ -71545,10 +71872,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand254 } from "citty";
+import { defineCommand as defineCommand255 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand242 } from "citty";
+import { defineCommand as defineCommand243 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList3(value) {
@@ -71601,7 +71928,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand242({
+var advertisersCommand2 = defineCommand243({
   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'
@@ -71659,7 +71986,7 @@ var advertisersCommand2 = defineCommand242({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand243 } from "citty";
+import { defineCommand as defineCommand244 } 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.",
@@ -71705,7 +72032,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand243({
+var briefCommand = defineCommand244({
   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`
@@ -71741,7 +72068,7 @@ var briefCommand = defineCommand243({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand244 } from "citty";
+import { defineCommand as defineCommand245 } 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.",
@@ -71754,7 +72081,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand244({
+var contentCommand = defineCommand245({
   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"
@@ -71803,7 +72130,7 @@ var contentCommand = defineCommand244({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand245 } from "citty";
+import { defineCommand as defineCommand246 } from "citty";
 function buildFeedParams(input) {
   const params2 = {};
   const advertiser = splitList3(input.advertiser);
@@ -71855,7 +72182,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand2 = defineCommand245({
+var feedCommand2 = defineCommand246({
   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"
@@ -71940,7 +72267,7 @@ var feedCommand2 = defineCommand245({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand246 } from "citty";
+import { defineCommand as defineCommand247 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -71955,7 +72282,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand246({
+var followCommand = defineCommand247({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks every platform we can resolve. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -72002,7 +72329,7 @@ var followCommand = defineCommand246({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand247 } from "citty";
+import { defineCommand as defineCommand248 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -72035,7 +72362,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand247({
+var followCompetitorsCommand = defineCommand248({
   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"'
@@ -72110,7 +72437,7 @@ var followCompetitorsCommand = defineCommand247({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand248 } from "citty";
+import { defineCommand as defineCommand249 } 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.",
@@ -72164,7 +72491,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand248({
+var followingCommand = defineCommand249({
   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"
@@ -72200,7 +72527,7 @@ var followingCommand = defineCommand248({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand249 } from "citty";
+import { defineCommand as defineCommand250 } 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.",
@@ -72239,7 +72566,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand249({
+var patternsCommand = defineCommand250({
   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"
@@ -72295,7 +72622,7 @@ var patternsCommand = defineCommand249({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand250 } from "citty";
+import { defineCommand as defineCommand251 } 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.",
@@ -72433,7 +72760,7 @@ function reportSearchError(err) {
   }
   reportError2(err);
 }
-var searchCommand5 = defineCommand250({
+var searchCommand5 = defineCommand251({
   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"
@@ -72553,7 +72880,7 @@ var searchCommand5 = defineCommand250({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand251 } from "citty";
+import { defineCommand as defineCommand252 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -72581,7 +72908,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand251({
+  return defineCommand252({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -72630,7 +72957,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand252 } from "citty";
+import { defineCommand as defineCommand253 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -72638,7 +72965,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand252({
+var unfollowCommand = defineCommand253({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -72659,7 +72986,7 @@ var unfollowCommand = defineCommand252({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand253 } from "citty";
+import { defineCommand as defineCommand254 } 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.",
@@ -72669,7 +72996,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand253({
+var winnersCommand = defineCommand254({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -72719,7 +73046,7 @@ var winnersCommand = defineCommand253({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand254({
+var winningAdsCommand = defineCommand255({
   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.
@@ -72919,8 +73246,8 @@ function suggestFlag(unknown, command) {
   const name = flag3.slice(2);
   const def = args5[name] ?? args5[camel(name)];
   const described = def && typeof def === "object" ? def.description : void 0;
-  const description = typeof described === "string" ? described.split(/(?<!\b(?:e\.g|i\.e|vs))\.\s/)[0]?.trim().replace(/\.$/, "") : "";
-  return description ? { flag: flag3, description } : { flag: flag3 };
+  const description2 = typeof described === "string" ? described.split(/(?<!\b(?:e\.g|i\.e|vs))\.\s/)[0]?.trim().replace(/\.$/, "") : "";
+  return description2 ? { flag: flag3, description: description2 } : { flag: flag3 };
 }
 function suggestionText(suggestion) {
   if (!suggestion) {
@@ -73046,7 +73373,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand255({
+var main = defineCommand256({
   meta: {
     name: "baker",
     version: getCliVersion(),