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

package/dist/chunk-IELPT4K2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/gsc/resolve.ts"],"sourcesContent":["import { ApiError, apiGet } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../error-handler.ts\";\nimport { cacheGet, cacheSet } from \"../ads/cache.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\n\ninterface GscSite {\n  siteUrl: string;\n  permissionLevel: string;\n}\n\nasync function fetchSites(useCache = true): Promise<GscSite[]> {\n  if (useCache) {\n    const cached = cacheGet<GscSite[]>(\"gsc-sites\", \"list\");\n    if (cached) return cached.data;\n  }\n  const params = !useCache ? { \"skip-cache\": \"true\" } : undefined;\n  const data = await apiGet<GscSite[]>(\"/api/gsc/sites\", params);\n  if (useCache) {\n    cacheSet(\"gsc-sites\", \"list\", data, 60 * 60 * 1000);\n  }\n  return data;\n}\n\nexport async function resolveSiteUrl(args: Record<string, unknown>): Promise<string> {\n  const fromArgs = args[\"site-url\"] as string | undefined;\n  const fromEnv = getEnv().BAKER_GSC_SITE_URL;\n  const siteUrl = fromArgs || fromEnv;\n\n  if (siteUrl) return siteUrl;\n\n  const useCache = !args[\"no-cache\"];\n\n  try {\n    const sites = await fetchSites(useCache);\n    const [single] = sites;\n    if (sites.length === 1 && single) {\n      process.stderr.write(`Using site \"${single.siteUrl}\"\\n`);\n      return single.siteUrl;\n    }\n    if (sites.length === 0) {\n      handleConnectionError(\"gsc\");\n    }\n    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join(\"\\n\");\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"MULTIPLE_SITES\",\n        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:\\n${list}`,\n      },\n    });\n    process.exit(1);\n  } catch (err) {\n    // The listing call is the only thing that can throw here, so a 401/404 from\n    // it means the connection is missing — not that resolution is ambiguous.\n    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"gsc\", err.message);\n    }\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"RESOLUTION_ERROR\",\n        message: \"Could not auto-detect site. Pass --site-url or set BAKER_GSC_SITE_URL.\",\n      },\n    });\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAWA,eAAe,WAAW,WAAW,MAA0B;AAC7D,MAAI,UAAU;AACZ,UAAM,SAAS,SAAoB,aAAa,MAAM;AACtD,QAAI,OAAQ,QAAO,OAAO;AAAA,EAC5B;AACA,QAAM,SAAS,CAAC,WAAW,EAAE,cAAc,OAAO,IAAI;AACtD,QAAM,OAAO,MAAM,OAAkB,kBAAkB,MAAM;AAC7D,MAAI,UAAU;AACZ,aAAS,aAAa,QAAQ,MAAM,KAAK,KAAK,GAAI;AAAA,EACpD;AACA,SAAO;AACT;AAEA,eAAsB,eAAe,MAAgD;AACnF,QAAM,WAAW,KAAK,UAAU;AAChC,QAAM,UAAU,OAAO,EAAE;AACzB,QAAM,UAAU,YAAY;AAE5B,MAAI,QAAS,QAAO;AAEpB,QAAM,WAAW,CAAC,KAAK,UAAU;AAEjC,MAAI;AACF,UAAM,QAAQ,MAAM,WAAW,QAAQ;AACvC,UAAM,CAAC,MAAM,IAAI;AACjB,QAAI,MAAM,WAAW,KAAK,QAAQ;AAChC,cAAQ,OAAO,MAAM,eAAe,OAAO,OAAO;AAAA,CAAK;AACvD,aAAO,OAAO;AAAA,IAChB;AACA,QAAI,MAAM,WAAW,GAAG;AACtB,4BAAsB,KAAK;AAAA,IAC7B;AACA,UAAM,OAAO,MAAM,IAAI,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,EAAE,eAAe,GAAG,EAAE,KAAK,IAAI;AACjF,sBAAkB;AAAA,MAChB,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,EAAqE,IAAI;AAAA,MACpF;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB,SAAS,KAAK;AAGZ,QAAI,eAAe,YAAY,mBAAmB,IAAI,MAAM,IAAI,OAAO,GAAG;AACxE,4BAAsB,OAAO,IAAI,OAAO;AAAA,IAC1C;AACA,sBAAkB;AAAA,MAChB,IAAI;AAAA,MACJ,OAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/chunk-IJMWEO4P.js

@@ -0,0 +1,57 @@
+// src/commands/avatars/profile.ts
+var TEXT_FIELDS = [
+  ["subject", "subjectDescription"],
+  ["persona", "persona"],
+  ["speech", "speech"],
+  ["accent", "accent"],
+  ["motion", "motion"],
+  ["wardrobe", "wardrobe"],
+  ["setting", "setting"]
+];
+function parseGuardrails(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  return [
+    ...new Set(
+      value.split(",").map((rule) => rule.trim()).filter((rule) => rule.length > 0)
+    )
+  ];
+}
+function buildProfilePatch(args) {
+  const patch = {};
+  for (const [flag, field] of TEXT_FIELDS) {
+    const value = args[flag];
+    if (typeof value === "string") {
+      Object.assign(patch, { [field]: value.trim() });
+    }
+  }
+  const guardrails = parseGuardrails(args.guardrails);
+  if (guardrails) {
+    patch.guardrails = guardrails;
+  }
+  return patch;
+}
+function hasProfileEdit(patch) {
+  return Object.keys(patch).length > 0;
+}
+function mergeProfile(current, patch) {
+  const merged = { ...current };
+  for (const [key, value] of Object.entries(patch)) {
+    if (value.length === 0) {
+      if (key !== "subjectDescription") {
+        delete merged[key];
+      }
+      continue;
+    }
+    Object.assign(merged, { [key]: value });
+  }
+  return merged;
+}
+
+export {
+  buildProfilePatch,
+  hasProfileEdit,
+  mergeProfile
+};
+//# sourceMappingURL=chunk-IJMWEO4P.js.map

package/dist/chunk-IJMWEO4P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/avatars/profile.ts"],"sourcesContent":["import type { AvatarProfile } from \"@baker/api\";\n\n/**\n * A partial edit of an avatar's written profile.\n *\n * `update` sends the profile whole — the backend replaces it rather than\n * merging — so an agent that passes `--persona` alone would wipe the subject\n * description, which is the one field the identity depends on. The CLI reads\n * the stored profile first and merges this patch over it.\n */\nexport type AvatarProfilePatch = Partial<AvatarProfile>;\n\n/** Written-profile flags, in the order they read on the command line. */\nexport const PROFILE_FLAGS = [\n  \"subject\",\n  \"persona\",\n  \"speech\",\n  \"accent\",\n  \"motion\",\n  \"wardrobe\",\n  \"setting\",\n  \"guardrails\",\n] as const;\n\ntype AvatarProfileTextField = Exclude<keyof AvatarProfile, \"guardrails\">;\n\nconst TEXT_FIELDS: ReadonlyArray<[flag: string, field: AvatarProfileTextField]> = [\n  [\"subject\", \"subjectDescription\"],\n  [\"persona\", \"persona\"],\n  [\"speech\", \"speech\"],\n  [\"accent\", \"accent\"],\n  [\"motion\", \"motion\"],\n  [\"wardrobe\", \"wardrobe\"],\n  [\"setting\", \"setting\"],\n];\n\n/**\n * Split a `--guardrails \"never a, never b\"` flag into single rules.\n *\n * Returns undefined when the flag was omitted so the caller can tell \"leave the\n * stored rules alone\" from \"clear them\" (an empty string).\n */\nexport function parseGuardrails(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((rule) => rule.trim())\n        .filter((rule) => rule.length > 0),\n    ),\n  ];\n}\n\n/** Read the profile flags a caller actually passed. Omitted flags stay absent. */\nexport function buildProfilePatch(args: Record<string, unknown>): AvatarProfilePatch {\n  const patch: AvatarProfilePatch = {};\n  for (const [flag, field] of TEXT_FIELDS) {\n    const value = args[flag];\n    if (typeof value === \"string\") {\n      Object.assign(patch, { [field]: value.trim() });\n    }\n  }\n  const guardrails = parseGuardrails(args.guardrails);\n  if (guardrails) {\n    patch.guardrails = guardrails;\n  }\n  return patch;\n}\n\nexport function hasProfileEdit(patch: AvatarProfilePatch): boolean {\n  return Object.keys(patch).length > 0;\n}\n\n/**\n * Merge a patch over the stored profile. An empty value clears the field it\n * names — except `subjectDescription`, which the identity sheet was fused from\n * and can only ever be replaced, never removed (`update` rejects the empty\n * flag outright, so this is the second line of defence).\n */\nexport function mergeProfile(current: AvatarProfile, patch: AvatarProfilePatch): AvatarProfile {\n  const merged: AvatarProfile = { ...current };\n  for (const [key, value] of Object.entries(patch) as [keyof AvatarProfile, string | string[]][]) {\n    if (value.length === 0) {\n      if (key !== \"subjectDescription\") {\n        delete merged[key];\n      }\n      continue;\n    }\n    Object.assign(merged, { [key]: value });\n  }\n  return merged;\n}\n"],"mappings":";AA0BA,IAAM,cAA4E;AAAA,EAChF,CAAC,WAAW,oBAAoB;AAAA,EAChC,CAAC,WAAW,SAAS;AAAA,EACrB,CAAC,UAAU,QAAQ;AAAA,EACnB,CAAC,UAAU,QAAQ;AAAA,EACnB,CAAC,UAAU,QAAQ;AAAA,EACnB,CAAC,YAAY,UAAU;AAAA,EACvB,CAAC,WAAW,SAAS;AACvB;AAQO,SAAS,gBAAgB,OAAsC;AACpE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,GAAG,IAAI;AAAA,MACL,MACG,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AAAA,IACrC;AAAA,EACF;AACF;AAGO,SAAS,kBAAkB,MAAmD;AACnF,QAAM,QAA4B,CAAC;AACnC,aAAW,CAAC,MAAM,KAAK,KAAK,aAAa;AACvC,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,OAAO,OAAO,EAAE,CAAC,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;AAAA,IAChD;AAAA,EACF;AACA,QAAM,aAAa,gBAAgB,KAAK,UAAU;AAClD,MAAI,YAAY;AACd,UAAM,aAAa;AAAA,EACrB;AACA,SAAO;AACT;AAEO,SAAS,eAAe,OAAoC;AACjE,SAAO,OAAO,KAAK,KAAK,EAAE,SAAS;AACrC;AAQO,SAAS,aAAa,SAAwB,OAA0C;AAC7F,QAAM,SAAwB,EAAE,GAAG,QAAQ;AAC3C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAiD;AAC9F,QAAI,MAAM,WAAW,GAAG;AACtB,UAAI,QAAQ,sBAAsB;AAChC,eAAO,OAAO,GAAG;AAAA,MACnB;AACA;AAAA,IACF;AACA,WAAO,OAAO,QAAQ,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC;AAAA,EACxC;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-IREMSVKW.js

@@ -0,0 +1,175 @@
+import {
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson
+} from "./chunk-EIGXX6KI.js";
+import {
+  LINKEDIN_SEARCH_STATUSES,
+  unsupportedLinkedinSearchStatuses
+} from "./chunk-O6XZIQXZ.js";
+import {
+  ApiError
+} from "./chunk-CUL3VB4L.js";
+import {
+  MissingChatIdError,
+  getEnv
+} from "./chunk-I4FTS5EE.js";
+
+// src/commands/ads/linkedin/shared.ts
+var DAY_MS = 864e5;
+function handleLinkedinError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    if (isNoAccountsSelectedError(err.code, err.message)) {
+      handleConnectionError("linkedin_ads", err.message);
+    }
+    const explanation = explainLinkedinError(err);
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: explanation.action,
+          explanation: explanation.message,
+          correctedCommand: explanation.correctedCommand
+        },
+        retryable: err.code === "RATE_LIMITED" || err.code === "UNAVAILABLE" || err.code === "INTERNAL_ERROR"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson(unexpectedErrorEnvelope(err));
+  process.exit(1);
+}
+function unexpectedErrorEnvelope(err) {
+  if (err instanceof MissingChatIdError) {
+    return {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: {
+          action: "reject",
+          explanation: "LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here."
+        },
+        retryable: false
+      }
+    };
+  }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  return { ok: false, error: { code: "NETWORK_ERROR", message } };
+}
+function isNoAccountsSelectedError(code, message) {
+  return code === "VALIDATION_ERROR" && /no linkedin ad accounts selected/i.test(message);
+}
+function explainLinkedinError(err) {
+  const lower = err.message.toLowerCase();
+  if (err.code === "VALIDATION_ERROR" && lower.includes("granularity") && lower.includes("daily")) {
+    return {
+      action: "retry_with_flag",
+      message: "LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.",
+      correctedCommand: void 0
+    };
+  }
+  if (err.code === "RATE_LIMITED") {
+    return {
+      action: "wait_and_retry",
+      message: "Hit a LinkedIn throttle. The CLI already backs off automatically \u2014 if you see this you've exhausted the retry budget. Wait ~60s and retry."
+    };
+  }
+  if (err.code === "INTERNAL_ERROR" && lower.includes("deprecat")) {
+    return {
+      action: "reject",
+      message: "LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped \u2014 file an issue or update the constant."
+    };
+  }
+  return { action: "reject", message: err.message };
+}
+var LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\d+$/;
+function resolveAccountIdArg(args) {
+  const fromArgs = args["account-id"] ?? args["account-urn"];
+  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;
+  if (!id) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "MISSING_ACCOUNT_ID",
+        message: "Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs."
+      }
+    });
+    process.exit(1);
+  }
+  if (!LI_ACCOUNT_ID_RE.test(id)) {
+    writeAdsJson({
+      ok: false,
+      error: {
+        code: "INVALID_ACCOUNT_ID",
+        message: `Invalid LinkedIn account ID "${id}". Expected numeric or urn:li:sponsoredAccount:N.`
+      }
+    });
+    process.exit(1);
+  }
+  return id.startsWith("urn:") ? id.split(":").pop() ?? id : id;
+}
+function todayIso() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function daysAgoIso(days) {
+  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
+}
+function csvOrJson(args) {
+  return args.output ?? "json";
+}
+function statusesArgDescription(level) {
+  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
+}
+function statusFilterError(level, statuses) {
+  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
+  if (unsupported.length === 0) {
+    return null;
+  }
+  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_STATUS",
+      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
+      },
+      retryable: false
+    }
+  };
+}
+function resolveStatusFilter(args, level) {
+  if (args["all-statuses"]) {
+    return void 0;
+  }
+  const explicit = args.statuses;
+  if (!explicit) {
+    return ["ACTIVE"];
+  }
+  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  const error = statusFilterError(level, statuses);
+  if (error) {
+    writeAdsJson(error);
+    process.exit(1);
+  }
+  return statuses;
+}
+
+export {
+  handleLinkedinError,
+  resolveAccountIdArg,
+  todayIso,
+  daysAgoIso,
+  csvOrJson,
+  statusesArgDescription,
+  resolveStatusFilter
+};
+//# sourceMappingURL=chunk-IREMSVKW.js.map

package/dist/chunk-IREMSVKW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/shared.ts"],"sourcesContent":["import { LINKEDIN_SEARCH_STATUSES, type LinkedinSearchLevel, unsupportedLinkedinSearchStatuses } from \"@baker/api\";\nimport { ApiError } from \"../../../client.ts\";\nimport { getEnv, MissingChatIdError } from \"../../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport type { AdsErrorEnvelope } from \"../types.ts\";\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Map LinkedIn-flavored API errors into the shared CLI error envelope. The\n * backend already maps LinkedIn `serviceErrorCode` → tagged HTTP status, so by\n * the time we get here we just need to attach an actionable `fix` and exit.\n */\nexport function handleLinkedinError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"linkedin_ads\", err.message);\n    }\n    if (isNoAccountsSelectedError(err.code, err.message)) {\n      handleConnectionError(\"linkedin_ads\", err.message);\n    }\n    const explanation = explainLinkedinError(err);\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: {\n          action: explanation.action,\n          explanation: explanation.message,\n          correctedCommand: explanation.correctedCommand,\n        },\n        retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\" || err.code === \"INTERNAL_ERROR\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  writeAdsJson(unexpectedErrorEnvelope(err));\n  process.exit(1);\n}\n\n/**\n * Any failure that is not an API answer. A missing chat id gets its own code\n * and a fix — no retry can supply it — and anything else reads as the network.\n */\nexport function unexpectedErrorEnvelope(err: unknown): {\n  ok: false;\n  error: Pick<AdsErrorEnvelope[\"error\"], \"code\" | \"message\"> &\n    Partial<Pick<AdsErrorEnvelope[\"error\"], \"fix\" | \"retryable\">>;\n} {\n  if (err instanceof MissingChatIdError) {\n    return {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: {\n          action: \"reject\",\n          explanation:\n            \"LinkedIn changes are staged in a chat and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here.\",\n        },\n        retryable: false,\n      },\n    };\n  }\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  return { ok: false, error: { code: \"NETWORK_ERROR\", message } };\n}\n\n/**\n * \"No ad accounts selected\" comes back as a 400 (→ VALIDATION_ERROR), which\n * reads like a bad flag but is really an unfinished connection: the user has to\n * pick their accounts again. Route it to the connect flow, not flag advice.\n */\nexport function isNoAccountsSelectedError(code: string, message: string): boolean {\n  return code === \"VALIDATION_ERROR\" && /no linkedin ad accounts selected/i.test(message);\n}\n\nfunction explainLinkedinError(err: ApiError): {\n  action: AdsErrorEnvelope[\"error\"][\"fix\"][\"action\"];\n  message: string;\n  correctedCommand?: string;\n} {\n  const lower = err.message.toLowerCase();\n  if (err.code === \"VALIDATION_ERROR\" && lower.includes(\"granularity\") && lower.includes(\"daily\")) {\n    return {\n      action: \"retry_with_flag\",\n      message:\n        \"LinkedIn rejects DAILY granularity when pivoting on demographic dims (job-title, company, etc.). Re-run with --granularity ALL or MONTHLY.\",\n      correctedCommand: undefined,\n    };\n  }\n  if (err.code === \"RATE_LIMITED\") {\n    return {\n      action: \"wait_and_retry\",\n      message:\n        \"Hit a LinkedIn throttle. The CLI already backs off automatically — if you see this you've exhausted the retry budget. Wait ~60s and retry.\",\n    };\n  }\n  if (err.code === \"INTERNAL_ERROR\" && lower.includes(\"deprecat\")) {\n    return {\n      action: \"reject\",\n      message:\n        \"LinkedIn-Version header is deprecated. The backend constant LINKEDIN_API_VERSION needs to be bumped — file an issue or update the constant.\",\n    };\n  }\n  return { action: \"reject\", message: err.message };\n}\n\nconst LI_ACCOUNT_ID_RE = /^(urn:li:sponsoredAccount:)?\\d+$/;\n\n/** Pull the default LinkedIn ad account ID from `--account-id` arg or env. */\nexport function resolveAccountIdArg(args: Record<string, unknown>): string {\n  const fromArgs = (args[\"account-id\"] as string | undefined) ?? (args[\"account-urn\"] as string | undefined);\n  const id = fromArgs || getEnv().BAKER_LINKEDIN_AD_ACCOUNT_ID;\n  if (!id) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MISSING_ACCOUNT_ID\",\n        message:\n          \"Pass --account-id (numeric) or --account-urn (urn:li:sponsoredAccount:N), or set BAKER_LINKEDIN_AD_ACCOUNT_ID. Run `baker ads linkedin accounts` to find IDs.\",\n      },\n    });\n    process.exit(1);\n  }\n  if (!LI_ACCOUNT_ID_RE.test(id)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"INVALID_ACCOUNT_ID\",\n        message: `Invalid LinkedIn account ID \"${id}\". Expected numeric or urn:li:sponsoredAccount:N.`,\n      },\n    });\n    process.exit(1);\n  }\n  return id.startsWith(\"urn:\") ? (id.split(\":\").pop() ?? id) : id;\n}\n\nexport function todayIso(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport function daysAgoIso(days: number): string {\n  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);\n}\n\nexport function csvOrJson(args: Record<string, unknown>): string {\n  return (args.output as string | undefined) ?? \"json\";\n}\n\n/** The `--statuses` help line, listing exactly what LinkedIn accepts at this level. */\nexport function statusesArgDescription(level: LinkedinSearchLevel): string {\n  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(\",\")})`;\n}\n\n/**\n * One status LinkedIn does not know fails the whole listing, so refuse it here\n * with the accepted values instead of forwarding LinkedIn's enum error.\n */\nexport function statusFilterError(level: LinkedinSearchLevel, statuses: readonly string[]): AdsErrorEnvelope | null {\n  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);\n  if (unsupported.length === 0) {\n    return null;\n  }\n  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(\",\");\n  return {\n    ok: false,\n    error: {\n      code: \"INVALID_STATUS\",\n      message: `LinkedIn does not accept status ${unsupported.join(\", \")} for this listing.`,\n      fix: {\n        action: \"retry_with_flag\",\n        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`,\n      },\n      retryable: false,\n    },\n  };\n}\n\n/**\n * Default to ACTIVE-only on listings — almost always what an AI agent or human\n * glance wants. `--all-statuses` widens; `--statuses ACTIVE,PAUSED` overrides.\n */\nexport function resolveStatusFilter(args: Record<string, unknown>, level: LinkedinSearchLevel): string[] | undefined {\n  if (args[\"all-statuses\"]) {\n    return undefined;\n  }\n  const explicit = args.statuses as string | undefined;\n  if (!explicit) {\n    return [\"ACTIVE\"];\n  }\n  const statuses = explicit\n    .split(\",\")\n    .map((s) => s.trim().toUpperCase())\n    .filter(Boolean);\n  const error = statusFilterError(level, statuses);\n  if (error) {\n    writeAdsJson(error);\n    process.exit(1);\n  }\n  return statuses;\n}\n"],"mappings":"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","names":[]}

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-JD3W3ON7.js

@@ -0,0 +1,188 @@
+import {
+  analyticsErrorEnvelope
+} from "./chunk-PZ4OM2LK.js";
+import {
+  PEOPLE_SEARCH_MAX_TERMS,
+  parsePeopleQuery,
+  peopleLookupRequestSchema
+} from "./chunk-QMLGJ5OW.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-EIGXX6KI.js";
+import {
+  apiPost
+} from "./chunk-CUL3VB4L.js";
+import {
+  registerSchema
+} from "./chunk-MYTDK3AL.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-JD3W3ON7.js.map

package/dist/chunk-JD3W3ON7.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"]}