docs(05-04): complete mention mode plan

Phase 5 complete - M4, M5, M8 milestones done:
- Open mode (parallel) for multi-model discussions
- Discuss mode (sequential rounds) with context
- @mention direct messages to specific models

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.planning/ROADMAP.md

@@ -18,7 +18,7 @@ None
 - [x] **Phase 2: Bot Core** - Telegram bot setup, /help, /status (M1)
 - [x] **Phase 3: Project CRUD** - Project management commands (M2)
 - [x] **Phase 4: Single Model Q&A** - AI client abstraction, basic queries (M3)
-- [ ] **Phase 5: Multi-Model Discussions** - Open mode, discuss mode, @mentions (M4, M5, M8)
+- [x] **Phase 5: Multi-Model Discussions** - Open mode, discuss mode, @mentions (M4, M5, M8)
 - [ ] **Phase 6: Consensus & Export** - Consensus generation, markdown export (M6, M7)
 
 ## Phase Details
@@ -53,11 +53,12 @@ None
 **Plans**: 2 (04-01 AI client, 04-02 /ask command)
 **Completed**: 2026-01-16
 
-### Phase 5: Multi-Model Discussions
+### Phase 5: Multi-Model Discussions ✓
 **Goal**: Open mode (parallel), discuss mode (sequential rounds), and @mention direct messages
 **Depends on**: Phase 4
 **Research**: Unlikely (builds on Phase 4 AI client patterns)
 **Plans**: 4 (05-01 discussion service, 05-02 open mode, 05-03 discuss mode, 05-04 mentions)
+**Completed**: 2026-01-16
 
 ### Phase 6: Consensus & Export
 **Goal**: Consensus generation from discussions and markdown export
@@ -76,5 +77,5 @@ Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6
 | 2. Bot Core | 2/2 | Complete | 2026-01-16 |
 | 3. Project CRUD | 3/3 | Complete | 2026-01-16 |
 | 4. Single Model Q&A | 2/2 | Complete | 2026-01-16 |
-| 5. Multi-Model Discussions | 3/4 | In progress | - |
+| 5. Multi-Model Discussions | 4/4 | Complete | 2026-01-16 |
 | 6. Consensus & Export | 0/TBD | Not started | - |

.planning/STATE.md

@@ -5,23 +5,23 @@
 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 5 — Multi-Model Discussions (next)
+**Current focus:** Phase 6 — Consensus & Export (next)
 
 ## Current Position
 
 Phase: 5 of 6 (Multi-Model Discussions)
-Plan: 3 of 4 in current phase
+Plan: 4 of 4 in current phase
-Status: In progress
+Status: Phase complete
-Last activity: 2026-01-16 — Completed 05-03-PLAN.md (discuss mode)
+Last activity: 2026-01-16 — Completed 05-04-PLAN.md (mention mode)
 
-Progress: █████████░ ~80%
+Progress: █████████░ ~85%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 13
+- Total plans completed: 14
 - Average duration: 4 min
-- Total execution time: 0.82 hours
+- Total execution time: 0.95 hours
 
 **By Phase:**
 
@@ -31,10 +31,10 @@ Progress: █████████░ ~80%
 | 02-bot-core | 2 | 4 min | 2 min |
 | 03-project-crud | 3 | 11 min | 4 min |
 | 04-single-model-qa | 2 | 10 min | 5 min |
-| 05-multi-model | 3 | 10 min | 3 min |
+| 05-multi-model | 4 | 18 min | 5 min |
 
 **Recent Trend:**
-- Last 5 plans: 04-02 (5 min), 05-01 (2 min), 05-02 (3 min), 05-03 (5 min)
+- Last 5 plans: 05-01 (2 min), 05-02 (3 min), 05-03 (5 min), 05-04 (8 min)
 - Trend: Fast
 
 ## Accumulated Context
@@ -68,6 +68,9 @@ Recent decisions affecting current work:
 - **05-02:** SYSTEM_PROMPT includes participant list and topic for roundtable context
 - **05-03:** Sequential model execution with for-loop so each model sees prior responses
 - **05-03:** Context stored in user_data["discussion_state"] for multi-command flows
+- **05-04:** Direct messages prefix with "[Direct to you]:" for model awareness
+- **05-04:** MessageHandler registered AFTER CommandHandlers for correct priority
+- **05-04:** @mentions persist with is_direct=True in current round
 
 ### Deferred Issues
 
@@ -79,6 +82,6 @@ None yet.
 
 ## Session Continuity
 
-Last session: 2026-01-16T19:45:21Z
+Last session: 2026-01-16T19:58:00Z
-Stopped at: Completed 05-03-PLAN.md (discuss mode)
+Stopped at: Completed 05-04-PLAN.md (mention mode) - Phase 5 complete
 Resume file: None

.planning/phases/05-multi-model-discussions/05-04-SUMMARY.md

@@ -0,0 +1,103 @@
+---
+phase: 05-multi-model-discussions
+plan: 04
+subsystem: api
+tags: [telegram, ai-orchestration, mention-handler, direct-messages, message-handler]
+
+# Dependency graph
+requires:
+  - phase: 05-multi-model-discussions/03
+    provides: build_context() for discussion context, discussion service with is_direct flag
+  - phase: 04-single-model-qa/02
+    provides: AIClient.complete() and typing indicator pattern
+provides:
+  - query_model_direct() for single model queries with optional context
+  - @mention handler (@claude, @gpt, @gemini) for direct model messages
+  - Enhanced /status showing active discussion state
+affects: [06-consensus, 06-export]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [MessageHandler with regex filter for @mentions, direct messages with is_direct flag]
+
+key-files:
+  created: []
+  modified: [src/moai/core/orchestrator.py, src/moai/bot/handlers/discussion.py, src/moai/bot/handlers/__init__.py, src/moai/bot/handlers/status.py]
+
+key-decisions:
+  - "Direct messages include '[Direct to you]:' prefix in context for model awareness"
+  - "MessageHandler registered AFTER CommandHandlers (telegram-bot ordering)"
+  - "@mentions persist with is_direct=True in current round if discussion active"
+
+patterns-established:
+  - "query_model_direct for single model queries with optional discussion context"
+  - "MessageHandler with Regex filter for @mention syntax"
+
+issues-created: []
+
+# Metrics
+duration: 8min
+completed: 2026-01-16
+---
+
+# Phase 5 Plan 4: @Mention Direct Messages Summary
+
+**@claude/@gpt/@gemini direct message handlers with discussion context and enhanced /status display**
+
+## Performance
+
+- **Duration:** 8 min
+- **Started:** 2026-01-16T19:50:00Z
+- **Completed:** 2026-01-16T19:58:00Z
+- **Tasks:** 3
+- **Files modified:** 4
+
+## Accomplishments
+
+- Added query_model_direct() function for single model queries with optional discussion context
+- Implemented @mention message handler with regex filter for @claude, @gpt, @gemini
+- Direct messages persist with is_direct=True flag when discussion is active
+- Enhanced /status command to show active discussion info (round progress, message count, discussion ID)
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Add query_model_direct() to orchestrator** - `5934d21` (feat)
+2. **Task 2: Implement @mention message handler** - `3296874` (feat)
+3. **Task 3: Update /status to show active discussion info** - `2a86d39` (feat)
+
+**Plan metadata:** (pending)
+
+## Files Created/Modified
+
+- `src/moai/core/orchestrator.py` - Added query_model_direct() function for direct model queries
+- `src/moai/bot/handlers/discussion.py` - Added mention_handler for @model messages
+- `src/moai/bot/handlers/__init__.py` - Registered MessageHandler with regex filter
+- `src/moai/bot/handlers/status.py` - Enhanced to show project and discussion state
+
+## Decisions Made
+
+- Direct messages prefix user input with "[Direct to you]:" so model knows it's specifically addressed
+- MessageHandler registered after CommandHandlers to ensure commands take priority
+- Regex filter `^@(claude|gpt|gemini)\s` requires space after model name
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None
+
+## Next Phase Readiness
+
+- M8 milestone (@mention direct messages) complete
+- Phase 5 complete (M4, M5, M8 all done)
+- Discussion infrastructure ready for consensus generation (Phase 6)
+- Message context and is_direct flag available for export filtering
+
+---
+*Phase: 05-multi-model-discussions*
+*Completed: 2026-01-16*