@riddledc/riddle-proof 0.7.41 → 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" }
@@ -252,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-6MVVU54I.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",
@@ -353,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)) {
@@ -368,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.`);
@@ -399,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,
@@ -666,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;
@@ -682,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 || [];
@@ -1418,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;
@@ -1431,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 || [];
@@ -2447,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",
@@ -7226,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)) {
@@ -7241,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.`);
@@ -7272,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,
@@ -7539,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;
@@ -7555,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 || [];
@@ -8275,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;
@@ -8288,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 || [];
@@ -9304,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-6MVVU54I.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",
@@ -9067,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)) {
@@ -9082,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.`);
@@ -9113,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,
@@ -9380,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;
@@ -9396,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 || [];
@@ -10132,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;
@@ -10145,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 || [];
@@ -11161,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-6MVVU54I.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",
@@ -396,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)) {
@@ -411,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.`);
@@ -442,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,
@@ -709,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;
@@ -725,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 || [];
@@ -1461,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;
@@ -1474,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 || [];
@@ -2490,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];
@@ -88,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];
@@ -88,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-6MVVU54I.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.41",
+  "version": "0.7.42",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",