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

Delta 0.3.11-pre.012 — réconciliation documentaire finale

1. Base requise

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 :

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 :

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 :

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 :

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

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

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

aucun

9. Surfaces volontairement inchangées

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 :

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 :

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

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.