v0.3.12-pre.008-fix.002

This commit is contained in:
2026-09-09 20:57:54 +02:00
parent 5095be0b0d
commit 223f11b989
4 changed files with 135 additions and 5 deletions

View File

@@ -1,12 +1,12 @@
# file: Cargo.toml # file: Cargo.toml
# version: 531 # version: 532
[workspace] [workspace]
resolver = "3" 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"] 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] [workspace.package]
version = "0.3.12-pre.8.fix.1" version = "0.3.12-pre.8.fix.2"
edition = "2024" edition = "2024"
license = "MIT" license = "MIT"
repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project" repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project"

View File

@@ -1,5 +1,5 @@
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs // file: crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
// version: 16 // version: 17
#![warn(missing_docs)] #![warn(missing_docs)]
#![deny(unreachable_pub)] #![deny(unreachable_pub)]
@@ -16,7 +16,7 @@
//! admission path; BlockMeta/Slot remain continuity-only signals. Hydration is coalesced by network/signature/commitment //! admission path; BlockMeta/Slot remain continuity-only signals. Hydration is coalesced by network/signature/commitment
//! under bounded in-flight and pending budgets. A bounded run-local processing frontier projects hydration pending, //! under bounded in-flight and pending budgets. A bounded run-local processing frontier projects hydration pending,
//! oldest pending slot and highest unblocked actually observed slot. The productive source now also projects safe Transport reconnect/replay state and faults //! oldest pending slot and highest unblocked actually observed slot. The productive source now also projects safe Transport reconnect/replay state and faults
//! conservatively when Transport proves a replay-retention continuity gap; history repair remains outside this crate. //! conservatively when Transport proves a replay-retention continuity gap; history remediation remains outside this crate.
mod admission; mod admission;
mod error; mod error;

View File

@@ -0,0 +1,105 @@
<!-- file: deltas/0.3.12/pre.008-fix.002.md -->
<!-- version: 1 -->
# Delta `0.3.12-pre.008-fix.002` — correction du faux positif `public_api` sur `repair`
## Base requise
```text
0.3.12-pre.008-fix.001
workspace.package.version = 0.3.12-pre.8.fix.1
```
Le gate opérateur valide les audits, `cargo check`, Clippy strict, l'ensemble Transport, 63 tests unitaires Worker, 9 `dependency_boundary` et 15 `hardening`. L'unique échec restant est le canari `v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processing_only`, car la documentation de crate Worker contient encore le token `repair`.
## Objectif
Corriger uniquement ce faux positif documentaire sans modifier ni affaiblir le canari `public_api` de `pre.007`.
## Version
```text
workspace.package.version = 0.3.12-pre.8.fix.2
```
## Modification
Dans `ksp-worker-raw-transaction-ingest-lib/src/lib.rs` :
```text
history repair remains outside this crate
```
devient :
```text
history remediation remains outside this crate
```
Le token `repair` reste interdit par le canari `pre.007` existant. Aucun code productif, contrat, dépendance, type, import ou comportement n'est modifié.
## Fichiers modifiés
```text
Cargo.toml
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
docs/validation/029-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY.md
```
## Fichier ajouté
```text
deltas/0.3.12/pre.008-fix.002.md
```
## Fichiers supprimés
```text
aucun
```
## Invariants préservés
Le correctif ne modifie pas :
```text
Transport reconnect/from_slot/ReplayInfo
projection source-neutral Worker
processing frontier run-local
coalescence/hydration HTTP
admission/persistence
politique proven continuity gap -> source fault
API publique
backfill/repair
```
## Validations exécutées dans l'environnement d'assemblage
```text
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
canari statique exact des tokens interdits dans src/lib.rs
contrôle diff exact contre pre.008-fix.001
reconstruction du delta sur la base pre.008-fix.001
unzip -t de l'archive finale
```
## Validations non exécutées localement
L'environnement d'assemblage ne fournit pas Cargo/rustc/rustfmt. Le gate opérateur doit être rejoué :
```text
cargo fmt --all
cargo check --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test -p ksp-onchain-transport-lib
cargo test -p ksp-worker-raw-transaction-ingest-lib
```
## Décisions
Le canari `pre.007` reste strict et inchangé. La documentation de racine publique évite les tokens réservés aux surfaces explicitement absentes.
## Questions ouvertes
Aucune.

View File

@@ -1,5 +1,5 @@
<!-- file: docs/validation/029-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY.md --> <!-- file: docs/validation/029-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY.md -->
<!-- version: 17 --> <!-- version: 18 -->
# Validation v0.3.12 — Yellowstone + hydration HTTP + continuité de run du Worker RawTransaction # Validation v0.3.12 — Yellowstone + hydration HTTP + continuité de run du Worker RawTransaction
@@ -1680,3 +1680,28 @@ history repair remains outside this crate
Le fix ne modifie ni reconnect/replay, ni `from_slot`, ni `ReplayInfo`, ni la processing frontier, ni l'hydration, ni l'admission/persistence, ni l'API publique. Le fix ne modifie ni reconnect/replay, ni `from_slot`, ni `ReplayInfo`, ni la processing frontier, ni l'hydration, ni l'admission/persistence, ni l'API publique.
## 72. Gate opérateur `pre.008-fix.001` et fix `.002`
Le gate opérateur de `0.3.12-pre.8.fix.1` valide :
```text
audits Rust/Markdown : PASS
cargo check --workspace : PASS
cargo clippy --workspace --all-targets --all-features -- -D warnings : PASS
ksp-onchain-transport-lib : 388 unit tests PASS, 51 public_api PASS, 43 release_completeness PASS
ksp-worker-raw-transaction-ingest-lib : 63 unit tests PASS, 9 dependency_boundary PASS, 15 hardening PASS
```
L'unique échec restant est `v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processing_only` dans `public_api`. Le canari `pre.007` interdit volontairement les tokens `ReplayInfo`, `from_slot`, `repair` et `backfill` dans la racine publique Worker. Après le fix `.001`, le seul token `repair` restant dans `src/lib.rs` est encore documentaire :
```text
history repair remains outside this crate
```
Aucune API, dépendance ou logique de repair/backfill n'est exposée. Le fix `.002` conserve donc le canari `public_api` inchangé et reformule uniquement cette documentation en :
```text
history remediation remains outside this crate
```
Le correctif ne modifie aucun comportement reconnect/replay, aucune ownership de `from_slot`/`ReplayInfo`, aucune processing frontier, hydration, admission, persistence ou API publique.