v0.3.15-pre.017

This commit is contained in:
2026-09-19 08:36:52 +02:00
parent 5f19786ce9
commit cd5c79c253
15 changed files with 282 additions and 104 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/000-README.md -->
<!-- version: 73 -->
<!-- version: 74 -->
# Documentation KSP
@@ -67,7 +67,14 @@ docs/
│ ├── 027-V0_3_6_JOB_API_BACKFILL_PLAN.md
│ ├── 028-V0_3_7_BACKFILL_DESK_PLAN.md
│ ├── 029-V0_3_8_STORE_DESK_PLAN.md
── 030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md
── 030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md
│ ├── 031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md
│ ├── 032-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION_PLAN.md
│ ├── 033-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY_PLAN.md
│ ├── 034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
│ ├── 035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md
│ ├── 036-V0_3_15_RAW_TRANSACTION_INGEST_DESK_PLAN.md
│ └── 037-V0_3_16_RAW_RESILIENCE_CONFLICT_HANDOFF.md
├── validation/
│ ├── 000-README.md
│ ├── 001-V0_1_4_CONFIG_DESKTOP.md
@@ -95,7 +102,13 @@ docs/
│ ├── 023-V0_3_6_JOB_API_BACKFILL.md
│ ├── 024-V0_3_7_BACKFILL_DESK.md
│ ├── 025-V0_3_8_STORE_DESK.md
── 026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md
── 026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md
│ ├── 027-V0_3_10_RAW_TRANSACTION_INGEST.md
│ ├── 028-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION.md
│ ├── 029-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY.md
│ ├── 030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
│ ├── 031-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING.md
│ └── 032-V0_3_15_RAW_TRANSACTION_INGEST_DESK.md
└── rules/
├── FILE_CONTRACTS.md
├── PROMPT_STRUCTURE.md
@@ -120,6 +133,8 @@ Le plan historique de la phase fondatrice clôturée est conservé dans [`plans/
La candidate `0.3.9 — Worker API générique + audit RAW Transaction` est réconciliée dans [`plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md`](plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md) avec [`validation/026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md`](validation/026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md). `ksp-worker-api` reste Core-only et runtime-neutral pour les services continus ; l'architecture RAW place Store/`RawTransaction` au centre et sépare strictement le Job Backfill historique paramétré du futur Worker Ingest continu start/stop. [`../crates/ksp-worker-api/README.md`](../crates/ksp-worker-api/README.md), [`../crates/ksp-worker-api/USAGE.md`](../crates/ksp-worker-api/USAGE.md), [`architecture/009-ACQUISITION_WORKERS_AND_JOBS.md`](architecture/009-ACQUISITION_WORKERS_AND_JOBS.md) et [`architecture/011-RAW_TRANSACTION_ACQUISITION.md`](architecture/011-RAW_TRANSACTION_ACQUISITION.md) constituent les références durables avant la lane de publication.
Les candidates `0.3.10` à `0.3.15` prolongent cette trajectoire RAW dans [`plans/031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md`](plans/031-V0_3_10_RAW_TRANSACTION_INGEST_PLAN.md), [`plans/032-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION_PLAN.md`](plans/032-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION_PLAN.md), [`plans/033-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY_PLAN.md`](plans/033-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY_PLAN.md), [`plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md`](plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md), [`plans/035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md`](plans/035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md) et [`plans/036-V0_3_15_RAW_TRANSACTION_INGEST_DESK_PLAN.md`](plans/036-V0_3_15_RAW_TRANSACTION_INGEST_DESK_PLAN.md), avec leurs matrices [`validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md`](validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md) à [`validation/032-V0_3_15_RAW_TRANSACTION_INGEST_DESK.md`](validation/032-V0_3_15_RAW_TRANSACTION_INGEST_DESK.md). Cette séquence matérialise le Common RAW partagé, la fondation Worker, Yellowstone live, cinq familles multi-source, la continuité/gap repair puis le Desk multi-route ; `0.3.15` ferme en plus les anomalies Mainnet observées de convergence `logMessages`, backpressure Yellowstone soutenue et shutdown post-half-close. Le handoff [`plans/037-V0_3_16_RAW_RESILIENCE_CONFLICT_HANDOFF.md`](plans/037-V0_3_16_RAW_RESILIENCE_CONFLICT_HANDOFF.md) réserve explicitement à `0.3.16` les variantes RAW durables, la résolution des conflits, les retries Store/Transport et les vues correspondantes de Store Desk ; `0.3.17` et `0.3.18` portent ensuite le Backfill multi-route et son Desk adapté.
## Spécifications de formats
Les formats durables, interopérables et destinés à être réimplémentables hors de KSP sont indexés depuis [`formats/000-README.md`](formats/000-README.md). [`.kspwallet` V1](formats/KSPWALLET_V1.md) reste le format JSON historique stable publié par `0.2.5`. [`.kspwallet` V2](formats/KSPWALLET_V2.md), publié stable avec `0.2.6`, ajoute le wire binaire canonique KSP, le runtime multi-version/default V2 et la migration explicite OWNER-authentifiée V1 -> V2.