Plan 06 CI/CD: .clang-format, lint_firmware.sh, branch_protection.sh, protected_environments.sh, firmware-lint + hardware-gate CI jobs Plan 09 Bulk Edit: snapshot.sh, bulk_edit.py (dry-run/apply/verify), hw_diff.sh Plan 14 Release: release_prep.sh, generate_changelog.py, release_policy.py All 20 items closed across 3 plans. Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
1.9 KiB
1.9 KiB
14) Plan de release & versioning
Objectif
Mettre en place un versioning clair et des releases reproductibles (firmware + hardware + specs + evidence pack).
Recommandation versioning
- Firmware : SemVer (
vMAJOR.MINOR.PATCH) - Hardware :
HW-V0,HW-V1+ révisions PCB - Specs : version interne (rev) ou tag repo
Étapes release
1. Préparer la RC
- “Freeze” features, bugfix only — Delivered:
tools/ci/release_prep.sh <version>createsrelease/branch (bugfix-only by policy) - Test matrix complète — Delivered:
tools/test_python.sh --suite stable+firmware/test/ - Evidence pack complet — Delivered:
.github/workflows/evidence_pack.yml+tools/collect_evidence.py
2. Tag & artefacts
- Tag git — Delivered:
tools/ci/release_prep.sh <version> --tag+.github/workflows/release_signing.ymltriggers onv*tags - Générer binaires firmware (CI) — Delivered:
tools/build_firmware.py+.github/workflows/ci.yml - Publier artefacts (hash, size) — Delivered:
.github/workflows/release_signing.yml+.github/workflows/sbom_validation.yml
3. Release notes
- Liste des AC couverts — Delivered:
tools/ci/generate_changelog.pyextracts AC references from commit messages - Changements incompatibles — Delivered:
tools/ci/generate_changelog.pydetects BREAKING CHANGE and!conventional-commit markers - Profil compliance — Delivered:
docs/COMPLIANCE.md
4. Post‑release
- Backport policy — Delivered:
tools/ci/release_policy.py --show(documents eligible backport criteria) - Hotfix process — Delivered:
tools/ci/release_policy.py --show(step-by-step hotfix workflow from tag to cherry-pick)
Gates
- CI verte
- Evidence pack présent
- Review finale
Critère de sortie
✅ Release publiée, reproductible, avec preuves et notes claires.
Références
docs/workflows/compliance_release.mddocs/evidence/evidence_pack.md