# Changelog

All notable changes to Mosaic Stack will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- Complete turnkey Docker Compose setup with all services (#8)
  - PostgreSQL 17 with pgvector extension
  - Valkey (Redis-compatible cache)
  - Authentik OIDC provider (optional profile)
  - Ollama AI service (optional profile)
  - Multi-stage Dockerfiles for API and Web apps
  - Health checks for all services
  - Service dependency ordering
  - Network isolation (internal and public networks)
  - Named volumes for data persistence
  - Docker Compose profiles for optional services
- Traefik reverse proxy integration (#36)
  - Bundled mode: Self-contained Traefik instance with automatic service discovery
  - Upstream mode: Connect to external Traefik instances
  - None mode: Direct port exposure without reverse proxy
  - Automatic SSL/TLS support (Let's Encrypt or self-signed)
  - Traefik dashboard for monitoring routes and services
  - Flexible domain configuration via environment variables
  - Integration tests for all three deployment modes
  - Comprehensive deployment guide with production examples
- Comprehensive environment configuration
  - Updated .env.example with all Docker variables
  - PostgreSQL performance tuning options
  - Valkey memory management settings
  - Authentik bootstrap configuration
- Docker deployment documentation
  - Complete deployment guide
  - Docker-specific configuration guide
  - Updated installation instructions
  - Troubleshooting section
  - Production deployment considerations
- Integration testing for Docker stack
  - Service health check tests
  - Connectivity validation
  - Volume and network verification
  - Service dependency tests
- Docker helper scripts
  - Smoke test script for deployment validation
  - Makefile for common operations
  - npm scripts for Docker commands
- docker-compose.override.yml.example template for customization
- Environment templates for Traefik deployment modes
  - .env.traefik-bundled.example for bundled mode
  - .env.traefik-upstream.example for upstream mode

### Changed

- Updated README.md with Docker deployment instructions
- Enhanced configuration documentation with Docker-specific settings
- Improved installation guide with profile-based service activation
- Updated Makefile with Traefik deployment shortcuts
- Enhanced docker-compose.override.yml.example with Traefik examples

## [0.0.23] - 2026-03-07

### Added

- **Mission Control Dashboard** — real-time agent orchestration UI at `/mission-control`
  - Live SSE message streams per agent (`OrchestratorPanel`)
  - Barge-in input with optional pause-before-send
  - Pause / Resume / Graceful Kill / Force Kill controls per agent panel
  - Global agent roster sidebar with tree view and per-agent kill
  - KillAllDialog with scope selector (requires typing `KILL ALL` to confirm)
  - AuditLogDrawer with paginated operator action history
  - Responsive panel grid: up to 6 panels, add/remove, full-screen expand
- **Agent Provider Interface** — extensible `IAgentProvider` plugin system
  - `InternalAgentProvider` wrapping existing orchestrator services
  - `AgentProviderRegistry` aggregating sessions across providers
  - `AgentProviderConfig` CRUD API (`/api/agent-providers`)
  - Mission Control proxy API (`/api/mission-control/*`) with SSE proxying and audit log
- **OpenClaw Provider Adapter** — connect external OpenClaw instances
  - `OpenClawProvider` implementing `IAgentProvider` against OpenClaw REST API
  - Dedicated `OpenClawSseBridge` with retry logic (5 retries, 2s backoff)
  - Provider config UI in Settings for registering OpenClaw gateways
  - Tokens encrypted at rest via `EncryptionService` (AES-256-GCM)
- **OperatorAuditLog** — every inject/pause/resume/kill persisted to DB

### Changed

- Orchestrator app: extended with `AgentsModule` exports for provider registry
- Settings navigation: added "Agent Providers" section

### Fixed

- Flaky web tests: async query timing in Kanban and OnboardingWizard tests

## [0.0.1] - 2026-01-28

### Added

- Initial project structure with pnpm workspaces and TurboRepo
- NestJS API application with BetterAuth integration
- Next.js 16 web application foundation
- PostgreSQL 17 database with pgvector extension
- Prisma ORM with comprehensive schema
- Authentik OIDC authentication integration
- Activity logging system
- Authentication module with OIDC support
- Database seeding scripts
- Comprehensive test suite with 85%+ coverage
- Documentation structure (Bookstack-compatible hierarchy)
- Development workflow and coding standards

[Unreleased]: https://git.mosaicstack.dev/mosaic/stack/compare/v0.0.23...HEAD
[0.0.23]: https://git.mosaicstack.dev/mosaic/stack/releases/tag/v0.0.23
[0.0.1]: https://git.mosaicstack.dev/mosaic/stack/releases/tag/v0.0.1