@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/chunk-AMCY5YCB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/hints.ts"],"sourcesContent":["/**\n * The `research` family shipped with no `hints[]` on any command. Everything\n * here is one nudge for one dead end that an audited run actually hit — not a\n * running commentary on healthy results.\n */\n\nimport { RESEARCH_GOOGLE_ADS_MAX_COPY, type ResearchRedditSource } from \"@baker/api\";\nimport type { QueryContext } from \"../../geo-context.ts\";\nimport type { ResearchFix } from \"./output.ts\";\n\ntype Depth = \"medium\" | \"high\" | \"xhigh\";\n\n/**\n * `advertisers` is named after advertisers and returns none of their advertising.\n * A run read the name as \"SERP ad creative\", got domain economics, and wrote \"no\n * live paid ad copy captured\" into the client's vault without ever trying the\n * command that does return copy. So this fires on every call, not just empty ones.\n */\nexport const AD_COPY_ROUTE =\n  \"This returns competing domains and their SERP economics — no ad copy, no headlines, no creative. \" +\n  \"For a competitor's Google ads and their copy: `baker research google-ads <competitor.com> --copy` \" +\n  \"(Google's Ads Transparency Center: every ad, how long it has run, and the text ads' headline and description). \" +\n  'For Meta and LinkedIn: `baker winning-ads advertisers \"<brand>\"` → ' +\n  '`baker winning-ads search \"<brief>\" --advertiser-id <id>` → `baker winning-ads content <adId>` ' +\n  \"(`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). \" +\n  \"Do not keep querying this command for copy.\";\n\n/**\n * Empty SERP data has two causes and only one is worth a second call: the wrong\n * market. Once the market was explicit, a re-query is waste — say so, because\n * \"no rows\" otherwise reads as \"reword the keyword\".\n */\nexport function noSerpRowsHints(rowCount: number, queryContext: QueryContext): string[] {\n  if (rowCount > 0) {\n    return [];\n  }\n  const defaulted = queryContext.location_is_default || queryContext.language_is_default;\n  if (defaulted) {\n    return [\n      `No rows for ${queryContext.location} / ${queryContext.language} — the market you did not set. ` +\n        \"Set --location and --language for the client's actual market and re-run once \" +\n        \"(`baker research countries` / `baker research languages` for the accepted codes) \" +\n        \"before you touch the keyword.\",\n    ];\n  }\n  return [\n    `No rows for ${queryContext.location} / ${queryContext.language}, which you set explicitly. ` +\n      \"This term has no third-party SERP coverage in that market — move on rather than re-querying it. \" +\n      \"For demand signal try `baker research autocomplete`; for a competitor's actual terms, \" +\n      \"`baker research keywords-for-site <domain>`.\",\n  ];\n}\n\nexport function advertisersHints(rowCount: number, queryContext: QueryContext): string[] {\n  return [...noSerpRowsHints(rowCount, queryContext), AD_COPY_ROUTE];\n}\n\n/**\n * \"This competitor buys no paid search\" is a real competitive answer, but it\n * arrives as an empty array that looks like a broken call — so say which it is\n * before the agent re-runs the same query with a different sort.\n */\nexport function keywordsForSiteHints(\n  rowCount: number,\n  queryContext: QueryContext,\n  typeFilter: string | undefined,\n): string[] {\n  if (rowCount > 0) {\n    return [];\n  }\n  if (typeFilter === \"paid\" || typeFilter === \"organic\") {\n    return [\n      `No rows with --type ${typeFilter} in ${queryContext.location} / ${queryContext.language}. ` +\n        `A domain with zero ${typeFilter} keywords in a market is itself the finding — record it and move on. ` +\n        \"Confirm once with --type all (nothing at all there means the domain has no SERP coverage, \" +\n        \"not that it has no ads) instead of re-running with a different --sort or --limit.\",\n    ];\n  }\n  return noSerpRowsHints(rowCount, queryContext);\n}\n\nconst THIN_ANSWER_CHARS = 600;\nconst THIN_SOURCE_COUNT = 2;\n\n// Only `medium` and `high` have somewhere to escalate to; `xhigh` is the ceiling,\n// so a thin answer there is a fact about the web, not a flag the agent forgot.\nconst ESCALATION: Partial<Record<Depth, string>> = {\n  medium:\n    \"`medium` is a quick lookup, not a search. Re-ask the SAME question once with `--depth high` before \" +\n    \"concluding the web has nothing on it.\",\n  high:\n    \"`high` already thought hard about this. `--depth xhigh` is the only step left and it can run 15 minutes — \" +\n    \"take it only if this answer blocks a deliverable; otherwise record the gap and move on.\",\n};\n\n/**\n * The one thing worth saying about a page that came back fine is that you are\n * not looking at all of it — which the content itself cannot tell you.\n */\nexport function fetchHints({\n  truncated,\n  contentChars,\n  shownChars,\n}: {\n  truncated: boolean;\n  contentChars: number;\n  shownChars: number;\n}): string[] {\n  const hints: string[] = [];\n\n  if (shownChars < contentChars) {\n    hints.push(\n      `Showing the first ${shownChars.toLocaleString(\"en-US\")} of ${contentChars.toLocaleString(\"en-US\")} characters. ` +\n        \"Re-run the same command with `--full` for the whole page — the read is cached for 24h, so it costs no extra time and no extra credit.\",\n    );\n  }\n\n  if (truncated) {\n    hints.push(\n      \"This page is longer than one read returns, so the end of it is missing. \" +\n        \"Don't present this as the complete page; if the part you need is further down, fetch the deeper URL directly.\",\n    );\n  }\n\n  return hints;\n}\n\nexport function webDepthHints({\n  answer,\n  sourceCount,\n  depth,\n}: {\n  answer: string;\n  sourceCount: number;\n  depth: Depth;\n}): string[] {\n  const thin = answer.length < THIN_ANSWER_CHARS || sourceCount <= THIN_SOURCE_COUNT;\n  const escalation = ESCALATION[depth];\n  if (!thin || !escalation) {\n    return [];\n  }\n  return [`Thin answer (${answer.length} chars, ${sourceCount} source(s)). ${escalation}`];\n}\n\n/**\n * The volume DataForSEO returns is Google's own Keyword Planner figure resold,\n * so putting the two side by side validates nothing — a run did exactly that,\n * found all seven rows agreeing to the digit, and reported the agreement as\n * corroboration. This fires on every call rather than on a suspicious one,\n * because by the time the numbers are in a table the provenance is already gone.\n */\nexport function keywordMetricsHints({\n  rows,\n  asked,\n  clickstream,\n  queryContext,\n}: {\n  rows: Array<{ keyword: string; search_volume: number | null }>;\n  asked: string[];\n  clickstream: boolean;\n  queryContext: QueryContext;\n}): string[] {\n  if (rows.length === 0) {\n    return noSerpRowsHints(0, queryContext);\n  }\n\n  const provenance =\n    \"DataForSEO resells Google's Keyword Planner volume — planner_search_volume here is the SAME number \" +\n    \"`baker ads google keywords metrics` returns, not an independent reading of it. Quoting the two as agreeing \" +\n    \"sources is not corroboration.\" +\n    (clickstream\n      ? \" clickstream_search_volume IS independent (DataForSEO's own panels); when the two disagree, say which one you are quoting.\"\n      : \" For a genuinely independent estimate of demand, re-run with --clickstream (costs 2x), or use first-party data: \" +\n        \"`baker gsc query` for what already reaches the site, or the account's own search terms.\");\n\n  const hints = [provenance];\n\n  const empty = rows.filter((row) => row.search_volume === null).map((row) => row.keyword);\n  if (empty.length > 0) {\n    hints.push(\n      `${empty.length} of ${asked.length} keywords came back with no data in ${queryContext.location} / ${queryContext.language}: ` +\n        `${empty.join(\", \")}. That is missing coverage, NOT zero demand — do not report them as unsearched, and do not ` +\n        \"re-query them reworded. `baker research autocomplete` on the head term is the way to find the phrasing that market uses.\",\n    );\n  }\n\n  return hints;\n}\n\n/**\n * The archive keeps a post's words the moment it is written and its points\n * only once it has settled, so a number on something young is not the number\n * Reddit shows. Said once, when it applies, so a count is never quoted as live.\n */\nconst ARCHIVE_NOTE =\n  \"Read from the Reddit archive: the words are as posted, but points and comment counts on anything under ~36h old are as first captured — don't quote those numbers as current.\";\n\n/**\n * An empty Reddit search is almost always a phrasing miss, not a silent\n * audience: Reddit matches words, and people write in their own. A run that\n * came back empty on a posts search also never looked at the replies, which is\n * where most of the verbatim voice is.\n */\nexport function redditSearchHints({\n  resultCount,\n  kind,\n  source,\n}: {\n  resultCount: number;\n  kind: \"posts\" | \"comments\";\n  source: ResearchRedditSource;\n}): string[] {\n  const hints: string[] = [];\n  if (resultCount === 0) {\n    hints.push(\n      \"Nothing matched. Reddit search matches words, not meaning: try the audience's own phrasing (one distinctive word, \" +\n        \"or a seed from `baker research autocomplete`), a longer --since window, or other subreddits — \" +\n        '`baker research reddit subreddits \"<topic>\"` finds where the audience actually talks' +\n        (kind === \"posts\" ? \", and try --kind comments — most of the voice is in the replies.\" : \".\"),\n    );\n  } else if (kind === \"posts\") {\n    hints.push(\n      \"Titles rarely carry the voice. Read the promising threads with `baker research reddit thread <permalink>` \" +\n        \"for the replies, or search the replies directly with --kind comments.\",\n    );\n  }\n  if (source === \"archive\" && resultCount > 0) hints.push(ARCHIVE_NOTE);\n  return hints;\n}\n\n/** A thread whose replies no source would serve is still the post — but it must not read as a thread nobody answered. */\nexport function redditThreadHints({\n  commentsShown,\n  commentsAsked,\n  commentCount,\n  source,\n}: {\n  commentsShown: number;\n  commentsAsked: number;\n  commentCount: number | null;\n  source: ResearchRedditSource;\n}): string[] {\n  const hints: string[] = [];\n  if (commentsAsked > 0 && commentsShown === 0 && (commentCount ?? 0) > 0) {\n    hints.push(\n      `This thread has ${commentCount} comments but none could be read just now. Quote the post only, and don't describe the replies.`,\n    );\n  }\n  if (source === \"archive\") hints.push(ARCHIVE_NOTE);\n  return hints;\n}\n\nconst REDDIT_HOST = /(^|\\.)reddit\\.com$|^redd\\.it$/i;\n\n/**\n * A subreddit's member count is its size, not its pulse. The run that prompted\n * this command mined r/CouriersUK — a real subreddit, with one post in its whole\n * history — and found nothing. One dated search tells a living subreddit from a\n * dead one before it is relied on.\n */\nexport function redditSubredditsHints({ resultCount }: { resultCount: number }): string[] {\n  if (resultCount === 0) {\n    return [\n      '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>`.',\n    ];\n  }\n  return [\n    '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.',\n  ];\n}\n\n/** A Reddit link that does not lead to the words attributed to it. Shared by `reddit thread` and `fetch`. */\nexport const REDDIT_LINK_REJECTED: ResearchFix = {\n  action: \"reject\",\n  explanation:\n    \"Do not quote anything attributed to this link — 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.\",\n};\n\n/**\n * `research fetch` hands a Reddit URL to the Reddit reader, but its generic\n * remediation was written for ordinary pages: FORBIDDEN reads \"this will not\n * open, carry on without it\" and NOT_FOUND \"carry on\". For Reddit both are the\n * wrong advice. A page the reader will not turn into a thread is one `reddit`\n * command away, and a link that leads nowhere real must not be quoted at all.\n */\nexport function redditPageFix(url: string, code: string): ResearchFix | null {\n  let host: string;\n  try {\n    host = new URL(url).hostname;\n  } catch {\n    return null;\n  }\n  if (!REDDIT_HOST.test(host)) return null;\n  if (code === \"NOT_FOUND\") return REDDIT_LINK_REJECTED;\n  if (code !== \"FORBIDDEN\") return null;\n  return {\n    action: \"retry_with_changes\",\n    explanation:\n      '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.',\n  };\n}\n\n/**\n * `google-ads` replaces a browser trip through Google's Ads Transparency\n * Center, so its hints keep the agent out of one: no ads is an answer, and an\n * ad whose copy Google does not give is shown by its link, never opened.\n */\nexport function googleAdsHints({\n  target,\n  adCount,\n  located,\n  textWithoutCopy,\n  copyAsked,\n  copyUnread,\n  visual,\n}: {\n  target: string;\n  adCount: number;\n  located: boolean;\n  textWithoutCopy: number;\n  copyAsked: boolean;\n  copyUnread: number;\n  visual: number;\n}): string[] {\n  if (adCount === 0) {\n    return [\n      `No Google ads point to ${target}${located ? \" in that region\" : \"\"} — that is the answer, not a failed call: ` +\n        \"this competitor is not advertising on Google there, or its ads point to another domain. \" +\n        (located ? \"Re-run once without --location to see every region; then move on. \" : \"Move on. \") +\n        `Its paid search terms, if any: \\`baker research keywords-for-site ${target} --type paid\\`.`,\n    ];\n  }\n  const hints: string[] = [];\n  if (!copyAsked && textWithoutCopy > 0) {\n    hints.push(\n      `${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).`,\n    );\n  }\n  const pastCap = copyAsked ? textWithoutCopy - copyUnread : 0;\n  if (pastCap > 0) {\n    hints.push(\n      `${pastCap} text ads past the first ${RESEARCH_GOOGLE_ADS_MAX_COPY} were not read — one request reads at most ${RESEARCH_GOOGLE_ADS_MAX_COPY}. ` +\n        \"Narrow with --since, --location or --platform google_search and re-run for their words.\",\n    );\n  }\n  if (visual > 0 || copyUnread > 0) {\n    const without = [\n      visual > 0 ? `${visual} image or video ads (Google gives no text for those)` : \"\",\n      copyUnread > 0 ? `${copyUnread} text ads whose image could not be read` : \"\",\n    ].filter(Boolean);\n    hints.push(\n      `No copy for ${without.join(\" and \")}: show those by their \\`transparency_url\\`. ` +\n        \"Do not open the Transparency Center in agent-browser to read them — it is the browser load this command exists to avoid.\",\n    );\n  }\n  return hints;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-AP3TP6VG.js

@@ -0,0 +1,139 @@
+import {
+  brandVerificationHints
+} from "./chunk-IVIJJXXT.js";
+import {
+  OUTPUT_ARGS,
+  writeProviderHits
+} from "./chunk-LWAEHLKV.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-MYTDK3AL.js";
+
+// src/commands/images/logo.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.logo",
+  description: "Brand logo lookup via Brandfetch. Auto-ingests by default. Returns `brandMatch` \u2014 Brandfetch's own verdict on whose brand the domain is (confirmed | mismatch | unverified). Branch on it: `mismatch` means the mark is another company's, so do not place it. `confirmed` verifies the record, not the artwork \u2014 read the ingested row back to check the mark itself.",
+  args: {
+    domain: { type: "string", description: "Brand domain (e.g. stripe.com)", required: true },
+    variant: { type: "string", description: "icon | logo | symbol", required: false },
+    "auto-ingest": {
+      type: "number",
+      description: `Ingest top N hits (0-${AUTO_INGEST_MAX.logo}). Defaults to 1 (the first variant). Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants, so ${AUTO_INGEST_MAX.logo} ingests every one. Keep it at 1+ \u2014 the ingested row is the only way to check the mark is the brand you asked for.`,
+      required: false
+    },
+    "no-auto-ingest": {
+      type: "boolean",
+      description: "Skip auto-ingest (equivalent to --auto-ingest 0). Leaves the returned mark unverifiable.",
+      required: false,
+      default: false
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to ingested logo variants (e.g. 'Stripe \u2014 payments integration partner', 'Acme competitor brand mark')",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  }
+});
+var logoCommand = defineCommand({
+  meta: {
+    name: "logo",
+    description: "Brand logo via Brandfetch. Returns up to 5 variants (icon, light/dark logo, light/dark symbol) plus `brandMatch`. Auto-ingests the first variant.\n\nStart here: check `brandMatch.verdict`.\n  mismatch   \u2192 the mark belongs to `brandMatch.name`, a different company. Do not place it.\n  unverified \u2192 nothing confirmed whose logo this is. Treat as unchecked.\n  confirmed  \u2192 Brandfetch has this brand's record. That verifies the record, NOT the artwork \u2014 a confirmed domain has served another company's logo before.\n\n\u26A0 Whatever the verdict, read the ingested row back with `baker images get <imageId>` and check `textInImage`/`subject` before placing it. That is the only check that looks at the mark.\n\nExample: baker images logo stripe.com --variant logo"
+  },
+  args: {
+    domain: { type: "positional", description: "Brand domain", required: false },
+    variant: { type: "string", description: "icon|logo|symbol", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Ingest top N (0-${AUTO_INGEST_MAX.logo}, default 1)`,
+      required: false
+    },
+    "no-auto-ingest": { type: "boolean", description: "Skip auto-ingest", required: false },
+    context: { type: "string", description: "Description context hint applied to ingested logos", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const domain = args.domain;
+      if (!domain) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Domain is required" } });
+        process.exit(1);
+      }
+      const body = { domain };
+      if (args.variant) body.variant = args.variant;
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.logo);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants for a domain, so --auto-ingest ${AUTO_INGEST_MAX.logo} already ingests every one. Re-run with a value in 0-${AUTO_INGEST_MAX.logo}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      } else if (args["no-auto-ingest"]) {
+        body.autoIngest = 0;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/logo", body);
+      const hints = [
+        // `brandMatch` is Brandfetch's own answer to whose brand this domain is,
+        // so the warning can now be graded instead of fired blind: loud on a
+        // mismatch, honest about what a confirmation does and does not cover.
+        ...brandVerificationHints({
+          domain,
+          ingested: data.ingested,
+          hitCount: data.hits.length,
+          brandMatch: data.brandMatch
+        }),
+        ...emptyResultHints({ provider: "logo", hitCount: data.hits.length, activeFilters: [], subject: domain })
+      ];
+      writeProviderHits(data, data.hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+async function fetchBrandLogo(domain) {
+  try {
+    const body = { domain, variant: "logo" };
+    const data = await apiPost("/api/images/logo", body);
+    if (data?.brandMatch?.verdict === "mismatch") return null;
+    return data?.ingested?.[0]?.imageUrl ?? data?.hits?.find((h) => h.imageUrl)?.imageUrl ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  logoCommand,
+  fetchBrandLogo
+};
+//# sourceMappingURL=chunk-AP3TP6VG.js.map

package/dist/chunk-AP3TP6VG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/logo.ts"],"sourcesContent":["import type { ImagesLogoRequest, ImagesLogoResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { AUTO_INGEST_MAX, parseAutoIngest } from \"./autoIngest.ts\";\nimport { brandVerificationHints } from \"./brandVerification.ts\";\nimport { OUTPUT_ARGS, writeProviderHits } from \"./providerHits.ts\";\nimport { emptyResultHints } from \"./searchHints.ts\";\n\nregisterSchema({\n  command: \"images.logo\",\n  description:\n    \"Brand logo lookup via Brandfetch. Auto-ingests by default. Returns `brandMatch` — Brandfetch's own verdict on whose brand the domain is (confirmed | mismatch | unverified). Branch on it: `mismatch` means the mark is another company's, so do not place it. `confirmed` verifies the record, not the artwork — read the ingested row back to check the mark itself.\",\n  args: {\n    domain: { type: \"string\", description: \"Brand domain (e.g. stripe.com)\", required: true },\n    variant: { type: \"string\", description: \"icon | logo | symbol\", required: false },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Ingest top N hits (0-${AUTO_INGEST_MAX.logo}). Defaults to 1 (the first variant). Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants, so ${AUTO_INGEST_MAX.logo} ingests every one. Keep it at 1+ — the ingested row is the only way to check the mark is the brand you asked for.`,\n      required: false,\n    },\n    \"no-auto-ingest\": {\n      type: \"boolean\",\n      description: \"Skip auto-ingest (equivalent to --auto-ingest 0). Leaves the returned mark unverifiable.\",\n      required: false,\n      default: false,\n    },\n    context: {\n      type: \"string\",\n      description:\n        \"Free-text hint applied to ingested logo variants (e.g. 'Stripe — payments integration partner', 'Acme competitor brand mark')\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: { type: \"boolean\", description: \"Include full metadata\", required: false, default: false },\n  },\n});\n\nexport const logoCommand = defineCommand({\n  meta: {\n    name: \"logo\",\n    description:\n      \"Brand logo via Brandfetch. Returns up to 5 variants (icon, light/dark logo, light/dark symbol) plus `brandMatch`. Auto-ingests the first variant.\\n\\nStart here: check `brandMatch.verdict`.\\n  mismatch   → the mark belongs to `brandMatch.name`, a different company. Do not place it.\\n  unverified → nothing confirmed whose logo this is. Treat as unchecked.\\n  confirmed  → Brandfetch has this brand's record. That verifies the record, NOT the artwork — a confirmed domain has served another company's logo before.\\n\\n⚠ Whatever the verdict, read the ingested row back with `baker images get <imageId>` and check `textInImage`/`subject` before placing it. That is the only check that looks at the mark.\\n\\nExample: baker images logo stripe.com --variant logo\",\n  },\n  args: {\n    domain: { type: \"positional\", description: \"Brand domain\", required: false },\n    variant: { type: \"string\", description: \"icon|logo|symbol\", required: false },\n    \"auto-ingest\": {\n      type: \"string\",\n      description: `Ingest top N (0-${AUTO_INGEST_MAX.logo}, default 1)`,\n      required: false,\n    },\n    \"no-auto-ingest\": { type: \"boolean\", description: \"Skip auto-ingest\", required: false },\n    context: { type: \"string\", description: \"Description context hint applied to ingested logos\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const domain = args.domain as string | undefined;\n      if (!domain) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Domain is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesLogoRequest = { domain };\n      if (args.variant) body.variant = args.variant as ImagesLogoRequest[\"variant\"];\n      // Explicit --auto-ingest wins over --no-auto-ingest; backend default is 1.\n      if (args[\"auto-ingest\"] !== undefined) {\n        const parsed = parseAutoIngest(args[\"auto-ingest\"], AUTO_INGEST_MAX.logo);\n        if (!parsed.ok) {\n          writeJson({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: parsed.message,\n              fix: {\n                action: \"retry_with_changes\",\n                explanation: `Brandfetch resolves at most ${AUTO_INGEST_MAX.logo} variants for a domain, so --auto-ingest ${AUTO_INGEST_MAX.logo} already ingests every one. Re-run with a value in 0-${AUTO_INGEST_MAX.logo}.`,\n              },\n            },\n          });\n          process.exit(1);\n        }\n        body.autoIngest = parsed.value;\n      } else if (args[\"no-auto-ingest\"]) {\n        body.autoIngest = 0;\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesLogoResponse>(\"/api/images/logo\", body);\n      const hints = [\n        // `brandMatch` is Brandfetch's own answer to whose brand this domain is,\n        // so the warning can now be graded instead of fired blind: loud on a\n        // mismatch, honest about what a confirmation does and does not cover.\n        ...brandVerificationHints({\n          domain,\n          ingested: data.ingested,\n          hitCount: data.hits.length,\n          brandMatch: data.brandMatch,\n        }),\n        ...emptyResultHints({ provider: \"logo\", hitCount: data.hits.length, activeFilters: [], subject: domain }),\n      ];\n      writeProviderHits(data, data.hits, args as Record<string, unknown>, hints);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n\n/**\n * A brand's real logo, ingested, as its image URL (Brandfetch through `/api/images/logo`): what a\n * static ad's proof badge is wired with. Null when no logo came back, or Brandfetch says the mark\n * is another company's. Never throws.\n */\nexport async function fetchBrandLogo(domain: string): Promise<string | null> {\n  try {\n    const body: ImagesLogoRequest = { domain, variant: \"logo\" };\n    const data = await apiPost<ImagesLogoResponse>(\"/api/images/logo\", body);\n    if (data?.brandMatch?.verdict === \"mismatch\") return null;\n    return data?.ingested?.[0]?.imageUrl ?? data?.hits?.find((h) => h.imageUrl)?.imageUrl ?? null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}