159 lines
4.6 KiB
Markdown
159 lines
4.6 KiB
Markdown
<!-- 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
|
|
```
|