v0.3.11-pre.012

deltas/0.3.11/pre.012.md

@@ -0,0 +1,169 @@
+<!-- file: deltas/0.3.11/pre.012.md -->
+<!-- version: 1 -->
+
+# 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.