mosaic/stack
1
0
Fork 0
Code Issues 10 Pull Requests 1 Actions Packages Projects Releases 2 Wiki Activity

docs: close out MS16+MS17 mission
All checks were successful
ci/woodpecker/push/web Pipeline was successful
Details

Browse Source 
Mark acceptance criteria 14-28 as DONE, add MS16+MS17 to Completed Work
section, update resolved risks/open questions, close issue #469, finalize
manifest and scratchpad with smoke test confirmation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Jason Woltje
2026-02-23 07:26:51 -06:00
parent a7955b9b32
commit dc5ec68e02
6 changed files with 110 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

74
docs/PRD.md
View File

@@ -53,6 +53,22 @@ Dashboard polish, task ingestion pipeline, agent cycle visibility, deploy + smok
- Deployed to Coolify at mosaic.woltje.com, auth working via Authentik
- Release tag v0.1.0
### MS16+MS17-PagesDataIntegration (v0.1.1) — Complete
All pages built + wired to real API data. PRs #470-484 (15 PRs). Issues #466-469.
- Custom 404 pages (global + authenticated route groups)
- Settings root page with 4 category cards
- Tasks, Calendar, Knowledge pages wired to real API (238+ lines mock data removed)
- Projects list page with create/delete dialogs
- Project Workspace page with tabbed view (Tasks, Agent Sessions, Settings)
- Kanban board with drag-and-drop (@hello-pangea/dnd), 5 status columns, optimistic updates
- File Manager page with list/grid views, search, create/delete
- Logs & Telemetry page with auto-refresh, expandable rows, filters
- Profile page with user info and preferences
- All 5125 tests passing, CI pipeline #585 green
- Deployed and smoke-tested at mosaic.woltje.com
## Scope
### In Scope (MS16+MS17 — Pages & Data Integration)
@@ -290,23 +306,23 @@ This is the active mission scope. MS16 (Pages) and MS17 (Backend Integration) ar
12. ~~WebSocket emits for agent job lifecycle~~ DONE
13. ~~Deployed to mosaic.woltje.com with auth working~~ DONE
### MS16+MS17 — Pages & Data Integration
### MS16+MS17 — Pages & Data Integration — COMPLETE
14. All sidebar links navigate to functional pages (no 404s)
15. Projects page: list, create, view project details
16. Workspace page: view single project with tasks and agent sessions
17. Kanban page: drag-and-drop board with task status columns
18. File Manager page: tree/list view with CRUD operations
19. Logs page: log viewer with filtering and auto-refresh
20. Settings root page: category index linking to subpages
21. Custom 404 page for unknown routes
22. `/tasks` page uses real API data (no mock)
23. `/calendar` page uses real API data (no mock)
24. `/knowledge` pages use real API data (no mock)
25. All new pages support light/dark theme
26. All new pages are responsive (sm/md/lg/xl breakpoints)
27. Lint, typecheck, and tests pass
28. Deployed and smoke-tested at mosaic.woltje.com
14. ~~All sidebar links navigate to functional pages (no 404s)~~ DONE
15. ~~Projects page: list, create, view project details~~ DONE
16. ~~Workspace page: view single project with tasks and agent sessions~~ DONE
17. ~~Kanban page: drag-and-drop board with task status columns~~ DONE
18. ~~File Manager page: tree/list view with CRUD operations~~ DONE
19. ~~Logs page: log viewer with filtering and auto-refresh~~ DONE
20. ~~Settings root page: category index linking to subpages~~ DONE
21. ~~Custom 404 page for unknown routes~~ DONE
22. ~~`/tasks` page uses real API data (no mock)~~ DONE
23. ~~`/calendar` page uses real API data (no mock)~~ DONE
24. ~~`/knowledge` pages use real API data (no mock)~~ DONE
25. ~~All new pages support light/dark theme~~ DONE
26. ~~All new pages are responsive (sm/md/lg/xl breakpoints)~~ DONE
27. ~~Lint, typecheck, and tests pass~~ DONE
28. ~~Deployed and smoke-tested at mosaic.woltje.com~~ DONE
### Full Project (All Milestones)
@@ -333,12 +349,12 @@ This is the active mission scope. MS16 (Pages) and MS17 (Backend Integration) ar
## Risks and Open Questions
1. **Risk**: Pages need to match the design system established in MS15. Inconsistency would degrade UX. Mitigation: Use existing design tokens and shared components exclusively.
2. **Risk**: Kanban drag-and-drop adds complexity and potential for state bugs. Mitigation: Use a proven DnD library (dnd-kit or react-beautiful-dnd), test edge cases.
3. **Risk**: Mock data elimination may reveal backend API gaps or mismatches. Mitigation: Audit each API response shape against page needs during implementation.
4. **Open**: Exact task status values for Kanban columns (need to check Prisma schema enum).
5. **Open**: Whether Workspace page should require project selection or show a default view.
6. **Open**: File Manager page — should it be a direct mapping of Knowledge entries or a separate file abstraction?
1. **Risk**: Pages need to match the design system established in MS15. Inconsistency would degrade UX. Mitigation: Use existing design tokens and shared components exclusively. **RESOLVED** — All MS16+MS17 pages use design tokens consistently.
2. **Risk**: Kanban drag-and-drop adds complexity and potential for state bugs. Mitigation: Use a proven DnD library. **RESOLVED** — @hello-pangea/dnd selected (maintained fork of react-beautiful-dnd, better TS support). Optimistic updates with rollback on failure.
3. **Risk**: Mock data elimination may reveal backend API gaps or mismatches. Mitigation: Audit each API response shape against page needs during implementation. **RESOLVED** — All 3 mock-data pages wired successfully. No API gaps found.
4. ~~**Open**: Exact task status values for Kanban columns~~ **RESOLVED** — TaskStatus enum: NOT_STARTED, IN_PROGRESS, PAUSED, COMPLETED, ARCHIVED (5 columns).
5. ~~**Open**: Whether Workspace page should require project selection or show a default view~~ **RESOLVED** — Shows project selector when no project param, workspace detail when ?project=id.
6. ~~**Open**: File Manager page — should it be a direct mapping of Knowledge entries or a separate file abstraction?~~ **RESOLVED** — Direct mapping to Knowledge entries via /api/knowledge. API shape matches file manager needs.
## Existing Backend API Modules (Reference)
@@ -383,13 +399,13 @@ These 19 NestJS modules are already implemented with Prisma and available for fr
| ------------------------------ | ------- | ----------------------------------------------------------------- | ----------- |
| MS15-DashboardShell | 0.0.15 | Design system + app shell + dashboard page | COMPLETE |
| Go-Live MVP | 0.1.0 | Dashboard polish, ingestion, agent visibility, deploy | COMPLETE |
| MS16+MS17-PagesDataIntegration | 0.2.0 | All pages built + wired to real API data | COMPLETE |
| MS18-ThemeWidgets | 0.3.0 | Theme package system, widget registry, dashboard customization | NOT STARTED |
| MS19-ChatTerminal | 0.4.0 | Global terminal, project chat, master chat session | NOT STARTED |
| MS20-MultiTenant | 0.5.0 | Multi-tenant, teams, RBAC, RLS enforcement, break-glass auth | NOT STARTED |
| MS21-Federation | 0.6.0 | Federation (M-M, M-S), 3 instances, key exchange, data separation | NOT STARTED |
| MS22-AgentTelemetry | 0.7.0 | Agent task mapping, telemetry, wide-event logging | NOT STARTED |
| MS23-Testing | 0.8.0 | Playwright E2E, federation tests, documentation finalization | NOT STARTED |
| MS16+MS17-PagesDataIntegration | 0.1.1 | All pages built + wired to real API data | COMPLETE |
| MS18-ThemeWidgets | 0.1.x | Theme package system, widget registry, dashboard customization | NOT STARTED |
| MS19-ChatTerminal | 0.1.x | Global terminal, project chat, master chat session | NOT STARTED |
| MS20-MultiTenant | 0.2.0 | Multi-tenant, teams, RBAC, RLS enforcement, break-glass auth | NOT STARTED |
| MS21-Federation | 0.2.x | Federation (M-M, M-S), 3 instances, key exchange, data separation | NOT STARTED |
| MS22-AgentTelemetry | 0.2.x | Agent task mapping, telemetry, wide-event logging | NOT STARTED |
| MS23-Testing | 0.2.x | Playwright E2E, federation tests, documentation finalization | NOT STARTED |
## Assumptions