@riddledc/riddle-proof 0.7.143 → 0.7.145

package/dist/{chunk-66RDQVFI.js → chunk-ZC6AK3D3.js}

@@ -2030,11 +2030,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = numberValue(inventory.source_link_count) ?? numberValue(inventory.home_game_link_count) ?? null;
   const sourceUniqueLinkCount = numberValue(inventory.source_unique_link_count) ?? numberValue(inventory.home_unique_game_link_count) ?? null;
+  const sourceCandidateCount = numberValue(inventory.source_candidate_count);
+  const sourceCandidateUniqueLinkCount = numberValue(inventory.source_candidate_unique_link_count);
+  const sourceLinkScope = stringValue(inventory.source_link_scope);
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
   const duplicateSourceLinkCount = numberValue(inventory.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope ?? null,
+    source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -2044,6 +2050,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path2 = route.trim();
+      return path2 ? { path: path2 } : void 0;
+    }
+    if (!isRecord(route)) return void 0;
+    const path = stringValue(route.path);
+    if (!path) return void 0;
+    const name = stringValue(route.name);
+    return name ? { name, path } : { path };
+  }).filter((route) => Boolean(route));
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -2645,7 +2665,10 @@ function assessCheckFromEvidence(check, evidence) {
         type: check.type,
         label: checkLabel(check),
         status: "failed",
-        evidence: { expected_count: check.expected_routes?.length || 0 },
+        evidence: {
+          expected_count: check.expected_routes?.length || 0,
+          expected_routes: routeInventoryExpectedRouteSummaries(void 0, check.expected_routes)
+        },
         message: "No route inventory evidence was captured."
       };
     }
@@ -2656,14 +2679,22 @@ function assessCheckFromEvidence(check, evidence) {
     const clickthroughs = Array.isArray(first?.clickthroughs) ? first.clickthroughs : [];
     const sourceLinkCount = numberValue(first?.source_link_count) ?? numberValue(first?.home_game_link_count) ?? null;
     const sourceUniqueLinkCount = numberValue(first?.source_unique_link_count) ?? numberValue(first?.home_unique_game_link_count) ?? null;
+    const sourceCandidateCount = numberValue(first?.source_candidate_count);
+    const sourceCandidateUniqueLinkCount = numberValue(first?.source_candidate_unique_link_count);
+    const sourceLinkScope = stringValue(first?.source_link_scope);
     const duplicateSourceLinks = Array.isArray(first?.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
     const duplicateSourceLinkCount = numberValue(first?.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
+    const expectedRoutes = routeInventoryExpectedRouteSummaries(first?.expected_routes, check.expected_routes);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
+        expected_routes: expectedRoutes,
+        source_link_scope: sourceLinkScope ?? null,
+        source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+        source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
         source_link_count: sourceLinkCount,
         source_unique_link_count: sourceUniqueLinkCount,
         duplicate_source_link_count: duplicateSourceLinkCount,
@@ -3656,11 +3687,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = typeof inventory.source_link_count === "number" ? inventory.source_link_count : typeof inventory.home_game_link_count === "number" ? inventory.home_game_link_count : null;
   const sourceUniqueLinkCount = typeof inventory.source_unique_link_count === "number" ? inventory.source_unique_link_count : typeof inventory.home_unique_game_link_count === "number" ? inventory.home_unique_game_link_count : null;
+  const sourceCandidateCount = typeof inventory.source_candidate_count === "number" ? inventory.source_candidate_count : null;
+  const sourceCandidateUniqueLinkCount = typeof inventory.source_candidate_unique_link_count === "number" ? inventory.source_candidate_unique_link_count : null;
+  const sourceLinkScope = typeof inventory.source_link_scope === "string" ? inventory.source_link_scope : null;
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
   const duplicateSourceLinkCount = typeof inventory.duplicate_source_link_count === "number" ? inventory.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -3670,6 +3707,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length,
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path = route.trim();
+      return path ? { path } : null;
+    }
+    if (!route || typeof route !== "object" || Array.isArray(route)) return null;
+    const path = typeof route.path === "string" && route.path.trim() ? route.path.trim() : "";
+    if (!path) return null;
+    const name = typeof route.name === "string" && route.name.trim() ? route.name.trim() : "";
+    return name ? { name, path } : { path };
+  }).filter(Boolean);
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -4497,7 +4548,10 @@ function assessProfile(profile, evidence) {
           type: check.type,
           label: check.label || check.type,
           status: "failed",
-          evidence: { expected_count: (check.expected_routes || []).length },
+          evidence: {
+            expected_count: (check.expected_routes || []).length,
+            expected_routes: routeInventoryExpectedRouteSummaries(undefined, check.expected_routes),
+          },
           message: "No route inventory evidence was captured.",
         });
         continue;
@@ -4514,14 +4568,22 @@ function assessProfile(profile, evidence) {
       const clickthroughs = Array.isArray(first.clickthroughs) ? first.clickthroughs : [];
       const sourceLinkCount = typeof first.source_link_count === "number" ? first.source_link_count : typeof first.home_game_link_count === "number" ? first.home_game_link_count : null;
       const sourceUniqueLinkCount = typeof first.source_unique_link_count === "number" ? first.source_unique_link_count : typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null;
+      const sourceCandidateCount = typeof first.source_candidate_count === "number" ? first.source_candidate_count : null;
+      const sourceCandidateUniqueLinkCount = typeof first.source_candidate_unique_link_count === "number" ? first.source_candidate_unique_link_count : null;
+      const sourceLinkScope = typeof first.source_link_scope === "string" ? first.source_link_scope : null;
       const duplicateSourceLinks = Array.isArray(first.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
       const duplicateSourceLinkCount = typeof first.duplicate_source_link_count === "number" ? first.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
+      const expectedRoutes = routeInventoryExpectedRouteSummaries(first.expected_routes, check.expected_routes);
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
+          expected_routes: expectedRoutes,
+          source_link_scope: sourceLinkScope,
+          source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+          source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
           source_link_count: sourceLinkCount,
           source_unique_link_count: sourceUniqueLinkCount,
           duplicate_source_link_count: duplicateSourceLinkCount,
@@ -6693,9 +6755,15 @@ async function collectInventoryHomeLinks(check) {
         app_path: appPath,
       };
     });
-    return links.filter((link) => (
+    const selectedLinks = links.filter((link) => (
       routePathPrefix ? link.app_path.startsWith(routePathPrefix) : expectedSet.has(link.app_path)
     ));
+    return {
+      links: selectedLinks,
+      candidate_count: links.length,
+      candidate_unique_link_count: Array.from(new Set(links.map((link) => link.app_path))).length,
+      source_link_scope: routePathPrefix ? "route_path_prefix" : "expected_routes",
+    };
   }, { linkSelector, expectedPaths, routePathPrefix, targetUrl });
 }
 async function waitForInventoryRouteHealth(check, expectedPath) {
@@ -6836,7 +6904,11 @@ async function collectRouteInventory(check, viewport) {
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
   const expectedSet = new Set(expectedPaths);
   const failures = [];
-  const homeLinks = await collectInventoryHomeLinks(check);
+  const homeLinkCapture = await collectInventoryHomeLinks(check);
+  const homeLinks = Array.isArray(homeLinkCapture) ? homeLinkCapture : Array.isArray(homeLinkCapture && homeLinkCapture.links) ? homeLinkCapture.links : [];
+  const sourceCandidateCount = typeof homeLinkCapture?.candidate_count === "number" ? homeLinkCapture.candidate_count : homeLinks.length;
+  const sourceCandidateUniqueLinkCount = typeof homeLinkCapture?.candidate_unique_link_count === "number" ? homeLinkCapture.candidate_unique_link_count : new Set(homeLinks.map((link) => link.app_path)).size;
+  const sourceLinkScope = typeof homeLinkCapture?.source_link_scope === "string" ? homeLinkCapture.source_link_scope : check.route_path_prefix ? "route_path_prefix" : "expected_routes";
   const homeLinkPaths = homeLinks.map((link) => link.app_path);
   const uniqueHomeLinkPaths = Array.from(new Set(homeLinkPaths));
   const duplicateHomeLinkPaths = homeLinkPaths.filter((path, index) => homeLinkPaths.indexOf(path) !== index);
@@ -6918,6 +6990,9 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount,
     source_link_count: homeLinkPaths.length,
     source_unique_link_count: uniqueHomeLinkPaths.length,
     duplicate_source_link_count: duplicateHomeLinkPaths.length,
@@ -7114,6 +7189,9 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_scope: routeInventoryCheck.route_path_prefix ? "route_path_prefix" : "expected_routes",
+        source_candidate_count: 0,
+        source_candidate_unique_link_count: 0,
         source_link_count: 0,
         source_unique_link_count: 0,
         duplicate_source_link_count: 0,
@@ -7240,6 +7318,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          source_link_scope: viewport.route_inventory.source_link_scope,
+          source_candidate_count: viewport.route_inventory.source_candidate_count,
+          source_candidate_unique_link_count: viewport.route_inventory.source_candidate_unique_link_count,
           source_link_count: viewport.route_inventory.source_link_count == null ? viewport.route_inventory.home_game_link_count : viewport.route_inventory.source_link_count,
           source_unique_link_count: viewport.route_inventory.source_unique_link_count == null ? viewport.route_inventory.home_unique_game_link_count : viewport.route_inventory.source_unique_link_count,
           duplicate_source_link_count: viewport.route_inventory.duplicate_source_link_count,

package/dist/cli.cjs

@@ -8967,11 +8967,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = numberValue(inventory.source_link_count) ?? numberValue(inventory.home_game_link_count) ?? null;
   const sourceUniqueLinkCount = numberValue(inventory.source_unique_link_count) ?? numberValue(inventory.home_unique_game_link_count) ?? null;
+  const sourceCandidateCount = numberValue(inventory.source_candidate_count);
+  const sourceCandidateUniqueLinkCount = numberValue(inventory.source_candidate_unique_link_count);
+  const sourceLinkScope = stringValue2(inventory.source_link_scope);
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path7) => String(path7)) : [];
   const duplicateSourceLinkCount = numberValue(inventory.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope ?? null,
+    source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -8981,6 +8987,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path8 = route.trim();
+      return path8 ? { path: path8 } : void 0;
+    }
+    if (!isRecord(route)) return void 0;
+    const path7 = stringValue2(route.path);
+    if (!path7) return void 0;
+    const name = stringValue2(route.name);
+    return name ? { name, path: path7 } : { path: path7 };
+  }).filter((route) => Boolean(route));
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -9582,7 +9602,10 @@ function assessCheckFromEvidence(check, evidence) {
         type: check.type,
         label: checkLabel(check),
         status: "failed",
-        evidence: { expected_count: check.expected_routes?.length || 0 },
+        evidence: {
+          expected_count: check.expected_routes?.length || 0,
+          expected_routes: routeInventoryExpectedRouteSummaries(void 0, check.expected_routes)
+        },
         message: "No route inventory evidence was captured."
       };
     }
@@ -9593,14 +9616,22 @@ function assessCheckFromEvidence(check, evidence) {
     const clickthroughs = Array.isArray(first?.clickthroughs) ? first.clickthroughs : [];
     const sourceLinkCount = numberValue(first?.source_link_count) ?? numberValue(first?.home_game_link_count) ?? null;
     const sourceUniqueLinkCount = numberValue(first?.source_unique_link_count) ?? numberValue(first?.home_unique_game_link_count) ?? null;
+    const sourceCandidateCount = numberValue(first?.source_candidate_count);
+    const sourceCandidateUniqueLinkCount = numberValue(first?.source_candidate_unique_link_count);
+    const sourceLinkScope = stringValue2(first?.source_link_scope);
     const duplicateSourceLinks = Array.isArray(first?.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path7) => String(path7)) : [];
     const duplicateSourceLinkCount = numberValue(first?.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
+    const expectedRoutes = routeInventoryExpectedRouteSummaries(first?.expected_routes, check.expected_routes);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
+        expected_routes: expectedRoutes,
+        source_link_scope: sourceLinkScope ?? null,
+        source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+        source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
         source_link_count: sourceLinkCount,
         source_unique_link_count: sourceUniqueLinkCount,
         duplicate_source_link_count: duplicateSourceLinkCount,
@@ -10577,11 +10608,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = typeof inventory.source_link_count === "number" ? inventory.source_link_count : typeof inventory.home_game_link_count === "number" ? inventory.home_game_link_count : null;
   const sourceUniqueLinkCount = typeof inventory.source_unique_link_count === "number" ? inventory.source_unique_link_count : typeof inventory.home_unique_game_link_count === "number" ? inventory.home_unique_game_link_count : null;
+  const sourceCandidateCount = typeof inventory.source_candidate_count === "number" ? inventory.source_candidate_count : null;
+  const sourceCandidateUniqueLinkCount = typeof inventory.source_candidate_unique_link_count === "number" ? inventory.source_candidate_unique_link_count : null;
+  const sourceLinkScope = typeof inventory.source_link_scope === "string" ? inventory.source_link_scope : null;
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
   const duplicateSourceLinkCount = typeof inventory.duplicate_source_link_count === "number" ? inventory.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -10591,6 +10628,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length,
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path = route.trim();
+      return path ? { path } : null;
+    }
+    if (!route || typeof route !== "object" || Array.isArray(route)) return null;
+    const path = typeof route.path === "string" && route.path.trim() ? route.path.trim() : "";
+    if (!path) return null;
+    const name = typeof route.name === "string" && route.name.trim() ? route.name.trim() : "";
+    return name ? { name, path } : { path };
+  }).filter(Boolean);
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -11418,7 +11469,10 @@ function assessProfile(profile, evidence) {
           type: check.type,
           label: check.label || check.type,
           status: "failed",
-          evidence: { expected_count: (check.expected_routes || []).length },
+          evidence: {
+            expected_count: (check.expected_routes || []).length,
+            expected_routes: routeInventoryExpectedRouteSummaries(undefined, check.expected_routes),
+          },
           message: "No route inventory evidence was captured.",
         });
         continue;
@@ -11435,14 +11489,22 @@ function assessProfile(profile, evidence) {
       const clickthroughs = Array.isArray(first.clickthroughs) ? first.clickthroughs : [];
       const sourceLinkCount = typeof first.source_link_count === "number" ? first.source_link_count : typeof first.home_game_link_count === "number" ? first.home_game_link_count : null;
       const sourceUniqueLinkCount = typeof first.source_unique_link_count === "number" ? first.source_unique_link_count : typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null;
+      const sourceCandidateCount = typeof first.source_candidate_count === "number" ? first.source_candidate_count : null;
+      const sourceCandidateUniqueLinkCount = typeof first.source_candidate_unique_link_count === "number" ? first.source_candidate_unique_link_count : null;
+      const sourceLinkScope = typeof first.source_link_scope === "string" ? first.source_link_scope : null;
       const duplicateSourceLinks = Array.isArray(first.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
       const duplicateSourceLinkCount = typeof first.duplicate_source_link_count === "number" ? first.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
+      const expectedRoutes = routeInventoryExpectedRouteSummaries(first.expected_routes, check.expected_routes);
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
+          expected_routes: expectedRoutes,
+          source_link_scope: sourceLinkScope,
+          source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+          source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
           source_link_count: sourceLinkCount,
           source_unique_link_count: sourceUniqueLinkCount,
           duplicate_source_link_count: duplicateSourceLinkCount,
@@ -13614,9 +13676,15 @@ async function collectInventoryHomeLinks(check) {
         app_path: appPath,
       };
     });
-    return links.filter((link) => (
+    const selectedLinks = links.filter((link) => (
       routePathPrefix ? link.app_path.startsWith(routePathPrefix) : expectedSet.has(link.app_path)
     ));
+    return {
+      links: selectedLinks,
+      candidate_count: links.length,
+      candidate_unique_link_count: Array.from(new Set(links.map((link) => link.app_path))).length,
+      source_link_scope: routePathPrefix ? "route_path_prefix" : "expected_routes",
+    };
   }, { linkSelector, expectedPaths, routePathPrefix, targetUrl });
 }
 async function waitForInventoryRouteHealth(check, expectedPath) {
@@ -13757,7 +13825,11 @@ async function collectRouteInventory(check, viewport) {
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
   const expectedSet = new Set(expectedPaths);
   const failures = [];
-  const homeLinks = await collectInventoryHomeLinks(check);
+  const homeLinkCapture = await collectInventoryHomeLinks(check);
+  const homeLinks = Array.isArray(homeLinkCapture) ? homeLinkCapture : Array.isArray(homeLinkCapture && homeLinkCapture.links) ? homeLinkCapture.links : [];
+  const sourceCandidateCount = typeof homeLinkCapture?.candidate_count === "number" ? homeLinkCapture.candidate_count : homeLinks.length;
+  const sourceCandidateUniqueLinkCount = typeof homeLinkCapture?.candidate_unique_link_count === "number" ? homeLinkCapture.candidate_unique_link_count : new Set(homeLinks.map((link) => link.app_path)).size;
+  const sourceLinkScope = typeof homeLinkCapture?.source_link_scope === "string" ? homeLinkCapture.source_link_scope : check.route_path_prefix ? "route_path_prefix" : "expected_routes";
   const homeLinkPaths = homeLinks.map((link) => link.app_path);
   const uniqueHomeLinkPaths = Array.from(new Set(homeLinkPaths));
   const duplicateHomeLinkPaths = homeLinkPaths.filter((path, index) => homeLinkPaths.indexOf(path) !== index);
@@ -13839,6 +13911,9 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount,
     source_link_count: homeLinkPaths.length,
     source_unique_link_count: uniqueHomeLinkPaths.length,
     duplicate_source_link_count: duplicateHomeLinkPaths.length,
@@ -14035,6 +14110,9 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_scope: routeInventoryCheck.route_path_prefix ? "route_path_prefix" : "expected_routes",
+        source_candidate_count: 0,
+        source_candidate_unique_link_count: 0,
         source_link_count: 0,
         source_unique_link_count: 0,
         duplicate_source_link_count: 0,
@@ -14161,6 +14239,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          source_link_scope: viewport.route_inventory.source_link_scope,
+          source_candidate_count: viewport.route_inventory.source_candidate_count,
+          source_candidate_unique_link_count: viewport.route_inventory.source_candidate_unique_link_count,
           source_link_count: viewport.route_inventory.source_link_count == null ? viewport.route_inventory.home_game_link_count : viewport.route_inventory.source_link_count,
           source_unique_link_count: viewport.route_inventory.source_unique_link_count == null ? viewport.route_inventory.home_unique_game_link_count : viewport.route_inventory.source_unique_link_count,
           duplicate_source_link_count: viewport.route_inventory.duplicate_source_link_count,
@@ -14820,6 +14901,35 @@ function cliValueLabel(value) {
 function cliStringArray(value) {
   return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
 }
+function cliRouteInventoryRoutes(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((entry) => {
+    if (typeof entry === "string") {
+      const pathValue2 = entry.trim();
+      return pathValue2 ? { path: pathValue2 } : void 0;
+    }
+    const route = cliRecord(entry);
+    if (!route) return void 0;
+    const pathValue = cliString(route.path);
+    if (!pathValue) return void 0;
+    const nameValue = cliString(route.name);
+    return nameValue ? { name: nameValue, path: pathValue } : { path: pathValue };
+  }).filter((route) => Boolean(route));
+}
+function cliRouteInventoryRouteLabel(route) {
+  return route.name && route.name !== route.path ? `${route.name} (${route.path})` : route.path;
+}
+function cliRouteInventoryRouteList(routes) {
+  const visible = routes.slice(0, 12).map(cliRouteInventoryRouteLabel);
+  const omitted = routes.length > 12 ? `; ${routes.length - 12} more` : "";
+  return `${visible.join("; ")}${omitted}`;
+}
+function cliRouteInventorySourceScopeLabel(value) {
+  const scope = cliString(value);
+  if (scope === "expected_routes") return "expected routes";
+  if (scope === "route_path_prefix") return "route path prefix";
+  return scope;
+}
 function profileEnvironmentBlockerMarkdown(result) {
   const blocker = cliRecord(result.environment_blocker);
   if (!blocker) return [];
@@ -15048,6 +15158,9 @@ function profileRouteInventorySummaryMarkdown(result) {
     const expectedCount = cliFiniteNumber(evidence.expected_count);
     const sourceLinkCount = cliFiniteNumber(evidence.source_link_count);
     const sourceUniqueLinkCount = cliFiniteNumber(evidence.source_unique_link_count);
+    const sourceCandidateCount = cliFiniteNumber(evidence.source_candidate_count);
+    const sourceCandidateUniqueLinkCount = cliFiniteNumber(evidence.source_candidate_unique_link_count);
+    const sourceScopeLabel = cliRouteInventorySourceScopeLabel(evidence.source_link_scope);
     const directRouteCount = cliFiniteNumber(evidence.direct_route_count);
     const clickthroughCount = cliFiniteNumber(evidence.clickthrough_count);
     const topLevelFailures = Array.isArray(evidence.failures) ? evidence.failures.length : void 0;
@@ -15063,15 +15176,25 @@ function profileRouteInventorySummaryMarkdown(result) {
       const duplicateText = duplicateLinks.length ? `: ${duplicateLinks.slice(0, 8).join(", ")}${duplicateLinks.length > 8 ? `, ${duplicateLinks.length - 8} more` : ""}` : "";
       lines.push(`- ${label} duplicate source links: ${duplicateCount}${evidence.duplicates_allowed === true ? " allowed" : ""}${duplicateText}`);
     }
+    const expectedRoutes = cliRouteInventoryRoutes(evidence.expected_routes);
+    if (expectedRoutes.length) {
+      lines.push(`- ${label} expected routes: ${cliRouteInventoryRouteList(expectedRoutes)}`);
+    }
+    if (sourceScopeLabel || sourceCandidateCount !== void 0) {
+      const candidateText = sourceCandidateCount === void 0 ? "" : `; selector candidates ${sourceCandidateCount}${sourceCandidateUniqueLinkCount === void 0 ? "" : ` (${sourceCandidateUniqueLinkCount} unique)`}`;
+      lines.push(`- ${label} source scope: ${sourceScopeLabel || "unknown"}${candidateText}`);
+    }
     for (const viewport of viewports.slice(0, 8)) {
       const viewportName = cliString(viewport.viewport) || cliString(viewport.name) || "viewport";
       const viewportSourceLinkCount = cliFiniteNumber(viewport.source_link_count);
       const viewportSourceUniqueLinkCount = cliFiniteNumber(viewport.source_unique_link_count);
+      const viewportSourceCandidateCount = cliFiniteNumber(viewport.source_candidate_count);
+      const viewportSourceCandidateUniqueLinkCount = cliFiniteNumber(viewport.source_candidate_unique_link_count);
       const viewportDirectRouteCount = cliFiniteNumber(viewport.direct_route_count);
       const viewportClickthroughCount = cliFiniteNumber(viewport.clickthrough_count);
       const viewportFailureCount = cliFiniteNumber(viewport.failure_count) || 0;
       lines.push(
-        `- ${label} ${viewportName}: source ${viewportSourceLinkCount ?? "unknown"}${viewportSourceUniqueLinkCount === void 0 ? "" : ` (${viewportSourceUniqueLinkCount} unique)`}, direct ${viewportDirectRouteCount ?? "unknown"}, clickthrough ${viewportClickthroughCount ?? "unknown"}, failures ${viewportFailureCount}`
+        `- ${label} ${viewportName}: source ${viewportSourceLinkCount ?? "unknown"}${viewportSourceUniqueLinkCount === void 0 ? "" : ` (${viewportSourceUniqueLinkCount} unique)`}${viewportSourceCandidateCount === void 0 ? "" : `, selector candidates ${viewportSourceCandidateCount}${viewportSourceCandidateUniqueLinkCount === void 0 ? "" : ` (${viewportSourceCandidateUniqueLinkCount} unique)`}`}, direct ${viewportDirectRouteCount ?? "unknown"}, clickthrough ${viewportClickthroughCount ?? "unknown"}, failures ${viewportFailureCount}`
       );
     }
     if (viewports.length > 8) lines.push(`- ${label}: ${viewports.length - 8} additional viewport(s) omitted from route inventory summary.`);

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-66RDQVFI.js";
+} from "./chunk-ZC6AK3D3.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -567,6 +567,35 @@ function cliValueLabel(value) {
 function cliStringArray(value) {
   return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
 }
+function cliRouteInventoryRoutes(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((entry) => {
+    if (typeof entry === "string") {
+      const pathValue2 = entry.trim();
+      return pathValue2 ? { path: pathValue2 } : void 0;
+    }
+    const route = cliRecord(entry);
+    if (!route) return void 0;
+    const pathValue = cliString(route.path);
+    if (!pathValue) return void 0;
+    const nameValue = cliString(route.name);
+    return nameValue ? { name: nameValue, path: pathValue } : { path: pathValue };
+  }).filter((route) => Boolean(route));
+}
+function cliRouteInventoryRouteLabel(route) {
+  return route.name && route.name !== route.path ? `${route.name} (${route.path})` : route.path;
+}
+function cliRouteInventoryRouteList(routes) {
+  const visible = routes.slice(0, 12).map(cliRouteInventoryRouteLabel);
+  const omitted = routes.length > 12 ? `; ${routes.length - 12} more` : "";
+  return `${visible.join("; ")}${omitted}`;
+}
+function cliRouteInventorySourceScopeLabel(value) {
+  const scope = cliString(value);
+  if (scope === "expected_routes") return "expected routes";
+  if (scope === "route_path_prefix") return "route path prefix";
+  return scope;
+}
 function profileEnvironmentBlockerMarkdown(result) {
   const blocker = cliRecord(result.environment_blocker);
   if (!blocker) return [];
@@ -795,6 +824,9 @@ function profileRouteInventorySummaryMarkdown(result) {
     const expectedCount = cliFiniteNumber(evidence.expected_count);
     const sourceLinkCount = cliFiniteNumber(evidence.source_link_count);
     const sourceUniqueLinkCount = cliFiniteNumber(evidence.source_unique_link_count);
+    const sourceCandidateCount = cliFiniteNumber(evidence.source_candidate_count);
+    const sourceCandidateUniqueLinkCount = cliFiniteNumber(evidence.source_candidate_unique_link_count);
+    const sourceScopeLabel = cliRouteInventorySourceScopeLabel(evidence.source_link_scope);
     const directRouteCount = cliFiniteNumber(evidence.direct_route_count);
     const clickthroughCount = cliFiniteNumber(evidence.clickthrough_count);
     const topLevelFailures = Array.isArray(evidence.failures) ? evidence.failures.length : void 0;
@@ -810,15 +842,25 @@ function profileRouteInventorySummaryMarkdown(result) {
       const duplicateText = duplicateLinks.length ? `: ${duplicateLinks.slice(0, 8).join(", ")}${duplicateLinks.length > 8 ? `, ${duplicateLinks.length - 8} more` : ""}` : "";
       lines.push(`- ${label} duplicate source links: ${duplicateCount}${evidence.duplicates_allowed === true ? " allowed" : ""}${duplicateText}`);
     }
+    const expectedRoutes = cliRouteInventoryRoutes(evidence.expected_routes);
+    if (expectedRoutes.length) {
+      lines.push(`- ${label} expected routes: ${cliRouteInventoryRouteList(expectedRoutes)}`);
+    }
+    if (sourceScopeLabel || sourceCandidateCount !== void 0) {
+      const candidateText = sourceCandidateCount === void 0 ? "" : `; selector candidates ${sourceCandidateCount}${sourceCandidateUniqueLinkCount === void 0 ? "" : ` (${sourceCandidateUniqueLinkCount} unique)`}`;
+      lines.push(`- ${label} source scope: ${sourceScopeLabel || "unknown"}${candidateText}`);
+    }
     for (const viewport of viewports.slice(0, 8)) {
       const viewportName = cliString(viewport.viewport) || cliString(viewport.name) || "viewport";
       const viewportSourceLinkCount = cliFiniteNumber(viewport.source_link_count);
       const viewportSourceUniqueLinkCount = cliFiniteNumber(viewport.source_unique_link_count);
+      const viewportSourceCandidateCount = cliFiniteNumber(viewport.source_candidate_count);
+      const viewportSourceCandidateUniqueLinkCount = cliFiniteNumber(viewport.source_candidate_unique_link_count);
       const viewportDirectRouteCount = cliFiniteNumber(viewport.direct_route_count);
       const viewportClickthroughCount = cliFiniteNumber(viewport.clickthrough_count);
       const viewportFailureCount = cliFiniteNumber(viewport.failure_count) || 0;
       lines.push(
-        `- ${label} ${viewportName}: source ${viewportSourceLinkCount ?? "unknown"}${viewportSourceUniqueLinkCount === void 0 ? "" : ` (${viewportSourceUniqueLinkCount} unique)`}, direct ${viewportDirectRouteCount ?? "unknown"}, clickthrough ${viewportClickthroughCount ?? "unknown"}, failures ${viewportFailureCount}`
+        `- ${label} ${viewportName}: source ${viewportSourceLinkCount ?? "unknown"}${viewportSourceUniqueLinkCount === void 0 ? "" : ` (${viewportSourceUniqueLinkCount} unique)`}${viewportSourceCandidateCount === void 0 ? "" : `, selector candidates ${viewportSourceCandidateCount}${viewportSourceCandidateUniqueLinkCount === void 0 ? "" : ` (${viewportSourceCandidateUniqueLinkCount} unique)`}`}, direct ${viewportDirectRouteCount ?? "unknown"}, clickthrough ${viewportClickthroughCount ?? "unknown"}, failures ${viewportFailureCount}`
       );
     }
     if (viewports.length > 8) lines.push(`- ${label}: ${viewports.length - 8} additional viewport(s) omitted from route inventory summary.`);

package/dist/index.cjs

@@ -10763,11 +10763,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = numberValue3(inventory.source_link_count) ?? numberValue3(inventory.home_game_link_count) ?? null;
   const sourceUniqueLinkCount = numberValue3(inventory.source_unique_link_count) ?? numberValue3(inventory.home_unique_game_link_count) ?? null;
+  const sourceCandidateCount = numberValue3(inventory.source_candidate_count);
+  const sourceCandidateUniqueLinkCount = numberValue3(inventory.source_candidate_unique_link_count);
+  const sourceLinkScope = stringValue5(inventory.source_link_scope);
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path6) => String(path6)) : [];
   const duplicateSourceLinkCount = numberValue3(inventory.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope ?? null,
+    source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -10777,6 +10783,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path7 = route.trim();
+      return path7 ? { path: path7 } : void 0;
+    }
+    if (!isRecord2(route)) return void 0;
+    const path6 = stringValue5(route.path);
+    if (!path6) return void 0;
+    const name = stringValue5(route.name);
+    return name ? { name, path: path6 } : { path: path6 };
+  }).filter((route) => Boolean(route));
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -11378,7 +11398,10 @@ function assessCheckFromEvidence(check, evidence) {
         type: check.type,
         label: checkLabel(check),
         status: "failed",
-        evidence: { expected_count: check.expected_routes?.length || 0 },
+        evidence: {
+          expected_count: check.expected_routes?.length || 0,
+          expected_routes: routeInventoryExpectedRouteSummaries(void 0, check.expected_routes)
+        },
         message: "No route inventory evidence was captured."
       };
     }
@@ -11389,14 +11412,22 @@ function assessCheckFromEvidence(check, evidence) {
     const clickthroughs = Array.isArray(first?.clickthroughs) ? first.clickthroughs : [];
     const sourceLinkCount = numberValue3(first?.source_link_count) ?? numberValue3(first?.home_game_link_count) ?? null;
     const sourceUniqueLinkCount = numberValue3(first?.source_unique_link_count) ?? numberValue3(first?.home_unique_game_link_count) ?? null;
+    const sourceCandidateCount = numberValue3(first?.source_candidate_count);
+    const sourceCandidateUniqueLinkCount = numberValue3(first?.source_candidate_unique_link_count);
+    const sourceLinkScope = stringValue5(first?.source_link_scope);
     const duplicateSourceLinks = Array.isArray(first?.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path6) => String(path6)) : [];
     const duplicateSourceLinkCount = numberValue3(first?.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
+    const expectedRoutes = routeInventoryExpectedRouteSummaries(first?.expected_routes, check.expected_routes);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
+        expected_routes: expectedRoutes,
+        source_link_scope: sourceLinkScope ?? null,
+        source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+        source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
         source_link_count: sourceLinkCount,
         source_unique_link_count: sourceUniqueLinkCount,
         duplicate_source_link_count: duplicateSourceLinkCount,
@@ -12389,11 +12420,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = typeof inventory.source_link_count === "number" ? inventory.source_link_count : typeof inventory.home_game_link_count === "number" ? inventory.home_game_link_count : null;
   const sourceUniqueLinkCount = typeof inventory.source_unique_link_count === "number" ? inventory.source_unique_link_count : typeof inventory.home_unique_game_link_count === "number" ? inventory.home_unique_game_link_count : null;
+  const sourceCandidateCount = typeof inventory.source_candidate_count === "number" ? inventory.source_candidate_count : null;
+  const sourceCandidateUniqueLinkCount = typeof inventory.source_candidate_unique_link_count === "number" ? inventory.source_candidate_unique_link_count : null;
+  const sourceLinkScope = typeof inventory.source_link_scope === "string" ? inventory.source_link_scope : null;
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
   const duplicateSourceLinkCount = typeof inventory.duplicate_source_link_count === "number" ? inventory.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -12403,6 +12440,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length,
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path = route.trim();
+      return path ? { path } : null;
+    }
+    if (!route || typeof route !== "object" || Array.isArray(route)) return null;
+    const path = typeof route.path === "string" && route.path.trim() ? route.path.trim() : "";
+    if (!path) return null;
+    const name = typeof route.name === "string" && route.name.trim() ? route.name.trim() : "";
+    return name ? { name, path } : { path };
+  }).filter(Boolean);
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -13230,7 +13281,10 @@ function assessProfile(profile, evidence) {
           type: check.type,
           label: check.label || check.type,
           status: "failed",
-          evidence: { expected_count: (check.expected_routes || []).length },
+          evidence: {
+            expected_count: (check.expected_routes || []).length,
+            expected_routes: routeInventoryExpectedRouteSummaries(undefined, check.expected_routes),
+          },
           message: "No route inventory evidence was captured.",
         });
         continue;
@@ -13247,14 +13301,22 @@ function assessProfile(profile, evidence) {
       const clickthroughs = Array.isArray(first.clickthroughs) ? first.clickthroughs : [];
       const sourceLinkCount = typeof first.source_link_count === "number" ? first.source_link_count : typeof first.home_game_link_count === "number" ? first.home_game_link_count : null;
       const sourceUniqueLinkCount = typeof first.source_unique_link_count === "number" ? first.source_unique_link_count : typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null;
+      const sourceCandidateCount = typeof first.source_candidate_count === "number" ? first.source_candidate_count : null;
+      const sourceCandidateUniqueLinkCount = typeof first.source_candidate_unique_link_count === "number" ? first.source_candidate_unique_link_count : null;
+      const sourceLinkScope = typeof first.source_link_scope === "string" ? first.source_link_scope : null;
       const duplicateSourceLinks = Array.isArray(first.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
       const duplicateSourceLinkCount = typeof first.duplicate_source_link_count === "number" ? first.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
+      const expectedRoutes = routeInventoryExpectedRouteSummaries(first.expected_routes, check.expected_routes);
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
+          expected_routes: expectedRoutes,
+          source_link_scope: sourceLinkScope,
+          source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+          source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
           source_link_count: sourceLinkCount,
           source_unique_link_count: sourceUniqueLinkCount,
           duplicate_source_link_count: duplicateSourceLinkCount,
@@ -15426,9 +15488,15 @@ async function collectInventoryHomeLinks(check) {
         app_path: appPath,
       };
     });
-    return links.filter((link) => (
+    const selectedLinks = links.filter((link) => (
       routePathPrefix ? link.app_path.startsWith(routePathPrefix) : expectedSet.has(link.app_path)
     ));
+    return {
+      links: selectedLinks,
+      candidate_count: links.length,
+      candidate_unique_link_count: Array.from(new Set(links.map((link) => link.app_path))).length,
+      source_link_scope: routePathPrefix ? "route_path_prefix" : "expected_routes",
+    };
   }, { linkSelector, expectedPaths, routePathPrefix, targetUrl });
 }
 async function waitForInventoryRouteHealth(check, expectedPath) {
@@ -15569,7 +15637,11 @@ async function collectRouteInventory(check, viewport) {
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
   const expectedSet = new Set(expectedPaths);
   const failures = [];
-  const homeLinks = await collectInventoryHomeLinks(check);
+  const homeLinkCapture = await collectInventoryHomeLinks(check);
+  const homeLinks = Array.isArray(homeLinkCapture) ? homeLinkCapture : Array.isArray(homeLinkCapture && homeLinkCapture.links) ? homeLinkCapture.links : [];
+  const sourceCandidateCount = typeof homeLinkCapture?.candidate_count === "number" ? homeLinkCapture.candidate_count : homeLinks.length;
+  const sourceCandidateUniqueLinkCount = typeof homeLinkCapture?.candidate_unique_link_count === "number" ? homeLinkCapture.candidate_unique_link_count : new Set(homeLinks.map((link) => link.app_path)).size;
+  const sourceLinkScope = typeof homeLinkCapture?.source_link_scope === "string" ? homeLinkCapture.source_link_scope : check.route_path_prefix ? "route_path_prefix" : "expected_routes";
   const homeLinkPaths = homeLinks.map((link) => link.app_path);
   const uniqueHomeLinkPaths = Array.from(new Set(homeLinkPaths));
   const duplicateHomeLinkPaths = homeLinkPaths.filter((path, index) => homeLinkPaths.indexOf(path) !== index);
@@ -15651,6 +15723,9 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount,
     source_link_count: homeLinkPaths.length,
     source_unique_link_count: uniqueHomeLinkPaths.length,
     duplicate_source_link_count: duplicateHomeLinkPaths.length,
@@ -15847,6 +15922,9 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_scope: routeInventoryCheck.route_path_prefix ? "route_path_prefix" : "expected_routes",
+        source_candidate_count: 0,
+        source_candidate_unique_link_count: 0,
         source_link_count: 0,
         source_unique_link_count: 0,
         duplicate_source_link_count: 0,
@@ -15973,6 +16051,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          source_link_scope: viewport.route_inventory.source_link_scope,
+          source_candidate_count: viewport.route_inventory.source_candidate_count,
+          source_candidate_unique_link_count: viewport.route_inventory.source_candidate_unique_link_count,
           source_link_count: viewport.route_inventory.source_link_count == null ? viewport.route_inventory.home_game_link_count : viewport.route_inventory.source_link_count,
           source_unique_link_count: viewport.route_inventory.source_unique_link_count == null ? viewport.route_inventory.home_unique_game_link_count : viewport.route_inventory.source_unique_link_count,
           duplicate_source_link_count: viewport.route_inventory.duplicate_source_link_count,

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-66RDQVFI.js";
+} from "./chunk-ZC6AK3D3.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -2077,11 +2077,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = numberValue(inventory.source_link_count) ?? numberValue(inventory.home_game_link_count) ?? null;
   const sourceUniqueLinkCount = numberValue(inventory.source_unique_link_count) ?? numberValue(inventory.home_unique_game_link_count) ?? null;
+  const sourceCandidateCount = numberValue(inventory.source_candidate_count);
+  const sourceCandidateUniqueLinkCount = numberValue(inventory.source_candidate_unique_link_count);
+  const sourceLinkScope = stringValue(inventory.source_link_scope);
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
   const duplicateSourceLinkCount = numberValue(inventory.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope ?? null,
+    source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -2091,6 +2097,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path2 = route.trim();
+      return path2 ? { path: path2 } : void 0;
+    }
+    if (!isRecord(route)) return void 0;
+    const path = stringValue(route.path);
+    if (!path) return void 0;
+    const name = stringValue(route.name);
+    return name ? { name, path } : { path };
+  }).filter((route) => Boolean(route));
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -2692,7 +2712,10 @@ function assessCheckFromEvidence(check, evidence) {
         type: check.type,
         label: checkLabel(check),
         status: "failed",
-        evidence: { expected_count: check.expected_routes?.length || 0 },
+        evidence: {
+          expected_count: check.expected_routes?.length || 0,
+          expected_routes: routeInventoryExpectedRouteSummaries(void 0, check.expected_routes)
+        },
         message: "No route inventory evidence was captured."
       };
     }
@@ -2703,14 +2726,22 @@ function assessCheckFromEvidence(check, evidence) {
     const clickthroughs = Array.isArray(first?.clickthroughs) ? first.clickthroughs : [];
     const sourceLinkCount = numberValue(first?.source_link_count) ?? numberValue(first?.home_game_link_count) ?? null;
     const sourceUniqueLinkCount = numberValue(first?.source_unique_link_count) ?? numberValue(first?.home_unique_game_link_count) ?? null;
+    const sourceCandidateCount = numberValue(first?.source_candidate_count);
+    const sourceCandidateUniqueLinkCount = numberValue(first?.source_candidate_unique_link_count);
+    const sourceLinkScope = stringValue(first?.source_link_scope);
     const duplicateSourceLinks = Array.isArray(first?.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
     const duplicateSourceLinkCount = numberValue(first?.duplicate_source_link_count) ?? (sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null);
+    const expectedRoutes = routeInventoryExpectedRouteSummaries(first?.expected_routes, check.expected_routes);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
+        expected_routes: expectedRoutes,
+        source_link_scope: sourceLinkScope ?? null,
+        source_candidate_count: sourceCandidateCount ?? sourceLinkCount,
+        source_candidate_unique_link_count: sourceCandidateUniqueLinkCount ?? sourceUniqueLinkCount,
         source_link_count: sourceLinkCount,
         source_unique_link_count: sourceUniqueLinkCount,
         duplicate_source_link_count: duplicateSourceLinkCount,
@@ -3703,11 +3734,17 @@ function summarizeRouteInventory(viewport, inventory) {
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
   const sourceLinkCount = typeof inventory.source_link_count === "number" ? inventory.source_link_count : typeof inventory.home_game_link_count === "number" ? inventory.home_game_link_count : null;
   const sourceUniqueLinkCount = typeof inventory.source_unique_link_count === "number" ? inventory.source_unique_link_count : typeof inventory.home_unique_game_link_count === "number" ? inventory.home_unique_game_link_count : null;
+  const sourceCandidateCount = typeof inventory.source_candidate_count === "number" ? inventory.source_candidate_count : null;
+  const sourceCandidateUniqueLinkCount = typeof inventory.source_candidate_unique_link_count === "number" ? inventory.source_candidate_unique_link_count : null;
+  const sourceLinkScope = typeof inventory.source_link_scope === "string" ? inventory.source_link_scope : null;
   const duplicateSourceLinks = Array.isArray(inventory.duplicate_source_link_paths) ? inventory.duplicate_source_link_paths.map((path) => String(path)) : [];
   const duplicateSourceLinkCount = typeof inventory.duplicate_source_link_count === "number" ? inventory.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
   const failures = Array.isArray(inventory.failures) ? inventory.failures : [];
   return {
     viewport,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
     source_link_count: sourceLinkCount,
     source_unique_link_count: sourceUniqueLinkCount,
     duplicate_source_link_count: duplicateSourceLinkCount,
@@ -3717,6 +3754,20 @@ function summarizeRouteInventory(viewport, inventory) {
     failure_count: failures.length,
   };
 }
+function routeInventoryExpectedRouteSummaries(value, fallback) {
+  const rawRoutes = Array.isArray(value) ? value : Array.isArray(fallback) ? fallback : [];
+  return rawRoutes.map((route) => {
+    if (typeof route === "string") {
+      const path = route.trim();
+      return path ? { path } : null;
+    }
+    if (!route || typeof route !== "object" || Array.isArray(route)) return null;
+    const path = typeof route.path === "string" && route.path.trim() ? route.path.trim() : "";
+    if (!path) return null;
+    const name = typeof route.name === "string" && route.name.trim() ? route.name.trim() : "";
+    return name ? { name, path } : { path };
+  }).filter(Boolean);
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -4544,7 +4595,10 @@ function assessProfile(profile, evidence) {
           type: check.type,
           label: check.label || check.type,
           status: "failed",
-          evidence: { expected_count: (check.expected_routes || []).length },
+          evidence: {
+            expected_count: (check.expected_routes || []).length,
+            expected_routes: routeInventoryExpectedRouteSummaries(undefined, check.expected_routes),
+          },
           message: "No route inventory evidence was captured.",
         });
         continue;
@@ -4561,14 +4615,22 @@ function assessProfile(profile, evidence) {
       const clickthroughs = Array.isArray(first.clickthroughs) ? first.clickthroughs : [];
       const sourceLinkCount = typeof first.source_link_count === "number" ? first.source_link_count : typeof first.home_game_link_count === "number" ? first.home_game_link_count : null;
       const sourceUniqueLinkCount = typeof first.source_unique_link_count === "number" ? first.source_unique_link_count : typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null;
+      const sourceCandidateCount = typeof first.source_candidate_count === "number" ? first.source_candidate_count : null;
+      const sourceCandidateUniqueLinkCount = typeof first.source_candidate_unique_link_count === "number" ? first.source_candidate_unique_link_count : null;
+      const sourceLinkScope = typeof first.source_link_scope === "string" ? first.source_link_scope : null;
       const duplicateSourceLinks = Array.isArray(first.duplicate_source_link_paths) ? first.duplicate_source_link_paths.map((path) => String(path)) : [];
       const duplicateSourceLinkCount = typeof first.duplicate_source_link_count === "number" ? first.duplicate_source_link_count : sourceLinkCount !== null && sourceUniqueLinkCount !== null ? Math.max(0, sourceLinkCount - sourceUniqueLinkCount) : null;
+      const expectedRoutes = routeInventoryExpectedRouteSummaries(first.expected_routes, check.expected_routes);
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
+          expected_routes: expectedRoutes,
+          source_link_scope: sourceLinkScope,
+          source_candidate_count: sourceCandidateCount == null ? sourceLinkCount : sourceCandidateCount,
+          source_candidate_unique_link_count: sourceCandidateUniqueLinkCount == null ? sourceUniqueLinkCount : sourceCandidateUniqueLinkCount,
           source_link_count: sourceLinkCount,
           source_unique_link_count: sourceUniqueLinkCount,
           duplicate_source_link_count: duplicateSourceLinkCount,
@@ -6740,9 +6802,15 @@ async function collectInventoryHomeLinks(check) {
         app_path: appPath,
       };
     });
-    return links.filter((link) => (
+    const selectedLinks = links.filter((link) => (
       routePathPrefix ? link.app_path.startsWith(routePathPrefix) : expectedSet.has(link.app_path)
     ));
+    return {
+      links: selectedLinks,
+      candidate_count: links.length,
+      candidate_unique_link_count: Array.from(new Set(links.map((link) => link.app_path))).length,
+      source_link_scope: routePathPrefix ? "route_path_prefix" : "expected_routes",
+    };
   }, { linkSelector, expectedPaths, routePathPrefix, targetUrl });
 }
 async function waitForInventoryRouteHealth(check, expectedPath) {
@@ -6883,7 +6951,11 @@ async function collectRouteInventory(check, viewport) {
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
   const expectedSet = new Set(expectedPaths);
   const failures = [];
-  const homeLinks = await collectInventoryHomeLinks(check);
+  const homeLinkCapture = await collectInventoryHomeLinks(check);
+  const homeLinks = Array.isArray(homeLinkCapture) ? homeLinkCapture : Array.isArray(homeLinkCapture && homeLinkCapture.links) ? homeLinkCapture.links : [];
+  const sourceCandidateCount = typeof homeLinkCapture?.candidate_count === "number" ? homeLinkCapture.candidate_count : homeLinks.length;
+  const sourceCandidateUniqueLinkCount = typeof homeLinkCapture?.candidate_unique_link_count === "number" ? homeLinkCapture.candidate_unique_link_count : new Set(homeLinks.map((link) => link.app_path)).size;
+  const sourceLinkScope = typeof homeLinkCapture?.source_link_scope === "string" ? homeLinkCapture.source_link_scope : check.route_path_prefix ? "route_path_prefix" : "expected_routes";
   const homeLinkPaths = homeLinks.map((link) => link.app_path);
   const uniqueHomeLinkPaths = Array.from(new Set(homeLinkPaths));
   const duplicateHomeLinkPaths = homeLinkPaths.filter((path, index) => homeLinkPaths.indexOf(path) !== index);
@@ -6965,6 +7037,9 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_scope: sourceLinkScope,
+    source_candidate_count: sourceCandidateCount,
+    source_candidate_unique_link_count: sourceCandidateUniqueLinkCount,
     source_link_count: homeLinkPaths.length,
     source_unique_link_count: uniqueHomeLinkPaths.length,
     duplicate_source_link_count: duplicateHomeLinkPaths.length,
@@ -7161,6 +7236,9 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_scope: routeInventoryCheck.route_path_prefix ? "route_path_prefix" : "expected_routes",
+        source_candidate_count: 0,
+        source_candidate_unique_link_count: 0,
         source_link_count: 0,
         source_unique_link_count: 0,
         duplicate_source_link_count: 0,
@@ -7287,6 +7365,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          source_link_scope: viewport.route_inventory.source_link_scope,
+          source_candidate_count: viewport.route_inventory.source_candidate_count,
+          source_candidate_unique_link_count: viewport.route_inventory.source_candidate_unique_link_count,
           source_link_count: viewport.route_inventory.source_link_count == null ? viewport.route_inventory.home_game_link_count : viewport.route_inventory.source_link_count,
           source_unique_link_count: viewport.route_inventory.source_unique_link_count == null ? viewport.route_inventory.home_unique_game_link_count : viewport.route_inventory.source_unique_link_count,
           duplicate_source_link_count: viewport.route_inventory.duplicate_source_link_count,

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-66RDQVFI.js";
+} from "./chunk-ZC6AK3D3.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/dist/proof-run-engine.d.cts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
+    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.143",
+  "version": "0.7.145",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",