@koda-sl/baker-cli 0.466.0 → 0.467.0

package/dist/viewer-check-65TIGVAJ.js

@@ -0,0 +1,68 @@
+import {
+  OFFER_READ,
+  VIEWER_CLARITY,
+  VIEWER_QUESTIONS,
+  VIEWER_REQUIRED_CLARITY,
+  ViewerAnswerSchema,
+  buildViewerPrompt,
+  checkViewer,
+  describeViewer,
+  gatewayViewerModel,
+  jevReadJudge,
+  judgeViewerAnswer,
+  liveViewerLookups,
+  misreadings,
+  personaSegments,
+  readCreativeForViewerCheck,
+  readPersonas,
+  resolveViewer,
+  sureEnough,
+  viewerCheckBeforeRender,
+  viewerCheckCacheKey,
+  viewerCheckCommand,
+  viewerCheckFailure,
+  viewerCheckSkip
+} from "./chunk-XUMMI5WJ.js";
+import "./chunk-NFSLRRIE.js";
+import "./chunk-D5MF337I.js";
+import "./chunk-VHMNSO2B.js";
+import "./chunk-65BQAJMH.js";
+import "./chunk-AQ4HEXUH.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-73B3RQJC.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-6GFJFTG6.js";
+import "./chunk-NAMEFVWL.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-CECS3DHZ.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  OFFER_READ,
+  VIEWER_CLARITY,
+  VIEWER_QUESTIONS,
+  VIEWER_REQUIRED_CLARITY,
+  ViewerAnswerSchema,
+  buildViewerPrompt,
+  checkViewer,
+  describeViewer,
+  gatewayViewerModel,
+  jevReadJudge,
+  judgeViewerAnswer,
+  liveViewerLookups,
+  misreadings,
+  personaSegments,
+  readCreativeForViewerCheck,
+  readPersonas,
+  resolveViewer,
+  sureEnough,
+  viewerCheckBeforeRender,
+  viewerCheckCacheKey,
+  viewerCheckCommand,
+  viewerCheckFailure,
+  viewerCheckSkip
+};
+//# sourceMappingURL=viewer-check-65TIGVAJ.js.map

package/dist/web-2ACSE34L.js

@@ -0,0 +1,140 @@
+import {
+  webDepthHints
+} from "./chunk-YT74ZEVP.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-57UECM77.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.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-2ACSE34L.js.map

package/dist/web-2ACSE34L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/web.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { webDepthHints } from \"./hints.ts\";\nimport { handleResearchError, writeResearchHints, writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.web\",\n  description:\n    \"Search the web with AI to answer marketing questions — competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).\",\n  args: {\n    question: {\n      type: \"string\",\n      description: \"The research question to answer using live web data\",\n      required: true,\n    },\n    depth: {\n      type: \"string\",\n      description: \"Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium\",\n      required: false,\n      enum: [\"medium\", \"high\", \"xhigh\"],\n    },\n  },\n});\n\ntype Depth = \"medium\" | \"high\" | \"xhigh\";\n\nconst TIMEOUT_MS: Record<Depth, number> = {\n  medium: 180_000,\n  high: 360_000,\n  xhigh: 900_000,\n};\n\ninterface WebResult {\n  answer: string;\n  sources: Array<{ title: string; url: string }>;\n}\n\nconst FIELDS: Record<string, string> = {\n  answer: \"AI-generated research answer (markdown)\",\n  sources: \"Array of {title, url} sources used for grounding\",\n};\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function runDeepResearch(question: string): Promise<WebResult> {\n  const { interactionId } = await apiPost<{ interactionId: string }>(\"/api/research/deep-research/start\", { question });\n\n  process.stderr.write(`Deep research started (${interactionId}). Polling...\\n`);\n\n  const deadline = Date.now() + TIMEOUT_MS.xhigh;\n  while (Date.now() < deadline) {\n    await sleep(10_000);\n    const poll = await apiGet<{ status: string; result?: WebResult }>(\"/api/research/deep-research/poll\", {\n      id: interactionId,\n    });\n\n    if (poll.status === \"completed\" && poll.result) {\n      return poll.result;\n    }\n    if (poll.status === \"failed\" || poll.status === \"cancelled\") {\n      throw new Error(`Deep research ${poll.status}`);\n    }\n    process.stderr.write(`  status: ${poll.status}\\n`);\n  }\n\n  throw new Error(\"Deep research timed out\");\n}\n\nexport const webCommand = defineCommand({\n  meta: {\n    name: \"web\",\n    description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.\n\nDepth levels:\n  medium  — Quick lookup using Gemini Flash with minimal thinking (default)\n  high    — Thorough answer using Gemini Flash with deep thinking\n  xhigh   — Exhaustive deep research using Gemini Deep Research (slow, use sparingly)\n\nExamples:\n  baker research web \"Who are the main competitors of HubSpot CRM?\"\n  baker research web \"What are the top pain points for SMB CRM buyers?\" --depth high\n  baker research web \"Full competitive analysis of project management SaaS\" --depth xhigh`,\n  },\n  args: {\n    question: { type: \"positional\", description: \"The research question\", required: true },\n    depth: { type: \"string\", description: \"Research depth: medium|high|xhigh (default: medium)\", required: false },\n    output: { type: \"string\", description: \"Format: json|md (default: json)\", required: false, default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const question = args.question as string;\n    if (question.length < 5) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Question must be at least 5 characters\" },\n      });\n      process.exit(1);\n    }\n\n    const depth = ((args.depth as string) || \"medium\") as Depth;\n    if (![\"medium\", \"high\", \"xhigh\"].includes(depth)) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Depth must be one of: medium, high, xhigh\" },\n      });\n      process.exit(1);\n    }\n\n    try {\n      const data =\n        depth === \"xhigh\"\n          ? await runDeepResearch(question)\n          : await apiPost<WebResult>(\"/api/research/explore\", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });\n\n      const format = (args.output as string) || \"json\";\n      const hints = webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth });\n      if (format === \"md\") {\n        process.stdout.write(`${data.answer}\\n`);\n        if (data.sources.length > 0) {\n          process.stdout.write(\"\\n## Sources\\n\");\n          for (const s of data.sources) {\n            process.stdout.write(`- [${s.title}](${s.url})\\n`);\n          }\n        }\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({ ok: true, data, fields: FIELDS, hints });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/winners-AI4PVSOI.js

@@ -0,0 +1,113 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-QTL4NJ5I.js";
+import {
+  reportError
+} from "./chunk-G3KO2HFZ.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.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-AI4PVSOI.js.map

package/dist/winning-ads-2ZOUOAYM.js

@@ -0,0 +1,84 @@
+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_, bkr_ or bkv_) + 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 "<website|brand|link>" \u2014 add a brand's ads to your library: every platform, every account it runs
+  baker winning-ads discover "<website|brand|link>" \u2014 see every account a brand runs ads from, without following
+  baker winning-ads add-accounts <advertiser> "<link,link>" \u2014 track more accounts of a followed brand (another market's page)
+  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"
+  baker winning-ads add-accounts adv_123 "https://www.facebook.com/barkibu.it"
+  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-4HIOKYFR.js").then((m) => m.searchCommand),
+    advertisers: () => import("./advertisers-BVAZ4XUX.js").then((m) => m.advertisersCommand),
+    follow: () => import("./follow-N3DQZV7M.js").then((m) => m.followCommand),
+    discover: () => import("./discover-UQXQUPNO.js").then((m) => m.discoverCommand),
+    "add-accounts": () => import("./add-accounts-M5Y4DQFM.js").then((m) => m.addAccountsCommand),
+    "follow-competitors": () => import("./follow-competitors-BZPCBGIB.js").then((m) => m.followCompetitorsCommand),
+    following: () => import("./following-KESWTEBR.js").then((m) => m.followingCommand),
+    feed: () => import("./feed-SQPOB7SP.js").then((m) => m.feedCommand),
+    winners: () => import("./winners-AI4PVSOI.js").then((m) => m.winnersCommand),
+    ads: () => import("./ads-DB5NDHX5.js").then((m) => m.adsCommand),
+    profile: () => import("./profile-NQOIBLJL.js").then((m) => m.profileCommand),
+    launches: () => import("./launches-7U4TPNO3.js").then((m) => m.launchesCommand),
+    landings: () => import("./landings-5IYXHA5Z.js").then((m) => m.landingsCommand),
+    "search-copy": () => import("./search-copy-QZXCAGK4.js").then((m) => m.searchCopyCommand),
+    content: () => import("./content-OXMONMHJ.js").then((m) => m.contentCommand),
+    fit: () => import("./fit-XJPM6573.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-WBBTVEHE.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-NKBJT47F.js").then((m) => m.refreshCommand),
+    hooks: () => import("./seeds-VUNZMHZH.js").then((m) => m.hooksCommand),
+    mechanisms: () => import("./seeds-VUNZMHZH.js").then((m) => m.mechanismsCommand),
+    formats: () => import("./seeds-VUNZMHZH.js").then((m) => m.formatsCommand)
+  }
+});
+export {
+  winningAdsCommand
+};
+//# sourceMappingURL=winning-ads-2ZOUOAYM.js.map

package/dist/winning-ads-2ZOUOAYM.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_, bkr_ or bkv_) + 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 \"<website|brand|link>\" — add a brand's ads to your library: every platform, every account it runs\n  baker winning-ads discover \"<website|brand|link>\" — see every account a brand runs ads from, without following\n  baker winning-ads add-accounts <advertiser> \"<link,link>\" — track more accounts of a followed brand (another market's page)\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\"\n  baker winning-ads add-accounts adv_123 \"https://www.facebook.com/barkibu.it\"\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    discover: () => import(\"./discover.ts\").then((m) => m.discoverCommand),\n    \"add-accounts\": () => import(\"./add-accounts.ts\").then((m) => m.addAccountsCommand),\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;AAAA;AAAA;AAAA,EAgDf;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,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,gBAAgB,MAAM,OAAO,4BAAmB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,IAClF,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":[]}