Thanks for your interest in contributing to Evolve.

1. Install Rust 1.86.0 (or newer).
2. Install just.
3. Clone the repository and run:

just --list
just build

Run these commands locally:

just fmt-check
just lint
just check
just test

For docs changes under docs/, also run:

cd docs
bun install
bun run build

• Keep PRs focused and small.
• Include tests for behavior changes.
• Update docs when public behavior changes.
• Do not merge failing CI.
• Use clear commit messages and PR descriptions.

• Rust: cargo fmt and cargo clippy must pass with no warnings.
• Prefer explicit, deterministic behavior over convenience.
• Avoid introducing breaking changes without documenting migration impact.

Open a GitHub issue with:

• Reproduction steps
• Expected behavior
• Actual behavior
• Environment details (OS, Rust version, command output)

By participating, you agree to follow the project Code of Conduct.