@riddledc/riddle-proof 0.7.59 → 0.7.60

package/README.md

@@ -355,6 +355,11 @@ game, or preview surfaces that render inside iframes:
 
 ```json
 [
+  {
+    "type": "frame_url_matches",
+    "selector": ".game-player-root iframe",
+    "pattern": "/saved/hot-path-.+/index\\.html$"
+  },
   {
     "type": "frame_text_visible",
     "selector": ".game-player-root iframe",
@@ -368,6 +373,11 @@ game, or preview surfaces that render inside iframes:
 ]
 ```
 
+Use `frame_url_equals` when the iframe must resolve to one exact embedded
+resource, or `frame_url_matches` when a preview/job/saved-game URL has a stable
+shape but a generated ID. URL checks fail when the frame is missing, just like
+frame text and overflow checks.
+
 Frame checks capture each matching iframe's URL, title, compact text sample,
 scroll width, client width, measured horizontal overflow, and top visible
 overflow offenders. This keeps embedded-player audits in profile mode instead

package/dist/{chunk-Q5VW6MAP.js → chunk-FLQ4HHTT.js}

@@ -22,6 +22,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_count_eq",
   "selector_text_order",
   "frame_text_visible",
+  "frame_url_equals",
+  "frame_url_matches",
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
@@ -506,12 +508,19 @@ function normalizeCheck(input, index) {
   if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && !stringValue(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
-  if ((type === "frame_text_visible" || type === "frame_no_horizontal_overflow") && !stringValue(input.selector)) {
+  if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if (type === "frame_text_visible" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`checks[${index}] frame_text_visible requires text or pattern.`);
   }
+  const expectedUrl = stringFromOwn(input, "expected_url", "expectedUrl", "url", "expected_value", "expectedValue", "value");
+  if (type === "frame_url_equals" && expectedUrl === void 0) {
+    throw new Error(`checks[${index}] frame_url_equals requires expected_url.`);
+  }
+  if (type === "frame_url_matches" && !stringValue(input.pattern)) {
+    throw new Error(`checks[${index}] frame_url_matches requires pattern.`);
+  }
   if ((type === "text_visible" || type === "text_absent") && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`checks[${index}] ${type} requires text or pattern.`);
   }
@@ -544,6 +553,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue(input.expected_path),
     param: stringValue(input.param) || stringValue(input.search_param) || stringValue(input.searchParam) || stringValue(input.key),
     expected_value: expectedValue,
+    expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue(input.selector),
     expected_texts: expectedTexts,
@@ -1011,6 +1021,35 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Frame selector ${key} did not contain expected text in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+    const key = selectorKey(check);
+    const expectedUrl = check.expected_url || check.expected_value || "";
+    const results = viewports.map((viewport) => {
+      const frames = frameEvidenceForSelector(viewport, key);
+      const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+      const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : matchText(url, check));
+      return {
+        viewport: viewport.name,
+        frame_count: frames.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        urls: urls.slice(0, 10)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+        pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Frame selector ${key} URL assertion failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_no_horizontal_overflow") {
     const key = selectorKey(check);
     const maxOverflow = check.max_overflow_px ?? 4;
@@ -1902,6 +1941,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+      const selector = check.selector || "";
+      const expectedUrl = check.expected_url || check.expected_value || "";
+      const results = checkViewports.map((viewport) => {
+        const frames = frameEvidenceForSelector(viewport, selector);
+        const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+        const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : textMatches(url, check));
+        return {
+          viewport: viewport.name,
+          frame_count: frames.length,
+          matched_count: matches.length,
+          matched: matches.length > 0,
+          urls: urls.slice(0, 10),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+          pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+          viewports: results,
+        },
+        message: failed ? "Frame selector " + selector + " URL assertion failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_no_horizontal_overflow") {
       const selector = check.selector || "";
       const maxOverflow = check.max_overflow_px == null ? 4 : check.max_overflow_px;
@@ -3373,7 +3442,7 @@ async function captureViewport(viewport) {
     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);
     }
-    if ((check.type === "frame_text_visible" || check.type === "frame_no_horizontal_overflow") && check.selector) {
+    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);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }

package/dist/cli.cjs

@@ -6895,6 +6895,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_count_eq",
   "selector_text_order",
   "frame_text_visible",
+  "frame_url_equals",
+  "frame_url_matches",
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
@@ -7379,12 +7381,19 @@ function normalizeCheck(input, index) {
   if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && !stringValue2(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
-  if ((type === "frame_text_visible" || type === "frame_no_horizontal_overflow") && !stringValue2(input.selector)) {
+  if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue2(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if (type === "frame_text_visible" && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`checks[${index}] frame_text_visible requires text or pattern.`);
   }
+  const expectedUrl = stringFromOwn(input, "expected_url", "expectedUrl", "url", "expected_value", "expectedValue", "value");
+  if (type === "frame_url_equals" && expectedUrl === void 0) {
+    throw new Error(`checks[${index}] frame_url_equals requires expected_url.`);
+  }
+  if (type === "frame_url_matches" && !stringValue2(input.pattern)) {
+    throw new Error(`checks[${index}] frame_url_matches requires pattern.`);
+  }
   if ((type === "text_visible" || type === "text_absent") && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`checks[${index}] ${type} requires text or pattern.`);
   }
@@ -7417,6 +7426,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue2(input.expected_path),
     param: stringValue2(input.param) || stringValue2(input.search_param) || stringValue2(input.searchParam) || stringValue2(input.key),
     expected_value: expectedValue,
+    expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue2(input.selector),
     expected_texts: expectedTexts,
@@ -7884,6 +7894,35 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Frame selector ${key} did not contain expected text in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+    const key = selectorKey(check);
+    const expectedUrl = check.expected_url || check.expected_value || "";
+    const results = viewports.map((viewport) => {
+      const frames = frameEvidenceForSelector(viewport, key);
+      const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+      const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : matchText(url, check));
+      return {
+        viewport: viewport.name,
+        frame_count: frames.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        urls: urls.slice(0, 10)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+        pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Frame selector ${key} URL assertion failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_no_horizontal_overflow") {
     const key = selectorKey(check);
     const maxOverflow = check.max_overflow_px ?? 4;
@@ -8759,6 +8798,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+      const selector = check.selector || "";
+      const expectedUrl = check.expected_url || check.expected_value || "";
+      const results = checkViewports.map((viewport) => {
+        const frames = frameEvidenceForSelector(viewport, selector);
+        const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+        const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : textMatches(url, check));
+        return {
+          viewport: viewport.name,
+          frame_count: frames.length,
+          matched_count: matches.length,
+          matched: matches.length > 0,
+          urls: urls.slice(0, 10),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+          pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+          viewports: results,
+        },
+        message: failed ? "Frame selector " + selector + " URL assertion failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_no_horizontal_overflow") {
       const selector = check.selector || "";
       const maxOverflow = check.max_overflow_px == null ? 4 : check.max_overflow_px;
@@ -10230,7 +10299,7 @@ async function captureViewport(viewport) {
     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);
     }
-    if ((check.type === "frame_text_visible" || check.type === "frame_no_horizontal_overflow") && check.selector) {
+    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);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-Q5VW6MAP.js";
+} from "./chunk-FLQ4HHTT.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8736,6 +8736,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_count_eq",
   "selector_text_order",
   "frame_text_visible",
+  "frame_url_equals",
+  "frame_url_matches",
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
@@ -9220,12 +9222,19 @@ function normalizeCheck(input, index) {
   if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && !stringValue5(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
-  if ((type === "frame_text_visible" || type === "frame_no_horizontal_overflow") && !stringValue5(input.selector)) {
+  if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue5(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if (type === "frame_text_visible" && !stringValue5(input.text) && !stringValue5(input.pattern)) {
     throw new Error(`checks[${index}] frame_text_visible requires text or pattern.`);
   }
+  const expectedUrl = stringFromOwn(input, "expected_url", "expectedUrl", "url", "expected_value", "expectedValue", "value");
+  if (type === "frame_url_equals" && expectedUrl === void 0) {
+    throw new Error(`checks[${index}] frame_url_equals requires expected_url.`);
+  }
+  if (type === "frame_url_matches" && !stringValue5(input.pattern)) {
+    throw new Error(`checks[${index}] frame_url_matches requires pattern.`);
+  }
   if ((type === "text_visible" || type === "text_absent") && !stringValue5(input.text) && !stringValue5(input.pattern)) {
     throw new Error(`checks[${index}] ${type} requires text or pattern.`);
   }
@@ -9258,6 +9267,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue5(input.expected_path),
     param: stringValue5(input.param) || stringValue5(input.search_param) || stringValue5(input.searchParam) || stringValue5(input.key),
     expected_value: expectedValue,
+    expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue5(input.selector),
     expected_texts: expectedTexts,
@@ -9725,6 +9735,35 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Frame selector ${key} did not contain expected text in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+    const key = selectorKey(check);
+    const expectedUrl = check.expected_url || check.expected_value || "";
+    const results = viewports.map((viewport) => {
+      const frames = frameEvidenceForSelector(viewport, key);
+      const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+      const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : matchText(url, check));
+      return {
+        viewport: viewport.name,
+        frame_count: frames.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        urls: urls.slice(0, 10)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+        pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Frame selector ${key} URL assertion failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_no_horizontal_overflow") {
     const key = selectorKey(check);
     const maxOverflow = check.max_overflow_px ?? 4;
@@ -10616,6 +10655,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+      const selector = check.selector || "";
+      const expectedUrl = check.expected_url || check.expected_value || "";
+      const results = checkViewports.map((viewport) => {
+        const frames = frameEvidenceForSelector(viewport, selector);
+        const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+        const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : textMatches(url, check));
+        return {
+          viewport: viewport.name,
+          frame_count: frames.length,
+          matched_count: matches.length,
+          matched: matches.length > 0,
+          urls: urls.slice(0, 10),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+          pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+          viewports: results,
+        },
+        message: failed ? "Frame selector " + selector + " URL assertion failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_no_horizontal_overflow") {
       const selector = check.selector || "";
       const maxOverflow = check.max_overflow_px == null ? 4 : check.max_overflow_px;
@@ -12087,7 +12156,7 @@ async function captureViewport(viewport) {
     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);
     }
-    if ((check.type === "frame_text_visible" || check.type === "frame_no_horizontal_overflow") && check.selector) {
+    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);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-Q5VW6MAP.js";
+} from "./chunk-FLQ4HHTT.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -65,6 +65,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_count_eq",
   "selector_text_order",
   "frame_text_visible",
+  "frame_url_equals",
+  "frame_url_matches",
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
@@ -549,12 +551,19 @@ function normalizeCheck(input, index) {
   if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && !stringValue(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
-  if ((type === "frame_text_visible" || type === "frame_no_horizontal_overflow") && !stringValue(input.selector)) {
+  if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if (type === "frame_text_visible" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`checks[${index}] frame_text_visible requires text or pattern.`);
   }
+  const expectedUrl = stringFromOwn(input, "expected_url", "expectedUrl", "url", "expected_value", "expectedValue", "value");
+  if (type === "frame_url_equals" && expectedUrl === void 0) {
+    throw new Error(`checks[${index}] frame_url_equals requires expected_url.`);
+  }
+  if (type === "frame_url_matches" && !stringValue(input.pattern)) {
+    throw new Error(`checks[${index}] frame_url_matches requires pattern.`);
+  }
   if ((type === "text_visible" || type === "text_absent") && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`checks[${index}] ${type} requires text or pattern.`);
   }
@@ -587,6 +596,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue(input.expected_path),
     param: stringValue(input.param) || stringValue(input.search_param) || stringValue(input.searchParam) || stringValue(input.key),
     expected_value: expectedValue,
+    expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue(input.selector),
     expected_texts: expectedTexts,
@@ -1054,6 +1064,35 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Frame selector ${key} did not contain expected text in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+    const key = selectorKey(check);
+    const expectedUrl = check.expected_url || check.expected_value || "";
+    const results = viewports.map((viewport) => {
+      const frames = frameEvidenceForSelector(viewport, key);
+      const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+      const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : matchText(url, check));
+      return {
+        viewport: viewport.name,
+        frame_count: frames.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        urls: urls.slice(0, 10)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+        pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Frame selector ${key} URL assertion failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_no_horizontal_overflow") {
     const key = selectorKey(check);
     const maxOverflow = check.max_overflow_px ?? 4;
@@ -1945,6 +1984,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+      const selector = check.selector || "";
+      const expectedUrl = check.expected_url || check.expected_value || "";
+      const results = checkViewports.map((viewport) => {
+        const frames = frameEvidenceForSelector(viewport, selector);
+        const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+        const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : textMatches(url, check));
+        return {
+          viewport: viewport.name,
+          frame_count: frames.length,
+          matched_count: matches.length,
+          matched: matches.length > 0,
+          urls: urls.slice(0, 10),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+          pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+          viewports: results,
+        },
+        message: failed ? "Frame selector " + selector + " URL assertion failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_no_horizontal_overflow") {
       const selector = check.selector || "";
       const maxOverflow = check.max_overflow_px == null ? 4 : check.max_overflow_px;
@@ -3416,7 +3485,7 @@ async function captureViewport(viewport) {
     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);
     }
-    if ((check.type === "frame_text_visible" || check.type === "frame_no_horizontal_overflow") && check.selector) {
+    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);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }

package/dist/profile.d.cts

@@ -4,7 +4,7 @@ declare const RIDDLE_PROOF_PROFILE_VERSION: "riddle-proof.profile.v1";
 declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evidence.v1";
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
-declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
+declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
 declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "press", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
@@ -94,6 +94,7 @@ interface RiddleProofProfileCheck {
     expected_path?: string;
     param?: string;
     expected_value?: string;
+    expected_url?: string;
     expected_routes?: RiddleProofProfileRouteInventoryRoute[];
     selector?: string;
     expected_texts?: string[];

package/dist/profile.d.ts

@@ -4,7 +4,7 @@ declare const RIDDLE_PROOF_PROFILE_VERSION: "riddle-proof.profile.v1";
 declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evidence.v1";
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
-declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
+declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "selector_text_order", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors"];
 declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "press", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
@@ -94,6 +94,7 @@ interface RiddleProofProfileCheck {
     expected_path?: string;
     param?: string;
     expected_value?: string;
+    expected_url?: string;
     expected_routes?: RiddleProofProfileRouteInventoryRoute[];
     selector?: string;
     expected_texts?: string[];

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-Q5VW6MAP.js";
+} from "./chunk-FLQ4HHTT.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

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

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

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

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

package/package.json

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