# Delta `0.3.11-pre.012` — réconciliation documentaire finale ## 1. Base requise ```text 0.3.11-pre.011 ``` Le gate technique final opérateur du 8 septembre 2026 est fermé avant cette tranche : rustfmt check, audits, `cargo check`, Clippy strict, 56 tests Worker, tests workspace all-targets/all-features, arbres Cargo Worker normal/features et `cargo tree --duplicates` ont été exécutés avec succès sur `0.3.11-pre.11`. ## 2. Objectif `pre.012` est le couloir de réconciliation documentaire finale de `0.3.11`. La tranche : - transforme les README/USAGE du Worker en références durables ; - remplace les formulations où le Worker était encore décrit comme futur ; - distingue explicitement la fondation source-neutral matérialisée des sources live `0.3.12+` ; - réaligne les graphes d'architecture sur l'absence réelle de Transport dans la fondation ; - ferme plan et validation sur les preuves réellement exécutées ; - ne finalise ni `CHANGELOG.md`, ni `ROADMAP.md`, ni le prompt `0.3.12`. ## 3. Version workspace `pre.012` est documentaire mais n'est pas un fix. Le contrat Cargo KSP impose donc le bump prerelease mécanique : ```text 0.3.11-pre.11 -> 0.3.11-pre.12 ``` Aucun `Cargo.toml` de crate, edge de dépendance, feature, build setting, runtime ou configuration n'est modifié. ## 4. Contrat Worker documenté La documentation durable fixe l'état actuel suivant : ```text Worker concret ksp-worker-raw-transaction-ingest-lib consumer de ksp-worker-api settings réseau/Worker bornés start/stop sur runtime Tokio caller-owned supervision privée des tâches mpsc central borné et backpressure canonicalisation/assembly via ksp-raw-transaction-lib observation key déterministe persistence atomique via ksp-store-lib, mode Normal concurrence Store bornée snapshots latest-value concrets + WorkerSnapshotSource classification settings/runtime/store/content/source/counter/drain shutdown deadline + abort/join avant terminal timeout ``` La même documentation rend explicite ce qui n'appartient pas encore à la fondation : ```text aucune source HTTP/WS/Yellowstone productive aucun edge ksp-onchain-transport-lib aucune lecture Config aucun backend Store direct aucune API publique enqueue/source registration aucun replay/gap-repair live aucune campagne historique/backfill ``` ## 5. Graphe de dépendances réconcilié Le graphe normal Worker confirmé par `pre.011` est documenté comme : ```text ksp-worker-raw-transaction-ingest-lib -> ksp-core-lib -> ksp-logging-lib -> ksp-raw-transaction-lib -> ksp-store-lib # default-features = false -> ksp-worker-api -> sha2 -> tokio ``` L'edge Worker -> `ksp-onchain-transport-lib` reste réservé aux adapters live ultérieurs et n'est plus présenté comme une dépendance déjà matérialisée. ## 6. Fichiers ajoutés ```text crates/ksp-worker-raw-transaction-ingest-lib/README.md crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md deltas/0.3.11/pre.012.md ``` ## 7. Fichiers modifiés ```text Cargo.toml README.md 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/architecture/011-RAW_TRANSACTION_ACQUISITION.md docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md docs/plans/032-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION_PLAN.md docs/validation/028-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION.md ``` ## 8. Fichiers supprimés ```text aucun ``` ## 9. Surfaces volontairement inchangées ```text crates/ksp-worker-raw-transaction-ingest-lib/src/** crates/ksp-worker-raw-transaction-ingest-lib/tests/** crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/** crates/ksp-worker-raw-transaction-ingest-lib/Cargo.toml CHANGELOG.md ROADMAP.md prompts/** config/** ``` ## 10. Validations exécutées pendant l'assemblage Sur l'état exact destiné à l'archive : ```text General Rust rule audit: clean Rust export completeness audit: 0 candidate(s) KSP workspace Rust rule audit: clean Markdown table audit: clean (340 table(s), 795 file(s)) ``` La revue de diff confirme également qu'aucun fichier `src/`, test, manifest de crate, Config, `CHANGELOG.md`, `ROADMAP.md` ou prompt n'est modifié. ## 11. Validations non exécutées dans l'environnement d'assemblage L'environnement d'assemblage ne dispose pas de Cargo/Rustc. Les validations Cargo propres au delta restent donc opérateur : ```bash cargo fmt --all -- --check cargo check --workspace cargo test -p ksp-worker-raw-transaction-ingest-lib ``` Le gate technique lourd (`clippy`, workspace all-targets/all-features, arbres Cargo) n'est pas rejoué car il appartient à `pre.011` et aucun code/test/dépendance/feature n'est modifié. ## 12. Décisions prises - la fondation `0.3.11` est documentée comme Worker concret utilisable pour lifecycle/observabilité, mais sans source réseau productive ; - l'admission reste privée : aucune API publique d'enqueue n'est inventée pour anticiper `0.3.12` ; - les graphes séparent l'état matériel `0.3.11` du futur edge Transport ; - le Job Backfill reste indépendant et historique ; - `pre.013` reste seule propriétaire du prompt `0.3.12`, de `CHANGELOG.md` et de `ROADMAP.md`. ## 13. Questions ouvertes ```text aucune question bloquante pour la clôture documentaire 0.3.11 ``` Les choix précis de source/adapters live restent des décisions de `0.3.12+`, sans être figés par cette tranche documentaire.