@koda-sl/baker-cli 0.457.0 → 0.458.0

package/dist/search-W7E5S347.js

@@ -0,0 +1,224 @@
+import {
+  READABLE_SHOT,
+  downloadReadableShot
+} from "./chunk-DNCLWSHO.js";
+import {
+  INSPIRATION_HINTS,
+  favoritesScopeHints,
+  parseNumber,
+  reportError,
+  splitList
+} from "./chunk-SZX5LUHK.js";
+import {
+  apiPost
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/search.ts
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.search",
+  description: "Search the shared library of real landing-page sections for reference before you design. Start here: baker landing inspiration search 'pricing with a monthly/annual toggle'. Returns the idea behind each section plus a downloaded screenshot you can Read. Defaults to this company's saved sections; pass --scope all for the whole library.",
+  args: {
+    query: { type: "string", description: "What you want to see, in plain English", required: false },
+    type: {
+      type: "string",
+      description: "Comma list of section types: hero,pricing,faq,testimonials,\u2026",
+      required: false
+    },
+    composition: {
+      type: "string",
+      description: "Comma list of composition patterns (references/composition.md)",
+      required: false
+    },
+    register: {
+      type: "string",
+      description: "Comma list of visual registers: dev-tool-minimal,luxury-high-end,\u2026",
+      required: false
+    },
+    interaction: { type: "string", description: "Comma list of interaction patterns", required: false },
+    motion: {
+      type: "string",
+      description: "Comma list of motion kinds: scroll-reveal,marquee,parallax,\u2026",
+      required: false
+    },
+    media: { type: "string", description: "Comma list of media kinds", required: false },
+    device: { type: "string", description: "Comma list of content devices", required: false },
+    theme: { type: "string", description: "light | dark | mixed", required: false },
+    "max-rank": {
+      type: "number",
+      description: "Show>Tell rank ceiling 1-7; 3 means 'rank 3 or better'",
+      required: false
+    },
+    "min-craft": { type: "number", description: "Craft floor 0-1", required: false },
+    "min-fidelity": {
+      type: "number",
+      description: "Only sections whose markup reproduces this well (0-1)",
+      required: false
+    },
+    domain: { type: "string", description: "Restrict to one site", required: false },
+    "similar-to": {
+      type: "string",
+      description: "Section id \u2014 find sections that look like this one",
+      required: false
+    },
+    scope: { type: "string", description: "favorites (default) | all", required: false },
+    limit: { type: "number", description: "Max results (default 8)", required: false },
+    "no-images": { type: "boolean", description: "Skip downloading screenshots", required: false },
+    full: {
+      type: "boolean",
+      description: "Add every classification facet (theme, density, rank, interactions, media, devices, tags, headline)",
+      required: false
+    }
+  }
+});
+function buildSearchBody(args) {
+  const body = {};
+  const setList = (key, value) => {
+    const list = splitList(value);
+    if (list) Object.assign(body, { [key]: list });
+  };
+  if (args.query) body.query = String(args.query);
+  if (args["similar-to"]) body.similarToSectionId = String(args["similar-to"]);
+  setList("sectionType", args.type);
+  setList("composition", args.composition);
+  setList("visualRegister", args.register);
+  setList("interaction", args.interaction);
+  setList("motion", args.motion);
+  setList("mediaKind", args.media);
+  setList("contentDevice", args.device);
+  if (args.theme) body.theme = String(args.theme);
+  if (args.domain) body.domain = String(args.domain);
+  const maxRank = parseNumber(args["max-rank"]);
+  if (maxRank !== void 0) body.maxShowTellRank = maxRank;
+  const minCraft = parseNumber(args["min-craft"]);
+  if (minCraft !== void 0) body.minCraftScore = minCraft;
+  const minFidelity = parseNumber(args["min-fidelity"]);
+  if (minFidelity !== void 0) body.minFidelity = minFidelity;
+  const limit = parseNumber(args.limit);
+  body.limit = limit ?? 8;
+  body.scope = args.scope === "all" ? "all" : "favorites";
+  return body;
+}
+async function downloadShots(results) {
+  const dir = path.join(process.cwd(), ".baker", "inspiration");
+  const saved = /* @__PURE__ */ new Map();
+  await Promise.all(
+    results.map(async (result) => {
+      const file = await downloadReadableShot(
+        result.desktopShotUrl,
+        path.join(dir, `${result.id}.${READABLE_SHOT.extension}`)
+      );
+      if (file) saved.set(result.id, file);
+    })
+  );
+  return saved;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all"
+  },
+  args: {
+    query: { type: "positional", description: "What you want to see, in plain English", required: false },
+    type: { type: "string", description: "Comma list of section types", required: false },
+    composition: { type: "string", description: "Comma list of composition patterns", required: false },
+    register: { type: "string", description: "Comma list of visual registers", required: false },
+    interaction: { type: "string", description: "Comma list of interaction patterns", required: false },
+    motion: { type: "string", description: "Comma list of motion kinds", required: false },
+    media: { type: "string", description: "Comma list of media kinds", required: false },
+    device: { type: "string", description: "Comma list of content devices", required: false },
+    theme: { type: "string", description: "light | dark | mixed", required: false },
+    "max-rank": { type: "string", description: "Show>Tell rank ceiling 1-7", required: false },
+    "min-craft": { type: "string", description: "Craft floor 0-1", required: false },
+    "min-fidelity": { type: "string", description: "Reproduction-fidelity floor 0-1", required: false },
+    domain: { type: "string", description: "Restrict to one site", required: false },
+    "similar-to": { type: "string", description: "Section id to find lookalikes of", required: false },
+    scope: { type: "string", description: "favorites (default) | all", required: false, default: "favorites" },
+    limit: { type: "string", description: "Max results (default 8)", required: false },
+    "no-images": { type: "boolean", description: "Skip downloading screenshots", required: false, default: false },
+    full: { type: "boolean", description: "Include every classification facet", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = buildSearchBody(args);
+      const data = await apiPost("/api/landing-inspiration/search", body);
+      const results = Array.isArray(data?.results) ? data.results : [];
+      const shots = args["no-images"] ? /* @__PURE__ */ new Map() : await downloadShots(results);
+      const full = args.full;
+      const rows = results.map((result) => ({
+        id: result.id,
+        // The id `page` takes. Its own schema says "from a search result's source
+        // id", and until this line no projection emitted one — so the ordering
+        // view could only be reached straight after `add`, never from a search.
+        page_id: result.sourceId,
+        section: result.sectionType,
+        composition: result.composition,
+        look: result.visualRegister,
+        motion: result.motionSummary,
+        why_it_works: result.whyItWorks,
+        craft: Number(result.craftScore?.toFixed?.(2) ?? result.craftScore),
+        fidelity: result.fidelity,
+        domain: result.domain,
+        // Only worth saying when it means something: >1 marks a section the site
+        // reuses across its pages, which is a stronger signal than a one-off.
+        ...result.pageCount > 1 ? { used_on_pages: result.pageCount } : {},
+        // With --no-images there is no file, so hand back the URL instead. A row
+        // with neither is a section the agent is asked to judge sight unseen,
+        // which is the one thing a visual library must never produce.
+        ...args["no-images"] ? { screenshot_url: result.desktopShotUrl ?? null } : { screenshot: shots.get(result.id) ?? null },
+        ...full ? {
+          theme: result.theme,
+          density: result.density,
+          show_tell_rank: result.showTellRank,
+          interactions: result.interactions,
+          media: result.mediaKinds,
+          devices: result.contentDevices,
+          tags: result.tags,
+          headline: result.headline,
+          source_url: result.sourceUrl
+        } : {}
+      }));
+      const hints = [INSPIRATION_HINTS.adapt];
+      const scopeHints = body.scope === "favorites" ? favoritesScopeHints(data.favoritesHealth, rows.length) : [];
+      if (scopeHints.length > 0) {
+        hints.push(...scopeHints);
+      } else if (rows.length === 0) {
+        hints.push(
+          body.scope === "favorites" ? "No matches in this company's saved sections. Retry with --scope all to search the whole library, or add a page with `baker landing inspiration add <url>`." : "No matches. Loosen the filters, or add reference pages with `baker landing inspiration add <url>`."
+        );
+      }
+      if (rows.length > 0 && data.moreInFullLibrary > 0) {
+        hints.push(`${data.moreInFullLibrary} more match in the full library \u2014 re-run with --scope all.`);
+      }
+      if (shots.size > 0) hints.push(`Screenshots saved to .baker/inspiration/ \u2014 Read them before deciding.`);
+      writeJson({
+        ok: true,
+        data: {
+          results: rows,
+          scope: data.scope,
+          more_in_full_library: data.moreInFullLibrary,
+          total: data.total,
+          // Only present when there was something to explain, so a healthy
+          // search pays nothing for it.
+          ...data.favoritesHealth ? { saved_pages: data.favoritesHealth } : {}
+        },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  buildSearchBody,
+  searchCommand
+};
+//# sourceMappingURL=search-W7E5S347.js.map

package/dist/search-copy-LXBPFQC3.js

@@ -0,0 +1,115 @@
+import {
+  reportError
+} from "./chunk-3FOE4P6A.js";
+import {
+  apiGet
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/search-copy.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "What one brand says on Google Search, read from its search ads: every headline with its hook (category, brand, free, price_discount, outcome, proof, new_timely, comparison, audience, location, feature, call_to_action, question), descriptions, sitelinks and callouts, each `running` or `dropped` (every ad that carried it has stopped: what the brand stopped paying for), with how many ads carried it and the longest any ran. Plus the hook mix of running vs dropped headlines and the headlines that name a rival. Compact by default; --running keeps what still runs; --full adds dates, every landing page and running counts.";
+registerSchema({
+  command: "winning-ads.search-copy",
+  description: DESCRIPTION,
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    limit: { type: "number", description: "Rows per list 1-100 (default 15)", required: false, default: 15 },
+    running: { type: "boolean", description: "Only what still runs", required: false, default: false },
+    full: { type: "boolean", description: "Dates, every landing page and running counts", required: false }
+  }
+});
+var keep = (running) => (p) => !running || p.status === "running";
+function compactSearchCopy(copy, opts) {
+  const brief = (p) => ({ text: p.text, status: p.status, ads: p.ads });
+  return {
+    advertiser_id: copy.advertiser_id,
+    totals: copy.totals,
+    headlines: copy.headlines.filter(keep(opts.running)).map((h) => ({
+      text: h.text,
+      hook: h.hook,
+      status: h.status,
+      ads: h.ads,
+      longest_days: h.longest_days,
+      landing: h.landing_pages[0] ?? null,
+      ad_id: h.example_ad_id,
+      ...h.names_rival ? { names_rival: true } : {}
+    })),
+    descriptions: copy.descriptions.filter(keep(opts.running)).map(brief),
+    sitelinks: copy.sitelinks.filter(keep(opts.running)).map(brief),
+    callouts: copy.callouts.filter(keep(opts.running)).map(brief),
+    hooks: copy.hooks,
+    rival_headlines: copy.rival_headlines
+  };
+}
+function searchCopyView(copy, opts) {
+  if (!opts.full) return compactSearchCopy(copy, { running: opts.running });
+  if (!opts.running) return copy;
+  const headlines = copy.headlines.filter(keep(true));
+  const live = new Set(headlines.map((h) => h.text));
+  return {
+    ...copy,
+    headlines,
+    descriptions: copy.descriptions.filter(keep(true)),
+    sitelinks: copy.sitelinks.filter(keep(true)),
+    callouts: copy.callouts.filter(keep(true)),
+    rival_headlines: copy.rival_headlines.filter((text) => live.has(text))
+  };
+}
+function searchCopyHints(copy) {
+  if (copy.totals.ads === 0) {
+    return [
+      'The library holds no Google search ads for this brand. Follow it on Google by its website (`baker winning-ads follow "<brand website>" --platform google`) and read again after the scan; for a one-off look, `baker research google-ads <domain> --copy`.'
+    ];
+  }
+  const hints = [];
+  const unread = copy.totals.ads - copy.totals.read;
+  if (unread > 0) {
+    hints.push(
+      `${unread} of ${copy.totals.ads} search ads are not read yet (extracted before their parts were read); the lists cover the other ${copy.totals.read}.`
+    );
+  }
+  hints.push(
+    "`dropped` is inferred: Google dates ads, not headlines. Read one ad whole with `baker winning-ads content <ad_id> --platform google`."
+  );
+  return hints;
+}
+var searchCopyCommand = defineCommand({
+  meta: {
+    name: "search-copy",
+    description: "What one brand says on Google Search: headlines with their hooks, descriptions, sitelinks and callouts, running or dropped. Start here: baker winning-ads search-copy adv_123 --running"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    limit: { type: "string", description: "Rows per list 1-100 (default 15)", required: false },
+    running: { type: "boolean", description: "Only what still runs", required: false, default: false },
+    full: { type: "boolean", description: "Dates, every landing page and running counts", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { id: String(args.advertiser) };
+      if (args.limit) params.limit = String(args.limit);
+      const copy = await apiGet("/api/ad-library/advertiser-search-copy", params);
+      writeJson({
+        ok: true,
+        data: searchCopyView(copy, { full: Boolean(args.full), running: Boolean(args.running) }),
+        hints: searchCopyHints(copy)
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  compactSearchCopy,
+  searchCopyCommand,
+  searchCopyHints,
+  searchCopyView
+};
+//# sourceMappingURL=search-copy-LXBPFQC3.js.map

package/dist/search-copy-LXBPFQC3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/search-copy.ts"],"sourcesContent":["import type { SearchCopyResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError } from \"./shared.ts\";\n\nconst DESCRIPTION =\n  \"What one brand says on Google Search, read from its search ads: every headline with its hook (category, brand, free, price_discount, outcome, proof, new_timely, comparison, audience, location, feature, call_to_action, question), descriptions, sitelinks and callouts, each `running` or `dropped` (every ad that carried it has stopped: what the brand stopped paying for), with how many ads carried it and the longest any ran. Plus the hook mix of running vs dropped headlines and the headlines that name a rival. Compact by default; --running keeps what still runs; --full adds dates, every landing page and running counts.\";\n\nregisterSchema({\n  command: \"winning-ads.search-copy\",\n  description: DESCRIPTION,\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id (from `advertisers` or `following`)\", required: true },\n    limit: { type: \"number\", description: \"Rows per list 1-100 (default 15)\", required: false, default: 15 },\n    running: { type: \"boolean\", description: \"Only what still runs\", required: false, default: false },\n    full: { type: \"boolean\", description: \"Dates, every landing page and running counts\", required: false },\n  },\n});\n\ntype Part = SearchCopyResponse[\"sitelinks\"][number];\n\nconst keep = (running: boolean) => (p: Part) => !running || p.status === \"running\";\n\n/** Per part, what a search strategy reads: the words, running or dropped, and how widely. */\nexport function compactSearchCopy(copy: SearchCopyResponse, opts: { running: boolean }) {\n  const brief = (p: Part) => ({ text: p.text, status: p.status, ads: p.ads });\n  return {\n    advertiser_id: copy.advertiser_id,\n    totals: copy.totals,\n    headlines: copy.headlines.filter(keep(opts.running)).map((h) => ({\n      text: h.text,\n      hook: h.hook,\n      status: h.status,\n      ads: h.ads,\n      longest_days: h.longest_days,\n      landing: h.landing_pages[0] ?? null,\n      ad_id: h.example_ad_id,\n      ...(h.names_rival ? { names_rival: true } : {}),\n    })),\n    descriptions: copy.descriptions.filter(keep(opts.running)).map(brief),\n    sitelinks: copy.sitelinks.filter(keep(opts.running)).map(brief),\n    callouts: copy.callouts.filter(keep(opts.running)).map(brief),\n    hooks: copy.hooks,\n    rival_headlines: copy.rival_headlines,\n  };\n}\n\n/** What `search-copy` prints: `--running` narrows the full view as much as the compact one. */\nexport function searchCopyView(copy: SearchCopyResponse, opts: { full: boolean; running: boolean }) {\n  if (!opts.full) return compactSearchCopy(copy, { running: opts.running });\n  if (!opts.running) return copy;\n  const headlines = copy.headlines.filter(keep(true));\n  const live = new Set(headlines.map((h) => h.text));\n  return {\n    ...copy,\n    headlines,\n    descriptions: copy.descriptions.filter(keep(true)),\n    sitelinks: copy.sitelinks.filter(keep(true)),\n    callouts: copy.callouts.filter(keep(true)),\n    rival_headlines: copy.rival_headlines.filter((text) => live.has(text)),\n  };\n}\n\nexport function searchCopyHints(copy: SearchCopyResponse): string[] {\n  if (copy.totals.ads === 0) {\n    return [\n      'The library holds no Google search ads for this brand. Follow it on Google by its website (`baker winning-ads follow \"<brand website>\" --platform google`) and read again after the scan; for a one-off look, `baker research google-ads <domain> --copy`.',\n    ];\n  }\n  const hints: string[] = [];\n  const unread = copy.totals.ads - copy.totals.read;\n  if (unread > 0) {\n    hints.push(\n      `${unread} of ${copy.totals.ads} search ads are not read yet (extracted before their parts were read); the lists cover the other ${copy.totals.read}.`,\n    );\n  }\n  hints.push(\n    \"`dropped` is inferred: Google dates ads, not headlines. Read one ad whole with `baker winning-ads content <ad_id> --platform google`.\",\n  );\n  return hints;\n}\n\nexport const searchCopyCommand = defineCommand({\n  meta: {\n    name: \"search-copy\",\n    description:\n      \"What one brand says on Google Search: headlines with their hooks, descriptions, sitelinks and callouts, running or dropped. Start here: baker winning-ads search-copy adv_123 --running\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id\", required: true },\n    limit: { type: \"string\", description: \"Rows per list 1-100 (default 15)\", required: false },\n    running: { type: \"boolean\", description: \"Only what still runs\", required: false, default: false },\n    full: { type: \"boolean\", description: \"Dates, every landing page and running counts\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = { id: String(args.advertiser) };\n      if (args.limit) params.limit = String(args.limit);\n      const copy = await apiGet<SearchCopyResponse>(\"/api/ad-library/advertiser-search-copy\", params);\n      writeJson({\n        ok: true,\n        data: searchCopyView(copy, { full: Boolean(args.full), running: Boolean(args.running) }),\n        hints: searchCopyHints(copy),\n      });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/seeds-Q6VS27LT.js

@@ -0,0 +1,101 @@
+import {
+  reportError
+} from "./chunk-3FOE4P6A.js";
+import {
+  apiGet
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/seeds.ts
+import { defineCommand } from "citty";
+function leanSeedRow(r) {
+  return {
+    key: r.key,
+    lift: r.lift,
+    brands_for: r.brands_for,
+    brands_against: r.brands_against,
+    count: r.count,
+    mean_winner_score: r.mean_winner_score,
+    winner_share: r.winner_share
+  };
+}
+function buildSeedParams(field, args) {
+  const params = { field };
+  if (args.platform) params.platform = String(args.platform);
+  if (args.awareness) params.awareness_stage = String(args.awareness);
+  if (args.industry) params.industry = String(args.industry);
+  if (args.limit) params.limit = String(args.limit);
+  return params;
+}
+function makeSeedCommand(opts) {
+  registerSchema({
+    command: `winning-ads.${opts.name}`,
+    description: opts.description,
+    args: {
+      platform: { type: "string", description: "Single platform (meta,linkedin,tiktok,google)", required: false },
+      awareness: { type: "string", description: "Single awareness stage", required: false },
+      industry: { type: "string", description: "Single industry seed", required: false },
+      limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
+    }
+  });
+  return defineCommand({
+    meta: { name: opts.name, description: opts.description },
+    args: {
+      platform: { type: "string", description: "Single platform to segment on", required: false },
+      awareness: { type: "string", description: "Single awareness stage to segment on", required: false },
+      industry: { type: "string", description: "Single industry seed to segment on", required: false },
+      limit: { type: "string", description: "Max keys 1-100 (default 20)", required: false, default: "20" },
+      output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+      full: { type: "boolean", description: "Include the segment breakdown per key", required: false, default: false }
+    },
+    run: async ({ args }) => {
+      try {
+        const params = buildSeedParams(opts.field, args);
+        const data = await apiGet("/api/ad-library/seed-catalog", params);
+        const rows = Array.isArray(data?.patterns) ? data.patterns : [];
+        const full = args.full;
+        const projected = rows.map((r) => full ? r : leanSeedRow(r));
+        const output = args.output || "json";
+        if (output === "json") {
+          writeJson({
+            ok: true,
+            data: { field: data?.field ?? opts.field, segment: data?.segment ?? null, patterns: projected }
+          });
+          return;
+        }
+        writeOutput({ ok: true, data: projected }, output);
+      } catch (err) {
+        reportError(err);
+      }
+    }
+  });
+}
+var hooksCommand = makeSeedCommand({
+  name: "hooks",
+  field: "hook_archetype",
+  description: "Top winner-weighted HOOK seeds for a segment (from the ad-dna pattern rollup). Ground a creative in a proven hook for the exact platform+awareness+industry, then feed the chosen seed to `search --hook-archetype`."
+});
+var mechanismsCommand = makeSeedCommand({
+  name: "mechanisms",
+  field: "mechanism_type",
+  description: "Top winner-weighted PRODUCT mechanism seeds for a segment: how the advertised product claims to work (proprietary formula, AI automated, done-for-you\u2026). Not the ad's persuasion device: for that use `hooks` and `formats`."
+});
+var formatsCommand = makeSeedCommand({
+  name: "formats",
+  field: "static_format_pattern",
+  description: "Top winner-weighted static ad FORMAT patterns for a segment (from the ad-dna pattern rollup)."
+});
+export {
+  formatsCommand,
+  hooksCommand,
+  leanSeedRow,
+  mechanismsCommand
+};
+//# sourceMappingURL=seeds-Q6VS27LT.js.map

package/dist/seeds-Q6VS27LT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/seeds.ts"],"sourcesContent":["import type { PatternSeed, SeedCatalogField, SeedCatalogResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { type OutputFormat, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError } from \"./shared.ts\";\n\n/**\n * Read the pattern rollup (ad-dna `pattern_stats`, exposed at\n * `/api/ad-library/seed-catalog`). One builder powers three named subcommands\n * (`hooks` / `mechanisms` / `formats`), each pinning a different taxonomy\n * `field`. It returns the SEED keys that win inside brands for a segment\n * (`lift`: how much more often a brand's creatives with the seed kept running\n * 60 days than its others; `brands_for` / `brands_against`), so the agent\n * grounds a creative in a PROVEN pattern for the exact\n * platform+awareness+industry — then still grounds it in a real reference. The\n * ranking is corpus data, not a hand-authored preset. Feed a hook seed to\n * `winning-ads search --hook-archetype` to narrow the search to that pattern.\n */\nexport function leanSeedRow(r: PatternSeed): Record<string, unknown> {\n  return {\n    key: r.key,\n    lift: r.lift,\n    brands_for: r.brands_for,\n    brands_against: r.brands_against,\n    count: r.count,\n    mean_winner_score: r.mean_winner_score,\n    winner_share: r.winner_share,\n  };\n}\n\ninterface SeedArgs {\n  platform?: unknown;\n  awareness?: unknown;\n  industry?: unknown;\n  limit?: unknown;\n}\n\n/** Build the `/api/ad-library/seed-catalog` query params, emitting only set keys. */\nfunction buildSeedParams(field: SeedCatalogField, args: SeedArgs): Record<string, string> {\n  const params: Record<string, string> = { field };\n  if (args.platform) params.platform = String(args.platform);\n  if (args.awareness) params.awareness_stage = String(args.awareness);\n  if (args.industry) params.industry = String(args.industry);\n  if (args.limit) params.limit = String(args.limit);\n  return params;\n}\n\nfunction makeSeedCommand(opts: { name: string; field: SeedCatalogField; description: string }) {\n  registerSchema({\n    command: `winning-ads.${opts.name}`,\n    description: opts.description,\n    args: {\n      platform: { type: \"string\", description: \"Single platform (meta,linkedin,tiktok,google)\", required: false },\n      awareness: { type: \"string\", description: \"Single awareness stage\", required: false },\n      industry: { type: \"string\", description: \"Single industry seed\", required: false },\n      limit: { type: \"number\", description: \"Max keys 1-100 (default 20)\", required: false, default: 20 },\n    },\n  });\n\n  return defineCommand({\n    meta: { name: opts.name, description: opts.description },\n    args: {\n      platform: { type: \"string\", description: \"Single platform to segment on\", required: false },\n      awareness: { type: \"string\", description: \"Single awareness stage to segment on\", required: false },\n      industry: { type: \"string\", description: \"Single industry seed to segment on\", required: false },\n      limit: { type: \"string\", description: \"Max keys 1-100 (default 20)\", required: false, default: \"20\" },\n      output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n      full: { type: \"boolean\", description: \"Include the segment breakdown per key\", required: false, default: false },\n    },\n    run: async ({ args }) => {\n      try {\n        const params = buildSeedParams(opts.field, args as SeedArgs);\n        const data = await apiGet<SeedCatalogResponse>(\"/api/ad-library/seed-catalog\", params);\n        const rows = Array.isArray(data?.patterns) ? data.patterns : [];\n        const full = args.full as boolean;\n        const projected = rows.map((r) => (full ? r : leanSeedRow(r)));\n        const output = (args.output as OutputFormat) || \"json\";\n\n        if (output === \"json\") {\n          writeJson({\n            ok: true,\n            data: { field: data?.field ?? opts.field, segment: data?.segment ?? null, patterns: projected },\n          });\n          return;\n        }\n        writeOutput({ ok: true, data: projected }, output);\n      } catch (err) {\n        reportError(err);\n      }\n    },\n  });\n}\n\nexport const hooksCommand = makeSeedCommand({\n  name: \"hooks\",\n  field: \"hook_archetype\",\n  description:\n    \"Top winner-weighted HOOK seeds for a segment (from the ad-dna pattern rollup). Ground a creative in a proven hook for the exact platform+awareness+industry, then feed the chosen seed to `search --hook-archetype`.\",\n});\n\nexport const mechanismsCommand = makeSeedCommand({\n  name: \"mechanisms\",\n  field: \"mechanism_type\",\n  description:\n    \"Top winner-weighted PRODUCT mechanism seeds for a segment: how the advertised product claims to work (proprietary formula, AI automated, done-for-you…). Not the ad's persuasion device: for that use `hooks` and `formats`.\",\n});\n\nexport const formatsCommand = makeSeedCommand({\n  name: \"formats\",\n  field: \"static_format_pattern\",\n  description: \"Top winner-weighted static ad FORMAT patterns for a segment (from the ad-dna pattern rollup).\",\n});\n"],"mappings":"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","names":[]}

package/dist/select-CB5BBKHR.js

@@ -0,0 +1,94 @@
+import {
+  versionOf
+} from "./chunk-WHOS7L4N.js";
+import "./chunk-ODMKCAAQ.js";
+import "./chunk-EMLM2TKM.js";
+import "./chunk-6C4S466W.js";
+import "./chunk-FZKC65TR.js";
+import "./chunk-MNCMAJKB.js";
+import "./chunk-GWFJAVWD.js";
+import "./chunk-RIXGQIMZ.js";
+import "./chunk-73JXX4LJ.js";
+import "./chunk-C2DAPBYB.js";
+import "./chunk-5TOKIRCD.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-KYQZM5FB.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-KNX2UBLI.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-5URIFBIL.js";
+import "./chunk-3KN3VCS3.js";
+import "./chunk-LCMGWIEQ.js";
+import "./chunk-HMKVVPWY.js";
+import {
+  creativesSelectRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-VAOMHPEX.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-TOYLG3ZY.js";
+import "./chunk-E4ICSNSW.js";
+import "./chunk-YKSIHGIL.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ZZFYDAJQ.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/select.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = `Choose the version of a creative to keep, and optionally which of its options, only when the user says to keep this version in this chat. The creative shows that version as the chosen one, and the choice counts as the user's approval. A version you render after it replaces it when the chat is published (the user saw that one last). It does not save the image to their library (that is baker creatives publish) and puts nothing into an ad.
+Start here: baker creatives select --slug spring-offer
+Only some options of a version that made several: --options "ugc,2" (labels or numbers). Naming options again replaces the earlier pick.`;
+var ARGS = {
+  slug: { type: "string", description: "The creative: its folder name under src/creatives/.", required: true },
+  run: {
+    type: "string",
+    description: "The version to keep: its canvas run id (r_\u2026) Left out, the version the creative shows now (its last render).",
+    required: false
+  },
+  options: {
+    type: "string",
+    description: 'Keep only these options of the version, comma-separated: labels ("ugc"), numbers ("2") or slots. Left out, the whole version.',
+    required: false
+  }
+};
+registerSchema({ command: "creatives.select", description: DESCRIPTION, args: ARGS });
+function fail(code, message) {
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+var selectCommand = defineCommand({
+  meta: { name: "select", description: DESCRIPTION },
+  args: ARGS,
+  run: async ({ args }) => {
+    const options = typeof args.options === "string" ? args.options.split(",").map((option) => option.trim()).filter((option) => option.length > 0) : [];
+    const parsed = creativesSelectRequestSchema.safeParse({
+      slug: args.slug,
+      runId: await versionOf(String(args.slug), args.run).then(
+        (run) => run ?? fail("VALIDATION_ERROR", "--run: this creative has no rendered version here; name one (r_\u2026).")
+      ),
+      ...options.length > 0 ? { options } : {}
+    });
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      fail("VALIDATION_ERROR", `--${String(issue?.path[0] ?? "args")}: ${issue?.message ?? "invalid"}`);
+    }
+    try {
+      const response = await apiPost("/api/creatives/select", parsed.data);
+      writeJson(response);
+    } catch (err) {
+      if (err instanceof ApiError) fail(err.code, err.message);
+      fail("INTERNAL_ERROR", "Unexpected error");
+    }
+  }
+});
+export {
+  selectCommand
+};
+//# sourceMappingURL=select-CB5BBKHR.js.map