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

# 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.
- [ ] 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`.
- [ ] Valider les 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`.
- [ ] Valider `kb-lib` et le workspace avec Cargo sur la machine de développement.
- [ ] Poursuivre avec SPL Memo après validation.