v0.3.3-pre.007

deltas/0.3.3/pre.007.md

@@ -0,0 +1,158 @@
+<!-- file: deltas/0.3.3/pre.007.md -->
+<!-- version: 1 -->
+
+# Delta `0.3.3-pre.007` — rétention atomique RawTransaction
+
+## 1. Base et gate d'entrée
+
+Base opérateur obligatoire :
+
+```text
+0.3.3-pre.6.fix.1
+```
+
+Le gate opérateur fourni le 2026-08-30 est entièrement vert :
+
+```text
+cargo fmt --all                                      PASS
+scripts/audit_rust_workspace_rules.py               PASS
+scripts/audit_markdown_tables.py                    PASS
+cargo check --workspace                             PASS
+cargo clippy --workspace --all-targets              PASS
+cargo test -p ksp-store-api                         PASS
+cargo test -p ksp-store-lib                         PASS
+cargo test -p ksp-store-postgres-lib                PASS (34 unit backend, live foundation ignoré)
+cargo test -p ksp-config-lib                        PASS (128 unit + ownership/public API)
+cargo check -p ksp-store-lib --no-default-features  PASS
+```
+
+La pagination/cursor `pre.006` est donc acquise et la tranche peut ouvrir la rétention mutante.
+
+## 2. Version
+
+```text
+workspace.package.version = 0.3.3-pre.7
+```
+
+## 3. Scope exact
+
+Cette tranche ajoute uniquement le bridge backend PostgreSQL de transition :
+
+```text
+PostgresBackend::transition_raw_transaction_retention
+Full -> Archived
+Archived -> Purged
+compare-and-transition
+Compacted unsupported
+```
+
+Ne sont pas encore ouverts :
+
+```text
+implémentations complètes des six traits RawTransaction*
+dispatch ksp-store-lib
+RawAccountState
+worker/job policy
+```
+
+## 4. Pré-I/O
+
+Avant `pool.get()` :
+
+- le réseau de `transition.reference()` doit égaler le binding backend ;
+- si `expected` ou `target` vaut `Compacted`, le backend retourne `RetentionCompactionUnsupported` ;
+- le code KSP stable reste `store.postgres_retention_compaction_unsupported`.
+
+Aucune ligne `retention_state = 'compacted'` n'est créée et aucune dépendance de compression n'est ajoutée.
+
+## 5. Compare-and-transition
+
+Sous transaction PostgreSQL, le canonical est lu avec `FOR UPDATE`. Sa forme physique est validée avant de retourner un outcome ou de muter :
+
+```text
+current == target   -> AlreadyAtTarget
+current != expected -> ExpectedStateMismatch
+Full + expected Full + target Archived       -> archive
+Archived + expected Archived + target Purged -> purge
+```
+
+Une référence absente est `ReferenceNotFound`. Aucun succès n'est rendu avant commit.
+
+## 6. `Full -> Archived`
+
+La transition :
+
+1. exige un payload hot non vide et borné ;
+2. exige l'absence d'une archive résiduelle ;
+3. insère les octets exacts dans `ksp_raw_transaction_archive_payloads` ;
+4. met `payload = NULL` et `retention_state = 'archived'` sur le canonical ;
+5. commit les deux opérations ensemble.
+
+Aucun état `Archived` sans payload archive n'est committé par KSP.
+
+## 7. `Archived -> Purged`
+
+La transition :
+
+1. exige l'absence de payload hot et la présence d'un payload archive valide ;
+2. supprime la ligne archive ;
+3. met `block_time_unix_millis = NULL`, `payload = NULL` et `retention_state = 'purged'` ;
+4. conserve signature, slot, format id/version et content hash ;
+5. commit atomiquement.
+
+Le tombstone reste donc limité aux cinq champs du contrat API.
+
+## 8. Races croisées
+
+Les acquisitions/idempotence/ForceRehydrate de `pre.005` et les transitions de cette tranche verrouillent la même ligne canonical avant mutation. Les races archive/purge/rehydrate sont donc sérialisées ; la preuve concurrente PostgreSQL réelle reste réservée à `pre.009`.
+
+## 9. Erreurs
+
+La classification backend ajoute :
+
+```text
+RetentionCompactionUnsupported
+```
+
+Les autres classifications réutilisées sont :
+
+```text
+WrongNetwork
+ReferenceNotFound
+DataInvalid
+WriteFailed
+```
+
+Aucun texte serveur, SQLSTATE, query ou bind n'est retenu.
+
+## 10. Migrations
+
+Aucune ressource V000/V001 n'est modifiée. Les checksums attendus restent :
+
+```text
+V000 d29068b8c13b9dc0cc9ef6aaadd0fa12d41e0fe4c56541a1118c4bfc846a1450
+V001 31488cda2f08f3f46c4cdbdbb6c18c243662fada02eac4487040c8735d72cc51
+```
+
+## 11. Gate opérateur demandé
+
+```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
+```
+
+Le test PostgreSQL live reste `#[ignore]`; la preuve métier rétention/concurrence est réservée à `pre.009`.
+
+## 12. Suite si gate vert
+
+```text
+0.3.3-pre.008 — six implémentations de capabilities + dispatch ksp-store-lib
+```