@koda-sl/baker-cli 0.489.0-dev.63e618e80 → 0.490.0

package/dist/inspect-QF2S3U2E.js

@@ -1,189 +0,0 @@
-import {
-  fetchRunRecord
-} from "./chunk-D2YHDDKW.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-23H4ZJRP.js";
-import "./chunk-2FSEESJU.js";
-import "./chunk-CVBKW75S.js";
-import "./chunk-BLAHHMPF.js";
-import "./chunk-36SU43V2.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  ApiError
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/canvas/inspect.ts
-import { execFile } from "child_process";
-import { readdir, readFile, stat } from "fs/promises";
-import path from "path";
-import { promisify } from "util";
-import { defineCommand } from "citty";
-var execFileAsync = promisify(execFile);
-var inspectCommand = defineCommand({
-  meta: {
-    name: "inspect",
-    description: "Dump a one-page summary of a canvas run: per-node duration + cache status, the run's outputs, and optionally three thumbnail frames per video output. Pass a run_id (r_\u2026) or an absolute run directory. A run whose folder is not in this workspace (an older version, or one rendered in another chat) is read from the company's run history instead: its status, stats, per-node results and the durable URL of every output."
-  },
-  args: {
-    run: { type: "positional", required: true, description: "Run id (e.g. r_01K...) or absolute run directory" },
-    "outputs-dir": { type: "string", description: "Per-run outputs root (default <workspace root>/canvas, where `canvas run` writes)" },
-    thumbnails: {
-      type: "boolean",
-      description: "Extract start/middle/end frames from every video output in the local run folder (requires ffmpeg)"
-    }
-  },
-  async run({ args }) {
-    const cwd = process.cwd();
-    const outputsDir = args["outputs-dir"] ? path.resolve(String(args["outputs-dir"])) : path.join(findWorkspaceRoot(cwd) ?? cwd, "canvas");
-    const runArg = String(args.run);
-    const runDir = await localRunDir(runArg, outputsDir);
-    if (!runDir) {
-      if (path.isAbsolute(runArg)) fail("not_found", `${runArg} is not a run directory`);
-      await inspectFromHistory(runArg, path.join(outputsDir, runArg));
-      return;
-    }
-    const manifest = await loadManifest(runDir);
-    const files = await listRunFiles(runDir);
-    const videos = files.filter((f) => isVideoFile(f.path));
-    let thumbnails = [];
-    if (args.thumbnails) {
-      thumbnails = await extractThumbnails(videos.map((v) => v.path));
-    }
-    const summary = {
-      ok: true,
-      source: "local",
-      run_id: manifest.run_id ?? path.basename(runDir),
-      run_dir: runDir,
-      stats: manifest.stats ?? null,
-      output: manifest.output ?? null,
-      node_runs: manifest.node_runs ?? [],
-      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),
-      thumbnails
-    };
-    process.stdout.write(`${JSON.stringify(summary, null, 2)}
-`);
-  }
-});
-async function localRunDir(run, outputsDir) {
-  const candidate = path.isAbsolute(run) ? run : path.join(outputsDir, run);
-  const s = await stat(candidate).catch(() => null);
-  return s?.isDirectory() ? candidate : null;
-}
-async function inspectFromHistory(runId, expectedDir) {
-  let run;
-  try {
-    run = await fetchRunRecord(runId);
-  } catch (e) {
-    const reason = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);
-    fail("unavailable", `No run folder at ${expectedDir}, and the run history could not be read (${reason}).`);
-  }
-  if (!run) {
-    fail(
-      "not_found",
-      `No run "${runId}": there is no folder at ${expectedDir} and the company's run history has no run by that id.`
-    );
-  }
-  const summary = {
-    ok: true,
-    source: "run_history",
-    run_id: run.runId,
-    creative: run.creativeSlug ?? null,
-    status: run.status,
-    ...run.errorMessage ? { error: run.errorMessage } : {},
-    stats: {
-      total_nodes: run.stats.totalNodes,
-      cached_nodes: run.stats.cachedNodes,
-      total_credits: run.stats.totalCredits,
-      duration_ms: run.stats.durationMs
-    },
-    outputs: run.finalOutputs,
-    node_runs: run.nodes.map((node) => ({
-      node_id: node.nodeId,
-      node_type: node.nodeType,
-      cached: node.cached,
-      duration_ms: node.durationMs,
-      credits: node.credits,
-      ...node.status ? { status: node.status } : {},
-      outputs: node.outputs
-    })),
-    ...run.review ? { review: run.review } : {},
-    hints: [
-      "This run's folder is not in this workspace, so there are no local files: every output above is a durable URL. To render it again here, run `baker canvas run --slug <creative>`."
-    ]
-  };
-  process.stdout.write(`${JSON.stringify(summary, null, 2)}
-`);
-}
-function fail(code, message) {
-  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
-`);
-  process.exit(2);
-}
-async function loadManifest(runDir) {
-  const manifestPath = path.join(runDir, "manifest.json");
-  try {
-    const raw = await readFile(manifestPath, "utf-8");
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-async function listRunFiles(runDir) {
-  const out = [];
-  const names = await readdir(runDir);
-  for (const name of names) {
-    const abs = path.join(runDir, name);
-    const s = await stat(abs).catch(() => null);
-    if (!s?.isFile()) continue;
-    out.push({ name, path: abs, size: s.size });
-  }
-  out.sort((a, b) => a.name.localeCompare(b.name));
-  return out;
-}
-function isVideoFile(p) {
-  return /\.(mp4|webm|mov)$/i.test(p);
-}
-async function extractThumbnails(videoPaths) {
-  const out = [];
-  for (const v of videoPaths) {
-    const duration = await probeDuration(v).catch(() => null);
-    if (duration === null) {
-      out.push({ video: v, frames: [] });
-      continue;
-    }
-    const frames = [];
-    const checkpoints = [0.05, 0.5, 0.95];
-    const base = v.replace(/\.[^.]+$/, "");
-    for (const ratio of checkpoints) {
-      const at = Math.max(0, Math.min(duration * ratio, duration - 0.01));
-      const dest = `${base}__frame_${Math.round(ratio * 100).toString().padStart(2, "0")}.png`;
-      try {
-        await execFileAsync("ffmpeg", ["-ss", at.toFixed(3), "-i", v, "-frames:v", "1", "-y", dest]);
-        frames.push(dest);
-      } catch {
-      }
-    }
-    out.push({ video: v, frames });
-  }
-  return out;
-}
-async function probeDuration(filePath) {
-  const { stdout } = await execFileAsync(
-    "ffprobe",
-    ["-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", filePath],
-    { encoding: "utf-8" }
-  );
-  return Number.parseFloat(stdout.trim());
-}
-export {
-  inspectCommand
-};
-//# sourceMappingURL=inspect-QF2S3U2E.js.map

package/dist/inspiration-XQYHBJY2.js

@@ -1,53 +0,0 @@
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/landing/inspiration/index.ts
-import { defineCommand } from "citty";
-var inspirationCommand = defineCommand({
-  meta: {
-    name: "inspiration",
-    description: `Reference library of real landing-page sections \u2014 look at how good pages actually solve a problem before you design one.
-
-Start here: \`baker landing inspiration search "<what you want to see>"\` during research, BEFORE you write the Direction Contract.
-
-This is inspiration, never a clipboard. Take the mechanism \u2014 what the eye hits first, what proof arrives before the ask, how the grid is split. The words are never yours to reuse: shipping a reference's headline is a Tier 0 message-match failure.
-
-Subcommands:
-  baker landing inspiration search "<query>"  \u2014 search by look, section type, composition, register or motion; saves screenshots you can Read
-  baker landing inspiration view <id>         \u2014 one section in full: tokens, motion filmstrip, why it works, what to change
-  baker landing inspiration code <id>         \u2014 its standalone HTML+CSS, for structure only
-  baker landing inspiration page <id>         \u2014 a whole page as a sequence: how it orders its sections
-  baker landing inspiration sequences "<q>"   \u2014 what follows what across MANY pages: openers, transitions, closers
-  baker landing inspiration add <url>         \u2014 add a page to the library and save it to this company (returns immediately); --refresh re-studies a page that changed
-  baker landing inspiration favorites         \u2014 what this company has saved; the default search scope
-  baker landing inspiration favorite <id>     \u2014 save a section
-  baker landing inspiration unfavorite <id>   \u2014 unsave a section
-  baker landing inspiration retry-failed      \u2014 study again every saved page that failed
-  baker landing inspiration scrape <url>      \u2014 internal/ops: run the capture locally
-
-Examples:
-  baker landing inspiration search "pricing with a monthly/annual toggle" --max-rank 3
-  baker landing inspiration search "dark developer hero with a terminal" --register dev-tool-minimal --scope all
-  baker landing inspiration search "testimonial wall with faces and company logos" --motion scroll-reveal
-  baker landing inspiration sequences "b2b saas pricing page" --scope all
-  baker landing inspiration add https://linear.app
-
-Full guide: __tooling__/docs/tools/baker/landing.md`
-  },
-  subCommands: {
-    search: () => import("./search-I6DRUXBX.js").then((m) => m.searchCommand),
-    view: () => import("./view-ABSWZMXW.js").then((m) => m.viewCommand),
-    code: () => import("./code-NXN7QYKU.js").then((m) => m.codeCommand),
-    page: () => import("./page-YWGBCN65.js").then((m) => m.pageCommand),
-    sequences: () => import("./sequences-5DUWNSWQ.js").then((m) => m.sequencesCommand),
-    add: () => import("./add-BK5AQI5A.js").then((m) => m.addCommand),
-    favorites: () => import("./favorites-4ELADD3R.js").then((m) => m.favoritesCommand),
-    favorite: () => import("./favorites-4ELADD3R.js").then((m) => m.favoriteCommand),
-    unfavorite: () => import("./favorites-4ELADD3R.js").then((m) => m.unfavoriteCommand),
-    "retry-failed": () => import("./retry-failed-EJBP4236.js").then((m) => m.retryFailedCommand),
-    scrape: () => import("./scrape-J2Y7YZ4Z.js").then((m) => m.scrapeCommand)
-  }
-});
-export {
-  inspirationCommand
-};
-//# sourceMappingURL=inspiration-XQYHBJY2.js.map

package/dist/intent-JJTDJ732.js

@@ -1,95 +0,0 @@
-import {
-  handleResearchError,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-BFRIRZRZ.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-M2D7ZWEU.js";
-import "./chunk-V57TZQPI.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/intent.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "research.intent",
-  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
-  args: {
-    keywords: {
-      type: "string",
-      description: "Comma-separated keywords (min 3 chars each, max 1000 keywords)",
-      required: true
-    },
-    language: {
-      type: "string",
-      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English keywords",
-      required: false
-    },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var FIELDS = {
-  keyword: "The keyword analyzed",
-  intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
-  probability: "Confidence score 0.0-1.0"
-};
-var intentCommand = defineCommand({
-  meta: {
-    name: "intent",
-    description: `Classify Google Search intent for keywords. Returns intent type and confidence.
-
-Examples:
-  baker research intent "buy running shoes,best running shoes 2026,how to tie running shoes"
-  baker research intent "crm software" --language spanish`
-  },
-  args: {
-    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
-    language: { type: "string", description: "Language code or name (default: en)", 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 rawKeywords = args.keywords;
-    const keywords = rawKeywords.split(",").map((k) => k.trim()).filter((k) => k.length >= 3);
-    if (keywords.length === 0) {
-      writeResearchJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword (min 3 chars each)" }
-      });
-      process.exit(1);
-    }
-    const language = args.language || void 0;
-    const skipCache = args["no-cache"] ? true : void 0;
-    const queryContext = buildResearchQueryContext(void 0, language, { skipLocation: true });
-    try {
-      const data = await apiPost("/api/research/intent", {
-        keywords,
-        language,
-        skipCache
-      });
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      if (format !== "json") {
-        writeResearchOutput(data, format);
-        return;
-      }
-      writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  intentCommand
-};
-//# sourceMappingURL=intent-JJTDJ732.js.map

package/dist/keyword-gap-4NQN56JP.js

@@ -1,130 +0,0 @@
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-BFRIRZRZ.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-M2D7ZWEU.js";
-import "./chunk-V57TZQPI.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.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-4NQN56JP.js.map

package/dist/keyword-metrics-QCIOBMTW.js

@@ -1,197 +0,0 @@
-import {
-  keywordMetricsHints
-} from "./chunk-IHUIXQBP.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-BFRIRZRZ.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-M2D7ZWEU.js";
-import "./chunk-V57TZQPI.js";
-import {
-  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
-} from "./chunk-36SU43V2.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-NAA4CKZZ.js";
-import {
-  apiPost
-} from "./chunk-XDZVBX6L.js";
-import "./chunk-N5O67GK5.js";
-import "./chunk-EE72SSB2.js";
-import {
-  registerSchema
-} from "./chunk-WNSE7N75.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-QCIOBMTW.js.map