@koda-sl/baker-cli 0.497.0 → 0.498.0

package/dist/chunk-EGHPYAI7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/ideas.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { readAllRules } from \"../../engine/creative-context/index.ts\";\nimport { selectRules } from \"../../engine/creative-rules/select.ts\";\nimport type { AskNouls } from \"../../engine/lib/remembered-nouls.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { marketFromCompanyDoc } from \"../../viewer-profile.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { sameMessageRead } from \"./ideas-judgments.ts\";\nimport { checkIdeas, IDEA_ANGLES, IDEA_FORMATS, type IdeaCheck } from \"./ideas-model.ts\";\nimport {\n  coverageOf,\n  readCreativeRecords,\n  readIdeas,\n  readInsights,\n  readKnowledgeCorpus,\n  readPersonaIds,\n  type UnreadableIdea,\n  workspaceIdeasJudge,\n} from \"./ideas-workspace.ts\";\nimport { type StoreProduct, storeProductReads } from \"./store-product.ts\";\n\nconst BUILD_NEXT = 3;\n\nconst DESCRIPTION = `Check and rank the ad ideas in src/creatives/_ideas/: is each backed by something a customer said (src/content/insights/), does it claim only what the Knowledge holds, is it a different ad from the others, does it fill a gap the live ads leave. Free and local.\n\nStart here, after writing 4-8 idea files (one per file: who, message, evidence, awareness, angle, shows, job, why; format only for a video or a container the person asked for; plus product: <handle> when the ad sells a store product, so the store's prices count as sourced):\n  baker creatives ideas            # ranked, with problems; build_next names the ones to make\n  baker creatives make <idea>      # then build each one in build_next\nAn idea with a problem is not built until it is fixed. An idea with no evidence is an explore bet: it may be built, and says so.`;\n\nconst ARGS = {\n  full: {\n    type: \"boolean\",\n    description: \"Every idea with its warnings and gaps, and the allowed angle and format values\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.ideas\", description: DESCRIPTION, args: ARGS });\n\ntype IdeasReport = {\n  ideas: IdeaCheck[];\n  unreadable: UnreadableIdea[];\n  insightCount: number;\n  observedCount: number;\n};\n\n/** What the agent does next. Pure. */\nexport function ideasHints(report: IdeasReport): string[] {\n  const hints: string[] = [];\n  const toBuild = report.ideas.filter((i) => i.status === \"idea\");\n  if (toBuild.length === 0 && report.unreadable.length === 0) {\n    hints.push(\n      \"No ideas yet. Write 4-8 files in src/creatives/_ideas/<idea>.md (who, message, evidence, awareness, angle, shows, job, why), then run this again.\",\n    );\n  }\n  if (report.unreadable.length > 0) {\n    hints.push(`Fix ${report.unreadable.map((u) => u.id).join(\", \")}: each names what is missing or unknown.`);\n  }\n  const blocked = toBuild.filter((i) => i.problems.length > 0);\n  if (blocked.length > 0) hints.push(`Fix before building: ${blocked.map((i) => i.id).join(\", \")}.`);\n  if (report.observedCount < 3) {\n    hints.push(\n      \"Few customer quotes on file: run `baker research customers` so ideas stand on what customers said; until then they are explore bets.\",\n    );\n  } else if (toBuild.length > 0 && toBuild.every((i) => i.evidence === \"explore\")) {\n    hints.push(\"No idea cites an insight: put the insight ids that back each one in its `evidence`.\");\n  }\n  const next = buildNext(report.ideas);\n  if (next.length === 1) hints.push(`Build: \\`baker creatives make ${next[0]}\\`.`);\n  // A render takes about five minutes: built one after another, three ideas took forty (dev, Oct 2026).\n  if (next.length > 1)\n    hints.push(\n      `Build ${next.join(\", \")} at once: one \\`creative-producer\\` per idea, all spawned in one message in the background, each given its idea id, and handle each as it returns. Never build them one after another: each render takes minutes. Edited an idea after this check? Run \\`baker creatives ideas\\` again first: a producer cannot build an idea with a problem.`,\n    );\n  return hints;\n}\n\n/** The ideas to build now: the best-ranked ones still to build with nothing blocking. Pure. */\nexport function buildNext(ideas: readonly IdeaCheck[], count = BUILD_NEXT): string[] {\n  // One explore bet a batch: the rest stand on what customers said.\n  const ready = ideas.filter((i) => i.status === \"idea\" && i.problems.length === 0);\n  const firstBet = ready.find((i) => i.evidence === \"explore\");\n  return ready\n    .filter((i) => i.evidence !== \"explore\" || i === firstBet)\n    .slice(0, count)\n    .map((i) => i.id);\n}\n\n/** One idea as the agent reads it by default: what decides building it, nothing more. Pure. */\nexport function compactIdea(check: IdeaCheck) {\n  return {\n    idea: check.id,\n    status: check.status,\n    evidence: check.evidence,\n    ...(check.quote ? { quote: check.quote.length > 120 ? `${check.quote.slice(0, 117)}...` : check.quote } : {}),\n    awareness: check.awareness,\n    angle: check.angle,\n    ...(check.shows ? { shows: check.shows } : {}),\n    ...(check.format ? { format: check.format } : {}),\n    platforms: check.platforms ?? (\"unset\" as const),\n    ...(check.problems.length > 0 ? { problems: check.problems } : {}),\n    ...(check.warnings.length > 0 ? { warnings: check.warnings } : {}),\n  };\n}\n\n/** Everything `checkIdeas` needs, read from the workspace. */\nexport async function ideasReport(\n  root: string,\n  opts: { ask?: AskNouls; readProduct?: (ref: string) => Promise<StoreProduct> } = {},\n): Promise<IdeasReport> {\n  const judge = opts.ask ? { ask: opts.ask, done: () => Promise.resolve() } : workspaceIdeasJudge(root);\n  const [{ ideas, unreadable }, insights, knowledge, personas, creatives, rules, companyDoc] = await Promise.all([\n    readIdeas(root),\n    readInsights(root, { ask: judge.ask }),\n    readKnowledgeCorpus(root),\n    readPersonaIds(root),\n    readCreativeRecords(root),\n    readAllRules(root).then((all) => selectRules(all, {})),\n    readFile(path.join(root, \"COMPANY.md\"), \"utf8\").catch(() => null),\n  ]);\n  const language = marketFromCompanyDoc(companyDoc)?.language;\n  const [sameMessage, products] = await Promise.all([\n    sameMessageRead(ideas, judge.ask),\n    storeProductReads(\n      ideas.map((i) => i.product),\n      opts.readProduct,\n    ),\n  ]);\n  await judge.done();\n  const checked = checkIdeas({\n    ideas,\n    insights,\n    knowledge,\n    personas,\n    sameMessage,\n    products,\n    rules,\n    ...(language ? { language } : {}),\n    ...coverageOf(ideas, creatives),\n  });\n  return {\n    ideas: checked,\n    unreadable,\n    insightCount: insights.length,\n    observedCount: insights.filter((i) => i.status === \"observed\").length,\n  };\n}\n\nexport const ideasCommand = defineCommand({\n  meta: { name: \"ideas\", description: DESCRIPTION },\n  args: ARGS,\n  async run({ args }) {\n    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n    const report = await ideasReport(root);\n    const full = args.full === true;\n    writeJson({\n      ok: true,\n      data: {\n        build_next: buildNext(report.ideas),\n        ideas: full ? report.ideas : report.ideas.map(compactIdea),\n        ...(report.unreadable.length > 0 ? { unreadable: report.unreadable } : {}),\n        customer_quotes: { total: report.insightCount, observed: report.observedCount },\n        ...(full ? { allowed: { angle: IDEA_ANGLES, format: IDEA_FORMATS } } : {}),\n      },\n      hints: ideasHints(report),\n    });\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/chunk-EHS3QWHJ.js

@@ -0,0 +1,206 @@
+import {
+  RESEARCH_GOOGLE_ADS_MAX_COPY
+} from "./chunk-K5X62YHZ.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-EHS3QWHJ.js.map