@koda-sl/baker-cli 0.96.0 → 0.97.0-dev.e4727e68

package/dist/cli.js

@@ -9,10 +9,10 @@ import {
   defaultRegistry,
   generateCatalog,
   validateCanvasDeep
-} from "./chunk-RCPMJKI7.js";
+} from "./chunk-7HSLFPZI.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand148, runMain } from "citty";
+import { defineCommand as defineCommand150, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand17 } from "citty";
@@ -483,6 +483,33 @@ var SCHEDULE_SIGNALS = [
   /\bremind(?:er|s)?\b/i,
   /\brun\s+at\b/i
 ];
+var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
+function parsePriority(value, { allowClear }) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    failValidation(
+      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+    );
+  }
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "") {
+    if (allowClear) {
+      return null;
+    }
+    return void 0;
+  }
+  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
+    return null;
+  }
+  if (ACTION_PRIORITIES.includes(trimmed)) {
+    return trimmed;
+  }
+  failValidation(
+    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+  );
+}
 function looksScheduled(name, description) {
   const haystack = `${name}
 ${description}`;
@@ -570,7 +597,7 @@ var completeCommand = defineCommand2({
 import { defineCommand as defineCommand3 } from "citty";
 registerSchema({
   command: "actions.create",
-  description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Tag the action with --tags (strongly encouraged \u2014 run `baker actions tags list` for the taxonomy). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
+  description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Pass --tags (REQUIRED \u2014 run `baker actions tags list` for the taxonomy) and --priority (one of urgent|high|medium|low \u2014 drives the dependency-aware 'Do first' ordering). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
   args: {
     name: { type: "string", description: "Action name (short, action-verb, \u22646 words)", required: true },
     description: {
@@ -583,6 +610,11 @@ registerSchema({
       description: "Comma-separated tag slugs (e.g. google-ads,audit-finding). Must be known \u2014 see `baker actions tags list`.",
       required: false
     },
+    priority: {
+      type: "string",
+      description: `User priority for the do-first ordering. One of: ${ACTION_PRIORITIES.join(", ")}.`,
+      required: false
+    },
     "temp-id": { type: "string", description: "Custom tempId (auto-generated if omitted)", required: false }
   }
 });
@@ -595,6 +627,7 @@ var createCommand = defineCommand3({
     name: { type: "string", description: "Action name", required: false },
     description: { type: "string", description: "Description", required: false, default: "" },
     tags: { type: "string", description: "Comma-separated tag slugs (see `baker actions tags list`)", required: false },
+    priority: { type: "string", description: `User priority: ${ACTION_PRIORITIES.join("|")}`, required: false },
     "temp-id": { type: "string", description: "Optional custom tempId", required: false }
   },
   run: async ({ args }) => {
@@ -606,12 +639,14 @@ var createCommand = defineCommand3({
       const chatId = requireChatId();
       const tempId = args["temp-id"] || generateTempId();
       const tags = parseTagList(args.tags);
+      const priority = parsePriority(args.priority, { allowClear: false });
       const response = await apiPost("/api/actions/create", {
         chatId,
         tempId,
         name,
         description: args.description ?? "",
-        ...tags ? { tags } : {}
+        ...tags ? { tags } : {},
+        ...priority !== void 0 && priority !== null ? { priority } : {}
       });
       const hints = [];
       if (looksScheduled(name, args.description ?? "")) {
@@ -625,7 +660,12 @@ var createCommand = defineCommand3({
       }
       if (!tags || tags.length === 0) {
         hints.push(
-          "Tag this action so it's filterable in the backlog: re-run with --tags <slug,...> (run `baker actions tags list` for the taxonomy, or `baker actions update <tempId> --tags <slug,...>`)."
+          "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
+        );
+      }
+      if (priority === void 0) {
+        hints.push(
+          `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
         );
       }
       writeJson({ ...response, hints });
@@ -1161,7 +1201,7 @@ var unlinkCommand = defineCommand15({
 import { defineCommand as defineCommand16 } from "citty";
 registerSchema({
   command: "actions.update",
-  description: "Stage an update on a claimed action (name, description, and/or tags). Applies on publish. --tags REPLACES the tag set; pass --tags '' to clear all tags. Tags must be known \u2014 see `baker actions tags list`.",
+  description: "Stage an update on a claimed action (name, description, tags, and/or priority). Applies on publish. --tags REPLACES the tag set; pass --tags '' to clear. --priority accepts urgent|high|medium|low or 'none' to clear back to unset (== normal).",
   args: {
     id: { type: "string", description: "Action ID (must be claimed by current chat)", required: true },
     name: { type: "string", description: "New name", required: false },
@@ -1170,6 +1210,11 @@ registerSchema({
       type: "string",
       description: "Comma-separated tag slugs \u2014 REPLACES existing tags ('' clears)",
       required: false
+    },
+    priority: {
+      type: "string",
+      description: `User priority: ${ACTION_PRIORITIES.join("|")}, or 'none' to clear.`,
+      required: false
     }
   }
 });
@@ -1183,7 +1228,8 @@ var updateCommand = defineCommand16({
     "action-id": { type: "string", description: "Action ID", required: false },
     name: { type: "string", description: "New name", required: false },
     description: { type: "string", description: "New description", required: false },
-    tags: { type: "string", description: "Comma-separated tag slugs \u2014 REPLACES existing ('' clears)", required: false }
+    tags: { type: "string", description: "Comma-separated tag slugs \u2014 REPLACES existing ('' clears)", required: false },
+    priority: { type: "string", description: `Priority: ${ACTION_PRIORITIES.join("|")}|none`, required: false }
   },
   run: async ({ args }) => {
     try {
@@ -1193,8 +1239,9 @@ var updateCommand = defineCommand16({
       }
       validateConvexId(id);
       const tags = parseTagList(args.tags);
-      if (args.name === void 0 && args.description === void 0 && tags === void 0) {
-        failValidation("Provide at least one of --name, --description, --tags.");
+      const priority = parsePriority(args.priority, { allowClear: true });
+      if (args.name === void 0 && args.description === void 0 && tags === void 0 && priority === void 0) {
+        failValidation("Provide at least one of --name, --description, --tags, --priority.");
       }
       const chatId = requireChatId();
       await apiPost("/api/actions/update", {
@@ -1202,7 +1249,8 @@ var updateCommand = defineCommand16({
         actionId: id,
         name: args.name,
         description: args.description,
-        ...tags !== void 0 ? { tags } : {}
+        ...tags !== void 0 ? { tags } : {},
+        ...priority !== void 0 ? { priority } : {}
       });
       writeOk();
     } catch (err) {
@@ -11509,11 +11557,161 @@ Subcommands:
   }
 });
 
+// src/commands/creatives/index.ts
+import { defineCommand as defineCommand86 } from "citty";
+
+// src/commands/creatives/publish.ts
+import { readFile as readFile7 } from "fs/promises";
+import { extname } from "path";
+import { defineCommand as defineCommand85 } from "citty";
+var creativeTag = "creative";
+var publishTimeoutMs = 18e4;
+var pollIntervalMs = 2e3;
+var mimeMap = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp"
+};
+var defaultDeps = {
+  readFile: readFile7,
+  post: apiPost,
+  get: apiGet,
+  sleep: (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))
+};
+registerSchema({
+  command: "creatives.publish",
+  description: "Publish a final static creative image to Baker Images, apply the official creative tag, and return an image reference.",
+  args: {
+    file: { type: "string", description: "Local PNG/JPG/WebP creative image path", required: true },
+    title: { type: "string", description: "Human title for the creative output", required: true },
+    context: { type: "string", description: "Optional describe context for the image row", required: false }
+  }
+});
+function detectCreativeContentType(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  const contentType = mimeMap[ext];
+  if (!contentType) {
+    throw new ApiError("VALIDATION_ERROR", `Unsupported creative image extension "${ext}". Use PNG, JPG, or WebP.`);
+  }
+  return contentType;
+}
+function imageToCreativeReference(image, title) {
+  if (!image.imageUrl) {
+    throw new ApiError("IMAGE_PROCESSING_ERROR", "Published image is missing imageUrl");
+  }
+  return {
+    type: "image",
+    slug: image._id,
+    title,
+    tags: image.tags?.includes(creativeTag) ? image.tags : [...image.tags ?? [], creativeTag],
+    imageUrl: image.imageUrl,
+    thumbnailUrl: image.thumbnailUrl ?? image.imageUrl,
+    storageKey: image.storageKey,
+    width: image.width,
+    height: image.height,
+    aspectRatio: image.aspectRatio,
+    source: image.source
+  };
+}
+async function waitForReadyImage(deps, imageId, timeoutMs = publishTimeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const image = await deps.get("/api/images/get", { id: imageId });
+    lastStatus = image.status ?? "unknown";
+    if (image.status === "ready") {
+      return image;
+    }
+    if (image.status === "error") {
+      throw new ApiError("IMAGE_PROCESSING_ERROR", "Creative image processing failed");
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Creative image was not ready before timeout; last status: ${lastStatus}`);
+}
+async function publishCreative(args, deps = defaultDeps) {
+  const title = args.title.trim();
+  if (!title) {
+    throw new ApiError("VALIDATION_ERROR", "--title is required");
+  }
+  const contentType = detectCreativeContentType(args.file);
+  const fileBuffer = await deps.readFile(args.file);
+  const uploadBody = {
+    base64: fileBuffer.toString("base64"),
+    contentType,
+    source: "ai_generated",
+    descriptionContext: args.context ?? `Static ad creative: ${title}`
+  };
+  const upload = await deps.post("/api/images/upload", uploadBody, {
+    timeoutMs: publishTimeoutMs
+  });
+  const readyImage = await waitForReadyImage(deps, upload.imageId);
+  await deps.post("/api/images/tag", {
+    imageIds: [upload.imageId],
+    addTags: [creativeTag],
+    removeTags: [],
+    title
+  });
+  const taggedImage = await deps.get("/api/images/get", { id: upload.imageId });
+  return { imageId: upload.imageId, reference: imageToCreativeReference({ ...readyImage, ...taggedImage }, title) };
+}
+var publishCommand = defineCommand85({
+  meta: {
+    name: "publish",
+    description: "Publish a final static creative image to Baker Images, deterministically tag it as creative, and print the image reference JSON."
+  },
+  args: {
+    file: { type: "positional", description: "Local PNG/JPG/WebP creative image path", required: false },
+    title: { type: "string", description: "Human title for the creative output", required: false },
+    context: { type: "string", description: "Optional describe context for the image row", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      const title = args.title;
+      if (!file) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Image path is required" } });
+        process.exit(1);
+      }
+      if (!title) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--title is required" } });
+        process.exit(1);
+      }
+      const data = await publishCreative({ file, title, context: args.context });
+      writeJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/creatives/index.ts
+var creativesCommand3 = defineCommand86({
+  meta: {
+    name: "creatives",
+    description: `Publish static ad creatives as first-class Baker outputs.
+
+Static creative handoff:
+  baker creatives publish ./canvas/run/final.png --title "Spring Offer Static Ad"
+
+Publishing uploads the image to the Company image library, applies the official creative tag, and returns an image reference for chat previews.`
+  },
+  subCommands: {
+    publish: publishCommand
+  }
+});
+
 // src/commands/ga4/index.ts
-import { defineCommand as defineCommand88 } from "citty";
+import { defineCommand as defineCommand90 } from "citty";
 
 // src/commands/ga4/audit.ts
-import { defineCommand as defineCommand85 } from "citty";
+import { defineCommand as defineCommand87 } from "citty";
 
 // src/commands/ga4/resolve.ts
 async function fetchProperties(useCache = true) {
@@ -11576,7 +11774,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var auditCommand2 = defineCommand85({
+var auditCommand2 = defineCommand87({
   meta: {
     name: "audit",
     description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
@@ -11628,7 +11826,7 @@ Examples:
 });
 
 // src/commands/ga4/properties.ts
-import { defineCommand as defineCommand86 } from "citty";
+import { defineCommand as defineCommand88 } 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.",
@@ -11636,7 +11834,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var propertiesCommand = defineCommand86({
+var propertiesCommand = defineCommand88({
   meta: {
     name: "properties",
     description: `List accessible GA4 properties.
@@ -11686,7 +11884,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 defineCommand89 } from "citty";
 
 // src/commands/ga4/presets.ts
 var GA4_PRESETS = [
@@ -11818,7 +12016,7 @@ function handleError(err) {
   });
   process.exit(1);
 }
-var queryCommand2 = defineCommand87({
+var queryCommand2 = defineCommand89({
   meta: {
     name: "query",
     description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
@@ -11889,7 +12087,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/ga4/index.ts
-var ga4Command = defineCommand88({
+var ga4Command = defineCommand90({
   meta: {
     name: "ga4",
     description: `Google Analytics 4 commands. Audit property config, run playbook-aligned reports.
@@ -11912,12 +12110,12 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-import { defineCommand as defineCommand92 } from "citty";
+import { defineCommand as defineCommand94 } 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 defineCommand91 } from "citty";
 
 // src/commands/gsc/presets.ts
 var GSC_PRESETS = [
@@ -12105,7 +12303,7 @@ function handleError2(err) {
   });
   process.exit(1);
 }
-var queryCommand3 = defineCommand89({
+var queryCommand3 = defineCommand91({
   meta: {
     name: "query",
     description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
@@ -12183,7 +12381,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/gsc/sitemaps.ts
-import { defineCommand as defineCommand90 } from "citty";
+import { defineCommand as defineCommand92 } from "citty";
 registerSchema({
   command: "gsc.sitemaps",
   description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
@@ -12192,7 +12390,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitemapsCommand = defineCommand90({
+var sitemapsCommand = defineCommand92({
   meta: {
     name: "sitemaps",
     description: `List sitemaps for a site. Check health and errors.
@@ -12242,7 +12440,7 @@ Examples:
 });
 
 // src/commands/gsc/sites.ts
-import { defineCommand as defineCommand91 } from "citty";
+import { defineCommand as defineCommand93 } from "citty";
 registerSchema({
   command: "gsc.sites",
   description: "List all verified Google Search Console sites. Returns site URLs needed for query and sitemaps commands.",
@@ -12250,7 +12448,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitesCommand = defineCommand91({
+var sitesCommand = defineCommand93({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -12298,7 +12496,7 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-var gscCommand = defineCommand92({
+var gscCommand = defineCommand94({
   meta: {
     name: "gsc",
     description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
@@ -12321,10 +12519,10 @@ Examples:
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand118 } from "citty";
 
 // src/commands/images/crop.ts
-import { defineCommand as defineCommand93 } from "citty";
+import { defineCommand as defineCommand95 } from "citty";
 
 // src/lib/image/crop-sprite.ts
 import sharp from "sharp";
@@ -12339,8 +12537,8 @@ 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 { dirname, extname, join as join3, resolve as resolve4 } from "path";
+import { glob as fsGlob, readFile as readFile8, rename, stat as stat2, writeFile as writeFile3 } from "fs/promises";
+import { dirname, extname as extname2, join as join3, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
 function isRemoteUrl(value) {
@@ -12375,7 +12573,7 @@ async function readImageBuffer(pathOrUrl) {
     }
     return Buffer.from(await response.arrayBuffer());
   }
-  return readFile7(pathOrUrl);
+  return readFile8(pathOrUrl);
 }
 async function isDirectory(path7) {
   try {
@@ -12386,7 +12584,7 @@ async function isDirectory(path7) {
   }
 }
 async function resolveOutputPath(inputPath, outputArg, options) {
-  const base = options.newExtension ? inputPath.slice(0, -extname(inputPath).length) + options.newExtension : inputPath;
+  const base = options.newExtension ? inputPath.slice(0, -extname2(inputPath).length) + options.newExtension : inputPath;
   if (!outputArg) return base;
   if (options.multipleInputs || await isDirectory(outputArg)) {
     const filename = base.split("/").pop() ?? "out.png";
@@ -12449,7 +12647,7 @@ function emitError2(err) {
   }
   process.exit(1);
 }
-var cropCommand = defineCommand93({
+var cropCommand = defineCommand95({
   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"
@@ -12485,7 +12683,7 @@ var cropCommand = defineCommand93({
 });
 
 // src/commands/images/delete.ts
-import { defineCommand as defineCommand94 } from "citty";
+import { defineCommand as defineCommand96 } from "citty";
 registerSchema({
   command: "images.delete",
   description: "Delete an image by ID",
@@ -12499,7 +12697,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand = defineCommand94({
+var deleteCommand = defineCommand96({
   meta: {
     name: "delete",
     description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run"
@@ -12540,7 +12738,7 @@ var deleteCommand = defineCommand94({
 });
 
 // src/commands/images/dimensions.ts
-import { defineCommand as defineCommand95 } from "citty";
+import { defineCommand as defineCommand97 } from "citty";
 
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
@@ -12563,7 +12761,7 @@ registerSchema({
     target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
   }
 });
-var dimensionsCommand = defineCommand95({
+var dimensionsCommand = defineCommand97({
   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"
@@ -12607,7 +12805,7 @@ var dimensionsCommand = defineCommand95({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand96 } from "citty";
+import { defineCommand as defineCommand98 } from "citty";
 registerSchema({
   command: "images.extract",
   description: "Extract images from a URL via Firecrawl (formats: images).",
@@ -12623,7 +12821,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand96({
+var extractCommand = defineCommand98({
   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"
@@ -12661,7 +12859,7 @@ var extractCommand = defineCommand96({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand97 } from "citty";
+import { defineCommand as defineCommand99 } from "citty";
 registerSchema({
   command: "images.find",
   description: "Fanout image search: library first, then opted-in external providers.",
@@ -12693,7 +12891,7 @@ registerSchema({
     }
   }
 });
-var findCommand = defineCommand97({
+var findCommand = defineCommand99({
   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"
@@ -12739,8 +12937,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 readFile9 } from "fs/promises";
+import { defineCommand as defineCommand100 } from "citty";
 import sharp2 from "sharp";
 var GENERATE_TIMEOUT_MS = 18e4;
 var REFERENCE_MAX_EDGE = 1536;
@@ -12822,7 +13020,7 @@ async function resolveReferences(spec) {
     }
     let raw;
     try {
-      raw = await readFile8(entry);
+      raw = await readFile9(entry);
     } catch {
       throw new ApiError("VALIDATION_ERROR", `Reference file not found: ${entry}`);
     }
@@ -12836,7 +13034,7 @@ async function resolveReferences(spec) {
   }
   return out;
 }
-var generateCommand = defineCommand98({
+var generateCommand = defineCommand100({
   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]]'"
@@ -12888,7 +13086,7 @@ var generateCommand = defineCommand98({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand99 } from "citty";
+import { defineCommand as defineCommand101 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -12896,7 +13094,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand2 = defineCommand99({
+var getCommand2 = defineCommand101({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -12932,7 +13130,7 @@ var getCommand2 = defineCommand99({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand100 } from "citty";
+import { defineCommand as defineCommand102 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -12964,7 +13162,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand100({
+var gifCommand = defineCommand102({
   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"
@@ -13011,7 +13209,7 @@ var gifCommand = defineCommand100({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand101 } from "citty";
+import { defineCommand as defineCommand103 } from "citty";
 registerSchema({
   command: "images.google",
   description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
@@ -13047,7 +13245,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand101({
+var googleCommand2 = defineCommand103({
   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"
@@ -13095,7 +13293,7 @@ var googleCommand2 = defineCommand101({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand102 } from "citty";
+import { defineCommand as defineCommand104 } from "citty";
 registerSchema({
   command: "images.icon",
   description: "Icon lookup via Iconify (200+ icon sets, free CDN).",
@@ -13121,7 +13319,7 @@ registerSchema({
     }
   }
 });
-var iconCommand = defineCommand102({
+var iconCommand = defineCommand104({
   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'"
@@ -13161,7 +13359,7 @@ var iconCommand = defineCommand102({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand103 } from "citty";
+import { defineCommand as defineCommand105 } from "citty";
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
@@ -13173,7 +13371,7 @@ registerSchema({
     context: { type: "string", description: "Description context hint", required: false }
   }
 });
-var ingestCommand = defineCommand103({
+var ingestCommand = defineCommand105({
   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"
@@ -13215,7 +13413,7 @@ var ingestCommand = defineCommand103({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand104 } from "citty";
+import { defineCommand as defineCommand106 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -13241,7 +13439,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand104({
+var libraryCommand = defineCommand106({
   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"
@@ -13298,7 +13496,7 @@ var libraryCommand = defineCommand104({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand105 } from "citty";
+import { defineCommand as defineCommand107 } from "citty";
 registerSchema({
   command: "images.logo",
   description: "Brand logo lookup via Brandfetch CDN (fallback/404). Auto-ingests by default.",
@@ -13323,7 +13521,7 @@ registerSchema({
     }
   }
 });
-var logoCommand = defineCommand105({
+var logoCommand = defineCommand107({
   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"
@@ -13361,7 +13559,7 @@ var logoCommand = defineCommand105({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand106 } from "citty";
+import { defineCommand as defineCommand108 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -14093,7 +14291,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand = defineCommand106({
+var normalizeCommand = defineCommand108({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -14148,7 +14346,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand107 } from "citty";
+import { defineCommand as defineCommand109 } 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.",
@@ -14168,7 +14366,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand107({
+var pinterestCommand = defineCommand109({
   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'"
@@ -14208,7 +14406,7 @@ var pinterestCommand = defineCommand107({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand108 } from "citty";
+import { defineCommand as defineCommand110 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -14224,7 +14422,7 @@ registerSchema({
     }
   }
 });
-var screenshotCommand = defineCommand108({
+var screenshotCommand = defineCommand110({
   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"
@@ -14274,7 +14472,7 @@ var screenshotCommand = defineCommand108({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand111 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -14290,7 +14488,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand109({
+var searchCommand = defineCommand111({
   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"
@@ -14350,7 +14548,7 @@ var searchCommand = defineCommand109({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -14382,7 +14580,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand110({
+var stickerCommand = defineCommand112({
   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"
@@ -14429,7 +14627,7 @@ var stickerCommand = defineCommand110({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand113 } from "citty";
 registerSchema({
   command: "images.stock",
   description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
@@ -14487,7 +14685,7 @@ registerSchema({
     }
   }
 });
-var stockCommand = defineCommand111({
+var stockCommand = defineCommand113({
   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"
@@ -14543,7 +14741,7 @@ var stockCommand = defineCommand111({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand114 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -14552,7 +14750,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand112({
+  return defineCommand114({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -14588,9 +14786,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 { extname as extname2 } from "path";
-import { defineCommand as defineCommand113 } from "citty";
+import { readFile as readFile10 } from "fs/promises";
+import { extname as extname3 } from "path";
+import { defineCommand as defineCommand115 } from "citty";
 var MIME_MAP = {
   ".png": "image/png",
   ".jpg": "image/jpeg",
@@ -14638,14 +14836,14 @@ function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
 function detectContentType(filePath) {
-  const ext = extname2(filePath).toLowerCase();
+  const ext = extname3(filePath).toLowerCase();
   const mime = MIME_MAP[ext];
   if (!mime) {
     throw new ApiError("VALIDATION_ERROR", `Cannot detect content type for extension "${ext}". Use --content-type.`);
   }
   return mime;
 }
-var uploadCommand = defineCommand113({
+var uploadCommand = defineCommand115({
   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'"
@@ -14728,7 +14926,7 @@ async function uploadLocal(target, args) {
     });
     return;
   }
-  const fileBuffer = await readFile9(target);
+  const fileBuffer = await readFile10(target);
   const base64 = fileBuffer.toString("base64");
   const body = { base64, contentType };
   if (args.source) body.source = args.source;
@@ -14738,7 +14936,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand114 } from "citty";
+import { defineCommand as defineCommand116 } 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).",
@@ -14753,7 +14951,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS3 = 1500;
-var upscaleCommand = defineCommand114({
+var upscaleCommand = defineCommand116({
   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"
@@ -14808,7 +15006,7 @@ var upscaleCommand = defineCommand114({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand115 } from "citty";
+import { defineCommand as defineCommand117 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -14824,7 +15022,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var useCommand = defineCommand115({
+var useCommand = defineCommand117({
   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"
@@ -14870,7 +15068,7 @@ var useCommand = defineCommand115({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand116({
+var imagesCommand = defineCommand118({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -14940,10 +15138,10 @@ Paid transforms (run on the Convex backend, cost-tracked):
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand129 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand119 } 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.";
@@ -15056,7 +15254,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand117({
+var advertisersCommand = defineCommand119({
   meta: {
     name: "advertisers",
     description: `Find domains competing for a keyword in Google SERPs.
@@ -15103,7 +15301,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand120 } 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).",
@@ -15126,7 +15324,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand118({
+var autocompleteCommand = defineCommand120({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -15172,7 +15370,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand121 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -15229,7 +15427,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand119({
+var countriesCommand = defineCommand121({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -15240,7 +15438,7 @@ var countriesCommand = defineCommand119({
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand120 } from "citty";
+import { defineCommand as defineCommand122 } 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.",
@@ -15263,7 +15461,7 @@ var FIELDS6 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand120({
+var intentCommand = defineCommand122({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -15311,7 +15509,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand121 } from "citty";
+import { defineCommand as defineCommand123 } 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.",
@@ -15340,7 +15538,7 @@ var FIELDS7 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand121({
+var keywordGapCommand = defineCommand123({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -15414,7 +15612,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand124 } 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.",
@@ -15447,7 +15645,7 @@ var FIELDS8 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand122({
+var keywordsForSiteCommand = defineCommand124({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -15500,7 +15698,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand125 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -15530,7 +15728,7 @@ var FIELDS9 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand123({
+var languagesCommand2 = defineCommand125({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -15541,7 +15739,7 @@ var languagesCommand2 = defineCommand123({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand126 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -15560,7 +15758,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 = defineCommand126({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -15598,7 +15796,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand127 } 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).",
@@ -15624,7 +15822,7 @@ var FIELDS11 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand125({
+var relevantPagesCommand = defineCommand127({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -15670,7 +15868,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand128 } 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).",
@@ -15721,7 +15919,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand126({
+var webCommand = defineCommand128({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -15781,7 +15979,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand127({
+var researchCommand = defineCommand129({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -15821,10 +16019,10 @@ Examples:
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand136 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand130 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -15929,7 +16127,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false }
   }
 });
-var createCommand2 = defineCommand128({
+var createCommand2 = defineCommand130({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -15977,7 +16175,7 @@ var createCommand2 = defineCommand128({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand131 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -15985,7 +16183,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand2 = defineCommand129({
+var deleteCommand2 = defineCommand131({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -16014,7 +16212,7 @@ var deleteCommand2 = defineCommand129({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand130 } from "citty";
+import { defineCommand as defineCommand132 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -16022,7 +16220,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var getCommand3 = defineCommand130({
+var getCommand3 = defineCommand132({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -16059,13 +16257,13 @@ var getCommand3 = defineCommand130({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand133 } 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 = defineCommand133({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set."
@@ -16086,7 +16284,7 @@ var listCommand3 = defineCommand131({
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand134 } 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.",
@@ -16094,7 +16292,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand132({
+var triggerCommand = defineCommand134({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -16131,7 +16329,7 @@ var triggerCommand = defineCommand132({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand133 } from "citty";
+import { defineCommand as defineCommand135 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -16156,7 +16354,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand2 = defineCommand133({
+var updateCommand2 = defineCommand135({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
@@ -16226,7 +16424,7 @@ var updateCommand2 = defineCommand133({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand134({
+var scheduledActionsCommand = defineCommand136({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger.
@@ -16252,8 +16450,8 @@ Examples:
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand135 } from "citty";
-var schemaCommand = defineCommand135({
+import { defineCommand as defineCommand137 } from "citty";
+var schemaCommand = defineCommand137({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -16289,10 +16487,10 @@ var schemaCommand = defineCommand135({
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand141 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -16300,7 +16498,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand4 = defineCommand136({
+var getCommand4 = defineCommand138({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -16337,7 +16535,7 @@ var getCommand4 = defineCommand136({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand137 } from "citty";
+import { defineCommand as defineCommand139 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -16367,7 +16565,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand4 = defineCommand137({
+var listCommand4 = defineCommand139({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -16416,7 +16614,7 @@ var listCommand4 = defineCommand137({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand138 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 registerSchema({
   command: "testimonials.search",
   description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
@@ -16447,7 +16645,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand2 = defineCommand138({
+var searchCommand2 = defineCommand140({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -16521,7 +16719,7 @@ var searchCommand2 = defineCommand138({
 var tagsCommand3 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand139({
+var testimonialsCommand = defineCommand141({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -16542,10 +16740,10 @@ Examples:
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -16559,7 +16757,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand140({
+var deleteCommand3 = defineCommand142({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -16600,7 +16798,7 @@ var deleteCommand3 = defineCommand140({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -16608,7 +16806,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand5 = defineCommand141({
+var getCommand5 = defineCommand143({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -16645,7 +16843,7 @@ var getCommand5 = defineCommand141({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -16655,7 +16853,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand3 = defineCommand142({
+var searchCommand3 = defineCommand144({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -16705,9 +16903,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 { extname as extname3 } from "path";
-import { defineCommand as defineCommand143 } from "citty";
+import { readFile as readFile11, stat as stat3 } from "fs/promises";
+import { extname as extname4 } from "path";
+import { defineCommand as defineCommand145 } from "citty";
 var MIME_MAP2 = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -16734,14 +16932,14 @@ registerSchema({
   }
 });
 function detectContentType2(filePath) {
-  const ext = extname3(filePath).toLowerCase();
+  const ext = extname4(filePath).toLowerCase();
   const mime = MIME_MAP2[ext];
   if (!mime) {
     throw new ApiError("VALIDATION_ERROR", `Cannot detect content type for extension "${ext}". Use --content-type.`);
   }
   return mime;
 }
-var uploadCommand2 = defineCommand143({
+var uploadCommand2 = defineCommand145({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -16770,7 +16968,7 @@ var uploadCommand2 = defineCommand143({
         return;
       }
       const { uploadUrl, videoId } = await apiPost("/api/videos/upload", {});
-      const fileBuffer = await readFile10(filePath);
+      const fileBuffer = await readFile11(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -16795,7 +16993,7 @@ var uploadCommand2 = defineCommand143({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand144({
+var videosCommand = defineCommand146({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
@@ -16818,10 +17016,10 @@ Examples:
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand147 } 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).",
@@ -16834,7 +17032,7 @@ registerSchema({
 function identity(record) {
   return record;
 }
-var advertisersCommand2 = defineCommand145({
+var advertisersCommand2 = defineCommand147({
   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'
@@ -16885,7 +17083,7 @@ var advertisersCommand2 = defineCommand145({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand148 } 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.",
@@ -16993,7 +17191,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand146({
+var searchCommand4 = defineCommand148({
   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"
@@ -17105,7 +17303,7 @@ var searchCommand4 = defineCommand146({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand147({
+var winningAdsCommand = defineCommand149({
   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.
@@ -17145,7 +17343,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand148({
+var main = defineCommand150({
   meta: {
     name: "baker",
     version: getCliVersion(),
@@ -17164,6 +17362,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     ga4: ga4Command,
     gsc: gscCommand,
     research: researchCommand,
+    creatives: creativesCommand3,
     images: imagesCommand,
     videos: videosCommand,
     testimonials: testimonialsCommand,