@riddledc/riddle-proof 0.7.50 → 0.7.52

package/README.md

@@ -238,16 +238,21 @@ where the second request must carry newer state.
 appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
 `click`, `fill`, `set_input_value`, `assert_text_visible`,
-`assert_text_absent`, `assert_selector_count`, `local_storage`,
-`session_storage`, `clear_storage`, `wait`, `wait_for_selector`, and
-`wait_for_text`; a failed setup action is recorded as a failed
-`setup_actions_succeeded` check so the profile cannot pass without reaching
-the intended state. Text-matched `click` actions prefer visible matching
-elements, which keeps responsive layouts from selecting hidden desktop or
-mobile-only links. Use setup assertions when the pre-click or pre-navigation
-state is part of the contract, for example a fresh row must be present, stale
-copy must be absent, or exactly one source link must exist before clicking into
-the final route. `assert_selector_count` accepts `expected_count`.
+`assert_text_absent`, `assert_selector_count`, `assert_window_value`,
+`local_storage`, `session_storage`, `clear_storage`, `wait`,
+`wait_for_selector`, `wait_for_text`, and `window_call`; a failed setup action
+is recorded as a failed `setup_actions_succeeded` check so the profile cannot
+pass without reaching the intended state. Text-matched `click` actions prefer
+visible matching elements, which keeps responsive layouts from selecting hidden
+desktop or mobile-only links. Add `force: true` to a click action only when the
+matched visible element is intentionally animated or otherwise never becomes
+stable enough for Playwright's default click actionability checks. Use setup
+assertions when the pre-click or pre-navigation state is part of the contract,
+for example a fresh row must be present, stale copy must be absent, exactly one
+source link must exist before clicking into the final route, or a canvas app's
+proof state must expose a terminal flag. `assert_selector_count` accepts
+`expected_count`; `assert_window_value` accepts `path` / `state_path` plus
+`expected_value` / `expected` and compares JSON-safe values exactly.
 `local_storage` and `session_storage` accept a `key` plus string `value` or
 JSON `json` / `value_json`, and can reload the page with `reload: true`.
 `clear_storage` clears `local`, `session`, or `both` browser storage scopes,

package/dist/{chunk-5FHHNCX4.js → chunk-4S6RC5IJ.js}

@@ -35,6 +35,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -248,21 +249,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path) {
+  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     path,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -1976,6 +1983,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -2224,6 +2254,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -2253,8 +2330,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/cli.cjs

@@ -6908,6 +6908,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -7121,21 +7122,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path7 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path7) {
+  const path7 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path7) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     path: path7,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue2(input.text),
     pattern: stringValue2(input.pattern),
     flags: stringValue2(input.flags),
@@ -8833,6 +8840,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -9081,6 +9111,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -9110,8 +9187,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-5FHHNCX4.js";
+} from "./chunk-4S6RC5IJ.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8749,6 +8749,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -8962,21 +8963,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path6 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path6) {
+  const path6 = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path6) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     path: path6,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue5(input.text),
     pattern: stringValue5(input.pattern),
     flags: stringValue5(input.flags),
@@ -10690,6 +10697,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -10938,6 +10968,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -10967,8 +11044,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-5FHHNCX4.js";
+} from "./chunk-4S6RC5IJ.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -78,6 +78,7 @@ var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "assert_text_visible",
   "assert_text_absent",
   "assert_selector_count",
+  "assert_window_value",
   "local_storage",
   "session_storage",
   "clear_storage",
@@ -291,21 +292,27 @@ function normalizeSetupAction(input, index) {
   if ((type === "local_storage" || type === "session_storage") && value === void 0 && !hasJsonValue) {
     throw new Error(`target.setup_actions[${index}] ${type} requires value.`);
   }
-  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath");
-  if (type === "window_call" && !path) {
+  const path = stringFromOwn(input, "path", "function_path", "functionPath", "window_path", "windowPath", "state_path", "statePath");
+  if ((type === "window_call" || type === "assert_window_value") && !path) {
     throw new Error(`target.setup_actions[${index}] ${type} requires path.`);
   }
   const args = type === "window_call" ? normalizeSetupActionArgs(input, index) : void 0;
+  const hasExpectedValue = hasOwn(input, "expected_value") || hasOwn(input, "expectedValue") || hasOwn(input, "expected") || hasOwn(input, "expect_value") || hasOwn(input, "expectValue") || hasOwn(input, "expect");
+  if (type === "assert_window_value" && !hasExpectedValue) {
+    throw new Error(`target.setup_actions[${index}] ${type} requires expected_value.`);
+  }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     path,
     args,
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
+    expected_value: hasExpectedValue ? toJsonValue(valueFromOwn(input, "expected_value", "expectedValue", "expected", "expect_value", "expectValue", "expect")) : void 0,
     text: stringValue(input.text),
     pattern: stringValue(input.pattern),
     flags: stringValue(input.flags),
@@ -2019,6 +2026,29 @@ function setupJsonValue(value) {
 function setupValuesEqual(left, right) {
   return JSON.stringify(setupJsonValue(left)) === JSON.stringify(setupJsonValue(right));
 }
+async function setupReadWindowValue(path) {
+  return await page.evaluate(({ path }) => {
+    const toJsonValue = (value) => {
+      if (value === null || value === undefined) return null;
+      if (typeof value === "string" || typeof value === "boolean") return value;
+      if (typeof value === "number") return Number.isFinite(value) ? value : null;
+      if (Array.isArray(value)) return value.map(toJsonValue);
+      if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
+      }
+      return String(value);
+    };
+    const pathParts = String(path || "").split(".").map((part) => part.trim()).filter(Boolean);
+    if (!pathParts.length) return { ok: false, reason: "missing_path" };
+    let current = window;
+    for (const part of pathParts) {
+      if (current === null || current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+      current = current[part];
+      if (current === undefined) return { ok: false, reason: "path_not_found", missing_part: part };
+    }
+    return { ok: true, value: toJsonValue(current) };
+  }, { path });
+}
 async function setupLocatorText(locator, index) {
   return await locator.nth(index).textContent({ timeout: 1000 }).catch(() => "");
 }
@@ -2267,6 +2297,53 @@ async function executeSetupAction(action, ordinal) {
         error: result.error || undefined,
       };
     }
+    if (type === "assert_window_value") {
+      const path = String(action.path || action.window_path || action.windowPath || "");
+      const hasExpected = setupHasOwn(action, "expected_value")
+        || setupHasOwn(action, "expectedValue")
+        || setupHasOwn(action, "expected")
+        || setupHasOwn(action, "expect_value")
+        || setupHasOwn(action, "expectValue")
+        || setupHasOwn(action, "expect");
+      const expected = setupHasOwn(action, "expected_value")
+        ? action.expected_value
+        : setupHasOwn(action, "expectedValue")
+          ? action.expectedValue
+          : setupHasOwn(action, "expected")
+            ? action.expected
+            : setupHasOwn(action, "expect_value")
+              ? action.expect_value
+              : setupHasOwn(action, "expectValue")
+                ? action.expectValue
+                : action.expect;
+      if (!path) return { ...base, path, reason: "missing_path" };
+      if (!hasExpected) return { ...base, path, reason: "missing_expected_value" };
+      const startedAt = Date.now();
+      let result = null;
+      while (Date.now() - startedAt <= timeout) {
+        result = await setupReadWindowValue(path);
+        if (result.ok && setupValuesEqual(result.value, expected)) {
+          return {
+            ...base,
+            ok: true,
+            path,
+            value: setupJsonValue(result.value),
+            expected_value: setupJsonValue(expected),
+            timeout_ms: timeout,
+          };
+        }
+        await page.waitForTimeout(100);
+      }
+      return {
+        ...base,
+        path,
+        reason: result?.ok ? "unexpected_value" : result?.reason || "path_not_found",
+        missing_part: result?.missing_part || undefined,
+        value: setupJsonValue(result?.value),
+        expected_value: setupJsonValue(expected),
+        timeout_ms: timeout,
+      };
+    }
     if (type === "click") {
       const locator = page.locator(action.selector);
       const count = await locator.count();
@@ -2296,8 +2373,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/profile.d.cts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 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_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", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "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];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -20,12 +20,14 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    force?: boolean;
     key?: string;
     value?: string;
     value_json?: JsonValue;
     path?: string;
     args?: JsonValue[];
     expect_return?: JsonValue;
+    expected_value?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;

package/dist/profile.d.ts

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 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_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", "assert_text_visible", "assert_text_absent", "assert_selector_count", "local_storage", "session_storage", "clear_storage", "wait", "wait_for_selector", "wait_for_text", "window_call"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "fill", "set_input_value", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "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];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];
@@ -20,12 +20,14 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    force?: boolean;
     key?: string;
     value?: string;
     value_json?: JsonValue;
     path?: string;
     args?: JsonValue[];
     expect_return?: JsonValue;
+    expected_value?: JsonValue;
     text?: string;
     pattern?: string;
     flags?: string;

package/dist/profile.js

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