v0.4.7-pre.011

README.md

@@ -1,37 +1,35 @@
 <!-- file: README.md -->
-<!-- version: 15 -->
+<!-- version: 16 -->
 
 # Khadhroony Bot3
 
-`khadhroony-bot3` est le workspace Rust consolidé succédant à `khadhroony-bot2` pour l’acquisition, le stockage, le décodage, la matérialisation, la validation et l’exécution contrôlée d’opérations Solana.
+`khadhroony-bot3` est un workspace Rust 2024 dédié à l’acquisition, au décodage, à la matérialisation et à l’exécution contrôlée de transactions Solana.
 
-## Version fonctionnelle
+## Version en développement
 
-Le workspace est aligné sur le périmètre fonctionnel de `khadhroony-bot2 0.4.6` dans la nouvelle architecture bot3. Les différences de structure sont intentionnelles : les modèles, décodeurs, exécuteurs et matérialisateurs sont consolidés dans `kb-lib`, le stockage dans `kb-store` et les transports RPC dans `kb-onchain-transport`.
+La version active est `0.4.7`, consacrée à l’achèvement de Metaplex Token Metadata.
 
-Exceptions documentées :
+Les contrats de décodage, les comptes, les matérialisations, les 35 opérations officiellement constructibles, l’orchestration généraliste, les scénarios synthétiques et le panneau desktop sont présents. La clôture est repoussée jusqu’à la réalisation des campagnes Devnet des 20 opérations courantes non dépréciées.
 
-- le registre ElGamal est implémenté avec validations synthétiques et garde-fous fail-closed, mais n’est pas déclaré validé réellement sur Devnet ou Mainnet ;
-- Metaplex Token Metadata possède déjà ses décodeurs d’instructions et de comptes ainsi qu’une matérialisation substantielle, mais son exécuteur, son orchestration complète et ses démonstrations appartiennent à `0.4.7` ;
-- les améliorations structurelles de `kb-config`, `kb-logging` et `kb-store` sont reportées à `0.5.x`.
+Le registre ElGamal reste une exception indépendante : il est implémenté et validé synthétiquement, mais n’est pas déclaré validé réellement sur Devnet ou Mainnet.
 
 ## Architecture
 
-Le workspace contient 11 crates :
+Le workspace contient onze crates :
 
 - `kb-core` : erreurs et primitives transversales ;
 - `kb-config` : chargement et validation de la configuration ;
 - `kb-lib` : modèles, décodeurs, exécuteurs et matérialisateurs ;
 - `kb-logging` : logging et tracing ;
-- `kb-program-ids` : registre des programmes et comptes Solana connus ;
-- `kb-pipeline` : backfill, extraction Core, replay et orchestration ;
-- `kb-pipeline-demo-scenarios` : bibliothèque de scénarios et CLI ;
+- `kb-program-ids` : registre canonique des programmes et comptes Solana ;
+- `kb-pipeline` : pipeline généraliste de backfill, extraction, replay et orchestration ;
+- `kb-pipeline-demo-scenarios` : scénarios synthétiques et campagnes Devnet/Testnet automatisables ;
 - `kb-onchain-transport` : transports RPC HTTP et WebSocket ;
 - `kb-store` : contrats de stockage et adaptateur PostgreSQL ;
-- `kb-wallet` : frontière de wallet et signataires, encore incomplète ;
-- `kb-app-demo-desktop` : bibliothèque et application Tauri de démonstration.
+- `kb-wallet` : frontière de wallet et signataires ;
+- `kb-app-demo-desktop` : application Tauri de démonstration, avec scénarios UI conservés dans le desktop.
 
-La vue détaillée est disponible dans :
+Références :
 
 - [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) ;
 - [`docs/architecture/CRATE_MAP.md`](docs/architecture/CRATE_MAP.md) ;
@@ -41,14 +39,16 @@ La vue détaillée est disponible dans :
 
 ## Documentation
 
-L’index actif se trouve dans [`docs/README.md`](docs/README.md).
-
-Les règles normatives commencent dans [`RULES.md`](RULES.md). Les règles spécialisées sont placées sous [`docs/rules/`](docs/rules/).
-
-Les documents historiques de bot2, bobobot et de la migration bot3 sont conservés sous `olddocs/`. Ils servent de sources historiques et ne sont pas normatifs.
+- [`RULES.md`](RULES.md) : index des règles ;
+- [`ROADMAP.md`](ROADMAP.md) : objectifs par version fonctionnelle ;
+- [`CHANGELOG.md`](CHANGELOG.md) : historique des versions fonctionnelles clôturées ;
+- [`docs/README.md`](docs/README.md) : index documentaire ;
+- [`prompts/027_v0_4_7_metaplex_token_metadata_completion.md`](prompts/027_v0_4_7_metaplex_token_metadata_completion.md) : prompt actif de `0.4.7`.
 
 ## Validation générale
 
+La validation finale d’une version utilise :
+
 ```bash
 cargo fmt --all
 cargo check --workspace
@@ -57,7 +57,7 @@ python3 scripts/audit_rust_workspace_rules.py
 cargo test --workspace
 ```
 
-La validation frontend desktop s’effectue uniquement avec :
+Lorsque le desktop est concerné :
 
 ```bash
 cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json