Project Roadmap 🗺️

The development path of codex-bot from a base framework to a complete Telegram development ecosystem.

✅ Phase 1: Foundation (v0.1.0) — COMPLETED

[x] Smart Merge: Safe integration into existing projects via CLI.
[x] FSM Isolation: Namespacing feature data (BaseStateManager).
[x] Smart Resolver: director.resolve() pattern for navigation control.
[x] ID Inspector: Built-in identifier debug helper.
[ ] Unified Envelope: Implementation of a unified message contract. (Task #006)
[x] Metadata-Driven Navigation: Full support for __next_scene__. (Backlog)
[ ] Redis Stream FSM Integration: Automatic Director injection in Redis handlers. (Task #004b)

[ ] In-Bot Guide System: Interactive documentation navigator. (Task #003)
[ ] Status Commands: Built-in system health diagnostics (DB, Redis, API).
[ ] Strict Typing: Transition to Enums for states and transitions.
[ ] Contextual Hints: Educational mode in CLI during feature creation.

[ ] Webhooks Service: Native support for incoming webhooks (FastAPI/Aiohttp). (Task #009)
[ ] Docker Infrastructure: Ready-to-use containerization templates. (Task #002)
[ ] Smart Recovery: Automated retry logic for API and DB.
[ ] Animation Engine: Expanding the library of visual waiting effects.
[ ] SQLAlchemy Sender Storage: Persistent UI coordinate storage without Redis. (Task #007)

[ ] Multi-Broker Support: Adapters for RabbitMQ and Kafka with unified router syntax. (Task #008)
[ ] Remote FSM Management: User state management via brokers without Aiogram involvement.
[ ] Smart Routing: Automated message distribution between multiple bot instances.

[ ] Infrastructure Coverage (High Priority)
- [x] Redis Routing & Dispatching Tests
- [ ] RedisStreamProcessor integration tests (mock Redis).
- [ ] CLI Automation tests (Scaffolding, Feature generation).
- [ ] Database Repository & Migration handlers tests.
[ ] Feature Verification
- [ ] features/errors pipeline verification.
- [ ] I18n Fluent compiler edge cases.