v0.3.15-rel.001
This commit is contained in:
@@ -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"
|
||||
|
||||
187
deltas/0.3.15/rel.001.md
Normal file
187
deltas/0.3.15/rel.001.md
Normal file
@@ -0,0 +1,187 @@
|
||||
<!-- file: deltas/0.3.15/rel.001.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# 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.
|
||||
Reference in New Issue
Block a user