diff --git a/Cargo.toml b/Cargo.toml index cc3d97f..4b6a7b5 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,12 +1,12 @@ # file: Cargo.toml -# version: 448 +# version: 449 [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-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib"] [workspace.package] -version = "0.3.8-pre.3" +version = "0.3.8-pre.3.fix.1" edition = "2024" license = "MIT" repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project" diff --git a/crates/ksp-store-lib/tests/hardening_completeness.rs b/crates/ksp-store-lib/tests/hardening_completeness.rs index f409720..458884a 100644 --- a/crates/ksp-store-lib/tests/hardening_completeness.rs +++ b/crates/ksp-store-lib/tests/hardening_completeness.rs @@ -1,5 +1,5 @@ // file: crates/ksp-store-lib/tests/hardening_completeness.rs -// version: 6 +// version: 7 #![warn(missing_docs)] #![deny(unreachable_pub)] @@ -158,9 +158,12 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() { "RawAccountObservationRead", "RawAccountObservationWrite", "RawAccountState", + "RawAccountStateInspectionQuery", + "RawAccountStateInspectionRead", "RawAccountStateQuery", "RawAccountStateRead", "RawAccountStateReference", + "RawAccountStateSummary", "RawAccountStateWrite", "RawAcquisitionOrigin", "RawAcquisitionProvenance", @@ -168,6 +171,8 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() { "RawContentHash", "RawEntityWriteOutcome", "RawFormatId", + "RawInspectionPage", + "RawInspectionPageRequest", "RawNetworkId", "RawObservationKey", "RawObservationWriteOutcome", @@ -184,6 +189,8 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() { "RawTimestamp", "RawTransaction", "RawTransactionAcquisitionMode", + "RawTransactionInspectionQuery", + "RawTransactionInspectionRead", "RawTransactionObservation", "RawTransactionObservationRead", "RawTransactionObservationWrite", @@ -194,6 +201,7 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() { "RawTransactionRetentionTransition", "RawTransactionRetentionWrite", "RawTransactionSignature", + "RawTransactionSummary", "RawTransactionTombstone", "RawTransactionWrite", "Result", @@ -208,7 +216,7 @@ fn pre_009_facade_modules_and_crate_root_exports_are_exact() { ]; expected.sort_unstable(); assert_eq!(actual.as_slice(), expected.as_slice()); - assert_eq!(actual.len(), 91); + assert_eq!(actual.len(), 99); return; } diff --git a/deltas/0.3.8/pre.003-fix.001.md b/deltas/0.3.8/pre.003-fix.001.md new file mode 100644 index 0000000..7703e06 --- /dev/null +++ b/deltas/0.3.8/pre.003-fix.001.md @@ -0,0 +1,129 @@ + + + +# 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. diff --git a/docs/validation/025-V0_3_8_STORE_DESK.md b/docs/validation/025-V0_3_8_STORE_DESK.md index 41cf770..2999c45 100644 --- a/docs/validation/025-V0_3_8_STORE_DESK.md +++ b/docs/validation/025-V0_3_8_STORE_DESK.md @@ -1,5 +1,5 @@ - + # 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] 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`. +