@koda-sl/baker-cli 0.500.0 → 0.503.0

package/dist/validate-5LLAJ2MA.js

@@ -0,0 +1,120 @@
+import {
+  outputRatioWarningsFor,
+  shownBaseline
+} from "./chunk-M4RFVC25.js";
+import {
+  creativeSlugFromCanvasPath
+} from "./chunk-PX3PUDK7.js";
+import "./chunk-XW35UMDI.js";
+import {
+  exitOnPrepareError,
+  prepareCanvas
+} from "./chunk-XDP7ES6W.js";
+import "./chunk-XFJMCDU2.js";
+import "./chunk-RG3UP6PT.js";
+import "./chunk-WHBFXR6F.js";
+import "./chunk-DQVI7GCX.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-SWN6OHXG.js";
+import "./chunk-SL47UJDL.js";
+import "./chunk-A3IQAONL.js";
+import "./chunk-5Y3I5LCJ.js";
+import "./chunk-MMWX7CPB.js";
+import "./chunk-3YJNSUNF.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-E44NXCTL.js";
+import {
+  canvasOutputsRoot
+} from "./chunk-EJGAJHLB.js";
+import {
+  defaultRegistry,
+  validateCanvasDeep
+} from "./chunk-6KWEF6HF.js";
+import "./chunk-TX7CQTD4.js";
+import "./chunk-F4YQ5PVR.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-MVD7QIXI.js";
+import "./chunk-LRV6M2WB.js";
+import "./chunk-7HZSORAB.js";
+import "./chunk-MCJ5I5LR.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-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  optionalTurnId
+} from "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/validate.ts
+import path from "path";
+import { defineCommand } from "citty";
+var validateCommand = defineCommand({
+  meta: {
+    name: "validate",
+    description: "Validate a canvas JSON file (no execution). Brings the canvas up to date with its prompt.json first (prompt.json and, for a video, scenes/*.json edits are written into the canvas, exactly as `run` does), then checks it: a per-node cost preview, each node's deep validators (composition meta checks for hyperframe_render/_snapshot), and each generator prompt measured with its {{slots}} filled against the model's character cap (PROMPT_OVER_MODEL_LIMIT)."
+  },
+  args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
+  async run({ args }) {
+    const filePath = path.resolve(String(args.file));
+    const slug = creativeSlugFromCanvasPath(filePath) ?? void 0;
+    const baseline = slug ? (await shownBaseline({
+      canvasRoot: canvasOutputsRoot(filePath),
+      slug,
+      creativeDir: path.dirname(filePath),
+      turnId: optionalTurnId(),
+      record: false
+    })).baseline : void 0;
+    let prepared;
+    try {
+      prepared = await prepareCanvas(filePath, {
+        gate: true,
+        log: (line) => process.stderr.write(`${line}
+`),
+        ...baseline ? { baseline } : {}
+      });
+    } catch (e) {
+      exitOnPrepareError(e);
+    }
+    const result = await validateCanvasDeep(prepared.canvas, defaultRegistry());
+    if (!result.ok) {
+      process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: result.issues } }, null, 2)}
+`);
+      process.exit(2);
+      return;
+    }
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          total_nodes: result.canvas.nodes.length,
+          estimated_credits: result.estimatedCredits,
+          cost_preview: result.perNodeCredits ?? [],
+          style_projection: prepared.projections.style,
+          scene_projection: prepared.projections.scenes,
+          canvas_updated: prepared.written,
+          normalized_paths: prepared.rewrites,
+          warnings: [...result.warnings ?? [], ...await outputRatioWarningsFor(prepared.canvas, filePath)]
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  validateCommand
+};
+//# sourceMappingURL=validate-5LLAJ2MA.js.map

package/dist/videos-JDCHL5SC.js

@@ -0,0 +1,39 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/index.ts
+import { defineCommand } from "citty";
+var videosCommand = defineCommand({
+  meta: {
+    name: "videos",
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, fetch, describe, delete, retry, tags.
+
+Examples:
+  baker videos search "product demo" --limit 5
+  baker videos search "tutorial" --tags explainer
+  baker videos get <video-id>
+  baker videos upload ./demo.mp4
+  baker videos ingest https://www.youtube.com/watch?v=abc123
+  baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips
+  baker videos describe <video-id> --description "Customer testimonial, 30s"
+  baker videos delete <video-id> --dry-run
+  baker videos retry <video-id>                    # process a failed video again
+  baker videos tags                                # list; tags create|update|delete for custom tags
+Full guide: __tooling__/docs/tools/baker/videos.md`
+  },
+  subCommands: {
+    get: () => import("./get-LSUOV5YD.js").then((m) => m.getCommand),
+    group: () => import("./group-Z3U67VRY.js").then((m) => m.groupCommand),
+    search: () => import("./search-WI2L755B.js").then((m) => m.searchCommand),
+    upload: () => import("./upload-7ASELPSD.js").then((m) => m.uploadCommand),
+    ingest: () => import("./ingest-4VG6XNCO.js").then((m) => m.ingestCommand),
+    fetch: () => import("./fetch-53TIHU4X.js").then((m) => m.fetchCommand),
+    describe: () => import("./describe-YW32V6EW.js").then((m) => m.describeCommand),
+    delete: () => import("./delete-EZHOZ2D2.js").then((m) => m.deleteCommand),
+    retry: () => import("./retry-EVDOPZAI.js").then((m) => m.retryCommand),
+    tags: () => import("./tags-GDGJ2R5N.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  videosCommand
+};
+//# sourceMappingURL=videos-JDCHL5SC.js.map

package/dist/viewer-check-5KVZ6VIW.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-F425ESRT.js";
+import "./chunk-XFJMCDU2.js";
+import "./chunk-RG3UP6PT.js";
+import "./chunk-WHBFXR6F.js";
+import "./chunk-SL47UJDL.js";
+import "./chunk-A3IQAONL.js";
+import "./chunk-3YJNSUNF.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LRV6M2WB.js";
+import "./chunk-7HZSORAB.js";
+import "./chunk-MCJ5I5LR.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-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.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-5KVZ6VIW.js.map

package/dist/web-5KLGKX6D.js

@@ -0,0 +1,141 @@
+import {
+  webDepthHints
+} from "./chunk-FZ7C3A2R.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-GSKZ3ZDO.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.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-5KLGKX6D.js.map

package/dist/winning-ads-3YASFLVY.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-564FGMGA.js").then((m) => m.fitCommand),
+    unfollow: () => import("./unfollow-Z7SCZDPM.js").then((m) => m.unfollowCommand),
+    refresh: () => import("./refresh-K72LPCCT.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-3YASFLVY.js.map