Phase One Release Checklist

1. Branch Hygiene

   • Ensure main is green (CI pipeline complete).
   • Review outstanding ADRs and docs for freshness.

2. Build & Test

   • just ci
   • just build-rel
   • just api-export

3. Artefact Verification

   • Binary: target/release/revaer-app
   • Checksum: sha256sum target/release/revaer-app
   • OpenAPI: docs/api/openapi.json
   • Docker image: just docker-build && just docker-scan

4. Runbook Execution

   • Follow docs/runbook.md
   • Archive CLI telemetry, /metrics, /health/full snapshots.

5. Documentation Refresh

   • Verify ADRs 005–007 reflect current design.
   • Update user guides (docs/api/guides/*.md) with any behavioural changes.

6. Tag & Publish

   • Create annotated tag: git tag -a vX.Y.Z -m "Phase One release"
   • Push tag: git push origin vX.Y.Z
   • Attach artefacts generated by the build-release workflow.

7. Post-Release Monitoring

   • Watch rate-limit and guard-rail metrics.
   • Confirm HealthChanged events return to empty degraded set.
   • Validate automation telemetry for CLI success rates.