Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions PROOF-NEEDS.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -170,9 +170,10 @@ checkers run on the receipt's source commit (§8.2). §8.2 accepts "a pinned
kernel run in CI" on the same terms as a checker service, so the CI runner
needs no digest-pinned container of its own. How the three provers are
installed is a separate matter, §6's, recorded under "Toolchain deviations"
below. A later change to a leg's inputs makes the receipt stale (the CI job
warns), and the grade then holds for `+e8deeaf+` until a run of the new commit is
recorded (§8.4, "regression drops the grade"). The row-by-row mapping is in
below. A change to a leg's inputs fails the receipt gate until a run of the
new inputs is recorded, or the current run is marked `+superseded+` or
`+regressed+`, which drops the grade until then (§8.4, "regression drops the
grade"). The row-by-row mapping is in
`+docs/theory/PROOF-GRADES.adoc+`. Since 2026-11-01 the gate runs
PROOF-POLICY §2.1's canonical invocation
(`+--safe --without-K --cubical-compatible …+`).
Expand Down
30 changes: 19 additions & 11 deletions docs/theory/PROOF-GRADES.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -117,17 +117,25 @@ also the ledger's recorded checker for rows G-1, T-1, T-2, T-3 and E-1m.
=== The machine-readable receipt

The receipt of record is `verification/receipts/januskey_praxis.deed`, a praxis
deed with `:profile proof-receipt` (PROOF-POLICY §8.5.1). `scripts/proof-receipt.sh`
writes it from two typed ledgers (the claims and the CI runs, each run copied
from its log) and from git: the input set of each leg, every file's SHA-256 and
the §8.5.1 digest are computed, never typed. `just test-receipt`, and the
`agda-proofs.yml` job "Proof receipt, derived grades, git checks", regenerate it
and refuse any difference, run the standards reader pinned by commit and
SHA-256 (it derives every grade and refuses one the receipts do not support),
run the §8.5.3 git checks (each manifest holds at its commit, the
`resource-algebra` import holds at its pin, and the source commit is on `main`),
and warn when a leg's inputs have changed since the receipt's source commit.
This page is the human reading of that file.
deed with `:profile proof-receipt` (PROOF-POLICY §8.5.1). It is written by the
estate's shared generator (standards `scripts/proof-receipt.sh`), which
`scripts/proof-receipt.sh` here fetches with the reader, the reference digest and
the §8.5.3 checker at one standards commit, each checked against its SHA-256.
The home script holds only januskey's own data: the claim list, the run ledger
(each run copied from its log), the run scopes (a superseded run is listed only
under the claims it checked), and the hooks naming each leg's invocation and
input set. Every file's SHA-256 and every §8.5.1 digest are computed from git,
never typed; a superseded run's digest is the reference digest of its leg's
inputs at that run's commit. `just test-receipt`, and the `agda-proofs.yml` job
"Proof receipt, derived grades, git checks", regenerate the receipt and refuse
any difference, run the §8.5.3 git checks (each manifest holds at its commit,
the `resource-algebra` import holds at its pin, and the source commit is on
`main`), and run the pinned reader, which derives every grade and refuses one
the receipts do not support, with a negative control. They also refuse a
receipt whose current runs no longer describe the tree: a change to a leg's
inputs must record a new run, or mark the current one `superseded` or
`regressed`, which drops the grade until a new run is recorded (§8.4). This
page is the human reading of that file.

The receipt describes commit `e8deeaf7bc7b70500d57c282828512c8f8ba81f9` on `main`,
the merge of hyperpolymath/januskey#180, which added the Rocq and Lean legs of
Expand Down
Loading
Loading