v0.3.10-pre.008

This commit is contained in:
2026-09-08 06:43:02 +02:00
parent ab87fd23cd
commit 510adcb49b
21 changed files with 790 additions and 195 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md -->
<!-- version: 96 -->
<!-- version: 97 -->
# Séquence des releases fonctionnelles KSP
@@ -524,7 +524,7 @@ Metadata HTTP/IPFS/Arweave viendra au premier besoin Metadata réel. SOL/EUR et
La dependency direction reste strictement `Interface -> Core`; aucun serde/codec générique, `solana-instruction`, runtime réseau ou logging n'est introduit. La façade crate-root est verrouillée par canaris public API, consumer externe, release completeness et dependency firewall. [`../../crates/ksp-interface-lib/README.md`](../../crates/ksp-interface-lib/README.md) et [`../../crates/ksp-interface-lib/USAGE.md`](../../crates/ksp-interface-lib/USAGE.md) deviennent les références durables de cette foundation. Le gate technique final `pre.006` est vert avant réconciliation documentaire.
Aucune `ksp-interface-api` séparée n'est retenue pour l'instant. Les codecs/layouts spécifiques restent conditionnés à un vertical réel, tandis que les wires génériques d'acquisition/CORE restent reportés à `0.3.2+`.
Aucune `ksp-interface-api` séparée n'est retenue pour l'instant. Les codecs/layouts spécifiques restent conditionnés à un vertical réel. La décomposition STRUCTURAL générique reste reportée à la série STRUCTURAL ouverte seulement après fermeture de la couche RAW ; elle n'est plus associée à un ancien numéro `0.3.2+` devenu obsolète.
### `0.2.14` — Program API foundation
@@ -552,50 +552,62 @@ Le hardening final verrouille l'inventaire crate-root exact, le passage d'une `P
Restent explicitement reportés : `ksp-program-lib`, payload canonique D3, registry runtime, identity/version/coverage génériques, autres familles de decoder et `ProgramExecutionPreparer`. Ils seront introduits uniquement par les vertical slices qui démontreront leurs contrats réels.
## Architecture durable : RAW -> CORE -> DECODE -> SPECIALIZED
## Architecture durable : RAW -> STRUCTURAL -> DECODED -> DOMAIN
La chaîne de données est :
```text
D1 RAW
-> D2 CORE
-> D3 DECODE
-> D4 SPECIALIZED
-> D2 STRUCTURAL
-> D3 DECODED
-> D4 DOMAIN
```
RAW et CORE ne nécessitent aucun decoder Program.
RAW et STRUCTURAL ne nécessitent aucun decoder Program.
`RAW -> CORE` est une normalisation générique Solana ; le premier decoder intervient à `CORE -> DECODE`.
`RAW -> STRUCTURAL` est une normalisation générique Solana ; le premier decoder intervient à `STRUCTURAL -> DECODED`.
## Série `0.3.x` — RAW / acquisition persistée
Début décidé :
La séquence effective a évolué par sizing et validation réels. La référence détaillée reste `ROADMAP.md`; cette synthèse conserve uniquement les frontières fonctionnelles :
```text
0.3.1 ksp-store-api + ksp-store-lib, RAW only
0.3.2 ksp-interface-lib, wires génériques acquisition/CORE
0.3.3 ksp-job-api + backfill
0.3.4 application backfill/RAW
0.3.1 ksp-store-api RAW
0.3.2 Store runtime + backend PostgreSQL foundation
0.3.3 persistence RawTransaction
0.3.4 persistence RawAccountState
0.3.5 Interface acquisition events
0.3.6 ksp-job-api + RawTransaction Backfill
0.3.7 ksp-app-backfill-desk
0.3.8 ksp-app-store-desk RAW
0.3.9 ksp-worker-api + audit acquisition RawTransaction
0.3.10 common ksp-raw-transaction-lib + preuves cross-source
0.3.11-0.3.14 Worker RAW ingest découpé par responsabilité
0.3.15 ksp-app-raw-transaction-ingest-desk
0.3.16 Backfill multi-source / multi-stratégie
```
La suite de la série termine la couche RAW avec worker/service live et outils d'exploitation utiles avant l'ouverture de CORE.
Cette série ferme la couche RAW et ses outils d'exploitation avant l'ouverture fonctionnelle de STRUCTURAL. Le Worker live RAW reste distinct des jobs historiques et ne constitue pas encore une transformation RAW -> STRUCTURAL.
`0.3.1` ne doit pas créer par anticipation les modèles/tables DECODE/SPECIALIZED.
Aucune release RAW ne crée par anticipation la persistence DECODED/DOMAIN.
## Série CORE suivante
## Série STRUCTURAL suivante
Objectif : rendre CORE exploitable sans aucun decoder Program :
Objectif : rendre la couche STRUCTURAL exploitable sans aucun decoder Program. Elle décompose les entrées RAW réellement décomposables en unités Solana génériques plus fines destinées au décodage ultérieur :
```text
RAW persisted
-> Solana generic normalization
-> CORE persistence
-> RAW->CORE replay/backfill
-> STRUCTURAL worker/service
-> CORE inspection/control app
-> Solana generic structural decomposition
-> STRUCTURAL persistence
-> RAW -> STRUCTURAL replay/backfill
-> STRUCTURAL job borné/rejouable
-> STRUCTURAL worker/service continu
-> STRUCTURAL inspection/control dans ksp-app-store-desk lorsque pertinent
```
## Séries DECODE/SPECIALIZED/EXECUTION suivantes
Le nom de couche historique `CORE` est abandonné. `Core` reste réservé à `ksp-core-lib`, à son domaine fondamental et aux noms propres tels que « Solana Core Programs ».
## Séries DECODED/DOMAIN/EXECUTION suivantes
À partir du décodage, KSP progresse par vertical slices complets et non par grandes couches de crates isolées :
@@ -638,7 +650,7 @@ Après les DEX prioritaires, introduire une petite `ksp-app-market-desk` consomm
Après Jupiter/OKX, enrichir la même app avec routes, legs, DEX impliqués, fees/slippage et quote/execution lorsque disponible.
L'app ne réimplémente pas les SDK/protocoles DEX ; elle consomme les faits SPECIALIZED normalisés.
L'app ne réimplémente pas les SDK/protocoles DEX ; elle consomme les faits DOMAIN normalisés.
## Discipline de sizing

View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md -->
<!-- version: 13 -->
<!-- version: 14 -->
# Plan v0.3.10 — RAW Transaction commune + qualification cross-source
@@ -1044,7 +1044,7 @@ Statut : réalisés, avec fixes déjà tracés et `pre.006-fix.001` requis pour
### `pre.007` — gate technique final `0.3.10`
Statut : **ouvert sur `0.3.10-pre.7`** après gate opérateur entièrement vert de `pre.006-fix.002`.
Statut : **fermé**. Le gate opérateur sur `0.3.10-pre.7` est entièrement vert, y compris workspace tests, Clippy strict, suites ciblées et graphes demandés.
Budget cible : **1520 min**. Rejouer le workspace complet, Clippy strict, suites common/Transport/Backfill, arbres normal/dev/features pertinents et duplicate tree. Aucun nouveau scope fonctionnel ; tout défaut découvert appartient à une tranche corrective dédiée avant de poursuivre la fermeture.
@@ -1052,7 +1052,9 @@ Le gate exact de cette tranche ne référence plus `ksp-worker-raw-transaction-i
### `pre.008` — réconciliation documentaire `0.3.10`
Budget cible : **1015 min**. Réconcilier plan, validation, README/USAGE de la common si nécessaire et architecture durable avec le périmètre effectivement livré. Aucun runtime Worker, smoke nouveau, CHANGELOG, ROADMAP ou prompt suivant.
Statut : **ouvert sur `0.3.10-pre.8`** après fermeture technique de `pre.007`.
Budget cible : **1015 min**. Réconcilier plan, validation, séquence fonctionnelle active, règles/architecture durables et README/USAGE de la common avec le périmètre effectivement livré. Normaliser la couche Store D2 (appelée N2 dans certains plans Store historiques) sous le nom `STRUCTURAL` et éliminer les références actives à l'ancien nom de couche `CORE`, sans renommer `ksp-core-lib`, le domaine Core fondamental ou les traces historiques clôturées. `ksp-raw-transaction-lib` doit recevoir `README.md` et `USAGE.md` puisqu'elle devient une bibliothèque complétée. Aucun runtime Worker, smoke nouveau, CHANGELOG ou prompt suivant. `ROADMAP.md` peut être corrigé uniquement pour la nomenclature durable des couches ; ses statuts de publication restent réservés à `pre.009`.
### `pre.009` — préparation de publication `0.3.10`