@koda-sl/baker-cli 0.149.0-dev.7b64ca6b5 → 0.150.0-dev.a970fa118

package/dist/cli.js

@@ -24,6 +24,7 @@ import {
   imageProfileFor,
   isPersistedAssetRef,
   looksLikeHttpUrl,
+  nearestSupportedAspectRatio,
   parseRefExpr,
   platformFormats,
   requireCredentialsFromEnv,
@@ -31,10 +32,11 @@ import {
   sha256Hex,
   spineInputFlags,
   spineInputOps,
+  supportsParam,
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-ZBRVPPJP.js";
+} from "./chunk-JBDSJZBZ.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -73,7 +75,7 @@ import {
 } from "./chunk-RK67WL4O.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand178, runMain } from "citty";
+import { defineCommand as defineCommand180, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand18 } from "citty";
@@ -2544,13 +2546,6 @@ var imageDocSchema = z8.object({
   width: z8.number().optional(),
   height: z8.number().optional(),
   aspectRatio: z8.number().optional(),
-  /** Any non-opaque pixel in the decoded image. */
-  hasAlpha: z8.boolean().optional(),
-  /** Opaque pixels ÷ their bounding-box area, 0..1. Feed with `aspectRatio`
-   * into `classifyLogoShape` to tell a brand wordmark from an app-icon plate
-   * before placing it — the library keeps assets forever, so a bad ingest is
-   * otherwise indistinguishable from a good one months later. */
-  solidity: z8.number().optional(),
   dominantColor: z8.string().optional(),
   imagePalette: z8.array(z8.string()).optional(),
   thumbhashDataUri: z8.string().optional(),
@@ -2633,13 +2628,6 @@ var imageSearchResultSchema = z8.object({
   width: z8.number().optional(),
   height: z8.number().optional(),
   aspectRatio: z8.number().optional(),
-  /** Any non-opaque pixel in the decoded image. */
-  hasAlpha: z8.boolean().optional(),
-  /** Opaque pixels ÷ their bounding-box area, 0..1. Feed with `aspectRatio`
-   * into `classifyLogoShape` to tell a brand wordmark from an app-icon plate
-   * before placing it — the library keeps assets forever, so a bad ingest is
-   * otherwise indistinguishable from a good one months later. */
-  solidity: z8.number().optional(),
   dominantColor: z8.string().optional(),
   imagePalette: z8.array(z8.string()).optional(),
   source: z8.string(),
@@ -2721,8 +2709,9 @@ var rgbTriple = z8.tuple([
   z8.number().int().min(0).max(255)
 ]);
 var imageGenerateModelSchema = z8.enum([
+  "openai/gpt-image-2",
+  // Legacy — see the registry entry; kept so pre-switch canvases still run.
   "openai/gpt-5.4-image-2",
-  "google/gemini-3.5-flash",
   "google/gemini-3.1-flash-image-preview",
   "google/gemini-3-pro-image-preview",
   "recraft/recraft-v4.1-pro-vector"
@@ -2763,13 +2752,10 @@ var imagesLogoRequestSchema = z8.object({
   descriptionContext: z8.string().optional()
 });
 var imagesLogoResponseSchema = providerHitsResponseSchema();
-var hexColorSchema = z8.string().transform((value) => value.trim().replace(/^%23/i, "#")).refine((value) => /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(value), {
-  message: "Expected a hex color like #D7FFA4"
-}).transform((value) => value.startsWith("#") ? value : `#${value}`);
 var imagesIconRequestSchema = z8.object({
   name: z8.string().min(1),
   set: z8.string().optional(),
-  color: hexColorSchema.optional(),
+  color: z8.string().optional(),
   width: z8.coerce.number().int().positive().optional(),
   autoIngest: z8.coerce.number().int().min(0).max(20).optional(),
   descriptionContext: z8.string().optional()
@@ -2819,19 +2805,6 @@ var imagesIngestResponseSchema = z8.object({
   contentHash: z8.string()
 });
 
-// ../api/src/logoShape.ts
-var PLATE_SOLIDITY_THRESHOLD = 0.6;
-var WORDMARK_MIN_ASPECT = 1.8;
-function classifyLogoShape({
-  aspectRatio: aspectRatio2,
-  hasAlpha,
-  solidity
-}) {
-  if (solidity === void 0 || aspectRatio2 === void 0) return "unknown";
-  if (solidity >= PLATE_SOLIDITY_THRESHOLD || hasAlpha === false) return "plated-icon";
-  return aspectRatio2 >= WORDMARK_MIN_ASPECT ? "wordmark" : "symbol";
-}
-
 // ../api/src/tags.ts
 import { z as z9 } from "zod";
 var TAG_TYPES = [
@@ -5425,17 +5398,27 @@ var googleDraftStageRequestSchema = z13.object({
   chatId: z13.string(),
   op: googleDraftOpInputSchema
 });
-var googleDraftStageResponseSchema = z13.object({
-  staged: z13.literal(true),
-  ref: z13.string(),
-  kind: googleDraftOpKindSchema,
-  mode: googleWriteModeSchema,
-  dependsOn: z13.array(z13.string()),
-  summary: z13.string(),
-  warnings: z13.array(z13.string()),
-  /** True when the op amended an already-staged op in place instead of appending a new one. */
-  amended: z13.boolean().optional()
-});
+var googleDraftStageResponseSchema = z13.discriminatedUnion("staged", [
+  z13.object({
+    staged: z13.literal(true),
+    ref: z13.string(),
+    kind: googleDraftOpKindSchema,
+    mode: googleWriteModeSchema,
+    dependsOn: z13.array(z13.string()),
+    summary: z13.string(),
+    warnings: z13.array(z13.string()),
+    /** True when the op amended an already-staged op in place instead of appending a new one. */
+    amended: z13.boolean().optional()
+  }),
+  z13.object({
+    staged: z13.literal(false),
+    noop: z13.literal(true),
+    kind: googleDraftOpKindSchema,
+    mode: googleWriteModeSchema,
+    summary: z13.string(),
+    reason: z13.string()
+  })
+]);
 var googleDraftAmendRequestSchema = z13.object({
   chatId: z13.string(),
   ref: z13.string(),
@@ -5462,7 +5445,8 @@ var googleDraftStageBatchResponseSchema = z13.object({
       summary: z13.string(),
       warnings: z13.array(z13.string())
     })
-  )
+  ),
+  skipped: z13.array(z13.object({ kind: googleDraftOpKindSchema, summary: z13.string(), reason: z13.string() })).optional()
 });
 var googleDraftOpViewSchema = z13.object({
   ref: z13.string(),
@@ -5702,11 +5686,11 @@ function rawTextEntries(value) {
   const values = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
   return values.filter((v) => typeof v === "string").flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
-function rawFileEntries(path27) {
-  if (typeof path27 !== "string" || path27.length === 0) {
+function rawFileEntries(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
     return [];
   }
-  return readFileSync2(path27, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path28, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args) {
   const defaultMatch = typeof args["match-type"] === "string" ? args["match-type"].toUpperCase() : void 0;
@@ -5721,7 +5705,7 @@ function keywordEntries(args) {
   const seen = /* @__PURE__ */ new Set();
   for (const item of raw) {
     const entry = parseKeywordEntry(item, defaultMatch);
-    const key = `${entry.text}\0${entry.matchType}`;
+    const key = JSON.stringify([entry.text, entry.matchType]);
     if (!seen.has(key)) {
       seen.add(key);
       entries.push(entry);
@@ -5729,19 +5713,19 @@ function keywordEntries(args) {
   }
   return entries;
 }
-function loadJsonFileArg(path27) {
-  if (typeof path27 !== "string" || path27.length === 0) {
+function loadJsonFileArg(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync2(path27, "utf8"));
+    const parsed = JSON.parse(readFileSync2(path28, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation(`${path27} must contain a JSON object`);
+      failWriteValidation(`${path28} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation(`${path27} is not valid JSON: ${err.message}`);
+      failWriteValidation(`${path28} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -5788,6 +5772,9 @@ function handleGoogleError(err) {
   });
   process.exit(1);
 }
+function noopHints(data) {
+  return data.staged ? [] : [`NOT STAGED \u2014 ${data.reason}. Nothing to publish for this change; say so rather than reporting it as done.`];
+}
 async function stageGoogleOp(raw, hints) {
   const preflight = googleDraftOpInputSchema.safeParse(raw);
   if (!preflight.success) {
@@ -5805,7 +5792,8 @@ async function stageGoogleOp(raw, hints) {
   try {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/google/draft/stage", { chatId, op: preflight.data });
-    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);
+    const allHints = [...noopHints(response.data), ...hints ?? []];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
   } catch (err) {
     handleGoogleError(err);
   }
@@ -5841,7 +5829,14 @@ async function stageGoogleOps(rawOps, hints) {
   try {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/google/draft/stage-batch", { chatId, ops });
-    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);
+    const skipped = response.data.skipped ?? [];
+    const allHints = [
+      ...skipped.length > 0 ? [
+        `${skipped.length} of ${ops.length} op(s) NOT STAGED \u2014 already in the requested state: ${skipped.map((s) => s.reason).join("; ")}`
+      ] : [],
+      ...hints ?? []
+    ];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
   } catch (err) {
     handleGoogleError(err);
   }
@@ -5852,10 +5847,10 @@ async function stageUpdate(kind, customerId, target, payload) {
 async function stageTarget(kind, customerId, target) {
   await stageGoogleOp({ kind, customerId, target });
 }
-async function draftAction(path27, body) {
+async function draftAction(path28, body) {
   try {
     const chatId = requireChatId();
-    const response = await apiPost(path27, { chatId, ...body });
+    const response = await apiPost(path28, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -9438,19 +9433,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path27) {
-  if (typeof path27 !== "string" || path27.length === 0) {
+function loadJsonFileArg2(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync6(path27, "utf8"));
+    const parsed = JSON.parse(readFileSync6(path28, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path27} must contain a JSON object`);
+      failWriteValidation2(`${path28} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path27} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path28} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -9535,15 +9530,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path27) {
-  if (typeof path27 !== "string" || path27.length === 0) {
+function loadTargetingFileArg(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path27);
+  const parsed = loadJsonFileArg2(path28);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path27} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path28} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -9578,14 +9573,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell) => cell.trim());
 }
-function parseListFileArg(path27, maxRows) {
-  if (typeof path27 !== "string" || path27.length === 0) {
+function parseListFileArg(path28, maxRows) {
+  if (typeof path28 !== "string" || path28.length === 0) {
     return void 0;
   }
-  const raw = readFileSync6(path27, "utf8");
+  const raw = readFileSync6(path28, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path27} needs a header row and at least one data row`);
+    failWriteValidation2(`${path28} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -9604,7 +9599,7 @@ function parseListFileArg(path27, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path27} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path28} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -11704,11 +11699,11 @@ var updateStatusSchema = z14.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path27) {
+function validateDailyBudgetFloor(money, ctx, path28) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path27, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path28, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -12340,19 +12335,19 @@ function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg3(path27) {
-  if (typeof path27 !== "string" || path27.length === 0) {
+function loadJsonFileArg3(path28) {
+  if (typeof path28 !== "string" || path28.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync8(path27, "utf8"));
+    const parsed = JSON.parse(readFileSync8(path28, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path27} must contain a JSON object`);
+      failWriteValidation3(`${path28} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path27} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path28} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -15291,12 +15286,327 @@ Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedi
   }
 });
 
+// src/commands/brand/index.ts
+import { defineCommand as defineCommand86 } from "citty";
+
+// src/commands/brand/fonts.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand as defineCommand85 } from "citty";
+
+// src/engine/brand/fonts.ts
+var GOOGLE_CSS2 = "https://fonts.googleapis.com/css2";
+function parseGoogleFontFaces(css) {
+  const faces = [];
+  const re = /\/\*\s*([\w-]+)\s*\*\/\s*@font-face\s*\{([^}]*)\}/g;
+  for (const match of String(css).matchAll(re)) {
+    const subset = match[1] ?? "";
+    const body = match[2] ?? "";
+    const family = body.match(/font-family\s*:\s*['"]?([^'";]+)['"]?\s*;/i)?.[1]?.trim();
+    const url = body.match(/src\s*:\s*url\(\s*['"]?([^'")]+)['"]?\s*\)/i)?.[1]?.trim();
+    const weight = body.match(/font-weight\s*:\s*(\d{3})\s*;/i)?.[1];
+    if (!family || !url || !weight) continue;
+    faces.push({
+      subset,
+      family,
+      style: body.match(/font-style\s*:\s*([\w-]+)\s*;/i)?.[1]?.trim() ?? "normal",
+      weight: Number(weight),
+      url,
+      unicodeRange: body.match(/unicode-range\s*:\s*([^;]+);/i)?.[1]?.trim() ?? ""
+    });
+  }
+  return faces;
+}
+function fontFileName(face) {
+  const family = face.family.replace(/[^A-Za-z0-9]/g, "");
+  const style = face.style === "italic" ? "italic" : "";
+  return `${family}-${face.weight}${style}-${face.subset}.woff2`;
+}
+function renderFontFaceCss(faces, hrefFor) {
+  return faces.map(
+    (face) => [
+      "@font-face {",
+      `  font-family: '${face.family}';`,
+      `  font-style: ${face.style};`,
+      `  font-weight: ${face.weight};`,
+      "  font-display: swap;",
+      `  src: url('${hrefFor(face)}') format('woff2');`,
+      ...face.unicodeRange ? [`  unicode-range: ${face.unicodeRange};`] : [],
+      "}"
+    ].join("\n")
+  ).join("\n");
+}
+function parseWeightAxis(spec) {
+  const axis = spec.match(/wght@([^&]+)/i)?.[1] ?? "";
+  const weights = /* @__PURE__ */ new Set();
+  for (const tuple of axis.split(";")) {
+    const last = tuple.split(",").pop()?.trim() ?? "";
+    const range = last.match(/^(\d{3})\.\.(\d{3})$/);
+    if (range) {
+      for (let w = Number(range[1]); w <= Number(range[2]); w += 100) weights.add(w);
+    } else if (/^\d{3}$/.test(last)) {
+      weights.add(Number(last));
+    }
+  }
+  return [...weights].sort((a, b) => a - b);
+}
+function googleFontRequests(css) {
+  const out = [];
+  for (const link of String(css).matchAll(/fonts\.googleapis\.com\/[^\s"')]+/gi)) {
+    for (const param of link[0].matchAll(/[?&]family=([^&]+)/gi)) {
+      const [namePart, ...specParts] = (param[1] ?? "").split(":");
+      const family = decodeURIComponent((namePart ?? "").replaceAll("+", " ")).trim();
+      if (!family) continue;
+      out.push({ family, weights: parseWeightAxis(specParts.join(":")) });
+    }
+  }
+  return out;
+}
+function resolveFetchWeights(flag, declared) {
+  if (flag) {
+    return String(flag).split(",").map((w) => Number(w.trim())).filter((w) => Number.isInteger(w) && w >= 100 && w <= 900);
+  }
+  return declared?.length ? declared : [400];
+}
+function googleFontCssUrl(family, weights) {
+  const name = family.trim().replace(/\s+/g, "+");
+  const axis = [...new Set(weights)].sort((a, b) => a - b).join(";");
+  const spec = axis ? `${name}:wght@${axis}` : name;
+  return `${GOOGLE_CSS2}?family=${spec}&display=swap`;
+}
+
+// src/commands/brand/fonts.ts
+var GLOBAL_CSS = path.join("src", "styles", "global.css");
+var FONTS_DIR = path.join("src", "brand", "fonts");
+var DEFAULT_SUBSETS = "latin";
+var BROWSER_UA = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 Chrome/120.0 Safari/537.36";
+registerSchema({
+  command: "brand.fonts.check",
+  description: "Start here when a brand's fonts are 'confirmed' but nobody verified it. Asks Google Fonts what it ACTUALLY serves for every family/weight src/styles/global.css requests, and reports any the brand promises but Google will not serve.",
+  args: {}
+});
+registerSchema({
+  command: "brand.fonts.fetch",
+  description: "Download a Google font into src/brand/fonts/ so the brand stops depending on a third party at page load, and print the @font-face block to paste above @theme in src/styles/global.css.",
+  args: {
+    family: { type: "string", description: 'Font family, e.g. "DM Sans"', required: true },
+    weights: {
+      type: "string",
+      description: "Comma-separated weights (default: what global.css requests, else 400)",
+      required: false
+    },
+    subsets: {
+      type: "string",
+      description: `Comma-separated unicode subsets (default: ${DEFAULT_SUBSETS})`,
+      required: false
+    }
+  }
+});
+function fail(code, message, fix) {
+  writeJson({ ok: false, error: { code, message, ...fix ? { fix } : {} } });
+  process.exit(2);
+}
+async function fetchGoogleCss(url) {
+  try {
+    const res = await fetch(url, { headers: { "User-Agent": BROWSER_UA } });
+    if (!res.ok) return null;
+    return await res.text();
+  } catch {
+    return null;
+  }
+}
+async function diagnoseUnserved(family) {
+  const bare = await fetchGoogleCss(googleFontCssUrl(family, []));
+  return bare === null ? "unknown-family" : "unavailable-weight";
+}
+async function readGlobalCss() {
+  try {
+    return await readFile(path.resolve(process.cwd(), GLOBAL_CSS), "utf8");
+  } catch {
+    return "";
+  }
+}
+var fontsCheckCommand = defineCommand85({
+  meta: {
+    name: "check",
+    description: "Verify the brand's fonts really exist. For every family/weight src/styles/global.css requests from Google Fonts, ask Google what it actually serves and report anything missing \u2014 a weight nobody serves renders as a synthesized fallback and looks off-brand everywhere."
+  },
+  async run() {
+    const css = await readGlobalCss();
+    const requests = googleFontRequests(css);
+    if (requests.length === 0) {
+      writeJson({
+        ok: true,
+        data: { families: [], selfHosted: true },
+        hints: [
+          `No Google Fonts requested in ${GLOBAL_CSS}. If the brand self-hosts, the offline validator already checks those files; nothing to verify against Google.`
+        ]
+      });
+      return;
+    }
+    const families = [];
+    const unavailable = [];
+    for (const request of requests) {
+      const url = googleFontCssUrl(request.family, request.weights);
+      const served = await fetchGoogleCss(url);
+      if (served === null) {
+        const cause = await diagnoseUnserved(request.family);
+        unavailable.push(
+          cause === "unknown-family" ? `${request.family} (no such family on Google Fonts \u2014 check the exact spelling)` : `${request.family} ${request.weights.join("/")} (the family exists, these weights do not)`
+        );
+        families.push({
+          family: request.family,
+          requested: request.weights,
+          served: [],
+          missing: request.weights,
+          cause
+        });
+        continue;
+      }
+      const faces = parseGoogleFontFaces(served);
+      const servedWeights = [...new Set(faces.map((f) => f.weight))].sort((a, b) => a - b);
+      const missing = request.weights.filter((w) => !servedWeights.includes(w));
+      if (missing.length > 0) unavailable.push(`${request.family} ${missing.join("/")}`);
+      families.push({
+        family: request.family,
+        requested: request.weights,
+        served: servedWeights,
+        missing,
+        subsets: [...new Set(faces.map((f) => f.subset))]
+      });
+    }
+    if (unavailable.length > 0) {
+      fail("FONT_NOT_SERVED", `Google Fonts does not serve: ${unavailable.join("; ")}`, {
+        action: `Correct the family name or weight in ${GLOBAL_CSS} and src/brand/BRAND.md, or run \`baker brand fonts fetch\` for a weight that does exist.`,
+        explanation: "A requested weight Google does not serve is silently synthesized by the browser, so the page looks subtly wrong with nothing failing."
+      });
+    }
+    writeJson({
+      ok: true,
+      data: { families },
+      hints: [
+        "Every requested family and weight is really served by Google.",
+        `To stop depending on Google at page load, run \`baker brand fonts fetch "<family>"\` to self-host into ${FONTS_DIR}.`
+      ]
+    });
+  }
+});
+var fontsFetchCommand = defineCommand85({
+  meta: {
+    name: "fetch",
+    description: "Download a Google font into src/brand/fonts/ and print the @font-face block to paste above @theme in src/styles/global.css. Use when a brand font should be self-hosted rather than requested from Google on every page load."
+  },
+  args: {
+    family: { type: "positional", required: true, description: 'Font family, e.g. "DM Sans"' },
+    weights: { type: "string", description: "Comma-separated weights (default: what global.css requests, else 400)" },
+    subsets: { type: "string", description: `Comma-separated unicode subsets (default: ${DEFAULT_SUBSETS})` }
+  },
+  async run({ args }) {
+    const family = String(args.family).trim();
+    if (!family) fail("INVALID_FAMILY", 'Pass a font family, e.g. `baker brand fonts fetch "DM Sans"`.');
+    const css = await readGlobalCss();
+    const declared = googleFontRequests(css).find((r) => r.family.toLowerCase() === family.toLowerCase());
+    const weights = resolveFetchWeights(args.weights, declared?.weights);
+    if (weights.length === 0) {
+      fail("INVALID_WEIGHTS", `"${args.weights}" has no usable weight \u2014 pass whole hundreds, e.g. --weights 400,700.`);
+    }
+    const wanted = new Set(
+      String(args.subsets ?? DEFAULT_SUBSETS).split(",").map((s) => s.trim()).filter(Boolean)
+    );
+    const servedCss = await fetchGoogleCss(googleFontCssUrl(family, weights));
+    if (servedCss === null) {
+      const cause = await diagnoseUnserved(family);
+      fail(
+        "FONT_NOT_SERVED",
+        cause === "unknown-family" ? `Google Fonts has no family called "${family}".` : `"${family}" exists on Google Fonts but not at weight ${weights.join("/")}.`,
+        cause === "unknown-family" ? {
+          action: "Check the exact family name at fonts.google.com, then retry.",
+          explanation: "Family names are case- and space-sensitive in the Google Fonts API."
+        } : {
+          action: `Run \`baker brand fonts check\` to see which weights this family really ships, then retry with --weights set to one of those.`,
+          explanation: "Google rejects the whole request when one requested weight does not exist."
+        }
+      );
+    }
+    const faces = parseGoogleFontFaces(servedCss).filter((f) => wanted.has(f.subset));
+    if (faces.length === 0) {
+      fail("SUBSET_NOT_SERVED", `"${family}" has no ${[...wanted].join("/")} subset.`, {
+        action: `Retry with --subsets set to one Google actually serves for this family.`,
+        explanation: "Google splits each family into unicode subsets; not every family ships every subset."
+      });
+    }
+    const fontsDir = path.resolve(process.cwd(), FONTS_DIR);
+    await mkdir(fontsDir, { recursive: true });
+    const downloaded = [];
+    for (const face of faces) {
+      const res = await fetch(face.url, { headers: { "User-Agent": BROWSER_UA } });
+      if (!res.ok) continue;
+      await writeFile(path.join(fontsDir, fontFileName(face)), Buffer.from(await res.arrayBuffer()));
+      downloaded.push(face);
+    }
+    const written = downloaded.map(fontFileName);
+    if (written.length === 0) {
+      fail("DOWNLOAD_FAILED", `Could not download any file for "${family}".`, {
+        action: "Retry; if it keeps failing, keep the Google @import and note it in BRAND.md.",
+        explanation: "The font stylesheet resolved but the font files themselves did not download."
+      });
+    }
+    const fontFace = renderFontFaceCss(downloaded, (f) => `/${FONTS_DIR}/${fontFileName(f)}`);
+    const downloadedWeights = [...new Set(downloaded.map((f) => f.weight))].sort((a, b) => a - b);
+    const incomplete = weights.filter((w) => !downloadedWeights.includes(w));
+    writeJson({
+      ok: true,
+      data: { family, weights: downloadedWeights, files: written, fontFace },
+      hints: [
+        `Paste the \`fontFace\` block ABOVE the @theme block in ${GLOBAL_CSS}, then remove "${family}" from the Google @import so the page stops fetching it at load.`,
+        `Record the exact weights (${downloadedWeights.join(", ")}) in src/brand/BRAND.md \u2014 a weight listed there but not downloaded renders as a synthesized fallback.`,
+        ...incomplete.length > 0 ? [
+          `PARTIAL: ${incomplete.join(", ")} did not download and is NOT in the \`fontFace\` block. Keep "${family}" in the Google @import for those weights, or re-run \`baker brand fonts fetch "${family}" --weights ${incomplete.join(",")}\`.`
+        ] : [],
+        "Licensing: Google Fonts are open-licensed and safe to self-host. A client's own commercial face is not \u2014 confirm before re-hosting one."
+      ]
+    });
+  }
+});
+var fontsCommand = defineCommand85({
+  meta: {
+    name: "fonts",
+    description: `Verify and self-host the brand's typefaces.
+
+Start here: \`baker brand fonts check\` \u2014 confirms the fonts the brand claims are really served.
+
+Subcommands:
+  baker brand fonts check           \u2014 ask Google what it actually serves for every family/weight global.css requests
+  baker brand fonts fetch <family>  \u2014 download a family into src/brand/fonts/ and print its @font-face block`
+  },
+  subCommands: {
+    check: fontsCheckCommand,
+    fetch: fontsFetchCommand
+  }
+});
+
+// src/commands/brand/index.ts
+var brandCommand = defineCommand86({
+  meta: {
+    name: "brand",
+    description: `Brand asset verification for src/brand/.
+
+Start here: \`baker brand fonts check\` after defining or editing the brand's typography.
+
+Subcommands:
+  baker brand fonts   \u2014 verify the brand's typefaces really load, and self-host them into src/brand/fonts/`
+  },
+  subCommands: {
+    fonts: fontsCommand
+  }
+});
+
 // src/commands/canvas/index.ts
-import { defineCommand as defineCommand95 } from "citty";
+import { defineCommand as defineCommand97 } from "citty";
 
 // src/commands/canvas/catalog.ts
-import { defineCommand as defineCommand85 } from "citty";
-var catalogCommand = defineCommand85({
+import { defineCommand as defineCommand87 } from "citty";
+var catalogCommand = defineCommand87({
   meta: {
     name: "catalog",
     description: "Print the agent-facing node catalog (JSON Schema). Includes every registered node grouped by category."
@@ -15309,9 +15619,9 @@ var catalogCommand = defineCommand85({
 });
 
 // src/commands/canvas/critique.ts
-import { readFile } from "fs/promises";
-import path from "path";
-import { defineCommand as defineCommand86 } from "citty";
+import { readFile as readFile2 } from "fs/promises";
+import path2 from "path";
+import { defineCommand as defineCommand88 } from "citty";
 
 // src/engine/scaffold/lib/critique.ts
 var VIBE_CUE = /\b(light|lighting|golden|moody|warm|cool|tone|grade|contrast|shadow|glow|rim|backlit|neon|soft)\b/i;
@@ -15431,15 +15741,15 @@ function critiqueCanvas(canvas) {
 }
 
 // src/commands/canvas/critique.ts
-var critiqueCommand = defineCommand86({
+var critiqueCommand = defineCommand88({
   meta: {
     name: "critique",
     description: "Pre-spend creative critic (ADVISORY \u2014 never blocks). Scores a scaffolded creative BEFORE the billed render, so weak spots get fixed for free. A VIDEO creative is scored on hook strength, sound-off first-frame legibility, retention risk, and mechanism clarity; a STATIC ad on baked-text legibility risk, identity grounding, brand-type fidelity, and mechanism clarity. Ground a video hook against `baker winning-ads hooks` for a proven pattern."
   },
   args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
   async run({ args }) {
-    const filePath = path.resolve(String(args.file));
-    const raw = await readFile(filePath, "utf8");
+    const filePath = path2.resolve(String(args.file));
+    const raw = await readFile2(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -15470,12 +15780,12 @@ var critiqueCommand = defineCommand86({
 
 // src/commands/canvas/inspect.ts
 import { execFile } from "child_process";
-import { readdir, readFile as readFile2, stat } from "fs/promises";
-import path2 from "path";
+import { readdir, readFile as readFile3, stat } from "fs/promises";
+import path3 from "path";
 import { promisify } from "util";
-import { defineCommand as defineCommand87 } from "citty";
+import { defineCommand as defineCommand89 } from "citty";
 var execFileAsync = promisify(execFile);
-var inspectCommand = defineCommand87({
+var inspectCommand = defineCommand89({
   meta: {
     name: "inspect",
     description: "Dump a one-page summary of a canvas run: per-node duration + cache status, list of output files in the run dir, and optionally three thumbnail frames per video output. Pass either a run_id (resolved against --outputs-dir) or an absolute run directory."
@@ -15489,7 +15799,7 @@ var inspectCommand = defineCommand87({
     }
   },
   async run({ args }) {
-    const outputsDir = path2.resolve(String(args["outputs-dir"] ?? "canvas"));
+    const outputsDir = path3.resolve(String(args["outputs-dir"] ?? "canvas"));
     const runArg = String(args.run);
     const runDir = await resolveRunDir(runArg, outputsDir);
     const manifest = await loadManifest(runDir);
@@ -15501,7 +15811,7 @@ var inspectCommand = defineCommand87({
     }
     const summary = {
       ok: true,
-      run_id: manifest.run_id ?? path2.basename(runDir),
+      run_id: manifest.run_id ?? path3.basename(runDir),
       run_dir: runDir,
       stats: manifest.stats ?? null,
       output: manifest.output ?? null,
@@ -15514,20 +15824,20 @@ var inspectCommand = defineCommand87({
   }
 });
 async function resolveRunDir(run, outputsDir) {
-  if (path2.isAbsolute(run)) {
+  if (path3.isAbsolute(run)) {
     const s2 = await stat(run).catch(() => null);
     if (s2?.isDirectory()) return run;
     throw new Error(`inspect: ${run} is not a directory`);
   }
-  const candidate = path2.join(outputsDir, run);
+  const candidate = path3.join(outputsDir, run);
   const s = await stat(candidate).catch(() => null);
   if (s?.isDirectory()) return candidate;
   throw new Error(`inspect: no run directory at ${candidate}`);
 }
 async function loadManifest(runDir) {
-  const manifestPath = path2.join(runDir, "manifest.json");
+  const manifestPath = path3.join(runDir, "manifest.json");
   try {
-    const raw = await readFile2(manifestPath, "utf-8");
+    const raw = await readFile3(manifestPath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return {};
@@ -15537,7 +15847,7 @@ async function listRunFiles(runDir) {
   const out = [];
   const names = await readdir(runDir);
   for (const name of names) {
-    const abs = path2.join(runDir, name);
+    const abs = path3.join(runDir, name);
     const s = await stat(abs).catch(() => null);
     if (!s?.isFile()) continue;
     out.push({ name, path: abs, size: s.size });
@@ -15582,13 +15892,13 @@ async function probeDuration(filePath) {
 }
 
 // src/commands/canvas/rerun.ts
-import path13 from "path";
-import { defineCommand as defineCommand89 } from "citty";
+import path14 from "path";
+import { defineCommand as defineCommand91 } from "citty";
 
 // src/commands/canvas/run.ts
-import { readFile as readFile9 } from "fs/promises";
-import path12 from "path";
-import { defineCommand as defineCommand88 } from "citty";
+import { readFile as readFile10 } from "fs/promises";
+import path13 from "path";
+import { defineCommand as defineCommand90 } from "citty";
 
 // src/commands/canvas/placeholders.ts
 function unsuppliedPlaceholderAssets(canvas) {
@@ -15607,7 +15917,7 @@ function unsuppliedPlaceholderAssets(canvas) {
 }
 
 // src/commands/canvas/resolve-paths.ts
-import path3 from "path";
+import path4 from "path";
 function resolveRelativeCanvasPaths(canvas, baseDir) {
   if (!canvas || typeof canvas !== "object") return canvas;
   const c = canvas;
@@ -15620,24 +15930,24 @@ function resolveNode(node, baseDir) {
   const params = n.params;
   if (!params || typeof params !== "object") return node;
   if (n.type === "ingest" && params.source === "path" && isResolvableRelative(params.path)) {
-    return { ...node, params: { ...params, path: path3.resolve(baseDir, params.path) } };
+    return { ...node, params: { ...params, path: path4.resolve(baseDir, params.path) } };
   }
   if (n.type === "hyperframe_render" && isResolvableRelative(params.composition)) {
-    return { ...node, params: { ...params, composition: path3.resolve(baseDir, params.composition) } };
+    return { ...node, params: { ...params, composition: path4.resolve(baseDir, params.composition) } };
   }
   return node;
 }
 function isResolvableRelative(value) {
-  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !looksLikeHttpUrl(value) && !path3.isAbsolute(value);
+  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !looksLikeHttpUrl(value) && !path4.isAbsolute(value);
 }
 
 // src/commands/canvas/source-version.ts
-import { readFile as readFile4 } from "fs/promises";
-import path5 from "path";
+import { readFile as readFile5 } from "fs/promises";
+import path6 from "path";
 
 // src/commands/canvas/scene-files.ts
-import { mkdir, readFile as readFile3, readdir as readdir2, rm, writeFile } from "fs/promises";
-import path4 from "path";
+import { mkdir as mkdir2, readFile as readFile4, readdir as readdir2, rm, writeFile as writeFile2 } from "fs/promises";
+import path5 from "path";
 var SCENES_DIR = "scenes";
 var GLOBAL_PROMPT_FILE = "prompt.json";
 var REBUILD_FILE = "prompt.rebuild.json";
@@ -15654,19 +15964,19 @@ function splitBlueprint(blueprint) {
 }
 async function writeSceneFiles(outDir, blueprint) {
   const { global, scenes } = splitBlueprint(blueprint);
-  await writeFile(path4.join(outDir, GLOBAL_PROMPT_FILE), `${JSON.stringify(global, null, 2)}
+  await writeFile2(path5.join(outDir, GLOBAL_PROMPT_FILE), `${JSON.stringify(global, null, 2)}
 `, "utf8");
-  const scenesDir = path4.join(outDir, SCENES_DIR);
-  await mkdir(scenesDir, { recursive: true });
+  const scenesDir = path5.join(outDir, SCENES_DIR);
+  await mkdir2(scenesDir, { recursive: true });
   const written = /* @__PURE__ */ new Set();
   for (let i = 0; i < scenes.length; i++) {
     const name = sceneFileName(i, scenes.length);
     written.add(name);
-    await writeFile(path4.join(scenesDir, name), `${JSON.stringify(scenes[i], null, 2)}
+    await writeFile2(path5.join(scenesDir, name), `${JSON.stringify(scenes[i], null, 2)}
 `, "utf8");
   }
   for (const name of await listSceneFileNames(scenesDir)) {
-    if (!written.has(name)) await rm(path4.join(scenesDir, name), { force: true });
+    if (!written.has(name)) await rm(path5.join(scenesDir, name), { force: true });
   }
 }
 async function listSceneFileNames(scenesDir) {
@@ -15679,17 +15989,17 @@ async function listSceneFileNames(scenesDir) {
   return entries.filter((n) => /^s\d+\.json$/.test(n)).sort(bySceneIndex);
 }
 async function listSceneFiles(creativeDir) {
-  const scenesDir = path4.join(creativeDir, SCENES_DIR);
-  return (await listSceneFileNames(scenesDir)).map((n) => path4.join(scenesDir, n));
+  const scenesDir = path5.join(creativeDir, SCENES_DIR);
+  return (await listSceneFileNames(scenesDir)).map((n) => path5.join(scenesDir, n));
 }
 async function reassembleBlueprint(creativeDir) {
   const files = await listSceneFiles(creativeDir);
   if (files.length === 0) return null;
-  const globalRaw = await readFile3(path4.join(creativeDir, GLOBAL_PROMPT_FILE), "utf8");
+  const globalRaw = await readFile4(path5.join(creativeDir, GLOBAL_PROMPT_FILE), "utf8");
   const global = JSON.parse(globalRaw);
   const scenes = [];
   for (const file of files) {
-    scenes.push(JSON.parse(await readFile3(file, "utf8")));
+    scenes.push(JSON.parse(await readFile4(file, "utf8")));
   }
   return { ...global, scenes };
 }
@@ -15703,15 +16013,15 @@ function bySceneIndex(a, b) {
 async function computeSourceSha(canvasPath) {
   let canvasBytes;
   try {
-    canvasBytes = await readFile4(canvasPath);
+    canvasBytes = await readFile5(canvasPath);
   } catch {
     return void 0;
   }
-  const canvasDir = path5.dirname(canvasPath);
-  const promptPath = path5.join(canvasDir, "prompt.json");
+  const canvasDir = path6.dirname(canvasPath);
+  const promptPath = path6.join(canvasDir, "prompt.json");
   let promptBytes;
   try {
-    promptBytes = await readFile4(promptPath);
+    promptBytes = await readFile5(promptPath);
   } catch {
     promptBytes = Buffer.alloc(0);
   }
@@ -15724,7 +16034,7 @@ async function computeSourceSha(canvasPath) {
   for (const sceneFile of await listSceneFiles(canvasDir)) {
     let sceneBytes;
     try {
-      sceneBytes = await readFile4(sceneFile);
+      sceneBytes = await readFile5(sceneFile);
     } catch {
       sceneBytes = Buffer.alloc(0);
     }
@@ -15734,8 +16044,8 @@ async function computeSourceSha(canvasPath) {
 }
 
 // src/commands/canvas/scene-projection.ts
-import { readFile as readFile5 } from "fs/promises";
-import path6 from "path";
+import { readFile as readFile6 } from "fs/promises";
+import path7 from "path";
 
 // src/engine/scaffold/video.ts
 import { toCardinal as nwAr } from "n2words/ar-SA";
@@ -16661,7 +16971,9 @@ function buildFrameRef(edge, url, framePrompt, present2, ctx, nodes) {
   const imageProfile = imageProfileFor(ctx.imageModel);
   const genParams = {
     model: ctx.imageModel,
-    image_size: "2K",
+    // gpt-image-2 derives pixel dimensions from the ratio and has no size knob,
+    // so asking for 2K there is an `unknown_param` at validate.
+    ...supportsParam("image_generate", ctx.imageModel, "image_size") ? { image_size: "2K" } : {},
     // Per-model image defaults (gpt-image: quality=high — OpenRouter forwards it; we do
     // NOT send input_fidelity, which gpt-image-2 forces high automatically).
     ...imageProfile?.paramDefaults ?? {},
@@ -16676,7 +16988,7 @@ function buildFrameRef(edge, url, framePrompt, present2, ctx, nodes) {
       ctx.imageModel
     )
   };
-  if (ctx.genAr) genParams.aspect_ratio = ctx.genAr;
+  if (ctx.genAr) genParams.aspect_ratio = nearestSupportedAspectRatio("image_generate", ctx.imageModel, ctx.genAr);
   const genId = `s${ctx.sceneIndex}${tag}_${edge}`;
   nodes.push({
     id: genId,
@@ -18992,12 +19304,12 @@ function nonPromptParamsDiverge(live = {}, rebuilt = {}) {
   return false;
 }
 async function syncSceneNodeParams(canvas, canvasPath, log) {
-  const creativeDir = path6.dirname(canvasPath);
+  const creativeDir = path7.dirname(canvasPath);
   const blueprint = await reassembleBlueprint(creativeDir);
   if (!blueprint) return "not_applicable";
   let rebuildRaw;
   try {
-    rebuildRaw = await readFile5(path6.join(creativeDir, REBUILD_FILE), "utf8");
+    rebuildRaw = await readFile6(path7.join(creativeDir, REBUILD_FILE), "utf8");
   } catch {
     return "not_applicable";
   }
@@ -19038,7 +19350,7 @@ async function syncSceneNodeParams(canvas, canvasPath, log) {
 }
 
 // src/commands/canvas/style-projection.ts
-import { readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
+import { readFile as readFile7, writeFile as writeFile3 } from "fs/promises";
 function findBlueprintProjection(canvas) {
   if (!canvas || typeof canvas !== "object") return null;
   const nodes = canvas.nodes;
@@ -19066,10 +19378,10 @@ function renderStyleProjectionFromValue(blueprint) {
 async function syncStyleProjection(canvas, log) {
   const pair = findBlueprintProjection(canvas);
   if (!pair) return "not_applicable";
-  const rendered = renderStyleProjection(await readFile6(pair.promptPath, "utf8"));
-  const current = await readFile6(pair.stylePath, "utf8").catch(() => null);
+  const rendered = renderStyleProjection(await readFile7(pair.promptPath, "utf8"));
+  const current = await readFile7(pair.stylePath, "utf8").catch(() => null);
   if (current === rendered) return "up_to_date";
-  await writeFile2(pair.stylePath, rendered, "utf8");
+  await writeFile3(pair.stylePath, rendered, "utf8");
   log(
     "[style] prompt.style.json regenerated from prompt.json \u2014 every frame's shared ad spec changed; affected image frames will re-bill on the next run"
   );
@@ -19129,13 +19441,13 @@ ${body}` : header || body || compactJson(record);
 }
 
 // src/commands/canvas/run-record.ts
-import path7 from "path";
+import path8 from "path";
 var MAX_RUN_NODES = 200;
 var MAX_OUTPUTS_PER_NODE = 10;
 var MAX_FINAL_OUTPUTS = 10;
 var MAX_CREATIVE_SLUG_LENGTH = 100;
 function creativeSlugFromCanvasPath(filePath) {
-  const normalized = filePath.split(path7.sep).join("/");
+  const normalized = filePath.split(path8.sep).join("/");
   const match = normalized.match(/(?:^|\/)src\/creatives\/([a-z0-9](?:[a-z0-9-]*[a-z0-9])?)\//);
   const slug = match?.[1] ?? null;
   return slug && slug.length <= MAX_CREATIVE_SLUG_LENGTH ? slug : null;
@@ -19423,7 +19735,7 @@ var RunRecordPoster = class {
 
 // src/commands/canvas/run-retention.ts
 import { rm as rm2 } from "fs/promises";
-import path8 from "path";
+import path9 from "path";
 function runDirsToPrune(entries, keep, currentRunId) {
   const runs = entries.filter((e) => /^r_[0-9A-Za-z]+$/.test(e) && e !== currentRunId).sort();
   if (keep <= 0) return runs;
@@ -19440,7 +19752,7 @@ async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
   const toPrune = runDirsToPrune(entries, keep, currentRunId);
   if (toPrune.length === 0) return;
   for (const dir of toPrune) {
-    await rm2(path8.join(outputsDir, dir), { recursive: true, force: true }).catch(
+    await rm2(path9.join(outputsDir, dir), { recursive: true, force: true }).catch(
       (e) => log(`[prune   ] could not remove ${dir}: ${e.message}`)
     );
   }
@@ -19448,13 +19760,13 @@ async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
 }
 
 // src/commands/canvas/dirty-marker.ts
-import { mkdir as mkdir2, readdir as readdir3, rm as rm3, writeFile as writeFile3 } from "fs/promises";
-import path9 from "path";
+import { mkdir as mkdir3, readdir as readdir3, rm as rm3, writeFile as writeFile4 } from "fs/promises";
+import path10 from "path";
 function creativeDirtyDir(base) {
-  return base ?? path9.resolve("canvas", ".dirty");
+  return base ?? path10.resolve("canvas", ".dirty");
 }
 function dirtyMarkerFile(slug, base) {
-  return path9.join(creativeDirtyDir(base), `${slug}.json`);
+  return path10.join(creativeDirtyDir(base), `${slug}.json`);
 }
 async function clearCreativeDirty(slug, base) {
   try {
@@ -19464,18 +19776,18 @@ async function clearCreativeDirty(slug, base) {
 }
 
 // src/commands/canvas/run-resume.ts
-import { mkdir as mkdir3, readFile as readFile7, rm as rm4, writeFile as writeFile4 } from "fs/promises";
-import path10 from "path";
+import { mkdir as mkdir4, readFile as readFile8, rm as rm4, writeFile as writeFile5 } from "fs/promises";
+import path11 from "path";
 function markerKey(canvasPath) {
   const slug = creativeSlugFromCanvasPath(canvasPath);
-  const identity = slug ?? path10.relative(process.cwd(), path10.resolve(canvasPath));
+  const identity = slug ?? path11.relative(process.cwd(), path11.resolve(canvasPath));
   return sha256Hex(Buffer.from(identity)).slice(0, 32);
 }
 function legacyMarkerKey(canvasPath) {
-  return sha256Hex(Buffer.from(path10.resolve(canvasPath))).slice(0, 32);
+  return sha256Hex(Buffer.from(path11.resolve(canvasPath))).slice(0, 32);
 }
 function markerFile(outputsDir, key) {
-  return path10.join(outputsDir, ".inflight", `${key}.json`);
+  return path11.join(outputsDir, ".inflight", `${key}.json`);
 }
 var REMOTE_ADOPT_STALE_MS = 12e4;
 function classifyRemoteRun(run, now) {
@@ -19511,7 +19823,7 @@ async function resolveRunId(opts) {
 async function readMarkerRunId(outputsDir, canvasPath) {
   for (const key of [markerKey(canvasPath), legacyMarkerKey(canvasPath)]) {
     try {
-      const raw = await readFile7(markerFile(outputsDir, key), "utf8");
+      const raw = await readFile8(markerFile(outputsDir, key), "utf8");
       const parsed = JSON.parse(raw);
       if (typeof parsed.runId === "string" && parsed.runId.length > 0) return parsed.runId;
     } catch {
@@ -19522,8 +19834,8 @@ async function readMarkerRunId(outputsDir, canvasPath) {
 async function markRunInFlight(outputsDir, canvasPath, runId) {
   try {
     const file = markerFile(outputsDir, markerKey(canvasPath));
-    await mkdir3(path10.dirname(file), { recursive: true });
-    await writeFile4(file, JSON.stringify({ runId, canvasPath: path10.resolve(canvasPath), startedAt: Date.now() }));
+    await mkdir4(path11.dirname(file), { recursive: true });
+    await writeFile5(file, JSON.stringify({ runId, canvasPath: path11.resolve(canvasPath), startedAt: Date.now() }));
   } catch {
   }
 }
@@ -19537,8 +19849,8 @@ async function clearRunMarker(outputsDir, canvasPath) {
 }
 
 // src/commands/canvas/run-snapshot.ts
-import { mkdir as mkdir4, readdir as readdir4, readFile as readFile8, stat as stat2, writeFile as writeFile5 } from "fs/promises";
-import path11 from "path";
+import { mkdir as mkdir5, readdir as readdir4, readFile as readFile9, stat as stat2, writeFile as writeFile6 } from "fs/promises";
+import path12 from "path";
 var SNAPSHOT_SCHEMA = "baker-canvas-snapshot/1";
 var MAX_SNAPSHOT_FILE_BYTES = 32 * 1024 * 1024;
 var EXT_TO_MIME = {
@@ -19565,11 +19877,11 @@ var EXT_TO_MIME = {
   woff2: "font/woff2"
 };
 function mimeForFile(filePath) {
-  const ext = path11.extname(filePath).slice(1).toLowerCase();
+  const ext = path12.extname(filePath).slice(1).toLowerCase();
   return EXT_TO_MIME[ext] ?? "application/octet-stream";
 }
 function toPosix(p) {
-  return p.split(path11.sep).join("/");
+  return p.split(path12.sep).join("/");
 }
 function localPathRefsFromCanvas(parsed) {
   const nodes = parsed?.nodes;
@@ -19594,37 +19906,37 @@ function isSnapshotablePath(value) {
 async function sourceRefsToSnapshot(canvasDir, parsed) {
   const refs = new Set(localPathRefsFromCanvas(parsed));
   for (const sceneFile of await listSceneFiles(canvasDir)) {
-    refs.add(toPosix(path11.relative(canvasDir, sceneFile)));
+    refs.add(toPosix(path12.relative(canvasDir, sceneFile)));
   }
   refs.add(REBUILD_FILE);
   return [...refs];
 }
 async function uploadRunSnapshot(client, opts) {
   try {
-    const canvasDir = path11.dirname(opts.canvasPath);
+    const canvasDir = path12.dirname(opts.canvasPath);
     const put = (bytes, mime) => putContentAddressed(client, bytes, mime, opts.signal);
     const canvasBytes = Buffer.from(opts.raw);
     const canvasUpload = await put(canvasBytes, "application/json");
     const files = [];
     const skipped = [];
     for (const refPath of await sourceRefsToSnapshot(canvasDir, opts.parsed)) {
-      const abs = path11.isAbsolute(refPath) ? refPath : path11.resolve(canvasDir, refPath);
+      const abs = path12.isAbsolute(refPath) ? refPath : path12.resolve(canvasDir, refPath);
       let st;
       try {
         st = await stat2(abs);
       } catch {
-        skipped.push({ path: toPosix(path11.relative(canvasDir, abs)), reason: "missing" });
+        skipped.push({ path: toPosix(path12.relative(canvasDir, abs)), reason: "missing" });
         continue;
       }
       const fileList = st.isDirectory() ? await listFilesRecursive(abs) : [abs];
       for (const file of fileList) {
-        const rel = toPosix(path11.relative(canvasDir, file));
+        const rel = toPosix(path12.relative(canvasDir, file));
         const size = (await stat2(file)).size;
         if (size > MAX_SNAPSHOT_FILE_BYTES) {
           skipped.push({ path: rel, reason: `too large (${size} bytes)` });
           continue;
         }
-        const bytes = await readFile8(file);
+        const bytes = await readFile9(file);
         const upload = await put(bytes, mimeForFile(file));
         files.push({ path: rel, sha256: upload.sha256, url: upload.url });
       }
@@ -19633,7 +19945,7 @@ async function uploadRunSnapshot(client, opts) {
       schema: SNAPSHOT_SCHEMA,
       creativeSlug: opts.creativeSlug,
       canvasSha: canvasUpload.sha256,
-      canvas: { path: path11.basename(opts.canvasPath), sha256: canvasUpload.sha256, url: canvasUpload.url },
+      canvas: { path: path12.basename(opts.canvasPath), sha256: canvasUpload.sha256, url: canvasUpload.url },
       files,
       skipped: skipped.length > 0 ? skipped : void 0
     };
@@ -19660,7 +19972,7 @@ async function putContentAddressed(client, bytes, mime, signal) {
 }
 async function listFilesRecursive(dir) {
   const entries = await readdir4(dir, { recursive: true, withFileTypes: true });
-  return entries.filter((d) => d.isFile()).map((d) => path11.join(d.parentPath, d.name));
+  return entries.filter((d) => d.isFile()).map((d) => path12.join(d.parentPath, d.name));
 }
 var SnapshotConflictError = class extends Error {
   conflicts;
@@ -19672,19 +19984,19 @@ var SnapshotConflictError = class extends Error {
 };
 async function restoreRunSnapshot(manifest, targetDir, opts = {}) {
   const entries = [manifest.canvas, ...manifest.files];
-  const resolvedTarget = path11.resolve(targetDir);
+  const resolvedTarget = path12.resolve(targetDir);
   const planned = [];
   const conflicts = [];
   const upToDate = [];
   for (const entry of entries) {
-    if (path11.isAbsolute(entry.path) || entry.path.split("/").includes("..")) {
+    if (path12.isAbsolute(entry.path) || entry.path.split("/").includes("..")) {
       throw new Error(`snapshot entry escapes the creative directory: ${entry.path}`);
     }
-    const target = path11.resolve(resolvedTarget, entry.path);
-    if (target !== resolvedTarget && !target.startsWith(resolvedTarget + path11.sep)) {
+    const target = path12.resolve(resolvedTarget, entry.path);
+    if (target !== resolvedTarget && !target.startsWith(resolvedTarget + path12.sep)) {
       throw new Error(`snapshot entry escapes the creative directory: ${entry.path}`);
     }
-    const existing = await readFile8(target).catch(() => null);
+    const existing = await readFile9(target).catch(() => null);
     if (existing) {
       if (sha256Hex(existing) === entry.sha256) {
         upToDate.push(entry.path);
@@ -19706,15 +20018,15 @@ async function restoreRunSnapshot(manifest, targetDir, opts = {}) {
     if (sha256Hex(bytes) !== entry.sha256) {
       throw new Error(`snapshot download for ${entry.path} does not match its recorded sha256`);
     }
-    await mkdir4(path11.dirname(target), { recursive: true });
-    await writeFile5(target, bytes);
+    await mkdir5(path12.dirname(target), { recursive: true });
+    await writeFile6(target, bytes);
     restored.push(entry.path);
   }
-  return { canvasPath: path11.resolve(resolvedTarget, manifest.canvas.path), restored, upToDate };
+  return { canvasPath: path12.resolve(resolvedTarget, manifest.canvas.path), restored, upToDate };
 }
 
 // src/commands/canvas/run.ts
-var runCommand = defineCommand88({
+var runCommand = defineCommand90({
   meta: { name: "run", description: "Validate and execute a canvas JSON file." },
   args: {
     file: { type: "positional", required: true, description: "Path to canvas JSON" },
@@ -19790,8 +20102,8 @@ function resolveMaxCredits(...candidates) {
   return void 0;
 }
 async function executeCanvasRun(opts) {
-  const filePath = path12.resolve(opts.file);
-  const raw = await readFile9(filePath, "utf8");
+  const filePath = path13.resolve(opts.file);
+  const raw = await readFile10(filePath, "utf8");
   let parsed;
   try {
     parsed = JSON.parse(raw);
@@ -19803,7 +20115,7 @@ async function executeCanvasRun(opts) {
   }
   const attemptedSlug = creativeSlugFromCanvasPath(filePath);
   if (attemptedSlug) await clearCreativeDirty(attemptedSlug);
-  parsed = resolveRelativeCanvasPaths(parsed, path12.dirname(filePath));
+  parsed = resolveRelativeCanvasPaths(parsed, path13.dirname(filePath));
   try {
     await syncStyleProjection(parsed, (line) => process.stderr.write(`${line}
 `));
@@ -19909,7 +20221,7 @@ async function executeCanvasRun(opts) {
   const canvasSha = sha256Hex(Buffer.from(raw));
   const creativeSlug = creativeSlugFromCanvasPath(filePath) ?? void 0;
   const client = opts.record === false ? null : buildBackendClient();
-  const outputsDir = opts.outputsDir ? path12.resolve(opts.outputsDir) : path12.resolve("canvas");
+  const outputsDir = opts.outputsDir ? path13.resolve(opts.outputsDir) : path13.resolve("canvas");
   const { runId, resumed, source, concurrentRunId } = await resolveRunId({
     explicitRunId: opts.runId,
     fresh: opts.fresh === true,
@@ -19943,7 +20255,7 @@ async function executeCanvasRun(opts) {
   const canvasSnapshotUrl = client && creativeSlug ? await uploadRunSnapshot(client, { canvasPath: filePath, raw, creativeSlug, parsed }) ?? void 0 : void 0;
   const recordMeta = {
     creativeSlug,
-    canvasPath: path12.relative(process.cwd(), filePath) || void 0,
+    canvasPath: path13.relative(process.cwd(), filePath) || void 0,
     canvasSha,
     // The fingerprint the dashboard compares against the current source to flag
     // "edited since last render". Computed from the on-disk canvas.json +
@@ -20084,7 +20396,7 @@ async function postInitialRunRecord(client, payload) {
 
 // src/commands/canvas/rerun.ts
 var SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
-var rerunCommand = defineCommand89({
+var rerunCommand = defineCommand91({
   meta: {
     name: "rerun",
     description: "Re-run a creative's latest recorded canvas. Restores its definition files from run history first, so it works in a fresh workspace that never had the source chat's files \u2014 an interrupted run resumes (in-flight jobs re-attach), a completed one re-renders from the cache."
@@ -20113,24 +20425,24 @@ var rerunCommand = defineCommand89({
   async run({ args }) {
     const slug = String(args.slug);
     if (!SLUG_PATTERN.test(slug)) {
-      fail("invalid_slug", `"${slug}" is not a valid creative slug`);
+      fail2("invalid_slug", `"${slug}" is not a valid creative slug`);
     }
     const client = buildBackendClient();
     if (!client) {
-      fail("missing_credentials", "rerun needs backend credentials (BAKER_API_URL / BAKER_API_KEY)");
+      fail2("missing_credentials", "rerun needs backend credentials (BAKER_API_URL / BAKER_API_KEY)");
     }
     const latest = await client.getLatestSnapshotRun(slug);
     if (!latest) {
-      fail(
+      fail2(
         "no_snapshot_run",
         `no rerunnable history for "${slug}" \u2014 the creative was never run by a CLI that records canvas snapshots`
       );
     }
     const manifest = await fetchManifest(latest.canvasSnapshotUrl);
     if (latest.canvasSha && manifest.canvasSha !== latest.canvasSha) {
-      fail("snapshot_mismatch", `snapshot manifest for run ${latest.runId} does not match its recorded canvas sha`);
+      fail2("snapshot_mismatch", `snapshot manifest for run ${latest.runId} does not match its recorded canvas sha`);
     }
-    const targetDir = path13.resolve("src", "creatives", slug);
+    const targetDir = path14.resolve("src", "creatives", slug);
     let restoredCanvasPath;
     try {
       const restore = await restoreRunSnapshot(manifest, targetDir, { force: args["force-remote"] === true });
@@ -20148,7 +20460,7 @@ var rerunCommand = defineCommand89({
       }
     } catch (e) {
       if (e instanceof SnapshotConflictError) {
-        fail(
+        fail2(
           "local_files_differ",
           `local files differ from the recorded snapshot: ${e.conflicts.join(", ")}. Re-run with --force-remote to overwrite them, or run the local canvas directly with \`baker canvas run\`.`
         );
@@ -20163,25 +20475,25 @@ var rerunCommand = defineCommand89({
     });
   }
 });
-function fail(code, message) {
+function fail2(code, message) {
   process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
 `);
   process.exit(2);
 }
 async function fetchManifest(url) {
   const res = await fetch(url);
-  if (!res.ok) fail("snapshot_unavailable", `snapshot manifest download failed: ${res.status} ${res.statusText}`);
+  if (!res.ok) fail2("snapshot_unavailable", `snapshot manifest download failed: ${res.status} ${res.statusText}`);
   const manifest = await res.json();
   if (manifest?.schema !== SNAPSHOT_SCHEMA || typeof manifest.canvas?.path !== "string") {
-    fail("snapshot_invalid", "snapshot manifest has an unexpected shape");
+    fail2("snapshot_invalid", "snapshot manifest has an unexpected shape");
   }
   return manifest;
 }
 
 // src/commands/canvas/scaffold-static-ad.ts
-import { access, mkdir as mkdir5, readFile as readFile11, writeFile as writeFile6 } from "fs/promises";
-import path17 from "path";
-import { defineCommand as defineCommand91 } from "citty";
+import { access, mkdir as mkdir6, readFile as readFile12, writeFile as writeFile7 } from "fs/promises";
+import path18 from "path";
+import { defineCommand as defineCommand93 } from "citty";
 
 // src/engine/scaffold/staticAd.ts
 import { z as z17 } from "zod";
@@ -20403,8 +20715,13 @@ function scaffoldStaticAd(input, elementsInput, opts) {
     inputs: { reference, target_blueprint: "$ref:prompt.asset" },
     params: {
       model: opts.genModel,
-      aspect_ratio: baseAspectRatio(blueprint, opts),
-      image_size: "2K",
+      // The hero renders at the closest ratio its model actually accepts; the
+      // placement fan-out below adapts it to the exact platform formats, which
+      // is also how a 4:5 Meta feed ad gets made on a model that has no 4:5.
+      aspect_ratio: nearestSupportedAspectRatio("image_generate", opts.genModel, baseAspectRatio(blueprint, opts)),
+      ...supportsParam("image_generate", opts.genModel, "image_size") ? { image_size: "2K" } : {},
+      // Per-model image defaults (gpt-image: quality=high).
+      ...imageProfileFor(opts.genModel)?.paramDefaults ?? {},
       prompt
     }
   });
@@ -20453,7 +20770,7 @@ function staticAdReport(input, elementsInput, opts) {
 }
 
 // src/commands/canvas/creative-definition.ts
-import path14 from "path";
+import path15 from "path";
 var PLATFORM_VALUES = ["meta", "google", "linkedin", "tiktok", "youtube", "x", "other"];
 var FORMAT_VALUES = ["1:1", "4:5", "9:16", "16:9", "1.91:1"];
 function titleFromSlug(slug) {
@@ -20501,16 +20818,16 @@ function buildCreativeDefinition(input) {
 }
 
 // src/commands/canvas/scaffold-static-ad-paths.ts
-import path15 from "path";
+import path16 from "path";
 function resolveScaffoldStaticAdPaths(rawFile, out, cwd = process.cwd(), slug) {
   const file = rawFile.trim();
   const imageIsUrl = /^https?:\/\//i.test(file);
-  const imageSource = imageIsUrl ? file : path15.resolve(cwd, file);
-  const outPath = out ? path15.resolve(cwd, out) : slug ? path15.join(cwd, "src", "creatives", slug, `${slug}.canvas.json`) : imageIsUrl ? path15.join(cwd, "static-ad.canvas.json") : path15.join(path15.dirname(imageSource), "static-ad.canvas.json");
-  const blueprintPath = path15.join(path15.dirname(outPath), "prompt.json");
-  const creativeDir = slug ? path15.dirname(outPath) : null;
-  const definitionPath = creativeDir ? path15.join(creativeDir, "_definition.md") : null;
-  const referencesDir = creativeDir ? path15.join(creativeDir, "references") : null;
+  const imageSource = imageIsUrl ? file : path16.resolve(cwd, file);
+  const outPath = out ? path16.resolve(cwd, out) : slug ? path16.join(cwd, "src", "creatives", slug, `${slug}.canvas.json`) : imageIsUrl ? path16.join(cwd, "static-ad.canvas.json") : path16.join(path16.dirname(imageSource), "static-ad.canvas.json");
+  const blueprintPath = path16.join(path16.dirname(outPath), "prompt.json");
+  const creativeDir = slug ? path16.dirname(outPath) : null;
+  const definitionPath = creativeDir ? path16.join(creativeDir, "_definition.md") : null;
+  const referencesDir = creativeDir ? path16.join(creativeDir, "references") : null;
   return { imageIsUrl, imageSource, outPath, blueprintPath, creativeDir, definitionPath, referencesDir };
 }
 var SCAFFOLD_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
@@ -20520,9 +20837,9 @@ function isValidScaffoldSlug(slug) {
 }
 
 // src/commands/canvas/sync-definition.ts
-import { readdir as readdir5, readFile as readFile10, stat as stat3 } from "fs/promises";
-import path16 from "path";
-import { defineCommand as defineCommand90 } from "citty";
+import { readdir as readdir5, readFile as readFile11, stat as stat3 } from "fs/promises";
+import path17 from "path";
+import { defineCommand as defineCommand92 } from "citty";
 
 // src/commands/canvas/definition-graph.ts
 var MAX_NODES = 300;
@@ -20614,15 +20931,15 @@ async function syncCreativeDefinitionBestEffort(input) {
   }
 }
 async function resolveCanvasPath(inputPath) {
-  const resolved = path16.resolve(inputPath);
+  const resolved = path17.resolve(inputPath);
   let dir = resolved;
   try {
     if ((await stat3(resolved)).isFile()) {
       if (resolved.endsWith(".canvas.json")) return resolved;
-      dir = path16.dirname(resolved);
+      dir = path17.dirname(resolved);
     }
   } catch {
-    dir = resolved.endsWith(".canvas.json") ? path16.dirname(resolved) : resolved;
+    dir = resolved.endsWith(".canvas.json") ? path17.dirname(resolved) : resolved;
   }
   let entries;
   try {
@@ -20633,9 +20950,9 @@ async function resolveCanvasPath(inputPath) {
   const canvases = entries.filter((name) => name.endsWith(".canvas.json"));
   const slug = creativeSlugFromCanvasPath(`${dir}/x/`);
   const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
-  return chosen ? path16.join(dir, chosen) : null;
+  return chosen ? path17.join(dir, chosen) : null;
 }
-var syncDefinitionCommand = defineCommand90({
+var syncDefinitionCommand = defineCommand92({
   meta: {
     name: "sync-definition",
     description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. Runs automatically when you edit a creative's canvas.json or prompt.json."
@@ -20656,7 +20973,7 @@ var syncDefinitionCommand = defineCommand90({
     if (!slug) return;
     let canvas;
     try {
-      canvas = JSON.parse(await readFile10(canvasPath, "utf8"));
+      canvas = JSON.parse(await readFile11(canvasPath, "utf8"));
     } catch {
       return;
     }
@@ -20681,7 +20998,7 @@ async function uploadSourceAsReference(source, isUrl, client) {
     if (!res.ok) throw new Error(`failed to download source image (${res.status})`);
     bytes = Buffer.from(await res.arrayBuffer());
   } else {
-    bytes = await readFile11(source);
+    bytes = await readFile12(source);
   }
   const safe = await toModelSafeImage(bytes);
   const sha256 = sha256Hex(safe.bytes);
@@ -20736,7 +21053,7 @@ DROP background extras, decorative props, generic scenery, and anything small or
 For each kept element return: { "type": one of logo|product|person|animal|badge, "label": a short UPPER_SNAKE_CASE name (e.g. LOGO, PRODUCT, HERO_DOG, TRUSTPILOT), "description": a concrete reusable description to source/shoot the real asset (include the exact expression for a living subject, and its castable attributes \u2014 breed/species for an animal, apparent age band, apparent origin/ethnicity, and wardrobe/setting for a person \u2014 so it can be recast to fit OUR audience/market), "expression": the facial expression for a living subject or null, "reason": why it is identity-critical, "locator": the blueprint entry this element came from as { "collection": one of "subjects" | "people" | "brands_logos", "index": its 0-based position in that array } (people -> people; logos/badges -> brands_logos; products/animals/objects -> subjects). Output ONLY the JSON object.`;
 async function loadAssetText(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile11(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile12(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -20760,7 +21077,7 @@ function parseLayout(raw) {
   }
   return null;
 }
-function fail2(code, message) {
+function fail3(code, message) {
   process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
 `);
   process.exit(2);
@@ -20771,7 +21088,7 @@ function resolveModels(args) {
     describeModel: pick("describe-model", "image_describe", "~google/gemini-pro-latest"),
     selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
     layoutModel: pick("layout-model", "text_generate", "~google/gemini-flash-latest"),
-    genModel: pick("gen-model", "image_generate", "openai/gpt-5.4-image-2")
+    genModel: pick("gen-model", "image_generate", "openai/gpt-image-2")
   };
 }
 var PLATFORM_PLACEMENTS = {
@@ -20851,8 +21168,8 @@ async function runVisionPasses(canvas) {
     outputsByNode = result.outputs_by_node;
     creditsSpent = result.stats?.total_credits;
   } catch (e) {
-    if (e instanceof ValidationError) return fail2("validation", JSON.stringify(e.issues));
-    return fail2("describe", e instanceof Error ? e.message : String(e));
+    if (e instanceof ValidationError) return fail3("validation", JSON.stringify(e.issues));
+    return fail3("describe", e instanceof Error ? e.message : String(e));
   }
   try {
     const blueprint = JSON.parse(await loadAssetText(outputsByNode.describe?.description, "describe output"));
@@ -20860,10 +21177,10 @@ async function runVisionPasses(canvas) {
     const layout = parseLayout(await loadAssetText(outputsByNode.layout?.text, "layout output"));
     return { blueprint, elements, layout, creditsSpent };
   } catch (e) {
-    return fail2("read_outputs", e instanceof Error ? e.message : String(e));
+    return fail3("read_outputs", e instanceof Error ? e.message : String(e));
   }
 }
-var scaffoldStaticAdCommand = defineCommand91({
+var scaffoldStaticAdCommand = defineCommand93({
   meta: {
     name: "scaffold-static-ad",
     description: "Turn a source/inspiration image into a runnable static-ad canvas. Runs billed passes \u2014 image_describe (the blueprint, baked to prompt.json as the editable 'prompt'), an AI selection of the image's MAIN identity elements, and a structured global-layout pass (the column/row grid with per-region bounds and text sizes) \u2014 then scaffolds a canvas that wires one [TODO] ingest slot per element (logo/product/subject/badge + brand font) into image_generate. By default it also fans the hero out to the platform's placement ratios (via image_aspect_adapt \u2014 the hero ratio is free, the rest are billed AI recompositions); pass --placements none for a single base ad, or a preset to pick the set. Edit prompt.json and drop the real assets, then `baker canvas run` it."
@@ -20912,7 +21229,7 @@ var scaffoldStaticAdCommand = defineCommand91({
       process.cwd(),
       slug
     );
-    await mkdir5(path17.dirname(outPath), { recursive: true });
+    await mkdir6(path18.dirname(outPath), { recursive: true });
     const { describeModel, selectModel, layoutModel, genModel } = resolveModels(args);
     let durableSourceUrl;
     if (referencesDir) {
@@ -20921,7 +21238,7 @@ var scaffoldStaticAdCommand = defineCommand91({
         try {
           durableSourceUrl = await uploadSourceAsReference(imageSource, imageIsUrl, client);
         } catch (e) {
-          return fail2("source_unavailable", e instanceof Error ? e.message : String(e));
+          return fail3("source_unavailable", e instanceof Error ? e.message : String(e));
         }
       }
     }
@@ -20938,7 +21255,7 @@ var scaffoldStaticAdCommand = defineCommand91({
     if (layout && annotated && typeof annotated === "object") {
       annotated.layout = layout;
     }
-    await writeFile6(blueprintPath, `${JSON.stringify(annotated, null, 2)}
+    await writeFile7(blueprintPath, `${JSON.stringify(annotated, null, 2)}
 `, "utf8");
     let canvasImagePath = imageSource;
     let canvasImageIsUrl = imageIsUrl;
@@ -20955,7 +21272,7 @@ var scaffoldStaticAdCommand = defineCommand91({
       args.placements ? String(args.placements) : void 0,
       definitionPlatform
     );
-    if (!placementsResult.ok) return fail2("invalid_placements", placementsResult.message);
+    if (!placementsResult.ok) return fail3("invalid_placements", placementsResult.message);
     const placements = placementsResult.placements;
     const opts = {
       genModel,
@@ -20973,7 +21290,7 @@ var scaffoldStaticAdCommand = defineCommand91({
       canvas = scaffoldStaticAd(blueprint, elements, opts);
       report = staticAdReport(blueprint, elements, opts);
     } catch (e) {
-      return fail2("scaffold", e instanceof Error ? e.message : String(e));
+      return fail3("scaffold", e instanceof Error ? e.message : String(e));
     }
     const validation = await validateCanvasDeep(canvas, defaultRegistry());
     if (!validation.ok) {
@@ -20983,10 +21300,10 @@ var scaffoldStaticAdCommand = defineCommand91({
       );
       process.exit(2);
     }
-    await writeFile6(outPath, `${JSON.stringify(canvas, null, 2)}
+    await writeFile7(outPath, `${JSON.stringify(canvas, null, 2)}
 `, "utf8");
     if (definitionPath && !await fileExists(definitionPath)) {
-      await writeFile6(
+      await writeFile7(
         definitionPath,
         buildCreativeDefinition({
           title: args.title ? String(args.title) : titleFromSlug(slug ?? ""),
@@ -21032,7 +21349,7 @@ var scaffoldStaticAdCommand = defineCommand91({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path17.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
+            edit_prompt: `Edit ${path18.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
             assets_to_supply: report.elements,
             font_slot: report.includes_font ? "Drop a brand font at the [TODO] brandfont path (the describe pass recorded the ad's typefaces under `fonts` in prompt.json \u2014 match those). The font is wired into the render as a TYPE SPECIMEN reference so generated text takes the brand letterforms. Delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             actor_sheets: report.actor_sheets.length > 0 ? `Each living hero (${report.actor_sheets.join(", ")}) is fused into a generated multi-view reference sheet (image_reference_sheet) that the render grounds on \u2014 so drop ONE clean photo at that hero's ingest and the sheet builds the consistent turnaround. Pass --skip-actor-sheets to ground on the lone photo instead.` : "none (no person/animal heroes detected, or --skip-actor-sheets)",
@@ -21049,10 +21366,10 @@ var scaffoldStaticAdCommand = defineCommand91({
 });
 
 // src/commands/canvas/scaffold-video.ts
-import { access as access2, cp, mkdir as mkdir6, readFile as readFile14, rm as rm6, writeFile as writeFile7 } from "fs/promises";
+import { access as access2, cp, mkdir as mkdir7, readFile as readFile15, rm as rm6, writeFile as writeFile8 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import path20 from "path";
-import { defineCommand as defineCommand92 } from "citty";
+import path21 from "path";
+import { defineCommand as defineCommand94 } from "citty";
 
 // src/engine/scaffold/lib/model-router.ts
 var SEEDANCE = "bytedance/seedance-2.0";
@@ -21090,7 +21407,7 @@ function routeVideoModel(input) {
 
 // src/engine/nodes/local/lib/sceneDetect.ts
 import { execFile as execFile2 } from "child_process";
-import { mkdtemp, readdir as readdir6, readFile as readFile12, rm as rm5 } from "fs/promises";
+import { mkdtemp, readdir as readdir6, readFile as readFile13, rm as rm5 } from "fs/promises";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
 import { promisify as promisify2 } from "util";
@@ -21166,7 +21483,7 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
     );
     const csvName = (await readdir6(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
     if (!csvName) return [];
-    return parsePySceneDetectCsvCuts(await readFile12(join2(outDir, csvName), "utf-8"));
+    return parsePySceneDetectCsvCuts(await readFile13(join2(outDir, csvName), "utf-8"));
   } finally {
     await rm5(outDir, { recursive: true, force: true });
   }
@@ -21191,23 +21508,23 @@ async function detectSceneCutsPySceneDetect(filePath, opts = {}) {
 
 // src/commands/canvas/composition-path.ts
 import { existsSync as existsSync3 } from "fs";
-import path18 from "path";
+import path19 from "path";
 function resolveShippedCanvasDir(name, startDir, exists = existsSync3, maxDepth = 8) {
-  const rel = path18.join("canvas", name);
+  const rel = path19.join("canvas", name);
   let dir = startDir;
   for (let i = 0; i < maxDepth; i++) {
-    const candidate = path18.join(dir, rel);
-    if (exists(path18.join(candidate, "meta.json"))) return candidate;
-    const parent = path18.dirname(dir);
+    const candidate = path19.join(dir, rel);
+    if (exists(path19.join(candidate, "meta.json"))) return candidate;
+    const parent = path19.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path18.resolve(startDir, "../../../", rel);
+  return path19.resolve(startDir, "../../../", rel);
 }
 
 // src/commands/canvas/gitignore.ts
-import { appendFile, readFile as readFile13 } from "fs/promises";
-import path19 from "path";
+import { appendFile, readFile as readFile14 } from "fs/promises";
+import path20 from "path";
 function missingGitignoreEntries(existing, entries) {
   const present2 = new Set(
     existing.split("\n").map((l) => l.trim().replace(/\/+$/, "")).filter((l) => l.length > 0 && !l.startsWith("#"))
@@ -21215,10 +21532,10 @@ function missingGitignoreEntries(existing, entries) {
   return entries.filter((e) => !present2.has(e.trim().replace(/\/+$/, "")));
 }
 async function ensureGitignore(dir, entries) {
-  const file = path19.join(dir, ".gitignore");
+  const file = path20.join(dir, ".gitignore");
   let existing;
   try {
-    existing = await readFile13(file, "utf8");
+    existing = await readFile14(file, "utf8");
   } catch {
     return;
   }
@@ -21257,7 +21574,7 @@ ONE PERSON, MULTIPLE LOOKS: if a single individual plays MULTIPLE personas or wa
 For each kept element return: { "type": one of person|animal|product|logo|badge|location, "label": a short UPPER_SNAKE_CASE name (e.g. HERO, CREATOR_SKEPTIC, INSURANCE_CARD, LOGO), "description": a concrete reusable description to source/shoot the real asset \u2014 for a person/animal give a NEUTRAL castable role (e.g. "hero pet-owner, woman in her 30s" or "a small beagle"), NOT the original individual's literal face/identity: we RECAST with a FRESH person/animal, so never tell the agent to reuse the original. "expression": a living subject's typical expression or null, "cast_id": the global.cast id if it maps to one else null, "same_as": the label of another element this is the SAME individual as (different wardrobe/persona) else null, "scenes": the 0-based indices of ONLY the scenes where the element is ACTUALLY VISIBLE ON SCREEN \u2014 judged from that scene's start_frame_prompt / end_frame_prompt subjects and its action_detail, NOT from who is merely speaking. A narrator heard over b-roll is NOT present in that b-roll scene; a dog-running cutaway does NOT contain the couch creator just because she talks across it. Do NOT pad the list \u2014 an element wrongly listed in a scene makes the reproduction render the wrong subject there (e.g. the creator appearing in a pure-dog b-roll). When in doubt, leave a scene OUT. Output ONLY the JSON object.`;
 async function loadAssetText2(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile14(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile15(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -21276,7 +21593,7 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text = transcript?.trim();
   if (!text || text === "[]") return {};
-  const compositionPath = path20.join(outDir, "tiktok-captions-composition");
+  const compositionPath = path21.join(outDir, "tiktok-captions-composition");
   await cp(SHIPPED_CAPTIONS_DIR, compositionPath, { recursive: true });
   return { compositionPath };
 }
@@ -21294,12 +21611,12 @@ function patchCompositionHtml(html, dims) {
   return html.replace(/(<meta\s+name="viewport"\s+content="width=)\d+(,\s*height=)\d+(")/i, `$1${dims.w}$2${dims.h}$3`).replace(/(width:\s*)\d+(px;\s*height:\s*)\d+(px;)/i, `$1${dims.w}$2${dims.h}$3`).replace(/(data-width=")\d+(")/i, `$1${dims.w}$2`).replace(/(data-height=")\d+(")/i, `$1${dims.h}$2`);
 }
 async function stampCompositionDims(compositionDir, dims) {
-  const metaPath = path20.join(compositionDir, "meta.json");
-  const rawMeta = await readFile14(metaPath, "utf8");
-  await writeFile7(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
-  const htmlPath = path20.join(compositionDir, "index.html");
-  const rawHtml = await readFile14(htmlPath, "utf8");
-  await writeFile7(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
+  const metaPath = path21.join(compositionDir, "meta.json");
+  const rawMeta = await readFile15(metaPath, "utf8");
+  await writeFile8(metaPath, patchCompositionMeta(rawMeta, dims), "utf8");
+  const htmlPath = path21.join(compositionDir, "index.html");
+  const rawHtml = await readFile15(htmlPath, "utf8");
+  await writeFile8(htmlPath, patchCompositionHtml(rawHtml, dims), "utf8");
 }
 function parseElements2(raw) {
   const parsed = JSON.parse(raw);
@@ -21334,7 +21651,7 @@ async function detectShotCutsBestEffort(videoPath, threshold) {
     return void 0;
   }
 }
-function fail3(code, message) {
+function fail4(code, message) {
   process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
 `);
   process.exit(2);
@@ -21346,7 +21663,7 @@ var VIDEO_EXT_BY_MIME = {
   "video/x-matroska": ".mkv"
 };
 function referenceVideoExt(url, contentType) {
-  const fromPath = path20.extname(new URL(url).pathname).toLowerCase();
+  const fromPath = path21.extname(new URL(url).pathname).toLowerCase();
   if (fromPath && fromPath.length <= 5) return fromPath;
   const mime = (contentType ?? "").split(";")[0]?.trim().toLowerCase();
   return mime && VIDEO_EXT_BY_MIME[mime] || ".mp4";
@@ -21372,7 +21689,7 @@ function videoDefinitionDescription(blueprint) {
   return typeof product === "string" && product.trim() ? product.trim() : void 0;
 }
 async function materializeReferenceVideo(fileArg2) {
-  if (!/^https?:\/\//i.test(fileArg2)) return path20.resolve(fileArg2);
+  if (!/^https?:\/\//i.test(fileArg2)) return path21.resolve(fileArg2);
   let res;
   try {
     res = await fetch(fileArg2);
@@ -21382,11 +21699,11 @@ async function materializeReferenceVideo(fileArg2) {
   if (!res.ok) throw new Error(`failed to download reference video (${res.status} ${res.statusText})`);
   const bytes = Buffer.from(await res.arrayBuffer());
   if (bytes.length === 0) throw new Error("reference video download was empty");
-  const dest = path20.join(
+  const dest = path21.join(
     tmpdir2(),
     `baker-ref-${sha256Hex(bytes).slice(0, 16)}${referenceVideoExt(fileArg2, res.headers.get("content-type"))}`
   );
-  await writeFile7(dest, bytes);
+  await writeFile8(dest, bytes);
   return dest;
 }
 function resolveSeamDedup(raw) {
@@ -21413,7 +21730,7 @@ function resolveModels2(args) {
     // Default to the strongest image model (matches the static-ad scaffold); the
     // frame generators need the most faithful text/identity reproduction. Override
     // with --image-model for a cheaper/faster pass.
-    imageModel: pick("image-model", "image_generate", "openai/gpt-5.4-image-2")
+    imageModel: pick("image-model", "image_generate", "openai/gpt-image-2")
   };
 }
 function hasPhotorealCast(elements) {
@@ -21494,9 +21811,9 @@ async function runAnalysisPasses(deconstructCanvas, selectModel) {
     blueprint = JSON.parse(await loadAssetText2(r1.outputs_by_node.deconstruct?.analysis, "deconstruct output"));
     transcript = await loadTranscriptBestEffort(r1.outputs_by_node.deconstruct?.transcript);
   } catch (e) {
-    if (e instanceof ValidationError) return fail3("validation", JSON.stringify(e.issues));
-    if (e instanceof SyntaxError) return fail3("read_outputs", e.message);
-    return fail3("deconstruct", e instanceof Error ? e.message : String(e));
+    if (e instanceof ValidationError) return fail4("validation", JSON.stringify(e.issues));
+    if (e instanceof SyntaxError) return fail4("read_outputs", e.message);
+    return fail4("deconstruct", e instanceof Error ? e.message : String(e));
   }
   const slimJson = JSON.stringify(slimBlueprintForSelection(blueprint));
   try {
@@ -21505,12 +21822,12 @@ async function runAnalysisPasses(deconstructCanvas, selectModel) {
     const elements = parseElements2(await loadAssetText2(r2.outputs_by_node.select?.text, "selection output"));
     return { blueprint, elements, transcript, creditsSpent: sawCredits ? credits : void 0 };
   } catch (e) {
-    if (e instanceof ValidationError) return fail3("validation", JSON.stringify(e.issues));
-    if (e instanceof SyntaxError) return fail3("read_outputs", e.message);
-    return fail3("deconstruct", e instanceof Error ? e.message : String(e));
+    if (e instanceof ValidationError) return fail4("validation", JSON.stringify(e.issues));
+    if (e instanceof SyntaxError) return fail4("read_outputs", e.message);
+    return fail4("deconstruct", e instanceof Error ? e.message : String(e));
   }
 }
-var scaffoldVideoCommand = defineCommand92({
+var scaffoldVideoCommand = defineCommand94({
   meta: {
     name: "scaffold-video",
     description: "Turn a reference video into a runnable reproduction canvas in one command. Runs billed passes \u2014 video_deconstruct (the full scene-by-scene blueprint + transcript, baked to a split, editable blueprint: a global prompt.json plus one small scenes/sNN.json per scene) and an AI selection of the video's RECURRING identity elements (person/animal/product/logo) \u2014 then scaffolds a pipeline where every scene boundary is a static-ad-grade frame (the blueprint as target_blueprint, a reference legend, the real frame as anchor) and each recurring element gets ONE shared [TODO] ingest slot wired into every frame it appears in. The clips feed Seedance an ultra-detailed motion brief (action, camera, dialogue, transcript). Edit a scene's scenes/sNN.json (or prompt.json for global cast/palette/brand), drop the real source images, then `baker canvas run`."
@@ -21591,7 +21908,7 @@ var scaffoldVideoCommand = defineCommand92({
     }
     const isUrl = /^https?:\/\//i.test(fileArg2);
     if (isUrl && !slug && !args.out) {
-      return fail3(
+      return fail4(
         "missing_output_target",
         "When the reference is a URL, pass --slug (writes src/creatives/<slug>/) or --out <path> so the scaffolded canvas has a home in the repo."
       );
@@ -21600,13 +21917,13 @@ var scaffoldVideoCommand = defineCommand92({
     try {
       videoPath = await materializeReferenceVideo(fileArg2);
     } catch (e) {
-      return fail3("download", e instanceof Error ? e.message : String(e));
+      return fail4("download", e instanceof Error ? e.message : String(e));
     }
-    const base = path20.basename(videoPath, path20.extname(videoPath));
-    const outPath = args.out ? path20.resolve(String(args.out)) : slug ? path20.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path20.join(path20.dirname(videoPath), `${base}.video.canvas.json`);
-    const outDir = path20.dirname(outPath);
-    const blueprintPath = path20.join(outDir, "prompt.json");
-    const blueprintStylePath = path20.join(outDir, "prompt.style.json");
+    const base = path21.basename(videoPath, path21.extname(videoPath));
+    const outPath = args.out ? path21.resolve(String(args.out)) : slug ? path21.join(process.cwd(), "src", "creatives", slug, `${slug}.canvas.json`) : path21.join(path21.dirname(videoPath), `${base}.video.canvas.json`);
+    const outDir = path21.dirname(outPath);
+    const blueprintPath = path21.join(outDir, "prompt.json");
+    const blueprintStylePath = path21.join(outDir, "prompt.style.json");
     const frames = args.frames === "reuse" ? "reuse" : "generate";
     const maxScenes = args["max-scenes"] ? Number(args["max-scenes"]) : void 0;
     if (Number.isFinite(maxScenes)) {
@@ -21630,10 +21947,10 @@ var scaffoldVideoCommand = defineCommand92({
       process.stderr.write(`\u{1F3AC} Photoreal on-camera cast detected \u2192 generating clips on ${videoModel} (dodges Seedance's real-person filter).
 `);
     }
-    await mkdir6(outDir, { recursive: true });
+    await mkdir7(outDir, { recursive: true });
     const annotated = annotateBlueprintWithElements(blueprint, elements);
     await writeSceneFiles(outDir, annotated);
-    await writeFile7(blueprintStylePath, renderStyleProjectionFromValue(annotated), "utf8");
+    await writeFile8(blueprintStylePath, renderStyleProjectionFromValue(annotated), "utf8");
     let aspect;
     try {
       aspect = resolveAspect(
@@ -21642,7 +21959,7 @@ var scaffoldVideoCommand = defineCommand92({
         genAspectsFor(videoModel)
       );
     } catch (e) {
-      return fail3("aspect", e instanceof Error ? e.message : String(e));
+      return fail4("aspect", e instanceof Error ? e.message : String(e));
     }
     const outDims = canvasDims(aspect.outAr);
     if (aspect.remapped) {
@@ -21651,29 +21968,29 @@ var scaffoldVideoCommand = defineCommand92({
 `
       );
     }
-    const compositionDest = path20.join(outDir, "video-overlay-composition");
+    const compositionDest = path21.join(outDir, "video-overlay-composition");
     await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
     await stampCompositionDims(compositionDest, outDims);
-    const indexPath = path20.join(compositionDest, "index.html");
+    const indexPath = path21.join(compositionDest, "index.html");
     const overlayHtml = buildOverlayHtml(blueprint, { captionsActive: Boolean(transcript) });
-    const indexHtml = await readFile14(indexPath, "utf8");
+    const indexHtml = await readFile15(indexPath, "utf8");
     const injected = indexHtml.replace("<!--OVERLAYS-->", () => overlayHtml);
     if (injected === indexHtml && overlayHtml.trim()) {
-      fail3(
+      fail4(
         "composition_marker_missing",
         `video-overlay-composition/index.html is missing the <!--OVERLAYS--> marker \u2014 cannot inject the overlay layer`
       );
     }
-    await writeFile7(indexPath, injected, "utf8");
+    await writeFile8(indexPath, injected, "utf8");
     const captions = await stageCaptions(outDir, transcript);
     if (captions.compositionPath) await stampCompositionDims(captions.compositionPath, outDims);
     const opts = {
       imageModel,
       videoModel,
-      overlayCompositionPath: path20.relative(outDir, compositionDest),
-      captionsCompositionPath: captions.compositionPath ? path20.relative(outDir, captions.compositionPath) : void 0,
-      blueprintPath: path20.relative(outDir, blueprintPath),
-      blueprintStylePath: path20.relative(outDir, blueprintStylePath),
+      overlayCompositionPath: path21.relative(outDir, compositionDest),
+      captionsCompositionPath: captions.compositionPath ? path21.relative(outDir, captions.compositionPath) : void 0,
+      blueprintPath: path21.relative(outDir, blueprintPath),
+      blueprintStylePath: path21.relative(outDir, blueprintStylePath),
       frames,
       ambient: Boolean(args.ambient),
       seamDedup: resolveSeamDedup(args["seam-dedup"]),
@@ -21686,7 +22003,7 @@ var scaffoldVideoCommand = defineCommand92({
       canvas = scaffoldVideoCanvas(blueprint, elements, opts);
       report = videoReport(blueprint, elements);
     } catch (e) {
-      return fail3("scaffold", e instanceof Error ? e.message : String(e));
+      return fail4("scaffold", e instanceof Error ? e.message : String(e));
     }
     if (captions.compositionPath && !canvas.nodes.some((n) => n.id === "captions")) {
       await rm6(captions.compositionPath, { recursive: true, force: true });
@@ -21698,10 +22015,10 @@ var scaffoldVideoCommand = defineCommand92({
       todo.blocking_validation_issues = validation.issues;
       meta.todo = todo;
     }
-    await writeFile7(outPath, `${JSON.stringify(canvas, null, 2)}
+    await writeFile8(outPath, `${JSON.stringify(canvas, null, 2)}
 `, "utf8");
-    await writeFile7(
-      path20.join(outDir, REBUILD_FILE),
+    await writeFile8(
+      path21.join(outDir, REBUILD_FILE),
       `${JSON.stringify({ elements, opts }, null, 2)}
 `,
       "utf8"
@@ -21726,9 +22043,9 @@ var scaffoldVideoCommand = defineCommand92({
     await ensureGitignore(process.cwd(), ["canvas/", ".context/"]);
     const sourceRef = videoSourceReference(blueprint, fileArg2);
     if (slug) {
-      const definitionPath = path20.join(outDir, "_definition.md");
+      const definitionPath = path21.join(outDir, "_definition.md");
       if (!await fileExists2(definitionPath)) {
-        await writeFile7(
+        await writeFile8(
           definitionPath,
           buildCreativeDefinition({
             title: titleFromSlug(slug),
@@ -21781,7 +22098,7 @@ var scaffoldVideoCommand = defineCommand92({
             graph: canvas.metadata?.video?.graph_stats
           },
           checklist: {
-            edit_prompt: `The blueprint is split so you edit ONE small file at a time \u2014 never a giant one. Per-scene content (a scene's dialogue, action, frame prompts, overlays) lives in \`scenes/sNN.json\` \u2014 edit the single scene you want to change. Global cast/palette/brand/copy lives in \`${path20.basename(blueprintPath)}\`. \`baker canvas validate\`/\`run\` re-assemble the blueprint and re-flow every edited scene back into the render (and regenerate ${path20.basename(blueprintStylePath)}, the projection each frame's target_blueprint reads) \u2014 so your scene edits reach the render automatically. Never hand-edit the inlined node prompts in the canvas or the derived ${path20.basename(blueprintStylePath)}; both are regenerated.`,
+            edit_prompt: `The blueprint is split so you edit ONE small file at a time \u2014 never a giant one. Per-scene content (a scene's dialogue, action, frame prompts, overlays) lives in \`scenes/sNN.json\` \u2014 edit the single scene you want to change. Global cast/palette/brand/copy lives in \`${path21.basename(blueprintPath)}\`. \`baker canvas validate\`/\`run\` re-assemble the blueprint and re-flow every edited scene back into the render (and regenerate ${path21.basename(blueprintStylePath)}, the projection each frame's target_blueprint reads) \u2014 so your scene edits reach the render automatically. Never hand-edit the inlined node prompts in the canvas or the derived ${path21.basename(blueprintStylePath)}; both are regenerated.`,
             recurring_elements_to_supply: report.elements,
             voices_to_confirm: report.dialogue.map((d) => ({
               scene: d.scene,
@@ -21818,9 +22135,9 @@ var scaffoldVideoCommand = defineCommand92({
 });
 
 // src/commands/canvas/set-prompt.ts
-import { readFile as readFile15, writeFile as writeFile8 } from "fs/promises";
-import path21 from "path";
-import { defineCommand as defineCommand93 } from "citty";
+import { readFile as readFile16, writeFile as writeFile9 } from "fs/promises";
+import path22 from "path";
+import { defineCommand as defineCommand95 } from "citty";
 function setNodePrompt(canvas, nodeId, text) {
   const nodes = canvas?.nodes;
   if (!Array.isArray(nodes)) throw new Error("canvas has no nodes array");
@@ -21835,7 +22152,7 @@ function setNodePrompt(canvas, nodeId, text) {
   newNodes[idx] = newNode;
   return { ...canvas, nodes: newNodes };
 }
-var setPromptCommand = defineCommand93({
+var setPromptCommand = defineCommand95({
   meta: {
     name: "set-prompt",
     description: "Safely set a node's params.prompt (a frame description, motion prompt, etc.) without hand-editing the JSON. Prefer --text-file for multi-line/accented copy \u2014 it preserves UTF-8 exactly, unlike shell-quoted jq."
@@ -21847,17 +22164,17 @@ var setPromptCommand = defineCommand93({
     "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
   },
   async run({ args }) {
-    const filePath = path21.resolve(String(args.file));
+    const filePath = path22.resolve(String(args.file));
     let canvas;
     try {
-      canvas = JSON.parse(await readFile15(filePath, "utf8"));
+      canvas = JSON.parse(await readFile16(filePath, "utf8"));
     } catch (e) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "parse", message: String(e) } }, null, 2)}
 `);
       process.exit(2);
     }
     let text;
-    if (args["text-file"]) text = await readFile15(path21.resolve(String(args["text-file"])), "utf8");
+    if (args["text-file"]) text = await readFile16(path22.resolve(String(args["text-file"])), "utf8");
     else if (args.text !== void 0) text = String(args.text);
     else {
       process.stderr.write(
@@ -21878,14 +22195,14 @@ var setPromptCommand = defineCommand93({
       process.exit(2);
       return;
     }
-    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path21.dirname(filePath)), defaultRegistry());
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path22.dirname(filePath)), defaultRegistry());
     if (!validation.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.issues } }, null, 2)}
 `);
       process.exit(2);
       return;
     }
-    await writeFile8(filePath, `${JSON.stringify(updated, null, 2)}
+    await writeFile9(filePath, `${JSON.stringify(updated, null, 2)}
 `, "utf8");
     process.stdout.write(`${JSON.stringify({ ok: true, node: String(args.node), bytes: text.length }, null, 2)}
 `);
@@ -21893,18 +22210,18 @@ var setPromptCommand = defineCommand93({
 });
 
 // src/commands/canvas/validate.ts
-import { readFile as readFile16 } from "fs/promises";
-import path22 from "path";
-import { defineCommand as defineCommand94 } from "citty";
-var validateCommand = defineCommand94({
+import { readFile as readFile17 } from "fs/promises";
+import path23 from "path";
+import { defineCommand as defineCommand96 } from "citty";
+var validateCommand = defineCommand96({
   meta: {
     name: "validate",
     description: "Validate a canvas JSON file (no execution). Includes a per-node cost preview and runs each node's deep validators (composition meta checks for hyperframe_render/_snapshot)."
   },
   args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
   async run({ args }) {
-    const filePath = path22.resolve(String(args.file));
-    const raw = await readFile16(filePath, "utf8");
+    const filePath = path23.resolve(String(args.file));
+    const raw = await readFile17(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -21914,7 +22231,7 @@ var validateCommand = defineCommand94({
 `);
       process.exit(2);
     }
-    parsed = resolveRelativeCanvasPaths(parsed, path22.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path23.dirname(filePath));
     let styleProjection = "not_applicable";
     try {
       styleProjection = await syncStyleProjection(parsed, (line) => process.stderr.write(`${line}
@@ -21966,7 +22283,7 @@ var validateCommand = defineCommand94({
 });
 
 // src/commands/canvas/index.ts
-var canvasCommand = defineCommand95({
+var canvasCommand = defineCommand97({
   meta: {
     name: "canvas",
     description: `Run Baker creative canvas JSON files locally. Local nodes execute in-process; remote nodes POST to the Convex backend gateway.
@@ -22000,7 +22317,7 @@ Full guide: __tooling__/docs/tools/baker/canvas.md`
 });
 
 // src/commands/chats/index.ts
-import { defineCommand as defineCommand96 } from "citty";
+import { defineCommand as defineCommand98 } from "citty";
 var STATUS_GROUPS = ["active", "archived", "all"];
 var REPO_SURFACES = ["knowledge", "company", "brand", "landings", "flows", "creatives"];
 function parseBoundedInt(raw, name, min, max) {
@@ -22022,7 +22339,7 @@ registerSchema({
     full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
   }
 });
-var listCommand5 = defineCommand96({
+var listCommand5 = defineCommand98({
   meta: { name: "list", description: "List other Sessions on this account, newest first." },
   args: {
     status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
@@ -22077,7 +22394,7 @@ registerSchema({
     }
   }
 });
-var viewCommand = defineCommand96({
+var viewCommand = defineCommand98({
   meta: {
     name: "view",
     description: "Inspect one Session's full effects \u2014 git content + actions/tags/ads, kickoff, commits."
@@ -22121,7 +22438,7 @@ registerSchema({
     }
   }
 });
-var transcriptCommand = defineCommand96({
+var transcriptCommand = defineCommand98({
   meta: { name: "transcript", description: "Read another Session's conversation." },
   args: {
     id: { type: "positional", description: "The Session id", required: true },
@@ -22173,7 +22490,7 @@ registerSchema({
     }
   }
 });
-var diffCommand = defineCommand96({
+var diffCommand = defineCommand98({
   meta: { name: "diff", description: "See a published Session's real file-level changes." },
   args: {
     id: { type: "positional", description: "The Session id", required: true },
@@ -22217,7 +22534,7 @@ var diffCommand = defineCommand96({
     }
   }
 });
-var chatsCommand = defineCommand96({
+var chatsCommand = defineCommand98({
   meta: {
     name: "chats",
     description: `Inspect other Sessions on this account (read-only): list them, view what they produced, read their conversation, and see their real file changes \u2014 so you can reuse past work for a new goal.
@@ -22232,13 +22549,13 @@ Full guide: __tooling__/docs/tools/baker/chats.md`
 });
 
 // src/commands/creatives/index.ts
-import { defineCommand as defineCommand98 } from "citty";
+import { defineCommand as defineCommand100 } from "citty";
 
 // src/commands/creatives/publish.ts
-import { defineCommand as defineCommand97 } from "citty";
+import { defineCommand as defineCommand99 } from "citty";
 
 // src/commands/images/api.ts
-import { readFile as readFile17 } from "fs/promises";
+import { readFile as readFile18 } from "fs/promises";
 import { extname } from "path";
 var imageProcessingTimeoutMs = 18e4;
 var imageReadyPollIntervalMs = 2e3;
@@ -22252,7 +22569,7 @@ var mimeMap = {
   ".avif": "image/avif"
 };
 var defaultImageApiDeps = {
-  readFile: readFile17,
+  readFile: readFile18,
   post: apiPost,
   get: apiGet,
   sleep: (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))
@@ -22379,7 +22696,7 @@ async function publishCreative(args, deps = defaultImageApiDeps) {
     chatId: chatIdFromEnv()
   });
 }
-var publishCommand = defineCommand97({
+var publishCommand = defineCommand99({
   meta: {
     name: "publish",
     description: "Publish a final static creative image to Baker Creatives and print the creative reference JSON."
@@ -22437,7 +22754,7 @@ var publishCommand = defineCommand97({
 });
 
 // src/commands/creatives/index.ts
-var creativesCommand3 = defineCommand98({
+var creativesCommand3 = defineCommand100({
   meta: {
     name: "creatives",
     description: `Publish static ad creatives as first-class Baker outputs.
@@ -22454,7 +22771,7 @@ Full guide: __tooling__/docs/tools/baker/creatives.md`
 });
 
 // src/commands/flows/index.ts
-import { defineCommand as defineCommand99 } from "citty";
+import { defineCommand as defineCommand101 } from "citty";
 
 // src/commands/flows/shared.ts
 import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync9 } from "fs";
@@ -22487,12 +22804,12 @@ function listFlowSlugs() {
   return readdirSync2(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith("_") && entry.name !== ".gitkeep").map((entry) => entry.name).sort();
 }
 function readFlowTree(slug) {
-  const path27 = join3(flowsDir(), slug, "_data.json");
-  if (!existsSync4(path27)) {
+  const path28 = join3(flowsDir(), slug, "_data.json");
+  if (!existsSync4(path28)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync9(path27, "utf-8"));
+    return JSON.parse(readFileSync9(path28, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -22609,7 +22926,7 @@ function displayName(slug) {
   const name = tree.displayName;
   return typeof name === "string" && name.trim() ? name.trim() : slug;
 }
-var listCommand6 = defineCommand99({
+var listCommand6 = defineCommand101({
   meta: {
     name: "list",
     description: "List Forms in this workspace with the count of confidential fields still needing setup. Example: baker flows list"
@@ -22623,7 +22940,7 @@ var listCommand6 = defineCommand99({
     writeJson({ ok: true, data: { flows } });
   }
 });
-var showCommand2 = defineCommand99({
+var showCommand2 = defineCommand101({
   meta: {
     name: "show",
     description: "Show a Form's confidential fields and their configuration status (never secret values). Example: baker flows show contact"
@@ -22644,7 +22961,7 @@ var showCommand2 = defineCommand99({
     writeJson({ ok: true, data: response });
   }
 });
-var flowsCommand = defineCommand99({
+var flowsCommand = defineCommand101({
   meta: {
     name: "flows",
     description: `Read this workspace's Forms (flows) and the configuration status of their confidential fields \u2014 connection secrets, OAuth connections, and third-party field definitions (HubSpot, Calendly, HighLevel, SavvyCal).
@@ -22672,10 +22989,10 @@ Full guide: __tooling__/docs/tools/baker/flows.md`
 });
 
 // src/commands/ga4/index.ts
-import { defineCommand as defineCommand103 } from "citty";
+import { defineCommand as defineCommand105 } from "citty";
 
 // src/commands/ga4/audit.ts
-import { defineCommand as defineCommand100 } from "citty";
+import { defineCommand as defineCommand102 } from "citty";
 
 // src/commands/ga4/resolve.ts
 async function fetchProperties(useCache = true) {
@@ -22738,7 +23055,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var auditCommand2 = defineCommand100({
+var auditCommand2 = defineCommand102({
   meta: {
     name: "audit",
     description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
@@ -22790,7 +23107,7 @@ Examples:
 });
 
 // src/commands/ga4/properties.ts
-import { defineCommand as defineCommand101 } from "citty";
+import { defineCommand as defineCommand103 } from "citty";
 registerSchema({
   command: "ga4.properties",
   description: "List all accessible GA4 properties. Returns property IDs needed for query and audit commands. Run this first to find property IDs.",
@@ -22798,7 +23115,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var propertiesCommand = defineCommand101({
+var propertiesCommand = defineCommand103({
   meta: {
     name: "properties",
     description: `List accessible GA4 properties.
@@ -22848,7 +23165,7 @@ Examples:
 // src/commands/ga4/query.ts
 import { appendFileSync as appendFileSync2, existsSync as existsSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync3 } from "fs";
 import { resolve as resolve2 } from "path";
-import { defineCommand as defineCommand102 } from "citty";
+import { defineCommand as defineCommand104 } from "citty";
 
 // src/commands/ga4/presets.ts
 var GA4_PRESETS = [
@@ -22980,7 +23297,7 @@ function handleError(err) {
   });
   process.exit(1);
 }
-var queryCommand2 = defineCommand102({
+var queryCommand2 = defineCommand104({
   meta: {
     name: "query",
     description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
@@ -23051,7 +23368,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/ga4/index.ts
-var ga4Command = defineCommand103({
+var ga4Command = defineCommand105({
   meta: {
     name: "ga4",
     description: `Google Analytics 4 commands. Audit property config, run playbook-aligned reports.
@@ -23075,12 +23392,12 @@ Full guide: __tooling__/docs/tools/baker/ga4.md`
 });
 
 // src/commands/gsc/index.ts
-import { defineCommand as defineCommand107 } from "citty";
+import { defineCommand as defineCommand109 } from "citty";
 
 // src/commands/gsc/query.ts
 import { appendFileSync as appendFileSync3, existsSync as existsSync6, readFileSync as readFileSync11, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve3 } from "path";
-import { defineCommand as defineCommand104 } from "citty";
+import { defineCommand as defineCommand106 } from "citty";
 
 // src/commands/gsc/presets.ts
 var GSC_PRESETS = [
@@ -23268,7 +23585,7 @@ function handleError2(err) {
   });
   process.exit(1);
 }
-var queryCommand3 = defineCommand104({
+var queryCommand3 = defineCommand106({
   meta: {
     name: "query",
     description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
@@ -23346,7 +23663,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/gsc/sitemaps.ts
-import { defineCommand as defineCommand105 } from "citty";
+import { defineCommand as defineCommand107 } from "citty";
 registerSchema({
   command: "gsc.sitemaps",
   description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
@@ -23355,7 +23672,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitemapsCommand = defineCommand105({
+var sitemapsCommand = defineCommand107({
   meta: {
     name: "sitemaps",
     description: `List sitemaps for a site. Check health and errors.
@@ -23405,7 +23722,7 @@ Examples:
 });
 
 // src/commands/gsc/sites.ts
-import { defineCommand as defineCommand106 } from "citty";
+import { defineCommand as defineCommand108 } from "citty";
 registerSchema({
   command: "gsc.sites",
   description: "List all verified Google Search Console sites. Returns site URLs needed for query and sitemaps commands.",
@@ -23413,7 +23730,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitesCommand = defineCommand106({
+var sitesCommand = defineCommand108({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -23461,7 +23778,7 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-var gscCommand = defineCommand107({
+var gscCommand = defineCommand109({
   meta: {
     name: "gsc",
     description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
@@ -23485,7 +23802,7 @@ Full guide: __tooling__/docs/tools/baker/gsc.md`
 });
 
 // src/commands/history/index.ts
-import { defineCommand as defineCommand108 } from "citty";
+import { defineCommand as defineCommand110 } from "citty";
 registerSchema({
   command: "history.list",
   description: "Start here: unified account history (audit log) \u2014 everything that changed on this account, newest first: publishes, chat lifecycle, backlog actions, team changes, setup links, tags, schedules, ad-platform writes, followed advertisers, media, creatives, reports, domains, and integrations. Use it to see what happened recently before planning work. Compact by default; add --full for raw metadata per entry.",
@@ -23540,7 +23857,7 @@ function parseBoundedInt2(raw, name, min, max) {
   }
   return value;
 }
-var listCommand7 = defineCommand108({
+var listCommand7 = defineCommand110({
   meta: {
     name: "list",
     description: "List recent account changes (unified audit log), newest first."
@@ -23586,7 +23903,7 @@ var listCommand7 = defineCommand108({
     }
   }
 });
-var historyCommand = defineCommand108({
+var historyCommand = defineCommand110({
   meta: {
     name: "history",
     description: `Unified account history (audit log): what changed, who did it, and when.
@@ -23596,10 +23913,10 @@ Full guide: __tooling__/docs/tools/baker/history.md`
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand134 } from "citty";
 
 // src/commands/images/crop.ts
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand111 } from "citty";
 
 // src/lib/image/crop-sprite.ts
 import sharp from "sharp";
@@ -23614,7 +23931,7 @@ function cropSprite(input, region) {
 
 // src/lib/image/io.ts
 import { randomBytes } from "crypto";
-import { glob as fsGlob, readFile as readFile18, rename, stat as stat4, writeFile as writeFile9 } from "fs/promises";
+import { glob as fsGlob, readFile as readFile19, rename, stat as stat4, writeFile as writeFile10 } from "fs/promises";
 import { dirname as dirname2, extname as extname2, join as join4, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
@@ -23650,11 +23967,11 @@ async function readImageBuffer(pathOrUrl) {
     }
     return Buffer.from(await response.arrayBuffer());
   }
-  return readFile18(pathOrUrl);
+  return readFile19(pathOrUrl);
 }
-async function isDirectory(path27) {
+async function isDirectory(path28) {
   try {
-    const s = await stat4(path27);
+    const s = await stat4(path28);
     return s.isDirectory();
   } catch {
     return false;
@@ -23673,7 +23990,7 @@ async function atomicWrite(targetPath, data) {
   const absolute = resolve4(targetPath);
   const dir = dirname2(absolute);
   const tmp = join4(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
-  await writeFile9(tmp, data);
+  await writeFile10(tmp, data);
   await rename(tmp, absolute);
 }
 
@@ -23724,7 +24041,7 @@ function emitError2(err) {
   }
   process.exit(1);
 }
-var cropCommand = defineCommand109({
+var cropCommand = defineCommand111({
   meta: {
     name: "crop",
     description: "Crop a rectangular region from an image.\n\nExample: baker images crop sprite.png --x 0 --y 0 --width 64 --height 64 --output icon.png"
@@ -23760,7 +24077,7 @@ var cropCommand = defineCommand109({
 });
 
 // src/commands/images/delete.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 registerSchema({
   command: "images.delete",
   description: "Delete an image by ID",
@@ -23774,7 +24091,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand = defineCommand110({
+var deleteCommand = defineCommand112({
   meta: {
     name: "delete",
     description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run"
@@ -23815,7 +24132,7 @@ var deleteCommand = defineCommand110({
 });
 
 // src/commands/images/dimensions.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand113 } from "citty";
 
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
@@ -23838,7 +24155,7 @@ registerSchema({
     target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
   }
 });
-var dimensionsCommand = defineCommand111({
+var dimensionsCommand = defineCommand113({
   meta: {
     name: "dimensions",
     description: "Read image dimensions without decoding the full file.\n\nExample: baker images dimensions ./logo.png\nExample: baker images dimensions https://acme.com/hero.png"
@@ -23882,7 +24199,7 @@ var dimensionsCommand = defineCommand111({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand114 } from "citty";
 registerSchema({
   command: "images.extract",
   description: "Extract images from a URL via Firecrawl (formats: images).",
@@ -23898,7 +24215,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand112({
+var extractCommand = defineCommand114({
   meta: {
     name: "extract",
     description: "Pull every image from a single URL via Firecrawl. ~$0.001/scrape. Cap auto-ingest at 20.\n\nExample: baker images extract https://stripe.com --auto-ingest 5"
@@ -23936,7 +24253,7 @@ var extractCommand = defineCommand112({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand113 } from "citty";
+import { defineCommand as defineCommand115 } from "citty";
 registerSchema({
   command: "images.find",
   description: "Fanout image search: library first, then opted-in external providers.",
@@ -23968,7 +24285,7 @@ registerSchema({
     }
   }
 });
-var findCommand = defineCommand113({
+var findCommand = defineCommand115({
   meta: {
     name: "find",
     description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs.\n\nExample: baker images find 'office' --sources library,magnific --limit 20"
@@ -24016,8 +24333,8 @@ var findCommand = defineCommand113({
 });
 
 // src/commands/images/generate.ts
-import { readFile as readFile19 } from "fs/promises";
-import { defineCommand as defineCommand114 } from "citty";
+import { readFile as readFile20 } from "fs/promises";
+import { defineCommand as defineCommand116 } from "citty";
 import sharp2 from "sharp";
 var GENERATE_TIMEOUT_MS = 18e4;
 var REFERENCE_MAX_EDGE = 1536;
@@ -24106,7 +24423,7 @@ async function resolveReferences(spec) {
     }
     let raw;
     try {
-      raw = await readFile19(entry);
+      raw = await readFile20(entry);
     } catch {
       throw new ApiError("VALIDATION_ERROR", `Reference file not found: ${entry}`);
     }
@@ -24120,10 +24437,10 @@ async function resolveReferences(spec) {
   }
   return out;
 }
-var generateCommand = defineCommand114({
+var generateCommand = defineCommand116({
   meta: {
     name: "generate",
-    description: "Generate an image with AI and store it in the library (cost-tracked per request via OpenRouter usage). Models mirror the canvas: google/gemini-3.1-flash-image-preview (Nano Banana flash \u2014 default, fast, extreme aspect ratios) & google/gemini-3.5-flash (fast), google/gemini-3-pro-image-preview (Nano Banana Pro \u2014 highest fidelity), openai/gpt-5.4-image-2 (photoreal, cleanest in-image text, best for ad/landing reproduction), recraft/recraft-v4.1-pro-vector (vector/SVG-style with palette control). The result is auto-ingested (describe + embed), so the next `baker images library` query finds it. Pass --reference with image URLs and/or local file paths (Pinterest, stock, brand assets, sandbox files) to ground generation in reality.\n\nExamples:\n  baker images generate 'a friendly golden retriever sitting in a bright modern living room' --aspect-ratio 16:9\n  baker images generate 'hero shot of a matte black water bottle on marble' --model openai/gpt-5.4-image-2 --image-size 2K\n  baker images generate 'lifestyle photo matching this mood' --reference 'https://\u2026/ref1.jpg,https://\u2026/ref2.jpg'\n  baker images generate 'put this product on a marble countertop, soft daylight' --reference './src/brand/logos/product.png,./refs/kitchen-mood.jpg'\n  baker images generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
+    description: "Generate an image with AI and store it in the library (cost-tracked per request via OpenRouter usage). Models mirror the canvas: google/gemini-3.1-flash-image-preview (Nano Banana flash \u2014 default, fast, extreme aspect ratios), google/gemini-3-pro-image-preview (Nano Banana Pro \u2014 highest fidelity), openai/gpt-image-2 (photoreal, cleanest in-image text, best for ad/landing reproduction \u2014 no --image-size, and no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/SVG-style with palette control). The result is auto-ingested (describe + embed), so the next `baker images library` query finds it. Pass --reference with image URLs and/or local file paths (Pinterest, stock, brand assets, sandbox files) to ground generation in reality.\n\nExamples:\n  baker images generate 'a friendly golden retriever sitting in a bright modern living room' --aspect-ratio 16:9\n  baker images generate 'hero shot of a matte black water bottle on marble' --model openai/gpt-image-2 --aspect-ratio 3:2\n  baker images generate 'lifestyle photo matching this mood' --reference 'https://\u2026/ref1.jpg,https://\u2026/ref2.jpg'\n  baker images generate 'put this product on a marble countertop, soft daylight' --reference './src/brand/logos/product.png,./refs/kitchen-mood.jpg'\n  baker images generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
   },
   args: {
     prompt: { type: "positional", description: "What to generate", required: false },
@@ -24172,7 +24489,7 @@ var generateCommand = defineCommand114({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand115 } from "citty";
+import { defineCommand as defineCommand117 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -24180,7 +24497,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand2 = defineCommand115({
+var getCommand2 = defineCommand117({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -24216,7 +24533,7 @@ var getCommand2 = defineCommand115({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand118 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -24248,7 +24565,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand116({
+var gifCommand = defineCommand118({
   meta: {
     name: "gif",
     description: "Search Giphy for GIFs / reaction memes \u2014 built for paid-social creative (Meta, TikTok, LinkedIn, X). Free API. Each hit carries WebP + GIF + MP4 URLs in providerMeta so you can pick the right format per platform.\n\nExample: baker images gif 'this is fine' --limit 10\nExample: baker images gif 'office reaction' --rating pg --auto-ingest 2\nExample: baker images gif --trending --limit 25"
@@ -24295,7 +24612,35 @@ var gifCommand = defineCommand116({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand119 } from "citty";
+
+// src/commands/images/searchHints.ts
+var FALLBACK = {
+  stock: "Still empty \u2192 `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover \u2014 `--sources` is required, `find` alone searches the library only) or `baker images generate` to make the asset. Do not re-run this search with reshuffled flags.",
+  google: "Still empty \u2192 `baker images generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry."
+};
+function emptyResultHints({ provider, hitCount, activeFilters }) {
+  if (hitCount > 0) {
+    return [];
+  }
+  const hints = [];
+  if (activeFilters.length > 0) {
+    hints.push(
+      `No hits. Drop the filters before touching the query \u2014 ${activeFilters.join(", ")} narrowed this search and filter combinations are the usual cause of an empty result.`
+    );
+  }
+  hints.push(FALLBACK[provider]);
+  return hints;
+}
+function activeFilterFlags(args, candidates) {
+  return candidates.filter((flag) => args[flag] !== void 0 && args[flag] !== "").map((flag) => `--${flag}`);
+}
+
+// src/commands/images/google.ts
+var GOOGLE_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker images generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
 registerSchema({
   command: "images.google",
   description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
@@ -24331,7 +24676,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand117({
+var googleCommand2 = defineCommand119({
   meta: {
     name: "google",
     description: "Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). \u26A0 Source unverified \u2014 watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20"
@@ -24366,10 +24711,18 @@ var googleCommand2 = defineCommand117({
       if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
       if (args.context) body.descriptionContext = args.context;
       const data = await apiPost("/api/images/google", body);
-      writeJson({ ok: true, data });
+      const hints = emptyResultHints({
+        provider: "google",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "size", "color", "safe"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        writeJson({
+          ok: false,
+          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
@@ -24379,7 +24732,7 @@ var googleCommand2 = defineCommand117({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand120 } from "citty";
 registerSchema({
   command: "images.icon",
   description: "Icon lookup via Iconify (200+ icon sets, free CDN).",
@@ -24405,7 +24758,7 @@ registerSchema({
     }
   }
 });
-var iconCommand = defineCommand118({
+var iconCommand = defineCommand120({
   meta: {
     name: "icon",
     description: "Icon via Iconify (simple-icons, logos, lucide, devicon, heroicons, tabler, phosphor, material-symbols, \u2026). Free CDN, no API key.\n\nExample: baker images icon react --set devicon\nExample: baker images icon lucide:check --color '#0a0a0a'"
@@ -24445,7 +24798,7 @@ var iconCommand = defineCommand118({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand121 } from "citty";
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
@@ -24457,7 +24810,7 @@ registerSchema({
     context: { type: "string", description: "Description context hint", required: false }
   }
 });
-var ingestCommand = defineCommand119({
+var ingestCommand = defineCommand121({
   meta: {
     name: "ingest",
     description: "Download a remote URL and store it in the library. Hash-deduped on bytes + externalId.\n\nExample: baker images ingest https://img.freepik.com/free-photo/xyz.jpg --source magnific --external-id 12345"
@@ -24499,32 +24852,7 @@ var ingestCommand = defineCommand119({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand120 } from "citty";
-
-// src/commands/images/logoHints.ts
-var LOGO_QUERY_RE = /\blogos?\b|\bwordmark\b|\bbrand mark\b/i;
-function withLogoShape(row) {
-  return {
-    ...row,
-    logoShape: classifyLogoShape({
-      aspectRatio: row.aspectRatio,
-      hasAlpha: row.hasAlpha,
-      solidity: row.solidity
-    })
-  };
-}
-function buildLogoLibraryHints(query, rows) {
-  if (!LOGO_QUERY_RE.test(query)) return [];
-  const plates = rows.filter((row) => row.logoShape === "plated-icon");
-  if (plates.length === 0) return [];
-  const names = plates.map((row) => row.name).filter((name) => Boolean(name)).slice(0, 4);
-  const subject = names.length > 0 ? names.join(", ") : `${plates.length} result(s)`;
-  return [
-    `PLATED ICON: ${subject} \u2014 solid tile with the mark knocked out, not a wordmark. In a logo strip it renders as a filled box and verify blocks it (logo-plate). Re-source with 'baker images logo <domain> --variant logo', or strip the plate with 'baker images normalize <file> --remove-bg --shrink-to-content'. Only use a plate in slots under ~32px.`
-  ];
-}
-
-// src/commands/images/library.ts
+import { defineCommand as defineCommand122 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -24550,7 +24878,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand120({
+var libraryCommand = defineCommand122({
   meta: {
     name: "library",
     description: "Search the company image library (hybrid BM25 + vector + Cohere rerank). Use this BEFORE any external provider.\n\nExample: baker images library 'hero banner' --aspect-ratio 16:9 --source magnific"
@@ -24589,10 +24917,8 @@ var libraryCommand = defineCommand120({
       if (minScore !== void 0) {
         data = data.filter((r) => typeof r.score === "number" && r.score >= minScore);
       }
-      const shaped = data.map(withLogoShape);
-      const hints = buildLogoLibraryHints(query, shaped);
       writeOutput(
-        { ok: true, data: shaped, ...hints.length > 0 ? { hints } : {} },
+        { ok: true, data },
         args.output || "json",
         args.fields ? args.fields.split(",") : void 0,
         args.full
@@ -24609,17 +24935,12 @@ var libraryCommand = defineCommand120({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand121 } from "citty";
-var MAX_DOMAINS = 20;
+import { defineCommand as defineCommand123 } from "citty";
 registerSchema({
   command: "images.logo",
   description: "Brand logo lookup via Brandfetch CDN (fallback/404). Auto-ingests by default.",
   args: {
-    domain: {
-      type: "string",
-      description: "Brand domain, or a comma-separated list for a whole strip (e.g. stripe.com,intercom.com)",
-      required: true
-    },
+    domain: { type: "string", description: "Brand domain (e.g. stripe.com)", required: true },
     variant: { type: "string", description: "icon | logo | symbol", required: false },
     "auto-ingest": {
       type: "number",
@@ -24639,13 +24960,13 @@ registerSchema({
     }
   }
 });
-var logoCommand = defineCommand121({
+var logoCommand = defineCommand123({
   meta: {
     name: "logo",
-    description: "Brand logo via Brandfetch CDN. Returns up to 5 variants (icon, light/dark logo, light/dark symbol). Auto-ingests the first variant.\n\nSource a whole strip in one call by passing a comma-separated list \u2014 a text-rendered brand name is never the cheaper option.\n\nExamples:\n  baker images logo stripe.com --variant logo\n  baker images logo stripe.com,intercom.com,notion.so --variant logo"
+    description: "Brand logo via Brandfetch CDN. Returns up to 5 variants (icon, light/dark logo, light/dark symbol). Auto-ingests the first variant.\n\nExample: baker images logo stripe.com --variant logo"
   },
   args: {
-    domain: { type: "positional", description: "Brand domain, or a comma-separated list", required: false },
+    domain: { type: "positional", description: "Brand domain", required: false },
     variant: { type: "string", description: "icon|logo|symbol", required: false },
     "auto-ingest": { type: "string", description: "Ingest top N (0-20, default 1)", required: false },
     "no-auto-ingest": { type: "boolean", description: "Skip auto-ingest", required: false },
@@ -24653,50 +24974,18 @@ var logoCommand = defineCommand121({
   },
   run: async ({ args }) => {
     try {
-      const raw = args.domain;
-      const domains = [
-        ...new Set(
-          (raw ?? "").split(",").map((d) => d.trim()).filter(Boolean)
-        )
-      ];
-      if (domains.length === 0) {
+      const domain = args.domain;
+      if (!domain) {
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Domain is required" } });
         process.exit(1);
       }
-      if (domains.length > MAX_DOMAINS) {
-        writeJson({
-          ok: false,
-          error: {
-            code: "VALIDATION_ERROR",
-            message: `Too many domains (${domains.length}); pass at most ${MAX_DOMAINS} per call`
-          }
-        });
-        process.exit(1);
-      }
-      const base = {};
-      if (args.variant) base.variant = args.variant;
-      if (args["auto-ingest"] !== void 0) base.autoIngest = Number(args["auto-ingest"]);
-      else if (args["no-auto-ingest"]) base.autoIngest = 0;
-      if (args.context) base.descriptionContext = args.context;
-      const fetchOne = (domain) => apiPost("/api/images/logo", { ...base, domain });
-      if (domains.length === 1) {
-        writeJson({ ok: true, data: await fetchOne(domains[0]) });
-        return;
-      }
-      const settled = await Promise.all(
-        domains.map(async (domain) => {
-          try {
-            return { domain, ...await fetchOne(domain) };
-          } catch (err) {
-            return { domain, hits: [], error: err instanceof ApiError ? err.message : "Lookup failed" };
-          }
-        })
-      );
-      const empty = settled.filter((r) => r.hits.length === 0).map((r) => r.domain);
-      const hints = empty.length > 0 ? [
-        `NO LOGO: ${empty.join(", ")} \u2014 Brandfetch doesn't know ${empty.length === 1 ? "this brand" : "these brands"}. Fall back per domain: 'baker images extract <domain> --auto-ingest 5', then 'baker images icon <brand> --set simple-icons'. Still nothing \u2192 'baker actions create' to acquire the file. Do not render the name as text.`
-      ] : [];
-      writeJson({ ok: true, data: { results: settled }, ...hints.length > 0 ? { hints } : {} });
+      const body = { domain };
+      if (args.variant) body.variant = args.variant;
+      if (args["auto-ingest"] !== void 0) body.autoIngest = Number(args["auto-ingest"]);
+      else if (args["no-auto-ingest"]) body.autoIngest = 0;
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/logo", body);
+      writeJson({ ok: true, data });
     } catch (err) {
       if (err instanceof ApiError) {
         writeJson({ ok: false, error: { code: err.code, message: err.message } });
@@ -24709,7 +24998,7 @@ var logoCommand = defineCommand121({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand124 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -24740,7 +25029,6 @@ function getDominantEdgeColor(data, width, height) {
   const colorCount = {};
   function accumulateColor(i, j) {
     const idx = (i * width + j) * 4;
-    if ((data[idx + 3] ?? 0) < 10) return;
     const colorKey = `${data[idx]},${data[idx + 1]},${data[idx + 2]}`;
     colorCount[colorKey] = (colorCount[colorKey] ?? 0) + 1;
   }
@@ -24753,7 +25041,7 @@ function getDominantEdgeColor(data, width, height) {
     accumulateColor(i, width - 1);
   }
   let maxCount = 0;
-  let dominantColor = null;
+  let dominantColor = { r: 0, g: 0, b: 0 };
   for (const key in colorCount) {
     const count = colorCount[key];
     if (count > maxCount) {
@@ -24764,27 +25052,6 @@ function getDominantEdgeColor(data, width, height) {
   }
   return dominantColor;
 }
-function opaqueSolidity(data, width, height) {
-  let minX = width;
-  let minY = height;
-  let maxX = -1;
-  let maxY = -1;
-  let opaque = 0;
-  for (let y = 0; y < height; y++) {
-    for (let x = 0; x < width; x++) {
-      if ((data[(y * width + x) * 4 + 3] ?? 0) <= 200) continue;
-      opaque++;
-      if (x < minX) minX = x;
-      if (x > maxX) maxX = x;
-      if (y < minY) minY = y;
-      if (y > maxY) maxY = y;
-    }
-  }
-  if (maxX < 0) return 0;
-  const boxArea = (maxX - minX + 1) * (maxY - minY + 1);
-  return boxArea === 0 ? 0 : opaque / boxArea;
-}
-var PLATE_SOLIDITY_THRESHOLD2 = 0.6;
 function hasTransparency(data, threshold = 0.02) {
   let transparentPixels = 0;
   let totalPixels = 0;
@@ -24849,9 +25116,6 @@ function removeBackground(data, width, height, colorRangeThreshold = COLOR_RANGE
     return data;
   }
   const dominantEdgeColor = getDominantEdgeColor(data, width, height);
-  if (!dominantEdgeColor) {
-    return data;
-  }
   const isGradient = hasGradientColors(data);
   const result = Buffer.from(data);
   if (isGradient) {
@@ -25129,8 +25393,8 @@ async function processInternal(inputBuffer, isSVG, options) {
   const metadata = await sharp3(inputBuffer).metadata();
   let alreadyTransparent = false;
   if (metadata.hasAlpha) {
-    const { data: alphaData, info: info2 } = await sharp3(inputBuffer).raw().toBuffer({ resolveWithObject: true });
-    alreadyTransparent = opaqueSolidity(alphaData, info2.width, info2.height) < PLATE_SOLIDITY_THRESHOLD2;
+    const { data: alphaData } = await sharp3(inputBuffer).raw().toBuffer({ resolveWithObject: true });
+    alreadyTransparent = hasTransparency(alphaData, 0.05);
   }
   let { data: processedData, info } = await sharp3(inputBuffer).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
   if (options.color) {
@@ -25466,7 +25730,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand = defineCommand122({
+var normalizeCommand = defineCommand124({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -25521,7 +25785,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand125 } from "citty";
 registerSchema({
   command: "images.pinterest",
   description: "Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing \u2014 Pinterest is unverified, trademark-bearing web content.",
@@ -25541,7 +25805,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand123({
+var pinterestCommand = defineCommand125({
   meta: {
     name: "pinterest",
     description: "Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery \u2014 lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. \u26A0 Unverified, trademark-bearing web content \u2014 inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\n\nExamples:\n  baker images pinterest 'scandinavian living room'\n  baker images pinterest 'minimalist skincare product photography' --limit 20\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'"
@@ -25581,7 +25845,7 @@ var pinterestCommand = defineCommand123({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand126 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -25597,7 +25861,7 @@ registerSchema({
     }
   }
 });
-var screenshotCommand = defineCommand124({
+var screenshotCommand = defineCommand126({
   meta: {
     name: "screenshot",
     description: "Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\n\nExample: baker images screenshot https://stripe.com --full-page"
@@ -25660,7 +25924,7 @@ var screenshotCommand = defineCommand124({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand127 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -25676,7 +25940,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand125({
+var searchCommand = defineCommand127({
   meta: {
     name: "search",
     description: "Semantic search images by text query. Uses hybrid BM25 + vector + reranking. Example: baker images search 'hero banner' --aspect-ratio 16:9 --tags logo"
@@ -25736,7 +26000,7 @@ var searchCommand = defineCommand125({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand128 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -25768,7 +26032,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand126({
+var stickerCommand = defineCommand128({
   meta: {
     name: "sticker",
     description: "Search Giphy's sticker corpus \u2014 transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\n\nExample: baker images sticker 'thumbs up' --limit 10\nExample: baker images sticker celebration --rating g --auto-ingest 3\nExample: baker images sticker --trending --limit 25"
@@ -25815,7 +26079,11 @@ var stickerCommand = defineCommand126({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand129 } from "citty";
+var STOCK_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `baker images generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
 registerSchema({
   command: "images.stock",
   description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
@@ -25873,7 +26141,22 @@ registerSchema({
     }
   }
 });
-var stockCommand = defineCommand127({
+function buildStockRequest(query, args) {
+  const body = { query };
+  if (args.type) body.contentType = args.type;
+  if (args.orientation) body.orientation = args.orientation;
+  if (args.license) body.license = args.license;
+  if (args.color) body.color = args.color;
+  if (args.ai) body.aiGenerated = args.ai;
+  if (args.people) body.people = args.people;
+  if (args.order) body.order = args.order;
+  if (args.limit) body.limit = Number(args.limit);
+  if (args.page) body.page = Number(args.page);
+  if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+  if (args.context) body.descriptionContext = args.context;
+  return body;
+}
+var stockCommand = defineCommand129({
   meta: {
     name: "stock",
     description: "Stock search via Magnific \u2014 Freepik's developer API (~250M assets: photos, vectors, illustrations, icons, PSDs). $0.002/req. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'flat office workers' --type vector\n  baker images stock 'hero photo of a kitchen' --type photo --orientation landscape --ai exclude\n  baker images stock 'brand pattern' --color '#0a0a0a' --license freemium --auto-ingest 2"
@@ -25903,23 +26186,23 @@ var stockCommand = defineCommand127({
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
         process.exit(1);
       }
-      const body = { query };
-      if (args.type) body.contentType = args.type;
-      if (args.orientation) body.orientation = args.orientation;
-      if (args.license) body.license = args.license;
-      if (args.color) body.color = args.color;
-      if (args.ai) body.aiGenerated = args.ai;
-      if (args.people) body.people = args.people;
-      if (args.order) body.order = args.order;
-      if (args.limit) body.limit = Number(args.limit);
-      if (args.page) body.page = Number(args.page);
-      if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
-      if (args.context) body.descriptionContext = args.context;
-      const data = await apiPost("/api/images/stock", body);
-      writeJson({ ok: true, data });
+      const data = await apiPost("/api/images/stock", buildStockRequest(query, args));
+      const hints = emptyResultHints({
+        provider: "stock",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "orientation", "license", "color", "ai", "people"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            fix: STOCK_ERROR_FIX
+          }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
@@ -25929,7 +26212,7 @@ var stockCommand = defineCommand127({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand130 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -25938,7 +26221,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand128({
+  return defineCommand130({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -25974,7 +26257,7 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand2 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand131 } from "citty";
 registerSchema({
   command: "images.upload",
   description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
@@ -26012,7 +26295,7 @@ registerSchema({
 function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand = defineCommand129({
+var uploadCommand = defineCommand131({
   meta: {
     name: "upload",
     description: "Upload an image to the library \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: reads bytes, sends to /api/images/upload, content-type auto-detected from extension.\nRemote: dispatches to /api/images/ingest with hash-dedup on bytes + externalId.\n\nExamples:\n  baker images upload ./logo.png --source uploaded\n  baker images upload ./cert.png --context 'ISO 27001 badge \u2014 enterprise tier'\n  baker images upload https://acme.com/hero.png --source firecrawl --context 'Acme competitor pricing hero'"
@@ -26105,7 +26388,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand130 } from "citty";
+import { defineCommand as defineCommand132 } from "citty";
 registerSchema({
   command: "images.upscale",
   description: "Upscale a library image via the backend (Replicate, cost-tracked). Waits for completion by default. The image must be status 'ready' and raster (not SVG/AVIF).",
@@ -26120,7 +26403,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS3 = 1500;
-var upscaleCommand = defineCommand130({
+var upscaleCommand = defineCommand132({
   meta: {
     name: "upscale",
     description: "Upscale a library image via the Convex backend (Replicate, cost-tracked at $0.05/image). Waits for completion by default.\n\nExample: baker images upscale j571abc123def\nExample: baker images upscale j571abc123def --max-wait 0   # fire-and-forget"
@@ -26175,7 +26458,7 @@ var upscaleCommand = defineCommand130({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand133 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -26191,7 +26474,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var useCommand = defineCommand131({
+var useCommand = defineCommand133({
   meta: {
     name: "use",
     description: "Sugar over `ingest`: download \u2192 store \u2192 wait until describe + embed complete \u2192 return ready library record.\n\nExample: baker images use https://cdn.example.com/hero.png --source uploaded"
@@ -26237,7 +26520,7 @@ var useCommand = defineCommand131({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand132({
+var imagesCommand = defineCommand134({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -26308,16 +26591,16 @@ Full guide: __tooling__/docs/tools/baker/images.md`
 });
 
 // src/commands/landing/index.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand136 } from "citty";
 
 // src/commands/landing/critique.ts
 import { readdir as readdir8, stat as stat6 } from "fs/promises";
-import path26 from "path";
-import { defineCommand as defineCommand133 } from "citty";
+import path27 from "path";
+import { defineCommand as defineCommand135 } from "citty";
 
 // src/engine/landing/lib/brand-tokens.ts
-import { readFile as readFile20 } from "fs/promises";
-import path23 from "path";
+import { readFile as readFile21 } from "fs/promises";
+import path24 from "path";
 
 // src/engine/landing/lib/color.ts
 var NEUTRAL_COLOR_KEYWORDS = /* @__PURE__ */ new Set([
@@ -26479,14 +26762,14 @@ function parseBrandMd(brandMd, fonts, colors) {
   }
 }
 async function loadBrandTokens(projectRoot) {
-  const globalCss = await safeRead(path23.join(projectRoot, "src", "styles", "global.css"));
-  const brandMd = await safeRead(path23.join(projectRoot, "src", "brand", "BRAND.md"));
+  const globalCss = await safeRead(path24.join(projectRoot, "src", "styles", "global.css"));
+  const brandMd = await safeRead(path24.join(projectRoot, "src", "brand", "BRAND.md"));
   if (!globalCss && !brandMd) return EMPTY;
   return parseBrandTokens(globalCss, brandMd);
 }
 async function safeRead(file) {
   try {
-    return await readFile20(file, "utf8");
+    return await readFile21(file, "utf8");
   } catch {
     return "";
   }
@@ -27272,40 +27555,40 @@ function describeCounts(findings) {
 }
 
 // src/commands/landing/snapshot.ts
-import { mkdir as mkdir7, rename as rename2, writeFile as writeFile10 } from "fs/promises";
-import path24 from "path";
+import { mkdir as mkdir8, rename as rename2, writeFile as writeFile11 } from "fs/promises";
+import path25 from "path";
 var CRITIC_VERSION = "1";
 function critiqueCacheDir(projectRoot) {
-  return path24.join(projectRoot, ".cache", "landing-critique");
+  return path25.join(projectRoot, ".cache", "landing-critique");
 }
 function snapshotPath(projectRoot, slug) {
-  return path24.join(critiqueCacheDir(projectRoot), `${slug}.json`);
+  return path25.join(critiqueCacheDir(projectRoot), `${slug}.json`);
 }
 async function writeCritiqueSnapshot(projectRoot, snapshot) {
-  await mkdir7(critiqueCacheDir(projectRoot), { recursive: true });
+  await mkdir8(critiqueCacheDir(projectRoot), { recursive: true });
   const dest = snapshotPath(projectRoot, snapshot.slug);
   const tmp = `${dest}.tmp`;
-  await writeFile10(tmp, `${JSON.stringify(snapshot, null, 2)}
+  await writeFile11(tmp, `${JSON.stringify(snapshot, null, 2)}
 `, "utf8");
   await rename2(tmp, dest);
 }
 
 // src/commands/landing/source-version.ts
-import { readdir as readdir7, readFile as readFile21, stat as stat5 } from "fs/promises";
-import path25 from "path";
+import { readdir as readdir7, readFile as readFile22, stat as stat5 } from "fs/promises";
+import path26 from "path";
 async function landingSourceRelPaths(landingDir) {
   const rel = [];
-  if (await isFile(path25.join(landingDir, "index.astro"))) rel.push("index.astro");
-  const componentsDir = path25.join(landingDir, "_components");
+  if (await isFile(path26.join(landingDir, "index.astro"))) rel.push("index.astro");
+  const componentsDir = path26.join(landingDir, "_components");
   for (const abs of await walkAstro(componentsDir)) {
-    rel.push(path25.relative(landingDir, abs).split(path25.sep).join("/"));
+    rel.push(path26.relative(landingDir, abs).split(path26.sep).join("/"));
   }
   return rel.sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
 }
 async function readLandingSources(landingDir) {
   const rel = await landingSourceRelPaths(landingDir);
   const out = [];
-  for (const r of rel) out.push({ path: r, text: await readFile21(path25.join(landingDir, r), "utf8") });
+  for (const r of rel) out.push({ path: r, text: await readFile22(path26.join(landingDir, r), "utf8") });
   return out;
 }
 async function computeLandingSourceSha(landingDir) {
@@ -27314,7 +27597,7 @@ async function computeLandingSourceSha(landingDir) {
   for (const r of rel) {
     let bytes;
     try {
-      bytes = await readFile21(path25.join(landingDir, r));
+      bytes = await readFile22(path26.join(landingDir, r));
     } catch {
       bytes = Buffer.alloc(0);
     }
@@ -27338,7 +27621,7 @@ async function walkAstro(dir) {
   }
   const out = [];
   for (const entry of entries) {
-    const abs = path25.join(dir, entry.name);
+    const abs = path26.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...await walkAstro(abs));
     else if (entry.isFile() && entry.name.endsWith(".astro")) out.push(abs);
   }
@@ -27359,14 +27642,14 @@ registerSchema({
   }
 });
 var SLUG_RE = /^[a-z0-9][a-z0-9._-]*$/i;
-function fail4(code, message, fix) {
+function fail5(code, message, fix) {
   process.stderr.write(
     `${JSON.stringify({ ok: false, error: { code, message, ...fix ? { fix } : {} } }, null, 2)}
 `
   );
   process.exit(2);
 }
-var critiqueCommand2 = defineCommand133({
+var critiqueCommand2 = defineCommand135({
   meta: {
     name: "critique",
     description: "Start here: `baker landing critique <slug>` after building or editing a landing. Deterministic design-quality critic (ADVISORY \u2014 findings never fail it). Flags the known AI design tells (gradient text, overused fonts, side-tab borders, cream palettes, buzzword copy, broken images) tiered block/warn/advisory, respecting the client's BRAND.md as the allowlist. Also records the critique that publishing requires \u2014 run it before finishing a landing."
@@ -27379,15 +27662,15 @@ var critiqueCommand2 = defineCommand133({
     const slug = String(args.slug);
     const projectRoot = process.cwd();
     if (!SLUG_RE.test(slug) || slug.includes("..")) {
-      fail4(
+      fail5(
         "INVALID_SLUG",
         `"${slug}" is not a landing slug \u2014 use the folder name directly under src/pages/ (letters, digits, dashes; not a path, not a _-private folder).`,
         { availableSlugs: await listLandingSlugs(projectRoot) }
       );
     }
-    const landingDir = path26.resolve(projectRoot, "src", "pages", slug);
+    const landingDir = path27.resolve(projectRoot, "src", "pages", slug);
     if (!await isDir(landingDir)) {
-      fail4("NOT_FOUND", `No landing at src/pages/${slug}/`, {
+      fail5("NOT_FOUND", `No landing at src/pages/${slug}/`, {
         availableSlugs: await listLandingSlugs(projectRoot)
       });
     }
@@ -27440,7 +27723,7 @@ var critiqueCommand2 = defineCommand133({
 });
 async function listLandingSlugs(projectRoot) {
   try {
-    const entries = await readdir8(path26.join(projectRoot, "src", "pages"), { withFileTypes: true });
+    const entries = await readdir8(path27.join(projectRoot, "src", "pages"), { withFileTypes: true });
     return entries.filter((e) => e.isDirectory() && !e.name.startsWith("_") && !e.name.startsWith(".")).map((e) => e.name).sort();
   } catch {
     return [];
@@ -27466,7 +27749,7 @@ async function isDir(p) {
 }
 
 // src/commands/landing/index.ts
-var landingCommand = defineCommand134({
+var landingCommand = defineCommand136({
   meta: {
     name: "landing",
     description: `Design-quality tools for landing pages (src/pages/<slug>/).
@@ -27482,7 +27765,7 @@ Subcommands:
 });
 
 // src/commands/mcp/index.ts
-import { defineCommand as defineCommand135 } from "citty";
+import { defineCommand as defineCommand137 } from "citty";
 var SCOPES = ["user", "user_org", "company", "org"];
 function parseScope(raw) {
   const scope = raw === void 0 ? "company" : String(raw);
@@ -27508,7 +27791,7 @@ function parseHeaders(raw) {
   }
   return Object.keys(headers).length > 0 ? headers : void 0;
 }
-function fail5(err) {
+function fail6(err) {
   if (err instanceof ApiError) {
     writeJson({ ok: false, error: { code: err.code, message: err.message } });
     process.exit(1);
@@ -27521,7 +27804,7 @@ registerSchema({
   description: "List every third-party tool this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, \u2026) plus custom MCP servers. Start here when the user mentions an external tool.",
   args: {}
 });
-var connectedCommand = defineCommand135({
+var connectedCommand = defineCommand137({
   meta: {
     name: "connected",
     description: `List all connected third-party tools \u2014 managed integrations plus custom MCP servers.
@@ -27559,7 +27842,7 @@ A tool the user names that is NOT listed here is simply not connected yet.`
         hints
       });
     } catch (err) {
-      fail5(err);
+      fail6(err);
     }
   }
 });
@@ -27568,7 +27851,7 @@ registerSchema({
   description: "List the custom MCP servers this company's chats see (org + company + your own user scope).",
   args: {}
 });
-var listCommand8 = defineCommand135({
+var listCommand8 = defineCommand137({
   meta: { name: "list", description: "List custom MCP servers visible to this company's chats." },
   run: async () => {
     try {
@@ -27579,7 +27862,7 @@ var listCommand8 = defineCommand135({
       );
       writeJson({ ok: true, data: data.servers });
     } catch (err) {
-      fail5(err);
+      fail6(err);
     }
   }
 });
@@ -27593,7 +27876,7 @@ registerSchema({
     header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
   }
 });
-var addCommand = defineCommand135({
+var addCommand = defineCommand137({
   meta: {
     name: "add",
     description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.
@@ -27625,7 +27908,7 @@ Examples:
       });
       writeJson({ ok: true, data });
     } catch (err) {
-      fail5(err);
+      fail6(err);
     }
   }
 });
@@ -27634,7 +27917,7 @@ registerSchema({
   description: "Remove a company custom MCP server by name.",
   args: { name: { type: "string", description: "Server name to remove", required: true } }
 });
-var removeCommand4 = defineCommand135({
+var removeCommand4 = defineCommand137({
   meta: {
     name: "remove",
     description: `Remove a company custom MCP server by name.
@@ -27652,11 +27935,11 @@ Example:
       });
       writeJson({ ok: true, data });
     } catch (err) {
-      fail5(err);
+      fail6(err);
     }
   }
 });
-var mcpCommand = defineCommand135({
+var mcpCommand = defineCommand137({
   meta: {
     name: "mcp",
     description: `Third-party tools for this company \u2014 see what's connected, register custom HTTPS MCP endpoints.
@@ -27682,10 +27965,10 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand148 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 
 // src/commands/research/output.ts
 var RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
@@ -27798,7 +28081,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand136({
+var advertisersCommand = defineCommand138({
   meta: {
     name: "advertisers",
     description: `Find domains competing for a keyword in Google SERPs.
@@ -27845,7 +28128,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand137 } from "citty";
+import { defineCommand as defineCommand139 } from "citty";
 registerSchema({
   command: "research.autocomplete",
   description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -27868,7 +28151,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand137({
+var autocompleteCommand = defineCommand139({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -27914,7 +28197,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand138 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -27971,7 +28254,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand138({
+var countriesCommand = defineCommand140({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -27982,7 +28265,7 @@ var countriesCommand = defineCommand138({
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand141 } from "citty";
 registerSchema({
   command: "research.intent",
   description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. IMPORTANT: If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
@@ -28005,7 +28288,7 @@ var FIELDS6 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand139({
+var intentCommand = defineCommand141({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -28053,7 +28336,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 registerSchema({
   command: "research.keyword-gap",
   description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
@@ -28082,7 +28365,7 @@ var FIELDS7 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand140({
+var keywordGapCommand = defineCommand142({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -28156,7 +28439,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 registerSchema({
   command: "research.keywords-for-site",
   description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
@@ -28189,7 +28472,7 @@ var FIELDS8 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand141({
+var keywordsForSiteCommand = defineCommand143({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -28242,7 +28525,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -28272,7 +28555,7 @@ var FIELDS9 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand142({
+var languagesCommand2 = defineCommand144({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -28283,7 +28566,7 @@ var languagesCommand2 = defineCommand142({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand145 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -28302,7 +28585,7 @@ var FIELDS10 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand143({
+var lighthouseCommand = defineCommand145({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -28340,7 +28623,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 registerSchema({
   command: "research.relevant-pages",
   description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -28366,7 +28649,7 @@ var FIELDS11 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand144({
+var relevantPagesCommand = defineCommand146({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -28412,7 +28695,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand147 } from "citty";
 registerSchema({
   command: "research.web",
   description: "Search the web with AI to answer marketing questions \u2014 competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).",
@@ -28463,7 +28746,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand145({
+var webCommand = defineCommand147({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -28523,7 +28806,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand146({
+var researchCommand = defineCommand148({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -28564,10 +28847,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand153 } from "citty";
+import { defineCommand as defineCommand155 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -28682,7 +28965,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false }
   }
 });
-var createCommand2 = defineCommand147({
+var createCommand2 = defineCommand149({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -28731,7 +29014,7 @@ var createCommand2 = defineCommand147({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand148 } from "citty";
+import { defineCommand as defineCommand150 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -28739,7 +29022,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand2 = defineCommand148({
+var deleteCommand2 = defineCommand150({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -28768,7 +29051,7 @@ var deleteCommand2 = defineCommand148({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand149 } from "citty";
+import { defineCommand as defineCommand151 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -28776,7 +29059,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var getCommand3 = defineCommand149({
+var getCommand3 = defineCommand151({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -28813,13 +29096,13 @@ var getCommand3 = defineCommand149({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand150 } from "citty";
+import { defineCommand as defineCommand152 } from "citty";
 registerSchema({
   command: "scheduled-actions.list",
   description: "List published scheduled actions. Includes draft state when BAKER_CHAT_ID is set.",
   args: {}
 });
-var listCommand9 = defineCommand150({
+var listCommand9 = defineCommand152({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set."
@@ -28840,7 +29123,7 @@ var listCommand9 = defineCommand150({
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand151 } from "citty";
+import { defineCommand as defineCommand153 } from "citty";
 registerSchema({
   command: "scheduled-actions.trigger",
   description: "Immediately trigger a published scheduled action. Does not require BAKER_CHAT_ID and rejects temp_sched_* IDs.",
@@ -28848,7 +29131,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand151({
+var triggerCommand = defineCommand153({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -28885,7 +29168,7 @@ var triggerCommand = defineCommand151({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand152 } from "citty";
+import { defineCommand as defineCommand154 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -28910,7 +29193,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand2 = defineCommand152({
+var updateCommand2 = defineCommand154({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
@@ -28981,7 +29264,7 @@ var updateCommand2 = defineCommand152({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand153({
+var scheduledActionsCommand = defineCommand155({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger.
@@ -29008,8 +29291,8 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand154 } from "citty";
-var schemaCommand = defineCommand154({
+import { defineCommand as defineCommand156 } from "citty";
+var schemaCommand = defineCommand156({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -29051,7 +29334,7 @@ var schemaCommand = defineCommand154({
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand155 } from "citty";
+import { defineCommand as defineCommand157 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -29117,7 +29400,7 @@ async function listTags(json) {
     failApi3(err);
   }
 }
-var listCommand10 = defineCommand155({
+var listCommand10 = defineCommand157({
   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"
@@ -29136,7 +29419,7 @@ async function listDraft3() {
     failApi3(err);
   }
 }
-var draftCommand3 = defineCommand155({
+var draftCommand3 = defineCommand157({
   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)."
@@ -29145,7 +29428,7 @@ var draftCommand3 = defineCommand155({
     await listDraft3();
   }
 });
-var tagsCommand3 = defineCommand155({
+var tagsCommand3 = defineCommand157({
   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.
@@ -29171,10 +29454,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand159 } from "citty";
+import { defineCommand as defineCommand161 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand156 } from "citty";
+import { defineCommand as defineCommand158 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -29182,7 +29465,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand4 = defineCommand156({
+var getCommand4 = defineCommand158({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -29219,7 +29502,7 @@ var getCommand4 = defineCommand156({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand157 } from "citty";
+import { defineCommand as defineCommand159 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -29249,7 +29532,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand11 = defineCommand157({
+var listCommand11 = defineCommand159({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -29298,7 +29581,7 @@ var listCommand11 = defineCommand157({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand158 } from "citty";
+import { defineCommand as defineCommand160 } from "citty";
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
     return null;
@@ -29376,7 +29659,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand2 = defineCommand158({
+var searchCommand2 = defineCommand160({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -29432,7 +29715,7 @@ var searchCommand2 = defineCommand158({
 var tagsCommand4 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand159({
+var testimonialsCommand = defineCommand161({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -29454,10 +29737,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand164 } from "citty";
+import { defineCommand as defineCommand166 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand160 } from "citty";
+import { defineCommand as defineCommand162 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -29471,7 +29754,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand160({
+var deleteCommand3 = defineCommand162({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -29512,7 +29795,7 @@ var deleteCommand3 = defineCommand160({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand161 } from "citty";
+import { defineCommand as defineCommand163 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -29520,7 +29803,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand5 = defineCommand161({
+var getCommand5 = defineCommand163({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -29557,7 +29840,7 @@ var getCommand5 = defineCommand161({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand162 } from "citty";
+import { defineCommand as defineCommand164 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -29567,7 +29850,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand3 = defineCommand162({
+var searchCommand3 = defineCommand164({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -29617,9 +29900,9 @@ var searchCommand3 = defineCommand162({
 var tagsCommand5 = makeTagsCommand("videos", "video", "/api/videos/tags");
 
 // src/commands/videos/upload.ts
-import { readFile as readFile22, stat as stat7 } from "fs/promises";
+import { readFile as readFile23, stat as stat7 } from "fs/promises";
 import { extname as extname3 } from "path";
-import { defineCommand as defineCommand163 } from "citty";
+import { defineCommand as defineCommand165 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -29653,7 +29936,7 @@ function detectContentType(filePath) {
   }
   return mime;
 }
-var uploadCommand2 = defineCommand163({
+var uploadCommand2 = defineCommand165({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -29682,7 +29965,7 @@ var uploadCommand2 = defineCommand163({
         return;
       }
       const { uploadUrl, videoId } = await apiPost("/api/videos/upload", {});
-      const fileBuffer = await readFile22(filePath);
+      const fileBuffer = await readFile23(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -29707,7 +29990,7 @@ var uploadCommand2 = defineCommand163({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand164({
+var videosCommand = defineCommand166({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
@@ -29731,10 +30014,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand179 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand167 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList(value) {
@@ -29787,7 +30070,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand165({
+var advertisersCommand2 = defineCommand167({
   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'
@@ -29845,7 +30128,7 @@ var advertisersCommand2 = defineCommand165({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand168 } 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.",
@@ -29891,7 +30174,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand166({
+var briefCommand = defineCommand168({
   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`
@@ -29927,7 +30210,7 @@ var briefCommand = defineCommand166({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand169 } 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.",
@@ -29940,7 +30223,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand167({
+var contentCommand = defineCommand169({
   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"
@@ -29989,7 +30272,7 @@ var contentCommand = defineCommand167({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand170 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList(input.advertiser);
@@ -30041,7 +30324,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand168({
+var feedCommand = defineCommand170({
   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"
@@ -30126,7 +30409,7 @@ var feedCommand = defineCommand168({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 var PLATFORMS = ["meta", "linkedin"];
 registerSchema({
   command: "winning-ads.follow",
@@ -30141,7 +30424,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand169({
+var followCommand = defineCommand171({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks both Meta + LinkedIn. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -30188,7 +30471,7 @@ var followCommand = defineCommand169({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 var PLATFORMS2 = ["meta", "linkedin"];
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -30221,7 +30504,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand170({
+var followCompetitorsCommand = defineCommand172({
   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"'
@@ -30296,7 +30579,7 @@ var followCompetitorsCommand = defineCommand170({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand173 } 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.",
@@ -30329,7 +30612,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand171({
+var followingCommand = defineCommand173({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
@@ -30364,7 +30647,7 @@ var followingCommand = defineCommand171({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand174 } 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.",
@@ -30403,7 +30686,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand172({
+var patternsCommand = defineCommand174({
   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"
@@ -30459,7 +30742,7 @@ var patternsCommand = defineCommand172({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand175 } 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.",
@@ -30567,7 +30850,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand173({
+var searchCommand4 = defineCommand175({
   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"
@@ -30682,7 +30965,7 @@ var searchCommand4 = defineCommand173({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand174 } from "citty";
+import { defineCommand as defineCommand176 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -30710,7 +30993,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand174({
+  return defineCommand176({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -30759,7 +31042,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand175 } from "citty";
+import { defineCommand as defineCommand177 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -30767,7 +31050,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand175({
+var unfollowCommand = defineCommand177({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -30788,7 +31071,7 @@ var unfollowCommand = defineCommand175({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand176 } from "citty";
+import { defineCommand as defineCommand178 } 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.",
@@ -30798,7 +31081,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand176({
+var winnersCommand = defineCommand178({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -30848,7 +31131,7 @@ var winnersCommand = defineCommand176({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand177({
+var winningAdsCommand = defineCommand179({
   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.
@@ -30920,7 +31203,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand178({
+var main = defineCommand180({
   meta: {
     name: "baker",
     version: getCliVersion(),
@@ -30936,6 +31219,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     actions: actionsCommand,
     "scheduled-actions": scheduledActionsCommand,
     ads: adsCommand2,
+    brand: brandCommand,
     ga4: ga4Command,
     gsc: gscCommand,
     research: researchCommand,