Count views of shareable resource pages in resource stats

tools/catalog-build/build-stats.js

@@ -1,7 +1,7 @@
 import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { replaceClarityDays, unchangedStatsPayload } from './stats-state.js';
+import { replaceClarityDays, slugFromClarityUrl, unchangedStatsPayload } from './stats-state.js';
 
 const toolDirectory = dirname(fileURLToPath(import.meta.url));
 const repositoryRoot = join(toolDirectory, '..', '..');
@@ -98,16 +98,6 @@ function collectFallbackViews(resourceFolders) {
   return totals;
 }
 
-function slugFromClarityUrl(value, knownSlugs) {
-  if (typeof value !== 'string') return undefined;
-  try {
-    const slug = decodeURIComponent(new URL(value).hash.slice(1));
-    return knownSlugs.has(slug) ? slug : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
 function dateFromClarityRow(row) {
   const value = row.date ?? row.Date ?? row.day ?? row.Day;
   if (typeof value !== 'string') return undefined;

tools/catalog-build/stats-state.js

@@ -1,3 +1,22 @@
+// Resolves a Clarity page URL to a catalog slug. The catalog's detail view uses
+// `/#<slug>` and each shareable resource page lives at `/r/<slug>/`; both count as views.
+export function slugFromClarityUrl(value, knownSlugs) {
+  if (typeof value !== 'string') return undefined;
+  try {
+    const url = new URL(value);
+    const fromHash = decodeURIComponent(url.hash.slice(1));
+    if (knownSlugs.has(fromHash)) return fromHash;
+    const fromPath = url.pathname.match(/\/r\/([^/]+)\/?$/);
+    if (fromPath) {
+      const slug = decodeURIComponent(fromPath[1]);
+      if (knownSlugs.has(slug)) return slug;
+    }
+    return undefined;
+  } catch {
+    return undefined;
+  }
+}
+
 export function replaceClarityDays(state, buckets, lastRun) {
   for (const [date, metrics] of buckets) {
     state.days[date] = Object.fromEntries(

tools/catalog-build/test-stats-state.js

@@ -2,13 +2,27 @@ import {
   clarityStateContains,
   reconcileClarityStates,
   replaceClarityDays,
+  slugFromClarityUrl,
   unchangedStatsPayload
 } from './stats-state.js';
 
 function assert(condition, message) {
   if (!condition) throw new Error(message);
 }
 
+// Views on both the catalog detail route (#slug) and the shareable page (/r/slug/) count.
+const known = new Set(['ai-council', 'agents-cost-calculator']);
+assert(slugFromClarityUrl('https://microsoft.github.io/FastTrack/#ai-council', known) === 'ai-council',
+  'Hash routes must resolve to a slug.');
+assert(slugFromClarityUrl('https://microsoft.github.io/FastTrack/r/agents-cost-calculator/', known) === 'agents-cost-calculator',
+  'Shareable resource pages must resolve to a slug.');
+assert(slugFromClarityUrl('https://microsoft.github.io/FastTrack/r/agents-cost-calculator', known) === 'agents-cost-calculator',
+  'A missing trailing slash must still resolve.');
+assert(slugFromClarityUrl('https://microsoft.github.io/FastTrack/r/unknown/', known) === undefined,
+  'Unknown slugs must not resolve.');
+assert(slugFromClarityUrl('https://microsoft.github.io/FastTrack/', known) === undefined,
+  'The landing page is not a resource view.');
+
 const state = {
   lastRun: '2026-09-10',
   days: {