From c9047af62643183feceb1349d5dbdbf9135b66ad Mon Sep 17 00:00:00 2001 From: SinuS Von SifriduS Date: Sat, 5 Sep 2026 20:47:42 +0200 Subject: [PATCH] v0.3.9-rel.001 --- Cargo.toml | 4 +- deltas/0.3.9/rel.001.md | 172 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 174 insertions(+), 2 deletions(-) create mode 100644 deltas/0.3.9/rel.001.md diff --git a/Cargo.toml b/Cargo.toml index a4e087c..253f014 100644 --- a/Cargo.toml +++ b/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" diff --git a/deltas/0.3.9/rel.001.md b/deltas/0.3.9/rel.001.md new file mode 100644 index 0000000..bee02dd --- /dev/null +++ b/deltas/0.3.9/rel.001.md @@ -0,0 +1,172 @@ + + + +# 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.