@riddledc/riddle-proof 0.7.82 → 0.7.84

package/README.md

@@ -59,7 +59,7 @@ without depending on another plugin runtime.
 ## Durable Loop CLI
 
 The package publishes `riddle-proof-loop` as a host-agnostic runner surface for
-Codex/CLI-style testing:
+CLI-style and sole-agent testing:
 
 ```sh
 riddle-proof-loop run --request-json request.json --checkpoint-mode yield
@@ -88,9 +88,9 @@ Flag-based `respond` refuses to submit generated placeholder payloads. If the
 checkpoint template includes `TODO` fields, provide a real `--payload-json`
 file/object before resuming the run.
 
-`--agent local` is the generic CLI executor slot. The current implementation
-uses the local Codex CLI adapter underneath, but the loop contract and CLI
-surface are intentionally not Codex-specific.
+`--agent local` is the generic CLI executor slot. A host can wire that slot to
+Codex, Claude Code, another local CLI, or a managed worker without changing the
+checkpoint, evidence, or proof-assessment contract.
 
 Visual/UI proof runs can pass `viewport_matrix` / `viewport_matrix_json` to the
 base loop. The runtime records the requested matrix, captures per-viewport
@@ -676,7 +676,7 @@ terminal proof failure. If `--wait` exhausts its attempts before a terminal job
 status, the command exits non-zero and the result explains the last observed
 status and `submitted_at` state.
 
-## OpenClaw Adapter Boundary
+## Base vs OpenClaw Wrapper Boundary
 
 `@riddledc/riddle-proof/openclaw` translates OpenClaw Riddle Proof tool params
 into generic `RiddleProofRunParams`.
@@ -689,6 +689,27 @@ Generic authenticated proof inputs are preserved as pass-through JSON strings:
 those for public integrations; reserve `use_auth` for a configured, site-specific
 auth helper.
 
+Keep behavior in base `@riddledc/riddle-proof` when it changes the portable run
+contract or evidence semantics:
+
+- checkpoint packets and responses
+- profile, audit/no-diff, and proof-of-change run modes
+- viewport matrices and per-viewport artifact metadata
+- visual-delta thresholds, changed-region evidence, and evidence recovery gates
+- run state, run cards, result objects, proof sessions, and evidence bundles
+- generic auth/header/local storage inputs
+
+Keep behavior in the OpenClaw wrapper when it only concerns OpenClaw hosting or
+presentation:
+
+- OpenClaw tool registration and schema wording
+- Discord thread/status formatting
+- OpenClaw workflow labels such as interactive, background PR, and continuous
+- PR handoff/status phrasing such as `ship_mode=none`
+- checkpoint packet display and review UX
+- configured site-specific auth helpers
+- wrapper deployment, hot reload, and notification adapters
+
 The adapter does not invoke another OpenClaw plugin and does not supply a
 coding agent. It is the reusable mapping layer a future OpenClaw wrapper can
 call before handing the request to its configured implementation, judge, ship,

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

@@ -226,11 +226,12 @@ 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 successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -254,7 +255,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,
@@ -491,6 +493,7 @@ 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`),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1063,6 +1066,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,7 +1453,21 @@ 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) {
@@ -1457,12 +1481,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)) {
       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 +1498,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_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 +1888,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,11 +2043,14 @@ 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 successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -2051,7 +2086,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,
@@ -2174,7 +2210,21 @@ 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) {
@@ -2188,12 +2238,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)) {
         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 +2255,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
+          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_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,
@@ -3946,7 +3997,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,11 +7113,12 @@ 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 successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -7141,7 +7142,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,
@@ -7378,6 +7380,7 @@ 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`),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -7950,6 +7953,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,7 +8340,21 @@ 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) {
@@ -8344,12 +8368,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)) {
       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 +8385,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_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 +8759,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,11 +8914,14 @@ 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 successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -8922,7 +8957,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,
@@ -9045,7 +9081,21 @@ 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) {
@@ -9059,12 +9109,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)) {
         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 +9126,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
+          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_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,
@@ -10817,7 +10868,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-QC42KDBD.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -8954,11 +8954,12 @@ 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 successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -8982,7 +8983,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,
@@ -9219,6 +9221,7 @@ 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`),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -9791,6 +9794,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,7 +10181,21 @@ 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) {
@@ -10185,12 +10209,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)) {
       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 +10226,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_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 +10616,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,11 +10771,14 @@ 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 successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -10779,7 +10814,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,
@@ -10902,7 +10938,21 @@ 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) {
@@ -10916,12 +10966,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)) {
         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 +10983,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
+          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_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,
@@ -12674,7 +12725,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-QC42KDBD.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -269,11 +269,12 @@ 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 successfulClicks = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -297,7 +298,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,
@@ -534,6 +536,7 @@ 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`),
     continue_on_failure: input.continue_on_failure === true || input.continueOnFailure === true
   };
 }
@@ -1106,6 +1109,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,7 +1496,21 @@ 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) {
@@ -1500,12 +1524,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)) {
       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 +1541,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_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 +1931,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,11 +2086,14 @@ 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 successfulClicks = results.filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false);
@@ -2094,7 +2129,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,
@@ -2217,7 +2253,21 @@ 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) {
@@ -2231,12 +2281,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)) {
         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 +2298,12 @@ function assessProfile(profile, evidence) {
         action_count: actionCount,
         viewports: viewports.map((viewport) => ({
           name: viewport.name,
-          ok: (viewport.setup_action_results || []).length >= actionCount
+          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_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,
@@ -3989,7 +4040,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,7 @@ interface RiddleProofProfileSetupAction {
     repeat?: number;
     reload?: boolean;
     storage?: "local" | "session" | "both";
+    viewports?: string[];
     continue_on_failure?: boolean;
 }
 interface RiddleProofProfileNetworkMockResponse {

package/dist/profile.d.ts

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

package/dist/profile.js

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