# 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 ```