Skip to content

Project Roadmap 🗺️

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

Release 0.4.0 adds managed agent skills, offline skill installation, and dependency and packaging maintenance. See the installation guide. The unchecked items below are future work, without assigned release versions.

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

  • [x] Core framework: Director, Orchestrator, ViewSender.
  • [x] Discovery Engine: Automated feature search.
  • [x] Basic Redis Integration: FSM and Storage.
  • [x] CLI: startproject command and base templates.

🏗️ Phase 2: Protocols & Standardization — IN PROGRESS

  • [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)

🧩 Phase 3: DX & Tooling — PLANNED

  • [ ] 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.

🚀 Phase 4: Scaling & Infrastructure — PLANNED

  • [ ] 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)

📡 Phase 5: Event-Driven Ecosystem — PLANNED

  • [ ] 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.

🧪 Testing & Quality Assurance

  • [ ] 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.

📈 Future

  • Telegram Business integration (managing personal accounts via bots).
  • Visual scenario designer plugin (No-code bridge).