@koda-sl/baker-cli 0.94.0 → 0.95.1

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
 } from "./chunk-RCPMJKI7.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand143, runMain } from "citty";
+import { defineCommand as defineCommand144, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand13 } from "citty";
@@ -853,7 +853,7 @@ var linkCommand = defineCommand7({
 import { defineCommand as defineCommand8 } from "citty";
 registerSchema({
   command: "actions.list",
-  description: "List actions for the current company. Default: pre-bucketed (claimable/myClaims/blocked/claimedByOthers/completed/discarded). Set --bucketed=false for a flat list filterable by --status.",
+  description: "List actions for the current company. Default: pre-bucketed (claimable/myClaims/blocked/claimedByOthers/completed/discarded), each bucket ordered do-first (blockers before blocked, then highest-leverage). Set --bucketed=false for a flat list filterable by --status and orderable by --sort.",
   args: {
     bucketed: {
       type: "boolean",
@@ -865,6 +865,11 @@ registerSchema({
       type: "string",
       description: "Filter by status (only with --bucketed=false): pending|in_progress|completed|discarded",
       required: false
+    },
+    sort: {
+      type: "string",
+      description: "Order a flat list (only with --bucketed=false): priority (do-first: blockers before blocked, then highest-leverage) | recent. Default: priority.",
+      required: false
     }
   }
 });
@@ -875,7 +880,8 @@ var listCommand2 = defineCommand8({
   },
   args: {
     bucketed: { type: "boolean", description: "Pre-bucket by chat", required: false, default: true },
-    status: { type: "string", description: "Status filter (raw mode)", required: false }
+    status: { type: "string", description: "Status filter (raw mode)", required: false },
+    sort: { type: "string", description: "Order (raw mode): priority|recent", required: false }
   },
   run: async ({ args }) => {
     try {
@@ -889,6 +895,7 @@ var listCommand2 = defineCommand8({
         if (args.status) {
           body.status = args.status;
         }
+        body.sort = args.sort === "recent" ? "recent" : "priority";
       }
       const response = await apiPost("/api/actions/list", body);
       writeJson(response);
@@ -9096,7 +9103,8 @@ function buildElementSlots(elements) {
     "spine",
     "overlaid",
     "captions",
-    "captions_transcript",
+    "captions_premux",
+    "captions_transcribe",
     "audio_mix",
     "final",
     "music_bed"
@@ -9762,7 +9770,8 @@ function makePresenterPresent(slots, canonical, opts = {}) {
   };
 }
 var PAUSE_GAP_S = 0.6;
-var PHRASE_MAX_S = SEEDANCE_DURATIONS[SEEDANCE_DURATIONS.length - 1];
+var SEEDANCE_SAFE_MAX_S = SEEDANCE_DURATIONS.find((d) => d >= 10) ?? 10;
+var PHRASE_MAX_S = SEEDANCE_SAFE_MAX_S;
 function collapseVoiceover(blueprint) {
   const casts = castIdSet(blueprint);
   const cameraOn = onCameraDialogue(blueprint);
@@ -10564,22 +10573,8 @@ function scaffoldVideoCanvas(input, elementsInput, opts) {
     videoRef = "$ref:overlaid.video";
     videoNode = "overlaid";
   }
-  if (opts.captionsCompositionPath && opts.transcriptPath) {
-    nodes.push({
-      id: "captions_transcript",
-      type: "ingest",
-      params: { source: "path", path: opts.transcriptPath, expect: "json" }
-    });
-    nodes.push({
-      id: "captions",
-      type: "hyperframe_render",
-      inputs: { background: videoRef, transcript: "$ref:captions_transcript.asset" },
-      params: { composition: opts.captionsCompositionPath }
-    });
-    videoRef = "$ref:captions.video";
-    videoNode = "captions";
-  }
   const tracks = [...voTracks, ...buildSfxMusic(blueprint, nodes)];
+  let audioMixRef;
   if (tracks.length > 0) {
     const mixInputs = {};
     for (const t of tracks) mixInputs[t.slot] = t.ref;
@@ -10600,10 +10595,54 @@ function scaffoldVideoCanvas(input, elementsInput, opts) {
         ...duck
       }
     });
+    audioMixRef = "$ref:audio_mix.audio";
+  }
+  if (opts.captionsCompositionPath && audioMixRef) {
+    nodes.push({
+      id: "captions_premux",
+      type: "ffmpeg",
+      inputs: { video: videoRef, audio: audioMixRef },
+      params: {
+        args: [
+          "-i",
+          "{{in.video}}",
+          "-i",
+          "{{in.audio}}",
+          "-map",
+          "0:v:0",
+          "-map",
+          "1:a:0",
+          "-c:v",
+          "copy",
+          "-c:a",
+          "aac",
+          "-shortest",
+          "{{out.video}}"
+        ],
+        outputs: { video: { kind: "video", ext: "mp4" } }
+      }
+    });
+    const captionLanguage = deriveTtsLanguageCode(blueprint);
+    nodes.push({
+      id: "captions_transcribe",
+      type: "video_transcribe",
+      inputs: { video: "$ref:captions_premux.video" },
+      params: captionLanguage ? { language: captionLanguage } : {}
+    });
+    nodes.push({
+      id: "captions",
+      type: "hyperframe_render",
+      inputs: { background: videoRef, transcript: "$ref:captions_transcribe.transcript" },
+      params: { composition: opts.captionsCompositionPath }
+    });
+    videoRef = "$ref:captions.video";
+    videoNode = "captions";
+  }
+  if (audioMixRef) {
     nodes.push({
       id: "final",
       type: "ffmpeg",
-      inputs: { video: videoRef, audio: "$ref:audio_mix.audio" },
+      inputs: { video: videoRef, audio: audioMixRef },
       params: {
         args: [
           "-i",
@@ -10845,14 +10884,36 @@ function buildVideoTodo(report, overlayCount, floatingCount, opts, blueprint) {
     // "none detected" — re-watch the reference and fill the gaps with the right tool.
     completeness_check: 'The scaffold mirrors the deconstruct\'s catalog, which UNDER-DETECTS \u2014 never trust a 0 count. Re-watch the reference frame-by-frame and add anything missing: (1) ON-IMAGE GRAPHICS not in floating_elements (dollar/coin icons, emojis, checkmarks, rating stars, price tags, arrows, progress bars, app UI) \u2192 source each with `baker images icon "<desc>"` / `baker images sticker` / `baker images gif` / `baker images logo <domain>` and add it as an <img class="ov pos-* " data-start data-dur> in video-overlay-composition/index.html (NEVER bake graphics into the frame plates). (2) SOUND CUES not in sound_effects (cha-ching/coin, whoosh, ding, pop, notification, keyboard) \u2192 add a `sound_effect` node (eleven_text_to_sound) and wire it onto `audio_mix` at its timestamp. (3) RECURRING people/animals/products/logos/sets with no el_* slot \u2192 add an `ingest` [TODO] slot and reference it from the frames they appear in. (4) Burned-in captions/text not in text_overlays \u2192 add an <img>-free <div class="ov"> in index.html. (5) ONE person playing MULTIPLE personas/wardrobes (skeptic vs believer, before vs after, two outfits) collapsed into a single el_* slot \u2192 split into one el_* slot PER look, each linked as the SAME individual via `same_as` so every outfit has its own reference image but the face/identity stays identical.',
     scenes_clamped_to_15s: report.clamped_scenes,
+    oversize_scenes: report.oversize_scenes.length > 0 ? {
+      scenes: report.oversize_scenes,
+      fix: "Each listed scene's own footage is longer than the gateway-safe ~10s clip ceiling, so its clip will fail the gateway (HTTP 524) \u2014 and the scaffold can't auto-split a single scene. Split each into two scenes in prompt.json (scene N+1's start frame = scene N's end frame, so the action stays continuous) before rendering."
+    } : "none \u2014 every scene fits within the gateway-safe clip ceiling.",
+    overstuffed_scenes: report.overstuffed_scenes.length > 0 ? {
+      scenes: report.overstuffed_scenes,
+      fix: "Each listed scene's estimated speech runs well past its window \u2014 the line will overrun the scene and push the picture off the audio timeline (lips fall behind). Shorten the copy in prompt.json or lengthen the scene before rendering."
+    } : "none \u2014 every scene's spoken length fits its window.",
     run_warning: "`baker canvas run` generates many billed image/video/audio assets \u2014 validate first, it is not free."
   };
 }
+var OVERSTUFF_RATIO = 1.3;
+function collectClipAdvisories(scene, i, out) {
+  const round22 = (n) => Math.round(n * 100) / 100;
+  const original = scene.duration_s ?? 5;
+  if (original > 15) out.clamped.push({ scene: i, original_s: original, clip_s: snapToSeedance(original) });
+  const window = sceneDurationS(scene);
+  if (window > SEEDANCE_SAFE_MAX_S)
+    out.oversize.push({ scene: i, scene_s: round22(window), clip_s: ceilToSeedance(window) });
+  const speech = (scene.dialogue ?? []).reduce((s, line) => s + (line.line ? estSpeechS(line.line) : 0), 0);
+  if (speech > window * OVERSTUFF_RATIO)
+    out.overstuffed.push({ scene: i, scene_s: round22(window), est_speech_s: round22(speech) });
+}
 function videoReport(input, elementsInput) {
   const blueprint = VideoBlueprint.parse(input);
   const elements = RecurringElements.parse(elementsInput);
   const dialogue = [];
   const clamped = [];
+  const oversize = [];
+  const overstuffed = [];
   let sfxCount = 0;
   let overlayCount = 0;
   blueprint.scenes.forEach((scene, i) => {
@@ -10868,9 +10929,7 @@ function videoReport(input, elementsInput) {
     }
     sfxCount += (scene.sfx ?? []).length;
     overlayCount += (scene.overlays ?? []).length;
-    const original = scene.duration_s ?? 5;
-    const clip = snapToSeedance(original);
-    if (original > 15) clamped.push({ scene: i, original_s: original, clip_s: clip });
+    collectClipAdvisories(scene, i, { clamped, oversize, overstuffed });
   });
   return {
     scene_count: blueprint.scenes.length,
@@ -10885,6 +10944,8 @@ function videoReport(input, elementsInput) {
     sfx_count: sfxCount,
     overlay_count: overlayCount,
     clamped_scenes: clamped,
+    oversize_scenes: oversize,
+    overstuffed_scenes: overstuffed,
     has_music: Boolean(blueprint.global?.music?.music_prompt)
   };
 }
@@ -10950,12 +11011,9 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text = transcript?.trim();
   if (!text || text === "[]") return {};
-  const transcriptPath = path5.join(outDir, "transcript.json");
-  await writeFile2(transcriptPath, `${text}
-`, "utf8");
   const compositionPath = path5.join(outDir, "tiktok-captions-composition");
   await cp(SHIPPED_CAPTIONS_DIR, compositionPath, { recursive: true });
-  return { compositionPath, transcriptPath };
+  return { compositionPath };
 }
 function parseElements2(raw) {
   const parsed = JSON.parse(raw);
@@ -11161,7 +11219,6 @@ var scaffoldVideoCommand = defineCommand78({
       videoModel,
       overlayCompositionPath: compositionDest,
       captionsCompositionPath: captions.compositionPath,
-      transcriptPath: captions.transcriptPath,
       blueprintPath,
       frames,
       ambient: Boolean(args.ambient),
@@ -11214,6 +11271,8 @@ var scaffoldVideoCommand = defineCommand78({
             overlay_count: report.overlay_count,
             has_music: report.has_music,
             scenes_clamped_to_15s: report.clamped_scenes,
+            oversize_scenes: report.oversize_scenes,
+            overstuffed_scenes: report.overstuffed_scenes,
             note: "Drop ONE real source image at each el_* [TODO] (reused across every frame that element appears in), confirm each voice_select casting, then `baker canvas validate` and `baker canvas run`. Running generates many billed image/video/audio assets \u2014 it is not free."
           }
         },
@@ -12108,7 +12167,7 @@ Examples:
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 
 // src/commands/images/crop.ts
 import { defineCommand as defineCommand89 } from "citty";
@@ -14329,10 +14388,55 @@ var stockCommand = defineCommand107({
   }
 });
 
+// src/lib/tags-command.ts
+import { defineCommand as defineCommand108 } from "citty";
+function makeTagsCommand(command, label, endpoint) {
+  registerSchema({
+    command: `${command}.tags`,
+    description: `List the available ${label} tag taxonomy (built-in defaults + this company's custom tags).`,
+    args: {
+      output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
+    }
+  });
+  return defineCommand108({
+    meta: {
+      name: "tags",
+      description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
+    },
+    args: {
+      output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
+    },
+    run: async ({ args }) => {
+      try {
+        const { markdown } = await apiGet(endpoint);
+        if (args.output === "json") {
+          writeJson({ ok: true, data: { markdown } });
+          return;
+        }
+        process.stdout.write(`${markdown.trimEnd()}
+`);
+      } catch (err) {
+        const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+        const message = err instanceof ApiError ? err.message : "Unexpected error";
+        if (args.output === "json") {
+          writeJson({ ok: false, error: { code, message } });
+        } else {
+          process.stderr.write(`Error: ${message}
+`);
+        }
+        process.exit(1);
+      }
+    }
+  });
+}
+
+// src/commands/images/tags.ts
+var tagsCommand = 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 defineCommand108 } from "citty";
+import { defineCommand as defineCommand109 } from "citty";
 var MIME_MAP = {
   ".png": "image/png",
   ".jpg": "image/jpeg",
@@ -14387,7 +14491,7 @@ function detectContentType(filePath) {
   }
   return mime;
 }
-var uploadCommand = defineCommand108({
+var uploadCommand = defineCommand109({
   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'"
@@ -14480,7 +14584,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand110 } 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).",
@@ -14495,7 +14599,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS3 = 1500;
-var upscaleCommand = defineCommand109({
+var upscaleCommand = defineCommand110({
   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"
@@ -14550,7 +14654,7 @@ var upscaleCommand = defineCommand109({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand111 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -14566,7 +14670,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var useCommand = defineCommand110({
+var useCommand = defineCommand111({
   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"
@@ -14612,7 +14716,7 @@ var useCommand = defineCommand110({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand111({
+var imagesCommand = defineCommand112({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -14648,6 +14752,9 @@ Local transforms (operate on files in the sandbox, before upload):
                                                        Coordinate-based rectangular extract
   baker images dimensions <file-or-url>                Width / height / aspect / format without decoding the full image
 
+Taxonomy:
+  baker images tags                                    List available image tag names (defaults + company custom tags)
+
 Paid transforms (run on the Convex backend, cost-tracked):
   baker images upscale <imageId>                       Real-ESRGAN super-resolution ($0.05/image, waits for completion)`
   },
@@ -14673,15 +14780,16 @@ Paid transforms (run on the Convex backend, cost-tracked):
     normalize: normalizeCommand,
     crop: cropCommand,
     dimensions: dimensionsCommand,
-    upscale: upscaleCommand
+    upscale: upscaleCommand,
+    tags: tagsCommand
   }
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand123 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand113 } 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.";
@@ -14794,7 +14902,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand112({
+var advertisersCommand = defineCommand113({
   meta: {
     name: "advertisers",
     description: `Find domains competing for a keyword in Google SERPs.
@@ -14841,7 +14949,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand113 } from "citty";
+import { defineCommand as defineCommand114 } 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).",
@@ -14864,7 +14972,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand113({
+var autocompleteCommand = defineCommand114({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -14910,7 +15018,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand114 } from "citty";
+import { defineCommand as defineCommand115 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -14967,7 +15075,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand114({
+var countriesCommand = defineCommand115({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -14978,7 +15086,7 @@ var countriesCommand = defineCommand114({
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand115 } from "citty";
+import { defineCommand as defineCommand116 } 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.",
@@ -15001,7 +15109,7 @@ var FIELDS6 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand115({
+var intentCommand = defineCommand116({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -15049,7 +15157,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand117 } 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.",
@@ -15078,7 +15186,7 @@ var FIELDS7 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand116({
+var keywordGapCommand = defineCommand117({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -15152,7 +15260,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand118 } 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.",
@@ -15185,7 +15293,7 @@ var FIELDS8 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand117({
+var keywordsForSiteCommand = defineCommand118({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -15238,7 +15346,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand119 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -15268,7 +15376,7 @@ var FIELDS9 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand118({
+var languagesCommand2 = defineCommand119({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -15279,7 +15387,7 @@ var languagesCommand2 = defineCommand118({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand120 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -15298,7 +15406,7 @@ var FIELDS10 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand119({
+var lighthouseCommand = defineCommand120({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -15336,7 +15444,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand120 } from "citty";
+import { defineCommand as defineCommand121 } 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).",
@@ -15362,7 +15470,7 @@ var FIELDS11 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand120({
+var relevantPagesCommand = defineCommand121({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -15408,7 +15516,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand121 } from "citty";
+import { defineCommand as defineCommand122 } 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).",
@@ -15459,7 +15567,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand121({
+var webCommand = defineCommand122({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -15519,7 +15627,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand122({
+var researchCommand = defineCommand123({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -15559,10 +15667,10 @@ Examples:
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand130 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand124 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -15667,7 +15775,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false }
   }
 });
-var createCommand2 = defineCommand123({
+var createCommand2 = defineCommand124({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -15715,7 +15823,7 @@ var createCommand2 = defineCommand123({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand125 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -15723,7 +15831,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand2 = defineCommand124({
+var deleteCommand2 = defineCommand125({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -15752,7 +15860,7 @@ var deleteCommand2 = defineCommand124({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand126 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -15760,7 +15868,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var getCommand3 = defineCommand125({
+var getCommand3 = defineCommand126({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -15797,13 +15905,13 @@ var getCommand3 = defineCommand125({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand127 } from "citty";
 registerSchema({
   command: "scheduled-actions.list",
   description: "List published scheduled actions. Includes draft state when BAKER_CHAT_ID is set.",
   args: {}
 });
-var listCommand3 = defineCommand126({
+var listCommand3 = defineCommand127({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set."
@@ -15824,7 +15932,7 @@ var listCommand3 = defineCommand126({
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand128 } 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.",
@@ -15832,7 +15940,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand127({
+var triggerCommand = defineCommand128({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -15869,7 +15977,7 @@ var triggerCommand = defineCommand127({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand129 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -15894,7 +16002,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand2 = defineCommand128({
+var updateCommand2 = defineCommand129({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
@@ -15964,7 +16072,7 @@ var updateCommand2 = defineCommand128({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand129({
+var scheduledActionsCommand = defineCommand130({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger.
@@ -15990,8 +16098,8 @@ Examples:
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand130 } from "citty";
-var schemaCommand = defineCommand130({
+import { defineCommand as defineCommand131 } from "citty";
+var schemaCommand = defineCommand131({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -16027,10 +16135,10 @@ var schemaCommand = defineCommand130({
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand135 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand132 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -16038,7 +16146,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand4 = defineCommand131({
+var getCommand4 = defineCommand132({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -16075,7 +16183,7 @@ var getCommand4 = defineCommand131({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand133 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -16105,7 +16213,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand4 = defineCommand132({
+var listCommand4 = defineCommand133({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -16154,7 +16262,7 @@ var listCommand4 = defineCommand132({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand133 } from "citty";
+import { defineCommand as defineCommand134 } from "citty";
 registerSchema({
   command: "testimonials.search",
   description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
@@ -16185,7 +16293,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand2 = defineCommand133({
+var searchCommand2 = defineCommand134({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -16255,30 +16363,35 @@ var searchCommand2 = defineCommand133({
   }
 });
 
+// src/commands/testimonials/tags.ts
+var tagsCommand2 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
+
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand134({
+var testimonialsCommand = defineCommand135({
   meta: {
     name: "testimonials",
-    description: `Find and browse testimonials in Baker. Subcommands: search, get, list.
+    description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
 
 Examples:
   baker testimonials search "great customer service" --limit 5
   baker testimonials search "value for money" --rating-min 4
   baker testimonials get <testimonial-id>
-  baker testimonials list --source google --sentiment positive`
+  baker testimonials list --source google --sentiment positive
+  baker testimonials tags`
   },
   subCommands: {
     get: getCommand4,
     search: searchCommand2,
-    list: listCommand4
+    list: listCommand4,
+    tags: tagsCommand2
   }
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand135 } from "citty";
+import { defineCommand as defineCommand136 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -16292,7 +16405,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand135({
+var deleteCommand3 = defineCommand136({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -16333,7 +16446,7 @@ var deleteCommand3 = defineCommand135({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand137 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -16341,7 +16454,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand5 = defineCommand136({
+var getCommand5 = defineCommand137({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -16378,7 +16491,7 @@ var getCommand5 = defineCommand136({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand137 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -16388,7 +16501,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand3 = defineCommand137({
+var searchCommand3 = defineCommand138({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -16434,10 +16547,13 @@ var searchCommand3 = defineCommand137({
   }
 });
 
+// src/commands/videos/tags.ts
+var tagsCommand3 = 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 defineCommand138 } from "citty";
+import { defineCommand as defineCommand139 } from "citty";
 var MIME_MAP2 = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -16471,7 +16587,7 @@ function detectContentType2(filePath) {
   }
   return mime;
 }
-var uploadCommand2 = defineCommand138({
+var uploadCommand2 = defineCommand139({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -16525,31 +16641,33 @@ var uploadCommand2 = defineCommand138({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand139({
+var videosCommand = defineCommand140({
   meta: {
     name: "videos",
-    description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete.
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
 
 Examples:
   baker videos search "product demo" --limit 5
   baker videos search "tutorial" --tags explainer
   baker videos get <video-id>
   baker videos upload ./demo.mp4
-  baker videos delete <video-id> --dry-run`
+  baker videos delete <video-id> --dry-run
+  baker videos tags`
   },
   subCommands: {
     get: getCommand5,
     search: searchCommand3,
     upload: uploadCommand2,
-    delete: deleteCommand3
+    delete: deleteCommand3,
+    tags: tagsCommand3
   }
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand141 } 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).",
@@ -16562,7 +16680,7 @@ registerSchema({
 function identity(record) {
   return record;
 }
-var advertisersCommand2 = defineCommand140({
+var advertisersCommand2 = defineCommand141({
   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'
@@ -16613,7 +16731,7 @@ var advertisersCommand2 = defineCommand140({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand142 } 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.",
@@ -16721,7 +16839,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand141({
+var searchCommand4 = defineCommand142({
   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"
@@ -16833,7 +16951,7 @@ var searchCommand4 = defineCommand141({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand142({
+var winningAdsCommand = defineCommand143({
   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.
@@ -16873,7 +16991,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand143({
+var main = defineCommand144({
   meta: {
     name: "baker",
     version: getCliVersion(),