@koda-sl/baker-cli 0.449.0 → 0.450.0-dev.b454c3dd2

package/dist/insights-ZIU6FJMS.js

@@ -1,122 +0,0 @@
-import {
-  CHATGPT_ADS_GRANULARITIES,
-  CHATGPT_ADS_LEVELS,
-  CHATGPT_ADS_METRICS,
-  CHATGPT_ADS_REFERENCE,
-  CHATGPT_ADS_SEGMENTS,
-  chatgptAdsInsightsRequestSchema,
-  insightsRequestFromArgs,
-  runChatgptRead
-} from "./chunk-KLBTXETO.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/insights.ts
-import { defineCommand } from "citty";
-var args = {
-  level: {
-    type: "string",
-    description: `What one row is: ${CHATGPT_ADS_LEVELS.join("|")} (default campaign)`,
-    required: false
-  },
-  "campaign-id": { type: "string", description: "Report on one campaign (cmpn_\u2026)", required: false },
-  "ad-group-id": { type: "string", description: "Report on one ad group (adgrp_\u2026)", required: false },
-  "ad-id": { type: "string", description: "Report on one ad (ad_\u2026)", required: false },
-  days: {
-    type: "string",
-    description: "Last N complete days, ending the account's yesterday (default 7)",
-    required: false
-  },
-  since: {
-    type: "string",
-    description: "First day, YYYY-MM-DD, account timezone (instead of --days)",
-    required: false
-  },
-  until: { type: "string", description: "Last day, inclusive, YYYY-MM-DD", required: false },
-  granularity: {
-    type: "string",
-    description: `${CHATGPT_ADS_GRANULARITIES.join("|")} (default none: one total per row)`,
-    required: false
-  },
-  segment: {
-    type: "string",
-    description: `Break rows down by one of ${CHATGPT_ADS_SEGMENTS.join("|")}`,
-    required: false
-  },
-  metrics: {
-    type: "string",
-    description: `CSV of ${CHATGPT_ADS_METRICS.join(",")} (default impressions,clicks,spend,ctr,cpc,conversions,cpa)`,
-    required: false
-  },
-  sort: { type: "string", description: "Metric to rank rows by, highest first", required: false },
-  limit: { type: "string", description: "Rows, 1-2000 (default 200)", required: false }
-};
-registerSchema({
-  command: "ads.chatgpt.insights",
-  description: "Performance of the connected ChatGPT Ads account: impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, attributed sales and ROAS, per account, campaign, ad group or ad, over a window, optionally per day and broken down by country, device, platform or product. Spend and costs are in the account currency; null means not reported, not zero.",
-  args
-});
-function insightsHints(report) {
-  const hints = [];
-  if (report.rows.length === 0) {
-    hints.push(
-      "No delivery in this window. Check `baker ads chatgpt campaigns` for serving issues before concluding the ads do not work."
-    );
-  }
-  if (report.truncated) {
-    hints.push("More rows matched than --limit allowed. Narrow the report or raise --limit (max 2000).");
-  }
-  hints.push(
-    "Conversions come from ChatGPT Ads' own pixel or Conversions API and take at least a day to appear; the most recent days are still filling in."
-  );
-  return hints;
-}
-var insightsCommand = defineCommand({
-  meta: {
-    name: "insights",
-    description: `How a ChatGPT Ads account performs. Start here for "how are the ChatGPT campaigns doing".
-
-Examples:
-  baker ads chatgpt insights                                          # last 7 days, one row per campaign
-  baker ads chatgpt insights --days 30 --granularity daily --level account
-  baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend
-  baker ads chatgpt insights --segment country --metrics spend,clicks,conversions
-  baker ads chatgpt insights --since 2026-09-01 --until 2026-09-07 --metrics spend,order_created_roas`
-  },
-  args,
-  run: async ({ args: input }) => {
-    const parsed = chatgptAdsInsightsRequestSchema.safeParse(insightsRequestFromArgs(input));
-    if (!parsed.success) {
-      const message = parsed.error.issues[0]?.message ?? "Invalid report request";
-      writeJsonEnvelope({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message,
-          fix: { action: "retry_with_modified_query", explanation: message },
-          retryable: false
-        }
-      });
-      process.exit(1);
-    }
-    await runChatgptRead(
-      CHATGPT_ADS_REFERENCE.insights,
-      () => apiPost("/api/ads/chatgpt/insights", parsed.data),
-      insightsHints
-    );
-  }
-});
-export {
-  insightsCommand
-};
-//# sourceMappingURL=insights-ZIU6FJMS.js.map

package/dist/inspect-Q5NHBBHX.js

@@ -1,189 +0,0 @@
-import {
-  fetchRunRecord
-} from "./chunk-A4LOJ2VD.js";
-import {
-  findWorkspaceRoot
-} from "./chunk-DZSIUEGH.js";
-import "./chunk-HRYOZUSK.js";
-import "./chunk-VVZBBKRC.js";
-import "./chunk-YBMVHGY3.js";
-import "./chunk-XF4JUKVF.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
-import {
-  ApiError
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import "./chunk-NU7JSWVA.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-Q5NHBBHX.js.map

package/dist/inspect-Q5NHBBHX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/canvas/inspect.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { defineCommand } from \"citty\";\nimport { ApiError } from \"../../client.ts\";\nimport { findWorkspaceRoot } from \"./normalize-paths.ts\";\nimport { fetchRunRecord } from \"./run-history.ts\";\n\nconst execFileAsync = promisify(execFile);\n\ntype ManifestNodeRun = {\n  node_id: string;\n  node_type: string;\n  cached: boolean;\n  duration_ms: number;\n  credits: number;\n};\n\ntype Manifest = {\n  run_id: string;\n  output?: unknown;\n  stats?: { total_nodes: number; cached_nodes: number; total_credits: number; duration_ms: number };\n  node_runs?: ManifestNodeRun[];\n};\n\nexport const inspectCommand = defineCommand({\n  meta: {\n    name: \"inspect\",\n    description:\n      \"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_…) 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.\",\n  },\n  args: {\n    run: { type: \"positional\", required: true, description: \"Run id (e.g. r_01K...) or absolute run directory\" },\n    \"outputs-dir\": { type: \"string\", description: \"Per-run outputs root (default <workspace root>/canvas, where `canvas run` writes)\" },\n    thumbnails: {\n      type: \"boolean\",\n      description: \"Extract start/middle/end frames from every video output in the local run folder (requires ffmpeg)\",\n    },\n  },\n  async run({ args }) {\n    const cwd = process.cwd();\n    const outputsDir = args[\"outputs-dir\"]\n      ? path.resolve(String(args[\"outputs-dir\"]))\n      : path.join(findWorkspaceRoot(cwd) ?? cwd, \"canvas\");\n    const runArg = String(args.run);\n    const runDir = await localRunDir(runArg, outputsDir);\n    if (!runDir) {\n      if (path.isAbsolute(runArg)) fail(\"not_found\", `${runArg} is not a run directory`);\n      await inspectFromHistory(runArg, path.join(outputsDir, runArg));\n      return;\n    }\n\n    const manifest = await loadManifest(runDir);\n    const files = await listRunFiles(runDir);\n    const videos = files.filter((f) => isVideoFile(f.path));\n    let thumbnails: Array<{ video: string; frames: string[] }> = [];\n    if (args.thumbnails) {\n      thumbnails = await extractThumbnails(videos.map((v) => v.path));\n    }\n\n    const summary = {\n      ok: true,\n      source: \"local\",\n      run_id: manifest.run_id ?? path.basename(runDir),\n      run_dir: runDir,\n      stats: manifest.stats ?? null,\n      output: manifest.output ?? null,\n      node_runs: manifest.node_runs ?? [],\n      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),\n      thumbnails,\n    };\n\n    process.stdout.write(`${JSON.stringify(summary, null, 2)}\\n`);\n  },\n});\n\n/** The run's local folder, or null when this workspace does not have it. */\nasync function localRunDir(run: string, outputsDir: string): Promise<string | null> {\n  const candidate = path.isAbsolute(run) ? run : path.join(outputsDir, run);\n  const s = await stat(candidate).catch(() => null);\n  return s?.isDirectory() ? candidate : null;\n}\n\n/** The run as the company's run history keeps it: no local files, durable output URLs. */\nasync function inspectFromHistory(runId: string, expectedDir: string): Promise<void> {\n  let run: Awaited<ReturnType<typeof fetchRunRecord>>;\n  try {\n    run = await fetchRunRecord(runId);\n  } catch (e) {\n    const reason = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);\n    fail(\"unavailable\", `No run folder at ${expectedDir}, and the run history could not be read (${reason}).`);\n  }\n  if (!run) {\n    fail(\n      \"not_found\",\n      `No run \"${runId}\": there is no folder at ${expectedDir} and the company's run history has no run by that id.`,\n    );\n  }\n  const summary = {\n    ok: true,\n    source: \"run_history\",\n    run_id: run.runId,\n    creative: run.creativeSlug ?? null,\n    status: run.status,\n    ...(run.errorMessage ? { error: run.errorMessage } : {}),\n    stats: {\n      total_nodes: run.stats.totalNodes,\n      cached_nodes: run.stats.cachedNodes,\n      total_credits: run.stats.totalCredits,\n      duration_ms: run.stats.durationMs,\n    },\n    outputs: run.finalOutputs,\n    node_runs: run.nodes.map((node) => ({\n      node_id: node.nodeId,\n      node_type: node.nodeType,\n      cached: node.cached,\n      duration_ms: node.durationMs,\n      credits: node.credits,\n      ...(node.status ? { status: node.status } : {}),\n      outputs: node.outputs,\n    })),\n    ...(run.review ? { review: run.review } : {}),\n    hints: [\n      \"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>`.\",\n    ],\n  };\n  process.stdout.write(`${JSON.stringify(summary, null, 2)}\\n`);\n}\n\nfunction fail(code: string, message: string): never {\n  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}\\n`);\n  process.exit(2);\n}\n\nasync function loadManifest(runDir: string): Promise<Manifest> {\n  const manifestPath = path.join(runDir, \"manifest.json\");\n  try {\n    const raw = await readFile(manifestPath, \"utf-8\");\n    return JSON.parse(raw) as Manifest;\n  } catch {\n    return {} as Manifest;\n  }\n}\n\ntype RunFile = { name: string; path: string; size: number };\nasync function listRunFiles(runDir: string): Promise<RunFile[]> {\n  const out: RunFile[] = [];\n  const names = await readdir(runDir);\n  for (const name of names) {\n    const abs = path.join(runDir, name);\n    const s = await stat(abs).catch(() => null);\n    if (!s?.isFile()) continue;\n    out.push({ name, path: abs, size: s.size });\n  }\n  out.sort((a, b) => a.name.localeCompare(b.name));\n  return out;\n}\n\nfunction isVideoFile(p: string): boolean {\n  return /\\.(mp4|webm|mov)$/i.test(p);\n}\n\nasync function extractThumbnails(videoPaths: string[]): Promise<Array<{ video: string; frames: string[] }>> {\n  const out: Array<{ video: string; frames: string[] }> = [];\n  for (const v of videoPaths) {\n    const duration = await probeDuration(v).catch(() => null);\n    if (duration === null) {\n      out.push({ video: v, frames: [] });\n      continue;\n    }\n    const frames: string[] = [];\n    const checkpoints = [0.05, 0.5, 0.95];\n    const base = v.replace(/\\.[^.]+$/, \"\");\n    for (const ratio of checkpoints) {\n      const at = Math.max(0, Math.min(duration * ratio, duration - 0.01));\n      const dest = `${base}__frame_${Math.round(ratio * 100)\n        .toString()\n        .padStart(2, \"0\")}.png`;\n      try {\n        await execFileAsync(\"ffmpeg\", [\"-ss\", at.toFixed(3), \"-i\", v, \"-frames:v\", \"1\", \"-y\", dest]);\n        frames.push(dest);\n      } catch {\n        // skip — best-effort; thumbnail extraction is non-fatal.\n      }\n    }\n    out.push({ video: v, frames });\n  }\n  return out;\n}\n\nasync function probeDuration(filePath: string): Promise<number> {\n  const { stdout } = await execFileAsync(\n    \"ffprobe\",\n    [\"-v\", \"error\", \"-show_entries\", \"format=duration\", \"-of\", \"csv=p=0\", filePath],\n    { encoding: \"utf-8\" },\n  );\n  return Number.parseFloat(stdout.trim());\n}\n"],"mappings":"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","names":[]}

package/dist/inspiration-P265QJ2H.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-742XSULP.js").then((m) => m.searchCommand),
-    view: () => import("./view-NPAG66QK.js").then((m) => m.viewCommand),
-    code: () => import("./code-YS6ZMGX3.js").then((m) => m.codeCommand),
-    page: () => import("./page-GS3WLT2C.js").then((m) => m.pageCommand),
-    sequences: () => import("./sequences-OIPVR7JL.js").then((m) => m.sequencesCommand),
-    add: () => import("./add-577QWMCF.js").then((m) => m.addCommand),
-    favorites: () => import("./favorites-NSGF4OV5.js").then((m) => m.favoritesCommand),
-    favorite: () => import("./favorites-NSGF4OV5.js").then((m) => m.favoriteCommand),
-    unfavorite: () => import("./favorites-NSGF4OV5.js").then((m) => m.unfavoriteCommand),
-    "retry-failed": () => import("./retry-failed-6HXPUVXJ.js").then((m) => m.retryFailedCommand),
-    scrape: () => import("./scrape-ETAMW43A.js").then((m) => m.scrapeCommand)
-  }
-});
-export {
-  inspirationCommand
-};
-//# sourceMappingURL=inspiration-P265QJ2H.js.map

package/dist/keyword-metrics-PDY4ZXSP.js

@@ -1,197 +0,0 @@
-import {
-  keywordMetricsHints
-} from "./chunk-OZRUJVIQ.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-WNFIJAUO.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-LIQ4SQ2T.js";
-import "./chunk-XCM6XWOB.js";
-import {
-  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
-} from "./chunk-XF4JUKVF.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-TEINLN64.js";
-import "./chunk-ZJWUBJYQ.js";
-import "./chunk-NE4F3FHN.js";
-import {
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import "./chunk-IFWP3ZDO.js";
-import "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.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-PDY4ZXSP.js.map

package/dist/keyword-metrics-PDY4ZXSP.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":[]}