@koda-sl/baker-cli 0.133.1 → 0.134.1

package/dist/cli.js

@@ -34,7 +34,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-Q4UI5JZN.js";
+} from "./chunk-CIF62V7L.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -73,7 +73,7 @@ import {
 } from "./chunk-RK67WL4O.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand171, runMain } from "citty";
+import { defineCommand as defineCommand172, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand18 } from "citty";
@@ -1023,6 +1023,30 @@ var advertiserWinnersResponseSchema = z2.object({
   advertiser_id: z2.string(),
   winners: z2.array(winningAdSchema)
 });
+var feedRequestSchema = z2.object({
+  // Optional subset of your followed advertiser ids to narrow to ("trim down
+  // per advertiser"). Ids you don't follow are ignored and echoed back in
+  // `unknown_requested`. Omit to browse winners across every brand you follow.
+  advertiser_ids: z2.array(z2.string()).optional(),
+  platform: adLibraryPlatformSchema.optional(),
+  winner_category: z2.array(z2.string()).optional(),
+  format: z2.array(z2.string()).optional(),
+  // Winners kept per advertiser so no single brand floods the feed. `0` = no
+  // cap. Default applied by the route.
+  per_advertiser: z2.number().int().min(0).max(50).optional(),
+  // Total winners returned across all followed advertisers.
+  limit: z2.number().int().min(1).max(200).optional()
+});
+var feedResponseSchema = z2.object({
+  winners: z2.array(winningAdSchema),
+  // How many brands the company follows (regardless of the trim).
+  following_count: z2.number(),
+  // The advertiser ids actually queried (follows ∩ requested subset).
+  advertiser_ids: z2.array(z2.string()),
+  // Requested ids that aren't followed — a hint the caller mistyped or hasn't
+  // followed them yet.
+  unknown_requested: z2.array(z2.string())
+});
 var briefRequestSchema = z2.object({
   // Partial DNA describing the target creative (all optional); the service
   // pulls its own strategically-similar references.
@@ -20631,20 +20655,6 @@ function parseBudget(raw) {
 }
 function resolveModels2(args) {
   const pick = (flag, kind, fallback) => args[flag] ? String(args[flag]) : resolveModel2(kind, fallback);
-  let videoModel;
-  let videoRouteReason;
-  if (args["video-model"]) {
-    videoModel = resolveModel2("video_generate", String(args["video-model"]));
-  } else {
-    const route = routeVideoModel({
-      hasRealFace: Boolean(args["real-face"]),
-      needsIdentity: Boolean(args.identity),
-      needsMotionTransfer: Boolean(args["motion-transfer"]),
-      budget: parseBudget(args.budget)
-    });
-    videoModel = resolveModel2("video_generate", route.model);
-    videoRouteReason = route.reason;
-  }
   return {
     // Flash by default: ~2-3× faster per call than Pro, which keeps each
     // per-scene deconstruct step well inside the action time budget and turns a
@@ -20655,11 +20665,29 @@ function resolveModels2(args) {
     // Default to the strongest image model (matches the static-ad scaffold); the
     // frame generators need the most faithful text/identity reproduction. Override
     // with --image-model for a cheaper/faster pass.
-    imageModel: pick("image-model", "image_generate", "openai/gpt-5.4-image-2"),
-    videoModel: videoModel || DEFAULT_VIDEO_GENERATE_MODEL,
-    videoRouteReason
+    imageModel: pick("image-model", "image_generate", "openai/gpt-5.4-image-2")
   };
 }
+function hasPhotorealCast(elements) {
+  return Array.isArray(elements) && elements.some((e) => {
+    const type = typeof e === "object" && e !== null ? e.type : void 0;
+    return type === "person" || type === "animal";
+  });
+}
+function resolveVideoModel(args, elements) {
+  if (args["video-model"]) {
+    return { videoModel: resolveModel2("video_generate", String(args["video-model"])) };
+  }
+  const photorealCast = hasPhotorealCast(elements);
+  const route = routeVideoModel({
+    hasRealFace: Boolean(args["real-face"]) || photorealCast,
+    needsIdentity: Boolean(args.identity),
+    needsMotionTransfer: Boolean(args["motion-transfer"]),
+    budget: parseBudget(args.budget)
+  });
+  const reason = photorealCast && !args["real-face"] ? `${route.reason} \u2014 detected a photoreal on-camera cast, which Seedance's real-person filter would block` : route.reason;
+  return { videoModel: resolveModel2("video_generate", route.model) || DEFAULT_VIDEO_GENERATE_MODEL, videoRouteReason: reason };
+}
 function buildDeconstructCanvas(videoPath, deconstructModel, opts) {
   const deconstructParams = { model: deconstructModel, mode: "full" };
   if (typeof opts.maxScenes === "number") deconstructParams.max_scenes = opts.maxScenes;
@@ -20780,7 +20808,7 @@ var scaffoldVideoCommand = defineCommand92({
     "video-model": { type: "string", description: "Override the video_generate model id for clips (skips the scored router)" },
     "real-face": {
       type: "boolean",
-      description: "Brief needs a real human likeness preserved \u2192 the router picks Veo (dodges the ByteDance real-person filter)."
+      description: "The ad has a photoreal human face on camera \u2192 the router picks Veo (dodges the ByteDance real-person filter). Set this for ANY photoreal presenter/creator/testimonial cast \u2014 the filter blocks AI-GENERATED photoreal faces too, not just real ones."
     },
     "motion-transfer": {
       type: "boolean",
@@ -20839,7 +20867,7 @@ var scaffoldVideoCommand = defineCommand92({
 `
       );
     }
-    const { deconstructModel, selectModel, imageModel, videoModel, videoRouteReason } = resolveModels2(args);
+    const { deconstructModel, selectModel, imageModel } = resolveModels2(args);
     const shotThreshold = args["shot-threshold"] ? Number(args["shot-threshold"]) : void 0;
     const shotCuts = await detectShotCutsBestEffort(videoPath, shotThreshold);
     const deconstructCanvas = buildDeconstructCanvas(videoPath, deconstructModel, {
@@ -20849,6 +20877,11 @@ var scaffoldVideoCommand = defineCommand92({
       shotCuts
     });
     const { blueprint, elements, transcript, creditsSpent } = await runAnalysisPasses(deconstructCanvas, selectModel);
+    const { videoModel, videoRouteReason } = resolveVideoModel(args, elements);
+    if (videoRouteReason && !args["video-model"] && !args["real-face"] && hasPhotorealCast(elements)) {
+      process.stderr.write(`\u{1F3AC} Photoreal on-camera cast detected \u2192 generating clips on ${videoModel} (dodges Seedance's real-person filter).
+`);
+    }
     await mkdir6(outDir, { recursive: true });
     const annotated = annotateBlueprintWithElements(blueprint, elements);
     await writeSceneFiles(outDir, annotated);
@@ -21018,12 +21051,12 @@ var scaffoldVideoCommand = defineCommand92({
             // on-brand color. The overlays inherit the reference's motion unless the
             // operator restyles easing/transition/accent from the brand's motion language.
             prompt_discipline: "Rewrite each scene with the six-decision structure (Route / Spec / Beats / Copy / Technique / Negatives): quote exact copy, give every beat a timestamp, and name the moves. Pull easing, transition (cut vs fade), pacing, and the accent moment from BRAND.md \xA7 Brand in Motion so the overlays move like THIS brand \u2014 not the reference's. If BRAND.md has no Brand-in-Motion section, seed it with brand-build first. See the creative-canvas-ads skill: references/prompt-anatomy.md + references/hyperframes/.",
-            // A photoreal on-camera person/animal on Seedance can trip ByteDance's
-            // real-person-likeness filter (422 content_policy_blocked, NON-retryable — no
-            // prompt reframe clears it). Surface the escape BEFORE the billed run so a
-            // face-heavy ad isn't discovered broken mid-render.
+            // Photoreal on-camera casts auto-route to Veo above, so this only fires
+            // when `--video-model bytedance/seedance-2.0` was EXPLICITLY forced despite
+            // a person/animal cast — overriding that safety route. Warn that every such
+            // clip will hit ByteDance's real-person filter and burn a wasted attempt.
             ...report.elements.some((e) => e.type === "person" || e.type === "animal") && /seedance/i.test(videoModel) ? {
-              content_policy_risk: "This ad has a photoreal on-camera cast generating on Seedance. ByteDance's real-person-likeness filter can reject a photoreal AI face with a NON-retryable 422 (content_policy_blocked) \u2014 no prompt change clears it. If clips fail that way, regenerate on Veo (re-run with `--video-model google/veo-3.1-fast`) or make the frame less photoreal."
+              content_policy_risk: "You FORCED Seedance (`--video-model bytedance/seedance-2.0`) on an ad with a photoreal on-camera cast. ByteDance's real-person filter will reject those clips (content_policy_blocked, E005) \u2014 no prompt change clears it. Each clip auto-recovers on Veo at render time so the run still completes, but you burn a wasted Seedance attempt per clip. Drop `--video-model` to let the scaffold route the cast to Veo up front, or make the frames less photorealistic."
             } : {},
             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."
           }
@@ -27249,7 +27282,7 @@ Examples:
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
 import { defineCommand as defineCommand161 } from "citty";
@@ -27444,8 +27477,145 @@ var briefCommand = defineCommand162({
   }
 });
 
-// src/commands/winning-ads/follow.ts
+// src/commands/winning-ads/feed.ts
 import { defineCommand as defineCommand163 } from "citty";
+function buildFeedParams(input) {
+  const params = {};
+  const advertiser = splitList(input.advertiser);
+  if (advertiser.length > 0) {
+    params.advertiser = advertiser.join(",");
+  }
+  if (input.platform) {
+    params.platform = input.platform;
+  }
+  if (input.perAdvertiser !== void 0 && input.perAdvertiser !== "") {
+    params.per_advertiser = input.perAdvertiser;
+  }
+  if (input.limit !== void 0 && input.limit !== "") {
+    params.limit = input.limit;
+  }
+  const winnerCategory = splitList(input.winnerCategory);
+  if (winnerCategory.length > 0) {
+    params.winner_category = winnerCategory.join(",");
+  }
+  const format = splitList(input.format);
+  if (format.length > 0) {
+    params.format = format.join(",");
+  }
+  return params;
+}
+registerSchema({
+  command: "winning-ads.feed",
+  description: "Winners across EVERY brand you follow, in one library. Start here to review your followed advertisers, then trim to specific ones with --advertiser. Capped per advertiser so no single brand floods the feed. Lean winner cards; add --full for DNA + longevity.",
+  args: {
+    advertiser: {
+      type: "string",
+      description: "Comma-separated followed advertiser ids to narrow to (from `following`). Omit for all follows.",
+      required: false
+    },
+    platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false },
+    "per-advertiser": {
+      type: "number",
+      description: "Max winners kept per advertiser 0-50 (0 = no cap, default 5)",
+      required: false,
+      default: 5
+    },
+    limit: {
+      type: "number",
+      description: "Total winners across all follows 1-200 (default 40)",
+      required: false,
+      default: 40
+    },
+    "winner-category": { type: "string", description: "Comma-separated winner categories to include", required: false },
+    format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
+  }
+});
+var feedCommand = defineCommand163({
+  meta: {
+    name: "feed",
+    description: "Winners across every brand you follow (browse, then trim per advertiser). Example: baker winning-ads feed --per-advertiser 5 --output md"
+  },
+  args: {
+    advertiser: {
+      type: "string",
+      description: "Comma-separated followed advertiser ids to narrow to",
+      required: false
+    },
+    platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false },
+    "per-advertiser": {
+      type: "string",
+      description: "Max winners per advertiser 0-50 (0 = no cap, default 5)",
+      required: false
+    },
+    limit: { type: "string", description: "Total winners 1-200 (default 40)", required: false },
+    "winner-category": { type: "string", description: "Comma-separated winner categories", required: false },
+    format: { type: "string", description: "Comma-separated formats", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: {
+      type: "boolean",
+      description: "Include DNA detail (angle, persona, hook) + longevity",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = buildFeedParams({
+        advertiser: args.advertiser,
+        platform: args.platform,
+        perAdvertiser: args["per-advertiser"],
+        limit: args.limit,
+        winnerCategory: args["winner-category"],
+        format: args.format
+      });
+      const data = await apiGet("/api/ad-library/feed", params);
+      const output = args.output || "json";
+      const full = args.full;
+      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];
+      const hints = [];
+      if ((data?.following_count ?? 0) === 0) {
+        hints.push(
+          'You don\'t follow any brands yet. Run `baker winning-ads follow "<domain>" --platform meta` first.'
+        );
+      }
+      if (Array.isArray(data?.unknown_requested) && data.unknown_requested.length > 0) {
+        hints.push(
+          `Not in your follows (skipped): ${data.unknown_requested.join(", ")}. Check ids with \`baker winning-ads following\`.`
+        );
+      }
+      if (output === "json") {
+        const winners = rawWinners.map((w) => winningAdNormalizer(w, full));
+        writeJson({
+          ok: true,
+          data: {
+            winners,
+            following_count: data?.following_count ?? 0,
+            advertiser_ids: Array.isArray(data?.advertiser_ids) ? data.advertiser_ids : [],
+            ...hints.length > 0 ? { hints } : {}
+          }
+        });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: rawWinners },
+        output,
+        args.fields ? args.fields.split(",") : void 0,
+        full,
+        winningAdNormalizer
+      );
+      for (const hint of hints) {
+        process.stderr.write(`${hint}
+`);
+      }
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+
+// src/commands/winning-ads/follow.ts
+import { defineCommand as defineCommand164 } from "citty";
 var PLATFORMS = ["meta", "linkedin"];
 registerSchema({
   command: "winning-ads.follow",
@@ -27460,7 +27630,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand163({
+var followCommand = defineCommand164({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks both Meta + LinkedIn. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -27507,7 +27677,7 @@ var followCommand = defineCommand163({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand164 } from "citty";
+import { defineCommand as defineCommand165 } from "citty";
 registerSchema({
   command: "winning-ads.following",
   description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts.",
@@ -27540,7 +27710,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand164({
+var followingCommand = defineCommand165({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
@@ -27575,7 +27745,7 @@ var followingCommand = defineCommand164({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand166 } from "citty";
 registerSchema({
   command: "winning-ads.patterns",
   description: "Mine what separates two cohorts of ads: pass a comma-list of winning ad ids (--winners) and a comma-list of weaker ad ids (--duds). Returns the discriminating DNA fields.",
@@ -27614,7 +27784,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand165({
+var patternsCommand = defineCommand166({
   meta: {
     name: "patterns",
     description: "Discover what separates winning ads from weak ones. Example: baker winning-ads patterns --winners a_1,a_2,a_3 --duds a_9,a_8 --output md"
@@ -27670,7 +27840,7 @@ var patternsCommand = defineCommand165({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand167 } 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.",
@@ -27778,7 +27948,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand166({
+var searchCommand4 = defineCommand167({
   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"
@@ -27893,7 +28063,7 @@ var searchCommand4 = defineCommand166({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand168 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -27921,7 +28091,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand167({
+  return defineCommand168({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -27970,7 +28140,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand169 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -27978,7 +28148,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand168({
+var unfollowCommand = defineCommand169({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -27999,7 +28169,7 @@ var unfollowCommand = defineCommand168({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand170 } from "citty";
 registerSchema({
   command: "winning-ads.winners",
   description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
@@ -28009,7 +28179,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand169({
+var winnersCommand = defineCommand170({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -28059,7 +28229,7 @@ var winnersCommand = defineCommand169({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand170({
+var winningAdsCommand = defineCommand171({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -28071,6 +28241,7 @@ Subcommands:
   baker winning-ads advertisers "<brand>"     \u2014 list corpus brands \u2192 advertiser ids (for --exclude-advertiser / --advertiser-id)
   baker winning-ads follow "<domain|url|brand>" --platform meta|linkedin   \u2014 add a brand's ads to your library
   baker winning-ads following                 \u2014 list brands you follow (status + counts)
+  baker winning-ads feed                      \u2014 winners across EVERY brand you follow; trim with --advertiser
   baker winning-ads winners <advertiser>      \u2014 top winners for one advertiser id
   baker winning-ads unfollow <advertiser>     \u2014 stop following a brand
   baker winning-ads brief                     \u2014 creative brief grounded in similar winners
@@ -28083,6 +28254,8 @@ Examples:
   baker winning-ads search "B2B SaaS before/after AI automation" --platform meta --format static --output md
   baker winning-ads advertisers "Acme" --output md
   baker winning-ads follow "deel.com" --platform meta
+  baker winning-ads feed --per-advertiser 5 --output md
+  baker winning-ads feed --advertiser adv_123,adv_456 --platform meta --output md
   baker winning-ads winners adv_123 --top 15 --output md
   baker winning-ads hooks --platform meta --awareness problem_aware --industry saas --output md
   baker winning-ads search "fintech onboarding" --hook-archetype callout --winner-category winner --output md
@@ -28093,6 +28266,7 @@ Examples:
     advertisers: advertisersCommand2,
     follow: followCommand,
     following: followingCommand,
+    feed: feedCommand,
     winners: winnersCommand,
     unfollow: unfollowCommand,
     brief: briefCommand,
@@ -28120,7 +28294,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand171({
+var main = defineCommand172({
   meta: {
     name: "baker",
     version: getCliVersion(),