126 lines
3.3 KiB
Markdown
126 lines
3.3 KiB
Markdown
<!-- file: deltas/0.3.3/pre.012-fix.001.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.3-pre.012-fix.001` — conformité des rôles documentaires
|
|
|
|
## 1. Base requise
|
|
|
|
Base directe attendue :
|
|
|
|
```text
|
|
0.3.3-pre.012
|
|
workspace.package.version = 0.3.3-pre.12
|
|
```
|
|
|
|
Le gate opérateur de `pre.012` du 30 août 2026 est entièrement propre.
|
|
|
|
## 2. Motif du correctif
|
|
|
|
La réconciliation `pre.012` avait laissé dans les guides `USAGE.md` des éléments qui appartiennent à d'autres familles documentaires :
|
|
|
|
```text
|
|
chronologie 0.3.3-pre.*
|
|
preuve de gate/live
|
|
statut de validation
|
|
renvois à une release future
|
|
```
|
|
|
|
Ce contenu viole le rôle déjà défini par `KSP-REL-013` et `docs/rules/FILE_CONTRACTS.md` : un `USAGE.md` doit être durable, sans notes de version et centré sur l'utilisation concrète de la surface publique.
|
|
|
|
Le README PostgreSQL contenait également une chronologie de prerelease et un récit de preuve live qui appartiennent à `docs/validation` et aux deltas.
|
|
|
|
## 3. Correction
|
|
|
|
Les deux `USAGE.md` Store sont réécrits comme guides pratiques :
|
|
|
|
- dépendance et préconditions ;
|
|
- construction/résolution des settings ;
|
|
- ouverture, health et fermeture ;
|
|
- lecture `RawTransaction` ;
|
|
- pagination keyset ;
|
|
- acquisition canonique atomique ;
|
|
- lecture/écriture d'observations ;
|
|
- lecture et transition de rétention ;
|
|
- classification sûre des erreurs ;
|
|
- limites de responsabilité.
|
|
|
|
Les exemples utilisent la surface publique actuelle et évitent toute chronologie de release.
|
|
|
|
Les deux README restent descriptifs : responsabilité, frontières, architecture runtime, surface courante et hors périmètre. Les preuves et résultats de gate restent dans la validation et les deltas.
|
|
|
|
## 4. Règles
|
|
|
|
Aucune nouvelle règle n'est ajoutée : les contrats canoniques existaient déjà.
|
|
|
|
```text
|
|
KSP-REL-013
|
|
DOC-CRATE-002
|
|
DOC-CRATE-004
|
|
docs/rules/FILE_CONTRACTS.md — Documentation durable des crates et applications
|
|
```
|
|
|
|
Le correctif remet les documents en conformité avec ces règles au lieu de dupliquer la norme.
|
|
|
|
## 5. Version Cargo
|
|
|
|
```text
|
|
0.3.3-pre.12
|
|
-> 0.3.3-pre.12.fix.1
|
|
```
|
|
|
|
## 6. Invariants techniques
|
|
|
|
Aucun changement n'est apporté à :
|
|
|
|
```text
|
|
src/**
|
|
tests/**
|
|
config/**
|
|
docs/architecture/**
|
|
docs/rules/**
|
|
migrations/**
|
|
Cargo.toml de crate
|
|
dépendances/features
|
|
```
|
|
|
|
Les migrations V000/V001 et leurs checksums restent inchangés.
|
|
|
|
## 7. Fichiers ajoutés
|
|
|
|
```text
|
|
deltas/0.3.3/pre.012-fix.001.md
|
|
```
|
|
|
|
## 8. Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-store-lib/README.md
|
|
crates/ksp-store-lib/USAGE.md
|
|
crates/ksp-store-postgres-lib/README.md
|
|
crates/ksp-store-postgres-lib/USAGE.md
|
|
docs/plans/024-V0_3_3_STORE_POSTGRES_RAW_TRANSACTION_PLAN.md
|
|
docs/validation/020-V0_3_3_STORE_POSTGRES_RAW_TRANSACTION.md
|
|
```
|
|
|
|
## 9. Fichiers supprimés
|
|
|
|
Aucun.
|
|
|
|
## 10. Gate attendu
|
|
|
|
```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.3
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-store-api
|
|
cargo test -p ksp-store-lib
|
|
cargo test -p ksp-store-postgres-lib
|
|
cargo test -p ksp-config-lib
|
|
cargo check -p ksp-store-lib --no-default-features
|
|
```
|
|
|
|
Aucun replay PostgreSQL n'est nécessaire : le correctif ne modifie ni code, ni test, ni SQL, ni migration.
|