@koda-sl/baker-cli 0.387.0 → 0.389.0-dev.8065ad8f0

package/dist/keyword-metrics-HLCM3QU7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/keyword-metrics.ts","../src/commands/research/keyword-metrics-rows.ts"],"sourcesContent":["import { RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS, type ResearchKeywordMetricsRow } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { keywordMetricsHints } from \"./hints.ts\";\nimport { keywordMetricsFields, toOutputRow } from \"./keyword-metrics-rows.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.keyword-metrics\",\n  description:\n    \"Search volume, CPC, top-of-page bids and competition for a list of keywords you name — no domain needed. This is the command for sizing a market you have keywords for; the domain-bound ones (keywords-for-site, keyword-gap) answer a different question and should not be used as a workaround for this one. The volume is Google's Keyword Planner figure resold by DataForSEO, so it is not a second opinion on `baker ads google keywords metrics` — for that, pass --clickstream. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.\",\n  args: {\n    keywords: {\n      type: \"string\",\n      description: `Comma-separated keywords (max ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS}, 80 chars each)`,\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, mx, br, es...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name. Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    clickstream: {\n      type: \"boolean\",\n      description:\n        \"Also return DataForSEO's own panel-derived volume (clickstream_search_volume), the only genuinely independent estimate of demand available here. Costs 2x.\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Add keyword difficulty, search intent and the 12-month volume trend to each row\",\n      required: false,\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\nexport const keywordMetricsCommand = defineCommand({\n  meta: {\n    name: \"keyword-metrics\",\n    description: `Volume, CPC and competition for keywords you name. No domain required.\n\nNumbers are Keyword Planner ESTIMATES of total market volume, resold by DataForSEO — every column carrying one is named planner_. Pass --clickstream for DataForSEO's own independent estimate alongside.\n\nExamples:\n  baker research keyword-metrics \"chatbot whatsapp,agente whatsapp ecommerce\" --location mx --language es\n  baker research keyword-metrics \"chatbot whatsapp\" --location br --language pt --clickstream\n  baker research keyword-metrics \"crm software,best crm\" --full --output md`,\n  },\n  args: {\n    keywords: { type: \"positional\", description: \"Comma-separated keywords\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    clickstream: { type: \"boolean\", description: \"Add DataForSEO's own volume estimate (costs 2x)\", required: false },\n    full: { type: \"boolean\", description: \"Add difficulty, intent and the 12-month trend\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const keywords = (args.keywords as string)\n      .split(\",\")\n      .map((k) => k.trim())\n      .filter(Boolean);\n\n    if (keywords.length === 0) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Provide at least one keyword\" },\n      });\n      process.exit(1);\n    }\n    if (keywords.length > RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: `Maximum ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} keywords per request`,\n          fix: {\n            action: \"retry_with_changes\",\n            explanation: `You sent ${keywords.length}. Split the list into batches of ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} and run the command once per batch — each batch is a separate charge, so batch by priority.`,\n          },\n        },\n      });\n      process.exit(1);\n    }\n\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const clickstream = Boolean(args.clickstream);\n    const full = Boolean(args.full);\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const result = await apiPost<{ data: ResearchKeywordMetricsRow[] }>(\"/api/research/keyword-metrics\", {\n        keywords,\n        location,\n        language,\n        includeClickstream: clickstream,\n        skipCache: args[\"no-cache\"] ? true : undefined,\n      });\n\n      const columns = { clickstream, full };\n      const rows = result.data.map((row) => toOutputRow(row, columns));\n      const hints = keywordMetricsHints({ rows: result.data, asked: keywords, clickstream, queryContext });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeResearchOutput(rows, format);\n        writeResearchHints([...hints, RESEARCH_DATA_NOTE], format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data: rows,\n        fields: keywordMetricsFields(columns),\n        note: RESEARCH_DATA_NOTE,\n        hints,\n        query_context: queryContext,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n","/**\n * Naming the rows of `baker research keyword-metrics` after where each number\n * came from.\n *\n * DataForSEO does not measure Google's search volume — it resells the Keyword\n * Planner figure, so `search_volume` here and `planner_avg_monthly_searches`\n * from `baker ads google keywords metrics` are one number with two names. A run\n * that did not know that presented the two side by side as agreeing sources and\n * reported the agreement as validation; they matched to the digit in all seven\n * rows because they are the same row. The only defence that survives a CSV in\n * /tmp is the column name, which is the same conclusion `ads/google/keywords/\n * provenance.ts` reached for the other half of the pair — so the same prefix is\n * used deliberately.\n *\n * The exception is clickstream: `clickstream_search_volume` is DataForSEO's own\n * panel-derived estimate and genuinely is a second opinion. It keeps its own\n * prefix so it can never be read as Google's, or Google's as it.\n */\nimport type { ResearchKeywordMetricsRow } from \"@baker/api\";\n\nexport const KEYWORD_METRICS_SOURCE = \"keyword_planner_estimate_via_dataforseo\";\n\nexport type KeywordMetricsOutputRow = Record<string, unknown>;\n\nexport interface KeywordMetricsColumnOptions {\n  /** The request asked for DataForSEO's panel volume alongside Google's. */\n  clickstream: boolean;\n  /** Add difficulty, intent and the 12-month trend. */\n  full: boolean;\n}\n\nexport function toOutputRow(\n  row: ResearchKeywordMetricsRow,\n  options: KeywordMetricsColumnOptions,\n): KeywordMetricsOutputRow {\n  const out: KeywordMetricsOutputRow = {\n    source: KEYWORD_METRICS_SOURCE,\n    keyword: row.keyword,\n    planner_search_volume: row.search_volume,\n    planner_cpc: row.cpc,\n    planner_low_top_of_page_bid: row.low_top_of_page_bid,\n    planner_high_top_of_page_bid: row.high_top_of_page_bid,\n    planner_competition: row.competition,\n    planner_competition_index: row.competition_index,\n  };\n  if (options.clickstream) {\n    out.clickstream_search_volume = row.clickstream_search_volume;\n  }\n  if (options.full) {\n    out.keyword_difficulty = row.keyword_difficulty;\n    out.main_intent = row.main_intent;\n    out.planner_monthly_searches = row.monthly_searches;\n  }\n  return out;\n}\n\nexport function keywordMetricsFields(options: KeywordMetricsColumnOptions): Record<string, string> {\n  const fields: Record<string, string> = {\n    source: `Always \"${KEYWORD_METRICS_SOURCE}\". Every planner_ column below is Google's Keyword Planner ESTIMATE of total market volume, resold by DataForSEO — the same number \\`baker ads google keywords metrics\\` returns, not an independent measurement of it. Columns without the planner_ prefix are DataForSEO's own.`,\n    keyword:\n      \"The keyword asked for. A row with every metric null means DataForSEO holds no data on it — not that nobody searches it.\",\n    planner_search_volume: \"ESTIMATE: average monthly searches across the whole market, last 12 months\",\n    planner_cpc: \"ESTIMATE: average cost per click in USD (a single blended figure, not a top-of-page range)\",\n    planner_low_top_of_page_bid: \"ESTIMATE: low-range top-of-page bid in USD\",\n    planner_high_top_of_page_bid: \"ESTIMATE: high-range top-of-page bid in USD\",\n    planner_competition: \"ESTIMATE: competition level — LOW, MEDIUM or HIGH\",\n    planner_competition_index: \"ESTIMATE: competition index 0-100 (higher = more advertisers)\",\n  };\n  if (options.clickstream) {\n    fields.clickstream_search_volume =\n      \"DataForSEO's OWN volume estimate, from clickstream panels — not Google's, and the only number here that is a genuine second opinion on demand. Expect it to differ from planner_search_volume; that is the point.\";\n  }\n  if (options.full) {\n    fields.keyword_difficulty = \"DataForSEO's 0-100 estimate of how hard ranking in the organic top 10 would be\";\n    fields.main_intent = \"DataForSEO's intent classification: informational, navigational, commercial or transactional\";\n    fields.planner_monthly_searches = \"ESTIMATE: 12-month volume breakdown ({year, month, search_volume})\";\n  }\n  return fields;\n}\n"],"mappings":"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","names":[]}

package/dist/keywords-for-site-BDKPQKWB.js

@@ -0,0 +1,128 @@
+import {
+  keywordsForSiteHints
+} from "./chunk-H7XVKLIY.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-Y362QH54.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-3ZWWXAQZ.js";
+import "./chunk-77DN7R35.js";
+import "./chunk-SMIENBNX.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/keywords-for-site.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.keywords-for-site",
+  description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+  args: {
+    target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    sort: {
+      type: "string",
+      description: "Sort: search_volume, competition, cpc (default: search_volume)",
+      required: false
+    },
+    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  keyword: "Keyword the site targets",
+  search_volume: "Monthly search volume",
+  cpc: "Cost per click in USD",
+  competition: "LOW, MEDIUM, or HIGH",
+  competition_index: "Competition score 0-100"
+};
+var keywordsForSiteCommand = defineCommand({
+  meta: {
+    name: "keywords-for-site",
+    description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
+
+Examples:
+  baker research keywords-for-site "competitor.com"
+  baker research keywords-for-site "competitor.com" --type paid --limit 20
+  baker research keywords-for-site "competitor.com" --type organic --location uk`
+  },
+  args: {
+    target: { type: "positional", description: "Domain or URL to analyze", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    sort: { type: "string", description: "Sort: search_volume, competition, cpc", required: false },
+    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const target = args.target;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const sort = args.sort || void 0;
+    const type = args.type || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/keywords-for-site", {
+        target,
+        location,
+        language,
+        sort,
+        type,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      const hints = keywordsForSiteHints(data.length, queryContext, type);
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data,
+        fields: FIELDS,
+        note: RESEARCH_DATA_NOTE,
+        query_context: queryContext,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  keywordsForSiteCommand
+};
+//# sourceMappingURL=keywords-for-site-BDKPQKWB.js.map

package/dist/keywords-for-site-BDKPQKWB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/keywords-for-site.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { keywordsForSiteHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.keywords-for-site\",\n  description:\n    \"Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.\",\n  args: {\n    target: { type: \"string\", description: \"Domain or URL to analyze (positional)\", required: true },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name. Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    sort: {\n      type: \"string\",\n      description: \"Sort: search_volume, competition, cpc (default: search_volume)\",\n      required: false,\n    },\n    type: { type: \"string\", description: \"Filter: paid, organic, all (default: all)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 50, max: 1000)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface KeywordForSite {\n  keyword: string;\n  search_volume: number;\n  cpc: number;\n  competition: string;\n  competition_index: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  keyword: \"Keyword the site targets\",\n  search_volume: \"Monthly search volume\",\n  cpc: \"Cost per click in USD\",\n  competition: \"LOW, MEDIUM, or HIGH\",\n  competition_index: \"Competition score 0-100\",\n};\n\nexport const keywordsForSiteCommand = defineCommand({\n  meta: {\n    name: \"keywords-for-site\",\n    description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.\n\nExamples:\n  baker research keywords-for-site \"competitor.com\"\n  baker research keywords-for-site \"competitor.com\" --type paid --limit 20\n  baker research keywords-for-site \"competitor.com\" --type organic --location uk`,\n  },\n  args: {\n    target: { type: \"positional\", description: \"Domain or URL to analyze\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    sort: { type: \"string\", description: \"Sort: search_volume, competition, cpc\", required: false },\n    type: { type: \"string\", description: \"Filter: paid, organic, all (default: all)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 50, max: 1000)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const target = args.target as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const sort = (args.sort as string) || undefined;\n    const type = (args.type as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const data = await apiPost<KeywordForSite[]>(\"/api/research/keywords-for-site\", {\n        target,\n        location,\n        language,\n        sort,\n        type,\n        limit,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      const hints = keywordsForSiteHints(data.length, queryContext, type);\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        query_context: queryContext,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAa9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,QAAQ,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,KAAK;AAAA,IAC/F,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,MAAM,EAAE,MAAM,UAAU,aAAa,6CAA6C,UAAU,MAAM;AAAA,IAClG,OAAO,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,MAAM;AAAA,IAC9F,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAUD,IAAM,SAAiC;AAAA,EACrC,SAAS;AAAA,EACT,eAAe;AAAA,EACf,KAAK;AAAA,EACL,aAAa;AAAA,EACb,mBAAmB;AACrB;AAEO,IAAM,yBAAyB,cAAc;AAAA,EAClD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,MAAM;AAAA,IACJ,QAAQ,EAAE,MAAM,cAAc,aAAa,4BAA4B,UAAU,KAAK;AAAA,IACtF,UAAU,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,MAAM,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IAC9F,MAAM,EAAE,MAAM,UAAU,aAAa,6CAA6C,UAAU,MAAM;AAAA,IAClG,OAAO,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,MAAM;AAAA,IAC9F,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,KAAK;AACpB,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,OAAQ,KAAK,QAAmB;AACtC,UAAM,OAAQ,KAAK,QAAmB;AACtC,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,UAAU,QAAQ;AAEjE,QAAI;AACF,YAAM,OAAO,MAAM,QAA0B,mCAAmC;AAAA,QAC9E;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,YAAM,QAAQ,qBAAqB,KAAK,QAAQ,cAAc,IAAI;AAClE,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E,2BAAmB,OAAO,MAAM;AAChC;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/landing-4K6XYNFM.js

@@ -0,0 +1,28 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/index.ts
+import { defineCommand } from "citty";
+var landingCommand = defineCommand({
+  meta: {
+    name: "landing",
+    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.
+
+Start here: \`baker landing critique <slug>\` after building or editing a landing.
+
+Subcommands:
+  baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
+  baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
+  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and positioning integrity (copy ranking a competitor above the client), tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
+  baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
+  },
+  subCommands: {
+    inspiration: () => import("./inspiration-Y2J2PUPC.js").then((m) => m.inspirationCommand),
+    critique: () => import("./critique-B3H7QFM2.js").then((m) => m.critiqueCommand),
+    variant: () => import("./variant-FOVE6URJ.js").then((m) => m.variantCommand),
+    export: () => import("./export-TS5GYEMA.js").then((m) => m.exportCommand)
+  }
+});
+export {
+  landingCommand
+};
+//# sourceMappingURL=landing-4K6XYNFM.js.map

package/dist/landing-4K6XYNFM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const landingCommand = defineCommand({\n  meta: {\n    name: \"landing\",\n    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.\n\nStart here: \\`baker landing critique <slug>\\` after building or editing a landing.\n\nSubcommands:\n  baker landing inspiration      — reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.\n  baker landing variant <control> <slug> — the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \\`baker experiment plan\\` first.\n  baker landing critique <slug>   — design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and positioning integrity (copy ranking a competitor above the client), tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires — run it before finishing a landing.\n  baker landing export start      — download the PUBLISHED landings as a ZIP of plain HTML (\"download my landings\", \"send me the HTML\"); \\`baker landing export status <id>\\` gives the link.`,\n  },\n  subCommands: {\n    inspiration: () => import(\"./inspiration/index.ts\").then((m) => m.inspirationCommand),\n    critique: () => import(\"./critique.ts\").then((m) => m.critiqueCommand),\n    variant: () => import(\"./variant.ts\").then((m) => m.variantCommand),\n    export: () => import(\"./export.ts\").then((m) => m.exportCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,aAAa;AAAA,IACX,aAAa,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,IACpF,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,EACjE;AACF,CAAC;","names":[]}

package/dist/landings-F7LOAEJE.js

@@ -0,0 +1,151 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-752S7JF6.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  LANDING_ANALYSE_BATCH,
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/landings.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.landings",
+  description: "Every landing page one brand's ads send people to, the ones in use now first (a short or tracking link counts as the page it opens; Instant Forms, chats, app stores and social profiles are not pages): how many ads point there, how many still run, platforms, when each was used (`used`: one stretch per run of ads, `\u2192 now` while running), `address_only` on an address only Google search ads print (Google publishes no search ad's real destination, and the path need not exist \u2014 not analysed), and \u2014 once analysed \u2014 the page's headline, value propositions, offer, pricing, CTAs, proof, audience and sections in order. Compact by default; --full returns every field, the ads behind each page and its screenshot. --analyse studies the top pages not yet analysed (a few minutes each).",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "Every field of every page", required: false, default: false },
+    analyse: {
+      type: "boolean",
+      description: `Analyse the top ${LANDING_ANALYSE_BATCH} pages not analysed yet (or those named in --pages)`,
+      required: false,
+      default: false
+    },
+    pages: {
+      type: "string",
+      description: `With --analyse: comma list of page urls to analyse instead (max ${LANDING_ANALYSE_BATCH})`,
+      required: false
+    }
+  }
+});
+var COMPACT_PAGES = 20;
+var COMPACT_VALUE_PROPS = 3;
+var day = (iso) => iso.slice(0, 10);
+function compactPage(p) {
+  const pitch = p.analysis.pitch;
+  return {
+    url: p.canonical_url,
+    in_use_now: p.active_ads > 0,
+    ads: p.ads,
+    running: p.active_ads,
+    platforms: p.platforms,
+    used: p.windows.map((w) => `${day(w.from)} \u2192 ${w.to ? day(w.to) : "now"}`),
+    last_seen_at: p.last_seen_at,
+    ...p.address_only ? { address_only: true } : {},
+    analysis: p.analysis.status,
+    ...pitch ? {
+      headline: pitch.headline,
+      value_propositions: pitch.value_propositions.slice(0, COMPACT_VALUE_PROPS),
+      offer: pitch.offer
+    } : {}
+  };
+}
+function compactLandings(report) {
+  return {
+    advertiser_id: report.advertiser_id,
+    total_pages: report.total_pages,
+    analysed: report.pages.filter((p) => p.analysis.status === "ready").length,
+    pages: report.pages.slice(0, COMPACT_PAGES).map(compactPage)
+  };
+}
+function pagesToAnalyse(report) {
+  return report.pages.filter((p) => !p.address_only && (p.analysis.status === "not_analysed" || p.analysis.status === "failed")).slice(0, LANDING_ANALYSE_BATCH).map((p) => p.canonical_url);
+}
+function landingsHints(report, advertiser) {
+  const hints = [];
+  const top = report.pages.slice(0, COMPACT_PAGES);
+  const pending = top.filter((p) => !p.address_only && p.analysis.status === "not_analysed").length;
+  const addressOnly = report.pages.filter((p) => p.address_only).length;
+  const analysing = report.pages.filter((p) => p.analysis.status === "analysing").length;
+  if (report.pages.length === 0) {
+    hints.push("No ad of this brand links to a landing page yet.");
+    return hints;
+  }
+  if (addressOnly > 0) {
+    hints.push(
+      `${addressOnly} ${addressOnly === 1 ? "address" : "addresses"} only Google search ads show (\`address_only\`): Google publishes no search ad's destination, only the address printed on it, whose path the brand types freely and need not exist. Quote it as the address the ad shows, never as a page the ads lead to; it is not analysed.`
+    );
+  }
+  if (pending > 0) {
+    hints.push(
+      `${pending} of the top pages are not analysed yet: \`baker winning-ads landings ${advertiser} --analyse\` studies the top ${LANDING_ANALYSE_BATCH} (value propositions, offer, pricing, proof, sections). It takes a few minutes; run this again to read them.`
+    );
+  }
+  if (analysing > 0) {
+    hints.push(`${analysing} pages are being analysed now: run this again in a few minutes.`);
+  }
+  if (report.pages.some((p) => p.analysis.status === "ready")) {
+    hints.push(
+      "--full returns each analysed page's whole read: pricing, CTAs, proof, audience and its sections in order."
+    );
+  }
+  return hints;
+}
+var landingsCommand = defineCommand({
+  meta: {
+    name: "landings",
+    description: "Every landing page a brand's ads point to, with how the page sells once analysed. Start here: baker winning-ads landings adv_123 (--analyse to study the top pages not analysed yet, --full for everything)"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "Every field of every page", required: false, default: false },
+    analyse: {
+      type: "boolean",
+      description: `Analyse the top ${LANDING_ANALYSE_BATCH} pages not analysed yet`,
+      required: false,
+      default: false
+    },
+    pages: { type: "string", description: "With --analyse: comma list of page urls to analyse", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const advertiser = String(args.advertiser);
+      const params = { advertiser };
+      if (args.platform) params.platform = String(args.platform);
+      let report = await apiGet("/api/ad-library/landing-pages", params);
+      let started;
+      if (args.analyse) {
+        const named = args.pages ? splitList(String(args.pages)) : [];
+        const urls = named.length > 0 ? named.slice(0, LANDING_ANALYSE_BATCH) : pagesToAnalyse(report);
+        if (urls.length > 0) {
+          started = (await apiPost("/api/ad-library/landing-pages/analyse", { urls })).pages;
+          report = await apiGet("/api/ad-library/landing-pages", params);
+        }
+      }
+      writeJson({
+        ok: true,
+        data: { ...args.full ? report : compactLandings(report), ...started ? { analyse: started } : {} },
+        hints: landingsHints(report, advertiser)
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  compactLandings,
+  landingsCommand,
+  landingsHints,
+  pagesToAnalyse
+};
+//# sourceMappingURL=landings-F7LOAEJE.js.map

package/dist/landings-F7LOAEJE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/landings.ts"],"sourcesContent":["import {\n  type AnalyseLandingPagesResponse,\n  type BrandLandingPage,\n  type BrandLandingPages,\n  LANDING_ANALYSE_BATCH,\n} from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.landings\",\n  description:\n    \"Every landing page one brand's ads send people to, the ones in use now first (a short or tracking link counts as the page it opens; Instant Forms, chats, app stores and social profiles are not pages): how many ads point there, how many still run, platforms, when each was used (`used`: one stretch per run of ads, `→ now` while running), `address_only` on an address only Google search ads print (Google publishes no search ad's real destination, and the path need not exist — not analysed), and — once analysed — the page's headline, value propositions, offer, pricing, CTAs, proof, audience and sections in order. Compact by default; --full returns every field, the ads behind each page and its screenshot. --analyse studies the top pages not yet analysed (a few minutes each).\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id (from `advertisers` or `following`)\", required: true },\n    platform: { type: \"string\", description: \"Only this platform: meta|linkedin|tiktok|google\", required: false },\n    full: { type: \"boolean\", description: \"Every field of every page\", required: false, default: false },\n    analyse: {\n      type: \"boolean\",\n      description: `Analyse the top ${LANDING_ANALYSE_BATCH} pages not analysed yet (or those named in --pages)`,\n      required: false,\n      default: false,\n    },\n    pages: {\n      type: \"string\",\n      description: `With --analyse: comma list of page urls to analyse instead (max ${LANDING_ANALYSE_BATCH})`,\n      required: false,\n    },\n  },\n});\n\nconst COMPACT_PAGES = 20;\nconst COMPACT_VALUE_PROPS = 3;\n\nconst day = (iso: string) => iso.slice(0, 10);\n\nfunction compactPage(p: BrandLandingPage) {\n  const pitch = p.analysis.pitch;\n  return {\n    url: p.canonical_url,\n    in_use_now: p.active_ads > 0,\n    ads: p.ads,\n    running: p.active_ads,\n    platforms: p.platforms,\n    used: p.windows.map((w) => `${day(w.from)} → ${w.to ? day(w.to) : \"now\"}`),\n    last_seen_at: p.last_seen_at,\n    ...(p.address_only ? { address_only: true } : {}),\n    analysis: p.analysis.status,\n    ...(pitch\n      ? {\n          headline: pitch.headline,\n          value_propositions: pitch.value_propositions.slice(0, COMPACT_VALUE_PROPS),\n          offer: pitch.offer,\n        }\n      : {}),\n  };\n}\n\n/** The pages cut to what an agent needs to pick which to read: url, ads, what runs, the top of the pitch. */\nexport function compactLandings(report: BrandLandingPages) {\n  return {\n    advertiser_id: report.advertiser_id,\n    total_pages: report.total_pages,\n    analysed: report.pages.filter((p) => p.analysis.status === \"ready\").length,\n    pages: report.pages.slice(0, COMPACT_PAGES).map(compactPage),\n  };\n}\n\n/**\n * The top pages (in use now first) nobody has analysed, or whose analysis\n * failed, at most one batch. An address only Google search ads show is left\n * out: it need not be a page at all.\n */\nexport function pagesToAnalyse(report: BrandLandingPages): string[] {\n  return report.pages\n    .filter((p) => !p.address_only && (p.analysis.status === \"not_analysed\" || p.analysis.status === \"failed\"))\n    .slice(0, LANDING_ANALYSE_BATCH)\n    .map((p) => p.canonical_url);\n}\n\n/** Point at the pages still to analyse, and say when some are on their way. */\nexport function landingsHints(report: BrandLandingPages, advertiser: string): string[] {\n  const hints: string[] = [];\n  const top = report.pages.slice(0, COMPACT_PAGES);\n  const pending = top.filter((p) => !p.address_only && p.analysis.status === \"not_analysed\").length;\n  const addressOnly = report.pages.filter((p) => p.address_only).length;\n  const analysing = report.pages.filter((p) => p.analysis.status === \"analysing\").length;\n  if (report.pages.length === 0) {\n    hints.push(\"No ad of this brand links to a landing page yet.\");\n    return hints;\n  }\n  if (addressOnly > 0) {\n    hints.push(\n      `${addressOnly} ${addressOnly === 1 ? \"address\" : \"addresses\"} only Google search ads show (\\`address_only\\`): Google publishes no search ad's destination, only the address printed on it, whose path the brand types freely and need not exist. Quote it as the address the ad shows, never as a page the ads lead to; it is not analysed.`,\n    );\n  }\n  if (pending > 0) {\n    hints.push(\n      `${pending} of the top pages are not analysed yet: \\`baker winning-ads landings ${advertiser} --analyse\\` studies the top ${LANDING_ANALYSE_BATCH} (value propositions, offer, pricing, proof, sections). It takes a few minutes; run this again to read them.`,\n    );\n  }\n  if (analysing > 0) {\n    hints.push(`${analysing} pages are being analysed now: run this again in a few minutes.`);\n  }\n  if (report.pages.some((p) => p.analysis.status === \"ready\")) {\n    hints.push(\n      \"--full returns each analysed page's whole read: pricing, CTAs, proof, audience and its sections in order.\",\n    );\n  }\n  return hints;\n}\n\nexport const landingsCommand = defineCommand({\n  meta: {\n    name: \"landings\",\n    description:\n      \"Every landing page a brand's ads point to, with how the page sells once analysed. Start here: baker winning-ads landings adv_123 (--analyse to study the top pages not analysed yet, --full for everything)\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id\", required: true },\n    platform: { type: \"string\", description: \"Only this platform: meta|linkedin|tiktok|google\", required: false },\n    full: { type: \"boolean\", description: \"Every field of every page\", required: false, default: false },\n    analyse: {\n      type: \"boolean\",\n      description: `Analyse the top ${LANDING_ANALYSE_BATCH} pages not analysed yet`,\n      required: false,\n      default: false,\n    },\n    pages: { type: \"string\", description: \"With --analyse: comma list of page urls to analyse\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const advertiser = String(args.advertiser);\n      const params: Record<string, string> = { advertiser };\n      if (args.platform) params.platform = String(args.platform);\n      let report = await apiGet<BrandLandingPages>(\"/api/ad-library/landing-pages\", params);\n      let started: AnalyseLandingPagesResponse[\"pages\"] | undefined;\n      if (args.analyse) {\n        const named = args.pages ? splitList(String(args.pages)) : [];\n        const urls = named.length > 0 ? named.slice(0, LANDING_ANALYSE_BATCH) : pagesToAnalyse(report);\n        if (urls.length > 0) {\n          started = (await apiPost<AnalyseLandingPagesResponse>(\"/api/ad-library/landing-pages/analyse\", { urls }))\n            .pages;\n          report = await apiGet<BrandLandingPages>(\"/api/ad-library/landing-pages\", params);\n        }\n      }\n      writeJson({\n        ok: true,\n        data: { ...(args.full ? report : compactLandings(report)), ...(started ? { analyse: started } : {}) },\n        hints: landingsHints(report, advertiser),\n      });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/languages-P3ZM6R2A.js

@@ -0,0 +1,40 @@
+import {
+  GOOGLE_ADS_LANGUAGES
+} from "./chunk-3ZWWXAQZ.js";
+import "./chunk-77DN7R35.js";
+import {
+  writeAdsJson
+} from "./chunk-BVM5IRZW.js";
+import "./chunk-XX6ZMCY5.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.languages",
+  description: "List all supported language IDs for --language flag in Google Ads keyword commands.",
+  args: {}
+});
+var FIELDS = {
+  id: "Language ID to pass as --language",
+  name: "Language name"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language IDs for --language flag."
+  },
+  run: () => {
+    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-P3ZM6R2A.js.map

package/dist/languages-P3ZM6R2A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/keywords/languages.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { GOOGLE_ADS_LANGUAGES } from \"../../../../geo-context.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { writeAdsJson } from \"../../output.ts\";\n\nregisterSchema({\n  command: \"ads.google.keywords.languages\",\n  description: \"List all supported language IDs for --language flag in Google Ads keyword commands.\",\n  args: {},\n});\n\nconst FIELDS: Record<string, string> = {\n  id: \"Language ID to pass as --language\",\n  name: \"Language name\",\n};\n\nexport const languagesCommand = defineCommand({\n  meta: {\n    name: \"languages\",\n    description: \"List all supported language IDs for --language flag.\",\n  },\n  run: () => {\n    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAK9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,CAAC;AACT,CAAC;AAED,IAAM,SAAiC;AAAA,EACrC,IAAI;AAAA,EACJ,MAAM;AACR;AAEO,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,KAAK,MAAM;AACT,iBAAa,EAAE,IAAI,MAAM,MAAM,sBAAsB,QAAQ,OAAO,CAAC;AAAA,EACvE;AACF,CAAC;","names":[]}

package/dist/languages-XEJKTIFP.js

@@ -0,0 +1,55 @@
+import {
+  writeResearchJson
+} from "./chunk-Y362QH54.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.languages",
+  description: "List all supported language codes for --language flag in research commands.",
+  args: {}
+});
+var LANGUAGES = [
+  { code: "en", name: "english" },
+  { code: "es", name: "spanish" },
+  { code: "fr", name: "french" },
+  { code: "de", name: "german" },
+  { code: "it", name: "italian" },
+  { code: "pt", name: "portuguese" },
+  { code: "nl", name: "dutch" },
+  { code: "ja", name: "japanese" },
+  { code: "ko", name: "korean" },
+  { code: "zh", name: "chinese" },
+  { code: "ar", name: "arabic" },
+  { code: "ru", name: "russian" },
+  { code: "pl", name: "polish" },
+  { code: "tr", name: "turkish" },
+  { code: "sv", name: "swedish" },
+  { code: "no", name: "norwegian" },
+  { code: "da", name: "danish" },
+  { code: "fi", name: "finnish" }
+];
+var FIELDS = {
+  code: "Language code to pass as --language",
+  name: "Language name (also accepted by --language)"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language codes for --language flag."
+  },
+  run: () => {
+    writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-XEJKTIFP.js.map

package/dist/languages-XEJKTIFP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/languages.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.languages\",\n  description: \"List all supported language codes for --language flag in research commands.\",\n  args: {},\n});\n\nconst LANGUAGES: Array<{ code: string; name: string }> = [\n  { code: \"en\", name: \"english\" },\n  { code: \"es\", name: \"spanish\" },\n  { code: \"fr\", name: \"french\" },\n  { code: \"de\", name: \"german\" },\n  { code: \"it\", name: \"italian\" },\n  { code: \"pt\", name: \"portuguese\" },\n  { code: \"nl\", name: \"dutch\" },\n  { code: \"ja\", name: \"japanese\" },\n  { code: \"ko\", name: \"korean\" },\n  { code: \"zh\", name: \"chinese\" },\n  { code: \"ar\", name: \"arabic\" },\n  { code: \"ru\", name: \"russian\" },\n  { code: \"pl\", name: \"polish\" },\n  { code: \"tr\", name: \"turkish\" },\n  { code: \"sv\", name: \"swedish\" },\n  { code: \"no\", name: \"norwegian\" },\n  { code: \"da\", name: \"danish\" },\n  { code: \"fi\", name: \"finnish\" },\n];\n\nconst FIELDS: Record<string, string> = {\n  code: \"Language code to pass as --language\",\n  name: \"Language name (also accepted by --language)\",\n};\n\nexport const languagesCommand = defineCommand({\n  meta: {\n    name: \"languages\",\n    description: \"List all supported language codes for --language flag.\",\n  },\n  run: () => {\n    writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAI9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,CAAC;AACT,CAAC;AAED,IAAM,YAAmD;AAAA,EACvD,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,aAAa;AAAA,EACjC,EAAE,MAAM,MAAM,MAAM,QAAQ;AAAA,EAC5B,EAAE,MAAM,MAAM,MAAM,WAAW;AAAA,EAC/B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,YAAY;AAAA,EAChC,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAChC;AAEA,IAAM,SAAiC;AAAA,EACrC,MAAM;AAAA,EACN,MAAM;AACR;AAEO,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,KAAK,MAAM;AACT,sBAAkB,EAAE,IAAI,MAAM,MAAM,WAAW,QAAQ,OAAO,CAAC;AAAA,EACjE;AACF,CAAC;","names":[]}

package/dist/launches-TCFAYUA5.js

@@ -0,0 +1,19 @@
+import {
+  IDEA_HINT,
+  compactLaunches,
+  launchesCommand,
+  launchesHints
+} from "./chunk-WNFTXSGR.js";
+import "./chunk-752S7JF6.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  IDEA_HINT,
+  compactLaunches,
+  launchesCommand,
+  launchesHints
+};
+//# sourceMappingURL=launches-TCFAYUA5.js.map

package/dist/launches-TCFAYUA5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}