From 257d45c97c8ecd0736456ff3747ee5197509df46 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 14 Nov 2026 19:11:41 +0000 Subject: [PATCH 1/2] docs(claude-md): add the hand-authored Proofs section below the generated region Copied verbatim from the template's CLAUDE.md (owner ruling 2026-10-26). It sits below the ARRIVAL-PACK:END marker, so just claude-md does not touch it. estate-rules asserts it in governance_policy_test.sh. Co-Authored-By: Claude --- CLAUDE.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 984fa428..8a59516e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -116,3 +116,35 @@ hand; that migration is done per repo (ADR-008 phase P3). In deed files use **ENFORCEMENT:** these rulings are recorded on `standards#787`. Some are ruled but not yet gated: check the gate on `standards` main before relying on it. + + +## Proofs — which prover for which obligation + +Normative source: `3-practice/PROOF-POLICY.adoc` in `hyperpolymath/standards`. +Read it there; `verification/proofs/README.adoc` maps it onto this repo. + +| Code or obligation | Verifier | +|---|---| +| Rust code | **Creusot** with **Pearlite** contracts, and **Verus**, by default and on the code (§1.2). Kani for `unsafe`/FFI seams and Aeneas for Rust that implements an Agda theorem run alongside, never instead | +| Ada code | **SPARK** | +| APIs, ABIs, engineering properties | **Idris2** | +| Theory | **Agda**, rechecked in **Rocq** and **Lean** (no Mathlib) | + +Always name Creusot, Pearlite and Verus in Rust verification plans and in +`docs/status/PROOF-STATUS.adoc`. Pearlite is Creusot's specification +language, not a third verifier. Plan scopes for both verifiers, and record +any that is unsupported, inapplicable or not yet run, with its reason; never +present an unexecuted check as a pass. Using both does not make two +independent witnesses (policy §1.2). + +Third-party code (crates such as Bevy, libraries, forks) is **not** converted +or re-proved. State what a proof relies on as an `ASSUMED` boundary +specification, and when choosing between dependencies that fit equally well, +prefer one that carries its own verification. A preference, not a gate. + +Proof grades are policy §8, *Proof Witness Grades*: `PWG-3` < `PWG-2i` < +`PWG-2ii` < `PWG-1`, where `PWG-1` is strongest. A grade is derived from +receipts, never asserted. A "verified" or "machine-checked" claim needs +current receipts. Report a census with its denominator, never a +percentage. Always write the `PWG-` prefix: CRG, TRG, ARG and FRG letters, +and ECHIDNA's `TrustLevel`, are different schemes. From 62009c3e145378c46544079b48fee8f5485f59bd Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 14 Nov 2026 19:11:41 +0000 Subject: [PATCH 2/2] test(governance): take the template's governance_policy_test.sh verbatim The canon identity block is now template-only (rsr-template-repo#378). Co-Authored-By: Claude --- tests/workflows/governance_policy_test.sh | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/tests/workflows/governance_policy_test.sh b/tests/workflows/governance_policy_test.sh index d31902ab..14a58a95 100644 --- a/tests/workflows/governance_policy_test.sh +++ b/tests/workflows/governance_policy_test.sh @@ -220,6 +220,17 @@ console.log("PASS: new proof instructions require needs, verification, rechecks // Keep the independently specified release tuple together: a version-only // bump or retaining the previous gates hash would misidentify the canon. // Update this expectation deliberately when adopting the next canon release. +// Only the template carries rsr-template-repo_chora.deed. A repo minted from it +// has its own deed name, so this identity check is template-only, like the other +// template-only controls (scripts/is-template-tree.sh is the one definition). +const isTemplateTree = (() => { + try { execFileSync("bash", [resolve(root, "scripts/is-template-tree.sh"), root]); return true; } + catch { return false; } +})(); +if (!isTemplateTree) { + console.log("SKIP: canon 2.1.5 identity (not the template tree; is-template-tree.sh says no)"); + process.exit(0); +} const field = (key) => execFileSync("bash", [resolve(root, "scripts/deed-field.sh"), resolve(root, "rsr-template-repo_chora.deed"), "canon", key], { encoding: "utf8" }).trim(); assert.deepEqual([field("version"), field("criteria-sha256"), field("gates-sha256")], [