khadhroony-bot3/ROADMAP.md

ROADMAP — khadhroony-bot3

0.1.0 — Consolidation du workspace

• Créer les dix crates initiales du workspace avec le nom canonique kb-wallet.
• Regrouper les contrats decoder/executor/materializer dans kb-lib.
• Générer l’arborescence des modules à partir des anciennes crates.
• Conserver une copie de référence complète de khadhroony-bot2.
• Restaurer l’architecture modulaire de kb-core à partir de kb_core, avec lib.rs limité aux modules et réexports.
• Porter exactement les contrats publics de kb_decoder_api.
• Porter exactement les contrats publics des APIs d’exécution et de matérialisation.
• Porter les modèles de kb_model vers kb-lib.
• [~] Porter les décodeurs Solana core, SPL et Metaplex.
• Porter leurs matérialisateurs et exécuteurs.
• Fusionner kb_store_core et kb_store_pg dans kb-store.
• Adapter kb-pipeline aux nouveaux chemins publics.
• Adapter kb-app-demo et rétablir les validations fonctionnelles.
• Réorganiser les chemins d’export TS‑RS de kb-lib dans une tranche dédiée, en conservant ../frontend/ts/bindings/ comme préfixe de base.
• Auditer rétrospectivement la couverture historique des décodeurs et matérialisateurs.

0.1.0-pre.002 — Contrats fondamentaux consolidés

• Porter les modèles partagés de kb_model dans kb-lib.
• Porter les contrats publics de décodage dans kb-lib::decoder::api.
• Porter les contrats publics de matérialisation dans kb-lib::materializer::api.
• Porter les contrats publics d'exécution dans kb-lib::executor::api.
• Maintenir lib.rs comme façade sans implémentation métier.
• Valider le workspace avec Cargo sur la machine de développement.

0.1.0-pre.003 — Réécriture de kb-store

• Remplacer le scaffold par une architecture intégrée contrats/adaptateurs.
• Porter les DTO, entités, traits et validations store-neutral.
• Porter l’adaptateur PostgreSQL, ses requêtes, diagnostics et initialisations idempotentes.
• Conserver CoreInstructionReplayInput dans kb-lib et le réexporter depuis kb-store.
• Supprimer la dépendance directe de kb-store vers kb-config.
• Adapter les règles bot2 devenues incompatibles avec l’architecture bot3.
• Valider cargo check, les 84 tests et Clippy pour kb-store, puis cargo check --workspace.
• Valider cargo test --workspace et cargo clippy --workspace --all-targets.
• Valider les 84 tests PostgreSQL réels avec KB_POSTGRES_TEST_URL.

0.1.0-pre.004 — Décodeur Solana Core dans kb-lib

• Remplacer le scaffold kb-lib::decoder::solana::core par le décodeur maximal validé de bot2.
• Conserver les 18 surfaces natives, leurs 121 déclarations de couverture et leurs tests.
• Adapter les contrats vers les réexports de kb-lib sans dépendance vers kb-store.
• Préfixer les symboles internes afin d’éviter les collisions avec les futurs décodeurs fusionnés.
• Déclarer le target hiérarchique kb-lib.decoder.solana.core.
• Valider cargo check -p kb-lib, les 169 tests de kb-lib et les deux audits Rust.
• Valider Clippy et l’ensemble du workspace sur la machine de développement.
• Poursuivre avec SPL Memo après validation.

0.1.0-pre.005 — Décodeur SPL Memo dans kb-lib

• Remplacer le scaffold kb-lib::decoder::spl::memo par le décodeur validé de bot2.
• Conserver les générations v1, v3 et v4, leurs règles distinctes et les 9 tests.
• Ajouter les trois Program IDs canoniques dans kb-program-ids sans les classer comme natifs.
• Préserver le payload borné, le SHA-256, les comptes ordonnés et les statuts non commités.
• Porter la matrice machine-readable docs/SPL_MEMO_MATRIX.json.
• Valider kb-program-ids, kb-lib et le workspace avec Cargo sur la machine de développement.
• Poursuivre avec SPL Token classique après validation.