@koda-sl/baker-cli 0.569.0 → 0.570.0

package/dist/videos-GHFCOTT7.js

@@ -0,0 +1,146 @@
+import {
+  handleMetaError
+} from "./chunk-4HFM5RCP.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-MPTNN35I.js";
+import {
+  apiGet
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/videos.ts
+import { createWriteStream, mkdirSync } from "fs";
+import { join } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+
+// ../api/src/ads-meta/adVideos.ts
+import { z } from "zod";
+var metaAdVideoSchema = z.object({
+  videoId: z.string(),
+  /** Short-lived MP4 address; null when Meta does not hand the file to this connection. */
+  source: z.string().url().nullable(),
+  seconds: z.number().nullable(),
+  title: z.string().nullable(),
+  thumbnail: z.string().url().nullable()
+});
+var metaAdVideosResponseSchema = z.object({
+  adId: z.string().nullable(),
+  creativeId: z.string(),
+  videos: z.array(metaAdVideoSchema)
+});
+
+// src/commands/ads/meta/videos.ts
+import { defineCommand } from "citty";
+var DEFAULT_OUT_DIR = "/tmp/meta-ad-videos";
+function downloadHints(results) {
+  const all = results.flatMap((result) => result.videos);
+  const hints = [];
+  if (all.length === 0)
+    hints.push("No video in these ads: they are image or carousel ads (`creatives --creative-id` shows their assets).");
+  if (all.some((video) => video.file === null && video.url === void 0)) {
+    hints.push(
+      "A video with no file is a copy Meta does not hand to this connection (usually the Page's copy of the same upload); the other video of that ad is the same film."
+    );
+  }
+  if (all.some((video) => video.file !== null)) {
+    hints.push(
+      "Watch before judging: a frame strip (`ffmpeg -i <file> -vf fps=2,scale=240:-1,tile=8x2 strip.jpg`) and the 3-second hold rate from `insights --level ad --intent video`."
+    );
+  }
+  return hints;
+}
+async function download(url, file) {
+  const response = await fetch(url);
+  if (!response.ok || !response.body) throw new Error(`Meta's video address answered ${response.status}`);
+  await pipeline(Readable.fromWeb(response.body), createWriteStream(file));
+  return Number(response.headers.get("content-length") ?? 0);
+}
+async function fetchAndSave(params, outDir, save) {
+  const data = metaAdVideosResponseSchema.parse(await apiGet("/api/ads/meta/videos", params));
+  const owner = data.adId ?? data.creativeId;
+  const videos = [];
+  for (const video of data.videos) {
+    if (!video.source || !save) {
+      videos.push({
+        videoId: video.videoId,
+        file: null,
+        ...video.source ? { url: video.source } : {},
+        seconds: video.seconds,
+        megabytes: null
+      });
+      continue;
+    }
+    const file = join(outDir, `${owner}-${video.videoId}.mp4`);
+    const bytes = await download(video.source, file);
+    videos.push({
+      videoId: video.videoId,
+      file,
+      seconds: video.seconds,
+      megabytes: bytes ? Math.round(bytes / 1e5) / 10 : null
+    });
+  }
+  return { adId: data.adId, creativeId: data.creativeId, videos };
+}
+var splitIds = (value) => typeof value === "string" ? value.split(",").map((id) => id.trim()).filter(Boolean) : [];
+registerSchema({
+  command: "ads.meta.videos",
+  description: "Download the video files of running Meta ads (or creatives) to disk, to watch, cut or analyse them. One call for several ads.",
+  args: {
+    "ad-id": { type: "string", description: "Ad id, or several comma-separated", required: false },
+    "creative-id": { type: "string", description: "Creative id, or several comma-separated", required: false },
+    "out-dir": { type: "string", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})`, required: false },
+    "url-only": {
+      type: "boolean",
+      description: "Return Meta's short-lived addresses instead of files",
+      required: false
+    }
+  }
+});
+var videosCommand = defineCommand({
+  meta: {
+    name: "videos",
+    description: `Download the video files behind Meta ads, to watch, cut or analyse the company's own ads.
+  baker ads meta videos --ad-id 120211234567890,120211234567891     \u2014 MP4s in ${DEFAULT_OUT_DIR}
+  baker ads meta videos --creative-id 9988 --out-dir /tmp/ads        \u2014 by creative
+Start here when judging video ads: \`insights --level ad --intent video\` names the ads, this gets their files.`
+  },
+  args: {
+    "ad-id": { type: "string", description: "Ad id, or several comma-separated" },
+    "creative-id": { type: "string", description: "Creative id, or several comma-separated" },
+    "out-dir": { type: "string", description: `Where the MP4s go (default ${DEFAULT_OUT_DIR})` },
+    // Not `--no-download`: citty reads any `--no-x` as `x: false`, so that flag would never be set.
+    "url-only": { type: "boolean", description: "Return Meta's short-lived addresses instead of files" }
+  },
+  run: async ({ args }) => {
+    const adIds = splitIds(args["ad-id"]);
+    const creativeIds = splitIds(args["creative-id"]);
+    if (adIds.length + creativeIds.length === 0) {
+      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: "Name --ad-id or --creative-id" } });
+      process.exit(1);
+    }
+    const outDir = typeof args["out-dir"] === "string" ? args["out-dir"] : DEFAULT_OUT_DIR;
+    const save = !args["url-only"];
+    if (save) mkdirSync(outDir, { recursive: true });
+    try {
+      const results = [];
+      for (const id of adIds) results.push(await fetchAndSave({ "ad-id": id }, outDir, save));
+      for (const id of creativeIds) results.push(await fetchAndSave({ "creative-id": id }, outDir, save));
+      writeJsonEnvelope({ ok: true, data: results, hints: downloadHints(results) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  downloadHints,
+  videosCommand
+};
+//# sourceMappingURL=videos-GHFCOTT7.js.map

package/dist/videos-NW2UP342.js

@@ -0,0 +1,41 @@
+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, download, 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 download <video-id> --out /tmp/clips   # a library video as a local .mp4 to edit
+  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-JIZPYK3Z.js").then((m) => m.getCommand),
+    group: () => import("./group-3DT4UYSR.js").then((m) => m.groupCommand),
+    search: () => import("./search-TXBYKNQC.js").then((m) => m.searchCommand),
+    upload: () => import("./upload-45GCGMA5.js").then((m) => m.uploadCommand),
+    ingest: () => import("./ingest-4RPLN54K.js").then((m) => m.ingestCommand),
+    fetch: () => import("./fetch-I6P72CDL.js").then((m) => m.fetchCommand),
+    download: () => import("./download-ZVOGLTFB.js").then((m) => m.downloadCommand),
+    describe: () => import("./describe-MAGTSOW4.js").then((m) => m.describeCommand),
+    delete: () => import("./delete-SP66F7ZV.js").then((m) => m.deleteCommand),
+    retry: () => import("./retry-VLH4AO7F.js").then((m) => m.retryCommand),
+    tags: () => import("./tags-YHAC3NVY.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  videosCommand
+};
+//# sourceMappingURL=videos-NW2UP342.js.map

package/dist/view-YR6MDLWL.js

@@ -0,0 +1,133 @@
+import {
+  READABLE_SHOT,
+  downloadReadableShot
+} from "./chunk-DNCLWSHO.js";
+import {
+  INSPIRATION_HINTS,
+  fidelityHint,
+  reportError
+} from "./chunk-3WN5GWX4.js";
+import {
+  apiGet
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/view.ts
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.view",
+  description: "Everything known about one section: composition, motion, design tokens, the copy it uses, why it works, and what must change to make it yours. Downloads the desktop and mobile screenshots plus the motion filmstrip, to look at through the visual-check subagent.",
+  args: {
+    id: { type: "string", description: "Section id from search", required: true },
+    full: {
+      type: "boolean",
+      description: "Add the classification facets (theme, density, rank, interactions, media, devices, tags) and the reproduction notes",
+      required: false
+    }
+  }
+});
+function viewShotHints(shots) {
+  const hints = [];
+  if (shots.desktop) {
+    hints.push(
+      `Look at ${shots.desktop} through the visual-check subagent (the path and what you need to learn) before you build \u2014 the description is not the section \u2014 not by Reading it yourself: every image you Read is re-sent on every later request.`
+    );
+  }
+  if (shots.filmstrip) {
+    hints.push(
+      `${shots.filmstrip} shows this section animating in, six frames left-to-right then top-to-bottom, with the elapsed time on each. If you want the motion, not just the layout, ask visual-check about it.`
+    );
+  }
+  return hints;
+}
+var viewCommand = defineCommand({
+  meta: {
+    name: "view",
+    description: "Full detail for one reference section. Example: baker landing inspiration view k57abc\u2026 \u2014 look at the screenshots it saves (through the visual-check subagent) before you build."
+  },
+  args: {
+    id: { type: "positional", description: "Section id from search", required: true },
+    full: {
+      type: "boolean",
+      description: "Include classification facets and reproduction notes",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id;
+      const data = await apiGet("/api/landing-inspiration/section", { id });
+      const section = data.section;
+      const dir = path.join(process.cwd(), ".baker", "inspiration", id);
+      const ext = READABLE_SHOT.extension;
+      const [desktop, mobile, filmstrip] = await Promise.all([
+        downloadReadableShot(section.desktopShotUrl, path.join(dir, `desktop.${ext}`)),
+        downloadReadableShot(section.mobileShotUrl, path.join(dir, `mobile.${ext}`)),
+        downloadReadableShot(section.motionFilmstripUrl, path.join(dir, `motion-filmstrip.${ext}`))
+      ]);
+      const full = args.full;
+      const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
+      const [desktopHint, filmstripHint] = viewShotHints({ desktop, filmstrip });
+      if (desktopHint) hints.push(desktopHint);
+      hints.push("Need the mechanics? `baker landing inspiration code <id>` writes the standalone HTML+CSS to disk.");
+      const fidelity = fidelityHint(section.fidelity);
+      if (fidelity) hints.push(fidelity);
+      if (filmstripHint) hints.push(filmstripHint);
+      writeJson({
+        ok: true,
+        data: {
+          id: section.id,
+          page_id: section.sourceId,
+          section: section.sectionType,
+          composition: section.composition,
+          look: section.visualRegister,
+          motion: section.motionSummary,
+          design_tokens: section.designTokens,
+          size: section.boundingBox,
+          copy: {
+            headline: section.headline,
+            subhead: section.subhead,
+            ctas: section.ctaLabels,
+            proof: section.proofSignals
+          },
+          why_it_works: section.whyItWorks,
+          adaptation_notes: section.adaptationNotes,
+          craft: section.craftScore,
+          fidelity: section.fidelity,
+          source_url: section.sourceUrl,
+          screenshots: { desktop, mobile, motion_filmstrip: filmstrip },
+          // Behind --full: exactly the block `search` already gates, plus the
+          // reproduction notes, which `code` returns again for the one caller
+          // that acts on them. Everything above is what you design *from*;
+          // these are how the section was filed and how it rebuilds.
+          ...full ? {
+            theme: section.theme,
+            density: section.density,
+            show_tell_rank: section.showTellRank,
+            interactions: section.interactions,
+            media: section.mediaKinds,
+            devices: section.contentDevices,
+            tags: section.tags,
+            reproduction_notes: section.reproductionNotes
+          } : {}
+        },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  viewCommand,
+  viewShotHints
+};
+//# sourceMappingURL=view-YR6MDLWL.js.map

package/dist/viewer-check-IDXFRRCO.js

@@ -0,0 +1,83 @@
+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-XWAOECD2.js";
+import "./chunk-JT3UUBID.js";
+import "./chunk-VAURJ4QJ.js";
+import "./chunk-6MJKVNLL.js";
+import "./chunk-RVIBHENP.js";
+import "./chunk-BNEWJXKU.js";
+import "./chunk-ITIUWJGQ.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-BIBXZJZI.js";
+import "./chunk-Q3G4ZI2U.js";
+import "./chunk-DGHSXHZR.js";
+import "./chunk-JGK2FDZW.js";
+import "./chunk-47VWQ7FQ.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-Q736UFSD.js";
+import "./chunk-CBVUO7SK.js";
+import "./chunk-UK4XSLV2.js";
+import "./chunk-O5VSYBUA.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import "./chunk-NXNOXZGB.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-IDXFRRCO.js.map

package/dist/web-VMPKMBKA.js

@@ -0,0 +1,173 @@
+import {
+  webDepthHints,
+  webSourceHints
+} from "./chunk-LQACNCAV.js";
+import {
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson
+} from "./chunk-MTW2NDDD.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.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. Each source is the page itself plus the part of the answer it backs. Depths: medium (a fast model, quick, default), high (the same model thinking longer \u2014 not a stronger model), xhigh (a deep-research agent, minutes).",
+  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, resolved, cites}: url is the page Google read; cites are the parts of the answer that page backs (verbatim). resolved:false = an opaque Google link that could not be followed \u2014 do not cite it"
+};
+function webMarkdown(data) {
+  const lines = [data.answer];
+  if (data.sources.length > 0) {
+    lines.push("", "## Sources");
+    for (const s of data.sources) {
+      if (s.resolved === false) {
+        lines.push(`- ${s.title} \u2014 unresolved Google link, do not cite: ${s.url}`);
+        continue;
+      }
+      lines.push(`- [${s.title}](${s.url})`);
+      for (const cite of s.cites ?? []) lines.push(`  > "${cite}"`);
+    }
+  }
+  return `${lines.join("\n")}
+`;
+}
+var DEEP_RESEARCH_FINISHED = /* @__PURE__ */ new Set(["completed", "incomplete"]);
+var DEEP_RESEARCH_RUNNING = /* @__PURE__ */ new Set(["queued", "in_progress"]);
+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 (DEEP_RESEARCH_FINISHED.has(poll.status) && poll.result) {
+      return { data: poll.result, incomplete: poll.status === "incomplete" };
+    }
+    if (!DEEP_RESEARCH_RUNNING.has(poll.status)) {
+      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: a fast model with minimal thinking (default)
+  high    \u2014 The SAME model and the same web search, thinking longer. Not a stronger model:
+            it reasons more over similar sources, so do not present a high answer as better-sourced.
+  xhigh   \u2014 A deep-research agent: plans, searches and reads many pages, writes a cited report
+            (minutes; use sparingly)
+
+Sources: every source is the page itself (Google's redirect links are followed for you), with
+"cites" \u2014 the parts of the answer that page is attached to, verbatim. Cite a URL only for the
+claim it backs. resolved:false means the link could not be followed: do not cite it or guess a path.
+An answer with no sources is synthesis, not a citable fact.
+
+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, incomplete } = depth === "xhigh" ? await runDeepResearch(question) : {
+        data: await apiPost(
+          "/api/research/explore",
+          { question, depth },
+          { timeoutMs: TIMEOUT_MS[depth] }
+        ),
+        incomplete: false
+      };
+      const format = args.output || "json";
+      const hints = [
+        ...webSourceHints(data.sources),
+        ...incomplete ? ["Deep research stopped at its budget, so the end of this report may be missing \u2014 say so if you use it."] : [],
+        ...webDepthHints({ answer: data.answer, sourceCount: data.sources.length, depth })
+      ];
+      if (format === "md") {
+        process.stdout.write(webMarkdown(data));
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, hints });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  webCommand,
+  webMarkdown
+};
+//# sourceMappingURL=web-VMPKMBKA.js.map

package/dist/winners-4T5RFQXU.js

@@ -0,0 +1,113 @@
+import {
+  adFieldPlan,
+  adRows
+} from "./chunk-MSIOGH67.js";
+import {
+  reportError
+} from "./chunk-Q5XUFN2W.js";
+import {
+  apiGet
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema,
+  winningAdNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-NXNOXZGB.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-4T5RFQXU.js.map