# ROADMAP — khadhroony-bot3 ## 0.1.0 — Consolidation du workspace - [x] Créer les dix crates initiales du workspace avec le nom canonique `kb-wallet`. - [x] Regrouper les contrats decoder/executor/materializer dans `kb-lib`. - [x] Générer l’arborescence des modules à partir des anciennes crates. - [x] Conserver une copie de référence complète de `khadhroony-bot2`. - [x] Restaurer l’architecture modulaire de `kb-core` à partir de `kb_core`, avec `lib.rs` limité aux modules et réexports. - [x] Porter exactement les contrats publics de `kb_decoder_api`. - [x] Porter exactement les contrats publics des APIs d’exécution et de matérialisation. - [x] 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. - [x] 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 - [x] Porter les modèles partagés de `kb_model` dans `kb-lib`. - [x] Porter les contrats publics de décodage dans `kb-lib::decoder::api`. - [x] Porter les contrats publics de matérialisation dans `kb-lib::materializer::api`. - [x] Porter les contrats publics d'exécution dans `kb-lib::executor::api`. - [x] Maintenir `lib.rs` comme façade sans implémentation métier. - [x] Valider le workspace avec Cargo sur la machine de développement. ### 0.1.0-pre.003 — Réécriture de `kb-store` - [x] Remplacer le scaffold par une architecture intégrée contrats/adaptateurs. - [x] Porter les DTO, entités, traits et validations store-neutral. - [x] Porter l’adaptateur PostgreSQL, ses requêtes, diagnostics et initialisations idempotentes. - [x] Conserver `CoreInstructionReplayInput` dans `kb-lib` et le réexporter depuis `kb-store`. - [x] Supprimer la dépendance directe de `kb-store` vers `kb-config`. - [x] Adapter les règles bot2 devenues incompatibles avec l’architecture bot3. - [x] 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`. - [x] Valider les 84 tests PostgreSQL réels avec `KB_POSTGRES_TEST_URL`. ### 0.1.0-pre.004 — Décodeur Solana Core dans `kb-lib` - [x] Remplacer le scaffold `kb-lib::decoder::solana::core` par le décodeur maximal validé de bot2. - [x] Conserver les 18 surfaces natives, leurs 121 déclarations de couverture et leurs tests. - [x] Adapter les contrats vers les réexports de `kb-lib` sans dépendance vers `kb-store`. - [x] Préfixer les symboles internes afin d’éviter les collisions avec les futurs décodeurs fusionnés. - [x] Déclarer le target hiérarchique `kb-lib.decoder.solana.core`. - [x] 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. - [x] Poursuivre avec SPL Memo après validation. ### 0.1.0-pre.005 — Décodeur SPL Memo dans `kb-lib` - [x] Remplacer le scaffold `kb-lib::decoder::spl::memo` par le décodeur validé de bot2. - [x] Conserver les générations v1, v3 et v4, leurs règles distinctes et les 9 tests. - [x] Ajouter les trois Program IDs canoniques dans `kb-program-ids` sans les classer comme natifs. - [x] Préserver le payload borné, le SHA-256, les comptes ordonnés et les statuts non commités. - [x] Porter la matrice machine-readable `docs/SPL_MEMO_MATRIX.json`. - [x] Valider `kb-program-ids`, `kb-lib` et le workspace avec Cargo sur la machine de développement. - [x] Poursuivre avec SPL Token classique après validation. ### 0.1.0-pre.006 — Décodeur SPL Token classique dans `kb-lib` - [x] Remplacer le scaffold `kb-lib::decoder::spl::token` par le décodeur maximal validé de bot2. - [x] Conserver les 28 tags publiés par `spl-token-interface 3.0.0` et les huit tests différentiels. - [x] Préserver montants bruts, comptes ordonnés, autorités simple/multisig, suffixes et statuts non commités. - [x] Conserver les bornes de `Batch`, ses chemins enfants et le refus des batches imbriqués. - [x] Porter le target de tracing vers `kb-lib.decoder.spl.token`. - [x] Rendre la contrainte `wincode 0.5.5` et `solana-wincode-varint 1.0.0` vérifiable par l’audit workspace. - [ ] Valider `kb-program-ids`, `kb-lib`, Clippy et le workspace avec Cargo sur la machine de développement. - [ ] Poursuivre avec le décodeur SPL Associated Token Account après validation.