docs: add unified ROADMAP.md with all milestones and parallel execution strategy

Includes: - All milestones M2-M7 with status - Dependency graph - Parallel execution strategy - Issue references for Federation (#83-94) and Orchestration (#95-102) - Versioning policy (0.0.x -> 0.1.0 MVP -> 1.0.0)
2026-01-29 17:31:24 -06:00
parent 82a09373e0
commit 95833fb4ea
1 changed files with 297 additions and 0 deletions
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -0,0 +1,297 @@
+# Mosaic Stack Roadmap
+
+**Last Updated:** 2026-01-29  
+**Authoritative Source:** [Issues & Milestones](https://git.mosaicstack.dev/mosaic/stack/issues)
+
+## Versioning Policy
+
+| Version | Meaning |
+|---------|---------|
+| `0.0.x` | Active development, breaking changes expected |
+| `0.1.0` | **MVP** — First user-testable release |
+| `0.x.y` | Pre-stable iteration, API may change with notice |
+| `1.0.0` | Stable release, public API contract |
+
+---
+
+## Milestone Overview
+
+```
+Timeline (2026)
+═══════════════════════════════════════════════════════════════════════════════
+
+Feb                    Mar                    Apr                    May
+ │                      │                      │                      │
+ ├──M2 ✓                │                      │                      │
+ │  MultiTenant         │                      │                      │
+ │  (0.0.2) DONE        │                      │                      │
+ │                      │                      │                      │
+ ├──M3─────────┐        │                      │                      │
+ │  Features   │        │                      │                      │
+ │  (0.0.3)    │        │                      │                      │
+ │             │        │                      │                      │
+ ├──M4─────────┼────┐   │                      │                      │
+ │  MoltBot    │    │   │                      │                      │
+ │  (0.0.4)    │    │   │                      │                      │
+ │             │    │   │                      │                      │
+ │             │    ├───┼──M5 Knowledge        │                      │
+ │             │    │   │  Module (0.0.5)      │                      │
+ │             │    │   │                      │                      │
+ │             │    │   ├──M6─────────────┐    │                      │
+ │             │    │   │  Orchestration │    │                      │
+ │             │    │   │  (0.0.6)       │    │                      │
+ │             │    │   │                │    │                      │
+ │             │    │   │                ├────┼──M7 Federation       │
+ │             │    │   │                │    │  (0.0.7)             │
+ │             │    │   │                │    │                      │
+ │             │    │   │                │    ├──M5 Migration        │
+ │             │    │   │                │    │  (0.1.0 MVP)         │
+ └─────────────┴────┴───┴────────────────┴────┴──────────────────────┘
+
+Legend: ───── Active development window
+        ✓     Complete
+```
+
+---
+
+## Milestones Detail
+
+### ✅ M2-MultiTenant (0.0.2) — COMPLETE
+**Due:** 2026-02-08 | **Status:** Done
+
+- [x] Workspace model and CRUD
+- [x] Team model with membership
+- [x] PostgreSQL Row-Level Security (RLS)
+- [x] Workspace isolation at database level
+- [x] Role-based access (Owner, Admin, Member, Guest)
+
+---
+
+### 🚧 M3-Features (0.0.3)
+**Due:** 2026-02-15 | **Status:** In Progress
+
+Core features for daily use:
+
+| Issue | Title | Priority | Status |
+|-------|-------|----------|--------|
+| #15 | Gantt chart component | P0 | Open |
+| #16 | Real-time updates (WebSocket) | P0 | Open |
+| #17 | Kanban board view | P1 | Open |
+| #18 | Advanced filtering and search | P1 | Open |
+| #21 | Ollama integration | P1 | Open |
+| #37 | Domains model | — | Open |
+| #41 | Widget/HUD System | — | Open |
+| #82 | Personality Module | P1 | Open |
+
+---
+
+### 🚧 M4-MoltBot (0.0.4)
+**Due:** 2026-02-22 | **Status:** In Progress
+
+Agent integration and skills:
+
+| Issue | Title | Priority | Status |
+|-------|-------|----------|--------|
+| #22 | Brain query API endpoint | P0 | Open |
+| #23 | mosaic-plugin-brain skill | P0 | Open |
+| #24 | mosaic-plugin-calendar skill | P1 | Open |
+| #25 | mosaic-plugin-tasks skill | P1 | Open |
+| #26 | mosaic-plugin-gantt skill | P2 | Open |
+| #27 | Intent classification service | P1 | Open |
+| #29 | Cron job configuration | P1 | Open |
+| #42 | Jarvis Chat Overlay | — | Open |
+
+---
+
+### 🚧 M5-Knowledge Module (0.0.5)
+**Due:** 2026-03-14 | **Status:** In Progress
+
+Wiki-style knowledge management:
+
+| Phase | Issues | Description |
+|-------|--------|-------------|
+| 1 | — | Core CRUD (DONE) |
+| 2 | #59-64 | Wiki-style linking |
+| 3 | #65-70 | Full-text + semantic search |
+| 4 | #71-74 | Graph visualization |
+| 5 | #75-80 | History, import/export, caching |
+
+**EPIC:** #81
+
+---
+
+### 📋 M6-AgentOrchestration (0.0.6)
+**Due:** 2026-03-28 | **Status:** Planned
+
+Persistent task management and autonomous agent coordination:
+
+| Phase | Issues | Description |
+|-------|--------|-------------|
+| 1 | #96, #97 | Database schema, Task CRUD API |
+| 2 | #98, #99, #102 | Valkey, Coordinator, Gateway integration |
+| 3 | #100 | Failure recovery, checkpoints |
+| 4 | #101 | Task progress UI |
+| 5 | — | Advanced (cost tracking, multi-region) |
+
+**EPIC:** #95  
+**Design Doc:** `docs/design/agent-orchestration.md`
+
+---
+
+### 📋 M7-Federation (0.0.7)
+**Due:** 2026-04-15 | **Status:** Planned
+
+Multi-instance federation for work/personal separation:
+
+| Phase | Issues | Description |
+|-------|--------|-------------|
+| 1 | #84, #85 | Instance identity, CONNECT/DISCONNECT |
+| 2 | #86, #87 | Authentik integration, identity linking |
+| 3 | #88, #89, #90 | QUERY, COMMAND, EVENT protocol |
+| 4 | #91, #92 | Connection manager UI, aggregated dashboard |
+| 5 | #93, #94 | Agent federation, spoke configuration |
+| 6 | — | Enterprise features |
+
+**EPIC:** #83  
+**Design Doc:** `docs/design/federation-architecture.md`
+
+---
+
+### 🎯 M5-Migration (0.1.0 MVP)
+**Due:** 2026-04-01 | **Status:** Planned
+
+Production readiness and migration from jarvis-brain:
+
+| Issue | Title | Priority |
+|-------|-------|----------|
+| #30 | Migration scripts from jarvis-brain | P0 |
+| #31 | Data validation and integrity checks | P0 |
+| #32 | Parallel operation testing | P1 |
+| #33 | Performance optimization | P1 |
+| #34 | Documentation (SETUP.md, CONFIGURATION.md) | P1 |
+| #35 | Docker Compose customization guide | P1 |
+
+---
+
+## Parallel Execution Strategy
+
+Work streams that can run in parallel:
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         PARALLEL WORK STREAMS                           │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  Stream A: Core Features (M3)                                           │
+│  ├── Gantt, Kanban, WebSocket, Domains                                 │
+│  └── Can proceed independently                                          │
+│                                                                         │
+│  Stream B: Agent Skills (M4)                                            │
+│  ├── Brain API, plugin-brain, plugin-calendar, plugin-tasks            │
+│  └── Depends on: Core APIs from M3                                      │
+│                                                                         │
+│  Stream C: Knowledge Module (M5-Knowledge)                              │
+│  ├── Wiki linking, search, graph viz                                    │
+│  └── Independent module, can parallel with all                          │
+│                                                                         │
+│  Stream D: Agent Orchestration (M6)                                     │
+│  ├── Task schema, Valkey, Coordinator                                   │
+│  └── Depends on: Base agent model (exists)                              │
+│                                                                         │
+│  Stream E: Federation (M7)                                              │
+│  ├── Instance identity, protocol, Authentik                             │
+│  └── Depends on: RLS (done), Agent Orchestration (for agent federation) │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**Recommended parallelization:**
+
+| Sprint | Stream A | Stream B | Stream C | Stream D | Stream E |
+|--------|----------|----------|----------|----------|----------|
+| Feb W1-2 | M3 P0 | — | KNOW Phase 2 | ORCH #96, #97 | — |
+| Feb W3-4 | M3 P1 | M4 P0 | KNOW Phase 2 | ORCH #98, #99 | FED #84, #85 |
+| Mar W1-2 | M3 finish | M4 P1 | KNOW Phase 3 | ORCH #102 | FED #86, #87 |
+| Mar W3-4 | — | M4 finish | KNOW Phase 4 | ORCH #100 | FED #88, #89 |
+| Apr W1-2 | MVP prep | — | KNOW Phase 5 | ORCH #101 | FED #91, #92 |
+| Apr W3-4 | **0.1.0 MVP** | — | — | — | FED #93, #94 |
+
+---
+
+## Dependencies Graph
+
+```
+                    ┌─────────────────┐
+                    │  M2-MultiTenant │
+                    │     (DONE)      │
+                    └────────┬────────┘
+                             │
+          ┌──────────────────┼──────────────────┐
+          │                  │                  │
+          ▼                  ▼                  ▼
+   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
+   │ M3-Features │    │ M5-Knowledge│    │ M6-Orchestr │
+   └──────┬──────┘    └─────────────┘    └──────┬──────┘
+          │                                     │
+          ▼                                     │
+   ┌─────────────┐                              │
+   │ M4-MoltBot  │                              │
+   └──────┬──────┘                              │
+          │                                     │
+          │           ┌─────────────────────────┘
+          │           │
+          ▼           ▼
+   ┌─────────────────────────┐
+   │     M7-Federation       │
+   │  (Agent Federation      │
+   │   depends on M6)        │
+   └───────────┬─────────────┘
+               │
+               ▼
+   ┌─────────────────────────┐
+   │   M5-Migration (MVP)    │
+   │       0.1.0             │
+   └─────────────────────────┘
+```
+
+---
+
+## Issue Labels
+
+| Label | Meaning |
+|-------|---------|
+| `p0` | Critical path, must complete |
+| `p1` | Important, should complete |
+| `p2` | Nice to have |
+| `phase-N` | Implementation phase within milestone |
+| `api` | Backend API work |
+| `frontend` | Web UI work |
+| `database` | Schema/migration work |
+| `orchestration` | Agent orchestration related |
+| `federation` | Federation related |
+| `knowledge-module` | Knowledge module related |
+
+---
+
+## How to Use This Roadmap
+
+1. **Check milestones** for high-level progress
+2. **Check issues** for detailed task status
+3. **Use labels** to filter by priority or area
+4. **Dependencies** show what can be parallelized
+5. **Design docs** provide implementation details
+
+**Quick links:**
+- [All Open Issues](https://git.mosaicstack.dev/mosaic/stack/issues?state=open)
+- [Milestones](https://git.mosaicstack.dev/mosaic/stack/milestones)
+- [Design Docs](./design/)
+
+---
+
+## Changelog
+
+| Date | Change |
+|------|--------|
+| 2026-01-29 | Added M6-AgentOrchestration, M7-Federation milestones and issues |
+| 2026-01-29 | Created unified roadmap document |
+| 2026-01-28 | M2-MultiTenant completed |