v0.3.10-pre.006-fix.002

This commit is contained in:
2026-09-08 00:17:25 +02:00
parent 919b4ed46d
commit 1a352aa8d0
10 changed files with 288 additions and 66 deletions

View File

@@ -0,0 +1,118 @@
<!-- file: deltas/0.3.10/pre.006-fix.002.md -->
<!-- version: 1 -->
# Delta `0.3.10-pre.006-fix.002` — rustdoc Yellowstone + réconciliation architecture/prompt handoff
## 1. Base requise
```text
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` :
```text
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 :
```text
//! 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` :
```text
+ 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 :
```text
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 :
```text
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 1520 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
```bash
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
```text
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é.