@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/keyword-gap-DJAYVD4U.js

@@ -1,131 +0,0 @@
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-A3PEJ3V3.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-2SCPDSFN.js";
-import "./chunk-EVYXTT7V.js";
-import "./chunk-XML7AJM3.js";
-import {
-  apiPost
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/keyword-gap.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "research.keyword-gap",
-  description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. 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: {
-    competitor: { type: "string", description: "Competitor domain (positional 1)", required: true },
-    ours: { type: "string", description: "Your domain (positional 2)", required: true },
-    location: {
-      type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States); set it for any non-US market.",
-      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
-    },
-    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
-    limit: { type: "string", description: "Max results per page (default: 50, max: 1000)", required: false },
-    offset: { type: "string", description: "Pagination offset (default: 0)", required: false },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var FIELDS = {
-  keyword: "Keyword in the gap (they rank, you don't)",
-  search_volume: "Monthly search volume",
-  cpc: "Cost per click USD",
-  their_position: "Competitor's ranking position"
-};
-var keywordGapCommand = defineCommand({
-  meta: {
-    name: "keyword-gap",
-    description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
-
-Examples:
-  baker research keyword-gap "competitor.com" "mysite.com"
-  baker research keyword-gap "competitor.com" "mysite.com" --type paid --limit 100
-  baker research keyword-gap "competitor.com" "mysite.com" --offset 50 --limit 50`
-  },
-  args: {
-    competitor: { type: "positional", description: "Competitor domain", required: true },
-    ours: { type: "positional", description: "Your domain", 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 },
-    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
-    limit: { type: "string", description: "Max results per page (default: 50, max: 1000)", required: false },
-    offset: { type: "string", description: "Pagination offset (default: 0)", 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 competitor = args.competitor;
-    const ours = args.ours;
-    const location = args.location || void 0;
-    const language = args.language || void 0;
-    const type = args.type || void 0;
-    const limit = args.limit ? Number(args.limit) : void 0;
-    const offset = args.offset ? Number(args.offset) : void 0;
-    const skipCache = args["no-cache"] ? true : void 0;
-    const queryContext = buildResearchQueryContext(location, language);
-    try {
-      const result = await apiPost("/api/research/keyword-gap", {
-        competitor,
-        ours,
-        location,
-        language,
-        type,
-        limit,
-        offset,
-        skipCache
-      });
-      const currentOffset = offset ?? 0;
-      const currentLimit = limit ?? 50;
-      const hasMore = currentOffset + result.data.length < result.total_count;
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeResearchOutput(result.data, format);
-        writeResearchHints([RESEARCH_DATA_NOTE], format);
-        return;
-      }
-      writeResearchJson({
-        ok: true,
-        your_domain: ours,
-        competitor_domain: competitor,
-        data: result.data,
-        fields: FIELDS,
-        note: RESEARCH_DATA_NOTE,
-        total_count: result.total_count,
-        query_context: queryContext,
-        pagination: {
-          offset: currentOffset,
-          limit: currentLimit,
-          has_more: hasMore,
-          next_offset: hasMore ? currentOffset + currentLimit : void 0
-        }
-      });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  keywordGapCommand
-};
-//# sourceMappingURL=keyword-gap-DJAYVD4U.js.map

package/dist/keyword-gap-DJAYVD4U.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/research/keyword-gap.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.keyword-gap\",\n  description:\n    \"Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. 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    competitor: { type: \"string\", description: \"Competitor domain (positional 1)\", required: true },\n    ours: { type: \"string\", description: \"Your domain (positional 2)\", 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); set it for any non-US market.\",\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    type: { type: \"string\", description: \"Filter: paid, organic, all (default: all)\", required: false },\n    limit: { type: \"string\", description: \"Max results per page (default: 50, max: 1000)\", required: false },\n    offset: { type: \"string\", description: \"Pagination offset (default: 0)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface KeywordGapItem {\n  keyword: string;\n  search_volume: number;\n  cpc: number;\n  their_position: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  keyword: \"Keyword in the gap (they rank, you don't)\",\n  search_volume: \"Monthly search volume\",\n  cpc: \"Cost per click USD\",\n  their_position: \"Competitor's ranking position\",\n};\n\nexport const keywordGapCommand = defineCommand({\n  meta: {\n    name: \"keyword-gap\",\n    description: `Find keywords a competitor has that you don't. Supports pagination via --offset.\n\nExamples:\n  baker research keyword-gap \"competitor.com\" \"mysite.com\"\n  baker research keyword-gap \"competitor.com\" \"mysite.com\" --type paid --limit 100\n  baker research keyword-gap \"competitor.com\" \"mysite.com\" --offset 50 --limit 50`,\n  },\n  args: {\n    competitor: { type: \"positional\", description: \"Competitor domain\", required: true },\n    ours: { type: \"positional\", description: \"Your domain\", 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    type: { type: \"string\", description: \"Filter: paid, organic, all (default: all)\", required: false },\n    limit: { type: \"string\", description: \"Max results per page (default: 50, max: 1000)\", required: false },\n    offset: { type: \"string\", description: \"Pagination offset (default: 0)\", 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 competitor = args.competitor as string;\n    const ours = args.ours as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const type = (args.type as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const offset = args.offset ? Number(args.offset) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const result = await apiPost<{ data: KeywordGapItem[]; total_count: number }>(\"/api/research/keyword-gap\", {\n        competitor,\n        ours,\n        location,\n        language,\n        type,\n        limit,\n        offset,\n        skipCache,\n      });\n\n      const currentOffset = offset ?? 0;\n      const currentLimit = limit ?? 50;\n      const hasMore = currentOffset + result.data.length < result.total_count;\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeResearchOutput(result.data as unknown as Array<Record<string, unknown>>, format);\n        // The caveat travels with the rows, not only with the envelope. csv and\n        // md are the formats a person pastes into a deck, which is exactly where\n        // \"estimates, not exact figures\" stops being optional.\n        writeResearchHints([RESEARCH_DATA_NOTE], format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        your_domain: ours,\n        competitor_domain: competitor,\n        data: result.data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        total_count: result.total_count,\n        query_context: queryContext,\n        pagination: {\n          offset: currentOffset,\n          limit: currentLimit,\n          has_more: hasMore,\n          next_offset: hasMore ? currentOffset + currentLimit : undefined,\n        },\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/keyword-metrics-4FEFFTQO.js

@@ -1,198 +0,0 @@
-import {
-  keywordMetricsHints
-} from "./chunk-PIWMNKWI.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-A3PEJ3V3.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-2SCPDSFN.js";
-import "./chunk-EVYXTT7V.js";
-import {
-  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
-} from "./chunk-MBKCUSMR.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-WYCVJIHD.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-XML7AJM3.js";
-import {
-  apiPost
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/keyword-metrics.ts
-import { defineCommand } from "citty";
-
-// src/commands/research/keyword-metrics-rows.ts
-var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
-function toOutputRow(row, options) {
-  const out = {
-    source: KEYWORD_METRICS_SOURCE,
-    keyword: row.keyword,
-    planner_search_volume: row.search_volume,
-    planner_cpc: row.cpc,
-    planner_low_top_of_page_bid: row.low_top_of_page_bid,
-    planner_high_top_of_page_bid: row.high_top_of_page_bid,
-    planner_competition: row.competition,
-    planner_competition_index: row.competition_index
-  };
-  if (options.clickstream) {
-    out.clickstream_search_volume = row.clickstream_search_volume;
-  }
-  if (options.full) {
-    out.keyword_difficulty = row.keyword_difficulty;
-    out.main_intent = row.main_intent;
-    out.planner_monthly_searches = row.monthly_searches;
-  }
-  return out;
-}
-function keywordMetricsFields(options) {
-  const fields = {
-    source: `Always "${KEYWORD_METRICS_SOURCE}". Every planner_ column below is Google's Keyword Planner ESTIMATE of total market volume, resold by DataForSEO \u2014 the same number \`baker ads google keywords metrics\` returns, not an independent measurement of it. Columns without the planner_ prefix are DataForSEO's own.`,
-    keyword: "The keyword asked for. A row with every metric null means DataForSEO holds no data on it \u2014 not that nobody searches it.",
-    planner_search_volume: "ESTIMATE: average monthly searches across the whole market, last 12 months",
-    planner_cpc: "ESTIMATE: average cost per click in USD (a single blended figure, not a top-of-page range)",
-    planner_low_top_of_page_bid: "ESTIMATE: low-range top-of-page bid in USD",
-    planner_high_top_of_page_bid: "ESTIMATE: high-range top-of-page bid in USD",
-    planner_competition: "ESTIMATE: competition level \u2014 LOW, MEDIUM or HIGH",
-    planner_competition_index: "ESTIMATE: competition index 0-100 (higher = more advertisers)"
-  };
-  if (options.clickstream) {
-    fields.clickstream_search_volume = "DataForSEO's OWN volume estimate, from clickstream panels \u2014 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.";
-  }
-  if (options.full) {
-    fields.keyword_difficulty = "DataForSEO's 0-100 estimate of how hard ranking in the organic top 10 would be";
-    fields.main_intent = "DataForSEO's intent classification: informational, navigational, commercial or transactional";
-    fields.planner_monthly_searches = "ESTIMATE: 12-month volume breakdown ({year, month, search_volume})";
-  }
-  return fields;
-}
-
-// src/commands/research/keyword-metrics.ts
-registerSchema({
-  command: "research.keyword-metrics",
-  description: "Search volume, CPC, top-of-page bids and competition for a list of keywords you name \u2014 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` \u2014 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.",
-  args: {
-    keywords: {
-      type: "string",
-      description: `Comma-separated keywords (max ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS}, 80 chars each)`,
-      required: true
-    },
-    location: {
-      type: "string",
-      description: "Country code (us, mx, br, es...) 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
-    },
-    clickstream: {
-      type: "boolean",
-      description: "Also return DataForSEO's own panel-derived volume (clickstream_search_volume), the only genuinely independent estimate of demand available here. Costs 2x.",
-      required: false
-    },
-    full: {
-      type: "boolean",
-      description: "Add keyword difficulty, search intent and the 12-month volume trend to each row",
-      required: false
-    },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var keywordMetricsCommand = defineCommand({
-  meta: {
-    name: "keyword-metrics",
-    description: `Volume, CPC and competition for keywords you name. No domain required.
-
-Numbers are Keyword Planner ESTIMATES of total market volume, resold by DataForSEO \u2014 every column carrying one is named planner_. Pass --clickstream for DataForSEO's own independent estimate alongside.
-
-Examples:
-  baker research keyword-metrics "chatbot whatsapp,agente whatsapp ecommerce" --location mx --language es
-  baker research keyword-metrics "chatbot whatsapp" --location br --language pt --clickstream
-  baker research keyword-metrics "crm software,best crm" --full --output md`
-  },
-  args: {
-    keywords: { type: "positional", description: "Comma-separated keywords", 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 },
-    clickstream: { type: "boolean", description: "Add DataForSEO's own volume estimate (costs 2x)", required: false },
-    full: { type: "boolean", description: "Add difficulty, intent and the 12-month trend", 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 keywords = args.keywords.split(",").map((k) => k.trim()).filter(Boolean);
-    if (keywords.length === 0) {
-      writeResearchJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword" }
-      });
-      process.exit(1);
-    }
-    if (keywords.length > RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS) {
-      writeResearchJson({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: `Maximum ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} keywords per request`,
-          fix: {
-            action: "retry_with_changes",
-            explanation: `You sent ${keywords.length}. Split the list into batches of ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} and run the command once per batch \u2014 each batch is a separate charge, so batch by priority.`
-          }
-        }
-      });
-      process.exit(1);
-    }
-    const location = args.location || void 0;
-    const language = args.language || void 0;
-    const clickstream = Boolean(args.clickstream);
-    const full = Boolean(args.full);
-    const queryContext = buildResearchQueryContext(location, language);
-    try {
-      const result = await apiPost("/api/research/keyword-metrics", {
-        keywords,
-        location,
-        language,
-        includeClickstream: clickstream,
-        skipCache: args["no-cache"] ? true : void 0
-      });
-      const columns = { clickstream, full };
-      const rows = result.data.map((row) => toOutputRow(row, columns));
-      const hints = keywordMetricsHints({ rows: result.data, asked: keywords, clickstream, queryContext });
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeResearchOutput(rows, format);
-        writeResearchHints([...hints, RESEARCH_DATA_NOTE], format);
-        return;
-      }
-      writeResearchJson({
-        ok: true,
-        data: rows,
-        fields: keywordMetricsFields(columns),
-        note: RESEARCH_DATA_NOTE,
-        hints,
-        query_context: queryContext
-      });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  keywordMetricsCommand
-};
-//# sourceMappingURL=keyword-metrics-4FEFFTQO.js.map

package/dist/keyword-metrics-4FEFFTQO.js.map

@@ -1 +0,0 @@
-{"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-HIMEQY63.js

@@ -1,125 +0,0 @@
-import {
-  keywordsForSiteHints
-} from "./chunk-PIWMNKWI.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-A3PEJ3V3.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-2SCPDSFN.js";
-import "./chunk-EVYXTT7V.js";
-import "./chunk-XML7AJM3.js";
-import {
-  apiPost
-} from "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.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-HIMEQY63.js.map

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

@@ -1 +0,0 @@
-{"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-KU3ILVB3.js

@@ -1,28 +0,0 @@
-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 deterministic design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, buzzword copy, broken images) and positioning integrity (copy ranking a competitor above the client) tiered block/warn/advisory, respecting the client's BRAND.md. 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-64DY3QWN.js").then((m) => m.inspirationCommand),
-    critique: () => import("./critique-XXCM7YAV.js").then((m) => m.critiqueCommand),
-    variant: () => import("./variant-3DBL2RDV.js").then((m) => m.variantCommand),
-    export: () => import("./export-WXFUVX6F.js").then((m) => m.exportCommand)
-  }
-});
-export {
-  landingCommand
-};
-//# sourceMappingURL=landing-KU3ILVB3.js.map

package/dist/landing-KU3ILVB3.js.map

@@ -1 +0,0 @@
-{"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>   — deterministic design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, buzzword copy, broken images) and positioning integrity (copy ranking a competitor above the client) tiered block/warn/advisory, respecting the client's BRAND.md. 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/languages-4QYK5DMW.js

@@ -1,56 +0,0 @@
-import {
-  writeResearchJson
-} from "./chunk-A3PEJ3V3.js";
-import "./chunk-EPK2GYLV.js";
-import "./chunk-BSUN6JMU.js";
-import "./chunk-SXRSLUW7.js";
-import "./chunk-O4AXPEOE.js";
-import {
-  registerSchema
-} from "./chunk-JIHG6K7N.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-4QYK5DMW.js.map

package/dist/languages-4QYK5DMW.js.map

@@ -1 +0,0 @@
-{"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":[]}