docs(02-01): complete bot infrastructure plan

Tasks completed: 3/3
- Create bot configuration module
- Create bot main.py with Application setup
- Create handlers package structure

SUMMARY: .planning/phases/02-bot-core/02-01-SUMMARY.md

.planning/ROADMAP.md

@@ -70,7 +70,7 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6
 | Phase | Plans Complete | Status | Completed |
 |-------|----------------|--------|-----------|
 | 1. Foundation | 3/3 | Complete | 2026-01-16 |
-| 2. Bot Core | 0/TBD | Not started | - |
+| 2. Bot Core | 1/TBD | In progress | - |
 | 3. Project CRUD | 0/TBD | Not started | - |
 | 4. Single Model Q&A | 0/TBD | Not started | - |
 | 5. Multi-Model Discussions | 0/TBD | Not started | - |

.planning/STATE.md

@@ -5,32 +5,33 @@
 See: .planning/PROJECT.md (updated 2026-01-16)
 
 **Core value:** Get richer, more diverse AI insights through structured multi-model discussions—ask a team of AIs instead of just one.
-**Current focus:** Phase 1 — Foundation
+**Current focus:** Phase 2 — Bot Core
 
 ## Current Position
 
-Phase: 1 of 6 (Foundation)
-Plan: 3 of 3 complete
-Status: Phase complete
-Last activity: 2026-01-16 — Completed 01-03-PLAN.md (database & tests)
+Phase: 2 of 6 (Bot Core)
+Plan: 1 of ? in current phase
+Status: In progress
+Last activity: 2026-01-16 — Completed 02-01-PLAN.md (bot infrastructure)
 
-Progress: █░░░░░░░░░ ~17%
+Progress: ██░░░░░░░░ ~22%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 3
-- Average duration: 5 min
-- Total execution time: 0.25 hours
+- Total plans completed: 4
+- Average duration: 4 min
+- Total execution time: 0.28 hours
 
 **By Phase:**
 
 | Phase | Plans | Total | Avg/Plan |
 |-------|-------|-------|----------|
 | 01-foundation | 3 | 15 min | 5 min |
+| 02-bot-core | 1 | 2 min | 2 min |
 
 **Recent Trend:**
-- Last 5 plans: 01-01 (8 min), 01-02 (3 min), 01-03 (4 min)
+- Last 5 plans: 01-01 (8 min), 01-02 (3 min), 01-03 (4 min), 02-01 (2 min)
 - Trend: Fast
 
 ## Accumulated Context
@@ -46,6 +47,8 @@ Recent decisions affecting current work:
 - **01-02:** JSON type for list/dict fields (no ARRAY for SQLite)
 - **01-03:** expire_on_commit=False for async session usability
 - **01-03:** Module-level globals for engine/session factory (simple singleton)
+- **02-01:** Module-level config reference for post_init callback access
+- **02-01:** Config stored in bot_data for handler access
 
 ### Deferred Issues
 
@@ -57,6 +60,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-01-16T15:17:06Z
-Stopped at: Completed Phase 1 (Foundation) — 3/3 plans done
+Last session: 2026-01-16T15:37:27Z
+Stopped at: Completed 02-01-PLAN.md (bot infrastructure)
 Resume file: None

.planning/phases/02-bot-core/02-01-SUMMARY.md

@@ -0,0 +1,94 @@
+---
+phase: 02-bot-core
+plan: 01
+subsystem: bot
+tags: [telegram, python-telegram-bot, async, configuration]
+
+# Dependency graph
+requires:
+  - phase: 01-foundation/01-03
+    provides: Async database session management (init_db, create_tables, close_db)
+provides:
+  - Bot entry point with Application lifecycle
+  - Configuration loading from environment
+  - Handler registration pattern
+affects: [02-02-handlers, 03-project-crud]
+
+# Tech tracking
+tech-stack:
+  added: [python-telegram-bot]
+  patterns: [ApplicationBuilder with lifecycle hooks, module-level config singleton]
+
+key-files:
+  created:
+    - src/moai/bot/config.py
+    - src/moai/bot/main.py
+  modified:
+    - src/moai/bot/handlers/__init__.py
+
+key-decisions:
+  - "Module-level config reference for post_init callback access"
+  - "Config stored in bot_data for handler access"
+  - "Empty register_handlers as extension point for future handlers"
+
+patterns-established:
+  - "Bot lifecycle: post_init for DB setup, post_shutdown for cleanup"
+  - "Environment config with BotConfig.from_env() pattern"
+
+issues-created: []
+
+# Metrics
+duration: 2min
+completed: 2026-01-16
+---
+
+# Phase 02-01: Bot Infrastructure Summary
+
+**Telegram bot entry point with ApplicationBuilder, config loading, and handler registration pattern**
+
+## Performance
+
+- **Duration:** 2 min
+- **Started:** 2026-01-16T15:34:55Z
+- **Completed:** 2026-01-16T15:37:27Z
+- **Tasks:** 3
+- **Files modified:** 3
+
+## Accomplishments
+- BotConfig dataclass loading configuration from environment variables
+- Bot main.py with ApplicationBuilder and database lifecycle hooks
+- Handler registration pattern ready for incremental handler addition
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create bot configuration module** - `4381e12` (feat)
+2. **Task 2: Create bot main.py with Application setup** - `c3a849b` (feat)
+3. **Task 3: Create handlers package structure** - `0a81855` (feat)
+
+## Files Created/Modified
+- `src/moai/bot/config.py` - BotConfig dataclass with from_env() loading BOT_TOKEN, ALLOWED_USERS, DATABASE_URL, LOG_LEVEL
+- `src/moai/bot/main.py` - Bot entry point with ApplicationBuilder, post_init/post_shutdown hooks, register_handlers call
+- `src/moai/bot/handlers/__init__.py` - register_handlers function placeholder for future handler registration
+
+## Decisions Made
+- Used module-level `_config` variable for post_init callback to access config (simpler than passing through Application)
+- Store config in `app.bot_data["config"]` for handlers to access user settings
+- Keep register_handlers as empty placeholder rather than removing it - cleaner extension point
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+None
+
+## Next Phase Readiness
+- Bot infrastructure complete, ready for handler implementation
+- Ready for 02-02: /help and /status command handlers
+- Database lifecycle integrated with bot startup/shutdown
+
+---
+*Phase: 02-bot-core*
+*Completed: 2026-01-16*