npm - @ainyc/canonry - Versions diffs - 4.23.0 → 4.24.0 - Mend

@ainyc/canonry 4.23.0 → 4.24.0

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 (10) hide show

package/assets/agent-workspace/skills/canonry-setup/references/server-side-traffic.md +54 -7
package/assets/assets/index-BFfB9cRq.js +302 -0
package/assets/index.html +1 -1
package/dist/{chunk-VOSBGXXG.js → chunk-6EJ54OX7.js} +2 -2
package/dist/{chunk-CLVZF3X7.js → chunk-E5PZ23OS.js} +229 -62
package/dist/cli.js +5 -5
package/dist/index.js +2 -2
package/dist/mcp.js +2 -2
package/package.json +6 -6
package/assets/assets/index-qGDEhNJu.js +0 -302

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-qGDEhNJu.js"></script>
+    <script type="module" crossorigin src="./assets/index-BFfB9cRq.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-rPok6yk8.css">
   </head>
   <body>

package/dist/{chunk-VOSBGXXG.js → chunk-6EJ54OX7.js} RENAMED Viewed

@@ -1752,7 +1752,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_traffic_source_get",
     title: "Get traffic source detail",
-    description: "Get one traffic source plus 24h totals (crawler hits, AI-referral hits, raw event sample count) and the latest traffic-sync run summary. Use to confirm a source is healthy and observing traffic before drilling into events.",
+    description: "Get one traffic source plus 24h totals (crawler hits, AI-referral sessions, raw event sample count) and the latest traffic-sync run summary. Use to confirm a source is healthy and observing traffic before drilling into events.",
     access: "read",
     tier: "traffic",
     inputSchema: trafficSourceIdInputSchema,
@@ -1763,7 +1763,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_traffic_status",
     title: "Traffic status (all sources)",
-    description: "Single-call composite returning every non-archived traffic source plus its last-24h totals (crawler hits, AI-referral hits, sample count) and latest source-scoped traffic-sync run. Same per-entry shape as canonry_traffic_source_get, but one call covers all sources \u2014 prefer this over a list+per-source fan-out.",
+    description: "Single-call composite returning every non-archived traffic source plus its last-24h totals (crawler hits, AI-referral sessions, sample count) and latest source-scoped traffic-sync run. Same per-entry shape as canonry_traffic_source_get, but one call covers all sources \u2014 prefer this over a list+per-source fan-out.",
     access: "read",
     tier: "traffic",
     inputSchema: projectInputSchema,

package/dist/{chunk-CLVZF3X7.js → chunk-E5PZ23OS.js} RENAMED Viewed

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-VOSBGXXG.js";
+} from "./chunk-6EJ54OX7.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -4304,33 +4304,44 @@ function renderServerActivity(report, audience) {
     return `<span class="tone-${deltaTone(d.deltaPct)}">${escapeHtml(copy)}</span>`;
   };
   if (isClient) {
-    const clientOperators = sa.byOperator.filter((o) => o.verifiedHits > 0 || o.referralArrivals > 0).slice(0, 5);
+    const crawlerRequests = {
+      current: sa.verifiedCrawlerHits.current + sa.unverifiedCrawlerHits.current,
+      prior: sa.verifiedCrawlerHits.prior + sa.unverifiedCrawlerHits.prior,
+      deltaPct: deltaPercent(
+        sa.verifiedCrawlerHits.current + sa.unverifiedCrawlerHits.current,
+        sa.verifiedCrawlerHits.prior + sa.unverifiedCrawlerHits.prior
+      )
+    };
+    const crawlerTrustSummary = `${formatNumber(sa.verifiedCrawlerHits.current)} verified \xB7 ${formatNumber(sa.unverifiedCrawlerHits.current)} unverified`;
+    const crawlerDelta = formatDelta(crawlerRequests, "requests");
+    const crawlerSubtitle = crawlerDelta ? `${escapeHtml(crawlerTrustSummary)} \xB7 ${crawlerDelta}` : escapeHtml(crawlerTrustSummary);
+    const clientOperators = sa.byOperator.filter((o) => o.verifiedHits > 0 || o.unverifiedHits > 0 || o.referralArrivals > 0).slice(0, 5);
     const clientOperatorRows = clientOperators.map((o) => `
     <tr>
       <td>${escapeHtml(o.operator)}</td>
-      <td class="numeric">${formatNumber(o.verifiedHits)}</td>
+      <td class="numeric">${formatNumber(o.verifiedHits + o.unverifiedHits)}</td>
       <td class="numeric">${formatNumber(o.referralArrivals)}</td>
     </tr>`).join("");
     return section(
       serverActivityHeading("client", true),
       `<div class="metric-grid">
         <div class="metric">
-          <div class="label">AI bots visited your site</div>
-          <div class="value">${formatNumber(sa.verifiedCrawlerHits.current)}</div>
-          <div class="subtitle">${formatDelta(sa.verifiedCrawlerHits, "crawls")}</div>
+          <div class="label">AI bot requests observed</div>
+          <div class="value">${formatNumber(crawlerRequests.current)}</div>
+          <div class="subtitle">${crawlerSubtitle}</div>
         </div>
         <div class="metric">
-          <div class="label">People clicked through from AI</div>
+          <div class="label">AI referral sessions</div>
           <div class="value">${formatNumber(sa.referralArrivals.current)}</div>
-          <div class="subtitle">${formatDelta(sa.referralArrivals, "arrivals")}</div>
+          <div class="subtitle">${formatDelta(sa.referralArrivals, "sessions")}</div>
         </div>
       </div>
       ${clientOperatorRows ? `<div class="chart-card"><h3>By AI tool</h3>
         <table class="report-table">
-          <thead><tr><th>AI tool</th><th class="numeric">Bot visits (7d)</th><th class="numeric">Click-throughs</th></tr></thead>
+          <thead><tr><th>AI tool</th><th class="numeric">Bot requests (7d)</th><th class="numeric">Referral sessions</th></tr></thead>
           <tbody>${clientOperatorRows}</tbody>
         </table>
-        <p class="meta">Verified visits only. We confirm each bot via reverse-DNS so the numbers above can't be inflated by anyone faking a user agent.</p>
+        <p class="meta">Verified requests are reverse-DNS confirmed. Unverified requests are user-agent claims shown separately in agency diagnostics.</p>
       </div>` : ""}`
     );
   }
@@ -4378,16 +4389,21 @@ function renderServerActivity(report, audience) {
         <div class="subtitle">${formatDelta(sa.verifiedCrawlerHits, "hits")}</div>
       </div>
       <div class="metric">
-        <div class="label">AI-referral arrivals (7d)</div>
+        <div class="label">Unverified crawler hits (7d)</div>
+        <div class="value">${formatNumber(sa.unverifiedCrawlerHits.current)}</div>
+        <div class="subtitle">${formatDelta(sa.unverifiedCrawlerHits, "hits")}</div>
+      </div>
+      <div class="metric">
+        <div class="label">AI-referral sessions (7d)</div>
         <div class="value">${formatNumber(sa.referralArrivals.current)}</div>
-        <div class="subtitle">${formatDelta(sa.referralArrivals, "arrivals")}</div>
+        <div class="subtitle">${formatDelta(sa.referralArrivals, "sessions")}</div>
       </div>
     </div>
     ${trendChart}
     ${operatorRows ? `<div class="chart-card"><h3>Per AI operator</h3>
       <p class="meta">Verified means rDNS-confirmed. Unverified bots claim the user-agent but couldn't be verified \u2014 could be the real bot or an imitator.</p>
       <table class="report-table">
-        <thead><tr><th>Operator</th><th class="numeric">Verified hits</th><th class="numeric">Unverified</th><th class="numeric">Referral arrivals</th><th class="numeric">7d delta</th></tr></thead>
+        <thead><tr><th>Operator</th><th class="numeric">Verified hits</th><th class="numeric">Unverified</th><th class="numeric">Referral sessions</th><th class="numeric">7d delta</th></tr></thead>
         <tbody>${operatorRows}</tbody>
       </table>
     </div>` : ""}
@@ -4398,16 +4414,16 @@ function renderServerActivity(report, audience) {
         <tbody>${pathRows}</tbody>
       </table>
     </div>` : ""}
-    ${referralProductRows ? `<div class="chart-card"><h3>Click-throughs by AI product</h3>
+    ${referralProductRows ? `<div class="chart-card"><h3>AI-referral sessions by product</h3>
       <p class="meta">Where humans landed coming from each AI product (chatgpt.com, claude.ai, \u2026).</p>
       <table class="report-table">
-        <thead><tr><th>Product</th><th class="numeric">Arrivals</th><th class="numeric">Distinct landing paths</th></tr></thead>
+        <thead><tr><th>Product</th><th class="numeric">Sessions</th><th class="numeric">Distinct landing paths</th></tr></thead>
         <tbody>${referralProductRows}</tbody>
       </table>
     </div>` : ""}
     ${referralLandingRows ? `<div class="chart-card"><h3>Top AI-referral landing paths</h3>
       <table class="report-table">
-        <thead><tr><th>Path</th><th class="numeric">Arrivals</th><th class="numeric">Distinct products</th></tr></thead>
+        <thead><tr><th>Path</th><th class="numeric">Sessions</th><th class="numeric">Distinct products</th></tr></thead>
         <tbody>${referralLandingRows}</tbody>
       </table>
     </div>` : ""}`
@@ -5075,28 +5091,39 @@ function buildCandidateQueries(opts) {
   });
 }
 function aggregateGscByQuery(rows) {
-  const byQuery = /* @__PURE__ */ new Map();
+  const accumulators = /* @__PURE__ */ new Map();
   for (const r of rows) {
-    const existing = byQuery.get(r.query);
-    const candidate = {
-      // GSC stores `page` as a full URL for url-prefix properties; normalize to
-      // a path so it can be joined against `gaTrafficByPage` (which is keyed by
-      // path) and so `ourBestPage.url` / `targetRef` stay consistent regardless
-      // of whether the page is sourced from GSC or from inventory.
-      page: extractPath(r.page),
-      position: Number(r.position) || 0,
-      impressions: r.impressions,
-      clicks: r.clicks,
-      ctr: Number(r.ctr) || 0
-    };
+    const page = extractPath(r.page);
+    const position = Number(r.position) || 0;
+    const existing = accumulators.get(r.query);
     if (!existing) {
-      byQuery.set(r.query, candidate);
+      accumulators.set(r.query, {
+        bestPage: page,
+        bestPageImpressions: r.impressions,
+        totalClicks: r.clicks,
+        totalImpressions: r.impressions,
+        weightedPositionSum: position * r.impressions
+      });
       continue;
     }
-    if (candidate.impressions > existing.impressions) {
-      byQuery.set(r.query, candidate);
+    existing.totalClicks += r.clicks;
+    existing.totalImpressions += r.impressions;
+    existing.weightedPositionSum += position * r.impressions;
+    if (r.impressions > existing.bestPageImpressions) {
+      existing.bestPage = page;
+      existing.bestPageImpressions = r.impressions;
     }
   }
+  const byQuery = /* @__PURE__ */ new Map();
+  for (const [query, acc] of accumulators) {
+    byQuery.set(query, {
+      page: acc.bestPage,
+      position: acc.totalImpressions > 0 ? acc.weightedPositionSum / acc.totalImpressions : 0,
+      impressions: acc.totalImpressions,
+      clicks: acc.totalClicks,
+      ctr: acc.totalImpressions > 0 ? acc.totalClicks / acc.totalImpressions : 0
+    });
+  }
   return byQuery;
 }
 function aggregateCandidate(opts) {
@@ -5503,6 +5530,29 @@ function buildAiReferrals(db, projectId) {
   const topLandingPages = [...pageAgg.entries()].map(([page, data]) => ({ page, sessions: data.sessions, users: data.users })).sort((a, b) => b.sessions - a.sessions).slice(0, TOP_AI_REFERRAL_PAGES_LIMIT);
   return { totalSessions: total, totalUsers, bySource, trend, topLandingPages };
 }
+function nonSubresourceReferralPathCondition() {
+  return sql3`
+    LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/_next/static/%'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/assets/%'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/static/%'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '/favicon.%'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.avif'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.css'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.gif'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.ico'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.jpeg'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.jpg'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.js'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.map'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.mjs'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.otf'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.png'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.svg'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.webmanifest'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.woff'
+    AND LOWER(${aiReferralEventsHourly.landingPathNormalized}) NOT LIKE '%.woff2'
+  `;
+}
 function buildServerActivity(db, projectId) {
   const sourceRows = db.select({ id: trafficSources.id }).from(trafficSources).where(
     and5(
@@ -5529,10 +5579,21 @@ function buildServerActivity(db, projectId) {
       )
     ).get()?.total ?? 0
   );
+  const sumUnverifiedCrawlers = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
+    db.select({ total: sql3`COALESCE(SUM(${crawlerEventsHourly.hits}), 0)` }).from(crawlerEventsHourly).where(
+      and5(
+        eq13(crawlerEventsHourly.projectId, projectId),
+        ne(crawlerEventsHourly.verificationStatus, VerificationStatuses.verified),
+        gte(crawlerEventsHourly.tsHour, windowStartIso),
+        exclusiveEnd ? lt(crawlerEventsHourly.tsHour, windowEndIso) : lte(crawlerEventsHourly.tsHour, windowEndIso)
+      )
+    ).get()?.total ?? 0
+  );
   const sumReferrals = (windowStartIso, windowEndIso, exclusiveEnd = false) => Number(
     db.select({ total: sql3`COALESCE(SUM(${aiReferralEventsHourly.sessionsOrHits}), 0)` }).from(aiReferralEventsHourly).where(
       and5(
         eq13(aiReferralEventsHourly.projectId, projectId),
+        nonSubresourceReferralPathCondition(),
         gte(aiReferralEventsHourly.tsHour, windowStartIso),
         exclusiveEnd ? lt(aiReferralEventsHourly.tsHour, windowEndIso) : lte(aiReferralEventsHourly.tsHour, windowEndIso)
       )
@@ -5540,6 +5601,8 @@ function buildServerActivity(db, projectId) {
   );
   const verifiedCurrent = sumVerifiedCrawlers(headlineStart, headlineEnd);
   const verifiedPrior = sumVerifiedCrawlers(priorStart, headlineStart, true);
+  const unverifiedCurrent = sumUnverifiedCrawlers(headlineStart, headlineEnd);
+  const unverifiedPrior = sumUnverifiedCrawlers(priorStart, headlineStart, true);
   const referralCurrent = sumReferrals(headlineStart, headlineEnd);
   const referralPrior = sumReferrals(priorStart, headlineStart, true);
   const crawlerByOperatorRows = db.select({
@@ -5570,6 +5633,7 @@ function buildServerActivity(db, projectId) {
   }).from(aiReferralEventsHourly).where(
     and5(
       eq13(aiReferralEventsHourly.projectId, projectId),
+      nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
@@ -5601,7 +5665,7 @@ function buildServerActivity(db, projectId) {
     referralArrivals: v.referrals,
     deltaPct: deltaPercent(v.verified, v.prior)
   })).sort(
-    (a, b) => b.verifiedHits - a.verifiedHits || b.referralArrivals - a.referralArrivals
+    (a, b) => b.verifiedHits - a.verifiedHits || b.unverifiedHits - a.unverifiedHits || b.referralArrivals - a.referralArrivals
   );
   const topPathsRows = db.select({
     path: crawlerEventsHourly.pathNormalized,
@@ -5627,6 +5691,7 @@ function buildServerActivity(db, projectId) {
   }).from(aiReferralEventsHourly).where(
     and5(
       eq13(aiReferralEventsHourly.projectId, projectId),
+      nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
@@ -5643,6 +5708,7 @@ function buildServerActivity(db, projectId) {
   }).from(aiReferralEventsHourly).where(
     and5(
       eq13(aiReferralEventsHourly.projectId, projectId),
+      nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, headlineStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
@@ -5669,6 +5735,7 @@ function buildServerActivity(db, projectId) {
   }).from(aiReferralEventsHourly).where(
     and5(
       eq13(aiReferralEventsHourly.projectId, projectId),
+      nonSubresourceReferralPathCondition(),
       gte(aiReferralEventsHourly.tsHour, trendStart),
       lte(aiReferralEventsHourly.tsHour, headlineEnd)
     )
@@ -5688,12 +5755,17 @@ function buildServerActivity(db, projectId) {
   return {
     windowStart: headlineStart,
     windowEnd: headlineEnd,
-    hasData: verifiedCurrent + referralCurrent + verifiedPrior + referralPrior > 0 || byOperator.length > 0 || topCrawledPaths.length > 0 || referralProducts.length > 0,
+    hasData: verifiedCurrent + unverifiedCurrent + referralCurrent + verifiedPrior + unverifiedPrior + referralPrior > 0 || byOperator.length > 0 || topCrawledPaths.length > 0 || referralProducts.length > 0,
     verifiedCrawlerHits: {
       current: verifiedCurrent,
       prior: verifiedPrior,
       deltaPct: deltaPercent(verifiedCurrent, verifiedPrior)
     },
+    unverifiedCrawlerHits: {
+      current: unverifiedCurrent,
+      prior: unverifiedPrior,
+      deltaPct: deltaPercent(unverifiedCurrent, unverifiedPrior)
+    },
     referralArrivals: {
       current: referralCurrent,
       prior: referralPrior,
@@ -8657,6 +8729,7 @@ var routeCatalog = [
       { name: "query", in: "query", description: "Filter by search query.", schema: stringSchema },
       { name: "page", in: "query", description: "Filter by page URL.", schema: stringSchema },
       limitQueryParameter,
+      offsetQueryParameter,
       analyticsWindowParameter
     ],
     responses: {
@@ -10043,7 +10116,7 @@ var routeCatalog = [
     method: "post",
     path: "/api/v1/projects/{name}/traffic/sources/{id}/sync",
     summary: "Trigger a sync run for a traffic source",
-    description: "Pulls request logs from the configured Cloud Run service for the lookback window, classifies crawler / AI-referral hits, and upserts hourly buckets and a bounded sample tail.",
+    description: "Pulls request logs from the configured Cloud Run service for the lookback window, classifies crawler hits / AI-referral sessions, and upserts hourly buckets and a bounded sample tail.",
     tags: ["traffic"],
     parameters: [
       nameParameter,
@@ -10138,7 +10211,7 @@ var routeCatalog = [
   {
     method: "get",
     path: "/api/v1/projects/{name}/traffic/events",
-    summary: "List rolled-up crawler and AI-referral hits within a window",
+    summary: "List rolled-up crawler hits and AI-referral sessions within a window",
     description: "Returns hourly rollup rows from `crawler_events_hourly` and `ai_referral_events_hourly`. Defaults to the last 24h. Totals reflect the full window; the `events` array is capped by `limit` (default 500, max 5000).",
     tags: ["traffic"],
     parameters: [
@@ -11998,7 +12071,7 @@ async function googleRoutes(app, opts) {
   });
   app.get("/projects/:name/google/gsc/performance", async (request) => {
     const project = resolveProject(app.db, request.params.name);
-    const { startDate, endDate, query, page, limit } = request.query;
+    const { startDate, endDate, query, page, limit, offset } = request.query;
     const cutoffDate = !startDate ? windowCutoff(parseWindow(request.query.window))?.slice(0, 10) ?? null : null;
     const conditions = [eq18(gscSearchData.projectId, project.id)];
     if (startDate) conditions.push(sql5`${gscSearchData.date} >= ${startDate}`);
@@ -12006,7 +12079,9 @@ async function googleRoutes(app, opts) {
     if (endDate) conditions.push(sql5`${gscSearchData.date} <= ${endDate}`);
     if (query) conditions.push(sql5`${gscSearchData.query} LIKE ${"%" + query + "%"}`);
     if (page) conditions.push(sql5`${gscSearchData.page} LIKE ${"%" + page + "%"}`);
-    const rows = app.db.select().from(gscSearchData).where(and8(...conditions)).orderBy(desc8(gscSearchData.date)).limit(parseInt(limit ?? "500", 10)).all();
+    const limitVal = Math.max(parseInt(limit ?? "500", 10) || 0, 1);
+    const offsetVal = Math.max(parseInt(offset ?? "0", 10) || 0, 0);
+    const rows = app.db.select().from(gscSearchData).where(and8(...conditions)).orderBy(desc8(gscSearchData.date)).limit(limitVal).offset(offsetVal).all();
     return rows.map((r) => ({
       date: r.date,
       query: r.query,
@@ -16898,9 +16973,21 @@ function classifyAiReferral(event) {
 // ../integration-traffic/src/rollup.ts
 var DEFAULT_SAMPLE_LIMIT = 25;
+var DEFAULT_AI_REFERRAL_SESSION_WINDOW_MS = 6e4;
 var UUID_SEGMENT = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var LONG_HEX_SEGMENT = /^[0-9a-f]{16,}$/i;
 var NUMERIC_SEGMENT = /^\d+$/;
+var ASSET_EXTENSION_PATTERN = /\.(?:avif|bmp|css|gif|ico|jpe?g|js|json|map|mjs|mp4|otf|png|svg|webm|webmanifest|woff2?|xml)$/i;
+var ASSET_PATH_PREFIXES = [
+  "/_next/static/",
+  "/assets/",
+  "/build/",
+  "/dist/",
+  "/fonts/",
+  "/images/",
+  "/img/",
+  "/static/"
+];
 function normalizeTrafficPathPattern(path15) {
   const cleanPath = path15.trim() || "/";
   const pathOnly = cleanPath.split("?")[0] || "/";
@@ -16920,6 +17007,69 @@ function hourBucket(value) {
   date.setUTCMinutes(0, 0, 0);
   return date.toISOString();
 }
+function sessionWindowBucket(value, windowMs) {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return new Date(Math.floor(date.getTime() / windowMs) * windowMs).toISOString();
+}
+function normalizeHost2(host) {
+  if (!host) return null;
+  return host.trim().toLowerCase().replace(/^www\./, "") || null;
+}
+function sameHost(a, b) {
+  const normalizedA = normalizeHost2(a);
+  const normalizedB = normalizeHost2(b);
+  return !!normalizedA && !!normalizedB && normalizedA === normalizedB;
+}
+function pathFromSameOriginReferer(event) {
+  if (!event.referer) return null;
+  try {
+    const refererUrl = new URL(event.referer);
+    if (!sameHost(refererUrl.hostname, event.host)) return null;
+    return refererUrl.pathname || "/";
+  } catch {
+    return null;
+  }
+}
+function resolveAiReferralLandingPath(event, evidenceType) {
+  if (evidenceType === "referer-utm") {
+    const refererPath = pathFromSameOriginReferer(event);
+    if (refererPath) return normalizeTrafficPathPattern(refererPath);
+  }
+  return normalizeTrafficPathPattern(event.path);
+}
+function isLikelySubresourcePath(path15) {
+  const cleanPath = path15.split("?")[0] || "/";
+  return ASSET_PATH_PREFIXES.some((prefix) => cleanPath.startsWith(prefix)) || ASSET_EXTENSION_PATTERN.test(cleanPath);
+}
+function actorKey(event) {
+  const remoteIp = event.remoteIp?.trim();
+  const userAgent = event.userAgent?.trim();
+  if (remoteIp || userAgent) return `${remoteIp ?? "unknown-ip"}	${userAgent ?? "unknown-ua"}`;
+  return `event:${event.eventId}`;
+}
+function aiReferralSessionKey(event, aiReferral, landingPathNormalized, windowMs) {
+  return [
+    hourBucket(event.observedAt),
+    sessionWindowBucket(event.observedAt, windowMs),
+    actorKey(event),
+    aiReferral.sourceDomain,
+    landingPathNormalized
+  ].join("	");
+}
+function evidenceRank(evidenceType) {
+  switch (evidenceType) {
+    case "referer":
+      return 3;
+    case "utm":
+      return 2;
+    case "referer-utm":
+      return 1;
+  }
+}
+function strongerReferralEvidence(current, next) {
+  return evidenceRank(next.evidenceType) > evidenceRank(current.evidenceType) ? next : current;
+}
 function sortCrawlerBuckets(a, b) {
   return a.tsHour.localeCompare(b.tsHour) || a.botId.localeCompare(b.botId) || a.pathNormalized.localeCompare(b.pathNormalized) || String(a.status).localeCompare(String(b.status));
 }
@@ -16931,8 +17081,11 @@ function topEntries(map, limit) {
 }
 function buildTrafficProbeReport(events, options = {}) {
   const sampleLimit = options.sampleLimit ?? DEFAULT_SAMPLE_LIMIT;
+  const configuredSessionWindowMs = options.aiReferralSessionWindowMs ?? DEFAULT_AI_REFERRAL_SESSION_WINDOW_MS;
+  const aiReferralSessionWindowMs = configuredSessionWindowMs > 0 ? configuredSessionWindowMs : DEFAULT_AI_REFERRAL_SESSION_WINDOW_MS;
   const crawlerBuckets = /* @__PURE__ */ new Map();
   const aiReferralBuckets = /* @__PURE__ */ new Map();
+  const aiReferralSessions = /* @__PURE__ */ new Map();
   const topBots = /* @__PURE__ */ new Map();
   const topCrawlerPaths = /* @__PURE__ */ new Map();
   const topAiReferrers = /* @__PURE__ */ new Map();
@@ -16979,34 +17132,21 @@ function buildTrafficProbeReport(events, options = {}) {
     }
     if (aiReferral) {
       aiReferralHits += 1;
-      const key = [
-        tsHour,
-        aiReferral.product,
-        aiReferral.sourceDomain,
-        aiReferral.evidenceType,
-        pathNormalized,
-        event.status ?? "null"
-      ].join("	");
-      const existing = aiReferralBuckets.get(key);
-      if (existing) {
-        existing.hits += 1;
-      } else {
-        aiReferralBuckets.set(key, {
+      const landingPathNormalized = resolveAiReferralLandingPath(event, aiReferral.evidenceType);
+      if (!isLikelySubresourcePath(landingPathNormalized)) {
+        const session = {
           tsHour,
           operator: aiReferral.operator,
           product: aiReferral.product,
           sourceDomain: aiReferral.sourceDomain,
           evidenceType: aiReferral.evidenceType,
-          landingPathNormalized: pathNormalized,
-          status: event.status,
-          hits: 1
-        });
+          landingPathNormalized,
+          status: event.status
+        };
+        const key = aiReferralSessionKey(event, aiReferral, landingPathNormalized, aiReferralSessionWindowMs);
+        const existing = aiReferralSessions.get(key);
+        aiReferralSessions.set(key, existing ? strongerReferralEvidence(existing, session) : session);
       }
-      incrementBucket(topAiReferrers, aiReferral.sourceDomain, {
-        sourceDomain: aiReferral.sourceDomain,
-        product: aiReferral.product
-      });
-      incrementBucket(topAiReferralLandingPaths, pathNormalized, { landingPathNormalized: pathNormalized });
     }
     if (!crawler && !aiReferral) unknownHits += 1;
     samples.push({
@@ -17023,11 +17163,38 @@ function buildTrafficProbeReport(events, options = {}) {
     });
     if (samples.length > sampleLimit) samples.shift();
   }
+  for (const session of aiReferralSessions.values()) {
+    const key = [
+      session.tsHour,
+      session.product,
+      session.sourceDomain,
+      session.evidenceType,
+      session.landingPathNormalized,
+      session.status ?? "null"
+    ].join("	");
+    const existing = aiReferralBuckets.get(key);
+    if (existing) {
+      existing.hits += 1;
+    } else {
+      aiReferralBuckets.set(key, {
+        ...session,
+        hits: 1
+      });
+    }
+    incrementBucket(topAiReferrers, session.sourceDomain, {
+      sourceDomain: session.sourceDomain,
+      product: session.product
+    });
+    incrementBucket(topAiReferralLandingPaths, session.landingPathNormalized, {
+      landingPathNormalized: session.landingPathNormalized
+    });
+  }
   return {
     generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
     totals: {
       normalizedEvents: events.length,
       crawlerHits,
+      aiReferralSessions: aiReferralSessions.size,
       aiReferralHits,
       unknownHits
     },
@@ -18742,7 +18909,7 @@ var sourceConnectedCheck = {
         status: CheckStatuses.skipped,
         code: "traffic.source.none",
         summary: "No server-side traffic source connected \u2014 server-log AI visibility data unavailable for this project.",
-        remediation: "Connect a traffic source via `canonry traffic connect <type> <project>` to surface crawler hits and AI-referral arrivals from your server logs.",
+        remediation: "Connect a traffic source via `canonry traffic connect <type> <project>` to surface crawler hits and AI-referral sessions from your server logs.",
         details: { sourceCount: 0 }
       };
     }
@@ -18836,7 +19003,7 @@ var recentDataCheck = {
       return {
         status: CheckStatuses.warn,
         code: "traffic.recent-data.stale",
-        summary: `No crawler hits or AI-referral arrivals in the last ${RECENT_DATA_WARN_DAYS} days, though older data exists.`,
+        summary: `No crawler hits or AI-referral sessions in the last ${RECENT_DATA_WARN_DAYS} days, though older data exists.`,
         remediation: lastSyncedAt ? `Last sync: ${lastSyncedAt}. Run \`canonry traffic sync <project>\` to refresh, or check the source connection.` : "Run `canonry traffic sync <project>` to pull recent events.",
         details: { lastSyncedAt, sourceCount: sources.length }
       };

package/dist/cli.js CHANGED Viewed

@@ -20,7 +20,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-CLVZF3X7.js";
+} from "./chunk-E5PZ23OS.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,7 +36,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-VOSBGXXG.js";
+} from "./chunk-6EJ54OX7.js";
 import {
   apiKeys,
   competitors,
@@ -2987,7 +2987,7 @@ async function trafficStatus(project, opts) {
     console.log(`  Last synced:     ${d.lastSyncedAt ?? "never"}`);
     if (d.lastError) console.log(`  Last error:      ${d.lastError}`);
     console.log(`  24h crawler:     ${d.totals24h.crawlerHits} hits`);
-    console.log(`  24h AI referral: ${d.totals24h.aiReferralHits} hits`);
+    console.log(`  24h AI referral: ${d.totals24h.aiReferralHits} sessions`);
     console.log(`  24h samples:     ${d.totals24h.sampleCount}`);
     if (d.latestRun) {
       console.log(`  Latest run:      ${d.latestRun.runId} (${d.latestRun.status})`);
@@ -3050,13 +3050,13 @@ async function trafficEvents(project, opts) {
   }
   console.log(`Traffic events for "${project}"  ${result.windowStart}  \u2192  ${result.windowEnd}`);
   console.log(`  Crawler hits (window):     ${result.totals.crawlerHits}`);
-  console.log(`  AI referral hits (window): ${result.totals.aiReferralHits}`);
+  console.log(`  AI referral sessions (window): ${result.totals.aiReferralHits}`);
   console.log("");
   if (result.events.length === 0) {
     console.log("No events in this window.");
     return;
   }
-  console.log("  TS_HOUR  KIND  IDENTITY  EVIDENCE/STATUS  PATH  HITS");
+  console.log("  TS_HOUR  KIND  IDENTITY  EVIDENCE/STATUS  PATH  COUNT");
   for (const event of result.events) {
     console.log(`  ${formatEventLine(event)}`);
   }

package/dist/index.js CHANGED Viewed

@@ -1,9 +1,9 @@
 import {
   createServer
-} from "./chunk-CLVZF3X7.js";
+} from "./chunk-E5PZ23OS.js";
 import {
   loadConfig
-} from "./chunk-VOSBGXXG.js";
+} from "./chunk-6EJ54OX7.js";
 import "./chunk-OYYFXKRK.js";
 import "./chunk-EUGCQSFC.js";
 export {

package/dist/mcp.js CHANGED Viewed

@@ -2,7 +2,7 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-VOSBGXXG.js";
+} from "./chunk-6EJ54OX7.js";
 import "./chunk-EUGCQSFC.js";
 // src/mcp/cli.ts
@@ -137,7 +137,7 @@ var CANONRY_MCP_TOOLKITS = [
     name: "traffic",
     title: "Server-side traffic ingestion",
     description: "Connect Cloud Run traffic sources, trigger syncs, and read crawler / AI-referral hourly rollups straight from server logs (no GA dependency).",
-    whenToLoad: "Load when you need server-log evidence of crawler hits or AI-referral arrivals (e.g. confirming GPTBot or ChatGPT-User on a page), or when wiring up / syncing a Cloud Run traffic source."
+    whenToLoad: "Load when you need server-log evidence of crawler hits or AI-referral sessions (e.g. confirming GPTBot or ChatGPT-User on a page), or when wiring up / syncing a Cloud Run traffic source."
   },
   {
     name: "agent",