7.8 KiB
Delta 0.3.10-pre.008 — réconciliation documentaire finale RAW commune / cross-source
1. Base requise
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 :
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 :
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 :
D1 RAW -> D2 STRUCTURAL -> D3 DECODED -> D4 DOMAIN
Sémantique :
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 :
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 :
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 :
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 :
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
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
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 :
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 :
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 :
pre.009 = préparation publication, CHANGELOG, statuts ROADMAP et prompt 0.3.11
rel.001 = publication stable mécanique de 0.3.10