@koda-sl/baker-cli 0.502.0 → 0.504.0-dev.239e52d65

package/dist/viewer-check-CTPQ5CRN.js

@@ -0,0 +1,81 @@
+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-AMO5Z7FU.js";
+import "./chunk-OG2UYL6Y.js";
+import "./chunk-VUV3YM35.js";
+import "./chunk-WHBFXR6F.js";
+import "./chunk-AII6BPX4.js";
+import "./chunk-EFPIK64C.js";
+import "./chunk-I5HCVGTV.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-ELXYZUHU.js";
+import "./chunk-CAD6FIYH.js";
+import "./chunk-UQA3ASVK.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-KUV4FMAV.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-C6JPTPPU.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.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-CTPQ5CRN.js.map

package/dist/web-M3DSKQ5K.js

@@ -0,0 +1,141 @@
+import {
+  webDepthHints
+} from "./chunk-O7CJAYMV.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-GSKZ3ZDO.js";
+import "./chunk-KUV4FMAV.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-C6JPTPPU.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.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-M3DSKQ5K.js.map

package/dist/winning-ads-MQYQJQL7.js

@@ -0,0 +1,86 @@
+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 "<website|brand|link>" \u2014 put a brand's ads in Baker's library WITHOUT following it (a client you study, not track)
+  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-3OMMKHJB.js").then((m) => m.searchCommand),
+    advertisers: () => import("./advertisers-7TYBQMB5.js").then((m) => m.advertisersCommand),
+    follow: () => import("./follow-CMCZVFHU.js").then((m) => m.followCommand),
+    discover: () => import("./discover-PPSZ6BQI.js").then((m) => m.discoverCommand),
+    add: () => import("./add-EVFOCMOM.js").then((m) => m.addCommand),
+    "add-accounts": () => import("./add-accounts-76WYQJC6.js").then((m) => m.addAccountsCommand),
+    "follow-competitors": () => import("./follow-competitors-B4ITK7QT.js").then((m) => m.followCompetitorsCommand),
+    following: () => import("./following-GUZRR5YB.js").then((m) => m.followingCommand),
+    feed: () => import("./feed-QJ2QHVJH.js").then((m) => m.feedCommand),
+    winners: () => import("./winners-YKLNIUJH.js").then((m) => m.winnersCommand),
+    ads: () => import("./ads-46BH2TCU.js").then((m) => m.adsCommand),
+    profile: () => import("./profile-T5LAXXFY.js").then((m) => m.profileCommand),
+    launches: () => import("./launches-CGRWUGRB.js").then((m) => m.launchesCommand),
+    landings: () => import("./landings-FLELWQDN.js").then((m) => m.landingsCommand),
+    "search-copy": () => import("./search-copy-EMS5PVMK.js").then((m) => m.searchCopyCommand),
+    content: () => import("./content-XJMRCTWX.js").then((m) => m.contentCommand),
+    fit: () => import("./fit-EILVAWJO.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-Z7SCZDPM.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-JETFLDUX.js").then((m) => m.refreshCommand),
+    hooks: () => import("./seeds-JETCIUR3.js").then((m) => m.hooksCommand),
+    mechanisms: () => import("./seeds-JETCIUR3.js").then((m) => m.mechanismsCommand),
+    formats: () => import("./seeds-JETCIUR3.js").then((m) => m.formatsCommand)
+  }
+});
+export {
+  winningAdsCommand
+};
+//# sourceMappingURL=winning-ads-MQYQJQL7.js.map