@koda-sl/baker-cli 0.139.1 → 0.140.1

package/dist/cli.js

@@ -73,7 +73,7 @@ import {
 } from "./chunk-RK67WL4O.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand174, runMain } from "citty";
+import { defineCommand as defineCommand175, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand18 } from "citty";
@@ -1008,6 +1008,33 @@ var followResponseSchema = z2.object({
   preview: resolvePreviewSchema.nullable(),
   candidates: z2.array(corpusAdvertiserSchema).nullable()
 });
+var FOLLOW_BATCH_MAX = 50;
+var followBatchRequestSchema = z2.object({
+  // One entry per brand — a domain (best; resolves both Meta + LinkedIn), a
+  // profile / ad-library URL, or a brand name.
+  inputs: z2.array(z2.string().min(1)).min(1).max(FOLLOW_BATCH_MAX),
+  // How to read every input (not a tracking limit — a domain still resolves
+  // every platform we can). Defaults to reading inputs as Meta identities.
+  platform: adLibraryPlatformSchema.default("meta")
+});
+var followBatchResultSchema = z2.object({
+  // Echoes the input so the caller can line results up with what it sent.
+  input: z2.string(),
+  // "following"/"added" mirror the single-follow statuses; "ambiguous" needs a
+  // manual pick; "failed" = we couldn't resolve or add it (see `error`).
+  status: z2.enum(["following", "added", "ambiguous", "failed"]),
+  advertiser: followedAdvertiserSchema.nullable(),
+  // Present only when status is "failed" — a plain-language reason.
+  error: z2.string().nullable()
+});
+var followBatchResponseSchema = z2.object({
+  results: z2.array(followBatchResultSchema),
+  // Rollup counts across the batch for a one-glance summary.
+  followed_count: z2.number(),
+  added_count: z2.number(),
+  ambiguous_count: z2.number(),
+  failed_count: z2.number()
+});
 var unfollowRequestSchema = z2.object({
   // Accept either the Baker subscription id or the corpus advertiser id.
   followed_id: z2.string().optional(),
@@ -28017,7 +28044,7 @@ Examples:
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand174 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
 import { defineCommand as defineCommand163 } from "citty";
@@ -28411,8 +28438,116 @@ var followCommand = defineCommand166({
   }
 });
 
-// src/commands/winning-ads/following.ts
+// src/commands/winning-ads/follow-competitors.ts
 import { defineCommand as defineCommand167 } from "citty";
+var PLATFORMS2 = ["meta", "linkedin"];
+var BATCH_TIMEOUT_MS = 3e5;
+function buildFollowBatchBody(input) {
+  const seen = /* @__PURE__ */ new Set();
+  const inputs = [];
+  for (const domain of splitList(input.domains)) {
+    const key = domain.toLowerCase();
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    inputs.push(domain);
+  }
+  return { inputs, platform: input.platform ?? "meta" };
+}
+registerSchema({
+  command: "winning-ads.follow-competitors",
+  description: "Follow MANY brands at once \u2014 the fast way to add every competitor to your library. Pass a comma-separated list of domains (best \u2014 each resolves both Meta + LinkedIn, every country). One brand failing never blocks the others: the response reports per-brand status (following/added/ambiguous/failed) plus rollup counts. Ideal right after a competitor scan.",
+  args: {
+    domains: {
+      type: "string",
+      description: `Comma-separated domains (best), profile/ad-library URLs, or brand names \u2014 up to ${FOLLOW_BATCH_MAX}. e.g. "deel.com,notion.so,hubspot.com"`,
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: "meta|linkedin \u2014 how to read each input, not a tracking limit (default meta). Domains resolve both.",
+      required: false,
+      default: "meta"
+    }
+  }
+});
+var followCompetitorsCommand = defineCommand167({
+  meta: {
+    name: "follow-competitors",
+    description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
+  },
+  args: {
+    domains: {
+      type: "positional",
+      description: "Comma-separated domains (best), URLs, or brand names",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: "meta|linkedin \u2014 how to read each input, not a tracking limit (default meta).",
+      required: false,
+      default: "meta"
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const platform = String(args.platform ?? "meta");
+      if (!PLATFORMS2.includes(platform)) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "--platform must be one of: meta, linkedin" }
+        });
+        process.exit(1);
+      }
+      const body = buildFollowBatchBody({ domains: String(args.domains ?? ""), platform });
+      if (body.inputs.length === 0) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Pass at least one domain in --domains." }
+        });
+        process.exit(1);
+      }
+      if (body.inputs.length > FOLLOW_BATCH_MAX) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `Too many brands (${body.inputs.length}). Follow at most ${FOLLOW_BATCH_MAX} per call.`
+          }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/ad-library/follow-batch", body, {
+        timeoutMs: BATCH_TIMEOUT_MS
+      });
+      const hints = [];
+      if (data.failed_count > 0) {
+        const failed = data.results.filter((r) => r.status === "failed").map((r) => r.input);
+        hints.push(
+          `${data.failed_count} brand(s) couldn't be added: ${failed.join(", ")}. Retry each with its website or Facebook/LinkedIn URL via \`baker winning-ads follow\`.`
+        );
+      }
+      if (data.ambiguous_count > 0) {
+        const ambiguous = data.results.filter((r) => r.status === "ambiguous").map((r) => r.input);
+        hints.push(
+          `${data.ambiguous_count} brand(s) matched multiple advertisers: ${ambiguous.join(", ")}. Re-run \`baker winning-ads follow\` with an exact domain/URL to pick one.`
+        );
+      }
+      if (data.added_count > 0) {
+        hints.push(
+          "Newly added brands are ingesting now \u2014 their winners fill in over the next few minutes. Check `baker winning-ads following` or `baker winning-ads feed`."
+        );
+      }
+      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+
+// src/commands/winning-ads/following.ts
+import { defineCommand as defineCommand168 } 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.",
@@ -28445,7 +28580,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand167({
+var followingCommand = defineCommand168({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
@@ -28480,7 +28615,7 @@ var followingCommand = defineCommand167({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand169 } 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.",
@@ -28519,7 +28654,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand168({
+var patternsCommand = defineCommand169({
   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"
@@ -28575,7 +28710,7 @@ var patternsCommand = defineCommand168({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand170 } 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.",
@@ -28683,7 +28818,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand169({
+var searchCommand4 = defineCommand170({
   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"
@@ -28798,7 +28933,7 @@ var searchCommand4 = defineCommand169({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -28826,7 +28961,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand170({
+  return defineCommand171({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -28875,7 +29010,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -28883,7 +29018,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand171({
+var unfollowCommand = defineCommand172({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -28904,7 +29039,7 @@ var unfollowCommand = defineCommand171({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand173 } 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.",
@@ -28914,7 +29049,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand172({
+var winnersCommand = defineCommand173({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -28964,7 +29099,7 @@ var winnersCommand = defineCommand172({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand173({
+var winningAdsCommand = defineCommand174({
   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.
@@ -28975,6 +29110,7 @@ Subcommands:
   baker winning-ads search "<free text>"      \u2014 semantic search across the corpus; lean shortlist (advertiser, summary, scores, media_url)
   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 follow-competitors "<domain,domain,...>"   \u2014 add MANY brands at once (every competitor by domain)
   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
@@ -28989,6 +29125,7 @@ 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 follow-competitors "deel.com,notion.so,hubspot.com"
   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
@@ -29000,6 +29137,7 @@ Examples:
     search: searchCommand4,
     advertisers: advertisersCommand2,
     follow: followCommand,
+    "follow-competitors": followCompetitorsCommand,
     following: followingCommand,
     feed: feedCommand,
     winners: winnersCommand,
@@ -29029,7 +29167,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand174({
+var main = defineCommand175({
   meta: {
     name: "baker",
     version: getCliVersion(),