@riddledc/riddle-proof 0.7.125 → 0.7.126

package/README.md

@@ -346,6 +346,16 @@ cycle instead of reusing the final response, for example to repeat a fail-then-
 success pair across multiple viewports. Repeated sequences also record
 `sequence_cycle: true` after the first cycle.
 
+For full viewport-matrix retry profiles, set `sequence_scope: "viewport"` when
+each viewport should get its own first response, second response, and so on.
+This keeps a fail-then-success retry sequence from being consumed by the first
+viewport before phone or tablet runs begin. The mock evidence records both the
+global `hit_index` and viewport-local `sequence_hit_index`, plus the active
+`viewport`, so a run can show that each viewport exercised the same sequence.
+Use `required_hit_count` when the total expected calls matter, such as
+`responses.length * viewports.length` for a two-step retry across four
+viewports.
+
 Use `max_hit_count` / `max_hits` when a profile needs to prove a request does
 not run too many times. Use `forbidden: true` as shorthand for
 `max_hit_count: 0` and `required: false`, for example when a chat failure must

package/dist/{chunk-JVZWSI55.js → chunk-55KDZEB3.js}

@@ -596,6 +596,20 @@ function normalizeNetworkMock(input, index) {
   if (maxHitCount !== void 0 && effectiveRequiredHitCount > maxHitCount) {
     throw new Error(`target.network_mocks[${index}].max_hit_count cannot be less than its required hit count.`);
   }
+  const sequenceScopeInput = stringValue(
+    input.sequence_scope ?? input.sequenceScope ?? input.response_sequence_scope ?? input.responseSequenceScope
+  );
+  let sequenceScope;
+  if (sequenceScopeInput) {
+    const normalizedScope = sequenceScopeInput.toLowerCase().replace(/[-\s]+/g, "_");
+    if (normalizedScope === "global" || normalizedScope === "profile" || normalizedScope === "run") {
+      sequenceScope = "global";
+    } else if (normalizedScope === "viewport" || normalizedScope === "per_viewport" || normalizedScope === "viewport_scoped") {
+      sequenceScope = "viewport";
+    } else {
+      throw new Error(`target.network_mocks[${index}].sequence_scope must be "global" or "viewport".`);
+    }
+  }
   return {
     ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
@@ -603,6 +617,7 @@ function normalizeNetworkMock(input, index) {
     method: stringValue(input.method)?.toUpperCase(),
     responses,
     repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
+    sequence_scope: sequenceScope,
     required_hit_count: requiredHitCount,
     max_hit_count: maxHitCount,
     forbidden,
@@ -4254,6 +4269,7 @@ async function setupLocatorVisible(locator, index) {
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
     let hitCount = 0;
+    const scopedHitCounts = {};
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -4269,8 +4285,13 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
+        const sequenceScope = mock.sequence_scope === "viewport" ? "viewport" : "global";
+        const viewportName = activeViewportName || null;
+        const sequenceScopeKey = sequenceScope === "viewport" ? (viewportName || "__unknown_viewport__") : "__global__";
+        const sequenceHitIndex = sequenceScope === "viewport" ? (scopedHitCounts[sequenceScopeKey] || 0) : hitIndex;
+        if (sequenceScope === "viewport") scopedHitCounts[sequenceScopeKey] = sequenceHitIndex + 1;
         const sequenceResponseIndex = responses.length
-          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          ? (mock.repeat_responses ? sequenceHitIndex % responses.length : Math.min(sequenceHitIndex, responses.length - 1))
           : null;
         let responseIndex = sequenceResponseIndex;
         let responseSelection = responseIndex === null ? "mock" : "sequence";
@@ -4305,11 +4326,14 @@ async function registerNetworkMocks(mocks) {
           label: mock.label,
           response_label: response.label || null,
           hit_index: hitIndex,
+          sequence_hit_index: responseIndex === null ? undefined : sequenceHitIndex,
+          sequence_scope: responseIndex === null ? undefined : sequenceScope,
+          viewport: viewportName,
           response_index: responseIndex,
           sequence_response_index: responseSelection === "request_body" ? sequenceResponseIndex : undefined,
           response_selection: responseIndex === null ? null : responseSelection,
-          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
-          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
+          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && sequenceHitIndex >= responses.length,
+          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && sequenceHitIndex >= responses.length,
           url: request.url(),
           method,
         };
@@ -4351,6 +4375,7 @@ async function registerNetworkMocks(mocks) {
     });
   }
 }
+let activeViewportName = null;
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
@@ -5613,6 +5638,7 @@ async function collectRouteInventory(check, viewport) {
   };
 }
 async function captureViewport(viewport) {
+  activeViewportName = viewport && viewport.name ? viewport.name : null;
   await page.setViewportSize({ width: viewport.width, height: viewport.height });
   let httpStatus = null;
   let navigationError;

package/dist/cli.cjs

@@ -7533,6 +7533,20 @@ function normalizeNetworkMock(input, index) {
   if (maxHitCount !== void 0 && effectiveRequiredHitCount > maxHitCount) {
     throw new Error(`target.network_mocks[${index}].max_hit_count cannot be less than its required hit count.`);
   }
+  const sequenceScopeInput = stringValue2(
+    input.sequence_scope ?? input.sequenceScope ?? input.response_sequence_scope ?? input.responseSequenceScope
+  );
+  let sequenceScope;
+  if (sequenceScopeInput) {
+    const normalizedScope = sequenceScopeInput.toLowerCase().replace(/[-\s]+/g, "_");
+    if (normalizedScope === "global" || normalizedScope === "profile" || normalizedScope === "run") {
+      sequenceScope = "global";
+    } else if (normalizedScope === "viewport" || normalizedScope === "per_viewport" || normalizedScope === "viewport_scoped") {
+      sequenceScope = "viewport";
+    } else {
+      throw new Error(`target.network_mocks[${index}].sequence_scope must be "global" or "viewport".`);
+    }
+  }
   return {
     ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
@@ -7540,6 +7554,7 @@ function normalizeNetworkMock(input, index) {
     method: stringValue2(input.method)?.toUpperCase(),
     responses,
     repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
+    sequence_scope: sequenceScope,
     required_hit_count: requiredHitCount,
     max_hit_count: maxHitCount,
     forbidden,
@@ -11175,6 +11190,7 @@ async function setupLocatorVisible(locator, index) {
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
     let hitCount = 0;
+    const scopedHitCounts = {};
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -11190,8 +11206,13 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
+        const sequenceScope = mock.sequence_scope === "viewport" ? "viewport" : "global";
+        const viewportName = activeViewportName || null;
+        const sequenceScopeKey = sequenceScope === "viewport" ? (viewportName || "__unknown_viewport__") : "__global__";
+        const sequenceHitIndex = sequenceScope === "viewport" ? (scopedHitCounts[sequenceScopeKey] || 0) : hitIndex;
+        if (sequenceScope === "viewport") scopedHitCounts[sequenceScopeKey] = sequenceHitIndex + 1;
         const sequenceResponseIndex = responses.length
-          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          ? (mock.repeat_responses ? sequenceHitIndex % responses.length : Math.min(sequenceHitIndex, responses.length - 1))
           : null;
         let responseIndex = sequenceResponseIndex;
         let responseSelection = responseIndex === null ? "mock" : "sequence";
@@ -11226,11 +11247,14 @@ async function registerNetworkMocks(mocks) {
           label: mock.label,
           response_label: response.label || null,
           hit_index: hitIndex,
+          sequence_hit_index: responseIndex === null ? undefined : sequenceHitIndex,
+          sequence_scope: responseIndex === null ? undefined : sequenceScope,
+          viewport: viewportName,
           response_index: responseIndex,
           sequence_response_index: responseSelection === "request_body" ? sequenceResponseIndex : undefined,
           response_selection: responseIndex === null ? null : responseSelection,
-          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
-          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
+          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && sequenceHitIndex >= responses.length,
+          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && sequenceHitIndex >= responses.length,
           url: request.url(),
           method,
         };
@@ -11272,6 +11296,7 @@ async function registerNetworkMocks(mocks) {
     });
   }
 }
+let activeViewportName = null;
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
@@ -12534,6 +12559,7 @@ async function collectRouteInventory(check, viewport) {
   };
 }
 async function captureViewport(viewport) {
+  activeViewportName = viewport && viewport.name ? viewport.name : null;
   await page.setViewportSize({ width: viewport.width, height: viewport.height });
   let httpStatus = null;
   let navigationError;

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-JVZWSI55.js";
+} from "./chunk-55KDZEB3.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport

package/dist/index.cjs

@@ -9329,6 +9329,20 @@ function normalizeNetworkMock(input, index) {
   if (maxHitCount !== void 0 && effectiveRequiredHitCount > maxHitCount) {
     throw new Error(`target.network_mocks[${index}].max_hit_count cannot be less than its required hit count.`);
   }
+  const sequenceScopeInput = stringValue5(
+    input.sequence_scope ?? input.sequenceScope ?? input.response_sequence_scope ?? input.responseSequenceScope
+  );
+  let sequenceScope;
+  if (sequenceScopeInput) {
+    const normalizedScope = sequenceScopeInput.toLowerCase().replace(/[-\s]+/g, "_");
+    if (normalizedScope === "global" || normalizedScope === "profile" || normalizedScope === "run") {
+      sequenceScope = "global";
+    } else if (normalizedScope === "viewport" || normalizedScope === "per_viewport" || normalizedScope === "viewport_scoped") {
+      sequenceScope = "viewport";
+    } else {
+      throw new Error(`target.network_mocks[${index}].sequence_scope must be "global" or "viewport".`);
+    }
+  }
   return {
     ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
@@ -9336,6 +9350,7 @@ function normalizeNetworkMock(input, index) {
     method: stringValue5(input.method)?.toUpperCase(),
     responses,
     repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
+    sequence_scope: sequenceScope,
     required_hit_count: requiredHitCount,
     max_hit_count: maxHitCount,
     forbidden,
@@ -12987,6 +13002,7 @@ async function setupLocatorVisible(locator, index) {
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
     let hitCount = 0;
+    const scopedHitCounts = {};
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -13002,8 +13018,13 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
+        const sequenceScope = mock.sequence_scope === "viewport" ? "viewport" : "global";
+        const viewportName = activeViewportName || null;
+        const sequenceScopeKey = sequenceScope === "viewport" ? (viewportName || "__unknown_viewport__") : "__global__";
+        const sequenceHitIndex = sequenceScope === "viewport" ? (scopedHitCounts[sequenceScopeKey] || 0) : hitIndex;
+        if (sequenceScope === "viewport") scopedHitCounts[sequenceScopeKey] = sequenceHitIndex + 1;
         const sequenceResponseIndex = responses.length
-          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          ? (mock.repeat_responses ? sequenceHitIndex % responses.length : Math.min(sequenceHitIndex, responses.length - 1))
           : null;
         let responseIndex = sequenceResponseIndex;
         let responseSelection = responseIndex === null ? "mock" : "sequence";
@@ -13038,11 +13059,14 @@ async function registerNetworkMocks(mocks) {
           label: mock.label,
           response_label: response.label || null,
           hit_index: hitIndex,
+          sequence_hit_index: responseIndex === null ? undefined : sequenceHitIndex,
+          sequence_scope: responseIndex === null ? undefined : sequenceScope,
+          viewport: viewportName,
           response_index: responseIndex,
           sequence_response_index: responseSelection === "request_body" ? sequenceResponseIndex : undefined,
           response_selection: responseIndex === null ? null : responseSelection,
-          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
-          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
+          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && sequenceHitIndex >= responses.length,
+          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && sequenceHitIndex >= responses.length,
           url: request.url(),
           method,
         };
@@ -13084,6 +13108,7 @@ async function registerNetworkMocks(mocks) {
     });
   }
 }
+let activeViewportName = null;
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
@@ -14346,6 +14371,7 @@ async function collectRouteInventory(check, viewport) {
   };
 }
 async function captureViewport(viewport) {
+  activeViewportName = viewport && viewport.name ? viewport.name : null;
   await page.setViewportSize({ width: viewport.width, height: viewport.height });
   let httpStatus = null;
   let navigationError;

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-JVZWSI55.js";
+} from "./chunk-55KDZEB3.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -643,6 +643,20 @@ function normalizeNetworkMock(input, index) {
   if (maxHitCount !== void 0 && effectiveRequiredHitCount > maxHitCount) {
     throw new Error(`target.network_mocks[${index}].max_hit_count cannot be less than its required hit count.`);
   }
+  const sequenceScopeInput = stringValue(
+    input.sequence_scope ?? input.sequenceScope ?? input.response_sequence_scope ?? input.responseSequenceScope
+  );
+  let sequenceScope;
+  if (sequenceScopeInput) {
+    const normalizedScope = sequenceScopeInput.toLowerCase().replace(/[-\s]+/g, "_");
+    if (normalizedScope === "global" || normalizedScope === "profile" || normalizedScope === "run") {
+      sequenceScope = "global";
+    } else if (normalizedScope === "viewport" || normalizedScope === "per_viewport" || normalizedScope === "viewport_scoped") {
+      sequenceScope = "viewport";
+    } else {
+      throw new Error(`target.network_mocks[${index}].sequence_scope must be "global" or "viewport".`);
+    }
+  }
   return {
     ...payload,
     label: normalizeName(input.label || input.name, `network-mock-${index + 1}`),
@@ -650,6 +664,7 @@ function normalizeNetworkMock(input, index) {
     method: stringValue(input.method)?.toUpperCase(),
     responses,
     repeat_responses: input.repeat_responses === true || input.repeatResponses === true || input.cycle_responses === true || input.cycleResponses === true,
+    sequence_scope: sequenceScope,
     required_hit_count: requiredHitCount,
     max_hit_count: maxHitCount,
     forbidden,
@@ -4301,6 +4316,7 @@ async function setupLocatorVisible(locator, index) {
 async function registerNetworkMocks(mocks) {
   for (const mock of mocks || []) {
     let hitCount = 0;
+    const scopedHitCounts = {};
     await page.route(mock.url, async (route) => {
       const request = route.request();
       const method = request.method ? request.method() : "";
@@ -4316,8 +4332,13 @@ async function registerNetworkMocks(mocks) {
         const responses = Array.isArray(mock.responses) ? mock.responses : [];
         const hitIndex = hitCount;
         hitCount += 1;
+        const sequenceScope = mock.sequence_scope === "viewport" ? "viewport" : "global";
+        const viewportName = activeViewportName || null;
+        const sequenceScopeKey = sequenceScope === "viewport" ? (viewportName || "__unknown_viewport__") : "__global__";
+        const sequenceHitIndex = sequenceScope === "viewport" ? (scopedHitCounts[sequenceScopeKey] || 0) : hitIndex;
+        if (sequenceScope === "viewport") scopedHitCounts[sequenceScopeKey] = sequenceHitIndex + 1;
         const sequenceResponseIndex = responses.length
-          ? (mock.repeat_responses ? hitIndex % responses.length : Math.min(hitIndex, responses.length - 1))
+          ? (mock.repeat_responses ? sequenceHitIndex % responses.length : Math.min(sequenceHitIndex, responses.length - 1))
           : null;
         let responseIndex = sequenceResponseIndex;
         let responseSelection = responseIndex === null ? "mock" : "sequence";
@@ -4352,11 +4373,14 @@ async function registerNetworkMocks(mocks) {
           label: mock.label,
           response_label: response.label || null,
           hit_index: hitIndex,
+          sequence_hit_index: responseIndex === null ? undefined : sequenceHitIndex,
+          sequence_scope: responseIndex === null ? undefined : sequenceScope,
+          viewport: viewportName,
           response_index: responseIndex,
           sequence_response_index: responseSelection === "request_body" ? sequenceResponseIndex : undefined,
           response_selection: responseIndex === null ? null : responseSelection,
-          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && hitIndex >= responses.length,
-          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && hitIndex >= responses.length,
+          sequence_reused: responseSelection === "sequence" && responseIndex !== null && !mock.repeat_responses && sequenceHitIndex >= responses.length,
+          sequence_cycle: responseSelection === "sequence" && responseIndex !== null && mock.repeat_responses === true && sequenceHitIndex >= responses.length,
           url: request.url(),
           method,
         };
@@ -4398,6 +4422,7 @@ async function registerNetworkMocks(mocks) {
     });
   }
 }
+let activeViewportName = null;
 async function executeSetupAction(action, ordinal, viewport) {
   const type = setupActionType(action);
   const frameSelector = setupFrameSelector(action);
@@ -5660,6 +5685,7 @@ async function collectRouteInventory(check, viewport) {
   };
 }
 async function captureViewport(viewport) {
+  activeViewportName = viewport && viewport.name ? viewport.name : null;
   await page.setViewportSize({ width: viewport.width, height: viewport.height });
   let httpStatus = null;
   let navigationError;

package/dist/profile.d.cts

@@ -142,6 +142,7 @@ interface RiddleProofProfileNetworkMock extends RiddleProofProfileNetworkMockRes
     method?: string;
     responses?: RiddleProofProfileNetworkMockResponse[];
     repeat_responses?: boolean;
+    sequence_scope?: "global" | "viewport";
     required_hit_count?: number;
     max_hit_count?: number;
     forbidden?: boolean;

package/dist/profile.d.ts

@@ -142,6 +142,7 @@ interface RiddleProofProfileNetworkMock extends RiddleProofProfileNetworkMockRes
     method?: string;
     responses?: RiddleProofProfileNetworkMockResponse[];
     repeat_responses?: boolean;
+    sequence_scope?: "global" | "viewport";
     required_hit_count?: number;
     max_hit_count?: number;
     forbidden?: boolean;

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-JVZWSI55.js";
+} from "./chunk-55KDZEB3.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.125",
+  "version": "0.7.126",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",