@ainyc/canonry 4.7.2 → 4.10.1

package/dist/{chunk-DVTPGC6O.js → chunk-TNW6Z3TW.js}

@@ -4,7 +4,7 @@ import {
   configExists,
   loadConfig,
   saveConfigPatch
-} from "./chunk-VDEMEI64.js";
+} from "./chunk-GAC7BSL6.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -61,7 +61,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-OOADR2Q5.js";
+} from "./chunk-XRDZ26OZ.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -77,6 +77,7 @@ import {
   RunStatuses,
   RunTriggers,
   absolutizeProjectUrl,
+  actionConfidenceLabel,
   agentBusy,
   agentMemoryDeleteRequestSchema,
   agentMemoryUpsertRequestSchema,
@@ -89,6 +90,9 @@ import {
   categoryLabel,
   citationStateToCited,
   competitorBatchRequestSchema,
+  contentActionLabel,
+  dedupeReportActions,
+  dedupeReportOpportunities,
   deliveryFailed,
   determineAnswerMentioned,
   effectiveDomains,
@@ -114,7 +118,11 @@ import {
   providerError,
   queryGenerateRequestSchema,
   registrableDomain,
+  reportActionCategoryLabel,
   reportActionTone,
+  reportConfidenceLabel,
+  reportHorizonLabel,
+  reportSeverityLabel,
   resolveConfigSpecQueries,
   resolveSnapshotRequestQueries,
   runInProgress,
@@ -129,7 +137,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-XAW66QUX.js";
+} from "./chunk-GPJ3GLOE.js";
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -2622,12 +2630,43 @@ function formatLandingPageHtml(raw) {
 function formatDate(iso) {
   if (!iso) return "\u2014";
   try {
-    const d = new Date(iso);
-    return d.toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric" });
+    const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(iso);
+    const options = { month: "short", day: "numeric", year: "numeric" };
+    const d = dateOnly && dateOnly[1] && dateOnly[2] && dateOnly[3] ? new Date(Date.UTC(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]))) : new Date(iso);
+    if (Number.isNaN(d.getTime())) return iso;
+    return d.toLocaleDateString("en-US", dateOnly ? { ...options, timeZone: "UTC" } : options);
   } catch {
     return iso;
   }
 }
+function formatDateRange(start, end) {
+  if (!start && !end) return "";
+  if (start && end) return `${formatDate(start)} \u2192 ${formatDate(end)}`;
+  return formatDate(start || end);
+}
+function gscDateRange(report) {
+  const summary = report.executiveSummary.gsc;
+  const gsc = report.gsc;
+  const start = summary?.periodStart || gsc?.periodStart || gsc?.trend[0]?.date || "";
+  const end = summary?.periodEnd || gsc?.periodEnd || gsc?.trend.at(-1)?.date || "";
+  return formatDateRange(start, end);
+}
+function pluralize(count, singular, plural = `${singular}s`) {
+  return count === 1 ? singular : plural;
+}
+function compactInlineList(items, limit = 3) {
+  const visible = items.slice(0, limit);
+  const more = items.length - visible.length;
+  return `${visible.join(", ")}${more > 0 ? `, +${more} more` : ""}`;
+}
+function renderProofChips(items, limit = 3) {
+  if (items.length === 0) return "";
+  const visible = items.slice(0, limit);
+  const more = items.length - visible.length;
+  const chips = visible.map((item) => `<span class="proof-chip">${escapeHtml(item)}</span>`);
+  if (more > 0) chips.push(`<span class="proof-chip">+${more} more</span>`);
+  return `<div class="proof-chips">${chips.join("")}</div>`;
+}
 function pressureTone(label) {
   if (label === "High") return "negative";
   if (label === "Moderate") return "caution";
@@ -2674,7 +2713,7 @@ body {
   font-size: 32px;
   font-weight: 700;
   margin: 0 0 8px;
-  letter-spacing: -0.02em;
+  letter-spacing: 0;
 }
 .header .subtitle {
   color: ${COLORS.textMuted};
@@ -2682,7 +2721,7 @@ body {
 }
 .eyebrow {
   text-transform: uppercase;
-  letter-spacing: 0.08em;
+  letter-spacing: 0;
   font-size: 10px;
   color: ${COLORS.textFaint};
   font-weight: 600;
@@ -2695,11 +2734,75 @@ section.report-section h2 {
   font-size: 22px;
   font-weight: 700;
   margin: 0 0 24px;
-  letter-spacing: -0.01em;
+  letter-spacing: 0;
 }
 section.report-section .section-intro {
   color: ${COLORS.textMuted};
   margin-bottom: 24px;
+  max-width: 760px;
+}
+.executive-hero {
+  display: grid;
+  grid-template-columns: minmax(0, 1.35fr) minmax(240px, 0.65fr);
+  gap: 16px;
+  margin-bottom: 16px;
+}
+.headline-card {
+  background: #111827;
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 28px;
+  min-height: 220px;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+}
+.headline-card .hero-kicker {
+  color: ${COLORS.textMuted};
+  font-size: 12px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0;
+}
+.headline-card .hero-title {
+  font-size: 44px;
+  line-height: 1.05;
+  font-weight: 800;
+  letter-spacing: 0;
+  margin: 18px 0;
+}
+.headline-card .hero-subtitle {
+  color: ${COLORS.textMuted};
+  font-size: 15px;
+  max-width: 620px;
+}
+.hero-proof-grid {
+  display: grid;
+  gap: 12px;
+}
+.hero-proof {
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 18px;
+}
+.hero-proof .mini-label {
+  color: ${COLORS.textFaint};
+  font-size: 10px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0;
+  margin-bottom: 8px;
+}
+.hero-proof .mini-value {
+  font-size: 30px;
+  line-height: 1;
+  font-weight: 800;
+}
+.hero-proof .mini-copy {
+  color: ${COLORS.textMuted};
+  font-size: 12px;
+  margin-top: 8px;
 }
 .metric-grid {
   display: grid;
@@ -2714,7 +2817,7 @@ section.report-section .section-intro {
 }
 .metric .label {
   text-transform: uppercase;
-  letter-spacing: 0.08em;
+  letter-spacing: 0;
   font-size: 10px;
   color: ${COLORS.textFaint};
   font-weight: 600;
@@ -2723,7 +2826,7 @@ section.report-section .section-intro {
 .metric .value {
   font-size: 28px;
   font-weight: 700;
-  letter-spacing: -0.02em;
+  letter-spacing: 0;
 }
 .metric .delta {
   font-size: 12px;
@@ -2748,10 +2851,46 @@ section.report-section .section-intro {
 .finding.tone-neutral { border-left-color: ${COLORS.neutral}; }
 .finding strong { display: block; margin-bottom: 4px; }
 .finding span { color: ${COLORS.textMuted}; font-size: 13px; }
-.location-card { margin-top: 16px; }
-.location-card .location-line { margin: 0 0 12px; font-size: 13px; color: ${COLORS.text}; }
-.location-card .location-line strong { color: ${COLORS.text}; }
-.location-card .location-line .cell-pending { font-size: 12px; }
+.market-scope-card { margin-top: 16px; }
+.market-scope-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 12px;
+}
+.scope-tile {
+  background: #09090b;
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 14px;
+}
+.scope-tile .scope-label {
+  color: ${COLORS.textFaint};
+  font-size: 10px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0;
+  margin-bottom: 8px;
+}
+.scope-tile .scope-value {
+  font-size: 18px;
+  line-height: 1.2;
+  font-weight: 700;
+}
+.scope-tile .scope-copy {
+  color: ${COLORS.textMuted};
+  font-size: 12px;
+  margin-top: 8px;
+}
+.scope-warning {
+  margin-top: 12px;
+  border: 1px solid ${COLORS.caution}55;
+  background: ${COLORS.caution}14;
+  border-radius: 8px;
+  padding: 12px 14px;
+  color: ${COLORS.textMuted};
+  font-size: 13px;
+}
+.scope-warning strong { color: ${COLORS.text}; display: block; margin-bottom: 4px; }
 .source-origin-headline { margin: 0 0 12px; font-size: 14px; color: ${COLORS.text}; }
 .source-origin-headline strong { color: ${COLORS.text}; }
 .source-bars { display: flex; flex-direction: column; gap: 6px; }
@@ -2773,18 +2912,24 @@ table.report-table th, table.report-table td {
   padding: 10px 12px;
   border-bottom: 1px solid ${COLORS.border};
   vertical-align: top;
-  overflow-wrap: anywhere;
-  word-break: break-word;
+  overflow-wrap: break-word;
+  hyphens: auto;
 }
 table.report-table th {
   font-weight: 600;
   color: ${COLORS.textMuted};
   text-transform: uppercase;
-  letter-spacing: 0.06em;
+  letter-spacing: 0;
   font-size: 10px;
 }
 table.report-table td.numeric { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
 table.report-table td.page-cell { max-width: 0; }
+table.insights-table { table-layout: fixed; }
+table.insights-table th.col-severity, table.insights-table td.col-severity { width: 96px; }
+table.insights-table th.col-query, table.insights-table td.col-query { width: 18%; }
+table.insights-table th.col-provider, table.insights-table td.col-provider { width: 88px; }
+table.insights-table th.col-title, table.insights-table td.col-title { width: 28%; }
+table.insights-table th.col-recommendation, table.insights-table td.col-recommendation { width: auto; }
 table.report-table td.page-cell .page-path {
   display: block;
   font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
@@ -2877,7 +3022,7 @@ table.report-table td .badge {
 .step .horizon {
   text-transform: uppercase;
   font-size: 10px;
-  letter-spacing: 0.08em;
+  letter-spacing: 0;
   color: ${COLORS.textFaint};
   font-weight: 600;
 }
@@ -2892,20 +3037,40 @@ table.report-table td .badge {
   background: ${COLORS.surface};
   border: 1px solid ${COLORS.border};
   border-radius: 8px;
-  padding: 18px 20px;
+  padding: 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.action-card .action-head {
+  display: grid;
+  grid-template-columns: 42px 1fr;
+  gap: 12px;
+  align-items: start;
+}
+.action-card .action-rank {
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  height: 42px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 16px;
+  font-weight: 800;
+  color: ${COLORS.text};
+  background: #09090b;
 }
 .action-card .action-meta {
   display: flex;
   flex-wrap: wrap;
   gap: 8px;
-  margin-bottom: 10px;
 }
 .action-card h3 {
   font-size: 16px;
-  margin: 0 0 8px;
+  margin: 8px 0 0;
 }
 .action-card p {
-  margin: 0 0 12px;
+  margin: 0;
   color: ${COLORS.textMuted};
 }
 .action-card ul {
@@ -2915,6 +3080,28 @@ table.report-table td .badge {
   font-size: 13px;
 }
 .action-card li { margin: 4px 0; }
+.proof-chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+.proof-chip {
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 6px 8px;
+  color: ${COLORS.textMuted};
+  font-size: 12px;
+  background: #09090b;
+}
+.action-details {
+  color: ${COLORS.textMuted};
+  font-size: 12px;
+}
+.action-details summary {
+  cursor: pointer;
+  color: ${COLORS.text};
+  font-weight: 600;
+}
 .action-card .success-metric {
   color: ${COLORS.text};
   font-size: 13px;
@@ -2950,10 +3137,44 @@ table.report-table td .badge {
 .diagnostic-card h3 { font-size: 14px; margin: 0 0 6px; }
 .diagnostic-card p { margin: 0 0 8px; color: ${COLORS.textMuted}; font-size: 13px; }
 .diagnostic-card ul { margin: 0; padding-left: 16px; color: ${COLORS.textMuted}; font-size: 12px; }
+.diagnostic-card .proof-chips { margin-top: 10px; }
 .diagnostic-card.tone-positive { border-left-color: ${COLORS.positive}; }
 .diagnostic-card.tone-caution { border-left-color: ${COLORS.caution}; }
 .diagnostic-card.tone-negative { border-left-color: ${COLORS.negative}; }
 .diagnostic-card.tone-neutral { border-left-color: ${COLORS.neutral}; }
+.opportunity-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: 12px;
+  margin-bottom: 16px;
+}
+.opportunity-card {
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 16px;
+}
+.opportunity-card .opportunity-score {
+  font-size: 32px;
+  line-height: 1;
+  font-weight: 800;
+  margin-bottom: 10px;
+}
+.opportunity-card .opportunity-score-suffix {
+  font-size: 14px;
+  font-weight: 600;
+  color: ${COLORS.textFaint};
+  margin-left: 4px;
+}
+.opportunity-card h3 {
+  font-size: 14px;
+  margin: 0 0 8px;
+}
+.opportunity-card p {
+  color: ${COLORS.textMuted};
+  font-size: 12px;
+  margin: 0;
+}
 .footer {
   margin-top: 96px;
   padding-top: 24px;
@@ -2962,6 +3183,14 @@ table.report-table td .badge {
   color: ${COLORS.textFaint};
   font-size: 12px;
 }
+@media (max-width: 760px) {
+  .container { padding: 32px 16px 72px; }
+  .executive-hero { grid-template-columns: 1fr; }
+  .headline-card .hero-title { font-size: 34px; }
+  .source-bar-row { grid-template-columns: 1fr; gap: 6px; }
+  .source-bar-value { text-align: left; }
+  .chart-grid { grid-template-columns: 1fr; }
+}
 @media print {
   body { background: white; color: black; }
   section.report-section { break-inside: avoid; }
@@ -2984,43 +3213,43 @@ function locationDisplay(location) {
   return place ? `${location.label} (${place})` : location.label;
 }
 function renderHeaderLocationFragment(location) {
-  if (!location) return " \xB7 No location set";
-  return ` \xB7 Location: ${escapeHtml(locationDisplay(location))}`;
+  if (!location) return " \xB7 No market set";
+  return ` \xB7 Market: ${escapeHtml(locationDisplay(location))}`;
 }
 function renderLocationCard(report) {
   const location = report.meta.location;
   const handling = report.meta.providerLocationHandling;
   if (!location && handling.length === 0) return "";
-  const treatmentTone = {
-    "request-param": "positive",
-    prompt: "positive",
-    "browser-geo": "caution",
-    ignored: "negative"
-  };
-  const treatmentLabel = {
-    "request-param": "Request parameter",
-    prompt: "Prompt-injected",
-    "browser-geo": "Browser geo",
-    ignored: "Ignored"
-  };
-  const locationLine = location ? `<p class="location-line"><strong>Location for this run:</strong> ${escapeHtml(locationDisplay(location))}${location.otherConfiguredLabels.length > 0 ? ` <span class="cell-pending">\u2014 other configured locations (${location.otherConfiguredLabels.map(escapeHtml).join(", ")}) need their own sweep to compare</span>` : ""}</p>` : `<p class="location-line"><strong>Location for this run:</strong> none \u2014 providers received the queries verbatim with no geographic hint.</p>`;
-  const handlingRows = handling.length > 0 ? handling.map((h) => {
-    const tone = treatmentTone[h.treatment] ?? "neutral";
-    const label = treatmentLabel[h.treatment] ?? h.treatment;
-    return `<tr>
-          <td>${escapeHtml(h.provider)}</td>
-          <td><span class="badge tone-${tone}">${escapeHtml(label)}</span></td>
-          <td>${escapeHtml(h.description)}</td>
-        </tr>`;
-  }).join("") : "";
-  const handlingTable = handlingRows ? `<table class="report-table">
-        <thead><tr><th>Provider</th><th>Treatment</th><th>How the location reached the model</th></tr></thead>
-        <tbody>${handlingRows}</tbody>
-      </table>` : "";
-  return `<div class="chart-card location-card">
-    <h3>Location handling</h3>
-    ${locationLine}
-    ${handlingTable}
+  const otherLocations = location?.otherConfiguredLabels ?? [];
+  const weakLocationProviders = handling.filter((h) => h.treatment === "ignored" || h.treatment === "browser-geo").map((h) => h.provider);
+  const marketValue = location ? locationDisplay(location) : "No market set";
+  const notIncluded = otherLocations.length > 0 ? compactInlineList(otherLocations, 4) : "None";
+  const interpretation = location ? otherLocations.length > 0 ? `${otherLocations.length} configured ${pluralize(otherLocations.length, "market")} still ${otherLocations.length === 1 ? "needs" : "need"} a matching check before cross-market recommendations.` : "Single-market report; findings can be read as the current market view." : "No geographic hint was attached to this check; read findings as default-market or national results.";
+  const providerCopy = handling.length > 0 ? weakLocationProviders.length > 0 ? `${weakLocationProviders.length} ${pluralize(weakLocationProviders.length, "provider")} need a closer location check.` : `${handling.length} ${pluralize(handling.length, "provider")} received the market context.` : "No provider-level location metadata is available for this report.";
+  const warning = weakLocationProviders.length > 0 ? `<div class="scope-warning">
+        <strong>Location handling needs review</strong>
+        ${escapeHtml(compactInlineList(weakLocationProviders, 4))} used weak or indirect market handling. Treat provider-level differences cautiously.
+      </div>` : "";
+  return `<div class="chart-card market-scope-card">
+    <h3>Market Scope</h3>
+    <div class="market-scope-grid">
+      <div class="scope-tile">
+        <div class="scope-label">Current check</div>
+        <div class="scope-value">${escapeHtml(marketValue)}</div>
+        <div class="scope-copy">All findings below are scoped to this run.</div>
+      </div>
+      <div class="scope-tile">
+        <div class="scope-label">Not included</div>
+        <div class="scope-value">${escapeHtml(notIncluded)}</div>
+        <div class="scope-copy">${escapeHtml(interpretation)}</div>
+      </div>
+      <div class="scope-tile">
+        <div class="scope-label">Provider context</div>
+        <div class="scope-value">${handling.length > 0 ? formatNumber(handling.length) : "\u2014"}</div>
+        <div class="scope-copy">${escapeHtml(providerCopy)}</div>
+      </div>
+    </div>
+    ${warning}
   </div>`;
 }
 function renderExecutiveSummary(report) {
@@ -3030,6 +3259,36 @@ function renderExecutiveSummary(report) {
   const queryNoun = s.totalQueryCount === 1 ? "query" : "queries";
   const citedFragment = s.totalQueryCount > 0 ? `${s.citedQueryCount}/${s.totalQueryCount} ${queryNoun} cited` : "no queries";
   const mentionedFragment = s.totalQueryCount > 0 ? `${s.mentionedQueryCount}/${s.totalQueryCount} ${queryNoun} mentioned` : "no queries";
+  const headlineTitle = s.totalQueryCount > 0 ? `${s.citedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} cite ${report.meta.project.displayName}` : "No AI citation data yet";
+  const headlineSubtitle = s.totalQueryCount > 0 ? `${s.citationRate}% citation coverage and ${s.mentionRate}% mention coverage across ${s.providerCount} ${pluralize(s.providerCount, "provider")}.` : "Run a check to populate the first citation and mention baseline.";
+  const priorityActions = report.agencyDiagnostics.priorities.length > 0 ? report.agencyDiagnostics.priorities : report.actionPlan;
+  const actionCount = dedupeReportActions(report, priorityActions).length;
+  const heroHtml = `<div class="executive-hero">
+    <div class="headline-card">
+      <div>
+        <div class="hero-kicker">Latest AI visibility check</div>
+        <div class="hero-title">${escapeHtml(headlineTitle)}</div>
+      </div>
+      <div class="hero-subtitle">${escapeHtml(headlineSubtitle)}</div>
+    </div>
+    <div class="hero-proof-grid">
+      <div class="hero-proof">
+        <div class="mini-label">Citation trend</div>
+        <div class="mini-value tone-${trendTone}">${escapeHtml(trendLabel)}</div>
+        <div class="mini-copy">${escapeHtml(citedFragment)}</div>
+      </div>
+      <div class="hero-proof">
+        <div class="mini-label">Mention coverage</div>
+        <div class="mini-value">${s.mentionRate}%</div>
+        <div class="mini-copy">${escapeHtml(mentionedFragment)}</div>
+      </div>
+      <div class="hero-proof">
+        <div class="mini-label">Prioritized actions</div>
+        <div class="mini-value">${formatNumber(actionCount)}</div>
+        <div class="mini-copy">Sorted for agency follow-up.</div>
+      </div>
+    </div>
+  </div>`;
   const metrics = [
     {
       label: "Citation rate",
@@ -3048,10 +3307,11 @@ function renderExecutiveSummary(report) {
     }
   ];
   if (s.gsc) {
+    const dateRange = gscDateRange(report);
     metrics.push({
       label: "GSC clicks",
       value: formatNumber(s.gsc.clicks),
-      delta: `${formatNumber(s.gsc.impressions)} imp \xB7 ${formatRatio(s.gsc.ctr)} CTR`
+      delta: `${formatNumber(s.gsc.impressions)} imp \xB7 ${formatRatio(s.gsc.ctr)} CTR${dateRange ? ` \xB7 ${escapeHtml(dateRange)}` : ""}`
     });
   }
   if (s.ga) {
@@ -3079,9 +3339,110 @@ function renderExecutiveSummary(report) {
       id: "executive-summary",
       eyebrow: "Section 1",
       title: "Executive Summary",
-      intro: "Two independent signals: Citation rate = share of tracked queries where your domain appeared in the source list the AI used. Mention rate = share of tracked queries where your brand or domain appeared in the answer text itself. A model can mention you without citing your domain, or cite your domain without naming you in the prose. Both are computed per-query so they stay comparable when provider count changes."
+      intro: "Citation = source list. Mention = answer text. They are independent signals."
     },
-    metricsHtml + findingsHtml + locationHtml
+    heroHtml + metricsHtml + findingsHtml + locationHtml
+  );
+}
+function deltaToneClass(direction) {
+  if (direction === "up") return "tone-positive";
+  if (direction === "down") return "tone-negative";
+  return "";
+}
+function deltaArrow(direction) {
+  if (direction === "up") return "\u2191";
+  if (direction === "down") return "\u2193";
+  return "\u2192";
+}
+function renderRateDeltaTile(label, delta, unit) {
+  if (!delta) {
+    return `<div class="metric"><div class="label">${escapeHtml(label)}</div><div class="value">\u2014</div><div class="delta">No prior data</div></div>`;
+  }
+  const valueSuffix = unit === "%" ? "%" : "";
+  const deltaSign = delta.deltaAbs > 0 ? "+" : "";
+  const deltaText = `${deltaSign}${delta.deltaAbs.toFixed(unit === "%" ? 1 : 0)}${valueSuffix} vs ${delta.prior}${valueSuffix}`;
+  return `<div class="metric">
+    <div class="label">${escapeHtml(label)}</div>
+    <div class="value ${deltaToneClass(delta.direction)}">${delta.current}${valueSuffix} <span style="font-size:14px;font-weight:500;">${deltaArrow(delta.direction)}</span></div>
+    <div class="delta">${deltaText}</div>
+  </div>`;
+}
+function renderTrafficDeltaTile(label, delta, countLabel) {
+  if (!delta) {
+    return `<div class="metric"><div class="label">${escapeHtml(label)}</div><div class="value">\u2014</div><div class="delta">Not enough trend data</div></div>`;
+  }
+  const deltaSign = delta.deltaAbs > 0 ? "+" : "";
+  const deltaText = `${deltaSign}${formatNumber(delta.deltaAbs)} ${countLabel} vs prior ${WHATS_CHANGED_PERIOD_DAYS} days`;
+  return `<div class="metric">
+    <div class="label">${escapeHtml(label)}</div>
+    <div class="value ${deltaToneClass(delta.direction)}">${formatNumber(delta.current)} <span style="font-size:14px;font-weight:500;">${deltaArrow(delta.direction)}</span></div>
+    <div class="delta">${deltaText}</div>
+  </div>`;
+}
+var WHATS_CHANGED_PERIOD_DAYS = 14;
+function renderProviderMovements(movements) {
+  const meaningful = movements.filter((m) => m.direction !== "flat");
+  if (meaningful.length === 0) return "";
+  const rows = meaningful.map((m) => {
+    const sign = m.deltaAbs > 0 ? "+" : "";
+    return `<tr>
+      <td>${escapeHtml(m.provider)}</td>
+      <td class="numeric">${m.prior}%</td>
+      <td class="numeric">${m.current}%</td>
+      <td class="numeric ${deltaToneClass(m.direction)}">${sign}${m.deltaAbs.toFixed(1)}% ${deltaArrow(m.direction)}</td>
+    </tr>`;
+  }).join("");
+  return `<div class="chart-card"><h3>AI engine movements</h3>
+    <table class="report-table">
+      <thead><tr><th>Engine</th><th class="numeric">Prior</th><th class="numeric">Current</th><th class="numeric">Change</th></tr></thead>
+      <tbody>${rows}</tbody>
+    </table>
+  </div>`;
+}
+function renderWinsLosses(insights2, heading, emptyMessage) {
+  if (insights2.length === 0) {
+    return `<div class="chart-card"><h3>${escapeHtml(heading)}</h3>
+      <p class="section-intro">${escapeHtml(emptyMessage)}</p>
+    </div>`;
+  }
+  const rows = insights2.map((i) => {
+    const tone = severityTone(i.severity);
+    const countChip = i.instanceCount > 1 ? ` <span class="badge tone-neutral">\xD7 ${i.instanceCount}</span>` : "";
+    return `<tr>
+      <td><span class="badge tone-${tone}">${escapeHtml(reportSeverityLabel(i.severity))}</span></td>
+      <td>${escapeHtml(i.title)}${countChip}</td>
+      <td>${escapeHtml(i.query)}</td>
+      <td>${escapeHtml(i.provider)}</td>
+    </tr>`;
+  }).join("");
+  return `<div class="chart-card"><h3>${escapeHtml(heading)}</h3>
+    <table class="report-table">
+      <thead><tr><th>Severity</th><th>Title</th><th>Query</th><th>Provider</th></tr></thead>
+      <tbody>${rows}</tbody>
+    </table>
+  </div>`;
+}
+function renderWhatsChanged(report) {
+  const w = report.whatsChanged;
+  if (!w.enoughHistory && !w.gscClicksDelta && !w.aiReferralsDelta && w.wins.length === 0 && w.regressions.length === 0) {
+    return section(
+      { id: "whats-changed", eyebrow: "Section 2", title: "What's Changed", intro: w.headline },
+      renderEmpty("Trends will appear after a few more checks.")
+    );
+  }
+  const rateTiles = `<div class="metric-grid">
+    ${renderRateDeltaTile("Citation rate", w.citationRate, "%")}
+    ${renderRateDeltaTile("Mention rate", w.mentionRate, "%")}
+    ${renderRateDeltaTile("Cited queries", w.citedQueryCount, "count")}
+    ${renderTrafficDeltaTile("GSC clicks", w.gscClicksDelta, "clicks")}
+    ${renderTrafficDeltaTile("AI referral sessions", w.aiReferralsDelta, "sessions")}
+  </div>`;
+  const movements = renderProviderMovements(w.providerMovements);
+  const wins = renderWinsLosses(w.wins, "Wins", "No new gains in the latest check.");
+  const regressions = renderWinsLosses(w.regressions, "Regressions", "No new regressions in the latest check.");
+  return section(
+    { id: "whats-changed", eyebrow: "Section 2", title: "What's Changed", intro: w.headline },
+    `${rateTiles}${movements}${wins}${regressions}`
   );
 }
 function renderProviderBars(rates) {
@@ -3112,7 +3473,7 @@ function renderProviderBars(rates) {
 }
 function renderCitationMatrix(scorecard) {
   if (scorecard.queries.length === 0 || scorecard.providers.length === 0) {
-    return renderEmpty("Run a visibility sweep to populate the citation matrix.");
+    return renderEmpty("Run a check to populate the citation matrix.");
   }
   const headers = scorecard.providers.map((p) => `<th>${escapeHtml(p)}</th>`).join("");
   const rows = scorecard.queries.map((q, qi) => {
@@ -3127,7 +3488,7 @@ function renderCitationMatrix(scorecard) {
     }).join("");
     return `<tr><td>${escapeHtml(q)}</td>${cells}</tr>`;
   }).join("");
-  const legend = '<p class="section-intro" style="margin-top:0;font-size:11px;">Each cell shows two flags \u2014 <span class="cell-cited">C</span>/<span class="cell-not-cited">c</span> = cited / not cited (your domain in the source list), <span class="cell-cited">M</span>/<span class="cell-not-cited">m</span> = mentioned / not mentioned (your brand in the answer text), <span class="cell-pending">\u2013</span> = no data.</p>';
+  const legend = '<p class="section-intro" style="margin-top:0;font-size:11px;">Legend: <span class="cell-cited">C</span>/<span class="cell-not-cited">c</span> = cited/not, <span class="cell-cited">M</span>/<span class="cell-not-cited">m</span> = mentioned/not, <span class="cell-pending">\u2013</span> = no data.</p>';
   return `${legend}<table class="report-table">
     <thead><tr><th>Query</th>${headers}</tr></thead>
     <tbody>${rows}</tbody>
@@ -3139,7 +3500,7 @@ function renderCitationScorecard(report) {
     ${renderCitationMatrix(report.citationScorecard)}
   `;
   return section(
-    { id: "citation-scorecard", eyebrow: "Section 2", title: "Citation Scorecard", intro: "Per (query \xD7 provider) view of both signals \u2014 citations (your domain in the source list) and mentions (your brand in the answer text) \u2014 for every tracked query in the latest sweep." },
+    { id: "citation-scorecard", eyebrow: "Section 3", title: "Citation Scorecard", intro: "Per-engine citation and mention coverage from the latest check." },
     body
   );
 }
@@ -3187,8 +3548,8 @@ function renderCompetitorLandscape(report) {
   const noMentionData = mentionLandscape.competitors.length === 0 && mentionLandscape.projectMentionCount === 0;
   if (noCitationData && noMentionData) {
     return section(
-      { id: "competitor-landscape", eyebrow: "Section 3", title: "Competitor Landscape" },
-      renderEmpty("No competitor data yet. Add competitors and run a visibility sweep.")
+      { id: "competitor-landscape", eyebrow: "Section 4", title: "Competitor Landscape" },
+      renderEmpty("No competitor data yet. Add competitors and run a check.")
     );
   }
   const mentionByDomain = new Map(mentionLandscape.competitors.map((m) => [m.domain, m]));
@@ -3219,9 +3580,9 @@ function renderCompetitorLandscape(report) {
   return section(
     {
       id: "competitor-landscape",
-      eyebrow: "Section 3",
+      eyebrow: "Section 4",
       title: "Competitor Landscape",
-      intro: "Where tracked competitors appear in AI answers compared to your domain \u2014 both in source citations and in the answer text itself."
+      intro: "Who AI engines cite and mention instead of the client."
     },
     `${charts}${table}`
   );
@@ -3262,12 +3623,32 @@ function renderCategoryBars(buckets) {
     <div class="source-bars">${rows}</div>
   </div>`;
 }
+function renderShareBars(heading, rows, countLabel) {
+  const visibleRows = rows.filter((r) => r.count > 0 || r.sharePct > 0);
+  if (visibleRows.length === 0) return "";
+  const bars = visibleRows.map((r, index) => {
+    const pct = Math.max(0, Math.min(100, r.sharePct));
+    const color = r.color ?? COLORS.series[index % COLORS.series.length];
+    return `
+      <div class="source-bar-row">
+        <div class="source-bar-label">${escapeHtml(r.label)}</div>
+        <div class="source-bar-track">
+          <div class="source-bar-fill" style="width:${pct.toFixed(1)}%;background:${color}"></div>
+        </div>
+        <div class="source-bar-value">${formatNumber(r.count)} <span class="source-bar-pct">${escapeHtml(countLabel)} \xB7 ${r.sharePct}%</span></div>
+      </div>`;
+  }).join("");
+  return `<div class="chart-card">
+    <h3>${escapeHtml(heading)}</h3>
+    <div class="source-bars">${bars}</div>
+  </div>`;
+}
 function renderAiSourceOrigin(report) {
   const origin = report.aiSourceOrigin;
   if (origin.categories.length === 0 && origin.topDomains.length === 0) {
     return section(
-      { id: "ai-source-origin", eyebrow: "Section 4", title: "AI Citation Sources" },
-      renderEmpty("No source data yet. Run a visibility sweep first.")
+      { id: "ai-source-origin", eyebrow: "Section 5", title: "AI Citation Sources" },
+      renderEmpty("No source data yet. Run a check first.")
     );
   }
   const competitorBucket = origin.categories.find((c) => c.category === "competitor");
@@ -3287,9 +3668,9 @@ function renderAiSourceOrigin(report) {
   return section(
     {
       id: "ai-source-origin",
-      eyebrow: "Section 4",
+      eyebrow: "Section 5",
       title: "AI Citation Sources",
-      intro: "Every external website AI engines cited as a source for your tracked queries in the latest sweep, ranked by citation count. Tracked competitors are pulled into their own bucket so you can see how much of the AI\u2019s answer came from rivals; the remaining buckets cover directories, forums, news, and other site types. Your own domains are excluded."
+      intro: "External domains AI engines cited most in the latest check."
     },
     `${headlineFragment}${table}${renderCategoryBars(origin.categories)}`
   );
@@ -3330,7 +3711,7 @@ function renderGsc(report) {
   const gsc = report.gsc;
   if (!gsc) {
     return section(
-      { id: "gsc", eyebrow: "Section 5", title: "GSC Performance" },
+      { id: "gsc", eyebrow: "Section 6", title: "GSC Performance" },
       renderEmpty("Connect Google Search Console to populate this section.")
     );
   }
@@ -3343,13 +3724,16 @@ function renderGsc(report) {
       <td class="numeric">${q.avgPosition.toFixed(1)}</td>
       <td><span class="badge tone-neutral">${escapeHtml(q.category)}</span></td>
     </tr>`).join("");
-  const breakdownRows = gsc.categoryBreakdown.map((c) => `
-    <tr>
-      <td>${escapeHtml(c.category)}</td>
-      <td class="numeric">${formatNumber(c.clicks)}</td>
-      <td class="numeric">${formatNumber(c.impressions)}</td>
-      <td class="numeric">${c.sharePct}%</td>
-    </tr>`).join("");
+  const categoryBars = renderShareBars(
+    "Search demand by intent",
+    gsc.categoryBreakdown.map((c, index) => ({
+      label: c.category,
+      count: c.clicks,
+      sharePct: c.sharePct,
+      color: COLORS.series[index % COLORS.series.length]
+    })),
+    "clicks"
+  );
   const trendChart = renderLineChart(
     gsc.trend.map((t) => ({ x: t.date, y: t.clicks, label: t.date.slice(5) })),
     COLORS.accent,
@@ -3358,18 +3742,19 @@ function renderGsc(report) {
   const crossoverBlocks = [];
   if (gsc.trackedButNoGsc.length > 0) {
     crossoverBlocks.push(`<div class="chart-card"><h3>AEO queries without search demand</h3>
-      <p class="section-intro">Tracked AEO queries with no GSC impressions in this window \u2014 review whether they represent real search demand.</p>
-      <ul>${gsc.trackedButNoGsc.map((q) => `<li>${escapeHtml(q)}</li>`).join("")}</ul>
+      <p class="section-intro">Review whether these still belong in the tracking set.</p>
+      ${renderProofChips(gsc.trackedButNoGsc, 6)}
     </div>`);
   }
   if (gsc.gscButNotTracked.length > 0) {
     crossoverBlocks.push(`<div class="chart-card"><h3>Search queries you should track</h3>
-      <p class="section-intro">GSC top queries (by impressions) that aren't tracked in your AEO project \u2014 candidates to add as queries.</p>
-      <ul>${gsc.gscButNotTracked.map((q) => `<li>${escapeHtml(q)}</li>`).join("")}</ul>
+      <p class="section-intro">High-impression candidates to add to AEO tracking.</p>
+      ${renderProofChips(gsc.gscButNotTracked, 6)}
     </div>`);
   }
+  const dateRange = gscDateRange(report);
   return section(
-    { id: "gsc", eyebrow: "Section 5", title: "GSC Performance", intro: "Your site\u2019s performance in Google\u2019s regular (non-AI) search results \u2014 top queries that drove impressions, intent breakdown, and the click trend, sourced from Google Search Console for the most recent sync window." },
+    { id: "gsc", eyebrow: "Section 6", title: "GSC Performance", intro: `Search demand signals to compare against AI visibility${dateRange ? ` for ${dateRange}` : ""}.` },
     `<div class="metric-grid">
       <div class="metric"><div class="label">Total clicks</div><div class="value">${formatNumber(gsc.totalClicks)}</div></div>
       <div class="metric"><div class="label">Total impressions</div><div class="value">${formatNumber(gsc.totalImpressions)}</div></div>
@@ -3383,12 +3768,7 @@ function renderGsc(report) {
         <tbody>${rows}</tbody>
       </table>
     </div>
-    <div class="chart-card"><h3>Category breakdown</h3>
-      <table class="report-table">
-        <thead><tr><th>Category</th><th class="numeric">Clicks</th><th class="numeric">Imp.</th><th class="numeric">Share</th></tr></thead>
-        <tbody>${breakdownRows}</tbody>
-      </table>
-    </div>
+    ${categoryBars}
     ${crossoverBlocks.join("\n")}`
   );
 }
@@ -3396,7 +3776,7 @@ function renderGa(report) {
   const ga = report.ga;
   if (!ga) {
     return section(
-      { id: "ga", eyebrow: "Section 6", title: "GA4 Traffic" },
+      { id: "ga", eyebrow: "Section 7", title: "GA4 Traffic" },
       renderEmpty("Connect Google Analytics 4 to populate this section.")
     );
   }
@@ -3407,14 +3787,18 @@ function renderGa(report) {
       <td class="numeric">${formatNumber(p.users)}</td>
       <td class="numeric">${formatNumber(p.organicSessions)}</td>
     </tr>`).join("");
-  const channelRows = ga.channelBreakdown.map((c) => `
-    <tr>
-      <td>${escapeHtml(c.channel)}</td>
-      <td class="numeric">${formatNumber(c.sessions)}</td>
-      <td class="numeric">${c.sharePct}%</td>
-    </tr>`).join("");
+  const channelBars = renderShareBars(
+    "Channel mix",
+    ga.channelBreakdown.map((c, index) => ({
+      label: c.channel,
+      count: c.sessions,
+      sharePct: c.sharePct,
+      color: COLORS.series[index % COLORS.series.length]
+    })),
+    "sessions"
+  );
   return section(
-    { id: "ga", eyebrow: "Section 6", title: "GA4 Traffic", intro: `Total sessions and users on your site between ${formatDate(ga.periodStart)} and ${formatDate(ga.periodEnd)}, with the top landing pages and channel breakdown \u2014 sourced from Google Analytics 4.` },
+    { id: "ga", eyebrow: "Section 7", title: "GA4 Traffic", intro: `Site traffic from ${formatDate(ga.periodStart)} to ${formatDate(ga.periodEnd)}.` },
     `<div class="metric-grid">
       <div class="metric"><div class="label">Total sessions</div><div class="value">${formatNumber(ga.totalSessions)}</div></div>
       <div class="metric"><div class="label">Total users</div><div class="value">${formatNumber(ga.totalUsers)}</div></div>
@@ -3426,28 +3810,27 @@ function renderGa(report) {
         <tbody>${pageRows}</tbody>
       </table>
     </div>
-    <div class="chart-card"><h3>Channel breakdown</h3>
-      <table class="report-table">
-        <thead><tr><th>Channel</th><th class="numeric">Sessions</th><th class="numeric">Share</th></tr></thead>
-        <tbody>${channelRows}</tbody>
-      </table>
-    </div>`
+    ${channelBars}`
   );
 }
 function renderSocial(report) {
   const social = report.socialReferrals;
   if (!social) {
     return section(
-      { id: "social-referrals", eyebrow: "Section 7", title: "Social Referrals" },
+      { id: "social-referrals", eyebrow: "Section 8", title: "Social Referrals" },
       renderEmpty("No social referral data yet.")
     );
   }
-  const channelRows = social.channels.map((c) => `
-    <tr>
-      <td>${escapeHtml(c.channelGroup)}</td>
-      <td class="numeric">${formatNumber(c.sessions)}</td>
-      <td class="numeric">${c.sharePct}%</td>
-    </tr>`).join("");
+  const channelBars = renderShareBars(
+    "Social channel mix",
+    social.channels.map((c, index) => ({
+      label: c.channelGroup,
+      count: c.sessions,
+      sharePct: c.sharePct,
+      color: COLORS.series[index % COLORS.series.length]
+    })),
+    "sessions"
+  );
   const campaignRows = social.topCampaigns.map((c) => `
     <tr>
       <td>${escapeHtml(c.source)}</td>
@@ -3455,18 +3838,13 @@ function renderSocial(report) {
       <td class="numeric">${formatNumber(c.sessions)}</td>
     </tr>`).join("");
   return section(
-    { id: "social-referrals", eyebrow: "Section 7", title: "Social Referrals", intro: "Sessions on your site sent by social platforms (LinkedIn, Facebook, X, etc.) \u2014 paid versus organic split and the top campaigns that drove them. Sourced from Google Analytics 4." },
+    { id: "social-referrals", eyebrow: "Section 8", title: "Social Referrals", intro: "Social traffic split by channel and campaign." },
     `<div class="metric-grid">
       <div class="metric"><div class="label">Total sessions</div><div class="value">${formatNumber(social.totalSessions)}</div></div>
       <div class="metric"><div class="label">Organic social</div><div class="value">${formatNumber(social.organicSessions)}</div></div>
       <div class="metric"><div class="label">Paid social</div><div class="value">${formatNumber(social.paidSessions)}</div></div>
     </div>
-    <div class="chart-card"><h3>Channel groups</h3>
-      <table class="report-table">
-        <thead><tr><th>Channel</th><th class="numeric">Sessions</th><th class="numeric">Share</th></tr></thead>
-        <tbody>${channelRows}</tbody>
-      </table>
-    </div>
+    ${channelBars}
     <div class="chart-card"><h3>Top campaigns</h3>
       <table class="report-table">
         <thead><tr><th>Source</th><th>Medium</th><th class="numeric">Sessions</th></tr></thead>
@@ -3479,17 +3857,20 @@ function renderAiReferrals(report) {
   const ai = report.aiReferrals;
   if (!ai) {
     return section(
-      { id: "ai-referrals", eyebrow: "Section 8", title: "AI Referral Traffic" },
+      { id: "ai-referrals", eyebrow: "Section 9", title: "AI Referral Traffic" },
       renderEmpty("No AI referral traffic detected yet.")
     );
   }
-  const sourceRows = ai.bySource.map((s) => `
-    <tr>
-      <td>${escapeHtml(s.source)}</td>
-      <td class="numeric">${formatNumber(s.sessions)}</td>
-      <td class="numeric">${formatNumber(s.users)}</td>
-      <td class="numeric">${s.sharePct}%</td>
-    </tr>`).join("");
+  const sourceBars = renderShareBars(
+    "AI sessions by source",
+    ai.bySource.map((s, index) => ({
+      label: s.source,
+      count: s.sessions,
+      sharePct: s.sharePct,
+      color: COLORS.series[(index + 2) % COLORS.series.length]
+    })),
+    "sessions"
+  );
   const pageRows = ai.topLandingPages.map((p) => `
     <tr>
       <td class="page-cell">${formatLandingPageHtml(p.page)}</td>
@@ -3502,18 +3883,13 @@ function renderAiReferrals(report) {
     "AI referral sessions over time"
   );
   return section(
-    { id: "ai-referrals", eyebrow: "Section 8", title: "AI Referral Traffic", intro: "Sessions on your site referred by AI answer engines (ChatGPT, Perplexity, Claude, Copilot, Gemini, etc.) \u2014 broken down by referrer with a daily trend and the top landing pages. Sourced from Google Analytics 4." },
+    { id: "ai-referrals", eyebrow: "Section 9", title: "AI Referral Traffic", intro: "Traffic arriving from AI answer engines." },
     `<div class="metric-grid">
       <div class="metric"><div class="label">Total sessions</div><div class="value">${formatNumber(ai.totalSessions)}</div></div>
       <div class="metric"><div class="label">Total users</div><div class="value">${formatNumber(ai.totalUsers)}</div></div>
     </div>
     ${trendChart}
-    <div class="chart-card"><h3>Sessions by source</h3>
-      <table class="report-table">
-        <thead><tr><th>Source</th><th class="numeric">Sessions</th><th class="numeric">Users</th><th class="numeric">Share</th></tr></thead>
-        <tbody>${sourceRows}</tbody>
-      </table>
-    </div>
+    ${sourceBars}
     <div class="chart-card"><h3>Top AI landing pages</h3>
       <table class="report-table">
         <thead><tr><th>Page</th><th class="numeric">Sessions</th><th class="numeric">Users</th></tr></thead>
@@ -3526,7 +3902,7 @@ function renderIndexingHealth(report) {
   const ih = report.indexingHealth;
   if (!ih) {
     return section(
-      { id: "indexing-health", eyebrow: "Section 9", title: "Indexing Health" },
+      { id: "indexing-health", eyebrow: "Section 10", title: "Indexing Health" },
       renderEmpty("Connect Google Search Console or Bing Webmaster Tools and run a sitemap inspection.")
     );
   }
@@ -3548,7 +3924,7 @@ function renderIndexingHealth(report) {
   }).join("");
   const legend = segments.map((s) => `<span><span class="legend-swatch" style="background:${s.color}"></span>${escapeHtml(s.label)}: ${s.count}</span>`).join("");
   return section(
-    { id: "indexing-health", eyebrow: "Section 9", title: "Indexing Health", intro: `What share of your tracked URLs are currently indexed in ${ih.provider === "google" ? "Google" : "Bing"} \u2014 sourced from ${ih.provider === "google" ? "Google Search Console URL Inspection" : "Bing Webmaster Tools URL Inspection"}. Pages absent from the index can\u2019t be retrieved by AI engines either.` },
+    { id: "indexing-health", eyebrow: "Section 10", title: "Indexing Health", intro: `Pages absent from ${ih.provider === "google" ? "Google" : "Bing"} are harder for AI engines to retrieve.` },
     `<div class="metric-grid">
       <div class="metric"><div class="label">Indexed</div><div class="value tone-positive">${formatNumber(ih.indexed)}</div></div>
       <div class="metric"><div class="label">Total inspected</div><div class="value">${formatNumber(ih.total)}</div></div>
@@ -3565,14 +3941,14 @@ function renderCitationsTrend(report) {
   const trend = report.citationsTrend;
   if (trend.length === 0) {
     return section(
-      { id: "citations-trend", eyebrow: "Section 10", title: "Citations Over Time" },
-      renderEmpty("Run multiple visibility sweeps to see a trend.")
+      { id: "citations-trend", eyebrow: "Section 11", title: "Citations Over Time" },
+      renderEmpty("Run multiple checks to see a trend.")
     );
   }
   if (isTrendBaseline(trend)) {
     return section(
-      { id: "citations-trend", eyebrow: "Section 10", title: "Citations Over Time" },
-      renderEmpty(`Establishing baseline (${trend.length} of ${MIN_TREND_POINTS} runs collected). Trend will appear once more sweeps are recorded.`)
+      { id: "citations-trend", eyebrow: "Section 11", title: "Citations Over Time" },
+      renderEmpty(`Building baseline (${trend.length} of ${MIN_TREND_POINTS} checks completed). Trend will appear once more checks are recorded.`)
     );
   }
   const chart = renderLineChart(
@@ -3588,11 +3964,11 @@ function renderCitationsTrend(report) {
       <td>${t.providerRates.map((r) => `${escapeHtml(r.provider)}: ${r.citationRate}%`).join(" \xB7 ")}</td>
     </tr>`).join("");
   return section(
-    { id: "citations-trend", eyebrow: "Section 10", title: "Citations Over Time", intro: "Citation rate across every visibility sweep \u2014 the share of tracked queries cited by at least one provider, with a per-provider breakdown beneath. Computed per-query so the headline stays comparable across runs that ran a different mix of providers." },
+    { id: "citations-trend", eyebrow: "Section 11", title: "Citations Over Time", intro: "Citation coverage across recent checks." },
     `${chart}
-    <div class="chart-card"><h3>Run-by-run breakdown</h3>
+    <div class="chart-card"><h3>Check-by-check breakdown</h3>
       <table class="report-table">
-        <thead><tr><th>Run</th><th class="numeric">Cited queries</th><th>Per-provider rates</th></tr></thead>
+        <thead><tr><th>Check</th><th class="numeric">Cited queries</th><th>Per-engine rates</th></tr></thead>
         <tbody>${rows}</tbody>
       </table>
     </div>`
@@ -3602,8 +3978,8 @@ function renderInsights(report) {
   const list = report.insights;
   if (list.length === 0) {
     return section(
-      { id: "insights", eyebrow: "Section 11", title: "Insights & Alerts" },
-      renderEmpty("No insights yet \u2014 run a visibility sweep to generate alerts.")
+      { id: "insights", eyebrow: "Section 12", title: "Insights & Alerts" },
+      renderEmpty("No insights yet \u2014 run a check to generate alerts.")
     );
   }
   const haveDeduped = list.every((i) => typeof i.instanceCount === "number");
@@ -3611,48 +3987,62 @@ function renderInsights(report) {
     const tone = severityTone(i.severity);
     const countChip = count > 1 ? ` <span class="badge tone-neutral">\xD7 ${count}</span>` : "";
     return `<tr>
-        <td><span class="badge tone-${tone}">${escapeHtml(i.severity)}</span></td>
-        <td>${escapeHtml(i.title)}${countChip}</td>
-        <td>${escapeHtml(i.query)}</td>
-        <td>${escapeHtml(i.provider)}</td>
-        <td>${i.recommendation ? escapeHtml(i.recommendation) : '<span class="cell-pending">\u2014</span>'}</td>
+        <td class="col-severity"><span class="badge tone-${tone}">${escapeHtml(reportSeverityLabel(i.severity))}</span></td>
+        <td class="col-title">${escapeHtml(i.title)}${countChip}</td>
+        <td class="col-query">${escapeHtml(i.query)}</td>
+        <td class="col-provider">${escapeHtml(i.provider)}</td>
+        <td class="col-recommendation">${i.recommendation ? escapeHtml(i.recommendation) : '<span class="cell-pending">\u2014</span>'}</td>
       </tr>`;
   }).join("");
   return section(
-    { id: "insights", eyebrow: "Section 11", title: "Insights & Alerts", intro: "Regressions (citations lost), gains (citations won), and opportunities surfaced by the intelligence engine across the most recent sweeps \u2014 ordered by severity and recurrence." },
-    `<table class="report-table">
-      <thead><tr><th>Severity</th><th>Title</th><th>Query</th><th>Provider</th><th>Recommendation</th></tr></thead>
+    { id: "insights", eyebrow: "Section 12", title: "Insights & Alerts", intro: "Regressions, gains, and recurring alerts ordered by severity." },
+    `<table class="report-table insights-table">
+      <thead><tr>
+        <th class="col-severity">Severity</th>
+        <th class="col-title">Title</th>
+        <th class="col-query">Query</th>
+        <th class="col-provider">Provider</th>
+        <th class="col-recommendation">Recommendation</th>
+      </tr></thead>
       <tbody>${rows}</tbody>
     </table>`
   );
 }
 function renderOpportunities(report) {
-  const opps = report.contentOpportunities;
+  const opps = dedupeReportOpportunities(report);
   if (opps.length === 0) return "";
   const canonical = report.meta.project.canonicalDomain;
+  const highlights = `<div class="opportunity-grid">
+    ${opps.slice(0, 3).map((o) => `<article class="opportunity-card">
+      <div class="opportunity-score" title="Opportunity score (0\u2013100, higher = stronger)">${Math.round(o.score)}<span class="opportunity-score-suffix">/100</span></div>
+      <h3>${escapeHtml(o.query)}</h3>
+      <p>${escapeHtml(contentActionLabel(o.action))} \xB7 ${escapeHtml(actionConfidenceLabel(o.actionConfidence))} confidence</p>
+      ${renderProofChips(o.drivers, 2)}
+    </article>`).join("")}
+  </div>`;
   const rows = opps.slice(0, 10).map((o) => {
     const ourPage = o.ourBestPage ? `<a href="${escapeHtml(absolutizeProjectUrl(o.ourBestPage.url, canonical))}">${escapeHtml(o.ourBestPage.url)}</a>` : '<span class="cell-not-cited">No page yet</span>';
     const winning = o.winningCompetitor ? `<a href="${escapeHtml(o.winningCompetitor.url)}">${escapeHtml(o.winningCompetitor.domain)}</a>` : '<span class="cell-not-cited">\u2014</span>';
     const drivers = o.drivers.length > 0 ? `<ul class="driver-list">${o.drivers.map((d) => `<li>${escapeHtml(d)}</li>`).join("")}</ul>` : '<span class="cell-not-cited">No driver signal yet</span>';
     return `<tr>
       <td>${escapeHtml(o.query)}</td>
-      <td><span class="badge tone-neutral">${escapeHtml(o.action)}</span></td>
-      <td class="numeric">${Math.round(o.score)}</td>
+      <td><span class="badge tone-neutral">${escapeHtml(contentActionLabel(o.action))}</span></td>
+      <td class="numeric" title="Opportunity score (0\u2013100)">${Math.round(o.score)}</td>
       <td>${drivers}</td>
       <td>${ourPage}</td>
       <td>${winning}</td>
-      <td><span class="badge tone-neutral">${escapeHtml(o.actionConfidence)}</span></td>
+      <td><span class="badge tone-neutral">${escapeHtml(actionConfidenceLabel(o.actionConfidence))}</span></td>
     </tr>`;
   }).join("");
   return section(
     {
       id: "content-opportunities",
-      eyebrow: "Section 12",
+      eyebrow: "Section 13",
       title: "Content Opportunities",
-      intro: "Queries where you have search demand or competitor citation pressure but aren\u2019t winning AI citations. Each row pairs a suggested action (create / refresh / expand / add-schema) with the signals driving the score, the best matching page on your domain, and the competitor URL the AI most often cites. Top 10 shown."
+      intro: "Queries where content work has the clearest path to more AI citations. Opportunity score is 0\u2013100, higher = stronger."
     },
-    `<table class="report-table">
-      <thead><tr><th>Query</th><th>Action</th><th class="numeric">Score</th><th>Why</th><th>Our page</th><th>Winning competitor</th><th>Confidence</th></tr></thead>
+    `${highlights}<table class="report-table">
+      <thead><tr><th>Query</th><th>Action</th><th class="numeric" title="Opportunity score (0\u2013100)">Score</th><th>Why</th><th>Our page</th><th>Winning competitor</th><th>Confidence</th></tr></thead>
       <tbody>${rows}</tbody>
     </table>`
   );
@@ -3673,9 +4063,9 @@ function renderContentGaps(report) {
   return section(
     {
       id: "content-gaps",
-      eyebrow: "Section 13",
+      eyebrow: "Section 14",
       title: "Content Gaps",
-      intro: 'Tracked queries where multiple competitors are cited by AI engines but you are not \u2014 explicit "they are answering, you are missing" signal. Sorted by recent miss rate, then by number of competitors cited. Top 10 shown.'
+      intro: "Tracked queries where competitors are cited and the client is missing."
     },
     `<table class="report-table">
       <thead><tr><th>Query</th><th class="numeric">Competitors cited</th><th>Domains</th><th class="numeric">Miss rate</th></tr></thead>
@@ -3687,7 +4077,7 @@ function renderRecommendedNextSteps(report) {
   const steps = report.recommendedNextSteps;
   if (steps.length === 0) {
     return section(
-      { id: "recommended-next-steps", eyebrow: "Section 14", title: "Recommended Next Steps", intro: "Action items bucketed by horizon (immediate, short-term, medium-term), drawn from open insights and the highest-ranked content opportunities." },
+      { id: "recommended-next-steps", eyebrow: "Section 15", title: "Recommended Next Steps", intro: "Action items bucketed by timing." },
       renderEmpty("No outstanding actions.")
     );
   }
@@ -3698,7 +4088,7 @@ function renderRecommendedNextSteps(report) {
       <span class="rationale">${escapeHtml(s.rationale)}</span>
     </div>`).join("");
   return section(
-    { id: "recommended-next-steps", eyebrow: "Section 14", title: "Recommended Next Steps", intro: "Action items bucketed by horizon (immediate, short-term, medium-term), drawn from open insights and the highest-ranked content opportunities." },
+    { id: "recommended-next-steps", eyebrow: "Section 15", title: "Recommended Next Steps", intro: "Action items bucketed by timing." },
     `<div class="steps">${items}</div>`
   );
 }
@@ -3708,33 +4098,45 @@ function actionAudienceMatches(action, audience) {
 function renderActionCards(actions) {
   if (actions.length === 0) return renderEmpty("No prioritized actions yet.");
   return `<div class="action-card-grid">
-    ${actions.map((action) => {
+    ${actions.map((action, idx) => {
     const tone = reportActionTone(action);
     const why = action.why.length > 0 ? `<ul>${action.why.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>` : "";
     const evidence = action.evidence.length > 0 ? `<ul>${action.evidence.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>` : "";
+    const proof = renderProofChips(action.evidence.length > 0 ? action.evidence : action.why, 3);
+    const details = why || evidence ? `<details class="action-details">
+            <summary>Evidence details</summary>
+            ${why ? `<div><strong>Why</strong>${why}</div>` : ""}
+            ${evidence ? `<div><strong>Evidence</strong>${evidence}</div>` : ""}
+          </details>` : "";
     return `<article class="action-card">
-        <div class="action-meta">
-          <span class="badge tone-${tone}">${escapeHtml(action.horizon)}</span>
-          <span class="badge tone-neutral">${escapeHtml(action.category)}</span>
-          <span class="badge tone-neutral">${escapeHtml(action.confidence)} confidence</span>
+        <div class="action-head">
+          <div class="action-rank" title="Impact rank \u2014 1 is the highest-leverage action">${idx + 1}</div>
+          <div>
+            <div class="action-meta">
+              <span class="badge tone-${tone}">${escapeHtml(reportHorizonLabel(action.horizon))}</span>
+              <span class="badge tone-neutral">${escapeHtml(reportActionCategoryLabel(action.category))}</span>
+              <span class="badge tone-neutral">${escapeHtml(reportConfidenceLabel(action.confidence))} confidence</span>
+            </div>
+            <h3>${escapeHtml(action.title)}</h3>
+          </div>
         </div>
-        <h3>${escapeHtml(action.title)}</h3>
         <p>${escapeHtml(action.action)}</p>
-        ${why ? `<div><strong>Why</strong>${why}</div>` : ""}
-        ${evidence ? `<div><strong>Evidence</strong>${evidence}</div>` : ""}
-        <div class="success-metric"><strong>Success metric:</strong> ${escapeHtml(action.successMetric)}</div>
+        ${proof}
+        ${details}
+        <div class="success-metric"><strong>Win condition:</strong> ${escapeHtml(action.successMetric)}</div>
       </article>`;
   }).join("")}
   </div>`;
 }
 function renderAudienceActionPlan(report, audience) {
-  const actions = audience === "client" ? report.clientSummary.actionItems : report.agencyDiagnostics.priorities.length > 0 ? report.agencyDiagnostics.priorities : report.actionPlan.filter((a) => actionAudienceMatches(a, audience));
+  const rawActions = audience === "client" ? report.clientSummary.actionItems : report.agencyDiagnostics.priorities.length > 0 ? report.agencyDiagnostics.priorities : report.actionPlan.filter((a) => actionAudienceMatches(a, audience));
+  const actions = dedupeReportActions(report, rawActions);
   return section(
     {
       id: audience === "client" ? "client-action-plan" : "agency-action-plan",
       eyebrow: audience === "client" ? "Client actions" : "Agency actions",
       title: audience === "client" ? "What We Recommend Next" : "Agency Action Plan",
-      intro: audience === "client" ? "Polished next steps the client can understand, backed by concise evidence from the report." : "Technical priorities pulled from the canonical action plan, sorted by urgency and evidence strength."
+      intro: audience === "client" ? "The short list to approve and execute." : "The highest-leverage work, sorted by urgency and evidence strength."
     },
     renderActionCards(actions)
   );
@@ -3786,11 +4188,12 @@ function renderClientEvidenceSummary(report) {
       <ul><li>${formatNumber(report.indexingHealth.indexed)} indexed</li><li>${formatNumber(report.indexingHealth.notIndexed)} not indexed</li></ul>
     </div>`);
   }
-  if (report.contentOpportunities.length > 0) {
+  const opportunities = dedupeReportOpportunities(report);
+  if (opportunities.length > 0) {
     evidenceCards.push(`<div class="diagnostic-card tone-caution">
       <h3>Content opportunities</h3>
       <p>Canonry found topics where better content could improve AI citations.</p>
-      <ul>${report.contentOpportunities.slice(0, 5).map((o) => `<li>${escapeHtml(o.query)}: ${escapeHtml(o.action)} (${Math.round(o.score)})</li>`).join("")}</ul>
+      <ul>${opportunities.slice(0, 5).map((o) => `<li>${escapeHtml(o.query)}: ${escapeHtml(o.action)} (${Math.round(o.score)})</li>`).join("")}</ul>
     </div>`);
   }
   return section(
@@ -3804,12 +4207,12 @@ function renderClientEvidenceSummary(report) {
   );
 }
 function renderAgencyDiagnostics(report) {
-  const diagnostics = report.agencyDiagnostics.diagnostics;
+  const diagnostics = report.agencyDiagnostics.diagnostics.filter((d) => d.title !== "Location caveat");
   const body = diagnostics.length > 0 ? `<div class="diagnostics-grid">
         ${diagnostics.map((d) => `<div class="diagnostic-card tone-${d.severity}">
           <h3>${escapeHtml(d.title)}</h3>
           <p>${escapeHtml(d.detail)}</p>
-          ${d.evidence.length > 0 ? `<ul>${d.evidence.map((e) => `<li>${escapeHtml(e)}</li>`).join("")}</ul>` : ""}
+          ${renderProofChips(d.evidence, 3)}
         </div>`).join("")}
       </div>` : renderEmpty("No agency diagnostics available yet.");
   return section(
@@ -3817,7 +4220,7 @@ function renderAgencyDiagnostics(report) {
       id: "agency-diagnostics",
       eyebrow: "Agency diagnostics",
       title: "Technical Diagnostics",
-      intro: "Operator-facing diagnostics for content, provider, source-domain, search-demand, indexing, and location follow-up."
+      intro: "Fast-read operator flags behind the action plan."
     },
     body
   );
@@ -3830,10 +4233,12 @@ function renderReportHtml(report, opts = {}) {
   const title = opts.title ?? `Canonry ${audience} report \u2014 ${report.meta.project.displayName}`;
   const sections = audience === "client" ? [
     renderClientSummary(report),
+    renderWhatsChanged(report),
     renderAudienceActionPlan(report, "client"),
     renderClientEvidenceSummary(report)
   ].join("\n") : [
     renderExecutiveSummary(report),
+    renderWhatsChanged(report),
     renderAudienceActionPlan(report, "agency"),
     renderAgencyDiagnostics(report),
     renderCitationScorecard(report),
@@ -3911,6 +4316,7 @@ function loadOrchestratorInput(db, project, locationFilter = void 0) {
     ownDomain,
     competitors: trackedCompetitors,
     candidateQueries,
+    queryIntentModifiers: buildQueryIntentModifiers(project, locationFilter),
     inventory,
     wpSchemaAudit: /* @__PURE__ */ new Map(),
     gaTrafficByPage,
@@ -3920,6 +4326,74 @@ function loadOrchestratorInput(db, project, locationFilter = void 0) {
     inProgressActions: /* @__PURE__ */ new Map()
   };
 }
+function buildQueryIntentModifiers(project, locationFilter) {
+  if (locationFilter === void 0 || locationFilter === null) return [];
+  const locations = parseJsonColumn(project.locations, []);
+  const currentLocation = locations.find((location) => location.label === locationFilter);
+  const raw = currentLocation ? [
+    currentLocation.label,
+    currentLocation.city,
+    currentLocation.region,
+    regionAbbreviation(currentLocation.region),
+    currentLocation.country
+  ] : [locationFilter];
+  return [...new Set(raw.map((value) => value.trim().toLowerCase()).filter(Boolean))];
+}
+function regionAbbreviation(region) {
+  return US_REGION_ABBREVIATIONS[region.trim().toLowerCase()] ?? "";
+}
+var US_REGION_ABBREVIATIONS = {
+  alabama: "al",
+  alaska: "ak",
+  arizona: "az",
+  arkansas: "ar",
+  california: "ca",
+  colorado: "co",
+  connecticut: "ct",
+  delaware: "de",
+  florida: "fl",
+  georgia: "ga",
+  hawaii: "hi",
+  idaho: "id",
+  illinois: "il",
+  indiana: "in",
+  iowa: "ia",
+  kansas: "ks",
+  kentucky: "ky",
+  louisiana: "la",
+  maine: "me",
+  maryland: "md",
+  massachusetts: "ma",
+  michigan: "mi",
+  minnesota: "mn",
+  mississippi: "ms",
+  missouri: "mo",
+  montana: "mt",
+  nebraska: "ne",
+  nevada: "nv",
+  "new hampshire": "nh",
+  "new jersey": "nj",
+  "new mexico": "nm",
+  "new york": "ny",
+  "north carolina": "nc",
+  "north dakota": "nd",
+  ohio: "oh",
+  oklahoma: "ok",
+  oregon: "or",
+  pennsylvania: "pa",
+  "rhode island": "ri",
+  "south carolina": "sc",
+  "south dakota": "sd",
+  tennessee: "tn",
+  texas: "tx",
+  utah: "ut",
+  vermont: "vt",
+  virginia: "va",
+  washington: "wa",
+  "west virginia": "wv",
+  wisconsin: "wi",
+  wyoming: "wy"
+};
 function listQueries(db, projectId) {
   const rows = db.select({ text: queries.query }).from(queries).where(eq12(queries.projectId, projectId)).all();
   return rows.map((r) => r.text);
@@ -4158,6 +4632,14 @@ var TOP_LANDING_PAGES_LIMIT = 20;
 var TOP_AI_REFERRAL_PAGES_LIMIT = 10;
 var TOP_CAMPAIGN_LIMIT = 10;
 var INSIGHT_LOOKBACK_RUNS = 5;
+var REPORT_WINDOW_DAYS = 30;
+function windowStartDate(endDate, windowDays) {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(endDate);
+  if (!m) return endDate;
+  const d = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])));
+  d.setUTCDate(d.getUTCDate() - (windowDays - 1));
+  return d.toISOString().slice(0, 10);
+}
 function safeNum(value) {
   if (typeof value === "number") return value;
   if (typeof value === "string") {
@@ -4193,7 +4675,12 @@ function loadQueryLookup(db, projectId) {
   return { byId };
 }
 function buildGscSection(db, projectId, projectDisplayName, canonicalDomain, trackedQueries) {
-  const rows = db.select().from(gscSearchData).where(eq13(gscSearchData.projectId, projectId)).all();
+  const allRows = db.select().from(gscSearchData).where(eq13(gscSearchData.projectId, projectId)).all();
+  if (allRows.length === 0) return null;
+  let maxDate = "";
+  for (const r of allRows) if (r.date > maxDate) maxDate = r.date;
+  const startDate = windowStartDate(maxDate, REPORT_WINDOW_DAYS);
+  const rows = allRows.filter((r) => r.date >= startDate && r.date <= maxDate);
   if (rows.length === 0) return null;
   let totalClicks = 0;
   let totalImpressions = 0;
@@ -4239,11 +4726,15 @@ function buildGscSection(db, projectId, projectDisplayName, canonicalDomain, tra
     sharePct: totalClicks > 0 ? Math.round(agg.clicks / totalClicks * 100) : 0
   })).sort((a, b) => b.clicks - a.clicks);
   const trend = [...trendAgg.entries()].map(([date, agg]) => ({ date, clicks: agg.clicks, impressions: agg.impressions })).sort((a, b) => a.date.localeCompare(b.date));
+  const periodStart = trend[0]?.date ?? "";
+  const periodEnd = trend.at(-1)?.date ?? "";
   const trackedSet = new Set(trackedQueries.map((q) => q.toLowerCase()));
   const gscQuerySet = new Set([...queryAgg.keys()].map((q) => q.toLowerCase()));
   const trackedButNoGsc = trackedQueries.filter((q) => !gscQuerySet.has(q.toLowerCase())).sort();
   const gscButNotTracked = [...queryAgg.entries()].filter(([q]) => !trackedSet.has(q.toLowerCase())).filter(([q]) => categorizeQuery(q, projectDisplayName, canonicalDomain) !== "brand").sort((a, b) => b[1].impressions - a[1].impressions).map(([q]) => q).slice(0, TOP_QUERIES_LIMIT);
   return {
+    periodStart,
+    periodEnd,
     totalClicks,
     totalImpressions,
     ctr,
@@ -4256,14 +4747,24 @@ function buildGscSection(db, projectId, projectDisplayName, canonicalDomain, tra
   };
 }
 function buildGaSection(db, projectId) {
-  const summaryRow = db.select().from(gaTrafficSummaries).where(eq13(gaTrafficSummaries.projectId, projectId)).orderBy(desc6(gaTrafficSummaries.syncedAt)).limit(1).get();
-  const snapshotRows = db.select().from(gaTrafficSnapshots).where(eq13(gaTrafficSnapshots.projectId, projectId)).all();
-  if (!summaryRow && snapshotRows.length === 0) return null;
-  const totalSessions = summaryRow?.totalSessions ?? snapshotRows.reduce((s, r) => s + r.sessions, 0);
-  const totalUsers = summaryRow?.totalUsers ?? snapshotRows.reduce((s, r) => s + r.users, 0);
-  const totalOrganicSessions = summaryRow?.totalOrganicSessions ?? snapshotRows.reduce((s, r) => s + r.organicSessions, 0);
+  const windowSummary = db.select().from(gaTrafficWindowSummaries).where(
+    and4(
+      eq13(gaTrafficWindowSummaries.projectId, projectId),
+      eq13(gaTrafficWindowSummaries.windowKey, "30d")
+    )
+  ).limit(1).get();
+  const fallbackSummary = windowSummary ? null : db.select().from(gaTrafficSummaries).where(eq13(gaTrafficSummaries.projectId, projectId)).orderBy(desc6(gaTrafficSummaries.syncedAt)).limit(1).get();
+  const allSnapshotRows = db.select().from(gaTrafficSnapshots).where(eq13(gaTrafficSnapshots.projectId, projectId)).all();
+  if (!windowSummary && !fallbackSummary && allSnapshotRows.length === 0) return null;
+  let snapshotMaxDate = "";
+  for (const r of allSnapshotRows) if (r.date > snapshotMaxDate) snapshotMaxDate = r.date;
+  const snapshotStartDate = snapshotMaxDate ? windowStartDate(snapshotMaxDate, REPORT_WINDOW_DAYS) : "";
+  const snapshotRows = snapshotStartDate ? allSnapshotRows.filter((r) => r.date >= snapshotStartDate && r.date <= snapshotMaxDate) : allSnapshotRows;
+  const totalSessions = windowSummary?.totalSessions ?? fallbackSummary?.totalSessions ?? snapshotRows.reduce((s, r) => s + r.sessions, 0);
+  const totalUsers = windowSummary?.totalUsers ?? fallbackSummary?.totalUsers ?? snapshotRows.reduce((s, r) => s + r.users, 0);
+  const totalOrganicSessions = windowSummary?.totalOrganicSessions ?? fallbackSummary?.totalOrganicSessions ?? snapshotRows.reduce((s, r) => s + r.organicSessions, 0);
   const pageAgg = /* @__PURE__ */ new Map();
-  let directSessions = 0;
+  let directSessions = windowSummary?.totalDirectSessions ?? 0;
   for (const r of snapshotRows) {
     const page = r.landingPageNormalized ?? r.landingPage;
     const existing = pageAgg.get(page) ?? { sessions: 0, users: 0, organic: 0 };
@@ -4271,7 +4772,7 @@ function buildGaSection(db, projectId) {
     existing.users += r.users;
     existing.organic += r.organicSessions;
     pageAgg.set(page, existing);
-    if (r.directSessions != null) directSessions += r.directSessions;
+    if (!windowSummary && r.directSessions != null) directSessions += r.directSessions;
   }
   const topLandingPages = [...pageAgg.entries()].map(([page, data]) => ({
     page,
@@ -4299,12 +4800,14 @@ function buildGaSection(db, projectId) {
       }
     }
   }
+  const periodStart = windowSummary?.periodStart ?? (snapshotStartDate || fallbackSummary?.periodStart || "");
+  const periodEnd = windowSummary?.periodEnd ?? (snapshotMaxDate || fallbackSummary?.periodEnd || "");
   return {
     totalSessions,
     totalUsers,
     totalOrganicSessions,
-    periodStart: summaryRow?.periodStart ?? "",
-    periodEnd: summaryRow?.periodEnd ?? "",
+    periodStart,
+    periodEnd,
     topLandingPages,
     channelBreakdown
   };
@@ -4557,7 +5060,7 @@ function buildExecutiveFindings(citationRate, citedQueryCount, totalQueryCount,
     const tone = trendBaseline ? "neutral" : trend === "up" ? "positive" : trend === "down" ? "negative" : "neutral";
     let detail;
     if (trendBaseline) {
-      detail = `Establishing baseline (${trendsPoints.length} of ${MIN_TREND_POINTS} runs collected).`;
+      detail = `Building baseline (${trendsPoints.length} of ${MIN_TREND_POINTS} checks completed).`;
     } else {
       switch (trend) {
         case "up":
@@ -4657,7 +5160,7 @@ function buildReportActionPlan(input) {
       horizon: "immediate",
       category: "competitors",
       title: "Define the competitor set Canonry should benchmark against",
-      action: "Review the recurring external source domains and add the true competitors before the next sweep.",
+      action: "Review the recurring external source domains and add the true competitors before the next check.",
       why: [
         "The report can identify repeated external sources, but it cannot separate competitors from publishers until competitors are configured.",
         "A clean competitor set makes future share-of-voice and content-gap reporting easier to explain to clients."
@@ -4691,7 +5194,7 @@ function buildReportActionPlan(input) {
       action: opportunity.ourBestPage ? `${verb} ${target} so it directly answers the tracked query and cites the strongest supporting evidence.` : `${verb} ${target} that directly answers the query and earns citations from AI answer engines.`,
       why: opportunity.drivers.length > 0 ? opportunity.drivers : ["Canonry ranked this as a content opportunity from search-demand and citation evidence."],
       evidence,
-      successMetric: `A future sweep cites ${input.canonicalDomain} for "${opportunity.query}" and the matching GSC query/page improves.`,
+      successMetric: `A future check cites ${input.canonicalDomain} for "${opportunity.query}" and the matching GSC query/page improves.`,
       confidence: opportunity.actionConfidence
     });
   }
@@ -4731,7 +5234,7 @@ function buildReportActionPlan(input) {
         "This points the agency toward provider-specific evidence gaps instead of a generic content recommendation."
       ],
       evidence: zeroCitationProviders.map((p) => `${p.provider}: 0/${p.totalCount} cited query-provider pairs`),
-      successMetric: "At least one zero-citation provider cites the client on a priority query in a later sweep.",
+      successMetric: "At least one zero-citation engine cites the client on a priority query in a later check.",
       confidence: "high"
     });
   }
@@ -4795,13 +5298,13 @@ function buildReportActionPlan(input) {
       horizon: "medium-term",
       category: "location",
       title: "Keep location-scoped reporting separate by market",
-      action: "Run and compare separate sweeps for each configured location before making market-level recommendations.",
+      action: "Run and compare separate checks for each configured location before making market-level recommendations.",
       why: [
         "A multi-location client can appear differently by market.",
         "Keeping each report location-scoped avoids mixing Florida and Michigan evidence in the same client story."
       ],
       evidence,
-      successMetric: "Each configured market has its own current sweep and trend before cross-market decisions are made.",
+      successMetric: "Each configured market has its own current check and trend before cross-market decisions are made.",
       confidence: "high"
     });
   }
@@ -4812,10 +5315,10 @@ function buildReportActionPlan(input) {
       horizon: "short-term",
       category: "monitoring",
       title: "Keep monitoring citation and mention coverage",
-      action: "Run the next scheduled visibility sweep and watch for citation gains, losses, and provider-specific misses.",
+      action: "Run the next scheduled check and watch for citation gains, losses, and engine-specific misses.",
       why: [
         "No urgent corrective action surfaced from the current evidence.",
-        "AEO performance is directional; repeated sweeps are needed before overreacting to a single sample."
+        "AEO performance is directional; repeated checks are needed before overreacting to a single sample."
       ],
       evidence: ["No critical insights, content gaps, indexing blockers, or provider-zero issues were detected in this report."],
       successMetric: "Coverage stays stable or improves across the next trend window.",
@@ -4827,11 +5330,11 @@ function buildReportActionPlan(input) {
 function trendSentence(trend) {
   switch (trend) {
     case "up":
-      return "Citation coverage improved versus the prior comparable sweep.";
+      return "Citation coverage improved versus the prior comparable check.";
     case "down":
-      return "Citation coverage declined versus the prior comparable sweep.";
+      return "Citation coverage declined versus the prior comparable check.";
     case "flat":
-      return "Citation coverage is flat versus the prior comparable sweep.";
+      return "Citation coverage is flat versus the prior comparable check.";
     case "unknown":
       return "There is not enough comparable run history yet to call a trend.";
   }
@@ -4839,16 +5342,16 @@ function trendSentence(trend) {
 function buildClientSummary(reportLike) {
   const s = reportLike.executiveSummary;
   const queryNoun = s.totalQueryCount === 1 ? "query" : "queries";
-  const headline = s.totalQueryCount > 0 ? `${s.citedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} are cited by AI engines` : "No tracked queries have completed a visibility sweep yet";
-  const overview = s.totalQueryCount > 0 ? `${reportLike.canonicalDomain} is cited on ${s.citationRate}% of tracked queries and mentioned on ${s.mentionRate}% of tracked queries. ${trendSentence(s.trend)}` : "Canonry needs at least one completed visibility sweep before it can summarize how the brand appears in AI answers.";
+  const headline = s.totalQueryCount > 0 ? `${s.citedQueryCount} of ${s.totalQueryCount} tracked ${queryNoun} are cited by AI engines` : "No tracked queries have completed a check yet";
+  const overview = s.totalQueryCount > 0 ? `${reportLike.canonicalDomain} is cited on ${s.citationRate}% of tracked queries and mentioned on ${s.mentionRate}% of tracked queries. ${trendSentence(s.trend)}` : "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 sweep completes.");
+    confidenceNotes.push("Confidence is low until the first tracked query check completes.");
   } else if (s.totalQueryCount < 5) {
     confidenceNotes.push("Directional read: the tracked query set is still small, so each query has outsized impact on the percentage.");
   }
   if (isTrendBaseline(reportLike.citationsTrend)) {
-    confidenceNotes.push(`Trend confidence is still developing; ${MIN_TREND_POINTS} comparable sweeps are needed for a stable trend.`);
+    confidenceNotes.push(`Trend confidence is still developing; ${MIN_TREND_POINTS} comparable checks are needed for a stable trend.`);
   }
   if (!reportLike.gsc) {
     confidenceNotes.push("Search Console is not connected, so content recommendations lean more heavily on citation and competitor evidence.");
@@ -4868,13 +5371,13 @@ function buildAgencyDiagnostics(input) {
   const zeroCitationProviders = input.citationScorecard.providerRates.filter((p) => p.totalCount > 0 && p.citedCount === 0);
   diagnostics.push({
     title: "Provider citation coverage",
-    detail: zeroCitationProviders.length > 0 ? `${zeroCitationProviders.length} provider${zeroCitationProviders.length === 1 ? "" : "s"} returned zero client citations in the latest sweep.` : "Every provider with completed snapshots produced at least one client citation or no provider data is available yet.",
+    detail: zeroCitationProviders.length > 0 ? `${zeroCitationProviders.length} engine${zeroCitationProviders.length === 1 ? "" : "s"} returned zero client citations in the latest check.` : "Every provider with completed snapshots produced at least one client citation or no provider data is available yet.",
     severity: zeroCitationProviders.length > 0 ? "negative" : "positive",
     evidence: zeroCitationProviders.length > 0 ? zeroCitationProviders.map((p) => `${p.provider}: 0/${p.totalCount}`) : input.citationScorecard.providerRates.map((p) => `${p.provider}: ${p.citedCount}/${p.totalCount}`)
   });
   diagnostics.push({
     title: "AI source domains",
-    detail: input.aiSourceOrigin.topDomains.length > 0 ? "Repeated external source domains show what AI engines are currently trusting for this topic set." : "No external source-domain evidence is available from the latest sweep yet.",
+    detail: input.aiSourceOrigin.topDomains.length > 0 ? "Repeated external source domains show what AI engines are currently trusting for this topic set." : "No external source-domain evidence is available from the latest check yet.",
     severity: input.aiSourceOrigin.topDomains.length > 0 ? "neutral" : "caution",
     evidence: input.aiSourceOrigin.topDomains.slice(0, 5).map((d) => `${d.domain}: ${d.count}`)
   });
@@ -4906,22 +5409,117 @@ function buildAgencyDiagnostics(input) {
     severity: input.contentOpportunities.length > 0 ? "caution" : "neutral",
     evidence: input.contentOpportunities.slice(0, 3).map((o) => `${o.query}: ${o.action} (${Math.round(o.score)})`)
   });
-  if (input.reportLocation) {
-    diagnostics.push({
-      title: "Location caveat",
-      detail: input.reportLocation.otherConfiguredLabels.length > 0 ? "This report is scoped to the latest run location; other configured locations need separate interpretation." : "This report is scoped to one configured location.",
-      severity: input.reportLocation.otherConfiguredLabels.length > 0 ? "caution" : "neutral",
-      evidence: [
-        `Current location: ${input.reportLocation.label}`,
-        ...input.reportLocation.otherConfiguredLabels.length > 0 ? [`Other configured locations: ${compactList(input.reportLocation.otherConfiguredLabels)}`] : []
-      ]
-    });
-  }
   return {
     priorities: input.actionPlan.filter((a) => actionAudienceMatches2(a, "agency")).slice(0, 6),
     diagnostics
   };
 }
+var WHATS_CHANGED_PERIOD_DAYS2 = 14;
+var WHATS_CHANGED_MIN_TREND_POINTS = WHATS_CHANGED_PERIOD_DAYS2 * 2;
+var WIN_REGRESSION_LIMIT = 5;
+function rateDirection(delta, threshold = 0.5) {
+  if (delta > threshold) return "up";
+  if (delta < -threshold) return "down";
+  return "flat";
+}
+function periodOverPeriodDelta(trend) {
+  if (trend.length < WHATS_CHANGED_MIN_TREND_POINTS) return null;
+  const tail = trend.slice(-WHATS_CHANGED_PERIOD_DAYS2);
+  const prior = trend.slice(-WHATS_CHANGED_PERIOD_DAYS2 * 2, -WHATS_CHANGED_PERIOD_DAYS2);
+  const current = tail.reduce((s, p) => s + p.value, 0);
+  const priorTotal = prior.reduce((s, p) => s + p.value, 0);
+  const deltaAbs = current - priorTotal;
+  return {
+    current,
+    prior: priorTotal,
+    deltaAbs,
+    direction: rateDirection(deltaAbs, 0)
+  };
+}
+function buildWhatsChangedHeadline(citation, gscClicks, aiReferrals, enoughHistory, trendLength) {
+  if (!enoughHistory) {
+    return `Building baseline (${trendLength} of ${MIN_TREND_POINTS} checks completed). Trends appear after a few more checks.`;
+  }
+  const parts = [];
+  if (citation) {
+    const arrow = citation.direction === "up" ? "\u2191" : citation.direction === "down" ? "\u2193" : "\u2192";
+    const verb = citation.direction === "up" ? "rose" : citation.direction === "down" ? "fell" : "held";
+    parts.push(`Citation rate ${verb} ${citation.prior}% ${arrow} ${citation.current}%`);
+  }
+  if (aiReferrals && aiReferrals.direction !== "flat") {
+    const arrow = aiReferrals.direction === "up" ? "\u2191" : "\u2193";
+    parts.push(`AI referrals ${arrow}${Math.abs(aiReferrals.deltaAbs)} sessions vs prior 14 days`);
+  } else if (gscClicks && gscClicks.direction !== "flat") {
+    const arrow = gscClicks.direction === "up" ? "\u2191" : "\u2193";
+    parts.push(`GSC clicks ${arrow}${Math.abs(gscClicks.deltaAbs)} vs prior 14 days`);
+  }
+  return parts.length > 0 ? `${parts.join(" \xB7 ")}.` : "No meaningful movement vs the prior period.";
+}
+function buildWhatsChanged(input) {
+  const { citationsTrend, gsc, aiReferrals, insights: insightList } = input;
+  const baseline = isTrendBaseline(citationsTrend);
+  const latest = citationsTrend.at(-1);
+  const prior = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
+  const enoughHistory = !baseline && latest !== void 0 && prior !== void 0;
+  const citationRate = enoughHistory ? {
+    current: latest.citationRate,
+    prior: prior.citationRate,
+    deltaAbs: latest.citationRate - prior.citationRate,
+    direction: rateDirection(latest.citationRate - prior.citationRate)
+  } : null;
+  const mentionRate = enoughHistory ? {
+    current: latest.mentionRate,
+    prior: prior.mentionRate,
+    deltaAbs: latest.mentionRate - prior.mentionRate,
+    direction: rateDirection(latest.mentionRate - prior.mentionRate)
+  } : null;
+  const citedQueryCount = enoughHistory ? {
+    current: latest.citedQueryCount,
+    prior: prior.citedQueryCount,
+    deltaAbs: latest.citedQueryCount - prior.citedQueryCount,
+    direction: rateDirection(latest.citedQueryCount - prior.citedQueryCount, 0)
+  } : null;
+  const providerMovements = [];
+  if (enoughHistory) {
+    const priorByProvider = new Map(prior.providerRates.map((p) => [p.provider, p.citationRate]));
+    for (const cur of latest.providerRates) {
+      const priorRate = priorByProvider.get(cur.provider);
+      if (priorRate === void 0) continue;
+      const deltaAbs = cur.citationRate - priorRate;
+      providerMovements.push({
+        provider: cur.provider,
+        current: cur.citationRate,
+        prior: priorRate,
+        deltaAbs,
+        direction: rateDirection(deltaAbs)
+      });
+    }
+    providerMovements.sort((a, b) => Math.abs(b.deltaAbs) - Math.abs(a.deltaAbs));
+  }
+  const gscClicksDelta = gsc ? periodOverPeriodDelta(gsc.trend.map((t) => ({ date: t.date, value: t.clicks }))) : null;
+  const aiReferralsDelta = aiReferrals ? periodOverPeriodDelta(aiReferrals.trend.map((t) => ({ date: t.date, value: t.sessions }))) : null;
+  const wins = insightList.filter((i) => i.type === "gain").slice(0, WIN_REGRESSION_LIMIT);
+  const regressions = insightList.filter((i) => i.type === "regression").slice(0, WIN_REGRESSION_LIMIT);
+  const headline = buildWhatsChangedHeadline(
+    citationRate,
+    gscClicksDelta,
+    aiReferralsDelta,
+    enoughHistory,
+    citationsTrend.length
+  );
+  return {
+    enoughHistory,
+    headline,
+    citationRate,
+    mentionRate,
+    citedQueryCount,
+    gscClicksDelta,
+    aiReferralsDelta,
+    providerMovements,
+    wins,
+    regressions
+  };
+}
 function buildProjectReport(db, projectName) {
   const project = resolveProject(db, projectName);
   const queryLookup = loadQueryLookup(db, project.id);
@@ -4974,6 +5572,12 @@ function buildProjectReport(db, projectName) {
     contentOpportunities,
     insightDerivedSteps
   );
+  const whatsChanged = buildWhatsChanged({
+    citationsTrend,
+    gsc: gscSection,
+    aiReferrals: aiReferralsSection,
+    insights: insightList
+  });
   const totalQueryCount = queryLookup.byId.size;
   const citedQueryIds = /* @__PURE__ */ new Set();
   const mentionedQueryIds = /* @__PURE__ */ new Set();
@@ -5029,7 +5633,9 @@ function buildProjectReport(db, projectName) {
       clicks: gscSection.totalClicks,
       impressions: gscSection.totalImpressions,
       ctr: gscSection.ctr,
-      avgPosition: gscSection.avgPosition
+      avgPosition: gscSection.avgPosition,
+      periodStart: gscSection.periodStart,
+      periodEnd: gscSection.periodEnd
     } : null,
     ga: gaSection ? {
       sessions: gaSection.totalSessions,
@@ -5099,6 +5705,7 @@ function buildProjectReport(db, projectName) {
     aiReferrals: aiReferralsSection,
     indexingHealth: indexingHealthSection,
     citationsTrend,
+    whatsChanged,
     insights: insightList,
     recommendedNextSteps,
     actionPlan,