khadhroony-solana-project/deltas/0.3.11/pre.012.md

<!-- 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.