@koda-sl/baker-cli 0.375.0-dev.8dac6def3 → 0.376.0-dev.2f68e83cd

package/dist/cli.js

@@ -133,7 +133,7 @@ import {
 } from "./chunk-7YNOGIWQ.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand250, runMain } from "citty";
+import { defineCommand as defineCommand251, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -6949,6 +6949,152 @@ var researchKeywordMetricsResponseSchema = z22.object({
 
 // ../api/src/scheduledAgentRules.ts
 import { z as z23 } from "zod";
+
+// ../api/src/shopify/storeEvents.ts
+var PRODUCT_FIELDS = [
+  "title",
+  "handle",
+  "status",
+  "published",
+  "price",
+  "price_max",
+  "currency",
+  "collections",
+  "tags",
+  "product_type",
+  "vendor",
+  "product_url",
+  "store"
+];
+var STORE_EVENTS = {
+  product_out_of_stock: {
+    label: "A product runs out of stock",
+    sentence: "When a product in your Shopify store runs out of stock",
+    description: "One or more of its options can no longer be bought; whole_product says whether nothing at all can be.",
+    payload: [
+      "title",
+      "handle",
+      "whole_product",
+      "options_out",
+      "options_out_count",
+      "options_count",
+      "promoted_by",
+      "promotions_checked",
+      ...PRODUCT_FIELDS.slice(2)
+    ],
+    namesProduct: true
+  },
+  product_back_in_stock: {
+    label: "A product is back in stock",
+    sentence: "When a product in your Shopify store is back in stock",
+    description: "Options that ran out can be bought again, or ads were paused for it after it came back.",
+    payload: [
+      "title",
+      "handle",
+      "whole_product_was_out",
+      "options_back",
+      "still_out_count",
+      "stock_holds",
+      "reason",
+      "promoted_by",
+      ...PRODUCT_FIELDS.slice(2)
+    ],
+    namesProduct: true
+  },
+  product_created: {
+    label: "A new product is added",
+    sentence: "When a new product is added to your Shopify store",
+    description: "A product appears in the store (never during Baker's first import).",
+    payload: [...PRODUCT_FIELDS],
+    namesProduct: true
+  },
+  product_updated: {
+    label: "A product is changed",
+    sentence: "When a product in your Shopify store is changed",
+    description: "Its price, title, status, publication, handle, tags, type, vendor or description changed; stock changes and changes Baker made do not count.",
+    payload: [
+      "title",
+      "handle",
+      "changed",
+      "before_title",
+      "before_price",
+      "before_status",
+      "before_published",
+      "price_changes",
+      ...PRODUCT_FIELDS.slice(2)
+    ],
+    namesProduct: true
+  },
+  collection_updated: {
+    label: "A collection changes",
+    sentence: "When a collection in your Shopify store changes",
+    description: "A collection is created, renamed, published or unpublished, or gains or loses products.",
+    payload: ["title", "collection", "changed", "product_count", "before_product_count", "published", "store"],
+    namesProduct: false
+  },
+  purchase: {
+    label: "An order is paid",
+    sentence: "When an order is paid",
+    description: "The store's sale; value is the order's total in the store's currency.",
+    payload: ["order_name", "ordered_at", "shopify_source", "visitor_from", "campaign_from", "store"],
+    namesProduct: false
+  },
+  refund: {
+    label: "Money is refunded on an order",
+    sentence: "When money is refunded on an order",
+    description: "Money given back on an order; value is the amount refunded.",
+    payload: ["order_name", "store"],
+    namesProduct: false
+  },
+  customer_created: {
+    label: "A new customer signs up",
+    sentence: "When a new customer account is created in your Shopify store",
+    description: "A new customer account, with their country and whether they accept email \u2014 never a name or address.",
+    payload: ["customer", "country", "accepts_email", "orders", "tags", "account_state", "store"],
+    namesProduct: false
+  },
+  checkout_abandoned: {
+    label: "A checkout is abandoned",
+    sentence: "When a shopper leaves a checkout in your Shopify store without buying",
+    description: "A checkout with contact details was not completed after an hour.",
+    payload: [
+      "total",
+      "currency",
+      "items_count",
+      "products",
+      "product_handles",
+      "known_customer",
+      "customer",
+      "discount_codes_count",
+      "started_at",
+      "last_activity_at",
+      "store"
+    ],
+    namesProduct: false
+  },
+  sales_drop: {
+    label: "Sales drop",
+    sentence: "When your Shopify store's sales drop well below usual",
+    description: "The last 6 hours brought far fewer orders than the same hours usually do.",
+    payload: [
+      "window_hours",
+      "window_start",
+      "window_end",
+      "orders",
+      "expected_orders",
+      "revenue",
+      "expected_revenue",
+      "currency",
+      "drop_percent",
+      "baseline_days",
+      "store"
+    ],
+    namesProduct: false
+  }
+};
+var STORE_EVENT_NAMES = Object.keys(STORE_EVENTS);
+
+// ../api/src/scheduledAgentRules.ts
 var CONDITION_OPERATORS = {
   equals: { label: "is", takesValue: true },
   not_equals: { label: "is not", takesValue: true },
@@ -9802,7 +9948,7 @@ import { defineCommand as defineCommand19 } from "citty";
 function listed(resources) {
   return resources.map((resource) => resource.label ? `${resource.id} (${resource.label})` : resource.id).join("; ");
 }
-function connectedResourceHints({ plural, singular, flag: flag3, resources }) {
+function connectedResourceHints({ plural: plural2, singular, flag: flag3, resources }) {
   if (resources.length === 0) {
     return [];
   }
@@ -9810,7 +9956,7 @@ function connectedResourceHints({ plural, singular, flag: flag3, resources }) {
     return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag3}.`];
   }
   return [
-    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ${flag3} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
+    `This company connected ${resources.length} ${plural2}: ${listed(resources)}. Each command works on one, so pass ${flag3} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
   ];
 }
 
@@ -12102,11 +12248,11 @@ function parseKeywordEntry(raw, defaultMatch) {
 function rawTextEntries(value, rawArgs) {
   return repeatedValues(rawArgs, "text", value).flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
-function rawFileEntries(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function rawFileEntries(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return [];
   }
-  return readFileSync2(path48, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path49, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args5, rawArgs) {
   const defaultMatch = typeof args5["match-type"] === "string" ? args5["match-type"].toUpperCase() : void 0;
@@ -12129,14 +12275,14 @@ function keywordEntries(args5, rawArgs) {
   }
   return entries;
 }
-function loadJsonFileArg(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadJsonFileArg(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return {};
   }
-  const inline = path48.trimStart().startsWith("{");
-  const source = inline ? "inline JSON" : path48;
+  const inline = path49.trimStart().startsWith("{");
+  const source = inline ? "inline JSON" : path49;
   try {
-    const parsed = JSON.parse(inline ? path48 : readFileSync2(path48, "utf8"));
+    const parsed = JSON.parse(inline ? path49 : readFileSync2(path49, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
       failWriteValidation(`${source} must contain a JSON object`);
     }
@@ -12273,10 +12419,10 @@ async function stageUpdate(kind, customerId, target2, payload, hints2) {
 async function stageTarget(kind, customerId, target2, hints2) {
   await stageGoogleOp({ kind, customerId, target: target2 }, hints2);
 }
-async function draftAction(path48, body, chat) {
+async function draftAction(path49, body, chat) {
   try {
     const chatId = resolveChatId(chat);
-    const response = await apiPost(path48, { chatId, ...body });
+    const response = await apiPost(path49, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -14694,14 +14840,14 @@ function mappingRowProblem(row) {
 
 // ../api/src/event-sources/template.ts
 var MENTION = /\{\{\s*([^{}]+?)\s*\}\}/g;
-function mentionOf(path48) {
-  return `{{${path48}}}`;
+function mentionOf(path49) {
+  return `{{${path49}}}`;
 }
 function templateMentions(template) {
   const seen = [];
   for (const match of template.matchAll(MENTION)) {
-    const path48 = (match[1] ?? "").trim();
-    if (path48 !== "" && !seen.includes(path48)) seen.push(path48);
+    const path49 = (match[1] ?? "").trim();
+    if (path49 !== "" && !seen.includes(path49)) seen.push(path49);
   }
   return seen;
 }
@@ -18071,17 +18217,17 @@ function ignoredColumnHints(columns) {
     `Ignored ${columns.length} column(s) that are not part of a conversion: ${columns.join(", ")}. A conversion carries an order id, a date, and something to match on: a click id (gclid / gbraid / wbraid), an email, a phone, or all four of givenName + familyName + country + postalCode. Optionally a value + currency, conversionCount, and eventSource (WEB / APP / IN_STORE / PHONE / OTHER). A column named just \`Name\` is ignored on purpose \u2014 Google needs the first and last name separately, so split it before re-running.`
   ];
 }
-function readRowsFile(path48) {
-  const inline = path48.trimStart().startsWith("[") || path48.trimStart().startsWith("{");
+function readRowsFile(path49) {
+  const inline = path49.trimStart().startsWith("[") || path49.trimStart().startsWith("{");
   let text2;
   try {
-    text2 = inline ? path48 : readFileSync4(path48, "utf8");
+    text2 = inline ? path49 : readFileSync4(path49, "utf8");
   } catch (err) {
-    failWriteValidation(`could not read ${path48}: ${err instanceof Error ? err.message : String(err)}`);
+    failWriteValidation(`could not read ${path49}: ${err instanceof Error ? err.message : String(err)}`);
   }
   const parsed = parseConversionRowsText(text2);
   if (!parsed.ok) {
-    failWriteValidation(`${inline ? "the conversions passed inline" : path48}: ${parsed.error}`);
+    failWriteValidation(`${inline ? "the conversions passed inline" : path49}: ${parsed.error}`);
   }
   return { rows: parsed.rows, ignoredColumns: parsed.ignoredColumns };
 }
@@ -19956,19 +20102,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadJsonFileArg2(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync5(path48, "utf8"));
+    const parsed = JSON.parse(readFileSync5(path49, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path48} must contain a JSON object`);
+      failWriteValidation2(`${path49} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path48} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path49} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -20053,15 +20199,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadTargetingFileArg(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path48);
+  const parsed = loadJsonFileArg2(path49);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path48} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path49} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -20096,14 +20242,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell3) => cell3.trim());
 }
-function parseListFileArg(path48, maxRows) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function parseListFileArg(path49, maxRows) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return void 0;
   }
-  const raw = readFileSync5(path48, "utf8");
+  const raw = readFileSync5(path49, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path48} needs a header row and at least one data row`);
+    failWriteValidation2(`${path49} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -20122,7 +20268,7 @@ function parseListFileArg(path48, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path48} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path49} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -20218,11 +20364,11 @@ function readPositionals(args5) {
 function splitIdList(raw) {
   return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function idsFileEntries(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function idsFileEntries(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return [];
   }
-  return readFileSync5(path48, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  return readFileSync5(path49, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
 }
 function requireTargets(args5, entity) {
   const positionals = readPositionals(args5);
@@ -23022,9 +23168,9 @@ function compactRow(row) {
     ...destination.postUrn ? { postUrn: destination.postUrn } : {}
   };
 }
-function readPath2(row, path48) {
+function readPath2(row, path49) {
   let current = row;
-  for (const segment of path48.split(".")) {
+  for (const segment of path49.split(".")) {
     const record = asRecord(current);
     if (!record) return void 0;
     current = record[segment];
@@ -23034,10 +23180,10 @@ function readPath2(row, path48) {
 function projectFields(rows, paths) {
   return rows.map((row) => {
     const projected = {};
-    for (const path48 of paths) {
-      const value = readPath2(row, path48);
+    for (const path49 of paths) {
+      const value = readPath2(row, path49);
       if (value !== void 0) {
-        projected[path48] = value;
+        projected[path49] = value;
       }
     }
     return projected;
@@ -24188,54 +24334,54 @@ function buildCustomConversionRule(input) {
 function customConversionRuleRefusal(rule) {
   return ruleNodeRefusal(rule, "rule");
 }
-function branchRefusal(key, value, path48) {
+function branchRefusal(key, value, path49) {
   if (!Array.isArray(value) || value.length === 0) {
-    return `${path48}.${key} must be a non-empty array of conditions \u2014 an empty one counts every event the pixel sends`;
+    return `${path49}.${key} must be a non-empty array of conditions \u2014 an empty one counts every event the pixel sends`;
   }
   for (const [index, child] of value.entries()) {
-    const refusal = ruleNodeRefusal(child, `${path48}.${key}[${index}]`);
+    const refusal = ruleNodeRefusal(child, `${path49}.${key}[${index}]`);
     if (refusal) {
       return refusal;
     }
   }
   return void 0;
 }
-function conditionRefusal(key, value, path48) {
-  return key === "and" || key === "or" ? branchRefusal(key, value, path48) : leafRefusal(key, value, path48);
+function conditionRefusal(key, value, path49) {
+  return key === "and" || key === "or" ? branchRefusal(key, value, path49) : leafRefusal(key, value, path49);
 }
-function ruleNodeRefusal(node, path48) {
+function ruleNodeRefusal(node, path49) {
   if (!isRecord2(node)) {
-    return `${path48} must be an object like {"URL":{"i_contains":"/thank-you"}}`;
+    return `${path49} must be an object like {"URL":{"i_contains":"/thank-you"}}`;
   }
   const entries = Object.entries(node);
   if (entries.length === 0) {
-    return `${path48} is empty \u2014 a rule with no condition counts every event the pixel sends`;
+    return `${path49} is empty \u2014 a rule with no condition counts every event the pixel sends`;
   }
   if (entries.length > 1) {
-    return `${path48} names ${entries.length} conditions side by side (${entries.map(([key]) => key).join(", ")}) \u2014 Meta reads one branch or one field test per object, so combine them with {"and":[\u2026]}`;
+    return `${path49} names ${entries.length} conditions side by side (${entries.map(([key]) => key).join(", ")}) \u2014 Meta reads one branch or one field test per object, so combine them with {"and":[\u2026]}`;
   }
   for (const [key, value] of entries) {
-    const refusal = conditionRefusal(key, value, path48);
+    const refusal = conditionRefusal(key, value, path49);
     if (refusal) {
       return refusal;
     }
   }
   return void 0;
 }
-function leafRefusal(field, condition, path48) {
+function leafRefusal(field, condition, path49) {
   if (!isRecord2(condition)) {
-    return `${path48}.${field} must be a test like {"i_contains":"/thank-you"}, not a bare value`;
+    return `${path49}.${field} must be a test like {"i_contains":"/thank-you"}, not a bare value`;
   }
   const tests = Object.entries(condition);
   if (tests.length === 0) {
-    return `${path48}.${field} names no test \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")}`;
+    return `${path49}.${field} names no test \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")}`;
   }
   if (tests.length > 1) {
-    return `${path48}.${field} names ${tests.length} operators at once (${tests.map(([operator]) => operator).join(", ")}) \u2014 test a field once per condition and combine them with {"and":[\u2026]}`;
+    return `${path49}.${field} names ${tests.length} operators at once (${tests.map(([operator]) => operator).join(", ")}) \u2014 test a field once per condition and combine them with {"and":[\u2026]}`;
   }
   for (const [operator] of tests) {
     if (!RULE_OPERATORS[operator]) {
-      return `${path48}.${field} uses "${operator}", which is not a Meta rule operator \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")} (URL matching is i_contains, not contains or includes)`;
+      return `${path49}.${field} uses "${operator}", which is not a Meta rule operator \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")} (URL matching is i_contains, not contains or includes)`;
     }
   }
   return void 0;
@@ -24950,11 +25096,11 @@ var updateStatusSchema = z36.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path48) {
+function validateDailyBudgetFloor(money, ctx, path49) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path48, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path49, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -25816,19 +25962,19 @@ function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg3(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadJsonFileArg3(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync9(path48, "utf8"));
+    const parsed = JSON.parse(readFileSync9(path49, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path48} must contain a JSON object`);
+      failWriteValidation3(`${path49} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path48} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path49} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -31429,12 +31575,12 @@ function flowExists(slug) {
   return existsSync3(join2(flowsDir(), slug, "_data.json"));
 }
 function readFlowTree(slug) {
-  const path48 = join2(flowsDir(), slug, "_data.json");
-  if (!existsSync3(path48)) {
+  const path49 = join2(flowsDir(), slug, "_data.json");
+  if (!existsSync3(path49)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync11(path48, "utf-8"));
+    return JSON.parse(readFileSync11(path49, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -32327,12 +32473,12 @@ function readPeopleFile(args5) {
 }
 function unreadablePeopleFile(args5) {
   if (!args5["people-file"]) return void 0;
-  const path48 = String(args5["people-file"]);
+  const path49 = String(args5["people-file"]);
   try {
-    readFileSync12(path48, "utf8");
+    readFileSync12(path49, "utf8");
     return void 0;
   } catch {
-    return `Couldn't read --people-file ${path48}. Check the path, or pass the people inline with --person.`;
+    return `Couldn't read --people-file ${path49}. Check the path, or pass the people inline with --person.`;
   }
 }
 function peopleLimitError(args5) {
@@ -33304,11 +33450,11 @@ function parseFieldArgs(argv) {
   for (const pair of parseRepeated(argv, "--field")) {
     const eq = pair.indexOf("=");
     const field = eq === -1 ? pair : pair.slice(0, eq);
-    const path48 = eq === -1 ? "" : pair.slice(eq + 1).trim();
+    const path49 = eq === -1 ? "" : pair.slice(eq + 1).trim();
     const problem = mappingRowProblem(field);
     if (problem !== null) throw new ConversionArgsError(problem);
-    if (path48 === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
-    mapping[field] = path48;
+    if (path49 === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
+    mapping[field] = path49;
   }
   return mapping;
 }
@@ -34905,11 +35051,11 @@ function unwrap(response) {
   }
   return response.data;
 }
-async function readAvatars(path48, params2) {
-  return unwrap(await apiGet(path48, params2));
+async function readAvatars(path49, params2) {
+  return unwrap(await apiGet(path49, params2));
 }
-async function writeAvatars(path48, body) {
-  return unwrap(await apiPost(path48, body));
+async function writeAvatars(path49, body) {
+  return unwrap(await apiPost(path49, body));
 }
 
 // src/commands/avatars/create.ts
@@ -35818,12 +35964,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: path48, source } of sources) {
-    const dir = posix.dirname(path48);
+  for (const { path: path49, source } of sources) {
+    const dir = posix.dirname(path49);
     for (const face of declaredFontFaces(source)) {
       if (!wanted.has(face.family)) continue;
       const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
-      perFile.set(path48, [...perFile.get(path48) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      perFile.set(path49, [...perFile.get(path49) ?? [], rebaseFontFaceSrc(face.block, dir)]);
       byFamily.set(face.family, perFile);
     }
   }
@@ -36023,9 +36169,9 @@ function fontsourceFamilies(css) {
   return out;
 }
 function asAuthored(css, normalized) {
-  const escaped = normalized.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const escaped2 = normalized.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const text2 = stripCssComments(css);
-  return text2.match(new RegExp(`["']${escaped}["']`, "i"))?.[0]?.slice(1, -1) ?? text2.match(new RegExp(`(?<![\\w-])${escaped}(?![\\w-])`, "i"))?.[0] ?? normalized;
+  return text2.match(new RegExp(`["']${escaped2}["']`, "i"))?.[0]?.slice(1, -1) ?? text2.match(new RegExp(`(?<![\\w-])${escaped2}(?![\\w-])`, "i"))?.[0] ?? normalized;
 }
 function unresolvedBrandFamilies(css) {
   const declared = [...parseBrandTokens(css, "").fonts].filter((family) => !GENERIC_FAMILIES.has(family));
@@ -41015,10 +41161,10 @@ function runDirsToPrune(entries, keep, currentRunId) {
   return runs.slice(0, Math.max(0, runs.length - keep));
 }
 async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
-  const { readdir: readdir16 } = await import("fs/promises");
+  const { readdir: readdir17 } = await import("fs/promises");
   let entries;
   try {
-    entries = await readdir16(outputsDir);
+    entries = await readdir17(outputsDir);
   } catch {
     return;
   }
@@ -48607,10 +48753,10 @@ function parseValueExpression(raw) {
   return parts.map(parsePart);
 }
 function trackingFieldIds() {
-  const path48 = join4(flowsDir(), "..", "tracking.ts");
-  if (!existsSync6(path48)) return null;
+  const path49 = join4(flowsDir(), "..", "tracking.ts");
+  if (!existsSync6(path49)) return null;
   try {
-    const source = readFileSync14(path48, "utf-8");
+    const source = readFileSync14(path49, "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]);
@@ -49184,13 +49330,13 @@ function specsFromFile(parsed) {
     return `${destField}${type}=${entry?.value ?? ""}`;
   });
 }
-function readSpecFile(path48) {
+function readSpecFile(path49) {
   let raw;
   try {
-    raw = path48 === "-" ? readFileSync15(0, "utf-8") : readFileSync15(path48, "utf-8");
+    raw = path49 === "-" ? readFileSync15(0, "utf-8") : readFileSync15(path49, "utf-8");
   } catch (error) {
     refuse(
-      `Could not read ${path48 === "-" ? "the mapping from stdin" : `"${path48}"`}: ${error instanceof Error ? error.message : String(error)}`
+      `Could not read ${path49 === "-" ? "the mapping from stdin" : `"${path49}"`}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   let parsed;
@@ -49198,7 +49344,7 @@ function readSpecFile(path48) {
     parsed = JSON.parse(raw);
   } catch (error) {
     refuse(
-      `${path48 === "-" ? "stdin" : `"${path48}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      `${path49 === "-" ? "stdin" : `"${path49}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
       'Expected { "map": { "<destField>": "<value>", \u2026 } }'
     );
   }
@@ -49497,21 +49643,21 @@ var ARRAY_FIELDS = [
   "tagIds"
 ];
 var ARRAY_OWNERS = ["", "body"];
-function dropUnsetOptionals(sideEffect, path48) {
+function dropUnsetOptionals(sideEffect, path49) {
   return OPTIONAL_STRINGS.flatMap((key) => {
     if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
     delete sideEffect[key];
-    return [{ path: path48, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+    return [{ path: path49, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
   });
 }
-function fillNulledArrays(target2, prefix, path48) {
+function fillNulledArrays(target2, prefix, path49) {
   return ARRAY_FIELDS.flatMap((key) => {
     if (!(key in target2) || target2[key] !== null) return [];
     target2[key] = [];
-    return [{ path: path48, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+    return [{ path: path49, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
   });
 }
-function tidyEmailRecipients(sideEffect, path48) {
+function tidyEmailRecipients(sideEffect, path49) {
   if (sideEffect.type !== "email") return [];
   const config = sideEffect.encryptedConfig;
   if (!config || typeof config !== "object" || Array.isArray(config)) return [];
@@ -49522,7 +49668,7 @@ function tidyEmailRecipients(sideEffect, path48) {
   const tidied = to.join(", ");
   if (tidied === raw) return [];
   config.email = tidied;
-  return [{ path: path48, change: "tidied the recipient list's spacing and separators" }];
+  return [{ path: path49, change: "tidied the recipient list's spacing and separators" }];
 }
 function sideEffectsOf(node) {
   if (!Array.isArray(node.sideEffects)) return [];
@@ -49531,13 +49677,13 @@ function sideEffectsOf(node) {
   );
 }
 function normalizeSideEffect(sideEffect, where) {
-  const path48 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const path49 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
   const arrays = ARRAY_OWNERS.flatMap((owner) => {
     const target2 = owner ? sideEffect[owner] : sideEffect;
     if (!target2 || typeof target2 !== "object") return [];
-    return fillNulledArrays(target2, owner ? `${owner}.` : "", path48);
+    return fillNulledArrays(target2, owner ? `${owner}.` : "", path49);
   });
-  return [...dropUnsetOptionals(sideEffect, path48), ...arrays, ...tidyEmailRecipients(sideEffect, path48)];
+  return [...dropUnsetOptionals(sideEffect, path49), ...arrays, ...tidyEmailRecipients(sideEffect, path49)];
 }
 function normalizeFlowTree(tree) {
   const changes = [];
@@ -50927,10 +51073,10 @@ async function stageOps(ops) {
     handleError5(err);
   }
 }
-async function draftAction2(path48, body, chat) {
+async function draftAction2(path49, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path48, { chatId, ...body });
+    const data = await apiPost(path49, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -53459,9 +53605,9 @@ async function readImageBuffer(pathOrUrl) {
   }
   return readFile28(pathOrUrl);
 }
-async function isDirectory(path48) {
+async function isDirectory(path49) {
   try {
-    const s = await stat7(path48);
+    const s = await stat7(path49);
     return s.isDirectory();
   } catch {
     return false;
@@ -53889,13 +54035,13 @@ function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDi
 }
 function disambiguate(paths) {
   const taken = /* @__PURE__ */ new Set();
-  return paths.map((path48) => {
-    if (!taken.has(path48)) {
-      taken.add(path48);
-      return path48;
+  return paths.map((path49) => {
+    if (!taken.has(path49)) {
+      taken.add(path49);
+      return path49;
     }
-    const ext = extname3(path48);
-    const stem = path48.slice(0, path48.length - ext.length);
+    const ext = extname3(path49);
+    const stem = path49.slice(0, path49.length - ext.length);
     let n = 2;
     while (taken.has(`${stem}-${n}${ext}`)) n += 1;
     const unique = `${stem}-${n}${ext}`;
@@ -54021,10 +54167,10 @@ async function runDownloads(plan) {
   const paths = disambiguate(fetched.map((item) => item.path));
   const downloaded = [];
   for (const [index, item] of fetched.entries()) {
-    const path48 = paths[index] ?? item.path;
+    const path49 = paths[index] ?? item.path;
     try {
-      await atomicWrite(path48, item.buffer);
-      downloaded.push({ input: item.input, output: path48, bytes: item.buffer.length, contentType: item.contentType });
+      await atomicWrite(path49, item.buffer);
+      downloaded.push({ input: item.input, output: path49, bytes: item.buffer.length, contentType: item.contentType });
     } catch (err) {
       failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
     }
@@ -63938,7 +64084,7 @@ var createCommand3 = defineCommand197({
       if (template.length === 0 && (!prompt || prompt.trim().length === 0)) {
         failValidation4("--prompt is required: it is the whole of what a run does. Or pass --template to copy a brief.");
       }
-      const trigger = buildTriggerBody(args5, { required: true });
+      const trigger = buildTriggerBody(args5, { required: template.length === 0 });
       const reaction = reactionBody(args5);
       const body = {
         chatId: requireChatId(),
@@ -64623,7 +64769,7 @@ var schemaCommand2 = defineCommand208({
 });
 
 // src/commands/shopify/index.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand211 } from "citty";
 
 // src/commands/shopify/buyers.ts
 import { defineCommand as defineCommand209 } from "citty";
@@ -65931,7 +66077,8 @@ function timingHints(answer) {
   const peak = [...answer.rows].sort((a, b) => b.orders - a.orders)[0];
   if (!peak || peak.orders === 0) return [];
   const zone = answer.window.timezone ? `, ${answer.window.timezone}` : "";
-  return [`Most orders are placed on ${peak.label} (store time${zone}): weight budgets and sends towards it.`];
+  const when = answer.by === "hour" ? `at ${peak.label}` : answer.by === "month_of_year" ? `in ${peak.label}` : `on ${peak.label}`;
+  return [`Most orders are placed ${when} (store time${zone}): weight budgets and sends towards it.`];
 }
 function salesHints(answer) {
   const hints2 = [];
@@ -66270,6 +66417,273 @@ var segmentsCommand = defineCommand209({
   }
 });
 
+// src/commands/shopify/promotions.ts
+import { defineCommand as defineCommand210 } from "citty";
+
+// src/commands/shopify/landingLinks.ts
+import { readdir as readdir16, readFile as readFile33, stat as stat11 } from "fs/promises";
+import path47 from "path";
+var PAGES_MAX = 300;
+var FILE_BYTES_MAX = 256 * 1024;
+function escaped(text2) {
+  return text2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function evidenceIn(text2, keys) {
+  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");
+  if (keys.handle && page.test(text2)) evidence.push("product_page");
+  const option = keys.variantIds.some(
+    (id) => new RegExp(`(?:/cart/(?:\\d+:\\d+,)*${id}:|variant=${id}(?!\\d))`).test(text2)
+  );
+  if (option) evidence.push("variant_id");
+  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)));
+    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"];
+  return [...bySlug].map(([slug, evidence]) => ({ slug, evidence: order.filter((entry) => evidence.has(entry)) }));
+}
+async function isDir4(target2) {
+  try {
+    return (await stat11(target2)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function readWorkspacePages(root) {
+  const dir = path47.join(root, "src/pages");
+  if (!await isDir4(dir)) return null;
+  let entries;
+  try {
+    entries = await readdir16(dir, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+  const slugs = entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith("_")).map((entry) => entry.name);
+  const pages = [];
+  for (const slug of slugs.slice(0, PAGES_MAX)) {
+    const files = [];
+    for (const file of await landingGraphFiles(root, slug)) {
+      try {
+        const absolute = path47.join(root, file);
+        if ((await stat11(absolute)).size > FILE_BYTES_MAX) continue;
+        files.push({ path: file, text: await readFile33(absolute, "utf8") });
+      } catch {
+      }
+    }
+    pages.push({ slug, files });
+  }
+  return { pages, skipped: Math.max(0, slugs.length - PAGES_MAX) };
+}
+
+// src/commands/shopify/promotionHints.ts
+var PLATFORM = { "google-ads": "Google Ads", meta: "Meta" };
+function plural(count2, one, many = `${one}s`) {
+  return `${count2} ${count2 === 1 ? one : many}`;
+}
+function pauseCommand2(ad) {
+  if (ad.platform === "meta") return `\`baker ads meta ads pause ${ad.id ?? "<id>"}\``;
+  const target2 = `${ad.resource ?? "<resource>"} --customer-id ${ad.account_id ?? "<account_id>"}`;
+  return ad.level === "asset_group" ? `\`baker ads google asset-groups update ${target2} --status PAUSED\`` : `\`baker ads google ads pause ${target2}\``;
+}
+function pauseHint(answer) {
+  const active = answer.ads.filter((ad) => ad.status === "active");
+  if (answer.product.stock === "in_stock" || active.length === 0) return null;
+  const one = active.length === 1;
+  const remembered = answer.remembered ? " A pause is remembered for this product only because you read its promotions here." : "";
+  return `${plural(active.length, "active ad")} still ${one ? "sends" : "send"} people to \u201C${answer.product.title}\u201D, which is out of stock. Stage pausing ${one ? "it" : "them"}: ${active.map(pauseCommand2).join("; ")}.${remembered}`;
+}
+function promotionHints(answer, scan) {
+  const hints2 = [];
+  const pause = pauseHint(answer);
+  if (pause) hints2.push(pause);
+  if (answer.shopping.length > 0 || answer.catalog_ads > 0) {
+    hints2.push(
+      "Shopping campaigns and catalog ads stop showing a product nobody can buy by themselves \u2014 never pause them for one product."
+    );
+  }
+  for (const missed of answer.checked.not_checked) {
+    hints2.push(
+      `${PLATFORM[missed.platform] ?? missed.platform} could not be checked (${missed.reason}); say so rather than that nothing runs there.`
+    );
+  }
+  for (const landing of answer.landings.filter((entry) => !entry.published)) {
+    hints2.push(`/${landing.slug} links to this product but is not live; no ad can send people to it yet.`);
+  }
+  if (answer.ads.length === 0 && answer.landings.length === 0 && answer.shopping.length === 0) {
+    hints2.push(`Nothing advertises \u201C${answer.product.title}\u201D that Baker can see: nothing to pause.`);
+  }
+  if (!scan.scanned) {
+    hints2.push(
+      "This workspace's pages were not read (no src/pages here), so landings are from Baker's last scan and measured visits only."
+    );
+  } else if (scan.skippedPages > 0) {
+    hints2.push(`${plural(scan.skippedPages, "page")} not checked for links to this product (past the 300-page bound).`);
+  }
+  if (!answer.remembered) {
+    hints2.push(
+      "This read was not remembered for a Session (no chat): a pause staged from it will not be undone when the product is back."
+    );
+  }
+  return hints2;
+}
+function holdName(hold) {
+  return `${PLATFORM[hold.platform]} ${hold.level.replace("_", " ")} ${hold.name ? `\u201C${hold.name}\u201D` : hold.entity_id}`;
+}
+var GOOGLE_GROUP = {
+  campaign: "campaigns",
+  ad_group: "ad-groups",
+  ad: "ads",
+  asset_group: "asset-groups",
+  adset: "ads"
+};
+function googleResume(hold) {
+  const target2 = `${hold.entity_id} --customer-id ${hold.account_id}`;
+  return hold.level === "asset_group" ? `baker ads google asset-groups update ${target2} --status ENABLED` : `baker ads google ${GOOGLE_GROUP[hold.level]} resume ${target2}`;
+}
+var META_GROUP = {
+  campaign: "campaigns",
+  ad_group: "adsets",
+  ad: "ads",
+  asset_group: "ads",
+  adset: "adsets"
+};
+function resumeCommand2(hold) {
+  return hold.platform === "meta" ? `\`baker ads meta ${META_GROUP[hold.level]} resume ${hold.entity_id}\`` : `\`${googleResume(hold)}\``;
+}
+function stockHoldHints(answer) {
+  const hints2 = [];
+  const held = answer.holds.filter((hold) => hold.state === "held");
+  if (answer.holds.length === 0)
+    hints2.push("Nothing was paused because this product ran out: there is nothing to resume.");
+  const resumable = held.filter((hold) => hold.verdict === "resumable");
+  if (resumable.length > 0) {
+    hints2.push(
+      `${resumable.length} can be resumed: stage ${resumable.map(resumeCommand2).join("; ")}. Resume nothing else.`
+    );
+  }
+  for (const hold of held) {
+    if (hold.verdict === "changed_since") {
+      hints2.push(`${holdName(hold)} was changed by someone after Baker paused it: leave it, and tell the user.`);
+    } else if (hold.verdict === "still_promotes_out_of_stock") {
+      hints2.push(
+        `${holdName(hold)} still sends people to \u201C${hold.verdict_detail ?? "another product"}\u201D, which is out: leave it until that is back.`
+      );
+    } else if (hold.verdict === "cannot_confirm") {
+      hints2.push(
+        `${holdName(hold)} could not be confirmed as untouched since Baker paused it: leave it, and tell the user to check it.`
+      );
+    } else if (hold.verdict === "already_active") {
+      hints2.push(`${holdName(hold)} is already running again: nothing to do.`);
+    }
+  }
+  for (const session of answer.pending_sessions) {
+    hints2.push(
+      `The out-of-stock work \u201C${session.title}\u201D is still waiting for review and would pause ${plural(session.staged_pauses, "ad")} for this product: tell the user to discard it.`
+    );
+  }
+  return hints2;
+}
+
+// src/commands/shopify/promotions.ts
+registerSchema({
+  command: "shopify.promotions",
+  description: "Start here when a product runs out of stock or comes back: what is advertising it \u2014 ads on Google Ads and Meta that lead to its store page, its buy link or a landing that links to it (`via`), the landings themselves (from this workspace's pages, and from measured visits), and the Shopping campaigns and catalog ads that show it (they stop by themselves when it runs out \u2014 never pause them). Read it in the Session that pauses: a pause is remembered \u2014 and undone when the product is back in stock \u2014 only for a product whose promotions that Session read. `checked.not_checked` names a platform Baker could not read.",
+  args: {
+    product: { type: "positional", description: "Product id, handle, or a link to the product", required: true },
+    full: {
+      ...fullArg,
+      description: "Add each ad's campaign and ad group or ad set ids and its URL (its id, account and Google resource name are always there)"
+    }
+  }
+});
+registerSchema({
+  command: "shopify.stock-holds",
+  description: "Start here when a product is back in stock: the ads Baker paused because it ran out, each with a `verdict` \u2014 `resumable` (resume it), `still_out_of_stock`, `changed_since` (someone changed it after Baker paused it: leave it), `already_active`, `still_promotes_out_of_stock` (it also sends people to another product that is still out: `verdict_detail` names it), `cannot_confirm`. Resume only what is resumable. `pending_sessions` lists out-of-stock work still waiting for review that would pause this product's ads: tell the user to discard it.",
+  args: {
+    product: { type: "string", description: "Only one product's holds: its id, handle or link", required: false },
+    all: { type: "boolean", description: "Resolved holds too (resumed or released)", required: false, default: false },
+    full: fullArg
+  }
+});
+var promotionsCommand = defineCommand210({
+  meta: {
+    name: "promotions",
+    description: "What advertises one product: ads that lead to it, landings that link to it, Shopping that shows it. Example: baker shopify promotions 10310413942969"
+  },
+  args: {
+    product: { type: "positional", description: "Product id, handle, or a link to the product", required: true },
+    full: {
+      type: "boolean",
+      description: "Add campaign and ad group or ad set ids and URLs",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const positionals = Array.isArray(args5._) ? args5._ : [];
+      if (positionals.length > 1) {
+        throw new ApiError("VALIDATION_ERROR", "product: Pass one product id, handle or product link.");
+      }
+      const { product, store } = await apiGet(
+        "/api/shopify/product",
+        params({ ref: args5.product })
+      );
+      const scan = await readWorkspacePages(process.cwd());
+      const linked = scan ? landingLinksOf(scan.pages, {
+        handle: product.handle,
+        variantIds: product.variants.map((variant) => variant.variantId),
+        buyUrls: product.variants.flatMap((variant) => variant.buyUrl ? [variant.buyUrl] : [])
+      }) : void 0;
+      const answer = await apiPost("/api/shopify/promotions", {
+        product: product.productId,
+        ...linked ? { linked_landings: linked.slice(0, 50) } : {},
+        scanned: scan !== null,
+        ...args5.full ? { full: true } : {}
+      });
+      emit2(answer, { store }, [
+        ...storeStateHints(store),
+        ...promotionHints(answer, { scanned: scan !== null, skippedPages: scan?.skipped ?? 0 })
+      ]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+var stockHoldsCommand = defineCommand210({
+  meta: {
+    name: "stock-holds",
+    description: "The ads Baker paused because a product ran out, and whether each may be resumed now. Example: baker shopify stock-holds --product 10310413942969"
+  },
+  args: {
+    product: { type: "string", description: "Only one product: its id, handle or link", required: false },
+    all: { type: "boolean", description: "Resolved holds too", required: false, default: false },
+    full: { type: "boolean", description: "Everything Baker keeps", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const answer = await apiGet(
+        "/api/shopify/stock-holds",
+        params({ product: args5.product, all: args5.all, full: args5.full })
+      );
+      const { store, ...data } = answer;
+      emit2(data, { store, count: answer.holds.length }, [...storeStateHints(store), ...stockHoldHints(answer)]);
+    } catch (err) {
+      fail9(err);
+    }
+  }
+});
+
 // src/commands/shopify/index.ts
 registerSchema({
   command: "shopify.store",
@@ -66398,7 +66812,7 @@ registerSchema({
     }
   }
 });
-var salesCommand = defineCommand210({
+var salesCommand = defineCommand211({
   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"
@@ -66436,7 +66850,7 @@ var salesCommand = defineCommand210({
     }
   }
 });
-var storeCommand = defineCommand210({
+var storeCommand = defineCommand211({
   meta: {
     name: "store",
     description: "The connected Shopify store: currency, countries, how many products, what is out of stock. Example: baker shopify store"
@@ -66453,7 +66867,7 @@ var storeCommand = defineCommand210({
     }
   }
 });
-var productsCommand = defineCommand210({
+var productsCommand = defineCommand211({
   meta: {
     name: "products",
     description: 'What the store sells, with price and stock. Example: baker shopify products --search "snowboard" --stock out_of_stock'
@@ -66499,7 +66913,7 @@ var productsCommand = defineCommand210({
     }
   }
 });
-var productCommand = defineCommand210({
+var productCommand = defineCommand211({
   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"
@@ -66562,7 +66976,7 @@ var productCommand = defineCommand210({
     }
   }
 });
-var collectionsCommand = defineCommand210({
+var collectionsCommand = defineCommand211({
   meta: {
     name: "collections",
     description: "The store's collections, with the handles --collection takes. Example: baker shopify collections --full"
@@ -66587,7 +67001,7 @@ var collectionsCommand = defineCommand210({
     }
   }
 });
-var stockCommand2 = defineCommand210({
+var stockCommand2 = defineCommand211({
   meta: {
     name: "stock",
     description: "Every product with options out of stock, naming them. Example: baker shopify stock"
@@ -66611,11 +67025,12 @@ var stockCommand2 = defineCommand210({
     }
   }
 });
-var shopifyCommand = defineCommand210({
+var shopifyCommand = defineCommand211({
   meta: {
     name: "shopify",
     description: `Read the connected Shopify store as Baker keeps it \u2014 products, prices by country, stock, collections,
-product photos, what it sold, and who buys, where and what. Read-only: nothing here changes the store.
+product photos, what it sold, who buys, where and what, and what advertises each product. Read-only:
+nothing here changes the store.
 
 Examples:
   baker shopify store                                # currency, countries, how many products, what is out of stock
@@ -66637,6 +67052,8 @@ Examples:
   baker shopify buyer 1042                           # one numbered customer's orders
   baker shopify segments                             # best, loyal, at risk, new, one-time \u2014 and who to find more of
   baker shopify cohorts --months 12                  # buyers by first-order month: who came back
+  baker shopify promotions <product>                 # what advertises it: ads, landings, Shopping (read before pausing)
+  baker shopify stock-holds --product <product>      # what Baker paused because it ran out, and what may be resumed
 
 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.
@@ -66659,15 +67076,17 @@ Full guide: __tooling__/docs/tools/baker/shopify.md`
     countries: countriesCommand2,
     "best-sellers": bestSellersCommand,
     cohorts: cohortsCommand,
-    segments: segmentsCommand
+    segments: segmentsCommand,
+    promotions: promotionsCommand,
+    "stock-holds": stockHoldsCommand
   }
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 
 // src/commands/studio/spokenPace.ts
 var WORDS_PER_SECOND3 = SPOKEN_WORDS_PER_SECOND;
@@ -66893,7 +67312,7 @@ function parseImageRefs(spec) {
 }
 var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path48) => uploadLocalImage({ file: path48, contentType: detectImageContentType(path48), source: "uploaded" })
+  upload: (path49) => uploadLocalImage({ file: path49, contentType: detectImageContentType(path49), source: "uploaded" })
 };
 async function resolveLibraryImageIds(spec, limit2, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
@@ -66913,10 +67332,10 @@ async function resolveLibraryImageIds(spec, limit2, deps = defaultDeps) {
   }
   return { imageIds, added };
 }
-function uploadFailure(path48) {
+function uploadFailure(path49) {
   return (error) => {
     if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path48}" as an image.`);
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path49}" as an image.`);
   };
 }
 
@@ -67180,7 +67599,7 @@ async function adByHandHintFor(body) {
     return null;
   }
 }
-var animateCommand = defineCommand211({
+var animateCommand = defineCommand212({
   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"
@@ -67305,7 +67724,7 @@ var animateCommand = defineCommand211({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -67441,7 +67860,7 @@ function buildGenerateBody(args5, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand212({
+var generateCommand = defineCommand213({
   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]]'"
@@ -67524,7 +67943,7 @@ var generateCommand = defineCommand212({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand214 } 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.",
@@ -67533,7 +67952,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand213({
+var getCommand5 = defineCommand214({
   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"
@@ -67562,7 +67981,7 @@ var getCommand5 = defineCommand213({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand215 } 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",
@@ -67587,7 +68006,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand214({
+var improveCommand = defineCommand215({
   meta: {
     name: "improve",
     description: `${DESCRIPTION2}
@@ -67631,7 +68050,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand216 } 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.",
@@ -67641,7 +68060,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand215({
+var keepCommand = defineCommand216({
   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"
@@ -67692,7 +68111,7 @@ var keepCommand = defineCommand215({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand217 } 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.",
@@ -67703,7 +68122,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand18 = defineCommand216({
+var listCommand18 = defineCommand217({
   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"
@@ -67737,7 +68156,7 @@ var listCommand18 = defineCommand216({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand218 } 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",
@@ -67824,7 +68243,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand217({
+var modelsCommand = defineCommand218({
   meta: {
     name: "models",
     description: `${DESCRIPTION3}
@@ -67871,13 +68290,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand219 } 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 = defineCommand218({
+var skillsCommand = defineCommand219({
   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"
@@ -67901,7 +68320,7 @@ var skillsCommand = defineCommand218({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand219({
+var studioCommand = defineCommand220({
   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.
@@ -67944,10 +68363,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand221 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync20 } from "fs";
@@ -68014,10 +68433,10 @@ async function stageOp4(op) {
     handleError8(err);
   }
 }
-async function draftAction3(path48, body, chat) {
+async function draftAction3(path49, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path48, { chatId, ...body });
+    const data = await apiPost(path49, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -68070,13 +68489,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand5 = defineCommand220({
+var draftCommand5 = defineCommand221({
   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: defineCommand220({
+    list: defineCommand221({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -68089,7 +68508,7 @@ var draftCommand5 = defineCommand220({
         await draftList2(args5.json === true, args5.chat);
       }
     }),
-    show: defineCommand220({
+    show: defineCommand221({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -68106,7 +68525,7 @@ var draftCommand5 = defineCommand220({
         );
       }
     }),
-    amend: defineCommand220({
+    amend: defineCommand221({
       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."
@@ -68123,7 +68542,7 @@ var draftCommand5 = defineCommand220({
         });
       }
     }),
-    remove: defineCommand220({
+    remove: defineCommand221({
       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 }) => {
@@ -68132,7 +68551,7 @@ var draftCommand5 = defineCommand220({
         });
       }
     }),
-    clear: defineCommand220({
+    clear: defineCommand221({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -68142,7 +68561,7 @@ var draftCommand5 = defineCommand220({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand222 } 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.",
@@ -68183,7 +68602,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand221({
+var containersCommand = defineCommand222({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -68200,7 +68619,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand221({
+var readCommand = defineCommand222({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -68242,7 +68661,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -68298,10 +68717,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand222({
+  return defineCommand223({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand222({
+      create: defineCommand223({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -68323,7 +68742,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand222({
+      update: defineCommand223({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -68343,7 +68762,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand222({
+      delete: defineCommand223({
         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 },
@@ -68384,7 +68803,7 @@ function builtinTypes(args5) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand222({
+var builtinCommand = defineCommand223({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -68394,7 +68813,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand222({
+    enable: defineCommand223({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -68408,7 +68827,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand222({
+    disable: defineCommand223({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -68426,7 +68845,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand223({
+var tagManagerCommand = defineCommand224({
   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.
@@ -68463,7 +68882,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -68543,7 +68962,7 @@ async function listTags(json) {
 var listArgs11 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand19 = defineCommand224({
+var listCommand19 = defineCommand225({
   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"
@@ -68562,7 +68981,7 @@ async function listDraft4(chat) {
     failApi3(err);
   }
 }
-var draftCommand6 = defineCommand224({
+var draftCommand6 = defineCommand225({
   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."
@@ -68572,7 +68991,7 @@ var draftCommand6 = defineCommand224({
     await listDraft4(args5.chat);
   }
 });
-var tagsCommand4 = defineCommand224({
+var tagsCommand4 = defineCommand225({
   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.
@@ -68601,10 +69020,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand229 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -68612,7 +69031,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand225({
+var getCommand6 = defineCommand226({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -68649,7 +69068,7 @@ var getCommand6 = defineCommand225({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -68806,7 +69225,7 @@ function buildListParams(args5) {
   }
   return params2;
 }
-var listCommand20 = defineCommand226({
+var listCommand20 = defineCommand227({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -68866,7 +69285,7 @@ var listCommand20 = defineCommand226({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand228 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -68945,7 +69364,7 @@ function buildSearchRequest(query, args5) {
   }
   return body;
 }
-var searchCommand3 = defineCommand227({
+var searchCommand3 = defineCommand228({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -69009,7 +69428,7 @@ var searchCommand3 = defineCommand227({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand228({
+var testimonialsCommand = defineCommand229({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -69031,10 +69450,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand236 } from "citty";
+import { defineCommand as defineCommand237 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand229 } from "citty";
+import { defineCommand as defineCommand230 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -69048,7 +69467,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand229({
+var deleteCommand4 = defineCommand230({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -69089,7 +69508,7 @@ var deleteCommand4 = defineCommand229({
 });
 
 // src/commands/videos/describe.ts
-import { defineCommand as defineCommand230 } from "citty";
+import { defineCommand as defineCommand231 } 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",
@@ -69106,7 +69525,7 @@ registerSchema({
     full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
   }
 });
-var describeCommand2 = defineCommand230({
+var describeCommand2 = defineCommand231({
   meta: {
     name: "describe",
     description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
@@ -69164,7 +69583,7 @@ Example: baker videos describe j571abc123 --description "Customer explaining how
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand231 } from "citty";
+import { defineCommand as defineCommand232 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -69172,7 +69591,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand7 = defineCommand231({
+var getCommand7 = defineCommand232({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -69209,7 +69628,7 @@ var getCommand7 = defineCommand231({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand233 } 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)",
@@ -69218,7 +69637,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand232({
+var groupCommand2 = defineCommand233({
   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>"
@@ -69238,10 +69657,10 @@ var groupCommand2 = defineCommand232({
 });
 
 // src/commands/videos/ingest.ts
-import { mkdtemp as mkdtemp3, rm as rm9, stat as stat11 } from "fs/promises";
+import { mkdtemp as mkdtemp3, rm as rm9, stat as stat12 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
-import path47 from "path";
-import { defineCommand as defineCommand233 } from "citty";
+import path48 from "path";
+import { defineCommand as defineCommand234 } from "citty";
 
 // src/lib/streamUpload.ts
 import { createHash as createHash2 } from "crypto";
@@ -69405,7 +69824,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand233({
+var ingestCommand2 = defineCommand234({
   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"
@@ -69591,7 +70010,7 @@ function ingestUrl(args5) {
 }
 async function downloadThenIngest(args5, country) {
   const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp3(path47.join(tmpdir4(), "videos-ingest-"));
+  const workDir = await mkdtemp3(path48.join(tmpdir4(), "videos-ingest-"));
   try {
     const probe = await probeYtDlp({ url: args5.url, country, vimeoCookie, cookieDir: workDir });
     if (isAudioOnly(probe.info)) {
@@ -69622,7 +70041,7 @@ async function downloadThenIngest(args5, country) {
       // we allow to fetch it cannot drift apart.
       timeoutMs: downloadTimeoutMs(durationSeconds(probe.info))
     });
-    const stats = await stat11(filePath);
+    const stats = await stat12(filePath);
     if (stats.size > MAX_VIDEO_INGEST_BYTES) {
       throw new ApiError(
         "VALIDATION_ERROR",
@@ -69667,7 +70086,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand235 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -69677,7 +70096,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand234({
+var searchCommand4 = defineCommand235({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -69727,9 +70146,9 @@ var searchCommand4 = defineCommand234({
 var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 
 // src/commands/videos/upload.ts
-import { readFile as readFile33, stat as stat12 } from "fs/promises";
+import { readFile as readFile34, stat as stat13 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand236 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -69771,7 +70190,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand235({
+var uploadCommand2 = defineCommand236({
   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"
@@ -69811,7 +70230,7 @@ var uploadCommand2 = defineCommand235({
       const originalFilename = basename3(filePath);
       const descriptionContext = args5.context;
       if (args5["dry-run"]) {
-        const fileStats = await stat12(filePath);
+        const fileStats = await stat13(filePath);
         writeJson({
           ok: true,
           dryRun: true,
@@ -69824,7 +70243,7 @@ var uploadCommand2 = defineCommand235({
         originalFilename,
         descriptionContext
       });
-      const fileBuffer = await readFile33(filePath);
+      const fileBuffer = await readFile34(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -69855,7 +70274,7 @@ var uploadCommand2 = defineCommand235({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand236({
+var videosCommand = defineCommand237({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, describe, delete, tags.
@@ -69884,10 +70303,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand249 } from "citty";
+import { defineCommand as defineCommand250 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand237 } from "citty";
+import { defineCommand as defineCommand238 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList3(value) {
@@ -69940,7 +70359,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand237({
+var advertisersCommand2 = defineCommand238({
   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'
@@ -69998,7 +70417,7 @@ var advertisersCommand2 = defineCommand237({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand238 } from "citty";
+import { defineCommand as defineCommand239 } 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.",
@@ -70044,7 +70463,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand238({
+var briefCommand = defineCommand239({
   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`
@@ -70080,7 +70499,7 @@ var briefCommand = defineCommand238({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand239 } from "citty";
+import { defineCommand as defineCommand240 } 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.",
@@ -70093,7 +70512,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand239({
+var contentCommand = defineCommand240({
   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"
@@ -70142,7 +70561,7 @@ var contentCommand = defineCommand239({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand240 } from "citty";
+import { defineCommand as defineCommand241 } from "citty";
 function buildFeedParams(input) {
   const params2 = {};
   const advertiser = splitList3(input.advertiser);
@@ -70194,7 +70613,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand2 = defineCommand240({
+var feedCommand2 = defineCommand241({
   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"
@@ -70279,7 +70698,7 @@ var feedCommand2 = defineCommand240({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand241 } from "citty";
+import { defineCommand as defineCommand242 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -70294,7 +70713,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand241({
+var followCommand = defineCommand242({
   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'
@@ -70341,7 +70760,7 @@ var followCommand = defineCommand241({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand242 } from "citty";
+import { defineCommand as defineCommand243 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -70374,7 +70793,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand242({
+var followCompetitorsCommand = defineCommand243({
   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"'
@@ -70449,7 +70868,7 @@ var followCompetitorsCommand = defineCommand242({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand243 } from "citty";
+import { defineCommand as defineCommand244 } 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.",
@@ -70503,7 +70922,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand243({
+var followingCommand = defineCommand244({
   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"
@@ -70539,7 +70958,7 @@ var followingCommand = defineCommand243({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand244 } from "citty";
+import { defineCommand as defineCommand245 } 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.",
@@ -70578,7 +70997,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand244({
+var patternsCommand = defineCommand245({
   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"
@@ -70634,7 +71053,7 @@ var patternsCommand = defineCommand244({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand245 } from "citty";
+import { defineCommand as defineCommand246 } 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.",
@@ -70772,7 +71191,7 @@ function reportSearchError(err) {
   }
   reportError2(err);
 }
-var searchCommand5 = defineCommand245({
+var searchCommand5 = defineCommand246({
   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"
@@ -70892,7 +71311,7 @@ var searchCommand5 = defineCommand245({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand246 } from "citty";
+import { defineCommand as defineCommand247 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -70920,7 +71339,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand246({
+  return defineCommand247({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -70969,7 +71388,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand247 } from "citty";
+import { defineCommand as defineCommand248 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -70977,7 +71396,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand247({
+var unfollowCommand = defineCommand248({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -70998,7 +71417,7 @@ var unfollowCommand = defineCommand247({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand248 } from "citty";
+import { defineCommand as defineCommand249 } 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.",
@@ -71008,7 +71427,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand248({
+var winnersCommand = defineCommand249({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -71058,7 +71477,7 @@ var winnersCommand = defineCommand248({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand249({
+var winningAdsCommand = defineCommand250({
   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.
@@ -71284,7 +71703,7 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion, hasSchema) {
   };
 }
 function commandPathOf(root, argv) {
-  const path48 = [];
+  const path49 = [];
   let command = root;
   for (const token of argv) {
     if (token === "--" || token.startsWith("-")) {
@@ -71295,10 +71714,10 @@ function commandPathOf(root, argv) {
     if (next === void 0 || typeof next !== "object") {
       break;
     }
-    path48.push(token);
+    path49.push(token);
     command = next;
   }
-  return path48.join(" ");
+  return path49.join(" ");
 }
 function refuseUnknownFlags(root, argv) {
   const unknown = findUnknownFlags(root, argv);
@@ -71308,9 +71727,9 @@ function refuseUnknownFlags(root, argv) {
   const command = commandFor(root, argv);
   const first = unknown[0];
   const suggestion = command && first ? suggestFlag(first, command) : null;
-  const path48 = commandPathOf(root, argv);
+  const path49 = commandPathOf(root, argv);
   process.stdout.write(
-    `${JSON.stringify(unknownFlagEnvelope(unknown, path48, suggestion, findSchema(path48.split(" ")) !== void 0), null, 2)}
+    `${JSON.stringify(unknownFlagEnvelope(unknown, path49, suggestion, findSchema(path49.split(" ")) !== void 0), null, 2)}
 `
   );
   process.exit(1);
@@ -71385,7 +71804,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand250({
+var main = defineCommand251({
   meta: {
     name: "baker",
     version: getCliVersion(),