@koda-sl/baker-cli 0.506.0 → 0.508.0

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/{landing-X4PG6XWU.js → landing-GEWSOHGZ.js}

@@ -12,12 +12,12 @@ Start here: \`baker landing critique <slug>\` after building or editing a landin
 Subcommands:
   baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
   baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
-  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and positioning integrity (copy ranking a competitor above the client), tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
+  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and a rival named in a comparison, tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
   baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
   },
   subCommands: {
     inspiration: () => import("./inspiration-QJNUFRNH.js").then((m) => m.inspirationCommand),
-    critique: () => import("./critique-DU7K2KVR.js").then((m) => m.critiqueCommand),
+    critique: () => import("./critique-WOSMZPHW.js").then((m) => m.critiqueCommand),
     variant: () => import("./variant-NZL2ZMYM.js").then((m) => m.variantCommand),
     export: () => import("./export-T5WPU75G.js").then((m) => m.exportCommand)
   }
@@ -25,4 +25,4 @@ Subcommands:
 export {
   landingCommand
 };
-//# sourceMappingURL=landing-X4PG6XWU.js.map
+//# sourceMappingURL=landing-GEWSOHGZ.js.map

package/dist/landing-GEWSOHGZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const landingCommand = defineCommand({\n  meta: {\n    name: \"landing\",\n    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.\n\nStart here: \\`baker landing critique <slug>\\` after building or editing a landing.\n\nSubcommands:\n  baker landing inspiration      — reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.\n  baker landing variant <control> <slug> — the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \\`baker experiment plan\\` first.\n  baker landing critique <slug>   — design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and a rival named in a comparison, tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires — run it before finishing a landing.\n  baker landing export start      — download the PUBLISHED landings as a ZIP of plain HTML (\"download my landings\", \"send me the HTML\"); \\`baker landing export status <id>\\` gives the link.`,\n  },\n  subCommands: {\n    inspiration: () => import(\"./inspiration/index.ts\").then((m) => m.inspirationCommand),\n    critique: () => import(\"./critique.ts\").then((m) => m.critiqueCommand),\n    variant: () => import(\"./variant.ts\").then((m) => m.variantCommand),\n    export: () => import(\"./export.ts\").then((m) => m.exportCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,aAAa;AAAA,IACX,aAAa,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,IACpF,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,EACjE;AACF,CAAC;","names":[]}

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