@riddledc/riddle-proof 0.7.127 → 0.7.129

package/dist/index.js

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

package/dist/profile.cjs

@@ -291,6 +291,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;
@@ -388,7 +419,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;
@@ -1481,6 +1512,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: stringValue(assertion.observed_type) || "missing",
     expected_exists: booleanValue(assertion.expected_exists),
     equals: hasOwn(assertion, "equals") ? toJsonValue(assertion.equals) : void 0,
@@ -1866,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 = [
@@ -2310,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,
@@ -2322,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
     };
@@ -2909,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 = [
@@ -3111,6 +3239,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,
@@ -3982,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;
@@ -4308,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));
@@ -5318,6 +5489,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;
@@ -5414,7 +5617,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;
@@ -6227,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 || []) {
@@ -6248,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);
@@ -6325,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

@@ -54,6 +54,10 @@ interface RiddleProofProfileHttpStatusBodyJsonAssertionResult {
     ok: boolean;
     exists: boolean;
     observed?: JsonValue;
+    observed_sample?: JsonValue;
+    observed_length?: number;
+    observed_key_count?: number;
+    observed_omitted_count?: number;
     observed_type: RiddleProofProfileJsonValueType | "missing";
     expected_exists?: boolean;
     equals?: JsonValue;
@@ -303,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

@@ -54,6 +54,10 @@ interface RiddleProofProfileHttpStatusBodyJsonAssertionResult {
     ok: boolean;
     exists: boolean;
     observed?: JsonValue;
+    observed_sample?: JsonValue;
+    observed_length?: number;
+    observed_key_count?: number;
+    observed_omitted_count?: number;
     observed_type: RiddleProofProfileJsonValueType | "missing";
     expected_exists?: boolean;
     equals?: JsonValue;
@@ -303,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-JLINSUKO.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.127",
+  "version": "0.7.129",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",