@koda-sl/baker-cli 0.530.0 → 0.532.0

package/dist/keyword-metrics-SBIRN5KC.js

@@ -0,0 +1,200 @@
+import {
+  keywordMetricsHints
+} from "./chunk-WWLZ5RRU.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-QPPQXU3U.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-SG2TDQEE.js";
+import "./chunk-44ZRCSR7.js";
+import {
+  RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS
+} from "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.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-SBIRN5KC.js.map

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

@@ -0,0 +1,131 @@
+import {
+  keywordsForSiteHints
+} from "./chunk-WWLZ5RRU.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-QPPQXU3U.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-SG2TDQEE.js";
+import "./chunk-44ZRCSR7.js";
+import "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.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-TLNPJHT2.js.map

package/dist/knowledge-L3VLOVLG.js

@@ -0,0 +1,195 @@
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.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-L3VLOVLG.js.map

package/dist/knowledge-L3VLOVLG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/knowledge/index.ts","../src/commands/knowledge/search.ts","../../api/src/knowledge.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { searchCommand } from \"./search.ts\";\n\nexport const knowledgeCommand = defineCommand({\n  meta: {\n    name: \"knowledge\",\n    description: \"Search the company's Knowledge vault (src/content/): answers to a question, ranked best first.\",\n  },\n  subCommands: {\n    search: searchCommand,\n  },\n});\n","import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport {\n  KNOWLEDGE_RANK_MAX_PASSAGE_CHARS,\n  KNOWLEDGE_RANK_MAX_PASSAGES,\n  type KnowledgeRankRequest,\n  type KnowledgeRankResponse,\n} from \"@baker/api/knowledge\";\nimport { defineCommand } from \"citty\";\nimport { z } from \"zod\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\n/**\n * `baker knowledge search`: qmd finds the passages, a hosted model ranks them.\n *\n * qmd's own reranker runs a 0.6B model on the Runtime's CPU — about 200 tokens a\n * second, so two minutes for the ~30 passages of one question, past the 120 s\n * bound a shell command gets. qmd still expands the question and fuses keyword\n * and vector hits here (`--no-rerank`, ~8 s, cached per question); only the\n * ordering is sent to the backend's reranker, which answers in under a second.\n * Measured on 10 marketer questions over the playbooks: NDCG@5 0.47 for qmd's\n * fused order, 0.81 ranked here.\n */\n\nconst execFileAsync = promisify(execFile);\n\n/** qmd expands, embeds and fuses in ~8 s; a query still running at this point is hung, not slow. */\nconst QMD_TIMEOUT_MS = 90_000;\n/** Lines kept from a passage's start, about qmd's own 900-token chunk. */\nconst PASSAGE_LINES = 70;\nconst SNIPPET_CHARS = 300;\n\nconst qmdRowSchema = z.object({\n  file: z.string(),\n  title: z.string().optional(),\n  line: z.number().int().optional(),\n  score: z.number().default(0),\n  body: z.string().default(\"\"),\n});\n\nexport interface KnowledgeHit {\n  file: string;\n  title?: string;\n  line?: number;\n  score: number;\n  snippet: string;\n  passage?: string;\n}\n\nexport interface SearchKnowledgeDeps {\n  /** qmd's stdout for the given arguments. */\n  runQmd: (args: string[]) => Promise<string>;\n  rank: (request: KnowledgeRankRequest) => Promise<KnowledgeRankResponse>;\n}\n\nexport interface SearchKnowledgeArgs {\n  question: string;\n  collection?: string;\n  limit: number;\n  full: boolean;\n}\n\n/** The lines a hit stands for: from just above qmd's best-passage line. Pure. */\nfunction passageOf(body: string, line: number | undefined): string {\n  const lines = body.split(\"\\n\");\n  const start = Math.max(0, (line ?? 1) - 1 - 5);\n  return lines\n    .slice(start, start + PASSAGE_LINES)\n    .join(\"\\n\")\n    .slice(0, KNOWLEDGE_RANK_MAX_PASSAGE_CHARS);\n}\n\nfunction qmdQueryArgs(args: SearchKnowledgeArgs): string[] {\n  return [\n    \"query\",\n    args.question,\n    \"--no-rerank\",\n    \"--json\",\n    \"--full\",\n    \"-n\",\n    String(KNOWLEDGE_RANK_MAX_PASSAGES),\n    ...(args.collection ? [\"-c\", args.collection] : []),\n  ];\n}\n\nexport async function searchKnowledge(\n  args: SearchKnowledgeArgs,\n  deps: SearchKnowledgeDeps,\n): Promise<{ data: KnowledgeHit[]; meta: { count: number; rankedBy: string }; hints: string[] }> {\n  const stdout = await deps.runQmd(qmdQueryArgs(args));\n  const rows = z.array(qmdRowSchema).parse(JSON.parse(stdout));\n  if (rows.length === 0) {\n    return {\n      data: [],\n      meta: { count: 0, rankedBy: \"qmd\" },\n      hints: [\n        'Nothing in the vault answers this. Try an exact word with `qmd search \"<word>\"`, or check the collections with `qmd collection list`.',\n      ],\n    };\n  }\n  const passages = rows.map((row) => passageOf(row.body, row.line));\n  const ranked = await deps.rank({ query: args.question, passages }).catch(() => null);\n  const { model, ranking } = ranked ?? {\n    model: \"qmd\",\n    ranking: rows.map((row, index) => ({ index, score: row.score })),\n  };\n  const data = ranking.slice(0, args.limit).flatMap(({ index, score }) => {\n    const row = rows[index];\n    const passage = passages[index];\n    if (!row || passage === undefined) return [];\n    return [\n      {\n        file: row.file,\n        ...(row.title ? { title: row.title } : {}),\n        ...(row.line ? { line: row.line } : {}),\n        score: Math.round(score * 100) / 100,\n        snippet: passage.slice(0, SNIPPET_CHARS),\n        ...(args.full ? { passage } : {}),\n      },\n    ];\n  });\n  const hints = ranked\n    ? []\n    : [\n        \"Not ranked: the ranking model did not answer, so these are in qmd's own order. Read a few before trusting the first.\",\n      ];\n  return { data, meta: { count: data.length, rankedBy: model }, hints };\n}\n\nconst ARGS = {\n  question: {\n    type: \"positional\",\n    description: \"The question, in plain words: what you want to know, not keywords\",\n    required: true,\n  },\n  collection: {\n    type: \"string\",\n    alias: \"c\",\n    description: \"Only this qmd collection (names: qmd collection list)\",\n    required: false,\n  },\n  limit: {\n    type: \"string\",\n    alias: \"n\",\n    description: \"Passages to return, 1-20 (default: 5)\",\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description: \"Also return each passage's text (default: a 300-character snippet)\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"knowledge.search\",\n  description:\n    \"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).\",\n  args: ARGS,\n});\n\nfunction readLimit(raw: unknown): number {\n  const limit = raw === undefined ? 5 : Number(raw);\n  return Number.isInteger(limit) && limit >= 1 && limit <= 20 ? limit : 5;\n}\n\nexport const searchCommand = defineCommand({\n  meta: {\n    name: \"search\",\n    description: `Answer a question from the Knowledge vault: the best passages, ranked. Read-only, ~10 s.\n\nStart here:\n  baker knowledge search \"what budget did we start Meta prospecting with\"\n  baker knowledge search \"which hooks worked for retargeting\" -c audits -n 10\n\nEach hit: file (read it whole with \\`qmd get <file>\\`), line, score (0-1), snippet. --full adds the passage text.\nFor an exact word, name or phrase: \\`qmd search \"<words>\"\\` (instant).\nFull guide: __tooling__/docs/tools/baker/knowledge.md`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    try {\n      const { data, meta, hints } = await searchKnowledge(\n        {\n          question: String(args.question),\n          ...(typeof args.collection === \"string\" ? { collection: args.collection } : {}),\n          limit: readLimit(args.limit),\n          full: args.full === true,\n        },\n        {\n          runQmd: async (qmdArgs) =>\n            (await execFileAsync(\"qmd\", qmdArgs, { timeout: QMD_TIMEOUT_MS, maxBuffer: 64 * 1024 * 1024 })).stdout,\n          rank: (request) => apiPost<KnowledgeRankResponse>(\"/api/knowledge/rank\", request, { timeoutMs: 20_000 }),\n        },\n      );\n      writeJson({ ok: true, data, meta, ...(hints.length > 0 ? { hints } : {}) });\n    } catch (err) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"UNAVAILABLE\",\n          message: `The vault search did not run: ${err instanceof Error ? err.message.slice(0, 300) : \"unknown error\"}`,\n          fix: {\n            action: \"degrade\",\n            explanation:\n              '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.',\n          },\n        },\n      });\n      process.exit(1);\n    }\n  },\n});\n","/**\n * `baker knowledge search` — the wire contract for ranking the passages a\n * vault search found.\n *\n * The search itself runs in the Runtime (qmd, over the company's Knowledge);\n * only the ranking leaves it. qmd's own reranker is a CPU model that took two\n * minutes a question in a Runtime, so the passages qmd fused come here and a\n * hosted cross-encoder orders them in well under a second. Read-only.\n */\nimport { z } from \"zod\";\n\n/** qmd's fused candidates per question; more costs ranking time and returns nothing the top 5 would use. */\nexport const KNOWLEDGE_RANK_MAX_PASSAGES = 40;\n/** About 1,000 tokens: qmd's own chunk is 900. */\nexport const KNOWLEDGE_RANK_MAX_PASSAGE_CHARS = 4000;\n\nexport const knowledgeRankRequestSchema = z.object({\n  query: z.string().trim().min(1, \"the question cannot be empty\").max(2000),\n  passages: z.array(z.string().max(KNOWLEDGE_RANK_MAX_PASSAGE_CHARS)).min(1).max(KNOWLEDGE_RANK_MAX_PASSAGES),\n});\n\nexport type KnowledgeRankRequest = z.infer<typeof knowledgeRankRequestSchema>;\n\nexport const knowledgeRankResponseSchema = z.object({\n  model: z.string(),\n  /** Every passage sent, best first. `index` points into the request's `passages`. */\n  ranking: z.array(z.object({ index: z.number().int().nonnegative(), score: z.number() })),\n});\n\nexport type KnowledgeRankResponse = z.infer<typeof knowledgeRankResponseSchema>;\n"],"mappings":"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","names":["defineCommand","z","z","defineCommand"]}

package/dist/landing-ZICSVWKF.js

@@ -0,0 +1,28 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/index.ts
+import { defineCommand } from "citty";
+var landingCommand = defineCommand({
+  meta: {
+    name: "landing",
+    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.
+
+Start here: \`baker landing critique <slug>\` after building or editing a landing.
+
+Subcommands:
+  baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
+  baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
+  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and a rival named in a comparison, tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
+  baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
+  },
+  subCommands: {
+    inspiration: () => import("./inspiration-VXNGKAJV.js").then((m) => m.inspirationCommand),
+    critique: () => import("./critique-4YRRUNAU.js").then((m) => m.critiqueCommand),
+    variant: () => import("./variant-O7LXOA2E.js").then((m) => m.variantCommand),
+    export: () => import("./export-YCLJG5YP.js").then((m) => m.exportCommand)
+  }
+});
+export {
+  landingCommand
+};
+//# sourceMappingURL=landing-ZICSVWKF.js.map