@koda-sl/baker-cli 0.465.0 → 0.467.0

package/dist/search-L3RYKE3G.js

@@ -0,0 +1,174 @@
+import {
+  measureEmptyCorpus
+} from "./chunk-GZ6YS7TG.js";
+import {
+  activeFilterFlags
+} from "./chunk-Q6ULQMWG.js";
+import {
+  testimonialSourceTypeSchema
+} from "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  testimonialNormalizer,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/search.ts
+import { defineCommand } from "citty";
+var FILTER_FLAGS = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
+function languageBiasHint(results, requestedLanguage) {
+  if (requestedLanguage) {
+    return null;
+  }
+  const withLang = results.filter((r) => typeof r.language === "string" && r.language.length > 0);
+  if (withLang.length < 3) {
+    return null;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const r of withLang) {
+    const lang = r.language;
+    counts.set(lang, (counts.get(lang) ?? 0) + 1);
+  }
+  const [topLang, topCount] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? ["", 0];
+  if (topLang && topCount / withLang.length >= 0.8) {
+    return `Results skew ${topLang} (${topCount}/${withLang.length}). If you're sourcing quotes for a specific market, pass --language <code> (e.g. --language en) so the ad's language matches its audience.`;
+  }
+  return null;
+}
+registerSchema({
+  command: "testimonials.search",
+  description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results to return", required: false, default: 10 },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false,
+      enum: [...testimonialSourceTypeSchema.options]
+    },
+    "rating-min": { type: "number", description: "Minimum star rating (1-5)", required: false },
+    "rating-max": { type: "number", description: "Maximum star rating (1-5)", required: false },
+    status: {
+      type: "string",
+      description: "Filter by status: pending|processing|ready|error",
+      required: false,
+      enum: ["pending", "processing", "ready", "error"]
+    },
+    sentiment: {
+      type: "string",
+      description: "Filter: positive|neutral|negative",
+      required: false,
+      enum: ["positive", "neutral", "negative"]
+    },
+    language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
+  }
+});
+function buildSearchRequest(query, args) {
+  const body = { query };
+  if (args.limit !== void 0) {
+    body.limit = Number(args.limit);
+  }
+  if (args.source) {
+    body.source = args.source;
+  }
+  if (args["rating-min"] !== void 0) {
+    body.rating_min = Number(args["rating-min"]);
+  }
+  if (args["rating-max"] !== void 0) {
+    body.rating_max = Number(args["rating-max"]);
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  if (args.sentiment) {
+    body.sentiment = args.sentiment;
+  }
+  if (args.language) {
+    body.language = args.language;
+  }
+  if (args.tags) {
+    body.tags = args.tags.split(",").filter(Boolean);
+  }
+  return body;
+}
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 10)", required: false },
+    source: {
+      type: "string",
+      description: `Filter by source: ${testimonialSourceTypeSchema.options.join("|")}`,
+      required: false
+    },
+    "rating-min": { type: "string", description: "Minimum star rating (1-5)", required: false },
+    "rating-max": { type: "string", description: "Maximum star rating (1-5)", required: false },
+    status: { type: "string", description: "Filter by status: pending|processing|ready|error", required: false },
+    sentiment: { type: "string", description: "Filter: positive|neutral|negative", required: false },
+    language: { type: "string", description: "Filter by language code (e.g. en, es)", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: 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 full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = buildSearchRequest(query, args);
+      const data = await apiPost("/api/testimonials/search", body);
+      const languageHint = languageBiasHint(data, body.language);
+      const { hints: emptyHints, empty } = await measureEmptyCorpus({
+        command: "search",
+        resultCount: data.length,
+        activeFilters: activeFilterFlags(args, FILTER_FLAGS)
+      });
+      const hints = [...emptyHints, ...languageHint ? [languageHint] : []];
+      const outputFormat = args.output || "json";
+      writeOutput(
+        { ok: true, data, ...empty ? { meta: { empty } } : {}, ...hints.length > 0 ? { hints } : {} },
+        outputFormat,
+        args.fields ? args.fields.split(",") : void 0,
+        args.full,
+        testimonialNormalizer
+      );
+      if (outputFormat !== "json") {
+        for (const hint of hints) {
+          process.stderr.write(`${hint}
+`);
+        }
+      }
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  searchCommand
+};
+//# sourceMappingURL=search-L3RYKE3G.js.map

package/dist/search-L3RYKE3G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/testimonials/search.ts"],"sourcesContent":["import {\n  type TestimonialsSearchRequest,\n  type TestimonialsSearchResponse,\n  testimonialSourceTypeSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { type OutputFormat, testimonialNormalizer, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { activeFilterFlags } from \"../images/searchHints.ts\";\nimport { measureEmptyCorpus } from \"./emptyCorpusHints.ts\";\n\nconst FILTER_FLAGS = [\"source\", \"rating-min\", \"rating-max\", \"status\", \"sentiment\", \"language\", \"tags\"];\n\n/**\n * Hybrid search reranks over this company's whole corpus with no language\n * awareness, so a corpus seeded in one language returns that language even for\n * an English query. When the caller didn't pin a `--language` and the results\n * clearly skew to one, nudge them to scope by the target market's language —\n * otherwise a Spanish/French-heavy corpus silently starves a market-specific ad\n * of on-language quotes.\n */\nfunction languageBiasHint(results: TestimonialsSearchResponse, requestedLanguage: string | undefined): string | null {\n  if (requestedLanguage) {\n    return null;\n  }\n  const withLang = results.filter((r) => typeof r.language === \"string\" && r.language.length > 0);\n  if (withLang.length < 3) {\n    return null;\n  }\n  const counts = new Map<string, number>();\n  for (const r of withLang) {\n    const lang = r.language as string;\n    counts.set(lang, (counts.get(lang) ?? 0) + 1);\n  }\n  const [topLang, topCount] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? [\"\", 0];\n  if (topLang && topCount / withLang.length >= 0.8) {\n    return `Results skew ${topLang} (${topCount}/${withLang.length}). If you're sourcing quotes for a specific market, pass --language <code> (e.g. --language en) so the ad's language matches its audience.`;\n  }\n  return null;\n}\n\nregisterSchema({\n  command: \"testimonials.search\",\n  description: \"Search testimonials by text query. Uses hybrid BM25 + vector + reranking.\",\n  args: {\n    query: { type: \"string\", description: \"Search query text\", required: true },\n    limit: { type: \"number\", description: \"Maximum results to return\", required: false, default: 10 },\n    source: {\n      type: \"string\",\n      description: `Filter by source: ${testimonialSourceTypeSchema.options.join(\"|\")}`,\n      required: false,\n      enum: [...testimonialSourceTypeSchema.options],\n    },\n    \"rating-min\": { type: \"number\", description: \"Minimum star rating (1-5)\", required: false },\n    \"rating-max\": { type: \"number\", description: \"Maximum star rating (1-5)\", required: false },\n    status: {\n      type: \"string\",\n      description: \"Filter by status: pending|processing|ready|error\",\n      required: false,\n      enum: [\"pending\", \"processing\", \"ready\", \"error\"],\n    },\n    sentiment: {\n      type: \"string\",\n      description: \"Filter: positive|neutral|negative\",\n      required: false,\n      enum: [\"positive\", \"neutral\", \"negative\"],\n    },\n    language: { type: \"string\", description: \"Filter by language code (e.g. en, es)\", required: false },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n  },\n});\n\n/** Assemble the search request body from CLI args, applying only the flags that were provided. */\nfunction buildSearchRequest(query: string, args: Record<string, unknown>): TestimonialsSearchRequest {\n  const body: TestimonialsSearchRequest = { query };\n  if (args.limit !== undefined) {\n    body.limit = Number(args.limit);\n  }\n  if (args.source) {\n    body.source = args.source as TestimonialsSearchRequest[\"source\"];\n  }\n  if (args[\"rating-min\"] !== undefined) {\n    body.rating_min = Number(args[\"rating-min\"]);\n  }\n  if (args[\"rating-max\"] !== undefined) {\n    body.rating_max = Number(args[\"rating-max\"]);\n  }\n  if (args.status) {\n    body.status = args.status as TestimonialsSearchRequest[\"status\"];\n  }\n  if (args.sentiment) {\n    body.sentiment = args.sentiment as TestimonialsSearchRequest[\"sentiment\"];\n  }\n  if (args.language) {\n    body.language = args.language as string;\n  }\n  if (args.tags) {\n    body.tags = (args.tags as string).split(\",\").filter(Boolean);\n  }\n  return body;\n}\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description:\n      \"Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query text\", required: false },\n    limit: { type: \"string\", description: \"Max results (default 10)\", required: false },\n    source: {\n      type: \"string\",\n      description: `Filter by source: ${testimonialSourceTypeSchema.options.join(\"|\")}`,\n      required: false,\n    },\n    \"rating-min\": { type: \"string\", description: \"Minimum star rating (1-5)\", required: false },\n    \"rating-max\": { type: \"string\", description: \"Maximum star rating (1-5)\", required: false },\n    status: { type: \"string\", description: \"Filter by status: pending|processing|ready|error\", required: false },\n    sentiment: { type: \"string\", description: \"Filter: positive|neutral|negative\", required: false },\n    language: { type: \"string\", description: \"Filter by language code (e.g. en, es)\", required: false },\n    tags: { type: \"string\", description: \"Comma-separated tags to filter by\", required: false },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Search query is required\" } });\n        process.exit(1);\n      }\n\n      const body = buildSearchRequest(query, args);\n      const data = await apiPost<TestimonialsSearchResponse>(\"/api/testimonials/search\", body);\n      const languageHint = languageBiasHint(data, body.language);\n      const { hints: emptyHints, empty } = await measureEmptyCorpus({\n        command: \"search\",\n        resultCount: data.length,\n        activeFilters: activeFilterFlags(args, FILTER_FLAGS),\n      });\n      const hints = [...emptyHints, ...(languageHint ? [languageHint] : [])];\n      const outputFormat = (args.output as OutputFormat) || \"json\";\n      writeOutput(\n        { ok: true, data, ...(empty ? { meta: { empty } } : {}), ...(hints.length > 0 ? { hints } : {}) },\n        outputFormat,\n        args.fields ? args.fields.split(\",\") : undefined,\n        args.full as boolean,\n        testimonialNormalizer,\n      );\n      // md/files render only the table, so hints (which never reach the table)\n      // go to stderr — otherwise `--output md` hides the language skew, and an\n      // empty result prints a header row and nothing else.\n      if (outputFormat !== \"json\") {\n        for (const hint of hints) {\n          process.stderr.write(`${hint}\\n`);\n        }\n      }\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,SAAS,qBAAqB;AAO9B,IAAM,eAAe,CAAC,UAAU,cAAc,cAAc,UAAU,aAAa,YAAY,MAAM;AAUrG,SAAS,iBAAiB,SAAqC,mBAAsD;AACnH,MAAI,mBAAmB;AACrB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,QAAQ,OAAO,CAAC,MAAM,OAAO,EAAE,aAAa,YAAY,EAAE,SAAS,SAAS,CAAC;AAC9F,MAAI,SAAS,SAAS,GAAG;AACvB,WAAO;AAAA,EACT;AACA,QAAM,SAAS,oBAAI,IAAoB;AACvC,aAAW,KAAK,UAAU;AACxB,UAAM,OAAO,EAAE;AACf,WAAO,IAAI,OAAO,OAAO,IAAI,IAAI,KAAK,KAAK,CAAC;AAAA,EAC9C;AACA,QAAM,CAAC,SAAS,QAAQ,IAAI,CAAC,GAAG,OAAO,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;AAC1F,MAAI,WAAW,WAAW,SAAS,UAAU,KAAK;AAChD,WAAO,gBAAgB,OAAO,KAAK,QAAQ,IAAI,SAAS,MAAM;AAAA,EAChE;AACA,SAAO;AACT;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,UAAU,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAC1E,OAAO,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,GAAG;AAAA,IAChG,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa,qBAAqB,4BAA4B,QAAQ,KAAK,GAAG,CAAC;AAAA,MAC/E,UAAU;AAAA,MACV,MAAM,CAAC,GAAG,4BAA4B,OAAO;AAAA,IAC/C;AAAA,IACA,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM,CAAC,WAAW,cAAc,SAAS,OAAO;AAAA,IAClD;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM,CAAC,YAAY,WAAW,UAAU;AAAA,IAC1C;AAAA,IACA,UAAU,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IAClG,MAAM,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,EAC5F;AACF,CAAC;AAGD,SAAS,mBAAmB,OAAe,MAA0D;AACnG,QAAM,OAAkC,EAAE,MAAM;AAChD,MAAI,KAAK,UAAU,QAAW;AAC5B,SAAK,QAAQ,OAAO,KAAK,KAAK;AAAA,EAChC;AACA,MAAI,KAAK,QAAQ;AACf,SAAK,SAAS,KAAK;AAAA,EACrB;AACA,MAAI,KAAK,YAAY,MAAM,QAAW;AACpC,SAAK,aAAa,OAAO,KAAK,YAAY,CAAC;AAAA,EAC7C;AACA,MAAI,KAAK,YAAY,MAAM,QAAW;AACpC,SAAK,aAAa,OAAO,KAAK,YAAY,CAAC;AAAA,EAC7C;AACA,MAAI,KAAK,QAAQ;AACf,SAAK,SAAS,KAAK;AAAA,EACrB;AACA,MAAI,KAAK,WAAW;AAClB,SAAK,YAAY,KAAK;AAAA,EACxB;AACA,MAAI,KAAK,UAAU;AACjB,SAAK,WAAW,KAAK;AAAA,EACvB;AACA,MAAI,KAAK,MAAM;AACb,SAAK,OAAQ,KAAK,KAAgB,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,EAC7D;AACA,SAAO;AACT;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,cAAc,aAAa,qBAAqB,UAAU,MAAM;AAAA,IAC/E,OAAO,EAAE,MAAM,UAAU,aAAa,4BAA4B,UAAU,MAAM;AAAA,IAClF,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,aAAa,qBAAqB,4BAA4B,QAAQ,KAAK,GAAG,CAAC;AAAA,MAC/E,UAAU;AAAA,IACZ;AAAA,IACA,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,cAAc,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,MAAM;AAAA,IAC1F,QAAQ,EAAE,MAAM,UAAU,aAAa,oDAAoD,UAAU,MAAM;AAAA,IAC3G,WAAW,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IAC/F,UAAU,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IAClG,MAAM,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IAC1F,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,IACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IACjG,MAAM,EAAE,MAAM,WAAW,aAAa,yBAAyB,UAAU,OAAO,SAAS,MAAM;AAAA,EACjG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,QAAQ,KAAK;AACnB,UAAI,CAAC,OAAO;AACV,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,SAAS,2BAA2B,EAAE,CAAC;AACjG,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,OAAO,mBAAmB,OAAO,IAAI;AAC3C,YAAM,OAAO,MAAM,QAAoC,4BAA4B,IAAI;AACvF,YAAM,eAAe,iBAAiB,MAAM,KAAK,QAAQ;AACzD,YAAM,EAAE,OAAO,YAAY,MAAM,IAAI,MAAM,mBAAmB;AAAA,QAC5D,SAAS;AAAA,QACT,aAAa,KAAK;AAAA,QAClB,eAAe,kBAAkB,MAAM,YAAY;AAAA,MACrD,CAAC;AACD,YAAM,QAAQ,CAAC,GAAG,YAAY,GAAI,eAAe,CAAC,YAAY,IAAI,CAAC,CAAE;AACrE,YAAM,eAAgB,KAAK,UAA2B;AACtD;AAAA,QACE,EAAE,IAAI,MAAM,MAAM,GAAI,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAI,GAAI,MAAM,SAAS,IAAI,EAAE,MAAM,IAAI,CAAC,EAAG;AAAA,QAChG;AAAA,QACA,KAAK,SAAS,KAAK,OAAO,MAAM,GAAG,IAAI;AAAA,QACvC,KAAK;AAAA,QACL;AAAA,MACF;AAIA,UAAI,iBAAiB,QAAQ;AAC3B,mBAAW,QAAQ,OAAO;AACxB,kBAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAAA,QAClC;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,kBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,gBAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,kBAAkB,SAAS,mBAAmB,EAAE,CAAC;AACvF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/search-copy-QZXCAGK4.js

@@ -0,0 +1,168 @@
+import {
+  reportError
+} from "./chunk-G3KO2HFZ.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  searchCopyPartKindSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.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. Each list opens with its first --limit rows; `part_totals` says how many there are in all, and `--part <kind> --offset <n>` reads the next page of one list (`next_offset` until the end). Compact by default; --running keeps what still runs; --full adds dates, the addresses the ads show and running counts. Google publishes no search ad's destination, only the address printed on it, so a `landing` is that address and may not be a real page.";
+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 },
+    part: {
+      type: "string",
+      description: "Read one list a page at a time: headlines|descriptions|sitelinks|callouts",
+      required: false
+    },
+    offset: { type: "number", description: "With --part: rows to skip (the last page's next_offset)", required: false },
+    running: { type: "boolean", description: "Only what still runs", required: false, default: false },
+    full: { type: "boolean", description: "Dates, the addresses the ads show and running counts", required: false }
+  }
+});
+var PART_KINDS = searchCopyPartKindSchema.options;
+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,
+    ...copy.part_totals ? { part_totals: copy.part_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 searchCopyPageView(page, opts) {
+  const end = page.offset + page.parts.length;
+  const parts = page.parts.filter((p) => !opts.running || p.status === "running");
+  return {
+    advertiser_id: page.advertiser_id,
+    part: page.part,
+    offset: page.offset,
+    total: page.total,
+    next_offset: end < page.total ? end : null,
+    parts: opts.full ? parts : parts.map((p) => ({ text: p.text, ...p.hook ? { hook: p.hook } : {}, status: p.status, ads: p.ads }))
+  };
+}
+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>"`) 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`."
+  );
+  for (const kind of PART_KINDS) {
+    const listed = copy[kind].length;
+    const total = copy.part_totals?.[kind] ?? listed;
+    if (total > listed) {
+      hints.push(
+        `${kind}: ${listed} of ${total} listed. Next page: \`baker winning-ads search-copy ${copy.advertiser_id} --part ${kind} --offset ${listed}\` \u2014 never call ${listed} the whole list.`
+      );
+    }
+  }
+  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 \xB7 next page of one list: --part sitelinks --offset 15"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    limit: { type: "string", description: "Rows per list 1-100 (default 15)", required: false },
+    part: {
+      type: "string",
+      description: "One list a page at a time: headlines|descriptions|sitelinks|callouts",
+      required: false
+    },
+    offset: { type: "string", description: "With --part: rows to skip (the last page's next_offset)", 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);
+      if (args.part) {
+        const page = await apiGet("/api/ad-library/advertiser-search-copy/page", {
+          ...params,
+          part: String(args.part),
+          offset: String(args.offset ?? 0)
+        });
+        const view = searchCopyPageView(page, { full: Boolean(args.full), running: Boolean(args.running) });
+        writeJson({
+          ok: true,
+          data: view,
+          hints: view.next_offset === null ? [`That was the last of ${page.total} ${page.part}.`] : [
+            `Next page: \`baker winning-ads search-copy ${page.advertiser_id} --part ${page.part} --offset ${view.next_offset}\``
+          ]
+        });
+        return;
+      }
+      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,
+  searchCopyPageView,
+  searchCopyView
+};
+//# sourceMappingURL=search-copy-QZXCAGK4.js.map

package/dist/seeds-VUNZMHZH.js

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

package/dist/select-IAHFSSDX.js

@@ -0,0 +1,94 @@
+import {
+  versionOf
+} from "./chunk-ZFIYN7KP.js";
+import "./chunk-EXZ2NIKX.js";
+import "./chunk-KCCWCK6L.js";
+import "./chunk-ZLU5QDLU.js";
+import "./chunk-5Q3XCLMS.js";
+import "./chunk-UUBFYAVE.js";
+import "./chunk-D5MF337I.js";
+import "./chunk-VHMNSO2B.js";
+import "./chunk-65BQAJMH.js";
+import "./chunk-GWM4DCAK.js";
+import "./chunk-4FCLXJYW.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-AQ4HEXUH.js";
+import "./chunk-CHSNHVYF.js";
+import "./chunk-73B3RQJC.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-6GFJFTG6.js";
+import "./chunk-NAMEFVWL.js";
+import "./chunk-GT4UFORX.js";
+import "./chunk-CECS3DHZ.js";
+import {
+  creativesSelectRequestSchema
+} from "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.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-IAHFSSDX.js.map

package/dist/select-IAHFSSDX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/select.ts"],"sourcesContent":["import { type CreativesSelectResponse, creativesSelectRequestSchema } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { versionOf } from \"./version-of.ts\";\n\nconst 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.\nStart here: baker creatives select --slug spring-offer\nOnly some options of a version that made several: --options \"ugc,2\" (labels or numbers). Naming options again replaces the earlier pick.`;\n\nconst ARGS = {\n  slug: { type: \"string\", description: \"The creative: its folder name under src/creatives/.\", required: true },\n  run: {\n    type: \"string\",\n    description:\n      \"The version to keep: its canvas run id (r_…) Left out, the version the creative shows now (its last render).\",\n    required: false,\n  },\n  options: {\n    type: \"string\",\n    description:\n      'Keep only these options of the version, comma-separated: labels (\"ugc\"), numbers (\"2\") or slots. Left out, the whole version.',\n    required: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.select\", description: DESCRIPTION, args: ARGS });\n\nfunction fail(code: string, message: string): never {\n  writeJson({ ok: false, error: { code, message } });\n  process.exit(1);\n}\n\nexport const selectCommand = defineCommand({\n  meta: { name: \"select\", description: DESCRIPTION },\n  args: ARGS,\n  run: async ({ args }) => {\n    const options =\n      typeof args.options === \"string\"\n        ? args.options\n            .split(\",\")\n            .map((option) => option.trim())\n            .filter((option) => option.length > 0)\n        : [];\n    const parsed = creativesSelectRequestSchema.safeParse({\n      slug: args.slug,\n      runId: await versionOf(String(args.slug), args.run).then(\n        (run) => run ?? fail(\"VALIDATION_ERROR\", \"--run: this creative has no rendered version here; name one (r_…).\"),\n      ),\n      ...(options.length > 0 ? { options } : {}),\n    });\n    if (!parsed.success) {\n      const issue = parsed.error.issues[0];\n      fail(\"VALIDATION_ERROR\", `--${String(issue?.path[0] ?? \"args\")}: ${issue?.message ?? \"invalid\"}`);\n    }\n    try {\n      const response = await apiPost<CreativesSelectResponse>(\"/api/creatives/select\", parsed.data);\n      writeJson(response);\n    } catch (err) {\n      if (err instanceof ApiError) fail(err.code, err.message);\n      fail(\"INTERNAL_ERROR\", \"Unexpected error\");\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,IAAM,cAAc;AAAA;AAAA;AAIpB,IAAM,OAAO;AAAA,EACX,MAAM,EAAE,MAAM,UAAU,aAAa,uDAAuD,UAAU,KAAK;AAAA,EAC3G,KAAK;AAAA,IACH,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aACE;AAAA,IACF,UAAU;AAAA,EACZ;AACF;AAEA,eAAe,EAAE,SAAS,oBAAoB,aAAa,aAAa,MAAM,KAAK,CAAC;AAEpF,SAAS,KAAK,MAAc,SAAwB;AAClD,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,QAAQ,EAAE,CAAC;AACjD,UAAQ,KAAK,CAAC;AAChB;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM,EAAE,MAAM,UAAU,aAAa,YAAY;AAAA,EACjD,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UACJ,OAAO,KAAK,YAAY,WACpB,KAAK,QACF,MAAM,GAAG,EACT,IAAI,CAAC,WAAW,OAAO,KAAK,CAAC,EAC7B,OAAO,CAAC,WAAW,OAAO,SAAS,CAAC,IACvC,CAAC;AACP,UAAM,SAAS,6BAA6B,UAAU;AAAA,MACpD,MAAM,KAAK;AAAA,MACX,OAAO,MAAM,UAAU,OAAO,KAAK,IAAI,GAAG,KAAK,GAAG,EAAE;AAAA,QAClD,CAAC,QAAQ,OAAO,KAAK,oBAAoB,yEAAoE;AAAA,MAC/G;AAAA,MACA,GAAI,QAAQ,SAAS,IAAI,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC1C,CAAC;AACD,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,QAAQ,OAAO,MAAM,OAAO,CAAC;AACnC,WAAK,oBAAoB,KAAK,OAAO,OAAO,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,OAAO,WAAW,SAAS,EAAE;AAAA,IAClG;AACA,QAAI;AACF,YAAM,WAAW,MAAM,QAAiC,yBAAyB,OAAO,IAAI;AAC5F,gBAAU,QAAQ;AAAA,IACpB,SAAS,KAAK;AACZ,UAAI,eAAe,SAAU,MAAK,IAAI,MAAM,IAAI,OAAO;AACvD,WAAK,kBAAkB,kBAAkB;AAAA,IAC3C;AAAA,EACF;AACF,CAAC;","names":[]}