@canonry/canonry 5.22.0 → 5.29.0

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-XFHXKLNT.js";
+} from "./chunk-7BW7BAD5.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-YTSXQUJ3.js";
+} from "./chunk-WPQB4UYX.js";
 import {
   configExists,
   createApiClient,
@@ -56,13 +56,13 @@ import {
   saveConfig,
   saveConfigPatch,
   shouldPrintServeSkillsNudge
-} from "./chunk-GLLY2GEV.js";
+} from "./chunk-VPIOF2PB.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-3LCR6WU6.js";
+import "./chunk-THMIDWMS.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -74,7 +74,7 @@ import {
   runMeasurementDraftAction,
   systemError,
   usageError
-} from "./chunk-DDL2XSNM.js";
+} from "./chunk-J6BJIOIN.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
   CLOUDFLARE_WORKER_GENERATED_MARKER,
@@ -89,7 +89,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-P5VXVFQW.js";
+} from "./chunk-KGYHEYHX.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -102,9 +102,13 @@ import {
   CheckScopes,
   CheckStatuses,
   CitationStates,
+  GaMoverChangeBases,
   MeasurementEvidenceShapes,
+  OUTSTANDING_PROVIDER_BATCH_STATUSES,
+  ProviderBatchStatuses,
   READ_ONLY_SCOPE,
   REPORT_PERIOD_OPTIONS,
+  RatioUnits,
   ResearchRunStatuses,
   RunKinds,
   RunStatuses,
@@ -142,9 +146,10 @@ import {
   formatGbpMetricLabel,
   formatIsoDate,
   formatMicros,
-  formatRatio,
+  formatPercent,
   formatRunErrorOneLine,
-  formatWholePercent,
+  formatSignedPointDelta,
+  gbpNegativeReviewMaxStarsSchema,
   googleAdsMetricsWindowSchema,
   isVisibilityCompareClassMetric,
   logQuerySchema,
@@ -166,11 +171,14 @@ import {
   normalizeProjectAliases,
   normalizeTelemetryStatus,
   notificationEventSchema,
+  providerDispatchModeSchema,
   queryClassFilterSchema,
   queryTrackingCommitRequestSchema,
   queryTrackingPreviewRequestSchema,
+  referralAssessmentQuerySchema,
   reportUnattributedAnswers,
   researchBatchCreateSchema,
+  resolveNegativeReviewMaxStars,
   resolveProviderInput,
   resultsClearRequestSchema,
   shareOfVoiceLabel,
@@ -179,7 +187,7 @@ import {
   visibilityCompareSelectionSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-S5OSY3PI.js";
+} from "./chunk-DCGELKRW.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -444,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-HULNEORN.js");
+  const { createDemoServer } = await import("./demo-server-EU6B4KNK.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -680,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)`);
   }
@@ -1193,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}):`);
@@ -1418,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) {
@@ -3603,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"}`);
 }
@@ -4227,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)`);
     }
@@ -4238,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();
@@ -4267,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();
@@ -4284,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)}`
       );
     }
   }
@@ -4482,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)`;
@@ -4510,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) {
@@ -4546,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");
@@ -4559,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)) {
@@ -4619,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(`
@@ -5144,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}`);
@@ -5226,9 +5243,48 @@ async function gbpPlaces(project, opts) {
     console.log(`  ${p.locationName}  [${p.tier}]  ${amenities}`);
   }
 }
-function fmtDelta(pct4) {
-  if (pct4 === null) return "n/a";
-  return `${pct4 >= 0 ? "+" : ""}${pct4}%`;
+async function gbpReviews(project, opts) {
+  const client = getClient8();
+  const response = await client.listGbpReviews(project, {
+    locationName: opts.location,
+    ...opts.negative ? { negative: true } : {},
+    ...opts.limit !== void 0 ? { limit: opts.limit } : {}
+  });
+  if (isMachineFormat(opts.format)) {
+    console.log(JSON.stringify(response, null, 2));
+    return;
+  }
+  if (response.locations.length === 0 && response.reviews.length === 0) {
+    console.log('No reviews yet. Run "canonry gbp sync" first.');
+    return;
+  }
+  const names = new Map(response.locations.map((loc) => [loc.locationName, loc.displayName]));
+  for (const loc of response.locations) {
+    const rating = loc.rating !== null ? `${Number(loc.rating.toFixed(2))} from ${loc.reviewCount ?? "?"} reviews (${loc.ratingOrigin === "gbp" ? "Business Profile" : "public listing"})` : "no rating yet";
+    const access = loc.reviewsAccess === "ok" ? "every review" : loc.reviewsAccess === null ? "review access not checked yet" : `Business Profile reviews ${loc.reviewsAccess}${loc.reviewsAccessReason ? ` (${loc.reviewsAccessReason})` : ""}`;
+    console.log(`${loc.displayName}  ${loc.locationName}`);
+    console.log(`  ${rating}; ${access}`);
+  }
+  const label = opts.negative ? "negative review(s)" : "review(s)";
+  if (response.reviews.length === 0) {
+    console.log(`
+No ${label} stored.`);
+    return;
+  }
+  const shown = response.reviews.length < response.total ? `, newest ${response.reviews.length} shown` : "";
+  console.log(`
+${response.total} ${label}${shown}:`);
+  const manyLocations = response.locations.length > 1;
+  for (const r of response.reviews) {
+    const stars = r.starRating !== null ? `${r.starRating}\u2605` : "--";
+    const where = manyLocations ? `  ${names.get(r.locationName) ?? r.locationName}` : "";
+    const text = r.comment ? `"${r.comment.length > 80 ? `${r.comment.slice(0, 79)}\u2026` : r.comment}"` : "(rating only)";
+    console.log(`  ${r.updateTime.slice(0, 10)}  ${stars}${where}  ${r.reviewerName ?? "Anonymous"}  ${text}  [${r.origin}, ${r.alertState}]`);
+  }
+}
+function fmtDelta(pct) {
+  if (pct === null) return "n/a";
+  return `${pct >= 0 ? "+" : ""}${formatPercent(pct, "percent")}`;
 }
 async function gbpSummary(project, opts) {
   const client = getClient8();
@@ -5254,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;
@@ -5446,6 +5502,25 @@ var GBP_CLI_COMMANDS = [
       await gbpPlaces(project, { location: getString(input.values, "location"), format: input.format });
     }
   },
+  {
+    path: ["gbp", "reviews"],
+    usage: "canonry gbp reviews <project> [--location <name>] [--negative] [--limit N] [--format json]",
+    options: {
+      location: stringOption(),
+      negative: { type: "boolean" },
+      limit: stringOption()
+    },
+    run: async (input) => {
+      const usage = "canonry gbp reviews <project> [--location <name>] [--negative] [--limit N] [--format json]";
+      const project = requireProject(input, "gbp.reviews", usage);
+      await gbpReviews(project, {
+        location: getString(input.values, "location"),
+        negative: getBoolean(input.values, "negative") ?? false,
+        limit: parseIntegerOption(input, "limit", { message: "--limit must be an integer", usage, command: "gbp.reviews" }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["gbp", "summary"],
     usage: "canonry gbp summary <project> [--location <name>] [--format json]",
@@ -5590,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 } : {});
@@ -5612,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"})`);
   }
@@ -7365,9 +7437,47 @@ async function trafficEvents(project, opts) {
     console.log(`  ${formatEventLine(event)}`);
   }
 }
+async function trafficReferralAssessment(project, options) {
+  const { format, ...query } = options;
+  const parsed = referralAssessmentQuerySchema.safeParse(query);
+  if (!parsed.success) throw new CliError({ code: "TRAFFIC_INVALID_ASSESSMENT", message: parsed.error.message });
+  const result = await createApiClient().trafficReferralAssessment(project, parsed.data);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`AI referral assessment for "${project}" \xB7 ${result.window.startDate} to ${result.window.endDate} UTC`);
+  console.log(`  Raw stored hits: ${result.totals.raw.total}`);
+  console.log(`  Countable stored hits: ${result.totals.countable.total}`);
+  console.log(`  Suspected burst hits: ${result.totals.suspected.total} (not confirmed automation)`);
+  console.log(`  Adjusted estimate: ${result.totals.adjustedEstimate.total} (countable minus candidate bursts)`);
+  console.log(`  Rule: ${result.rule.version}; threshold ${result.rule.burstThreshold}; ${result.rule.calibration}`);
+  console.log(`  Observed server/GA quotient: ${result.comparison.observedRatio ?? "unavailable"}; comparable coverage: unavailable`);
+  console.log(`  Evidence: ${result.evidence.returned} of ${result.evidence.total} candidate groups (source, product, normalized path, UTC hour)`);
+  for (const burst of result.bursts) console.log(`  ${burst.tsHour} ${burst.sourceId} ${burst.product} ${burst.landingPathNormalized} ${burst.counts.total}`);
+  for (const caveat of result.caveats) console.log(`  ${caveat}`);
+}
 
 // src/cli-commands/traffic.ts
 var TRAFFIC_CLI_COMMANDS = [
+  {
+    path: ["traffic", "referral-assessment"],
+    usage: "canonry traffic referral-assessment <project> --start-date YYYY-MM-DD --end-date YYYY-MM-DD [--source <id>] [--burst-threshold 100] [--ratio-threshold 3] [--limit 100] [--format json]",
+    help: "DB-only diagnostic. Raw headlines stay unchanged. Candidate bursts are not confirmed automation; adjusted counts are estimates. Property, Target and market attribution are unavailable. The observed GA quotient has unknown comparable coverage.",
+    options: { "start-date": stringOption(), "end-date": stringOption(), source: stringOption(), "burst-threshold": stringOption(), "ratio-threshold": stringOption(), limit: stringOption() },
+    run: async (input) => {
+      const project = requireProject(input, "traffic.referral-assessment", "canonry traffic referral-assessment <project> --start-date YYYY-MM-DD --end-date YYYY-MM-DD");
+      await trafficReferralAssessment(project, {
+        startDate: getString(input.values, "start-date"),
+        endDate: getString(input.values, "end-date"),
+        sourceId: getString(input.values, "source"),
+        burstThreshold: getString(input.values, "burst-threshold") === void 0 ? void 0 : Number(getString(input.values, "burst-threshold")),
+        ratioThreshold: getString(input.values, "ratio-threshold") === void 0 ? void 0 : Number(getString(input.values, "ratio-threshold")),
+        limit: getString(input.values, "limit") === void 0 ? void 0 : Number(getString(input.values, "limit")),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["traffic", "connect", "cloudflare"],
     usage: "canonry traffic connect cloudflare <project> [--delivery-mode direct-push|queue-pull] [--display-name <name>] [--zone-id <id>] [--account-id <id>] [--queue-id <id> --queue-name <name> --api-token-file <path> --retention-seconds 345600] [--output-dir <dir>] [--deploy --confirm-route --confirm-fail-open] [--format json]",
@@ -8194,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 = [];
@@ -8223,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"}`;
@@ -8234,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(
       `
@@ -8253,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();
@@ -8261,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)}`
     );
   }
 }
@@ -8292,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();
@@ -8301,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.");
@@ -8310,6 +8418,65 @@ async function googleTopPages(project, opts) {
     console.log('  Adding up the page rows would not give it. Run "canonry google sync" to fetch it.');
   }
 }
+async function googleQueryTotals(project, opts) {
+  const client = getClient11();
+  const params = {};
+  if (opts.startDate) params.startDate = opts.startDate;
+  if (opts.endDate) params.endDate = opts.endDate;
+  if (opts.window) params.window = opts.window;
+  if (opts.limit !== void 0) params.limit = String(opts.limit);
+  if (opts.offset !== void 0) params.offset = String(opts.offset);
+  const data = await client.gscQueryTotals(project, Object.keys(params).length > 0 ? params : void 0);
+  const { rows, totalMatching, truncated, window } = data;
+  if (opts.format === "json") {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  } else if (opts.format === "jsonl") {
+    emitJsonl(rows.map((row) => ({ project, window, ...row })));
+    return;
+  }
+  if (rows.length === 0) {
+    if (totalMatching > 0) {
+      console.log(
+        `Offset ${opts.offset ?? 0} is past the end of the result set (${totalMatching.toLocaleString()} queries). Lower --offset to page through them.`
+      );
+      return;
+    }
+    console.log('No GSC query data found in this window. Run "canonry google sync" first.');
+    return;
+  }
+  const range = `${window.startDate ?? "earliest"} to ${window.endDate ?? "latest"}`;
+  console.log(`GSC query totals (${rows.length.toLocaleString()} of ${totalMatching.toLocaleString()} queries, ${range}):
+`);
+  const showSource = rows.some((row) => row.source !== "google");
+  console.log(
+    `  ${"QUERY".padEnd(40)}${"CLICKS".padStart(8)}${"IMPR".padStart(10)}${"CTR".padStart(8)}${"POS".padStart(7)}${"DAYS".padStart(6)}${showSource ? "  SOURCE" : ""}`
+  );
+  console.log(`  ${"\u2500".repeat(40)}${"\u2500".repeat(8)}${"\u2500".repeat(10)}${"\u2500".repeat(8)}${"\u2500".repeat(7)}${"\u2500".repeat(6)}${showSource ? `  ${"\u2500".repeat(11)}` : ""}`);
+  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)}${formatPercent(row.ctr).padStart(8)}${row.position.toFixed(1).padStart(7)}${String(row.days).padStart(6)}${showSource ? `  ${row.source}` : ""}`
+    );
+  }
+  if (rows.length > 50) {
+    console.log(`
+  ... and ${rows.length - 50} more rows on this page (use --format json for full output)`);
+  }
+  if (truncated) {
+    const nextOffset = (opts.offset ?? 0) + rows.length;
+    console.log(`
+  This is one page. Use --offset ${nextOffset} (with the same --limit) to read the next.`);
+  }
+  console.log();
+  if (showSource) {
+    console.log("  Rows marked page-summed or mixed use the legacy page table for some days. Their impressions");
+    console.log("  over-count, because one search showing several of your pages was stored once per page.");
+    console.log(`  Run "canonry google sync" over the window to replace them with Google's per-query totals.`);
+  }
+  console.log("  These are the queries Google names. Google leaves rare queries out, so the rows do not add up");
+  console.log('  to the property total. Use "canonry google performance-daily" for that.');
+}
 async function googlePerformance(project, opts) {
   const client = getClient11();
   const params = {};
@@ -8357,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) {
@@ -8433,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}):`);
@@ -8892,6 +9061,7 @@ async function googleDeindexed(project, format) {
 
 // src/cli-commands/google.ts
 var GOOGLE_PERFORMANCE_USAGE = "canonry google performance <project> [--days <n> | --start <YYYY-MM-DD> --end <YYYY-MM-DD>] [--keyword <kw>] [--page <url>] [--limit <n>] [--offset <n>] [--order-by clicks|impressions|date] [--format json]";
+var GOOGLE_QUERY_TOTALS_USAGE = "canonry google query-totals <project> [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--window 7d|30d|90d|all] [--limit <n>] [--offset <n>] [--format json]";
 var GOOGLE_CLI_COMMANDS = [
   {
     path: ["google", "connect"],
@@ -9125,6 +9295,36 @@ Usage: ${GOOGLE_PERFORMANCE_USAGE}`,
       });
     }
   },
+  {
+    path: ["google", "query-totals"],
+    usage: GOOGLE_QUERY_TOTALS_USAGE,
+    options: {
+      window: stringOption(),
+      start: stringOption(),
+      end: stringOption(),
+      limit: stringOption(),
+      offset: stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(input, "google.query-totals", GOOGLE_QUERY_TOTALS_USAGE);
+      await googleQueryTotals(project, {
+        window: getString(input.values, "window"),
+        startDate: getString(input.values, "start"),
+        endDate: getString(input.values, "end"),
+        limit: parseIntegerOption(input, "limit", {
+          command: "google.query-totals",
+          usage: GOOGLE_QUERY_TOTALS_USAGE,
+          message: "--limit must be an integer"
+        }),
+        offset: parseIntegerOption(input, "offset", {
+          command: "google.query-totals",
+          usage: GOOGLE_QUERY_TOTALS_USAGE,
+          message: "--offset must be an integer"
+        }),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["google", "inspect"],
     usage: "canonry google inspect <project> <url> [--format json]",
@@ -9254,12 +9454,12 @@ Usage: ${GOOGLE_PERFORMANCE_USAGE}`,
   },
   {
     path: ["google"],
-    usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
+    usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|top-pages|query-totals|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
     run: async (input) => {
       unknownSubcommand(input.positionals[0], {
         command: "google",
-        usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
-        available: ["connect", "disconnect", "status", "properties", "set-property", "set-sitemap", "list-sitemaps", "submit-sitemap", "discover-sitemaps", "sync", "performance", "performance-daily", "inspect", "inspect-sitemap", "coverage", "coverage-history", "inspections", "deindexed", "request-indexing", "refresh"]
+        usage: "canonry google <connect|disconnect|status|properties|set-property|set-sitemap|list-sitemaps|submit-sitemap|discover-sitemaps|sync|performance|performance-daily|top-pages|query-totals|inspect|inspect-sitemap|coverage|coverage-history|inspections|deindexed|request-indexing|refresh> <project> [args]",
+        available: ["connect", "disconnect", "status", "properties", "set-property", "set-sitemap", "list-sitemaps", "submit-sitemap", "discover-sitemaps", "sync", "performance", "performance-daily", "top-pages", "query-totals", "inspect", "inspect-sitemap", "coverage", "coverage-history", "inspections", "deindexed", "request-indexing", "refresh"]
       });
     }
   }
@@ -9889,7 +10089,7 @@ var KEYWORD_CLI_COMMANDS = [
       const provider = requireStringOption(input, "provider", {
         command: "keyword.generate",
         usage: "canonry keyword generate <project> --provider <name> [--count <n>] [--save] [--format json]",
-        message: "--provider is required (e.g. gemini, openai, claude, perplexity, local)"
+        message: "--provider is required (e.g. gemini, openai, claude, perplexity, muse, local)"
       });
       await generateKeywords(project, provider, {
         count: parseIntegerOption(input, "count", {
@@ -10390,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) {
@@ -10633,7 +10833,7 @@ var QUERY_CLI_COMMANDS = [
       const provider = requireStringOption(input, "provider", {
         command: "query.generate",
         usage: "canonry query generate <project> --provider <name> [--count <n>] [--save] [--format json]",
-        message: "--provider is required (e.g. gemini, openai, claude, perplexity, local)"
+        message: "--provider is required (e.g. gemini, openai, claude, perplexity, muse, local)"
       });
       await generateQueries(project, provider, {
         count: parseIntegerOption(input, "count", {
@@ -11050,7 +11250,9 @@ var EVENT_DESCRIPTIONS = {
   "insight.critical": "A critical-severity insight was generated",
   "insight.high": "A high-severity insight was generated",
   "health.degraded": "A scheduled health check found the measurement degraded, daily data stopped arriving, or the website stopped answering (sent on change, not every pass)",
-  "health.recovered": "A degraded health check is passing again, or a website that was paged as down answers again"
+  "health.recovered": "A degraded health check is passing again, or a website that was paged as down answers again",
+  "review.negative": "A new or edited Google review at or below the project's negative-review threshold, 3 stars by default (Business Profile reviews, or the public listing when Google has not enabled review access)",
+  "review.rating-dropped": "A location's public Google rating fell (sent for locations without Business Profile review access)"
 };
 function listEvents(format, target = "local") {
   if (target === "server") return getClient16().listNotificationEvents().then((events) => printEvents(events, format));
@@ -11290,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(`
@@ -11298,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) {
@@ -11312,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();
@@ -11325,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}`);
       }
     }
   }
@@ -11373,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 ?? {};
@@ -11432,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}`);
   }
 }
 
@@ -11465,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
@@ -11537,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)`);
@@ -11956,14 +12172,23 @@ async function createProject(name, opts) {
     country: opts.country,
     language: opts.language,
     providers: opts.providers ?? [],
-    providerModels: opts.providerModels ?? {}
+    providerModels: opts.providerModels ?? {},
+    ...opts.providerDispatchModes && Object.keys(opts.providerDispatchModes).length > 0 ? { providerDispatchModes: opts.providerDispatchModes } : {}
   });
+  warnDroppedDispatchModes(opts.providerDispatchModes ?? {}, result);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
   console.log(`Project created: ${result.name} (${result.id})`);
 }
+function warnDroppedDispatchModes(sent, result) {
+  const kept = result.providerDispatchModes ?? {};
+  const dropped = Object.keys(sent).filter((provider) => !(provider in kept));
+  if (dropped.length > 0) {
+    console.error(`Warning: Dropped dispatch mode for engine(s) the project does not measure: ${dropped.join(", ")}`);
+  }
+}
 async function listProjects(format) {
   const client = getClient22();
   const projects2 = await client.listProjects();
@@ -12022,6 +12247,9 @@ async function showProject(name, format) {
   console.log(`  Providers:        ${(project.providers ?? []).length > 0 ? project.providers.join(", ") : "all configured"}`);
   const providerModels = Object.entries(project.providerModels ?? {});
   console.log(`  Model overrides:  ${providerModels.length > 0 ? providerModels.map(([provider, model]) => `${provider}=${model}`).join(", ") : "(none; instance settings inherited)"}`);
+  const dispatchModes = Object.entries(project.providerDispatchModes ?? {}).sort(([left], [right]) => left.localeCompare(right));
+  console.log(`  Dispatch modes:   ${dispatchModes.length > 0 ? `${dispatchModes.map(([provider, mode]) => `${provider}=${mode}`).join(", ")} (scheduled sweeps; others sync)` : "(none; every provider runs sync)"}`);
+  console.log(`  Negative reviews: ${resolveNegativeReviewMaxStars(project.negativeReviewMaxStars)} stars or fewer${project.negativeReviewMaxStars == null ? " (default)" : ""}`);
   console.log(`  Tags:             ${project.tags.length > 0 ? project.tags.join(", ") : "(none)"}`);
   const labelEntries = Object.entries(project.labels);
   console.log(`  Labels:           ${labelEntries.length > 0 ? labelEntries.map(([k, v]) => `${k}=${v}`).join(", ") : "(none)"}`);
@@ -12066,6 +12294,9 @@ async function updateProjectSettings(name, opts) {
       );
     }
   }
+  const touchesDispatch = Object.keys(opts.dispatchModes ?? {}).length > 0 || (opts.clearDispatchModes ?? []).length > 0;
+  const providerDispatchModes = { ...project.providerDispatchModes ?? {}, ...opts.dispatchModes ?? {} };
+  for (const provider of opts.clearDispatchModes ?? []) delete providerDispatchModes[provider];
   const result = await client.putProject(name, {
     displayName: nextDisplayName,
     canonicalDomain: opts.domain ?? project.canonicalDomain,
@@ -12077,10 +12308,15 @@ async function updateProjectSettings(name, opts) {
     labels: project.labels,
     providers: opts.providers ?? project.providers,
     providerModels,
+    ...touchesDispatch ? { providerDispatchModes } : {},
     locations: project.locations,
     defaultLocation: project.defaultLocation,
-    autoExtractBacklinks: project.autoExtractBacklinks
+    autoExtractBacklinks: project.autoExtractBacklinks,
+    // Sent only when asked for: the server keeps the stored threshold when the
+    // field is absent, so a stale read cannot overwrite a newer setting.
+    ...opts.negativeReviewMaxStars !== void 0 ? { negativeReviewMaxStars: opts.negativeReviewMaxStars } : {}
   });
+  warnDroppedDispatchModes(touchesDispatch ? providerDispatchModes : project.providerDispatchModes ?? {}, result);
   if (isMachineFormat(opts.format)) {
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -12193,7 +12429,7 @@ async function setDefaultLocation(project, label, format) {
 var PROJECT_CLI_COMMANDS = [
   {
     path: ["project", "create"],
-    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--format json]",
+    usage: "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--format json]",
     help: "Create a project. Pass --domain for the public site to scan. Provider credentials are not required for Page Health.",
     options: {
       domain: { type: "string", short: "d" },
@@ -12203,13 +12439,14 @@ var PROJECT_CLI_COMMANDS = [
       language: stringOption(),
       "display-name": stringOption(),
       provider: multiStringOption(),
-      "provider-model": multiStringOption()
+      "provider-model": multiStringOption(),
+      "dispatch-mode": multiStringOption()
     },
     run: async (input) => {
       const name = requireProject(
         input,
         "project.create",
-        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--format json]"
+        "canonry project create <name> [--domain <domain>] [--owned-domain <domain>...] [--alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--provider-model provider=model...] [--dispatch-mode provider=sync|batch...] [--format json]"
       );
       await createProject(name, {
         domain: getString(input.values, "domain") ?? name,
@@ -12220,13 +12457,14 @@ var PROJECT_CLI_COMMANDS = [
         displayName: getString(input.values, "display-name") ?? name,
         providers: getStringArray(input.values, "provider") ?? [],
         providerModels: parseProviderModelAssignments(getStringArray(input.values, "provider-model")),
+        providerDispatchModes: parseDispatchModeAssignments(getStringArray(input.values, "dispatch-mode")),
         format: input.format
       });
     }
   },
   {
     path: ["project", "update"],
-    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--format json]",
+    usage: "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--dispatch-mode provider=sync|batch...] [--clear-dispatch-mode <provider>...] [--negative-review-max-stars <1-4|default>] [--format json]",
     options: {
       domain: { type: "string", short: "d" },
       "owned-domain": multiStringOption(),
@@ -12241,13 +12479,16 @@ var PROJECT_CLI_COMMANDS = [
       provider: multiStringOption(),
       "all-providers": { type: "boolean" },
       "provider-model": multiStringOption(),
-      "clear-provider-model": multiStringOption()
+      "clear-provider-model": multiStringOption(),
+      "dispatch-mode": multiStringOption(),
+      "clear-dispatch-mode": multiStringOption(),
+      "negative-review-max-stars": stringOption()
     },
     run: async (input) => {
       const name = requireProject(
         input,
         "project.update",
-        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--format json]"
+        "canonry project update <name> [--domain <domain>] [--owned-domain <domain>...] [--add-domain <domain>...] [--remove-domain <domain>...] [--alias <name>...] [--add-alias <name>...] [--remove-alias <name>...] [--country <code>] [--language <lang>] [--display-name <name>] [--provider <name>...] [--all-providers] [--provider-model provider=model...] [--clear-provider-model <provider>...] [--dispatch-mode provider=sync|batch...] [--clear-dispatch-mode <provider>...] [--negative-review-max-stars <1-4|default>] [--format json]"
       );
       const providers = getStringArray(input.values, "provider");
       const allProviders = getBoolean(input.values, "all-providers");
@@ -12257,6 +12498,11 @@ var PROJECT_CLI_COMMANDS = [
       for (const provider of clearProviderModels) {
         if (provider in providerModels) throw usageError(`Error: --provider-model and --clear-provider-model conflict for ${provider}`);
       }
+      const dispatchModes = parseDispatchModeAssignments(getStringArray(input.values, "dispatch-mode"));
+      const clearDispatchModes = getStringArray(input.values, "clear-dispatch-mode") ?? [];
+      for (const provider of clearDispatchModes) {
+        if (provider in dispatchModes) throw usageError(`Error: --dispatch-mode and --clear-dispatch-mode conflict for ${provider}`);
+      }
       await updateProjectSettings(name, {
         displayName: getString(input.values, "display-name"),
         domain: getString(input.values, "domain"),
@@ -12271,6 +12517,9 @@ var PROJECT_CLI_COMMANDS = [
         providers: allProviders ? [] : providers,
         providerModels,
         clearProviderModels,
+        dispatchModes,
+        clearDispatchModes,
+        negativeReviewMaxStars: parseNegativeReviewMaxStars(getString(input.values, "negative-review-max-stars")),
         format: input.format
       });
     }
@@ -12386,6 +12635,18 @@ var PROJECT_CLI_COMMANDS = [
     }
   }
 ];
+function parseDispatchModeAssignments(assignments) {
+  const result = {};
+  for (const assignment of assignments ?? []) {
+    const separator = assignment.indexOf("=");
+    const provider = separator === -1 ? "" : assignment.slice(0, separator).trim();
+    const mode = providerDispatchModeSchema.safeParse(separator === -1 ? "" : assignment.slice(separator + 1).trim().toLowerCase());
+    if (!provider || !mode.success) throw usageError(`Error: --dispatch-mode must use provider=sync or provider=batch (received ${assignment})`);
+    if (provider in result) throw usageError(`Error: duplicate --dispatch-mode assignment for ${provider}`);
+    result[provider] = mode.data;
+  }
+  return result;
+}
 function parseProviderModelAssignments(assignments) {
   const result = {};
   for (const assignment of assignments ?? []) {
@@ -12398,6 +12659,18 @@ function parseProviderModelAssignments(assignments) {
   }
   return result;
 }
+function parseNegativeReviewMaxStars(raw) {
+  if (raw === void 0) return void 0;
+  if (raw === "default") return null;
+  const parsed = gbpNegativeReviewMaxStarsSchema.safeParse(Number(raw));
+  if (!parsed.success) {
+    throw usageError('Error: --negative-review-max-stars must be 1, 2, 3, 4, or "default" (3)', {
+      message: '--negative-review-max-stars must be 1-4 or "default"',
+      details: { command: "project.update", value: raw }
+    });
+  }
+  return parsed.data;
+}
 
 // src/commands/report.ts
 import fs13 from "fs";
@@ -12533,6 +12806,27 @@ function getClient23() {
   return createApiClient();
 }
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
+function throwIfWaitedRunFailed(waited) {
+  const failed = waited.filter((r) => r.status === RunStatuses.failed);
+  if (failed.length === 0) return;
+  const reason = (r) => r.error ? formatRunErrorOneLine(r.error) : null;
+  const label = (r) => [r.project, r.location ? `(${r.location})` : null, `run ${r.runId}`].filter(Boolean).join(" ");
+  const message = waited.length === 1 ? `Run ${failed[0].runId} failed${reason(failed[0]) ? `: ${reason(failed[0])}` : ""}` : `${failed.length} of ${waited.length} runs failed: ${failed.map((r) => `${label(r)}${reason(r) ? `: ${reason(r)}` : ""}`).join("; ")}`;
+  throw new CliError({
+    code: "RUN_FAILED",
+    message,
+    exitCode: EXIT_SYSTEM_ERROR,
+    details: {
+      waitedRunCount: waited.length,
+      failedRuns: failed.map((r) => ({
+        runId: r.runId,
+        ...r.project ? { project: r.project } : {},
+        ...r.location ? { location: r.location } : {},
+        error: reason(r)
+      }))
+    }
+  });
+}
 async function triggerRun(project, opts) {
   const client = getClient23();
   const body = {};
@@ -12562,19 +12856,22 @@ async function triggerRun(project, opts) {
   if (opts?.probe) {
     body.trigger = "probe";
   }
+  if (opts?.dispatchMode) {
+    body.dispatchMode = opts.dispatchMode;
+  }
   const response = await client.triggerRun(project, body);
   if (Array.isArray(response)) {
     const locationRuns = response;
     if (isMachineFormat(opts?.format)) {
       if (opts?.wait) {
-        const settled = await Promise.all(
-          locationRuns.map(async (r) => {
-            if (!r.id || r.status === "conflict") return r;
-            const final = await pollRun2(client, r.id);
-            return { ...r, ...final };
-          })
+        const finals = await Promise.all(
+          locationRuns.map(async (r) => !r.id || r.status === "conflict" ? null : pollRun2(client, r.id, false))
         );
-        console.log(JSON.stringify(settled, null, 2));
+        console.log(JSON.stringify(locationRuns.map((r, i) => finals[i] ? { ...r, ...finals[i] } : r), null, 2));
+        throwIfWaitedRunFailed(locationRuns.flatMap((r, i) => {
+          const final = finals[i];
+          return final ? [{ runId: final.id, status: final.status, project, location: r.location ?? null, error: final.error }] : [];
+        }));
       } else {
         console.log(JSON.stringify(locationRuns, null, 2));
       }
@@ -12591,12 +12888,17 @@ async function triggerRun(project, opts) {
     }
     if (opts?.wait) {
       const pending = locationRuns.filter((r) => r.id && r.status !== "conflict" && !TERMINAL_STATUSES.has(r.status));
+      const errors = /* @__PURE__ */ new Map();
       if (pending.length > 0) {
         process.stderr.write(`Waiting for ${pending.length} run(s)`);
+        const batchWaits = /* @__PURE__ */ new Map();
         await Promise.all(
           pending.map(async (r) => {
             const final = await pollRun2(client, r.id);
             r.status = final.status;
+            errors.set(r.id, final.error);
+            const waiting = batchWaitLine(final);
+            if (waiting) batchWaits.set(r.id, waiting);
           })
         );
         process.stderr.write("\n");
@@ -12605,20 +12907,31 @@ async function triggerRun(project, opts) {
           const loc = (r.location ?? "(unknown)").padEnd(15);
           console.log(`  ${loc}  ${r.status}`);
         }
+        if (batchWaits.size > 0) console.log("");
+        for (const r of locationRuns) {
+          const waiting = batchWaits.get(r.id);
+          if (waiting) console.log(`  ${r.location ?? "(unknown)"}: ${waiting}`);
+        }
       }
+      throwIfWaitedRunFailed(locationRuns.filter((r) => r.id && r.status !== "conflict").map((r) => ({ runId: r.id, status: r.status, project, location: r.location ?? null, error: errors.get(r.id) })));
     }
     return;
   }
   const run = response;
   if (opts?.wait && run.id && !TERMINAL_STATUSES.has(run.status)) {
-    process.stderr.write(`Run ${run.id} started`);
-    const result = await pollRun2(client, run.id);
+    const showProgress = !isMachineFormat(opts?.format);
+    if (showProgress) process.stderr.write(`Run ${run.id} started`);
+    const result = await pollRun2(client, run.id, showProgress);
     if (isMachineFormat(opts?.format)) {
       console.log(JSON.stringify(result, null, 2));
     } else {
       process.stderr.write("\n");
       printRunDetail(result);
+      const waiting = batchWaitLine(result);
+      if (waiting) console.log(`
+${waiting}`);
     }
+    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project, error: result.error }]);
     return;
   }
   if (opts?.wait && (TERMINAL_STATUSES.has(run.status) || !run.id)) {
@@ -12628,6 +12941,7 @@ async function triggerRun(project, opts) {
     } else {
       printRunDetail(result);
     }
+    throwIfWaitedRunFailed([{ runId: result.id, status: result.status, project, error: result.error }]);
     return;
   }
   if (isMachineFormat(opts?.format)) {
@@ -12664,6 +12978,9 @@ async function triggerRunAll(opts) {
   if (opts?.noLocation) {
     baseBody.noLocation = true;
   }
+  if (opts?.dispatchMode) {
+    baseBody.dispatchMode = opts.dispatchMode;
+  }
   const results = [];
   for (const p of projects2) {
     const body = { ...baseBody };
@@ -12686,19 +13003,27 @@ async function triggerRunAll(opts) {
       results.push({ project: p.name, runId: "", status: "error", location: null, error: msg });
     }
   }
+  const errors = /* @__PURE__ */ new Map();
+  const batchWaits = /* @__PURE__ */ new Map();
   if (opts?.wait) {
     const pending = results.filter((r) => r.runId && !TERMINAL_STATUSES.has(r.status));
     if (pending.length > 0) {
-      process.stderr.write(`Waiting for ${pending.length} run(s)`);
+      const showProgress = !isMachineFormat(opts?.format);
+      if (showProgress) process.stderr.write(`Waiting for ${pending.length} run(s)`);
       await Promise.all(pending.map(async (r) => {
-        const final = await pollRun2(client, r.runId);
+        const final = await pollRun2(client, r.runId, showProgress);
         r.status = final.status;
+        errors.set(r.runId, final.error);
+        const waiting = batchWaitLine(final);
+        if (waiting) batchWaits.set(r.runId, waiting);
       }));
-      process.stderr.write("\n");
+      if (showProgress) process.stderr.write("\n");
     }
   }
+  const waited = results.filter((r) => r.runId).map((r) => ({ runId: r.runId, status: r.status, project: r.project, location: r.location, error: errors.get(r.runId) }));
   if (isMachineFormat(opts?.format)) {
     console.log(JSON.stringify(results, null, 2));
+    if (opts?.wait) throwIfWaitedRunFailed(waited);
     return;
   }
   const showLocationColumn = results.some((r) => r.location !== null);
@@ -12723,6 +13048,12 @@ async function triggerRunAll(opts) {
       console.log(`  ${proj}  ${id}  ${r.status}`);
     }
   }
+  if (batchWaits.size > 0) console.log("");
+  for (const r of results) {
+    const waiting = batchWaits.get(r.runId);
+    if (waiting) console.log(`  ${r.location ? `${r.project} (${r.location})` : r.project}: ${waiting}`);
+  }
+  if (opts?.wait) throwIfWaitedRunFailed(waited);
 }
 async function cancelRun(project, runId, format) {
   const client = getClient23();
@@ -12806,7 +13137,7 @@ async function listRuns(project, opts) {
   }
 }
 var POLL_TIMEOUT_MS3 = 10 * 60 * 1e3;
-async function pollRun2(client, runId) {
+async function pollRun2(client, runId, showProgress = true) {
   const deadline = Date.now() + POLL_TIMEOUT_MS3;
   for (; ; ) {
     await new Promise((r) => setTimeout(r, 2e3));
@@ -12814,12 +13145,22 @@ async function pollRun2(client, runId) {
       throw new Error(`Timed out waiting for run ${runId} after ${POLL_TIMEOUT_MS3 / 1e3}s`);
     }
     const run = await client.getRun(runId);
-    process.stderr.write(".");
-    if (TERMINAL_STATUSES.has(run.status)) {
+    if (showProgress) process.stderr.write(".");
+    if (TERMINAL_STATUSES.has(run.status) || outstandingBatches(run).length > 0) {
       return run;
     }
   }
 }
+function outstandingBatches(run) {
+  if (TERMINAL_STATUSES.has(run.status)) return [];
+  return (run.providerBatches ?? []).filter((batch) => OUTSTANDING_PROVIDER_BATCH_STATUSES.includes(batch.status));
+}
+function batchWaitLine(run) {
+  const outstanding = outstandingBatches(run);
+  if (outstanding.length === 0) return null;
+  const batches = outstanding.map((batch) => `${batch.provider} \u2014 ${batch.requestCount} requests, submitted ${batch.submittedAt ?? "unknown"}, deadline ${batch.deadlineAt}`);
+  return `Waiting on provider batch(es): ${batches.join("; ")}; check with canonry run show ${run.id}`;
+}
 function printRunDetail(run) {
   console.log(`Run: ${run.id}`);
   console.log(`  Status:   ${run.status}`);
@@ -12836,6 +13177,13 @@ function printRunDetail(run) {
       }
     }
   }
+  const batched = Object.keys(run.dispatchModes ?? {}).sort();
+  if (batched.length > 0) console.log(`  Dispatch: ${batched.map((provider) => `${provider}=batch`).join(", ")} (other providers sync)`);
+  if (run.providerBatches && run.providerBatches.length > 0) {
+    console.log("\n  Provider batches:");
+    for (const batch of run.providerBatches) console.log(`    ${providerBatchLine(batch)}`);
+  }
+  if (run.usage && run.usage.length > 0) printUsageTable(run.usage);
   if (run.snapshots && run.snapshots.length > 0) {
     console.log(`
   Snapshots: ${run.snapshots.length}  (cell = [citation][mention];  C=cited c=not, M=mentioned m=not, \u2013=no data)`);
@@ -12847,6 +13195,46 @@ function printRunDetail(run) {
     }
   }
 }
+function providerBatchLine(batch) {
+  const recorded = `${batch.recordedCount} of ${batch.requestCount} answers recorded`;
+  const withError = (text) => batch.error ? `${text} (${batch.error})` : text;
+  switch (batch.status) {
+    case ProviderBatchStatuses.submitting:
+      return `submitting provider batch: ${batch.provider} \u2014 ${batch.requestCount} requests`;
+    // The two outstanding statuses: the run stays `running` until they clear.
+    case ProviderBatchStatuses.submitted:
+    case ProviderBatchStatuses.ended:
+      return `waiting on provider batch: ${batch.provider} \u2014 ${batch.requestCount} requests, submitted ${batch.submittedAt ?? "unknown"}, deadline ${batch.deadlineAt}`;
+    case ProviderBatchStatuses.ingested:
+      return withError(`provider batch ${batch.provider}: ingested \u2014 ${recorded}`);
+    case ProviderBatchStatuses.cancelled:
+      return withError(`provider batch ${batch.provider}: cancelled \u2014 ${recorded}; the rest are missing and can be filled`);
+    case ProviderBatchStatuses.failed:
+      return withError(`provider batch ${batch.provider}: rejected by the provider \u2014 its ${batch.requestCount} answers ran sync instead`);
+    case ProviderBatchStatuses.unknown:
+      return withError(`provider batch ${batch.provider}: submit outcome unknown \u2014 never resubmitted; its ${batch.requestCount} answers stay missing`);
+  }
+}
+function printUsageTable(rows) {
+  const cost = (row) => row.estimatedCostMicros === null ? "unpriced" : `${formatMicros(row.estimatedCostMicros, "USD", { fractionDigits: 4, showTinyAsLessThan: true })}${row.unpricedAnswers > 0 ? ` (+${row.unpricedAnswers} unpriced)` : ""}`;
+  const table = rows.map((row) => [
+    row.provider,
+    row.pricingTier,
+    row.answers.toLocaleString("en-US"),
+    row.inputTokens.toLocaleString("en-US"),
+    row.cachedInputTokens.toLocaleString("en-US"),
+    row.cacheWriteTokens.toLocaleString("en-US"),
+    row.outputTokens.toLocaleString("en-US"),
+    row.searchCount.toLocaleString("en-US"),
+    cost(row)
+  ]);
+  const header = ["PROVIDER", "TIER", "ANSWERS", "INPUT", "CACHED", "CACHE WRITE", "OUTPUT", "SEARCHES", "EST. COST"];
+  const widths = header.map((title, index) => Math.max(title.length, ...table.map((cells) => cells[index].length)));
+  const line = (cells) => `    ${cells.map((cell2, index) => cell2.padEnd(widths[index])).join("  ").trimEnd()}`;
+  console.log("\n  Usage (answers with recorded usage; cost is an estimate):");
+  console.log(line(header));
+  for (const cells of table) console.log(line(cells));
+}
 var FILL_POLL_INTERVAL_MS = 3e3;
 var FILL_POLL_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
 function missingSummary(completeness) {
@@ -12934,8 +13322,8 @@ async function fillRun(runId, opts = {}) {
 }
 
 // src/cli-commands/run.ts
-var RUN_TRIGGER_USAGE = "canonry run trigger <project> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--wait] [--format json]";
-var RUN_USAGE2 = "canonry run <project|--all> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--wait] [--format json]";
+var RUN_TRIGGER_USAGE = "canonry run trigger <project> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--dispatch-mode sync|batch] [--wait] [--format json]";
+var RUN_USAGE2 = "canonry run <project|--all> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--dispatch-mode sync|batch] [--wait] [--format json]";
 var RUN_FILL_USAGE = "canonry run fill <run-id> [--provider <name>[,<name>]] [--dry-run] [--wait] [--format json]";
 var RUNS_USAGE = "canonry runs <project> [--limit <n>] [--kind <kind>] [--status <status>] [--format json]";
 var RUN_TRIGGER_OPTIONS = {
@@ -12954,13 +13342,26 @@ var RUN_TRIGGER_OPTIONS = {
   // for inspection but are excluded from dashboard / analytics /
   // intelligence / notifications. Use when you want to verify a
   // provider works without polluting the project's metrics.
-  probe: { type: "boolean", default: false }
+  probe: { type: "boolean", default: false },
+  // `batch` sends every provider that can to its asynchronous batch API (a
+  // full plan sweep, enabled in config.yaml); refused when none can.
+  "dispatch-mode": stringOption()
 };
+function parseDispatchMode(value, command, usage) {
+  if (value === void 0) return void 0;
+  const parsed = providerDispatchModeSchema.safeParse(value.trim().toLowerCase());
+  if (parsed.success) return parsed.data;
+  throw usageError(`Error: --dispatch-mode must be one of: ${providerDispatchModeSchema.options.join(", ")} (received ${value})`, {
+    message: "--dispatch-mode must be sync or batch",
+    details: { command, usage }
+  });
+}
 async function triggerRunCommand(input, command) {
   const groups = getStringArray(input.values, "group") ?? [];
   const targets = getStringArray(input.values, "target") ?? [];
   const queries2 = getStringArray(input.values, "query") ?? [];
   const usage = command === "run" ? RUN_USAGE2 : RUN_TRIGGER_USAGE;
+  const dispatchMode = parseDispatchMode(getString(input.values, "dispatch-mode"), command, usage);
   if (getBoolean(input.values, "all")) {
     if (input.positionals.length > 0) {
       throw usageError("Error: --all cannot be combined with a project name", {
@@ -12991,6 +13392,7 @@ async function triggerRunCommand(input, command) {
       wait: getBoolean(input.values, "wait"),
       allLocations: getBoolean(input.values, "all-locations"),
       noLocation: getBoolean(input.values, "no-location"),
+      dispatchMode,
       format: input.format
     });
     return;
@@ -13017,6 +13419,7 @@ async function triggerRunCommand(input, command) {
     allLocations: getBoolean(input.values, "all-locations"),
     noLocation: getBoolean(input.values, "no-location"),
     probe: getBoolean(input.values, "probe"),
+    dispatchMode,
     format: input.format
   });
 }
@@ -13474,7 +13877,7 @@ var SETTINGS_CLI_COMMANDS = [
       const name = requirePositional(input, 0, {
         command: "settings.provider",
         usage: "canonry settings provider <name> [--api-key <key>] [--base-url <url>] [--model <model>] [--max-concurrent <n>] [--max-per-minute <n>] [--max-per-day <n>] [--format json]",
-        message: "provider name is required (e.g. gemini, openai, claude, perplexity, local)"
+        message: "provider name is required (e.g. gemini, openai, claude, perplexity, muse, local)"
       });
       const apiKey = getString(input.values, "api-key");
       const baseUrl = getString(input.values, "base-url");
@@ -14289,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}`);
@@ -14307,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})`);
     }
   }
 }
@@ -14417,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}`);
@@ -14430,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) {
@@ -14459,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:");
@@ -14472,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) {
@@ -14492,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) {
@@ -14839,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("");
   }
 }
@@ -15060,6 +15455,7 @@ async function bootstrapCommand(opts) {
   if (providers.openai) mergedProviders.openai = providers.openai;
   if (providers.claude) mergedProviders.claude = providers.claude;
   if (providers.perplexity) mergedProviders.perplexity = providers.perplexity;
+  if (providers.muse) mergedProviders.muse = providers.muse;
   if (providers.local) mergedProviders.local = providers.local;
   if (env.googleClientId && !env.googleClientSecret || !env.googleClientId && env.googleClientSecret) {
     console.warn("Warning: GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET must both be set to configure Google OAuth. Skipping Google auth config.");
@@ -15453,6 +15849,7 @@ async function initCommand(opts) {
     OPENAI_API_KEY: opts?.openaiKey,
     ANTHROPIC_API_KEY: opts?.claudeKey,
     PERPLEXITY_API_KEY: opts?.perplexityKey,
+    MUSE_API_KEY: opts?.museKey,
     LOCAL_BASE_URL: opts?.localUrl,
     LOCAL_MODEL: opts?.localModel,
     LOCAL_API_KEY: opts?.localKey,
@@ -15471,7 +15868,7 @@ async function initCommand(opts) {
   }
   const envProviders = bootstrapEnv.providers;
   const envGoogleConfigured = !!(bootstrapEnv.googleClientId && bootstrapEnv.googleClientSecret);
-  const nonInteractive = !!(envProviders.gemini || envProviders.openai || envProviders.claude || envProviders.perplexity || envProviders.local || envGoogleConfigured);
+  const nonInteractive = !!(envProviders.gemini || envProviders.openai || envProviders.claude || envProviders.perplexity || envProviders.muse || envProviders.local || envGoogleConfigured);
   const providers = {};
   let google;
   if (isMachineFormat(format) && !nonInteractive) {
@@ -15497,6 +15894,7 @@ async function initCommand(opts) {
     console.log("Configure AI providers (at least one required):\n");
     console.log("Tip: For non-interactive setup, pass provider flags or set");
     console.log("GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, PERPLEXITY_API_KEY,");
+    console.log("MUSE_API_KEY,");
     console.log("GOOGLE_CLIENT_ID, and GOOGLE_CLIENT_SECRET env vars.");
     console.log('Or use "canonry bootstrap".\n');
     const geminiApiKey = await promptProviderApiKey("Gemini", "GEMINI_API_KEY");
@@ -15519,6 +15917,11 @@ async function initCommand(opts) {
       const perplexityModel = await prompt("  Perplexity preset or model [fast]: ") || "fast";
       providers.perplexity = { apiKey: perplexityApiKey, model: perplexityModel, quota: DEFAULT_QUOTA };
     }
+    const museApiKey = await promptProviderApiKey("Muse", "MUSE_API_KEY");
+    if (museApiKey) {
+      const museModel = await prompt("  Muse model [muse-spark-1.3]: ") || "muse-spark-1.3";
+      providers.muse = { apiKey: museApiKey, model: museModel, quota: DEFAULT_QUOTA };
+    }
     console.log("\nLocal LLM (Ollama, LM Studio, llama.cpp, vLLM \u2014 any OpenAI-compatible API):");
     const localBaseUrl = await prompt("Local LLM base URL (press Enter to skip, e.g. http://localhost:11434/v1): ");
     if (localBaseUrl) {
@@ -15547,7 +15950,7 @@ async function initCommand(opts) {
       };
     }
   }
-  const hasProvider = providers.gemini || providers.openai || providers.claude || providers.perplexity || providers.local;
+  const hasProvider = providers.gemini || providers.openai || providers.claude || providers.perplexity || providers.muse || providers.local;
   if (!hasProvider) {
     throw new CliError({
       code: "INIT_PROVIDER_REQUIRED",
@@ -16264,7 +16667,7 @@ var SYSTEM_CLI_COMMANDS = [
   },
   {
     path: ["init"],
-    usage: "canonry init [--force] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--local-url <url>] [--local-model <name>] [--local-key <key>] [--google-client-id <id>] [--google-client-secret <key>] [--skip-skills] [--skip-mcp] [--skills-dir <path>] [--format json]",
+    usage: "canonry init [--force] [--gemini-key <key>] [--openai-key <key>] [--claude-key <key>] [--perplexity-key <key>] [--muse-key <key>] [--local-url <url>] [--local-model <name>] [--local-key <key>] [--google-client-id <id>] [--google-client-secret <key>] [--skip-skills] [--skip-mcp] [--skills-dir <path>] [--format json]",
     help: 'Optional interactive provider and OAuth setup. First-run Page Health does not need this: use "canonry bootstrap", then "canonry serve". At least one provider is required here. --format json needs provider flags or environment variables.',
     options: {
       force: { type: "boolean", short: "f", default: false },
@@ -16272,6 +16675,7 @@ var SYSTEM_CLI_COMMANDS = [
       "openai-key": stringOption(),
       "claude-key": stringOption(),
       "perplexity-key": stringOption(),
+      "muse-key": stringOption(),
       "local-url": stringOption(),
       "local-model": stringOption(),
       "local-key": stringOption(),
@@ -16289,6 +16693,7 @@ var SYSTEM_CLI_COMMANDS = [
         openaiKey: getString(input.values, "openai-key"),
         claudeKey: getString(input.values, "claude-key"),
         perplexityKey: getString(input.values, "perplexity-key"),
+        museKey: getString(input.values, "muse-key"),
         localUrl: getString(input.values, "local-url"),
         localModel: getString(input.values, "local-model"),
         localKey: getString(input.values, "local-key"),
@@ -16435,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}`
       );
     }
   }
@@ -16726,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}`);
     }
@@ -17419,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();
@@ -17438,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) {
@@ -17549,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));
@@ -17581,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) {
@@ -17595,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("  ")
       );
     }
@@ -17605,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)`
@@ -19789,6 +20191,7 @@ var TELEMETRY_ERROR_CODES = /* @__PURE__ */ new Set([
   "RUN_FILL_REFUSED",
   "RUN_FILL_IN_PROGRESS",
   "RUN_FILL_INCOMPLETE",
+  "RUN_FAILED",
   "API_ERROR",
   "CLI_ERROR",
   "CLI_USAGE_ERROR",