npm - @ainyc/canonry - Versions diffs - 3.5.0 → 3.6.2 - Mend

@ainyc/canonry 3.5.0 → 3.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/assets/agent-workspace/skills/aero/references/reporting.md +1 -1
package/assets/agent-workspace/skills/canonry-setup/references/canonry-cli.md +1 -1
package/assets/assets/{index-CFtdvSnQ.js → index-B5VNd16q.js} +114 -114
package/assets/index.html +1 -1
package/dist/{chunk-5G7S6SEP.js → chunk-CG4HEQAK.js} +225 -35
package/dist/{chunk-ZYESHCMF.js → chunk-GLPZ5NVP.js} +2 -2
package/dist/{chunk-VIUWGDDU.js → chunk-RDX6GBWM.js} +12 -0
package/dist/{chunk-K33FVWFW.js → chunk-W463NVVC.js} +43 -1
package/dist/cli.js +5 -5
package/dist/index.js +4 -4
package/dist/{intelligence-service-NGA6RLCH.js → intelligence-service-WZUM3AX6.js} +2 -2
package/dist/mcp.js +2 -2
package/package.json +7 -7

package/assets/index.html CHANGED Viewed

@@ -12,7 +12,7 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-CFtdvSnQ.js"></script>
+    <script type="module" crossorigin src="./assets/index-B5VNd16q.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-BfwQqd05.css">
   </head>
   <body>

package/dist/{chunk-5G7S6SEP.js → chunk-CG4HEQAK.js} RENAMED Viewed

@@ -4,7 +4,7 @@ import {
   configExists,
   loadConfig,
   saveConfigPatch
-} from "./chunk-ZYESHCMF.js";
+} from "./chunk-GLPZ5NVP.js";
 import {
   IntelligenceService,
   MIN_TREND_POINTS,
@@ -31,6 +31,7 @@ import {
   gaSocialReferrals,
   gaTrafficSnapshots,
   gaTrafficSummaries,
+  gaTrafficWindowSummaries,
   groupInsights,
   gscCoverageSnapshots,
   gscSearchData,
@@ -48,7 +49,7 @@ import {
   runs,
   schedules,
   usageCounters
-} from "./chunk-K33FVWFW.js";
+} from "./chunk-W463NVVC.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -63,6 +64,7 @@ import {
   RunKinds,
   RunStatuses,
   RunTriggers,
+  absolutizeProjectUrl,
   agentBusy,
   agentMemoryDeleteRequestSchema,
   agentMemoryUpsertRequestSchema,
@@ -110,7 +112,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-VIUWGDDU.js";
+} from "./chunk-RDX6GBWM.js";
 // src/telemetry.ts
 import crypto from "crypto";
@@ -2782,7 +2784,12 @@ function renderExecutiveSummary(report) {
           <span>${escapeHtml(f.detail)}</span>
         </div>`).join("")}</div>` : "";
   return section(
-    { id: "executive-summary", eyebrow: "Section 1", title: "Executive Summary" },
+    {
+      id: "executive-summary",
+      eyebrow: "Section 1",
+      title: "Executive Summary",
+      intro: "Top-line citation rate with trend versus the prior run, plus the most actionable findings from the latest visibility sweep."
+    },
     metricsHtml + findingsHtml
   );
 }
@@ -2841,15 +2848,11 @@ function renderCitationScorecard(report) {
     ${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." },
+    { id: "citation-scorecard", eyebrow: "Section 2", title: "Citation Scorecard", intro: "Whether your domain appeared in each AI engine\u2019s source list for every tracked keyword in the latest sweep \u2014 a cell turns green when your domain was cited, red when it was not, and gray when no snapshot exists for that pair." },
     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 }))
-  ];
+function renderLandscapeBars(data, heading, ariaLabel) {
   if (data.length <= 1) return "";
   const max = Math.max(...data.map((d) => d.count), 1);
   const width = 600;
@@ -2866,22 +2869,43 @@ function renderCompetitorBars(landscape, canonical) {
       <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">
+    <h3>${escapeHtml(heading)}</h3>
+    <svg viewBox="0 0 ${width} ${height}" width="100%" preserveAspectRatio="xMinYMin meet" role="img" aria-label="${escapeHtml(ariaLabel)}">
       ${bars}
     </svg>
   </div>`;
 }
+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 }))
+  ];
+  return renderLandscapeBars(data, "Citations per domain", "Citations per domain bar chart");
+}
+function renderMentionBars(landscape, canonical) {
+  const data = [
+    { label: canonical, count: landscape.projectMentionCount, isProject: true },
+    ...landscape.competitors.map((c) => ({ label: c.domain, count: c.mentionCount, isProject: false }))
+  ];
+  return renderLandscapeBars(data, "Mentions per domain", "Mentions per domain bar chart");
+}
 function renderCompetitorLandscape(report) {
   const competitors2 = report.competitorLandscape.competitors;
-  if (competitors2.length === 0 && report.competitorLandscape.projectCitationCount === 0) {
+  const mentionLandscape = report.mentionLandscape;
+  const noCitationData = competitors2.length === 0 && report.competitorLandscape.projectCitationCount === 0;
+  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.")
     );
   }
+  const mentionByDomain = new Map(mentionLandscape.competitors.map((m) => [m.domain, m]));
   const rows = competitors2.map((c) => {
     const tone = pressureTone(c.pressureLabel);
+    const mention = mentionByDomain.get(c.domain);
+    const mentionCount = mention?.mentionCount ?? 0;
+    const mentionTotal = mention?.totalCount ?? mentionLandscape.totalAnswerSnapshots;
     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>` : "";
@@ -2889,17 +2913,26 @@ function renderCompetitorLandscape(report) {
       <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">${mentionCount} / ${mentionTotal}</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>
+        <thead><tr><th>Domain</th><th>Pressure</th><th>Citations</th><th class="numeric">Mentions</th><th class="numeric">SOV</th><th>Cited keywords</th></tr></thead>
         <tbody>${rows}</tbody>
       </table>` : renderEmpty("No competitors configured.");
+  const citationBars = renderCompetitorBars(report.competitorLandscape, report.meta.project.canonicalDomain);
+  const mentionBars = renderMentionBars(mentionLandscape, report.meta.project.canonicalDomain);
+  const charts = citationBars && mentionBars ? `<div class="chart-grid">${citationBars}${mentionBars}</div>` : `${citationBars}${mentionBars}`;
   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}`
+    {
+      id: "competitor-landscape",
+      eyebrow: "Section 3",
+      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."
+    },
+    `${charts}${table}`
   );
 }
 function renderDonut(buckets) {
@@ -2946,7 +2979,7 @@ 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" },
+      { id: "ai-source-origin", eyebrow: "Section 4", title: "AI Citation Sources" },
       renderEmpty("No source data yet. Run a visibility sweep first.")
     );
   }
@@ -2961,7 +2994,12 @@ function renderAiSourceOrigin(report) {
         <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." },
+    {
+      id: "ai-source-origin",
+      eyebrow: "Section 4",
+      title: "AI Citation Sources",
+      intro: "Every external website AI engines cited as a source for your tracked keywords in the latest sweep \u2014 categorized by site type (Reddit, YouTube, news, etc.) on the left and ranked by citation count on the right. Your own domains are excluded; tracked competitors are flagged."
+    },
     `${renderDonut(origin.categories)}${table}`
   );
 }
@@ -3040,7 +3078,7 @@ function renderGsc(report) {
     </div>`);
   }
   return section(
-    { id: "gsc", eyebrow: "Section 5", title: "GSC Performance", intro: "Top queries, category breakdown, and traffic trend from Google Search Console." },
+    { 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." },
     `<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>
@@ -3085,7 +3123,7 @@ function renderGa(report) {
       <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)}.` },
+    { 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.` },
     `<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>
@@ -3126,7 +3164,7 @@ function renderSocial(report) {
       <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." },
+    { 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." },
     `<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>
@@ -3173,7 +3211,7 @@ function renderAiReferrals(report) {
     "AI referral sessions over time"
   );
   return section(
-    { id: "ai-referrals", eyebrow: "Section 8", title: "AI Referral Traffic", intro: "Sessions sent from AI answer engines." },
+    { 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." },
     `<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>
@@ -3219,7 +3257,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: `Source: ${ih.provider === "google" ? "Google Search Console" : "Bing Webmaster Tools"}.` },
+    { 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.` },
     `<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>
@@ -3259,7 +3297,7 @@ 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: "Per-run citation rate across the project history." },
+    { id: "citations-trend", eyebrow: "Section 10", title: "Citations Over Time", intro: "Citation rate across every visibility sweep \u2014 the share of (keyword \xD7 provider) pairs in each run where your domain appeared in the source list, with a per-provider breakdown beneath." },
     `${chart}
     <div class="chart-card"><h3>Run-by-run breakdown</h3>
       <table class="report-table">
@@ -3290,7 +3328,7 @@ function renderInsights(report) {
       </tr>`;
   }).join("");
   return section(
-    { id: "insights", eyebrow: "Section 11", title: "Insights & Alerts", intro: "Priority-ordered findings from the most recent runs." },
+    { 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>Keyword</th><th>Provider</th><th>Recommendation</th></tr></thead>
       <tbody>${rows}</tbody>
@@ -3300,8 +3338,9 @@ function renderInsights(report) {
 function renderOpportunities(report) {
   const opps = report.contentOpportunities;
   if (opps.length === 0) return "";
+  const canonical = report.meta.project.canonicalDomain;
   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 ourPage = o.ourBestPage ? `<a href="${escapeHtml(absolutizeProjectUrl(o.ourBestPage.url, canonical))}">${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>
@@ -3318,7 +3357,7 @@ function renderOpportunities(report) {
       id: "content-opportunities",
       eyebrow: "Section 12",
       title: "Content Opportunities",
-      intro: "Ranked, action-typed targets from the content recommendation engine. Top 10 shown."
+      intro: "Queries where you have search demand or competitor citation pressure but aren\u2019t winning AI citations. Each row carries a suggested action (create / refresh / expand / add-schema). 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>
@@ -3330,7 +3369,7 @@ function renderRecommendedNextSteps(report) {
   const steps = report.recommendedNextSteps;
   if (steps.length === 0) {
     return section(
-      { id: "recommended-next-steps", eyebrow: "Section 13", title: "Recommended Next Steps" },
+      { id: "recommended-next-steps", eyebrow: "Section 13", 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." },
       renderEmpty("No outstanding actions.")
     );
   }
@@ -3341,7 +3380,7 @@ function renderRecommendedNextSteps(report) {
       <span class="rationale">${escapeHtml(s.rationale)}</span>
     </div>`).join("");
   return section(
-    { id: "recommended-next-steps", eyebrow: "Section 13", title: "Recommended Next Steps" },
+    { id: "recommended-next-steps", eyebrow: "Section 13", 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." },
     `<div class="steps">${items}</div>`
   );
 }
@@ -3817,6 +3856,56 @@ function buildCompetitorLandscape(snapshots, competitorDomains, projectDomains,
   competitorRows.sort((a, b) => b.citationCount - a.citationCount);
   return { projectCitationCount, competitors: competitorRows };
 }
+function buildMentionLandscape(snapshots, competitorDomains, projectDisplayName, projectDomains, keywordLookup) {
+  let projectMentionCount = 0;
+  let totalAnswerSnapshots = 0;
+  const competitorMap = /* @__PURE__ */ new Map();
+  for (const c of competitorDomains) {
+    competitorMap.set(c, { count: 0, keywords: /* @__PURE__ */ new Set() });
+  }
+  for (const snap of snapshots) {
+    const text = snap.answerText;
+    if (!text) continue;
+    totalAnswerSnapshots++;
+    const kw = keywordLookup.byId.get(snap.keywordId);
+    const projectMentioned = snap.answerMentioned ?? determineAnswerMentioned(
+      text,
+      projectDisplayName,
+      projectDomains
+    );
+    if (projectMentioned) projectMentionCount++;
+    for (const competitor of competitorDomains) {
+      const brand = brandLabelFromDomain(competitor);
+      const mentioned = determineAnswerMentioned(text, brand, [competitor]);
+      if (mentioned) {
+        const entry = competitorMap.get(competitor);
+        entry.count++;
+        if (kw) entry.keywords.add(kw);
+      }
+    }
+  }
+  const totalMentionedSlots = projectMentionCount + [...competitorMap.values()].reduce((sum, v) => sum + v.count, 0);
+  const competitorRows = [...competitorMap.entries()].map(([domain, data]) => {
+    const ratio = totalAnswerSnapshots > 0 ? data.count / totalAnswerSnapshots : 0;
+    let pressureLabel = "None";
+    if (data.count > 0) {
+      if (ratio >= 0.5) pressureLabel = "High";
+      else if (ratio >= 0.2) pressureLabel = "Moderate";
+      else pressureLabel = "Low";
+    }
+    const sharePct = totalMentionedSlots > 0 ? Math.round(data.count / totalMentionedSlots * 100) : 0;
+    return {
+      domain,
+      mentionCount: data.count,
+      totalCount: totalAnswerSnapshots,
+      pressureLabel,
+      mentionedKeywords: [...data.keywords].sort(),
+      sharePct
+    };
+  });
+  competitorRows.sort((a, b) => b.mentionCount - a.mentionCount);
+  return { projectMentionCount, totalAnswerSnapshots, competitors: competitorRows };
+}
 function buildAiSourceOrigin(snapshots, projectDomains, competitorDomains) {
   const categoryCounts = /* @__PURE__ */ new Map();
   const domainCounts = /* @__PURE__ */ new Map();
@@ -4261,6 +4350,13 @@ function buildProjectReport(db, projectName) {
     projectDomains,
     keywordLookup
   );
+  const mentionLandscape = buildMentionLandscape(
+    latestSnapshots,
+    competitorDomains,
+    project.displayName,
+    projectDomains,
+    keywordLookup
+  );
   const aiSourceOrigin = buildAiSourceOrigin(latestSnapshots, projectDomains, competitorDomains);
   const trackedKeywords = [...keywordLookup.byId.values()];
   const gscSection = buildGscSection(
@@ -4353,6 +4449,7 @@ function buildProjectReport(db, projectName) {
     },
     citationScorecard,
     competitorLandscape,
+    mentionLandscape,
     aiSourceOrigin,
     gsc: gscSection,
     ga: gaSection,
@@ -7131,7 +7228,7 @@ var routeCatalog = [
     path: "/api/v1/projects/{name}/report",
     summary: "Aggregated client-facing AEO report",
     tags: ["report"],
-    description: "Bundles every section the canonry-report HTML output needs (executive summary, citation scorecard, competitor landscape, AI source origin, GSC, GA4, social/AI referrals, indexing health, citations trend, insights, and recommended next steps) into a single JSON payload. Backs `canonry report <project>`.",
+    description: "Bundles every section the canonry-report HTML output needs (executive summary, citation scorecard, competitor landscape \u2014 citation + mention landscapes, AI citation sources, GSC, GA4, social/AI referrals, indexing health, citations trend, insights, and recommended next steps) into a single JSON payload. Backs `canonry report <project>`.",
     parameters: [nameParameter],
     responses: {
       200: { description: "Report returned." },
@@ -8823,6 +8920,66 @@ async function fetchAggregateSummary(accessToken, propertyId, days) {
   ga4Log("info", "fetch-aggregate.done", { propertyId, ...summary });
   return summary;
 }
+var WINDOW_DAYS = { "7d": 7, "30d": 30, "90d": 90 };
+async function fetchWindowSummary(accessToken, propertyId, windowKey) {
+  validateAccessToken2(accessToken);
+  validatePropertyId(propertyId);
+  const days = WINDOW_DAYS[windowKey];
+  if (!days) {
+    throw new GA4ApiError(`Unsupported windowKey "${windowKey}" \u2014 must be 7d, 30d, or 90d`, 400);
+  }
+  const endDate = /* @__PURE__ */ new Date();
+  const startDate = /* @__PURE__ */ new Date();
+  startDate.setDate(startDate.getDate() - days);
+  const dateRange = { startDate: formatDate2(startDate), endDate: formatDate2(endDate) };
+  ga4Log("info", "fetch-window-summary.start", { propertyId, windowKey, days });
+  const batchRes = await batchRunReports(accessToken, propertyId, [
+    {
+      dateRanges: [dateRange],
+      dimensions: [],
+      metrics: [{ name: "sessions" }, { name: "totalUsers" }],
+      limit: 1
+    },
+    {
+      dateRanges: [dateRange],
+      dimensions: [],
+      metrics: [{ name: "sessions" }],
+      dimensionFilter: {
+        filter: {
+          fieldName: "sessionDefaultChannelGrouping",
+          stringFilter: { matchType: "EXACT", value: "Organic Search" }
+        }
+      },
+      limit: 1
+    },
+    {
+      dateRanges: [dateRange],
+      dimensions: [],
+      metrics: [{ name: "sessions" }],
+      dimensionFilter: {
+        filter: {
+          fieldName: "sessionDefaultChannelGrouping",
+          stringFilter: { matchType: "EXACT", value: "Direct" }
+        }
+      },
+      limit: 1
+    }
+  ]);
+  const totalRow = batchRes[0]?.rows?.[0];
+  const organicRow = batchRes[1]?.rows?.[0];
+  const directRow = batchRes[2]?.rows?.[0];
+  const summary = {
+    windowKey,
+    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,
+    totalDirectSessions: parseInt(directRow?.metricValues[0]?.value ?? "0", 10) || 0
+  };
+  ga4Log("info", "fetch-window-summary.done", { propertyId, ...summary });
+  return summary;
+}
 async function fetchAiReferrals(accessToken, propertyId, days) {
   validateAccessToken2(accessToken);
   validatePropertyId(propertyId);
@@ -10695,13 +10852,18 @@ async function ga4Routes(app, opts) {
       let rows = [];
       let aiReferrals = [];
       let socialReferrals = [];
-      const fetches = [fetchAggregateSummary(accessToken, propertyId, days)];
+      const WINDOW_KEYS = ["7d", "30d", "90d"];
+      const fetches = [
+        fetchAggregateSummary(accessToken, propertyId, days),
+        ...WINDOW_KEYS.map((w) => fetchWindowSummary(accessToken, propertyId, w))
+      ];
       if (syncTraffic) fetches.push(fetchTrafficByLandingPage(accessToken, propertyId, days));
       if (syncAi) fetches.push(fetchAiReferrals(accessToken, propertyId, days));
       if (syncSocial) fetches.push(fetchSocialReferrals(accessToken, propertyId, days));
       const results = await Promise.all(fetches);
       const summary = results[0];
-      let idx = 1;
+      const windowSummaries = results.slice(1, 1 + WINDOW_KEYS.length);
+      let idx = 1 + WINDOW_KEYS.length;
       if (syncTraffic) {
         rows = results[idx++];
       }
@@ -10798,6 +10960,22 @@ async function ga4Routes(app, opts) {
             syncedAt: now,
             syncRunId: runId
           }).run();
+          tx.delete(gaTrafficWindowSummaries).where(eq21(gaTrafficWindowSummaries.projectId, project.id)).run();
+          for (const ws of windowSummaries) {
+            tx.insert(gaTrafficWindowSummaries).values({
+              id: crypto16.randomUUID(),
+              projectId: project.id,
+              windowKey: ws.windowKey,
+              periodStart: ws.periodStart,
+              periodEnd: ws.periodEnd,
+              totalSessions: ws.totalSessions,
+              totalOrganicSessions: ws.totalOrganicSessions,
+              totalDirectSessions: ws.totalDirectSessions,
+              totalUsers: ws.totalUsers,
+              syncedAt: now,
+              syncRunId: runId
+            }).run();
+          }
         }
       });
       app.db.update(runs).set({ status: RunStatuses.completed, finishedAt: now }).where(eq21(runs.id, runId)).run();
@@ -10846,16 +11024,28 @@ async function ga4Routes(app, opts) {
     if (cutoffDate) aiConditions.push(sql5`${gaAiReferrals.date} >= ${cutoffDate}`);
     const socialConditions = [eq21(gaSocialReferrals.projectId, project.id)];
     if (cutoffDate) socialConditions.push(sql5`${gaSocialReferrals.date} >= ${cutoffDate}`);
-    const summaryRow = cutoffDate ? app.db.select({
+    const windowSummaryRow = cutoffDate ? app.db.select({
+      totalSessions: gaTrafficWindowSummaries.totalSessions,
+      totalOrganicSessions: gaTrafficWindowSummaries.totalOrganicSessions,
+      totalDirectSessions: gaTrafficWindowSummaries.totalDirectSessions,
+      totalUsers: gaTrafficWindowSummaries.totalUsers
+    }).from(gaTrafficWindowSummaries).where(
+      and9(
+        eq21(gaTrafficWindowSummaries.projectId, project.id),
+        eq21(gaTrafficWindowSummaries.windowKey, window)
+      )
+    ).get() : null;
+    const snapshotTotalsRow = cutoffDate && !windowSummaryRow ? app.db.select({
       totalSessions: sql5`COALESCE(SUM(${gaTrafficSnapshots.sessions}), 0)`,
       totalOrganicSessions: sql5`COALESCE(SUM(${gaTrafficSnapshots.organicSessions}), 0)`,
       totalUsers: sql5`COALESCE(SUM(${gaTrafficSnapshots.users}), 0)`
-    }).from(gaTrafficSnapshots).where(and9(...snapshotConditions)).get() : app.db.select({
+    }).from(gaTrafficSnapshots).where(and9(...snapshotConditions)).get() : null;
+    const summaryRow = cutoffDate ? windowSummaryRow ?? snapshotTotalsRow : app.db.select({
       totalSessions: gaTrafficSummaries.totalSessions,
       totalOrganicSessions: gaTrafficSummaries.totalOrganicSessions,
       totalUsers: gaTrafficSummaries.totalUsers
     }).from(gaTrafficSummaries).where(eq21(gaTrafficSummaries.projectId, project.id)).get();
-    const directTotalRow = app.db.select({
+    const directTotalRow = windowSummaryRow ? { totalDirectSessions: windowSummaryRow.totalDirectSessions } : app.db.select({
       totalDirectSessions: sql5`COALESCE(SUM(${gaTrafficSnapshots.directSessions}), 0)`
     }).from(gaTrafficSnapshots).where(and9(...snapshotConditions)).get();
     const summaryMeta = app.db.select({

package/dist/{chunk-ZYESHCMF.js → chunk-GLPZ5NVP.js} RENAMED Viewed

@@ -10,7 +10,7 @@ import {
   projectUpsertRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-VIUWGDDU.js";
+} from "./chunk-RDX6GBWM.js";
 // src/config.ts
 import fs from "fs";
@@ -1135,7 +1135,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_report",
     title: "Get aggregated AEO report",
-    description: "Returns the full client-facing AEO report bundle for a project \u2014 executive summary, per-keyword \xD7 per-provider citation matrix, competitor landscape, AI source origin, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render the self-contained HTML.",
+    description: "Returns the full client-facing AEO report bundle for a project \u2014 executive summary, per-keyword \xD7 per-provider citation matrix, competitor landscape, AI citation sources, GSC/GA4 performance, social and AI referrals, indexing health, citations trend, prioritized insights, and recommended next steps. Same payload `canonry report <project>` consumes to render the self-contained HTML.",
     access: "read",
     tier: "monitoring",
     inputSchema: projectInputSchema,

package/dist/{chunk-VIUWGDDU.js → chunk-RDX6GBWM.js} RENAMED Viewed

@@ -1711,6 +1711,17 @@ function dropTrailingSlash(path) {
   }
   return path;
 }
+function absolutizeProjectUrl(url, canonicalDomain) {
+  if (!url) return "";
+  const trimmed = url.trim();
+  if (!trimmed) return "";
+  if (/^https?:\/\//i.test(trimmed)) return trimmed;
+  if (trimmed.startsWith("//")) return `https:${trimmed}`;
+  const host = canonicalDomain.trim().replace(/^https?:\/\//i, "").replace(/\/+$/, "");
+  if (!host) return trimmed;
+  if (trimmed.startsWith("/")) return `https://${host}${trimmed}`;
+  return `https://${host}/${trimmed}`;
+}
 function normalizeUrlPath(input) {
   if (input == null) return null;
   let trimmed = input.trim();
@@ -1910,6 +1921,7 @@ export {
   CheckScopes,
   CheckCategories,
   summarizeCheckResults,
+  absolutizeProjectUrl,
   normalizeUrlPath,
   emptyCitationVisibility,
   citationStateToCited,

package/dist/{chunk-K33FVWFW.js → chunk-W463NVVC.js} RENAMED Viewed

@@ -2,7 +2,7 @@ import {
   ContentActions,
   RunKinds,
   __export
-} from "./chunk-VIUWGDDU.js";
+} from "./chunk-RDX6GBWM.js";
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";
@@ -33,6 +33,7 @@ __export(schema_exports, {
   gaSocialReferrals: () => gaSocialReferrals,
   gaTrafficSnapshots: () => gaTrafficSnapshots,
   gaTrafficSummaries: () => gaTrafficSummaries,
+  gaTrafficWindowSummaries: () => gaTrafficWindowSummaries,
   googleConnections: () => googleConnections,
   gscCoverageSnapshots: () => gscCoverageSnapshots,
   gscSearchData: () => gscSearchData,
@@ -392,6 +393,23 @@ var gaTrafficSummaries = sqliteTable("ga_traffic_summaries", {
   index("idx_ga_summary_project").on(table.projectId),
   index("idx_ga_summary_run").on(table.syncRunId)
 ]);
+var gaTrafficWindowSummaries = sqliteTable("ga_traffic_window_summaries", {
+  id: text("id").primaryKey(),
+  projectId: text("project_id").notNull().references(() => projects.id, { onDelete: "cascade" }),
+  /** '7d' | '30d' | '90d' */
+  windowKey: text("window_key").notNull(),
+  periodStart: text("period_start").notNull(),
+  periodEnd: text("period_end").notNull(),
+  totalSessions: integer("total_sessions").notNull().default(0),
+  totalOrganicSessions: integer("total_organic_sessions").notNull().default(0),
+  totalDirectSessions: integer("total_direct_sessions").notNull().default(0),
+  totalUsers: integer("total_users").notNull().default(0),
+  syncedAt: text("synced_at").notNull(),
+  syncRunId: text("sync_run_id").references(() => runs.id, { onDelete: "cascade" })
+}, (table) => [
+  uniqueIndex("idx_ga_window_summary_unique").on(table.projectId, table.windowKey),
+  index("idx_ga_window_summary_run").on(table.syncRunId)
+]);
 var usageCounters = sqliteTable("usage_counters", {
   id: text("id").primaryKey(),
   scope: text("scope").notNull(),
@@ -1332,6 +1350,29 @@ var MIGRATION_VERSIONS = [
       `CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_ai_ref_unique_v3
          ON ga_ai_referrals(project_id, date, source, medium, source_dimension, landing_page)`
     ]
+  },
+  {
+    version: 47,
+    name: "ga-traffic-window-summaries",
+    statements: [
+      `CREATE TABLE IF NOT EXISTS ga_traffic_window_summaries (
+        id                       TEXT PRIMARY KEY,
+        project_id               TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+        window_key               TEXT NOT NULL,
+        period_start             TEXT NOT NULL,
+        period_end               TEXT NOT NULL,
+        total_sessions           INTEGER NOT NULL DEFAULT 0,
+        total_organic_sessions   INTEGER NOT NULL DEFAULT 0,
+        total_direct_sessions    INTEGER NOT NULL DEFAULT 0,
+        total_users              INTEGER NOT NULL DEFAULT 0,
+        synced_at                TEXT NOT NULL,
+        sync_run_id              TEXT REFERENCES runs(id) ON DELETE CASCADE
+      )`,
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_ga_window_summary_unique
+         ON ga_traffic_window_summaries(project_id, window_key)`,
+      `CREATE INDEX IF NOT EXISTS idx_ga_window_summary_run
+         ON ga_traffic_window_summaries(sync_run_id)`
+    ]
   }
 ];
 function isDuplicateColumnError(err) {
@@ -2348,6 +2389,7 @@ export {
   gaAiReferrals,
   gaSocialReferrals,
   gaTrafficSummaries,
+  gaTrafficWindowSummaries,
   usageCounters,
   insights,
   healthSnapshots,