- add the missing `core.bot_db` module referenced by existing imports - keep the top-level `bot_db` module as a backward-compatible re-export - update README to reflect the module layout and venv-based setup flow