Files
Kill_LIFE/docs/plans/14_plan_release_versioning.md
L'électron rareandClaude Opus 4.6 7870c6cf58 feat: close plans 06/09/14 — CI firmware/HW gate, bulk edit, release process
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]>
2026-03-25 12:43:33 +01:00

1.9 KiB
Raw Permalink Blame History

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> creates release/ 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.yml triggers on v* 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.py extracts AC references from commit messages
  • Changements incompatibles — Delivered: tools/ci/generate_changelog.py detects 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.md
  • docs/evidence/evidence_pack.md