feat(matrix): land QA follow-ups and refresh docs

- harden Matrix onboarding/chat lifecycle after manual QA
- refresh README and Matrix docs to match current behavior
- add local ignores for runtime artifacts and include current planning/report docs

Closes #7
Closes #9
Closes #14

adapter/telegram/bot.py

@@ -4,6 +4,9 @@ import asyncio
 import os
 
 import structlog
+from dotenv import load_dotenv
+
+load_dotenv()
 from aiogram import Bot, Dispatcher
 from aiogram.fsm.storage.memory import MemoryStorage
 from aiogram.types import BotCommand
@@ -41,9 +44,9 @@ def build_event_dispatcher() -> EventDispatcher:
 
 
 async def main() -> None:
-    token = os.environ.get("BOT_TOKEN")
+    token = os.environ.get("BOT_TOKEN") or os.environ.get("TELEGRAM_BOT_TOKEN")
     if not token:
-        raise RuntimeError("BOT_TOKEN env variable is not set")
+        raise RuntimeError("BOT_TOKEN (or TELEGRAM_BOT_TOKEN) env variable is not set")
 
     db.init_db()