v0.4.8

2026-08-09 15:22:19 +02:00
parent 3a509acb82
commit 99fdfba767
47 changed files with 807 additions and 158 deletions
--- a/docs/validation/V0_4_8_METADATA_VALIDATION_REPORT.md
+++ b/docs/validation/V0_4_8_METADATA_VALIDATION_REPORT.md
@@ -0,0 +1,117 @@
+<!-- file: docs/validation/V0_4_8_METADATA_VALIDATION_REPORT.md -->
+<!-- version: 3 -->
+
+# Validation fonctionnelle — Metadata on-chain et clôture 0.4.8
+
+## Périmètre
+
+La version `0.4.8` ferme trois domaines Metadata on-chain strictement séparés :
+
+- Solana Program Metadata `ProgM6JCCvbYkfKqJYHePx4xxSUSqJp7rh8Lyv7nk7S` ;
+- Token-2022 Token Metadata via `spl-token-metadata-interface` ;
+- Metaplex Token Metadata `metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`.
+
+Elle couvre les contrats on-chain, décodeurs, matérialisateurs, exécuteurs lorsque applicables, orchestration stateful, scénarios réutilisables et validation desktop.
+
+## Qualification réseau
+
+### Solana Program Metadata
+
+Les neuf opérations stables sont `confirmed` sur Devnet avec simulation, soumission, confirmation, lectures stateful, replay canonique et matérialisation.
+
+### Token-2022 Token Metadata
+
+Les cinq opérations de l’interface sont `confirmed` sur Devnet :
+
+- `Initialize` ;
+- `UpdateField` ;
+- `Emit` ;
+- `RemoveKey` ;
+- `UpdateAuthority`.
+
+### Metaplex Token Metadata
+
+La matrice Devnet courante des vingt opérations est close :
+
+- 15 `confirmed` ;
+- 5 `unavailable` ;
+- 0 `not_run`.
+
+Les cinq opérations indisponibles restent explicitement bornées par les observations runtime documentées pendant `0.4.8-pre.013` ; elles ne sont jamais promues depuis une validation synthétique.
+
+## Desktop Metadata
+
+`kb-app-demo-desktop` sépare les trois domaines Metadata et appelle les scénarios réutilisables de `kb-pipeline-demo-scenarios`.
+
+La validation finale couvre notamment :
+
+- synchronisation du profil Devnet ;
+- campagnes spécialisées Metaplex ;
+- campagne Token-2022 Token Metadata ;
+- campagne Solana Program Metadata ;
+- JsonViewer pour les résultats structurés ;
+- accordéons de préflight, simulation/confirmation et postconditions/preuves ;
+- carte des exigences dans la colonne de résultats ;
+- journal d’exécution sur toute la largeur.
+
+## Conformité finale du workspace
+
+La campagne finale du 9 août 2026 est conforme :
+
+- `cargo fmt --all` réussi ;
+- `cargo check --workspace` réussi ;
+- `cargo clippy --all-targets` réussi sans warning ;
+- `python3 scripts/audit_rust_workspace_rules.py` : audit Rust général propre, export completeness à zéro candidat et audit Khadhroony propre ;
+- `cargo test --workspace` réussi sur toutes les crates, tous les tests d’intégration et toutes les doctests.
+
+Les principales cibles unitaires observées comprennent :
+
+- `kb-app-demo-desktop` : 144 tests ;
+- `kb-config` : 46 tests ;
+- `kb-core` : 2 tests ;
+- `kb-lib` : 706 tests, plus 9 tests d’intégration ;
+- `kb-logging` : 17 tests ;
+- `kb-onchain-transport` : 118 tests ;
+- `kb-pipeline` : 109 tests, plus 3 tests d’intégration Metadata ;
+- `kb-pipeline-demo-scenarios` : 105 tests bibliothèque, 1 test CLI et 1 test API externe ;
+- `kb-program-ids` : 6 tests ;
+- `kb-store` : 84 tests ;
+- `kb-wallet` : 6 tests.
+
+## Build desktop de release
+
+La validation frontend n’est pas exécutée par un `npm run build` autonome.
+
+La commande de release utilisée est :
+
+```bash
+cargo tauri build -c kb-app-demo-desktop/tauri.conf.json
+```
+
+Tauri déclenche le `beforeBuildCommand`, qui exécute TypeScript puis Vite. La configuration validée utilise :
+
+- `root: 'frontend'` et `build.outDir: '../../dist'` côté Vite ;
+- `frontendDist: '../dist'` côté Tauri.
+
+Ces deux chemins convergent vers le même répertoire `dist` à la racine du workspace.
+
+Le build de release a produit avec succès :
+
+- `Khadhroony Bot3 Demo Desktop_0.4.8_amd64.deb` ;
+- `Khadhroony Bot3 Demo Desktop-0.4.8-1.x86_64.rpm` ;
+- `Khadhroony Bot3 Demo Desktop_0.4.8_amd64.AppImage`.
+
+## Limites et reports
+
+- aucun fetch HTTP/IPFS/Arweave n’est intégré au replay canonique ;
+- la couverture généraliste différée — programmes/interfaces SPL non prioritaires, compléments Metaplex et autres Program IDs non bloquants pour la séquence trading prioritaire — est reportée à `0.15.x` ;
+- `kb-offchain-transport` est reportée à `0.16.x+` après repriorisation du ROADMAP ;
+- le registre ElGamal reste sans preuve réseau réelle disponible.
+
+## Traçabilité
+
+Les audits, rapports de prerelease et le plan de travail `0.4.8` sont archivés sous `olddocs/archivekbot3/`. Ils conservent la chronologie détaillée mais ne sont plus normatifs.
+
+## Statut
+
+**Version fonctionnelle `0.4.8` clôturée et validée.**