@riddledc/riddle-proof 0.7.127 → 0.7.129

package/dist/cli.cjs

@@ -7181,6 +7181,37 @@ function jsonValueType(value) {
   if (typeof value === "string") return "string";
   return "object";
 }
+function compactJsonAssertionSample(value, depth = 0) {
+  if (typeof value === "string") return value.length > 240 ? `${value.slice(0, 237)}...` : value;
+  if (value === null || typeof value === "boolean" || typeof value === "number") return toJsonValue(value);
+  if (Array.isArray(value)) {
+    if (depth >= 2) return `[array:${value.length}]`;
+    return value.slice(0, 3).map((item) => compactJsonAssertionSample(item, depth + 1));
+  }
+  if (isRecord(value)) {
+    const entries = Object.entries(value).slice(0, 8);
+    if (depth >= 2) return `[object:${Object.keys(value).length} keys]`;
+    return Object.fromEntries(entries.map(([key, child]) => [key, compactJsonAssertionSample(child, depth + 1)]));
+  }
+  return String(value);
+}
+function attachJsonAssertionObservedValue(result, value) {
+  const type = jsonValueType(value);
+  if (type === "array" && Array.isArray(value)) {
+    result.observed_length = value.length;
+    result.observed_omitted_count = Math.max(0, value.length - 3);
+    result.observed_sample = compactJsonAssertionSample(value);
+    return;
+  }
+  if (type === "object" && isRecord(value)) {
+    const keyCount = Object.keys(value).length;
+    result.observed_key_count = keyCount;
+    result.observed_omitted_count = Math.max(0, keyCount - 8);
+    result.observed_sample = compactJsonAssertionSample(value);
+    return;
+  }
+  result.observed = toJsonValue(value);
+}
 function deepJsonEqual(left, right) {
   if (left === right) return true;
   if (typeof left !== typeof right) return false;
@@ -7278,7 +7309,7 @@ function evaluateHttpStatusBodyJsonAssertion(root, assertion) {
     exists: resolved.exists,
     observed_type: resolved.exists ? jsonValueType(resolved.value) : "missing"
   };
-  if (resolved.exists) result.observed = toJsonValue(resolved.value);
+  if (resolved.exists) attachJsonAssertionObservedValue(result, resolved.value);
   if (resolved.error) errors.push(resolved.error);
   if (hasOwn(assertion, "exists")) {
     result.expected_exists = assertion.exists;
@@ -8371,6 +8402,10 @@ function httpStatusBodyJsonAssertionFailures(result, check) {
     ok: false,
     exists: assertion.exists === true,
     observed: hasOwn(assertion, "observed") ? toJsonValue(assertion.observed) : void 0,
+    observed_sample: hasOwn(assertion, "observed_sample") ? toJsonValue(assertion.observed_sample) : void 0,
+    observed_length: numberValue(assertion.observed_length),
+    observed_key_count: numberValue(assertion.observed_key_count),
+    observed_omitted_count: numberValue(assertion.observed_omitted_count),
     observed_type: stringValue2(assertion.observed_type) || "missing",
     expected_exists: booleanValue(assertion.expected_exists),
     equals: hasOwn(assertion, "equals") ? toJsonValue(assertion.equals) : void 0,
@@ -8756,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 = [
@@ -9200,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,
@@ -9212,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
     };
@@ -9783,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 = [
@@ -9985,6 +10113,10 @@ function httpStatusBodyJsonAssertionFailures(result, check) {
       ok: false,
       exists: assertion.exists === true,
       observed: Object.hasOwn(assertion, "observed") ? assertion.observed : undefined,
+      observed_sample: Object.hasOwn(assertion, "observed_sample") ? assertion.observed_sample : undefined,
+      observed_length: typeof assertion.observed_length === "number" && Number.isFinite(assertion.observed_length) ? assertion.observed_length : undefined,
+      observed_key_count: typeof assertion.observed_key_count === "number" && Number.isFinite(assertion.observed_key_count) ? assertion.observed_key_count : undefined,
+      observed_omitted_count: typeof assertion.observed_omitted_count === "number" && Number.isFinite(assertion.observed_omitted_count) ? assertion.observed_omitted_count : undefined,
       observed_type: typeof assertion.observed_type === "string" && assertion.observed_type ? assertion.observed_type : "missing",
       expected_exists: typeof assertion.expected_exists === "boolean" ? assertion.expected_exists : undefined,
       equals: Object.hasOwn(assertion, "equals") ? assertion.equals : undefined,
@@ -10856,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;
@@ -11182,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));
@@ -12192,6 +12363,38 @@ function jsonProbeValueType(value) {
   if (typeof value === "string") return "string";
   return "object";
 }
+function compactJsonProbeSample(value, depth) {
+  const level = typeof depth === "number" ? depth : 0;
+  if (typeof value === "string") return value.length > 240 ? value.slice(0, 237) + "..." : value;
+  if (value === null || typeof value === "boolean" || typeof value === "number") return value;
+  if (Array.isArray(value)) {
+    if (level >= 2) return "[array:" + value.length + "]";
+    return value.slice(0, 3).map((item) => compactJsonProbeSample(item, level + 1));
+  }
+  if (value && typeof value === "object") {
+    const entries = Object.entries(value);
+    if (level >= 2) return "[object:" + entries.length + " keys]";
+    return Object.fromEntries(entries.slice(0, 8).map(([key, child]) => [key, compactJsonProbeSample(child, level + 1)]));
+  }
+  return String(value);
+}
+function attachJsonProbeObservedValue(result, value) {
+  const type = jsonProbeValueType(value);
+  if (type === "array" && Array.isArray(value)) {
+    result.observed_length = value.length;
+    result.observed_omitted_count = Math.max(0, value.length - 3);
+    result.observed_sample = compactJsonProbeSample(value, 0);
+    return;
+  }
+  if (type === "object" && value && typeof value === "object" && !Array.isArray(value)) {
+    const keyCount = Object.keys(value).length;
+    result.observed_key_count = keyCount;
+    result.observed_omitted_count = Math.max(0, keyCount - 8);
+    result.observed_sample = compactJsonProbeSample(value, 0);
+    return;
+  }
+  result.observed = value;
+}
 function jsonProbeDeepEqual(left, right) {
   if (left === right) return true;
   if (typeof left !== typeof right) return false;
@@ -12288,7 +12491,7 @@ function evaluateJsonProbeAssertion(root, assertion) {
     exists: resolved.exists,
     observed_type: resolved.exists ? jsonProbeValueType(resolved.value) : "missing",
   };
-  if (resolved.exists) result.observed = resolved.value;
+  if (resolved.exists) attachJsonProbeObservedValue(result, resolved.value);
   if (resolved.error) errors.push(resolved.error);
   if (Object.hasOwn(assertion, "exists")) {
     result.expected_exists = assertion.exists;
@@ -13101,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 || []) {
@@ -13122,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);
@@ -13199,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-JLINSUKO.js";
+} from "./chunk-TDK6WFH3.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8977,6 +8977,37 @@ function jsonValueType(value) {
   if (typeof value === "string") return "string";
   return "object";
 }
+function compactJsonAssertionSample(value, depth = 0) {
+  if (typeof value === "string") return value.length > 240 ? `${value.slice(0, 237)}...` : value;
+  if (value === null || typeof value === "boolean" || typeof value === "number") return toJsonValue(value);
+  if (Array.isArray(value)) {
+    if (depth >= 2) return `[array:${value.length}]`;
+    return value.slice(0, 3).map((item) => compactJsonAssertionSample(item, depth + 1));
+  }
+  if (isRecord2(value)) {
+    const entries = Object.entries(value).slice(0, 8);
+    if (depth >= 2) return `[object:${Object.keys(value).length} keys]`;
+    return Object.fromEntries(entries.map(([key, child]) => [key, compactJsonAssertionSample(child, depth + 1)]));
+  }
+  return String(value);
+}
+function attachJsonAssertionObservedValue(result, value) {
+  const type = jsonValueType(value);
+  if (type === "array" && Array.isArray(value)) {
+    result.observed_length = value.length;
+    result.observed_omitted_count = Math.max(0, value.length - 3);
+    result.observed_sample = compactJsonAssertionSample(value);
+    return;
+  }
+  if (type === "object" && isRecord2(value)) {
+    const keyCount = Object.keys(value).length;
+    result.observed_key_count = keyCount;
+    result.observed_omitted_count = Math.max(0, keyCount - 8);
+    result.observed_sample = compactJsonAssertionSample(value);
+    return;
+  }
+  result.observed = toJsonValue(value);
+}
 function deepJsonEqual(left, right) {
   if (left === right) return true;
   if (typeof left !== typeof right) return false;
@@ -9074,7 +9105,7 @@ function evaluateHttpStatusBodyJsonAssertion(root, assertion) {
     exists: resolved.exists,
     observed_type: resolved.exists ? jsonValueType(resolved.value) : "missing"
   };
-  if (resolved.exists) result.observed = toJsonValue(resolved.value);
+  if (resolved.exists) attachJsonAssertionObservedValue(result, resolved.value);
   if (resolved.error) errors.push(resolved.error);
   if (hasOwn(assertion, "exists")) {
     result.expected_exists = assertion.exists;
@@ -10167,6 +10198,10 @@ function httpStatusBodyJsonAssertionFailures(result, check) {
     ok: false,
     exists: assertion.exists === true,
     observed: hasOwn(assertion, "observed") ? toJsonValue(assertion.observed) : void 0,
+    observed_sample: hasOwn(assertion, "observed_sample") ? toJsonValue(assertion.observed_sample) : void 0,
+    observed_length: numberValue3(assertion.observed_length),
+    observed_key_count: numberValue3(assertion.observed_key_count),
+    observed_omitted_count: numberValue3(assertion.observed_omitted_count),
     observed_type: stringValue5(assertion.observed_type) || "missing",
     expected_exists: booleanValue(assertion.expected_exists),
     equals: hasOwn(assertion, "equals") ? toJsonValue(assertion.equals) : void 0,
@@ -10552,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 = [
@@ -10996,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,
@@ -11008,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
     };
@@ -11595,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 = [
@@ -11797,6 +11925,10 @@ function httpStatusBodyJsonAssertionFailures(result, check) {
       ok: false,
       exists: assertion.exists === true,
       observed: Object.hasOwn(assertion, "observed") ? assertion.observed : undefined,
+      observed_sample: Object.hasOwn(assertion, "observed_sample") ? assertion.observed_sample : undefined,
+      observed_length: typeof assertion.observed_length === "number" && Number.isFinite(assertion.observed_length) ? assertion.observed_length : undefined,
+      observed_key_count: typeof assertion.observed_key_count === "number" && Number.isFinite(assertion.observed_key_count) ? assertion.observed_key_count : undefined,
+      observed_omitted_count: typeof assertion.observed_omitted_count === "number" && Number.isFinite(assertion.observed_omitted_count) ? assertion.observed_omitted_count : undefined,
       observed_type: typeof assertion.observed_type === "string" && assertion.observed_type ? assertion.observed_type : "missing",
       expected_exists: typeof assertion.expected_exists === "boolean" ? assertion.expected_exists : undefined,
       equals: Object.hasOwn(assertion, "equals") ? assertion.equals : undefined,
@@ -12668,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;
@@ -12994,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));
@@ -14004,6 +14175,38 @@ function jsonProbeValueType(value) {
   if (typeof value === "string") return "string";
   return "object";
 }
+function compactJsonProbeSample(value, depth) {
+  const level = typeof depth === "number" ? depth : 0;
+  if (typeof value === "string") return value.length > 240 ? value.slice(0, 237) + "..." : value;
+  if (value === null || typeof value === "boolean" || typeof value === "number") return value;
+  if (Array.isArray(value)) {
+    if (level >= 2) return "[array:" + value.length + "]";
+    return value.slice(0, 3).map((item) => compactJsonProbeSample(item, level + 1));
+  }
+  if (value && typeof value === "object") {
+    const entries = Object.entries(value);
+    if (level >= 2) return "[object:" + entries.length + " keys]";
+    return Object.fromEntries(entries.slice(0, 8).map(([key, child]) => [key, compactJsonProbeSample(child, level + 1)]));
+  }
+  return String(value);
+}
+function attachJsonProbeObservedValue(result, value) {
+  const type = jsonProbeValueType(value);
+  if (type === "array" && Array.isArray(value)) {
+    result.observed_length = value.length;
+    result.observed_omitted_count = Math.max(0, value.length - 3);
+    result.observed_sample = compactJsonProbeSample(value, 0);
+    return;
+  }
+  if (type === "object" && value && typeof value === "object" && !Array.isArray(value)) {
+    const keyCount = Object.keys(value).length;
+    result.observed_key_count = keyCount;
+    result.observed_omitted_count = Math.max(0, keyCount - 8);
+    result.observed_sample = compactJsonProbeSample(value, 0);
+    return;
+  }
+  result.observed = value;
+}
 function jsonProbeDeepEqual(left, right) {
   if (left === right) return true;
   if (typeof left !== typeof right) return false;
@@ -14100,7 +14303,7 @@ function evaluateJsonProbeAssertion(root, assertion) {
     exists: resolved.exists,
     observed_type: resolved.exists ? jsonProbeValueType(resolved.value) : "missing",
   };
-  if (resolved.exists) result.observed = resolved.value;
+  if (resolved.exists) attachJsonProbeObservedValue(result, resolved.value);
   if (resolved.error) errors.push(resolved.error);
   if (Object.hasOwn(assertion, "exists")) {
     result.expected_exists = assertion.exists;
@@ -14913,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 || []) {
@@ -14934,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);
@@ -15011,6 +15218,7 @@ async function captureViewport(viewport) {
     frames,
     text_sequences,
     text_matches,
+    text_match_samples,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,