@koda-sl/baker-cli 0.457.0 → 0.458.0

package/dist/web-JRDXE2GL.js

@@ -0,0 +1,140 @@
+import {
+  webDepthHints
+} from "./chunk-XX5DXKEI.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-N3DLCXMB.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-VAOMHPEX.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/web.ts
+import { defineCommand } 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).",
+  args: {
+    question: {
+      type: "string",
+      description: "The research question to answer using live web data",
+      required: true
+    },
+    depth: {
+      type: "string",
+      description: "Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium",
+      required: false,
+      enum: ["medium", "high", "xhigh"]
+    }
+  }
+});
+var TIMEOUT_MS = {
+  medium: 18e4,
+  high: 36e4,
+  xhigh: 9e5
+};
+var FIELDS = {
+  answer: "AI-generated research answer (markdown)",
+  sources: "Array of {title, url} sources used for grounding"
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runDeepResearch(question) {
+  const { interactionId } = await apiPost("/api/research/deep-research/start", { question });
+  process.stderr.write(`Deep research started (${interactionId}). Polling...
+`);
+  const deadline = Date.now() + TIMEOUT_MS.xhigh;
+  while (Date.now() < deadline) {
+    await sleep(1e4);
+    const poll = await apiGet("/api/research/deep-research/poll", {
+      id: interactionId
+    });
+    if (poll.status === "completed" && poll.result) {
+      return poll.result;
+    }
+    if (poll.status === "failed" || poll.status === "cancelled") {
+      throw new Error(`Deep research ${poll.status}`);
+    }
+    process.stderr.write(`  status: ${poll.status}
+`);
+  }
+  throw new Error("Deep research timed out");
+}
+var webCommand = defineCommand({
+  meta: {
+    name: "web",
+    description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
+
+Depth levels:
+  medium  \u2014 Quick lookup using Gemini Flash with minimal thinking (default)
+  high    \u2014 Thorough answer using Gemini Flash with deep thinking
+  xhigh   \u2014 Exhaustive deep research using Gemini Deep Research (slow, use sparingly)
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot CRM?"
+  baker research web "What are the top pain points for SMB CRM buyers?" --depth high
+  baker research web "Full competitive analysis of project management SaaS" --depth xhigh`
+  },
+  args: {
+    question: { type: "positional", description: "The research question", required: true },
+    depth: { type: "string", description: "Research depth: medium|high|xhigh (default: medium)", required: false },
+    output: { type: "string", description: "Format: json|md (default: json)", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const question = args.question;
+    if (question.length < 5) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Question must be at least 5 characters" }
+      });
+      process.exit(1);
+    }
+    const depth = args.depth || "medium";
+    if (!["medium", "high", "xhigh"].includes(depth)) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Depth must be one of: medium, high, xhigh" }
+      });
+      process.exit(1);
+    }
+    try {
+      const data = depth === "xhigh" ? await runDeepResearch(question) : await apiPost("/api/research/explore", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });
+      const format = args.output || "json";
+      const hints = webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth });
+      if (format === "md") {
+        process.stdout.write(`${data.answer}
+`);
+        if (data.sources.length > 0) {
+          process.stdout.write("\n## Sources\n");
+          for (const s of data.sources) {
+            process.stdout.write(`- [${s.title}](${s.url})
+`);
+          }
+        }
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, hints });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  webCommand
+};
+//# sourceMappingURL=web-JRDXE2GL.js.map

package/dist/winners-AWRCSFAC.js

@@ -0,0 +1,113 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-OIS3WG2U.js";
+import {
+  reportError
+} from "./chunk-3FOE4P6A.js";
+import {
+  apiGet
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/winners.ts
+import { defineCommand } 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.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id to browse", required: true },
+    top: { type: "number", description: "Max winners 1-100 (default 10)", required: false, default: 10 },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    "per-platform": {
+      type: "boolean",
+      description: "Also rank each platform the brand runs on on its own (by_platform)",
+      required: false,
+      default: false
+    }
+  }
+});
+var winnersCommand = defineCommand({
+  meta: {
+    name: "winners",
+    description: "Top winning ads for a specific advertiser id, across its platforms, on one (--platform) or ranked per platform (--per-platform). Example: baker winning-ads winners adv_123 --top 5 --per-platform --fields ad_id,platform,summary,days_active"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    top: { type: "string", description: "Max winners 1-100 (default 10)", required: false },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    "per-platform": {
+      type: "boolean",
+      description: "Also return each platform's own top winners (by_platform); scores don't compare across platforms",
+      required: false,
+      default: 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 = { id: String(args.advertiser) };
+      if (args.top) {
+        params.top = String(args.top);
+      }
+      if (args.platform) {
+        params.platform = String(args.platform);
+      } else if (args["per-platform"]) {
+        params.per_platform = "1";
+      }
+      const data = await apiGet("/api/ad-library/advertiser-winners", params);
+      const output = args.output || "json";
+      const plan = adFieldPlan(args.fields, args.full);
+      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];
+      if (output === "json") {
+        const winners = adRows(rawWinners, plan);
+        const byPlatform = data?.by_platform?.map((g) => ({ platform: g.platform, winners: adRows(g.winners, plan) }));
+        writeJson({
+          ok: true,
+          data: {
+            advertiser_id: data?.advertiser_id ?? String(args.advertiser),
+            winners,
+            ...byPlatform ? { by_platform: byPlatform } : {}
+          }
+        });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: data?.by_platform ? data.by_platform.flatMap((g) => g.winners) : rawWinners },
+        output,
+        plan.fields,
+        plan.full,
+        winningAdNormalizer
+      );
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  winnersCommand
+};
+//# sourceMappingURL=winners-AWRCSFAC.js.map

package/dist/winners-AWRCSFAC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/winners.ts"],"sourcesContent":["import type { AdvertiserWinnersResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { type OutputFormat, winningAdNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { adFieldPlan, adRows } from \"./adRows.ts\";\nimport { reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.winners\",\n  description:\n    \"Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id to browse\", required: true },\n    top: { type: \"number\", description: \"Max winners 1-100 (default 10)\", required: false, default: 10 },\n    platform: {\n      type: \"string\",\n      description: \"Filter to a single platform: meta|linkedin|tiktok|google\",\n      required: false,\n    },\n    \"per-platform\": {\n      type: \"boolean\",\n      description: \"Also rank each platform the brand runs on on its own (by_platform)\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nexport const winnersCommand = defineCommand({\n  meta: {\n    name: \"winners\",\n    description:\n      \"Top winning ads for a specific advertiser id, across its platforms, on one (--platform) or ranked per platform (--per-platform). Example: baker winning-ads winners adv_123 --top 5 --per-platform --fields ad_id,platform,summary,days_active\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id\", required: true },\n    top: { type: \"string\", description: \"Max winners 1-100 (default 10)\", required: false },\n    platform: {\n      type: \"string\",\n      description: \"Filter to a single platform: meta|linkedin|tiktok|google\",\n      required: false,\n    },\n    \"per-platform\": {\n      type: \"boolean\",\n      description: \"Also return each platform's own top winners (by_platform); scores don't compare across platforms\",\n      required: false,\n      default: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Include DNA detail (angle, persona, hook) + longevity\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = { id: String(args.advertiser) };\n      if (args.top) {\n        params.top = String(args.top);\n      }\n      if (args.platform) {\n        params.platform = String(args.platform);\n      } else if (args[\"per-platform\"]) {\n        params.per_platform = \"1\";\n      }\n\n      const data = await apiGet<AdvertiserWinnersResponse>(\"/api/ad-library/advertiser-winners\", params);\n      const output = (args.output as OutputFormat) || \"json\";\n      const plan = adFieldPlan(args.fields, args.full);\n      const rawWinners = Array.isArray(data?.winners) ? data.winners : [];\n\n      if (output === \"json\") {\n        const winners = adRows(rawWinners, plan);\n        const byPlatform = data?.by_platform?.map((g) => ({ platform: g.platform, winners: adRows(g.winners, plan) }));\n        writeJson({\n          ok: true,\n          data: {\n            advertiser_id: data?.advertiser_id ?? String(args.advertiser),\n            winners,\n            ...(byPlatform ? { by_platform: byPlatform } : {}),\n          },\n        });\n        return;\n      }\n      // A table has one list: per platform, each platform's own top winners in turn.\n      writeOutput(\n        { ok: true, data: data?.by_platform ? data.by_platform.flatMap((g) => g.winners) : rawWinners },\n        output,\n        plan.fields,\n        plan.full,\n        winningAdNormalizer,\n      );\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAO9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,UAAU,aAAa,2BAA2B,UAAU,KAAK;AAAA,IACrF,KAAK,EAAE,MAAM,UAAU,aAAa,kCAAkC,UAAU,OAAO,SAAS,GAAG;AAAA,IACnG,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,YAAY,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IAC/E,KAAK,EAAE,MAAM,UAAU,aAAa,kCAAkC,UAAU,MAAM;AAAA,IACtF,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,IACA,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,IACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IACjG,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAiC,EAAE,IAAI,OAAO,KAAK,UAAU,EAAE;AACrE,UAAI,KAAK,KAAK;AACZ,eAAO,MAAM,OAAO,KAAK,GAAG;AAAA,MAC9B;AACA,UAAI,KAAK,UAAU;AACjB,eAAO,WAAW,OAAO,KAAK,QAAQ;AAAA,MACxC,WAAW,KAAK,cAAc,GAAG;AAC/B,eAAO,eAAe;AAAA,MACxB;AAEA,YAAM,OAAO,MAAM,OAAkC,sCAAsC,MAAM;AACjG,YAAM,SAAU,KAAK,UAA2B;AAChD,YAAM,OAAO,YAAY,KAAK,QAAQ,KAAK,IAAI;AAC/C,YAAM,aAAa,MAAM,QAAQ,MAAM,OAAO,IAAI,KAAK,UAAU,CAAC;AAElE,UAAI,WAAW,QAAQ;AACrB,cAAM,UAAU,OAAO,YAAY,IAAI;AACvC,cAAM,aAAa,MAAM,aAAa,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,SAAS,OAAO,EAAE,SAAS,IAAI,EAAE,EAAE;AAC7G,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,MAAM;AAAA,YACJ,eAAe,MAAM,iBAAiB,OAAO,KAAK,UAAU;AAAA,YAC5D;AAAA,YACA,GAAI,aAAa,EAAE,aAAa,WAAW,IAAI,CAAC;AAAA,UAClD;AAAA,QACF,CAAC;AACD;AAAA,MACF;AAEA;AAAA,QACE,EAAE,IAAI,MAAM,MAAM,MAAM,cAAc,KAAK,YAAY,QAAQ,CAAC,MAAM,EAAE,OAAO,IAAI,WAAW;AAAA,QAC9F;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,QACL;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/winning-ads-QQ6Y5R7T.js

@@ -0,0 +1,79 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/index.ts
+import { defineCommand } from "citty";
+var winningAdsCommand = defineCommand({
+  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.
+
+Auth: BAKER_API_KEY (bk_ or bkr_) + BAKER_API_URL (your Convex .convex.site URL).
+
+Rows are compact. Filter at the source (--platform, --format, --running, --advertiser-id) and keep only the columns you need with --fields ad_id,summary,days_active; --full only for the 2-3 ads you will use.
+
+Subcommands:
+  baker winning-ads search "<free text>"      \u2014 semantic search, followed brands first; lean shortlist (advertiser, summary, scores, proof, 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|tiktok|google \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 (--platform: one platform's; --per-platform: each platform's own)
+  baker winning-ads ads <advertiser>          \u2014 every ad one advertiser has run; narrow with --platform, --format video,static,carousel,text, --running running|stopped
+  baker winning-ads profile <advertiser>      \u2014 what a brand is doing: spend estimate, launches + what still runs, tests + the version kept, mixes, landing pages, audiences, similar brands
+  baker winning-ads launches [--since 7]      \u2014 what followed brands launched in the last N days and which ads still run
+  baker winning-ads landings <advertiser>     \u2014 every landing page a brand's ads point to; --analyse reads how each sells (value props, offer, pricing, proof)
+  baker winning-ads search-copy <advertiser>  \u2014 what a brand says on Google Search: headlines + their hooks, descriptions, sitelinks, each running or dropped
+  baker winning-ads content <ad-id>           \u2014 read ONE ad's transcript + on-screen text + copy (understand a reference before reproducing it)
+  baker winning-ads fit <ad-id>               \u2014 does this winner fit OUR company? why it wins, what it needs, what we have, use|adapt|reject
+  baker winning-ads unfollow <advertiser>     \u2014 stop following a brand
+  baker winning-ads refresh <advertiser>      \u2014 re-scrape a followed brand for its newest ads (max once per 6h)
+  baker winning-ads hooks                     \u2014 top winner-weighted HOOK seeds for a segment (feed the seed to search --hook-archetype)
+  baker winning-ads mechanisms                \u2014 top winner-weighted PRODUCT mechanism seeds (how the product claims to work)
+  baker winning-ads formats                   \u2014 top winner-weighted static FORMAT patterns for a segment
+
+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 --output md
+  baker winning-ads feed --advertiser adv_123,adv_456 --platform meta --output md
+  baker winning-ads winners adv_123 --per-platform --top 5 --output md
+  baker winning-ads ads adv_123 --platform google --format text --running running --fields ad_id,summary,days_active --output md
+  baker winning-ads profile adv_123 --platform meta
+  baker winning-ads launches --since 7
+  baker winning-ads landings adv_123 --analyse
+  baker winning-ads search-copy adv_123 --running
+  baker winning-ads content adg_123 --full --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
+  baker winning-ads search --format-pattern comparison_table --sort longest_running --output md
+Full guide: __tooling__/docs/tools/baker/winning-ads.md`
+  },
+  subCommands: {
+    search: () => import("./search-6BHODVNN.js").then((m) => m.searchCommand),
+    advertisers: () => import("./advertisers-JDUAIACQ.js").then((m) => m.advertisersCommand),
+    follow: () => import("./follow-EKNBOS7Z.js").then((m) => m.followCommand),
+    "follow-competitors": () => import("./follow-competitors-OYQXYSI5.js").then((m) => m.followCompetitorsCommand),
+    following: () => import("./following-M3C3XSHY.js").then((m) => m.followingCommand),
+    feed: () => import("./feed-PG6AXUYA.js").then((m) => m.feedCommand),
+    winners: () => import("./winners-AWRCSFAC.js").then((m) => m.winnersCommand),
+    ads: () => import("./ads-FYSAF7HG.js").then((m) => m.adsCommand),
+    profile: () => import("./profile-2TPKFD4Y.js").then((m) => m.profileCommand),
+    launches: () => import("./launches-ZZ7ST4SY.js").then((m) => m.launchesCommand),
+    landings: () => import("./landings-JJELYF4P.js").then((m) => m.landingsCommand),
+    "search-copy": () => import("./search-copy-LXBPFQC3.js").then((m) => m.searchCopyCommand),
+    content: () => import("./content-MJ3W6FKW.js").then((m) => m.contentCommand),
+    fit: () => import("./fit-SSR3JDDI.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-S6XQVQIA.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-OER4JT3Q.js").then((m) => m.refreshCommand),
+    hooks: () => import("./seeds-Q6VS27LT.js").then((m) => m.hooksCommand),
+    mechanisms: () => import("./seeds-Q6VS27LT.js").then((m) => m.mechanismsCommand),
+    formats: () => import("./seeds-Q6VS27LT.js").then((m) => m.formatsCommand)
+  }
+});
+export {
+  winningAdsCommand
+};
+//# sourceMappingURL=winning-ads-QQ6Y5R7T.js.map

package/dist/winning-ads-QQ6Y5R7T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const winningAdsCommand = defineCommand({\n  meta: {\n    name: \"winning-ads\",\n    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) — no separate token needed.\n\nAuth: BAKER_API_KEY (bk_ or bkr_) + BAKER_API_URL (your Convex .convex.site URL).\n\nRows are compact. Filter at the source (--platform, --format, --running, --advertiser-id) and keep only the columns you need with --fields ad_id,summary,days_active; --full only for the 2-3 ads you will use.\n\nSubcommands:\n  baker winning-ads search \"<free text>\"      — semantic search, followed brands first; lean shortlist (advertiser, summary, scores, proof, media_url)\n  baker winning-ads advertisers \"<brand>\"     — list corpus brands → advertiser ids (for --exclude-advertiser / --advertiser-id)\n  baker winning-ads follow \"<domain|url|brand>\" --platform meta|linkedin|tiktok|google — add a brand's ads to your library\n  baker winning-ads follow-competitors \"<domain,domain,...>\"   — add MANY brands at once (every competitor by domain)\n  baker winning-ads following                 — list brands you follow (status + counts)\n  baker winning-ads feed                      — winners across EVERY brand you follow; trim with --advertiser\n  baker winning-ads winners <advertiser>      — top winners for one advertiser id (--platform: one platform's; --per-platform: each platform's own)\n  baker winning-ads ads <advertiser>          — every ad one advertiser has run; narrow with --platform, --format video,static,carousel,text, --running running|stopped\n  baker winning-ads profile <advertiser>      — what a brand is doing: spend estimate, launches + what still runs, tests + the version kept, mixes, landing pages, audiences, similar brands\n  baker winning-ads launches [--since 7]      — what followed brands launched in the last N days and which ads still run\n  baker winning-ads landings <advertiser>     — every landing page a brand's ads point to; --analyse reads how each sells (value props, offer, pricing, proof)\n  baker winning-ads search-copy <advertiser>  — what a brand says on Google Search: headlines + their hooks, descriptions, sitelinks, each running or dropped\n  baker winning-ads content <ad-id>           — read ONE ad's transcript + on-screen text + copy (understand a reference before reproducing it)\n  baker winning-ads fit <ad-id>               — does this winner fit OUR company? why it wins, what it needs, what we have, use|adapt|reject\n  baker winning-ads unfollow <advertiser>     — stop following a brand\n  baker winning-ads refresh <advertiser>      — re-scrape a followed brand for its newest ads (max once per 6h)\n  baker winning-ads hooks                     — top winner-weighted HOOK seeds for a segment (feed the seed to search --hook-archetype)\n  baker winning-ads mechanisms                — top winner-weighted PRODUCT mechanism seeds (how the product claims to work)\n  baker winning-ads formats                   — top winner-weighted static FORMAT patterns for a segment\n\nExamples:\n  baker winning-ads search \"B2B SaaS before/after AI automation\" --platform meta --format static --output md\n  baker winning-ads advertisers \"Acme\" --output md\n  baker winning-ads follow \"deel.com\" --platform meta\n  baker winning-ads follow-competitors \"deel.com,notion.so,hubspot.com\"\n  baker winning-ads feed --output md\n  baker winning-ads feed --advertiser adv_123,adv_456 --platform meta --output md\n  baker winning-ads winners adv_123 --per-platform --top 5 --output md\n  baker winning-ads ads adv_123 --platform google --format text --running running --fields ad_id,summary,days_active --output md\n  baker winning-ads profile adv_123 --platform meta\n  baker winning-ads launches --since 7\n  baker winning-ads landings adv_123 --analyse\n  baker winning-ads search-copy adv_123 --running\n  baker winning-ads content adg_123 --full --output md\n  baker winning-ads hooks --platform meta --awareness problem_aware --industry saas --output md\n  baker winning-ads search \"fintech onboarding\" --hook-archetype callout --winner-category winner --output md\n  baker winning-ads search --format-pattern comparison_table --sort longest_running --output md\nFull guide: __tooling__/docs/tools/baker/winning-ads.md`,\n  },\n  subCommands: {\n    search: () => import(\"./search.ts\").then((m) => m.searchCommand),\n    advertisers: () => import(\"./advertisers.ts\").then((m) => m.advertisersCommand),\n    follow: () => import(\"./follow.ts\").then((m) => m.followCommand),\n    \"follow-competitors\": () => import(\"./follow-competitors.ts\").then((m) => m.followCompetitorsCommand),\n    following: () => import(\"./following.ts\").then((m) => m.followingCommand),\n    feed: () => import(\"./feed.ts\").then((m) => m.feedCommand),\n    winners: () => import(\"./winners.ts\").then((m) => m.winnersCommand),\n    ads: () => import(\"./ads.ts\").then((m) => m.adsCommand),\n    profile: () => import(\"./profile.ts\").then((m) => m.profileCommand),\n    launches: () => import(\"./launches.ts\").then((m) => m.launchesCommand),\n    landings: () => import(\"./landings.ts\").then((m) => m.landingsCommand),\n    \"search-copy\": () => import(\"./search-copy.ts\").then((m) => m.searchCopyCommand),\n    content: () => import(\"./content.ts\").then((m) => m.contentCommand),\n    fit: () => import(\"./fit.ts\").then((m) => m.fitCommand),\n    unfollow: () => import(\"./unfollow.ts\").then((m) => m.unfollowCommand),\n    refresh: () => import(\"./refresh.ts\").then((m) => m.refreshCommand),\n    hooks: () => import(\"./seeds.ts\").then((m) => m.hooksCommand),\n    mechanisms: () => import(\"./seeds.ts\").then((m) => m.mechanismsCommand),\n    formats: () => import(\"./seeds.ts\").then((m) => m.formatsCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6Cf;AAAA,EACA,aAAa;AAAA,IACX,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,aAAa,MAAM,OAAO,2BAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,IAC9E,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,sBAAsB,MAAM,OAAO,kCAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,wBAAwB;AAAA,IACpG,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,MAAM,MAAM,OAAO,oBAAW,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW;AAAA,IACzD,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,KAAK,MAAM,OAAO,mBAAU,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;AAAA,IACtD,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,eAAe,MAAM,OAAO,2BAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC/E,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,KAAK,MAAM,OAAO,mBAAU,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;AAAA,IACtD,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,YAAY,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IACtE,SAAS,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,EAClE;AACF,CAAC;","names":[]}