@riddledc/riddle-proof 0.7.82 → 0.7.83

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 +26 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -59,7 +59,7 @@ without depending on another plugin runtime.
59
59
  ## Durable Loop CLI
60
60
 
61
61
  The package publishes `riddle-proof-loop` as a host-agnostic runner surface for
62
- Codex/CLI-style testing:
62
+ CLI-style and sole-agent testing:
63
63
 
64
64
  ```sh
65
65
  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
88
88
  checkpoint template includes `TODO` fields, provide a real `--payload-json`
89
89
  file/object before resuming the run.
90
90
 
91
- `--agent local` is the generic CLI executor slot. The current implementation
92
- uses the local Codex CLI adapter underneath, but the loop contract and CLI
93
- surface are intentionally not Codex-specific.
91
+ `--agent local` is the generic CLI executor slot. A host can wire that slot to
92
+ Codex, Claude Code, another local CLI, or a managed worker without changing the
93
+ checkpoint, evidence, or proof-assessment contract.
94
94
 
95
95
  Visual/UI proof runs can pass `viewport_matrix` / `viewport_matrix_json` to the
96
96
  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
676
676
  status, the command exits non-zero and the result explains the last observed
677
677
  status and `submitted_at` state.
678
678
 
679
- ## OpenClaw Adapter Boundary
679
+ ## Base vs OpenClaw Wrapper Boundary
680
680
 
681
681
  `@riddledc/riddle-proof/openclaw` translates OpenClaw Riddle Proof tool params
682
682
  into generic `RiddleProofRunParams`.
@@ -689,6 +689,27 @@ Generic authenticated proof inputs are preserved as pass-through JSON strings:
689
689
  those for public integrations; reserve `use_auth` for a configured, site-specific
690
690
  auth helper.
691
691
 
692
+ Keep behavior in base `@riddledc/riddle-proof` when it changes the portable run
693
+ contract or evidence semantics:
694
+
695
+ - checkpoint packets and responses
696
+ - profile, audit/no-diff, and proof-of-change run modes
697
+ - viewport matrices and per-viewport artifact metadata
698
+ - visual-delta thresholds, changed-region evidence, and evidence recovery gates
699
+ - run state, run cards, result objects, proof sessions, and evidence bundles
700
+ - generic auth/header/local storage inputs
701
+
702
+ Keep behavior in the OpenClaw wrapper when it only concerns OpenClaw hosting or
703
+ presentation:
704
+
705
+ - OpenClaw tool registration and schema wording
706
+ - Discord thread/status formatting
707
+ - OpenClaw workflow labels such as interactive, background PR, and continuous
708
+ - PR handoff/status phrasing such as `ship_mode=none`
709
+ - checkpoint packet display and review UX
710
+ - configured site-specific auth helpers
711
+ - wrapper deployment, hot reload, and notification adapters
712
+
692
713
  The adapter does not invoke another OpenClaw plugin and does not supply a
693
714
  coding agent. It is the reusable mapping layer a future OpenClaw wrapper can
694
715
  call before handing the request to its configured implementation, judge, ship,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@riddledc/riddle-proof",
3
- "version": "0.7.82",
3
+ "version": "0.7.83",
4
4
  "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
5
5
  "license": "MIT",
6
6
  "author": "RiddleDC",