@riddledc/riddle-proof 0.7.40 → 0.7.42

package/README.md

@@ -145,6 +145,8 @@ or as a stronger proof base before a change loop.
   "checks": [
     { "type": "route_loaded", "expected_path": "/pricing" },
     { "type": "selector_visible", "selector": "[data-testid='pricing-cards']" },
+    { "type": "selector_absent", "selector": "[data-testid='loading-spinner']" },
+    { "type": "selector_count_equals", "selector": "[data-testid='pricing-card']", "expected_count": 3 },
     { "type": "text_visible", "text": "Start building" },
     { "type": "no_mobile_horizontal_overflow" },
     { "type": "no_fatal_console_errors" }
@@ -210,7 +212,10 @@ When `responses` is present, `network_mocks_succeeded` requires each configured
 response to be hit at least once by default and records `hit_index`,
 `response_index`, and `response_label` for each request. Set
 `required_hit_count` / `min_hits` or `required: false` when a different
-contract is intentional.
+contract is intentional. Set `repeat_responses: true` when the sequence should
+cycle instead of reusing the final response, for example to repeat a fail-then-
+success pair across multiple viewports. Repeated sequences also record
+`sequence_cycle: true` after the first cycle.
 
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 appears only after a picker, tab, login stub, storage seed, form fill,
@@ -249,6 +254,21 @@ only unallowed `error` / `assert` console events and page errors fail the check.
 Use `allowed_page_error_patterns`, `allowed_console_texts`, or
 `allowed_page_error_texts` for narrower matching when needed.
 
+Use `selector_absent` when a forbidden element must not render, and
+`selector_count_equals` / `selector_count_equal` / `selector_count_eq` when a
+profile needs an exact DOM count rather than a lower bound:
+
+```json
+[
+  { "type": "selector_absent", "selector": ".game-player-root iframe" },
+  { "type": "selector_count_equals", "selector": ".pricing-card", "expected_count": 3 }
+]
+```
+
+These checks are useful for audit/no-diff profiles where the product should
+show a fallback state and avoid rendering stale loaders, duplicate rows, or
+missing-resource iframes.
+
 Use `selector_text_order` when a table, list, or card group must show visible
 items in a specific order after setup actions such as sorting or filtering:
 

package/dist/{chunk-RAVOICNN.js → chunk-MT2OZCCP.js}

@@ -13,7 +13,11 @@ var RIDDLE_PROOF_PROFILE_STATUSES = [
 var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "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",
@@ -261,6 +265,7 @@ function normalizeNetworkMock(input, index) {
     url,
     method: stringValue(input.method)?.toUpperCase(),
     responses,
+    repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
     required_hit_count: requiredHitCount,
     required: input.required === false ? false : true
   };
@@ -352,7 +357,7 @@ function normalizeCheck(input, index) {
   if (!isSupportedCheckType(type)) {
     throw new Error(`checks[${index}].type ${type} is not supported. Supported checks: ${RIDDLE_PROOF_PROFILE_CHECK_TYPES.join(", ")}`);
   }
-  if ((type === "selector_visible" || type === "selector_count_at_least") && !stringValue(input.selector)) {
+  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)) {
@@ -367,6 +372,10 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedCount = numberValue(input.expected_count) ?? numberValue(input.expectedCount) ?? numberValue(input.count);
+  if ((type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && expectedCount === void 0) {
+    throw new Error(`checks[${index}] ${type} requires expected_count.`);
+  }
   const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
   if (type === "selector_text_order") {
     if (!stringValue(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
@@ -398,6 +407,7 @@ function normalizeCheck(input, index) {
     allowed_page_error_texts: normalizeStringList(input.allowed_page_error_texts ?? input.allowedPageErrorTexts ?? input.allow_page_error_texts ?? input.allowPageErrorTexts, `checks[${index}] allowed_page_error_texts`),
     allowed_page_error_patterns: normalizeStringList(input.allowed_page_error_patterns ?? input.allowedPageErrorPatterns ?? input.allow_page_error_patterns ?? input.allowPageErrorPatterns, `checks[${index}] allowed_page_error_patterns`),
     min_count: numberValue(input.min_count),
+    expected_count: expectedCount,
     max_overflow_px: numberValue(input.max_overflow_px),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
@@ -665,6 +675,20 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} was not visible in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_absent") {
+    const key = selectorKey(check);
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) > 0);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} was present in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_count_at_least") {
     const key = selectorKey(check);
     const minCount = check.min_count ?? 1;
@@ -681,6 +705,22 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+    const key = selectorKey(check);
+    const expectedCount = check.expected_count ?? 0;
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) !== expectedCount);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_count: expectedCount,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} count did not equal ${expectedCount} in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_text_order") {
     const key = selectorKey(check);
     const expectedTexts = check.expected_texts || [];
@@ -1417,6 +1457,18 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_absent") {
+      const selector = check.selector || "";
+      const failed = viewports.filter((viewport) => viewport.selectors && viewport.selectors[selector] && viewport.selectors[selector].count > 0);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " was present in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_count_at_least") {
       const selector = check.selector || "";
       const minCount = check.min_count == null ? 1 : check.min_count;
@@ -1430,6 +1482,19 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+      const selector = check.selector || "";
+      const expectedCount = check.expected_count == null ? 0 : check.expected_count;
+      const failed = viewports.filter((viewport) => (viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) !== expectedCount);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, expected_count: expectedCount, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " count did not equal " + expectedCount + " in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_text_order") {
       const selector = check.selector || "";
       const expectedTexts = check.expected_texts || [];
@@ -1748,7 +1813,9 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
-        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const responseIndex = responses.length
+          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          : null;
         const response = responseIndex === null ? mock : responses[responseIndex];
         const headers = { ...(response.headers || mock.headers || {}) };
         let body = response.body || "";
@@ -1763,7 +1830,8 @@ async function registerNetworkMocks(mocks) {
           response_label: response.label || null,
           hit_index: hitIndex,
           response_index: responseIndex,
-          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
+          sequence_reused: responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
+          sequence_cycle: responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
           url: request.url(),
           method,
           status: response.status || mock.status || 200,
@@ -2443,7 +2511,16 @@ async function captureViewport(viewport) {
   const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
-    if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
+    if (
+      (
+        check.type === "selector_visible"
+        || check.type === "selector_absent"
+        || check.type === "selector_count_at_least"
+        || check.type === "selector_count_equals"
+        || check.type === "selector_count_equal"
+        || check.type === "selector_count_eq"
+      ) && check.selector
+    ) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
     if (check.type === "selector_text_order" && check.selector) {

package/dist/cli.cjs

@@ -6886,7 +6886,11 @@ var RIDDLE_PROOF_PROFILE_STATUSES = [
 var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "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",
@@ -7134,6 +7138,7 @@ function normalizeNetworkMock(input, index) {
     url,
     method: stringValue2(input.method)?.toUpperCase(),
     responses,
+    repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
     required_hit_count: requiredHitCount,
     required: input.required === false ? false : true
   };
@@ -7225,7 +7230,7 @@ function normalizeCheck(input, index) {
   if (!isSupportedCheckType(type)) {
     throw new Error(`checks[${index}].type ${type} is not supported. Supported checks: ${RIDDLE_PROOF_PROFILE_CHECK_TYPES.join(", ")}`);
   }
-  if ((type === "selector_visible" || type === "selector_count_at_least") && !stringValue2(input.selector)) {
+  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)) {
@@ -7240,6 +7245,10 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedCount = numberValue(input.expected_count) ?? numberValue(input.expectedCount) ?? numberValue(input.count);
+  if ((type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && expectedCount === void 0) {
+    throw new Error(`checks[${index}] ${type} requires expected_count.`);
+  }
   const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
   if (type === "selector_text_order") {
     if (!stringValue2(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
@@ -7271,6 +7280,7 @@ function normalizeCheck(input, index) {
     allowed_page_error_texts: normalizeStringList(input.allowed_page_error_texts ?? input.allowedPageErrorTexts ?? input.allow_page_error_texts ?? input.allowPageErrorTexts, `checks[${index}] allowed_page_error_texts`),
     allowed_page_error_patterns: normalizeStringList(input.allowed_page_error_patterns ?? input.allowedPageErrorPatterns ?? input.allow_page_error_patterns ?? input.allowPageErrorPatterns, `checks[${index}] allowed_page_error_patterns`),
     min_count: numberValue(input.min_count),
+    expected_count: expectedCount,
     max_overflow_px: numberValue(input.max_overflow_px),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
@@ -7538,6 +7548,20 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} was not visible in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_absent") {
+    const key = selectorKey(check);
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) > 0);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} was present in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_count_at_least") {
     const key = selectorKey(check);
     const minCount = check.min_count ?? 1;
@@ -7554,6 +7578,22 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+    const key = selectorKey(check);
+    const expectedCount = check.expected_count ?? 0;
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) !== expectedCount);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_count: expectedCount,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} count did not equal ${expectedCount} in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_text_order") {
     const key = selectorKey(check);
     const expectedTexts = check.expected_texts || [];
@@ -8274,6 +8314,18 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_absent") {
+      const selector = check.selector || "";
+      const failed = viewports.filter((viewport) => viewport.selectors && viewport.selectors[selector] && viewport.selectors[selector].count > 0);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " was present in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_count_at_least") {
       const selector = check.selector || "";
       const minCount = check.min_count == null ? 1 : check.min_count;
@@ -8287,6 +8339,19 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+      const selector = check.selector || "";
+      const expectedCount = check.expected_count == null ? 0 : check.expected_count;
+      const failed = viewports.filter((viewport) => (viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) !== expectedCount);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, expected_count: expectedCount, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " count did not equal " + expectedCount + " in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_text_order") {
       const selector = check.selector || "";
       const expectedTexts = check.expected_texts || [];
@@ -8605,7 +8670,9 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
-        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const responseIndex = responses.length
+          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          : null;
         const response = responseIndex === null ? mock : responses[responseIndex];
         const headers = { ...(response.headers || mock.headers || {}) };
         let body = response.body || "";
@@ -8620,7 +8687,8 @@ async function registerNetworkMocks(mocks) {
           response_label: response.label || null,
           hit_index: hitIndex,
           response_index: responseIndex,
-          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
+          sequence_reused: responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
+          sequence_cycle: responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
           url: request.url(),
           method,
           status: response.status || mock.status || 200,
@@ -9300,7 +9368,16 @@ async function captureViewport(viewport) {
   const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
-    if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
+    if (
+      (
+        check.type === "selector_visible"
+        || check.type === "selector_absent"
+        || check.type === "selector_count_at_least"
+        || check.type === "selector_count_equals"
+        || check.type === "selector_count_equal"
+        || check.type === "selector_count_eq"
+      ) && check.selector
+    ) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
     if (check.type === "selector_text_order" && check.selector) {

package/dist/cli.js

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

package/dist/index.cjs

@@ -8727,7 +8727,11 @@ var RIDDLE_PROOF_PROFILE_STATUSES = [
 var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "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",
@@ -8975,6 +8979,7 @@ function normalizeNetworkMock(input, index) {
     url,
     method: stringValue5(input.method)?.toUpperCase(),
     responses,
+    repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
     required_hit_count: requiredHitCount,
     required: input.required === false ? false : true
   };
@@ -9066,7 +9071,7 @@ function normalizeCheck(input, index) {
   if (!isSupportedCheckType(type)) {
     throw new Error(`checks[${index}].type ${type} is not supported. Supported checks: ${RIDDLE_PROOF_PROFILE_CHECK_TYPES.join(", ")}`);
   }
-  if ((type === "selector_visible" || type === "selector_count_at_least") && !stringValue5(input.selector)) {
+  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)) {
@@ -9081,6 +9086,10 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue3(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedCount = numberValue3(input.expected_count) ?? numberValue3(input.expectedCount) ?? numberValue3(input.count);
+  if ((type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && expectedCount === void 0) {
+    throw new Error(`checks[${index}] ${type} requires expected_count.`);
+  }
   const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
   if (type === "selector_text_order") {
     if (!stringValue5(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
@@ -9112,6 +9121,7 @@ function normalizeCheck(input, index) {
     allowed_page_error_texts: normalizeStringList(input.allowed_page_error_texts ?? input.allowedPageErrorTexts ?? input.allow_page_error_texts ?? input.allowPageErrorTexts, `checks[${index}] allowed_page_error_texts`),
     allowed_page_error_patterns: normalizeStringList(input.allowed_page_error_patterns ?? input.allowedPageErrorPatterns ?? input.allow_page_error_patterns ?? input.allowPageErrorPatterns, `checks[${index}] allowed_page_error_patterns`),
     min_count: numberValue3(input.min_count),
+    expected_count: expectedCount,
     max_overflow_px: numberValue3(input.max_overflow_px),
     timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
@@ -9379,6 +9389,20 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} was not visible in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_absent") {
+    const key = selectorKey(check);
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) > 0);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} was present in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_count_at_least") {
     const key = selectorKey(check);
     const minCount = check.min_count ?? 1;
@@ -9395,6 +9419,22 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+    const key = selectorKey(check);
+    const expectedCount = check.expected_count ?? 0;
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) !== expectedCount);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_count: expectedCount,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} count did not equal ${expectedCount} in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_text_order") {
     const key = selectorKey(check);
     const expectedTexts = check.expected_texts || [];
@@ -10131,6 +10171,18 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_absent") {
+      const selector = check.selector || "";
+      const failed = viewports.filter((viewport) => viewport.selectors && viewport.selectors[selector] && viewport.selectors[selector].count > 0);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " was present in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_count_at_least") {
       const selector = check.selector || "";
       const minCount = check.min_count == null ? 1 : check.min_count;
@@ -10144,6 +10196,19 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+      const selector = check.selector || "";
+      const expectedCount = check.expected_count == null ? 0 : check.expected_count;
+      const failed = viewports.filter((viewport) => (viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) !== expectedCount);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, expected_count: expectedCount, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " count did not equal " + expectedCount + " in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_text_order") {
       const selector = check.selector || "";
       const expectedTexts = check.expected_texts || [];
@@ -10462,7 +10527,9 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
-        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const responseIndex = responses.length
+          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          : null;
         const response = responseIndex === null ? mock : responses[responseIndex];
         const headers = { ...(response.headers || mock.headers || {}) };
         let body = response.body || "";
@@ -10477,7 +10544,8 @@ async function registerNetworkMocks(mocks) {
           response_label: response.label || null,
           hit_index: hitIndex,
           response_index: responseIndex,
-          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
+          sequence_reused: responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
+          sequence_cycle: responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
           url: request.url(),
           method,
           status: response.status || mock.status || 200,
@@ -11157,7 +11225,16 @@ async function captureViewport(viewport) {
   const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
-    if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
+    if (
+      (
+        check.type === "selector_visible"
+        || check.type === "selector_absent"
+        || check.type === "selector_count_at_least"
+        || check.type === "selector_count_equals"
+        || check.type === "selector_count_equal"
+        || check.type === "selector_count_eq"
+      ) && check.selector
+    ) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
     if (check.type === "selector_text_order" && check.selector) {

package/dist/index.js

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

package/dist/profile.cjs

@@ -56,7 +56,11 @@ var RIDDLE_PROOF_PROFILE_STATUSES = [
 var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "route_loaded",
   "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",
@@ -304,6 +308,7 @@ function normalizeNetworkMock(input, index) {
     url,
     method: stringValue(input.method)?.toUpperCase(),
     responses,
+    repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
     required_hit_count: requiredHitCount,
     required: input.required === false ? false : true
   };
@@ -395,7 +400,7 @@ function normalizeCheck(input, index) {
   if (!isSupportedCheckType(type)) {
     throw new Error(`checks[${index}].type ${type} is not supported. Supported checks: ${RIDDLE_PROOF_PROFILE_CHECK_TYPES.join(", ")}`);
   }
-  if ((type === "selector_visible" || type === "selector_count_at_least") && !stringValue(input.selector)) {
+  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)) {
@@ -410,6 +415,10 @@ function normalizeCheck(input, index) {
   if (type === "selector_count_at_least" && numberValue(input.min_count) === void 0) {
     throw new Error(`checks[${index}] selector_count_at_least requires min_count.`);
   }
+  const expectedCount = numberValue(input.expected_count) ?? numberValue(input.expectedCount) ?? numberValue(input.count);
+  if ((type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && expectedCount === void 0) {
+    throw new Error(`checks[${index}] ${type} requires expected_count.`);
+  }
   const expectedTexts = normalizeExpectedTexts(input.expected_texts ?? input.expectedTexts, index);
   if (type === "selector_text_order") {
     if (!stringValue(input.selector)) throw new Error(`checks[${index}] selector_text_order requires selector.`);
@@ -441,6 +450,7 @@ function normalizeCheck(input, index) {
     allowed_page_error_texts: normalizeStringList(input.allowed_page_error_texts ?? input.allowedPageErrorTexts ?? input.allow_page_error_texts ?? input.allowPageErrorTexts, `checks[${index}] allowed_page_error_texts`),
     allowed_page_error_patterns: normalizeStringList(input.allowed_page_error_patterns ?? input.allowedPageErrorPatterns ?? input.allow_page_error_patterns ?? input.allowPageErrorPatterns, `checks[${index}] allowed_page_error_patterns`),
     min_count: numberValue(input.min_count),
+    expected_count: expectedCount,
     max_overflow_px: numberValue(input.max_overflow_px),
     timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
@@ -708,6 +718,20 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} was not visible in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_absent") {
+    const key = selectorKey(check);
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) > 0);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} was present in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_count_at_least") {
     const key = selectorKey(check);
     const minCount = check.min_count ?? 1;
@@ -724,6 +748,22 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed.length ? `Selector ${key} count was below ${minCount} in ${failed.length} viewport(s).` : void 0
     };
   }
+  if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+    const key = selectorKey(check);
+    const expectedCount = check.expected_count ?? 0;
+    const failed = viewports.filter((viewport) => (viewport.selectors?.[key]?.count || 0) !== expectedCount);
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed.length ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_count: expectedCount,
+        counts: viewports.map((viewport) => viewport.selectors?.[key]?.count || 0)
+      },
+      message: failed.length ? `Selector ${key} count did not equal ${expectedCount} in ${failed.length} viewport(s).` : void 0
+    };
+  }
   if (check.type === "selector_text_order") {
     const key = selectorKey(check);
     const expectedTexts = check.expected_texts || [];
@@ -1460,6 +1500,18 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_absent") {
+      const selector = check.selector || "";
+      const failed = viewports.filter((viewport) => viewport.selectors && viewport.selectors[selector] && viewport.selectors[selector].count > 0);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " was present in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_count_at_least") {
       const selector = check.selector || "";
       const minCount = check.min_count == null ? 1 : check.min_count;
@@ -1473,6 +1525,19 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "selector_count_equals" || check.type === "selector_count_equal" || check.type === "selector_count_eq") {
+      const selector = check.selector || "";
+      const expectedCount = check.expected_count == null ? 0 : check.expected_count;
+      const failed = viewports.filter((viewport) => (viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) !== expectedCount);
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed.length ? "failed" : "passed",
+        evidence: { selector, expected_count: expectedCount, counts: viewports.map((viewport) => viewport.selectors && viewport.selectors[selector] ? viewport.selectors[selector].count : 0) },
+        message: failed.length ? "Selector " + selector + " count did not equal " + expectedCount + " in " + failed.length + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "selector_text_order") {
       const selector = check.selector || "";
       const expectedTexts = check.expected_texts || [];
@@ -1791,7 +1856,9 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
-        const responseIndex = responses.length ? Math.min(hitIndex, responses.length - 1) : null;
+        const responseIndex = responses.length
+          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          : null;
         const response = responseIndex === null ? mock : responses[responseIndex];
         const headers = { ...(response.headers || mock.headers || {}) };
         let body = response.body || "";
@@ -1806,7 +1873,8 @@ async function registerNetworkMocks(mocks) {
           response_label: response.label || null,
           hit_index: hitIndex,
           response_index: responseIndex,
-          sequence_reused: responseIndex !== null && hitIndex >= responses.length,
+          sequence_reused: responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
+          sequence_cycle: responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
           url: request.url(),
           method,
           status: response.status || mock.status || 200,
@@ -2486,7 +2554,16 @@ async function captureViewport(viewport) {
   const text_sequences = {};
   const text_matches = {};
   for (const check of profile.checks || []) {
-    if ((check.type === "selector_visible" || check.type === "selector_count_at_least") && check.selector) {
+    if (
+      (
+        check.type === "selector_visible"
+        || check.type === "selector_absent"
+        || check.type === "selector_count_at_least"
+        || check.type === "selector_count_equals"
+        || check.type === "selector_count_equal"
+        || check.type === "selector_count_eq"
+      ) && check.selector
+    ) {
       selectors[check.selector] = await selectorStats(check.selector);
     }
     if (check.type === "selector_text_order" && 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", "selector_visible", "selector_count_at_least", "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", "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_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
@@ -47,6 +47,7 @@ interface RiddleProofProfileNetworkMock extends RiddleProofProfileNetworkMockRes
     url: string;
     method?: string;
     responses?: RiddleProofProfileNetworkMockResponse[];
+    repeat_responses?: boolean;
     required_hit_count?: number;
     required?: boolean;
 }
@@ -87,6 +88,7 @@ interface RiddleProofProfileCheck {
     allowed_page_error_texts?: string[];
     allowed_page_error_patterns?: string[];
     min_count?: number;
+    expected_count?: number;
     max_overflow_px?: number;
     timeout_ms?: number;
     run_direct_routes?: boolean;

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", "selector_visible", "selector_count_at_least", "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", "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_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
@@ -47,6 +47,7 @@ interface RiddleProofProfileNetworkMock extends RiddleProofProfileNetworkMockRes
     url: string;
     method?: string;
     responses?: RiddleProofProfileNetworkMockResponse[];
+    repeat_responses?: boolean;
     required_hit_count?: number;
     required?: boolean;
 }
@@ -87,6 +88,7 @@ interface RiddleProofProfileCheck {
     allowed_page_error_texts?: string[];
     allowed_page_error_patterns?: string[];
     min_count?: number;
+    expected_count?: number;
     max_overflow_px?: number;
     timeout_ms?: number;
     run_direct_routes?: boolean;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-RAVOICNN.js";
+} from "./chunk-MT2OZCCP.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.40",
+  "version": "0.7.42",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",