@canonry/canonry 5.28.1 → 5.29.1

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-EP4STEPI.js";
+} from "./chunk-N2SVFXOB.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-DX2JUC5H.js";
+} from "./chunk-ASYPQYVV.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-FNGITGDF.js";
+} from "./chunk-XWBQWAVE.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-ONTEFAA7.js";
+import "./chunk-PTTVDWMN.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-MPICT6V7.js";
+} from "./chunk-WL2SHCPU.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-7RKCDOWO.js";
+} from "./chunk-RHZKOXDZ.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -102,11 +102,13 @@ import {
   CheckScopes,
   CheckStatuses,
   CitationStates,
+  GaMoverChangeBases,
   MeasurementEvidenceShapes,
   OUTSTANDING_PROVIDER_BATCH_STATUSES,
   ProviderBatchStatuses,
   READ_ONLY_SCOPE,
   REPORT_PERIOD_OPTIONS,
+  RatioUnits,
   ResearchRunStatuses,
   RunKinds,
   RunStatuses,
@@ -144,9 +146,9 @@ import {
   formatGbpMetricLabel,
   formatIsoDate,
   formatMicros,
-  formatRatio,
+  formatPercent,
   formatRunErrorOneLine,
-  formatWholePercent,
+  formatSignedPointDelta,
   gbpNegativeReviewMaxStarsSchema,
   googleAdsMetricsWindowSchema,
   isVisibilityCompareClassMetric,
@@ -185,7 +187,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-KVQHG3WB.js";
+} from "./chunk-FKL5EGOW.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -450,7 +452,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-HWWIMGD6.js");
+  const { createDemoServer } = await import("./demo-server-VGUIDC5T.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -686,7 +688,7 @@ function formatSummaryAndDomains(project, response) {
   lines.push(`Target:  ${s.targetDomain}`);
   lines.push(`Linking domains: ${s.totalLinkingDomains}`);
   lines.push(`Total hosts:     ${s.totalHosts}`);
-  lines.push(`Top-10 share:    ${s.top10HostsShare}`);
+  lines.push(`Top-10 share:    ${formatPercent(Number(s.top10HostsShare))}`);
   if (s.excludedLinkingDomains !== void 0 && s.excludedLinkingDomains > 0) {
     lines.push(`Excluded:        ${s.excludedLinkingDomains} crawler/proxy domains (${s.excludedHosts ?? 0} hosts)`);
   }
@@ -1199,7 +1201,7 @@ async function bingCoverage(project, format) {
   console.log(`
 Bing Index Coverage for "${project}"
 `);
-  console.log(`  SUMMARY: ${pctColor}${summary.indexed} / ${summary.total} pages indexed (${summary.percentage}%)${reset}${unknownNote}
+  console.log(`  SUMMARY: ${pctColor}${summary.indexed} / ${summary.total} pages indexed (${formatPercent(summary.percentage, "percent")})${reset}${unknownNote}
 `);
   if (result.indexed.length > 0) {
     console.log(`  INDEXED (${result.indexed.length}):`);
@@ -1424,7 +1426,7 @@ async function bingPerformance(project, format) {
   for (const row of rows.slice(0, 50)) {
     const query = row.query.length > 38 ? row.query.slice(0, 35) + "..." : row.query;
     console.log(
-      `  ${query.padEnd(40)}${String(row.clicks).padEnd(8)}${String(row.impressions).padEnd(8)}${(row.ctr * 100).toFixed(1).padStart(5)}%  ${row.averagePosition.toFixed(1).padStart(5)}`
+      `  ${query.padEnd(40)}${String(row.clicks).padEnd(8)}${String(row.impressions).padEnd(8)}${formatPercent(row.ctr).padStart(6)}  ${row.averagePosition.toFixed(1).padStart(5)}`
     );
   }
   if (rows.length > 50) {
@@ -3609,7 +3611,7 @@ async function adsSummary(project, opts) {
   console.log(`Structure:    ${result.campaignCount} campaigns / ${result.adGroupCount} ad groups / ${result.adCount} ads`);
   console.log(`Window:       ${result.window.from ?? "\u2014"} \u2192 ${result.window.to ?? "\u2014"}${partialDayNote(result.window.inProgressDate)}`);
   console.log(`Impressions:  ${result.totals.impressions}`);
-  console.log(`Clicks:       ${result.totals.clicks}${result.totals.ctr != null ? ` (CTR ${(result.totals.ctr * 100).toFixed(2)}%)` : ""}`);
+  console.log(`Clicks:       ${result.totals.clicks}${result.totals.ctr != null ? ` (CTR ${formatPercent(result.totals.ctr)})` : ""}`);
   console.log(`Spend:        ${formatMicros(result.totals.spendMicros, result.currencyCode ?? "USD")}${result.totals.cpcMicros != null ? ` (CPC ${formatMicros(result.totals.cpcMicros, result.currencyCode ?? "USD")})` : ""}`);
   console.log(`Last synced:  ${result.lastSyncedAt ?? "never"}`);
 }
@@ -4233,8 +4235,7 @@ async function gaTraffic(project, opts) {
   console.log(`  Organic Sessions:        ${result.totalOrganicSessions}`);
   console.log(`  Total Users:             ${result.totalUsers ?? "unavailable for this range"}`);
   if (result.aiSessionsDeduped > 0) {
-    const share = result.totalSessions > 0 ? Math.round(result.aiSessionsDeduped / result.totalSessions * 100) : 0;
-    console.log(`  AI Sessions (deduped):   ${result.aiSessionsDeduped} (${share}% of total)`);
+    console.log(`  AI Sessions (deduped):   ${result.aiSessionsDeduped} (${result.aiSharePctDisplay} of total)`);
     if (result.paidAiSessionsDeduped > 0) {
       console.log(`    Paid AI:               ${result.paidAiSessionsDeduped} (${result.paidAiSharePctDisplay} of total)`);
     }
@@ -4244,13 +4245,13 @@ async function gaTraffic(project, opts) {
     const attrWidth = 12;
     const classWidth = 8;
     console.log("  AI REFERRAL SOURCES");
-    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"CLASS".padEnd(classWidth)}  ${"ATTRIBUTION".padEnd(attrWidth)}  ${"SESSIONS".padEnd(10)}`);
-    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(classWidth)}  ${"\u2500".repeat(attrWidth)}  ${"\u2500".repeat(10)}`);
+    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"CLASS".padEnd(classWidth)}  ${"ATTRIBUTION".padEnd(attrWidth)}  ${"SESSIONS".padEnd(10)}  SHARE`);
+    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(classWidth)}  ${"\u2500".repeat(attrWidth)}  ${"\u2500".repeat(10)}  ${"\u2500".repeat(6)}`);
     for (const ref of result.aiReferrals) {
       const dimLabel = ref.sourceDimension === "first_user" ? "first-visit" : ref.sourceDimension === "manual_utm" ? "utm" : "session";
       const classLabel = ref.trafficClass === "paid" ? "paid" : "organic";
       console.log(
-        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${classLabel.padEnd(classWidth)}  ${dimLabel.padEnd(attrWidth)}  ${String(ref.sessions).padEnd(10)}`
+        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${classLabel.padEnd(classWidth)}  ${dimLabel.padEnd(attrWidth)}  ${String(ref.sessions).padEnd(10)}  ${formatPercent(ref.share)}`
       );
     }
     console.log();
@@ -4273,16 +4274,15 @@ async function gaTraffic(project, opts) {
   if (result.socialReferrals.length > 0) {
     const chanWidth = 12;
     if (result.socialSessions > 0) {
-      const share = result.totalSessions > 0 ? Math.round(result.socialSessions / result.totalSessions * 100) : 0;
-      console.log(`  Social Sessions:         ${result.socialSessions} (${share}% of total)`);
+      console.log(`  Social Sessions:         ${result.socialSessions} (${result.socialSharePctDisplay} of total)`);
     }
     console.log("  SOCIAL REFERRAL SOURCES");
-    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"CHANNEL".padEnd(chanWidth)}  ${"SESSIONS".padEnd(10)}`);
-    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(chanWidth)}  ${"\u2500".repeat(10)}`);
+    console.log(`  ${"SOURCE".padEnd(25)}  ${"MEDIUM".padEnd(15)}  ${"CHANNEL".padEnd(chanWidth)}  ${"SESSIONS".padEnd(10)}  SHARE`);
+    console.log(`  ${"\u2500".repeat(25)}  ${"\u2500".repeat(15)}  ${"\u2500".repeat(chanWidth)}  ${"\u2500".repeat(10)}  ${"\u2500".repeat(6)}`);
     for (const ref of result.socialReferrals) {
       const chanLabel = ref.channelGroup === "Paid Social" ? "paid" : "organic";
       console.log(
-        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${chanLabel.padEnd(chanWidth)}  ${String(ref.sessions).padEnd(10)}`
+        `  ${ref.source.padEnd(25)}  ${ref.medium.padEnd(15)}  ${chanLabel.padEnd(chanWidth)}  ${String(ref.sessions).padEnd(10)}  ${formatPercent(ref.share)}`
       );
     }
     console.log();
@@ -4290,12 +4290,12 @@ async function gaTraffic(project, opts) {
   if (result.topPages.length > 0) {
     const pageWidth = Math.min(60, Math.max(15, ...result.topPages.map((r) => r.landingPage.length)));
     console.log(`  TOP LANDING PAGES`);
-    console.log(`  ${"PAGE".padEnd(pageWidth)}  ${"SESSIONS".padEnd(10)}${"ORGANIC".padEnd(10)}`);
-    console.log(`  ${"\u2500".repeat(pageWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(10)}`);
+    console.log(`  ${"PAGE".padEnd(pageWidth)}  ${"SESSIONS".padEnd(10)}${"ORGANIC".padEnd(10)}ORGANIC %`);
+    console.log(`  ${"\u2500".repeat(pageWidth)}  ${"\u2500".repeat(10)}${"\u2500".repeat(10)}${"\u2500".repeat(9)}`);
     for (const row of result.topPages) {
       const page = row.landingPage.length > pageWidth ? row.landingPage.slice(0, pageWidth - 3) + "..." : row.landingPage;
       console.log(
-        `  ${page.padEnd(pageWidth)}  ${String(row.sessions).padEnd(10)}${String(row.organicSessions).padEnd(10)}`
+        `  ${page.padEnd(pageWidth)}  ${String(row.sessions).padEnd(10)}${String(row.organicSessions).padEnd(10)}${formatPercent(row.organicShare)}`
       );
     }
   }
@@ -4488,6 +4488,19 @@ async function gaCoverage(project, format) {
     );
   }
 }
+function fmtTrend(pct) {
+  return pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${formatPercent(pct, "percent")}`;
+}
+function fmtMoverChange(mover) {
+  switch (mover.changeBasis) {
+    case GaMoverChangeBases.new:
+      return "new";
+    case GaMoverChangeBases["small-base"]:
+      return `${mover.changeSessions > 0 ? "+" : ""}${mover.changeSessions} sessions`;
+    case GaMoverChangeBases.percent:
+      return fmtTrend(mover.changePct);
+  }
+}
 function windowLine(traffic) {
   if (!traffic.windowStart || !traffic.windowEnd) return null;
   const span = traffic.windowDays === null ? "" : ` (${traffic.windowDays} days)`;
@@ -4516,14 +4529,13 @@ async function gaSocialReferralSummary(project, opts) {
     const trendWindow = windowLine(traffic);
     if (trendWindow) console.log(`${trendWindow}
 `);
-    console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
+    console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePctDisplay} of ${traffic.totalSessions} total)`);
     console.log();
-    const fmtTrend = (pct4) => pct4 === null ? "n/a" : `${pct4 >= 0 ? "+" : ""}${pct4}%`;
     console.log(`  7d trend:  ${fmtTrend(trend.trend7dPct)} (${trend.socialSessions7d} vs ${trend.socialSessionsPrev7d})`);
     console.log(`  30d trend: ${fmtTrend(trend.trend30dPct)} (${trend.socialSessions30d} vs ${trend.socialSessionsPrev30d})`);
     if (trend.biggestMover) {
       const m = trend.biggestMover;
-      console.log(`  Mover:     ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d})`);
+      console.log(`  Mover:     ${m.source} (${fmtMoverChange(m)}, ${m.sessionsPrev7d}\u2192${m.sessions7d})`);
     }
     console.log();
     if (traffic.socialReferrals.length > 0) {
@@ -4552,7 +4564,7 @@ async function gaSocialReferralSummary(project, opts) {
   const socialWindow = windowLine(traffic);
   if (socialWindow) console.log(`${socialWindow}
 `);
-  console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
+  console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePctDisplay} of ${traffic.totalSessions} total)`);
   if (traffic.socialReferrals.length > 0) {
     console.log();
     console.log("  TOP SOURCES");
@@ -4565,7 +4577,6 @@ async function gaSocialReferralSummary(project, opts) {
 async function gaAttribution(project, opts) {
   const client = getClient7();
   const traffic = await client.gaTraffic(project);
-  const fmtTrend = (pct4) => pct4 === null ? "n/a" : `${pct4 >= 0 ? "+" : ""}${pct4}%`;
   if (opts?.trend) {
     const trend = await client.gaAttributionTrend(project);
     if (isMachineFormat(opts.format)) {
@@ -4625,25 +4636,25 @@ async function gaAttribution(project, opts) {
     console.log(`  Total Sessions:   ${traffic.totalSessions}`);
     console.log(`  Total Users:      ${traffic.totalUsers ?? "unavailable for this range"}`);
     console.log();
-    console.log("  CHANNEL BREAKDOWN                  7d trend     30d trend");
-    console.log(`    Organic Search: ${String(traffic.channelBreakdown.organic.sessions).padEnd(6)} (${traffic.channelBreakdown.organic.sharePctDisplay.padStart(4)})    ${fmtTrend(trend.organic.trend7dPct).padEnd(12)} ${fmtTrend(trend.organic.trend30dPct)}`);
-    console.log(`    Social:         ${String(traffic.channelBreakdown.social.sessions).padEnd(6)} (${traffic.channelBreakdown.social.sharePctDisplay.padStart(4)})    ${fmtTrend(trend.social.trend7dPct).padEnd(12)} ${fmtTrend(trend.social.trend30dPct)}`);
-    console.log(`    Direct:         ${String(traffic.channelBreakdown.direct.sessions).padEnd(6)} (${traffic.channelBreakdown.direct.sharePctDisplay.padStart(4)})    ${fmtTrend(trend.direct.trend7dPct).padEnd(12)} ${fmtTrend(trend.direct.trend30dPct)}`);
-    console.log(`    AI Referrals:   ${String(traffic.channelBreakdown.ai.sessions).padEnd(6)} (${traffic.channelBreakdown.ai.sharePctDisplay.padStart(4)})    ${fmtTrend(trend.ai.trend7dPct).padEnd(12)} ${fmtTrend(trend.ai.trend30dPct)}  (lower bound \u2014 sessionSource only; referrer-stripped traffic falls under Direct)`);
+    console.log(`  CHANNEL BREAKDOWN${" ".repeat(20)}7d trend     30d trend`);
+    console.log(`    Organic Search: ${String(traffic.channelBreakdown.organic.sessions).padEnd(6)} (${traffic.channelBreakdown.organic.sharePctDisplay.padStart(6)})    ${fmtTrend(trend.organic.trend7dPct).padEnd(12)} ${fmtTrend(trend.organic.trend30dPct)}`);
+    console.log(`    Social:         ${String(traffic.channelBreakdown.social.sessions).padEnd(6)} (${traffic.channelBreakdown.social.sharePctDisplay.padStart(6)})    ${fmtTrend(trend.social.trend7dPct).padEnd(12)} ${fmtTrend(trend.social.trend30dPct)}`);
+    console.log(`    Direct:         ${String(traffic.channelBreakdown.direct.sessions).padEnd(6)} (${traffic.channelBreakdown.direct.sharePctDisplay.padStart(6)})    ${fmtTrend(trend.direct.trend7dPct).padEnd(12)} ${fmtTrend(trend.direct.trend30dPct)}`);
+    console.log(`    AI Referrals:   ${String(traffic.channelBreakdown.ai.sessions).padEnd(6)} (${traffic.channelBreakdown.ai.sharePctDisplay.padStart(6)})    ${fmtTrend(trend.ai.trend7dPct).padEnd(12)} ${fmtTrend(trend.ai.trend30dPct)}  (lower bound \u2014 sessionSource only; referrer-stripped traffic falls under Direct)`);
     if (traffic.paidAiSessionsBySession > 0) {
-      console.log(`      Paid AI:      ${String(traffic.paidAiSessionsBySession).padEnd(6)} (${traffic.paidAiSharePctBySessionDisplay.padStart(4)})`);
+      console.log(`      Paid AI:      ${String(traffic.paidAiSessionsBySession).padEnd(6)} (${traffic.paidAiSharePctBySessionDisplay.padStart(6)})`);
     }
-    console.log(`    Other:          ${String(traffic.channelBreakdown.other.sessions).padEnd(6)} (${traffic.channelBreakdown.other.sharePctDisplay.padStart(4)})`);
+    console.log(`    Other:          ${String(traffic.channelBreakdown.other.sessions).padEnd(6)} (${traffic.channelBreakdown.other.sharePctDisplay.padStart(6)})`);
     console.log(`    \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
-    console.log(`    Total:          ${String(traffic.totalSessions).padEnd(6)}         ${fmtTrend(trend.total.trend7dPct).padEnd(12)} ${fmtTrend(trend.total.trend30dPct)}`);
+    console.log(`    Total:          ${String(traffic.totalSessions).padEnd(6)}${" ".repeat(13)}${fmtTrend(trend.total.trend7dPct).padEnd(12)} ${fmtTrend(trend.total.trend30dPct)}`);
     if (trend.aiBiggestMover) {
       const m = trend.aiBiggestMover;
       console.log(`
-  AI Mover:     ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
+  AI Mover:     ${m.source} (${fmtMoverChange(m)}, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
     }
     if (trend.socialBiggestMover) {
       const m = trend.socialBiggestMover;
-      console.log(`  Social Mover: ${m.source} (${m.changePct >= 0 ? "+" : ""}${m.changePct}%, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
+      console.log(`  Social Mover: ${m.source} (${fmtMoverChange(m)}, ${m.sessionsPrev7d}\u2192${m.sessions7d} sessions/7d)`);
     }
     if (traffic.lastSyncedAt) {
       console.log(`
@@ -5150,7 +5161,7 @@ async function gbpKeywords(project, opts) {
     console.log("No GBP keyword impressions stored. Run `canonry gbp sync <project>` first.");
     return;
   }
-  console.log(`${response.total} keyword(s), ${response.thresholdedPct}% privacy-thresholded. Top by impressions:`);
+  console.log(`${response.total} keyword(s), ${formatPercent(response.thresholdedPct, "percent")} privacy-thresholded. Top by impressions:`);
   for (const k of response.keywords.slice(0, 15)) {
     const val = k.valueCount !== null ? String(k.valueCount) : `<${k.valueThreshold ?? "?"}`;
     console.log(`  ${val.padStart(8)}  ${k.keyword}`);
@@ -5271,9 +5282,9 @@ ${response.total} ${label}${shown}:`);
     console.log(`  ${r.updateTime.slice(0, 10)}  ${stars}${where}  ${r.reviewerName ?? "Anonymous"}  ${text}  [${r.origin}, ${r.alertState}]`);
   }
 }
-function fmtDelta(pct4) {
-  if (pct4 === null) return "n/a";
-  return `${pct4 >= 0 ? "+" : ""}${pct4}%`;
+function fmtDelta(pct) {
+  if (pct === null) return "n/a";
+  return `${pct >= 0 ? "+" : ""}${formatPercent(pct, "percent")}`;
 }
 async function gbpSummary(project, opts) {
   const client = getClient8();
@@ -5299,7 +5310,7 @@ async function gbpSummary(project, opts) {
     }
   }
   console.log(`
-Keywords: ${s.keywords.total} tracked, ${s.keywords.thresholdedPct}% privacy-thresholded`);
+Keywords: ${s.keywords.total} tracked, ${formatPercent(s.keywords.thresholdedPct, "percent")} privacy-thresholded`);
   console.log(`Place actions: ${s.placeActions.total} CTA(s) \u2014 reservation:${s.placeActions.hasReservationCta ? "yes" : "no"} booking:${s.placeActions.hasBookingCta ? "yes" : "no"} direct-merchant:${s.placeActions.hasDirectMerchantCta ? "yes" : "no"}`);
   console.log(`Lodging API: ${s.lodging.lodgingLocationCount} profile(s), ${s.lodging.populatedLodgingCount} with readable groups, ${s.lodging.emptyLodgingCount} with 0 readable groups`);
   const pc = s.profileCompleteness;
@@ -5654,13 +5665,10 @@ function performanceMicros(micros, currencyCode) {
   if (currencyCode === null) return (micros / 1e6).toFixed(2);
   return formatMicros(micros, currencyCode);
 }
-function performanceRatio(ratio) {
-  return ratio === null ? "\u2014" : `${(ratio * 100).toFixed(2)}%`;
-}
 function performanceChange(ratio) {
   if (ratio === null) return "";
   const sign = ratio > 0 ? "+" : "";
-  return ` (${sign}${(ratio * 100).toFixed(1)}% vs prior period)`;
+  return ` (${sign}${formatPercent(ratio)} vs prior period)`;
 }
 async function googleAdsPerformance(client, project, opts) {
   const result = await client.getGoogleAdsPerformance(project, opts.window ? { window: opts.window } : {});
@@ -5676,9 +5684,9 @@ async function googleAdsPerformance(client, project, opts) {
   console.log(`As of:        ${result.source.asOfDate}${result.source.openDate ? ` (${result.source.openDate} still open, excluded)` : ""}`);
   console.log(`Account:      ${result.source.customerId} (${currency ?? "?"}, ${result.source.timeZone ?? "unknown zone"})`);
   console.log(`Impressions:  ${totals.impressions}${performanceChange(comparison?.change.impressions ?? null)}`);
-  console.log(`Clicks:       ${totals.clicks} (CTR ${performanceRatio(totals.ctr)})${performanceChange(comparison?.change.clicks ?? null)}`);
+  console.log(`Clicks:       ${totals.clicks} (CTR ${formatPercent(totals.ctr)})${performanceChange(comparison?.change.clicks ?? null)}`);
   console.log(`Cost:         ${performanceMicros(totals.costMicros, currency)} (CPC ${performanceMicros(totals.cpcMicros, currency)})${performanceChange(comparison?.change.costMicros ?? null)}`);
-  console.log(`Conversions:  ${totals.conversions} (rate ${performanceRatio(totals.conversionRate)}, cost/conv ${performanceMicros(totals.costPerConversionMicros, currency)})`);
+  console.log(`Conversions:  ${totals.conversions} (rate ${formatPercent(totals.conversionRate)}, cost/conv ${performanceMicros(totals.costPerConversionMicros, currency)})`);
   if (!comparison) {
     console.log(`Comparison:   unavailable (${result.comparisonUnavailableReason ?? "unknown"})`);
   }
@@ -8296,7 +8304,7 @@ async function googlePerformanceDaily(project, opts) {
   }
   console.log(`  Clicks:      ${clicks.toLocaleString()}`);
   console.log(`  Impressions: ${impressions.toLocaleString()}`);
-  console.log(`  CTR:         ${(ctr * 100).toFixed(2)}%`);
+  console.log(`  CTR:         ${formatPercent(ctr)}`);
   console.log(`  Position:    ${position == null ? "\u2014" : position.toFixed(1)}`);
   const fits = data.trends;
   const trendLines = [];
@@ -8325,7 +8333,7 @@ Trend (least-squares fit over ${days} day${days === 1 ? "" : "s"}):`);
 No period comparison: period comparison needs property-level daily data. Sync again, or pick a range covered by property totals.`
     );
   } else if (cmp) {
-    const pct4 = (ratio, prior, trailing, inverted) => {
+    const pct = (ratio, prior, trailing, inverted) => {
       if (ratio === null) {
         if (prior !== null && trailing !== null && prior <= 0 && trailing > 0) {
           return `new in last ${cmp.days} day${cmp.days === 1 ? "" : "s"}`;
@@ -8336,9 +8344,7 @@ No period comparison: period comparison needs property-level daily data. Sync ag
       }
       if (ratio === 0) return "no change";
       const better = inverted ? ratio < 0 : ratio > 0;
-      const magnitude = Math.abs(ratio * 100);
-      const shown = magnitude < 0.1 ? "<0.1" : magnitude.toFixed(1);
-      return `${ratio > 0 ? "+" : "-"}${shown}%  ${better ? "better" : "worse"}`;
+      return `${ratio > 0 ? "+" : "-"}${formatPercent(Math.abs(ratio))}  ${better ? "better" : "worse"}`;
     };
     console.log(
       `
@@ -8355,7 +8361,7 @@ Last ${cmp.days} day${cmp.days === 1 ? "" : "s"} (${cmp.trailing.startDate} to $
       ["CTR", cmp.change.ctr, cmp.prior.ctr, cmp.trailing.ctr, false],
       ["Position", cmp.change.position, cmp.prior.position, cmp.trailing.position, true]
     ]) {
-      console.log(`  ${`${label}:`.padEnd(13)}${pct4(ratio, prior, trailing, inverted)}`);
+      console.log(`  ${`${label}:`.padEnd(13)}${pct(ratio, prior, trailing, inverted)}`);
     }
   }
   console.log();
@@ -8363,7 +8369,7 @@ Last ${cmp.days} day${cmp.days === 1 ? "" : "s"} (${cmp.trailing.startDate} to $
   console.log(`  ${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(12)}${"\u2500".repeat(10)}${"\u2500".repeat(9)}`);
   for (const row of data.daily) {
     console.log(
-      `  ${row.date.padEnd(12)}${row.clicks.toLocaleString().padStart(10)}${row.impressions.toLocaleString().padStart(12)}${(row.ctr * 100).toFixed(2).padStart(9)}%${(row.position == null ? "\u2014" : row.position.toFixed(1)).padStart(9)}`
+      `  ${row.date.padEnd(12)}${row.clicks.toLocaleString().padStart(10)}${row.impressions.toLocaleString().padStart(12)}${formatPercent(row.ctr).padStart(10)}${(row.position == null ? "\u2014" : row.position.toFixed(1)).padStart(9)}`
     );
   }
 }
@@ -8394,7 +8400,7 @@ async function googleTopPages(project, opts) {
   for (const row of data.rows) {
     const page = row.page.length > pageWidth ? row.page.slice(0, pageWidth - 3) + "..." : row.page;
     console.log(
-      `  ${page.padEnd(pageWidth)}${row.clicks.toLocaleString().padStart(10)}${row.impressions.toLocaleString().padStart(12)}${(row.ctr * 100).toFixed(2).padStart(9)}%`
+      `  ${page.padEnd(pageWidth)}${row.clicks.toLocaleString().padStart(10)}${row.impressions.toLocaleString().padStart(12)}${formatPercent(row.ctr).padStart(10)}`
     );
   }
   console.log();
@@ -8403,7 +8409,7 @@ async function googleTopPages(project, opts) {
     console.log(`Property total (${days} day${days === 1 ? "" : "s"}, source: ${data.totalsSource}):`);
     console.log(`  Clicks:      ${clicks.toLocaleString()}`);
     console.log(`  Impressions: ${impressions.toLocaleString()}`);
-    console.log(`  CTR:         ${(ctr * 100).toFixed(2)}%`);
+    console.log(`  CTR:         ${formatPercent(ctr)}`);
     console.log();
     console.log("  The page rows above are a ranking. They do not add up to this total:");
     console.log("  Google withholds rare queries and repeats an impression per page.");
@@ -8450,7 +8456,7 @@ async function googleQueryTotals(project, opts) {
   for (const row of rows.slice(0, 50)) {
     const query = row.query.length > 38 ? row.query.slice(0, 35) + "..." : row.query;
     console.log(
-      `  ${query.padEnd(40)}${row.clicks.toLocaleString().padStart(8)}${row.impressions.toLocaleString().padStart(10)}${`${(row.ctr * 100).toFixed(1)}%`.padStart(8)}${row.position.toFixed(1).padStart(7)}${String(row.days).padStart(6)}${showSource ? `  ${row.source}` : ""}`
+      `  ${query.padEnd(40)}${row.clicks.toLocaleString().padStart(8)}${row.impressions.toLocaleString().padStart(10)}${formatPercent(row.ctr).padStart(8)}${row.position.toFixed(1).padStart(7)}${String(row.days).padStart(6)}${showSource ? `  ${row.source}` : ""}`
     );
   }
   if (rows.length > 50) {
@@ -8518,7 +8524,7 @@ async function googlePerformance(project, opts) {
   for (const row of rows.slice(0, 50)) {
     const query = row.query.length > 28 ? row.query.slice(0, 25) + "..." : row.query;
     console.log(
-      `  ${row.date.padEnd(12)}${query.padEnd(30)}${String(row.clicks).padEnd(8)}${String(row.impressions).padEnd(8)}${(row.ctr * 100).toFixed(1).padStart(5)}%  ${row.position.toFixed(1).padStart(5)}`
+      `  ${row.date.padEnd(12)}${query.padEnd(30)}${String(row.clicks).padEnd(8)}${String(row.impressions).padEnd(8)}${formatPercent(row.ctr).padStart(6)}  ${row.position.toFixed(1).padStart(5)}`
     );
   }
   if (rows.length > 50) {
@@ -8594,10 +8600,12 @@ async function googleCoverage(project, format) {
   }
   const pctColor = summary.percentage >= 80 ? "\x1B[32m" : summary.percentage >= 50 ? "\x1B[33m" : "\x1B[31m";
   const reset = "\x1B[0m";
+  const legacyServer = summary.indexedShare === void 0;
+  const shareText = legacyServer ? `(${formatPercent(summary.percentage, "percent")})` : `(${formatPercent(summary.indexedShare)}) \xB7 ${summary.notIndexed} not indexed (${formatPercent(summary.notIndexedShare)})`;
   console.log(`
 Index Coverage for "${project}"
 `);
-  console.log(`  SUMMARY: ${pctColor}${summary.indexed} / ${summary.total} pages indexed (${summary.percentage}%)${reset}
+  console.log(`  SUMMARY: ${pctColor}${summary.indexed} / ${summary.total} pages indexed ${shareText}${reset}
 `);
   if (result.indexed.length > 0) {
     console.log(`  INDEXED (${result.indexed.length}):`);
@@ -10582,7 +10590,7 @@ function unattributedText(metric) {
 }
 function metricText(metric) {
   if (metric.state === "unavailable") return METRIC_REASONS[metric.reason] ?? `not measured (${metric.reason})`;
-  const percent = `${Math.round(metric.value * 100)}%`;
+  const percent = formatPercent(metric.value);
   return metric.numerator === void 0 || metric.denominator === void 0 ? percent : `${metric.numerator} of ${metric.denominator} (${percent})`;
 }
 async function showMeasurementProperty(project, opts) {
@@ -11484,7 +11492,6 @@ function printMetrics(data) {
   console.log(`
 Citation Rate Trends (${data.window})`);
   console.log("\u2500".repeat(50));
-  const pct4 = (n) => `${(n * 100).toFixed(1)}%`;
   const modelChangeNotice = buildModelChangeNotice(readModelPointerChanges(data));
   if (modelChangeNotice?.kind === "change") {
     console.log(`
@@ -11492,13 +11499,14 @@ Citation Rate Trends (${data.window})`);
     console.log(`    ${modelChangeNotice.text}`);
     console.log("");
   }
-  console.log(`  Overall: ${pct4(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
+  console.log(`  Overall: ${formatPercent(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
   console.log(`  Trend:   ${data.trend}`);
+  printWindowChange(data);
   if (Object.keys(data.byProvider).length > 0) {
     console.log(`
   By Provider:`);
     for (const [provider, metric] of Object.entries(data.byProvider)) {
-      console.log(`    ${provider.padEnd(10)} ${pct4(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
+      console.log(`    ${provider.padEnd(10)} ${formatPercent(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
     }
   }
   if (data.buckets.length > 0) {
@@ -11506,7 +11514,7 @@ Citation Rate Trends (${data.window})`);
   Timeline (dates in UTC):`);
     for (const bucket of data.buckets) {
       const bar = bucket.total > 0 ? "\u2588".repeat(Math.round(bucket.citationRate * 20)) : "";
-      console.log(`    ${bucketDates(bucket).padEnd(BUCKET_DATE_WIDTH)}  ${pct4(bucket.citationRate).padStart(6)}  ${bar}`);
+      console.log(`    ${bucketDates(bucket).padEnd(BUCKET_DATE_WIDTH)}  ${formatPercent(bucket.citationRate).padStart(6)}  ${bar}`);
     }
   }
   const providersInBuckets = [...new Set(data.buckets.flatMap((b) => Object.keys(b.byProvider ?? {})))].sort();
@@ -11519,7 +11527,7 @@ Citation Rate Trends (${data.window})`);
         const metric = bucket.byProvider?.[provider];
         if (!metric) continue;
         const bar = metric.total > 0 ? "\u2588".repeat(Math.round(metric.citationRate * 20)) : "";
-        console.log(`      ${bucketDates(bucket).padEnd(BUCKET_DATE_WIDTH)}  ${pct4(metric.citationRate).padStart(6)}  ${bar}`);
+        console.log(`      ${bucketDates(bucket).padEnd(BUCKET_DATE_WIDTH)}  ${formatPercent(metric.citationRate).padStart(6)}  ${bar}`);
       }
     }
   }
@@ -11567,6 +11575,22 @@ Citation Rate Trends (${data.window})`);
     }
   }
 }
+function printWindowChange(data) {
+  const windowChange = data.windowChange;
+  if (!windowChange) return;
+  const shareScope = data.mentionShareScope === "non-brand" ? "non-brand queries" : "pooled queries \xB7 classification unavailable";
+  const series = [
+    ["Mentioned", windowChange.mentionRate],
+    ["Cited", windowChange.citationRate],
+    [`Mention share \xB7 ${shareScope}`, windowChange.mentionShare]
+  ];
+  console.log(`
+  Change Across the Window (first \u2192 latest bucket):`);
+  for (const [label, change] of series) {
+    const text = change ? `${formatPercent(change.first)} \u2192 ${formatPercent(change.latest)} (${formatSignedPointDelta(change.delta)})` : "fewer than two buckets to compare";
+    console.log(`    ${label}: ${text}`);
+  }
+}
 function readServedModelAttribution(data) {
   const legacyCompatible = data;
   return legacyCompatible.servedModelAttribution ?? {};
@@ -11626,9 +11650,8 @@ Source Origin Breakdown`);
     return;
   }
   for (const cat of data.overall) {
-    const pct4 = `${(cat.percentage * 100).toFixed(1)}%`;
     const domains = cat.topDomains.slice(0, 3).map((d) => d.domain).join(", ");
-    console.log(`  ${cat.label.padEnd(20)} ${pct4.padStart(6)}  (${cat.count})  ${domains}`);
+    console.log(`  ${cat.label.padEnd(20)} ${formatPercent(cat.percentage).padStart(6)}  (${cat.count})  ${domains}`);
   }
 }
 
@@ -11659,7 +11682,6 @@ Usage: ${SOURCES_USAGE}`, {
     details: { command: "sources", usage: SOURCES_USAGE, option: "include-by-query", value }
   });
 }
-var pct = (n) => `${(n * 100).toFixed(1)}%`;
 async function showSources(project, options) {
   if (options.limit !== void 0 && (!Number.isInteger(options.limit) || options.limit <= 0)) {
     throw usageError(`Error: --limit must be a positive integer
@@ -11731,12 +11753,12 @@ function describeScope(data) {
 function printSurfaceClasses(list) {
   for (const c of list.bySurfaceClass) {
     const noun = c.domainCount === 1 ? "domain" : "domains";
-    console.log(`    ${c.label.padEnd(28)} ${pct(c.percentage).padStart(6)}  (${c.count})  ${c.domainCount} ${noun}`);
+    console.log(`    ${c.label.padEnd(28)} ${formatPercent(c.percentage).padStart(6)}  (${c.count})  ${c.domainCount} ${noun}`);
   }
 }
 function printRankedEntries(list, indent = "") {
   for (const e of list.entries) {
-    console.log(`${indent}    ${e.domain.padEnd(32)} ${String(e.count).padStart(4)}  ${pct(e.percentage).padStart(6)}  ${e.surfaceClass}`);
+    console.log(`${indent}    ${e.domain.padEnd(32)} ${String(e.count).padStart(4)}  ${formatPercent(e.percentage).padStart(6)}  ${e.surfaceClass}`);
   }
   if (list.truncatedDomainCount > 0) {
     console.log(`${indent}    \u2026 +${list.truncatedDomainCount} more domains (${list.truncatedCitedSlots} cited slots)`);
@@ -14670,9 +14692,9 @@ async function showHealth(project, opts) {
     console.log("Date                      Mention Rate  Mentioned/Total   Cited Rate   Cited/Total");
     console.log("\u2500".repeat(86));
     for (const snap of snapshots) {
-      const mRate = (snap.overallMentionRate * 100).toFixed(1).padStart(5) + "%";
+      const mRate = formatPercent(snap.overallMentionRate).padStart(6);
       const mRatio = `${snap.mentionedPairs}/${snap.totalPairs}`.padEnd(15);
-      const cRate = (snap.overallCitedRate * 100).toFixed(1).padStart(5) + "%";
+      const cRate = formatPercent(snap.overallCitedRate).padStart(6);
       const cRatio = `${snap.citedPairs}/${snap.totalPairs}`;
       const date = snap.createdAt.slice(0, 19).padEnd(25);
       console.log(`${date} ${mRate}        ${mRatio}   ${cRate}        ${cRatio}`);
@@ -14688,17 +14710,13 @@ async function showHealth(project, opts) {
     console.log("No health data yet \u2014 run a sweep first (canonry run <project>).");
     return;
   }
-  const mentionRate = (health.overallMentionRate * 100).toFixed(1);
-  const citedRate = (health.overallCitedRate * 100).toFixed(1);
-  console.log(`Health: ${mentionRate}% mentioned (${health.mentionedPairs}/${health.totalPairs} pairs)`);
-  console.log(`        ${citedRate}% cited (${health.citedPairs}/${health.totalPairs} pairs)`);
+  console.log(`Health: ${formatPercent(health.overallMentionRate)} mentioned (${health.mentionedPairs}/${health.totalPairs} pairs)`);
+  console.log(`        ${formatPercent(health.overallCitedRate)} cited (${health.citedPairs}/${health.totalPairs} pairs)`);
   console.log("");
   if (health.providerBreakdown && Object.keys(health.providerBreakdown).length > 0) {
     console.log("Provider Breakdown:");
     for (const [provider, stats] of Object.entries(health.providerBreakdown)) {
-      const pMention = (stats.mentionRate * 100).toFixed(1);
-      const pCited = (stats.citedRate * 100).toFixed(1);
-      console.log(`  ${provider.padEnd(15)} ${pMention}% mentioned (${stats.mentioned}/${stats.total})   ${pCited}% cited (${stats.cited}/${stats.total})`);
+      console.log(`  ${provider.padEnd(15)} ${formatPercent(stats.mentionRate)} mentioned (${stats.mentioned}/${stats.total})   ${formatPercent(stats.citedRate)} cited (${stats.cited}/${stats.total})`);
     }
   }
 }
@@ -14798,8 +14816,8 @@ function renderHuman2(overview) {
   printScore("Competitor press.", scores.competitorPressure);
   printScore("Run status       ", scores.runStatus);
   console.log(`
-  Queries cited:     ${queryCounts.citedQueries}/${queryCounts.totalQueries} (${pct2(queryCounts.citedRate)})`);
-  console.log(`  Queries mentioned: ${queryCounts.mentionedQueries}/${queryCounts.totalQueries} (${pct2(queryCounts.mentionRate)})`);
+  Queries cited:     ${queryCounts.citedQueries}/${queryCounts.totalQueries} (${formatPercent(queryCounts.citedRate)})`);
+  console.log(`  Queries mentioned: ${queryCounts.mentionedQueries}/${queryCounts.totalQueries} (${formatPercent(queryCounts.mentionRate)})`);
   if (movementComparison.hasPreviousRun) {
     const comparisonLabel = movementComparison.querySetChanged ? `changed (+${movementComparison.addedQueryCount} added, -${movementComparison.removedQueryCount} removed); movement compares ${movementComparison.comparableQueryCount} shared` : `unchanged; ${movementComparison.comparableQueryCount} comparable`;
     console.log(`  Query basket:       ${comparisonLabel}`);
@@ -14811,14 +14829,14 @@ function renderHuman2(overview) {
   if (providers.length > 0) {
     console.log("\n  Providers:");
     for (const p of providers) {
-      console.log(`    ${p.provider.padEnd(12)} ${p.cited}/${p.total} (${pct2(p.citedRate)})`);
+      console.log(`    ${p.provider.padEnd(12)} ${p.cited}/${p.total} (${formatPercent(p.citedRate)})`);
     }
   }
   if (providerScores.length > 0) {
     console.log("\n  Models:");
     for (const m of providerScores) {
       const label = `${m.provider}/${m.model ?? "unknown"}`.padEnd(28);
-      console.log(`    ${label} ${m.cited}/${m.total} (${m.score}%)`);
+      console.log(`    ${label} ${m.cited}/${m.total} (${formatPercent(m.score, "percent")})`);
     }
   }
   if (transitions.since) {
@@ -14840,7 +14858,7 @@ function renderHuman2(overview) {
   }
   if (health) {
     console.log(`
-  Health: ${pct2(health.overallCitedRate)} cited (${health.citedPairs}/${health.totalPairs} pairs)`);
+  Health: ${formatPercent(health.overallCitedRate)} cited (${health.citedPairs}/${health.totalPairs} pairs)`);
   }
   if (topInsights.length > 0) {
     console.log("\n  Top insights:");
@@ -14853,7 +14871,7 @@ function renderHuman2(overview) {
   Run history (last ${runHistory.length}):`);
     for (const point of runHistory) {
       const bar = "\u2588".repeat(Math.round(point.citationRate / 10));
-      console.log(`    ${point.createdAt.slice(0, 10)} ${String(point.citationRate).padStart(3)}% ${bar}`);
+      console.log(`    ${point.createdAt.slice(0, 10)} ${formatPercent(point.citationRate, "percent").padStart(6)} ${bar}`);
     }
   }
   if (suggestedQueries.rows.length > 0) {
@@ -14873,23 +14891,19 @@ function printScore(prefix, score) {
   console.log(`  ${prefix} ${tone} ${value} ${score.delta}`);
 }
 function printMentionShareBreakdown(mentionShare) {
-  const { breakdown } = mentionShare;
-  if (breakdown.perCompetitor.length === 0) return;
-  const total = breakdown.projectMentionSnapshots + breakdown.competitorMentionSnapshots;
-  if (total === 0) return;
-  const youPct = (breakdown.projectMentionSnapshots / total * 100).toFixed(1);
-  console.log(`      you${" ".repeat(28)} ${breakdown.projectMentionSnapshots} mentions (${youPct}% of combined)`);
-  for (const row of breakdown.perCompetitor.slice(0, 3)) {
-    const pct4 = (row.mentionSnapshots / total * 100).toFixed(1);
-    console.log(`      ${row.domain.padEnd(30)} ${row.mentionSnapshots} mentions (${pct4}% of combined)`);
+  const legacyCompatible = mentionShare.breakdown;
+  const ranking = legacyCompatible.ranking ?? [];
+  const project = ranking.find((row) => row.kind === "project");
+  if (!project) return;
+  const competitors = ranking.filter((row) => row.kind === "competitor");
+  console.log(`      you${" ".repeat(28)} ${project.mentionSnapshots} mentions (${formatPercent(project.share)} of combined)`);
+  for (const row of competitors.slice(0, 3)) {
+    console.log(`      ${(row.domain ?? "").padEnd(30)} ${row.mentionSnapshots} mentions (${formatPercent(row.share)} of combined)`);
   }
-  if (breakdown.perCompetitor.length > 3) {
-    console.log(`      + ${breakdown.perCompetitor.length - 3} more competitor${breakdown.perCompetitor.length - 3 === 1 ? "" : "s"} (--format json for full breakdown)`);
+  if (competitors.length > 3) {
+    console.log(`      + ${competitors.length - 3} more competitor${competitors.length - 3 === 1 ? "" : "s"} (--format json for full breakdown)`);
   }
 }
-function pct2(value) {
-  return `${(value * 100).toFixed(1)}%`;
-}
 
 // src/commands/search.ts
 async function searchProject(project, opts) {
@@ -15220,9 +15234,9 @@ async function listContentGaps(project, opts) {
   console.log(`${response.gaps.length} gap${response.gaps.length === 1 ? "" : "s"} found`);
   console.log("");
   for (const gap of response.gaps) {
-    const missPct = formatWholePercent(gap.missRate);
-    console.log(`${missPct.padStart(4)}  ${gap.competitorCount} competitor(s)  ${gap.query}`);
-    console.log(`       competitors: ${gap.competitorDomains.join(", ")}`);
+    const missPct = formatPercent(gap.missRate);
+    console.log(`${missPct.padStart(6)}  ${gap.competitorCount} competitor(s)  ${gap.query}`);
+    console.log(`        competitors: ${gap.competitorDomains.join(", ")}`);
     console.log("");
   }
 }
@@ -16826,10 +16840,10 @@ async function technicalAeoScore(project, opts) {
   lines.push(`As of ${score.auditedAt}`);
   if (score.factors.length > 0) {
     lines.push("");
-    lines.push(`${"Factor".padEnd(32)}${"Wt".padStart(4)}${"Avg".padStart(6)}${"Status".padStart(9)}   Pass/Part/Fail`);
+    lines.push(`${"Factor".padEnd(32)}${"Share".padStart(7)}${"Avg".padStart(6)}${"Status".padStart(9)}   Pass/Part/Fail`);
     for (const f of score.factors) {
       lines.push(
-        `${f.name.slice(0, 31).padEnd(32)}${String(f.weight).padStart(4)}${String(f.avgScore).padStart(6)}${f.status.padStart(9)}   ${f.pagesPassing}/${f.pagesPartial}/${f.pagesFailing}`
+        `${f.name.slice(0, 31).padEnd(32)}${formatPercent(f.sharePct, RatioUnits.percent).padStart(7)}${String(f.avgScore).padStart(6)}${f.status.padStart(9)}   ${f.pagesPassing}/${f.pagesPartial}/${f.pagesFailing}`
       );
     }
   }
@@ -17117,7 +17131,8 @@ async function technicalAeoPageAudit(project, opts) {
   if (res.factors.length > 0) {
     lines.push("", "Factors:");
     for (const factor of res.factors) {
-      lines.push(`  ${factor.name}: ${factor.score}/100 (${factor.status})`);
+      const share = typeof factor.sharePct === "number" ? ` \xB7 worth ${formatPercent(factor.sharePct, RatioUnits.percent)} of the page score` : "";
+      lines.push(`  ${factor.name}: ${factor.score}/100 (${factor.status})${share}`);
       for (const finding of factor.findings) lines.push(`    [${finding.code}] ${finding.message}`);
       for (const recommendation of factor.recommendations) lines.push(`    Fix: ${recommendation}`);
     }
@@ -17810,9 +17825,6 @@ async function showVisibilityStats(project, opts) {
   }
   printVisibilityStats(data);
 }
-function pct3(rate) {
-  return rate === null ? "\u2014" : formatRatio(rate);
-}
 async function showVisibilityCompare(project, opts) {
   if (!opts.from || !opts.to) throw new Error("visibility-compare requires --from <YYYY-MM> and --to <YYYY-MM>");
   const client = createApiClient();
@@ -17829,8 +17841,7 @@ function periodCell(p) {
     return `unavailable: no competitive frame (${p.numerator} observed)`;
   }
   if (p.point === null || p.ciLow === null || p.ciHigh === null) return "no data";
-  const p1 = (v) => formatRatio(v);
-  return `${p1(p.point)} [${p1(p.ciLow)}, ${p1(p.ciHigh)}]`;
+  return `${formatPercent(p.point)} [${formatPercent(p.ciLow)}, ${formatPercent(p.ciHigh)}]`;
 }
 function verdictCell(m) {
   switch (m.verdict) {
@@ -17940,9 +17951,9 @@ function printVisibilityStats(data) {
   const rows = data.queries.map((q) => ({
     label: q.query,
     cited: citedCell(q),
-    citedPct: pct3(q.citedRate),
+    citedPct: formatPercent(q.citedRate),
     ment: mentionedCell(q),
-    mentPct: pct3(q.mentionRate)
+    mentPct: formatPercent(q.mentionRate)
   }));
   const queryWidth = Math.max(7, ...rows.map((r) => r.label.length));
   const citedWidth = Math.max(7, ...rows.map((r) => r.cited.length));
@@ -17972,9 +17983,9 @@ function printVisibilityStats(data) {
     [
       "TOTAL".padEnd(queryWidth),
       citedCell(data.totals).padEnd(citedWidth),
-      pct3(data.totals.citedRate).padStart(7),
+      formatPercent(data.totals.citedRate).padStart(7),
       mentionedCell(data.totals).padEnd(mentWidth),
-      pct3(data.totals.mentionRate).padStart(7)
+      formatPercent(data.totals.mentionRate).padStart(7)
     ].join("  ")
   );
   if (data.groupBy === "provider" && data.byProvider && data.byProvider.length > 0) {
@@ -17986,9 +17997,9 @@ function printVisibilityStats(data) {
         [
           `  ${p.provider}`.padEnd(provWidth + 2),
           citedCell(p).padEnd(citedWidth),
-          pct3(p.citedRate).padStart(7),
+          formatPercent(p.citedRate).padStart(7),
           mentionedCell(p).padEnd(mentWidth),
-          pct3(p.mentionRate).padStart(7)
+          formatPercent(p.mentionRate).padStart(7)
         ].join("  ")
       );
     }
@@ -17996,7 +18007,7 @@ function printVisibilityStats(data) {
   const sov = data.shareOfVoice;
   if (sov) {
     console.log("");
-    const pctStr = sov.availability !== void 0 ? shareOfVoiceLabel(sov.percent, sov) : sov.percent !== null ? `${sov.percent}%` : sov.competitorCount === 0 ? "\u2014 (no competitors configured)" : sov.snapshotsWithAnswerText === 0 ? "\u2014 (no answer text in scope)" : "\u2014 (no brands mentioned in scope)";
+    const pctStr = sov.availability !== void 0 ? shareOfVoiceLabel(sov.percent, sov) : sov.percent !== null ? formatPercent(sov.percent, "percent") : sov.competitorCount === 0 ? "\u2014 (no competitors configured)" : sov.snapshotsWithAnswerText === 0 ? "\u2014 (no answer text in scope)" : "\u2014 (no brands mentioned in scope)";
     const scope = sov.queryClass === "pooled" ? "pooled queries \xB7 classification unavailable" : `${sov.queryClass} queries`;
     console.log(
       `Share of voice (${scope}${sov.measurementScope === "all-markets" ? " \xB7 all markets" : ""}): ${pctStr}  (you ${sov.projectMentions} vs competitors ${sov.competitorMentions} brand mentions across ${sov.snapshotsWithAnswerText} answers)`