119 lines
4.6 KiB
Markdown
119 lines
4.6 KiB
Markdown
<!-- 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 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
|
||
|
||
```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é.
|