@riddledc/riddle-proof 0.7.102 → 0.7.103

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +22 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -434,6 +434,28 @@ The check records visible text for the selector in each viewport and reports
434
434
  matched counts plus short samples, which makes generated-command and evidence
435
435
  card audits easier to diagnose than global `text_visible` checks.
436
436
 
437
+ Use `http_status` when the contract belongs to the fetched response itself:
438
+ status code, content type, byte size, or raw body fragments from a markdown,
439
+ JSON, YAML, robots, sitemap, or other machine-readable endpoint:
440
+
441
+ ```json
442
+ {
443
+ "type": "http_status",
444
+ "label": "agent markdown",
445
+ "url": "https://example.com/docs/markdown.md",
446
+ "expected_status": 200,
447
+ "allowed_content_types": ["text/markdown"],
448
+ "min_bytes": 1000,
449
+ "body_contains": ["# API Documentation"]
450
+ }
451
+ ```
452
+
453
+ `body_contains`, `body_patterns`, `body_not_contains`, and
454
+ `body_not_patterns` match the raw HTTP response body, not rendered browser
455
+ text. Use `text_visible` or `selector_text_visible` when CSS transforms,
456
+ hydration, client rendering, hidden elements, or layout-specific copy should be
457
+ judged exactly as the browser exposes it to users.
458
+
437
459
  Use `frame_text_visible` and `frame_no_horizontal_overflow` for embedded app,
438
460
  game, or preview surfaces that render inside iframes:
439
461
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@riddledc/riddle-proof",
3
- "version": "0.7.102",
3
+ "version": "0.7.103",
4
4
  "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
5
5
  "license": "MIT",
6
6
  "author": "RiddleDC",