@koda-sl/baker-cli 0.394.0 → 0.395.0

package/dist/{chunk-F56XWRCY.js → chunk-EEHNRAFA.js}

@@ -2,13 +2,13 @@ import {
   handleConnectionError,
   needsConnectionFix,
   writeAdsJson
-} from "./chunk-ZPQ7L33H.js";
+} from "./chunk-QP7637HG.js";
 import {
   ApiError
-} from "./chunk-CEVZG46B.js";
+} from "./chunk-Q7RQ3H6Y.js";
 import {
   getEnv
-} from "./chunk-53ATKV76.js";
+} from "./chunk-BRIJ4OWT.js";
 
 // src/commands/ads/meta/shared.ts
 var DAY_MS = 864e5;
@@ -133,4 +133,4 @@ export {
   resolveEffectiveStatus,
   statusFilterHints
 };
-//# sourceMappingURL=chunk-F56XWRCY.js.map
+//# sourceMappingURL=chunk-EEHNRAFA.js.map

package/dist/{chunk-VTLHR3BB.js → chunk-LHJ5IXBN.js}

@@ -1,7 +1,7 @@
 import {
   debugLogHttp,
   readBodyForLog
-} from "./chunk-S35KWGIQ.js";
+} from "./chunk-ZWMATKNS.js";
 import {
   API_KEY_FORMAT_MESSAGE,
   DIRECT_ROUTE,
@@ -18,7 +18,7 @@ import {
   refuseNonPublicUrl,
   requireConnection,
   shouldEscalate
-} from "./chunk-53ATKV76.js";
+} from "./chunk-BRIJ4OWT.js";
 
 // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
@@ -11565,4 +11565,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-VTLHR3BB.js.map
+//# sourceMappingURL=chunk-LHJ5IXBN.js.map

package/dist/{chunk-CEVZG46B.js → chunk-Q7RQ3H6Y.js}

@@ -1,10 +1,10 @@
 import {
   debugLogHttp,
   readBodyForLog
-} from "./chunk-S35KWGIQ.js";
+} from "./chunk-ZWMATKNS.js";
 import {
   getEnv
-} from "./chunk-53ATKV76.js";
+} from "./chunk-BRIJ4OWT.js";
 
 // src/client.ts
 var MAX_RATE_LIMIT_RETRIES = 3;
@@ -208,4 +208,4 @@ export {
   apiGet,
   apiPost
 };
-//# sourceMappingURL=chunk-CEVZG46B.js.map
+//# sourceMappingURL=chunk-Q7RQ3H6Y.js.map

package/dist/{chunk-ZPQ7L33H.js → chunk-QP7637HG.js}

@@ -1,10 +1,10 @@
 import {
   ApiError,
   apiGet
-} from "./chunk-CEVZG46B.js";
+} from "./chunk-Q7RQ3H6Y.js";
 import {
   getEnv
-} from "./chunk-53ATKV76.js";
+} from "./chunk-BRIJ4OWT.js";
 
 // src/error-handler.ts
 var REQUEST_CONNECTION_PLATFORM = {
@@ -298,4 +298,4 @@ export {
   writeAdsOutput,
   resolveCustomerId
 };
-//# sourceMappingURL=chunk-ZPQ7L33H.js.map
+//# sourceMappingURL=chunk-QP7637HG.js.map

package/dist/{chunk-S35KWGIQ.js → chunk-ZWMATKNS.js}

@@ -1,6 +1,6 @@
 import {
   debugLogSetting
-} from "./chunk-53ATKV76.js";
+} from "./chunk-BRIJ4OWT.js";
 
 // src/debugLog.ts
 import { appendFileSync, mkdirSync, renameSync, statSync } from "fs";
@@ -173,4 +173,4 @@ export {
   readBodyForLog,
   installStreamTaps
 };
-//# sourceMappingURL=chunk-S35KWGIQ.js.map
+//# sourceMappingURL=chunk-ZWMATKNS.js.map

package/dist/cli.js

@@ -98,7 +98,7 @@ import {
   withoutCastName,
   wordCount,
   ytDlpBlockSignal
-} from "./chunk-VTLHR3BB.js";
+} from "./chunk-LHJ5IXBN.js";
 import {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -109,7 +109,7 @@ import {
   resolveEffectiveStatus,
   statusFilterHints,
   todayIso
-} from "./chunk-F56XWRCY.js";
+} from "./chunk-EEHNRAFA.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -125,19 +125,19 @@ import {
   writeAdsJson,
   writeAdsOutput,
   writeJsonEnvelope
-} from "./chunk-ZPQ7L33H.js";
+} from "./chunk-QP7637HG.js";
 import {
   ApiError,
   apiGet,
   apiGetWithHeaders,
   apiPost,
   validateConvexId
-} from "./chunk-CEVZG46B.js";
+} from "./chunk-Q7RQ3H6Y.js";
 import {
   installExitRecord,
   installStreamTaps,
   logInvocation
-} from "./chunk-S35KWGIQ.js";
+} from "./chunk-ZWMATKNS.js";
 import {
   __commonJS,
   __esm,
@@ -172,7 +172,7 @@ import {
   winningAdNormalizer,
   writeJson,
   writeOutput
-} from "./chunk-53ATKV76.js";
+} from "./chunk-BRIJ4OWT.js";
 
 // ../../node_modules/.pnpm/i18n-iso-countries@7.14.0/node_modules/i18n-iso-countries/langs/af.json
 var require_af = __commonJS({
@@ -22058,6 +22058,67 @@ var winnersHardFiltersSchema = z2.object({
   first_seen_after: z2.string().optional(),
   first_seen_before: z2.string().optional()
 });
+var firstSeenBoundSchema = z2.union([z2.iso.date(), z2.iso.datetime({ offset: true })], {
+  error: "first_seen_after/first_seen_before must be an ISO date (2026-01-01) or datetime (2026-01-01T00:00:00Z)"
+}).transform((value2) => new Date(value2.length === 10 ? `${value2}T00:00:00Z` : value2).toISOString());
+var adFormatSchema = z2.enum(["video", "static", "carousel"]);
+var winnerCategorySchema = z2.enum([
+  "winner",
+  "grand_slam_winner",
+  "scaled_winner",
+  "low_profile_winner",
+  "rising",
+  "evergreen",
+  "low_traction_dud",
+  "thrash_iteration",
+  "thrash_family",
+  "false_winner",
+  "untested",
+  "dud"
+]);
+var awarenessStageSchema = z2.enum([
+  "unaware",
+  "problem_aware",
+  "solution_aware",
+  "product_aware",
+  "most_aware"
+]);
+var staticFormatPatternSchema = z2.enum([
+  "clean_product",
+  "lifestyle_photo",
+  "headline_card",
+  "infographic",
+  "chat_screenshot",
+  "tweet_screenshot",
+  "review_screenshot",
+  "before_after_split",
+  "comparison_table",
+  "list_card",
+  "meme_template",
+  "native_post_lookalike",
+  "stock_photo_overlay",
+  "founder_portrait",
+  "testimonial_quote",
+  "packshot_minimalist",
+  "four_panel_lifestyle_grid",
+  "two_panel_split",
+  "notes_app_screenshot",
+  "founder_letter_textonly",
+  "us_vs_them_grid",
+  "benefit_callout_grid",
+  "create_your_own_adventure_meme",
+  "quad_split",
+  "stories_style_casual_static"
+]);
+var validatedHardFiltersSchema = winnersHardFiltersSchema.extend({
+  platform: z2.array(adLibraryPlatformSchema).optional(),
+  format: z2.array(adFormatSchema).optional(),
+  winner_category: z2.array(winnerCategorySchema).optional(),
+  awareness_stage: z2.array(awarenessStageSchema).optional(),
+  static_format_patterns: z2.array(staticFormatPatternSchema).optional(),
+  first_seen_after: firstSeenBoundSchema.optional(),
+  first_seen_before: firstSeenBoundSchema.optional()
+});
 var winnersSearchFields = z2.object({
   free_text_query: z2.string().max(500).optional(),
   ref_ad_id: z2.string().optional(),
@@ -22082,7 +22143,7 @@ var hasSearchInput = (b) => b.free_text_query !== void 0 || b.ref_ad_id !== void
 var SEARCH_INPUT_MESSAGE = "Provide free_text_query, ref_ad_id, or hard_filters";
 var winnersSearchRequestSchema = winnersSearchFields.refine(hasSearchInput, { message: SEARCH_INPUT_MESSAGE });
 var winnerSearchScopeSchema = z2.enum(["all", "followed", "followed-first"]);
-var scopedWinnersSearchRequestSchema = winnersSearchFields.extend({ scope: winnerSearchScopeSchema.optional() }).refine(hasSearchInput, { message: SEARCH_INPUT_MESSAGE }).refine((b) => b.scope !== "followed-first" || !b.offset, {
+var scopedWinnersSearchRequestSchema = winnersSearchFields.extend({ scope: winnerSearchScopeSchema.optional(), hard_filters: validatedHardFiltersSchema.optional() }).refine(hasSearchInput, { message: SEARCH_INPUT_MESSAGE }).refine((b) => b.scope !== "followed-first" || !b.offset, {
   message: "offset is not supported with scope followed-first; raise limit instead"
 });
 var winningAdDnaSchema = z2.object({
@@ -22092,6 +22153,10 @@ var winningAdDnaSchema = z2.object({
   audience_temperature: z2.string().nullable(),
   target_persona: z2.string().nullable(),
   hook_archetype: z2.string().nullable(),
+  // The proven hook pattern (`winning-ads hooks` seed) the free-text
+  // `hook_archetype` matches: the value two ads can share. Optional while an
+  // older ad-dna does not send it.
+  hook_seed: z2.string().nullable().optional(),
   creator_type: z2.string().nullable(),
   industry: z2.string().nullable(),
   business_model: z2.string().nullable(),
@@ -22121,6 +22186,9 @@ var winningAdSchema = z2.object({
   // How proven in-market (global creative strength).
   winner_score: z2.number().nullable(),
   winner_category: z2.string().nullable(),
+  // The score ad-dna ranked the result by (relevance blended with winner
+  // score, or the winner score on a browse). Search results only.
+  final_score: z2.number().nullable().optional(),
   days_active: z2.number().nullable(),
   reach: z2.number().nullable(),
   active: z2.boolean().nullable(),
@@ -53375,10 +53443,10 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     }
   },
   run: async ({ args: args8 }) => {
-    const { apiPost: apiPost2 } = await import("./client-ST4W3WRE.js");
-    const { requireChatId: requireChatId2 } = await import("./env-HQWFIYZF.js");
-    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-BTGDLTVL.js");
-    const { handleMetaError: handleMetaError2 } = await import("./shared-KLQWQWPJ.js");
+    const { apiPost: apiPost2 } = await import("./client-4P6U75EX.js");
+    const { requireChatId: requireChatId2 } = await import("./env-LJHSZSNA.js");
+    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-HVBFJX4I.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-7ZEF4DIX.js");
     try {
       const accountId = bareAccountId2(args8);
       const urlTags = typeof args8["url-tags"] === "string" ? args8["url-tags"] : void 0;
@@ -53529,10 +53597,10 @@ function duplicateCommand2(entity, label) {
       replace: { type: "boolean", description: "Pause the original once the copy publishes" }
     },
     run: async ({ args: args8 }) => {
-      const { apiPost: apiPost2 } = await import("./client-ST4W3WRE.js");
-      const { requireChatId: requireChatId2 } = await import("./env-HQWFIYZF.js");
-      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-BTGDLTVL.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-KLQWQWPJ.js");
+      const { apiPost: apiPost2 } = await import("./client-4P6U75EX.js");
+      const { requireChatId: requireChatId2 } = await import("./env-LJHSZSNA.js");
+      const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-HVBFJX4I.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-7ZEF4DIX.js");
       try {
         const accountId = bareAccountId2(args8);
         const chatId = requireChatId2();
@@ -98604,7 +98672,7 @@ var patternsCommand = defineCommand267({
 import { defineCommand as defineCommand268 } 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.",
+  description: "Search the ad-dna corpus of scored winning ads. Returns a lean shortlist (advertiser, summary, scores, media_url, and visual/container/mechanism when known) to pick a reference to reproduce. A value outside a closed list (--platform, --format, --winner-category, --awareness, --format-pattern) is refused with error.fix.validValues.",
   args: {
     query: { type: "string", description: "Free-text natural-language query", required: false },
     scope: {
@@ -98621,7 +98689,7 @@ registerSchema({
     limit: { type: "number", description: "Max results 1-100 (default 10)", required: false, default: 10 },
     "max-per-advertiser": {
       type: "number",
-      description: "Cap results per advertiser 1-50 (default 3)",
+      description: "Cap results per advertiser 0-50 (default 3; 0 = no cap), also when the company follows one brand",
       required: false,
       default: 3
     },
@@ -98655,17 +98723,17 @@ registerSchema({
     },
     "exclude-advertiser": {
       type: "string",
-      description: "Drop these advertiser ids \u2014 your own brand + already-used references",
+      description: "Drop these advertiser ids, usually your own brand (a reused ad is marked already_adapted instead)",
       required: false
     },
     "first-seen-after": {
       type: "string",
-      description: "ISO datetime; only ads first seen after this",
+      description: "ISO date (2026-01-01) or datetime; only ads first seen after this",
       required: false
     },
     "first-seen-before": {
       type: "string",
-      description: "ISO datetime; only ads first seen before this",
+      description: "ISO date (2026-01-01) or datetime; only ads first seen before this",
       required: false
     },
     "hook-archetype": {
@@ -98782,17 +98850,68 @@ function reportSearchError(err) {
   }
   reportError2(err);
 }
-function rejectWith(message) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
+var FLAG_FOR_FIELD = {
+  limit: "--limit",
+  max_per_advertiser: "--max-per-advertiser",
+  min_relevance: "--min-relevance",
+  platform: "--platform",
+  format: "--format",
+  winner_category: "--winner-category",
+  awareness_stage: "--awareness",
+  static_format_patterns: "--format-pattern",
+  first_seen_after: "--first-seen-after",
+  first_seen_before: "--first-seen-before"
+};
+function flagFor(path57) {
+  const field = String(path57[0] === "hard_filters" ? path57[1] : path57[0]);
+  return FLAG_FOR_FIELD[field] ?? field;
 }
-function rejectInvalidSearch(args8, body) {
+function schemaRejection(body) {
+  const parsed = scopedWinnersSearchRequestSchema.safeParse(body, { reportInput: true });
+  if (parsed.success) {
+    return null;
+  }
+  const [first] = parsed.error.issues;
+  if (!first) {
+    return { message: "Invalid search" };
+  }
+  const flag = flagFor(first.path);
+  if (first.code === "invalid_value") {
+    const sameFlag = parsed.error.issues.filter((i) => i.code === "invalid_value" && flagFor(i.path) === flag);
+    const invalidValues = sameFlag.map((i) => String(i.input));
+    const validValues = first.values.map(String);
+    return {
+      message: `Unknown ${flag} value${invalidValues.length > 1 ? "s" : ""} ${invalidValues.map((v) => `"${v}"`).join(", ")}.`,
+      fix: {
+        action: "retry_with_valid_values",
+        explanation: `Re-run with values from \`validValues\` for ${flag}, or drop the flag.`,
+        flag,
+        invalidValues,
+        validValues
+      }
+    };
+  }
+  return { message: first.path.length > 0 ? `${flag}: ${first.message}` : first.message };
+}
+var NUMERIC_FLAGS = [
+  ["--limit", "limit"],
+  ["--max-per-advertiser", "maxPerAdvertiser"],
+  ["--min-relevance", "minRelevance"]
+];
+function searchRejection(args8, body) {
   if (args8.scope !== void 0 && !winnerSearchScopeSchema.safeParse(args8.scope).success) {
-    rejectWith(`Unknown --scope "${args8.scope}". Use one of: ${winnerSearchScopeSchema.options.join(", ")}.`);
+    return { message: `Unknown --scope "${args8.scope}". Use one of: ${winnerSearchScopeSchema.options.join(", ")}.` };
+  }
+  for (const [flag, key] of NUMERIC_FLAGS) {
+    const value2 = args8[key];
+    if (value2 !== void 0 && value2 !== "" && Number.isNaN(Number(value2))) {
+      return { message: `${flag} must be a number, got "${value2}".` };
+    }
   }
   if (!("free_text_query" in body || "ref_ad_id" in body || "hard_filters" in body)) {
-    rejectWith("Provide a query, --ref-ad-id, or a filter flag");
+    return { message: "Provide a query, --ref-ad-id, or a filter flag" };
   }
+  return schemaRejection(body);
 }
 function writeSearchResult(data, opts) {
   const rawResults = Array.isArray(data?.results) ? data.results : [];
@@ -98817,6 +98936,7 @@ function writeSearchResult(data, opts) {
   }
   writeOutput({ ok: true, data: rawResults, ...withHints2 }, opts.output, opts.fields, opts.full, winningAdNormalizer);
 }
+var SEARCH_TIMEOUT_MS = 12e4;
 var searchCommand5 = defineCommand268({
   meta: {
     name: "search",
@@ -98838,7 +98958,7 @@ var searchCommand5 = defineCommand268({
     },
     "max-per-advertiser": {
       type: "string",
-      description: "Cap results per advertiser 1-50 (default 3)",
+      description: "Cap results per advertiser 0-50 (default 3; 0 = no cap), also when the company follows one brand",
       required: false
     },
     "min-relevance": { type: "string", description: "Relevance floor 0-1", required: false },
@@ -98863,11 +98983,11 @@ var searchCommand5 = defineCommand268({
     "advertiser-id": { type: "string", description: "Restrict to these advertiser ids", required: false },
     "exclude-advertiser": {
       type: "string",
-      description: "Drop these advertiser ids (your own + already-used)",
+      description: "Drop these advertiser ids, usually your own brand",
       required: false
     },
-    "first-seen-after": { type: "string", description: "ISO datetime lower bound", required: false },
-    "first-seen-before": { type: "string", description: "ISO datetime upper bound", required: false },
+    "first-seen-after": { type: "string", description: "ISO date or datetime lower bound", required: false },
+    "first-seen-before": { type: "string", description: "ISO date or datetime upper bound", required: false },
     "hook-archetype": {
       type: "string",
       description: "Comma list of proven hook seeds (from `winning-ads hooks`) to narrow the search",
@@ -98888,7 +99008,7 @@ var searchCommand5 = defineCommand268({
     fields: { type: "string", description: "Comma-separated field names to include", required: false },
     full: {
       type: "boolean",
-      description: "Include DNA detail (angle, persona, hook) + longevity",
+      description: "Include DNA detail (angle, persona, hook) + longevity; mechanism is in the default output",
       required: false,
       default: false
     }
@@ -98917,8 +99037,14 @@ var searchCommand5 = defineCommand268({
         diverse: args8.diverse
       };
       const body = buildSearchBody2(searchArgs);
-      rejectInvalidSearch(searchArgs, body);
-      const data = await apiPost("/api/ad-library/winners/search", body);
+      const rejection = searchRejection(searchArgs, body);
+      if (rejection) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", ...rejection } });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/ad-library/winners/search", body, {
+        timeoutMs: SEARCH_TIMEOUT_MS
+      });
       writeSearchResult(data, {
         output: args8.output || "json",
         fields: args8.fields ? args8.fields.split(",") : void 0,