81 lines
3.2 KiB
Markdown
81 lines
3.2 KiB
Markdown
<!-- file: deltas/0.1.0/0-pre.4.fix.1.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.1.0-0-pre.4.fix.1
|
|
|
|
## Base
|
|
|
|
Base déclarée : `0.1.0-0-pre.4`, non validée intégralement.
|
|
|
|
## Validation du delta précédent
|
|
|
|
L'utilisateur a exécuté les gates demandées pour `0.1.0-0-pre.4` le 2026-09-16.
|
|
|
|
Résultats propres avant Clippy :
|
|
|
|
- `cargo fmt --all` ;
|
|
- `cargo fmt --all -- --check` ;
|
|
- audit Rust/workspace ;
|
|
- audit Markdown : `1 table(s), 33 file(s)` ;
|
|
- `cargo check --workspace`.
|
|
|
|
La gate suivante a échoué :
|
|
|
|
```bash
|
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
|
```
|
|
|
|
Cause : le target d'intégration `crates/common/game-logging-lib/tests/test_support.rs` n'avait pas de documentation de crate alors que `missing_docs` est élevé en erreur par `-D warnings`.
|
|
|
|
Les tests ciblés ont néanmoins ensuite été exécutés et sont propres pour `game-logging-lib`, `engine-v1-common`, `engine-v1-platform-api`, `game-reflex-poc` et `game-snake-poc`. Les deux runners Desktop ont également produit les résultats fonctionnels attendus avec leurs événements `tracing`.
|
|
|
|
`0.1.0-0-pre.4` n'est donc pas considéré validé ; ce fix reste obligatoire avant `0-pre.5`.
|
|
|
|
## Correctif
|
|
|
|
- ajout d'une documentation de crate `//!` au target d'intégration `game-logging-lib/tests/test_support.rs` ;
|
|
- passage du workspace à `0.1.0-0-pre.4.fix.1` ;
|
|
- aucune modification fonctionnelle du tracing ou des jeux.
|
|
|
|
## Politique d'historique documentaire
|
|
|
|
Ce fix introduit `history/<X.Y.Z>/<label>.md` pour conserver les jalons transitoires validés sous forme immuable.
|
|
|
|
La première entrée créée est `history/0.1.0/0-pre.3.md`, car `0-pre.3` est le dernier jalon dont la validation est déjà connue définitivement.
|
|
|
|
À partir des versions suivant la structuration initiale `0.1.0` :
|
|
|
|
- les `pre.*` et leurs fixes ne modifient normalement pas `CHANGELOG.md` ;
|
|
- `CHANGELOG.md` privilégie `rc` et releases stables ;
|
|
- `alpha` et `beta` n'y apparaissent que lorsqu'ils constituent des jalons externes significatifs ;
|
|
- `ROADMAP.md` n'est modifié que lorsqu'un changement réel de plan le justifie ;
|
|
- les détails transitoires validés résident sous `history/` ;
|
|
- les détails de livraison et commandes de validation résident sous `deltas/`.
|
|
|
|
## Validation à exécuter par l'utilisateur
|
|
|
|
Le fix modifie un fichier Rust ; commencer par le formatage mutatif :
|
|
|
|
```bash
|
|
cargo fmt --all
|
|
cargo fmt --all -- --check
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates Android deltas history
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
|
```
|
|
|
|
Le seul comportement de test modifié appartient à `game-logging-lib` :
|
|
|
|
```bash
|
|
cargo test -p game-logging-lib --all-targets --all-features
|
|
```
|
|
|
|
La suite workspace complète et les smokes Desktop ne sont pas requis pour ce fix : ils ont été exécutés sur `0-pre.4`, et le correctif n'altère aucun comportement runtime.
|
|
|
|
## Règle de transition
|
|
|
|
Si ces validations sont propres, `0.1.0-0-pre.4.fix.1` est accepté et le travail passe automatiquement à `0.1.0-0-pre.5`.
|
|
|
|
Si une gate échoue, rester sur `0-pre.4` et produire `0.1.0-0-pre.4.fix.2`.
|