0.1.0

README.md

@@ -0,0 +1,39 @@
+# Khadhroony Bot3
+
+Khadhroony Bot3 is the consolidated successor workspace to `khadhroony-bot2`.
+
+## Workspace crates
+
+- `kb-core`: foundation errors and shared primitives.
+- `kb-config`: configuration contracts.
+- `kb-lib`: all decoder, executor and materializer APIs and implementations.
+- `kb-logging`: logging and tracing runtime.
+- `kb-program-ids`: Solana program identifier registry.
+- `kb-pipeline`: ingestion, decoding, materialization and execution orchestration.
+- `kb-rpc`: HTTP and WebSocket Solana transports.
+- `kb-store`: store-neutral contracts and PostgreSQL implementation modules.
+- `kb-wallet`: wallet and signer support.
+- `kb-app-demo`: the only binary retained during the initial migration.
+
+## Migration principle
+
+The previous workspace is preserved under `migration/khadhroony-bot2-reference`. The new workspace compiles independently as a controlled scaffold. Public APIs are ported into `kb-lib` module by module, with compatibility recorded in `migration/module-map.json`.
+
+## Validation
+
+```bash
+cargo fmt --all
+cargo check --workspace
+cargo test --workspace
+cargo clippy --workspace --all-targets
+```
+
+## État de migration `0.1.0-pre.001`
+
+- `kb-wallet` remplace définitivement le scaffold `kb_wallet`.
+- `kb-core` conserve l’architecture de `kb_core` : implémentations dans `error.rs` et `module.rs`, façade et réexports dans `lib.rs`.
+- Les prochaines APIs consolidées de `kb-lib` suivront la même règle : aucun contrat métier ne sera défini directement dans `lib.rs`.
+
+## Contrats consolidés
+
+À partir de `0.1.0-pre.002`, `kb-lib` porte les modèles et contrats fondamentaux autrefois répartis entre `kb_model`, `kb_decoder_api`, `kb_materializer_api` et `kb_execution_api`. Les implémentations restent dans des modules dédiés ; `kb-lib/src/lib.rs` ne contient que les déclarations de modules et les réexports publics.