@koda-sl/baker-cli 0.470.0-dev.fb31086c9 → 0.471.0

package/dist/chunk-LYPYD2W5.js

@@ -1,206 +0,0 @@
-import {
-  RESEARCH_GOOGLE_ADS_MAX_COPY
-} from "./chunk-RPJYEJDQ.js";
-
-// src/commands/research/hints.ts
-var AD_COPY_ROUTE = 'This returns competing domains and their SERP economics \u2014 no ad copy, no headlines, no creative. For a competitor\'s Google ads and their copy: `baker research google-ads <competitor.com> --copy` (Google\'s Ads Transparency Center: every ad, how long it has run, and the text ads\' headline and description). For Meta and LinkedIn: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). Do not keep querying this command for copy.';
-function noSerpRowsHints(rowCount, queryContext) {
-  if (rowCount > 0) {
-    return [];
-  }
-  const defaulted = queryContext.location_is_default || queryContext.language_is_default;
-  if (defaulted) {
-    return [
-      `No rows for ${queryContext.location} / ${queryContext.language} \u2014 the market you did not set. Set --location and --language for the client's actual market and re-run once (\`baker research countries\` / \`baker research languages\` for the accepted codes) before you touch the keyword.`
-    ];
-  }
-  return [
-    `No rows for ${queryContext.location} / ${queryContext.language}, which you set explicitly. This term has no third-party SERP coverage in that market \u2014 move on rather than re-querying it. For demand signal try \`baker research autocomplete\`; for a competitor's actual terms, \`baker research keywords-for-site <domain>\`.`
-  ];
-}
-function advertisersHints(rowCount, queryContext) {
-  return [...noSerpRowsHints(rowCount, queryContext), AD_COPY_ROUTE];
-}
-function keywordsForSiteHints(rowCount, queryContext, typeFilter) {
-  if (rowCount > 0) {
-    return [];
-  }
-  if (typeFilter === "paid" || typeFilter === "organic") {
-    return [
-      `No rows with --type ${typeFilter} in ${queryContext.location} / ${queryContext.language}. A domain with zero ${typeFilter} keywords in a market is itself the finding \u2014 record it and move on. Confirm once with --type all (nothing at all there means the domain has no SERP coverage, not that it has no ads) instead of re-running with a different --sort or --limit.`
-    ];
-  }
-  return noSerpRowsHints(rowCount, queryContext);
-}
-var THIN_ANSWER_CHARS = 600;
-var THIN_SOURCE_COUNT = 2;
-var ESCALATION = {
-  medium: "`medium` is a quick lookup, not a search. Re-ask the SAME question once with `--depth high` before concluding the web has nothing on it.",
-  high: "`high` already thought hard about this. `--depth xhigh` is the only step left and it can run 15 minutes \u2014 take it only if this answer blocks a deliverable; otherwise record the gap and move on."
-};
-function fetchHints({
-  truncated,
-  contentChars,
-  shownChars
-}) {
-  const hints = [];
-  if (shownChars < contentChars) {
-    hints.push(
-      `Showing the first ${shownChars.toLocaleString("en-US")} of ${contentChars.toLocaleString("en-US")} characters. Re-run the same command with \`--full\` for the whole page \u2014 the read is cached for 24h, so it costs no extra time and no extra credit.`
-    );
-  }
-  if (truncated) {
-    hints.push(
-      "This page is longer than one read returns, so the end of it is missing. Don't present this as the complete page; if the part you need is further down, fetch the deeper URL directly."
-    );
-  }
-  return hints;
-}
-function webDepthHints({
-  answer,
-  sourceCount,
-  depth
-}) {
-  const thin = answer.length < THIN_ANSWER_CHARS || sourceCount <= THIN_SOURCE_COUNT;
-  const escalation = ESCALATION[depth];
-  if (!thin || !escalation) {
-    return [];
-  }
-  return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];
-}
-function keywordMetricsHints({
-  rows,
-  asked,
-  clickstream,
-  queryContext
-}) {
-  if (rows.length === 0) {
-    return noSerpRowsHints(0, queryContext);
-  }
-  const provenance = "DataForSEO resells Google's Keyword Planner volume \u2014 planner_search_volume here is the SAME number `baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing sources is not corroboration." + (clickstream ? " clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting." : " For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: `baker gsc query` for what already reaches the site, or the account's own search terms.");
-  const hints = [provenance];
-  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);
-  if (empty.length > 0) {
-    hints.push(
-      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ${empty.join(", ")}. That is missing coverage, NOT zero demand \u2014 do not report them as unsearched, and do not re-query them reworded. \`baker research autocomplete\` on the head term is the way to find the phrasing that market uses.`
-    );
-  }
-  return hints;
-}
-var ARCHIVE_NOTE = "Read from the Reddit archive: the words are as posted, but points and comment counts on anything under ~36h old are as first captured \u2014 don't quote those numbers as current.";
-function redditSearchHints({
-  resultCount,
-  kind,
-  source
-}) {
-  const hints = [];
-  if (resultCount === 0) {
-    hints.push(
-      'Nothing matched. Reddit search matches words, not meaning: try the audience\'s own phrasing (one distinctive word, or a seed from `baker research autocomplete`), a longer --since window, or other subreddits \u2014 `baker research reddit subreddits "<topic>"` finds where the audience actually talks' + (kind === "posts" ? ", and try --kind comments \u2014 most of the voice is in the replies." : ".")
-    );
-  } else if (kind === "posts") {
-    hints.push(
-      "Titles rarely carry the voice. Read the promising threads with `baker research reddit thread <permalink>` for the replies, or search the replies directly with --kind comments."
-    );
-  }
-  if (source === "archive" && resultCount > 0) hints.push(ARCHIVE_NOTE);
-  return hints;
-}
-function redditThreadHints({
-  commentsShown,
-  commentsAsked,
-  commentCount,
-  source
-}) {
-  const hints = [];
-  if (commentsAsked > 0 && commentsShown === 0 && (commentCount ?? 0) > 0) {
-    hints.push(
-      `This thread has ${commentCount} comments but none could be read just now. Quote the post only, and don't describe the replies.`
-    );
-  }
-  if (source === "archive") hints.push(ARCHIVE_NOTE);
-  return hints;
-}
-var REDDIT_HOST = /(^|\.)reddit\.com$|^redd\.it$/i;
-function redditSubredditsHints({ resultCount }) {
-  if (resultCount === 0) {
-    return [
-      'No subreddits matched. Try the audience\'s role or the platform they work on ("amazon flex", "deliveroo", "nurses"), one word at a time, or a web search for `site:reddit.com <topic>`.'
-    ];
-  }
-  return [
-    'Members say how big a subreddit is, not how active it is. Before mining one, run `baker research reddit search "<word>" --subreddit <name> --since <a recent date>`: nothing back means it is quiet, so pick another. `restricted` can still be read; `private` cannot.'
-  ];
-}
-var REDDIT_LINK_REJECTED = {
-  action: "reject",
-  explanation: "Do not quote anything attributed to this link \u2014 it does not lead to those words. Find the real thread with `baker research reddit search`, and if you already wrote a quote from it, remove it."
-};
-function redditPageFix(url, code) {
-  let host;
-  try {
-    host = new URL(url).hostname;
-  } catch {
-    return null;
-  }
-  if (!REDDIT_HOST.test(host)) return null;
-  if (code === "NOT_FOUND") return REDDIT_LINK_REJECTED;
-  if (code !== "FORBIDDEN") return null;
-  return {
-    action: "retry_with_changes",
-    explanation: 'Read Reddit with its own commands: `baker research reddit search "<words>" --subreddit <name>` to find what people said, `baker research reddit thread <url>` for one thread.'
-  };
-}
-function googleAdsHints({
-  target,
-  adCount,
-  located,
-  textWithoutCopy,
-  copyAsked,
-  copyUnread,
-  visual
-}) {
-  if (adCount === 0) {
-    return [
-      `No Google ads point to ${target}${located ? " in that region" : ""} \u2014 that is the answer, not a failed call: this competitor is not advertising on Google there, or its ads point to another domain. ` + (located ? "Re-run once without --location to see every region; then move on. " : "Move on. ") + `Its paid search terms, if any: \`baker research keywords-for-site ${target} --type paid\`.`
-    ];
-  }
-  const hints = [];
-  if (!copyAsked && textWithoutCopy > 0) {
-    hints.push(
-      `${textWithoutCopy} text ads came back without their words. Re-run with --copy to read the headline and description of up to ${RESEARCH_GOOGLE_ADS_MAX_COPY} (cached, so only the reading is new).`
-    );
-  }
-  const pastCap = copyAsked ? textWithoutCopy - copyUnread : 0;
-  if (pastCap > 0) {
-    hints.push(
-      `${pastCap} text ads past the first ${RESEARCH_GOOGLE_ADS_MAX_COPY} were not read \u2014 one request reads at most ${RESEARCH_GOOGLE_ADS_MAX_COPY}. Narrow with --since, --location or --platform google_search and re-run for their words.`
-    );
-  }
-  if (visual > 0 || copyUnread > 0) {
-    const without = [
-      visual > 0 ? `${visual} image or video ads (Google gives no text for those)` : "",
-      copyUnread > 0 ? `${copyUnread} text ads whose image could not be read` : ""
-    ].filter(Boolean);
-    hints.push(
-      `No copy for ${without.join(" and ")}: show those by their \`transparency_url\`. Do not open the Transparency Center in agent-browser to read them \u2014 it is the browser load this command exists to avoid.`
-    );
-  }
-  return hints;
-}
-
-export {
-  noSerpRowsHints,
-  advertisersHints,
-  keywordsForSiteHints,
-  fetchHints,
-  webDepthHints,
-  keywordMetricsHints,
-  redditSearchHints,
-  redditThreadHints,
-  redditSubredditsHints,
-  REDDIT_LINK_REJECTED,
-  redditPageFix,
-  googleAdsHints
-};
-//# sourceMappingURL=chunk-LYPYD2W5.js.map

package/dist/chunk-M22GYDBE.js

@@ -1,136 +0,0 @@
-import {
-  coercePathUrlToUrl,
-  looksLikeHttpUrl
-} from "./chunk-3BLSLGVH.js";
-
-// src/commands/canvas/resolve-paths.ts
-import path from "path";
-function resolveRelativeCanvasPaths(canvas, baseDir) {
-  if (!canvas || typeof canvas !== "object") return canvas;
-  const c = canvas;
-  if (!Array.isArray(c.nodes)) return canvas;
-  return { ...canvas, nodes: c.nodes.map((n) => resolveNode(n, baseDir)) };
-}
-function localPathParam(node) {
-  if (node.type === "ingest") return node.params?.source === "path" ? "path" : null;
-  if (node.type === "hyperframe_render" || node.type === "hyperframe_snapshot") return "composition";
-  return null;
-}
-function resolveNode(node, baseDir) {
-  if (!node || typeof node !== "object") return node;
-  const n = node;
-  const params = n.params;
-  if (!params || typeof params !== "object") return node;
-  const key = localPathParam(n);
-  if (key && isResolvableRelative(params[key])) {
-    return { ...node, params: { ...params, [key]: path.resolve(baseDir, params[key]) } };
-  }
-  return node;
-}
-function isResolvableRelative(value) {
-  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !looksLikeHttpUrl(value) && !path.isAbsolute(value);
-}
-
-// src/commands/canvas/normalize-paths.ts
-import { existsSync, realpathSync } from "fs";
-import { writeFile } from "fs/promises";
-import path2 from "path";
-function findWorkspaceRoot(startDir, exists = existsSync, maxDepth = 12) {
-  let dir = path2.resolve(startDir);
-  for (let i = 0; i < maxDepth; i++) {
-    if (exists(path2.join(dir, "package.json"))) return dir;
-    const parent = path2.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
-function canvasOutputsRoot(canvasFile, cwd = process.cwd(), exists = existsSync) {
-  const root = findWorkspaceRoot(path2.dirname(path2.resolve(cwd, canvasFile)), exists) ?? cwd;
-  return path2.join(root, "canvas");
-}
-function canonicalize(target) {
-  const abs = path2.resolve(target);
-  let dir = abs;
-  for (; ; ) {
-    try {
-      const real = realpathSync(dir);
-      return dir === abs ? real : path2.join(real, path2.relative(dir, abs));
-    } catch {
-      const parent = path2.dirname(dir);
-      if (parent === dir) return abs;
-      dir = parent;
-    }
-  }
-}
-function isInside(root, target) {
-  const rel = path2.relative(root, target);
-  return rel !== "" && !rel.startsWith("..") && !path2.isAbsolute(rel);
-}
-function toCanvasRelative(canvasDir, target) {
-  return path2.relative(canvasDir, target).split(path2.sep).join("/");
-}
-var RUNTIME_WORKSPACE_ROOT = "/home/user/repo";
-function rewriteTarget(value, workspaceRoot) {
-  if (typeof value !== "string" || value.length === 0) return null;
-  if (value.includes("[TODO") || looksLikeHttpUrl(value) || !path2.isAbsolute(value)) return null;
-  const target = canonicalize(value);
-  if (isInside(workspaceRoot, target)) return target;
-  const fromRuntime = path2.relative(RUNTIME_WORKSPACE_ROOT, path2.normalize(value));
-  if (fromRuntime !== "" && !fromRuntime.startsWith("..") && !path2.isAbsolute(fromRuntime)) {
-    return path2.join(workspaceRoot, fromRuntime);
-  }
-  return null;
-}
-function normalizeCanvasPaths(canvas, canvasDir, workspaceRoot) {
-  if (!canvas || typeof canvas !== "object") return { canvas, rewrites: [] };
-  const c = canvas;
-  if (!Array.isArray(c.nodes)) return { canvas, rewrites: [] };
-  const root = canonicalize(workspaceRoot);
-  const dir = canonicalize(canvasDir);
-  const rewrites = [];
-  const nodes = c.nodes.map((node) => {
-    if (!node || typeof node !== "object") return node;
-    const n = node;
-    const params = n.params;
-    if (!params || typeof params !== "object") return node;
-    const nodeId = typeof n.id === "string" ? n.id : "?";
-    if (n.type === "ingest" && params.source === "path" && looksLikeHttpUrl(params.path)) {
-      rewrites.push({ nodeId, param: "source", from: "path", to: "url" });
-      return { ...node, params: coercePathUrlToUrl(params) };
-    }
-    const key = localPathParam(n);
-    if (!key) return node;
-    const target = rewriteTarget(params[key], root);
-    if (target === null) return node;
-    const to = toCanvasRelative(dir, target);
-    rewrites.push({ nodeId, param: key, from: params[key], to });
-    return { ...node, params: { ...params, [key]: to } };
-  });
-  return rewrites.length === 0 ? { canvas, rewrites } : { canvas: { ...canvas, nodes }, rewrites };
-}
-async function healCanvasPaths(filePath, canvas) {
-  const canvasDir = path2.dirname(filePath);
-  const workspaceRoot = findWorkspaceRoot(canvasDir);
-  if (!workspaceRoot) return { canvas, rewrites: [], text: null };
-  const normalized = normalizeCanvasPaths(canvas, canvasDir, workspaceRoot);
-  if (normalized.rewrites.length === 0) return { ...normalized, text: null };
-  const text = `${JSON.stringify(normalized.canvas, null, 2)}
-`;
-  await writeFile(filePath, text, "utf8");
-  return { ...normalized, text };
-}
-function describeRewrites(rewrites) {
-  return rewrites.map((r) => `  ${r.nodeId}.${r.param}: ${r.from} \u2192 ${r.to}`).join("\n");
-}
-
-export {
-  resolveRelativeCanvasPaths,
-  localPathParam,
-  findWorkspaceRoot,
-  canvasOutputsRoot,
-  normalizeCanvasPaths,
-  healCanvasPaths,
-  describeRewrites
-};
-//# sourceMappingURL=chunk-M22GYDBE.js.map

package/dist/chunk-M5G6QOR4.js

@@ -1,52 +0,0 @@
-import {
-  commandFor,
-  declaredArg
-} from "./chunk-MV3PVKTU.js";
-
-// src/cache-flag.ts
-var NO_CACHE_ARG = {
-  type: "boolean",
-  description: "Skip cached results and read live from the platform (slower)",
-  required: false
-};
-var LEGACY = "--skip-cache";
-var CANONICAL = "--no-cache";
-var PARSEABLE = "--noCache";
-function respell(token, from, to) {
-  if (token === from) {
-    return [to];
-  }
-  if (!token.startsWith(`${from}=`)) {
-    return [token];
-  }
-  return token.slice(from.length + 1) === "false" ? [] : [to];
-}
-function normalizeCacheFlag(argv) {
-  return rewriteBeforeDoubleDash(argv, (token) => respell(token, LEGACY, CANONICAL));
-}
-function cacheFlagForCommand(root, argv) {
-  if (!argv.includes(CANONICAL)) {
-    return argv;
-  }
-  const command = commandFor(root, argv);
-  if (!command || declaredArg(command, "no-cache")) {
-    return argv;
-  }
-  return rewriteBeforeDoubleDash(argv, (token) => token === CANONICAL ? [] : [token]);
-}
-function cacheFlagForParser(argv) {
-  return rewriteBeforeDoubleDash(argv, (token) => respell(token, CANONICAL, PARSEABLE));
-}
-function rewriteBeforeDoubleDash(argv, rewrite) {
-  const end = argv.indexOf("--");
-  const limit = end === -1 ? argv.length : end;
-  return argv.flatMap((token, index) => index >= limit ? [token] : rewrite(token));
-}
-
-export {
-  NO_CACHE_ARG,
-  normalizeCacheFlag,
-  cacheFlagForCommand,
-  cacheFlagForParser
-};
-//# sourceMappingURL=chunk-M5G6QOR4.js.map

package/dist/chunk-MANARRN4.js

@@ -1,19 +0,0 @@
-import {
-  latestVersion
-} from "./chunk-DE7BGRAA.js";
-import {
-  canvasOutputsRoot
-} from "./chunk-M22GYDBE.js";
-
-// src/commands/creatives/version-of.ts
-import path from "path";
-async function versionOf(slug, run) {
-  if (typeof run === "string" && run.trim()) return run.trim();
-  const canvas = path.join("src", "creatives", slug, `${slug}.canvas.json`);
-  return await latestVersion(canvasOutputsRoot(canvas), slug) ?? void 0;
-}
-
-export {
-  versionOf
-};
-//# sourceMappingURL=chunk-MANARRN4.js.map