khadhroony-bot3/ROADMAP.md

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 :

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.