v0.1.0-pre.056

KHADHROONY_BOT3_MIGRATION_CLOSURE_TODO.md

@@ -1,561 +1,337 @@
-# 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.
-
+<!-- file: KHADHROONY_BOT3_MIGRATION_CLOSURE_TODO.md -->
+<!-- version: 3 -->
+
+# Checklist détaillée de clôture de la migration `khadhroony-bot3`
+
+## Base et principe de validation
+
+- Base de travail : `khadhroony-bot3_v0.1.0-pre.055-full.zip`.
+- Références fonctionnelles : Bot2 `v0.4.6` puis Bot2 `v0.4.7-pre.035-tofix07`.
+- Prompt actif : `prompts/KHADHROONY_BOT3_MIGRATION_CONTINUATION_PROMPT_REORDERED.md`.
+- Une case n’est cochée qu’après preuve explicite : audit, compilation, test, requête SQL, contrôle runtime ou comparaison documentée.
+- L’ordre est obligatoire : règles, contrôles rapides, retour au niveau `0.4.6`, Metaplex `0.4.7`, Clippy/Tauri, documentation, versionnement.
+
+## 0. Revalidation des règles et des archives
+
+- [x] Inventorier l’archive Bot3 `pre.055`.
+- [x] Inventorier l’archive Bot2 `0.4.6` issue de Git.
+- [x] Inventorier l’archive Bot2 `0.4.7-pre.035-tofix07`.
+- [x] Vérifier la présence de l’IDL Metaplex local dans Bot3.
+- [x] Constater que Bot3 utilisait encore `RULES.md` et `RUST_RULES.md`.
+- [x] Créer `RULES_GENERAL.md`.
+- [x] Créer `RULES_RUST.md`.
+- [x] Créer `RULES_SPECIFIC_KHADHROONY.md`.
+- [x] Transformer `RULES.md` en index normatif.
+- [x] Corriger `docs/DELTA_WORKFLOW.md` pour Bot3, `-delta`, `delta-fix-XXX`, exclusion de `Cargo.lock` et absence de SHA256.
+- [x] Adapter le script d’audit aux nouveaux fichiers de règles.
+- [ ] Relire intégralement les quatre fichiers de règles après application du delta.
+- [ ] Comparer ligne par ligne les règles Bot2 encore applicables avec les règles Bot3.
+- [ ] Documenter chaque règle Bot2 écartée et sa justification.
+- [ ] Vérifier l’absence de contradiction sur les imports, réexports, façades, Tauri, TS-RS, logging, versionnement et archives.
+- [ ] Exécuter `cargo fmt --all`.
+- [ ] Exécuter `python3 scripts/audit_rust_workspace_rules.py`.
+
+## 0.1 Classification des matrices de contrat
+
+- [x] Inventorier les fichiers JSON machine auparavant placés sous `docs/`.
+- [x] Créer `test-fixtures/contract-matrices/` pour les matrices de contrat partagées.
+- [x] Déplacer les dix matrices JSON hors de `docs/`.
+- [x] Mettre à jour les dix-sept fichiers Rust contenant les `include_str!` concernés.
+- [x] Conserver le déplacement et les mises à jour de chemins dans une même livraison atomique.
+- [x] Lister chaque ancien fichier avec une commande `rm --` dans `delta.md`.
+- [ ] Exécuter les tests des crates consommatrices dans le workspace réel.
+- [ ] Vérifier qu’aucune référence résiduelle ne pointe vers les anciens chemins `docs/*.json`.
+
+## 1. Contrôles rapides avant code fonctionnel
+
+### 1.1 TS-RS
+
+- [ ] Rechercher `export_to` uniquement dans les fichiers `.rs` de `kb-config`, `kb-lib` et `kb-app-demo-desktop`.
+- [ ] Vérifier les sorties `kb_config`.
+- [ ] Vérifier les sorties `kb_lib`.
+- [ ] Vérifier les sorties `kb_app_demo_desktop`.
+- [ ] Supprimer les chemins historiques `kb_executor_*`.
+- [ ] Supprimer les chemins historiques `kb_decoder_*`.
+- [ ] Supprimer les chemins historiques `kb_materializer_*`.
+- [ ] Supprimer les chemins historiques `kb_model`.
+- [ ] Supprimer les chemins historiques `kb_store_pg` et `kb_store_core`.
+- [ ] Régénérer les bindings via les tests TS-RS.
+- [ ] Vérifier que les fichiers générés correspondent exactement aux chemins déclarés.
+
+### 1.2 Anciens chemins et nomenclature
+
+- [ ] Auditer `kb-app-demo-desktop/**/*.rs` pour les anciens noms Bot2.
+- [ ] Auditer tout le workspace pour `token_2022` interne.
+- [ ] Justifier séparément chaque contrat externe `TOKEN_2022_*` conservé.
+- [ ] Vérifier que `kb-lib` et `kb-store` sont les seules façades consolidées concernées.
+- [ ] Vérifier qu’aucune ancienne crate n’a été recréée.
+
+### 1.3 Frontend et menu
+
+- [ ] Auditer les occurrences `Copier` et `Effacer` dans tous les HTML et TypeScript.
+- [ ] Garantir une seule paire de contrôles par sortie.
+- [ ] Vérifier l’ordre du menu : Configuration, Transport et collecte, Pipeline, SQL, Exécution.
+- [ ] Vérifier les séparateurs.
+- [ ] Supprimer les entrées mortes.
+- [ ] Identifier les fenêtres migrées mais non reliées.
+
+## 2. Corrections UI rapides
+
+### 2.1 HTTP JSON-RPC
+
+- [ ] Remplacer le viewer JSON du résultat par un `textarea readonly`.
+- [ ] Fixer la hauteur.
+- [ ] Activer le scroll interne.
+- [ ] Garantir exactement un bouton Copier.
+- [ ] Garantir exactement un bouton Effacer.
+- [ ] Vider le buffer TypeScript lors de l’effacement.
+- [ ] Tester JSON, scalaire, texte, erreur et résultat vide.
+
+### 2.2 WebSocket
+
+- [ ] Afficher les messages dans un composant texte/log.
+- [ ] Fixer la hauteur et le scroll interne.
+- [ ] Garantir une seule paire Copier/Effacer.
+- [ ] Conserver les messages pendant la session active.
+- [ ] Restaurer l’affichage après fermeture/réouverture de la fenêtre.
+
+### 2.3 Journaux généraux et viewers
+
+- [ ] Vérifier Backfill HTTP.
+- [ ] Vérifier Extraction core.
+- [ ] Vérifier Exécution Solana Core.
+- [ ] Vérifier Exécution SPL.
+- [ ] Vérifier Decode replay.
+- [ ] Vérifier HTTP.
+- [ ] Vérifier WebSocket.
+- [ ] Placer les paramètres dans les accordéons.
+- [ ] Placer les journaux et résultats globaux sous les accordéons.
+- [ ] Réserver le viewer JSON au JSON structuré.
+- [ ] Utiliser des textareas pour texte brut, logs et diagnostics concaténés.
+- [ ] Fixer la hauteur de tous les viewers JSON.
+
+### 2.4 Fenêtres SQL
+
+- [ ] Mettre toutes les fenêtres SQL, sauf Replay Candidates, sur une seule colonne pleine largeur.
+- [ ] Mettre les tables sur toute la largeur.
+- [ ] Limiter le scroll horizontal au wrapper de table.
+- [ ] Vérifier toutes les balises HTML.
+- [ ] Vérifier boutons, onglets et liens.
+
+## 3. Configuration et environnement
+
+- [ ] Confirmer que seul `kb-config` charge `.env`.
+- [ ] Confirmer la priorité environnement du processus.
+- [ ] Confirmer `KB_ENV_FILE`.
+- [ ] Confirmer le `.env` racine par défaut.
+- [ ] Confirmer `${VAR}`.
+- [ ] Confirmer `${VAR:-fallback}`.
+- [ ] Confirmer l’absence non fatale pour les services optionnels.
+- [ ] Vérifier que les diagnostics ne révèlent aucun secret.
+- [ ] Vérifier que `kb-pipeline-demo-scenarios` ne dépend pas directement de `dotenvy`.
+- [ ] Valider réellement `HELIUS_API_KEY` depuis `.env`.
+- [ ] Garder la résolution de chemin de base `kb-store` dans le backlog documenté.
+
+## 4. Logging
+
+- [ ] Maintenir la console active pour `local_devnet`.
+- [ ] Maintenir la console active pour `mainnet_research`.
+- [ ] Maintenir la console active pour `mainnet`.
+- [ ] Supprimer les routes Bot2 obsolètes.
+- [ ] Vérifier les cibles `kb-lib.decoder.*`.
+- [ ] Vérifier les cibles `kb-lib.executor.*`.
+- [ ] Vérifier les cibles `kb-lib.materializer.*`.
+- [ ] Vérifier `kb-store`, `kb-config`, `kb-logging`, `kb-onchain-transport`, `kb-pipeline`, `kb-wallet` et `kb-app-demo-desktop`.
+- [ ] Vérifier qu’aucun ancien répertoire de logs de crate supprimée n’est recréé.
+
+## 5. Options SPL et Token-2022
+
+- [ ] Comparer chaque option de `demo_execution_spl.html` aux scénarios réellement supportés.
+- [ ] Comparer les options aux branches de `tauri.rs`.
+- [ ] Supprimer les options mortes.
+- [ ] Remplacer les valeurs internes `token_2022` par `token2022`.
+- [ ] Inventorier chaque variable `TOKEN_2022_*`.
+- [ ] Marquer les variables conservées pour compatibilité externe.
+- [ ] Marquer les variables limitées aux scénarios de démonstration.
+- [ ] Documenter les futurs remplacements par configuration ou structure typée.
+
+## 6. Cycle de vie WebSocket
+
+- [ ] Vérifier qu’aucun pool WebSocket n’est créé au démarrage.
+- [ ] Vérifier la création paresseuse au premier accès.
+- [ ] Vérifier le stockage du pool dans `AppState`.
+- [ ] Vérifier la survie de la session après fermeture de `demo_ws`.
+- [ ] Vérifier la récupération de l’état à la réouverture.
+- [ ] Vérifier la fermeture explicite.
+- [ ] Vérifier le timeout.
+- [ ] Vérifier l’arrêt global de l’application.
+- [ ] Vérifier que la fermeture de la fenêtre n’appelle jamais la déconnexion globale.
+
+## 7. Initialisation PostgreSQL et splash
+
+- [ ] Charger l’environnement.
+- [ ] Charger et valider la configuration.
+- [ ] Initialiser le logging.
+- [ ] Initialiser le pool HTTP.
+- [ ] Se connecter à PostgreSQL.
+- [ ] Appeler `initialize_postgres_schema_for_startup`.
+- [ ] Appeler `emit_sql_startup_table_report`.
+- [ ] Relier `emit_sql_startup_error`.
+- [ ] Relier `emit_sql_startup_splash`.
+- [ ] Ouvrir `main` seulement après le rapport PostgreSQL.
+- [ ] Fermer le splash après le statut final.
+- [ ] Ne pas initialiser WebSocket dans cette séquence.
+- [ ] Rendre la zone de messages du splash scrollable.
+- [ ] Garder le dernier message visible.
+- [ ] Afficher connexion, schéma, nombre de tables, tables manquantes et statut final.
+
+## 8. Purge contrôlée des données dérivées
+
+- [ ] Inventorier les tables via `kb-store`.
+- [ ] Classer chaque table en raw, nécessaire au replay, dérivée ou ambiguë.
+- [ ] Bloquer la purge tant qu’une table reste ambiguë.
+- [ ] Créer un script SQL versionné et idempotent.
+- [ ] Conserver transactions, signatures et payloads RPC raw.
+- [ ] Conserver toutes les données nécessaires à l’extraction et au replay.
+- [ ] Purger core dérivé, décodage, observations, coverage, diagnostics et états de replay dérivés.
+- [ ] Purger annotations, événements matérialisés, token accounts, lifecycle, admin, fees, risk, compliance et staking dérivés.
+- [ ] Exécuter la purge dans une transaction.
+- [ ] Ajouter des vérifications avant/après.
+- [ ] Documenter précisément les tables conservées.
+- [ ] Relancer l’extraction core.
+- [ ] Relancer tous les décodeurs.
+- [ ] Relancer la matérialisation.
+- [ ] Valider les compteurs et erreurs.
+- [ ] Contrôler la reconstruction de chaque projection attendue.
+
+## 9. Jalon fonctionnel Bot2 `0.4.6`
+
+- [ ] Solana Core équivalent et validé.
+- [ ] SPL Memo équivalent et validé.
+- [ ] SPL Token classique équivalent et validé.
+- [ ] SPL ATA équivalent et validé.
+- [ ] SPL Token-2022 équivalent et validé.
+- [ ] ElGamal Registry équivalent et validé.
+- [ ] Backfill équivalent et validé.
+- [ ] Extraction core équivalente et validée.
+- [ ] Replay équivalent et validé.
+- [ ] Matérialisation équivalente et validée.
+- [ ] Exécution supportée équivalente et validée.
+- [ ] Scénarios devnet historiques validés.
+- [ ] HTTP et WebSocket validés.
+- [ ] PostgreSQL validé.
+- [ ] Logging validé.
+- [ ] Configuration validée.
+- [ ] Produire un rapport explicite de parité `0.4.6` avant toute clôture Metaplex.
+
+## 10. Inventaire IDL
+
+- [ ] Créer `docs/IDL_SOURCES.md`.
+- [ ] Inventorier chaque IDL local.
+- [ ] Indiquer protocole et program ID.
+- [ ] Indiquer source officielle.
+- [ ] Indiquer version ou commit lorsqu’ils sont connus.
+- [ ] Indiquer chemin local, statut et usage.
+- [ ] Documenter les notes de compatibilité.
+- [ ] Ne pas inventer d’IDL absent.
+- [ ] Référencer l’IDL Metaplex existant sans le retélécharger.
+
+## 11. Metaplex Token Metadata — décodeur
+
+- [ ] Extraire toutes les erreurs Metaplex réelles.
+- [ ] Regrouper par instruction et type d’échec.
+- [ ] Isoler `create_metadata_account_v3`.
+- [ ] Isoler `transfer`.
+- [ ] Comparer runtime, IDL local, builders et interface officielle.
+- [ ] Corriger signer et writable flags.
+- [ ] Gérer comptes optionnels et variantes legacy.
+- [ ] Distinguer transactions échouées, payloads tronqués et variantes inconnues.
+- [ ] Ajouter des fixtures issues de transactions réelles.
+- [ ] Relancer le replay complet Metaplex.
+- [ ] Obtenir zéro faux échec de metas.
+
+## 12. Metaplex Token Metadata — exécuteur et devnet
+
+- [ ] Compléter les intents typés.
+- [ ] Compléter les builders.
+- [ ] Valider l’ordre des comptes.
+- [ ] Valider signers et writable flags.
+- [ ] Borner explicitement les variantes supportées.
+- [ ] Ajouter les politiques de sécurité.
+- [ ] Imposer simulation-first.
+- [ ] Ajouter l’estimation des coûts.
+- [ ] Ajouter la validation post-exécution.
+- [ ] Ajouter les tests unitaires.
+- [ ] Comparer aux builders officiels.
+- [ ] Compléter la matrice de couverture.
+- [ ] Ajouter des scénarios devnet explicites.
+- [ ] Interdire l’exécution par défaut sur mainnet.
+- [ ] Afficher plan, signers, simulation et résultat.
+- [ ] Effectuer un replay post-exécution.
+- [ ] Vérifier décodage et matérialisation.
+- [ ] Afficher les diagnostics.
+
+## 13. Clippy et Tauri
+
+- [ ] Traiter Clippy seulement après le fonctionnel Metaplex.
+- [ ] Identifier précisément les expansions de macros Tauri concernées par `question_mark_used`.
+- [ ] Éviter un `allow` global.
+- [ ] Documenter toute exception locale et sa portée.
+- [ ] Obtenir un Clippy propre ou un écart borné et reproductible.
+
+## 14. Documentation finale et versionnement
+
+- [ ] Rendre les README génériques et indépendants de la migration.
+- [ ] Retirer les numéros de version des README.
+- [ ] Retirer le récit Bot2 vers Bot3 des README actifs.
+- [ ] Créer `USAGES.md` pour chaque crate publique.
+- [ ] Documenter API, types, traits, fonctions, builders, exemples, invariants, erreurs, limites et intégrations.
+- [ ] Ajouter des roadmaps par crate uniquement lorsqu’elles apportent une valeur réelle.
+- [ ] Conserver au plus une courte note historique.
+- [ ] Ne passer à `0.4.7` qu’après parité `0.4.6`, Metaplex complet, replay validé et documentation terminée.
+- [ ] Mettre à jour `CHANGELOG.md` uniquement lors de cette validation explicite.
+
+## 15. Validation 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-store`.
+- [ ] `cargo test -p kb-store`.
+- [ ] `cargo check -p kb-lib`.
+- [ ] `cargo test -p kb-lib`.
+- [ ] `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 tauri dev -c kb-app-demo-desktop/tauri.conf.json`.
+- [ ] `cargo clippy --all-targets` en dernier.
+
+## 16. Critères de clôture
+
+- [ ] Toutes les crates compilent.
+- [ ] Tous les tests workspace passent.
+- [ ] Audit Rust propre.
+- [ ] Audit TS-RS propre.
+- [ ] Aucun chemin Bot2 supprimé encore actif.
+- [ ] Toutes les fenêtres fonctionnent.
+- [ ] WebSocket persistant validé.
+- [ ] `.env` et Helius validés.
+- [ ] PostgreSQL et splash validés.
+- [ ] Données dérivées purgées et reconstruites.
+- [ ] Niveau `0.4.6` restauré.
+- [ ] UI JSON/texte cohérente.
+- [ ] Aucun contrôle Copier/Effacer dupliqué.
+- [ ] Journaux hors accordéon.
+- [ ] Fenêtres SQL dimensionnées.
+- [ ] Routes de logs obsolètes supprimées.
+- [ ] Console active.
+- [ ] Inventaire IDL terminé.
+- [ ] Zéro faux échec Metaplex de metas.
+- [ ] Exécuteur et démos Metaplex validés.
+- [ ] Clippy/Tauri finalisés.
+- [ ] Documentation et `USAGES.md` terminés.
+- [ ] Passage à `0.4.7` justifié.