@riddledc/riddle-proof 0.7.83 → 0.7.85

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

@@ -226,13 +226,15 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
     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) => {
@@ -254,7 +256,8 @@ function profileSetupSummary(viewports, actionCount) {
       })).filter((item) => item.text).slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === void 0 ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === void 0 ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route?.observed ?? null,
         final_url: viewport.url ?? null,
@@ -274,6 +277,13 @@ function profileSetupSummary(viewports, actionCount) {
           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
         }))
       };
     })
@@ -491,6 +501,8 @@ function normalizeSetupAction(input, index) {
     repeat: normalizeSetupActionRepeat(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
   };
 }
@@ -1063,6 +1075,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!action.viewports?.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function assessCheckFromEvidence(check, evidence) {
   const viewports = viewportsForCheck(check, evidence.viewports || []);
   if (!viewports.length) {
@@ -1443,10 +1462,24 @@ function assessSetupActionsFromEvidence(profile, evidence) {
   const actionCount = profile.target.setup_actions.length;
   const failed = [];
   const viewports = evidence.viewports || [];
+  const expectedActionCountByViewport = /* @__PURE__ */ new Map();
+  const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+  for (const action of profile.target.setup_actions) {
+    if (action.viewports?.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+      failed.push({
+        viewport: null,
+        action: action.type,
+        selector: action.selector ?? null,
+        reason: `setup action scoped to missing viewport(s): ${action.viewports.join(", ")}`
+      });
+    }
+  }
   for (const viewport of viewports) {
+    const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+    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,
@@ -1457,12 +1490,12 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < actionCount && 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",
         selector: null,
-        reason: `missing setup action results: ${results.length}/${actionCount}`
+        reason: `missing setup action results: ${results.length}/${expectedActionCount}`
       });
     }
   }
@@ -1474,10 +1507,11 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       action_count: actionCount,
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
-        ok: (viewport.setup_action_results || []).length >= actionCount && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        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 || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -1863,6 +1897,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!Array.isArray(action.viewports) || !action.viewports.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function summarizeRouteInventory(viewport, inventory) {
   const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
@@ -2011,13 +2052,17 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
     viewports: (viewports || []).map((viewport) => {
+      const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
+        ? 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)
@@ -2051,7 +2096,8 @@ function profileSetupSummary(viewports, actionCount) {
         .slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === undefined ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === undefined ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route && viewport.route.observed || null,
         final_url: viewport.url || null,
@@ -2072,6 +2118,13 @@ function profileSetupSummary(viewports, actionCount) {
           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,
+        })),
       };
     }),
   };
@@ -2174,10 +2227,24 @@ function assessProfile(profile, evidence) {
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
+    const expectedActionCountsByViewport = {};
+    const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+    for (const action of profile.target.setup_actions) {
+      if (Array.isArray(action.viewports) && action.viewports.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+        failed.push({
+          viewport: null,
+          action: action.type,
+          selector: action.selector || null,
+          reason: "setup action scoped to missing viewport(s): " + action.viewports.join(", "),
+        });
+      }
+    }
     for (const viewport of viewports) {
+      const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+      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,
@@ -2188,12 +2255,12 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < actionCount && 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",
           selector: null,
-          reason: "missing setup action results: " + results.length + "/" + actionCount,
+          reason: "missing setup action results: " + results.length + "/" + expectedActionCount,
         });
       }
     }
@@ -2205,11 +2272,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+          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 || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -3003,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") {
@@ -3477,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;
       }
@@ -3946,7 +4014,7 @@ async function captureViewport(viewport) {
     await page.waitForTimeout(profile.target.wait_ms);
   }
   const setupActionResults = (!navigationError && !waitError)
-    ? await executeSetupActions(profile.target.setup_actions || [], viewport)
+    ? await executeSetupActions(setupActionsForViewport(profile.target.setup_actions || [], viewport.name), viewport)
     : [];
   const dom = await page.evaluate(() => {
     const body = document.body;

package/dist/cli.cjs

@@ -7113,13 +7113,15 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
     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) => {
@@ -7141,7 +7143,8 @@ function profileSetupSummary(viewports, actionCount) {
       })).filter((item) => item.text).slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === void 0 ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === void 0 ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route?.observed ?? null,
         final_url: viewport.url ?? null,
@@ -7161,6 +7164,13 @@ function profileSetupSummary(viewports, actionCount) {
           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
         }))
       };
     })
@@ -7378,6 +7388,8 @@ function normalizeSetupAction(input, index) {
     repeat: normalizeSetupActionRepeat(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
   };
 }
@@ -7950,6 +7962,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!action.viewports?.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function assessCheckFromEvidence(check, evidence) {
   const viewports = viewportsForCheck(check, evidence.viewports || []);
   if (!viewports.length) {
@@ -8330,10 +8349,24 @@ function assessSetupActionsFromEvidence(profile, evidence) {
   const actionCount = profile.target.setup_actions.length;
   const failed = [];
   const viewports = evidence.viewports || [];
+  const expectedActionCountByViewport = /* @__PURE__ */ new Map();
+  const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+  for (const action of profile.target.setup_actions) {
+    if (action.viewports?.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+      failed.push({
+        viewport: null,
+        action: action.type,
+        selector: action.selector ?? null,
+        reason: `setup action scoped to missing viewport(s): ${action.viewports.join(", ")}`
+      });
+    }
+  }
   for (const viewport of viewports) {
+    const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+    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,
@@ -8344,12 +8377,12 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < actionCount && 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",
         selector: null,
-        reason: `missing setup action results: ${results.length}/${actionCount}`
+        reason: `missing setup action results: ${results.length}/${expectedActionCount}`
       });
     }
   }
@@ -8361,10 +8394,11 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       action_count: actionCount,
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
-        ok: (viewport.setup_action_results || []).length >= actionCount && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        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 || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -8734,6 +8768,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!Array.isArray(action.viewports) || !action.viewports.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function summarizeRouteInventory(viewport, inventory) {
   const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
@@ -8882,13 +8923,17 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
     viewports: (viewports || []).map((viewport) => {
+      const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
+        ? 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)
@@ -8922,7 +8967,8 @@ function profileSetupSummary(viewports, actionCount) {
         .slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === undefined ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === undefined ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route && viewport.route.observed || null,
         final_url: viewport.url || null,
@@ -8943,6 +8989,13 @@ function profileSetupSummary(viewports, actionCount) {
           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,
+        })),
       };
     }),
   };
@@ -9045,10 +9098,24 @@ function assessProfile(profile, evidence) {
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
+    const expectedActionCountsByViewport = {};
+    const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+    for (const action of profile.target.setup_actions) {
+      if (Array.isArray(action.viewports) && action.viewports.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+        failed.push({
+          viewport: null,
+          action: action.type,
+          selector: action.selector || null,
+          reason: "setup action scoped to missing viewport(s): " + action.viewports.join(", "),
+        });
+      }
+    }
     for (const viewport of viewports) {
+      const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+      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,
@@ -9059,12 +9126,12 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < actionCount && 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",
           selector: null,
-          reason: "missing setup action results: " + results.length + "/" + actionCount,
+          reason: "missing setup action results: " + results.length + "/" + expectedActionCount,
         });
       }
     }
@@ -9076,11 +9143,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+          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 || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -9874,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") {
@@ -10348,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;
       }
@@ -10817,7 +10885,7 @@ async function captureViewport(viewport) {
     await page.waitForTimeout(profile.target.wait_ms);
   }
   const setupActionResults = (!navigationError && !waitError)
-    ? await executeSetupActions(profile.target.setup_actions || [], viewport)
+    ? await executeSetupActions(setupActionsForViewport(profile.target.setup_actions || [], viewport.name), viewport)
     : [];
   const dom = await page.evaluate(() => {
     const body = document.body;

package/dist/cli.js

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

package/dist/index.cjs

@@ -8954,13 +8954,15 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
     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) => {
@@ -8982,7 +8984,8 @@ function profileSetupSummary(viewports, actionCount) {
       })).filter((item) => item.text).slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === void 0 ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === void 0 ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route?.observed ?? null,
         final_url: viewport.url ?? null,
@@ -9002,6 +9005,13 @@ function profileSetupSummary(viewports, actionCount) {
           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
         }))
       };
     })
@@ -9219,6 +9229,8 @@ function normalizeSetupAction(input, index) {
     repeat: normalizeSetupActionRepeat(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
   };
 }
@@ -9791,6 +9803,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!action.viewports?.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function assessCheckFromEvidence(check, evidence) {
   const viewports = viewportsForCheck(check, evidence.viewports || []);
   if (!viewports.length) {
@@ -10171,10 +10190,24 @@ function assessSetupActionsFromEvidence(profile, evidence) {
   const actionCount = profile.target.setup_actions.length;
   const failed = [];
   const viewports = evidence.viewports || [];
+  const expectedActionCountByViewport = /* @__PURE__ */ new Map();
+  const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+  for (const action of profile.target.setup_actions) {
+    if (action.viewports?.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+      failed.push({
+        viewport: null,
+        action: action.type,
+        selector: action.selector ?? null,
+        reason: `setup action scoped to missing viewport(s): ${action.viewports.join(", ")}`
+      });
+    }
+  }
   for (const viewport of viewports) {
+    const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+    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,
@@ -10185,12 +10218,12 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < actionCount && 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",
         selector: null,
-        reason: `missing setup action results: ${results.length}/${actionCount}`
+        reason: `missing setup action results: ${results.length}/${expectedActionCount}`
       });
     }
   }
@@ -10202,10 +10235,11 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       action_count: actionCount,
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
-        ok: (viewport.setup_action_results || []).length >= actionCount && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        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 || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -10591,6 +10625,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!Array.isArray(action.viewports) || !action.viewports.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function summarizeRouteInventory(viewport, inventory) {
   const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
@@ -10739,13 +10780,17 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
     viewports: (viewports || []).map((viewport) => {
+      const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
+        ? 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)
@@ -10779,7 +10824,8 @@ function profileSetupSummary(viewports, actionCount) {
         .slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === undefined ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === undefined ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route && viewport.route.observed || null,
         final_url: viewport.url || null,
@@ -10800,6 +10846,13 @@ function profileSetupSummary(viewports, actionCount) {
           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,
+        })),
       };
     }),
   };
@@ -10902,10 +10955,24 @@ function assessProfile(profile, evidence) {
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
+    const expectedActionCountsByViewport = {};
+    const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+    for (const action of profile.target.setup_actions) {
+      if (Array.isArray(action.viewports) && action.viewports.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+        failed.push({
+          viewport: null,
+          action: action.type,
+          selector: action.selector || null,
+          reason: "setup action scoped to missing viewport(s): " + action.viewports.join(", "),
+        });
+      }
+    }
     for (const viewport of viewports) {
+      const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+      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,
@@ -10916,12 +10983,12 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < actionCount && 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",
           selector: null,
-          reason: "missing setup action results: " + results.length + "/" + actionCount,
+          reason: "missing setup action results: " + results.length + "/" + expectedActionCount,
         });
       }
     }
@@ -10933,11 +11000,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+          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 || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -11731,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") {
@@ -12205,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;
       }
@@ -12674,7 +12742,7 @@ async function captureViewport(viewport) {
     await page.waitForTimeout(profile.target.wait_ms);
   }
   const setupActionResults = (!navigationError && !waitError)
-    ? await executeSetupActions(profile.target.setup_actions || [], viewport)
+    ? await executeSetupActions(setupActionsForViewport(profile.target.setup_actions || [], viewport.name), viewport)
     : [];
   const dom = await page.evaluate(() => {
     const body = document.body;

package/dist/index.js

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

package/dist/profile.cjs

@@ -269,13 +269,15 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountByViewport) {
   return toJsonValue({
     viewport_count: viewports.length,
     action_count: actionCount ?? null,
     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) => {
@@ -297,7 +299,8 @@ function profileSetupSummary(viewports, actionCount) {
       })).filter((item) => item.text).slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === void 0 ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === void 0 ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route?.observed ?? null,
         final_url: viewport.url ?? null,
@@ -317,6 +320,13 @@ function profileSetupSummary(viewports, actionCount) {
           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
         }))
       };
     })
@@ -534,6 +544,8 @@ function normalizeSetupAction(input, index) {
     repeat: normalizeSetupActionRepeat(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
   };
 }
@@ -1106,6 +1118,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!action.viewports?.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function assessCheckFromEvidence(check, evidence) {
   const viewports = viewportsForCheck(check, evidence.viewports || []);
   if (!viewports.length) {
@@ -1486,10 +1505,24 @@ function assessSetupActionsFromEvidence(profile, evidence) {
   const actionCount = profile.target.setup_actions.length;
   const failed = [];
   const viewports = evidence.viewports || [];
+  const expectedActionCountByViewport = /* @__PURE__ */ new Map();
+  const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+  for (const action of profile.target.setup_actions) {
+    if (action.viewports?.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+      failed.push({
+        viewport: null,
+        action: action.type,
+        selector: action.selector ?? null,
+        reason: `setup action scoped to missing viewport(s): ${action.viewports.join(", ")}`
+      });
+    }
+  }
   for (const viewport of viewports) {
+    const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+    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,
@@ -1500,12 +1533,12 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         });
       }
     }
-    if (results.length < actionCount && 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",
         selector: null,
-        reason: `missing setup action results: ${results.length}/${actionCount}`
+        reason: `missing setup action results: ${results.length}/${expectedActionCount}`
       });
     }
   }
@@ -1517,10 +1550,11 @@ function assessSetupActionsFromEvidence(profile, evidence) {
       action_count: actionCount,
       viewports: viewports.map((viewport) => ({
         name: viewport.name,
-        ok: (viewport.setup_action_results || []).length >= actionCount && (viewport.setup_action_results || []).every((result) => result.ok !== false),
+        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 || result.optional === true),
         result_count: (viewport.setup_action_results || []).length
       })),
-      setup_summary: profileSetupSummary(viewports, actionCount),
+      setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountByViewport),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -1906,6 +1940,13 @@ function viewportsForCheck(check, viewports) {
   const names = new Set(check.viewports);
   return viewports.filter((viewport) => names.has(viewport.name));
 }
+function setupActionAppliesToViewport(action, viewportName) {
+  if (!Array.isArray(action.viewports) || !action.viewports.length) return true;
+  return Boolean(viewportName && action.viewports.includes(viewportName));
+}
+function setupActionsForViewport(actions, viewportName) {
+  return (actions || []).filter((action) => setupActionAppliesToViewport(action, viewportName));
+}
 function summarizeRouteInventory(viewport, inventory) {
   const directRoutes = Array.isArray(inventory.direct_routes) ? inventory.direct_routes : [];
   const clickthroughs = Array.isArray(inventory.clickthroughs) ? inventory.clickthroughs : [];
@@ -2054,13 +2095,17 @@ function profileScreenshotLabels(viewports) {
   }
   return labels;
 }
-function profileSetupSummary(viewports, actionCount) {
+function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport) {
   return {
     viewport_count: (viewports || []).length,
     action_count: actionCount ?? null,
     viewports: (viewports || []).map((viewport) => {
+      const expectedActionCount = expectedActionCountsByViewport && expectedActionCountsByViewport[viewport.name] !== undefined
+        ? 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)
@@ -2094,7 +2139,8 @@ function profileSetupSummary(viewports, actionCount) {
         .slice(-6);
       return {
         name: viewport.name,
-        ok: (actionCount === undefined ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        expected_action_count: expectedActionCount ?? null,
+        ok: (expectedActionCount === undefined ? results.length > 0 : results.length >= expectedActionCount) && failed.length === 0,
         result_count: results.length,
         observed_path: viewport.route && viewport.route.observed || null,
         final_url: viewport.url || null,
@@ -2115,6 +2161,13 @@ function profileSetupSummary(viewports, actionCount) {
           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,
+        })),
       };
     }),
   };
@@ -2217,10 +2270,24 @@ function assessProfile(profile, evidence) {
   if (profile.target && Array.isArray(profile.target.setup_actions) && profile.target.setup_actions.length) {
     const actionCount = profile.target.setup_actions.length;
     const failed = [];
+    const expectedActionCountsByViewport = {};
+    const capturedViewportNames = new Set(viewports.map((viewport) => viewport.name));
+    for (const action of profile.target.setup_actions) {
+      if (Array.isArray(action.viewports) && action.viewports.length && !action.viewports.some((name) => capturedViewportNames.has(name))) {
+        failed.push({
+          viewport: null,
+          action: action.type,
+          selector: action.selector || null,
+          reason: "setup action scoped to missing viewport(s): " + action.viewports.join(", "),
+        });
+      }
+    }
     for (const viewport of viewports) {
+      const expectedActionCount = setupActionsForViewport(profile.target.setup_actions, viewport.name).length;
+      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,
@@ -2231,12 +2298,12 @@ function assessProfile(profile, evidence) {
         });
         }
       }
-      if (results.length < actionCount && 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",
           selector: null,
-          reason: "missing setup action results: " + results.length + "/" + actionCount,
+          reason: "missing setup action results: " + results.length + "/" + expectedActionCount,
         });
       }
     }
@@ -2248,11 +2315,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
-            && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
+          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 || result.optional === true),
           result_count: (viewport.setup_action_results || []).length,
         })),
-        setup_summary: profileSetupSummary(viewports, actionCount),
+        setup_summary: profileSetupSummary(viewports, actionCount, expectedActionCountsByViewport),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -3046,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") {
@@ -3520,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;
       }
@@ -3989,7 +4057,7 @@ async function captureViewport(viewport) {
     await page.waitForTimeout(profile.target.wait_ms);
   }
   const setupActionResults = (!navigationError && !waitError)
-    ? await executeSetupActions(profile.target.setup_actions || [], viewport)
+    ? await executeSetupActions(setupActionsForViewport(profile.target.setup_actions || [], viewport.name), viewport)
     : [];
   const dom = await page.evaluate(() => {
     const body = document.body;

package/dist/profile.d.cts

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

package/dist/profile.d.ts

@@ -56,6 +56,8 @@ interface RiddleProofProfileSetupAction {
     repeat?: number;
     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-3RUIKF4C.js";
+} from "./chunk-3Y35UIZO.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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "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: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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