@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/chunk-IVIJJXXT.js

@@ -0,0 +1,62 @@
+// src/commands/images/brandVerification.ts
+function brandToken(domain) {
+  const bare = domain.trim().toLowerCase().replace(/^[a-z]+:\/\//, "").replace(/^www\./, "").split("/")[0];
+  const label = (bare ?? "").split(".")[0] ?? "";
+  return label;
+}
+function readBackHints(domain, ingested, token, recoverRoute) {
+  if (ingested.length === 0) {
+    return [
+      `Nothing was catalogued, so no described row exists to check the mark against. Re-run with \`--auto-ingest 1\` and read \`textInImage\` / \`subject\` back with \`baker images get <imageId>\`, or open the URL and confirm by eye that it is ${token || domain}'s mark and not another company's.`
+    ];
+  }
+  const readBack = ingested.map((item) => `baker images get ${item.imageId}`).join(" && ");
+  return [
+    `Read the mark itself: run \`${readBack}\` and confirm \`textInImage\` / \`subject\` names ${token || domain}. If it names a different company, this is the wrong mark: discard it and use ${recoverRoute} instead.`,
+    "The catalogued row is described asynchronously, so `textInImage` may be empty on the first read \u2014 re-read once the row is `ready` rather than treating an empty field as a match."
+  ];
+}
+function brandVerificationHints({
+  domain,
+  ingested,
+  hitCount = 0,
+  recover,
+  brandMatch
+}) {
+  if (ingested.length === 0 && hitCount === 0) {
+    return [];
+  }
+  const token = brandToken(domain);
+  const recoverRoute = recover ?? `\`baker images extract https://${domain}\` to pull the mark off the brand's own site`;
+  const readBack = readBackHints(domain, ingested, token, recoverRoute);
+  if (brandMatch?.verdict === "mismatch") {
+    const owner = brandMatch.name ?? "a different company";
+    const ownerDomain = brandMatch.domain ? ` (${brandMatch.domain})` : "";
+    return [
+      `WRONG BRAND \u2014 Brandfetch holds no record for "${domain}". The closest one it has is ${owner}${ownerDomain}, so the mark returned here is very likely ${owner}'s, not ${token || domain}'s. Do not place it. Use ${recoverRoute}, and if that fails, tell the user you could not find their logo rather than shipping this one.`,
+      ...readBack
+    ];
+  }
+  if (brandMatch?.verdict === "confirmed") {
+    const owner = brandMatch.name ?? (token || domain);
+    return [
+      `Brandfetch confirms "${domain}" is ${owner}, which verifies the record \u2014 not the artwork. Its ${owner} record is what the returned files come from, and a provider record can hold the wrong company's image: this is exactly how a domain confirmed as "Zernio" served ClickUp's logo into a client's page.`,
+      ...readBack
+    ];
+  }
+  if (brandMatch?.verdict === "unverified") {
+    return [
+      `This mark could not be checked \u2014 Brandfetch returned no record for "${domain}", so nothing confirms whose logo these files are. Treat it as unverified rather than as correct.`,
+      ...readBack
+    ];
+  }
+  return [
+    `VERIFY BRAND before placing any of these. This matched on the string "${domain}", not on what the image shows \u2014 a 200 from the provider's CDN only means bytes were served, so a wrong brand's mark comes back looking exactly like a right one.`,
+    ...readBack
+  ];
+}
+
+export {
+  brandVerificationHints
+};
+//# sourceMappingURL=chunk-IVIJJXXT.js.map

package/dist/chunk-IVIJJXXT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/brandVerification.ts"],"sourcesContent":["/**\n * Brandfetch matches on the domain string, not on what the mark depicts.\n *\n * Resolution is a constructed CDN URL probed with a GET whose bytes are thrown\n * away, so a 200 means \"the CDN served something\", never \"this is that brand's\n * logo\". In a real run `freepik.com` returned the Magnific wordmark and\n * `zernio.com` returned ClickUp — both shipped into a client's page and both\n * only noticed twenty minutes later, by eye.\n *\n * The response now carries `brandMatch`, Brandfetch's own answer to \"whose brand\n * is this domain\", so these hints no longer have to fire blind:\n *\n *   - `mismatch`   — Brandfetch has records and none is this brand. Loudest\n *                    warning available, naming the company whose mark this is.\n *   - `unverified` — the check did not run. Say so; do not imply either verdict.\n *   - `confirmed`  — the metadata agrees. Says nothing about the artwork, and\n *                    the read-back check stays exactly where it was, because\n *                    `zernio.com` is `confirmed` and still serves ClickUp.\n *\n * The hits are never withheld. A warned-about wrong logo is recoverable; a\n * client whose real mark refuses to load is not.\n */\n\ninterface IngestedRef {\n  imageId: string;\n}\n\n/** Brandfetch's verdict, as carried on the `logo` response. Absent for `icon`,\n * which has no brand record to consult, and for an older backend. */\ninterface BrandMatchRef {\n  verdict: \"confirmed\" | \"mismatch\" | \"unverified\";\n  requestedDomain?: string;\n  name?: string;\n  domain?: string;\n}\n\ninterface BrandVerificationInput {\n  /** What was asked for — a domain for `logo`, an icon slug for `icon`. */\n  domain: string;\n  ingested: IngestedRef[];\n  /** Hits returned by the provider. With `--no-auto-ingest` there are hits but\n   * no library row, so the read-back check has nothing to read. */\n  hitCount?: number;\n  /** What to run when the mark turns out to be the wrong brand. Callers whose\n   * subject is not a hostname must pass their own route — `https://<icon-slug>`\n   * is not a page. */\n  recover?: string;\n  brandMatch?: BrandMatchRef;\n}\n\n/**\n * The brand's own word, as it would appear burned into its wordmark:\n * `www.zernio.com` → `zernio`, `linear.app` → `linear`.\n */\nexport function brandToken(domain: string): string {\n  const bare = domain\n    .trim()\n    .toLowerCase()\n    .replace(/^[a-z]+:\\/\\//, \"\")\n    .replace(/^www\\./, \"\")\n    .split(\"/\")[0];\n  const label = (bare ?? \"\").split(\".\")[0] ?? \"\";\n  return label;\n}\n\n/** How to read the mark back, or how to get into a position to. */\nfunction readBackHints(domain: string, ingested: IngestedRef[], token: string, recoverRoute: string): string[] {\n  if (ingested.length === 0) {\n    return [\n      `Nothing was catalogued, so no described row exists to check the mark against. Re-run with \\`--auto-ingest 1\\` and read \\`textInImage\\` / \\`subject\\` back with \\`baker images get <imageId>\\`, or open the URL and confirm by eye that it is ${token || domain}'s mark and not another company's.`,\n    ];\n  }\n  const readBack = ingested.map((item) => `baker images get ${item.imageId}`).join(\" && \");\n  return [\n    `Read the mark itself: run \\`${readBack}\\` and confirm \\`textInImage\\` / \\`subject\\` names ${token || domain}. If it names a different company, this is the wrong mark: discard it and use ${recoverRoute} instead.`,\n    \"The catalogued row is described asynchronously, so `textInImage` may be empty on the first read — re-read once the row is `ready` rather than treating an empty field as a match.\",\n  ];\n}\n\nexport function brandVerificationHints({\n  domain,\n  ingested,\n  hitCount = 0,\n  recover,\n  brandMatch,\n}: BrandVerificationInput): string[] {\n  if (ingested.length === 0 && hitCount === 0) {\n    return [];\n  }\n\n  const token = brandToken(domain);\n  const recoverRoute =\n    recover ?? `\\`baker images extract https://${domain}\\` to pull the mark off the brand's own site`;\n  const readBack = readBackHints(domain, ingested, token, recoverRoute);\n\n  if (brandMatch?.verdict === \"mismatch\") {\n    const owner = brandMatch.name ?? \"a different company\";\n    const ownerDomain = brandMatch.domain ? ` (${brandMatch.domain})` : \"\";\n    return [\n      `WRONG BRAND — Brandfetch holds no record for \"${domain}\". The closest one it has is ${owner}${ownerDomain}, so the mark returned here is very likely ${owner}'s, not ${token || domain}'s. Do not place it. Use ${recoverRoute}, and if that fails, tell the user you could not find their logo rather than shipping this one.`,\n      ...readBack,\n    ];\n  }\n\n  if (brandMatch?.verdict === \"confirmed\") {\n    const owner = brandMatch.name ?? (token || domain);\n    return [\n      `Brandfetch confirms \"${domain}\" is ${owner}, which verifies the record — not the artwork. Its ${owner} record is what the returned files come from, and a provider record can hold the wrong company's image: this is exactly how a domain confirmed as \"Zernio\" served ClickUp's logo into a client's page.`,\n      ...readBack,\n    ];\n  }\n\n  if (brandMatch?.verdict === \"unverified\") {\n    return [\n      `This mark could not be checked — Brandfetch returned no record for \"${domain}\", so nothing confirms whose logo these files are. Treat it as unverified rather than as correct.`,\n      ...readBack,\n    ];\n  }\n\n  // No verdict at all (an `icon` lookup, or a backend that predates the field):\n  // fall back to warning unconditionally, since a wrong brand and a right one\n  // are byte-identical in shape.\n  return [\n    `VERIFY BRAND before placing any of these. This matched on the string \"${domain}\", not on what the image shows — a 200 from the provider's CDN only means bytes were served, so a wrong brand's mark comes back looking exactly like a right one.`,\n    ...readBack,\n  ];\n}\n"],"mappings":";AAsDO,SAAS,WAAW,QAAwB;AACjD,QAAM,OAAO,OACV,KAAK,EACL,YAAY,EACZ,QAAQ,gBAAgB,EAAE,EAC1B,QAAQ,UAAU,EAAE,EACpB,MAAM,GAAG,EAAE,CAAC;AACf,QAAM,SAAS,QAAQ,IAAI,MAAM,GAAG,EAAE,CAAC,KAAK;AAC5C,SAAO;AACT;AAGA,SAAS,cAAc,QAAgB,UAAyB,OAAe,cAAgC;AAC7G,MAAI,SAAS,WAAW,GAAG;AACzB,WAAO;AAAA,MACL,gPAAgP,SAAS,MAAM;AAAA,IACjQ;AAAA,EACF;AACA,QAAM,WAAW,SAAS,IAAI,CAAC,SAAS,oBAAoB,KAAK,OAAO,EAAE,EAAE,KAAK,MAAM;AACvF,SAAO;AAAA,IACL,+BAA+B,QAAQ,sDAAsD,SAAS,MAAM,iFAAiF,YAAY;AAAA,IACzM;AAAA,EACF;AACF;AAEO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AACF,GAAqC;AACnC,MAAI,SAAS,WAAW,KAAK,aAAa,GAAG;AAC3C,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,QAAQ,WAAW,MAAM;AAC/B,QAAM,eACJ,WAAW,kCAAkC,MAAM;AACrD,QAAM,WAAW,cAAc,QAAQ,UAAU,OAAO,YAAY;AAEpE,MAAI,YAAY,YAAY,YAAY;AACtC,UAAM,QAAQ,WAAW,QAAQ;AACjC,UAAM,cAAc,WAAW,SAAS,KAAK,WAAW,MAAM,MAAM;AACpE,WAAO;AAAA,MACL,sDAAiD,MAAM,gCAAgC,KAAK,GAAG,WAAW,8CAA8C,KAAK,WAAW,SAAS,MAAM,4BAA4B,YAAY;AAAA,MAC/N,GAAG;AAAA,IACL;AAAA,EACF;AAEA,MAAI,YAAY,YAAY,aAAa;AACvC,UAAM,QAAQ,WAAW,SAAS,SAAS;AAC3C,WAAO;AAAA,MACL,wBAAwB,MAAM,QAAQ,KAAK,2DAAsD,KAAK;AAAA,MACtG,GAAG;AAAA,IACL;AAAA,EACF;AAEA,MAAI,YAAY,YAAY,cAAc;AACxC,WAAO;AAAA,MACL,4EAAuE,MAAM;AAAA,MAC7E,GAAG;AAAA,IACL;AAAA,EACF;AAKA,SAAO;AAAA,IACL,yEAAyE,MAAM;AAAA,IAC/E,GAAG;AAAA,EACL;AACF;","names":[]}

package/dist/chunk-J57GWTPK.js

@@ -0,0 +1,106 @@
+import {
+  apiGet
+} from "./chunk-HREWXNTO.js";
+
+// src/commands/testimonials/emptyCorpusHints.ts
+function resolveEmptyReason({
+  resultCount,
+  activeFilters,
+  sourceCount
+}) {
+  if (resultCount > 0) {
+    return null;
+  }
+  if (activeFilters.length > 0) {
+    return "filtered_out";
+  }
+  return sourceCount === 0 ? "no_corpus_connected" : "corpus_empty";
+}
+var NO_CORPUS_EXIT = "Testimonials are ingested from the client's public review pages \u2014 an agent cannot write one \u2014 so no rewording will find quotes. If the user named the client's own review page (Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>` \u2014 its reviews arrive over the next minutes, not in this turn. Stop searching and source proof another way: a result or case study the client already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. Otherwise ship without a testimonial block and file the gap: `baker actions create --name \"Collect customer quotes for <page>\" --priority medium --tags <slug>`. Never invent, paraphrase-into-existence, or pad with unrelated praise.";
+function emptyReasonDetail(reason, sourceCount, activeFilters) {
+  if (reason === "filtered_out") {
+    return `No rows matched, and ${activeFilters.join(", ")} narrowed this read. The corpus was not checked \u2014 drop every filter to see whether the library itself is empty.`;
+  }
+  if (reason === "no_corpus_connected") {
+    return "This company has no review source connected \u2014 checked against its source list, not inferred from the empty result.";
+  }
+  return `${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but hold no testimonials yet \u2014 the source is there, the rows are not. Ingestion may still be running.`;
+}
+function morePagesHint(resultCount, cursor) {
+  const found = resultCount === 0 ? "This page held no matches" : `This page held ${resultCount}`;
+  return `${found}, and the library continues past it \u2014 so this is one page, not the client's whole set. Do not report it as the corpus and do not conclude anything is missing from it. Read the next page with \`baker testimonials list --cursor ${cursor}\` (same filters), or go straight at the rows you want with \`baker testimonials search <query>\`.`;
+}
+function endOfWalkHint(command) {
+  const noun = command === "search" ? "results" : "rows";
+  return `That was the end of the library \u2014 no more ${noun} past the page before this one. Nothing here says the corpus is empty (the earlier pages held it), so answer from what those pages returned rather than re-reading.`;
+}
+async function measureEmptyCorpus({
+  command,
+  resultCount,
+  activeFilters,
+  nextCursor = null,
+  continued = false
+}) {
+  if (nextCursor) {
+    return { hints: [morePagesHint(resultCount, nextCursor)] };
+  }
+  if (resultCount > 0) {
+    return { hints: [] };
+  }
+  if (continued) {
+    return { hints: [endOfWalkHint(command)] };
+  }
+  if (activeFilters.length > 0) {
+    const reason2 = "filtered_out";
+    return {
+      hints: emptyCorpusHints({ command, reason: reason2, sourceCount: 0, activeFilters }),
+      empty: { reason: reason2, detail: emptyReasonDetail(reason2, 0, activeFilters) }
+    };
+  }
+  let sourceCount;
+  try {
+    const sources = await apiGet("/api/testimonials/sources");
+    sourceCount = Array.isArray(sources) ? sources.length : 0;
+  } catch {
+    return {
+      hints: [
+        "No rows, and the check for connected review sources failed \u2014 so this is NOT evidence that the client has no reviews. Do not record an absence you could not verify. Re-run once; if it fails again, say the library could not be read rather than that it is empty."
+      ]
+    };
+  }
+  const reason = resolveEmptyReason({ resultCount, activeFilters, sourceCount });
+  if (reason === null) {
+    return { hints: [] };
+  }
+  return {
+    hints: emptyCorpusHints({ command, reason, sourceCount, activeFilters }),
+    empty: { reason, detail: emptyReasonDetail(reason, sourceCount, activeFilters) }
+  };
+}
+function emptyCorpusHints({
+  command,
+  reason,
+  sourceCount,
+  activeFilters
+}) {
+  if (reason === null) {
+    return [];
+  }
+  if (reason === "filtered_out") {
+    return [
+      `No rows \u2014 ${activeFilters.join(", ")} narrowed this. Drop every filter and re-run once before touching the query; a filter combination and an empty library look identical from here.`
+    ];
+  }
+  const lead = command === "search" ? "No hits" : "No rows";
+  if (reason === "no_corpus_connected") {
+    return [`${lead}, and this company's source list is empty: there is no review corpus to search. ${NO_CORPUS_EXIT}`];
+  }
+  return [
+    `${lead}. ${sourceCount} review source${sourceCount === 1 ? " is" : "s are"} connected but no testimonials have landed yet \u2014 so this is a timing or ingestion gap, not a missing connection, and re-querying will not change it. Ingestion may still be running: say so rather than reporting the client has no reviews. ${NO_CORPUS_EXIT}`
+  ];
+}
+
+export {
+  measureEmptyCorpus
+};
+//# sourceMappingURL=chunk-J57GWTPK.js.map

package/dist/chunk-J57GWTPK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/testimonials/emptyCorpusHints.ts"],"sourcesContent":["/**\n * Zero-result steering for the testimonial corpus.\n *\n * A bare `[]` reads as \"my query missed\" and the agent re-queries — three calls\n * to prove the same thing, in an audited run. It almost never means that here:\n * testimonials are ingested from the client's Google/Trustpilot reviews and an\n * agent cannot create one, so an empty library is a dead end no rewording opens.\n *\n * This module used to *assert* which of those it was, from `resultCount === 0`\n * alone: an unfiltered browse returning nothing was declared \"proof\" that the\n * company had no review corpus connected. It was never checked, and a company\n * with a connected source that simply holds no rows yet got told, confidently,\n * that it had no source at all. An agent then wrote that into the client's\n * knowledge vault as fact.\n *\n * So the reason is now measured against `GET /api/testimonials/sources` before\n * anything is claimed. `resolveEmptyReason` is the whole of that judgement and\n * is kept pure so it can be tested without a backend.\n */\n\nimport { apiGet } from \"../../client.ts\";\nimport type { EmptyEvidence } from \"../../output.ts\";\n\nexport type TestimonialQuery = \"search\" | \"list\";\n\n/**\n * Why a read came back empty.\n *\n * - `filtered_out`       — filters were applied; the corpus may be fine.\n * - `no_corpus_connected` — the company has no review source at all. Terminal.\n * - `corpus_empty`       — a source exists but holds no rows yet (still\n *                          ingesting, or the source genuinely has no reviews).\n */\nexport type EmptyCorpusReason = \"no_corpus_connected\" | \"corpus_empty\" | \"filtered_out\";\n\ninterface ResolveInput {\n  resultCount: number;\n  activeFilters: string[];\n  /** Rows from /api/testimonials/sources. */\n  sourceCount: number;\n}\n\nexport function resolveEmptyReason({\n  resultCount,\n  activeFilters,\n  sourceCount,\n}: ResolveInput): EmptyCorpusReason | null {\n  if (resultCount > 0) {\n    return null;\n  }\n  // Filters first: they explain the empty result without saying anything about\n  // the corpus, and a filter combination and an empty library look identical\n  // from the result set alone.\n  if (activeFilters.length > 0) {\n    return \"filtered_out\";\n  }\n  return sourceCount === 0 ? \"no_corpus_connected\" : \"corpus_empty\";\n}\n\nconst NO_CORPUS_EXIT =\n  \"Testimonials are ingested from the client's public review pages — an agent cannot write one — so no \" +\n  \"rewording will find quotes. If the user named the client's own review page (Google Maps, Trustpilot, Yelp, \" +\n  \"Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>` \" +\n  \"— its reviews arrive over the next minutes, not in this turn. Stop searching and source proof another way: a result or case study the client \" +\n  \"already published, a named-customer logo (`baker images logo`), or a founder claim attributed as a claim. \" +\n  \"Otherwise ship without a testimonial block and file the gap: `baker actions create \" +\n  '--name \"Collect customer quotes for <page>\" --priority medium --tags <slug>`. ' +\n  \"Never invent, paraphrase-into-existence, or pad with unrelated praise.\";\n\n/**\n * `detail` is written to be quotable — it ends up in `meta.empty.detail`, and\n * an agent that repeats it verbatim should still be saying something true.\n */\nexport function emptyReasonDetail(reason: EmptyCorpusReason, sourceCount: number, activeFilters: string[]): string {\n  if (reason === \"filtered_out\") {\n    return `No rows matched, and ${activeFilters.join(\", \")} narrowed this read. The corpus was not checked — drop every filter to see whether the library itself is empty.`;\n  }\n  if (reason === \"no_corpus_connected\") {\n    return \"This company has no review source connected — checked against its source list, not inferred from the empty result.\";\n  }\n  return `${sourceCount} review source${sourceCount === 1 ? \" is\" : \"s are\"} connected but hold no testimonials yet — the source is there, the rows are not. Ingestion may still be running.`;\n}\n\n/**\n * What to say when the library did not end where this page did.\n *\n * `GET /api/testimonials` is paged — a testimonial row carries a 3072-float\n * embedding, so a listing reads an index page at a time and returns\n * `X-Baker-Next-Cursor` when rows remain unexamined. Until that cursor comes\n * back absent, every conclusion this module otherwise draws is off the table: an\n * empty page proves nothing about the corpus, and a short one is not \"all there\n * is\". The next call is a `--cursor` away, so the hint says exactly that.\n */\nexport function morePagesHint(resultCount: number, cursor: string): string {\n  const found = resultCount === 0 ? \"This page held no matches\" : `This page held ${resultCount}`;\n  return (\n    `${found}, and the library continues past it — so this is one page, not the client's whole set. ` +\n    \"Do not report it as the corpus and do not conclude anything is missing from it. Read the next page with \" +\n    `\\`baker testimonials list --cursor ${cursor}\\` (same filters), or go straight at the rows you want with ` +\n    \"`baker testimonials search <query>`.\"\n  );\n}\n\n/** The last page of a walk came back empty: the read is over, and it worked. */\nfunction endOfWalkHint(command: TestimonialQuery): string {\n  const noun = command === \"search\" ? \"results\" : \"rows\";\n  return (\n    `That was the end of the library — no more ${noun} past the page before this one. Nothing here says the ` +\n    \"corpus is empty (the earlier pages held it), so answer from what those pages returned rather than re-reading.\"\n  );\n}\n\n/**\n * Establishes why a read was empty, by asking the backend rather than inferring.\n *\n * Costs one extra round trip and only on the zero-result path, which is the\n * cheap half of the trade: the call it replaces was the agent re-querying two or\n * three times to convince itself, and the claim it replaces was sometimes wrong.\n *\n * If the source check itself fails we return nothing at all. That is the point\n * of the change — a read that did not happen must never become a confident\n * statement about the client's account, which is exactly the failure this\n * module previously shipped.\n */\nexport async function measureEmptyCorpus({\n  command,\n  resultCount,\n  activeFilters,\n  nextCursor = null,\n  continued = false,\n}: {\n  command: TestimonialQuery;\n  resultCount: number;\n  activeFilters: string[];\n  /** `X-Baker-Next-Cursor` from the response — see `morePagesHint`. */\n  nextCursor?: string | null;\n  /** This call passed a `--cursor`, so it is the tail of a walk, not a read. */\n  continued?: boolean;\n}): Promise<{ hints: string[]; empty?: EmptyEvidence }> {\n  // A page that is not the last page establishes nothing about the corpus, so\n  // it gets a hint and no `empty` evidence — the same rule as a failed source\n  // check below. It is also the one path that speaks when rows came back:\n  // \"here are 4\" is the misleading half.\n  if (nextCursor) {\n    return { hints: [morePagesHint(resultCount, nextCursor)] };\n  }\n  if (resultCount > 0) {\n    return { hints: [] };\n  }\n  // Zero rows at the end of a walk is the walk ending — the rows were on the\n  // pages already read. Measuring the corpus here would answer a question\n  // nobody asked and, worse, answer it wrongly: a page can end exactly on the\n  // last row (the page cap closes it with `isDone` still false), so a library\n  // that was fully read hands back one final empty page, and `corpus_empty`\n  // would report a company with reviews as having none.\n  if (continued) {\n    return { hints: [endOfWalkHint(command)] };\n  }\n  if (activeFilters.length > 0) {\n    // Filters alone explain it; no need to spend a call on the corpus.\n    const reason = \"filtered_out\" as const;\n    return {\n      hints: emptyCorpusHints({ command, reason, sourceCount: 0, activeFilters }),\n      empty: { reason, detail: emptyReasonDetail(reason, 0, activeFilters) },\n    };\n  }\n\n  let sourceCount: number;\n  try {\n    const sources = await apiGet<unknown[]>(\"/api/testimonials/sources\");\n    sourceCount = Array.isArray(sources) ? sources.length : 0;\n  } catch {\n    return {\n      hints: [\n        \"No rows, and the check for connected review sources failed — so this is NOT evidence that the client \" +\n          \"has no reviews. Do not record an absence you could not verify. Re-run once; if it fails again, say \" +\n          \"the library could not be read rather than that it is empty.\",\n      ],\n    };\n  }\n\n  const reason = resolveEmptyReason({ resultCount, activeFilters, sourceCount });\n  if (reason === null) {\n    return { hints: [] };\n  }\n  return {\n    hints: emptyCorpusHints({ command, reason, sourceCount, activeFilters }),\n    empty: { reason, detail: emptyReasonDetail(reason, sourceCount, activeFilters) },\n  };\n}\n\nexport function emptyCorpusHints({\n  command,\n  reason,\n  sourceCount,\n  activeFilters,\n}: {\n  command: TestimonialQuery;\n  reason: EmptyCorpusReason | null;\n  sourceCount: number;\n  activeFilters: string[];\n}): string[] {\n  if (reason === null) {\n    return [];\n  }\n  if (reason === \"filtered_out\") {\n    return [\n      `No rows — ${activeFilters.join(\", \")} narrowed this. Drop every filter and re-run once before touching ` +\n        \"the query; a filter combination and an empty library look identical from here.\",\n    ];\n  }\n  const lead = command === \"search\" ? \"No hits\" : \"No rows\";\n  if (reason === \"no_corpus_connected\") {\n    // Terminal, and now actually verified — so it is safe to tell the agent to\n    // stop, which is the whole point of saying it.\n    return [`${lead}, and this company's source list is empty: there is no review corpus to search. ${NO_CORPUS_EXIT}`];\n  }\n  return [\n    `${lead}. ${sourceCount} review source${sourceCount === 1 ? \" is\" : \"s are\"} connected but no testimonials ` +\n      \"have landed yet — so this is a timing or ingestion gap, not a missing connection, and re-querying will not \" +\n      `change it. Ingestion may still be running: say so rather than reporting the client has no reviews. ${NO_CORPUS_EXIT}`,\n  ];\n}\n"],"mappings":";;;;;AA0CO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,MAAI,cAAc,GAAG;AACnB,WAAO;AAAA,EACT;AAIA,MAAI,cAAc,SAAS,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,gBAAgB,IAAI,wBAAwB;AACrD;AAEA,IAAM,iBACJ;AAaK,SAAS,kBAAkB,QAA2B,aAAqB,eAAiC;AACjH,MAAI,WAAW,gBAAgB;AAC7B,WAAO,wBAAwB,cAAc,KAAK,IAAI,CAAC;AAAA,EACzD;AACA,MAAI,WAAW,uBAAuB;AACpC,WAAO;AAAA,EACT;AACA,SAAO,GAAG,WAAW,iBAAiB,gBAAgB,IAAI,QAAQ,OAAO;AAC3E;AAYO,SAAS,cAAc,aAAqB,QAAwB;AACzE,QAAM,QAAQ,gBAAgB,IAAI,8BAA8B,kBAAkB,WAAW;AAC7F,SACE,GAAG,KAAK,0OAE8B,MAAM;AAGhD;AAGA,SAAS,cAAc,SAAmC;AACxD,QAAM,OAAO,YAAY,WAAW,YAAY;AAChD,SACE,kDAA6C,IAAI;AAGrD;AAcA,eAAsB,mBAAmB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb,YAAY;AACd,GAQwD;AAKtD,MAAI,YAAY;AACd,WAAO,EAAE,OAAO,CAAC,cAAc,aAAa,UAAU,CAAC,EAAE;AAAA,EAC3D;AACA,MAAI,cAAc,GAAG;AACnB,WAAO,EAAE,OAAO,CAAC,EAAE;AAAA,EACrB;AAOA,MAAI,WAAW;AACb,WAAO,EAAE,OAAO,CAAC,cAAc,OAAO,CAAC,EAAE;AAAA,EAC3C;AACA,MAAI,cAAc,SAAS,GAAG;AAE5B,UAAMA,UAAS;AACf,WAAO;AAAA,MACL,OAAO,iBAAiB,EAAE,SAAS,QAAAA,SAAQ,aAAa,GAAG,cAAc,CAAC;AAAA,MAC1E,OAAO,EAAE,QAAAA,SAAQ,QAAQ,kBAAkBA,SAAQ,GAAG,aAAa,EAAE;AAAA,IACvE;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,UAAM,UAAU,MAAM,OAAkB,2BAA2B;AACnE,kBAAc,MAAM,QAAQ,OAAO,IAAI,QAAQ,SAAS;AAAA,EAC1D,QAAQ;AACN,WAAO;AAAA,MACL,OAAO;AAAA,QACL;AAAA,MAGF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,mBAAmB,EAAE,aAAa,eAAe,YAAY,CAAC;AAC7E,MAAI,WAAW,MAAM;AACnB,WAAO,EAAE,OAAO,CAAC,EAAE;AAAA,EACrB;AACA,SAAO;AAAA,IACL,OAAO,iBAAiB,EAAE,SAAS,QAAQ,aAAa,cAAc,CAAC;AAAA,IACvE,OAAO,EAAE,QAAQ,QAAQ,kBAAkB,QAAQ,aAAa,aAAa,EAAE;AAAA,EACjF;AACF;AAEO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKa;AACX,MAAI,WAAW,MAAM;AACnB,WAAO,CAAC;AAAA,EACV;AACA,MAAI,WAAW,gBAAgB;AAC7B,WAAO;AAAA,MACL,kBAAa,cAAc,KAAK,IAAI,CAAC;AAAA,IAEvC;AAAA,EACF;AACA,QAAM,OAAO,YAAY,WAAW,YAAY;AAChD,MAAI,WAAW,uBAAuB;AAGpC,WAAO,CAAC,GAAG,IAAI,mFAAmF,cAAc,EAAE;AAAA,EACpH;AACA,SAAO;AAAA,IACL,GAAG,IAAI,KAAK,WAAW,iBAAiB,gBAAgB,IAAI,QAAQ,OAAO,qPAE6B,cAAc;AAAA,EACxH;AACF;","names":["reason"]}

package/dist/chunk-JPK34QPS.js

@@ -0,0 +1,134 @@
+// src/commands/ads/field-descriptions.ts
+var FIELD_DESCRIPTIONS = {
+  // Customer
+  "customer.id": "Google Ads account ID",
+  "customer.descriptive_name": "Account display name",
+  "customer.currency_code": "Account currency (e.g. USD, EUR)",
+  "customer.time_zone": "Account timezone (e.g. America/New_York)",
+  // Campaign
+  "campaign.id": "Unique campaign identifier",
+  "campaign.name": "Campaign display name",
+  "campaign.status": "ENABLED, PAUSED, or REMOVED",
+  "campaign.advertising_channel_type": "Campaign type: SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX, DEMAND_GEN",
+  "campaign.bidding_strategy_type": "Bidding strategy (TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, etc.)",
+  "campaign.primary_status": "Whether the campaign can serve: ELIGIBLE, PAUSED, REMOVED, ENDED, PENDING, MISCONFIGURED, LIMITED, LEARNING, NOT_ELIGIBLE. Unlike the keyword equivalent, LIMITED is a real value here \u2014 but Google publishes no reason-to-status mapping, so decide 'Limited by budget' from primary_status_reasons, not from this field.",
+  "campaign.primary_status_reasons": "Why the campaign is limited or not serving (repeated field \u2014 an array). BUDGET_CONSTRAINED is 'Limited by budget'; BUDGET_MISCONFIGURED is a broken budget setting, not a cap. Since 17 Aug 2026 a budget-limited campaign on a target-based strategy delivers toward its target instead of toward its recent actual cost, so BUDGET_CONSTRAINED is the flag that says a target above actual now costs money. BIDDING_STRATEGY_LEARNING means the bidding system is still adjusting to a change.",
+  "campaign.target_cpa.target_cpa_micros": "Target CPA in micros on a standalone Target CPA strategy",
+  "campaign.maximize_conversions.target_cpa_micros": "Target CPA in micros when the target is held inside a Maximize Conversions strategy \u2014 the shape Google uses on Search",
+  "campaign.target_roas.target_roas": "Target ROAS as a ratio (2.5 = 250%) on a standalone Target ROAS strategy",
+  "campaign.maximize_conversion_value.target_roas": "Target ROAS as a ratio when held inside a Maximize Conversion Value strategy",
+  "campaign.target_cpc.target_cpc_micros": "Target CPC in micros on a Demand Gen Target CPC strategy. Governed by the same August 2026 change as Target CPA/ROAS: on a budget-limited campaign it is what delivery moves toward, not a ceiling.",
+  "ad_group.target_cpc_micros": "Ad-group override of the campaign's Demand Gen target CPC, in micros",
+  "campaign.start_date": "Campaign start date (YYYY-MM-DD)",
+  "campaign.end_date": "Campaign end date (YYYY-MM-DD), blank if ongoing",
+  // Campaign budget
+  "campaign_budget.amount_micros": "Daily budget in micros (\xF7 1,000,000 for actual currency)",
+  // Ad group
+  "ad_group.id": "Unique ad group identifier",
+  "ad_group.name": "Ad group display name",
+  "ad_group.status": "ENABLED, PAUSED, or REMOVED",
+  "ad_group.type": "Ad group type (SEARCH_STANDARD, DISPLAY_STANDARD, etc.)",
+  // Ad group ad
+  "ad_group_ad.ad.id": "Unique ad identifier",
+  "ad_group_ad.ad.final_urls": "Landing page URLs (array)",
+  "ad_group_ad.ad.type": "Ad format (RESPONSIVE_SEARCH_AD, etc.)",
+  "ad_group_ad.status": "ENABLED, PAUSED, or REMOVED",
+  "ad_group_ad.ad.responsive_search_ad.headlines": "Ad headline variations (array)",
+  "ad_group_ad.ad.responsive_search_ad.descriptions": "Ad description variations (array)",
+  // Keywords
+  "ad_group_criterion.criterion_id": "Keyword criterion id \u2014 derived from text + match type, so every copy of the same keyword across ad groups shares it. Pair with ad_group.id to identify one copy (writes take customers/<cid>/adGroupCriteria/<adGroupId>~<criterionId>)",
+  "ad_group_criterion.keyword.text": "The keyword text",
+  "ad_group_criterion.keyword.match_type": "EXACT, PHRASE, or BROAD",
+  "ad_group_criterion.status": "ENABLED, PAUSED, or REMOVED",
+  "ad_group_criterion.quality_info.quality_score": "Quality score 1-10 (higher is better)",
+  "ad_group_criterion.quality_info.creative_quality_score": "Ad relevance bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE",
+  "ad_group_criterion.quality_info.post_click_quality_score": "Landing page experience bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE",
+  "ad_group_criterion.quality_info.search_predicted_ctr": "Expected click-through rate bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE",
+  "ad_group_criterion.primary_status": "Whether the keyword can serve: ELIGIBLE, PAUSED, REMOVED, PENDING, NOT_ELIGIBLE. There is no LIMITED value \u2014 Google Ads' 'Eligible (Limited)' is ELIGIBLE plus a limiting entry in primary_status_reasons, so read both.",
+  "ad_group_criterion.primary_status_reasons": "Why the keyword is in that status (array). AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID and AD_GROUP_CRITERION_LOW_QUALITY are the two that render as '(Limited)'; the CAMPAIGN_*/AD_GROUP_* entries just restate a paused or removed parent.",
+  "ad_group_criterion.system_serving_status": "ELIGIBLE or RARELY_SERVED (too few searches to show)",
+  "ad_group_criterion.approval_status": "Ad-approval state: APPROVED, DISAPPROVED, PENDING_REVIEW, UNDER_REVIEW",
+  "ad_group_criterion.disapproval_reasons": "Policy reasons the keyword was disapproved (array)",
+  "ad_group_criterion.cpc_bid_micros": "Max CPC bid set on this keyword, in micros (\xF7 1,000,000)",
+  "ad_group_criterion.effective_cpc_bid_micros": "Max CPC actually in force, in micros (\xF7 1,000,000) \u2014 the keyword's own bid, or the ad group's when the keyword has none",
+  "ad_group_criterion.effective_cpc_bid_source": "Where the effective max CPC comes from: ADGROUP, CRITERION, or CAMPAIGN_BIDDING_STRATEGY",
+  "ad_group_criterion.position_estimates.first_page_cpc_micros": "Bid estimated to reach the first page of results, in micros (\xF7 1,000,000). The number in Google Ads' 'Below first page bid (\u20AC3.63)' label \u2014 compare it against effective_cpc_bid_micros.",
+  "ad_group_criterion.position_estimates.top_of_page_cpc_micros": "Bid estimated to reach the top of the first page, in micros (\xF7 1,000,000)",
+  "ad_group_criterion.position_estimates.first_position_cpc_micros": "Bid estimated to reach the first ad position, in micros (\xF7 1,000,000)",
+  // Search terms
+  "search_term_view.search_term": "Actual user search query that triggered the ad",
+  "search_term_view.status": "Whether the search term is added, excluded, or none",
+  // Metrics
+  "metrics.impressions": "Times ads were shown (integer)",
+  "metrics.clicks": "Total clicks (integer)",
+  "metrics.cost_micros": "Total cost in micros (\xF7 1,000,000 for actual currency). Use 'currency' command for account currency.",
+  "metrics.cost": "Total cost in actual currency (already converted from micros)",
+  "metrics.conversions": "Conversion count (can be fractional from attribution models)",
+  "metrics.conversions_value": "Revenue from conversions in actual currency",
+  "metrics.all_conversions": "All conversions including view-through",
+  "metrics.all_conversions_value": "Total attributed revenue including view-through",
+  "metrics.ctr": "Click-through rate as decimal (0.05 = 5%)",
+  "metrics.average_cpc": "Average cost per click in micros (\xF7 1,000,000)",
+  "metrics.average_cpm": "Average cost per 1000 impressions in micros (\xF7 1,000,000)",
+  "metrics.search_impression_share": "Impression share as decimal (0.0\u20131.0)",
+  "metrics.search_budget_lost_impression_share": "Share of impressions lost because the budget ran out, as a decimal (0.0\u20131.0). The corroborating signal for a 'Limited by budget' campaign \u2014 a high value here alongside a target above actual cost per conversion is the combination that now raises spend.",
+  "metrics.cost_per_conversion": "Actual cost per conversion in micros (\xF7 1,000,000) \u2014 compare against the campaign's target",
+  "metrics.interaction_rate": "Interaction rate as decimal",
+  "metrics.video_views": "Total video views (integer)",
+  "metrics.video_view_rate": "Video view rate as decimal",
+  // Segments
+  "segments.date": "Date (YYYY-MM-DD format)",
+  "segments.device": "DESKTOP, MOBILE, TABLET, or OTHER",
+  "segments.day_of_week": "Day of week (MONDAY, TUESDAY, etc.)",
+  "segments.ad_network_type": "Network: SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, etc.",
+  "segments.product_title": "Shopping product title",
+  "segments.product_item_id": "Shopping product ID",
+  "segments.product_brand": "Shopping product brand",
+  "segments.product_type_l1": "Shopping product type (level 1)",
+  // Assets
+  "asset.type": "Asset type: IMAGE, YOUTUBE_VIDEO, TEXT, LEAD_FORM, etc.",
+  "asset.text_asset.text": "Text asset content",
+  "asset.image_asset.full_size.url": "Full-size image URL",
+  "asset.youtube_video_asset.youtube_video_id": "YouTube video ID",
+  "asset.youtube_video_asset.youtube_video_title": "YouTube video title",
+  "asset_group.name": "Asset group display name",
+  "asset_group.status": "ENABLED, PAUSED, or REMOVED",
+  "asset_group_asset.field_type": "Where the asset is used (HEADLINE, DESCRIPTION, LOGO, etc.)",
+  "asset_group_asset.primary_status": "Whether the asset serves: ELIGIBLE, LIMITED, NOT_ELIGIBLE, PAUSED, REMOVED, PENDING",
+  "asset_group_asset.primary_status_reasons": "Why the asset is not fully serving (policy, pending review, paused parent \u2026)",
+  // Change events (field-level detail, last 30 days)
+  "change_event.change_date_time": "When the change occurred (ISO 8601)",
+  "change_event.change_resource_type": "What was changed: CAMPAIGN, AD_GROUP, AD, etc.",
+  "change_event.resource_change_operation": "CREATE, UPDATE, or REMOVE",
+  "change_event.user_email": "Email of user who made the change",
+  // Change status (which resources changed, last 90 days — no values, no user)
+  "change_status.last_change_date_time": "When this resource last changed (ISO 8601)",
+  "change_status.resource_type": "What changed: CAMPAIGN, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION, etc.",
+  "change_status.resource_status": "ADDED, CHANGED, or REMOVED \u2014 not the old or new value",
+  "change_status.resource_name": "Identifier of the changed resource; query it to read its current values",
+  "change_status.campaign": "Resource name of the campaign the change belongs to",
+  "change_status.ad_group": "Resource name of the ad group the change belongs to",
+  "change_status.ad_group_ad": "Resource name of the changed ad",
+  "change_status.ad_group_criterion": "Resource name of the changed keyword or criterion",
+  "change_status.campaign_criterion": "Resource name of the changed campaign-level criterion",
+  // Landing pages
+  "landing_page_view.unexpanded_final_url": "Landing page URL",
+  // Geo
+  "geo_target_constant.name": "Geographic location name",
+  "geo_target_constant.resource_name": "Geo target resource identifier"
+};
+function getFieldDescriptions(fields) {
+  const result = {};
+  for (const field of fields) {
+    const desc = FIELD_DESCRIPTIONS[field];
+    if (desc) {
+      result[field] = desc;
+    }
+  }
+  return result;
+}
+
+export {
+  getFieldDescriptions
+};
+//# sourceMappingURL=chunk-JPK34QPS.js.map

package/dist/chunk-JPK34QPS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/field-descriptions.ts"],"sourcesContent":["const FIELD_DESCRIPTIONS: Record<string, string> = {\n  // Customer\n  \"customer.id\": \"Google Ads account ID\",\n  \"customer.descriptive_name\": \"Account display name\",\n  \"customer.currency_code\": \"Account currency (e.g. USD, EUR)\",\n  \"customer.time_zone\": \"Account timezone (e.g. America/New_York)\",\n\n  // Campaign\n  \"campaign.id\": \"Unique campaign identifier\",\n  \"campaign.name\": \"Campaign display name\",\n  \"campaign.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"campaign.advertising_channel_type\": \"Campaign type: SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX, DEMAND_GEN\",\n  \"campaign.bidding_strategy_type\": \"Bidding strategy (TARGET_CPA, TARGET_ROAS, MAXIMIZE_CONVERSIONS, etc.)\",\n  \"campaign.primary_status\":\n    \"Whether the campaign can serve: ELIGIBLE, PAUSED, REMOVED, ENDED, PENDING, MISCONFIGURED, LIMITED, LEARNING, NOT_ELIGIBLE. Unlike the keyword equivalent, LIMITED is a real value here — but Google publishes no reason-to-status mapping, so decide 'Limited by budget' from primary_status_reasons, not from this field.\",\n  \"campaign.primary_status_reasons\":\n    \"Why the campaign is limited or not serving (repeated field — an array). BUDGET_CONSTRAINED is 'Limited by budget'; BUDGET_MISCONFIGURED is a broken budget setting, not a cap. Since 17 Aug 2026 a budget-limited campaign on a target-based strategy delivers toward its target instead of toward its recent actual cost, so BUDGET_CONSTRAINED is the flag that says a target above actual now costs money. BIDDING_STRATEGY_LEARNING means the bidding system is still adjusting to a change.\",\n  \"campaign.target_cpa.target_cpa_micros\": \"Target CPA in micros on a standalone Target CPA strategy\",\n  \"campaign.maximize_conversions.target_cpa_micros\":\n    \"Target CPA in micros when the target is held inside a Maximize Conversions strategy — the shape Google uses on Search\",\n  \"campaign.target_roas.target_roas\": \"Target ROAS as a ratio (2.5 = 250%) on a standalone Target ROAS strategy\",\n  \"campaign.maximize_conversion_value.target_roas\":\n    \"Target ROAS as a ratio when held inside a Maximize Conversion Value strategy\",\n  \"campaign.target_cpc.target_cpc_micros\":\n    \"Target CPC in micros on a Demand Gen Target CPC strategy. Governed by the same August 2026 change as Target CPA/ROAS: on a budget-limited campaign it is what delivery moves toward, not a ceiling.\",\n  \"ad_group.target_cpc_micros\": \"Ad-group override of the campaign's Demand Gen target CPC, in micros\",\n  \"campaign.start_date\": \"Campaign start date (YYYY-MM-DD)\",\n  \"campaign.end_date\": \"Campaign end date (YYYY-MM-DD), blank if ongoing\",\n\n  // Campaign budget\n  \"campaign_budget.amount_micros\": \"Daily budget in micros (÷ 1,000,000 for actual currency)\",\n\n  // Ad group\n  \"ad_group.id\": \"Unique ad group identifier\",\n  \"ad_group.name\": \"Ad group display name\",\n  \"ad_group.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"ad_group.type\": \"Ad group type (SEARCH_STANDARD, DISPLAY_STANDARD, etc.)\",\n\n  // Ad group ad\n  \"ad_group_ad.ad.id\": \"Unique ad identifier\",\n  \"ad_group_ad.ad.final_urls\": \"Landing page URLs (array)\",\n  \"ad_group_ad.ad.type\": \"Ad format (RESPONSIVE_SEARCH_AD, etc.)\",\n  \"ad_group_ad.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"ad_group_ad.ad.responsive_search_ad.headlines\": \"Ad headline variations (array)\",\n  \"ad_group_ad.ad.responsive_search_ad.descriptions\": \"Ad description variations (array)\",\n\n  // Keywords\n  \"ad_group_criterion.criterion_id\":\n    \"Keyword criterion id — derived from text + match type, so every copy of the same keyword across ad groups shares it. Pair with ad_group.id to identify one copy (writes take customers/<cid>/adGroupCriteria/<adGroupId>~<criterionId>)\",\n  \"ad_group_criterion.keyword.text\": \"The keyword text\",\n  \"ad_group_criterion.keyword.match_type\": \"EXACT, PHRASE, or BROAD\",\n  \"ad_group_criterion.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"ad_group_criterion.quality_info.quality_score\": \"Quality score 1-10 (higher is better)\",\n  \"ad_group_criterion.quality_info.creative_quality_score\":\n    \"Ad relevance bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE\",\n  \"ad_group_criterion.quality_info.post_click_quality_score\":\n    \"Landing page experience bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE\",\n  \"ad_group_criterion.quality_info.search_predicted_ctr\":\n    \"Expected click-through rate bucket: ABOVE_AVERAGE, AVERAGE, BELOW_AVERAGE\",\n  \"ad_group_criterion.primary_status\":\n    \"Whether the keyword can serve: ELIGIBLE, PAUSED, REMOVED, PENDING, NOT_ELIGIBLE. There is no LIMITED value — Google Ads' 'Eligible (Limited)' is ELIGIBLE plus a limiting entry in primary_status_reasons, so read both.\",\n  \"ad_group_criterion.primary_status_reasons\":\n    \"Why the keyword is in that status (array). AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID and AD_GROUP_CRITERION_LOW_QUALITY are the two that render as '(Limited)'; the CAMPAIGN_*/AD_GROUP_* entries just restate a paused or removed parent.\",\n  \"ad_group_criterion.system_serving_status\": \"ELIGIBLE or RARELY_SERVED (too few searches to show)\",\n  \"ad_group_criterion.approval_status\": \"Ad-approval state: APPROVED, DISAPPROVED, PENDING_REVIEW, UNDER_REVIEW\",\n  \"ad_group_criterion.disapproval_reasons\": \"Policy reasons the keyword was disapproved (array)\",\n  \"ad_group_criterion.cpc_bid_micros\": \"Max CPC bid set on this keyword, in micros (÷ 1,000,000)\",\n  \"ad_group_criterion.effective_cpc_bid_micros\":\n    \"Max CPC actually in force, in micros (÷ 1,000,000) — the keyword's own bid, or the ad group's when the keyword has none\",\n  \"ad_group_criterion.effective_cpc_bid_source\":\n    \"Where the effective max CPC comes from: ADGROUP, CRITERION, or CAMPAIGN_BIDDING_STRATEGY\",\n  \"ad_group_criterion.position_estimates.first_page_cpc_micros\":\n    \"Bid estimated to reach the first page of results, in micros (÷ 1,000,000). The number in Google Ads' 'Below first page bid (€3.63)' label — compare it against effective_cpc_bid_micros.\",\n  \"ad_group_criterion.position_estimates.top_of_page_cpc_micros\":\n    \"Bid estimated to reach the top of the first page, in micros (÷ 1,000,000)\",\n  \"ad_group_criterion.position_estimates.first_position_cpc_micros\":\n    \"Bid estimated to reach the first ad position, in micros (÷ 1,000,000)\",\n\n  // Search terms\n  \"search_term_view.search_term\": \"Actual user search query that triggered the ad\",\n  \"search_term_view.status\": \"Whether the search term is added, excluded, or none\",\n\n  // Metrics\n  \"metrics.impressions\": \"Times ads were shown (integer)\",\n  \"metrics.clicks\": \"Total clicks (integer)\",\n  \"metrics.cost_micros\":\n    \"Total cost in micros (÷ 1,000,000 for actual currency). Use 'currency' command for account currency.\",\n  \"metrics.cost\": \"Total cost in actual currency (already converted from micros)\",\n  \"metrics.conversions\": \"Conversion count (can be fractional from attribution models)\",\n  \"metrics.conversions_value\": \"Revenue from conversions in actual currency\",\n  \"metrics.all_conversions\": \"All conversions including view-through\",\n  \"metrics.all_conversions_value\": \"Total attributed revenue including view-through\",\n  \"metrics.ctr\": \"Click-through rate as decimal (0.05 = 5%)\",\n  \"metrics.average_cpc\": \"Average cost per click in micros (÷ 1,000,000)\",\n  \"metrics.average_cpm\": \"Average cost per 1000 impressions in micros (÷ 1,000,000)\",\n  \"metrics.search_impression_share\": \"Impression share as decimal (0.0–1.0)\",\n  \"metrics.search_budget_lost_impression_share\":\n    \"Share of impressions lost because the budget ran out, as a decimal (0.0–1.0). The corroborating signal for a 'Limited by budget' campaign — a high value here alongside a target above actual cost per conversion is the combination that now raises spend.\",\n  \"metrics.cost_per_conversion\":\n    \"Actual cost per conversion in micros (÷ 1,000,000) — compare against the campaign's target\",\n  \"metrics.interaction_rate\": \"Interaction rate as decimal\",\n  \"metrics.video_views\": \"Total video views (integer)\",\n  \"metrics.video_view_rate\": \"Video view rate as decimal\",\n\n  // Segments\n  \"segments.date\": \"Date (YYYY-MM-DD format)\",\n  \"segments.device\": \"DESKTOP, MOBILE, TABLET, or OTHER\",\n  \"segments.day_of_week\": \"Day of week (MONDAY, TUESDAY, etc.)\",\n  \"segments.ad_network_type\": \"Network: SEARCH, SEARCH_PARTNERS, CONTENT, YOUTUBE_SEARCH, etc.\",\n  \"segments.product_title\": \"Shopping product title\",\n  \"segments.product_item_id\": \"Shopping product ID\",\n  \"segments.product_brand\": \"Shopping product brand\",\n  \"segments.product_type_l1\": \"Shopping product type (level 1)\",\n\n  // Assets\n  \"asset.type\": \"Asset type: IMAGE, YOUTUBE_VIDEO, TEXT, LEAD_FORM, etc.\",\n  \"asset.text_asset.text\": \"Text asset content\",\n  \"asset.image_asset.full_size.url\": \"Full-size image URL\",\n  \"asset.youtube_video_asset.youtube_video_id\": \"YouTube video ID\",\n  \"asset.youtube_video_asset.youtube_video_title\": \"YouTube video title\",\n  \"asset_group.name\": \"Asset group display name\",\n  \"asset_group.status\": \"ENABLED, PAUSED, or REMOVED\",\n  \"asset_group_asset.field_type\": \"Where the asset is used (HEADLINE, DESCRIPTION, LOGO, etc.)\",\n  \"asset_group_asset.primary_status\":\n    \"Whether the asset serves: ELIGIBLE, LIMITED, NOT_ELIGIBLE, PAUSED, REMOVED, PENDING\",\n  \"asset_group_asset.primary_status_reasons\":\n    \"Why the asset is not fully serving (policy, pending review, paused parent …)\",\n\n  // Change events (field-level detail, last 30 days)\n  \"change_event.change_date_time\": \"When the change occurred (ISO 8601)\",\n  \"change_event.change_resource_type\": \"What was changed: CAMPAIGN, AD_GROUP, AD, etc.\",\n  \"change_event.resource_change_operation\": \"CREATE, UPDATE, or REMOVE\",\n  \"change_event.user_email\": \"Email of user who made the change\",\n\n  // Change status (which resources changed, last 90 days — no values, no user)\n  \"change_status.last_change_date_time\": \"When this resource last changed (ISO 8601)\",\n  \"change_status.resource_type\": \"What changed: CAMPAIGN, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION, etc.\",\n  \"change_status.resource_status\": \"ADDED, CHANGED, or REMOVED — not the old or new value\",\n  \"change_status.resource_name\": \"Identifier of the changed resource; query it to read its current values\",\n  \"change_status.campaign\": \"Resource name of the campaign the change belongs to\",\n  \"change_status.ad_group\": \"Resource name of the ad group the change belongs to\",\n  \"change_status.ad_group_ad\": \"Resource name of the changed ad\",\n  \"change_status.ad_group_criterion\": \"Resource name of the changed keyword or criterion\",\n  \"change_status.campaign_criterion\": \"Resource name of the changed campaign-level criterion\",\n\n  // Landing pages\n  \"landing_page_view.unexpanded_final_url\": \"Landing page URL\",\n\n  // Geo\n  \"geo_target_constant.name\": \"Geographic location name\",\n  \"geo_target_constant.resource_name\": \"Geo target resource identifier\",\n};\n\nexport function getFieldDescriptions(fields: string[]): Record<string, string> {\n  const result: Record<string, string> = {};\n  for (const field of fields) {\n    const desc = FIELD_DESCRIPTIONS[field];\n    if (desc) {\n      result[field] = desc;\n    }\n  }\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-JRCFCIE3.js

@@ -0,0 +1,188 @@
+import {
+  analyticsErrorEnvelope
+} from "./chunk-AFJGYJ7Z.js";
+import {
+  PEOPLE_SEARCH_MAX_TERMS,
+  parsePeopleQuery,
+  peopleLookupRequestSchema
+} from "./chunk-FYWWTMXP.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+
+// src/commands/analytics/lookup.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+function peopleArgs(args2) {
+  const parts = peopleParts(args2);
+  if (parts.length === 0) return {};
+  const people = parsePeopleQuery(parts).terms.map((term) => term.input);
+  return people.length === 0 ? {} : { people };
+}
+function peopleParts(args2) {
+  return [...args2.person ? [String(args2.person)] : [], ...args2["people-file"] ? [readPeopleFile(args2)] : []];
+}
+function readPeopleFile(args2) {
+  try {
+    return readFileSync(String(args2["people-file"]), "utf8");
+  } catch {
+    return "";
+  }
+}
+function unreadablePeopleFile(args2) {
+  if (!args2["people-file"]) return void 0;
+  const path = String(args2["people-file"]);
+  try {
+    readFileSync(path, "utf8");
+    return void 0;
+  } catch {
+    return `Couldn't read --people-file ${path}. Check the path, or pass the people inline with --person.`;
+  }
+}
+function peopleLimitError(args2) {
+  const unreadable = unreadablePeopleFile(args2);
+  if (unreadable !== void 0) return unreadable;
+  const { terms, dropped } = parsePeopleQuery(peopleParts(args2));
+  if (dropped === 0) return void 0;
+  return `${terms.length + dropped} people named; one search takes up to ${PEOPLE_SEARCH_MAX_TERMS}. Split the list and run each part.`;
+}
+function compactRow(row) {
+  const clicks = [...row.googleClick ? ["google"] : [], ...row.metaClick ? ["meta"] : []];
+  const candidates = {
+    input: row.input,
+    readAs: row.kind,
+    found: row.found,
+    problem: row.problem,
+    contacts: row.contacts,
+    events: row.events,
+    firstSeen: row.firstSeen,
+    lastSeen: row.lastSeen,
+    pageViews: row.pageViews,
+    landings: row.landings,
+    visits: row.visits,
+    formSubmits: row.formSubmits,
+    firstSource: row.firstSource,
+    systemEvents: row.systemEvents,
+    pageEvents: row.pageEvents,
+    uploads: row.uploads,
+    uploadedTo: row.uploadedTo,
+    clicks,
+    knownBy: row.knownBy
+  };
+  return Object.fromEntries(
+    Object.entries(candidates).filter(
+      ([key, value]) => key === "found" || !(value === 0 || value === "" || Array.isArray(value) && value.length === 0)
+    )
+  );
+}
+function lookupHints(data) {
+  const hints = [];
+  if (data.dropped > 0) {
+    hints.push(
+      `${data.dropped} lines past the limit of ${PEOPLE_SEARCH_MAX_TERMS} were not looked up. Run the rest separately.`
+    );
+  }
+  const unseen = data.people.filter((row) => !row.found && row.problem === "");
+  if (unseen.length > 0) {
+    hints.push(
+      `Not seen by Baker: ${unseen.map((row) => row.input).join(", ")}. Baker knows a person by what its pages, Forms and connected systems recorded \u2014 a lead that came in through a form or site Baker does not measure, or a source not connected, is not here.`
+    );
+  }
+  for (const row of data.people.filter((person) => person.problem !== "")) {
+    hints.push(`${row.input}: ${row.problem}`);
+  }
+  const found = data.people.filter((row) => row.found);
+  const neverVisited = found.filter((row) => row.pageViews === 0);
+  if (neverVisited.length > 0) {
+    hints.push(
+      `${neverVisited.length} of ${found.length} found never visited a page Baker publishes: Baker knows them only from what their systems reported, so no landing can be credited with them.`
+    );
+  }
+  if (found.length > 0) {
+    hints.push(
+      `\`baker analytics feed --person '${found[0]?.input}' --days 90\` lists everything one of them did, in order \u2014 add more, comma-separated, to follow several.`
+    );
+  }
+  return hints;
+}
+function lookupReport(data, full = false) {
+  const found = data.people.filter((row) => row.found);
+  return {
+    summary: {
+      searched: data.people.length,
+      found: found.length,
+      notFound: data.people.length - found.length,
+      visitedABakerPage: found.filter((row) => row.pageViews > 0).length
+    },
+    people: full ? data.people : data.people.map(compactRow),
+    hints: lookupHints(data)
+  };
+}
+var NO_PEOPLE = "Name at least one person: --person 'ana@empresa.com, deal:40001234567' or --people-file leads.txt.";
+var args = {
+  person: {
+    type: "string",
+    description: "The people, comma-separated: an email, a phone (+34\u2026), a HubSpot contact id, deal:<HubSpot deal id>, a gclid/fbclid, a browser id. Prefix to be exact: email:, phone:, hubspot:, deal:, gclid:, fbclid:, browser:",
+    required: false
+  },
+  "people-file": {
+    type: "string",
+    description: "A file with one person per line \u2014 a column pasted from a CRM export",
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Every field of every line, zeros included",
+    required: false
+  }
+};
+registerSchema({
+  command: "analytics.lookup",
+  description: "What Baker saw of each person in a list, by email, phone, CRM id, deal or click id",
+  args
+});
+var lookupCommand = defineCommand({
+  meta: {
+    name: "lookup",
+    description: `What Baker saw of each person in a list \u2014 all time, one line each \u2014 by whatever the client holds about them. The reconciliation question: "HubSpot says 26 leads yesterday, which of them does Baker have, and where did they come from".
+
+Start here:
+  baker analytics lookup --person 'ana@empresa.com, +34600111222, 90001234567'
+  baker analytics lookup --person 'deal:40001234567, deal:40001234568'   \u2014 HubSpot deal ids, looked up through the deal's contacts
+  baker analytics lookup --people-file leads.txt                           \u2014 one per line, up to ${PEOPLE_SEARCH_MAX_TERMS}
+
+Each line says whether Baker has them, when it first and last saw them, the pages and Forms they touched, what their systems reported (systemEvents: CRM stages, orders), what Baker uploaded for them to ad platforms, which ad click they carried, and every kind of key they are linked by. A bare number is read as a HubSpot contact id or a phone; prefix it to be exact. Emails and phones are hashed by Baker \u2014 say them to the client as they gave them, never as a hash. Follow one with \`baker analytics feed --person <same value>\`.`
+  },
+  args,
+  run: async ({ args: raw }) => {
+    const { people } = peopleArgs(raw);
+    const parsed = peopleLookupRequestSchema.safeParse({ people: people ?? [] });
+    const invalid = peopleLimitError(raw) ?? (parsed.success ? void 0 : NO_PEOPLE);
+    if (invalid !== void 0 || !parsed.success) {
+      writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message: invalid ?? NO_PEOPLE } });
+      process.exit(1);
+    }
+    try {
+      const response = await apiPost("/api/analytics/people", parsed.data);
+      const { hints, ...data } = lookupReport(response.data, raw.full === true);
+      writeJsonEnvelope({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
+    } catch (error) {
+      writeJsonEnvelope({ ok: false, error: analyticsErrorEnvelope(error) });
+      process.exit(1);
+    }
+  }
+});
+
+export {
+  peopleArgs,
+  peopleLimitError,
+  lookupReport,
+  lookupCommand
+};
+//# sourceMappingURL=chunk-JRCFCIE3.js.map

package/dist/chunk-JRCFCIE3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analytics/lookup.ts"],"sourcesContent":["/**\n * `baker analytics lookup` — what Baker saw of each person in a list.\n *\n * The question a CRM export puts to Baker: here are yesterday's leads, which\n * of them do you have and what did you see them do. One line per person, all\n * time, by whatever the reader holds — an email, a phone, a HubSpot contact or\n * deal id, a click id. The server hashes contact details and asks HubSpot whose\n * each deal is; nothing here does either.\n *\n * `baker analytics feed --person` is the same list as rows.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport {\n  PEOPLE_SEARCH_MAX_TERMS,\n  type PeopleLookupData,\n  type PeopleLookupRow,\n  parsePeopleQuery,\n  peopleLookupRequestSchema,\n} from \"@baker/api/analytics\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { analyticsErrorEnvelope } from \"./errorEnvelope.ts\";\n\n/**\n * The people `--person` and `--people-file` name, one per line of the search.\n *\n * Split here with the server's own reading of a list, so the fifty-line limit\n * is the same one on both sides and a long pasted list travels as lines, not\n * as one oversized string.\n */\nexport function peopleArgs(args: Record<string, unknown>): { people?: string[] } {\n  const parts = peopleParts(args);\n  if (parts.length === 0) return {};\n  const people = parsePeopleQuery(parts).terms.map((term) => term.input);\n  return people.length === 0 ? {} : { people };\n}\n\nfunction peopleParts(args: Record<string, unknown>): string[] {\n  return [...(args.person ? [String(args.person)] : []), ...(args[\"people-file\"] ? [readPeopleFile(args)] : [])];\n}\n\n/** `--people-file`, or `\"\"` when it cannot be read — {@link peopleLimitError} is what reports that. */\nfunction readPeopleFile(args: Record<string, unknown>): string {\n  try {\n    return readFileSync(String(args[\"people-file\"]), \"utf8\");\n  } catch {\n    return \"\";\n  }\n}\n\nfunction unreadablePeopleFile(args: Record<string, unknown>): string | undefined {\n  if (!args[\"people-file\"]) return undefined;\n  const path = String(args[\"people-file\"]);\n  try {\n    readFileSync(path, \"utf8\");\n    return undefined;\n  } catch {\n    return `Couldn't read --people-file ${path}. Check the path, or pass the people inline with --person.`;\n  }\n}\n\n/**\n * Why a list is refused, when it is longer than one search holds. Refused\n * rather than cut: fifty lines answered out of sixty read as the whole list,\n * and \"not seen by Baker\" is then silently wrong about the other ten.\n */\nexport function peopleLimitError(args: Record<string, unknown>): string | undefined {\n  const unreadable = unreadablePeopleFile(args);\n  if (unreadable !== undefined) return unreadable;\n  const { terms, dropped } = parsePeopleQuery(peopleParts(args));\n  if (dropped === 0) return undefined;\n  return `${terms.length + dropped} people named; one search takes up to ${PEOPLE_SEARCH_MAX_TERMS}. Split the list and run each part.`;\n}\n\n/** One person as an agent reads them: what was seen, with every zero and empty list left out. */\nfunction compactRow(row: PeopleLookupRow): Record<string, unknown> {\n  const clicks = [...(row.googleClick ? [\"google\"] : []), ...(row.metaClick ? [\"meta\"] : [])];\n  const candidates: Record<string, unknown> = {\n    input: row.input,\n    readAs: row.kind,\n    found: row.found,\n    problem: row.problem,\n    contacts: row.contacts,\n    events: row.events,\n    firstSeen: row.firstSeen,\n    lastSeen: row.lastSeen,\n    pageViews: row.pageViews,\n    landings: row.landings,\n    visits: row.visits,\n    formSubmits: row.formSubmits,\n    firstSource: row.firstSource,\n    systemEvents: row.systemEvents,\n    pageEvents: row.pageEvents,\n    uploads: row.uploads,\n    uploadedTo: row.uploadedTo,\n    clicks,\n    knownBy: row.knownBy,\n  };\n  return Object.fromEntries(\n    Object.entries(candidates).filter(\n      ([key, value]) =>\n        key === \"found\" || !(value === 0 || value === \"\" || (Array.isArray(value) && value.length === 0)),\n    ),\n  );\n}\n\nfunction lookupHints(data: PeopleLookupData): string[] {\n  const hints: string[] = [];\n  if (data.dropped > 0) {\n    hints.push(\n      `${data.dropped} lines past the limit of ${PEOPLE_SEARCH_MAX_TERMS} were not looked up. Run the rest separately.`,\n    );\n  }\n  const unseen = data.people.filter((row) => !row.found && row.problem === \"\");\n  if (unseen.length > 0) {\n    hints.push(\n      `Not seen by Baker: ${unseen.map((row) => row.input).join(\", \")}. Baker knows a person by what its pages, Forms and connected systems recorded — a lead that came in through a form or site Baker does not measure, or a source not connected, is not here.`,\n    );\n  }\n  for (const row of data.people.filter((person) => person.problem !== \"\")) {\n    hints.push(`${row.input}: ${row.problem}`);\n  }\n  const found = data.people.filter((row) => row.found);\n  const neverVisited = found.filter((row) => row.pageViews === 0);\n  if (neverVisited.length > 0) {\n    hints.push(\n      `${neverVisited.length} of ${found.length} found never visited a page Baker publishes: Baker knows them only from what their systems reported, so no landing can be credited with them.`,\n    );\n  }\n  if (found.length > 0) {\n    hints.push(\n      `\\`baker analytics feed --person '${found[0]?.input}' --days 90\\` lists everything one of them did, in order — add more, comma-separated, to follow several.`,\n    );\n  }\n  return hints;\n}\n\n/** The envelope's data and hints. Pure, so what an agent reads is tested without a network. */\nexport function lookupReport(data: PeopleLookupData, full = false) {\n  const found = data.people.filter((row) => row.found);\n  return {\n    summary: {\n      searched: data.people.length,\n      found: found.length,\n      notFound: data.people.length - found.length,\n      visitedABakerPage: found.filter((row) => row.pageViews > 0).length,\n    },\n    people: full ? data.people : data.people.map(compactRow),\n    hints: lookupHints(data),\n  };\n}\n\nconst NO_PEOPLE = \"Name at least one person: --person 'ana@empresa.com, deal:40001234567' or --people-file leads.txt.\";\n\nconst args = {\n  person: {\n    type: \"string\",\n    description:\n      \"The people, comma-separated: an email, a phone (+34…), a HubSpot contact id, deal:<HubSpot deal id>, a gclid/fbclid, a browser id. Prefix to be exact: email:, phone:, hubspot:, deal:, gclid:, fbclid:, browser:\",\n    required: false,\n  },\n  \"people-file\": {\n    type: \"string\",\n    description: \"A file with one person per line — a column pasted from a CRM export\",\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description: \"Every field of every line, zeros included\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"analytics.lookup\",\n  description: \"What Baker saw of each person in a list, by email, phone, CRM id, deal or click id\",\n  args,\n});\n\nexport const lookupCommand = defineCommand({\n  meta: {\n    name: \"lookup\",\n    description: `What Baker saw of each person in a list — all time, one line each — by whatever the client holds about them. The reconciliation question: \"HubSpot says 26 leads yesterday, which of them does Baker have, and where did they come from\".\n\nStart here:\n  baker analytics lookup --person 'ana@empresa.com, +34600111222, 90001234567'\n  baker analytics lookup --person 'deal:40001234567, deal:40001234568'   — HubSpot deal ids, looked up through the deal's contacts\n  baker analytics lookup --people-file leads.txt                           — one per line, up to ${PEOPLE_SEARCH_MAX_TERMS}\n\nEach line says whether Baker has them, when it first and last saw them, the pages and Forms they touched, what their systems reported (systemEvents: CRM stages, orders), what Baker uploaded for them to ad platforms, which ad click they carried, and every kind of key they are linked by. A bare number is read as a HubSpot contact id or a phone; prefix it to be exact. Emails and phones are hashed by Baker — say them to the client as they gave them, never as a hash. Follow one with \\`baker analytics feed --person <same value>\\`.`,\n  },\n  args,\n  run: async ({ args: raw }) => {\n    const { people } = peopleArgs(raw as Record<string, unknown>);\n    const parsed = peopleLookupRequestSchema.safeParse({ people: people ?? [] });\n    const invalid = peopleLimitError(raw as Record<string, unknown>) ?? (parsed.success ? undefined : NO_PEOPLE);\n    if (invalid !== undefined || !parsed.success) {\n      writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message: invalid ?? NO_PEOPLE } });\n      process.exit(1);\n    }\n    try {\n      const response = await apiPost<{ ok: true; data: PeopleLookupData }>(\"/api/analytics/people\", parsed.data);\n      const { hints, ...data } = lookupReport(response.data, raw.full === true);\n      writeJsonEnvelope({ ok: true, data, ...(hints.length > 0 ? { hints } : {}) });\n    } catch (error) {\n      writeJsonEnvelope({ ok: false, error: analyticsErrorEnvelope(error) });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":["args"]}