v0.3.8-pre.003-fix.001

This commit is contained in:
2026-09-03 11:45:43 +02:00
parent 9300dccbe2
commit 009b957523
4 changed files with 181 additions and 5 deletions

View File

@@ -1,12 +1,12 @@
# file: Cargo.toml # file: Cargo.toml
# version: 448 # version: 449
[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-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-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-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib"]
[workspace.package] [workspace.package]
version = "0.3.8-pre.3" version = "0.3.8-pre.3.fix.1"
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-store-lib/tests/hardening_completeness.rs // file: crates/ksp-store-lib/tests/hardening_completeness.rs
// version: 6 // version: 7
#![warn(missing_docs)] #![warn(missing_docs)]
#![deny(unreachable_pub)] #![deny(unreachable_pub)]
@@ -158,9 +158,12 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() {
"RawAccountObservationRead", "RawAccountObservationRead",
"RawAccountObservationWrite", "RawAccountObservationWrite",
"RawAccountState", "RawAccountState",
"RawAccountStateInspectionQuery",
"RawAccountStateInspectionRead",
"RawAccountStateQuery", "RawAccountStateQuery",
"RawAccountStateRead", "RawAccountStateRead",
"RawAccountStateReference", "RawAccountStateReference",
"RawAccountStateSummary",
"RawAccountStateWrite", "RawAccountStateWrite",
"RawAcquisitionOrigin", "RawAcquisitionOrigin",
"RawAcquisitionProvenance", "RawAcquisitionProvenance",
@@ -168,6 +171,8 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() {
"RawContentHash", "RawContentHash",
"RawEntityWriteOutcome", "RawEntityWriteOutcome",
"RawFormatId", "RawFormatId",
"RawInspectionPage",
"RawInspectionPageRequest",
"RawNetworkId", "RawNetworkId",
"RawObservationKey", "RawObservationKey",
"RawObservationWriteOutcome", "RawObservationWriteOutcome",
@@ -184,6 +189,8 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() {
"RawTimestamp", "RawTimestamp",
"RawTransaction", "RawTransaction",
"RawTransactionAcquisitionMode", "RawTransactionAcquisitionMode",
"RawTransactionInspectionQuery",
"RawTransactionInspectionRead",
"RawTransactionObservation", "RawTransactionObservation",
"RawTransactionObservationRead", "RawTransactionObservationRead",
"RawTransactionObservationWrite", "RawTransactionObservationWrite",
@@ -194,6 +201,7 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() {
"RawTransactionRetentionTransition", "RawTransactionRetentionTransition",
"RawTransactionRetentionWrite", "RawTransactionRetentionWrite",
"RawTransactionSignature", "RawTransactionSignature",
"RawTransactionSummary",
"RawTransactionTombstone", "RawTransactionTombstone",
"RawTransactionWrite", "RawTransactionWrite",
"Result", "Result",
@@ -208,7 +216,7 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() {
]; ];
expected.sort_unstable(); expected.sort_unstable();
assert_eq!(actual.as_slice(), expected.as_slice()); assert_eq!(actual.as_slice(), expected.as_slice());
assert_eq!(actual.len(), 91); assert_eq!(actual.len(), 99);
return; return;
} }

View File

@@ -0,0 +1,129 @@
<!-- file: deltas/0.3.8/pre.003-fix.001.md -->
<!-- version: 1 -->
# Delta `0.3.8-pre.003-fix.001` — réconciliation du canari d'exports Store facade
## Base requise
Base directe attendue :
```text
0.3.8-pre.003
workspace.package.version = 0.3.8-pre.3
```
La livraison est :
```text
0.3.8-pre.003-fix.001
workspace.package.version = 0.3.8-pre.3.fix.1
commit = v0.3.8-pre.003-fix.001
tag = aucun
```
Le fix modifie un test Rust ; la version Cargo est donc synchronisée conformément à `VER-ID-007` et `VER-ID-010`.
## Objectif
Corriger le seul échec révélé par le gate opérateur de `pre.003`, sans modifier les contrats ou le runtime de la prerelease.
Le test historique :
```text
crates/ksp-store-lib/tests/hardening_completeness.rs
pre_009_facade_modules_and_crate_root_exports_are_exact
```
attendait encore l'inventaire exact de la façade antérieur aux réexports d'inspection de `pre.003`.
## Diagnostic
Le gate opérateur est vert pour les audits, `cargo check --workspace`, `cargo clippy --workspace --all-targets`, `ksp-store-api`, le mode `--no-default-features` de `ksp-store-lib` et `ksp-app-store-desk`.
`cargo test -p ksp-store-lib` échoue uniquement parce que la liste attendue ne contient pas les huit nouveaux réexports publics intentionnels :
```text
RawAccountStateInspectionQuery
RawAccountStateInspectionRead
RawAccountStateSummary
RawInspectionPage
RawInspectionPageRequest
RawTransactionInspectionQuery
RawTransactionInspectionRead
RawTransactionSummary
```
La surface réelle observée est donc correcte ; le canari exact est obsolète.
## Correction
Le tableau attendu du test est complété avec ces huit symboles et son cardinal exact passe :
```text
91 -> 99
```
Aucun fichier de production `ksp-store-api`, `ksp-store-lib`, `ksp-store-postgres-lib` ou `ksp-app-store-desk` n'est modifié.
## Invariants préservés
```text
contrats d'inspection pre.003 inchangés
RawPage cursor/keyset inchangé
aucune implémentation PostgreSQL d'inspection
aucun SQL ni migration
aucun changement DataTables/pagination
Store Desk supertrace inchangé
tracing frontend interactions inchangé
```
## Fichiers ajoutés
```text
deltas/0.3.8/pre.003-fix.001.md
```
## Fichiers modifiés
```text
Cargo.toml
crates/ksp-store-lib/tests/hardening_completeness.rs
docs/validation/025-V0_3_8_STORE_DESK.md
```
## Fichiers supprimés
```text
aucun
```
## 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
```
Un contrôle statique vérifie également que la liste attendue du canari contient exactement les huit nouveaux exports d'inspection et que le cardinal annoncé est `99`.
## Validations non exécutées dans l'environnement d'assemblage
`cargo` n'est pas disponible dans l'environnement d'assemblage. Le gate opérateur à rejouer est :
```bash
cargo fmt --all
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
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-store-api
cargo test -p ksp-store-lib
cargo check -p ksp-store-lib --no-default-features
cargo test -p ksp-app-store-desk
```
`pre.004` ne doit commencer qu'après fermeture de ce gate.
## Questions ouvertes
Aucune pour ce correctif.

View File

@@ -1,5 +1,5 @@
<!-- file: docs/validation/025-V0_3_8_STORE_DESK.md --> <!-- file: docs/validation/025-V0_3_8_STORE_DESK.md -->
<!-- version: 4 --> <!-- version: 5 -->
# Validation v0.3.8 — Store Desk V1 RAW # Validation v0.3.8 — Store Desk V1 RAW
@@ -256,3 +256,42 @@ Détail Store Desk communiqué : 12 tests unitaires, 2 dependency-boundary, 6 de
- [X] tracing frontend couvre boutons, navigation, tabs, changements de contrôles, Refresh et IPC ; - [X] tracing frontend couvre boutons, navigation, tabs, changements de contrôles, Refresh et IPC ;
- [X] les futurs événements DataTables page/length/query doivent être instrumentés lors de `pre.007`/`pre.008` sans logguer les valeurs de filtres ni payloads. - [X] les futurs événements DataTables page/length/query doivent être instrumentés lors de `pre.007`/`pre.008` sans logguer les valeurs de filtres ni payloads.
## 16. Gate opérateur `pre.003` et ouverture de `pre.003-fix.001`
Le gate opérateur de `pre.003` confirme :
```text
General Rust rule audit: clean
Rust export completeness audit: 0 candidate(s)
KSP workspace Rust rule audit: clean
Markdown table audit: clean (314 table(s), 694 file(s))
cargo check --workspace: PASS
cargo clippy --workspace --all-targets: PASS
cargo test -p ksp-store-api: PASS
cargo test -p ksp-app-store-desk: PASS
cargo check -p ksp-store-lib --no-default-features: PASS
```
`cargo test -p ksp-store-lib` échoue sur un seul canari historique :
```text
pre_009_facade_modules_and_crate_root_exports_are_exact
```
Le diagnostic est un inventaire attendu devenu obsolète après les réexports publics intentionnels de `pre.003`. La surface réelle contient bien les huit nouveaux symboles backend-neutral prévus :
```text
RawAccountStateInspectionQuery
RawAccountStateInspectionRead
RawAccountStateSummary
RawInspectionPage
RawInspectionPageRequest
RawTransactionInspectionQuery
RawTransactionInspectionRead
RawTransactionSummary
```
Le correctif `pre.003-fix.001` met uniquement à jour ce canari exact de `91` à `99` exports. Aucun contrat, comportement runtime, backend PostgreSQL, SQL, migration, pagination ou code Store Desk n'est modifié.
La case `pre.003` reste ouverte jusqu'au rejeu vert du gate opérateur sur `0.3.8-pre.3.fix.1`.