Repository navigation
registry: propose ADR 0005, a canonical JCS JSON route for proof receipts (prototype, unwired) - #103
hyperpolymath wants to merge 1 commit into
Conversation
…ipts Owner ruling 2026-11-16: rather than trope-checker emitting a deed, the reader in Mathesis should also accept a receipt that is canonical JCS I-JSON. This adds the proposal and an unwired prototype. docs/decisions/0005-jcs-json-receipt.adoc (status: proposed) maps each JSON field one to one onto the PROOF-POLICY 8.5.1 deed fields, with no pwg and no foundation_diverse. It makes JCS canonicality a hard requirement, and lists what the reader refuses. scripts/registry/json-receipt.mjs checks the JSON layer, writes the receipt as 8.5.1 deed text and lets the pinned canon reader derive each grade. The reader's own grade check serves as the oracle, so the prototype has no grading rule. claims-registry.mjs, READER and claims.jsonl are unchanged. tests/registry/json-receipt.test.mjs: three real deeds round-trip to an identical record. 36 refusal cases are each refused, and each is accepted by a permissive stub (JSON_RECEIPT_STUB=1 makes all 36 fail). trope-checker's verification/pwg.json is fetched at 0dceab6, checked against its sha256, and refused. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01J4QvDg2kzHbnbH2pmDf2Ar
|
Codex Review Summary: ❌ FailedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
|
Warning Review limit reachedYou've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Next included review available in 14 minutes. View limit details
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. |
…rkers (#105) ## Summary This refreshes the census rows for hyperpolymath/hypatia, metadatastician/standards and the 14 rows that have Idris2 proofs and a non-zero `unsafe` count. The hypatia row now covers the actions.lock closure work in hyperpolymath/hypatia#1026 and hyperpolymath/hypatia#1187. This PR first carried its own fix for a scanner false positive: the Idris2 function `partial'` was counted as four `partial` annotations. #101 landed on main meanwhile with the same fix, applied to every marker rule. The merge `39ea12a` keeps main's scanner and drops this PR's narrower rule and test. **The PR now changes census data only.** ## Changes | Repository | Change | |---|---| | hyperpolymath/hypatia @ `29a9e4a` | own files 58 → 77, declarations 680 → 1040, unsafe 0 | | metadatastician/standards @ `b49a33e` | own files 2 → 3, declarations 40 → 66 | | hyperpolymath/echidna | own files 170 → 163, declarations 1969 → 1676, from its newer commits | | 13 other Idris2 rows with unsafe markers | move to their current commits; counts unchanged | The 13 rows in the last line are ambientops, deed-core, developer-ecosystem, ephapax, poly-ssg, proven, raze-tui, reposystem, ssg-collection, cerro-torre, gossamer, paint-type and vordr. No unsafe count changed in the 14 refreshed Idris2 rows. Their markers are real `partial` annotations, and the false positive affected only hypatia. `docs/atlas/generated/*` is regenerated with `census-atlas.mjs build` and `render-catalogue.sh`. ## Follow-up Standards' row still names `docs/proof-debt.adoc` as its status document. standards#1635 renames standards' record to `3-practice/PROOF-STATUS.adoc` and retires that ledger. Once it merges, one more `update-rows.sh metadatastician/standards` will name the new file. ## RSR Quality Checklist ### Required - [x] Tests pass: `tests/census/*.sh` all pass, `bun test tests/atlas/census-atlas.test.mjs` 13/13 - [x] Catalogue matches rows; `census-atlas.mjs check` PASS - [x] No banned language patterns, no secrets - [x] No source files changed ### As Applicable - [ ] Deed and ROADMAP: not changed; project state did not change ## Open PRs this touches This PR changes only `docs/atlas/census/rows.jsonl` and the four generated atlas files. Of the other open PRs: - **#98** refreshes the same hypatia row at `6f3f16f`. This PR refreshes it at `29a9e4a`, which is later and includes hypatia#1187. If this merges, #98 is superseded. - **#96** (resource-algebra row) and **#100** (ddraig-ssg row) refresh different rows. They still edit the same files, so whichever merges second will conflict. To resolve, rerun `scripts/census/update-rows.sh` for its row on top of the new main, then regenerate. Do not hand-merge the generated files. - **#99** touches `docs/atlas/generated/registry.adoc`, which this PR does not change. **#102** and **#103** do not overlap with this PR. ## Testing Ran `update-rows.sh` on the 16 repositories on top of main at `261e6dc`. Then ran the census tests, the catalogue diff, and the atlas build, check and tests. No licence content is touched. https://claude.ai/code/session_01TbbnKqskQA5mj5gfMniPzi --- _Generated by [Claude Code](https://claude.ai/code)_ --------- Co-authored-by: Claude <noreply@anthropic.com>



Summary
This PR follows the owner ruling of 2026-11-16. trope-checker will not emit a praxis deed. Instead, the reader in Mathesis should also accept a proof receipt written as canonical JCS I-JSON. This PR is a proposal: an ADR with status proposed, a prototype reader and tests. Nothing is wired into the registry.
claims-registry.mjs, the pinned canon reader orREADER.sha256.claims.jsonl.Changes
docs/decisions/0005-jcs-json-receipt.adoc(proposed). It covers:pwgand nofoundation_diverse: a receipt that asserts a grade is refused (§8.4, WO 2.4);verification/pwg.json;scripts/registry/json-receipt.mjsis the prototype. First it checks the JSON layer: strict UTF-8, no BOM, bytes equal to JCS, I-JSON code points, a closed typed schema, no asserted grade, 40-hex commits, single-line values, andresult ∈ {pass, fail}consistent withstate. Then it writes the receipt as §8.5.1 deed text and lets the pinned canon reader derive the grade. The reader's own:pwgand:foundation-diversecheck is the oracle: for each claim, exactly one pair in the closed vocabulary is accepted. The prototype adds no grading rule.tests/registry/json-receipt.test.mjs: 39 tests.Testing
MATHESIS_STANDARDS=<standards @ e5a39d7> bun test tests/registry/gives 68 pass and 0 fail. The reader digest37ff85be…was verified.verification/receipts/theory_praxis.deed: THY-1 and APP-1 to APP-4, allPWG-1;example_praxis.deed:PWG-3;echo_praxis.deed:PWG-1through an echo.BRIDGE-PENDING, the derived grade isPWG-2iand the other claims stayPWG-1. My first expectation here wasPWG-2ii, and the test caught the mistake. The reader's rule is[PWG-3, PWG-2i, PWG-2ii][#recheck legs].JSON_RECEIPT_STUB=1, the suite runs against a permissive stub that only doesJSON.parse. Result: 3 pass, 39 fail. All 36 refusal tests fail, and so do the 3 tests that need the real reader.verification/pwg.jsonis fetched at0dceab68…and its sha256 is checked (3bf20a2e…5bda). The file is not vendored. The test confirms the file is canonical JCS and confirms the prototype refuses it (unknown field commit). Given to the pinned deed reader as it stands, the file fails with "line 1: line is 26347 octets", as the brief said.raw.githubusercontent.com, asregistry-checkalready does. A failed fetch fails the test; it is never skipped.asciidoctor --failure-level WARNrenders the ADR clean.Decisions for the owner (open questions in the ADR)
derive(record), with this prototype retired once that lands? This is the most elegant arm, and the ADR recommends it as the destination. The oracle approach exists only because the reader pin must not change.check-proof-receipt.shreads deeds only. Until it reads JSON, a JSON receipt would be catalogued atPWG-2iiat most.result? It is the one JSON field with no deed counterpart.Beyond this repo (trope-checker)
The file needs these changes before it can be read as a receipt. They are listed in the ADR:
PROVEN-WITH-AXIOMSandNOT-INVENTORIEDare not in the reader's vocabulary;sourceinstead ofre-proved;RSR Quality Checklist
bun test tests/registry/)docs/decisions/updated: added as proposed; the owner accepts ADRsGenerated by Claude Code