Implements #9, #10 - Team model with workspace membership - TeamMember model with role-based access (OWNER, ADMIN, MEMBER) - Row-Level Security policies for tenant isolation on 19 tables - Helper functions: current_user_id(), is_workspace_member(), is_workspace_admin() - Developer utilities in src/lib/db-context.ts for easy RLS integration - Comprehensive documentation in docs/design/multi-tenant-rls.md Database migrations: - 20260129220941_add_team_model: Adds Team and TeamMember tables - 20260129221004_add_rls_policies: Enables RLS and creates policies Security features: - Complete database-level tenant isolation - Automatic query filtering based on workspace membership - Defense-in-depth security with application and database layers - Performance-optimized with indexes on workspace_id
Design Documents
Technical design documents for major Mosaic Stack features.
Purpose
Design documents serve as:
- Blueprints for implementation
- Reference for architectural decisions
- Communication between team members
- Historical record of design evolution
Document Structure
Each design document should include:
- Problem Statement — What are we solving?
- Architecture Overview — High-level design with diagrams
- Database Schema — Tables, indexes, relationships
- API Specifications — Endpoints, request/response formats
- Implementation Plan — Phased rollout with milestones
- Security & Performance — Considerations and constraints
Documents
Agent Orchestration Layer
Status: Design Phase
Version: 1.0
Date: 2025-01-29
Infrastructure for persistent task management and autonomous agent coordination. Enables long-running background work independent of user sessions.
Key Features:
- Task queue with priority scheduling
- Agent health monitoring and automatic recovery
- Checkpoint-based resumption for interrupted work
- Multi-workspace coordination with row-level security
Knowledge Module
Status: Design Phase
Version: 1.0
Date: 2025-01-29
Issues: Implementation Tracker
Native knowledge management with wiki-style linking, semantic search, and graph visualization. Enables teams and agents to capture, connect, and query organizational knowledge.
Key Features:
- Wiki-style
[[links]]between entries - Full-text and semantic (vector) search
- Interactive knowledge graph visualization
- Version history with diff view
- Tag-based organization
Contributing
When creating a new design document:
- Copy the structure from an existing document
- Use ASCII diagrams for architecture (keep them simple)
- Include code examples in TypeScript
- Specify database schema in SQL (PostgreSQL dialect)
- Add implementation phases with clear milestones
- Update this README with a summary
Last Updated: 2025-01-29