Zerum

Zerum is a Rust-native, deterministic-first code governance platform for Python.

It combines:

1. Native deterministic checks (ZR001–ZR010) — complexity, design, warnings, AI placeholders, architecture imports
2. External checker orchestration (planned) — Ruff, Mypy, Bandit, and others
3. Auditable LLM-assisted review (planned, opt-in only)

Zerum is not a Ruff clone. It focuses on explainable governance, maintainability, and architectural boundaries.

Quick start

cargo build
cargo run -- list-checks
cargo run -- check path/to/python/project
cargo run -- review path/to/python/project   # same analysis, exits 0 when issues exist
cargo run -- explain ZR001
cargo run -- init

zerum init writes zerum.toml from zerum.toml.example. You can also copy the example file manually.

Exit codes (check)

zerum review uses the same analysis and reporters but exits 0 when issues are found (only 2 on operational failure).

Checks (v0.1.0)

Output formats

cargo run -- check . --format human    # default
cargo run -- check . --format json
cargo run -- check . --format sarif
cargo run -- check . --format markdown

Tutorial

Educational material lives under docs/tutorial/:

• 00 — Introduction
• 01 — Static analysis basics
• 02 — Parsing Python in Rust
• 03 — Building a rule engine
• 12 — Roadmap

Development

cargo test
cargo run -- check tests/fixtures/bad_project        # exits 1
cargo run -- check tests/fixtures/arch_violation     # ZR010, exits 1
cargo run -- check tests/fixtures/simple_project     # exits 0

Changelog

See CHANGELOG.md for release history. Full v0.1.0 notes: docs/RELEASE_v0.1.0.md.

License

MIT — see LICENSE.