Routines that many programs need (a mean, a gap penalty, the
Lennard-Jones potential, the minimum image convention) were rewritten
and re-verified each time, and there was no way to open one and see
exactly what it does. They now live in pplus-library, pinned here as
the submodule library/, and a program brings them in with USE.
- USE module / USE module.Routine (pseudo-study resolveUses): each
routine is studied once in its own file (its own USE lines resolved
the same way, cycles refused) and handed to the checker as a library
routine; unknown-library, unknown-routine, library-clash, use-place.
- A run steps over a library routine (one step at the call, one at the
return, none of its lines); a broken contract is reported at the call,
naming the routine. The prover uses its REQUIRE and ENSURE at the
call and does not prove it again; it is not a unit of the program.
- pseudo-to-mojo writes each library routine the program calls once,
dependencies first, labeled as coming from the library.
- src/library: the registry USE reads, generated from library/
(scripts/library.mjs emit), so the site needs no files at run time.
- scripts/library.mjs check: every routine at every level: structure,
cases, prover, fuzzer, generated Mojo, each reference implementation
(CPython; cc at -O0 and -O2; core's Mojo interpreter; the pinned
compiler's stored answer) held to the pseudo's results, and the Dafny
proof with the pinned Dafny. Writes library/status.json and STATUS.md.
scripts/library_godbolt.py stores the compiler's answers (network).
- pixi tasks library-check, library-emit, library-verify-mojo,
library-harness; CI checks out the submodule and runs library-check.
- Tests: tests/library.test.mjs, corpus 53-library; docs/library.md and
a library section in trust.md.
Gate: 332 pass; library-check: no failing check (16 routines; the Mojo
references are unverified until library-verify-mojo runs on the network).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FgvbRdoEheAHqsRmr2WuKZ