0.3.15-pre.014-fix.001
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
<!-- file: docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md -->
|
||||
<!-- version: 16 -->
|
||||
<!-- version: 17 -->
|
||||
|
||||
# Acquisition et alimentation `RawTransaction`
|
||||
|
||||
@@ -869,7 +869,30 @@ settings techniques nécessaires
|
||||
|
||||
Elle peut activer plusieurs providers/endpoints simultanément. Les secrets restent Config-owned, avec réutilisation unique de `KSP_SECRET_HELIUS_API_KEY` pour les surfaces Helius concernées.
|
||||
|
||||
## 15. Handoff `0.3.16` : Job Backfill multi-stratégie
|
||||
## 14.5 Handoff `0.3.16` : résilience RAW et conflits durables
|
||||
|
||||
`0.3.16` doit déplacer la résolution des divergences RAW dans le contrat Store partagé, afin que Worker live et futurs Jobs historiques convergent avec la même politique. Une divergence de contenu n'est plus assimilée automatiquement à une panne d'acquisition.
|
||||
|
||||
Modèle cible :
|
||||
|
||||
```text
|
||||
RawTransaction identity (network, signature)
|
||||
-> canonical_variant
|
||||
-> 1..N variantes de contenu durables
|
||||
-> observations/provenances rattachées à la variante réellement observée
|
||||
-> conflict case éventuel
|
||||
-> historique immutable des promotions/résolutions
|
||||
```
|
||||
|
||||
Classification minimale : `Exact`, `CompatibleLessComplete`, `CompatibleMoreComplete`, `Conflict`. Une représentation prouvée moins complète ne remplace jamais le canonique ; une représentation prouvée plus complète peut le promouvoir atomiquement ; un vrai conflit conserve toutes les variantes sans arrêter l'acquisition. La provenance d'un provider n'établit jamais à elle seule une priorité canonique.
|
||||
|
||||
Le Worker doit distinguer les problèmes locaux durablement gérables des pannes externes. Un conflit RAW quarantiné laisse la route active et rend la santé au plus `Degraded`. Une indisponibilité Store impose backpressure/pause et retry sans perte silencieuse. Une indisponibilité Transport déclenche une politique de reconnexion bornée/configurable (`initial_delay`, `max_delay`, backoff, `max_attempts`, reset après stabilité). Un terminal `Faulted` reste réservé aux erreurs irréconciliables ou à l'épuisement explicite d'une politique de retry/reconnect.
|
||||
|
||||
`ksp-app-store-desk` doit ajouter des vues de conflits/variantes et d'historique. Une résolution manuelle peut promouvoir une variante, conserver le canonique, ou produire une variante de fusion assistée. Toute ancienne valeur canonique reste une variante durable et peut être restaurée ultérieurement ; aucun `UPDATE` destructif ne doit rendre une décision manuelle irréversible.
|
||||
|
||||
Le détail de handoff est fixé dans `docs/plans/037-V0_3_16_RAW_RESILIENCE_CONFLICT_HANDOFF.md`.
|
||||
|
||||
## 15. Handoff `0.3.17` : Job Backfill multi-stratégie
|
||||
|
||||
Le Job doit conserver son vertical slice existant puis ajouter des stratégies historiques choisies selon requête + capabilities + configuration.
|
||||
|
||||
@@ -901,10 +924,10 @@ Ordre conseillé :
|
||||
0.3.13 P1 : multi-source convergence, dedup, provenance, content conflict, backpressure/fairness
|
||||
0.3.13 P2 : health source-neutral, shutdown/races, completeness/security et gate live keyless
|
||||
0.3.14 : trajectoire suivante définie par son prompt dédié ; ne pas réintroduire implicitement un scope reporté
|
||||
0.3.16 P0 : block scan historique
|
||||
0.3.16 P0 : replay Yellowstone borné
|
||||
0.3.16 P1 : provider history/archive
|
||||
0.3.16 P1 : Old Faithful
|
||||
0.3.17 P0 : block scan historique
|
||||
0.3.17 P0 : replay Yellowstone borné
|
||||
0.3.17 P1 : provider history/archive
|
||||
0.3.17 P1 : Old Faithful
|
||||
plus tard : substrats directs et sources vendor-specific sans accès actuel
|
||||
```
|
||||
|
||||
@@ -1026,7 +1049,9 @@ TR-C2 = adapter productif Transport DTO -> common réserv
|
||||
0.3.11 = fondation Worker source-neutral, persistence et observabilité
|
||||
0.3.12 = première verticale Yellowstone + hydration/replay continuity
|
||||
0.3.13 = cinq familles live + convergence/fairness/health/shutdown/completeness
|
||||
0.3.16 = Job Backfill multi-stratégie historique
|
||||
0.3.16 = résilience RAW, variantes/conflits/résolutions, retry/reconnect et Store Desk
|
||||
0.3.17 = Job Backfill multi-route/multi-stratégie historique
|
||||
0.3.18 = Backfill Desk multi-route
|
||||
```
|
||||
|
||||
`0.3.9` n'implémente aucune nouvelle stratégie d'acquisition. Il ferme l'architecture et l'inventaire nécessaires aux releases suivantes.
|
||||
|
||||
Reference in New Issue
Block a user