v0.3.9-rel.001

Cargo.toml

@@ -1,12 +1,12 @@
 # file: Cargo.toml
-# version: 488
+# version: 489
 
 [workspace]
 resolver = "3"
 members = ["crates/ksp-app-backfill-desk", "crates/ksp-app-config-desk", "crates/ksp-app-solprices-desk", "crates/ksp-app-store-desk", "crates/ksp-app-wallet-desk", "crates/ksp-config-lib", "crates/ksp-core-lib", "crates/ksp-interface-lib", "crates/ksp-job-api", "crates/ksp-job-backfill-lib", "crates/ksp-logging-lib", "crates/ksp-offchain-transport-lib", "crates/ksp-onchain-transport-lib", "crates/ksp-program-api", "crates/ksp-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib", "crates/ksp-worker-api"]
 
 [workspace.package]
-version = "0.3.9-pre.9"
+version = "0.3.9"
 edition = "2024"
 license = "MIT"
 repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project"

deltas/0.3.9/rel.001.md

@@ -0,0 +1,172 @@
+<!-- file: deltas/0.3.9/rel.001.md -->
+<!-- version: 1 -->
+
+# Delta `0.3.9-rel.001` — publication stable
+
+## Base requise
+
+Base directe attendue :
+
+```text
+0.3.9-pre.009
+workspace.package.version = 0.3.9-pre.9
+```
+
+Le gate minimal opérateur de `pre.009`, exécuté le **5 septembre 2026**, est propre :
+
+```text
+General Rust rule audit: clean
+Rust export completeness audit: 0 candidate(s)
+KSP workspace Rust rule audit: clean
+Markdown table audit: clean (332 table(s), 749 file(s))
+cargo check --workspace: PASS
+```
+
+Les couloirs de fermeture antérieurs sont déjà fermés :
+
+- `pre.007`, corrigée par `pre.007-fix.001` puis `pre.007-fix.002` : gate technique final, passage explicite à `jsonschema ^0.53` et `yellowstone-grpc-proto ^12.7`, adaptation des fixtures serveur au RPC `SubscribeGossip`, puis workspace `--all-targets --all-features`, Worker API et graphes Cargo validés ;
+- `pre.008` : réconciliation documentaire finale des surfaces Worker/architecture/indexes/plan/validation ;
+- `pre.009` : préparation minimale de publication avec `CHANGELOG.md`, `ROADMAP.md` et `prompts/029-V0_3_10_START_PROMPT.md`.
+
+## Objet
+
+Publier mécaniquement la version stable :
+
+```text
+0.3.9
+```
+
+Conformément à `VER-LIFECYCLE-012`, cette tranche ne corrige ni code, ni test, ni documentation durable, ni architecture, ni configuration, ni dépendance, ni prompt.
+
+Tout défaut nouveau renvoie vers une prerelease appropriée ; `rel.001` n'est pas une tranche de rattrapage.
+
+## Modification
+
+### `Cargo.toml`
+
+Le header est incrémenté parce que le fichier est réellement modifié :
+
+```text
+488 -> 489
+```
+
+La version workspace devient :
+
+```text
+0.3.9-pre.9 -> 0.3.9
+```
+
+Aucune autre ligne du `Cargo.toml` racine n'est modifiée.
+
+## Fichiers ajoutés
+
+```text
+deltas/0.3.9/rel.001.md
+```
+
+## Fichiers modifiés
+
+```text
+Cargo.toml
+```
+
+## Fichiers supprimés
+
+```text
+aucun
+```
+
+## Surfaces explicitement inchangées
+
+```text
+CHANGELOG.md
+ROADMAP.md
+README.md
+RULES.md
+prompts/029-V0_3_10_START_PROMPT.md
+crates/**
+docs/**
+config/**
+```
+
+La surface préparée en `pre.009` reste byte-identique hors mécanique Cargo et ajout du présent delta.
+
+## Surface stable publiée
+
+`0.3.9` stabilise d'abord `ksp-worker-api` comme API générique, courte et runtime-neutral pour services continus :
+
+- identité et kind bornés ;
+- lifecycle explicite et états terminaux immuables ;
+- health/activity sûrs ;
+- stop token partagé et idempotent ;
+- séquence/snapshot latest-value ;
+- `WorkerSnapshotSource` object-safe, `Send + Sync`, consommable sans runtime imposé ;
+- dépendance runtime exclusivement vers `ksp-core-lib` ;
+- aucune dépendance Job, Solana, Transport, Store, Config ou Tauri ;
+- aucun `start/stop/restart/reconfigure` universel imposé par l'API générique.
+
+Après freeze de cette API, la release publie également l'audit d'acquisition `RawTransaction` consolidé dans `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md` :
+
+- Store / `RawTransaction` est le centre du modèle RAW ;
+- Job Backfill historique paramétré et Worker Raw Transaction Ingest live sont deux producteurs indépendants du même Store ;
+- HTTP, WebSocket, Yellowstone gRPC, provider extensions, blocs/slots, discovery + hydration, replay, archives et sources EARLY sont classés par capability et non par rôle ;
+- possibilités documentées, support architectural, implémentation KSP et preuve live sont distingués explicitement ;
+- `mainnet` devient l'identité KSP canonique, `mainnet-beta` restant un alias legacy/externe lorsque nécessaire à une frontière provider ;
+- la normalisation RAW v1 commune doit être extraite vers `ksp-raw-transaction-lib`, sans edge Job ↔ Worker ;
+- le Worker `0.3.10` est live multi-source dès V1 et ne devient pas un moteur de campagne historique ;
+- les extensions Backfill multi-source/multi-stratégie restent réservées à `0.3.12`.
+
+La base technique publiée inclut également les baselines compatibles retenues pendant le gate final :
+
+```text
+jsonschema = ^0.53
+yellowstone-grpc-proto = ^12.7
+```
+
+L'ajout upstream `SubscribeGossip` de Yellowstone 12.7 est pris en compte uniquement dans les fixtures serveur de test de cette release ; aucune surface Gossip de production n'est ouverte par `0.3.9`.
+
+## Suite préparée
+
+La session suivante part exclusivement de la base stable :
+
+```text
+v0.3.9
+```
+
+et exécute :
+
+```text
+prompts/029-V0_3_10_START_PROMPT.md
+```
+
+pour ouvrir :
+
+```text
+0.3.10 — normalisation RAW commune + Worker RawTransaction live multi-source
+```
+
+`0.3.10-pre.001` doit commencer par l'audit/sizing et le plan détaillé imposés par ce prompt avant toute implémentation lourde.
+
+## Gate demandé
+
+La tranche est purement mécanique. Aucun nouveau smoke provider, build Tauri ou graphe de dépendances complet n'est nécessaire : aucune dépendance, feature, source runtime ou configuration n'est modifiée par `rel.001`.
+
+```bash
+cargo fmt --all -- --check
+python3 scripts/audit_rust_workspace_rules.py
+python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.9
+cargo check --workspace
+cargo clippy --workspace --all-targets --all-features -- -D warnings
+cargo test -p ksp-worker-api
+cargo tree -p ksp-worker-api --edges normal
+cargo tree -p ksp-worker-api -e features
+```
+
+Après gate propre :
+
+```text
+commit : v0.3.9-rel.001
+tag    : v0.3.9
+```
+
+Aucun tag de prerelease ou `rel.001` n'est requis.