@ainyc/canonry 3.4.7 → 3.5.0

package/dist/{chunk-3WMODJE5.js → chunk-5G7S6SEP.js}

@@ -2396,6 +2396,999 @@ async function intelligenceRoutes(app) {
 // ../api-routes/src/report.ts
 import { and as and4, desc as desc6, eq as eq13, inArray as inArray4, or as or2 } from "drizzle-orm";
 
+// ../api-routes/src/report-renderer.ts
+var COLORS = {
+  bg: "#09090b",
+  surface: "#18181b4d",
+  border: "#27272a99",
+  text: "#fafafa",
+  textMuted: "#a1a1aa",
+  textFaint: "#71717a",
+  positive: "#10b981",
+  caution: "#f59e0b",
+  negative: "#f43f5e",
+  neutral: "#71717a",
+  accent: "#3b82f6",
+  series: ["#10b981", "#3b82f6", "#ec4899", "#eab308", "#a855f7", "#f97316", "#06b6d4", "#ef4444"]
+};
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function formatRatio(value) {
+  if (!Number.isFinite(value) || value === 0) return "0%";
+  return `${(value * 100).toFixed(1)}%`;
+}
+function formatNumber(value) {
+  if (!Number.isFinite(value)) return "\u2014";
+  if (Math.abs(value) >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+  if (Math.abs(value) >= 1e3) return `${(value / 1e3).toFixed(1)}K`;
+  return value.toLocaleString("en-US");
+}
+function summarizeQueryParams(params) {
+  const keys = Array.from(params.keys());
+  const total = keys.length;
+  if (total === 0) return "";
+  const noun = total === 1 ? "param" : "params";
+  const tag = inferAdSource(params);
+  return tag ? `${tag} \xB7 ${total} ${noun}` : `${total} tracking ${noun}`;
+}
+function inferAdSource(params) {
+  if (params.has("fbclid")) return "Facebook Ad";
+  if (params.has("gclid") || params.has("gbraid") || params.has("wbraid")) return "Google Ad";
+  if (params.has("msclkid")) return "Microsoft Ad";
+  if (params.has("ttclid")) return "TikTok Ad";
+  if (params.has("li_fat_id")) return "LinkedIn Ad";
+  if (params.has("twclid")) return "X / Twitter Ad";
+  if (params.has("epik")) return "Pinterest Ad";
+  for (const k of params.keys()) {
+    if (k.startsWith("hsa_")) return "Search Ad";
+  }
+  const src = params.get("utm_source");
+  const med = params.get("utm_medium");
+  if (src && med) return `${src} / ${med}`;
+  if (src) return `Source: ${src}`;
+  if (med) return `Medium: ${med}`;
+  return null;
+}
+function formatLandingPageHtml(raw) {
+  const value = raw ?? "";
+  const queryIdx = value.indexOf("?");
+  const path15 = queryIdx === -1 ? value : value.slice(0, queryIdx);
+  const query = queryIdx === -1 ? "" : value.slice(queryIdx + 1);
+  const pathHtml = `<span class="page-path">${escapeHtml(path15 || "/")}</span>`;
+  if (!query) return pathHtml;
+  let summary = "";
+  try {
+    summary = summarizeQueryParams(new URLSearchParams(query));
+  } catch {
+    summary = "tracking params";
+  }
+  if (!summary) return pathHtml;
+  return `${pathHtml}<span class="page-query" title="${escapeHtml(value)}">${escapeHtml(summary)}</span>`;
+}
+function formatDate(iso) {
+  if (!iso) return "\u2014";
+  try {
+    const d = new Date(iso);
+    return d.toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric" });
+  } catch {
+    return iso;
+  }
+}
+function pressureTone(label) {
+  if (label === "High") return "negative";
+  if (label === "Moderate") return "caution";
+  if (label === "Low") return "positive";
+  return "neutral";
+}
+function severityTone(severity) {
+  switch (severity) {
+    case "critical":
+      return "negative";
+    case "high":
+      return "negative";
+    case "medium":
+      return "caution";
+    case "low":
+      return "neutral";
+  }
+}
+var STYLE = `
+:root {
+  color-scheme: dark;
+}
+* { box-sizing: border-box; }
+html, body { margin: 0; padding: 0; }
+body {
+  background: ${COLORS.bg};
+  color: ${COLORS.text};
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
+  font-size: 14px;
+  line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+}
+.container {
+  max-width: 1100px;
+  margin: 0 auto;
+  padding: 48px 24px 96px;
+}
+.header {
+  border-bottom: 1px solid ${COLORS.border};
+  padding-bottom: 32px;
+  margin-bottom: 48px;
+}
+.header h1 {
+  font-size: 32px;
+  font-weight: 700;
+  margin: 0 0 8px;
+  letter-spacing: -0.02em;
+}
+.header .subtitle {
+  color: ${COLORS.textMuted};
+  font-size: 14px;
+}
+.eyebrow {
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  font-size: 10px;
+  color: ${COLORS.textFaint};
+  font-weight: 600;
+  margin-bottom: 8px;
+}
+section.report-section {
+  margin: 64px 0;
+}
+section.report-section h2 {
+  font-size: 22px;
+  font-weight: 700;
+  margin: 0 0 24px;
+  letter-spacing: -0.01em;
+}
+section.report-section .section-intro {
+  color: ${COLORS.textMuted};
+  margin-bottom: 24px;
+}
+.metric-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 16px;
+}
+.metric {
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 16px 20px;
+}
+.metric .label {
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  font-size: 10px;
+  color: ${COLORS.textFaint};
+  font-weight: 600;
+  margin-bottom: 8px;
+}
+.metric .value {
+  font-size: 28px;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+}
+.metric .delta {
+  font-size: 12px;
+  color: ${COLORS.textMuted};
+  margin-top: 4px;
+}
+.findings {
+  margin-top: 24px;
+  display: grid;
+  gap: 12px;
+}
+.finding {
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-left-width: 3px;
+  border-radius: 6px;
+  padding: 12px 16px;
+}
+.finding.tone-positive { border-left-color: ${COLORS.positive}; }
+.finding.tone-caution { border-left-color: ${COLORS.caution}; }
+.finding.tone-negative { border-left-color: ${COLORS.negative}; }
+.finding.tone-neutral { border-left-color: ${COLORS.neutral}; }
+.finding strong { display: block; margin-bottom: 4px; }
+.finding span { color: ${COLORS.textMuted}; font-size: 13px; }
+table.report-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 13px;
+}
+table.report-table th, table.report-table td {
+  text-align: left;
+  padding: 10px 12px;
+  border-bottom: 1px solid ${COLORS.border};
+  vertical-align: top;
+  overflow-wrap: anywhere;
+  word-break: break-word;
+}
+table.report-table th {
+  font-weight: 600;
+  color: ${COLORS.textMuted};
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  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.report-table td.page-cell .page-path {
+  display: block;
+  font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;
+  font-size: 12px;
+  color: ${COLORS.text};
+}
+table.report-table td.page-cell .page-query {
+  display: inline-block;
+  margin-top: 4px;
+  padding: 1px 8px;
+  font-size: 11px;
+  color: ${COLORS.textMuted};
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 999px;
+  cursor: help;
+}
+table.report-table td .badge {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 999px;
+  font-size: 11px;
+  font-weight: 600;
+  border: 1px solid;
+}
+.cell-cited { color: ${COLORS.positive}; font-weight: 600; }
+.cell-not-cited { color: ${COLORS.textFaint}; }
+.cell-pending { color: ${COLORS.textFaint}; font-style: italic; }
+.tone-positive { color: ${COLORS.positive}; }
+.tone-caution { color: ${COLORS.caution}; }
+.tone-negative { color: ${COLORS.negative}; }
+.tone-neutral { color: ${COLORS.neutral}; }
+.badge.tone-positive { color: ${COLORS.positive}; border-color: ${COLORS.positive}40; background: ${COLORS.positive}14; }
+.badge.tone-caution { color: ${COLORS.caution}; border-color: ${COLORS.caution}40; background: ${COLORS.caution}14; }
+.badge.tone-negative { color: ${COLORS.negative}; border-color: ${COLORS.negative}40; background: ${COLORS.negative}14; }
+.badge.tone-neutral { color: ${COLORS.textMuted}; border-color: ${COLORS.border}; background: transparent; }
+.chart-card {
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 20px;
+  margin-bottom: 16px;
+}
+.chart-card h3 {
+  font-size: 14px;
+  font-weight: 600;
+  margin: 0 0 16px;
+}
+.chart-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(360px, 1fr));
+  gap: 16px;
+}
+.legend {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  font-size: 12px;
+  margin-top: 12px;
+}
+.legend-swatch {
+  display: inline-block;
+  width: 10px;
+  height: 10px;
+  border-radius: 2px;
+  margin-right: 6px;
+  vertical-align: middle;
+}
+.empty-state {
+  background: ${COLORS.surface};
+  border: 1px dashed ${COLORS.border};
+  border-radius: 8px;
+  padding: 32px;
+  color: ${COLORS.textMuted};
+  text-align: center;
+  font-size: 13px;
+}
+.steps {
+  display: grid;
+  gap: 12px;
+}
+.step {
+  background: ${COLORS.surface};
+  border: 1px solid ${COLORS.border};
+  border-radius: 8px;
+  padding: 16px 20px;
+  display: grid;
+  gap: 4px;
+}
+.step .horizon {
+  text-transform: uppercase;
+  font-size: 10px;
+  letter-spacing: 0.08em;
+  color: ${COLORS.textFaint};
+  font-weight: 600;
+}
+.step .title { font-weight: 600; }
+.step .rationale { color: ${COLORS.textMuted}; font-size: 13px; }
+.footer {
+  margin-top: 96px;
+  padding-top: 24px;
+  border-top: 1px solid ${COLORS.border};
+  text-align: center;
+  color: ${COLORS.textFaint};
+  font-size: 12px;
+}
+@media print {
+  body { background: white; color: black; }
+  section.report-section { break-inside: avoid; }
+}
+`;
+function section(opts, body) {
+  return `<section class="report-section" id="${escapeHtml(opts.id)}">
+    <div class="eyebrow">${escapeHtml(opts.eyebrow)}</div>
+    <h2>${escapeHtml(opts.title)}</h2>
+    ${opts.intro ? `<p class="section-intro">${escapeHtml(opts.intro)}</p>` : ""}
+    ${body}
+  </section>`;
+}
+function renderEmpty(message) {
+  return `<div class="empty-state">${escapeHtml(message)}</div>`;
+}
+function renderExecutiveSummary(report) {
+  const s = report.executiveSummary;
+  const trendLabel = s.trend === "up" ? "\u2191 Up" : s.trend === "down" ? "\u2193 Down" : s.trend === "flat" ? "\u2192 Flat" : "\u2014";
+  const trendTone = s.trend === "up" ? "positive" : s.trend === "down" ? "negative" : "neutral";
+  const metrics = [
+    {
+      label: "Citation rate",
+      value: `${s.citationRate}%`,
+      delta: `<span class="tone-${trendTone}">${trendLabel}</span> \xB7 ${s.providerCount} provider${s.providerCount === 1 ? "" : "s"}`
+    },
+    {
+      label: "Keywords tracked",
+      value: formatNumber(s.keywordCount),
+      delta: `${s.competitorCount} competitor${s.competitorCount === 1 ? "" : "s"} tracked`
+    }
+  ];
+  if (s.gsc) {
+    metrics.push({
+      label: "GSC clicks",
+      value: formatNumber(s.gsc.clicks),
+      delta: `${formatNumber(s.gsc.impressions)} imp \xB7 ${formatRatio(s.gsc.ctr)} CTR`
+    });
+  }
+  if (s.ga) {
+    metrics.push({
+      label: "GA sessions",
+      value: formatNumber(s.ga.sessions),
+      delta: `${formatNumber(s.ga.users)} users \xB7 ${formatDate(s.ga.periodStart)} \u2192 ${formatDate(s.ga.periodEnd)}`
+    });
+  }
+  const metricsHtml = `<div class="metric-grid">
+    ${metrics.map((m) => `<div class="metric">
+      <div class="label">${escapeHtml(m.label)}</div>
+      <div class="value">${m.value}</div>
+      <div class="delta">${m.delta}</div>
+    </div>`).join("")}
+  </div>`;
+  const findingsHtml = s.findings.length > 0 ? `<div class="findings">${s.findings.map((f) => `
+        <div class="finding tone-${f.tone}">
+          <strong>${escapeHtml(f.title)}</strong>
+          <span>${escapeHtml(f.detail)}</span>
+        </div>`).join("")}</div>` : "";
+  return section(
+    { id: "executive-summary", eyebrow: "Section 1", title: "Executive Summary" },
+    metricsHtml + findingsHtml
+  );
+}
+function renderProviderBars(rates) {
+  if (rates.length === 0) return "";
+  const max = Math.max(...rates.map((r) => r.citationRate), 100);
+  const width = 600;
+  const height = Math.max(rates.length * 32 + 24, 80);
+  const labelWidth = 80;
+  const padding = 8;
+  const barWidth = width - labelWidth - padding * 2;
+  const bars = rates.map((r, i) => {
+    const y = i * 32 + padding;
+    const barHeight = 22;
+    const w = max > 0 ? r.citationRate / max * barWidth : 0;
+    const color = COLORS.series[i % COLORS.series.length];
+    return `
+      <text x="${labelWidth - 8}" y="${y + 16}" fill="${COLORS.textMuted}" font-size="11" text-anchor="end">${escapeHtml(r.provider)}</text>
+      <rect x="${labelWidth}" y="${y}" width="${barWidth}" height="${barHeight}" fill="${COLORS.border}" opacity="0.4" rx="3" />
+      <rect x="${labelWidth}" y="${y}" width="${w}" height="${barHeight}" fill="${color}" rx="3" />
+      <text x="${labelWidth + w + 6}" y="${y + 16}" fill="${COLORS.text}" font-size="11">${r.citationRate}% (${r.citedCount}/${r.totalCount})</text>`;
+  }).join("");
+  return `<div class="chart-card">
+    <h3>Provider citation rate</h3>
+    <svg viewBox="0 0 ${width} ${height}" width="100%" preserveAspectRatio="xMinYMin meet" role="img" aria-label="Provider citation rate bar chart">
+      ${bars}
+    </svg>
+  </div>`;
+}
+function renderCitationMatrix(scorecard) {
+  if (scorecard.keywords.length === 0 || scorecard.providers.length === 0) {
+    return renderEmpty("Run a visibility sweep to populate the citation matrix.");
+  }
+  const headers = scorecard.providers.map((p) => `<th>${escapeHtml(p)}</th>`).join("");
+  const rows = scorecard.keywords.map((kw, ki) => {
+    const cells = scorecard.providers.map((_, pi) => {
+      const cell = scorecard.matrix[ki]?.[pi];
+      if (!cell) {
+        return '<td><span class="cell-pending">\u2014</span></td>';
+      }
+      if (cell.citationState === "cited") {
+        return '<td><span class="cell-cited">Cited</span></td>';
+      }
+      return '<td><span class="cell-not-cited">Not cited</span></td>';
+    }).join("");
+    return `<tr><td>${escapeHtml(kw)}</td>${cells}</tr>`;
+  }).join("");
+  return `<table class="report-table">
+    <thead><tr><th>Keyword</th>${headers}</tr></thead>
+    <tbody>${rows}</tbody>
+  </table>`;
+}
+function renderCitationScorecard(report) {
+  const body = `
+    ${renderProviderBars(report.citationScorecard.providerRates)}
+    ${renderCitationMatrix(report.citationScorecard)}
+  `;
+  return section(
+    { id: "citation-scorecard", eyebrow: "Section 2", title: "Citation Scorecard", intro: "Per-keyword \xD7 per-provider citation matrix from the latest visibility sweep." },
+    body
+  );
+}
+function renderCompetitorBars(landscape, canonical) {
+  const data = [
+    { label: canonical, count: landscape.projectCitationCount, isProject: true },
+    ...landscape.competitors.map((c) => ({ label: c.domain, count: c.citationCount, isProject: false }))
+  ];
+  if (data.length <= 1) return "";
+  const max = Math.max(...data.map((d) => d.count), 1);
+  const width = 600;
+  const height = data.length * 28 + 16;
+  const labelWidth = 160;
+  const bars = data.map((d, i) => {
+    const y = i * 28 + 8;
+    const barHeight = 18;
+    const w = d.count / max * (width - labelWidth - 60);
+    const color = d.isProject ? COLORS.accent : COLORS.series[(i + 1) % COLORS.series.length];
+    return `
+      <text x="${labelWidth - 8}" y="${y + 13}" fill="${COLORS.textMuted}" font-size="11" text-anchor="end">${escapeHtml(d.label)}</text>
+      <rect x="${labelWidth}" y="${y}" width="${w}" height="${barHeight}" fill="${color}" rx="3" />
+      <text x="${labelWidth + w + 6}" y="${y + 13}" fill="${COLORS.text}" font-size="11">${d.count}</text>`;
+  }).join("");
+  return `<div class="chart-card">
+    <h3>Citations per domain</h3>
+    <svg viewBox="0 0 ${width} ${height}" width="100%" preserveAspectRatio="xMinYMin meet" role="img" aria-label="Citations per domain bar chart">
+      ${bars}
+    </svg>
+  </div>`;
+}
+function renderCompetitorLandscape(report) {
+  const competitors2 = report.competitorLandscape.competitors;
+  if (competitors2.length === 0 && report.competitorLandscape.projectCitationCount === 0) {
+    return section(
+      { id: "competitor-landscape", eyebrow: "Section 3", title: "Competitor Landscape" },
+      renderEmpty("No competitor data yet. Add competitors and run a visibility sweep.")
+    );
+  }
+  const rows = competitors2.map((c) => {
+    const tone = pressureTone(c.pressureLabel);
+    const pagesDisclosure = c.theirCitedPages.length > 0 ? `<details class="cited-pages"><summary>${c.theirCitedPages.length} cited URL${c.theirCitedPages.length > 1 ? "s" : ""}</summary>
+          <ul>${c.theirCitedPages.map((p) => `<li><a href="${escapeHtml(p.url)}">${escapeHtml(p.url)}</a> <span class="cited-for">${escapeHtml(p.citedFor.join(", "))}</span></li>`).join("")}</ul>
+        </details>` : "";
+    return `<tr>
+      <td>${escapeHtml(c.domain)}</td>
+      <td><span class="badge tone-${tone}">${escapeHtml(c.pressureLabel)}</span></td>
+      <td class="numeric">${c.citationCount} / ${c.totalCount}</td>
+      <td class="numeric">${c.sharePct}%</td>
+      <td>${escapeHtml(c.citedKeywords.slice(0, 5).join(", "))}${c.citedKeywords.length > 5 ? "\u2026" : ""}${pagesDisclosure}</td>
+    </tr>`;
+  }).join("");
+  const table = competitors2.length > 0 ? `<table class="report-table">
+        <thead><tr><th>Domain</th><th>Pressure</th><th>Citations</th><th class="numeric">SOV</th><th>Cited keywords</th></tr></thead>
+        <tbody>${rows}</tbody>
+      </table>` : renderEmpty("No competitors configured.");
+  return section(
+    { id: "competitor-landscape", eyebrow: "Section 3", title: "Competitor Landscape", intro: "Where tracked competitors appear in AI answers compared to your domain." },
+    `${renderCompetitorBars(report.competitorLandscape, report.meta.project.canonicalDomain)}${table}`
+  );
+}
+function renderDonut(buckets) {
+  if (buckets.length === 0) return "";
+  const total = buckets.reduce((s, b) => s + b.count, 0);
+  if (total === 0) return "";
+  const cx = 110;
+  const cy = 110;
+  const r = 80;
+  const innerR = 48;
+  let cumulative = 0;
+  const slices = [];
+  const legend = [];
+  buckets.forEach((b, i) => {
+    const startAngle = cumulative / total * Math.PI * 2 - Math.PI / 2;
+    const endAngle = (cumulative + b.count) / total * Math.PI * 2 - Math.PI / 2;
+    cumulative += b.count;
+    const x1 = cx + Math.cos(startAngle) * r;
+    const y1 = cy + Math.sin(startAngle) * r;
+    const x2 = cx + Math.cos(endAngle) * r;
+    const y2 = cy + Math.sin(endAngle) * r;
+    const ix1 = cx + Math.cos(endAngle) * innerR;
+    const iy1 = cy + Math.sin(endAngle) * innerR;
+    const ix2 = cx + Math.cos(startAngle) * innerR;
+    const iy2 = cy + Math.sin(startAngle) * innerR;
+    const largeArc = endAngle - startAngle > Math.PI ? 1 : 0;
+    const color = COLORS.series[i % COLORS.series.length];
+    if (b.count > 0) {
+      slices.push(`<path d="M ${x1} ${y1} A ${r} ${r} 0 ${largeArc} 1 ${x2} ${y2} L ${ix1} ${iy1} A ${innerR} ${innerR} 0 ${largeArc} 0 ${ix2} ${iy2} Z" fill="${color}" />`);
+      legend.push(`<span><span class="legend-swatch" style="background:${color}"></span>${escapeHtml(b.label)} (${b.count})</span>`);
+    }
+  });
+  return `<div class="chart-card">
+    <h3>AI source categories</h3>
+    <div style="display:flex;align-items:center;gap:24px;flex-wrap:wrap;">
+      <svg viewBox="0 0 220 220" width="220" height="220" role="img" aria-label="AI source category donut chart">
+        ${slices.join("")}
+      </svg>
+      <div class="legend" style="flex-direction:column;align-items:flex-start;gap:6px;">${legend.join("")}</div>
+    </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 Source Origin" },
+      renderEmpty("No source data yet. Run a visibility sweep first.")
+    );
+  }
+  const rows = origin.topDomains.map((d) => `
+    <tr>
+      <td>${escapeHtml(d.domain)}</td>
+      <td class="numeric">${d.count}</td>
+      <td>${d.isCompetitor ? '<span class="badge tone-negative">Competitor</span>' : '<span class="badge tone-neutral">External</span>'}</td>
+    </tr>`).join("");
+  const table = origin.topDomains.length > 0 ? `<table class="report-table">
+        <thead><tr><th>Domain</th><th>Citations</th><th>Tag</th></tr></thead>
+        <tbody>${rows}</tbody>
+      </table>` : "";
+  return section(
+    { id: "ai-source-origin", eyebrow: "Section 4", title: "AI Source Origin", intro: "Where AI answers pull from, aggregated across the latest sweep." },
+    `${renderDonut(origin.categories)}${table}`
+  );
+}
+function renderLineChart(points, color, title, height = 200) {
+  if (points.length === 0) return "";
+  const width = 600;
+  const padX = 32;
+  const padY = 24;
+  const usableW = width - padX * 2;
+  const usableH = height - padY * 2;
+  const max = Math.max(...points.map((p) => p.y), 1);
+  const stepX = points.length > 1 ? usableW / (points.length - 1) : 0;
+  const xy = points.map((p, i) => ({
+    x: padX + i * stepX,
+    y: padY + usableH - p.y / max * usableH,
+    raw: p
+  }));
+  const path15 = xy.map((p, i) => `${i === 0 ? "M" : "L"} ${p.x.toFixed(1)} ${p.y.toFixed(1)}`).join(" ");
+  const dots = xy.map((p) => `<circle cx="${p.x.toFixed(1)}" cy="${p.y.toFixed(1)}" r="3" fill="${color}" />`).join("");
+  const xLabels = xy.map((p, i) => {
+    if (points.length > 8 && i % Math.ceil(points.length / 6) !== 0 && i !== points.length - 1) return "";
+    return `<text x="${p.x.toFixed(1)}" y="${(height - 4).toFixed(1)}" fill="${COLORS.textFaint}" font-size="9" text-anchor="middle">${escapeHtml(p.raw.label ?? p.raw.x)}</text>`;
+  }).join("");
+  return `<div class="chart-card">
+    <h3>${escapeHtml(title)}</h3>
+    <svg viewBox="0 0 ${width} ${height}" width="100%" preserveAspectRatio="xMinYMin meet" role="img" aria-label="${escapeHtml(title)} line chart">
+      <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(max)}</text>
+      <text x="${padX - 6}" y="${(padY + usableH).toFixed(1)}" fill="${COLORS.textFaint}" font-size="9" text-anchor="end">0</text>
+      <path d="${path15}" stroke="${color}" stroke-width="2" fill="none" />
+      ${dots}
+      ${xLabels}
+    </svg>
+  </div>`;
+}
+function renderGsc(report) {
+  const gsc = report.gsc;
+  if (!gsc) {
+    return section(
+      { id: "gsc", eyebrow: "Section 5", title: "GSC Performance" },
+      renderEmpty("Connect Google Search Console to populate this section.")
+    );
+  }
+  const rows = gsc.topQueries.map((q) => `
+    <tr>
+      <td>${escapeHtml(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">${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 trendChart = renderLineChart(
+    gsc.trend.map((t) => ({ x: t.date, y: t.clicks, label: t.date.slice(5) })),
+    COLORS.accent,
+    "Clicks over time"
+  );
+  const crossoverBlocks = [];
+  if (gsc.trackedButNoGsc.length > 0) {
+    crossoverBlocks.push(`<div class="chart-card"><h3>AEO keywords without search demand</h3>
+      <p class="section-intro">Tracked AEO keywords with no GSC impressions in this window \u2014 review whether they represent real search demand.</p>
+      <ul>${gsc.trackedButNoGsc.map((k) => `<li>${escapeHtml(k)}</li>`).join("")}</ul>
+    </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 keywords.</p>
+      <ul>${gsc.gscButNotTracked.map((q) => `<li>${escapeHtml(q)}</li>`).join("")}</ul>
+    </div>`);
+  }
+  return section(
+    { id: "gsc", eyebrow: "Section 5", title: "GSC Performance", intro: "Top queries, category breakdown, and traffic trend from Google Search Console." },
+    `<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>
+      <div class="metric"><div class="label">Avg CTR</div><div class="value">${formatRatio(gsc.ctr)}</div></div>
+      <div class="metric"><div class="label">Avg position</div><div class="value">${gsc.avgPosition.toFixed(1)}</div></div>
+    </div>
+    ${trendChart}
+    <div class="chart-card"><h3>Top queries</h3>
+      <table class="report-table">
+        <thead><tr><th>Query</th><th class="numeric">Clicks</th><th class="numeric">Imp.</th><th class="numeric">CTR</th><th class="numeric">Pos.</th><th>Category</th></tr></thead>
+        <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>
+    ${crossoverBlocks.join("\n")}`
+  );
+}
+function renderGa(report) {
+  const ga = report.ga;
+  if (!ga) {
+    return section(
+      { id: "ga", eyebrow: "Section 6", title: "GA4 Traffic" },
+      renderEmpty("Connect Google Analytics 4 to populate this section.")
+    );
+  }
+  const pageRows = ga.topLandingPages.map((p) => `
+    <tr>
+      <td class="page-cell">${formatLandingPageHtml(p.page)}</td>
+      <td class="numeric">${formatNumber(p.sessions)}</td>
+      <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("");
+  return section(
+    { id: "ga", eyebrow: "Section 6", title: "GA4 Traffic", intro: `Sessions and users for ${formatDate(ga.periodStart)} \u2192 ${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>
+      <div class="metric"><div class="label">Organic sessions</div><div class="value">${formatNumber(ga.totalOrganicSessions)}</div></div>
+    </div>
+    <div class="chart-card"><h3>Top landing pages</h3>
+      <table class="report-table">
+        <thead><tr><th>Page</th><th class="numeric">Sessions</th><th class="numeric">Users</th><th class="numeric">Organic</th></tr></thead>
+        <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>`
+  );
+}
+function renderSocial(report) {
+  const social = report.socialReferrals;
+  if (!social) {
+    return section(
+      { id: "social-referrals", eyebrow: "Section 7", 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 campaignRows = social.topCampaigns.map((c) => `
+    <tr>
+      <td>${escapeHtml(c.source)}</td>
+      <td>${escapeHtml(c.medium)}</td>
+      <td class="numeric">${formatNumber(c.sessions)}</td>
+    </tr>`).join("");
+  return section(
+    { id: "social-referrals", eyebrow: "Section 7", title: "Social Referrals", intro: "Paid vs organic split with top campaigns." },
+    `<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>
+    <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>
+        <tbody>${campaignRows}</tbody>
+      </table>
+    </div>`
+  );
+}
+function renderAiReferrals(report) {
+  const ai = report.aiReferrals;
+  if (!ai) {
+    return section(
+      { id: "ai-referrals", eyebrow: "Section 8", 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 pageRows = ai.topLandingPages.map((p) => `
+    <tr>
+      <td class="page-cell">${formatLandingPageHtml(p.page)}</td>
+      <td class="numeric">${formatNumber(p.sessions)}</td>
+      <td class="numeric">${formatNumber(p.users)}</td>
+    </tr>`).join("");
+  const trendChart = renderLineChart(
+    ai.trend.map((t) => ({ x: t.date, y: t.sessions, label: t.date.slice(5) })),
+    COLORS.series[2],
+    "AI referral sessions over time"
+  );
+  return section(
+    { id: "ai-referrals", eyebrow: "Section 8", title: "AI Referral Traffic", intro: "Sessions sent 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>
+    <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>
+        <tbody>${pageRows}</tbody>
+      </table>
+    </div>`
+  );
+}
+function renderIndexingHealth(report) {
+  const ih = report.indexingHealth;
+  if (!ih) {
+    return section(
+      { id: "indexing-health", eyebrow: "Section 9", title: "Indexing Health" },
+      renderEmpty("Connect Google Search Console or Bing Webmaster Tools and run a sitemap inspection.")
+    );
+  }
+  const segments = [
+    { label: "Indexed", count: ih.indexed, color: COLORS.positive },
+    { label: "Not indexed", count: ih.notIndexed, color: COLORS.caution },
+    { label: "Deindexed", count: ih.deindexed, color: COLORS.negative },
+    { label: "Unknown", count: ih.unknown, color: COLORS.neutral }
+  ].filter((s) => s.count > 0);
+  const total = segments.reduce((s, x) => s + x.count, 0) || 1;
+  const width = 600;
+  const height = 28;
+  let acc = 0;
+  const bars = segments.map((s) => {
+    const w = s.count / total * width;
+    const x = acc;
+    acc += w;
+    return `<rect x="${x}" y="0" width="${w}" height="${height}" fill="${s.color}" />`;
+  }).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: `Source: ${ih.provider === "google" ? "Google Search Console" : "Bing Webmaster Tools"}.` },
+    `<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>
+      <div class="metric"><div class="label">Indexed share</div><div class="value">${ih.indexedPct}%</div></div>
+    </div>
+    <div class="chart-card">
+      <h3>Coverage breakdown</h3>
+      <svg viewBox="0 0 ${width} ${height}" width="100%" preserveAspectRatio="xMinYMin meet" role="img" aria-label="Coverage stacked bar">${bars}</svg>
+      <div class="legend">${legend}</div>
+    </div>`
+  );
+}
+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.")
+    );
+  }
+  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.`)
+    );
+  }
+  const chart = renderLineChart(
+    trend.map((t) => ({ x: t.date, y: t.citationRate, label: formatDate(t.date) })),
+    COLORS.positive,
+    "Overall citation rate",
+    220
+  );
+  const rows = trend.map((t) => `
+    <tr>
+      <td>${formatDate(t.date)}</td>
+      <td class="numeric">${t.citationRate}%</td>
+      <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: "Per-run citation rate across the project history." },
+    `${chart}
+    <div class="chart-card"><h3>Run-by-run breakdown</h3>
+      <table class="report-table">
+        <thead><tr><th>Run</th><th class="numeric">Overall rate</th><th>Per-provider rates</th></tr></thead>
+        <tbody>${rows}</tbody>
+      </table>
+    </div>`
+  );
+}
+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.")
+    );
+  }
+  const haveDeduped = list.every((i) => typeof i.instanceCount === "number");
+  const rows = (haveDeduped ? list.map((i) => ({ rep: i, count: i.instanceCount })) : groupInsights(list).map((g) => ({ rep: g.representative, count: g.count }))).map(({ rep: i, count }) => {
+    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.keyword)}</td>
+        <td>${escapeHtml(i.provider)}</td>
+        <td>${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: "Priority-ordered findings from the most recent runs." },
+    `<table class="report-table">
+      <thead><tr><th>Severity</th><th>Title</th><th>Keyword</th><th>Provider</th><th>Recommendation</th></tr></thead>
+      <tbody>${rows}</tbody>
+    </table>`
+  );
+}
+function renderOpportunities(report) {
+  const opps = report.contentOpportunities;
+  if (opps.length === 0) return "";
+  const rows = opps.slice(0, 10).map((o) => {
+    const ourPage = o.ourBestPage ? `<a href="${escapeHtml(o.ourBestPage.url)}">${escapeHtml(o.ourBestPage.url)}</a>` : '<span class="cell-not-cited">\u2014</span>';
+    const winning = o.winningCompetitor ? `<a href="${escapeHtml(o.winningCompetitor.url)}">${escapeHtml(o.winningCompetitor.domain)}</a>` : '<span class="cell-not-cited">\u2014</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>${ourPage}</td>
+      <td>${winning}</td>
+      <td><span class="badge tone-neutral">${escapeHtml(o.demandSource)}</span></td>
+      <td><span class="badge tone-neutral">${escapeHtml(o.actionConfidence)}</span></td>
+    </tr>`;
+  }).join("");
+  return section(
+    {
+      id: "content-opportunities",
+      eyebrow: "Section 12",
+      title: "Content Opportunities",
+      intro: "Ranked, action-typed targets from the content recommendation engine. Top 10 shown."
+    },
+    `<table class="report-table">
+      <thead><tr><th>Query</th><th>Action</th><th class="numeric">Score</th><th>Our page</th><th>Winning competitor</th><th>Demand</th><th>Confidence</th></tr></thead>
+      <tbody>${rows}</tbody>
+    </table>`
+  );
+}
+function renderRecommendedNextSteps(report) {
+  const steps = report.recommendedNextSteps;
+  if (steps.length === 0) {
+    return section(
+      { id: "recommended-next-steps", eyebrow: "Section 13", title: "Recommended Next Steps" },
+      renderEmpty("No outstanding actions.")
+    );
+  }
+  const items = steps.map((s) => `
+    <div class="step">
+      <span class="horizon">${escapeHtml(s.horizon)}</span>
+      <span class="title">${escapeHtml(s.title)}</span>
+      <span class="rationale">${escapeHtml(s.rationale)}</span>
+    </div>`).join("");
+  return section(
+    { id: "recommended-next-steps", eyebrow: "Section 13", title: "Recommended Next Steps" },
+    `<div class="steps">${items}</div>`
+  );
+}
+function escapeJsonForScript(json) {
+  return json.replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function renderReportHtml(report, opts = {}) {
+  const title = opts.title ?? `Canonry report \u2014 ${report.meta.project.displayName}`;
+  const sections = [
+    renderExecutiveSummary(report),
+    renderCitationScorecard(report),
+    renderCompetitorLandscape(report),
+    renderAiSourceOrigin(report),
+    renderGsc(report),
+    renderGa(report),
+    renderSocial(report),
+    renderAiReferrals(report),
+    renderIndexingHealth(report),
+    renderCitationsTrend(report),
+    renderInsights(report),
+    renderOpportunities(report),
+    renderRecommendedNextSteps(report)
+  ].join("\n");
+  const json = escapeJsonForScript(JSON.stringify(report));
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>${escapeHtml(title)}</title>
+<style>${STYLE}</style>
+</head>
+<body>
+<div class="container">
+  <header class="header">
+    <div class="eyebrow">AEO Report</div>
+    <h1>${escapeHtml(report.meta.project.displayName)}</h1>
+    <div class="subtitle">${escapeHtml(report.meta.project.canonicalDomain)} \xB7 ${escapeHtml(report.meta.project.country)} / ${escapeHtml(report.meta.project.language.toUpperCase())} \xB7 Generated ${formatDate(report.meta.generatedAt)}</div>
+  </header>
+  ${sections}
+  <footer class="footer">Generated by canonry \xB7 ${escapeHtml(report.meta.generatedAt)}</footer>
+</div>
+<script type="application/json" id="canonry-report-data">${json}</script>
+</body>
+</html>`;
+}
+
 // ../api-routes/src/content-data.ts
 import { and as and3, eq as eq12, desc as desc5, inArray as inArray3 } from "drizzle-orm";
 var RECENT_RUNS_WINDOW = 5;
@@ -3248,134 +4241,149 @@ function buildExecutiveFindings(citationRate, trend, trendsPoints, trendBaseline
   }
   return findings.slice(0, 5);
 }
-async function reportRoutes(app) {
-  app.get("/projects/:name/report", async (request, reply) => {
-    const project = resolveProject(app.db, request.params.name);
-    const keywordLookup = loadKeywordLookup(app.db, project.id);
-    const allRuns = app.db.select().from(runs).where(eq13(runs.projectId, project.id)).orderBy(desc6(runs.createdAt)).all();
-    const visibilityRuns = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]);
-    const latestRun = visibilityRuns.find(
-      (r) => r.status === RunStatuses.completed || r.status === RunStatuses.partial
-    ) ?? visibilityRuns[0];
-    const latestSnapshots = latestRun ? loadSnapshotsForRun(app.db, latestRun.id) : [];
-    const competitorRows = app.db.select().from(competitors).where(eq13(competitors.projectId, project.id)).all();
-    const competitorDomains = competitorRows.map((c) => c.domain);
-    const ownedDomains = parseJsonColumn(project.ownedDomains, []);
-    const projectDomains = [project.canonicalDomain, ...ownedDomains];
-    const citationScorecard = buildCitationScorecard(latestSnapshots, keywordLookup);
-    const competitorLandscape = buildCompetitorLandscape(
-      latestSnapshots,
-      competitorDomains,
-      projectDomains,
-      keywordLookup
-    );
-    const aiSourceOrigin = buildAiSourceOrigin(latestSnapshots, projectDomains, competitorDomains);
-    const trackedKeywords = [...keywordLookup.byId.values()];
-    const gscSection = buildGscSection(
-      app.db,
-      project.id,
-      project.displayName,
-      project.canonicalDomain,
-      trackedKeywords
-    );
-    const gaSection = buildGaSection(app.db, project.id);
-    const socialSection = buildSocialReferrals(app.db, project.id);
-    const aiReferralsSection = buildAiReferrals(app.db, project.id);
-    const indexingHealthSection = buildIndexingHealth(app.db, project.id);
-    const citationsTrend = buildCitationsTrend(app.db, project.id, keywordLookup);
-    const insightList = buildInsightList(app.db, project.id);
-    const orchestratorInput = loadOrchestratorInput(app.db, project);
-    const contentOpportunities = buildContentTargetRows(orchestratorInput);
-    const contentGaps = buildContentGapRows(orchestratorInput);
-    const groundingSources = buildContentSourceRows(orchestratorInput);
-    const insightDerivedSteps = buildRecommendedNextSteps(insightList);
-    const recommendedNextSteps = mapOpportunitiesToNextSteps(
-      contentOpportunities,
-      insightDerivedSteps
-    );
-    let latestCited = 0;
-    let latestConsidered = 0;
-    for (const snap of latestSnapshots) {
-      if (!keywordLookup.byId.has(snap.keywordId)) continue;
-      latestConsidered++;
-      if (snap.citationState === "cited") latestCited++;
-    }
-    const citationRate = latestConsidered > 0 ? Math.round(latestCited / latestConsidered * 100) : 0;
-    const trendBaseline = isTrendBaseline(citationsTrend);
-    const latestPoint = citationsTrend.at(-1);
-    const previousPoint = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
-    let trend = "unknown";
-    if (!trendBaseline && latestPoint) {
-      const latestRunOnTrend = latestRun?.id === latestPoint.runId;
-      const currentRate = latestRunOnTrend ? latestPoint.citationRate : citationRate;
-      const priorRate = latestRunOnTrend ? previousPoint?.citationRate : latestPoint.citationRate;
-      if (priorRate !== void 0) {
-        if (currentRate > priorRate) trend = "up";
-        else if (currentRate < priorRate) trend = "down";
-        else trend = "flat";
-      }
-    }
-    const findings = buildExecutiveFindings(
+function buildProjectReport(db, projectName) {
+  const project = resolveProject(db, projectName);
+  const keywordLookup = loadKeywordLookup(db, project.id);
+  const allRuns = db.select().from(runs).where(eq13(runs.projectId, project.id)).orderBy(desc6(runs.createdAt)).all();
+  const visibilityRuns = allRuns.filter((r) => r.kind === RunKinds["answer-visibility"]);
+  const latestRun = visibilityRuns.find(
+    (r) => r.status === RunStatuses.completed || r.status === RunStatuses.partial
+  ) ?? visibilityRuns[0];
+  const latestSnapshots = latestRun ? loadSnapshotsForRun(db, latestRun.id) : [];
+  const competitorRows = db.select().from(competitors).where(eq13(competitors.projectId, project.id)).all();
+  const competitorDomains = competitorRows.map((c) => c.domain);
+  const ownedDomains = parseJsonColumn(project.ownedDomains, []);
+  const projectDomains = [project.canonicalDomain, ...ownedDomains];
+  const citationScorecard = buildCitationScorecard(latestSnapshots, keywordLookup);
+  const competitorLandscape = buildCompetitorLandscape(
+    latestSnapshots,
+    competitorDomains,
+    projectDomains,
+    keywordLookup
+  );
+  const aiSourceOrigin = buildAiSourceOrigin(latestSnapshots, projectDomains, competitorDomains);
+  const trackedKeywords = [...keywordLookup.byId.values()];
+  const gscSection = buildGscSection(
+    db,
+    project.id,
+    project.displayName,
+    project.canonicalDomain,
+    trackedKeywords
+  );
+  const gaSection = buildGaSection(db, project.id);
+  const socialSection = buildSocialReferrals(db, project.id);
+  const aiReferralsSection = buildAiReferrals(db, project.id);
+  const indexingHealthSection = buildIndexingHealth(db, project.id);
+  const citationsTrend = buildCitationsTrend(db, project.id, keywordLookup);
+  const insightList = buildInsightList(db, project.id);
+  const orchestratorInput = loadOrchestratorInput(db, project);
+  const contentOpportunities = buildContentTargetRows(orchestratorInput);
+  const contentGaps = buildContentGapRows(orchestratorInput);
+  const groundingSources = buildContentSourceRows(orchestratorInput);
+  const insightDerivedSteps = buildRecommendedNextSteps(insightList);
+  const recommendedNextSteps = mapOpportunitiesToNextSteps(
+    contentOpportunities,
+    insightDerivedSteps
+  );
+  let latestCited = 0;
+  let latestConsidered = 0;
+  for (const snap of latestSnapshots) {
+    if (!keywordLookup.byId.has(snap.keywordId)) continue;
+    latestConsidered++;
+    if (snap.citationState === "cited") latestCited++;
+  }
+  const citationRate = latestConsidered > 0 ? Math.round(latestCited / latestConsidered * 100) : 0;
+  const trendBaseline = isTrendBaseline(citationsTrend);
+  const latestPoint = citationsTrend.at(-1);
+  const previousPoint = citationsTrend.length >= 2 ? citationsTrend.at(-2) : null;
+  let trend = "unknown";
+  if (!trendBaseline && latestPoint) {
+    const latestRunOnTrend = latestRun?.id === latestPoint.runId;
+    const currentRate = latestRunOnTrend ? latestPoint.citationRate : citationRate;
+    const priorRate = latestRunOnTrend ? previousPoint?.citationRate : latestPoint.citationRate;
+    if (priorRate !== void 0) {
+      if (currentRate > priorRate) trend = "up";
+      else if (currentRate < priorRate) trend = "down";
+      else trend = "flat";
+    }
+  }
+  const findings = buildExecutiveFindings(
+    citationRate,
+    trend,
+    citationsTrend,
+    trendBaseline,
+    insightList,
+    competitorLandscape.competitors
+  );
+  const periodStart = citationsTrend[0]?.date ?? null;
+  const periodEnd = citationsTrend.at(-1)?.date ?? null;
+  return {
+    meta: {
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      project: {
+        id: project.id,
+        name: project.name,
+        displayName: project.displayName,
+        canonicalDomain: project.canonicalDomain,
+        country: project.country,
+        language: project.language
+      },
+      periodStart,
+      periodEnd
+    },
+    executiveSummary: {
       citationRate,
       trend,
-      citationsTrend,
-      trendBaseline,
-      insightList,
-      competitorLandscape.competitors
-    );
-    const periodStart = citationsTrend[0]?.date ?? null;
-    const periodEnd = citationsTrend.at(-1)?.date ?? null;
-    const dto = {
-      meta: {
-        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        project: {
-          id: project.id,
-          name: project.name,
-          displayName: project.displayName,
-          canonicalDomain: project.canonicalDomain,
-          country: project.country,
-          language: project.language
-        },
-        periodStart,
-        periodEnd
-      },
-      executiveSummary: {
-        citationRate,
-        trend,
-        keywordCount: keywordLookup.byId.size,
-        competitorCount: competitorDomains.length,
-        providerCount: citationScorecard.providers.length,
-        gsc: gscSection ? {
-          clicks: gscSection.totalClicks,
-          impressions: gscSection.totalImpressions,
-          ctr: gscSection.ctr,
-          avgPosition: gscSection.avgPosition
-        } : null,
-        ga: gaSection ? {
-          sessions: gaSection.totalSessions,
-          users: gaSection.totalUsers,
-          periodStart: gaSection.periodStart,
-          periodEnd: gaSection.periodEnd
-        } : null,
-        findings
-      },
-      citationScorecard,
-      competitorLandscape,
-      aiSourceOrigin,
-      gsc: gscSection,
-      ga: gaSection,
-      socialReferrals: socialSection,
-      aiReferrals: aiReferralsSection,
-      indexingHealth: indexingHealthSection,
-      citationsTrend,
-      insights: insightList,
-      recommendedNextSteps,
-      contentOpportunities,
-      contentGaps,
-      groundingSources
-    };
+      keywordCount: keywordLookup.byId.size,
+      competitorCount: competitorDomains.length,
+      providerCount: citationScorecard.providers.length,
+      gsc: gscSection ? {
+        clicks: gscSection.totalClicks,
+        impressions: gscSection.totalImpressions,
+        ctr: gscSection.ctr,
+        avgPosition: gscSection.avgPosition
+      } : null,
+      ga: gaSection ? {
+        sessions: gaSection.totalSessions,
+        users: gaSection.totalUsers,
+        periodStart: gaSection.periodStart,
+        periodEnd: gaSection.periodEnd
+      } : null,
+      findings
+    },
+    citationScorecard,
+    competitorLandscape,
+    aiSourceOrigin,
+    gsc: gscSection,
+    ga: gaSection,
+    socialReferrals: socialSection,
+    aiReferrals: aiReferralsSection,
+    indexingHealth: indexingHealthSection,
+    citationsTrend,
+    insights: insightList,
+    recommendedNextSteps,
+    contentOpportunities,
+    contentGaps,
+    groundingSources
+  };
+}
+function reportFilenameFor(project, generatedAt) {
+  const date = generatedAt.slice(0, 10);
+  return `canonry-report-${project.name}-${date}.html`;
+}
+async function reportRoutes(app) {
+  app.get("/projects/:name/report", async (request, reply) => {
+    const dto = buildProjectReport(app.db, request.params.name);
     return reply.send(dto);
   });
+  app.get("/projects/:name/report.html", async (request, reply) => {
+    const dto = buildProjectReport(app.db, request.params.name);
+    const html = renderReportHtml(dto);
+    const filename = reportFilenameFor(dto.meta.project, dto.meta.generatedAt);
+    reply.header("Content-Type", "text/html; charset=utf-8");
+    reply.header("Content-Disposition", `attachment; filename="${filename}"`);
+    return reply.send(html);
+  });
 }
 
 // ../api-routes/src/citations.ts
@@ -6130,6 +7138,18 @@ var routeCatalog = [
       404: { description: "Project not found." }
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/report.html",
+    summary: "Standalone HTML AEO report",
+    tags: ["report"],
+    description: "Server-rendered self-contained HTML version of the project report. Same data as `/projects/{name}/report` (JSON), rendered through the canonry HTML report renderer. Returns `text/html` with `Content-Disposition: attachment` so browsers download it as `canonry-report-<project>-YYYY-MM-DD.html`. Open in a browser and Print \u2192 Save as PDF for a PDF copy.",
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "HTML report returned." },
+      404: { description: "Project not found." }
+    }
+  },
   {
     method: "get",
     path: "/api/v1/projects/{name}/health/latest",
@@ -7613,7 +8633,7 @@ async function batchRunReports(accessToken, propertyId, requests) {
   const data = await res.json();
   return data.reports;
 }
-function formatDate(d) {
+function formatDate2(d) {
   return d.toISOString().split("T")[0];
 }
 var AI_REFERRAL_SOURCE_FILTERS = [
@@ -7643,7 +8663,7 @@ async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
   while (pageCount < GA4_MAX_PAGES) {
     pageCount++;
     const request = {
-      dateRanges: [{ startDate: formatDate(startDate), endDate: formatDate(endDate) }],
+      dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
       dimensions: [
         { name: "date" },
         { name: "landingPagePlusQueryString" }
@@ -7678,7 +8698,7 @@ async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
   while (organicPageCount < GA4_MAX_PAGES) {
     organicPageCount++;
     const organicRequest = {
-      dateRanges: [{ startDate: formatDate(startDate), endDate: formatDate(endDate) }],
+      dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
       dimensions: [{ name: "date" }, { name: "landingPagePlusQueryString" }],
       metrics: [{ name: "sessions" }],
       dimensionFilter: {
@@ -7706,7 +8726,7 @@ async function fetchTrafficByLandingPage(accessToken, propertyId, days) {
   while (directPageCount < GA4_MAX_PAGES) {
     directPageCount++;
     const directRequest = {
-      dateRanges: [{ startDate: formatDate(startDate), endDate: formatDate(endDate) }],
+      dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
       dimensions: [{ name: "date" }, { name: "landingPagePlusQueryString" }],
       metrics: [{ name: "sessions" }],
       dimensionFilter: {
@@ -7755,7 +8775,7 @@ async function verifyConnectionWithToken(accessToken, propertyId) {
   const startDate = /* @__PURE__ */ new Date();
   startDate.setDate(startDate.getDate() - 1);
   await runReport(accessToken, propertyId, {
-    dateRanges: [{ startDate: formatDate(startDate), endDate: formatDate(endDate) }],
+    dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
     dimensions: [{ name: "date" }],
     metrics: [{ name: "sessions" }],
     limit: 1
@@ -7770,7 +8790,7 @@ async function fetchAggregateSummary(accessToken, propertyId, days) {
   const startDate = /* @__PURE__ */ new Date();
   startDate.setDate(startDate.getDate() - syncDays);
   ga4Log("info", "fetch-aggregate.start", { propertyId, days: syncDays });
-  const dateRange = { startDate: formatDate(startDate), endDate: formatDate(endDate) };
+  const dateRange = { startDate: formatDate2(startDate), endDate: formatDate2(endDate) };
   const batchRes = await batchRunReports(accessToken, propertyId, [
     {
       dateRanges: [dateRange],
@@ -7794,8 +8814,8 @@ async function fetchAggregateSummary(accessToken, propertyId, days) {
   const totalRow = batchRes[0]?.rows?.[0];
   const organicRow = batchRes[1]?.rows?.[0];
   const summary = {
-    periodStart: formatDate(startDate),
-    periodEnd: formatDate(endDate),
+    periodStart: formatDate2(startDate),
+    periodEnd: formatDate2(endDate),
     totalSessions: parseInt(totalRow?.metricValues[0]?.value ?? "0", 10) || 0,
     totalUsers: parseInt(totalRow?.metricValues[1]?.value ?? "0", 10) || 0,
     totalOrganicSessions: parseInt(organicRow?.metricValues[0]?.value ?? "0", 10) || 0
@@ -7824,7 +8844,7 @@ async function fetchAiReferrals(accessToken, propertyId, days) {
     while (aiRefPageCount < GA4_MAX_PAGES) {
       aiRefPageCount++;
       const request = {
-        dateRanges: [{ startDate: formatDate(startDate), endDate: formatDate(endDate) }],
+        dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
         dimensions: [
           { name: "date" },
           { name: sourceDim },
@@ -7902,7 +8922,7 @@ async function fetchSocialReferrals(accessToken, propertyId, days) {
   let offset = 0;
   while (true) {
     const request = {
-      dateRanges: [{ startDate: formatDate(startDate), endDate: formatDate(endDate) }],
+      dateRanges: [{ startDate: formatDate2(startDate), endDate: formatDate2(endDate) }],
       dimensions: [
         { name: "date" },
         { name: "sessionSource" },
@@ -8056,10 +9076,10 @@ async function googleRoutes(app, opts) {
       return reply.status(500).send("Google OAuth not configured");
     }
     const store = requireConnectionStore();
-    const escapeHtml = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
+    const escapeHtml2 = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
     const { code, state, error } = request.query;
     if (error) {
-      const safeError = escapeHtml(String(error));
+      const safeError = escapeHtml2(String(error));
       const errorHtml = error === "redirect_uri_mismatch" ? `<html><body style="font-family:system-ui;padding:40px;max-width:600px;margin:0 auto">
             <h2 style="color:#ef4444">Redirect URI mismatch</h2>
             <p>Google rejected the OAuth callback because the redirect URI is not registered.</p>
@@ -8070,7 +9090,7 @@ async function googleRoutes(app, opts) {
               <li>Under "Authorized redirect URIs", add:<br><code style="background:#1e1e1e;color:#e0e0e0;padding:4px 8px;border-radius:4px;display:inline-block;margin-top:4px">${request.query.state ? (() => {
         try {
           const s = verifySignedState(request.query.state, stateSecret);
-          return escapeHtml(String(s?.redirectUri ?? "Could not determine URI"));
+          return escapeHtml2(String(s?.redirectUri ?? "Could not determine URI"));
         } catch {
           return "Could not determine URI";
         }
@@ -8099,9 +9119,9 @@ async function googleRoutes(app, opts) {
       return reply.type("text/html").send(
         `<html><body style="font-family:system-ui;padding:40px;max-width:600px;margin:0 auto">
           <h2 style="color:#ef4444">Token exchange failed</h2>
-          <p>${escapeHtml(msg)}</p>
+          <p>${escapeHtml2(msg)}</p>
           <p><strong>Redirect URI used:</strong><br>
-            <code style="background:#1e1e1e;color:#e0e0e0;padding:4px 8px;border-radius:4px">${escapeHtml(redirectUri)}</code>
+            <code style="background:#1e1e1e;color:#e0e0e0;padding:4px 8px;border-radius:4px">${escapeHtml2(redirectUri)}</code>
           </p>
           <p>Ensure this URI is listed in your <a href="https://console.cloud.google.com/apis/credentials" target="_blank">Google Cloud Console</a> OAuth client's authorized redirect URIs.</p>
           <p style="color:#888">You can close this tab.</p>
@@ -16432,7 +17452,7 @@ function getCurrentUsageDay() {
 import crypto20 from "crypto";
 import { eq as eq24, and as and13, sql as sql8 } from "drizzle-orm";
 var log2 = createLogger("GscSync");
-function formatDate2(d) {
+function formatDate3(d) {
   return d.toISOString().split("T")[0];
 }
 function daysAgo(n) {
@@ -16472,9 +17492,9 @@ async function executeGscSync(db, runId, projectId, opts) {
       saveConfigPatch(opts.config);
     }
     const lagOffset = GSC_DATA_LAG_DAYS;
-    const endDate = formatDate2(daysAgo(lagOffset));
+    const endDate = formatDate3(daysAgo(lagOffset));
     const days = opts.full ? 480 : opts.days ?? 30;
-    const startDate = formatDate2(daysAgo(days + lagOffset));
+    const startDate = formatDate3(daysAgo(days + lagOffset));
     log2.info("fetch.start", { runId, projectId, propertyId: conn.propertyId, startDate, endDate });
     const rows = await fetchSearchAnalytics(accessToken, conn.propertyId, {
       startDate,
@@ -16570,7 +17590,7 @@ async function executeGscSync(db, runId, projectId, opts) {
         reasonCounts[reason] = (reasonCounts[reason] ?? 0) + 1;
       }
     }
-    const snapshotDate = formatDate2(/* @__PURE__ */ new Date());
+    const snapshotDate = formatDate3(/* @__PURE__ */ new Date());
     db.delete(gscCoverageSnapshots).where(and13(eq24(gscCoverageSnapshots.projectId, projectId), eq24(gscCoverageSnapshots.date, snapshotDate))).run();
     db.insert(gscCoverageSnapshots).values({
       id: crypto20.randomUUID(),
@@ -20591,6 +21611,7 @@ export {
   determineCitationState,
   computeCompetitorOverlap,
   extractRecommendedCompetitors,
+  renderReportHtml,
   setGoogleAuthConfig,
   formatAuditFactorScore,
   listAgentProviders,