@koda-sl/baker-cli 0.574.0-dev.19539e5a8 → 0.575.0-dev.85f21462e

package/dist/chunk-AFWLBOIN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/draft-account.ts","../src/commands/ads/google/write-shared.ts","../src/commands/ads/google/copy-list-usage.ts","../src/commands/ads/google/draft-status.ts","../src/commands/ads/google/stage-streak.ts"],"sourcesContent":["import type { GoogleDraftListResponse } from \"@baker/api/ads-google\";\n\n/**\n * `--customer-id` on the draft reads. A draft belongs to the chat, not to an account, and may span\n * several; every other Google Ads command takes the flag, so agents carry it here (BAKER-497).\n * `list` narrows to that account and says what the others still hold; `validate` and `show` keep\n * their whole answer, because publish sends every account together and a ref names one op.\n */\n\nfunction changes(n: number, staged: boolean): string {\n  const noun = staged ? \"staged change\" : \"change\";\n  return n === 1 ? `1 ${noun}` : `${n} ${noun}s`;\n}\n\n/**\n * The draft as one account holds it, with what the rest of the chat's draft holds. `empty` is the\n * readable line for an account holding none of it, where the whole-chat \"nothing staged\" would be false.\n * Only an active draft's other changes are still to publish; a published one's are already done.\n */\nexport function draftInAccount(\n  data: GoogleDraftListResponse,\n  customerId: string,\n): { data: GoogleDraftListResponse; hints: string[]; empty?: string } {\n  const ops = data.ops.filter((op) => op.customerId === customerId);\n  const narrowed = {\n    ...data,\n    count: ops.length,\n    ops,\n    ...(data.tree ? { tree: data.tree.filter((node) => node.customerId === customerId) } : {}),\n  };\n  const others = data.ops.filter((op) => op.customerId !== customerId);\n  if (others.length === 0) return { data: narrowed, hints: [] };\n  const staged = data.status === \"active\";\n  const accounts = [...new Set(others.map((op) => op.customerId))];\n  const where = `account${accounts.length === 1 ? \"\" : \"s\"} ${accounts.join(\", \")}`;\n  const one = others.length === 1;\n  if (ops.length === 0) {\n    return {\n      data: narrowed,\n      empty: `No Google Ads changes in account ${customerId} on this chat.`,\n      hints: [`This chat's ${changes(others.length, staged)} ${one ? \"is\" : \"are\"} in ${where}, not ${customerId}.`],\n    };\n  }\n  const more = `${others.length} more ${staged ? \"staged \" : \"\"}change${one ? \"\" : \"s\"}`;\n  const verb = staged ? (one ? \"publishes\" : \"publish\") : one ? \"is\" : \"are\";\n  return {\n    data: narrowed,\n    hints: [\n      `Showing account ${customerId} only. ${more} in ${where} ${verb} ${staged ? \"with this chat too\" : \"on this chat too\"}; \\`baker ads google draft list\\` without --customer-id shows ${one ? \"it\" : \"them\"}.`,\n    ],\n  };\n}\n\n/** `draft validate --customer-id`: said back, since the verdicts still cover every account. */\nexport function validateAccountHint(customerId: string): string {\n  return `Validated this chat's whole draft, not only account ${customerId}: publish sends every account's changes together, so each verdict above counts.`;\n}\n\n/** `draft show --customer-id` naming another account than the op's own. */\nexport function showAccountHint(customerId: string, opCustomerId: string): string | undefined {\n  return opCustomerId === customerId ? undefined : `This op is staged in account ${opCustomerId}, not ${customerId}.`;\n}\n","import { readFileSync } from \"node:fs\";\nimport {\n  GOOGLE_DRAFT_BATCH_MAX,\n  type GoogleDraftListResponse,\n  type GoogleDraftStageBatchResponse,\n  type GoogleDraftStageResponse,\n  googleDraftOpInputSchema,\n  OP_TOO_LARGE_FIX,\n  OP_TOO_LARGE_MESSAGE_START,\n  toMicros,\n} from \"@baker/api/ads-google\";\nimport { describeOpPayload } from \"@baker/api/capabilities\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../client.ts\";\nimport { requireChatId, resolveChatId } from \"../../../env.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../../error-handler.ts\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { payloadArg } from \"../../../schemas.ts\";\nimport { payloadFix } from \"../../capabilities/fix.ts\";\nimport { booleanWordPositionalError } from \"../boolean-word-positional.ts\";\nimport { adCopyHints } from \"../copy-hints.ts\";\nimport { hintLines, withHints } from \"../hints.ts\";\nimport { bareCustomerId, writeJsonEnvelope } from \"../output.ts\";\nimport { termsRefusalFix } from \"../terms-output.ts\";\nimport { copyListCountFix } from \"./copy-list-usage.ts\";\nimport { draftInAccount } from \"./draft-account.ts\";\nimport { renderDraftStatus } from \"./draft-status.ts\";\nimport { recordSingleStage } from \"./stage-streak.ts\";\n\n/**\n * Shared plumbing for the staged Google Ads write commands. Writes NEVER hit\n * the Google Ads API directly: every command stages an op against this chat's\n * draft (`/api/ads/google/draft/stage`), the dashboard shows it as a pending\n * Google Ads change, and the draft applies as one `GoogleAdsService.Mutate`\n * request per advertiser account when the chat is published. `--customer-id` is\n * required on every write — a draft may span several accounts, so nothing is\n * picked for you.\n */\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\nexport function requireCustomerId(args: Record<string, unknown>): string {\n  const given = (args[\"customer-id\"] ?? args.customerId) as string | undefined;\n  const raw = given === undefined ? undefined : bareCustomerId(String(given));\n  if (!raw || !/^\\d{10}$/.test(raw)) {\n    failWriteValidation(\"pass --customer-id as the 10-digit Google Ads customer id (386-508-3115 or 3865083115)\");\n  }\n  return raw;\n}\n\nexport function requireTarget(args: Record<string, unknown>, entity: string): string {\n  // `--flag false` is refused, not documented: citty parses it as the flag set to TRUE plus a stray\n  // positional nobody consumes, so on `conversions update --primary` it silently PROMOTES an action\n  // into what every Maximize Conversions campaign bids toward. Caught here because this is the only\n  // place on this surface that reads positionals, and every target-taking command goes through it.\n  const booleanWord = booleanWordPositionalError(args, entity);\n  if (booleanWord) {\n    failWriteValidation(booleanWord);\n  }\n  const positional = Array.isArray(args._) ? args._[0] : undefined;\n  const target = args.id ?? args.target ?? args.ref ?? positional;\n  if (typeof target !== \"string\" || target.length === 0) {\n    failWriteValidation(`pass the ${entity} resource name or id as the positional argument`);\n  }\n  return target;\n}\n\n/**\n * The targets a bulk status command was given: every positional (comma-separated ones split), plus\n * `--file` with one target per line (blank lines and `#` comments skipped), deduped in order. One\n * call then stages them all as one batch instead of one command per row.\n */\nexport function targetEntries(args: Record<string, unknown>, entity: string): string[] {\n  const booleanWord = booleanWordPositionalError(args, entity);\n  if (booleanWord) {\n    failWriteValidation(booleanWord);\n  }\n  const positionals = Array.isArray(args._) ? args._.filter((v): v is string => typeof v === \"string\") : [];\n  const raw = [...positionals.flatMap((v) => v.split(\",\")), ...rawFileEntries(args.file)]\n    .map((v) => v.trim())\n    .filter(Boolean);\n  const targets = [...new Set(raw)];\n  if (targets.length === 0) {\n    failWriteValidation(`pass the ${entity} resource name(s) as positional arguments and/or --file (one per line)`);\n  }\n  if (targets.length > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(`${targets.length} targets exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split them`);\n  }\n  return targets;\n}\n\nexport function requireStringFlag(value: unknown, flag: string): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    failWriteValidation(`${flag} is required`);\n  }\n  return value;\n}\n\n/** Money flag in major currency units → micros. */\nexport function microsFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const num = Number(value);\n  if (Number.isNaN(num) || num <= 0) {\n    failWriteValidation(`${flag} must be a positive amount (major currency units, e.g. 50 or 50.00)`);\n  }\n  return toMicros(num);\n}\n\n/** Split a comma-separated flag into trimmed non-empty values. */\nexport function listFlag(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.length === 0) {\n    return undefined;\n  }\n  const items = value\n    .split(\",\")\n    .map((v) => v.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\nexport interface KeywordEntry {\n  text: string;\n  matchType: string;\n}\n\nconst MATCH_TYPES = new Set([\"EXACT\", \"PHRASE\", \"BROAD\"]);\n\n/**\n * One raw keyword entry → { text, matchType }. A trailing `:EXACT|:PHRASE|:BROAD`\n * suffix overrides the default match type; colons and commas aren't legal in Google\n * keyword text, so the syntax is unambiguous.\n */\nfunction parseKeywordEntry(raw: string, defaultMatch: string | undefined): KeywordEntry {\n  const colon = raw.lastIndexOf(\":\");\n  if (colon > 0) {\n    const suffix = raw\n      .slice(colon + 1)\n      .trim()\n      .toUpperCase();\n    if (MATCH_TYPES.has(suffix)) {\n      return { text: raw.slice(0, colon).trim(), matchType: suffix };\n    }\n    failWriteValidation(`\"${raw}\": \":${raw.slice(colon + 1)}\" is not a match type (EXACT | PHRASE | BROAD)`);\n  }\n  if (!defaultMatch) {\n    failWriteValidation(`\"${raw}\" has no match type — add a :EXACT/:PHRASE/:BROAD suffix or pass --match-type`);\n  }\n  return { text: raw, matchType: defaultMatch };\n}\n\n/**\n * Raw --text value(s) → individual entries: repeated flags and comma-separated\n * both work. The repeats have to come off `rawArgs`, because citty parses a\n * repeated flag down to its last value alone.\n */\nfunction rawTextEntries(value: unknown, rawArgs: readonly string[] | undefined): string[] {\n  return repeatedValues(rawArgs, \"text\", value)\n    .flatMap((v) => v.split(\",\"))\n    .map((v) => v.trim())\n    .filter(Boolean);\n}\n\n/** Newline-separated keyword file: one `text[:MATCH_TYPE]` per line; blank lines and `#` comments skipped. */\nfunction rawFileEntries(path: unknown): string[] {\n  return typeof path === \"string\" && path.length > 0 ? fileLines(path) : [];\n}\n\n/** A text file's entries: one per line, trimmed; blank lines and `#` comments skipped. */\nexport function fileLines(path: string): string[] {\n  return readFileSync(path, \"utf8\")\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0 && !line.startsWith(\"#\"));\n}\n\n/**\n * The keyword batch a command was invoked with: comma-separated `--text` entries\n * (optional `:MATCH_TYPE` suffix each) plus `--file` lines, deduped, each falling\n * back to `--match-type`. One entry stages exactly like before; many stage as one batch.\n */\nexport function keywordEntries(args: Record<string, unknown>, rawArgs?: readonly string[]): KeywordEntry[] {\n  const defaultMatch = typeof args[\"match-type\"] === \"string\" ? args[\"match-type\"].toUpperCase() : undefined;\n  const raw = [...rawTextEntries(args.text, rawArgs), ...rawFileEntries(args.file)];\n  if (raw.length === 0) {\n    failWriteValidation(\"pass keywords via --text (comma-separated) and/or --file (one per line)\");\n  }\n  if (raw.length > GOOGLE_DRAFT_BATCH_MAX) {\n    failWriteValidation(`${raw.length} keywords exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX}`);\n  }\n  const entries: KeywordEntry[] = [];\n  const seen = new Set<string>();\n  for (const item of raw) {\n    const entry = parseKeywordEntry(item, defaultMatch);\n    const key = JSON.stringify([entry.text, entry.matchType]);\n    if (!seen.has(key)) {\n      seen.add(key);\n      entries.push(entry);\n    }\n  }\n  return entries;\n}\n\n/**\n * The payloads behind `--file`: a path to a JSON file, or the JSON written inline. The file holds one\n * payload object, a JSON array of them, or JSON Lines (one object per line) — many payloads stage as\n * one batch, which is how a bulk change lands in one call instead of hundreds.\n *\n * Inline is here because every doc example already writes it that way — `packages/cli/README.md`\n * and the scaffold's `ads-google.md` both show `--file '{\"type\":\"image\",…}'` — while the arg only\n * ever read a path, so following the documentation answered with a raw ENOENT stack trace. Reading\n * a leading `{` or `[` as the payload makes those examples true rather than making the agent re-learn\n * the one shape that works.\n */\nexport function loadJsonPayloads(path: unknown): Array<Record<string, unknown>> {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return [];\n  }\n  const inline = /^\\s*[[{]/.test(path);\n  const source = inline ? \"inline JSON\" : path;\n  const text = inline ? path : readFileSync(path, \"utf8\");\n  return parsedPayloads(text, source).map((item, index, all) => {\n    if (item === null || typeof item !== \"object\" || Array.isArray(item)) {\n      failWriteValidation(\n        all.length === 1 ? `${source} must contain a JSON object` : `${source}: item ${index} must be a JSON object`,\n      );\n    }\n    return item as Record<string, unknown>;\n  });\n}\n\n/** One JSON value (an array spreads into its items), else JSON Lines; the JSON error when neither parses. */\nfunction parsedPayloads(text: string, source: string): unknown[] {\n  try {\n    const parsed = JSON.parse(text) as unknown;\n    return Array.isArray(parsed) ? parsed : [parsed];\n  } catch (err) {\n    if (!(err instanceof SyntaxError)) {\n      throw err;\n    }\n    const lines = text.split(/\\r?\\n/).filter((line) => line.trim().length > 0);\n    if (lines.length > 1) {\n      return lines.map((line, index) => parseJsonLine(line, index, source));\n    }\n    failWriteValidation(`${source} is not valid JSON: ${err.message}`);\n  }\n}\n\n/** One JSON Lines entry, or the line's own error naming where it is. */\nfunction parseJsonLine(line: string, index: number, source: string): unknown {\n  try {\n    return JSON.parse(line) as unknown;\n  } catch (err) {\n    return failWriteValidation(\n      `${source} line ${index + 1} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\n/** The ONE op payload behind `--file`, for commands that change a single entity. */\nexport function loadJsonFileArg(path: unknown): Record<string, unknown> {\n  const payloads = loadJsonPayloads(path);\n  if (payloads.length > 1) {\n    failWriteValidation(\n      `this command changes one entity, and --file holds ${payloads.length} payloads — stage many changes from one file with \\`baker ads google draft stage --file\\` (one op per item: {\"kind\",\"customerId\",\"target\"?,\"payload\"?})`,\n    );\n  }\n  return payloads[0] ?? {};\n}\n\n/** Flags override file keys — the file is the base, flags are the overrides. */\nexport function mergePayload(file: Record<string, unknown>, flags: Record<string, unknown>): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...file };\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  }\n  return merged;\n}\n\n/**\n * The `draft amend` patch: exactly one of `--file <path>` (JSON file) or `--patch '<json>'`\n * (inline string), and it must parse to a JSON object — RFC-7386 merge-patch needs an object to\n * merge, and a stray array/scalar would silently no-op or replace the whole payload.\n */\nexport function loadPatchArg(args: Record<string, unknown>): Record<string, unknown> {\n  const file = typeof args.file === \"string\" && args.file.length > 0 ? args.file : undefined;\n  const inline = typeof args.patch === \"string\" && args.patch.length > 0 ? args.patch : undefined;\n  if (Boolean(file) === Boolean(inline)) {\n    failWriteValidation(\"pass exactly one of --file <patch.json> or --patch '<json>'\");\n  }\n  if (file) {\n    return loadJsonFileArg(file);\n  }\n  try {\n    const parsed = JSON.parse(inline as string) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(\"--patch must be a JSON object\");\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`--patch is not valid JSON: ${err.message}`);\n    }\n    throw err;\n  }\n}\n\nexport function handleGoogleError(err: unknown): never {\n  if (err instanceof ApiError) {\n    // Covers both \"no connection\" and staging's 403 for an account this company\n    // never connected — same remedy either way: connect, and pick the account.\n    if (isNotConnectedError(err.code, err.message)) {\n      handleConnectionError(\"google_ads\", err.message);\n    }\n    const terms = termsRefusalFix(err.code, err.message);\n    if (terms) {\n      writeJsonEnvelope({\n        ok: false,\n        error: { code: terms.code, message: err.message, retryable: false, fix: terms.fix },\n      });\n      process.exit(1);\n    }\n    if (err.message.includes(OP_TOO_LARGE_MESSAGE_START)) {\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"OP_TOO_LARGE\",\n          message: err.message,\n          retryable: false,\n          fix: { action: \"split_the_change\", explanation: OP_TOO_LARGE_FIX },\n        },\n      });\n      process.exit(1);\n    }\n    writeJsonEnvelope({ ok: false, error: { code: err.code ?? \"API_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"UNKNOWN\", message: err instanceof Error ? err.message : String(err) },\n  });\n  process.exit(1);\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: GoogleDraftStageResponse;\n}\n\n/**\n * A no-op response isn't a failure — the change was already in place, so nothing was\n * staged. Say so explicitly, otherwise the agent re-stages it or reports work it\n * didn't do.\n */\nfunction noopHints(data: GoogleDraftStageResponse): string[] {\n  return data.staged\n    ? []\n    : [`NOT STAGED — ${data.reason}. Nothing to publish for this change; say so rather than reporting it as done.`];\n}\n\n/**\n * What to tell the agent about the ops a batch didn't stage.\n *\n * Two different things land in `skipped`: a change already in place, and a change Google refuses\n * outright (editing an experiment campaign's status, dates or budget). This hint used to assert the\n * first — \"already in the requested state\" — which read as \"done\" for a refusal the user never heard\n * about. So it leads with each op's own reason and asks for the refusals to be passed on.\n */\nexport function skippedHints(skipped: Array<{ summary: string; reason: string }>, total: number): string[] {\n  if (skipped.length === 0) {\n    return [];\n  }\n  const detail = skipped.map((s) => `${s.summary} — ${s.reason}`).join(\"; \");\n  return [\n    `${skipped.length} of ${total} op(s) NOT STAGED: ${detail}. Don't re-stage them; tell the user which changes couldn't be made and why, then carry on with the rest.`,\n  ];\n}\n\n/**\n * Preflight-validates the op against the shared `@baker/api/ads-google`\n * contract (the same schema the backend enforces), then stages it. Prints the\n * staged envelope — ref, mode (always `live`: publishing reaches the real\n * account), summary, warnings.\n */\nexport async function stageGoogleOp(raw: Record<string, unknown>, hints?: string[]): Promise<void> {\n  const preflight = googleDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message }));\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: fields.map((f) => (f.path ? `${f.path}: ${f.message}` : f.message)).join(\"; \"),\n        fields,\n        fix: copyListCountFix(raw, preflight.error.issues) ?? payloadFix(\"google-ads\", googleDraftOpInputSchema, raw),\n      },\n    });\n    process.exit(1);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/google/draft/stage\", { chatId, op: preflight.data });\n    const allHints = [\n      ...noopHints(response.data),\n      ...recordSingleStage(chatId, preflight.data.kind),\n      ...(hints ?? []),\n      ...(await adCopyHints(preflight.data)),\n    ];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\n/** Stage a create op: `{ kind, customerId, payload }`. */\nexport async function stageCreate(\n  kind: string,\n  customerId: string,\n  payload: Record<string, unknown>,\n  hints?: string[],\n): Promise<void> {\n  await stageGoogleOp({ kind, customerId, payload }, hints);\n}\n\ninterface StageBatchEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: GoogleDraftStageBatchResponse;\n}\n\n/**\n * A batch reads every target's before-state and checks each op against the account, which for a few\n * hundred removals outlasts the default 60 s. Timing out early reported a batch as failed that went on\n * to stage, so a retry then collided with the ops it had already staged.\n */\nconst STAGE_BATCH_TIMEOUT_MS = 5 * 60_000;\n\n/**\n * Stage several ops as ONE request (`/stage-batch`) — all-or-nothing on the backend,\n * one rate-limit hit instead of one per keyword. A single op falls through to the\n * plain stage path so its envelope (and amend behavior) stays exactly as before.\n */\nexport async function stageGoogleOps(rawOps: Array<Record<string, unknown>>, hints?: string[]): Promise<void> {\n  if (rawOps.length === 1 && rawOps[0]) {\n    await stageGoogleOp(rawOps[0], hints);\n    return;\n  }\n  const ops: unknown[] = [];\n  for (const [index, raw] of rawOps.entries()) {\n    const preflight = googleDraftOpInputSchema.safeParse(raw);\n    if (!preflight.success) {\n      const fields = preflight.error.issues.map((issue) => ({\n        path: `ops[${index}].${issue.path.join(\".\")}`,\n        message: issue.message,\n      }));\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: fields.map((f) => `${f.path}: ${f.message}`).join(\"; \"),\n          fields,\n          fix: copyListCountFix(raw, preflight.error.issues) ?? payloadFix(\"google-ads\", googleDraftOpInputSchema, raw),\n        },\n      });\n      process.exit(1);\n    }\n    ops.push(preflight.data);\n  }\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageBatchEnvelope>(\n      \"/api/ads/google/draft/stage-batch\",\n      { chatId, ops },\n      { timeoutMs: STAGE_BATCH_TIMEOUT_MS },\n    );\n    const allHints = [\n      ...skippedHints(response.data.skipped ?? [], ops.length),\n      ...(hints ?? []),\n      ...(await adCopyHints(ops)),\n    ];\n    writeJsonEnvelope(withHints(response, allHints));\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\n/** Stage an update op: `{ kind, customerId, target, payload }`. */\nexport async function stageUpdate(\n  kind: string,\n  customerId: string,\n  target: string,\n  payload: Record<string, unknown>,\n  hints?: string[],\n): Promise<void> {\n  await stageGoogleOp({ kind, customerId, target, payload }, hints);\n}\n\n/** Stage a target-only op (pause/resume/remove/detach): `{ kind, customerId, target }`. */\nexport async function stageTarget(kind: string, customerId: string, target: string, hints?: string[]): Promise<void> {\n  await stageGoogleOp({ kind, customerId, target }, hints);\n}\n\nexport async function draftAction(path: string, body: Record<string, unknown>, chat?: unknown): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const response = await apiPost<Record<string, unknown>>(path, { chatId, ...body });\n    writeJsonEnvelope(response);\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\ninterface DraftListEnvelope extends Record<string, unknown> {\n  ok: boolean;\n  data?: GoogleDraftListResponse;\n}\n\n/**\n * List the staged draft. By default renders a readable campaign ▸ ad group ▸ ad status tree so the\n * agent can review everything it has staged at a glance; `--json` returns the raw envelope for tools,\n * and `--full` that envelope with every op's payload.\n */\nexport async function draftListAction(json: boolean, chat?: unknown, full = false, customerId?: string): Promise<void> {\n  try {\n    const chatId = resolveChatId(chat);\n    const listed = await apiPost<DraftListEnvelope>(\"/api/ads/google/draft\", {\n      chatId,\n      ...(full ? { full: true } : {}),\n    });\n    const inAccount =\n      customerId !== undefined && listed.ok && listed.data ? draftInAccount(listed.data, customerId) : undefined;\n    const response = inAccount ? withHints({ ...listed, data: inAccount.data }, inAccount.hints) : listed;\n    if (json || full || !response.ok || !response.data) {\n      writeJsonEnvelope(response);\n      return;\n    }\n    process.stdout.write(`${inAccount?.empty ?? renderDraftStatus(response.data)}${hintLines(response)}\\n`);\n  } catch (err) {\n    handleGoogleError(err);\n  }\n}\n\nexport const customerIdArg = {\n  \"customer-id\": { type: \"string\" as const, description: \"10-digit Google Ads customer id\" },\n};\n/** The entity a command changes, read by position the way `requireTarget` reads it — declared so --help shows it. */\nexport function targetArg(entity: string) {\n  return {\n    id: {\n      type: \"positional\" as const,\n      description: `The ${entity} to change: its id or resource name (customers/…)`,\n      required: false,\n    },\n  };\n}\n\nconst PAYLOAD_FIELDS = \"run `baker schema` on this command for every field the payload takes\";\n\nfunction payloadShape(kind: string): () => string | undefined {\n  return () => describeOpPayload(googleDraftOpInputSchema, kind);\n}\n\n/** `--file` for a command that stages one `kind` op; `baker schema` prints that op's payload shape. */\nexport function fileArg(kind: string) {\n  return {\n    file: payloadArg(\n      {\n        type: \"string\" as const,\n        description: `The op payload: a JSON file path, or the JSON object inline (flags override it) — ${PAYLOAD_FIELDS}`,\n      },\n      payloadShape(kind),\n    ),\n  };\n}\n\n/** `--file` that stages one or many `kind` ops; `baker schema` prints that op's payload shape. */\nexport function fileBatchArg(kind: string) {\n  return {\n    file: payloadArg(\n      {\n        type: \"string\" as const,\n        description: `The op payload: a JSON file path or inline JSON — one object, or a JSON array / JSON Lines of objects to stage many in one call (up to 500) — ${PAYLOAD_FIELDS}`,\n      },\n      payloadShape(kind),\n    ),\n  };\n}\n\n/** A create command whose payload is a JSON file or inline JSON — one object or an array staged as one batch. */\nexport function fileCreateCommand(\n  name: string,\n  kind: string,\n  description: string,\n  hints?: string[] | ((payload: Record<string, unknown>) => string[]),\n) {\n  return defineCommand({\n    meta: { name, description },\n    args: { ...customerIdArg, ...fileBatchArg(kind) },\n    run: async ({ args }) => {\n      const customerId = requireCustomerId(args);\n      const payloads = loadJsonPayloads(args.file);\n      if (payloads.length === 0 || payloads.some((payload) => Object.keys(payload).length === 0)) {\n        failWriteValidation(`${kind} needs --file with the op payload (one object, or a JSON array to stage many)`);\n      }\n      if (payloads.length > GOOGLE_DRAFT_BATCH_MAX) {\n        failWriteValidation(\n          `${payloads.length} payloads exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} — split the file`,\n        );\n      }\n      const payloadHints = [\n        ...new Set(payloads.flatMap((payload) => (typeof hints === \"function\" ? hints(payload) : (hints ?? [])))),\n      ];\n      await stageGoogleOps(\n        payloads.map((payload) => ({ kind, customerId, payload })),\n        payloadHints,\n      );\n    },\n  });\n}\n\n/**\n * `--bid-modifier` as a number, validated against the range Google actually accepts.\n *\n * Rejecting the (0, 0.1) gap here rather than at the backend is the point: 0 and 0.1 are a hundredth\n * apart in value and mean \"never serve\" versus \"bid a tenth\", so a typo between them is a real spend\n * decision, and the error should arrive before anything is staged.\n */\nexport function bidModifierFlag(value: unknown): number {\n  if (value === undefined || value === null || value === \"\") {\n    failWriteValidation(\n      \"--bid-modifier is required: 1 for no adjustment, 1.25 to bid 25% more, 0.9 to bid 10% less, 0 to stop serving on a device\",\n    );\n  }\n  const num = Number(value);\n  if (Number.isNaN(num) || num < 0 || num > 10 || (num > 0 && num < 0.1)) {\n    failWriteValidation(\"--bid-modifier must be 0 (stop serving on it) or between 0.1 and 10.0\");\n  }\n  return num;\n}\n","import type { z } from \"zod\";\n\n/** Appended to each copy flag's help, so `--help` and `baker schema` say how to pass a comma. */\nexport const AD_COPY_LIST_USAGE =\n  \"repeat the flag once per item, or pass one comma-separated list and wrap an item that contains a comma in double quotes: '\\\"Fast, free quotes\\\",Book today'. A flag given once is read as a list, so a lone item with a comma needs its double quotes too: '\\\"Fast, free quotes\\\"'\";\n\n/** The op's copy-list fields, by the flag an agent passes them with. */\nconst COPY_LIST_FLAG: Readonly<Record<string, string>> = {\n  headlines: \"--headlines\",\n  descriptions: \"--descriptions\",\n  longHeadlines: \"--long-headlines\",\n};\n\ninterface CountRefusal {\n  flag: string;\n  count: number | undefined;\n  bound: string;\n  tooMany: boolean;\n}\n\nfunction valueAt(root: unknown, path: readonly PropertyKey[]): unknown {\n  let node = root;\n  for (const key of path) {\n    if (node === null || typeof node !== \"object\") return undefined;\n    node = (node as Record<PropertyKey, unknown>)[key];\n  }\n  return node;\n}\n\nfunction countRefusal(op: unknown, issue: z.core.$ZodIssue): CountRefusal | undefined {\n  if ((issue.code !== \"too_big\" && issue.code !== \"too_small\") || issue.origin !== \"array\") return undefined;\n  const flag = COPY_LIST_FLAG[String(issue.path.at(-1))];\n  if (!flag) return undefined;\n  const value = valueAt(op, issue.path);\n  const count = Array.isArray(value) ? value.length : undefined;\n  return issue.code === \"too_big\"\n    ? { flag, count, bound: `at most ${issue.maximum}`, tooMany: true }\n    : { flag, count, bound: `at least ${issue.minimum}`, tooMany: false };\n}\n\n/**\n * The fix for a stage refused only for how many headlines, descriptions or long headlines it has.\n *\n * That is a limit on a field the agent named correctly, so the generic \"read `baker capabilities`,\n * do not guess another field name\" sent it through draft list, schema and --help before it saw the\n * cause. Too many items is usually copy cut at its commas — a flag given once is a comma-separated\n * list, so \"Rated 4,5/5\" becomes two items — which is why that case names the forms that keep a\n * comma. Undefined when anything else was refused too, so the capabilities pointer still covers it.\n */\nexport function copyListCountFix(\n  op: unknown,\n  issues: readonly z.core.$ZodIssue[],\n): { action: string; explanation: string } | undefined {\n  const refusals = issues.map((issue) => countRefusal(op, issue));\n  if (refusals.length === 0 || refusals.some((refusal) => refusal === undefined)) return undefined;\n  const counted = refusals.filter((refusal): refusal is CountRefusal => refusal !== undefined);\n  const limits = counted\n    .map(({ flag, count, bound }) => `${flag} has ${count ?? \"the wrong number of\"} items; this ad takes ${bound}.`)\n    .join(\" \");\n  const commaCause = counted.some((refusal) => refusal.tooMany)\n    ? ' If you meant fewer items, the copy was cut at its commas: a flag given once is read as a comma-separated list, so an item with a comma in it (\"Fast, free quotes\", a decimal like \"4,5/5\") becomes two. To keep a comma, ' +\n      `${AD_COPY_LIST_USAGE} — or put the content in --file as JSON.`\n    : \"\";\n  return {\n    action: \"fix_copy_list_count\",\n    explanation: `${limits}${commaCause} ${commaCause ? \"Otherwise add\" : \"Add\"} or drop items to fit the limit, then stage again; the field names are right.`,\n  };\n}\n","import type {\n  GoogleDraftListResponse,\n  GoogleDraftStatusCollection,\n  GoogleDraftStatusNode,\n} from \"@baker/api/ads-google\";\n\n/**\n * Render the staged Google Ads draft as a readable campaign ▸ ad group ▸ ad tree — the CLI\n * counterpart to the dashboard's Google Ads tab, so an agent can review everything it has staged\n * with one command instead of reading raw JSON. Pure: takes the draft-list response, returns text.\n */\n\nconst OPERATION_LABELS: Record<string, string> = {\n  create: \"Creating\",\n  update: \"Updating\",\n  pause: \"Pausing\",\n  resume: \"Resuming\",\n  remove: \"Removing\",\n};\n\nfunction badge(node: GoogleDraftStatusNode): string {\n  const label = node.operation ? OPERATION_LABELS[node.operation] : undefined;\n  if (label) {\n    return label;\n  }\n  return node.existing ? \"on Google Ads\" : \"staged\";\n}\n\nfunction collectionLine(collection: GoogleDraftStatusCollection): string | undefined {\n  const parts: string[] = [];\n  if (collection.added > 0) {\n    parts.push(`+${collection.added}`);\n  }\n  if (collection.existing > 0) {\n    parts.push(`${collection.existing} existing`);\n  }\n  if (collection.removed > 0) {\n    parts.push(`-${collection.removed}`);\n  }\n  // Neither an add nor a remove — a member that stays in the set with a changed value (a device's\n  // bid adjustment). Left out, a draft whose only criterion change is one printed no line at all.\n  if ((collection.updated ?? 0) > 0) {\n    parts.push(`~${collection.updated}`);\n  }\n  return parts.length > 0 ? `${collection.label}: ${parts.join(\", \")}` : undefined;\n}\n\n/**\n * Every advertiser account the tree touches. A draft may legitimately span\n * several, and a criterion id is derived from the keyword's text and match type\n * — so the same keyword carries the same id in every account. The account is\n * printed on each node once there is more than one, and left off when there is not.\n */\nfunction accountsInTree(nodes: readonly GoogleDraftStatusNode[]): Set<string> {\n  const accounts = new Set<string>();\n  const walk = (node: GoogleDraftStatusNode): void => {\n    accounts.add(node.customerId);\n    for (const child of node.children) {\n      walk(child);\n    }\n  };\n  for (const node of nodes) {\n    walk(node);\n  }\n  return accounts;\n}\n\nfunction renderNode(node: GoogleDraftStatusNode, depth: number, lines: string[], showAccount: boolean): void {\n  const indent = \"  \".repeat(depth);\n  const account = showAccount ? ` · account ${node.customerId}` : \"\";\n  lines.push(`${indent}• ${node.name} · ${badge(node)}${account}`);\n  for (const warning of node.warnings ?? []) {\n    lines.push(`${indent}    ⚠ ${warning}`);\n  }\n  for (const collection of node.collections) {\n    const line = collectionLine(collection);\n    if (line) {\n      lines.push(`${indent}    ${line}`);\n    }\n  }\n  for (const child of node.children) {\n    renderNode(child, depth + 1, lines, showAccount);\n  }\n}\n\nconst RESOURCE_ENTITIES = new Set([\n  \"sharedSet\",\n  \"biddingStrategy\",\n  \"audience\",\n  \"conversionAction\",\n  \"label\",\n  \"budget\",\n  \"asset\",\n]);\n\nfunction renderSection(title: string, nodes: GoogleDraftStatusNode[], lines: string[], showAccount: boolean): void {\n  if (nodes.length === 0) {\n    return;\n  }\n  lines.push(\"\");\n  lines.push(title);\n  for (const node of nodes) {\n    renderNode(node, 1, lines, showAccount);\n  }\n}\n\nfunction renderAdvisories(data: GoogleDraftListResponse, lines: string[]): void {\n  const advisories = data.advisories ?? [];\n  // Every advisory is phrased as something to settle BEFORE publishing. On a published draft there\n  // is nothing left to settle here, and printing them reads as work still outstanding on this chat.\n  if (advisories.length === 0 || data.status === \"applied\") {\n    return;\n  }\n  lines.push(\"\");\n  // Two kinds of finding share this block: build-out nudges (\"this ad group has one ad\") and\n  // whole-draft coherence findings (\"this campaign will report zero conversions\", \"two of your\n  // campaigns bid on the same keyword\"). The coherence ones come first and cost money, so the\n  // heading no longer frames the block as optional polish.\n  lines.push(\"Advisories (non-blocking, checked across the whole draft — settle these before you publish)\");\n  for (const advisory of advisories) {\n    lines.push(`  • ${advisory.message}`);\n  }\n}\n\n/**\n * What the publish did, once there is a publish to report.\n *\n * A published Google Ads draft rendered exactly like a staged one — same count, every op still\n * reading \"Creating\" — so the surface `.claude/rules/cli-env.md` sends an agent to for the outcome\n * could not answer, and a failed op was invisible in the human output while sitting in the JSON\n * envelope the whole time. Found by publishing a BUSINESS_LOGO link that Google refused with\n * \"Customer is not verified\": the draft still read \"4 staged changes\". LinkedIn fixed the same\n * shape first; this is its counterpart.\n */\nfunction renderOutcome(data: GoogleDraftListResponse, lines: string[]): void {\n  const counts = new Map<string, number>();\n  for (const op of data.ops) {\n    const status = op.result?.status ?? \"pending\";\n    counts.set(status, (counts.get(status) ?? 0) + 1);\n  }\n  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(\", \");\n  lines.push(`Google Ads — published · ${summary || `${data.count} op(s)`} · ${data.mode}`);\n  // A failure is the reason to read this at all, so it is named with its error rather than left as\n  // a number to go and look up.\n  for (const op of data.ops) {\n    const status = op.result?.status;\n    if (status !== \"failed\" && status !== \"skipped\") {\n      continue;\n    }\n    const reason = op.result?.error ?? op.result?.skippedBecause ?? \"no reason recorded\";\n    lines.push(`  ✗ ${op.summary} — ${status}: ${reason}`);\n  }\n}\n\nexport function renderDraftStatus(data: GoogleDraftListResponse): string {\n  if (data.status === \"none\" || data.count === 0) {\n    return \"No staged Google Ads changes on this chat.\";\n  }\n  const modeNote =\n    data.mode === \"live\"\n      ? \"Live — publishing writes directly to Google Ads.\"\n      : \"Simulated — publishing completes the whole draft without calling Google Ads.\";\n  const lines: string[] = [];\n  if (data.status === \"applied\") {\n    renderOutcome(data, lines);\n  } else if (data.status === \"publishing\") {\n    lines.push(`Google Ads — publishing ${data.count} change${data.count === 1 ? \"\" : \"s\"} · ${data.mode}`);\n  } else {\n    lines.push(`Google Ads — ${data.count} staged change${data.count === 1 ? \"\" : \"s\"} · ${data.mode}`);\n  }\n  lines.push(modeNote);\n\n  const tree = data.tree ?? [];\n  const showAccount = accountsInTree(tree).size > 1;\n  renderSection(\n    \"Shared resources\",\n    tree.filter((node) => RESOURCE_ENTITIES.has(node.entity)),\n    lines,\n    showAccount,\n  );\n  renderSection(\n    \"Campaigns\",\n    tree.filter((node) => node.entity === \"campaign\"),\n    lines,\n    showAccount,\n  );\n  const rest = tree.filter((node) => !RESOURCE_ENTITIES.has(node.entity) && node.entity !== \"campaign\");\n  renderSection(\"Other\", rest, lines, showAccount);\n  renderAdvisories(data, lines);\n\n  return lines.join(\"\\n\");\n}\n","import { cacheGet, cacheSet } from \"../cache.ts\";\n\n/**\n * Bulk work done as a loop of single commands — one `keywords update` per keyword, one\n * `negative-keywords remove` per term — is one request, one rate-limit hit and one tool call per row;\n * production saw 1,284 of them. The CLI cannot see the loop from inside one call, so it remembers the\n * last few single stages per chat and, once the same kind repeats, says how to do the rest in one call.\n */\n\nexport interface StageStreak {\n  kind: string;\n  count: number;\n  lastAt: number;\n}\n\n/** Singles further apart than this are separate decisions, not a loop. */\nconst STREAK_WINDOW_MS = 5 * 60_000;\n/** The streak length that reads as a loop. */\nconst STREAK_THRESHOLD = 5;\n\nexport function nextStageStreak(previous: StageStreak | undefined, kind: string, now: number): StageStreak {\n  const continues = previous && previous.kind === kind && now - previous.lastAt <= STREAK_WINDOW_MS;\n  return { kind, count: continues ? previous.count + 1 : 1, lastAt: now };\n}\n\n/** The one-call form of a kind, where a command has one beside `draft stage --file`. */\nconst BATCH_FORMS: Record<string, string> = {\n  \"google.keyword.add\": \"`keywords add --file keywords.txt` (one term[:MATCH_TYPE] per line)\",\n  \"google.keyword.update\":\n    \"`keywords pause|resume <resource name> <resource name>…` (or --file, one per line) for status\",\n  \"google.keyword.remove\": \"`draft stage --file` with one google.keyword.remove per target\",\n  \"google.negativeKeyword.add\": \"`negative-keywords add --file terms.txt`\",\n  \"google.sharedSetMember.add\": \"`keyword-lists add --file terms.txt`\",\n  \"google.sharedSetMember.remove\": '`keyword-lists remove --list-ref <id> --text \"a,b,c\"`',\n};\n\nexport function stageStreakHints(streak: StageStreak): string[] {\n  if (streak.count < STREAK_THRESHOLD) {\n    return [];\n  }\n  const form = BATCH_FORMS[streak.kind];\n  return [\n    `LOOP: that is ${streak.count} ${streak.kind} ops staged one command at a time. Stop looping — put every remaining change in one file and stage them in ONE call: \\`baker ads google draft stage --file ops.json --customer-id <id>\\` (a JSON array of {\"kind\",\"target\"?,\"payload\"?}, up to 500, any mix of kinds)${form ? `, or ${form}` : \"\"}. Fix staged ops together with \\`draft amend --file\\`.`,\n  ];\n}\n\nconst STREAK_CACHE = \"stage-streak\";\n\n/** Record one single stage on this chat and return the nudge it earns, if any. Never throws. */\nexport function recordSingleStage(chatId: string, kind: string): string[] {\n  try {\n    const streak = nextStageStreak(cacheGet<StageStreak>(STREAK_CACHE, chatId)?.data, kind, Date.now());\n    cacheSet(STREAK_CACHE, chatId, streak, STREAK_WINDOW_MS);\n    return stageStreakHints(streak);\n  } catch {\n    return [];\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ALCRXFIZ.js

@@ -0,0 +1,351 @@
+import {
+  RESEARCH_GOOGLE_ADS_MAX_COPY
+} from "./chunk-BTOGDXA4.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 webSourceHints(sources) {
+  if (sources.length === 0) {
+    return [
+      "This answer came back with no sources. Treat every claim in it as Synthesis: \u2014 no source to cite. Do not attach a URL to it; to cite a fact, find the page that states it and read it with `baker research fetch`."
+    ];
+  }
+  const unresolved = sources.filter((s) => s.resolved === false).length;
+  if (unresolved > 0) {
+    return [
+      `${unresolved} of ${sources.length} sources are Google links that could not be followed (resolved: false). Do not cite them or guess a path from the site name \u2014 cite only a resolved URL, or open the claim's page yourself.`
+    ];
+  }
+  return [];
+}
+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;
+}
+var LINKEDIN_PERSON_USE = "For ad and page messaging only; nothing is stored \u2014 quote their stated priorities into the creative brief for this account, and don't save the person to Knowledge or read them again to keep track of them.";
+function peopleHints({
+  found,
+  dropped,
+  verified
+}) {
+  if (found === 0) {
+    return [
+      `Nobody in public LinkedIn results holds this role here${dropped > 0 ? ` (${dropped} profiles were elsewhere now or in another role)` : ""}. Try the name people write on LinkedIn with --name, a broader --seniority, or the client's CRM: \`baker hubspot companies contacts <domain>\`.`
+    ];
+  }
+  const hints = [
+    verified ? "These are public search results a decision model checked \u2014 likely holders of the role, to confirm before anyone reaches out. Brief sales with them; never contact anyone or save them to Knowledge." : "The check could not run, so these profiles are unchecked: Google matched the words, not the person. Read each headline before naming anyone.",
+    "To write to one of them in their own words, read their profile once: `baker research linkedin-person <profile_url>`."
+  ];
+  return hints;
+}
+function linkedinPersonHints({ isPrivate, postCount }) {
+  if (isPrivate) {
+    return [
+      "LinkedIn doesn't show this profile publicly, and reading it again won't change that. Find their own words elsewhere \u2014 a keynote, podcast or earnings call through `baker research transcript <url>`, or an interview through `baker research fetch <url>` \u2014 or write the brief from the account's company-level priorities."
+    ];
+  }
+  if (postCount === 0) {
+    return [
+      LINKEDIN_PERSON_USE,
+      "They have no recent posts, so their `about` is the only first-person line here. Their priorities are more often said aloud: a keynote, podcast or earnings call through `baker research transcript <url>`."
+    ];
+  }
+  return [LINKEDIN_PERSON_USE];
+}
+function transcriptHints({ excerpted, truncated }) {
+  const hints = [];
+  if (excerpted) {
+    hints.push(
+      "This is the opening excerpt. Re-run with `--out <file>` to write the whole text to a file and read the parts you need, or `--full` to have it all here \u2014 the transcript is cached for 7 days, so either costs nothing more."
+    );
+  }
+  if (truncated) {
+    hints.push(
+      "The recording is longer than one transcript carries, so the end of the recording is missing. Don't quote this as the whole talk."
+    );
+  }
+  return hints;
+}
+function thinProfileHint(domain, profile) {
+  const missing = [
+    profile.linkedinUrl ? null : "no LinkedIn page",
+    profile.hqCountry ? null : "no HQ country",
+    profile.employees ? null : "no employee band"
+  ].filter((gap) => gap !== null);
+  const tiny = profile.employees === "1-10";
+  if (missing.length < 2 && !tiny) return null;
+  const why = [...missing, ...tiny ? ["1-10 employees"] : []].join(", ");
+  return `This profile is thin (${why}). Check ${domain} is the company's main website \u2014 companies often run on another domain (e.g. factorial.es vs factorialhr.com) \u2014 before using these facts for tiering.`;
+}
+function companyHints({
+  domain,
+  profile,
+  hiring
+}) {
+  const hints = [];
+  if (!profile) {
+    hints.push(
+      "There's no company profile for this domain, only its hiring. Check it is the company's main website; otherwise take size, industry and location from its LinkedIn page or its own site."
+    );
+  } else {
+    const thin = thinProfileHint(domain, profile);
+    if (thin) hints.push(thin);
+  }
+  if (hiring.status === "unavailable" && hiring.reason === "not_configured") {
+    hints.push(
+      "Hiring signals aren't switched on for this workspace yet, so these are the firmographics alone. Score the account on them and leave hiring out of the reason."
+    );
+  }
+  if (hiring.status === "unavailable" && hiring.reason === "failed") {
+    hints.push(
+      "Hiring signals couldn't be read this time; don't retry in a loop. Use the firmographics and say hiring is unknown for this account."
+    );
+  }
+  if (hiring.status === "not_tracked") {
+    hints.push(
+      "No hiring data is kept for this company \u2014 that means unknown, not that it isn't hiring. Don't score it down for it."
+    );
+  }
+  return hints;
+}
+function industryList(industries) {
+  return industries.map(({ slug, companies }) => `${slug} (${companies.toLocaleString("en-US")})`).join(", ");
+}
+function relatedIndustriesHint(related) {
+  if (related.length === 0) return null;
+  return `Related industries not included (companies each adds with your other filters): ${industryList(related)} \u2014 add them with --industry a,b to widen.`;
+}
+function companySearchHints({
+  total,
+  returned,
+  page,
+  lastPage,
+  related
+}) {
+  const hints = [];
+  if (total === 0) {
+    hints.push(
+      "No company matches every filter. Widen one at a time \u2014 a neighbouring size band, a related industry, one more country."
+    );
+  } else if (page < lastPage && returned > 0) {
+    hints.push(
+      `${total} companies match and ${returned} came back (each one returned is billed). Use \`total\` to size the market; ask for \`--page ${page + 1}\` only if you need the next rows for the list.`
+    );
+  }
+  const widen = relatedIndustriesHint(related);
+  if (widen) hints.push(widen);
+  return hints;
+}
+function unknownIndustriesFix(industries) {
+  const misses = industries.map(
+    ({ input, closest }) => closest.length > 0 ? `"${input}" is not an industry. Closest (companies each matches with your other filters): ${industryList(closest)}.` : `"${input}" is not an industry, and none is named like it \u2014 try a broader word (software, logistics, retail).`
+  );
+  return {
+    action: "retry_with_changes",
+    explanation: `${misses.join(" ")} Pass one or several of these slugs with --industry a,b \u2014 several widen the search, any of them matching. Nothing was charged.`
+  };
+}
+
+export {
+  noSerpRowsHints,
+  advertisersHints,
+  keywordsForSiteHints,
+  webSourceHints,
+  fetchHints,
+  webDepthHints,
+  keywordMetricsHints,
+  redditSearchHints,
+  redditThreadHints,
+  redditSubredditsHints,
+  REDDIT_LINK_REJECTED,
+  redditPageFix,
+  googleAdsHints,
+  peopleHints,
+  linkedinPersonHints,
+  transcriptHints,
+  companyHints,
+  companySearchHints,
+  unknownIndustriesFix
+};
+//# sourceMappingURL=chunk-ALCRXFIZ.js.map

package/dist/chunk-ALCRXFIZ.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 {\n  RESEARCH_GOOGLE_ADS_MAX_COPY,\n  type ResearchCompanyHiring,\n  type ResearchCompanyIndustry,\n  type ResearchRedditSource,\n} 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 * Google grounding used to come back as opaque redirect links labelled by domain,\n * and the agent guessed the real paths, 404'd, and invented links. The backend\n * now follows them; this says what to do with the ones it could not, and with\n * an answer that rests on nothing.\n */\nexport function webSourceHints(sources: Array<{ resolved?: boolean }>): string[] {\n  if (sources.length === 0) {\n    return [\n      \"This answer came back with no sources. Treat every claim in it as Synthesis: — no source to cite. \" +\n        \"Do not attach a URL to it; to cite a fact, find the page that states it and read it with `baker research fetch`.\",\n    ];\n  }\n  // An older backend sends no `resolved`; only an explicit false is a link we know is opaque.\n  const unresolved = sources.filter((s) => s.resolved === false).length;\n  if (unresolved > 0) {\n    return [\n      `${unresolved} of ${sources.length} sources are Google links that could not be followed (resolved: false). ` +\n        \"Do not cite them or guess a path from the site name — cite only a resolved URL, or open the claim's page yourself.\",\n    ];\n  }\n  return [];\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\n/**\n * A person's profile is read to write one account's ads and pages, and that is\n * all it is for. Said on every read, because the next natural step — saving\n * them to Knowledge, or reading them again next week — is the one we don't take.\n */\nexport const LINKEDIN_PERSON_USE =\n  \"For ad and page messaging only; nothing is stored — quote their stated priorities into the creative brief \" +\n  \"for this account, and don't save the person to Knowledge or read them again to keep track of them.\";\n\n/**\n * The people a search found are public profiles a decision model checked, not\n * contacts: said on every read, with the one next step that deepens a lead.\n */\nexport function peopleHints({\n  found,\n  dropped,\n  verified,\n}: {\n  found: number;\n  dropped: number;\n  verified: boolean;\n}): string[] {\n  if (found === 0) {\n    return [\n      `Nobody in public LinkedIn results holds this role here${dropped > 0 ? ` (${dropped} profiles were elsewhere now or in another role)` : \"\"}. ` +\n        \"Try the name people write on LinkedIn with --name, a broader --seniority, or the client's CRM: `baker hubspot companies contacts <domain>`.\",\n    ];\n  }\n  const hints = [\n    verified\n      ? \"These are public search results a decision model checked — likely holders of the role, to confirm before anyone reaches out. Brief sales with them; never contact anyone or save them to Knowledge.\"\n      : \"The check could not run, so these profiles are unchecked: Google matched the words, not the person. Read each headline before naming anyone.\",\n    \"To write to one of them in their own words, read their profile once: `baker research linkedin-person <profile_url>`.\",\n  ];\n  return hints;\n}\n\nexport function linkedinPersonHints({ isPrivate, postCount }: { isPrivate: boolean; postCount: number }): string[] {\n  if (isPrivate) {\n    return [\n      \"LinkedIn doesn't show this profile publicly, and reading it again won't change that. \" +\n        \"Find their own words elsewhere — a keynote, podcast or earnings call through \" +\n        \"`baker research transcript <url>`, or an interview through `baker research fetch <url>` — \" +\n        \"or write the brief from the account's company-level priorities.\",\n    ];\n  }\n  if (postCount === 0) {\n    return [\n      LINKEDIN_PERSON_USE,\n      \"They have no recent posts, so their `about` is the only first-person line here. \" +\n        \"Their priorities are more often said aloud: a keynote, podcast or earnings call through `baker research transcript <url>`.\",\n    ];\n  }\n  return [LINKEDIN_PERSON_USE];\n}\n\n/**\n * A keynote runs to tens of thousands of words, which is why the default is an\n * excerpt; the transcript is cached for a week, so asking again for the rest\n * costs nothing.\n */\nexport function transcriptHints({ excerpted, truncated }: { excerpted: boolean; truncated: boolean }): string[] {\n  const hints: string[] = [];\n  if (excerpted) {\n    hints.push(\n      \"This is the opening excerpt. Re-run with `--out <file>` to write the whole text to a file and read the parts you need, \" +\n        \"or `--full` to have it all here — the transcript is cached for 7 days, so either costs nothing more.\",\n    );\n  }\n  if (truncated) {\n    hints.push(\n      \"The recording is longer than one transcript carries, so the end of the recording is missing. \" +\n        \"Don't quote this as the whole talk.\",\n    );\n  }\n  return hints;\n}\n\n/** The facts whose absence marks a profile as possibly another company's. */\nexport interface CompanyProfileFacts {\n  linkedinUrl: string | null;\n  hqCountry: string | null;\n  employees: string | null;\n}\n\n/**\n * A profile missing two of its anchor facts, or sized 1-10, is often a namesake\n * on the domain asked for while the company itself runs on another one.\n */\nfunction thinProfileHint(domain: string, profile: CompanyProfileFacts): string | null {\n  const missing = [\n    profile.linkedinUrl ? null : \"no LinkedIn page\",\n    profile.hqCountry ? null : \"no HQ country\",\n    profile.employees ? null : \"no employee band\",\n  ].filter((gap) => gap !== null);\n  const tiny = profile.employees === \"1-10\";\n  if (missing.length < 2 && !tiny) return null;\n  const why = [...missing, ...(tiny ? [\"1-10 employees\"] : [])].join(\", \");\n  return (\n    `This profile is thin (${why}). Check ${domain} is the company's main website — companies often run on another ` +\n    \"domain (e.g. factorial.es vs factorialhr.com) — before using these facts for tiering.\"\n  );\n}\n\n/**\n * Hiring is a signal on top of the profile, so a lookup without it still\n * answers — and says which half is missing, so the agent neither loops on it\n * nor reads \"no openings\" into a gap. A hiring read left out on purpose\n * (`--no-hiring`) says nothing.\n */\nexport function companyHints({\n  domain,\n  profile,\n  hiring,\n}: {\n  domain: string;\n  profile: CompanyProfileFacts | null;\n  hiring: ResearchCompanyHiring;\n}): string[] {\n  const hints: string[] = [];\n  if (!profile) {\n    hints.push(\n      \"There's no company profile for this domain, only its hiring. Check it is the company's main website; \" +\n        \"otherwise take size, industry and location from its LinkedIn page or its own site.\",\n    );\n  } else {\n    const thin = thinProfileHint(domain, profile);\n    if (thin) hints.push(thin);\n  }\n  if (hiring.status === \"unavailable\" && hiring.reason === \"not_configured\") {\n    hints.push(\n      \"Hiring signals aren't switched on for this workspace yet, so these are the firmographics alone. \" +\n        \"Score the account on them and leave hiring out of the reason.\",\n    );\n  }\n  if (hiring.status === \"unavailable\" && hiring.reason === \"failed\") {\n    hints.push(\n      \"Hiring signals couldn't be read this time; don't retry in a loop. Use the firmographics and say hiring is unknown for this account.\",\n    );\n  }\n  if (hiring.status === \"not_tracked\") {\n    hints.push(\n      \"No hiring data is kept for this company — that means unknown, not that it isn't hiring. Don't score it down for it.\",\n    );\n  }\n  return hints;\n}\n\nfunction industryList(industries: readonly ResearchCompanyIndustry[]): string {\n  return industries.map(({ slug, companies }) => `${slug} (${companies.toLocaleString(\"en-US\")})`).join(\", \");\n}\n\n/**\n * Neighbouring industries the search left out, so a thin market is widened on\n * purpose rather than guessed at. Each count is the companies it would add.\n */\nfunction relatedIndustriesHint(related: readonly ResearchCompanyIndustry[]): string | null {\n  if (related.length === 0) return null;\n  return (\n    `Related industries not included (companies each adds with your other filters): ${industryList(related)}` +\n    \" — add them with --industry a,b to widen.\"\n  );\n}\n\nexport function companySearchHints({\n  total,\n  returned,\n  page,\n  lastPage,\n  related,\n}: {\n  total: number;\n  returned: number;\n  page: number;\n  lastPage: number;\n  related: readonly ResearchCompanyIndustry[];\n}): string[] {\n  const hints: string[] = [];\n  if (total === 0) {\n    hints.push(\n      \"No company matches every filter. Widen one at a time — a neighbouring size band, a related industry, one more country.\",\n    );\n  } else if (page < lastPage && returned > 0) {\n    hints.push(\n      `${total} companies match and ${returned} came back (each one returned is billed). ` +\n        `Use \\`total\\` to size the market; ask for \\`--page ${page + 1}\\` only if you need the next rows for the list.`,\n    );\n  }\n  const widen = relatedIndustriesHint(related);\n  if (widen) hints.push(widen);\n  return hints;\n}\n\n/** An industry that is no slug refuses the search before anything is billed; the fix offers the real ones. */\nexport function unknownIndustriesFix(industries: readonly { input: string; closest: ResearchCompanyIndustry[] }[]): {\n  action: \"retry_with_changes\";\n  explanation: string;\n} {\n  const misses = industries.map(({ input, closest }) =>\n    closest.length > 0\n      ? `\"${input}\" is not an industry. Closest (companies each matches with your other filters): ${industryList(closest)}.`\n      : `\"${input}\" is not an industry, and none is named like it — try a broader word (software, logistics, retail).`,\n  );\n  return {\n    action: \"retry_with_changes\",\n    explanation: `${misses.join(\" \")} Pass one or several of these slugs with --industry a,b — several widen the search, any of them matching. Nothing was charged.`,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-AYKV2B6X.js

@@ -0,0 +1,47 @@
+// ../api/src/accounts/companyName.ts
+var NOISE_WORDS = /* @__PURE__ */ new Set([
+  "inc",
+  "incorporated",
+  "llc",
+  "ltd",
+  "limited",
+  "plc",
+  "corp",
+  "corporation",
+  "co",
+  "company",
+  "gmbh",
+  "ag",
+  "kg",
+  "bv",
+  "nv",
+  "sa",
+  "sau",
+  "sl",
+  "slu",
+  "sas",
+  "sarl",
+  "srl",
+  "spa",
+  "oy",
+  "ab",
+  "as",
+  "aps",
+  "pty",
+  "lda",
+  "ltda",
+  "kk",
+  "group",
+  "grupo",
+  "holding",
+  "holdings",
+  "the"
+]);
+function companyNameKey(name) {
+  return name.normalize("NFD").replace(new RegExp("\\p{Diacritic}", "gu"), "").toLowerCase().replace(/\./g, "").split(/[^\p{L}\p{N}]+/u).filter((word) => word !== "" && !NOISE_WORDS.has(word)).join(" ");
+}
+
+export {
+  companyNameKey
+};
+//# sourceMappingURL=chunk-AYKV2B6X.js.map

package/dist/chunk-AYKV2B6X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/accounts/companyName.ts"],"sourcesContent":["/**\n * One company, however its name is spelled.\n *\n * Visitor companies arrive as a network's registered name — `Banco Santander\n * S.A.`, `ACME-CORP` — and nothing else: Cloudflare gives no website, so they\n * cannot join the Account insights rows or a target list on the registrable\n * domain everything else here joins on. This is the fallback key: case,\n * accents, punctuation and legal-entity suffixes removed, so `Telefónica, S.A.`\n * and `TELEFONICA` meet. Equality on the key, never a fuzzy score — a wrong\n * match puts the wrong company in a sales brief.\n */\n\n/** Legal-entity and filler words that say nothing about which company it is. */\nconst NOISE_WORDS = new Set([\n  \"inc\",\n  \"incorporated\",\n  \"llc\",\n  \"ltd\",\n  \"limited\",\n  \"plc\",\n  \"corp\",\n  \"corporation\",\n  \"co\",\n  \"company\",\n  \"gmbh\",\n  \"ag\",\n  \"kg\",\n  \"bv\",\n  \"nv\",\n  \"sa\",\n  \"sau\",\n  \"sl\",\n  \"slu\",\n  \"sas\",\n  \"sarl\",\n  \"srl\",\n  \"spa\",\n  \"oy\",\n  \"ab\",\n  \"as\",\n  \"aps\",\n  \"pty\",\n  \"lda\",\n  \"ltda\",\n  \"kk\",\n  \"group\",\n  \"grupo\",\n  \"holding\",\n  \"holdings\",\n  \"the\",\n]);\n\n/** The comparable form of a company name; empty when nothing distinctive is left. */\nexport function companyNameKey(name: string): string {\n  return name\n    .normalize(\"NFD\")\n    .replace(/\\p{Diacritic}/gu, \"\")\n    .toLowerCase()\n    .replace(/\\./g, \"\")\n    .split(/[^\\p{L}\\p{N}]+/u)\n    .filter((word) => word !== \"\" && !NOISE_WORDS.has(word))\n    .join(\" \");\n}\n"],"mappings":";AAaA,IAAM,cAAc,oBAAI,IAAI;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,SAAS,eAAe,MAAsB;AACnD,SAAO,KACJ,UAAU,KAAK,EACf,QAAQ,WAAC,kBAAc,IAAE,GAAE,EAAE,EAC7B,YAAY,EACZ,QAAQ,OAAO,EAAE,EACjB,MAAM,iBAAiB,EACvB,OAAO,CAAC,SAAS,SAAS,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,EACtD,KAAK,GAAG;AACb;","names":[]}