@koda-sl/baker-cli 0.560.0 → 0.561.0

package/dist/keyword-metrics-IDMR3ES2.js

@@ -1,200 +0,0 @@
-import {
-  keywordMetricsHints
-} from "./chunk-X2OVFCRC.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-CXYX6G3I.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-FVDC6AKZ.js";
-import "./chunk-Q2JDS6WL.js";
-import {
-  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
-} from "./chunk-TK7VRZKM.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-MSMTG6OC.js";
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.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-IDMR3ES2.js.map

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

@@ -1,131 +0,0 @@
-import {
-  keywordsForSiteHints
-} from "./chunk-X2OVFCRC.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-CXYX6G3I.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-FVDC6AKZ.js";
-import "./chunk-Q2JDS6WL.js";
-import "./chunk-TK7VRZKM.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-MSMTG6OC.js";
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.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-V3SGYZDW.js.map

package/dist/knowledge-PN3FAZJ2.js

@@ -1,195 +0,0 @@
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/knowledge/index.ts
-import { defineCommand as defineCommand2 } from "citty";
-
-// src/commands/knowledge/search.ts
-import { execFile } from "child_process";
-import { promisify } from "util";
-
-// ../api/src/knowledge.ts
-import { z } from "zod";
-var KNOWLEDGE_RANK_MAX_PASSAGES = 40;
-var KNOWLEDGE_RANK_MAX_PASSAGE_CHARS = 4e3;
-var knowledgeRankRequestSchema = z.object({
-  query: z.string().trim().min(1, "the question cannot be empty").max(2e3),
-  passages: z.array(z.string().max(KNOWLEDGE_RANK_MAX_PASSAGE_CHARS)).min(1).max(KNOWLEDGE_RANK_MAX_PASSAGES)
-});
-var knowledgeRankResponseSchema = z.object({
-  model: z.string(),
-  /** Every passage sent, best first. `index` points into the request's `passages`. */
-  ranking: z.array(z.object({ index: z.number().int().nonnegative(), score: z.number() }))
-});
-
-// src/commands/knowledge/search.ts
-import { defineCommand } from "citty";
-import { z as z2 } from "zod";
-var execFileAsync = promisify(execFile);
-var QMD_TIMEOUT_MS = 9e4;
-var PASSAGE_LINES = 70;
-var SNIPPET_CHARS = 300;
-var qmdRowSchema = z2.object({
-  file: z2.string(),
-  title: z2.string().optional(),
-  line: z2.number().int().optional(),
-  score: z2.number().default(0),
-  body: z2.string().default("")
-});
-function passageOf(body, line) {
-  const lines = body.split("\n");
-  const start = Math.max(0, (line ?? 1) - 1 - 5);
-  return lines.slice(start, start + PASSAGE_LINES).join("\n").slice(0, KNOWLEDGE_RANK_MAX_PASSAGE_CHARS);
-}
-function qmdQueryArgs(args) {
-  return [
-    "query",
-    args.question,
-    "--no-rerank",
-    "--json",
-    "--full",
-    "-n",
-    String(KNOWLEDGE_RANK_MAX_PASSAGES),
-    ...args.collection ? ["-c", args.collection] : []
-  ];
-}
-async function searchKnowledge(args, deps) {
-  const stdout = await deps.runQmd(qmdQueryArgs(args));
-  const rows = z2.array(qmdRowSchema).parse(JSON.parse(stdout));
-  if (rows.length === 0) {
-    return {
-      data: [],
-      meta: { count: 0, rankedBy: "qmd" },
-      hints: [
-        'Nothing in the vault answers this. Try an exact word with `qmd search "<word>"`, or check the collections with `qmd collection list`.'
-      ]
-    };
-  }
-  const passages = rows.map((row) => passageOf(row.body, row.line));
-  const ranked = await deps.rank({ query: args.question, passages }).catch(() => null);
-  const { model, ranking } = ranked ?? {
-    model: "qmd",
-    ranking: rows.map((row, index) => ({ index, score: row.score }))
-  };
-  const data = ranking.slice(0, args.limit).flatMap(({ index, score }) => {
-    const row = rows[index];
-    const passage = passages[index];
-    if (!row || passage === void 0) return [];
-    return [
-      {
-        file: row.file,
-        ...row.title ? { title: row.title } : {},
-        ...row.line ? { line: row.line } : {},
-        score: Math.round(score * 100) / 100,
-        snippet: passage.slice(0, SNIPPET_CHARS),
-        ...args.full ? { passage } : {}
-      }
-    ];
-  });
-  const hints = ranked ? [] : [
-    "Not ranked: the ranking model did not answer, so these are in qmd's own order. Read a few before trusting the first."
-  ];
-  return { data, meta: { count: data.length, rankedBy: model }, hints };
-}
-var ARGS = {
-  question: {
-    type: "positional",
-    description: "The question, in plain words: what you want to know, not keywords",
-    required: true
-  },
-  collection: {
-    type: "string",
-    alias: "c",
-    description: "Only this qmd collection (names: qmd collection list)",
-    required: false
-  },
-  limit: {
-    type: "string",
-    alias: "n",
-    description: "Passages to return, 1-20 (default: 5)",
-    required: false
-  },
-  full: {
-    type: "boolean",
-    description: "Also return each passage's text (default: a 300-character snippet)",
-    required: false,
-    default: false
-  }
-};
-registerSchema({
-  command: "knowledge.search",
-  description: "Start here for a question about the company's Knowledge vault (src/content/): qmd finds the passages, a hosted model ranks them, best first, in about 10 seconds. Returns file (open it with `qmd get <file>`), line, score and a snippet. For an exact word, name or phrase use `qmd search` instead (instant).",
-  args: ARGS
-});
-function readLimit(raw) {
-  const limit = raw === void 0 ? 5 : Number(raw);
-  return Number.isInteger(limit) && limit >= 1 && limit <= 20 ? limit : 5;
-}
-var searchCommand = defineCommand({
-  meta: {
-    name: "search",
-    description: `Answer a question from the Knowledge vault: the best passages, ranked. Read-only, ~10 s.
-
-Start here:
-  baker knowledge search "what budget did we start Meta prospecting with"
-  baker knowledge search "which hooks worked for retargeting" -c audits -n 10
-
-Each hit: file (read it whole with \`qmd get <file>\`), line, score (0-1), snippet. --full adds the passage text.
-For an exact word, name or phrase: \`qmd search "<words>"\` (instant).
-Full guide: __tooling__/docs/tools/baker/knowledge.md`
-  },
-  args: ARGS,
-  run: async ({ args }) => {
-    try {
-      const { data, meta, hints } = await searchKnowledge(
-        {
-          question: String(args.question),
-          ...typeof args.collection === "string" ? { collection: args.collection } : {},
-          limit: readLimit(args.limit),
-          full: args.full === true
-        },
-        {
-          runQmd: async (qmdArgs) => (await execFileAsync("qmd", qmdArgs, { timeout: QMD_TIMEOUT_MS, maxBuffer: 64 * 1024 * 1024 })).stdout,
-          rank: (request) => apiPost("/api/knowledge/rank", request, { timeoutMs: 2e4 })
-        }
-      );
-      writeJson({ ok: true, data, meta, ...hints.length > 0 ? { hints } : {} });
-    } catch (err) {
-      writeJson({
-        ok: false,
-        error: {
-          code: "UNAVAILABLE",
-          message: `The vault search did not run: ${err instanceof Error ? err.message.slice(0, 300) : "unknown error"}`,
-          fix: {
-            action: "degrade",
-            explanation: 'Search for an exact word instead with `qmd search "<word>"` (instant), or read the likely files under src/content/ directly. Do not retry in a loop.'
-          }
-        }
-      });
-      process.exit(1);
-    }
-  }
-});
-
-// src/commands/knowledge/index.ts
-var knowledgeCommand = defineCommand2({
-  meta: {
-    name: "knowledge",
-    description: "Search the company's Knowledge vault (src/content/): answers to a question, ranked best first."
-  },
-  subCommands: {
-    search: searchCommand
-  }
-});
-export {
-  knowledgeCommand
-};
-//# sourceMappingURL=knowledge-PN3FAZJ2.js.map

package/dist/landing-7PZPYD3M.js

@@ -1,28 +0,0 @@
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/landing/index.ts
-import { defineCommand } from "citty";
-var landingCommand = defineCommand({
-  meta: {
-    name: "landing",
-    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.
-
-Start here: \`baker landing critique <slug>\` after building or editing a landing.
-
-Subcommands:
-  baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
-  baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
-  baker landing critique <slug>   \u2014 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-WGUU7W5Z.js").then((m) => m.inspirationCommand),
-    critique: () => import("./critique-CYV7JQAY.js").then((m) => m.critiqueCommand),
-    variant: () => import("./variant-MEHXEXFK.js").then((m) => m.variantCommand),
-    export: () => import("./export-6WWVO4O6.js").then((m) => m.exportCommand)
-  }
-});
-export {
-  landingCommand
-};
-//# sourceMappingURL=landing-7PZPYD3M.js.map