@koda-sl/baker-cli 0.525.0 → 0.526.0

package/dist/job-status-N7RWRDRO.js

@@ -0,0 +1,74 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-UPDIBQUC.js";
+import {
+  writeAdsJson
+} from "./chunk-HPDGVK6R.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/stats/job-status.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.statsJobStatus",
+  description: "Check the status of one or more X Ads stats jobs. Returns status (PROCESSING|SUCCESS|FAILED) and a downloadable url when SUCCESS. Pass --job-id or --job-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "job-id": { type: "string", description: "Single job ID", required: false },
+    "job-ids": { type: "string", description: "CSV of job IDs", required: false }
+  }
+});
+var statsJobStatusCommand = defineCommand({
+  meta: {
+    name: "job-status",
+    description: `Poll the status of an async X Ads stats job.
+
+Examples:
+  baker ads x stats job-status --account-id 18ce53xyz --job-id abc
+  baker ads x stats job-status --account-id 18ce53xyz --job-ids abc,def`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "job-id": { type: "string", description: "Job ID", required: false },
+    "job-ids": { type: "string", description: "CSV of job IDs", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    if (!args["job-id"] && !args["job-ids"]) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "MISSING_PARAMETER", message: "Pass --job-id or --job-ids" }
+      });
+      process.exit(1);
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["job-id"]) params["job-id"] = args["job-id"];
+      if (args["job-ids"]) params["job-ids"] = args["job-ids"];
+      const data = await apiGet("/api/ads/x/stats/jobs", params);
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  statsJobStatusCommand
+};
+//# sourceMappingURL=job-status-N7RWRDRO.js.map

package/dist/keep-Z2WH3CKU.js

@@ -0,0 +1,78 @@
+import {
+  failStudioCommand
+} from "./chunk-DNWP5DL6.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/keep.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "studio.keep",
+  description: "Mark one take as the keeper. For an image this stars it, so the client reviewing the batch sees which one you used. For a CLIP it is the step that puts it in the video library \u2014 until then the clip cannot be used in a canvas, a landing, or an ad.",
+  args: {
+    "generation-id": { type: "string", description: "Batch id from `generate` / `animate`", required: true },
+    slot: { type: "number", description: "Which take, as shown in the batch (0-based)", required: true },
+    undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
+  }
+});
+var keepCommand = defineCommand({
+  meta: {
+    name: "keep",
+    description: "Mark one take as the keeper. An image gets starred (it was already in the library); a clip gets INGESTED into the video library, which is what makes it usable anywhere else.\n\nExample: baker studio keep j57abc123def456ghi789 --slot 2\nExample: baker studio keep j57abc123def456ghi789 --slot 2 --undo"
+  },
+  args: {
+    "generation-id": { type: "positional", description: "Batch id", required: false },
+    slot: { type: "string", description: "Which take (0-based)", required: false },
+    undo: { type: "boolean", description: "Reverse the keep", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const generationId = args["generation-id"];
+      if (!generationId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A batch id is required" } });
+        process.exit(1);
+      }
+      if (args.slot === void 0 || args.slot === "") {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "--slot is required: say which take you are keeping" }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/studio/keep", {
+        generationId,
+        slot: Number(args.slot),
+        ...args.undo ? { keep: false } : {}
+      });
+      const hints = [];
+      if (data.kind === "video" && data.kept) {
+        hints.push(
+          `The clip is in the video library now as ${data.videoId ?? "a new video"} \u2014 use that id from a canvas, a landing, or an ad.`
+        );
+      }
+      if (data.kind === "video" && !data.kept) {
+        hints.push("The clip is out of the video library again, so nothing else can use it.");
+      }
+      if (data.kind === "image" && data.kept) {
+        hints.push(
+          "Starred. The image was already in the media library \u2014 this is what tells the client it is the pick."
+        );
+      }
+      writeJson({ ok: true, data, hints });
+    } catch (error) {
+      failStudioCommand(error);
+    }
+  }
+});
+export {
+  keepCommand
+};
+//# sourceMappingURL=keep-Z2WH3CKU.js.map

package/dist/keyword-gap-B2WPVHOB.js

@@ -0,0 +1,130 @@
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-3KMYOPBI.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-SG2TDQEE.js";
+import "./chunk-44ZRCSR7.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.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-B2WPVHOB.js.map

package/dist/keyword-metrics-UDGWN7BO.js

@@ -0,0 +1,200 @@
+import {
+  keywordMetricsHints
+} from "./chunk-WWLZ5RRU.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-3KMYOPBI.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-SG2TDQEE.js";
+import "./chunk-44ZRCSR7.js";
+import {
+  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
+} from "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.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-UDGWN7BO.js.map

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

@@ -0,0 +1,131 @@
+import {
+  keywordsForSiteHints
+} from "./chunk-WWLZ5RRU.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-3KMYOPBI.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-SG2TDQEE.js";
+import "./chunk-44ZRCSR7.js";
+import "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.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-GEG6AXD3.js.map

package/dist/landing-BFMRM3HA.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 a rival named in a comparison, 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-KAXPRINY.js").then((m) => m.inspirationCommand),
+    critique: () => import("./critique-GWRXVXVG.js").then((m) => m.critiqueCommand),
+    variant: () => import("./variant-JQVZUUA4.js").then((m) => m.variantCommand),
+    export: () => import("./export-6Z6QBU6V.js").then((m) => m.exportCommand)
+  }
+});
+export {
+  landingCommand
+};
+//# sourceMappingURL=landing-BFMRM3HA.js.map