202 lines
7.8 KiB
Markdown
202 lines
7.8 KiB
Markdown
<!-- file: deltas/0.3.10/pre.008.md -->
|
||
<!-- version: 1 -->
|
||
|
||
# Delta `0.3.10-pre.008` — réconciliation documentaire finale RAW commune / cross-source
|
||
|
||
## 1. Base requise
|
||
|
||
```text
|
||
0.3.10-pre.007 appliquée
|
||
workspace.package.version = 0.3.10-pre.7
|
||
```
|
||
|
||
Le rejeu opérateur communiqué le 8 septembre 2026 ferme entièrement le gate technique final de `pre.007` : audits Rust/Markdown, `cargo check --workspace`, Clippy workspace strict, `cargo test --workspace --all-targets --all-features`, suites ciblées common/Transport/Backfill et graphes Cargo demandés sont exécutés sans échec.
|
||
|
||
Les smokes live opt-in restent `ignored` par politique et ne sont pas revendiqués comme preuves réseau exécutées.
|
||
|
||
## 2. Objet
|
||
|
||
Effectuer exclusivement la réconciliation documentaire finale de `0.3.10` après fermeture technique de `pre.007`, sans nouveau développement fonctionnel.
|
||
|
||
Cette tranche :
|
||
|
||
```text
|
||
réconcilie la nomenclature durable des couches de données Store ;
|
||
synchronise la séquence fonctionnelle active avec le redécoupage 0.3.10 -> 0.3.16 ;
|
||
réconcilie les règles et documents d'architecture actifs ;
|
||
complète la documentation durable de ksp-raw-transaction-lib ;
|
||
ne modifie aucun comportement Rust, API, dépendance, feature ou runtime.
|
||
```
|
||
|
||
## 3. Version
|
||
|
||
Cette livraison est une prerelease non-fix :
|
||
|
||
```text
|
||
workspace.package.version = 0.3.10-pre.8
|
||
commit attendu = v0.3.10-pre.008
|
||
aucun tag prerelease
|
||
```
|
||
|
||
Aucune version npm/Tauri n'est modifiée.
|
||
|
||
## 4. Nomenclature canonique des couches de données
|
||
|
||
La progression durable du Store devient :
|
||
|
||
```text
|
||
D1 RAW -> D2 STRUCTURAL -> D3 DECODED -> D4 DOMAIN
|
||
```
|
||
|
||
Sémantique :
|
||
|
||
```text
|
||
D1 RAW = matériau acquis et conservé avant décomposition métier ;
|
||
D2 STRUCTURAL = décomposition Solana générique en structures unitaires exploitables ;
|
||
D3 DECODED = décodage générique des structures selon les contrats de programmes ;
|
||
D4 DOMAIN = matérialisation métier/spécialisée issue des données décodées.
|
||
```
|
||
|
||
L'ancien nom de couche D2 `CORE` est abandonné. Il créait une ambiguïté avec `ksp-core-lib` et le domaine Core fondamental alors que cette couche Store représente une décomposition structurelle du RAW.
|
||
|
||
Cette normalisation ne renomme jamais :
|
||
|
||
```text
|
||
ksp-core-lib ;
|
||
le domaine Core architectural fondamental ;
|
||
les noms propres comme « Solana Core Programs » ;
|
||
les traces historiques clôturées qui documentent l'ancienne terminologie.
|
||
```
|
||
|
||
Les niveaux architecturaux `N1–N4` de `docs/architecture/002-LAYERS_AND_DEPENDENCIES.md` restent réservés aux niveaux de composants. Les couches de données utilisent désormais `D1–D4` afin d'éviter toute collision de vocabulaire. Les plans Store historiques qui parlaient de N1–N4 data restent interprétables selon la correspondance ci-dessus mais ne sont pas réécrits en masse.
|
||
|
||
## 5. Conséquences STRUCTURAL
|
||
|
||
Les rôles actifs deviennent explicitement :
|
||
|
||
```text
|
||
STRUCTURAL persistence
|
||
RAW -> STRUCTURAL replay/backfill
|
||
STRUCTURAL job
|
||
STRUCTURAL worker
|
||
STRUCTURAL inspection/control app lorsque pertinent
|
||
```
|
||
|
||
Le `STRUCTURAL job` est borné et rejouable. Le `STRUCTURAL worker` traite continuellement le backlog RAW. Aucun des deux ne réalise le décodage Program : la frontière `STRUCTURAL -> DECODED` reste en aval.
|
||
|
||
## 6. Séquence fonctionnelle active
|
||
|
||
`docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md` est remis en cohérence avec la trajectoire réellement matérialisée :
|
||
|
||
```text
|
||
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
|
||
```
|
||
|
||
Le redécoupage ne change pas les frontières Job/Worker arrêtées précédemment et ne réintroduit aucun Worker concret dans `0.3.10`.
|
||
|
||
## 7. Documentation de `ksp-raw-transaction-lib`
|
||
|
||
La crate common RAW étant désormais une bibliothèque complétée de `0.3.10`, elle reçoit :
|
||
|
||
```text
|
||
crates/ksp-raw-transaction-lib/README.md
|
||
crates/ksp-raw-transaction-lib/USAGE.md
|
||
```
|
||
|
||
Le `README.md` fixe son rôle, ses dépendances autorisées et ses frontières. Le `USAGE.md` reste volontairement version-neutre et montre uniquement l'utilisation durable de la surface publique de crate root : signatures, wire Solana, canonicalisation RAW et assemblage acquisition/observation.
|
||
|
||
La documentation rappelle explicitement que le résultat de cette crate reste D1 RAW et qu'elle n'implémente pas la transformation RAW -> STRUCTURAL.
|
||
|
||
## 8. ROADMAP et publication
|
||
|
||
`ROADMAP.md` est modifié uniquement pour éliminer l'ancien libellé actif `RAW/CORE/DECODE/SPECIALIZED` au profit de `RAW/STRUCTURAL/DECODED/DOMAIN`.
|
||
|
||
Les changements de statut de release, le CHANGELOG et la préparation du prompt `0.3.11` restent réservés à `pre.009`.
|
||
|
||
## 9. Traces historiques
|
||
|
||
Les prompts, deltas, plans et validations clôturés ne sont pas réécrits en masse. Une ancienne occurrence de `CORE` dans une trace historique peut donc rester légitime lorsqu'elle décrit l'état documentaire de sa livraison.
|
||
|
||
Cette tranche corrige les documents durables actifs, pas l'histoire du repository.
|
||
|
||
## 10. Fichiers modifiés
|
||
|
||
```text
|
||
Cargo.toml
|
||
ROADMAP.md
|
||
docs/IDEAS.md
|
||
docs/architecture/002-LAYERS_AND_DEPENDENCIES.md
|
||
docs/architecture/003-COMPONENT_CONTRACTS.md
|
||
docs/architecture/004-COMPONENT_INVENTORY.md
|
||
docs/architecture/005-DEPENDENCY_GRAPH.md
|
||
docs/architecture/006-WIRE_AND_PROGRAM.md
|
||
docs/architecture/008-DATA_MATERIALIZATION_AND_STORE.md
|
||
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
|
||
docs/architecture/010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md
|
||
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
||
docs/plans/031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md
|
||
docs/rules/RULES_DEPENDENCIES.md
|
||
docs/rules/RULES_KSP.md
|
||
docs/validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md
|
||
```
|
||
|
||
## 11. Fichiers ajoutés
|
||
|
||
```text
|
||
crates/ksp-raw-transaction-lib/README.md
|
||
crates/ksp-raw-transaction-lib/USAGE.md
|
||
deltas/0.3.10/pre.008.md
|
||
```
|
||
|
||
Aucun fichier Rust source, manifest de crate, Config, frontend ou dépendance n'est modifié.
|
||
|
||
## 12. Validation d'assemblage
|
||
|
||
À enregistrer avant livraison :
|
||
|
||
```text
|
||
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
|
||
contrôle statique nomenclature D1-D4 / STRUCTURAL
|
||
contrôle statique version/scope/headers
|
||
contrôle exact de l'inventaire delta
|
||
contrôle archive delta et reconstruction overlay
|
||
```
|
||
|
||
Cargo/rustc/rustfmt ne sont pas disponibles dans l'environnement d'assemblage ; aucun gate Cargo de `pre.008` n'est déclaré PASS localement. Le gate technique complet de `pre.007` reste la baseline opérateur fermée ; `pre.008` ne modifie aucun code ni graphe de dépendances.
|
||
|
||
## 13. Rejeu opérateur `pre.008`
|
||
|
||
Comme cette tranche est documentaire hors incrément mécanique de version workspace, le rejeu minimal attendu est :
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
Un échec ouvre `pre.008-fix.NNN`. Aucun nouveau test fonctionnel ou smoke live n'est requis par cette réconciliation documentaire seule.
|
||
|
||
## 14. Suite
|
||
|
||
Après retour opérateur vert sur `0.3.10-pre.8` :
|
||
|
||
```text
|
||
pre.009 = préparation publication, CHANGELOG, statuts ROADMAP et prompt 0.3.11
|
||
rel.001 = publication stable mécanique de 0.3.10
|
||
```
|