144 lines
4.5 KiB
Markdown
144 lines
4.5 KiB
Markdown
<!-- file: deltas/0.3.2/pre.003-fix.001.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.2-pre.003-fix.001` — conformité Clippy et canari de frontière Store
|
|
|
|
## 1. Base requise
|
|
|
|
Base exacte :
|
|
|
|
```text
|
|
0.3.2-pre.003
|
|
workspace.package.version = 0.3.2-pre.3
|
|
```
|
|
|
|
Le gate opérateur fourni le 29 août 2026 confirme :
|
|
|
|
```text
|
|
cargo fmt --all PASS
|
|
audit Rust général / exports / workspace PASS
|
|
audit Markdown PASS — 186 tables / 127 files
|
|
cargo check --workspace PASS
|
|
cargo clippy --workspace --all-targets FAIL — 5 implicit_return observés dans les tests Store
|
|
cargo test -p ksp-store-api PASS
|
|
cargo test -p ksp-store-lib FAIL — faux positif dependency_boundary sur PostgresPoolSettings
|
|
cargo test -p ksp-store-lib --no-default-features FAIL — même faux positif dependency_boundary
|
|
cargo test -p ksp-store-postgres-lib PASS
|
|
cargo check -p ksp-store-lib --no-default-features PASS
|
|
```
|
|
|
|
Aucun défaut de production/runtime n'est observé : les 6 tests unitaires Store passent dans les deux configurations de feature. Le correctif reste strictement dans le couloir `pre.003`.
|
|
|
|
## 2. Objet
|
|
|
|
Corriger exclusivement :
|
|
|
|
```text
|
|
les closures de tests non conformes à clippy::implicit_return
|
|
le canari dependency_boundary trop large qui interdit le mot générique Pool
|
|
```
|
|
|
|
Aucune surface API, borne, erreur, lifecycle, feature, dépendance ou comportement Store n'est modifié.
|
|
|
|
## 3. Clippy `implicit_return`
|
|
|
|
Les closures de projection de code d'erreur utilisent désormais la forme explicite requise par `RUST-ERR-003` :
|
|
|
|
```rust
|
|
|value| return value.code()
|
|
```
|
|
|
|
La correction couvre toutes les occurrences de la tranche, y compris les branches compilées uniquement avec `--no-default-features`.
|
|
|
|
## 4. Canari de frontière physique
|
|
|
|
Le test `pre_003_facade_adds_only_backend_neutral_settings_lifecycle_and_api_reexports` interdisait le token nu :
|
|
|
|
```text
|
|
Pool
|
|
```
|
|
|
|
Cette condition est incorrecte car `PostgresPoolSettings` est une surface de configuration backend-neutral explicitement prévue par `pre.003`. Elle provoquait donc un faux positif tout en ne prouvant pas mieux l'absence de fuite physique.
|
|
|
|
Le canari interdit désormais les chemins/types physiques ciblés :
|
|
|
|
```text
|
|
pub use ksp_store_postgres_lib
|
|
tokio_postgres
|
|
deadpool_postgres
|
|
rustls::
|
|
deadpool::managed::Pool
|
|
tokio_postgres::Client
|
|
tokio_postgres::Row
|
|
tokio_postgres::Statement
|
|
```
|
|
|
|
Les protections existantes sur le manifeste et les production sources restent inchangées.
|
|
|
|
## 5. Version Cargo
|
|
|
|
Le correctif modifie des fichiers Rust de tests consommés par le build. Conformément à `VER-ID-007` et `VER-ID-010` :
|
|
|
|
```text
|
|
workspace.package.version = 0.3.2-pre.3.fix.1
|
|
```
|
|
|
|
Livraison :
|
|
|
|
```text
|
|
0.3.2-pre.003-fix.001
|
|
```
|
|
|
|
## 6. Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-store-lib/tests/dependency_boundary.rs
|
|
crates/ksp-store-lib/tests/feature_mismatch.rs
|
|
crates/ksp-store-lib/unit_tests/settings.rs
|
|
crates/ksp-store-lib/unit_tests/store.rs
|
|
```
|
|
|
|
Chaque fichier Rust réellement modifié incrémente son header de version une seule fois. Aucun autre fichier source n'est touché.
|
|
|
|
## 7. Fichier ajouté
|
|
|
|
```text
|
|
deltas/0.3.2/pre.003-fix.001.md
|
|
```
|
|
|
|
## 8. Fichiers supprimés
|
|
|
|
```text
|
|
aucun
|
|
```
|
|
|
|
## 9. Validations exécutées dans l'environnement de génération
|
|
|
|
```text
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.2
|
|
```
|
|
|
|
`cargo`, `rustc` et `rustfmt` ne sont pas disponibles dans l'environnement de génération. Aucun gate Cargo n'est donc déclaré PASS ici.
|
|
|
|
## 10. Gate opérateur requis
|
|
|
|
```bash
|
|
cargo fmt --all
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.2
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-store-lib
|
|
cargo test -p ksp-store-lib --no-default-features
|
|
cargo test -p ksp-store-postgres-lib
|
|
cargo check -p ksp-store-lib --no-default-features
|
|
```
|
|
|
|
## 11. Décisions et questions ouvertes
|
|
|
|
Décision : un canari de fuite backend doit cibler des symboles/chemins physiques, pas interdire des mots génériques faisant partie de settings publics légitimes.
|
|
|
|
Question ouverte : aucune. Si le gate est vert, la suite reste `0.3.2-pre.004` — Config `std.store`.
|