@canonry/canonry 5.28.1 → 5.29.1

package/dist/{chunk-7RKCDOWO.js → chunk-RHZKOXDZ.js}

@@ -61,6 +61,7 @@ import {
   GOOGLE_MARKETING_LIVE_READ_SCOPE,
   GOOGLE_MARKETING_STORED_SNAPSHOT_PAGE_MAX,
   GOOGLE_MARKETING_WRITE_SCOPE,
+  GaMoverChangeBases,
   GoogleAdsCampaignStatuses,
   GoogleAdsConnectionStates,
   GoogleAdsGoalConfigurationLevels,
@@ -92,6 +93,7 @@ import {
   MEASUREMENT_PORTFOLIO_TIE_NOTE,
   MEASUREMENT_PROPERTY_CITED_DOMAINS_LIMIT,
   MIN_DOMAIN_BRAND_KEY_LENGTH,
+  MIN_PCT_BASE,
   MIN_TREND_POINTS,
   MODEL_ATTRIBUTION_EVENT_LIMIT,
   MeasurementEvidenceShapes,
@@ -110,6 +112,7 @@ import {
   REPORT_VISIBILITY_COPY,
   RESEARCH_RUN_SCOPE,
   RUN_FILL_MAX_AGE_MS,
+  RatioUnits,
   ReportSectionIds,
   ResearchQueryStatuses,
   ResearchRunStatuses,
@@ -211,6 +214,7 @@ import {
   aggregateHarvestedQueries,
   aiReferralClassCounts,
   alreadyExists,
+  answerProseForMentions,
   apiKeyDtoSchema,
   apiKeyListDtoSchema,
   applyHarvestSemanticNovelty,
@@ -238,6 +242,7 @@ import {
   brandKeyFromText,
   brandLabelFromDomain,
   brandMetricsDtoSchema,
+  breakdownShares,
   buildHarvestAnchorTerms,
   buildMeasurementExecutionIdentity,
   buildMeasurementRunManifestV1,
@@ -351,8 +356,8 @@ import {
   formatIsoDate,
   formatIsoDateInTimeZone,
   formatNumber,
-  formatRatio,
-  formatWholePercent,
+  formatPercent,
+  formatSignedPercent,
   formatWindowCountDelta,
   ga4AiReferralDailyDtoSchema,
   ga4AiReferralHistoryEntrySchema,
@@ -361,9 +366,12 @@ import {
   ga4SocialReferralHistoryEntrySchema,
   ga4StatusDtoSchema,
   ga4SyncResponseDtoSchema,
+  gaAttributionTrendResponseSchema,
   gaMeasurementAnalysisDtoSchema,
   gaMeasurementAnalysisWindowSchema,
   gaMeasurementHostScopeSchema,
+  gaSocialReferralTrendResponseSchema,
+  gaTrafficResponseSchema,
   gateHarvestedSearchQueries,
   gbpAccountListResponseSchema,
   gbpAttributesListResponseSchema,
@@ -584,6 +592,7 @@ import {
   parseRunError,
   parseStoredMeasurementPlanAnyVersion,
   parseWindow,
+  percentOf,
   pickClusterRepresentative,
   prepareBrandMatchText,
   projectConfigSchema,
@@ -665,6 +674,7 @@ import {
   reportProviderRateLabel,
   reportQueryClassLabel,
   reportRateDeltaCopy,
+  reportRateDeltaValue,
   reportReferralRedirectNote,
   reportServerActivityAgencyOperatorHeaders,
   reportServerActivityAgencyTiles,
@@ -708,6 +718,7 @@ import {
   resultsClearResponseSchema,
   resultsExportDtoSchema,
   retryAfterDelayMs,
+  roundRatio,
   runCompletenessDtoSchema,
   runDetailDtoSchema,
   runDtoSchema,
@@ -734,6 +745,7 @@ import {
   segmentCrawlerHits,
   serializeRunError,
   settingsDtoSchema,
+  shareOf,
   shareOfVoiceReason,
   shareOfVoiceSummary,
   shiftIsoCalendarDate,
@@ -772,6 +784,7 @@ import {
   sourceBreakdownDtoSchema,
   sourceBreakdownQuerySchema,
   splitList,
+  stripCitationChips,
   sumInfraHits,
   summarizeCheckResults,
   summarizeRunUsage,
@@ -825,7 +838,7 @@ import {
   wordpressSchemaDeployResultDtoSchema,
   wordpressSchemaStatusResultDtoSchema,
   wordpressStatusDtoSchema
-} from "./chunk-KVQHG3WB.js";
+} from "./chunk-FKL5EGOW.js";
 
 // src/intelligence-service.ts
 import { eq as eq79, desc as desc34, asc as asc14, and as and66, ne as ne13, or as or18, inArray as inArray29, gte as gte21, lte as lte18, isNull as isNull14, sql as sql29, exists } from "drizzle-orm";
@@ -9059,8 +9072,7 @@ function buildDrivers(input) {
     drivers.push(`${formatImpressions(input.gscImpressions)} GSC impressions`);
   }
   if (input.recentMissRate >= 0.5 && input.competitorCount > 0) {
-    const pct = Math.round(clamp01(input.recentMissRate) * 100);
-    drivers.push(`missed in ${pct}% of recent runs`);
+    drivers.push(`missed in ${formatPercent(clamp01(input.recentMissRate))} of recent runs`);
   }
   if (input.action === "create" && input.position === null) {
     drivers.push("no existing page");
@@ -9443,8 +9455,8 @@ function buildCitationScorecard(snapshots, queryLookup) {
   }
   const providerRates = providerList.map((provider) => {
     const counts2 = providerCounts.get(provider) ?? { cited: 0, mentioned: 0, total: 0 };
-    const citationRate = counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0;
-    const mentionRate3 = counts2.total > 0 ? Math.round(counts2.mentioned / counts2.total * 100) : 0;
+    const citationRate = percentOf(counts2.cited, counts2.total) ?? 0;
+    const mentionRate3 = percentOf(counts2.mentioned, counts2.total) ?? 0;
     return {
       provider,
       citedCount: counts2.cited,
@@ -9485,8 +9497,9 @@ function compileCompetitiveSignalResolver(competitorDomains) {
         ...evidence.citedDomains ?? [],
         ...(evidence.groundingSources ?? []).map((source) => source.uri)
       ];
-      const answerDomains2 = evidence.answerDomains ?? extractDomainsFromText(evidence.answerText);
-      const mentionedBrandKeys = matchedAliasKeys(domainBrandMatcher, evidence.answerText);
+      const prose = answerProseForMentions(evidence.answerText);
+      const answerDomains2 = evidence.answerDomains ?? extractDomainsFromText(prose);
+      const mentionedBrandKeys = matchedAliasKeys(domainBrandMatcher, prose);
       const citedCompetitorDomains = [];
       const mentionedCompetitorDomains = [];
       for (const identity of identities) {
@@ -9549,7 +9562,7 @@ function buildCompetitorLandscape(snapshots, competitorDomains, projectDomains,
       else if (ratio >= 0.2) pressureLabel = "Moderate";
       else pressureLabel = "Low";
     }
-    const sharePct = totalCitedSlots > 0 ? Math.round(data.count / totalCitedSlots * 100) : 0;
+    const sharePct = percentOf(data.count, totalCitedSlots) ?? 0;
     const theirCitedPages = [...data.pages.entries()].map(([url, qs]) => ({ url, citedFor: [...qs].sort() })).sort((a, b) => b.citedFor.length - a.citedFor.length);
     return {
       domain,
@@ -9584,17 +9597,37 @@ function toBreakdown(tally, competitors2) {
   const perCompetitor = competitors2.map((c) => ({
     domain: c.domain,
     mentionSnapshots: tally.competitorCounts.get(c.domain) ?? 0,
-    shareOfCompetitiveTotal: competitorMentionSnapshots > 0 ? Math.round((tally.competitorCounts.get(c.domain) ?? 0) / competitorMentionSnapshots * 1e3) / 10 : 0
+    shareOfCompetitiveTotal: percentOf(tally.competitorCounts.get(c.domain) ?? 0, competitorMentionSnapshots) ?? 0
   })).filter((row) => row.mentionSnapshots > 0).sort((a, b) => b.mentionSnapshots - a.mentionSnapshots || (a.domain < b.domain ? -1 : 1));
   return {
     projectMentionSnapshots: tally.projectMentionSnapshots,
     competitorMentionSnapshots,
+    combinedMentionSnapshots: denom,
     perCompetitor,
+    ranking: rankMentionShare(tally, competitors2, denom),
     snapshotsWithAnswerText: tally.snapshotsWithAnswerText,
     snapshotsTotal: tally.snapshotsTotal,
-    score: denom > 0 ? Math.round(tally.projectMentionSnapshots / denom * 100) : null
+    score: percentOf(tally.projectMentionSnapshots, denom)
   };
 }
+function rankMentionShare(tally, competitors2, denom) {
+  if (competitors2.length === 0 || denom === 0) return [];
+  const project = {
+    kind: "project",
+    domain: null,
+    mentionSnapshots: tally.projectMentionSnapshots,
+    share: tally.projectMentionSnapshots / denom
+  };
+  const rivals = competitors2.map((c) => ({ domain: c.domain, mentionSnapshots: tally.competitorCounts.get(c.domain) ?? 0 })).sort((a, b) => b.mentionSnapshots - a.mentionSnapshots || (a.domain < b.domain ? -1 : 1)).map((c) => ({
+    kind: "competitor",
+    domain: c.domain,
+    mentionSnapshots: c.mentionSnapshots,
+    share: c.mentionSnapshots / denom
+  }));
+  const firstNotAbove = rivals.findIndex((row) => row.mentionSnapshots <= project.mentionSnapshots);
+  const at = firstNotAbove === -1 ? rivals.length : firstNotAbove;
+  return [...rivals.slice(0, at), project, ...rivals.slice(at)];
+}
 function buildMentionShare(snapshots, options) {
   const competitorMatchers = new Map(
     options.competitors.map((c) => [c.domain, compileBrandAliases(usableBrandAliases([...c.brandTokens]))])
@@ -9610,7 +9643,7 @@ function buildMentionShare(snapshots, options) {
     tally.snapshotsWithAnswerText++;
     if (snap.projectMentioned) tally.projectMentionSnapshots++;
     if (options.competitors.length === 0) continue;
-    const prepared = prepareBrandMatchText(text2);
+    const prepared = prepareBrandMatchText(answerProseForMentions(text2));
     for (const competitor of options.competitors) {
       const matcher = competitorMatchers.get(competitor.domain);
       if (matcher && matcherMatchesText(matcher, prepared)) {
@@ -9691,7 +9724,7 @@ function buildMentionShare(snapshots, options) {
       value: "No mentions",
       delta: scopeLabel(scope, "No brand mentions in this run"),
       tone: "neutral",
-      description: describe({ scope, score, breakdown: headline, branded: brandedBreakdown }),
+      description: describe({ scope, breakdown: headline, branded: brandedBreakdown }),
       tooltip,
       trend: [],
       scope,
@@ -9701,10 +9734,10 @@ function buildMentionShare(snapshots, options) {
   }
   return {
     label: "Mention Share",
-    value: `${score}`,
+    value: formatPercent(headline.projectMentionSnapshots / denom),
     delta: scopeLabel(scope, `${headline.projectMentionSnapshots} of ${denom} brand mentions`),
     tone: mentionShareTone(score),
-    description: describe({ scope, score, breakdown: headline, branded: brandedBreakdown }),
+    description: describe({ scope, breakdown: headline, branded: brandedBreakdown }),
     tooltip,
     trend: [],
     progress: score,
@@ -9722,7 +9755,7 @@ function mentionShareTone(score) {
   return "negative";
 }
 function describe(parts) {
-  const { scope, score, breakdown: breakdown2, branded } = parts;
+  const { scope, breakdown: breakdown2, branded } = parts;
   const { projectMentionSnapshots, competitorMentionSnapshots, perCompetitor } = breakdown2;
   const where = scope === "non-brand" ? "on non-brand queries" : "across your tracked queries";
   const brandedNote = branded.snapshotsWithAnswerText > 0 && branded.score !== null ? ` Separately, you are named in ${branded.projectMentionSnapshots} of ${branded.snapshotsWithAnswerText} answers to queries that contain your name.` : "";
@@ -9734,10 +9767,11 @@ function describe(parts) {
   }
   const top = perCompetitor[0];
   const total = projectMentionSnapshots + competitorMentionSnapshots;
+  const share = formatPercent(projectMentionSnapshots / total);
   if (!top) {
-    return `${score}% of brand mentions ${where} are you (${projectMentionSnapshots} of ${total}).${brandedNote}`;
+    return `${share} of brand mentions ${where} are you (${projectMentionSnapshots} of ${total}).${brandedNote}`;
   }
-  return `${score}% of brand mentions ${where} are you. Top competitor: ${top.domain} (${top.mentionSnapshots} mentions).${brandedNote}`;
+  return `${share} of brand mentions ${where} are you. Top competitor: ${top.domain} (${top.mentionSnapshots} mentions).${brandedNote}`;
 }
 
 // ../intelligence/src/share-of-voice-frame.ts
@@ -9754,7 +9788,7 @@ function buildShareOfVoiceFrame(input) {
     basis,
     reason,
     availability: reason === null ? "measured" : "not-measured",
-    score: reason === null ? Math.round(input.projectMentions / denominator * 1e3) / 10 : null,
+    score: reason === null ? percentOf(input.projectMentions, denominator) : null,
     denominator,
     competitorMentions,
     domains
@@ -9875,7 +9909,7 @@ function buildCompetitorLandscapeHistory(options) {
         for (const candidate of frozen.values()) putCandidate(eligibleCandidates, candidate);
         combined = combineMatchers([...eligibleCandidates.values()].map((candidate) => candidate.matcher));
       }
-      const matchedKeys = matchedAliasKeys(combined, text2);
+      const matchedKeys = matchedAliasKeys(combined, answerProseForMentions(text2));
       if (matchedKeys.size > 0) {
         for (const candidate of eligibleCandidates.values()) {
           for (const key of candidate.matcher.keys) {
@@ -10058,7 +10092,7 @@ function finalizeRow(row, answeredResults, mentionCredits, competitive) {
     surfaceClass: row.surfaceClass,
     pinned: row.pinned,
     mentionCount: row.mentionCount,
-    shareOfVoice: competitive ? mentionCredits > 0 ? roundPercentage(row.mentionCount / mentionCredits * 100) : null : null,
+    shareOfVoice: competitive ? percentOf(row.mentionCount, mentionCredits) : null,
     citationCount: row.citationCount,
     answeredResults,
     firstSeenAt: row.firstSeenAt,
@@ -10066,9 +10100,6 @@ function finalizeRow(row, answeredResults, mentionCredits, competitive) {
     sampleUrls: [...row.sampleUrls]
   };
 }
-function roundPercentage(value) {
-  return Math.round(value * 10) / 10;
-}
 function compareCompetitiveRows(a, b) {
   return b.mentionCount - a.mentionCount || b.citationCount - a.citationCount || a.domain.localeCompare(b.domain);
 }
@@ -10097,7 +10128,7 @@ function toSection(tally) {
       else if (ratio >= 0.2) pressureLabel = "Moderate";
       else pressureLabel = "Low";
     }
-    const sharePct = totalMentionedSlots > 0 ? Math.round(data.count / totalMentionedSlots * 100) : null;
+    const sharePct = percentOf(data.count, totalMentionedSlots);
     return {
       domain,
       mentionCount: data.count,
@@ -10186,7 +10217,7 @@ function buildAiSourceOrigin(snapshots, projectDomains, competitorDomains, topDo
     category,
     label,
     count: count4,
-    sharePct: totalCitations > 0 ? Math.round(count4 / totalCitations * 100) : 0
+    sharePct: percentOf(count4, totalCitations) ?? 0
   })).sort((a, b) => b.count - a.count);
   const topDomains = [...domainCounts.entries()].map(([domain, count4]) => ({
     domain,
@@ -10378,13 +10409,13 @@ function buildVisibilityScore(snapshots, options) {
   }
   const totalCount = queryCited.size;
   const citedCount = [...queryCited.values()].filter(Boolean).length;
-  const score = totalCount > 0 ? Math.round(citedCount / totalCount * 100) : 0;
+  const score = percentOf(citedCount, totalCount) ?? 0;
   const runProviders = new Set(snapshots.map((s) => s.provider));
   const runApiProviderCount = options.configuredApiProviders.filter((p) => runProviders.has(p)).length;
   const isPartialProviderRun = options.configuredApiProviders.length > 1 && runApiProviderCount < options.configuredApiProviders.length;
   return {
     label: "Citation Coverage",
-    value: `${score}`,
+    value: formatPercent(citedCount / totalCount),
     delta: `${citedCount} of ${totalCount} queries cited`,
     tone: isPartialProviderRun ? "caution" : scoreTone(score),
     description: `${citedCount} of ${totalCount} tracked queries found your domain in at least one AI answer engine.`,
@@ -10416,13 +10447,13 @@ function buildMentionCoverage(snapshots, options) {
   }
   const totalCount = queryMentioned.size;
   const mentionedCount = [...queryMentioned.values()].filter(Boolean).length;
-  const score = totalCount > 0 ? Math.round(mentionedCount / totalCount * 100) : 0;
+  const score = percentOf(mentionedCount, totalCount) ?? 0;
   const runProviders = new Set(snapshots.map((s) => s.provider));
   const runApiProviderCount = options.configuredApiProviders.filter((p) => runProviders.has(p)).length;
   const isPartialProviderRun = options.configuredApiProviders.length > 1 && runApiProviderCount < options.configuredApiProviders.length;
   return {
     label: "Mention Coverage",
-    value: `${score}`,
+    value: formatPercent(mentionedCount / totalCount),
     delta: `${mentionedCount} of ${totalCount} queries mentioned`,
     tone: isPartialProviderRun ? "caution" : scoreTone(score),
     description: `${mentionedCount} of ${totalCount} tracked queries had your brand or domain in the AI answer text.`,
@@ -10468,7 +10499,7 @@ function buildGapQueryScore(snapshots) {
     description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} currently cite competitors without citing your domain.` : "No competitive citation gaps detected in the latest visibility run.",
     tooltip,
     trend: [],
-    progress: totalCount > 0 ? Math.round(gapCount / totalCount * 100) : 0
+    progress: percentOf(gapCount, totalCount) ?? 0
   };
 }
 function buildMentionGapScore(snapshots) {
@@ -10505,7 +10536,7 @@ function buildMentionGapScore(snapshots) {
     description: gapCount > 0 ? `${gapCount} tracked ${gapQueryLabel} mention competitors but never your brand.` : "No competitive mention gaps detected in the latest visibility run.",
     tooltip,
     trend: [],
-    progress: totalCount > 0 ? Math.round(gapCount / totalCount * 100) : 0
+    progress: percentOf(gapCount, totalCount) ?? 0
   };
 }
 
@@ -10586,7 +10617,7 @@ function buildProviderScores(snapshots) {
   ).map(({ provider, model, cited, total }) => ({
     provider,
     model,
-    score: total > 0 ? Math.round(cited / total * 100) : 0,
+    score: percentOf(cited, total) ?? 0,
     cited,
     total
   }));
@@ -10608,9 +10639,9 @@ function buildRunHistory(runs2, snapshotsByRunId, limit = DEFAULT_RUN_HISTORY_LI
     }
     const totalCount = queryCited.size;
     const citedCount = [...queryCited.values()].filter(Boolean).length;
-    const citationRate = totalCount > 0 ? Math.round(citedCount / totalCount * 100) : 0;
+    const citationRate = percentOf(citedCount, totalCount) ?? 0;
     const mentionedCount = [...queryMentioned.values()].filter(Boolean).length;
-    const mentionRate3 = totalCount > 0 ? Math.round(mentionedCount / totalCount * 100) : 0;
+    const mentionRate3 = percentOf(mentionedCount, totalCount) ?? 0;
     return {
       runId: run.id,
       createdAt: run.createdAt,
@@ -10642,7 +10673,8 @@ function buildProviderTrends(runs2, snapshotsByRunId, limit = 12) {
     }
     for (const key of keys) {
       const queryMap = perKey.get(key);
-      const rate2 = queryMap && queryMap.size > 0 ? Math.round([...queryMap.values()].filter(Boolean).length / queryMap.size * 100) : 0;
+      const cited = queryMap ? [...queryMap.values()].filter(Boolean).length : 0;
+      const rate2 = percentOf(cited, queryMap?.size ?? 0) ?? 0;
       result.get(key).push({ rate: rate2, createdAt: run.createdAt });
     }
   }
@@ -10713,7 +10745,7 @@ function formatImpressions2(value) {
 
 // ../intelligence/src/smoothed-delta.ts
 var SMOOTHED_RUN_DELTA_MAX_WINDOW = 3;
-function smoothedRunDelta(points, valueFn, maxWindow = SMOOTHED_RUN_DELTA_MAX_WINDOW) {
+function smoothedRunDelta(points, valueFn, maxWindow = SMOOTHED_RUN_DELTA_MAX_WINDOW, ratioUnit) {
   if (points.length < 2) return null;
   const window = Math.min(maxWindow, Math.floor(points.length / 2));
   const tail = points.slice(-window);
@@ -10721,8 +10753,9 @@ function smoothedRunDelta(points, valueFn, maxWindow = SMOOTHED_RUN_DELTA_MAX_WI
   const sum = (arr) => arr.reduce((s, p) => s + valueFn(p), 0);
   const currentAvg = sum(tail) / tail.length;
   const priorAvg = sum(prior) / prior.length;
-  const current = roundTo1Decimal(currentAvg);
-  const prior_ = roundTo1Decimal(priorAvg);
+  const round = (value) => ratioUnit ? roundRatio(value, ratioUnit) : roundTo1Decimal(value);
+  const current = round(currentAvg);
+  const prior_ = round(priorAvg);
   return {
     current,
     prior: prior_,
@@ -10819,7 +10852,7 @@ function analyzeGbp(signals) {
         ...base,
         type: "gbp-metric-drop",
         severity: abs >= GBP_METRIC_SEVERE_PCT ? "high" : "medium",
-        title: `${loc.displayName}: ${metricLabel(worstMetric.metric)} down ${abs}% week-over-week`,
+        title: `${loc.displayName}: ${metricLabel(worstMetric.metric)} down ${formatPercent(abs, RatioUnits.percent)} week-over-week`,
         recommendation: {
           action: "Investigate the local-visibility drop (profile changes, category edits, new competition)",
           reason: `${metricLabel(worstMetric.metric)} fell from ${worstMetric.prior} to ${worstMetric.recent} (last 7d vs the prior 7d).`
@@ -10833,7 +10866,7 @@ function analyzeGbp(signals) {
         ...base,
         type: "gbp-keyword-drop",
         severity: worstKeyword.dropPct >= GBP_KEYWORD_SEVERE_PCT && !actionsHeldUp(loc) ? "high" : "medium",
-        title: `${loc.displayName}: "${worstKeyword.keyword}" impressions down ${worstKeyword.dropPct}% month-over-month${window}`,
+        title: `${loc.displayName}: "${worstKeyword.keyword}" impressions down ${formatPercent(worstKeyword.dropPct, RatioUnits.percent)} month-over-month${window}`,
         recommendation: {
           action: "Check whether the property still ranks for this local search term and refresh the profile",
           reason: `Search-keyword impressions for "${worstKeyword.keyword}" fell from ${worstKeyword.prior} to ${worstKeyword.recent} month-over-month.`
@@ -10867,7 +10900,7 @@ function pickWorstKeywordDrop(loc) {
     if (point.recent == null || point.prior == null || point.prior < GBP_KEYWORD_MIN_BASELINE) continue;
     const changeRatio = relativeChangeRatio(point.recent, point.prior);
     if (changeRatio === null) continue;
-    const dropPct = Math.round(-changeRatio * 100);
+    const dropPct = roundRatio(-changeRatio * 100, RatioUnits.percent);
     if (dropPct < GBP_KEYWORD_DROP_PCT) continue;
     if (!worst || dropPct > worst.dropPct) {
       worst = { keyword: point.keyword, dropPct, recent: point.recent, prior: point.prior };
@@ -13288,8 +13321,8 @@ function aliasMatchesAt(textWords, aliasWords, start) {
   }
   return true;
 }
-function containsAnyAlias(answerText, aliases) {
-  const textWords = words(answerText);
+function containsAnyAlias(prose, aliases) {
+  const textWords = words(prose);
   const candidates = aliases.map(words).filter((alias2) => alias2.length > 0);
   for (let start = 0; start < textWords.length; start++) {
     if (candidates.some((alias2) => aliasMatchesAt(textWords, alias2, start))) return true;
@@ -13431,6 +13464,7 @@ function prepareReport(input, options = {}, detailedEvidence = true) {
     if (!source.complete) evidenceIncomplete.add(observation.id);
     observationsBySlot.set(slot.id, {
       input: observation,
+      mentionText: answerProseForMentions(observation.answerText),
       slot,
       bridged: isBridged,
       historical: source.historical,
@@ -13466,7 +13500,7 @@ function prepareReport(input, options = {}, detailedEvidence = true) {
       const source = sourceAttribution(url);
       return source.classification === "matched" ? source.matchedTargetIds : [];
     }));
-    const mentions = resolveMentionIdentity(observation.input.answerText, input.targets, aliasesByFirstWord, citedTargetIds, ambiguityPatterns);
+    const mentions = resolveMentionIdentity(observation.mentionText, input.targets, aliasesByFirstWord, citedTargetIds, ambiguityPatterns);
     observation.mentionedTargetIds = mentions.mentioned;
     observation.unknownMentionTargetIds = mentions.unknown;
     observation.citedTargetIds = citedTargetIds;
@@ -13645,7 +13679,7 @@ function buildSovForSlots(slots, competitors2, projectBrandNames, projectDomain,
         return { domain: row.domain, own: row.own, presentIn: null, of: null, reason: "aliasless" };
       }
       const presentIn = selected.filter((slot) => {
-        const answer = prepared.observationsBySlot.get(slot.id)?.input.answerText;
+        const answer = prepared.observationsBySlot.get(slot.id)?.mentionText;
         return answer !== null && answer !== void 0 && containsAnyAlias(answer, row.aliases);
       }).length;
       return { domain: row.domain, own: row.own, presentIn, of: selected.length };
@@ -13842,7 +13876,7 @@ function targetMentionRate(targets, slots, answered2, indexes) {
 }
 function presenceIn(slots, aliases, prepared) {
   return slots.filter((slot) => {
-    const answer = prepared.observationsBySlot.get(slot.id)?.input.answerText;
+    const answer = prepared.observationsBySlot.get(slot.id)?.mentionText;
     return answer !== null && answer !== void 0 && containsAnyAlias(answer, aliases);
   }).length;
 }
@@ -16206,7 +16240,7 @@ function buildMentionShareInputs(opts) {
     snapshots: opts.snapshots.map((snap) => {
       const queryText = (snap.queryId ? opts.queryTextById?.get(snap.queryId) : void 0) ?? snap.queryText ?? null;
       const cachedAnswerDomains = !snap.answerText || !opts.answerDomainsByText ? void 0 : opts.answerDomainsByText.get(snap.answerText) ?? (() => {
-        const domains = extractDomainsFromText(snap.answerText);
+        const domains = extractDomainsFromText(answerProseForMentions(snap.answerText));
         opts.answerDomainsByText.set(snap.answerText, domains);
         return domains;
       })();
@@ -25299,7 +25333,10 @@ function frozenCompetitorMatchers(competitors2) {
 function exactCompetitorMatchers(plan) {
   return frozenCompetitorMatchers(plan.groups.flatMap((group) => group.competitors));
 }
-function competitorSignals(snapshot, matchers, preparedAnswerText = prepareBrandMatchText(snapshot.answerText)) {
+function preparedAnswerProse(answerText) {
+  return prepareBrandMatchText(answerProseForMentions(answerText));
+}
+function competitorSignals(snapshot, matchers, preparedAnswerText = preparedAnswerProse(snapshot.answerText)) {
   const mentioned = preparedAnswerText === null ? [] : [...matchers].filter(([, matcher]) => matcherMatchesText(matcher, preparedAnswerText)).map(([domain]) => domain);
   const citedDomains = new Set(snapshot.citedDomains.map((value) => {
     try {
@@ -25517,7 +25554,7 @@ function frozenSimpleRun(run, definition, snapshots, includeEvidence = true) {
     }
     const slotId = `slot:simple:${query.queryId}:${provider}`;
     if (!slotKeys.has(slotId)) throw new Error(`Frozen simple definition has no slot for stored snapshot ${snapshot.id}`);
-    const preparedAnswerText = prepareBrandMatchText(snapshot.answerText);
+    const preparedAnswerText = preparedAnswerProse(snapshot.answerText);
     const mentioned = snapshot.answerText !== null ? matcherMatchesText(matcher, preparedAnswerText) : snapshot.answerMentioned === true;
     const competitorSignalsForSnapshot = !includeEvidence || competitors2 === null ? { mentioned: [], cited: [] } : competitorSignals(snapshot, competitors2, preparedAnswerText);
     observations.push({
@@ -28627,6 +28664,7 @@ async function analyticsRoutes(app) {
         byProvider: {},
         trend: "stable",
         mentionTrend: "stable",
+        windowChange: { citationRate: null, mentionRate: null, mentionShare: null },
         queryChanges: [],
         basketChanges: [],
         executionIdentityChanges: [],
@@ -28839,6 +28877,7 @@ async function analyticsRoutes(app) {
     }
     const trend = computeTrend(buckets, "citationRate");
     const mentionTrend = computeTrend(buckets, "mentionRate");
+    const windowChange = computeWindowChange(buckets);
     const queryChanges = computeQueryChanges(projectQueries, cutoff);
     const basketChanges = basketRevisions.slice(1).map((rev, i) => {
       const previous = new Set(basketRevisions[i].members);
@@ -28860,7 +28899,7 @@ async function analyticsRoutes(app) {
       }
       previousExecutionChecksum = identity.checksum;
     }
-    return reply.send({ window, mentionShareScope, buckets, overall, byProvider, trend, mentionTrend, queryChanges, basketChanges, executionIdentityChanges, referenceBasketRevision: latestBasket?.revision ?? null, modelAttribution, servedModelAttribution, modelServiceMismatch, modelPointerChanges });
+    return reply.send({ window, mentionShareScope, buckets, overall, byProvider, trend, mentionTrend, windowChange, queryChanges, basketChanges, executionIdentityChanges, referenceBasketRevision: latestBasket?.revision ?? null, modelAttribution, servedModelAttribution, modelServiceMismatch, modelPointerChanges });
   });
   app.get("/projects/:name/analytics/gaps", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -28939,9 +28978,10 @@ async function analyticsRoutes(app) {
           if (match) competitorsCiting.add(match);
         }
         if (!s.answerText) continue;
+        const prose = prepareBrandMatchText(answerProseForMentions(s.answerText));
         for (const competitor of competitorDomains) {
           const matcher = competitorMatchers.get(competitor);
-          if (matcher && matcherMatchesText(matcher, s.answerText)) competitorsMentioned.add(competitor);
+          if (matcher && matcherMatchesText(matcher, prose)) competitorsMentioned.add(competitor);
         }
       }
       const cons = consistencyMap.get(queryId);
@@ -29328,7 +29368,7 @@ function computeMentionShareBucketMetric(snapshots, mentionShareCompetitors, cla
     scope: result.scope,
     // A project-only denominator is recognition evidence, not competitive
     // share. Preserve the count but leave the rate undefined without a frame.
-    rate: mentionShareCompetitors.length > 0 && denominator > 0 ? round4(projectMentionSnapshots / denominator) : null,
+    rate: mentionShareCompetitors.length > 0 && denominator > 0 ? roundRatio(projectMentionSnapshots / denominator, RatioUnits.fraction) : null,
     projectMentionSnapshots,
     competitorMentionSnapshots
   };
@@ -29358,6 +29398,20 @@ function pooledRate(buckets, rateKey) {
   }
   return denominator > 0 ? numerator / denominator : 0;
 }
+function windowRateChange(rates) {
+  const first = rates[0];
+  const latest = rates.at(-1);
+  if (rates.length < 2 || first === void 0 || latest === void 0) return null;
+  return { first, latest, delta: roundRatio(latest - first, RatioUnits.fraction) };
+}
+function computeWindowChange(buckets) {
+  const measured = buckets.filter((b) => b.total > 0);
+  return {
+    citationRate: windowRateChange(measured.map((b) => b.citationRate)),
+    mentionRate: windowRateChange(measured.map((b) => b.mentionRate)),
+    mentionShare: windowRateChange(buckets.flatMap((b) => b.mentionShare.rate === null ? [] : [b.mentionShare.rate]))
+  };
+}
 function computeTrend(buckets, rateKey) {
   const nonEmpty = buckets.filter((b) => b.total > 0);
   if (nonEmpty.length < 2) return "stable";
@@ -29371,9 +29425,6 @@ function computeTrend(buckets, rateKey) {
   if (diff < -0.05) return "declining";
   return "stable";
 }
-function round4(ratio) {
-  return Math.round(ratio * 1e4) / 1e4;
-}
 function bumpDomain(map, domain, category, label, surfaceClass) {
   const existing = map.get(domain);
   if (existing) existing.count += 1;
@@ -29388,8 +29439,8 @@ function buildRankedList(domains, limit, answerTotal, answersWithSources) {
   const entries = shownEntries.map((d) => ({
     domain: d.domain,
     count: d.count,
-    percentage: totalCitedSlots > 0 ? round4(d.count / totalCitedSlots) : 0,
-    answerShare: answerTotal > 0 ? round4(d.count / answerTotal) : 0,
+    percentage: totalCitedSlots > 0 ? roundRatio(d.count / totalCitedSlots, RatioUnits.fraction) : 0,
+    answerShare: answerTotal > 0 ? roundRatio(d.count / answerTotal, RatioUnits.fraction) : 0,
     category: d.category,
     label: d.label,
     surfaceClass: d.surfaceClass
@@ -29406,7 +29457,7 @@ function buildRankedList(domains, limit, answerTotal, answersWithSources) {
     surfaceClass,
     label: surfaceClassLabel(surfaceClass),
     count: v.count,
-    percentage: totalCitedSlots > 0 ? round4(v.count / totalCitedSlots) : 0,
+    percentage: totalCitedSlots > 0 ? roundRatio(v.count / totalCitedSlots, RatioUnits.fraction) : 0,
     domainCount: v.domainCount
   })).sort((a, b) => b.count - a.count || a.surfaceClass.localeCompare(b.surfaceClass));
   return {
@@ -31610,7 +31661,7 @@ function renderExecutiveSummary(report) {
       </div>
       <div class="hero-proof">
         <div class="mini-label">${copy.proofTiles.mentionCoverage}</div>
-        <div class="mini-value">${s.mentionRate}%</div>
+        <div class="mini-value">${formatPercent(s.mentionRate, RatioUnits.percent)}</div>
         <div class="mini-copy">${escapeHtml2(headline.mentionedFragment)}</div>
       </div>
       <div class="hero-proof">
@@ -31623,12 +31674,12 @@ function renderExecutiveSummary(report) {
   const metrics = [
     {
       label: copy.tiles.citationRate,
-      value: `${s.citationRate}%`,
+      value: formatPercent(s.citationRate, RatioUnits.percent),
       delta: `<span class="tone-${headline.trendTone}">${headline.trendLabel}</span> \xB7 ${headline.citedFragment} \xB7 ${headline.providerCountLabel}`
     },
     {
       label: copy.tiles.mentionRate,
-      value: `${s.mentionRate}%`,
+      value: formatPercent(s.mentionRate, RatioUnits.percent),
       delta: headline.mentionedFragment
     },
     {
@@ -31684,11 +31735,10 @@ function renderRateDeltaTile(label, delta, unit) {
   if (!delta) {
     return `<div class="metric"><div class="label">${escapeHtml2(label)}</div><div class="value">\u2014</div><div class="delta">${REPORT_SECTION_COPY["whats-changed"].rateTileEmpty}</div></div>`;
   }
-  const valueSuffix = unit === "%" ? "%" : "";
   const deltaText = reportRateDeltaCopy(delta, unit);
   return `<div class="metric">
     <div class="label">${escapeHtml2(label)}</div>
-    <div class="value ${deltaToneClass(delta.direction)}">${delta.current}${valueSuffix} <span style="font-size:14px;font-weight:500;">${reportDeltaArrow(delta.direction)}</span></div>
+    <div class="value ${deltaToneClass(delta.direction)}">${reportRateDeltaValue(delta, unit)} <span style="font-size:14px;font-weight:500;">${reportDeltaArrow(delta.direction)}</span></div>
     <div class="delta">${deltaText}</div>
   </div>`;
 }
@@ -31711,8 +31761,8 @@ function renderProviderMovements(movements, audience) {
   const rows = meaningful.map((m) => {
     return `<tr>
       <td>${escapeHtml2(isClient ? reportProviderDisplayName(m.provider) : m.provider)}</td>
-      <td class="numeric">${m.prior}%</td>
-      <td class="numeric">${m.current}%</td>
+      <td class="numeric">${formatPercent(m.prior, RatioUnits.percent)}</td>
+      <td class="numeric">${formatPercent(m.current, RatioUnits.percent)}</td>
       <td class="numeric ${deltaToneClass(m.direction)}">${reportMovementChangeCopy(m)}</td>
     </tr>`;
   }).join("");
@@ -31905,7 +31955,7 @@ function renderCompetitorLandscape(report) {
       <td><span class="badge tone-${tone}">${escapeHtml2(c.pressureLabel)}</span></td>
       <td class="numeric">${c.citationCount} / ${c.totalCount}</td>
       <td class="numeric">${mentionCount} / ${mentionTotal}</td>
-      <td class="numeric">${c.sharePct}%</td>
+      <td class="numeric">${formatPercent(c.sharePct, RatioUnits.percent)}</td>
       <td>${escapeHtml2(reportTruncatedList(c.citedQueries, 5))}${pagesDisclosure}</td>
     </tr>`;
   }).join("");
@@ -32016,7 +32066,7 @@ function renderAiSourceOrigin(report) {
     `${headlineFragment}${table}${renderCategoryBars(origin.categories)}`
   );
 }
-function renderLineChart(points, color, title, height = 200) {
+function renderLineChart(points, color, title, height = 200, formatValue = formatNumber) {
   if (points.length === 0) return "";
   const width = 600;
   const padX = 32;
@@ -32040,8 +32090,8 @@ function renderLineChart(points, color, title, height = 200) {
     <h3>${escapeHtml2(title)}</h3>
     <svg viewBox="0 0 ${width} ${height}" width="100%" preserveAspectRatio="xMinYMin meet" role="img" aria-label="${escapeHtml2(reportLineChartLabel(title))}">
       <line x1="${padX}" y1="${padY + usableH}" x2="${padX + usableW}" y2="${padY + usableH}" stroke="${COLORS.border}" stroke-width="1" />
-      <text x="${padX - 6}" y="${(padY + 4).toFixed(1)}" fill="${COLORS.textFaint}" font-size="9" text-anchor="end">${formatNumber(max2)}</text>
-      <text x="${padX - 6}" y="${(padY + usableH).toFixed(1)}" fill="${COLORS.textFaint}" font-size="9" text-anchor="end">0</text>
+      <text x="${padX - 6}" y="${(padY + 4).toFixed(1)}" fill="${COLORS.textFaint}" font-size="9" text-anchor="end">${formatValue(max2)}</text>
+      <text x="${padX - 6}" y="${(padY + usableH).toFixed(1)}" fill="${COLORS.textFaint}" font-size="9" text-anchor="end">${formatValue(0)}</text>
       <path d="${path8}" stroke="${color}" stroke-width="2" fill="none" />
       ${dots}
       ${xLabels}
@@ -32062,7 +32112,7 @@ function renderGsc(report) {
       <td>${escapeHtml2(q.query)}</td>
       <td class="numeric">${formatNumber(q.clicks)}</td>
       <td class="numeric">${formatNumber(q.impressions)}</td>
-      <td class="numeric">${formatRatio(q.ctr)}</td>
+      <td class="numeric">${formatPercent(q.ctr)}</td>
       <td class="numeric">${q.avgPosition.toFixed(1)}</td>
       <td><span class="badge tone-neutral">${escapeHtml2(q.category)}</span></td>
     </tr>`).join("");
@@ -32100,7 +32150,7 @@ function renderGsc(report) {
     `<div class="metric-grid">
       <div class="metric"><div class="label">${copy.tiles.clicks}</div><div class="value">${formatNumber(gsc.totalClicks)}</div></div>
       <div class="metric"><div class="label">${copy.tiles.impressions}</div><div class="value">${formatNumber(gsc.totalImpressions)}</div></div>
-      <div class="metric"><div class="label">${copy.tiles.ctr}</div><div class="value">${formatRatio(gsc.ctr)}</div></div>
+      <div class="metric"><div class="label">${copy.tiles.ctr}</div><div class="value">${formatPercent(gsc.ctr)}</div></div>
       <div class="metric"><div class="label">${copy.tiles.position}</div><div class="value">${gsc.avgPosition.toFixed(1)}</div></div>
     </div>
     ${trendChart}
@@ -32448,7 +32498,7 @@ function renderIndexingHealth(report) {
     `<div class="metric-grid">
       <div class="metric"><div class="label">${copy.tiles.indexed}</div><div class="value tone-positive">${formatNumber(ih.indexed)}</div></div>
       <div class="metric"><div class="label">${copy.tiles.total}</div><div class="value">${formatNumber(ih.total)}</div></div>
-      <div class="metric"><div class="label">${copy.tiles.share}</div><div class="value">${ih.indexedPct}%</div></div>
+      <div class="metric"><div class="label">${copy.tiles.share}</div><div class="value">${formatPercent(ih.indexedPct, RatioUnits.percent)}</div></div>
     </div>
     <div class="chart-card">
       <h3>${copy.coverageHeading}</h3>
@@ -32476,12 +32526,13 @@ function renderCitationsTrend(report) {
     trend.map((t) => ({ x: t.date, y: t.citationRate, label: formatDate(t.date) })),
     COLORS.positive,
     copy.chartTitle,
-    220
+    220,
+    (value) => formatPercent(value, RatioUnits.percent)
   );
   const rows = trend.map((t) => `
     <tr>
       <td>${formatDate(t.date)}</td>
-      <td class="numeric">${t.citationRate}% <span class="cell-pending">(${t.citedQueryCount}/${t.totalQueryCount})</span></td>
+      <td class="numeric">${formatPercent(t.citationRate, RatioUnits.percent)} <span class="cell-pending">(${t.citedQueryCount}/${t.totalQueryCount})</span></td>
       <td>${escapeHtml2(reportTrendProviderRates(t.providerRates))}</td>
     </tr>`).join("");
   const [checkHeader, citedQueriesHeader, engineRatesHeader] = copy.breakdownHeaders;
@@ -32668,7 +32719,7 @@ function renderClientSummary(report) {
   const sc = report.citationScorecard;
   const copy = REPORT_SECTION_COPY["client-summary"];
   const totalQ = s.totalQueryCount ?? 0;
-  const heroNumber = totalQ > 0 ? `${s.mentionRate}%` : "\u2014";
+  const heroNumber = totalQ > 0 ? formatPercent(s.mentionRate, RatioUnits.percent) : "\u2014";
   const heroSentence = reportClientHeroSentence(totalQ, s.mentionedQueryCount);
   const trend = reportClientTrendCopy(report.whatsChanged.mentionRate);
   const heroTrend = trend ? `<p class="client-hero-trend tone-${trend.tone}"><span style="margin-right:6px;">${trend.arrow}</span>${escapeHtml2(trend.text)}</p>` : "";
@@ -32682,12 +32733,12 @@ function renderClientSummary(report) {
   const tiles = `<div class="client-metric-grid">
     <div class="client-metric-tile">
       <div class="label">${copy.tiles.mentioned}</div>
-      <div class="value">${s.mentionRate}%</div>
+      <div class="value">${formatPercent(s.mentionRate, RatioUnits.percent)}</div>
       <div class="subtitle">${reportClientMentionedSubtitle(s.mentionedQueryCount, totalQ)}</div>
     </div>
     <div class="client-metric-tile">
       <div class="label">${copy.tiles.cited}</div>
-      <div class="value">${s.citationRate}%</div>
+      <div class="value">${formatPercent(s.citationRate, RatioUnits.percent)}</div>
       <div class="subtitle">${reportClientCitedSubtitle(s.citedQueryCount, totalQ)}</div>
     </div>
     <div class="client-metric-tile">
@@ -32719,7 +32770,7 @@ function renderClientSummary(report) {
     return `<div class="client-bar-row">
               <span class="bar-label">${escapeHtml2(reportProviderDisplayName(r.provider))}</span>
               <div class="bar-track"><div class="bar-fill" style="width:${pct}%"></div></div>
-              <span class="bar-value">${r.mentionRate}% <span class="bar-value-sub">(${r.mentionedCount}/${r.totalCount})</span></span>
+              <span class="bar-value">${formatPercent(r.mentionRate, RatioUnits.percent)} <span class="bar-value-sub">(${r.mentionedCount}/${r.totalCount})</span></span>
             </div>`;
   }).join("")}
         </div>
@@ -32759,7 +32810,7 @@ function renderClientEvidenceSummary(report) {
     cards.push(`<div class="client-card">
       <h3>${copy.indexing.heading}</h3>
       <p class="card-subtitle">${copy.indexing.subtitle}</p>
-      <div class="client-progress-number tone-${tone}">${indexing.indexedPct}%</div>
+      <div class="client-progress-number tone-${tone}">${formatPercent(indexing.indexedPct, RatioUnits.percent)}</div>
       <div style="font-size:12px;color:${COLORS.textMuted};">${reportClientIndexedPages(indexing.indexed, indexing.total)}</div>
       <div class="client-progress-bar"><div class="client-progress-fill tone-${tone}" style="width:${fillPct}%"></div></div>
       <p style="margin:0;font-size:12px;color:${COLORS.textMuted};"><strong style="color:${COLORS.text};">${formatNumber(indexing.notIndexed)}</strong> ${reportClientNotIndexedTail(indexing.notIndexed)}</p>
@@ -33180,7 +33231,7 @@ function buildGscSection(db, projectId, projectBrandNames, canonicalDomain, trac
     category,
     clicks: agg.clicks,
     impressions: agg.impressions,
-    sharePct: categoryTotalClicks > 0 ? Math.round(agg.clicks / categoryTotalClicks * 100) : 0
+    sharePct: percentOf(agg.clicks, categoryTotalClicks) ?? 0
   })).sort((a, b) => b.clicks - a.clicks);
   const periodStart = trend[0]?.date ?? "";
   const periodEnd = trend.at(-1)?.date ?? "";
@@ -33284,7 +33335,7 @@ function buildGaSection(db, projectId, windowDays2) {
         channelBreakdown.push({
           channel: b.channel,
           sessions: b.sessions,
-          sharePct: Math.round(b.sessions / totalSessions * 100)
+          sharePct: percentOf(b.sessions, totalSessions) ?? 0
         });
       }
     }
@@ -33327,7 +33378,7 @@ function buildSocialReferrals(db, projectId, windowDays2) {
   const channels = [...channelAgg.entries()].map(([channelGroup, sessions]) => ({
     channelGroup,
     sessions,
-    sharePct: total > 0 ? Math.round(sessions / total * 100) : 0
+    sharePct: percentOf(sessions, total) ?? 0
   })).sort((a, b) => b.sessions - a.sessions);
   const topCampaigns = [...campaignAgg.values()].sort((a, b) => b.sessions - a.sessions).slice(0, TOP_CAMPAIGN_LIMIT);
   return {
@@ -33409,7 +33460,7 @@ function buildAiReferrals(db, projectId, windowDays2) {
     sessions: data.sessions,
     paidSessions: data.paidSessions,
     organicSessions: data.organicSessions,
-    sharePct: total > 0 ? Math.round(data.sessions / total * 100) : 0
+    sharePct: percentOf(data.sessions, total) ?? 0
   })).sort((a, b) => b.sessions - a.sessions);
   const trend = [...trendAgg.entries()].map(([date, sessions]) => ({ date, sessions })).sort((a, b) => a.date.localeCompare(b.date));
   const topLandingPages = [...pageAgg.entries()].map(([page3, data]) => ({ page: page3, sessions: data.sessions })).sort((a, b) => b.sessions - a.sessions).slice(0, TOP_AI_REFERRAL_PAGES_LIMIT);
@@ -33740,7 +33791,7 @@ function buildIndexingHealth(db, projectId) {
       notIndexed: gsc.notIndexed,
       deindexed: 0,
       unknown: 0,
-      indexedPct: total > 0 ? Math.round(gsc.indexed / total * 100) : 0
+      indexedPct: percentOf(gsc.indexed, total) ?? 0
     };
   }
   const bing = db.select().from(bingCoverageSnapshots).where(eq37(bingCoverageSnapshots.projectId, projectId)).orderBy(desc17(bingCoverageSnapshots.date)).limit(1).get();
@@ -33753,7 +33804,7 @@ function buildIndexingHealth(db, projectId) {
       notIndexed: bing.notIndexed,
       deindexed: 0,
       unknown: bing.unknown,
-      indexedPct: total > 0 ? Math.round(bing.indexed / total * 100) : 0
+      indexedPct: percentOf(bing.indexed, total) ?? 0
     };
   }
   return null;
@@ -33784,12 +33835,12 @@ function buildCitationsTrend(db, projectId, queryLookup, locationFilter) {
     const totalQueries = new Set(snaps.map((snapshot) => snapshot.queryId)).size;
     const citedQueryCount = citedQueryIds.size;
     const mentionedQueryCount = mentionedQueryIds.size;
-    const citationRate = totalQueries > 0 ? Math.round(citedQueryCount / totalQueries * 100) : 0;
-    const mentionRate3 = totalQueries > 0 ? Math.round(mentionedQueryCount / totalQueries * 100) : 0;
+    const citationRate = percentOf(citedQueryCount, totalQueries) ?? 0;
+    const mentionRate3 = percentOf(mentionedQueryCount, totalQueries) ?? 0;
     const providerRates = [...providerCounts.entries()].map(([provider, counts2]) => ({
       provider,
-      citationRate: counts2.total > 0 ? Math.round(counts2.cited / counts2.total * 100) : 0,
-      mentionRate: counts2.total > 0 ? Math.round(counts2.mentioned / counts2.total * 100) : 0
+      citationRate: percentOf(counts2.cited, counts2.total) ?? 0,
+      mentionRate: percentOf(counts2.mentioned, counts2.total) ?? 0
     })).sort((a, b) => a.provider.localeCompare(b.provider));
     points.push({
       runId: run.id,
@@ -33911,7 +33962,7 @@ function buildExecutiveFindings(citationRate, citedQueryCount, totalQueryCount,
     const queryNoun = totalQueryCount === 1 ? "query" : "queries";
     const ratioFragment = totalQueryCount > 0 ? ` (${citedQueryCount} of ${totalQueryCount} ${queryNoun} cited)` : "";
     findings.push({
-      title: `Citation rate at ${citationRate}%${ratioFragment}`,
+      title: `Citation rate at ${formatPercent(citationRate, RatioUnits.percent)}${ratioFragment}`,
       detail,
       tone
     });
@@ -34044,7 +34095,7 @@ function buildReportActionPlan(input) {
   if (input.indexingHealth && input.indexingHealth.total > 0 && input.indexingHealth.indexedPct < 70) {
     const ih = input.indexingHealth;
     const evidence = [
-      `${ih.indexedPct}% indexed (${ih.indexed}/${ih.total})`,
+      `${formatPercent(ih.indexedPct, RatioUnits.percent)} indexed (${ih.indexed}/${ih.total})`,
       `${ih.notIndexed} not indexed${ih.deindexed > 0 ? `, ${ih.deindexed} deindexed` : ""}`
     ];
     actions.push({
@@ -34119,7 +34170,7 @@ function buildReportActionPlan(input) {
         "They are stronger evidence than a generic topic list because the model is already retrieving competing content."
       ],
       evidence: [
-        `"${topGap.query}" missed at ${formatWholePercent(topGap.missRate)} with ${topGap.competitorCount} competitor${topGap.competitorCount === 1 ? "" : "s"} cited`,
+        `"${topGap.query}" missed at ${formatPercent(topGap.missRate)} with ${topGap.competitorCount} competitor${topGap.competitorCount === 1 ? "" : "s"} cited`,
         `Cited competitors: ${reportCompactList(topGap.competitorDomains)}`
       ],
       successMetric: "The top content-gap query moves from missed to cited or mentioned after the recommended content work ships.",
@@ -34186,7 +34237,7 @@ function buildClientSummary(reportLike) {
   const s = reportLike.executiveSummary;
   const queryNoun = s.totalQueryCount === 1 ? "query" : "queries";
   const headline = (s.totalQueryCount ?? 0) > 0 ? `${s.mentionedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} mention the brand in AI answers` : "No tracked queries have completed a check yet";
-  const overview = (s.totalQueryCount ?? 0) > 0 ? `${reportLike.canonicalDomain} is mentioned on ${s.mentionRate}% of tracked queries and cited on ${s.citationRate}% of tracked queries. ${mentionTrendSentence(reportLike.whatsChanged.mentionRate)}` : "At least one completed check is needed before this can summarize how the brand appears in AI answers.";
+  const overview = (s.totalQueryCount ?? 0) > 0 ? `${reportLike.canonicalDomain} is mentioned on ${formatPercent(s.mentionRate, RatioUnits.percent)} of tracked queries and cited on ${formatPercent(s.citationRate, RatioUnits.percent)} of tracked queries. ${mentionTrendSentence(reportLike.whatsChanged.mentionRate)}` : "At least one completed check is needed before this can summarize how the brand appears in AI answers.";
   const confidenceNotes = [];
   if (s.totalQueryCount === 0) {
     confidenceNotes.push("Confidence is low until the first tracked query check completes.");
@@ -34240,7 +34291,7 @@ function buildAgencyDiagnostics(input) {
     const provider = input.indexingHealth.provider ?? "the connected provider";
     diagnostics.push({
       title: "Indexing health",
-      detail: inspected ? `${input.indexingHealth.indexedPct}% of inspected URLs are indexed in ${provider}.` : `No URLs have been inspected in ${provider} yet, so indexing coverage is not measured.`,
+      detail: inspected ? `${formatPercent(input.indexingHealth.indexedPct, RatioUnits.percent)} of inspected URLs are indexed in ${provider}.` : `No URLs have been inspected in ${provider} yet, so indexing coverage is not measured.`,
       // Not measured is not a finding, so it must not carry a finding's tone.
       severity: !inspected ? "neutral" : input.indexingHealth.indexedPct >= 90 ? "positive" : input.indexingHealth.indexedPct >= 70 ? "caution" : "negative",
       evidence: inspected ? [
@@ -34292,7 +34343,7 @@ function buildWhatsChangedHeadline(citation, gscClicks, aiReferrals, enoughHisto
     const arrow = citation.direction === "up" ? "\u2191" : citation.direction === "down" ? "\u2193" : "\u2192";
     const verb = citation.direction === "up" ? "rose" : citation.direction === "down" ? "fell" : "held";
     const smoothingHint = citation.window && citation.window >= 2 ? ` (avg of last ${citation.window} checks)` : "";
-    parts.push(`Citation rate ${verb} ${citation.prior}% ${arrow} ${citation.current}%${smoothingHint}`);
+    parts.push(`Citation rate ${verb} ${formatPercent(citation.prior, RatioUnits.percent)} ${arrow} ${formatPercent(citation.current, RatioUnits.percent)}${smoothingHint}`);
   }
   if (aiReferrals && aiReferrals.direction !== "flat") {
     const arrow = aiReferrals.direction === "up" ? "\u2191" : "\u2193";
@@ -34309,12 +34360,12 @@ function buildWhatsChanged(input) {
   const latest = citationsTrend.at(-1);
   const prior = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
   const enoughHistory = !baseline && latest !== void 0 && prior !== void 0;
-  const citationRateSmoothed = smoothedRunDelta(citationsTrend, (p) => p.citationRate);
+  const citationRateSmoothed = smoothedRunDelta(citationsTrend, (p) => p.citationRate, SMOOTHED_RUN_DELTA_MAX_WINDOW, RatioUnits.percent);
   const citationRate = enoughHistory && citationRateSmoothed ? {
     ...citationRateSmoothed,
     direction: rateDirection(citationRateSmoothed.deltaAbs, RATE_REAL_MOVEMENT_THRESHOLD_PP)
   } : null;
-  const mentionRateSmoothed = smoothedRunDelta(citationsTrend, (p) => p.mentionRate);
+  const mentionRateSmoothed = smoothedRunDelta(citationsTrend, (p) => p.mentionRate, SMOOTHED_RUN_DELTA_MAX_WINDOW, RatioUnits.percent);
   const mentionRate3 = enoughHistory && mentionRateSmoothed ? {
     ...mentionRateSmoothed,
     direction: rateDirection(mentionRateSmoothed.deltaAbs, RATE_REAL_MOVEMENT_THRESHOLD_PP)
@@ -34335,7 +34386,7 @@ function buildWhatsChanged(input) {
     for (const cur of latest.providerRates) {
       const priorRate = priorByProvider.get(cur.provider);
       if (priorRate === void 0) continue;
-      const deltaAbs = cur.citationRate - priorRate;
+      const deltaAbs = roundRatio(cur.citationRate - priorRate, RatioUnits.percent);
       providerMovements.push({
         provider: cur.provider,
         current: cur.citationRate,
@@ -34448,7 +34499,7 @@ function buildProjectReport(db, projectName, periodDays) {
       pressureLabel: row.mentions === 0 ? "None" : row.mentions / share.snapshotsWithAnswerText >= 0.5 ? "High" : row.mentions / share.snapshotsWithAnswerText >= 0.2 ? "Moderate" : "Low",
       mentionCount: counts2.get(row.domain) ?? 0,
       totalCount: share.snapshotsWithAnswerText,
-      sharePct: share.availability === "measured" ? Math.round((counts2.get(row.domain) ?? 0) / (share.projectMentions + share.competitorMentions) * 1e3) / 10 : null
+      sharePct: share.availability === "measured" ? percentOf(counts2.get(row.domain) ?? 0, share.projectMentions + share.competitorMentions) : null
     }));
   }
   Object.assign(mentionLandscape, mentionLandscape.nonBrand);
@@ -34498,8 +34549,8 @@ function buildProjectReport(db, projectName, periodDays) {
   }
   const citedQueryCount = citedQueryIds.size;
   const mentionedQueryCount = mentionedQueryIds.size;
-  const citationRate = totalQueryCount > 0 ? Math.round(citedQueryCount / totalQueryCount * 100) : 0;
-  const mentionRate3 = totalQueryCount > 0 ? Math.round(mentionedQueryCount / totalQueryCount * 100) : 0;
+  const citationRate = percentOf(citedQueryCount, totalQueryCount) ?? 0;
+  const mentionRate3 = percentOf(mentionedQueryCount, totalQueryCount) ?? 0;
   const trendBaseline = isTrendBaseline(citationsTrend);
   const latestPoint = citationsTrend.at(-1);
   const previousPoint = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
@@ -35333,7 +35384,7 @@ function summarizeServer(crawlers, fetches, referrals) {
 function comparisonDetail(latest, prior) {
   if (prior === 0) return `${latest} in the latest cohort versus 0 in the prior cohort`;
   const change = deltaPercent(latest, prior) ?? 0;
-  return `${latest} in the latest cohort versus ${prior} prior (${change >= 0 ? "+" : ""}${change}%)`;
+  return `${latest} in the latest cohort versus ${prior} prior (${formatSignedPercent(change, RatioUnits.percent)})`;
 }
 function aggregateCoverage(row) {
   return row?.startDate && row.endDate ? { startDate: row.startDate, endDate: row.endDate, observedDays: Number(row.observedDays) } : null;
@@ -36050,7 +36101,7 @@ function countPeriod(snaps, competitors2, queryClassOf, classificationAvailable,
     snaps.map((s) => ({
       // Share uses current identity; named-rate counts above deliberately keep
       // their historical persisted-boolean semantics.
-      projectMentioned: s.answerText ? matcherMatchesText(projectMatcher, s.answerText) : s.answerMentioned === true,
+      projectMentioned: s.answerText ? matcherMatchesText(projectMatcher, answerProseForMentions(s.answerText)) : s.answerMentioned === true,
       answerText: s.answerText,
       queryClass: queryClassOf(s)
     })),
@@ -36250,9 +36301,6 @@ function computeVisibilityCompare(input) {
 }
 
 // ../api-routes/src/visibility-stats.ts
-function round42(value) {
-  return Math.round(value * 1e4) / 1e4;
-}
 function emptyAgg() {
   return { total: 0, checked: 0, mentioned: 0, cited: 0, first: null, last: null };
 }
@@ -36272,8 +36320,8 @@ function counts(agg) {
     cited: agg.cited,
     // mention proportion is over the CHECKED sample; citation proportion is
     // over the full total (every snapshot is checked for citation).
-    mentionRate: agg.checked > 0 ? round42(agg.mentioned / agg.checked) : null,
-    citedRate: agg.total > 0 ? round42(agg.cited / agg.total) : null
+    mentionRate: agg.checked > 0 ? roundRatio(agg.mentioned / agg.checked, RatioUnits.fraction) : null,
+    citedRate: agg.total > 0 ? roundRatio(agg.cited / agg.total, RatioUnits.fraction) : null
   };
 }
 function providerEntries(byProvider) {
@@ -36964,7 +37012,7 @@ async function compositeRoutes(app) {
     const answerDomainsByText = /* @__PURE__ */ new Map();
     for (const snapshot of trackedLatest) {
       if (snapshot.answerText && !answerDomainsByText.has(snapshot.answerText)) {
-        answerDomainsByText.set(snapshot.answerText, extractDomainsFromText(snapshot.answerText));
+        answerDomainsByText.set(snapshot.answerText, extractDomainsFromText(answerProseForMentions(snapshot.answerText)));
       }
     }
     const mentionShareInputs = buildMentionShareInputs({
@@ -37367,13 +37415,13 @@ function buildIndexCoverageScore(app, projectId) {
   const deindexedLabel = deindexed === 1 ? "URL" : "URLs";
   return {
     label: "Index Coverage",
-    value: `${Math.round(percentage)}`,
+    value: formatPercent(chosen.indexed / total),
     delta: `${chosen.provider} \xB7 ${chosen.indexed} of ${total} indexed`,
     tone,
     description: deindexed > 0 ? `${deindexed} deindexed ${deindexedLabel} detected in the latest Google Search Console inspection.` : `${chosen.notIndexed} ${notIndexedLabel} not indexed in ${chosen.provider === "Google" ? "Google Search Console" : "Bing Webmaster Tools"}.`,
     tooltip,
     trend: [],
-    progress: Math.round(percentage)
+    progress: roundRatio(percentage, RatioUnits.percent)
   };
 }
 function countGoogleDeindexedUrls(app, projectId) {
@@ -37726,6 +37774,9 @@ var SCHEMA_TABLE = {
   GA4PropertiesDto: ga4PropertiesDtoSchema,
   GA4StatusDto: ga4StatusDtoSchema,
   GA4SyncResponseDto: ga4SyncResponseDtoSchema,
+  GaAttributionTrendResponse: gaAttributionTrendResponseSchema,
+  GaSocialReferralTrendResponse: gaSocialReferralTrendResponseSchema,
+  GaTrafficResponse: gaTrafficResponseSchema,
   GbpAccountListResponse: gbpAccountListResponseSchema,
   GbpDailyMetricListResponse: gbpDailyMetricListResponseSchema,
   GbpKeywordImpressionListResponse: gbpKeywordImpressionListResponseSchema,
@@ -37983,6 +38034,7 @@ function errorResponse(description) {
 }
 
 // ../api-routes/src/openapi.ts
+var GA_MOVER_DESCRIPTION = `A biggest mover is the source whose sessions changed most, in either direction, over the last 7 days against the 7 before. A source with no sessions in the prior 7 days has changeBasis new and a null changePct: a change from zero has no percentage. Below ${MIN_PCT_BASE} prior sessions changeBasis is small-base and changeSessions is the figure to state.`;
 var stringSchema = { type: "string" };
 var booleanSchema = { type: "boolean" };
 var integerSchema = { type: "integer" };
@@ -43556,11 +43608,11 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/ga/traffic",
     summary: "Get GA4 landing page traffic, channel breakdown, and AI referral landing pages",
+    description: "Every figure is measured over one window (windowStart to windowEnd). Each AI and social referral row carries share, its fraction of that table's sessions, so a table's shares add up to 1; each top page carries organicShare, its organic sessions over its own sessions.",
     tags: ["ga4"],
     parameters: [nameParameter, limitQueryParameter, analyticsWindowParameter, analyticsStartDateParameter, analyticsEndDateParameter],
     responses: {
-      // TODO: Add `GaTrafficResponse` Zod schema in contracts.
-      200: rawJsonResponse("GA4 traffic data returned.", looseObjectSchema),
+      200: jsonResponse("GA4 traffic data returned.", "GaTrafficResponse"),
       400: errorResponse("GA4 is not connected."),
       404: errorResponse("Project not found.")
     }
@@ -43607,11 +43659,11 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/ga/social-referral-trend",
     summary: "Get social referral trend (7d/30d) with biggest mover",
+    description: GA_MOVER_DESCRIPTION,
     tags: ["ga4"],
     parameters: [nameParameter],
     responses: {
-      // TODO: Add `GaSocialReferralTrendResponse` Zod schema in contracts.
-      200: rawJsonResponse("Social referral trend returned.", looseObjectSchema),
+      200: jsonResponse("Social referral trend returned.", "GaSocialReferralTrendResponse"),
       400: errorResponse("GA4 is not connected."),
       404: errorResponse("Project not found.")
     }
@@ -43620,11 +43672,11 @@ var routeCatalog = [
     method: "get",
     path: "/api/v1/projects/{name}/ga/attribution-trend",
     summary: "Get per-channel attribution trends (7d/30d) for organic, AI, and social",
+    description: GA_MOVER_DESCRIPTION,
     tags: ["ga4"],
     parameters: [nameParameter],
     responses: {
-      // TODO: Add `GaAttributionTrendResponse` Zod schema in contracts.
-      200: rawJsonResponse("Attribution trend returned.", looseObjectSchema),
+      200: jsonResponse("Attribution trend returned.", "GaAttributionTrendResponse"),
       400: errorResponse("GA4 is not connected."),
       404: errorResponse("Project not found.")
     }
@@ -46426,10 +46478,6 @@ function daysBetween(from, to) {
   const [ty, tm, td] = to.split("-").map(Number);
   return Math.round((Date.UTC(ty, tm - 1, td) - Date.UTC(fy, fm - 1, fd)) / 864e5);
 }
-function roundPct(numerator, denominator) {
-  if (denominator === 0) return 0;
-  return Math.round(numerator / denominator * 100);
-}
 function computeWindowDelta(rows, referenceDate) {
   const recentLow = shiftDate(referenceDate, -7);
   const priorLow = shiftDate(referenceDate, -14);
@@ -46494,7 +46542,7 @@ function buildTimeseries(rows, freshness, windowDays2 = 30) {
 function computeKeywordCoverage(rows) {
   const total = rows.length;
   const thresholdedCount = rows.filter((r) => r.valueCount === null).length;
-  return { total, thresholdedCount, thresholdedPct: roundPct(thresholdedCount, total) };
+  return { total, thresholdedCount, thresholdedPct: percentOf(thresholdedCount, total) ?? 0 };
 }
 function summarizePlaceActions(rows) {
   return {
@@ -49269,7 +49317,12 @@ async function googleRoutes(app, opts) {
         indexed,
         notIndexed,
         deindexed: deindexedUrls.length,
-        percentage: total > 0 ? Math.round(indexed / total * 1e3) / 10 : 0
+        percentage: percentOf(indexed, total) ?? 0,
+        // The coverage donut's two arcs and the CLI summary. Every latest
+        // inspection lands in exactly one bucket, so the two shares sum to 1.
+        // Unrounded, so the two arcs add up to 1.
+        indexedShare: total > 0 ? indexed / total : null,
+        notIndexedShare: total > 0 ? notIndexed / total : null
       },
       lastInspectedAt,
       lastSyncedAt,
@@ -49887,7 +49940,7 @@ async function googleRoutes(app, opts) {
         valueThreshold: r.valueThreshold ?? null
       })),
       total: rows.length,
-      thresholdedPct: rows.length ? Math.round(thresholded / rows.length * 100) : 0
+      thresholdedPct: percentOf(thresholded, rows.length) ?? 0
     };
   });
   app.get("/projects/:name/gbp/place-actions", async (request) => {
@@ -57212,7 +57265,7 @@ async function bingRoutes(app, opts) {
         indexed,
         notIndexed,
         unknown,
-        percentage: total > 0 ? Math.round(indexed / total * 1e3) / 10 : 0
+        percentage: percentOf(indexed, total) ?? 0
       },
       lastInspectedAt,
       indexed: indexedUrls.map(formatRow),
@@ -57658,6 +57711,47 @@ function buildSessionHistory(landingPageDays, dailyTotals) {
   });
 }
 
+// ../api-routes/src/ga-source-mover.ts
+function moverChangeBasis(prior) {
+  if (prior <= 0) return GaMoverChangeBases.new;
+  return prior < MIN_PCT_BASE ? GaMoverChangeBases["small-base"] : GaMoverChangeBases.percent;
+}
+function buildSourceMover(source, sessions7d, sessionsPrev7d) {
+  return {
+    source,
+    sessions7d,
+    sessionsPrev7d,
+    changeSessions: sessions7d - sessionsPrev7d,
+    // Null from a zero prior. It used to fall back to 100, so every source that
+    // appeared this week read as "+100%" whatever it sent.
+    changePct: deltaPercent(sessions7d, sessionsPrev7d),
+    changeBasis: moverChangeBasis(sessionsPrev7d)
+  };
+}
+function findBiggestMover(current, prior) {
+  const bySource = /* @__PURE__ */ new Map();
+  const entry = (source) => {
+    let sessions = bySource.get(source);
+    if (!sessions) {
+      sessions = { current: 0, prior: 0 };
+      bySource.set(source, sessions);
+    }
+    return sessions;
+  };
+  for (const row of current) entry(row.source).current += row.sessions ?? 0;
+  for (const row of prior) entry(row.source).prior += row.sessions ?? 0;
+  let mover = null;
+  const sources = [...bySource.keys()].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+  for (const source of sources) {
+    const sessions = bySource.get(source);
+    const size = Math.abs(sessions.current - sessions.prior);
+    if (size > 0 && (mover === null || size > Math.abs(mover.changeSessions))) {
+      mover = buildSourceMover(source, sessions.current, sessions.prior);
+    }
+  }
+  return mover;
+}
+
 // ../api-routes/src/ga.ts
 function gaLog(level, action, ctx) {
   const entry = { ts: (/* @__PURE__ */ new Date()).toISOString(), level, module: "GA4Routes", action, ...ctx };
@@ -57665,12 +57759,11 @@ function gaLog(level, action, ctx) {
   stream.write(JSON.stringify(entry) + "\n");
 }
 function formatSharePct(numerator, total) {
-  if (numerator > 0 && total <= 0) return "\u2014";
-  if (total <= 0 || numerator <= 0) return "0%";
-  const pct = numerator / total * 100;
-  const rounded = Math.round(pct);
-  if (rounded === 0) return "<1%";
-  return `${rounded}%`;
+  return formatPercent(shareOf(numerator, total));
+}
+function withSessionShares(rows) {
+  const shares = breakdownShares(rows.map((row) => row.sessions));
+  return rows.map((row, index2) => ({ ...row, share: shares[index2] ?? 0 }));
 }
 function dateRangeConditions(column, range) {
   const conditions = [];
@@ -57694,7 +57787,7 @@ function buildChannelBreakdown(input) {
   const otherSessions = Math.max(0, input.totalSessions - coveredSessions);
   const bucket = (sessions) => ({
     sessions,
-    sharePct: input.totalSessions > 0 ? Math.round(sessions / input.totalSessions * 100) : 0,
+    sharePct: percentOf(sessions, input.totalSessions) ?? 0,
     sharePctDisplay: formatSharePct(sessions, input.totalSessions)
   });
   return {
@@ -57704,7 +57797,7 @@ function buildChannelBreakdown(input) {
     ai: bucket(aiSessions),
     other: {
       sessions: otherSessions,
-      sharePct: input.totalSessions > 0 ? Math.round(otherSessions / input.totalSessions * 100) : 0,
+      sharePct: percentOf(otherSessions, input.totalSessions) ?? 0,
       sharePctDisplay: input.totalSessions <= 0 && coveredSessions > 0 ? "\u2014" : formatSharePct(otherSessions, input.totalSessions)
     }
   };
@@ -58536,7 +58629,8 @@ async function ga4Routes(app, opts) {
         sessions: r.sessions ?? 0,
         organicSessions: r.organicSessions ?? 0,
         directSessions: r.directSessions ?? 0,
-        users: r.users ?? 0
+        users: r.users ?? 0,
+        organicShare: shareOf(r.organicSessions ?? 0, r.sessions ?? 0)
       })),
       // No `users` on either referral row type, and no `ai*Users*` totals: GA
       // reports users as a COUNT DISTINCT at the grain requested, so summing
@@ -58544,13 +58638,16 @@ async function ga4Routes(app, opts) {
       // every date in the window) counted one visitor once per row. Withdrawn
       // in 4.135.0; see `ga-ai-referral-aggregation.ts` for why no correct
       // figure can be computed or fetched.
-      aiReferrals: aiReferrals.map((r) => ({
+      // Shares of the rows' own sum, not of `aiSessionsDeduped`: that total
+      // keeps the winning lens per day, these rows one lens per source over the
+      // window, so it can exceed what the rows add up to.
+      aiReferrals: withSessionShares(aiReferrals.map((r) => ({
         source: r.source,
         medium: r.medium,
         trafficClass: normalizeAiTrafficClass(r.trafficClass),
         sourceDimension: r.sourceDimension,
         sessions: r.sessions ?? 0
-      })),
+      }))),
       aiReferralLandingPages: aiReferralLandingPages.map((r) => ({
         source: r.source,
         medium: r.medium,
@@ -58565,23 +58662,25 @@ async function ga4Routes(app, opts) {
       aiSessionsBySession: aiSummary.bySession.sessions,
       paidAiSessionsBySession: aiSummary.paidBySession.sessions,
       organicAiSessionsBySession: aiSummary.organicBySession.sessions,
-      socialReferrals: socialReferrals.map((r) => ({
+      // These rows partition `socialSessions` (same window, one lens), so each
+      // share is also the row's share of that total.
+      socialReferrals: withSessionShares(socialReferrals.map((r) => ({
         source: r.source,
         medium: r.medium,
         channelGroup: r.channelGroup,
         sessions: r.sessions ?? 0
-      })),
+      }))),
       socialSessions,
       channelBreakdown,
-      organicSharePct: total > 0 ? Math.round(totalOrganicSessions / total * 100) : 0,
-      aiSharePct: total > 0 ? Math.round(aiSummary.deduped.sessions / total * 100) : 0,
-      aiSharePctBySession: total > 0 ? Math.round(aiSummary.bySession.sessions / total * 100) : 0,
-      paidAiSharePct: total > 0 ? Math.round(aiSummary.paidDeduped.sessions / total * 100) : 0,
-      paidAiSharePctBySession: total > 0 ? Math.round(aiSummary.paidBySession.sessions / total * 100) : 0,
-      organicAiSharePct: total > 0 ? Math.round(aiSummary.organicDeduped.sessions / total * 100) : 0,
-      organicAiSharePctBySession: total > 0 ? Math.round(aiSummary.organicBySession.sessions / total * 100) : 0,
-      directSharePct: total > 0 ? Math.round(totalDirectSessions / total * 100) : 0,
-      socialSharePct: total > 0 ? Math.round(socialSessions / total * 100) : 0,
+      organicSharePct: percentOf(totalOrganicSessions, total) ?? 0,
+      aiSharePct: percentOf(aiSummary.deduped.sessions, total) ?? 0,
+      aiSharePctBySession: percentOf(aiSummary.bySession.sessions, total) ?? 0,
+      paidAiSharePct: percentOf(aiSummary.paidDeduped.sessions, total) ?? 0,
+      paidAiSharePctBySession: percentOf(aiSummary.paidBySession.sessions, total) ?? 0,
+      organicAiSharePct: percentOf(aiSummary.organicDeduped.sessions, total) ?? 0,
+      organicAiSharePctBySession: percentOf(aiSummary.organicBySession.sessions, total) ?? 0,
+      directSharePct: percentOf(totalDirectSessions, total) ?? 0,
+      socialSharePct: percentOf(socialSessions, total) ?? 0,
       otherSessions: channelBreakdown.other.sessions,
       otherSharePct: channelBreakdown.other.sharePct,
       otherSharePctDisplay: channelBreakdown.other.sharePctDisplay,
@@ -58703,31 +58802,16 @@ async function ga4Routes(app, opts) {
       sql21`${gaSocialReferrals.date} >= ${daysAgo(14)}`,
       sql21`${gaSocialReferrals.date} < ${daysAgo(7)}`
     )).groupBy(gaSocialReferrals.source).all();
-    const prevMap = new Map(sourcePrev.map((r) => [r.source, r.sessions]));
-    let biggestMover = null;
-    let maxDelta = 0;
-    for (const row of sourceCurrent) {
-      const prev = prevMap.get(row.source) ?? 0;
-      const delta = Math.abs(row.sessions - prev);
-      if (delta > maxDelta) {
-        maxDelta = delta;
-        biggestMover = {
-          source: row.source,
-          sessions7d: row.sessions,
-          sessionsPrev7d: prev,
-          changePct: deltaPercent(row.sessions, prev) ?? (row.sessions > 0 ? 100 : 0)
-        };
-      }
-    }
-    return {
+    const response = {
       socialSessions7d: current7d?.sessions ?? 0,
       socialSessionsPrev7d: prev7d?.sessions ?? 0,
       trend7dPct: deltaPercent(current7d?.sessions ?? 0, prev7d?.sessions ?? 0),
       socialSessions30d: current30d?.sessions ?? 0,
       socialSessionsPrev30d: prev30d?.sessions ?? 0,
       trend30dPct: deltaPercent(current30d?.sessions ?? 0, prev30d?.sessions ?? 0),
-      biggestMover
+      biggestMover: findBiggestMover(sourceCurrent, sourcePrev)
     };
+    return response;
   });
   app.get("/projects/:name/ga/attribution-trend", async (request, _reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -58769,23 +58853,9 @@ async function ga4Routes(app, opts) {
       sql21`${gaAiReferrals.date} < ${daysAgo(7)}`,
       eq55(gaAiReferrals.sourceDimension, "session")
     )).groupBy(gaAiReferrals.source).all();
-    const findBiggestMover = (current, prev) => {
-      const prevMap = new Map(prev.map((r) => [r.source, r.sessions]));
-      let mover = null;
-      let maxDelta = 0;
-      for (const row of current) {
-        const p = prevMap.get(row.source) ?? 0;
-        const delta = Math.abs(row.sessions - p);
-        if (delta > maxDelta) {
-          maxDelta = delta;
-          mover = { source: row.source, sessions7d: row.sessions, sessionsPrev7d: p, changePct: deltaPercent(row.sessions, p) ?? (row.sessions > 0 ? 100 : 0) };
-        }
-      }
-      return mover;
-    };
     const socialSourceCurrent = app.db.select({ source: gaSocialReferrals.source, sessions: sql21`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and47(eq55(gaSocialReferrals.projectId, project.id), sql21`${gaSocialReferrals.date} >= ${daysAgo(7)}`, sql21`${gaSocialReferrals.date} < ${todayStr}`)).groupBy(gaSocialReferrals.source).all();
     const socialSourcePrev = app.db.select({ source: gaSocialReferrals.source, sessions: sql21`SUM(${gaSocialReferrals.sessions})` }).from(gaSocialReferrals).where(and47(eq55(gaSocialReferrals.projectId, project.id), sql21`${gaSocialReferrals.date} >= ${daysAgo(14)}`, sql21`${gaSocialReferrals.date} < ${daysAgo(7)}`)).groupBy(gaSocialReferrals.source).all();
-    return {
+    const response = {
       total: buildTrend(sumTotal),
       organic: buildTrend(sumOrganic),
       ai: buildTrend(sumAi),
@@ -58794,6 +58864,7 @@ async function ga4Routes(app, opts) {
       aiBiggestMover: findBiggestMover(aiSourceCurrent, aiSourcePrev),
       socialBiggestMover: findBiggestMover(socialSourceCurrent, socialSourcePrev)
     };
+    return response;
   });
   app.get("/projects/:name/ga/session-history", async (request, _reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -82342,9 +82413,6 @@ function loadProject(ctx) {
   if (!ctx.project) return null;
   return ctx.db.select().from(projects).where(eq66(projects.id, ctx.project.id)).get() ?? null;
 }
-function percent(value) {
-  return Math.round(value * 100);
-}
 var winnabilityCoverageCheck = {
   id: "content.winnability.coverage",
   category: CheckCategories.integrations,
@@ -82412,7 +82480,7 @@ var winnabilityCoverageCheck = {
       return {
         status: CheckStatuses.warn,
         code: "content.winnability.low-coverage",
-        summary: `${coveredDomains.length} of ${citedDomains.length} cited-surface domain(s) recognized (${percent(coverage)}%); the winnability gate may miss ceded surfaces in the unrecognized tail.`,
+        summary: `${coveredDomains.length} of ${citedDomains.length} cited-surface domain(s) recognized (${formatPercent(coverage)}); the winnability gate may miss ceded surfaces in the unrecognized tail.`,
         remediation: discoverRemediation,
         details
       };
@@ -82420,7 +82488,7 @@ var winnabilityCoverageCheck = {
     return {
       status: CheckStatuses.ok,
       code: "content.winnability.covered",
-      summary: `${coveredDomains.length} of ${citedDomains.length} cited-surface domain(s) recognized (${percent(coverage)}%); the winnability gate is active.`,
+      summary: `${coveredDomains.length} of ${citedDomains.length} cited-surface domain(s) recognized (${formatPercent(coverage)}); the winnability gate is active.`,
       remediation: null,
       details
     };
@@ -86113,6 +86181,9 @@ function mapCrawlPage(row) {
     healthState: deriveSiteHealthState(row)
   };
 }
+function withRecordedShare(factor) {
+  return { ...factor, sharePct: typeof factor.sharePct === "number" ? factor.sharePct : null };
+}
 function mapCrawlPageAuditEvidence(row) {
   const fields = row.auditFields;
   const rawFactors = Array.isArray(fields.factors) ? fields.factors : [];
@@ -86399,7 +86470,7 @@ async function technicalAeoRoutes(app, opts) {
       trend,
       previousScore: previous?.aggregateScore ?? null,
       previousAuditedAt: previous?.auditedAt ?? null,
-      factors: snap.factorAverages,
+      factors: snap.factorAverages.map(withRecordedShare),
       crossCuttingIssues: snap.crossCuttingIssues,
       prioritizedFixes: snap.prioritizedFixes
     };
@@ -86436,7 +86507,7 @@ async function technicalAeoRoutes(app, opts) {
       overallScore: row.overallScore,
       status: row.status === "error" ? "error" : "success",
       error: row.error,
-      factors: row.factors
+      factors: row.factors.map(withRecordedShare)
     }));
     return { project: project.name, runId: latest.runId, auditedAt: latest.auditedAt, total, pages };
   });
@@ -89288,10 +89359,11 @@ function extractRecommendedCompetitors(answerText, ownDomains, citedDomains, com
     "whyitstandsout",
     "whywechoseit"
   ]);
+  const scanText = stripCitationChips(answerText);
   const seen2 = /* @__PURE__ */ new Map();
   for (const pattern of candidatePatterns) {
     let match;
-    while ((match = pattern.exec(answerText)) !== null) {
+    while ((match = pattern.exec(scanText)) !== null) {
       const candidate = cleanCandidateName(match[1]);
       const candidateKey2 = brandKeyFromText(candidate);
       if (!candidateKey2) continue;
@@ -90164,6 +90236,7 @@ export {
   deliverWebhook,
   redactNotificationUrl,
   renderReportHtml,
+  buildOpenApiDocument,
   toAlertView,
   resolveDestination,
   getPlaceDetails,