@koda-sl/baker-cli 0.97.0 → 0.98.1

package/dist/cli.js

@@ -9,10 +9,10 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "./chunk-RCPMJKI7.js";
+} from "./chunk-3JVYU72O.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand148, runMain } from "citty";
+import { defineCommand as defineCommand149, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand17 } from "citty";
@@ -147,9 +147,9 @@ async function handleResponse(response) {
     throw new ApiError("INTERNAL_ERROR", "Failed to parse API response as JSON");
   }
 }
-async function apiGet(path7, params) {
+async function apiGet(path11, params) {
   const env = getEnv();
-  const url = new URL(path7, env.BAKER_API_URL);
+  const url = new URL(path11, env.BAKER_API_URL);
   if (params) {
     const clean = sanitizeParams(params);
     for (const [key, value] of Object.entries(clean)) {
@@ -174,12 +174,12 @@ async function apiGet(path7, params) {
   }
   return handleResponse(response);
 }
-async function apiPost(path7, body, opts) {
+async function apiPost(path11, body, opts) {
   const env = getEnv();
   const timeoutMs = opts?.timeoutMs ?? 6e4;
   let response;
   try {
-    response = await fetchWithRateLimitRetry(new URL(path7, env.BAKER_API_URL).toString(), {
+    response = await fetchWithRateLimitRetry(new URL(path11, env.BAKER_API_URL).toString(), {
       method: "POST",
       headers: {
         Authorization: `Bearer ${env.BAKER_API_KEY}`,
@@ -1327,31 +1327,31 @@ function cachePath(category, key) {
   return join(dir, `${hashKey(key)}.json`);
 }
 function cacheGet(category, key) {
-  const path7 = cachePath(category, key);
-  if (!existsSync(path7)) {
+  const path11 = cachePath(category, key);
+  if (!existsSync(path11)) {
     return null;
   }
   try {
-    const raw = readFileSync(path7, "utf-8");
+    const raw = readFileSync(path11, "utf-8");
     const entry = JSON.parse(raw);
     if (entry.expiresAt < Date.now()) {
-      rmSync(path7, { force: true });
+      rmSync(path11, { force: true });
       return null;
     }
     return entry;
   } catch {
-    rmSync(path7, { force: true });
+    rmSync(path11, { force: true });
     return null;
   }
 }
 function cacheSet(category, key, data, ttlMs, fields) {
-  const path7 = cachePath(category, key);
+  const path11 = cachePath(category, key);
   const entry = {
     expiresAt: Date.now() + ttlMs,
     data,
     fields
   };
-  writeFileSync(path7, JSON.stringify(entry), "utf-8");
+  writeFileSync(path11, JSON.stringify(entry), "utf-8");
 }
 var HOUR = 60 * 60 * 1e3;
 var MINUTE = 60 * 1e3;
@@ -8045,7 +8045,7 @@ Examples:
 });
 
 // src/commands/canvas/index.ts
-import { defineCommand as defineCommand84 } from "citty";
+import { defineCommand as defineCommand85 } from "citty";
 
 // src/commands/canvas/catalog.ts
 import { defineCommand as defineCommand78 } from "citty";
@@ -8176,7 +8176,7 @@ async function probeDuration(filePath) {
 
 // src/commands/canvas/run.ts
 import { readFile as readFile2 } from "fs/promises";
-import path2 from "path";
+import path4 from "path";
 import { defineCommand as defineCommand80 } from "citty";
 
 // src/commands/canvas/placeholders.ts
@@ -8195,6 +8195,57 @@ function unsuppliedPlaceholderAssets(canvas) {
   return out;
 }
 
+// src/commands/canvas/resolve-paths.ts
+import path2 from "path";
+function resolveRelativeCanvasPaths(canvas, baseDir) {
+  if (!canvas || typeof canvas !== "object") return canvas;
+  const c = canvas;
+  if (!Array.isArray(c.nodes)) return canvas;
+  return { ...canvas, nodes: c.nodes.map((n) => resolveNode(n, baseDir)) };
+}
+function resolveNode(node, baseDir) {
+  if (!node || typeof node !== "object") return node;
+  const n = node;
+  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: path2.resolve(baseDir, params.path) } };
+  }
+  if (n.type === "hyperframe_render" && isResolvableRelative(params.composition)) {
+    return { ...node, params: { ...params, composition: path2.resolve(baseDir, params.composition) } };
+  }
+  return node;
+}
+function isResolvableRelative(value) {
+  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !path2.isAbsolute(value);
+}
+
+// src/commands/canvas/run-retention.ts
+import { rm } from "fs/promises";
+import path3 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;
+  return runs.slice(0, Math.max(0, runs.length - keep));
+}
+async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
+  const { readdir: readdir3 } = await import("fs/promises");
+  let entries;
+  try {
+    entries = await readdir3(outputsDir);
+  } catch {
+    return;
+  }
+  const toPrune = runDirsToPrune(entries, keep, currentRunId);
+  if (toPrune.length === 0) return;
+  for (const dir of toPrune) {
+    await rm(path3.join(outputsDir, dir), { recursive: true, force: true }).catch(
+      (e) => log(`[prune   ] could not remove ${dir}: ${e.message}`)
+    );
+  }
+  log(`[prune   ] removed ${toPrune.length} old run dir(s), kept the ${keep} newest`);
+}
+
 // src/commands/canvas/run.ts
 var runCommand = defineCommand80({
   meta: { name: "run", description: "Validate and execute a canvas JSON file." },
@@ -8203,10 +8254,14 @@ var runCommand = defineCommand80({
     "cache-dir": { type: "string", description: "Cache root (default ./canvas/.cache)" },
     "outputs-dir": { type: "string", description: "Per-run outputs root (default ./canvas)" },
     "run-id": { type: "string", description: "Override run id" },
-    "cache-policy": { type: "string", description: "read_write | bypass | read_only" }
+    "cache-policy": { type: "string", description: "read_write | bypass | read_only" },
+    "keep-runs": {
+      type: "string",
+      description: "After the run, prune old r_* run dirs, keeping the N newest (off by default)"
+    }
   },
   async run({ args }) {
-    const filePath = path2.resolve(String(args.file));
+    const filePath = path4.resolve(String(args.file));
     const raw = await readFile2(filePath, "utf8");
     let parsed;
     try {
@@ -8217,6 +8272,7 @@ var runCommand = defineCommand80({
 `);
       process.exit(2);
     }
+    parsed = resolveRelativeCanvasPaths(parsed, path4.dirname(filePath));
     const pending = unsuppliedPlaceholderAssets(parsed);
     if (pending.length > 0) {
       process.stderr.write(
@@ -8248,6 +8304,12 @@ var runCommand = defineCommand80({
         run_id: args["run-id"] ? String(args["run-id"]) : void 0,
         cache_policy: policy
       });
+      const keepRuns = args["keep-runs"] !== void 0 ? Number(args["keep-runs"]) : void 0;
+      if (keepRuns !== void 0 && Number.isFinite(keepRuns)) {
+        const outputsDir = args["outputs-dir"] ? path4.resolve(String(args["outputs-dir"])) : path4.resolve("canvas");
+        await pruneOldRuns(outputsDir, keepRuns, result.run_id, (line) => process.stdout.write(`${line}
+`));
+      }
       process.stdout.write(
         `${JSON.stringify(
           {
@@ -8280,7 +8342,7 @@ var runCommand = defineCommand80({
 
 // src/commands/canvas/scaffold-static-ad.ts
 import { readFile as readFile3, writeFile } from "fs/promises";
-import path3 from "path";
+import path5 from "path";
 import { defineCommand as defineCommand81 } from "citty";
 
 // src/engine/scaffold/staticAd.ts
@@ -8617,10 +8679,10 @@ var scaffoldStaticAdCommand = defineCommand81({
     "skip-font": { type: "boolean", description: "Skip the brand-font \u2192 type-specimen slot" }
   },
   async run({ args }) {
-    const imagePath = path3.resolve(String(args.file));
-    const outPath = args.out ? path3.resolve(String(args.out)) : path3.join(path3.dirname(imagePath), "static-ad.canvas.json");
-    const outDir = path3.dirname(outPath);
-    const blueprintPath = path3.join(outDir, "prompt.json");
+    const imagePath = path5.resolve(String(args.file));
+    const outPath = args.out ? path5.resolve(String(args.out)) : path5.join(path5.dirname(imagePath), "static-ad.canvas.json");
+    const outDir = path5.dirname(outPath);
+    const blueprintPath = path5.join(outDir, "prompt.json");
     const { describeModel, selectModel, layoutModel, genModel } = resolveModels(args);
     const describeCanvas = buildDescribeCanvas(
       imagePath,
@@ -8677,7 +8739,7 @@ var scaffoldStaticAdCommand = defineCommand81({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path3.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 ${path5.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, or delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             note: "Replace every [TODO] ingest path with a real file, then `baker canvas validate` and `baker canvas run`. Running generates a billed image \u2014 it is not free."
@@ -8692,13 +8754,13 @@ var scaffoldStaticAdCommand = defineCommand81({
 });
 
 // src/commands/canvas/scaffold-video.ts
-import { cp, mkdir, readFile as readFile5, writeFile as writeFile2 } from "fs/promises";
-import path5 from "path";
+import { cp, mkdir, readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
+import path8 from "path";
 import { defineCommand as defineCommand82 } from "citty";
 
 // src/engine/nodes/local/lib/sceneDetect.ts
 import { execFile as execFile2 } from "child_process";
-import { mkdtemp, readdir as readdir2, readFile as readFile4, rm } from "fs/promises";
+import { mkdtemp, readdir as readdir2, readFile as readFile4, rm as rm2 } from "fs/promises";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
 import { promisify as promisify2 } from "util";
@@ -8766,7 +8828,7 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
     if (!csvName) return [];
     return parsePySceneDetectCsvCuts(await readFile4(join2(outDir, csvName), "utf-8"));
   } finally {
-    await rm(outDir, { recursive: true, force: true });
+    await rm2(outDir, { recursive: true, force: true });
   }
 }
 async function detectSceneCutsPySceneDetect(filePath, opts = {}) {
@@ -9022,6 +9084,13 @@ function stillHoldArgs(durationS, dims) {
     `scale=${dims.w}:${dims.h}:force_original_aspect_ratio=increase,crop=${dims.w}:${dims.h},setsar=1,format=yuv420p`,
     "-c:v",
     "libx264",
+    // Near-visually-lossless re-encode. libx264 DEFAULTS (crf 23, preset medium)
+    // roughly halve the source bitrate and add banding on smooth surfaces; the
+    // spine concats these by stream-copy, so any loss here ships to the final cut.
+    "-crf",
+    "18",
+    "-preset",
+    "slow",
     "-pix_fmt",
     "yuv420p",
     "{{out.video}}"
@@ -9037,6 +9106,13 @@ function trimArgs(durationS, offsetS = 0) {
     "-an",
     "-c:v",
     "libx264",
+    // Preserve the seedance source quality through the trim. libx264 DEFAULTS
+    // (crf 23) halve the bitrate (measured 9.57→4.40 Mbps) and band on motion;
+    // the spine stream-copies the result, so the loss is permanent without this.
+    "-crf",
+    "18",
+    "-preset",
+    "slow",
     "-pix_fmt",
     "yuv420p",
     "{{out.video}}"
@@ -9103,6 +9179,13 @@ var Scene = z3.object({
   // The scene's role in the ad's persuasion arc (DECON-supplied); drives the
   // script re-craft checklist. Inferred from position when absent.
   narrative_role: z3.string().optional(),
+  // DECON-supplied on the HOOK scene: the engineered physical/emotional state that
+  // makes the first frame stop the scroll (sweaty/breathless/urgent …). Injected
+  // into the hook's start-frame description so the generator renders that state,
+  // not a calm influencer (CCA-11).
+  hook_mechanic: z3.object({ mechanic: z3.string().optional(), why_it_stops_scroll: z3.string().optional() }).loose().optional(),
+  // DECON-supplied per-scene location (so a gym hook isn't flattened to "home").
+  scene_setting: z3.string().optional(),
   // How this scene cuts to the next (DECON-supplied). A recognized non-cut type
   // (fade/whip/zoom/dissolve/swipe) is reproduced as an ffmpeg xfade at the
   // boundary; cut/match_cut/none/other stay hard cuts. The last scene's value is
@@ -9150,10 +9233,21 @@ var VideoBlueprint = z3.object({
       mode: z3.string().optional(),
       voice_description: z3.string().optional(),
       persona: z3.string().optional()
-    }).loose().optional()
+    }).loose().optional(),
+    // Visual palette — read only to colour a clean brand-card/CTA plate (the
+    // first hex is the dominant brand colour); never to drive frame generation.
+    style: z3.object({ palette: z3.array(z3.object({ hex: z3.string().optional() }).loose()).optional() }).loose().optional()
   }).loose().optional(),
   scenes: z3.array(Scene).min(1)
 }).loose();
+function injectHookPhysicality(blueprint) {
+  for (const scene of blueprint.scenes) {
+    const why = scene.hook_mechanic?.why_it_stops_scroll?.trim();
+    const prompt = scene.start_frame_prompt?.trim();
+    if (!why || !prompt || prompt.includes(why)) continue;
+    scene.start_frame_prompt = `${prompt} The subject's physical state IS the scroll-stopper \u2014 render it explicitly, not a calm pose: ${why}.`;
+  }
+}
 var AppearsItem = z3.union([z3.number(), z3.object({ scene: z3.number(), edge: z3.string().optional() }).loose()]);
 var RecurringElement = z3.object({
   // person | animal | product | logo | badge | other
@@ -9179,7 +9273,8 @@ function sanitizeId2(raw, fallback) {
   return /^[a-z]/.test(id) ? id : `${fallback}_${id}`.replace(/_+$/g, "") || fallback;
 }
 function labelFor2(el, used) {
-  const base = (el.label ?? el.type ?? "ELEMENT").toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "ELEMENT";
+  const raw = el.type?.toLowerCase() === "logo" ? "BRAND_LOGO" : el.label ?? el.type ?? "ELEMENT";
+  const base = raw.toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "") || "ELEMENT";
   let label = base;
   let n = 2;
   while (used.has(label)) label = `${base}_${n++}`;
@@ -9346,6 +9441,8 @@ function buildElementSheets(slots, nodes) {
     if (slot.sameAs) continue;
     if (slot.presence.size < 1) continue;
     const sheetId = `${slot.id}_sheet`;
+    const slotType = slot.type.toLowerCase();
+    const isCast = slotType === "person" || slotType === "animal";
     nodes.push({
       id: sheetId,
       type: "image_reference_sheet",
@@ -9358,7 +9455,14 @@ function buildElementSheets(slots, nodes) {
         // 4K: the sheet packs up to 8 cells (angles + tight face/detail close-ups), and
         // it's the ONE reference every frame grounds on — per-cell sharpness here
         // propagates to every clip, so it's worth the highest tier on this single asset.
-        image_size: "4K"
+        image_size: "4K",
+        // The sheet is the look that propagates to EVERY grounded frame, so a glossy
+        // studio turnaround makes the whole UGC ad read as "produced" (the #1 AI tell).
+        // Force a flat, real, front-camera look on the cast sheet so the actor stays
+        // authentic, not an airbrushed influencer (CCA-02).
+        ...isCast ? {
+          style: "authentic UGC look: flat, even, natural front-camera lighting \u2014 no studio key/rim light, no seamless backdrop, no shallow depth of field; real skin texture and pores, no airbrushing or beauty retouch; true-to-life everyday styling"
+        } : {}
       }
     });
     slot.ref = `$ref:${sheetId}.sheet`;
@@ -9466,8 +9570,7 @@ function buildFrameRef(edge, url, framePrompt, present, ctx, nodes) {
     const t = s.type.toLowerCase();
     return t === "person" || t === "animal";
   });
-  const castIdentityLocked = castSlots.every((s) => s.sheetBacked);
-  const useOriginalAnchor = Boolean(url) && (castSlots.length === 0 || castIdentityLocked);
+  const useOriginalAnchor = Boolean(url) && castSlots.length === 0;
   const hasOriginal = useOriginalAnchor;
   const originalRef = useOriginalAnchor && url ? ingestFrameRef(url, edge, ctx, nodes) : void 0;
   const reference = [...present.map((s) => s.ref), ...originalRef ? [originalRef] : []];
@@ -9678,6 +9781,39 @@ function isUiOnlyComposite(regions) {
   const ui = regions.filter(regionIsUiSurface).length;
   return ui >= 1 && regions.length - ui <= 1;
 }
+function sceneIsFullScreenUi(scene, present) {
+  if (scene.narrative_role?.trim() === "cta") return false;
+  const hasCast = present.some((s) => {
+    const t = s.type.toLowerCase();
+    return t === "person" || t === "animal";
+  });
+  if (hasCast) return false;
+  const hay = `${scene.summary ?? ""} ${scene.start_frame_prompt ?? ""} ${scene.end_frame_prompt ?? ""} ${scene.action_detail ?? ""}`;
+  return UI_SURFACE_RE.test(hay);
+}
+function screenStillArgs(durationS, dims) {
+  return [
+    "-loop",
+    "1",
+    "-i",
+    "{{in.frame}}",
+    "-t",
+    durationS.toFixed(3),
+    "-r",
+    "30",
+    "-vf",
+    `scale=${dims.w}:${dims.h}:force_original_aspect_ratio=decrease,pad=${dims.w}:${dims.h}:(ow-iw)/2:(oh-ih)/2:color=black,setsar=1,format=yuv420p`,
+    "-c:v",
+    "libx264",
+    "-crf",
+    "18",
+    "-preset",
+    "slow",
+    "-pix_fmt",
+    "yuv420p",
+    "{{out.video}}"
+  ];
+}
 function layeredComposition(scene) {
   const comp = scene.composition;
   const layout = (comp?.layout ?? "").toLowerCase();
@@ -9848,6 +9984,77 @@ function emitFlashHold(i, scene, slots, ctx, lengths, out, ar, nodes, clips) {
   });
   clips.push({ ref: `$ref:s${i}_clip.video`, scene_s: lengths.dur, out });
 }
+function emitScreenScene(i, scene, lengths, out, ar, nodes, clips) {
+  const label = commentSafe((scene.summary || scene.start_frame_prompt || "the app screen").slice(0, 120));
+  const refId = `s${i}_screen_ref`;
+  nodes.push({
+    id: refId,
+    type: "ingest",
+    params: {
+      source: "path",
+      path: `[TODO: supply the REAL screen for "${label}" \u2014 NEVER AI-generate a UI. Capture a clean, text-free screenshot with \`baker images screenshot https://<brand-domain>/<path>\` (image-library skill); spoken/overlay text rides the overlay layer, not the screenshot]`,
+      expect: "image"
+    }
+  });
+  nodes.push({
+    id: `s${i}_clip`,
+    type: "ffmpeg",
+    inputs: { frame: `$ref:${refId}.asset` },
+    params: {
+      args: screenStillArgs(lengths.trimTarget, canvasDims(ar)),
+      outputs: { video: { kind: "video", ext: "mp4" } }
+    }
+  });
+  clips.push({ ref: `$ref:s${i}_clip.video`, scene_s: lengths.dur, out });
+}
+var BRAND_CARD_RE = /\b(?:solid|plain|flat|brand|logo|wordmark|end[- ]?card|cta card|title card|colou?r background|background colou?r)\b/i;
+function sceneIsBrandCard(scene, present, isCta) {
+  if (!isCta) return false;
+  const hasCast = present.some((s) => {
+    const t = s.type.toLowerCase();
+    return t === "person" || t === "animal";
+  });
+  if (hasCast) return false;
+  const hay = `${scene.summary ?? ""} ${scene.start_frame_prompt ?? ""} ${scene.end_frame_prompt ?? ""}`;
+  return BRAND_CARD_RE.test(hay);
+}
+var HEX6_RE = /^#?[0-9a-fA-F]{6}$/;
+function brandPlateColor(blueprint) {
+  const palette = blueprint.global?.style?.palette;
+  const hex = palette?.map((p) => p?.hex).find((h) => typeof h === "string" && HEX6_RE.test(h));
+  return hex ? `0x${hex.replace(/^#/, "").toUpperCase()}` : "0x000000";
+}
+function colorPlateArgs(durationS, dims, color) {
+  return [
+    "-f",
+    "lavfi",
+    "-i",
+    `color=c=${color}:s=${dims.w}x${dims.h}:r=30`,
+    "-t",
+    durationS.toFixed(3),
+    "-c:v",
+    "libx264",
+    "-crf",
+    "18",
+    "-preset",
+    "slow",
+    "-pix_fmt",
+    "yuv420p",
+    "{{out.video}}"
+  ];
+}
+function emitBrandCardScene(i, lengths, out, ar, color, nodes, clips) {
+  nodes.push({
+    id: `s${i}_clip`,
+    type: "ffmpeg",
+    inputs: {},
+    params: {
+      args: colorPlateArgs(lengths.trimTarget, canvasDims(ar), color),
+      outputs: { video: { kind: "video", ext: "mp4" } }
+    }
+  });
+  clips.push({ ref: `$ref:s${i}_clip.video`, scene_s: lengths.dur, out });
+}
 function musicArcDigest(blueprint) {
   const roles = blueprint.scenes.map((s) => s.narrative_role).filter((r) => Boolean(r));
   const arc = roles.length > 0 ? roles.join(" \u2192 ") : "";
@@ -9967,7 +10174,7 @@ function makePresenterPresent(slots, canonical, opts = {}) {
   const solePerson = !opts.strict && personSlots.length === 1 ? personSlots[0].presence : null;
   return (speaker, sceneIndex) => {
     const presence = bySpeaker.get(speaker) ?? solePerson;
-    if (!presence) return opts.strict ? false : true;
+    if (!presence) return !opts.strict;
     return presence.has(sceneIndex);
   };
 }
@@ -10332,6 +10539,15 @@ function emitBrollScene(scene, i, isLast, env, nodes, out, prevEndFrame) {
     shootMode: mode,
     ingestCache: env.ingestCache
   };
+  if (!env.reuse && sceneIsFullScreenUi(scene, present)) {
+    emitScreenScene(i, scene, lengths, lengths.out, env.ar, nodes, out.clips);
+    return void 0;
+  }
+  const isCta = scene.narrative_role?.trim() === "cta" || isLast;
+  if (!env.reuse && sceneIsBrandCard(scene, present, isCta)) {
+    emitBrandCardScene(i, lengths, lengths.out, env.ar, brandPlateColor(env.blueprint), nodes, out.clips);
+    return void 0;
+  }
   if (!ambientBroll && lengths.dur <= FLASH_HOLD_MAX_S) {
     emitFlashHold(i, scene, env.slots, ctx, lengths, lengths.out, env.ar, nodes, out.clips);
     return void 0;
@@ -10597,7 +10813,7 @@ function overlayElement(ov, at, dur) {
   const normAnim = normalizeAnim(ov.animation);
   const anim = normAnim ? ` data-anim="${normAnim}"` : "";
   const detail = ov.animation_detail ? ` data-anim-detail="${escapeHtml(ov.animation_detail)}"` : "";
-  return `<div class="ov ${positionClass(ov.position)}" data-start="${at}" data-dur="${dur}"${role}${anim}${detail}>${escapeHtml(ov.text.trim())}</div>`;
+  return `<div class="ov clip ${positionClass(ov.position)}" data-start="${at}" data-dur="${dur}"${role}${anim}${detail}>${escapeHtml(ov.text.trim())}</div>`;
 }
 var RICH_OVERLAY_RE = /notif|tweet|\bx post\b|post\b|comment|message|chat|bubble|card|review|rating|stat|counter|toast|popup/;
 function sourceHint(fe) {
@@ -10627,7 +10843,7 @@ function floatingStub(fe, sceneStart) {
   const slug = (fe.kind ?? "element").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "element";
   return [
     `<!-- ${kind}: ${label} @ ${at}s for ${dur}s (${positionClass(fe.position)}). Source a real asset: ${hint} \u2014 drop it in this dir and uncomment:`,
-    `<img class="ov ${positionClass(fe.position)}" src="your-${slug}.png" data-start="${at}" data-dur="${dur}" alt="" /> -->`
+    `<img class="ov clip ${positionClass(fe.position)}" src="your-${slug}.png" data-start="${at}" data-dur="${dur}" alt="" /> -->`
   ].join("\n");
 }
 function uiPipStub(scene) {
@@ -10647,7 +10863,7 @@ function uiPipStub(scene) {
     "     \u2014 OR hand-build a brand-accurate HTML screen; then frame it in a phone mockup:",
     "       npx hyperframes add phone-scroll   (writes compositions/phone-scroll.html)",
     "     drop the screenshot as screenshot.png in this dir and nest it as a PIP clip:",
-    `     <div data-composition-src="compositions/phone-scroll.html" data-start="${at}" data-duration="${dur}" data-track-index="2" data-width="1080" data-height="1920"></div> -->`
+    `     <div class="clip" data-composition-src="compositions/phone-scroll.html" data-start="${at}" data-duration="${dur}" data-track-index="2" data-width="1080" data-height="1920"></div> -->`
   ].join("\n");
 }
 function buildOverlayHtml(input) {
@@ -10743,6 +10959,7 @@ function buildSpine(clips, nodes) {
 }
 function scaffoldVideoCanvas(input, elementsInput, opts) {
   const blueprint = VideoBlueprint.parse(input);
+  injectHookPhysicality(blueprint);
   const elements = RecurringElements.parse(elementsInput);
   const nodes = [];
   nodes.push({
@@ -11154,18 +11371,44 @@ function videoReport(input, elementsInput) {
 
 // src/commands/canvas/composition-path.ts
 import { existsSync as existsSync3 } from "fs";
-import path4 from "path";
+import path6 from "path";
 function resolveShippedCanvasDir(name, startDir, exists = existsSync3, maxDepth = 8) {
-  const rel = path4.join("canvas", name);
+  const rel = path6.join("canvas", name);
   let dir = startDir;
   for (let i = 0; i < maxDepth; i++) {
-    const candidate = path4.join(dir, rel);
-    if (exists(path4.join(candidate, "meta.json"))) return candidate;
-    const parent = path4.dirname(dir);
+    const candidate = path6.join(dir, rel);
+    if (exists(path6.join(candidate, "meta.json"))) return candidate;
+    const parent = path6.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path4.resolve(startDir, "../../../", rel);
+  return path6.resolve(startDir, "../../../", rel);
+}
+
+// src/commands/canvas/gitignore.ts
+import { appendFile, readFile as readFile5 } from "fs/promises";
+import path7 from "path";
+function missingGitignoreEntries(existing, entries) {
+  const present = new Set(
+    existing.split("\n").map((l) => l.trim().replace(/\/+$/, "")).filter((l) => l.length > 0 && !l.startsWith("#"))
+  );
+  return entries.filter((e) => !present.has(e.trim().replace(/\/+$/, "")));
+}
+async function ensureGitignore(dir, entries) {
+  const file = path7.join(dir, ".gitignore");
+  let existing;
+  try {
+    existing = await readFile5(file, "utf8");
+  } catch {
+    return;
+  }
+  const missing = missingGitignoreEntries(existing, entries);
+  if (missing.length === 0) return;
+  const prefix = existing.endsWith("\n") || existing.length === 0 ? "" : "\n";
+  await appendFile(file, `${prefix}
+# Baker canvas (engine cache + scaffold working files)
+${missing.join("\n")}
+`);
 }
 
 // src/commands/canvas/scaffold-video.ts
@@ -11194,7 +11437,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 readFile5(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile6(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})`);
@@ -11213,7 +11456,7 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text = transcript?.trim();
   if (!text || text === "[]") return {};
-  const compositionPath = path5.join(outDir, "tiktok-captions-composition");
+  const compositionPath = path8.join(outDir, "tiktok-captions-composition");
   await cp(SHIPPED_CAPTIONS_DIR, compositionPath, { recursive: true });
   return { compositionPath };
 }
@@ -11375,11 +11618,11 @@ var scaffoldVideoCommand = defineCommand82({
     }
   },
   async run({ args }) {
-    const videoPath = path5.resolve(String(args.file));
-    const base = path5.basename(videoPath, path5.extname(videoPath));
-    const outPath = args.out ? path5.resolve(String(args.out)) : path5.join(path5.dirname(videoPath), `${base}.video.canvas.json`);
-    const outDir = path5.dirname(outPath);
-    const blueprintPath = path5.join(outDir, "prompt.json");
+    const videoPath = path8.resolve(String(args.file));
+    const base = path8.basename(videoPath, path8.extname(videoPath));
+    const outPath = args.out ? path8.resolve(String(args.out)) : path8.join(path8.dirname(videoPath), `${base}.video.canvas.json`);
+    const outDir = path8.dirname(outPath);
+    const blueprintPath = path8.join(outDir, "prompt.json");
     const frames = args.frames === "reuse" ? "reuse" : "generate";
     const maxScenes = args["max-scenes"] ? Number(args["max-scenes"]) : void 0;
     if (Number.isFinite(maxScenes)) {
@@ -11402,11 +11645,11 @@ var scaffoldVideoCommand = defineCommand82({
     const annotated = annotateBlueprintWithElements(blueprint, elements);
     await writeFile2(blueprintPath, `${JSON.stringify(annotated, null, 2)}
 `, "utf8");
-    const compositionDest = path5.join(outDir, "video-overlay-composition");
+    const compositionDest = path8.join(outDir, "video-overlay-composition");
     await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
-    const indexPath = path5.join(compositionDest, "index.html");
+    const indexPath = path8.join(compositionDest, "index.html");
     const overlayHtml = buildOverlayHtml(blueprint);
-    const indexHtml = await readFile5(indexPath, "utf8");
+    const indexHtml = await readFile6(indexPath, "utf8");
     const injected = indexHtml.replace("<!--OVERLAYS-->", () => overlayHtml);
     if (injected === indexHtml && overlayHtml.trim()) {
       fail2(
@@ -11419,9 +11662,9 @@ var scaffoldVideoCommand = defineCommand82({
     const opts = {
       imageModel,
       videoModel,
-      overlayCompositionPath: compositionDest,
-      captionsCompositionPath: captions.compositionPath,
-      blueprintPath,
+      overlayCompositionPath: path8.relative(outDir, compositionDest),
+      captionsCompositionPath: captions.compositionPath ? path8.relative(outDir, captions.compositionPath) : void 0,
+      blueprintPath: path8.relative(outDir, blueprintPath),
       frames,
       ambient: Boolean(args.ambient),
       ...args.resolution ? { resolution: String(args.resolution) } : {}
@@ -11434,7 +11677,7 @@ var scaffoldVideoCommand = defineCommand82({
     } catch (e) {
       return fail2("scaffold", e instanceof Error ? e.message : String(e));
     }
-    const validation = await validateCanvasDeep(canvas, defaultRegistry());
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(canvas, outDir), defaultRegistry());
     if (!validation.ok) {
       process.stderr.write(
         `${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.issues } }, null, 2)}
@@ -11444,6 +11687,7 @@ var scaffoldVideoCommand = defineCommand82({
     }
     await writeFile2(outPath, `${JSON.stringify(canvas, null, 2)}
 `, "utf8");
+    await ensureGitignore(process.cwd(), ["canvas/", ".context/"]);
     process.stdout.write(
       `${JSON.stringify(
         {
@@ -11461,7 +11705,7 @@ var scaffoldVideoCommand = defineCommand82({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path5.basename(blueprintPath)} \u2014 the blueprint deconstructed from your video; rewrite it into the ad you want (cast, palette, copy, claims). Every scene frame reads it via target_blueprint.`,
+            edit_prompt: `Edit ${path8.basename(blueprintPath)} \u2014 the blueprint deconstructed from your video; rewrite it into the ad you want (cast, palette, copy, claims). Every scene frame reads it via target_blueprint.`,
             recurring_elements_to_supply: report.elements,
             voices_to_confirm: report.dialogue.map((d) => ({
               scene: d.scene,
@@ -11486,19 +11730,94 @@ var scaffoldVideoCommand = defineCommand82({
   }
 });
 
-// src/commands/canvas/validate.ts
-import { readFile as readFile6 } from "fs/promises";
-import path6 from "path";
+// src/commands/canvas/set-prompt.ts
+import { readFile as readFile7, writeFile as writeFile3 } from "fs/promises";
+import path9 from "path";
 import { defineCommand as defineCommand83 } from "citty";
-var validateCommand = defineCommand83({
+function setNodePrompt(canvas, nodeId, text) {
+  const nodes = canvas?.nodes;
+  if (!Array.isArray(nodes)) throw new Error("canvas has no nodes array");
+  const idx = nodes.findIndex((n) => n?.id === nodeId);
+  if (idx < 0) {
+    const ids = nodes.map((n) => n?.id).filter((id) => typeof id === "string");
+    throw new Error(`node "${nodeId}" not found. Known nodes: ${ids.join(", ")}`);
+  }
+  const node = nodes[idx];
+  const newNode = { ...node, params: { ...node.params ?? {}, prompt: text } };
+  const newNodes = [...nodes];
+  newNodes[idx] = newNode;
+  return { ...canvas, nodes: newNodes };
+}
+var setPromptCommand = defineCommand83({
+  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."
+  },
+  args: {
+    file: { type: "positional", required: true, description: "Path to canvas JSON" },
+    node: { type: "positional", required: true, description: "Node id to edit (e.g. s0_start)" },
+    text: { type: "string", description: "New prompt text (inline)" },
+    "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
+  },
+  async run({ args }) {
+    const filePath = path9.resolve(String(args.file));
+    let canvas;
+    try {
+      canvas = JSON.parse(await readFile7(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 readFile7(path9.resolve(String(args["text-file"])), "utf8");
+    else if (args.text !== void 0) text = String(args.text);
+    else {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "no_text", message: "pass --text or --text-file" } }, null, 2)}
+`
+      );
+      process.exit(2);
+      return;
+    }
+    let updated;
+    try {
+      updated = setNodePrompt(canvas, String(args.node), text);
+    } catch (e) {
+      process.stderr.write(
+        `${JSON.stringify({ ok: false, error: { code: "node_not_found", message: String(e.message) } }, null, 2)}
+`
+      );
+      process.exit(2);
+      return;
+    }
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path9.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 writeFile3(filePath, `${JSON.stringify(updated, null, 2)}
+`, "utf8");
+    process.stdout.write(`${JSON.stringify({ ok: true, node: String(args.node), bytes: text.length }, null, 2)}
+`);
+  }
+});
+
+// src/commands/canvas/validate.ts
+import { readFile as readFile8 } from "fs/promises";
+import path10 from "path";
+import { defineCommand as defineCommand84 } from "citty";
+var validateCommand = defineCommand84({
   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 = path6.resolve(String(args.file));
-    const raw = await readFile6(filePath, "utf8");
+    const filePath = path10.resolve(String(args.file));
+    const raw = await readFile8(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -11508,6 +11827,7 @@ var validateCommand = defineCommand83({
 `);
       process.exit(2);
     }
+    parsed = resolveRelativeCanvasPaths(parsed, path10.dirname(filePath));
     const result = await validateCanvasDeep(parsed, defaultRegistry());
     if (!result.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, issues: result.issues }, null, 2)}
@@ -11532,7 +11852,7 @@ var validateCommand = defineCommand83({
 });
 
 // src/commands/canvas/index.ts
-var canvasCommand = defineCommand84({
+var canvasCommand = defineCommand85({
   meta: {
     name: "canvas",
     description: `Run Baker creative canvas JSON files locally. Local nodes execute in-process; remote nodes POST to the Convex backend gateway.
@@ -11553,15 +11873,16 @@ Subcommands:
     catalog: catalogCommand,
     inspect: inspectCommand,
     "scaffold-video": scaffoldVideoCommand,
-    "scaffold-static-ad": scaffoldStaticAdCommand
+    "scaffold-static-ad": scaffoldStaticAdCommand,
+    "set-prompt": setPromptCommand
   }
 });
 
 // src/commands/ga4/index.ts
-import { defineCommand as defineCommand88 } from "citty";
+import { defineCommand as defineCommand89 } from "citty";
 
 // src/commands/ga4/audit.ts
-import { defineCommand as defineCommand85 } from "citty";
+import { defineCommand as defineCommand86 } from "citty";
 
 // src/commands/ga4/resolve.ts
 async function fetchProperties(useCache = true) {
@@ -11624,7 +11945,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var auditCommand2 = defineCommand85({
+var auditCommand2 = defineCommand86({
   meta: {
     name: "audit",
     description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
@@ -11676,7 +11997,7 @@ Examples:
 });
 
 // src/commands/ga4/properties.ts
-import { defineCommand as defineCommand86 } from "citty";
+import { defineCommand as defineCommand87 } 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.",
@@ -11684,7 +12005,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var propertiesCommand = defineCommand86({
+var propertiesCommand = defineCommand87({
   meta: {
     name: "properties",
     description: `List accessible GA4 properties.
@@ -11734,7 +12055,7 @@ Examples:
 // src/commands/ga4/query.ts
 import { appendFileSync as appendFileSync2, existsSync as existsSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve2 } from "path";
-import { defineCommand as defineCommand87 } from "citty";
+import { defineCommand as defineCommand88 } from "citty";
 
 // src/commands/ga4/presets.ts
 var GA4_PRESETS = [
@@ -11866,7 +12187,7 @@ function handleError(err) {
   });
   process.exit(1);
 }
-var queryCommand2 = defineCommand87({
+var queryCommand2 = defineCommand88({
   meta: {
     name: "query",
     description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
@@ -11937,7 +12258,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/ga4/index.ts
-var ga4Command = defineCommand88({
+var ga4Command = defineCommand89({
   meta: {
     name: "ga4",
     description: `Google Analytics 4 commands. Audit property config, run playbook-aligned reports.
@@ -11960,12 +12281,12 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-import { defineCommand as defineCommand92 } from "citty";
+import { defineCommand as defineCommand93 } from "citty";
 
 // src/commands/gsc/query.ts
 import { appendFileSync as appendFileSync3, existsSync as existsSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve3 } from "path";
-import { defineCommand as defineCommand89 } from "citty";
+import { defineCommand as defineCommand90 } from "citty";
 
 // src/commands/gsc/presets.ts
 var GSC_PRESETS = [
@@ -12153,7 +12474,7 @@ function handleError2(err) {
   });
   process.exit(1);
 }
-var queryCommand3 = defineCommand89({
+var queryCommand3 = defineCommand90({
   meta: {
     name: "query",
     description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
@@ -12231,7 +12552,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/gsc/sitemaps.ts
-import { defineCommand as defineCommand90 } from "citty";
+import { defineCommand as defineCommand91 } from "citty";
 registerSchema({
   command: "gsc.sitemaps",
   description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
@@ -12240,7 +12561,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitemapsCommand = defineCommand90({
+var sitemapsCommand = defineCommand91({
   meta: {
     name: "sitemaps",
     description: `List sitemaps for a site. Check health and errors.
@@ -12290,7 +12611,7 @@ Examples:
 });
 
 // src/commands/gsc/sites.ts
-import { defineCommand as defineCommand91 } from "citty";
+import { defineCommand as defineCommand92 } from "citty";
 registerSchema({
   command: "gsc.sites",
   description: "List all verified Google Search Console sites. Returns site URLs needed for query and sitemaps commands.",
@@ -12298,7 +12619,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitesCommand = defineCommand91({
+var sitesCommand = defineCommand92({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -12346,7 +12667,7 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-var gscCommand = defineCommand92({
+var gscCommand = defineCommand93({
   meta: {
     name: "gsc",
     description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
@@ -12369,10 +12690,10 @@ Examples:
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand117 } from "citty";
 
 // src/commands/images/crop.ts
-import { defineCommand as defineCommand93 } from "citty";
+import { defineCommand as defineCommand94 } from "citty";
 
 // src/lib/image/crop-sprite.ts
 import sharp from "sharp";
@@ -12387,7 +12708,7 @@ function cropSprite(input, region) {
 
 // src/lib/image/io.ts
 import { randomBytes } from "crypto";
-import { glob as fsGlob, readFile as readFile7, rename, stat as stat2, writeFile as writeFile3 } from "fs/promises";
+import { glob as fsGlob, readFile as readFile9, rename, stat as stat2, writeFile as writeFile4 } from "fs/promises";
 import { dirname, extname, join as join3, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
@@ -12423,11 +12744,11 @@ async function readImageBuffer(pathOrUrl) {
     }
     return Buffer.from(await response.arrayBuffer());
   }
-  return readFile7(pathOrUrl);
+  return readFile9(pathOrUrl);
 }
-async function isDirectory(path7) {
+async function isDirectory(path11) {
   try {
-    const s = await stat2(path7);
+    const s = await stat2(path11);
     return s.isDirectory();
   } catch {
     return false;
@@ -12446,7 +12767,7 @@ async function atomicWrite(targetPath, data) {
   const absolute = resolve4(targetPath);
   const dir = dirname(absolute);
   const tmp = join3(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
-  await writeFile3(tmp, data);
+  await writeFile4(tmp, data);
   await rename(tmp, absolute);
 }
 
@@ -12497,7 +12818,7 @@ function emitError2(err) {
   }
   process.exit(1);
 }
-var cropCommand = defineCommand93({
+var cropCommand = defineCommand94({
   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"
@@ -12533,7 +12854,7 @@ var cropCommand = defineCommand93({
 });
 
 // src/commands/images/delete.ts
-import { defineCommand as defineCommand94 } from "citty";
+import { defineCommand as defineCommand95 } from "citty";
 registerSchema({
   command: "images.delete",
   description: "Delete an image by ID",
@@ -12547,7 +12868,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand = defineCommand94({
+var deleteCommand = defineCommand95({
   meta: {
     name: "delete",
     description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run"
@@ -12588,7 +12909,7 @@ var deleteCommand = defineCommand94({
 });
 
 // src/commands/images/dimensions.ts
-import { defineCommand as defineCommand95 } from "citty";
+import { defineCommand as defineCommand96 } from "citty";
 
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
@@ -12611,7 +12932,7 @@ registerSchema({
     target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
   }
 });
-var dimensionsCommand = defineCommand95({
+var dimensionsCommand = defineCommand96({
   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"
@@ -12655,7 +12976,7 @@ var dimensionsCommand = defineCommand95({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand96 } from "citty";
+import { defineCommand as defineCommand97 } from "citty";
 registerSchema({
   command: "images.extract",
   description: "Extract images from a URL via Firecrawl (formats: images).",
@@ -12671,7 +12992,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand96({
+var extractCommand = defineCommand97({
   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"
@@ -12709,7 +13030,7 @@ var extractCommand = defineCommand96({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand97 } from "citty";
+import { defineCommand as defineCommand98 } from "citty";
 registerSchema({
   command: "images.find",
   description: "Fanout image search: library first, then opted-in external providers.",
@@ -12741,7 +13062,7 @@ registerSchema({
     }
   }
 });
-var findCommand = defineCommand97({
+var findCommand = defineCommand98({
   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"
@@ -12787,8 +13108,8 @@ var findCommand = defineCommand97({
 });
 
 // src/commands/images/generate.ts
-import { readFile as readFile8 } from "fs/promises";
-import { defineCommand as defineCommand98 } from "citty";
+import { readFile as readFile10 } from "fs/promises";
+import { defineCommand as defineCommand99 } from "citty";
 import sharp2 from "sharp";
 var GENERATE_TIMEOUT_MS = 18e4;
 var REFERENCE_MAX_EDGE = 1536;
@@ -12870,7 +13191,7 @@ async function resolveReferences(spec) {
     }
     let raw;
     try {
-      raw = await readFile8(entry);
+      raw = await readFile10(entry);
     } catch {
       throw new ApiError("VALIDATION_ERROR", `Reference file not found: ${entry}`);
     }
@@ -12884,7 +13205,7 @@ async function resolveReferences(spec) {
   }
   return out;
 }
-var generateCommand = defineCommand98({
+var generateCommand = defineCommand99({
   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: openai/gpt-5.4-image-2 (default \u2014 photoreal, cleanest text, best for ad/landing reproduction), google/gemini-3-pro-image-preview (Nano Banana Pro), google/gemini-3.5-flash & google/gemini-3.1-flash-image-preview (fast, extreme aspect ratios), 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 google/gemini-3-pro-image-preview --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]]'"
@@ -12936,7 +13257,7 @@ var generateCommand = defineCommand98({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand99 } from "citty";
+import { defineCommand as defineCommand100 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -12944,7 +13265,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand2 = defineCommand99({
+var getCommand2 = defineCommand100({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -12980,7 +13301,7 @@ var getCommand2 = defineCommand99({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand100 } from "citty";
+import { defineCommand as defineCommand101 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -13012,7 +13333,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand100({
+var gifCommand = defineCommand101({
   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"
@@ -13059,7 +13380,7 @@ var gifCommand = defineCommand100({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand101 } from "citty";
+import { defineCommand as defineCommand102 } from "citty";
 registerSchema({
   command: "images.google",
   description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
@@ -13095,7 +13416,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand101({
+var googleCommand2 = defineCommand102({
   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"
@@ -13143,7 +13464,7 @@ var googleCommand2 = defineCommand101({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand102 } from "citty";
+import { defineCommand as defineCommand103 } from "citty";
 registerSchema({
   command: "images.icon",
   description: "Icon lookup via Iconify (200+ icon sets, free CDN).",
@@ -13169,7 +13490,7 @@ registerSchema({
     }
   }
 });
-var iconCommand = defineCommand102({
+var iconCommand = defineCommand103({
   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'"
@@ -13209,7 +13530,7 @@ var iconCommand = defineCommand102({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand103 } from "citty";
+import { defineCommand as defineCommand104 } from "citty";
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
@@ -13221,7 +13542,7 @@ registerSchema({
     context: { type: "string", description: "Description context hint", required: false }
   }
 });
-var ingestCommand = defineCommand103({
+var ingestCommand = defineCommand104({
   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"
@@ -13263,7 +13584,7 @@ var ingestCommand = defineCommand103({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand104 } from "citty";
+import { defineCommand as defineCommand105 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -13289,7 +13610,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand104({
+var libraryCommand = defineCommand105({
   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"
@@ -13346,7 +13667,7 @@ var libraryCommand = defineCommand104({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand105 } from "citty";
+import { defineCommand as defineCommand106 } from "citty";
 registerSchema({
   command: "images.logo",
   description: "Brand logo lookup via Brandfetch CDN (fallback/404). Auto-ingests by default.",
@@ -13371,7 +13692,7 @@ registerSchema({
     }
   }
 });
-var logoCommand = defineCommand105({
+var logoCommand = defineCommand106({
   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\nExample: baker images logo stripe.com --variant logo"
@@ -13409,7 +13730,7 @@ var logoCommand = defineCommand105({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand106 } from "citty";
+import { defineCommand as defineCommand107 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -14141,7 +14462,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand = defineCommand106({
+var normalizeCommand = defineCommand107({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -14196,7 +14517,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand107 } from "citty";
+import { defineCommand as defineCommand108 } 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.",
@@ -14216,7 +14537,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand107({
+var pinterestCommand = defineCommand108({
   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'"
@@ -14256,7 +14577,7 @@ var pinterestCommand = defineCommand107({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand108 } from "citty";
+import { defineCommand as defineCommand109 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -14272,7 +14593,7 @@ registerSchema({
     }
   }
 });
-var screenshotCommand = defineCommand108({
+var screenshotCommand = defineCommand109({
   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"
@@ -14322,7 +14643,7 @@ var screenshotCommand = defineCommand108({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand110 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -14338,7 +14659,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand109({
+var searchCommand = defineCommand110({
   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"
@@ -14398,7 +14719,7 @@ var searchCommand = defineCommand109({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand111 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -14430,7 +14751,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand110({
+var stickerCommand = defineCommand111({
   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"
@@ -14477,7 +14798,7 @@ var stickerCommand = defineCommand110({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 registerSchema({
   command: "images.stock",
   description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
@@ -14535,7 +14856,7 @@ registerSchema({
     }
   }
 });
-var stockCommand = defineCommand111({
+var stockCommand = defineCommand112({
   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"
@@ -14591,7 +14912,7 @@ var stockCommand = defineCommand111({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand113 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -14600,7 +14921,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand112({
+  return defineCommand113({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -14636,9 +14957,9 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand2 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { readFile as readFile9 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 import { extname as extname2 } from "path";
-import { defineCommand as defineCommand113 } from "citty";
+import { defineCommand as defineCommand114 } from "citty";
 var MIME_MAP = {
   ".png": "image/png",
   ".jpg": "image/jpeg",
@@ -14693,7 +15014,7 @@ function detectContentType(filePath) {
   }
   return mime;
 }
-var uploadCommand = defineCommand113({
+var uploadCommand = defineCommand114({
   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'"
@@ -14776,7 +15097,7 @@ async function uploadLocal(target, args) {
     });
     return;
   }
-  const fileBuffer = await readFile9(target);
+  const fileBuffer = await readFile11(target);
   const base64 = fileBuffer.toString("base64");
   const body = { base64, contentType };
   if (args.source) body.source = args.source;
@@ -14786,7 +15107,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand114 } from "citty";
+import { defineCommand as defineCommand115 } 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).",
@@ -14801,7 +15122,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS3 = 1500;
-var upscaleCommand = defineCommand114({
+var upscaleCommand = defineCommand115({
   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"
@@ -14856,7 +15177,7 @@ var upscaleCommand = defineCommand114({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand115 } from "citty";
+import { defineCommand as defineCommand116 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -14872,7 +15193,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var useCommand = defineCommand115({
+var useCommand = defineCommand116({
   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"
@@ -14918,7 +15239,7 @@ var useCommand = defineCommand115({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand116({
+var imagesCommand = defineCommand117({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -14988,10 +15309,10 @@ Paid transforms (run on the Convex backend, cost-tracked):
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand128 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand118 } 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.";
@@ -15104,7 +15425,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand117({
+var advertisersCommand = defineCommand118({
   meta: {
     name: "advertisers",
     description: `Find domains competing for a keyword in Google SERPs.
@@ -15151,7 +15472,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand119 } 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).",
@@ -15174,7 +15495,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand118({
+var autocompleteCommand = defineCommand119({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -15220,7 +15541,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand120 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -15277,7 +15598,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand119({
+var countriesCommand = defineCommand120({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -15288,7 +15609,7 @@ var countriesCommand = defineCommand119({
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand120 } from "citty";
+import { defineCommand as defineCommand121 } 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.",
@@ -15311,7 +15632,7 @@ var FIELDS6 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand120({
+var intentCommand = defineCommand121({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -15359,7 +15680,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand121 } from "citty";
+import { defineCommand as defineCommand122 } 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.",
@@ -15388,7 +15709,7 @@ var FIELDS7 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand121({
+var keywordGapCommand = defineCommand122({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -15462,7 +15783,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand123 } 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.",
@@ -15495,7 +15816,7 @@ var FIELDS8 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand122({
+var keywordsForSiteCommand = defineCommand123({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -15548,7 +15869,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand124 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -15578,7 +15899,7 @@ var FIELDS9 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand123({
+var languagesCommand2 = defineCommand124({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -15589,7 +15910,7 @@ var languagesCommand2 = defineCommand123({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand125 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -15608,7 +15929,7 @@ var FIELDS10 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand124({
+var lighthouseCommand = defineCommand125({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -15646,7 +15967,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand126 } 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).",
@@ -15672,7 +15993,7 @@ var FIELDS11 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand125({
+var relevantPagesCommand = defineCommand126({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -15718,7 +16039,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand127 } 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).",
@@ -15769,7 +16090,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand126({
+var webCommand = defineCommand127({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -15829,7 +16150,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand127({
+var researchCommand = defineCommand128({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -15869,10 +16190,10 @@ Examples:
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand135 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand129 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -15977,7 +16298,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false }
   }
 });
-var createCommand2 = defineCommand128({
+var createCommand2 = defineCommand129({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -16025,7 +16346,7 @@ var createCommand2 = defineCommand128({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand130 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -16033,7 +16354,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand2 = defineCommand129({
+var deleteCommand2 = defineCommand130({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -16062,7 +16383,7 @@ var deleteCommand2 = defineCommand129({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand130 } from "citty";
+import { defineCommand as defineCommand131 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -16070,7 +16391,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var getCommand3 = defineCommand130({
+var getCommand3 = defineCommand131({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -16107,13 +16428,13 @@ var getCommand3 = defineCommand130({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand132 } from "citty";
 registerSchema({
   command: "scheduled-actions.list",
   description: "List published scheduled actions. Includes draft state when BAKER_CHAT_ID is set.",
   args: {}
 });
-var listCommand3 = defineCommand131({
+var listCommand3 = defineCommand132({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set."
@@ -16134,7 +16455,7 @@ var listCommand3 = defineCommand131({
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand133 } 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.",
@@ -16142,7 +16463,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand132({
+var triggerCommand = defineCommand133({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -16179,7 +16500,7 @@ var triggerCommand = defineCommand132({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand133 } from "citty";
+import { defineCommand as defineCommand134 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -16204,7 +16525,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand2 = defineCommand133({
+var updateCommand2 = defineCommand134({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
@@ -16274,7 +16595,7 @@ var updateCommand2 = defineCommand133({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand134({
+var scheduledActionsCommand = defineCommand135({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger.
@@ -16300,8 +16621,8 @@ Examples:
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand135 } from "citty";
-var schemaCommand = defineCommand135({
+import { defineCommand as defineCommand136 } from "citty";
+var schemaCommand = defineCommand136({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -16337,10 +16658,10 @@ var schemaCommand = defineCommand135({
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand137 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -16348,7 +16669,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand4 = defineCommand136({
+var getCommand4 = defineCommand137({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -16385,7 +16706,7 @@ var getCommand4 = defineCommand136({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand137 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -16415,7 +16736,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand4 = defineCommand137({
+var listCommand4 = defineCommand138({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -16464,7 +16785,7 @@ var listCommand4 = defineCommand137({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand138 } from "citty";
+import { defineCommand as defineCommand139 } from "citty";
 registerSchema({
   command: "testimonials.search",
   description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
@@ -16495,7 +16816,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand2 = defineCommand138({
+var searchCommand2 = defineCommand139({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -16569,7 +16890,7 @@ var searchCommand2 = defineCommand138({
 var tagsCommand3 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand139({
+var testimonialsCommand = defineCommand140({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -16590,10 +16911,10 @@ Examples:
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand145 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand141 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -16607,7 +16928,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand140({
+var deleteCommand3 = defineCommand141({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -16648,7 +16969,7 @@ var deleteCommand3 = defineCommand140({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -16656,7 +16977,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand5 = defineCommand141({
+var getCommand5 = defineCommand142({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -16693,7 +17014,7 @@ var getCommand5 = defineCommand141({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -16703,7 +17024,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand3 = defineCommand142({
+var searchCommand3 = defineCommand143({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -16753,9 +17074,9 @@ var searchCommand3 = defineCommand142({
 var tagsCommand4 = makeTagsCommand("videos", "video", "/api/videos/tags");
 
 // src/commands/videos/upload.ts
-import { readFile as readFile10, stat as stat3 } from "fs/promises";
+import { readFile as readFile12, stat as stat3 } from "fs/promises";
 import { extname as extname3 } from "path";
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 var MIME_MAP2 = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -16789,7 +17110,7 @@ function detectContentType2(filePath) {
   }
   return mime;
 }
-var uploadCommand2 = defineCommand143({
+var uploadCommand2 = defineCommand144({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -16818,7 +17139,7 @@ var uploadCommand2 = defineCommand143({
         return;
       }
       const { uploadUrl, videoId } = await apiPost("/api/videos/upload", {});
-      const fileBuffer = await readFile10(filePath);
+      const fileBuffer = await readFile12(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -16843,7 +17164,7 @@ var uploadCommand2 = defineCommand143({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand144({
+var videosCommand = defineCommand145({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
@@ -16866,10 +17187,10 @@ Examples:
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand148 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 registerSchema({
   command: "winning-ads.advertisers",
   description: "Resolve a brand name to advertiser_id(s) in the ad-dna corpus \u2014 to find your OWN advertiser (to --exclude-advertiser) or a competitor (to --advertiser-id).",
@@ -16882,7 +17203,7 @@ registerSchema({
 function identity(record) {
   return record;
 }
-var advertisersCommand2 = defineCommand145({
+var advertisersCommand2 = defineCommand146({
   meta: {
     name: "advertisers",
     description: 'Resolve a brand name to advertiser_id(s). Use it to find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id. Example: baker winning-ads advertisers "Deel" --output md'
@@ -16933,7 +17254,7 @@ var advertisersCommand2 = defineCommand145({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand147 } 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.",
@@ -17041,7 +17362,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand146({
+var searchCommand4 = defineCommand147({
   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"
@@ -17153,7 +17474,7 @@ var searchCommand4 = defineCommand146({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand147({
+var winningAdsCommand = defineCommand148({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -17193,7 +17514,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand148({
+var main = defineCommand149({
   meta: {
     name: "baker",
     version: getCliVersion(),