@riddledc/riddle-proof 0.7.84 → 0.7.86

package/dist/{chunk-QC42KDBD.js → chunk-3Y35UIZO.js}

@@ -233,7 +233,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result.ok === false);
+      const failed = results.filter((result) => result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -276,6 +277,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason ?? result.error ?? null
+        })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason ?? result.error ?? null
         }))
       };
     })
@@ -494,6 +502,7 @@ function normalizeSetupAction(input, index) {
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     viewports: normalizeStringList(input.viewports ?? input.viewport_names ?? input.viewportNames, `target.setup_actions[${index}] viewports`),
+    optional: input.optional === true || input.required === false,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1470,7 +1479,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     expectedActionCountByViewport.set(viewport.name, expectedActionCount);
     const results = viewport.setup_action_results || [];
     for (const result of results) {
-      if (result.ok === false) {
+      if (result.ok === false && result.optional !== true) {
         failed.push({
           viewport: viewport.name,
           action: result.action ?? result.type ?? null,
@@ -1481,7 +1490,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < expectedActionCount && results.every((result) => result.ok !== false)) {
+    if (results.length < expectedActionCount && results.every((result) => result.ok !== false || result.optional === true)) {
       failed.push({
         viewport: viewport.name,
         action: "setup_actions",
@@ -1499,7 +1508,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
         expected_action_count: expectedActionCountByViewport.get(viewport.name) ?? actionCount,
-        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
       setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
@@ -2052,7 +2061,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result && result.ok === false);
+      const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
@@ -2108,6 +2118,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
           frame_selector: result.frame_selector ?? null,
           reason: result.reason || result.error || null,
         })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason || result.error || null,
+        })),
       };
     }),
   };
@@ -2227,7 +2244,7 @@ function assessProfile(profile, evidence) {
       expectedActionCountsByViewport[viewport.name] = expectedActionCount;
       const results = viewport.setup_action_results || [];
       for (const result of results) {
-        if (result && result.ok === false) {
+        if (result && result.ok === false && result.optional !== true) {
           failed.push({
             viewport: viewport.name,
           action: result.action || result.type || null,
@@ -2238,7 +2255,7 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false)) {
+      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false || result.optional === true)) {
         failed.push({
           viewport: viewport.name,
           action: "setup_actions",
@@ -2257,7 +2274,7 @@ function assessProfile(profile, evidence) {
           name: viewport.name,
           expected_action_count: expectedActionCountsByViewport[viewport.name] ?? actionCount,
           ok: (viewport.setup_action_results || []).length >= (expectedActionCountsByViewport[viewport.name] ?? actionCount)
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
         setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
@@ -3054,7 +3071,7 @@ async function registerNetworkMocks(mocks) {
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
-  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null };
+  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null, optional: action.optional === true };
   const timeout = setupNumber(action.timeout_ms, 5000);
   try {
     if (type === "wait") {
@@ -3528,7 +3545,7 @@ async function executeSetupActions(actions, viewport) {
         : result);
       const afterMs = setupNumber(action.after_ms, 0);
       if (afterMs) await page.waitForTimeout(afterMs);
-      if (result.ok === false && action.continue_on_failure !== true) {
+      if (result.ok === false && action.continue_on_failure !== true && action.optional !== true) {
         shouldStop = true;
         break;
       }

package/dist/cli.cjs

@@ -7120,7 +7120,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result.ok === false);
+      const failed = results.filter((result) => result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -7163,6 +7164,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason ?? result.error ?? null
+        })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason ?? result.error ?? null
         }))
       };
     })
@@ -7381,6 +7389,7 @@ function normalizeSetupAction(input, index) {
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     viewports: normalizeStringList(input.viewports ?? input.viewport_names ?? input.viewportNames, `target.setup_actions[${index}] viewports`),
+    optional: input.optional === true || input.required === false,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -8357,7 +8366,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     expectedActionCountByViewport.set(viewport.name, expectedActionCount);
     const results = viewport.setup_action_results || [];
     for (const result of results) {
-      if (result.ok === false) {
+      if (result.ok === false && result.optional !== true) {
         failed.push({
           viewport: viewport.name,
           action: result.action ?? result.type ?? null,
@@ -8368,7 +8377,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < expectedActionCount && results.every((result) => result.ok !== false)) {
+    if (results.length < expectedActionCount && results.every((result) => result.ok !== false || result.optional === true)) {
       failed.push({
         viewport: viewport.name,
         action: "setup_actions",
@@ -8386,7 +8395,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
         expected_action_count: expectedActionCountByViewport.get(viewport.name) ?? actionCount,
-        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
       setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
@@ -8923,7 +8932,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result && result.ok === false);
+      const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
@@ -8979,6 +8989,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
           frame_selector: result.frame_selector ?? null,
           reason: result.reason || result.error || null,
         })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason || result.error || null,
+        })),
       };
     }),
   };
@@ -9098,7 +9115,7 @@ function assessProfile(profile, evidence) {
       expectedActionCountsByViewport[viewport.name] = expectedActionCount;
       const results = viewport.setup_action_results || [];
       for (const result of results) {
-        if (result && result.ok === false) {
+        if (result && result.ok === false && result.optional !== true) {
           failed.push({
             viewport: viewport.name,
           action: result.action || result.type || null,
@@ -9109,7 +9126,7 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false)) {
+      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false || result.optional === true)) {
         failed.push({
           viewport: viewport.name,
           action: "setup_actions",
@@ -9128,7 +9145,7 @@ function assessProfile(profile, evidence) {
           name: viewport.name,
           expected_action_count: expectedActionCountsByViewport[viewport.name] ?? actionCount,
           ok: (viewport.setup_action_results || []).length >= (expectedActionCountsByViewport[viewport.name] ?? actionCount)
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
         setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
@@ -9925,7 +9942,7 @@ async function registerNetworkMocks(mocks) {
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
-  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null };
+  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null, optional: action.optional === true };
   const timeout = setupNumber(action.timeout_ms, 5000);
   try {
     if (type === "wait") {
@@ -10399,7 +10416,7 @@ async function executeSetupActions(actions, viewport) {
         : result);
       const afterMs = setupNumber(action.after_ms, 0);
       if (afterMs) await page.waitForTimeout(afterMs);
-      if (result.ok === false && action.continue_on_failure !== true) {
+      if (result.ok === false && action.continue_on_failure !== true && action.optional !== true) {
         shouldStop = true;
         break;
       }
@@ -11239,7 +11256,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -11301,6 +11318,9 @@ function optionNumber(options, ...keys) {
   }
   return void 0;
 }
+function profileOutputDirOption(options) {
+  return optionString(options, "output") ?? optionString(options, "outputDir");
+}
 function readStdin() {
   return (0, import_node_fs6.readFileSync)(0, "utf-8");
 }
@@ -11918,7 +11938,7 @@ async function main() {
   if (command === "run-profile") {
     const profile = normalizeProfileForCli(options);
     const result = await runProfileForCli(profile, options);
-    writeProfileOutput(optionString(options, "output"), result);
+    writeProfileOutput(profileOutputDirOption(options), result);
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     process.exitCode = profileStatusExitCode(profile, result.status);

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-QC42KDBD.js";
+} from "./chunk-3Y35UIZO.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -44,7 +44,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -106,6 +106,9 @@ function optionNumber(options, ...keys) {
   }
   return void 0;
 }
+function profileOutputDirOption(options) {
+  return optionString(options, "output") ?? optionString(options, "outputDir");
+}
 function readStdin() {
   return readFileSync(0, "utf-8");
 }
@@ -723,7 +726,7 @@ async function main() {
   if (command === "run-profile") {
     const profile = normalizeProfileForCli(options);
     const result = await runProfileForCli(profile, options);
-    writeProfileOutput(optionString(options, "output"), result);
+    writeProfileOutput(profileOutputDirOption(options), result);
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     process.exitCode = profileStatusExitCode(profile, result.status);

package/dist/index.cjs

@@ -8961,7 +8961,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result.ok === false);
+      const failed = results.filter((result) => result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -9004,6 +9005,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason ?? result.error ?? null
+        })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason ?? result.error ?? null
         }))
       };
     })
@@ -9222,6 +9230,7 @@ function normalizeSetupAction(input, index) {
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     viewports: normalizeStringList(input.viewports ?? input.viewport_names ?? input.viewportNames, `target.setup_actions[${index}] viewports`),
+    optional: input.optional === true || input.required === false,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -10198,7 +10207,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     expectedActionCountByViewport.set(viewport.name, expectedActionCount);
     const results = viewport.setup_action_results || [];
     for (const result of results) {
-      if (result.ok === false) {
+      if (result.ok === false && result.optional !== true) {
         failed.push({
           viewport: viewport.name,
           action: result.action ?? result.type ?? null,
@@ -10209,7 +10218,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < expectedActionCount && results.every((result) => result.ok !== false)) {
+    if (results.length < expectedActionCount && results.every((result) => result.ok !== false || result.optional === true)) {
       failed.push({
         viewport: viewport.name,
         action: "setup_actions",
@@ -10227,7 +10236,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
         expected_action_count: expectedActionCountByViewport.get(viewport.name) ?? actionCount,
-        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
       setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
@@ -10780,7 +10789,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result && result.ok === false);
+      const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
@@ -10836,6 +10846,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
           frame_selector: result.frame_selector ?? null,
           reason: result.reason || result.error || null,
         })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason || result.error || null,
+        })),
       };
     }),
   };
@@ -10955,7 +10972,7 @@ function assessProfile(profile, evidence) {
       expectedActionCountsByViewport[viewport.name] = expectedActionCount;
       const results = viewport.setup_action_results || [];
       for (const result of results) {
-        if (result && result.ok === false) {
+        if (result && result.ok === false && result.optional !== true) {
           failed.push({
             viewport: viewport.name,
           action: result.action || result.type || null,
@@ -10966,7 +10983,7 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false)) {
+      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false || result.optional === true)) {
         failed.push({
           viewport: viewport.name,
           action: "setup_actions",
@@ -10985,7 +11002,7 @@ function assessProfile(profile, evidence) {
           name: viewport.name,
           expected_action_count: expectedActionCountsByViewport[viewport.name] ?? actionCount,
           ok: (viewport.setup_action_results || []).length >= (expectedActionCountsByViewport[viewport.name] ?? actionCount)
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
         setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
@@ -11782,7 +11799,7 @@ async function registerNetworkMocks(mocks) {
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
-  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null };
+  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null, optional: action.optional === true };
   const timeout = setupNumber(action.timeout_ms, 5000);
   try {
     if (type === "wait") {
@@ -12256,7 +12273,7 @@ async function executeSetupActions(actions, viewport) {
         : result);
       const afterMs = setupNumber(action.after_ms, 0);
       if (afterMs) await page.waitForTimeout(afterMs);
-      if (result.ok === false && action.continue_on_failure !== true) {
+      if (result.ok === false && action.continue_on_failure !== true && action.optional !== true) {
         shouldStop = true;
         break;
       }

package/dist/index.js

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

package/dist/profile.cjs

@@ -276,7 +276,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
     viewports: viewports.map((viewport) => {
       const expectedActionCount = expectedActionCountByViewport?.get(viewport.name) ?? actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result.ok === false);
+      const failed = results.filter((result) => result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks.map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0).filter((value) => value !== void 0);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -319,6 +320,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
           selector: result.selector ?? null,
           frame_selector: result.frame_selector ?? null,
           reason: result.reason ?? result.error ?? null
+        })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason ?? result.error ?? null
         }))
       };
     })
@@ -537,6 +545,7 @@ function normalizeSetupAction(input, index) {
     reload: input.reload === true,
     storage: normalizeSetupActionStorage(input.storage, index),
     viewports: normalizeStringList(input.viewports ?? input.viewport_names ?? input.viewportNames, `target.setup_actions[${index}] viewports`),
+    optional: input.optional === true || input.required === false,
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1513,7 +1522,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
     expectedActionCountByViewport.set(viewport.name, expectedActionCount);
     const results = viewport.setup_action_results || [];
     for (const result of results) {
-      if (result.ok === false) {
+      if (result.ok === false && result.optional !== true) {
         failed.push({
           viewport: viewport.name,
           action: result.action ?? result.type ?? null,
@@ -1524,7 +1533,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < expectedActionCount && results.every((result) => result.ok !== false)) {
+    if (results.length < expectedActionCount && results.every((result) => result.ok !== false || result.optional === true)) {
       failed.push({
         viewport: viewport.name,
         action: "setup_actions",
@@ -1542,7 +1551,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
         expected_action_count: expectedActionCountByViewport.get(viewport.name) ?? actionCount,
-        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        ok: (viewport.setup_action_results || []).length >= (expectedActionCountByViewport.get(viewport.name) ?? actionCount) && (viewport.setup_action_results || []).every((result) => result.ok !== false || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
       setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
@@ -2095,7 +2104,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         ? expectedActionCountsByViewport[viewport.name]
         : actionCount;
       const results = viewport.setup_action_results || [];
-      const failed = results.filter((result) => result && result.ok === false);
+      const failed = results.filter((result) => result && result.ok === false && result.optional !== true);
+      const optionalFailed = results.filter((result) => result && result.ok === false && result.optional === true);
       const successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
       const clickCountValues = successfulClicks
         .map((result) => typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : undefined)
@@ -2151,6 +2161,13 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
           frame_selector: result.frame_selector ?? null,
           reason: result.reason || result.error || null,
         })),
+        optional_failed: optionalFailed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason || result.error || null,
+        })),
       };
     }),
   };
@@ -2270,7 +2287,7 @@ function assessProfile(profile, evidence) {
       expectedActionCountsByViewport[viewport.name] = expectedActionCount;
       const results = viewport.setup_action_results || [];
       for (const result of results) {
-        if (result && result.ok === false) {
+        if (result && result.ok === false && result.optional !== true) {
           failed.push({
             viewport: viewport.name,
           action: result.action || result.type || null,
@@ -2281,7 +2298,7 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false)) {
+      if (results.length < expectedActionCount && results.every((result) => !result || result.ok !== false || result.optional === true)) {
         failed.push({
           viewport: viewport.name,
           action: "setup_actions",
@@ -2300,7 +2317,7 @@ function assessProfile(profile, evidence) {
           name: viewport.name,
           expected_action_count: expectedActionCountsByViewport[viewport.name] ?? actionCount,
           ok: (viewport.setup_action_results || []).length >= (expectedActionCountsByViewport[viewport.name] ?? actionCount)
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
         setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
@@ -3097,7 +3114,7 @@ async function registerNetworkMocks(mocks) {
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
-  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null };
+  const base = { ok: false, action: type || "unknown", ordinal, selector: action.selector || null, frame_selector: frameSelector || null, optional: action.optional === true };
   const timeout = setupNumber(action.timeout_ms, 5000);
   try {
     if (type === "wait") {
@@ -3571,7 +3588,7 @@ async function executeSetupActions(actions, viewport) {
         : result);
       const afterMs = setupNumber(action.after_ms, 0);
       if (afterMs) await page.waitForTimeout(afterMs);
-      if (result.ok === false && action.continue_on_failure !== true) {
+      if (result.ok === false && action.continue_on_failure !== true && action.optional !== true) {
         shouldStop = true;
         break;
       }

package/dist/profile.d.cts

@@ -57,6 +57,7 @@ interface RiddleProofProfileSetupAction {
     reload?: boolean;
     storage?: "local" | "session" | "both";
     viewports?: string[];
+    optional?: boolean;
     continue_on_failure?: boolean;
 }
 interface RiddleProofProfileNetworkMockResponse {

package/dist/profile.d.ts

@@ -57,6 +57,7 @@ interface RiddleProofProfileSetupAction {
     reload?: boolean;
     storage?: "local" | "session" | "both";
     viewports?: string[];
+    optional?: boolean;
     continue_on_failure?: boolean;
 }
 interface RiddleProofProfileNetworkMockResponse {

package/dist/profile.js

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