0.3.16-pre.009
This commit is contained in:
181
deltas/0.3.16/pre.009.md
Normal file
181
deltas/0.3.16/pre.009.md
Normal file
@@ -0,0 +1,181 @@
|
||||
<!-- file: deltas/0.3.16/pre.009.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# Delta `0.3.16-pre.009` — réconciliation documentaire finale
|
||||
|
||||
## Base requise
|
||||
|
||||
```text
|
||||
0.3.16-pre.008-fix.001 appliqué
|
||||
workspace.package.version = 0.3.16-pre.8.fix.1
|
||||
```
|
||||
|
||||
Le gate opérateur de `pre.008-fix.001` est entièrement propre : format, audits Rust/Markdown, `cargo check --workspace`, Clippy workspace/all-targets/all-features avec `-D warnings`, Store API, Store façade, PostgreSQL, Job Backfill et Worker passent. Le live proof `postgres_raw_transaction_live` a également été exécuté séparément avec succès sur PostgreSQL 17.
|
||||
|
||||
## Objectif
|
||||
|
||||
`pre.009` est exclusivement la lane de réconciliation documentaire finale de `0.3.16`.
|
||||
|
||||
Elle aligne les références durables sur l'état réellement implémenté et validé :
|
||||
|
||||
```text
|
||||
V003 multi-variantes
|
||||
selector canonique + promotion atomique
|
||||
comparateur partagé fail-closed
|
||||
conflict case minimal durable
|
||||
QuarantinedConflict non terminal côté Worker
|
||||
projection Conflict côté Backfill
|
||||
hardening concurrence / rollback / PostgreSQL live
|
||||
```
|
||||
|
||||
Aucun code runtime, test fonctionnel, migration, configuration, `CHANGELOG.md`, `ROADMAP.md` ou prompt de démarrage suivant n'est modifié.
|
||||
|
||||
## Version
|
||||
|
||||
```text
|
||||
workspace.package.version = 0.3.16-pre.9
|
||||
```
|
||||
|
||||
## Plan et validation
|
||||
|
||||
Le plan 038 est réconcilié avec les gates réellement observés :
|
||||
|
||||
- `pre.005` à `pre.008-fix.001` sont décrits avec leur état livré/validé ;
|
||||
- `pre.008` enregistre le live PostgreSQL 17 comme PASS ;
|
||||
- `0.3.16` ne revendique ni résolution complète, ni retry Store, ni reconnect configurable, ni Store Desk ;
|
||||
- les lanes de fermeture `0.3.17` et `0.3.18` sont séparées conformément aux règles actuelles entre gate technique, réconciliation documentaire et préparation de publication.
|
||||
|
||||
La validation 033 ajoute la matrice finale `0.3.16`, le gate opérateur complet de `pre.008-fix.001`, la preuve PostgreSQL réelle, les scopes explicitement reportés et l'état de fermeture avant `pre.010`.
|
||||
|
||||
## Références d'architecture
|
||||
|
||||
Les références durables sont réalignées sur le découpage courant :
|
||||
|
||||
```text
|
||||
0.3.16 fondations RAW multi-variantes + conflit durable minimal + Worker non terminal
|
||||
0.3.17 lifecycle/résolution/rétention variantes + résilience Store/Transport
|
||||
0.3.18 Store Desk variantes/conflits/résolutions
|
||||
0.3.19 cible Backfill multi-route/multi-stratégie
|
||||
0.3.20 cible Backfill Desk multi-route
|
||||
```
|
||||
|
||||
Le handoff historique `037` reste inchangé ; il est explicitement présenté comme historique et supersédé pour le sizing par le plan 038.
|
||||
|
||||
## Documentation Store
|
||||
|
||||
`ksp-store-lib` et `ksp-store-postgres-lib` documentent désormais :
|
||||
|
||||
- les 14 capabilities RAW réellement implémentées, dont les quatre inspections ;
|
||||
- V003 et ses quatre tables ;
|
||||
- les outcomes de variantes ;
|
||||
- `QuarantinedConflict` comme succès durable ;
|
||||
- la promotion atomique `CompatibleMoreComplete` ;
|
||||
- le mapping observation -> variante réellement reçue ;
|
||||
- la conservation du canonique sur conflit/incomparable ;
|
||||
- la portée volontairement minimale du conflict case `0.3.16`.
|
||||
|
||||
## Documentation Worker / Backfill
|
||||
|
||||
Le Worker documente comme contrat stable `0.3.16` que la sérialisation run-local ne décide plus du contenu et que toute acquisition atteint le Store ; `QuarantinedConflict` laisse le Worker `Running/Degraded` et n'empêche pas l'identité suivante.
|
||||
|
||||
Le Job Backfill documente la projection `QuarantinedConflict -> Conflict` tout en conservant l'outcome réel de l'observation. Les deux références Backfill utilisent désormais la terminologie `STRUCTURAL` au lieu de l'ancien nom de couche `CORE`.
|
||||
|
||||
## Fichiers modifiés
|
||||
|
||||
```text
|
||||
Cargo.toml
|
||||
docs/000-README.md
|
||||
docs/architecture/004-COMPONENT_INVENTORY.md
|
||||
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
|
||||
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
||||
docs/plans/038-V0_3_16_RAW_RESILIENCE_CONFLICT_PLAN.md
|
||||
docs/validation/033-V0_3_16_RAW_RESILIENCE_CONFLICT.md
|
||||
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
|
||||
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||
crates/ksp-job-backfill-lib/README.md
|
||||
crates/ksp-job-backfill-lib/USAGE.md
|
||||
```
|
||||
|
||||
## Fichier ajouté
|
||||
|
||||
```text
|
||||
deltas/0.3.16/pre.009.md
|
||||
```
|
||||
|
||||
## Fichiers supprimés
|
||||
|
||||
```text
|
||||
aucun
|
||||
```
|
||||
|
||||
## Validation opérateur de la base
|
||||
|
||||
Le gate `pre.008-fix.001` fourni par l'opérateur est entièrement vert. Les résultats détaillés sont désormais consignés dans `docs/validation/033-V0_3_16_RAW_RESILIENCE_CONFLICT.md`.
|
||||
|
||||
Le live PostgreSQL séparé a produit :
|
||||
|
||||
```text
|
||||
server major 17
|
||||
1 passed; 0 failed
|
||||
```
|
||||
|
||||
## Validations de génération
|
||||
|
||||
Exécutées dans l'environnement de génération :
|
||||
|
||||
```bash
|
||||
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
|
||||
```
|
||||
|
||||
Résultats :
|
||||
|
||||
```text
|
||||
General Rust rule audit: clean
|
||||
Rust export completeness audit: 0 candidate(s)
|
||||
KSP workspace Rust rule audit: clean
|
||||
Markdown table audit: clean (352 table(s), 959 file(s))
|
||||
```
|
||||
|
||||
Le toolchain Rust n'est pas installé dans l'environnement de génération. Le changement de version Cargo impose donc au gate opérateur de rejouer format/check/Clippy/tests, même si cette tranche ne modifie aucun source Rust.
|
||||
|
||||
## Gate opérateur demandé
|
||||
|
||||
```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 deltas
|
||||
|
||||
cargo check --workspace
|
||||
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||
|
||||
cargo test -p ksp-store-api --all-targets --all-features
|
||||
cargo test -p ksp-store-lib --all-targets --all-features
|
||||
cargo test -p ksp-store-postgres-lib --all-targets --all-features
|
||||
cargo test -p ksp-job-backfill-lib --all-targets --all-features
|
||||
cargo test -p ksp-worker-raw-transaction-ingest-lib --all-targets --all-features
|
||||
```
|
||||
|
||||
Aucun live PostgreSQL supplémentaire n'est requis par `pre.009`, car cette tranche ne modifie aucun test/runtime et le live `pre.008` a déjà été exécuté avec succès.
|
||||
|
||||
## Décisions prises
|
||||
|
||||
- la documentation finale de `0.3.16` décrit uniquement les capacités effectivement livrées ;
|
||||
- `0.3.17` et `0.3.18` conservent explicitement les responsabilités non implémentées ;
|
||||
- les extensions Backfill restent reportées par défaut à `0.3.19`/`0.3.20` ;
|
||||
- le handoff historique n'est pas réécrit ;
|
||||
- `CHANGELOG.md`, `ROADMAP.md` et le prompt `0.3.17` restent réservés à `pre.010`.
|
||||
|
||||
## Questions ouvertes
|
||||
|
||||
Aucune question documentaire bloquante pour `0.3.16`.
|
||||
|
||||
## Suite
|
||||
|
||||
Après gate propre : `0.3.16-pre.010`, préparation de publication minimale uniquement (`CHANGELOG.md`, `ROADMAP.md`, prompt de démarrage `0.3.17`, version et delta).
|
||||
Reference in New Issue
Block a user