4.6 KiB
Delta 0.3.10-pre.006-fix.002 — rustdoc Yellowstone + réconciliation architecture/prompt handoff
1. Base requise
0.3.10-pre.006-fix.001 appliquée
workspace.package.version = 0.3.10-pre.6.fix.1
Le gate opérateur du 7 septembre 2026 confirme que les erreurs Rust corrigées par fix.001 ont disparu. Le seul blocage restant sous Clippy strict est le lint crate-level missing_docs de crates/ksp-job-backfill-lib/tests/yellowstone_raw_parity.rs.
2. Version technique
Le correctif modifie un test Rust compilé. Conformément à VER-ID-007 / VER-ID-010 :
workspace.package.version = 0.3.10-pre.6.fix.2
commit attendu = v0.3.10-pre.006-fix.002
aucun tag prerelease
Aucune version npm/Tauri n'est modifiée : aucune application Desk n'est touchée.
3. Correction Rust
tests/yellowstone_raw_parity.rs reçoit la rustdoc crate-level manquante :
//! Deterministic local Yellowstone gRPC parity canary for source-neutral RAW transaction v1 projection.
Aucun #[allow(missing_docs)] n'est ajouté. Le serveur fixture, la projection Yellowstone, les goldens, les assertions et les dépendances restent inchangés.
4. Inventaire des composants
docs/architecture/004-COMPONENT_INVENTORY.md :
+ ksp-raw-transaction-lib comme common RAW Transaction implémentée en 0.3.10
CORE processor -> STRUCTURAL job
CORE worker -> STRUCTURAL worker
Le Job STRUCTURAL représente le traitement borné/rejouable RAW -> CORE ; le Worker STRUCTURAL représente le service continu backlog RAW -> CORE. Les références durables correspondantes dans 009-ACQUISITION_WORKERS_AND_JOBS.md, 010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md et la séquence fonctionnelle active sont synchronisées. Les noms/packagings concrets restent à fixer lors de l'ouverture de la couche CORE.
5. Graphe de dépendances
docs/architecture/005-DEPENDENCY_GRAPH.md matérialise la lower layer réelle :
ksp-raw-transaction-lib
-> ksp-store-api
-> ksp-core-lib
-> base64 / serde_json / sha2
-X-> Transport
-X-> ksp-store-lib
-X-> Job / Worker
-X-> Config / runtime async / backend Store
Le graphe Backfill ajoute son edge réel vers ksp-raw-transaction-lib, et le graphe du futur Worker réserve la même common crate avant la persistence par ksp-store-lib.
6. Note de génération des prompts 0.3.12 à 0.3.15
Le plan 031 n'introduit pas quatre prompts prématurés. Il fixe un handoff séquentiel :
0.3.11 ferme -> génère le prompt 0.3.12
0.3.12 ferme -> génère le prompt 0.3.13
0.3.13 ferme -> génère le prompt 0.3.14
0.3.14 ferme -> génère le prompt 0.3.15
Chaque prompt doit partir de la base stable réellement obtenue, refaire son audit/sizing pre.001, rester sous le budget 15–20 min par tranche et rescinder sa release si la clôture dans une session devient incertaine. La note transfère les missions Yellowstone, WS/Helius/HTTP, gap repair/hardening puis Desk sans les figer comme vérité future.
Le plan corrige aussi l'ancienne référence résiduelle de la Desk 0.3.11 vers sa cible recalibrée 0.3.15.
7. Validation opérateur requise
cargo fmt --all
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
cargo test -p ksp-raw-transaction-lib
cargo test -p ksp-onchain-transport-lib
cargo test -p ksp-job-backfill-lib
cargo tree -p ksp-job-backfill-lib --edges normal
cargo tree -p ksp-job-backfill-lib --edges dev
cargo tree -p ksp-job-backfill-lib -e features
Aucune commande ne doit être déclarée PASS avant exécution réelle. Si ce gate est vert, pre.006-fix.002 ferme le défaut technique restant de pre.006 et pre.007 peut rester le gate technique final recalibré de 0.3.10.
8. Périmètre du delta
Cargo.toml
crates/ksp-job-backfill-lib/tests/yellowstone_raw_parity.rs
docs/architecture/004-COMPONENT_INVENTORY.md
docs/architecture/005-DEPENDENCY_GRAPH.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/validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md
deltas/0.3.10/pre.006-fix.002.md
Aucun code de production, manifest de crate, dépendance, feature, golden RAW, Config, Store schema, frontend ou application n'est modifié.