feat: Add presence heartbeat for Matrix online status
- matrix-gateway: POST /internal/matrix/presence/online endpoint - usePresenceHeartbeat hook with activity tracking - Auto away after 5 min inactivity - Offline on page close/visibility change - Integrated in MatrixChatRoom component
This commit is contained in:
Apple
251
docs/tasks/README.md
Normal file
251
docs/tasks/README.md
Normal file
@@ -0,0 +1,251 @@
|
||||
# DAARION Cursor Tasks
|
||||
|
||||
**Готові таски для Cursor AI / інженерів**
|
||||
|
||||
Ця директорія містить структуровані задачі для імплементації функцій DAARION.
|
||||
|
||||
---
|
||||
|
||||
## 📋 Available Tasks
|
||||
|
||||
### 🔥 MASTER TASK: PHASE2_MASTER_TASK.md
|
||||
**Status:** 🚀 READY TO COPY TO CURSOR
|
||||
**Priority:** Critical
|
||||
**Estimated Time:** 4 weeks
|
||||
|
||||
**The complete, copy-paste-ready task for Cursor AI!**
|
||||
|
||||
Full implementation with code examples:
|
||||
- agent_filter (complete Python code)
|
||||
- Router extension (complete code)
|
||||
- agent-runtime (complete code)
|
||||
- Docker integration
|
||||
|
||||
**How to use:**
|
||||
```bash
|
||||
# Copy entire file and paste into Cursor
|
||||
cat docs/tasks/PHASE2_MASTER_TASK.md | pbcopy
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 1. TASK_PHASE2_AGENT_INTEGRATION.md
|
||||
**Status:** 📋 Ready to implement
|
||||
**Priority:** High
|
||||
**Estimated Time:** 4 weeks
|
||||
|
||||
**Goal:**
|
||||
Повна інтеграція агентів у Messenger:
|
||||
- `agent_filter` service — Security & routing layer
|
||||
- DAGI Router extension — Message routing
|
||||
- `agent-runtime-service` — LLM + Memory + Posting
|
||||
|
||||
**Deliverables:**
|
||||
- 3 нові сервіси (agent-filter, router extension, agent-runtime)
|
||||
- NATS event integration (actual publishing)
|
||||
- Full flow: Human → agent_filter → Router → Agent Runtime → Reply
|
||||
|
||||
**Dependencies:**
|
||||
- Messenger Module (✅ Complete)
|
||||
- NATS JetStream (✅ Running)
|
||||
- Matrix Synapse (✅ Running)
|
||||
|
||||
**How to use:**
|
||||
```bash
|
||||
# Copy entire task into Cursor
|
||||
cat docs/tasks/TASK_PHASE2_AGENT_INTEGRATION.md
|
||||
|
||||
# Or work step-by-step:
|
||||
# 1) Implement agent_filter
|
||||
# 2) Extend DAGI Router
|
||||
# 3) Implement agent-runtime
|
||||
# 4) Docker-compose integration
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. TASK_AGENT_HUB_MVP.md
|
||||
**Status:** 📋 Ready to implement
|
||||
**Priority:** High
|
||||
**Estimated Time:** 2 weeks
|
||||
|
||||
**Goal:**
|
||||
Створити Agent Hub — головний інтерфейс для роботи з агентами:
|
||||
- 3-колонковий layout (Agents | Chat | Context)
|
||||
- Direct channels з агентами
|
||||
- Reuse Messenger components
|
||||
- Context panel (projects, capabilities)
|
||||
|
||||
**Deliverables:**
|
||||
- Frontend: `/hub` route з 6 компонентами
|
||||
- Backend: Agent Hub API (4 endpoints)
|
||||
- Navigation links (Onboarding → Hub, City → Hub)
|
||||
|
||||
**Dependencies:**
|
||||
- Messenger Module (✅ Complete)
|
||||
- TASK_PHASE2_AGENT_INTEGRATION (⚠️ Recommended but not blocking for UI)
|
||||
|
||||
**How to use:**
|
||||
```bash
|
||||
# Copy entire task into Cursor
|
||||
cat docs/tasks/TASK_AGENT_HUB_MVP.md
|
||||
|
||||
# Or implement incrementally:
|
||||
# 1) Backend API (agents-service)
|
||||
# 2) Frontend structure
|
||||
# 3) Messenger integration
|
||||
# 4) Context panel
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Task Workflow
|
||||
|
||||
### Step 1: Choose Task
|
||||
Select based on priority and dependencies.
|
||||
|
||||
### Step 2: Review
|
||||
- Read task completely
|
||||
- Check dependencies
|
||||
- Review acceptance criteria
|
||||
|
||||
### Step 3: Implement
|
||||
- Copy task to Cursor
|
||||
- Follow structure step-by-step
|
||||
- Test each component
|
||||
|
||||
### Step 4: Validate
|
||||
- Run acceptance criteria tests
|
||||
- Update documentation
|
||||
- Mark task as complete
|
||||
|
||||
---
|
||||
|
||||
## 📚 Related Documentation
|
||||
|
||||
### Core Docs
|
||||
- [MESSAGING_ARCHITECTURE.md](../MESSAGING_ARCHITECTURE.md) — Complete technical spec
|
||||
- [MESSENGER_COMPLETE_SPECIFICATION.md](../MESSENGER_COMPLETE_SPECIFICATION.md) — Master navigation
|
||||
- [messaging-erd.dbml](../messaging-erd.dbml) — Database ERD
|
||||
|
||||
### Implementation Guides
|
||||
- [MESSENGER_MODULE_COMPLETE.md](../MESSENGER_MODULE_COMPLETE.md) — Phase 1 summary
|
||||
- [MESSENGER_TESTING_GUIDE.md](../MESSENGER_TESTING_GUIDE.md) — Testing scenarios
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Roadmap
|
||||
|
||||
```
|
||||
✅ Phase 1: Messenger Core (Complete)
|
||||
- Database schema
|
||||
- messaging-service
|
||||
- matrix-gateway spec
|
||||
- Frontend UI
|
||||
- WebSocket real-time
|
||||
|
||||
📋 Phase 2: Agent Integration (Next - TASK_PHASE2)
|
||||
- agent_filter service
|
||||
- DAGI Router extension
|
||||
- agent-runtime-service
|
||||
- NATS events
|
||||
|
||||
📋 Phase 2.5: Agent Hub (Parallel - TASK_AGENT_HUB)
|
||||
- Agent Hub UI
|
||||
- Direct channels
|
||||
- Context panel
|
||||
- Navigation
|
||||
|
||||
🔜 Phase 3: Advanced Features
|
||||
- Multi-agent coordination
|
||||
- Scheduled messages
|
||||
- Voice messages
|
||||
- Analytics
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💡 Tips for Using Tasks
|
||||
|
||||
### For Cursor AI:
|
||||
1. Copy entire task file
|
||||
2. Paste as single prompt
|
||||
3. Let Cursor work through incrementally
|
||||
4. Review generated code
|
||||
5. Test acceptance criteria
|
||||
|
||||
### For Human Developers:
|
||||
1. Read task thoroughly
|
||||
2. Break into sub-tasks if needed
|
||||
3. Implement step-by-step
|
||||
4. Cross-reference with architecture docs
|
||||
5. Write tests
|
||||
|
||||
### For Team Leads:
|
||||
1. Assign tasks based on expertise
|
||||
2. Track progress via acceptance criteria
|
||||
3. Review deliverables
|
||||
4. Update roadmap
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start
|
||||
|
||||
### To start Phase 2:
|
||||
```bash
|
||||
# 1. Read task
|
||||
cat docs/tasks/TASK_PHASE2_AGENT_INTEGRATION.md
|
||||
|
||||
# 2. Start with agent_filter
|
||||
cd services
|
||||
mkdir agent-filter
|
||||
cd agent-filter
|
||||
# Follow task instructions...
|
||||
|
||||
# 3. Test
|
||||
docker-compose -f docker-compose.agents.yml up -d
|
||||
```
|
||||
|
||||
### To start Agent Hub:
|
||||
```bash
|
||||
# 1. Read task
|
||||
cat docs/tasks/TASK_AGENT_HUB_MVP.md
|
||||
|
||||
# 2. Create feature structure
|
||||
mkdir -p src/features/agent-hub/{components,hooks,api}
|
||||
# Follow task instructions...
|
||||
|
||||
# 3. Test
|
||||
npm run dev
|
||||
# Navigate to http://localhost:8899/hub
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Task Status
|
||||
|
||||
| Task | Status | Progress | ETA |
|
||||
|------|--------|----------|-----|
|
||||
| Messenger Core (Phase 1) | ✅ Complete | 100% | Done |
|
||||
| **Phase 2: Agent Integration** | 🚀 **READY** | 0% | 4 weeks |
|
||||
| Agent Hub MVP | 📋 Ready | 0% | 2 weeks |
|
||||
| Phase 3: Core Services | 📋 Roadmap | 0% | 6-8 weeks |
|
||||
| Projects Module | 🔜 Planned | 0% | TBD |
|
||||
| Follow-ups Module | 🔜 Planned | 0% | TBD |
|
||||
|
||||
---
|
||||
|
||||
## 🤝 Contributing
|
||||
|
||||
When adding new tasks:
|
||||
1. Use existing task format
|
||||
2. Include all sections (Goal, Dependencies, Deliverables, Acceptance Criteria)
|
||||
3. Add to this README
|
||||
4. Link to related docs
|
||||
5. Update roadmap
|
||||
|
||||
---
|
||||
|
||||
**Last Updated:** 2025-11-24
|
||||
**Maintainer:** DAARION Platform Team
|
||||
|
||||
Reference in New Issue
Block a user