<!-- file: ROADMAP.md -->
<!-- version: 22 -->

# ROADMAP — khadhroony-bot3

Le roadmap décrit les objectifs fonctionnels par version mineure. Il ne contient ni prereleases, ni correctifs `fix`, ni journal détaillé des travaux terminés. Les détails opérationnels appartiennent aux `TODO.md` et `CHANGELOG.md` des crates.

## 0.4.6 — alignement fonctionnel et clôture de la migration principale

### Objectifs

- formaliser l’équivalence largement atteinte avec khadhroony-bot2 `0.4.6` ;
- documenter précisément les écarts résiduels ;
- valider les renommages, consolidations et nouvelles frontières de crates ;
- fermer la migration structurelle principale ;
- décider du réalignement officiel du versionnement et du premier numéro fonctionnel publié après la transition `0.1.0-mig-from-kbot2`.

### Lots

- refonte de la documentation générale et des règles ;
- reconstruction des changelogs et du roadmap ;
- documentation complète des 11 crates ;
- reconstruction des prompts bot3 ;
- audit ciblé `docs/V0_4_6_ALIGNMENT_AUDIT.md` ;
- traitement ou documentation explicite des exceptions restantes.

### Critères de sortie

- chaque crate possède `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md` ;
- les versions, noms de crates et binaires sont cohérents ;
- les tests et validations déjà réalisés sont synthétisés sans nouvel audit complet des protocoles ;
- le statut de `kb-wallet`, `kb-config`, `kb-pipeline-demo-scenarios`, ElGamal et des transports est explicite ;
- l’audit conclut `READY_FOR_0_4_6` ou `READY_WITH_DOCUMENTED_EXCEPTIONS` ;
- le changelog général n’ajoute l’entrée de réalignement qu’au dernier prerelease ou correctif précédant le commit de la version fonctionnelle retenue.

## 0.4.7 — Metaplex Token Metadata complet et clôture de 0.4.x

### Positionnement de version

- le premier numéro fonctionnel après la migration pourra être `0.4.6+` ou une étape préparatoire de la famille `0.4.7`, selon la conclusion de l’audit d’alignement ;
- l’entrée générale correspondante ne sera ajoutée au changelog qu’au moment de finaliser cette version ;
- la version finale `0.4.7` doit inclure la surface Metaplex Token Metadata complète, et non le seul décodeur déjà migré.

### Objectifs

- terminer Metaplex Token Metadata commencé dans bot2 et dont le décodeur a déjà été migré dans bot3 ;
- vérifier et compléter décodeurs de comptes et instructions ;
- ajouter les matérialisateurs, exécuteurs, préflights et validations nécessaires ;
- finaliser les éléments résiduels du noyau historique ;
- préparer les démonstrations complètes de la série `0.5.x`.

### Contraintes

- ne pas confondre Metaplex Token Metadata avec les metadata incorporées de Token-2022 ou Metaplex Core ;
- utiliser les IDL archivées comme références de conception, jamais comme moteur dynamique de production ;
- conserver les matrices exécutables sous `test-fixtures/contract-matrices/`.

### Critères de sortie

- couverture fonctionnelle bornée et documentée ;
- tests contractuels et unitaires complets ;
- limites et validations réseau explicites ;
- aucune surface partiellement annoncée comme terminée.

## 0.5.x — démonstrations, configuration et wallet

### Configuration

- scinder `kb-config` en deux fichiers, ou trois si nécessaire ;
- alléger la configuration générale ;
- extraire les blocs dupliqués entre profils, notamment le logging ;
- conserver un schéma explicite et des exemples utilisateurs cohérents.

### Scénarios de démonstration

- rendre `kb-pipeline-demo-scenarios` pleinement autonome hors desktop ;
- améliorer le CLI, les fixtures et les rapports ;
- compléter les démonstrations des surfaces `0.4.x` ;
- maintenir les adapters Tauri minces.

### Wallet

- compléter réellement `kb-wallet` ;
- ajouter import, export, multi-wallets et sélection active ;
- ajouter changement de mot de passe, chiffrement, déchiffrement et verrouillage ;
- ajouter sauvegarde, restauration, politiques de sécurité et intégration aux profils/signers.

## 0.6.x — Anchor, programmes SPL et Metaplex complémentaires

### Anchor

- implémenter une infrastructure générique de décodage des conventions Anchor ;
- prendre en charge discriminants, comptes, événements et erreurs selon des contrats bornés ;
- intégrer les conventions Anchor aux décodeurs, exécuteurs et matérialisateurs.

### IDL

- maintenir dès maintenant la classification et le nommage des IDL archivées ;
- ajouter les IDL de référence au fur et à mesure des protocoles étudiés ;
- ne jamais charger dynamiquement les IDL ni exécuter arbitrairement leur contenu en production.

### Programmes

- ajouter le reste des programmes SPL ;
- ajouter le reste des programmes Metaplex ;
- documenter chaque surface avec matrices, tests et critères de validation.

## 0.7.x — Meteora

1. AMM Meteora : DLMM, DAMM v1, DAMM v2 et autres AMM non launchpad ;
2. launchpad DBC ;
3. vaults Meteora ;
4. autres programmes Meteora identifiés et vérifiés.

## 0.8.x — Raydium

1. AMM et swaps : v4, v3, v2, CPMM, CLMM et stable swap ;
2. LaunchLab ;
3. Raydium Lock ;
4. autres programmes Raydium identifiés et vérifiés.

## 0.9.x — Pump

1. Pump AMM ;
2. Pump.fun ;
3. Pump Fees ;
4. autres programmes Pump à identifier.

À auditer avant classement :

```text
MAyhSmzXzV1pTf7LsNkrNwkWKTo4ougAJ1PPg47MD4e
```

Vérifier sa nature, son déploiement et son appartenance réelle à la famille Pump. Vérifier séparément si `pumpup_ai` appartient à cette famille ou constitue un protocole distinct.

## 0.10.x — Orca

1. Whirlpool ;
2. Orca v1 ;
3. Orca v2 ;
4. Wavebreak ;
5. autres programmes Orca identifiés et vérifiés.

## 0.11.x — Jupiter

- routers et agrégateurs ;
- DCA et ordres ;
- perpetuals et lockers ;
- autres programmes Jupiter identifiés et vérifiés.

## 0.12.x — OKX et autres routers

- routers et autres programmes OKX ;
- autres routers et agrégateurs hors Jupiter ;
- surfaces de matérialisation, sécurité et exécution associées.

## 0.13.x — transports temps réel

- extension WebSocket Helius dans `kb-onchain-transport` ;
- amélioration de LaserStream si pertinente ;
- Yellowstone gRPC ;
- autres transports streaming ;
- reprise, continuité, backpressure, reconnexion et métriques ;
- vérification et classement du listing historique des Program IDs sans modifier l’archive bot2.

## 0.14.x — application de trading et orchestration

- application de trading ;
- workers et services séparés ;
- orchestration et automatisation ;
- stratégies et exécution contrôlée ;
- sécurité opérationnelle ;
- séparation stricte entre UI, workers et services.

## 0.15.x+ — extensions futures

- nouveaux décodeurs, exécuteurs et matérialisateurs ;
- protocoles et transports supplémentaires ;
- opérations historiques et backfills avancés ;
- optimisations, observabilité et outils d’administration ;
- extensions futures validées par des contrats bornés.