Skip to content
hyperpolymathPublic

About

Experimental verification for a closed Zig subset: source-bound obligations, checked models, explicit trust limits, and proof replay toward a verifier for Zig.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

32 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Atoma — experimental verification for Zig

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.

Build and check

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.sh

The 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.

Current verification boundary

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.

Plan and collaboration

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.

Identity and licensing

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.

About

Experimental verification for a closed Zig subset: source-bound obligations, checked models, explicit trust limits, and proof replay toward a verifier for Zig.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages