v0.1.0-pre.055

KHADHROONY_BOT3_MIGRATION_CLOSURE_TODO.md

@@ -0,0 +1,561 @@
+# Khadhroony Bot3 — Checklist de clôture de la migration
+
+> **Périmètre :** clôturer la migration de `khadhroony-bot2` vers `khadhroony-bot3`, stabiliser `kb-app-demo-desktop` et valider l’intégration des crates consolidées.
+>
+> **Base de suivi :** `0.1.0-pre.055` et correctifs suivants.
+>
+> **Règle d’utilisation :** cocher chaque case uniquement après validation locale explicite. Les sous-cases constituent les critères d’acceptation de la tâche parente.
+
+---
+
+## 0. État validé à ce jour
+
+- [x] Les fenêtres historiques principales ont été portées dans `kb-app-demo-desktop`.
+- [x] Les décodeurs, modèles, matérialiseurs et exécuteurs sont consommés depuis `kb-lib`.
+- [x] `kb-store-core` et `kb-store-pg` ont été fusionnés dans `kb-store`.
+- [x] `kb-program-ids` est une dépendance explicite du desktop.
+- [x] `kb-pipeline-demo-scenarios` est une dépendance explicite du desktop.
+- [x] Le pool WebSocket n’est plus initialisé au démarrage de l’application.
+- [x] Le pool WebSocket est créé paresseusement à l’ouverture/utilisation de `demo_ws`.
+- [x] La session WebSocket survit à la fermeture de la fenêtre `demo_ws`.
+- [x] La réouverture de `demo_ws` récupère l’état de la session existante.
+- [x] La clé `HELIUS_API_KEY` chargée depuis `.env` permet une connexion Helius réelle.
+- [x] Les fenêtres dynamiques sont déclarées dans `vite.config.ts` et `capabilities/default.json`, sans être ajoutées à `tauri.conf.json`.
+- [x] La permission de logging est attribuée aux fenêtres dynamiques.
+- [x] Les balises HTML mal imbriquées qui rechargeaient `main.html` ont été corrigées.
+- [x] Les routes de fichiers de logs consolidées produisent une arborescence cohérente.
+- [x] L’audit Rust global est propre sur la base testée :
+  - `General Rust rule audit: clean`
+  - `Rust export completeness audit: 0 candidate(s)`
+  - `Khadhroony workspace rule audit: clean`
+
+---
+
+## 1. Corriger immédiatement les deux afficheurs non JSON
+
+### 1.1 Fenêtre HTTP JSON-RPC
+
+- [ ] Remplacer le `@andypf/json-viewer` du bloc **Résultat** par un `<textarea readonly>`.
+- [ ] Conserver le résultat RPC sous sa forme textuelle exacte, sans supposer qu’il s’agit toujours de JSON.
+- [ ] Ajouter exactement un bouton **Copier** utilisant le presse-papiers.
+- [ ] Ajouter exactement un bouton **Effacer**.
+- [ ] S’assurer que l’effacement vide également le buffer TypeScript interne.
+- [ ] Donner au textarea une hauteur fixe et un scroll interne.
+- [ ] Tester successivement :
+  - réponse JSON structurée ;
+  - valeur scalaire ;
+  - chaîne simple ;
+  - erreur RPC ;
+  - résultat vide.
+
+### 1.2 Fenêtre WebSocket
+
+- [ ] Remplacer le `@andypf/json-viewer` du bloc **Messages** par un `<textarea readonly>`.
+- [ ] Conserver les messages sous forme de journal texte append-only.
+- [ ] Ajouter exactement un bouton **Copier**.
+- [ ] Ajouter exactement un bouton **Effacer**.
+- [ ] S’assurer que l’effacement vide le buffer en mémoire et le contenu visible.
+- [ ] Donner au textarea une hauteur fixe et un scroll interne.
+- [ ] Vérifier que la réouverture de la fenêtre restaure :
+  - l’état de connexion ;
+  - les abonnements actifs ;
+  - le statut de session ;
+  - le journal conservé, si cette conservation est voulue.
+
+---
+
+## 2. Audit global des composants Copier / Effacer
+
+- [ ] Rechercher tous les boutons statiques et boutons injectés dynamiquement :
+
+```bash
+find kb-app-demo-desktop/frontend \
+  -type f \( -name '*.html' -o -name '*.ts' \) -print0 |
+xargs -0 grep -nE 'Copier|Effacer|clipboard|app-log-clear|attach.*controls'
+```
+
+- [ ] Pour chaque bloc de journal ou résultat textuel, garantir **une seule** paire Copier/Effacer.
+- [ ] Interdire la coexistence de boutons HTML statiques et de boutons ajoutés par `frontend_log.ts` sur le même composant.
+- [ ] Vérifier au minimum :
+  - `demo_backfill` ;
+  - `demo_core_extraction` ;
+  - `demo_http` ;
+  - `demo_ws` ;
+  - `demo_decode_replay` ;
+  - `demo_execution_solana_core` ;
+  - `demo_execution_spl` ;
+  - fenêtres SQL ;
+  - configuration.
+- [ ] Ajouter un test frontend ou une vérification statique qui échoue lorsqu’un conteneur reçoit plusieurs groupes de contrôles.
+
+---
+
+## 3. Uniformiser la position des journaux généraux
+
+- [x] Le journal du Backfill HTTP est placé hors de l’accordéon.
+- [x] Le journal d’Extraction core est placé hors de l’accordéon.
+- [ ] Vérifier que tous les journaux généraux restent visibles lorsque les sections de paramètres sont repliées.
+- [ ] Déplacer hors des accordéons tout journal général encore imbriqué dans une section de paramètres.
+- [ ] Conserver dans les accordéons uniquement les sorties strictement liées à une opération ou à un sous-panneau particulier.
+- [ ] Documenter une règle UI :
+  - paramètres et formulaires dans les accordéons ;
+  - journal global et résultat principal sous l’accordéon ;
+  - hauteur fixe avec scroll ;
+  - une seule paire Copier/Effacer.
+
+---
+
+## 4. Politique JSON commune
+
+- [ ] Utiliser `@andypf/json-viewer` uniquement lorsque la valeur affichée est garantie comme JSON.
+- [ ] Utiliser un textarea readonly pour :
+  - journaux ;
+  - flux de messages ;
+  - texte brut ;
+  - réponses dont le format varie ;
+  - erreurs non structurées.
+- [ ] Centraliser la création et la mise à jour des viewers JSON dans un helper TypeScript commun.
+- [ ] Appliquer une hauteur fixe à tous les viewers JSON.
+- [ ] Appliquer un scroll interne au-delà de la hauteur maximale.
+- [ ] Éviter qu’un collapse contenant du JSON agrandisse indéfiniment `.card-body`.
+- [ ] Vérifier tous les viewers présents dans :
+  - Configuration ;
+  - SQL diagnostics ;
+  - Decode replay ;
+  - exécutions ;
+  - autres vues structurées.
+- [ ] Prévoir une règle pour les valeurs JSON invalides : fallback texte, sans crash de la fenêtre.
+
+---
+
+## 5. Stabiliser les fenêtres SQL
+
+### 5.1 Layout
+
+- [ ] Restaurer une disposition pleine largeur pour :
+  - SQL diagnostics ;
+  - PostgreSQL raw ;
+  - PostgreSQL core.
+- [ ] Ne pas splitter les tableaux principaux en deux colonnes.
+- [ ] Réserver les colonnes uniquement aux petits panneaux synthétiques si nécessaire.
+- [ ] Supprimer le scroll horizontal global de la page.
+- [ ] Autoriser un scroll horizontal local uniquement dans `.table-responsive` lorsque réellement nécessaire.
+- [ ] Vérifier que le listing des tables utilise toute la largeur disponible.
+- [ ] Comparer le rendu avec Bot2 pour éviter une régression fonctionnelle ou ergonomique.
+
+### 5.2 Navigation et IPC
+
+- [x] Les balises de navbar mal fermées ont été corrigées.
+- [ ] Vérifier chaque bouton et chaque onglet des quatre fenêtres SQL.
+- [ ] Confirmer qu’aucune action ne recharge `main.html`.
+- [ ] Confirmer qu’aucun clic ne déclenche une navigation implicite via un `<a>` parent.
+- [ ] Vérifier les formulaires et boutons sans `type="button"` susceptibles de soumettre un formulaire.
+- [ ] Revalider les appels IPC lors de rechargements Vite, sans considérer l’ancien défaut comme actif s’il n’est plus reproductible.
+
+### 5.3 Initialisation PostgreSQL
+
+- [ ] Décider définitivement quand exécuter `initialize_postgres_schema_for_startup` :
+  - au démarrage avec compte rendu dans le splash ; ou
+  - à la première ouverture d’une fenêtre SQL.
+- [ ] Supprimer le code mort si l’initialisation de démarrage est abandonnée.
+- [ ] Sinon, brancher réellement :
+  - `initialize_postgres_schema_for_startup` ;
+  - `emit_sql_startup_table_report` ;
+  - `emit_sql_startup_error` ;
+  - `emit_sql_startup_splash`.
+- [ ] Ne pas conserver durablement des helpers publics ou `pub(crate)` inutilisés.
+- [ ] Ajouter des tests de schéma présent, incomplet et inaccessible.
+
+---
+
+## 6. Corriger les échecs Metaplex Token Metadata
+
+### 6.1 Constat issu des logs `pre.055`
+
+- [x] Le pipeline sélectionne correctement le décodeur `metadata_metaplex_token_metadata`.
+- [x] Le programme canonique est reconnu :
+
+```text
+metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s
+```
+
+- [x] L’archive analysée contient **10 échecs** explicites de validation de comptes :
+  - **8** `create_metadata_account_v3 account 1 has invalid signer/writable flags` ;
+  - **2** `transfer account 1 has invalid signer/writable flags`.
+
+### 6.2 Diagnostic à effectuer
+
+- [ ] Extraire pour chaque transaction échouée :
+  - signature ;
+  - slot ;
+  - chemin d’instruction ;
+  - instruction outer/inner ;
+  - données brutes ;
+  - liste ordonnée des comptes ;
+  - flags signer/writable réellement reconstruits.
+- [ ] Vérifier si `account 1` désigne :
+  - l’index dans les comptes de l’instruction ;
+  - l’index global du message ;
+  - un index décalé par le program ID ;
+  - un compte issu d’une Address Lookup Table.
+- [ ] Vérifier la reconstruction des flags pour :
+  - comptes statiques ;
+  - comptes chargés par ALT ;
+  - instructions internes ;
+  - comptes dupliqués ;
+  - invocation CPI.
+- [ ] Comparer les contrats du décodeur avec :
+  - l’IDL officiel `token_metadata.json` ;
+  - les builders/generated instructions Metaplex ;
+  - des transactions mainnet réelles.
+- [ ] Vérifier si les contraintes imposées sont trop strictes pour les CPI, notamment lorsqu’un programme appelant transmet un compte avec des privilèges supérieurs ou différents.
+- [ ] Distinguer clairement :
+  - compte absent ;
+  - nombre de comptes invalide ;
+  - signer manquant ;
+  - writable manquant ;
+  - privilège supplémentaire acceptable ;
+  - privilège incompatible.
+
+### 6.3 Correctif et tests
+
+- [ ] Corriger la matrice de comptes de `create_metadata_account_v3`.
+- [ ] Corriger la matrice de comptes de `transfer`.
+- [ ] Ajouter les transactions réelles de l’archive comme fixtures bornées ou vecteurs synthétiques équivalents.
+- [ ] Ajouter un test de CPI pour chaque instruction concernée.
+- [ ] Ajouter un test avec Address Lookup Table si applicable.
+- [ ] Ajouter un test où un compte possède un privilège supérieur acceptable.
+- [ ] Ajouter un test qui refuse réellement un signer/writable manquant.
+- [ ] Rejouer les signatures échouées avec `forceReplay=true`.
+- [ ] Obtenir `failed=0` pour les cas désormais supportés.
+- [ ] Classer en `Unsupported` plutôt qu’en `Failed` toute variante volontairement hors périmètre mais valide sur chaîne.
+- [ ] Vérifier la matérialisation après correction du décodage.
+
+### 6.4 Observabilité du décodeur
+
+- [ ] Enrichir le diagnostic avec :
+  - nom du rôle attendu ;
+  - index du compte ;
+  - pubkey ;
+  - flags attendus ;
+  - flags observés ;
+  - contexte outer/inner.
+- [ ] Afficher ces diagnostics dans la fenêtre Decode replay.
+- [ ] Ajouter un bouton Copier pour les diagnostics détaillés.
+- [ ] Ne pas exposer de données sensibles dans les logs.
+
+---
+
+## 7. IDL Metaplex Token Metadata
+
+- [ ] Placer le snapshot officiel dans le workspace :
+
+```text
+idls/metaplex_token_metadata.metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s.json
+```
+
+- [ ] Conserver le fichier source/provenance associé.
+- [ ] Documenter :
+  - URL officielle ;
+  - commit ou SHA du blob ;
+  - version IDL `1.14.0` ;
+  - program ID canonique.
+- [ ] Ajouter un script de rafraîchissement déterministe.
+- [ ] Ajouter un test vérifiant que l’IDL est du JSON valide.
+- [ ] Ajouter un test comparant les discriminants couverts par le décodeur avec l’IDL.
+- [ ] Ne pas utiliser l’IDL comme seule source normative lorsque le programme ou les generated builders divergent.
+
+---
+
+## 8. Configuration `.env` et ordre de résolution
+
+### 8.1 `kb-config`
+
+- [x] `dotenvy` appartient à `kb-config`, pas au desktop.
+- [ ] Vérifier l’API publique finale et ses noms.
+- [ ] Appliquer et tester l’ordre :
+  1. environnement déjà présent dans le processus ;
+  2. fichier explicitement indiqué par `KB_ENV_FILE` ;
+  3. `.env` à la racine du workspace ;
+  4. fallback `${VAR:-fallback}` ;
+  5. variable non résolue conservée ou erreur selon le contrat du champ.
+- [ ] Garantir qu’un `.env` ne remplace jamais une variable déjà injectée par le shell, systemd, Docker, CI ou IDE.
+- [ ] Définir le comportement si `KB_ENV_FILE` pointe vers un fichier absent.
+- [ ] Définir le comportement si `.env` est absent.
+- [ ] Définir le comportement des lignes invalides.
+- [ ] Interdire l’impression de valeurs secrètes dans les diagnostics.
+- [ ] Ajouter des tests isolés et sérialisés pour éviter les collisions d’environnement global entre tests.
+
+### 8.2 `kb-app-demo-desktop`
+
+- [ ] Retirer toute lecture ou tout chargement `.env` résiduel du desktop.
+- [ ] Ne conserver que l’appel à l’API de chargement de `kb-config`.
+- [ ] Afficher dans la fenêtre Configuration la provenance des sources sans afficher les secrets :
+  - environnement processus ;
+  - fichier `.env` chargé ;
+  - fallback ;
+  - non résolu.
+- [ ] Vérifier que l’application démarre sans clé Helius.
+- [ ] Vérifier que l’utilisation d’un endpoint Helius sans clé produit une erreur ciblée.
+- [x] Vérifier qu’une clé valide dans `.env` permet HTTP et WebSocket Helius.
+
+### 8.3 `kb-pipeline-demo-scenarios`
+
+- [ ] Ne pas dépendre directement de `dotenvy`.
+- [ ] Centraliser l’initialisation par `kb-config` lorsque les scénarios sont lancés directement.
+- [ ] Réduire progressivement les appels directs `std::env::var`.
+- [ ] Introduire des structures typées pour :
+  - SPL Token classique ;
+  - ATA ;
+  - Token-2022 ;
+  - ElGamal Registry ;
+  - scénarios Solana Core.
+- [ ] Permettre l’injection des valeurs dans les tests sans modifier l’environnement global.
+- [ ] Vérifier que les variables externes historiques `TOKEN_2022_*` peuvent rester nommées ainsi, tout en utilisant `token2022` dans les modules Rust internes.
+
+### 8.4 Tâche ultérieure `kb-store`
+
+- [ ] **À reporter :** décider si les chemins/URLs de base sont entièrement résolus par `kb-config` avant construction de `kb-store`.
+- [ ] Ne pas faire charger `.env` directement par `kb-store`.
+- [ ] Prévoir une configuration typée déjà résolue pour PostgreSQL et les futures bases.
+- [ ] Étudier la séparation future des targets de logs `kb-store.core` et `kb-store.postgres`.
+
+---
+
+## 9. Cycle de vie WebSocket
+
+- [x] Aucun pool WebSocket au démarrage général.
+- [x] Création paresseuse lors du premier accès.
+- [x] Pool conservé dans `AppState`.
+- [x] Fermeture de `demo_ws` sans fermeture de la session.
+- [x] Récupération du statut à la réouverture.
+- [ ] Utiliser `disconnect_demo_ws_app_state` lors de la fermeture globale de l’application.
+- [ ] Ne pas l’appeler lors de la simple destruction de `demo_ws`.
+- [ ] Tester la fermeture explicite depuis la fenêtre.
+- [ ] Tester le timeout de session.
+- [ ] Tester la fermeture de l’application avec session et abonnements actifs.
+- [ ] Vérifier qu’aucune tâche Tokio ni relay ne reste suspendu après arrêt.
+- [ ] Éliminer le warning `dead_code` de façon fonctionnelle, sans supprimer le hook requis.
+
+---
+
+## 10. Menu principal et cohérence visuelle
+
+- [ ] Réordonner définitivement le dropdown des fenêtres selon les groupes suivants :
+  1. Configuration ;
+  2. Transport : HTTP, WebSocket, Backfill ;
+  3. Pipeline : Extraction core, Decode replay ;
+  4. SQL : diagnostics, raw, core, replay ;
+  5. Exécution : Solana Core, SPL.
+- [ ] Ajouter des séparateurs ou titres de groupes non cliquables.
+- [ ] Vérifier que chaque fenêtre possède le logo non cliquable.
+- [ ] Vérifier particulièrement `demo_execution_solana_core`.
+- [ ] Garder les descriptions longues dans le contenu principal et non dans la navbar.
+- [ ] Vérifier les deux textes :
+  - « System Program uniquement — simulation-first et replay post-exécution » ;
+  - « Memo, SPL Token classique, Token-2022 et ATA — simulation-first et replay post-exécution ».
+- [ ] Uniformiser titres, sous-titres, marges et hauteurs de navbar.
+
+---
+
+## 11. Vérifier les options de la fenêtre Exécution SPL
+
+- [ ] Auditer toutes les valeurs de `demo_execution_spl.html`.
+- [ ] Vérifier leur correspondance exacte avec les parsers et enums Rust.
+- [ ] Remplacer les valeurs internes historiques `token_2022` par `token2022` lorsqu’elles ne constituent pas un contrat externe.
+- [ ] Conserver uniquement les variables d’environnement externes `TOKEN_2022_*` si elles sont déjà documentées et utilisées.
+- [ ] Vérifier chaque scénario :
+  - Memo v4 ;
+  - SPL Token classique ;
+  - Token-2022 ;
+  - ATA.
+- [ ] Vérifier que Memo v1 et v3 restent non exécutables.
+- [ ] Vérifier les scénarios publics Token-2022 réellement supportés par l’exécuteur.
+- [ ] Retirer ou désactiver toute option UI sans implémentation réelle.
+- [ ] Ajouter un test qui compare la liste HTML/TypeScript avec l’inventaire Rust exposé.
+
+---
+
+## 12. Façades consolidées et nomenclature
+
+- [ ] Exécuter une recherche uniquement sur les fichiers Rust :
+
+```bash
+find kb-app-demo-desktop -type f -name '*.rs' -print0 |
+xargs -0 grep -nE 'kb_store_pg|kb_store_core|kb_model|kb_decoder_|kb_materializer_|kb_executor_|token_2022|_2022'
+```
+
+- [ ] Aucun ancien crate Bot2 ne doit subsister.
+- [ ] Tous les modèles, décodeurs, matérialiseurs et exécuteurs doivent passer par `kb-lib`.
+- [ ] Tout le stockage doit passer par `kb-store`.
+- [ ] Les modules Rust internes utilisent `token2022`, jamais `token_2022`.
+- [ ] Les constantes utilisent `SPL_TOKEN2022_*` selon la nomenclature de `kb-program-ids`.
+- [ ] Les variables d’environnement externes `TOKEN_2022_*` peuvent rester.
+- [ ] Vérifier tous les `export_to` uniquement dans les `.rs` :
+
+```bash
+find kb-config kb-lib kb-app-demo-desktop \
+  -type f -name '*.rs' -print0 |
+xargs -0 grep -n 'export_to'
+```
+
+- [ ] Corriger les chemins TS-RS résiduels qui imitent des anciens noms de crates.
+- [ ] Supprimer les fichiers de bindings orphelins générés par les anciens chemins.
+
+---
+
+## 13. Logging
+
+- [x] La sortie console compacte est de nouveau active.
+- [x] Les routes consolidées produisent une arborescence cohérente.
+- [ ] Vérifier la console pour chaque profil configuré.
+- [ ] Vérifier qu’aucune route n’utilise un ancien target Bot2.
+- [ ] Vérifier l’absence de dossiers vides créés pour des targets inexistants.
+- [ ] Ajouter un test de complétude des routes par rapport aux targets publics actuels.
+- [ ] Vérifier la cohérence tiret/underscore entre target et répertoire.
+- [ ] Décider ultérieurement si `kb-store` doit produire :
+  - `kb-store/core` ;
+  - `kb-store/postgres`.
+- [ ] Ne pas traiter cette séparation comme bloquante pour la clôture de la migration.
+
+---
+
+## 14. Nettoyage des warnings Rust
+
+- [ ] Résoudre le warning `DemoDecodeReplayProgressPayload` inutilisé par un usage réel ou un ajustement de visibilité justifié.
+- [ ] Résoudre le warning `initialize_postgres_schema_for_startup` inutilisé après décision sur l’initialisation SQL.
+- [ ] Résoudre le warning `disconnect_demo_ws_app_state` inutilisé en le branchant sur l’arrêt global.
+- [ ] Résoudre les helpers SQL privés inutilisés en les utilisant ou en les supprimant si le flux est abandonné.
+- [ ] Ne pas supprimer une fonction prévue uniquement pour faire taire un warning sans décision architecturale.
+- [ ] Obtenir `cargo test -p kb-app-demo-desktop` sans warning propre au code applicatif.
+
+---
+
+## 15. Clippy et macros Tauri
+
+- [ ] Traiter en dernier les erreurs `clippy::question_mark_used` provenant des expansions `#[tauri::command]` async.
+- [ ] Confirmer qu’aucun `?` interdit n’existe dans le code source métier.
+- [ ] Choisir une solution localisée et documentée :
+  - allowance au niveau du module adaptateur Tauri ; ou
+  - configuration ciblée pour le code généré ; ou
+  - exception d’audit explicite pour les macros externes.
+- [ ] Ne pas rendre les commandes synchrones uniquement pour satisfaire Clippy.
+- [ ] Ne pas désactiver le lint à l’échelle du workspace.
+- [ ] Ajouter une note dans `RUST_RULES.md` expliquant l’exception du code généré Tauri.
+- [ ] Obtenir finalement :
+
+```bash
+cargo clippy --all-targets
+```
+
+sans erreur.
+
+---
+
+## 16. Validation fonctionnelle de chaque fenêtre
+
+- [ ] Splash : affiche uniquement les composants réellement initialisés au démarrage, puis est détruit.
+- [ ] Main : menu ordonné, tous les liens fonctionnels.
+- [ ] Configuration : viewers JSON bornés, provenance de configuration lisible, secrets masqués.
+- [ ] HTTP : méthodes, paramètres, résultat texte, Copier/Effacer.
+- [ ] WebSocket : connexion, abonnements multiples, restauration, messages texte, déconnexion.
+- [ ] Backfill : anciens/nouveaux historiques, annulation, journal permanent, résultat.
+- [ ] SQL diagnostics : pleine largeur, refresh, erreurs.
+- [ ] SQL raw : pleine largeur, tables et compteurs.
+- [ ] SQL core : pleine largeur, tables et compteurs.
+- [ ] SQL replay : filtres, DataTables, CSV, onglets.
+- [ ] Extraction core : campagne, annulation, journal permanent.
+- [ ] Decode replay : 7 décodeurs, matérialiseurs, diagnostics, annotations.
+- [ ] Exécution Solana Core : simulation, envoi contrôlé, replay post-exécution.
+- [ ] Exécution SPL : Memo v4, Token, Token-2022, ATA.
+- [ ] Fermeture et réouverture répétées de toutes les fenêtres dynamiques.
+- [ ] Vérification qu’aucune fenêtre dynamique ne démarre automatiquement.
+
+---
+
+## 17. Tests de scénarios hors Tauri
+
+- [ ] Déplacer ou dupliquer les scénarios métier importants dans `kb-pipeline-demo-scenarios`.
+- [ ] Couvrir Solana Core.
+- [ ] Couvrir Memo v4.
+- [ ] Couvrir SPL Token classique.
+- [ ] Couvrir ATA.
+- [ ] Couvrir Token-2022.
+- [ ] Couvrir ElGamal Registry lorsque validable.
+- [ ] Couvrir Metaplex Token Metadata.
+- [ ] Tester sans démarrer Tauri.
+- [ ] Tester avec configurations injectées plutôt qu’avec environnement global lorsque possible.
+
+---
+
+## 18. Sécurité des secrets et fichiers locaux
+
+- [ ] Vérifier que `.env` est ignoré par Git.
+- [ ] Conserver `.env.example` versionné sans secret.
+- [ ] Vérifier l’historique Git pour s’assurer qu’aucune clé Helius réelle n’a été ajoutée.
+- [ ] Masquer les valeurs sensibles dans les logs et dans la fenêtre Configuration.
+- [ ] Ne jamais inclure `.env` dans les archives delta.
+- [ ] Ajouter une validation de démarrage qui signale la présence/absence d’une clé sans l’afficher.
+
+---
+
+## 19. Validation technique finale
+
+- [ ] `cargo fmt --all`
+- [ ] `cargo check -p kb-config`
+- [ ] `cargo test -p kb-config`
+- [ ] `cargo check -p kb-pipeline-demo-scenarios`
+- [ ] `cargo test -p kb-pipeline-demo-scenarios`
+- [ ] `cargo check -p kb-app-demo-desktop`
+- [ ] `cargo test -p kb-app-demo-desktop`
+- [ ] `cargo check --workspace`
+- [ ] `cargo test --workspace`
+- [ ] `python3 scripts/audit_rust_workspace_rules.py`
+- [ ] `cargo clippy --all-targets` après traitement de l’exception Tauri.
+- [ ] `cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json`
+- [ ] Vérification manuelle de toutes les fenêtres.
+- [ ] Vérification réelle HTTP Helius.
+- [ ] Vérification réelle WebSocket Helius.
+- [ ] Rejeu Metaplex avec `failed=0` sur les cas corrigés.
+
+---
+
+## 20. Documentation et clôture
+
+- [ ] Mettre à jour `README.md` avec l’architecture Bot3 finale.
+- [ ] Mettre à jour `ROADMAP.md` avec les points réellement clôturés et les reports.
+- [ ] Mettre à jour `CHANGELOG.md` avec toutes les prereleases et fixes.
+- [ ] Documenter la politique `.env` et l’ordre de résolution.
+- [ ] Documenter le cycle de vie HTTP/WebSocket.
+- [ ] Documenter les fenêtres dynamiques, Vite et capabilities.
+- [ ] Documenter les conventions de viewers JSON et de journaux texte.
+- [ ] Documenter l’IDL Metaplex et sa provenance.
+- [ ] Documenter les tâches reportées :
+  - résolution de configuration de base dans `kb-store` ;
+  - séparation des logs `kb-store.core` / `kb-store.postgres` ;
+  - améliorations non bloquantes.
+- [ ] Préparer le prompt complet de la session suivante.
+- [ ] Livrer le dernier delta de migration.
+- [ ] Effectuer le commit Git de clôture.
+- [ ] Taguer la prerelease ou version de clôture selon la convention retenue.
+
+---
+
+## 21. Critères de clôture obligatoires
+
+La migration ne peut être déclarée terminée que lorsque toutes les conditions suivantes sont satisfaites :
+
+- [ ] Toutes les fenêtres historiques requises sont présentes et fonctionnelles.
+- [ ] Aucun ancien crate Bot2 n’est référencé.
+- [ ] Aucune erreur de compilation ou de test.
+- [ ] Audits Rust et workspace propres.
+- [ ] Aucun warning applicatif non justifié.
+- [ ] `.env` est centralisé dans `kb-config` et sa priorité est testée.
+- [ ] HTTP et WebSocket Helius fonctionnent avec une clé locale non versionnée.
+- [ ] Les erreurs Metaplex observées sont corrigées ou classées explicitement et correctement.
+- [ ] Les fenêtres SQL n’ont ni navigation involontaire ni layout régressif.
+- [ ] Chaque journal/résultat texte possède une seule paire Copier/Effacer.
+- [ ] Les viewers JSON sont bornés en hauteur et réservés au JSON réel.
+- [ ] Le cycle de vie WebSocket est validé jusqu’à l’arrêt global.
+- [ ] La documentation de clôture et le prompt suivant sont livrés.
+