Polish release docs and add CI checks
- Correct stale references and headline-path wording in READMEs and Lean docstrings - Document build steps, comparator requirements, sweep scope, and coverage - Unify Apache headers across Lean and C++ sources - Add a bwrap-free axiom audit for the headline theorems - Add a Gitea workflow running lake build, the axiom audit, C++ tests, and coverage - Match LLVM coverage tool versions to the compiler and recreate stale build dirs
This commit is contained in:
1 parent
73e371fb40
commit
273ad72f0c
34 files changed
+431
-133
No files matched your search
@@ -24,14 +24,30 @@ conflicting write, and none of whose proper subranges is sufficient.
|
||||
## Build and check
|
||||
|
||||
```sh
|
||||
lake exe cache get # clean checkout: download Mathlib's prebuilt oleans
|
||||
lake build
|
||||
./scripts/check-axioms.sh
|
||||
lake comparator
|
||||
```
|
||||
|
||||
This repository pins Lean `v4.35.0` and Mathlib `v4.35.0`
|
||||
(`lean-toolchain`, `lakefile.toml`). `lake comparator` checks that the solution
|
||||
proves the challenge's statements and that the proofs use only `propext`,
|
||||
`Quot.sound`, and `Classical.choice`.
|
||||
(`lean-toolchain`, `lakefile.toml`). `lake exe cache get` downloads Mathlib's
|
||||
prebuilt `.olean` files; without it a fresh clone compiles Mathlib from source.
|
||||
`lake build` then compiles the default targets (`Statement` and `Proof`, which
|
||||
pull in the reference development); run it before the checks so that a manifest
|
||||
is present and dependencies are resolved.
|
||||
|
||||
`./scripts/check-axioms.sh` prints the axiom dependencies of
|
||||
`Statement.closedFormMinimal` and `Statement.minimalUnique` and fails unless
|
||||
both are exactly `[propext, Classical.choice, Quot.sound]`. This catches `sorry`
|
||||
(`sorryAx`) and newly introduced axioms without needing the comparator sandbox.
|
||||
|
||||
`lake comparator` then builds `Challenge` and `Solution` independently and
|
||||
checks that the solution proves the challenge's statements and uses only
|
||||
`propext`, `Quot.sound`, and `Classical.choice`. It requires `bubblewrap` and
|
||||
either unprivileged user namespaces or a setuid-root `bwrap`; on systems where
|
||||
user namespaces are restricted, `lake comparator` will fail before checking the
|
||||
proof.
|
||||
|
||||
## Status and scope
|
||||
|
||||
@@ -39,18 +55,27 @@ proves the challenge's statements and that the proofs use only `propext`,
|
||||
proof in `Proof.lean`, `Bridge.lean`, or `FormalConflictRange/` uses `sorry`.
|
||||
* `Challenge.lean` deliberately contains `sorry`: it is the statement side of
|
||||
the comparator check, not part of the proof.
|
||||
* Some docstrings in `FormalConflictRange/` are a research log and refer to
|
||||
files that are **not** part of this repository:
|
||||
`FormalConflictRange/Counterexample`, `FormalConflictRange/Open`, and
|
||||
`notes/main.tex`. Those references appear only in comments and docstrings, so
|
||||
they do not affect the build or the headline proofs, but their specific claims
|
||||
cannot be checked here. `FormalConflictRange/Prototype.lean` is likewise an
|
||||
experimental prototype, not part of the headline proof path.
|
||||
* The headline argument is the closed-form development under `FormalConflictRange/`.
|
||||
`FormalConflictRange/Algorithm.lean` and `FormalConflictRange/Prototype.lean`
|
||||
also supply shared ingredients used by that development: the empty-result
|
||||
theory (`emptyValue`, `EmptyInferenceWitness`,
|
||||
`minimal_emptyValue_of_emptyInference`) and the ascending-key list and
|
||||
constraint collectors (`ascendingKeys`, `emptyConstraints`), respectively.
|
||||
Their partial-algorithm and prototype sections are earlier case-analysis and
|
||||
search material; those sections are not the route taken by the final
|
||||
closed-form proof.
|
||||
* The C++ tree is validated against Lean-generated golden vectors, by
|
||||
differential fuzzing, and by a deterministic exhaustive sweep of small
|
||||
readable instances; `cpp/README.md` describes the model, the tests, the
|
||||
coverage check, and the benchmark. The summarised implementation has 100%
|
||||
line coverage via `cpp/run-coverage.sh`.
|
||||
line and branch coverage via `cpp/run-coverage.sh`.
|
||||
|
||||
## Continuous integration
|
||||
|
||||
`.gitea/workflows/ci.yml` runs the Lean build, the axiom audit, and the C++ test
|
||||
suite (including the coverage gate) on pushes to `main` and on pull requests. It
|
||||
is written for Gitea Actions; a GitHub mirror would need an equivalent workflow
|
||||
under `.github/workflows/`.
|
||||
|
||||
## License
|
||||
|
||||
|
||||
Reference in new issue
Block a user