diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md new file mode 100644 index 0000000..27e7d7b --- /dev/null +++ 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 |