@riddledc/riddle-proof 0.7.125 → 0.7.127

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
@@ -582,13 +592,35 @@ JSON, YAML, robots, sitemap, or other machine-readable endpoint:
 }
 ```
 
+For JSON responses, prefer `body_json_assertions` when the durable contract is
+a field value rather than a raw substring:
+
+```json
+{
+  "type": "http_status",
+  "label": "proof artifact",
+  "url": "/proof/good-catches/artifacts/job_1234/proof.json.json",
+  "expected_status": 200,
+  "allowed_content_types": ["application/json"],
+  "body_json_assertions": [
+    { "path": "status", "equals": "passed" },
+    { "path": "checks[0].status", "equals": "passed" },
+    { "path": "environment_blocker", "exists": false }
+  ]
+}
+```
+
+JSON paths support dot keys and array indexes such as `checks[0].status`, with
+`$` as the root. Each assertion supports `exists`, `equals`, `not_equals`,
+`contains`, and `type`.
+
 `body_contains`, `body_patterns`, `body_not_contains`, and
 `body_not_patterns` match the raw HTTP response body, not rendered browser
 text. Use `text_visible` or `selector_text_visible` when CSS transforms,
 hydration, client rendering, hidden elements, or layout-specific copy should be
 judged exactly as the browser exposes it to users.
-Hosted `summary.md` includes `http_status` body assertion pass counts so a
-reviewer can see raw body proof coverage without opening `proof.json`.
+Hosted `summary.md` includes `http_status` body and JSON assertion pass counts
+so a reviewer can see raw response proof coverage without opening `proof.json`.
 
 When the profile target is a mounted Riddle static Preview such as
 `https://preview.riddledc.com/s/ps_1234abcd/docs/`, root-relative