@riddledc/riddle-proof 0.7.128 → 0.7.129

package/dist/{chunk-TO3FVF5S.js → chunk-TDK6WFH3.js}

@@ -1854,6 +1854,49 @@ function matchText(sample, check) {
   }
   return sample.includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return void 0;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(`${prefix}${source.slice(start, end)}${suffix}`);
+  return compacted ? compacted.slice(0, 240) : void 0;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText2 = match ? textSampleAroundMatch(source, match.index, match[0]?.length || 1) : void 0;
+      return sampleText2 ? [sampleText2] : [];
+    } catch {
+      return [];
+    }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const index = source.indexOf(text);
+  const sampleText = textSampleAroundMatch(source, index, text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = textKey(check);
+  const captured = viewport.text_match_samples?.[key] || [];
+  const capturedSamples = captured.map((sample) => compactTextEvidenceSample(sample).slice(0, 240)).filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!isRecord(input)) return String(input || "");
   const parts = [
@@ -2298,10 +2341,17 @@ function assessCheckFromEvidence(check, evidence) {
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
-    const matches = viewports.map((viewport) => {
+    const results = viewports.map((viewport) => {
       const fromEvidence = viewport.text_matches?.[key];
-      return typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const matched = typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const failedAgainstExpectation = matched !== expectedVisible;
+      return {
+        viewport: viewport.name,
+        matched,
+        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : []
+      };
     });
+    const matches = results.map((result) => result.matched);
     const failed = matches.filter((matched) => matched !== expectedVisible).length;
     return {
       type: check.type,
@@ -2310,7 +2360,8 @@ function assessCheckFromEvidence(check, evidence) {
       evidence: {
         text: check.text || null,
         pattern: check.pattern || null,
-        matches
+        matches,
+        viewports: results.map((result) => toJsonValue(result))
       },
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
@@ -2897,6 +2948,48 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
+  const captured = viewport && viewport.text_match_samples && Array.isArray(viewport.text_match_samples[key]) ? viewport.text_match_samples[key] : [];
+  const capturedSamples = captured
+    .map((sample) => compactTextEvidenceSample(sample).slice(0, 240))
+    .filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport && viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport && viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return String(input || "");
   const parts = [
@@ -3974,13 +4067,22 @@ function assessProfile(profile, evidence) {
     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";
-      const matches = checkViewports.map((viewport) => viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check));
+      const results = checkViewports.map((viewport) => {
+        const matched = viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check);
+        const failedAgainstExpectation = matched !== expectedVisible;
+        return {
+          viewport: viewport.name,
+          matched,
+          samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+        };
+      });
+      const matches = results.map((result) => result.matched);
       const failed = matches.filter((matched) => matched !== expectedVisible).length;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failed ? "failed" : "passed",
-        evidence: { text: check.text, pattern: check.pattern, matches },
+        evidence: { text: check.text, pattern: check.pattern, matches, viewports: results },
         message: failed ? "Text assertion failed in " + failed + " viewport(s)." : undefined,
       });
       continue;
@@ -4300,6 +4402,36 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
 function profileCheckAppliesToViewport(check, viewport) {
   if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
   return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
@@ -6251,6 +6383,7 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const text_match_samples = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -6272,7 +6405,10 @@ async function captureViewport(viewport) {
       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);
+      const key = textKey(check);
+      const sample = dom.body_text || dom.body_text_sample || "";
+      text_matches[key] = textMatches(sample, check);
+      text_match_samples[key] = textMatchSamples(sample, check);
     }
     if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
@@ -6349,6 +6485,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    text_match_samples,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,

package/dist/cli.cjs

@@ -8791,6 +8791,49 @@ function matchText(sample, check) {
   }
   return sample.includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return void 0;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(`${prefix}${source.slice(start, end)}${suffix}`);
+  return compacted ? compacted.slice(0, 240) : void 0;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText2 = match ? textSampleAroundMatch(source, match.index, match[0]?.length || 1) : void 0;
+      return sampleText2 ? [sampleText2] : [];
+    } catch {
+      return [];
+    }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const index = source.indexOf(text);
+  const sampleText = textSampleAroundMatch(source, index, text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = textKey(check);
+  const captured = viewport.text_match_samples?.[key] || [];
+  const capturedSamples = captured.map((sample) => compactTextEvidenceSample(sample).slice(0, 240)).filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!isRecord(input)) return String(input || "");
   const parts = [
@@ -9235,10 +9278,17 @@ function assessCheckFromEvidence(check, evidence) {
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
-    const matches = viewports.map((viewport) => {
+    const results = viewports.map((viewport) => {
       const fromEvidence = viewport.text_matches?.[key];
-      return typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const matched = typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const failedAgainstExpectation = matched !== expectedVisible;
+      return {
+        viewport: viewport.name,
+        matched,
+        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : []
+      };
     });
+    const matches = results.map((result) => result.matched);
     const failed = matches.filter((matched) => matched !== expectedVisible).length;
     return {
       type: check.type,
@@ -9247,7 +9297,8 @@ function assessCheckFromEvidence(check, evidence) {
       evidence: {
         text: check.text || null,
         pattern: check.pattern || null,
-        matches
+        matches,
+        viewports: results.map((result) => toJsonValue(result))
       },
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
@@ -9818,6 +9869,48 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
+  const captured = viewport && viewport.text_match_samples && Array.isArray(viewport.text_match_samples[key]) ? viewport.text_match_samples[key] : [];
+  const capturedSamples = captured
+    .map((sample) => compactTextEvidenceSample(sample).slice(0, 240))
+    .filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport && viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport && viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return String(input || "");
   const parts = [
@@ -10895,13 +10988,22 @@ function assessProfile(profile, evidence) {
     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";
-      const matches = checkViewports.map((viewport) => viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check));
+      const results = checkViewports.map((viewport) => {
+        const matched = viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check);
+        const failedAgainstExpectation = matched !== expectedVisible;
+        return {
+          viewport: viewport.name,
+          matched,
+          samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+        };
+      });
+      const matches = results.map((result) => result.matched);
       const failed = matches.filter((matched) => matched !== expectedVisible).length;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failed ? "failed" : "passed",
-        evidence: { text: check.text, pattern: check.pattern, matches },
+        evidence: { text: check.text, pattern: check.pattern, matches, viewports: results },
         message: failed ? "Text assertion failed in " + failed + " viewport(s)." : undefined,
       });
       continue;
@@ -11221,6 +11323,36 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
 function profileCheckAppliesToViewport(check, viewport) {
   if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
   return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
@@ -13172,6 +13304,7 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const text_match_samples = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -13193,7 +13326,10 @@ async function captureViewport(viewport) {
       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);
+      const key = textKey(check);
+      const sample = dom.body_text || dom.body_text_sample || "";
+      text_matches[key] = textMatches(sample, check);
+      text_match_samples[key] = textMatchSamples(sample, check);
     }
     if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
@@ -13270,6 +13406,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    text_match_samples,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-TO3FVF5S.js";
+} from "./chunk-TDK6WFH3.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -10587,6 +10587,49 @@ function matchText(sample, check) {
   }
   return sample.includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return void 0;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(`${prefix}${source.slice(start, end)}${suffix}`);
+  return compacted ? compacted.slice(0, 240) : void 0;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText2 = match ? textSampleAroundMatch(source, match.index, match[0]?.length || 1) : void 0;
+      return sampleText2 ? [sampleText2] : [];
+    } catch {
+      return [];
+    }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const index = source.indexOf(text);
+  const sampleText = textSampleAroundMatch(source, index, text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = textKey(check);
+  const captured = viewport.text_match_samples?.[key] || [];
+  const capturedSamples = captured.map((sample) => compactTextEvidenceSample(sample).slice(0, 240)).filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!isRecord2(input)) return String(input || "");
   const parts = [
@@ -11031,10 +11074,17 @@ function assessCheckFromEvidence(check, evidence) {
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
-    const matches = viewports.map((viewport) => {
+    const results = viewports.map((viewport) => {
       const fromEvidence = viewport.text_matches?.[key];
-      return typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const matched = typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const failedAgainstExpectation = matched !== expectedVisible;
+      return {
+        viewport: viewport.name,
+        matched,
+        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : []
+      };
     });
+    const matches = results.map((result) => result.matched);
     const failed = matches.filter((matched) => matched !== expectedVisible).length;
     return {
       type: check.type,
@@ -11043,7 +11093,8 @@ function assessCheckFromEvidence(check, evidence) {
       evidence: {
         text: check.text || null,
         pattern: check.pattern || null,
-        matches
+        matches,
+        viewports: results.map((result) => toJsonValue(result))
       },
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
@@ -11630,6 +11681,48 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
+  const captured = viewport && viewport.text_match_samples && Array.isArray(viewport.text_match_samples[key]) ? viewport.text_match_samples[key] : [];
+  const capturedSamples = captured
+    .map((sample) => compactTextEvidenceSample(sample).slice(0, 240))
+    .filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport && viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport && viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return String(input || "");
   const parts = [
@@ -12707,13 +12800,22 @@ function assessProfile(profile, evidence) {
     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";
-      const matches = checkViewports.map((viewport) => viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check));
+      const results = checkViewports.map((viewport) => {
+        const matched = viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check);
+        const failedAgainstExpectation = matched !== expectedVisible;
+        return {
+          viewport: viewport.name,
+          matched,
+          samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+        };
+      });
+      const matches = results.map((result) => result.matched);
       const failed = matches.filter((matched) => matched !== expectedVisible).length;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failed ? "failed" : "passed",
-        evidence: { text: check.text, pattern: check.pattern, matches },
+        evidence: { text: check.text, pattern: check.pattern, matches, viewports: results },
         message: failed ? "Text assertion failed in " + failed + " viewport(s)." : undefined,
       });
       continue;
@@ -13033,6 +13135,36 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
 function profileCheckAppliesToViewport(check, viewport) {
   if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
   return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
@@ -14984,6 +15116,7 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const text_match_samples = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -15005,7 +15138,10 @@ async function captureViewport(viewport) {
       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);
+      const key = textKey(check);
+      const sample = dom.body_text || dom.body_text_sample || "";
+      text_matches[key] = textMatches(sample, check);
+      text_match_samples[key] = textMatchSamples(sample, check);
     }
     if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
@@ -15082,6 +15218,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    text_match_samples,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,

package/dist/index.js

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

package/dist/profile.cjs

@@ -1901,6 +1901,49 @@ function matchText(sample, check) {
   }
   return sample.includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return void 0;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(`${prefix}${source.slice(start, end)}${suffix}`);
+  return compacted ? compacted.slice(0, 240) : void 0;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText2 = match ? textSampleAroundMatch(source, match.index, match[0]?.length || 1) : void 0;
+      return sampleText2 ? [sampleText2] : [];
+    } catch {
+      return [];
+    }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const index = source.indexOf(text);
+  const sampleText = textSampleAroundMatch(source, index, text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = textKey(check);
+  const captured = viewport.text_match_samples?.[key] || [];
+  const capturedSamples = captured.map((sample) => compactTextEvidenceSample(sample).slice(0, 240)).filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!isRecord(input)) return String(input || "");
   const parts = [
@@ -2345,10 +2388,17 @@ function assessCheckFromEvidence(check, evidence) {
   if (check.type === "text_visible" || check.type === "text_absent") {
     const key = textKey(check);
     const expectedVisible = check.type === "text_visible";
-    const matches = viewports.map((viewport) => {
+    const results = viewports.map((viewport) => {
       const fromEvidence = viewport.text_matches?.[key];
-      return typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const matched = typeof fromEvidence === "boolean" ? fromEvidence : matchText(viewport.body_text_sample || "", check);
+      const failedAgainstExpectation = matched !== expectedVisible;
+      return {
+        viewport: viewport.name,
+        matched,
+        samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : []
+      };
     });
+    const matches = results.map((result) => result.matched);
     const failed = matches.filter((matched) => matched !== expectedVisible).length;
     return {
       type: check.type,
@@ -2357,7 +2407,8 @@ function assessCheckFromEvidence(check, evidence) {
       evidence: {
         text: check.text || null,
         pattern: check.pattern || null,
-        matches
+        matches,
+        viewports: results.map((result) => toJsonValue(result))
       },
       message: failed ? `Text assertion failed in ${failed} viewport(s).` : void 0
     };
@@ -2944,6 +2995,48 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
+function textCheckFailureSamples(viewport, check) {
+  const key = check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
+  const captured = viewport && viewport.text_match_samples && Array.isArray(viewport.text_match_samples[key]) ? viewport.text_match_samples[key] : [];
+  const capturedSamples = captured
+    .map((sample) => compactTextEvidenceSample(sample).slice(0, 240))
+    .filter(Boolean);
+  if (capturedSamples.length) return capturedSamples.slice(0, 3);
+  const matchedSamples = textMatchSamples(viewport && viewport.body_text_sample || "", check);
+  if (matchedSamples.length) return matchedSamples.slice(0, 3);
+  const fallback = compactTextEvidenceSample(viewport && viewport.body_text_sample || "").slice(0, 240);
+  return fallback ? [fallback] : [];
+}
 function allowedMessageSample(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return String(input || "");
   const parts = [
@@ -4021,13 +4114,22 @@ function assessProfile(profile, evidence) {
     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";
-      const matches = checkViewports.map((viewport) => viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check));
+      const results = checkViewports.map((viewport) => {
+        const matched = viewport.text_matches && typeof viewport.text_matches[key] === "boolean" ? viewport.text_matches[key] : textMatches(viewport.body_text_sample || "", check);
+        const failedAgainstExpectation = matched !== expectedVisible;
+        return {
+          viewport: viewport.name,
+          matched,
+          samples: failedAgainstExpectation ? textCheckFailureSamples(viewport, check) : [],
+        };
+      });
+      const matches = results.map((result) => result.matched);
       const failed = matches.filter((matched) => matched !== expectedVisible).length;
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failed ? "failed" : "passed",
-        evidence: { text: check.text, pattern: check.pattern, matches },
+        evidence: { text: check.text, pattern: check.pattern, matches, viewports: results },
         message: failed ? "Text assertion failed in " + failed + " viewport(s)." : undefined,
       });
       continue;
@@ -4347,6 +4449,36 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function compactTextEvidenceSample(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function textSampleAroundMatch(sample, index, length) {
+  if (index < 0) return undefined;
+  const source = String(sample || "");
+  const context = 120;
+  const start = Math.max(0, index - context);
+  const end = Math.min(source.length, index + Math.max(length, 1) + context);
+  const prefix = start > 0 ? "..." : "";
+  const suffix = end < source.length ? "..." : "";
+  const compacted = compactTextEvidenceSample(prefix + source.slice(start, end) + suffix);
+  return compacted ? compacted.slice(0, 240) : undefined;
+}
+function textMatchSamples(sample, check) {
+  const source = String(sample || "");
+  if (!source) return [];
+  if (check.pattern) {
+    try {
+      const flags = Array.from(new Set(String(check.flags || "").replace(/[gy]/g, "").split(""))).join("");
+      const match = new RegExp(check.pattern, flags).exec(source);
+      const sampleText = match ? textSampleAroundMatch(source, match.index, match[0] ? match[0].length : 1) : undefined;
+      return sampleText ? [sampleText] : [];
+    } catch { return []; }
+  }
+  const text = check.text || "";
+  if (!text) return [];
+  const sampleText = textSampleAroundMatch(source, source.indexOf(text), text.length);
+  return sampleText ? [sampleText] : [];
+}
 function profileCheckAppliesToViewport(check, viewport) {
   if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
   return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
@@ -6298,6 +6430,7 @@ async function captureViewport(viewport) {
   const frames = {};
   const text_sequences = {};
   const text_matches = {};
+  const text_match_samples = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -6319,7 +6452,10 @@ async function captureViewport(viewport) {
       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);
+      const key = textKey(check);
+      const sample = dom.body_text || dom.body_text_sample || "";
+      text_matches[key] = textMatches(sample, check);
+      text_match_samples[key] = textMatchSamples(sample, check);
     }
     if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
@@ -6396,6 +6532,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    text_match_samples,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,

package/dist/profile.d.cts

@@ -307,6 +307,7 @@ interface RiddleProofProfileViewportEvidence {
     frames?: Record<string, Record<string, JsonValue>>;
     text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
+    text_match_samples?: Record<string, string[]>;
     http_statuses?: Record<string, Record<string, JsonValue>>;
     link_statuses?: Record<string, Record<string, JsonValue>>;
     route_inventory?: Record<string, JsonValue>;

package/dist/profile.d.ts

@@ -307,6 +307,7 @@ interface RiddleProofProfileViewportEvidence {
     frames?: Record<string, Record<string, JsonValue>>;
     text_sequences?: Record<string, Record<string, JsonValue>>;
     text_matches?: Record<string, boolean>;
+    text_match_samples?: Record<string, string[]>;
     http_statuses?: Record<string, Record<string, JsonValue>>;
     link_statuses?: Record<string, Record<string, JsonValue>>;
     route_inventory?: Record<string, JsonValue>;

package/dist/profile.js

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

package/package.json

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