@koda-sl/baker-cli 0.507.0 → 0.508.0

package/README.md

@@ -182,7 +182,7 @@ Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **
 
 Every connected ad platform's numbers from Baker's stored copy (refreshed every few hours, full history), without calling the platforms. Read-only. Results are the company's chosen conversion goals, else each platform's headline conversions; money is shown in the company's reporting currency at the period's average ECB rate (`--currency <ISO>` for another, `--currency native` for each ad account's own), and comparisons use only days whose conversions have settled.
 
-It is the first read for any ads report, analysis or alert: no rate limit and the whole history, a few hours behind (`status` says how fresh). The live `baker ads <platform>` reads are for today's numbers and what this lacks, and their answers name the synced command that covers the same question.
+It is the first read for any ads report, analysis or alert: no rate limit and the whole history, a few hours behind. Every read's first hint says when each platform's copy was last updated and which days it holds; when an update failed or history is still loading, it names the days the copy lacks and the live read that fills them. The live `baker ads <platform>` reads are for today's numbers and what this lacks, and their answers name the synced command that covers the same question.
 
 ```bash
 baker ads performance overview --days 30          # spend, results, cost per result per platform, vs the period before

package/dist/{ads-T5RPISTB.js → ads-BOLVA4YI.js}

@@ -33,16 +33,16 @@ Examples:
 Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt|performance|terms)`
   },
   subCommands: {
-    google: () => import("./google-3GSINSOV.js").then((m) => m.googleCommand),
-    meta: () => import("./meta-KS3SQSYZ.js").then((m) => m.metaCommand),
-    linkedin: () => import("./linkedin-4MGRSWXZ.js").then((m) => m.linkedinCommand),
-    x: () => import("./x-7VY6K7JS.js").then((m) => m.xCommand),
-    chatgpt: () => import("./chatgpt-SVGWMEQD.js").then((m) => m.chatgptCommand),
-    performance: () => import("./performance-WPFGEJTE.js").then((m) => m.performanceCommand),
+    google: () => import("./google-X6LRA27Z.js").then((m) => m.googleCommand),
+    meta: () => import("./meta-VL5RNWCW.js").then((m) => m.metaCommand),
+    linkedin: () => import("./linkedin-AWUXPBIV.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-AHQPDNB4.js").then((m) => m.xCommand),
+    chatgpt: () => import("./chatgpt-DEG26ES2.js").then((m) => m.chatgptCommand),
+    performance: () => import("./performance-34XRXF2I.js").then((m) => m.performanceCommand),
     terms: () => import("./terms-O6ODXEOK.js").then((m) => m.termsCommand)
   }
 });
 export {
   adsCommand
 };
-//# sourceMappingURL=ads-T5RPISTB.js.map
+//# sourceMappingURL=ads-BOLVA4YI.js.map

package/dist/{analytics-XW4ZEEAR.js → analytics-YIRKA7OC.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-CLUJWAQE.js";
 import {
   syncedFirstHint
-} from "./chunk-TWKZVPOA.js";
+} from "./chunk-Y2FAUFWK.js";
 import {
   writeAdsJson,
   writeAdsOutput
@@ -442,4 +442,4 @@ Examples \u2014 common AI questions:
 export {
   analyticsCommand
 };
-//# sourceMappingURL=analytics-XW4ZEEAR.js.map
+//# sourceMappingURL=analytics-YIRKA7OC.js.map

package/dist/{chatgpt-SVGWMEQD.js → chatgpt-DEG26ES2.js}

@@ -36,7 +36,7 @@ Full guide: __tooling__/docs/tools/baker/ads-chatgpt.md`
     audiences: () => import("./audiences-WCDWN64L.js").then((m) => m.audiencesCommand),
     catalogs: () => import("./catalogs-T23RKYFC.js").then((m) => m.catalogsCommand),
     history: () => import("./history-5MRLNTCI.js").then((m) => m.historyCommand),
-    insights: () => import("./insights-JZVXC7IJ.js").then((m) => m.insightsCommand),
+    insights: () => import("./insights-XCT3ONC7.js").then((m) => m.insightsCommand),
     locations: () => import("./locations-UKBOT6SB.js").then((m) => m.locationsCommand),
     draft: () => import("./draft-LPVK6YHI.js").then((m) => m.draftCommand)
   }
@@ -44,4 +44,4 @@ Full guide: __tooling__/docs/tools/baker/ads-chatgpt.md`
 export {
   chatgptCommand
 };
-//# sourceMappingURL=chatgpt-SVGWMEQD.js.map
+//# sourceMappingURL=chatgpt-DEG26ES2.js.map

package/dist/{chunk-LLBB6OAB.js → chunk-GACSA5A6.js}

@@ -1,6 +1,6 @@
 import {
   googlePresetSyncedHint
-} from "./chunk-TWKZVPOA.js";
+} from "./chunk-Y2FAUFWK.js";
 import {
   getFieldDescriptions
 } from "./chunk-JPK34QPS.js";
@@ -1643,4 +1643,4 @@ export {
   runQuery,
   queryCommand
 };
-//# sourceMappingURL=chunk-LLBB6OAB.js.map
+//# sourceMappingURL=chunk-GACSA5A6.js.map

package/dist/{chunk-TWKZVPOA.js → chunk-Y2FAUFWK.js}

@@ -1,6 +1,6 @@
 // src/commands/ads/synced-first.ts
 function hint(command) {
-  return `Synced copy first: \`${command}\` answers this with no rate limit and full history, a few hours behind (\`baker ads performance status\` says how fresh). Read live only for today's numbers, a field the synced copy lacks, or right before a change.`;
+  return `Synced copy first: \`${command}\` answers this with no rate limit and full history, a few hours behind (every synced read says how fresh, and which days it lacks). Read live only for today's numbers, a field the synced copy lacks, or right before a change.`;
 }
 function syncedCommand(platform, level) {
   const scope = `--platforms ${platform}`;
@@ -47,4 +47,4 @@ export {
   metaBreakdownSyncedHint,
   googlePresetSyncedHint
 };
-//# sourceMappingURL=chunk-TWKZVPOA.js.map
+//# sourceMappingURL=chunk-Y2FAUFWK.js.map

package/dist/chunk-Y2FAUFWK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/synced-first.ts"],"sourcesContent":["/**\n * The nudge on every live performance read (`baker ads <platform> insights`,\n * `analytics`, `stats`, GAQL performance presets): Baker's synced copy\n * (`baker ads performance`) answers the same question with no rate limit and\n * the whole history, so it is the first read; live is for today's numbers, a\n * field the copy lacks, or the read right before a change.\n */\n\nexport type SyncedPlatform = \"meta\" | \"google\" | \"linkedin\" | \"x\" | \"chatgpt\";\nexport type SyncedLevel = \"account\" | \"campaign\" | \"ad_group\" | \"ad\" | \"keyword\";\n\nfunction hint(command: string): string {\n  return `Synced copy first: \\`${command}\\` answers this with no rate limit and full history, a few hours behind (every synced read says how fresh, and which days it lacks). Read live only for today's numbers, a field the synced copy lacks, or right before a change.`;\n}\n\nfunction syncedCommand(platform: SyncedPlatform, level: SyncedLevel): string {\n  const scope = `--platforms ${platform}`;\n  if (level === \"account\") return `baker ads performance overview ${scope}`;\n  return `baker ads performance entities ${scope} --level ${level}`;\n}\n\nexport function syncedFirstHint(platform: SyncedPlatform, level: SyncedLevel): string {\n  return hint(syncedCommand(platform, level));\n}\n\n/** Meta insights breakdowns the synced copy keeps, and the `breakdown --dimension` that reads each. */\nconst META_BREAKDOWN_DIMENSION: Record<string, string> = {\n  age: \"age\",\n  gender: \"gender\",\n  country: \"country\",\n  publisher_platform: \"placement\",\n  platform_position: \"placement\",\n  impression_device: \"device\",\n  device_platform: \"device\",\n};\n\n/** The synced read for a Meta breakdown; null when the copy does not keep it or would need two dimensions at once. */\nexport function metaBreakdownSyncedHint(breakdowns: readonly string[]): string | null {\n  const dimensions = new Set(breakdowns.map((breakdown) => META_BREAKDOWN_DIMENSION[breakdown]));\n  const [dimension] = dimensions;\n  if (dimensions.size !== 1 || dimension === undefined) return null;\n  return hint(`baker ads performance breakdown --dimension ${dimension} --platforms meta`);\n}\n\n/** Google Ads presets the synced copy answers, and the read that does. Inventories and live-only reports are absent. */\nconst GOOGLE_PRESET_READS: Record<string, string> = {\n  \"account-summary\": \"baker ads performance overview --platforms google\",\n  \"campaign-performance\": \"baker ads performance entities --platforms google --level campaign\",\n  \"budget-limited\": \"baker ads performance impression-share\",\n  \"keyword-analysis\": \"baker ads performance entities --platforms google --level keyword\",\n  \"search-terms\": \"baker ads performance search-terms\",\n  \"ad-copy-performance\": \"baker ads performance entities --platforms google --level ad\",\n  \"geo-performance\": \"baker ads performance breakdown --dimension country --platforms google\",\n  \"landing-pages\": \"baker ads performance landings --platforms google\",\n  \"conversions-by-action\": \"baker ads performance goals\",\n  \"account-budget\": \"baker ads performance pacing --platforms google\",\n};\n\nexport function googlePresetSyncedHint(preset: string | undefined): string | null {\n  const command = preset === undefined ? undefined : GOOGLE_PRESET_READS[preset];\n  return command === undefined ? null : hint(command);\n}\n"],"mappings":";AAWA,SAAS,KAAK,SAAyB;AACrC,SAAO,wBAAwB,OAAO;AACxC;AAEA,SAAS,cAAc,UAA0B,OAA4B;AAC3E,QAAM,QAAQ,eAAe,QAAQ;AACrC,MAAI,UAAU,UAAW,QAAO,kCAAkC,KAAK;AACvE,SAAO,kCAAkC,KAAK,YAAY,KAAK;AACjE;AAEO,SAAS,gBAAgB,UAA0B,OAA4B;AACpF,SAAO,KAAK,cAAc,UAAU,KAAK,CAAC;AAC5C;AAGA,IAAM,2BAAmD;AAAA,EACvD,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,mBAAmB;AAAA,EACnB,iBAAiB;AACnB;AAGO,SAAS,wBAAwB,YAA8C;AACpF,QAAM,aAAa,IAAI,IAAI,WAAW,IAAI,CAAC,cAAc,yBAAyB,SAAS,CAAC,CAAC;AAC7F,QAAM,CAAC,SAAS,IAAI;AACpB,MAAI,WAAW,SAAS,KAAK,cAAc,OAAW,QAAO;AAC7D,SAAO,KAAK,+CAA+C,SAAS,mBAAmB;AACzF;AAGA,IAAM,sBAA8C;AAAA,EAClD,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,kBAAkB;AAAA,EAClB,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,uBAAuB;AAAA,EACvB,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,yBAAyB;AAAA,EACzB,kBAAkB;AACpB;AAEO,SAAS,uBAAuB,QAA2C;AAChF,QAAM,UAAU,WAAW,SAAY,SAAY,oBAAoB,MAAM;AAC7E,SAAO,YAAY,SAAY,OAAO,KAAK,OAAO;AACpD;","names":[]}

package/dist/cli.js

@@ -117,7 +117,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     capabilities: () => import("./capabilities-QREOIRIH.js").then((m) => m.capabilitiesCommand),
     actions: () => import("./actions-IG2D6NRC.js").then((m) => m.actionsCommand),
     "scheduled-agents": () => import("./scheduled-agents-7JW3JIOL.js").then((m) => m.scheduledAgentsCommand),
-    ads: () => import("./ads-T5RPISTB.js").then((m) => m.adsCommand),
+    ads: () => import("./ads-BOLVA4YI.js").then((m) => m.adsCommand),
     brand: () => import("./brand-JB6NXAAL.js").then((m) => m.brandCommand),
     analytics: () => import("./analytics-P5UFA6I4.js").then((m) => m.analyticsCommand),
     experiment: () => import("./experiment-I5CRLOVN.js").then((m) => m.experimentCommand),

package/dist/{google-3GSINSOV.js → google-X6LRA27Z.js}

@@ -1,7 +1,7 @@
 import {
   runQuery
-} from "./chunk-LLBB6OAB.js";
-import "./chunk-TWKZVPOA.js";
+} from "./chunk-GACSA5A6.js";
+import "./chunk-Y2FAUFWK.js";
 import "./chunk-JPK34QPS.js";
 import {
   AD_COPY_LIST_USAGE,
@@ -3254,7 +3254,7 @@ Full guide: __tooling__/docs/tools/baker/ads-google.md`
     "identity-verification": () => import("./account-reads-KJHPUVEV.js").then((m) => m.identityVerificationCommand),
     previews: () => import("./account-reads-KJHPUVEV.js").then((m) => m.previewsCommand),
     brands: () => import("./account-reads-KJHPUVEV.js").then((m) => m.brandsCommand),
-    query: () => import("./query-42QT56FJ.js").then((m) => m.queryCommand),
+    query: () => import("./query-QM7MBQD7.js").then((m) => m.queryCommand),
     keywords: keywordsWithWrites,
     ...googleWriteCommandsWithLists,
     "merchant-center": merchantCenterCommand,
@@ -3264,4 +3264,4 @@ Full guide: __tooling__/docs/tools/baker/ads-google.md`
 export {
   googleCommand
 };
-//# sourceMappingURL=google-3GSINSOV.js.map
+//# sourceMappingURL=google-X6LRA27Z.js.map

package/dist/{insights-EQW34IL4.js → insights-M3CYB22P.js}

@@ -11,7 +11,7 @@ import {
 import {
   metaBreakdownSyncedHint,
   syncedFirstHint
-} from "./chunk-TWKZVPOA.js";
+} from "./chunk-Y2FAUFWK.js";
 import "./chunk-Y2JZX6JB.js";
 import {
   writeAdsJson,
@@ -434,4 +434,4 @@ export {
   insightsCommand,
   wantsAsync
 };
-//# sourceMappingURL=insights-EQW34IL4.js.map
+//# sourceMappingURL=insights-M3CYB22P.js.map

package/dist/{insights-JZVXC7IJ.js → insights-XCT3ONC7.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-M7HD42M6.js";
 import {
   syncedFirstHint
-} from "./chunk-TWKZVPOA.js";
+} from "./chunk-Y2FAUFWK.js";
 import {
   writeJsonEnvelope
 } from "./chunk-ZRP7Y2DM.js";
@@ -127,4 +127,4 @@ export {
   chatgptInsightsHints,
   insightsCommand
 };
-//# sourceMappingURL=insights-JZVXC7IJ.js.map
+//# sourceMappingURL=insights-XCT3ONC7.js.map

package/dist/{linkedin-4MGRSWXZ.js → linkedin-AWUXPBIV.js}

@@ -1291,7 +1291,7 @@ Full guide: __tooling__/docs/tools/baker/ads-linkedin.md`
     "lead-forms": () => import("./write-commands-ZQ5JYOUB.js").then((m) => m.leadFormsCommand),
     experiments: () => import("./experiments-PJWBABLJ.js").then((m) => m.experimentsCommand),
     draft: () => import("./draft-RTZBROFS.js").then((m) => m.linkedinDraftCommand),
-    analytics: () => import("./analytics-XW4ZEEAR.js").then((m) => m.analyticsCommand),
+    analytics: () => import("./analytics-YIRKA7OC.js").then((m) => m.analyticsCommand),
     demographics: () => import("./demographics-MZBHPCT3.js").then((m) => m.demographicsCommand),
     companies: () => import("./companies-2DHNNS34.js").then((m) => m.companiesCommand),
     "top-companies": () => import("./top-companies-HZQTHV2H.js").then((m) => m.topCompaniesCommand),
@@ -1311,4 +1311,4 @@ Full guide: __tooling__/docs/tools/baker/ads-linkedin.md`
 export {
   linkedinCommand
 };
-//# sourceMappingURL=linkedin-4MGRSWXZ.js.map
+//# sourceMappingURL=linkedin-AWUXPBIV.js.map

package/dist/{meta-KS3SQSYZ.js → meta-VL5RNWCW.js}

@@ -92,7 +92,7 @@ Full guide: __tooling__/docs/tools/baker/ads-meta.md`
     "custom-conversions": () => import("./custom-conversions-6KYF26SK.js").then((m) => m.customConversionsCommand),
     pixels: () => import("./pixels-ZZTB6NWF.js").then((m) => m.pixelsCommand),
     activities: () => import("./activities-LKLPORDI.js").then((m) => m.activitiesCommand),
-    insights: () => import("./insights-EQW34IL4.js").then((m) => m.insightsCommand),
+    insights: () => import("./insights-M3CYB22P.js").then((m) => m.insightsCommand),
     preview: () => import("./preview-CWRGDFCP.js").then((m) => m.previewCommand),
     targeting: () => import("./targeting-SOMGPSKV.js").then((m) => m.targetingCommand),
     "instagram-accounts": () => import("./account-assets-WZOYMT3C.js").then((m) => m.instagramAccountsCommand),
@@ -119,4 +119,4 @@ Full guide: __tooling__/docs/tools/baker/ads-meta.md`
 export {
   metaCommand
 };
-//# sourceMappingURL=meta-KS3SQSYZ.js.map
+//# sourceMappingURL=meta-VL5RNWCW.js.map

package/dist/{performance-WPFGEJTE.js → performance-34XRXF2I.js}

@@ -1469,15 +1469,119 @@ import { defineCommand as defineCommand2 } from "citty";
 
 // src/commands/ads/performance/reportCommand.ts
 import { defineCommand } from "citty";
+
+// src/commands/ads/performance/syncCoverage.ts
+var HOUR_MS = 36e5;
+var DAY_MS = 24 * HOUR_MS;
+var BEHIND_AFTER_MS = 26 * HOUR_MS;
+var LIVE_READ = {
+  google: (from, to) => `baker ads google query --preset campaign-performance --date-range "BETWEEN '${from}' AND '${to}'"`,
+  meta: (from, to) => `baker ads meta insights --level campaign --since ${from} --until ${to}`,
+  linkedin: (from, to) => `baker ads linkedin analytics --level campaign --start ${from} --end ${to}`,
+  x: () => "baker ads x stats",
+  chatgpt: () => "baker ads chatgpt insights"
+};
+function ago(ms) {
+  const hours = Math.max(0, Math.floor(ms / HOUR_MS));
+  if (hours < 1) return "under an hour";
+  if (hours < 48) return `${hours}h`;
+  return `${Math.floor(hours / 24)} days`;
+}
+function utc(at) {
+  return `${new Date(at).toISOString().slice(0, 16).replace("T", " ")} UTC`;
+}
+function dayOf(at) {
+  return new Date(at).toISOString().slice(0, 10);
+}
+function dayAfter(day, days = 1) {
+  return dayOf(Date.parse(`${day}T00:00:00Z`) + days * DAY_MS);
+}
+function earliest(dates) {
+  const known = dates.filter((date) => date !== null);
+  return known.length === 0 ? null : known.reduce((a, b) => b < a ? b : a);
+}
+function liveRead(platform, from, to, why) {
+  const command = LIVE_READ[platform]?.(from, to);
+  return command ? `: read live with \`${command}\` (live reads spend the platform's rate limit \u2014 ${why})` : "";
+}
+function headline(platform, accounts, now) {
+  const updatedAt = platform.lastSuccessAt;
+  const from = earliest(accounts.map((account) => account.historyFrom));
+  const through = earliest(accounts.map((account) => account.newestDate));
+  const updated = updatedAt === null ? "never updated yet" : `last updated ${ago(now - updatedAt)} ago (${utc(updatedAt)})`;
+  const holds = from !== null && through !== null ? `; holds ${from} \u2192 ${through}` : "";
+  return `${platformLabel(platform.platform)} synced copy: ${updated}${holds}.`;
+}
+function loadingSentences(platform, accounts) {
+  return accounts.filter((account) => !account.backfillComplete && account.historyFrom !== null).map((account) => {
+    const before = account.historyFrom ?? "";
+    const live = LIVE_READ[platform.platform]?.("<from>", dayAfter(before, -1));
+    return `History is still loading for ${account.name || account.adAccountId}: days before ${before} are not in the copy yet${live ? `; for an older window read live with \`${live}\`` : ""}.`;
+  });
+}
+function emptySentences(accounts) {
+  if (accounts.every((account) => account.newestDate === null)) return [];
+  return accounts.filter((account) => account.newestDate === null).map((account) => `Nothing is stored yet for ${account.name || account.adAccountId}; read it live.`);
+}
+function failureSentences(platform, accounts) {
+  const byError = /* @__PURE__ */ new Map();
+  for (const account of accounts) {
+    if (account.error === null) continue;
+    byError.set(account.error, [...byError.get(account.error) ?? [], account.name || account.adAccountId]);
+  }
+  const sentences = [...byError].map(([error, names]) => `Last update failed for ${names.join(", ")}: ${error}`);
+  if (sentences.length === 0 && platform.error) sentences.push(`Last update failed: ${platform.error}`);
+  return sentences;
+}
+function behindSentences(platform, accounts, now) {
+  const sentences = failureSentences(platform, accounts);
+  const updatedAt = platform.lastSuccessAt;
+  const overdue = updatedAt === null || now - updatedAt > BEHIND_AFTER_MS;
+  if (!overdue && sentences.length === 0) return sentences;
+  const through = earliest(accounts.map((account) => account.newestDate));
+  const today = dayOf(now);
+  if (through === null) {
+    const live = liveRead(platform.platform, dayOf(now - 29 * DAY_MS), today, "read only what the question needs");
+    sentences.push(`Nothing is in the copy yet${live}.`);
+  } else if (through < today) {
+    const live = liveRead(platform.platform, dayAfter(through), today, "read only the missing days");
+    sentences.push(
+      `Days after ${through} are not in the copy${live}, or tell the person the numbers stop at ${through}.`
+    );
+  }
+  return sentences;
+}
+var GOOGLE_ONLY_READS = /* @__PURE__ */ new Set(["brand-split", "impression-share", "keyword-quality", "google-report", "segments"]);
+function platformsOfRead(path, body) {
+  const named = typeof body === "object" && body !== null ? body : {};
+  if (Array.isArray(named.platforms) && named.platforms.length > 0) return named.platforms.map(String);
+  if (typeof named.platform === "string") return [named.platform];
+  return GOOGLE_ONLY_READS.has(path) ? ["google"] : void 0;
+}
+function syncCoverageHints(status, now, platforms) {
+  return status.platforms.filter((platform) => platform.connected && (platforms === void 0 || platforms.includes(platform.platform))).map((platform) => {
+    const accounts = platform.accounts.filter((account) => account.selected);
+    return [
+      headline(platform, accounts, now),
+      ...loadingSentences(platform, accounts),
+      ...emptySentences(accounts),
+      ...behindSentences(platform, accounts, now)
+    ].join(" ");
+  });
+}
+
+// src/commands/ads/performance/reportCommand.ts
 function failInvalid(issues, args) {
   writeJson({ ok: false, error: { code: "INVALID_ARGS", message: invalidArgsMessage(issues, args) } });
   process.exit(1);
 }
-function postRead(path, body) {
-  return retryOnceIfBusy(
+async function postRead(path, body) {
+  const response = await retryOnceIfBusy(
     () => apiPost(`/api/ads/performance/${path}`, body),
     (caught) => caught instanceof Error ? caught.message : ""
   );
+  const coverage = response.dataStatus ? syncCoverageHints(response.dataStatus, Date.now(), platformsOfRead(path, body)) : [];
+  return { ok: true, data: response.data, coverage };
 }
 function failRead(err) {
   const refusal = err instanceof ApiError ? adPerformanceRefusal(err.code, err.message) : null;
@@ -1507,7 +1611,7 @@ function report(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.path, parsed.data);
-        const hints = spec.hints?.(response.data, parsed.data, args) ?? [];
+        const hints = [...response.coverage, ...spec.hints?.(response.data, parsed.data, args) ?? []];
         const data = args.full === true ? response.data : (spec.compact ?? roundDeep)(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -1901,8 +2005,8 @@ function evidenceWords(evidence) {
     evidence.format === "different" ? "different format" : null
   ].filter((part) => part !== null).join(", ");
 }
-var titleOf = (concept, headline) => {
-  const words = (concept ?? headline).trim();
+var titleOf = (concept, headline2) => {
+  const words = (concept ?? headline2).trim();
   return words.length <= 120 ? words : `${words.slice(0, 119).trimEnd()}\u2026`;
 };
 function whyWords(choice) {
@@ -2410,16 +2514,6 @@ var PLATFORM_LABEL = {
 function platformLabel(platform) {
   return PLATFORM_LABEL[platform] ?? platform;
 }
-function historyLoadingHint(status) {
-  if (!status.historyLoading) return null;
-  const loading = status.platforms.flatMap(
-    (platform) => platform.accounts.filter((account) => account.selected && !account.backfillComplete).map(
-      (account) => `${account.name || account.adAccountId} (${platformLabel(platform.platform)}${account.historyFrom ? `, stored from ${account.historyFrom}` : ""})`
-    )
-  );
-  const which = loading.length > 0 ? loading.join(", ") : "some ad accounts";
-  return `History is still loading for ${which}; older periods are incomplete. Say so before comparing them, or read a recent window.`;
-}
 var NO_GOALS_HINT = "No result goals are set, so results are each platform's headline conversions. Run `baker ads performance goals` to see every conversion action each platform reported.";
 function resultNounHint(noun) {
   if (noun.source === "company")
@@ -2430,8 +2524,6 @@ function resultNounHint(noun) {
 }
 function overviewHints(data) {
   const hints = [];
-  const loading = historyLoadingHint(data.dataStatus);
-  if (loading !== null) hints.push(loading);
   if (data.goals.length === 0 && data.platforms.length > 0) hints.push(NO_GOALS_HINT);
   const noun = resultNounHint(data.resultNoun);
   if (noun !== null) hints.push(noun);
@@ -2616,15 +2708,7 @@ function splitAdsHints(status) {
   );
 }
 function statusHints(status) {
-  const hints = [];
-  const loading = historyLoadingHint(status);
-  if (loading !== null) hints.push(loading);
-  for (const platform of status.platforms) {
-    if (platform.connected && platform.error)
-      hints.push(`${platformLabel(platform.platform)} last sync failed: ${platform.error}`);
-  }
-  hints.push(...splitAdsHints(status));
-  return hints;
+  return splitAdsHints(status);
 }
 
 // src/commands/ads/performance/accounts.ts
@@ -2966,7 +3050,7 @@ function targetCommand(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.name, parsed.data);
-        const hints = spec.hints(response.data);
+        const hints = [...response.coverage, ...spec.hints(response.data)];
         const data = args.full === true ? response.data : spec.compact(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -3324,7 +3408,7 @@ var creativeAssetsCommand = defineCommand4({
     if (!parsed.success) failInvalid(parsed.error.issues, CREATIVE_ASSETS_ARGS);
     try {
       const response = await postRead("creative-assets", parsed.data);
-      const hints = creativeAssetsHints(response.data, parsed.data);
+      const hints = [...response.coverage, ...creativeAssetsHints(response.data, parsed.data)];
       const data = args.full === true ? response.data : compactCreativeAssets(response.data);
       writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
     } catch (err) {
@@ -3544,7 +3628,7 @@ var creativeHealthCommand = defineCommand5({
     }
     try {
       const response = await postRead("creative-health", parsed.data);
-      const hints = creativeHealthHints(response.data, choice);
+      const hints = [...response.coverage, ...creativeHealthHints(response.data, choice)];
       const data = args.full === true ? response.data : compactCreativeHealth(response.data, choice);
       writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
     } catch (err) {
@@ -3776,7 +3860,7 @@ function diagnosticCommand(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.path, parsed.data);
-        const hints = spec.hints(response.data);
+        const hints = [...response.coverage, ...spec.hints(response.data)];
         const data = args.full === true ? response.data : spec.compact(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -3957,7 +4041,7 @@ var healthCommand = defineCommand7({
     if (!parsed.success) failInvalid(parsed.error.issues, HEALTH_ARGS);
     try {
       const response = await postRead("health", parsed.data);
-      const hints = healthHints(response.data);
+      const hints = [...response.coverage, ...healthHints(response.data)];
       const data = args.full === true ? response.data : compactHealth(response.data);
       writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
     } catch (err) {
@@ -4231,7 +4315,7 @@ function peopleCommand(spec) {
       if (!parsed.success) failInvalid(parsed.error.issues, spec.args);
       try {
         const response = await postRead(spec.path, parsed.data);
-        const hints = spec.hints(response.data);
+        const hints = [...response.coverage, ...spec.hints(response.data)];
         const data = args.full === true ? response.data : spec.compact(response.data);
         writeJson({ ok: true, data, ...hints.length > 0 ? { hints } : {} });
       } catch (err) {
@@ -5452,4 +5536,4 @@ Full guide: __tooling__/docs/tools/baker/ads-performance.md`
 export {
   performanceCommand
 };
-//# sourceMappingURL=performance-WPFGEJTE.js.map
+//# sourceMappingURL=performance-34XRXF2I.js.map