From 7328be6997399c513306f2f4c8cdf00bd8b22367 Mon Sep 17 00:00:00 2001 From: SinuS Von SifriduS Date: Sat, 19 Sep 2026 12:40:28 +0200 Subject: [PATCH] v0.3.15-rel.001 --- Cargo.toml | 4 +- deltas/0.3.15/rel.001.md | 187 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 189 insertions(+), 2 deletions(-) create mode 100644 deltas/0.3.15/rel.001.md diff --git a/Cargo.toml b/Cargo.toml index 8028bdd..301fa9c 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,12 +1,12 @@ # file: Cargo.toml -# version: 636 +# version: 637 [workspace] resolver = "3" members = ["crates/ksp-app-backfill-desk", "crates/ksp-app-config-desk", "crates/ksp-app-raw-transaction-ingest-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-raw-transaction-lib", "crates/ksp-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib", "crates/ksp-worker-api", "crates/ksp-worker-raw-transaction-ingest-lib"] [workspace.package] -version = "0.3.15-pre.18" +version = "0.3.15" edition = "2024" license = "MIT" repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project" diff --git a/deltas/0.3.15/rel.001.md b/deltas/0.3.15/rel.001.md new file mode 100644 index 0000000..23fcf56 --- /dev/null +++ b/deltas/0.3.15/rel.001.md @@ -0,0 +1,187 @@ + + + +# Delta `0.3.15-rel.001` — publication stable + +## Base requise + +Base directe attendue : + +```text +0.3.15-pre.018 +workspace.package.version = 0.3.15-pre.18 +``` + +Le gate opérateur de `pre.018`, exécuté le **19 septembre 2026 à 08:37–08:38**, est propre : + +```text +cargo fmt --all -- --check : PASS +General Rust rule audit : clean +Rust export completeness audit : 0 candidate(s) +KSP workspace Rust rule audit : clean +Markdown table audit : clean (318 table(s), 232 file(s)) +cargo check --workspace : PASS +``` + +Les couloirs de fermeture précédents sont fermés : + +- `pre.015` puis `pre.015-fix.001` : correction du backpressure Yellowstone soutenu et du shutdown post-half-close ; +- `pre.016` : gate technique/live final, suites ciblées/workspace, graphes Cargo et build Tauri ; +- `pre.017` : réconciliation documentaire finale des surfaces `0.3.15` ; +- `pre.018` : préparation minimale de publication avec `CHANGELOG.md`, `ROADMAP.md` et `prompts/035-V0_3_16_START_PROMPT.md`. + +## Objet + +Publier mécaniquement la version stable : + +```text +0.3.15 +``` + +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 +636 -> 637 +``` + +La version workspace devient : + +```text +0.3.15-pre.18 -> 0.3.15 +``` + +Aucune autre ligne du `Cargo.toml` racine n'est modifiée. + +## Fichiers ajoutés + +```text +deltas/0.3.15/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/035-V0_3_16_START_PROMPT.md +crates/** +docs/** +config/** +``` + +La surface préparée en `pre.018` reste byte-identique hors mécanique Cargo et ajout du présent delta. + +## Surface stable publiée + +`0.3.15` stabilise l'application de supervision multi-route `ksp-app-raw-transaction-ingest-desk` et les adaptations nécessaires de la chaîne RAW live : + +- cinq familles de routes live : Yellowstone + HTTP hydration, Standard Logs + HTTP hydration, Standard Block direct lorsque la capability WS Block existe, Helius Transaction + HTTP hydration et HTTP Block Polling ; +- sélection et supervision de plusieurs routes indépendantes d'un même réseau, chacune portée par sa propre instance Worker et partageant le même Store RAW ; +- reconstruction des routes à partir des capabilities réellement composables depuis Config, sans transformer une capability provider en réseau logique distinct ; +- Yellowstone Mainnet utilisant le flux gRPC comme trigger de blocs puis HTTP `getBlock` pour l'hydration, sans hydration `getTransaction` par transaction ; +- coordination Yellowstone bornée et concurrente avant HTTP, puis backpressure gRPC asynchrone bornée au lieu d'un `grpc_backpressure_overflow` local lorsque l'aval est momentanément plus lent ; +- fermeture Yellowstone coopérative : un status distant reçu après half-close local explicite ne transforme plus le Stop utilisateur en faute, tandis qu'un status reçu pendant une session active reste une erreur réelle ; +- convergence Store durcie : un entrant dont `logMessages` contient une troncature explicitement prouvée et compatible avec un canonique déjà plus complet est accepté comme observation sans remplacer le canonique ni arrêter le Worker ; +- diagnostic cross-provider sûr des conflits de contenu et de l'identité de bloc, sans exposition de signatures, blockhashes, payloads ou lignes de logs arbitraires ; +- supervision Desk avec Start/Stop ciblés, latest-value monitoring, états/health, gaps et compteurs source-neutral, tout en conservant les ressources physiques côté backend ; +- maintien des frontières Worker/Transport/Store/Config et de l'indépendance entre Worker live et Job Backfill historique. + +Le gate technique final de `pre.016` a validé les suites ciblées Store, Transport, Worker et Desk, puis `cargo test --workspace --all-targets --all-features`, les graphes Cargo demandés et `cargo tauri build` de `ksp-app-raw-transaction-ingest-desk`. Le build Tauri a produit les bundles Linux `.deb`, `.rpm` et `.AppImage`. + +Le live Mainnet de fermeture a fait tourner Yellowstone et HTTP Block Polling en parallèle environ dix-neuf minutes sans `grpc_backpressure_overflow` ni terminal `Faulted`; les deux routes ont ensuite terminé `Stopped/Healthy` lors des Stops opérateur. + +La compatibilité `logMessages` reste volontairement asymétrique en `0.3.15` : canonique complet + entrant tronqué compatible est accepté, mais canonique tronqué + entrant complet n'effectue pas encore de promotion durable. Variantes conflictuelles, promotion/résolution réversible, retry Store et politique configurable de reconnexion Transport sont réservés à `0.3.16`. + +## Suite préparée + +La session suivante part exclusivement de la base stable : + +```text +v0.3.15 +``` + +et exécute : + +```text +prompts/035-V0_3_16_START_PROMPT.md +``` + +pour ouvrir : + +```text +0.3.16 — RAW resilience / conflict management +``` + +Le cadrage préparé réserve notamment : + +- variantes RAW durables et historique de résolution ; +- comparaison `Exact`, `CompatibleLessComplete`, `CompatibleMoreComplete`, `Conflict` ; +- promotions canoniques monotones, atomiques et réversibles ; +- quarantaine durable des conflits non résolus sans arrêt du Worker pour une divergence locale conservable ; +- retry/backpressure Store sans perte silencieuse ; +- reconnexion Transport configurable et bornée ; +- nouvelles vues `ksp-app-store-desk` pour conflits ouverts, historique, promotion, restauration et fusion assistée ; +- audit préalable des sémantiques Solana avant toute généralisation de la notion de complétude à d'autres champs que le cas déjà prouvé de `logMessages`. + +`0.3.17` reste réservé à la mise en multi-route/multi-stratégie de `ksp-job-backfill-lib`, puis `0.3.18` à l'adaptation correspondante de `ksp-app-backfill-desk`. + +## Validations d'assemblage + +Sur l'état candidat `rel.001`, avant packaging : + +```text +General Rust rule audit : clean +Rust export completeness audit : 0 candidate(s) +KSP workspace Rust rule audit : clean +Markdown table audit : clean (318 table(s), 233 file(s)) +``` + +Les contrôles d'archive et la comparaison byte-exact sont exécutés après packaging avant livraison. + +Aucun PASS Cargo post-bump stable n'est revendiqué localement faute de toolchain dans l'environnement d'assemblage. + +## Gate demandé après application + +La tranche est purement mécanique. Après application sur un `pre.018` dont le gate préalable est vert : + +```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.15 +cargo check --workspace +cargo clippy --workspace --all-targets --all-features -- -D warnings +cargo test -p ksp-onchain-transport-lib --all-targets --all-features +cargo test -p ksp-worker-raw-transaction-ingest-lib --all-targets --all-features +cargo test -p ksp-app-raw-transaction-ingest-desk --all-targets --all-features +``` + +Après gate propre : + +```text +commit : v0.3.15-rel.001 +tag : v0.3.15 +``` + +Aucun tag de prerelease ou `rel.001` n'est requis.