Bactrian is a planned verification suite for a deliberately restricted, pure subset of OCaml, for BEAM-style actor protocols, and for Idris2 and Zig foreign function boundaries. It aims to route proof obligations to Why3 with SMT solvers, to Apalache, and to checked proof receipts. The design is a research proposal.
|
Important
|
Status: research stage.
|
-
docs/architecture/BACTRIAN-VERIFICATION-SPEC.adoc: the architecture and soundness contract. -
docs/architecture/BACTRIAN-IMPLEMENTATION-PLAN.adoc: the milestones 0 to 6. -
docs/status/BACTRIAN-ULTRAPLAN.adoc: work packages WP-00A to WP-09 and gates G0 to G5. -
scripts/bactrian/doctor.sh: the readiness preflight. It checks required tools, the ECHIDNA adapter setting, the authority lock and the planned source files. -
tests/bactrian/doctor_test.sh: the test of the preflight. -
.machine_readable/bactrian/authorities.lock: eight upstream authority rows. All eight areUNPINNED.
bash scripts/bactrian/doctor.sh
bash tests/bactrian/doctor_test.shdoctor.sh prints one line per check. It exits with status 2 and prints
"Preflight BLOCKED" while tools or authorities are missing. This is the
expected result today. A green exit would still not mean that anything is
proved.
doctor_test.sh tests the preflight itself. It uses synthetic fixtures. A pass
means the preflight behaves as designed. It says nothing about Bactrian proofs.
CI runs both commands in .github/workflows/bactrian.yml.
-
Layer A: a sequential, pure OCaml subset. The plan uses Why3 and SMT solvers, with strict Dedukti witnesses.
-
Layer B: actor, mailbox and protocol models. The plan uses K-CUT artifacts from
choreographic-typesand Apalache bounded model checking. -
Layer C: a verified foreign boundary. The plan uses an Idris2 ABI manifest and a Zig implementation checked by Idris2 QTT and ZigProve.
None of these layers is implemented.
-
Plan to v1.0.0: gates, order, models and effort
The repository was created from the Rhodium Standard Repository template and keeps its tooling. The Justfile provides these recipes, among others:
mise trust && mise install # install the pinned developer tools
mise exec -- just doctor # check the developer environment
mise exec -- just validate # run the template validation suiteTemplate recipes such as just readiness are not yet wired to Bactrian. The
repository map is generated at
docs/architecture/REPOSITORY-MAP.adoc.
Contributors should read CONTRIBUTING.adoc and
CODE_OF_CONDUCT.adoc. Report security issues as
described in .github/SECURITY.md.
Code, configuration and scripts are Mozilla Public License 2.0
(MPL-2.0). Prose documentation is CC-BY-SA-4.0. Both texts live in
LICENSES/. Per-file SPDX-License-Identifier headers are authoritative.