@riddledc/riddle-proof 0.7.33 → 0.7.35

package/README.md

@@ -202,6 +202,21 @@ clears `local`, `session`, or `both` browser storage scopes, defaults to
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`
 still overrides the profile value for one-off runs.
 
+Use `selector_text_order` when a table, list, or card group must show visible
+items in a specific order after setup actions such as sorting or filtering:
+
+```json
+{
+  "type": "selector_text_order",
+  "selector": ".game-table tbody tr",
+  "expected_texts": ["AAA Alpha", "MMM Middle", "ZZZ Omega"]
+}
+```
+
+The check records the visible text sequence for the selector and passes when
+the expected texts appear in that order as a subsequence. This is less brittle
+than matching one large body-text regex when only row or card order matters.
+
 Use the `route_inventory` check for source-page route coverage audits where a
 navigation surface must expose a known set of routes and each route must load
 both directly and through real link clicks:
@@ -220,14 +235,17 @@ both directly and through real link clicks:
 }
 ```
 
-The check records discovered source links, duplicate/missing/unexpected routes,
-direct route health, real clickthrough health, wrong-path failures, and stale
-source-surface failures. It runs direct/clickthrough sweeps on the first
-viewport by default and leaves ordinary profile overflow checks to cover the
-source page across all configured viewports. Set `run_direct_routes: false`,
-`run_clickthroughs: false`, `allow_unexpected_routes: true`, or
+The check records discovered source links, unique source-link counts, duplicate
+source-link counts, missing/unexpected routes, direct route health, real
+clickthrough health, wrong-path failures, and stale source-surface failures. It
+runs direct/clickthrough sweeps on the first viewport by default and leaves
+ordinary profile overflow checks to cover the source page across all configured
+viewports. Set `run_direct_routes: false`, `run_clickthroughs: false`,
+`allow_unexpected_routes: true`, `require_unique_routes: false`, or
 `save_route_screenshots: true` when a profile needs a narrower or more
-artifact-heavy audit.
+artifact-heavy audit. `require_unique_routes: false` is useful when a navigation
+surface intentionally links to the same route from multiple cards or anchors,
+while still proving the unique expected route set.
 
 The result uses `riddle-proof.profile-result.v1` and separates product failures
 from weak proof and environment blockers:

package/dist/{chunk-COUZXKGM.js → chunk-VCINQE5O.js}

@@ -14,6 +14,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "selector_visible",
   "selector_count_at_least",
+  "selector_text_order",
   "text_visible",
   "text_absent",
   "route_inventory",
@@ -293,6 +294,15 @@ function normalizeRouteInventoryRoutes(value, index) {
   }
   return routes;
 }
+function normalizeExpectedTexts(value, index) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`checks[${index}] selector_text_order expected_texts must be a non-empty array.`);
+  }
+  const texts = value.map((item) => String(item).replace(/\s+/g, " ").trim()).filter(Boolean);
+  if (!texts.length) throw new Error(`checks[${index}] selector_text_order expected_texts must contain non-empty strings.`);
+  return texts;
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue(input.type);
@@ -309,6 +319,11 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
+  if (type === "selector_text_order") {
+    if (!stringValue(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
+    if (!expectedTexts?.length) throw new Error(`checks[${index}] selector_text_order requires expected_texts.`);
+  }
   const expectedRoutes = normalizeRouteInventoryRoutes(input.expected_routes ?? input.expectedRoutes, index);
   if (type === "route_inventory" && !expectedRoutes?.length) {
     throw new Error(`checks[${index}] route_inventory requires expected_routes.`);
@@ -319,6 +334,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue(input.expected_path),
     expected_routes: expectedRoutes,
     selector: stringValue(input.selector),
+    expected_texts: expectedTexts,
     link_selector: stringValue(input.link_selector) || stringValue(input.linkSelector),
     source_selector: stringValue(input.source_selector) || stringValue(input.sourceSelector),
     route_path_prefix: stringValue(input.route_path_prefix) || stringValue(input.routePathPrefix),
@@ -424,6 +440,28 @@ function selectorKey(check) {
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
+function textSequenceForCheck(viewport, check) {
+  const key = selectorKey(check);
+  const sequence = viewport.text_sequences?.[key];
+  if (isRecord(sequence)) {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text).replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -543,6 +581,32 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_text_order") {
+    const key = selectorKey(check);
+    const expectedTexts = check.expected_texts || [];
+    const results = viewports.map((viewport) => {
+      const texts = textSequenceForCheck(viewport, check);
+      const match = textOrderMatch(texts, expectedTexts);
+      return {
+        viewport: viewport.name,
+        matched: match.matched,
+        matched_positions: match.positions,
+        visible_texts: texts.slice(0, 20)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_texts: expectedTexts,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Selector ${key} text order failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
@@ -578,14 +642,23 @@ function assessCheckFromEvidence(check, evidence) {
     const first = inventories[0]?.inventory;
     const directRoutes = Array.isArray(first?.direct_routes) ? first.direct_routes : [];
     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 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);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
-        homepage_link_count: numberValue(first?.home_game_link_count) ?? null,
-        homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? null,
+        source_link_count: sourceLinkCount,
+        source_unique_link_count: sourceUniqueLinkCount,
+        duplicate_source_link_count: duplicateSourceLinkCount,
+        duplicate_source_links: duplicateSourceLinks,
+        duplicates_allowed: check.require_unique_routes === false,
+        homepage_link_count: numberValue(first?.home_game_link_count) ?? sourceLinkCount,
+        homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? sourceUniqueLinkCount,
         direct_route_count: directRoutes.length,
         clickthrough_count: clickthroughs.length,
         failures
@@ -884,6 +957,28 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function textSequenceForCheck(viewport, check) {
+  const key = check.selector || "";
+  const sequence = viewport.text_sequences && viewport.text_sequences[key];
+  if (sequence && typeof sequence === "object") {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text || "").replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts || []) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -1088,6 +1183,29 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_text_order") {
+      const selector = check.selector || "";
+      const expectedTexts = check.expected_texts || [];
+      const results = viewports.map((viewport) => {
+        const texts = textSequenceForCheck(viewport, check);
+        const match = textOrderMatch(texts, expectedTexts);
+        return {
+          viewport: viewport.name,
+          matched: match.matched,
+          matched_positions: match.positions,
+          visible_texts: texts.slice(0, 20),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: { selector, expected_texts: expectedTexts, viewports: results },
+        message: failed ? "Selector " + selector + " text order failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "text_visible" || check.type === "text_absent") {
       const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
       const expectedVisible = check.type === "text_visible";
@@ -1125,14 +1243,23 @@ function assessProfile(profile, evidence) {
       const first = inventories[0].inventory || {};
       const directRoutes = Array.isArray(first.direct_routes) ? first.direct_routes : [];
       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 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;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
-          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : null,
-          homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null,
+          source_link_count: sourceLinkCount,
+          source_unique_link_count: sourceUniqueLinkCount,
+          duplicate_source_link_count: duplicateSourceLinkCount,
+          duplicate_source_links: duplicateSourceLinks,
+          duplicates_allowed: check.require_unique_routes === false,
+          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : sourceLinkCount,
+          homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : sourceUniqueLinkCount,
           direct_route_count: directRoutes.length,
           clickthrough_count: clickthroughs.length,
           failures,
@@ -1452,6 +1579,27 @@ async function selectorStats(selector) {
     return { count: elements.length, visible_count: elements.filter(isVisible).length };
   }).catch((error) => ({ count: 0, visible_count: 0, error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+async function selectorTextSequence(selector) {
+  return page.locator(selector).evaluateAll((elements) => {
+    const compact = (value) => String(value || "").replace(/\s+/g, " ").trim().slice(0, 240);
+    const isVisible = (element) => {
+      const style = window.getComputedStyle(element);
+      const rect = element.getBoundingClientRect();
+      return style && style.visibility !== "hidden" && style.display !== "none" && rect.width > 0 && rect.height > 0;
+    };
+    const rows = elements.map((element, index) => ({
+      index,
+      text: compact(element.innerText || element.textContent || ""),
+      visible: isVisible(element),
+    }));
+    return {
+      count: rows.length,
+      visible_count: rows.filter((row) => row.visible).length,
+      texts: rows.map((row) => row.text).filter(Boolean).slice(0, 40),
+      visible_texts: rows.filter((row) => row.visible).map((row) => row.text).filter(Boolean).slice(0, 40),
+    };
+  }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
+}
 function inventoryAppPathFromUrl(urlLike) {
   const url = new URL(String(urlLike), targetUrl);
   const mountPrefix = previewMountPrefix(new URL(targetUrl).pathname);
@@ -1651,8 +1799,9 @@ async function collectRouteInventory(check, viewport) {
   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);
+  const duplicateHomeLinkPathSet = Array.from(new Set(duplicateHomeLinkPaths));
   if (check.require_unique_routes !== false && duplicateHomeLinkPaths.length) {
-    failures.push({ code: "duplicate_source_links", paths: Array.from(new Set(duplicateHomeLinkPaths)) });
+    failures.push({ code: "duplicate_source_links", paths: duplicateHomeLinkPathSet });
   }
   for (const route of expectedRoutes) {
     if (!homeLinkPaths.includes(normalizeRoutePath(route.path))) {
@@ -1728,6 +1877,11 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_count: homeLinkPaths.length,
+    source_unique_link_count: uniqueHomeLinkPaths.length,
+    duplicate_source_link_count: duplicateHomeLinkPaths.length,
+    duplicate_source_link_paths: duplicateHomeLinkPathSet,
+    duplicates_allowed: check.require_unique_routes === false,
     home_game_link_count: homeLinkPaths.length,
     home_unique_game_link_count: uniqueHomeLinkPaths.length,
     home_links: homeLinks,
@@ -1843,11 +1997,16 @@ async function captureViewport(viewport) {
     evaluation_error: String(error && error.message ? error.message : error).slice(0, 1000),
   }));
   const selectors = {};
+  const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
     if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
+    if (check.type === "selector_text_order" && check.selector) {
+      selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
+      text_sequences[check.selector] = await selectorTextSequence(check.selector);
+    }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
     }
@@ -1871,6 +2030,11 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_count: 0,
+        source_unique_link_count: 0,
+        duplicate_source_link_count: 0,
+        duplicate_source_link_paths: [],
+        duplicates_allowed: routeInventoryCheck.require_unique_routes === false,
         home_game_link_count: 0,
         home_unique_game_link_count: 0,
         home_links: [],
@@ -1906,6 +2070,7 @@ async function captureViewport(viewport) {
     bounds_overflow_px: dom.bounds_overflow_px,
     overflow_offenders: dom.overflow_offenders || [],
     selectors,
+    text_sequences,
     text_matches,
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
@@ -1945,6 +2110,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          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,
           home_unique_game_link_count: viewport.route_inventory.home_unique_game_link_count,
           direct_route_count: (viewport.route_inventory.direct_routes || []).length,
           clickthrough_count: (viewport.route_inventory.clickthroughs || []).length,

package/dist/cli.cjs

@@ -6887,6 +6887,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "selector_visible",
   "selector_count_at_least",
+  "selector_text_order",
   "text_visible",
   "text_absent",
   "route_inventory",
@@ -7166,6 +7167,15 @@ function normalizeRouteInventoryRoutes(value, index) {
   }
   return routes;
 }
+function normalizeExpectedTexts(value, index) {
+  if (value === void 0) return void 0;
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error(`checks[${index}] selector_text_order expected_texts must be a non-empty array.`);
+  }
+  const texts = value.map((item) => String(item).replace(/\s+/g, " ").trim()).filter(Boolean);
+  if (!texts.length) throw new Error(`checks[${index}] selector_text_order expected_texts must contain non-empty strings.`);
+  return texts;
+}
 function normalizeCheck(input, index) {
   if (!isRecord(input)) throw new Error(`checks[${index}] must be an object.`);
   const type = stringValue2(input.type);
@@ -7182,6 +7192,11 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
+  if (type === "selector_text_order") {
+    if (!stringValue2(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
+    if (!expectedTexts?.length) throw new Error(`checks[${index}] selector_text_order requires expected_texts.`);
+  }
   const expectedRoutes = normalizeRouteInventoryRoutes(input.expected_routes ?? input.expectedRoutes, index);
   if (type === "route_inventory" && !expectedRoutes?.length) {
     throw new Error(`checks[${index}] route_inventory requires expected_routes.`);
@@ -7192,6 +7207,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue2(input.expected_path),
     expected_routes: expectedRoutes,
     selector: stringValue2(input.selector),
+    expected_texts: expectedTexts,
     link_selector: stringValue2(input.link_selector) || stringValue2(input.linkSelector),
     source_selector: stringValue2(input.source_selector) || stringValue2(input.sourceSelector),
     route_path_prefix: stringValue2(input.route_path_prefix) || stringValue2(input.routePathPrefix),
@@ -7297,6 +7313,28 @@ function selectorKey(check) {
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
+function textSequenceForCheck(viewport, check) {
+  const key = selectorKey(check);
+  const sequence = viewport.text_sequences?.[key];
+  if (isRecord(sequence)) {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text).replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
 function matchText(sample, check) {
   if (check.pattern) {
     try {
@@ -7416,6 +7454,32 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_text_order") {
+    const key = selectorKey(check);
+    const expectedTexts = check.expected_texts || [];
+    const results = viewports.map((viewport) => {
+      const texts = textSequenceForCheck(viewport, check);
+      const match = textOrderMatch(texts, expectedTexts);
+      return {
+        viewport: viewport.name,
+        matched: match.matched,
+        matched_positions: match.positions,
+        visible_texts: texts.slice(0, 20)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_texts: expectedTexts,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Selector ${key} text order failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
@@ -7451,14 +7515,23 @@ function assessCheckFromEvidence(check, evidence) {
     const first = inventories[0]?.inventory;
     const directRoutes = Array.isArray(first?.direct_routes) ? first.direct_routes : [];
     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 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);
     return {
       type: check.type,
       label: checkLabel(check),
       status: failures.length ? "failed" : "passed",
       evidence: {
         expected_count: check.expected_routes?.length || 0,
-        homepage_link_count: numberValue(first?.home_game_link_count) ?? null,
-        homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? null,
+        source_link_count: sourceLinkCount,
+        source_unique_link_count: sourceUniqueLinkCount,
+        duplicate_source_link_count: duplicateSourceLinkCount,
+        duplicate_source_links: duplicateSourceLinks,
+        duplicates_allowed: check.require_unique_routes === false,
+        homepage_link_count: numberValue(first?.home_game_link_count) ?? sourceLinkCount,
+        homepage_unique_link_count: numberValue(first?.home_unique_game_link_count) ?? sourceUniqueLinkCount,
         direct_route_count: directRoutes.length,
         clickthrough_count: clickthroughs.length,
         failures
@@ -7741,6 +7814,28 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function textSequenceForCheck(viewport, check) {
+  const key = check.selector || "";
+  const sequence = viewport.text_sequences && viewport.text_sequences[key];
+  if (sequence && typeof sequence === "object") {
+    const visibleTexts = Array.isArray(sequence.visible_texts) ? sequence.visible_texts : [];
+    const texts = Array.isArray(sequence.texts) ? sequence.texts : [];
+    const candidates = visibleTexts.length ? visibleTexts : texts;
+    return candidates.map((text) => String(text || "").replace(/\s+/g, " ").trim()).filter(Boolean);
+  }
+  return [];
+}
+function textOrderMatch(texts, expectedTexts) {
+  const positions = [];
+  let startAt = 0;
+  for (const expected of expectedTexts || []) {
+    const index = texts.findIndex((text, offset) => offset >= startAt && text.includes(expected));
+    if (index < 0) return { matched: false, positions };
+    positions.push(index);
+    startAt = index + 1;
+  }
+  return { matched: true, positions };
+}
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -7945,6 +8040,29 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_text_order") {
+      const selector = check.selector || "";
+      const expectedTexts = check.expected_texts || [];
+      const results = viewports.map((viewport) => {
+        const texts = textSequenceForCheck(viewport, check);
+        const match = textOrderMatch(texts, expectedTexts);
+        return {
+          viewport: viewport.name,
+          matched: match.matched,
+          matched_positions: match.positions,
+          visible_texts: texts.slice(0, 20),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: { selector, expected_texts: expectedTexts, viewports: results },
+        message: failed ? "Selector " + selector + " text order failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "text_visible" || check.type === "text_absent") {
       const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
       const expectedVisible = check.type === "text_visible";
@@ -7982,14 +8100,23 @@ function assessProfile(profile, evidence) {
       const first = inventories[0].inventory || {};
       const directRoutes = Array.isArray(first.direct_routes) ? first.direct_routes : [];
       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 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;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failures.length ? "failed" : "passed",
         evidence: {
           expected_count: (check.expected_routes || []).length,
-          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : null,
-          homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : null,
+          source_link_count: sourceLinkCount,
+          source_unique_link_count: sourceUniqueLinkCount,
+          duplicate_source_link_count: duplicateSourceLinkCount,
+          duplicate_source_links: duplicateSourceLinks,
+          duplicates_allowed: check.require_unique_routes === false,
+          homepage_link_count: typeof first.home_game_link_count === "number" ? first.home_game_link_count : sourceLinkCount,
+          homepage_unique_link_count: typeof first.home_unique_game_link_count === "number" ? first.home_unique_game_link_count : sourceUniqueLinkCount,
           direct_route_count: directRoutes.length,
           clickthrough_count: clickthroughs.length,
           failures,
@@ -8309,6 +8436,27 @@ async function selectorStats(selector) {
     return { count: elements.length, visible_count: elements.filter(isVisible).length };
   }).catch((error) => ({ count: 0, visible_count: 0, error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+async function selectorTextSequence(selector) {
+  return page.locator(selector).evaluateAll((elements) => {
+    const compact = (value) => String(value || "").replace(/\s+/g, " ").trim().slice(0, 240);
+    const isVisible = (element) => {
+      const style = window.getComputedStyle(element);
+      const rect = element.getBoundingClientRect();
+      return style && style.visibility !== "hidden" && style.display !== "none" && rect.width > 0 && rect.height > 0;
+    };
+    const rows = elements.map((element, index) => ({
+      index,
+      text: compact(element.innerText || element.textContent || ""),
+      visible: isVisible(element),
+    }));
+    return {
+      count: rows.length,
+      visible_count: rows.filter((row) => row.visible).length,
+      texts: rows.map((row) => row.text).filter(Boolean).slice(0, 40),
+      visible_texts: rows.filter((row) => row.visible).map((row) => row.text).filter(Boolean).slice(0, 40),
+    };
+  }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
+}
 function inventoryAppPathFromUrl(urlLike) {
   const url = new URL(String(urlLike), targetUrl);
   const mountPrefix = previewMountPrefix(new URL(targetUrl).pathname);
@@ -8508,8 +8656,9 @@ async function collectRouteInventory(check, viewport) {
   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);
+  const duplicateHomeLinkPathSet = Array.from(new Set(duplicateHomeLinkPaths));
   if (check.require_unique_routes !== false && duplicateHomeLinkPaths.length) {
-    failures.push({ code: "duplicate_source_links", paths: Array.from(new Set(duplicateHomeLinkPaths)) });
+    failures.push({ code: "duplicate_source_links", paths: duplicateHomeLinkPathSet });
   }
   for (const route of expectedRoutes) {
     if (!homeLinkPaths.includes(normalizeRoutePath(route.path))) {
@@ -8585,6 +8734,11 @@ async function collectRouteInventory(check, viewport) {
     expected_routes: expectedRoutes,
     link_selector: check.link_selector || "a[href]",
     source_selector: check.source_selector || null,
+    source_link_count: homeLinkPaths.length,
+    source_unique_link_count: uniqueHomeLinkPaths.length,
+    duplicate_source_link_count: duplicateHomeLinkPaths.length,
+    duplicate_source_link_paths: duplicateHomeLinkPathSet,
+    duplicates_allowed: check.require_unique_routes === false,
     home_game_link_count: homeLinkPaths.length,
     home_unique_game_link_count: uniqueHomeLinkPaths.length,
     home_links: homeLinks,
@@ -8700,11 +8854,16 @@ async function captureViewport(viewport) {
     evaluation_error: String(error && error.message ? error.message : error).slice(0, 1000),
   }));
   const selectors = {};
+  const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
     if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
+    if (check.type === "selector_text_order" && check.selector) {
+      selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
+      text_sequences[check.selector] = await selectorTextSequence(check.selector);
+    }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
     }
@@ -8728,6 +8887,11 @@ async function captureViewport(viewport) {
         expected_routes: routeInventoryCheck.expected_routes || [],
         link_selector: routeInventoryCheck.link_selector || "a[href]",
         source_selector: routeInventoryCheck.source_selector || null,
+        source_link_count: 0,
+        source_unique_link_count: 0,
+        duplicate_source_link_count: 0,
+        duplicate_source_link_paths: [],
+        duplicates_allowed: routeInventoryCheck.require_unique_routes === false,
         home_game_link_count: 0,
         home_unique_game_link_count: 0,
         home_links: [],
@@ -8763,6 +8927,7 @@ async function captureViewport(viewport) {
     bounds_overflow_px: dom.bounds_overflow_px,
     overflow_offenders: dom.overflow_offenders || [],
     selectors,
+    text_sequences,
     text_matches,
     route_inventory: routeInventory,
     setup_action_results: setupActionResults,
@@ -8802,6 +8967,9 @@ function buildProfileEvidence(currentViewports) {
         .map((viewport) => ({
           viewport: viewport.name,
           expected_count: (viewport.route_inventory.expected_routes || []).length,
+          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,
           home_unique_game_link_count: viewport.route_inventory.home_unique_game_link_count,
           direct_route_count: (viewport.route_inventory.direct_routes || []).length,
           clickthrough_count: (viewport.route_inventory.clickthroughs || []).length,