From 1dc57a85c239315e89fad14fab233f275e0e68f6 Mon Sep 17 00:00:00 2001 From: SinuS Von SifriduS Date: Thu, 10 Sep 2026 00:09:44 +0200 Subject: [PATCH] v0.3.12-rel.001 --- Cargo.toml | 4 +- deltas/0.3.12/rel.001.md | 162 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 164 insertions(+), 2 deletions(-) create mode 100644 deltas/0.3.12/rel.001.md diff --git a/Cargo.toml b/Cargo.toml index 1053134..d27481c 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,12 +1,12 @@ # file: Cargo.toml -# version: 538 +# version: 539 [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-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.12-pre.13" +version = "0.3.12" edition = "2024" license = "MIT" repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project" diff --git a/deltas/0.3.12/rel.001.md b/deltas/0.3.12/rel.001.md new file mode 100644 index 0000000..d6ef7d9 --- /dev/null +++ b/deltas/0.3.12/rel.001.md @@ -0,0 +1,162 @@ + + + +# Delta `0.3.12-rel.001` — publication stable + +## Base requise + +Base directe attendue : + +```text +0.3.12-pre.013 +workspace.package.version = 0.3.12-pre.13 +``` + +Le gate opérateur minimal de `pre.013`, exécuté le **9 septembre 2026**, 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 (340 table(s), 824 file(s)) +cargo check --workspace: PASS +``` + +Les couloirs de fermeture antérieurs sont déjà fermés : + +- `pre.011` : gate technique complet avec `cargo test --workspace --all-targets --all-features`, suites ciblées, graphes Cargo Worker normal/features et `cargo tree --duplicates` ; +- smokes live keyless exécutés après `pre.011` : HTTP Solana Devnet PASS et WebSocket Solana Devnet PASS ; +- `pre.012` : réconciliation documentaire finale des surfaces Yellowstone/hydration/frontier/replay et du statut réel des preuves live ; +- `pre.013` : préparation minimale de publication avec `CHANGELOG.md`, `ROADMAP.md` et `prompts/032-V0_3_13_START_PROMPT.md`. + +## Objet + +Publier mécaniquement la version stable : + +```text +0.3.12 +``` + +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 +538 -> 539 +``` + +La version workspace devient : + +```text +0.3.12-pre.13 -> 0.3.12 +``` + +Aucune autre ligne du `Cargo.toml` racine n'est modifiée. + +## Fichiers ajoutés + +```text +deltas/0.3.12/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/032-V0_3_13_START_PROMPT.md +crates/** +docs/** +config/** +``` + +La surface préparée en `pre.013` reste byte-identique hors mécanique Cargo et ajout du présent delta. + +## Surface stable publiée + +`0.3.12` stabilise la première verticale réseau productive de `ksp-worker-raw-transaction-ingest-lib` : + +- source Yellowstone gRPC caller-composed et supervisée via `ksp-onchain-transport-lib` ; +- updates `Transaction`, `TransactionStatus` et transactions de `Block` projetées en signaux source-neutral ; +- coalescence bornée par identité `(network, signature, commitment)` avant hydration ; +- hydration HTTP `getTransaction` observed puis conversion Common RAW via `ksp-raw-transaction-lib` avant admission/persistence Store ; +- `BlockMeta` et `Slot` réservés à la continuité ; +- provenance composite sûre, sans URL, secret ni payload distant ; +- processing frontier strictement run-local, distincte d'une preuve durable de complétude ; +- reconnect/replay, `from_slot` et `SubscribeReplayInfo` conservés sous ownership Transport ; +- distinction explicite entre tentative de replay, reconnexion réussie et gap de rétention prouvé ; +- fault Worker sur gap prouvé, sans lancement automatique de Backfill ni campagne de réparation ; +- hardening des duplicate storms, overflow de compteurs, backpressure, stop/fault races, abort/join des hydrations et absence de tâches/frontier orphelines ; +- canaris cross-layer Transport -> Worker -> Common RAW -> Store, inventaires publics et dependency firewalls fermés ; +- gate workspace complet `--all-targets --all-features` validé ; +- smokes live keyless HTTP Devnet et WebSocket Devnet réellement PASS ; +- smokes Yellowstone token-gated et Worker end-to-end laissés explicitement non exécutés faute de ressources opérateur complètes lors du gate. + +Le Job Backfill historique paramétré et le Worker Ingest continu restent deux producteurs indépendants du même Store. `0.3.12` ne transforme pas le Worker en moteur de campagne historique et ne persiste aucun checkpoint de replay Worker. + +## Suite préparée + +La session suivante part exclusivement de la base stable : + +```text +v0.3.12 +``` + +et exécute : + +```text +prompts/032-V0_3_13_START_PROMPT.md +``` + +pour ouvrir : + +```text +0.3.13 — WS standard / Helius / HTTP live + convergence multi-source +``` + +`0.3.13-pre.001` doit commencer par audit/sizing/planification avant tout développement lourd. Le gap repair/hardening multi-source complet reste réservé à `0.3.14`. + +## Gate demandé + +La tranche est purement mécanique. Aucune dépendance, feature, source runtime, configuration ou documentation durable 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.12 +cargo check --workspace +cargo clippy --workspace --all-targets --all-features -- -D warnings +cargo test -p ksp-worker-raw-transaction-ingest-lib +cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal +cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features +``` + +Après gate propre : + +```text +commit : v0.3.12-rel.001 +tag : v0.3.12 +``` + +Aucun tag de prerelease ou `rel.001` n'est requis.