Atoma develops source-bound verification for an explicitly closed Zig subset. It currently provides canonical contracts, a syntax screen, typechecked Idris2 specifications, Agda proofs of a store-free model and a finite u8 source pilot. It is not yet a general sound verifier for Zig. Evidence remains INCOMPLETE (Warrant): finite-model replay now runs through ECHIDNA and coqchk, while compiler/refinement arguments and the full kernel chain remain unfinished.
Use Zig 0.15.2, Z3 4.13.3 and the Agda/Idris2/ECHIDNA/Coq profiles in the toolchain decision. From the repository root:
bash scripts/atoma-gate.shThe gate rebuilds the current source, runs contract extraction and registered
proof checks, checks the good and wrong-body fixtures against every u8 input,
and exercises failures for missing tools, stale executables and I/O errors.
It also regenerates source-bound Coq model proofs, runs actual ECHIDNA,
checks the compiled libraries with coqchk and audits theorem assumptions.
Evidence is written to build/atoma-evidence/. The hosted workflow publishes
the same evidence and is required on main.
tools/atoma owns the command-line tooling and closed source pilot.
examples/atoma/frame-v1 exercises the frame ABI contract and error paths.
verification/atoma/agda proves a model theorem; this is not a theorem about
the full Zig implementation. Legacy frame SMT queries remain model evidence.
The Idris QTT resource example is a model, not an executable foreign binding.
Read the source-to-proof decision before extending claims or admitted language constructs. A solver answer or a passing test must never be promoted to COMPLETE without the required checked translation, provenance and kernel-replay evidence.
The v1 plan defines conjunctive release gates, estimates and stop points. The first finite-model replay slice is described in the replay report. Next are the typed semantic boundary, an alias counterexample and checked refinement. The sibling assessment explains potential reuse with Quintessence, Apodeixis.jl and Bactrian.
See architecture, maintainers, security reporting and contributing.
The project deed is atoma_chora.deed, with experimental maturity and the
Formal Verification & Proofs clade. Repository metadata and green CI are not
standards certification or a program-soundness certificate.
Code is MPL-2.0; documentation is CC-BY-SA-4.0, as declared in the existing licence and per-file identifiers. No licence terms are changed by the identity repair.