# Release Checklist

Run before tagging a release:

```bash
mix format --check-formatted
mix compile --warnings-as-errors
mix test
mix xref graph --format cycles --label compile-connected --fail-above 0
cd reference/python
uv sync
uv run python differential_check.py --cases 250 --seed 202607
uv run python benchmark.py --mode quick --baseline benchmark_baseline_quick.json --fail-ratio 2.0
cd ../..
```

Review:

- Fixture diffs are intentional.
- `docs/compatibility.md` matches current behavior.
- `README.md` examples are still valid.
- `reference/python/UPSTREAM_TEST_COVERAGE.md` reflects upstream-derived cases.
- Changelog entries describe public behavior changes.
- Benchmark results are reviewed for unexpected regressions.
- Package metadata in `mix.exs` is correct.

CI and Dialyzer are intentionally outside the current production-readiness goal.