Files
stack/CHANGELOG.md
Jason Woltje 12abdfe81d feat(#93): implement agent spawn via federation
Implements FED-010: Agent Spawn via Federation feature that enables
spawning and managing Claude agents on remote federated Mosaic Stack
instances via COMMAND message type.

Features:
- Federation agent command types (spawn, status, kill)
- FederationAgentService for handling agent operations
- Integration with orchestrator's agent spawner/lifecycle services
- API endpoints for spawning, querying status, and killing agents
- Full command routing through federation COMMAND infrastructure
- Comprehensive test coverage (12/12 tests passing)

Architecture:
- Hub → Spoke: Spawn agents on remote instances
- Command flow: FederationController → FederationAgentService →
  CommandService → Remote Orchestrator
- Response handling: Remote orchestrator returns agent status/results
- Security: Connection validation, signature verification

Files created:
- apps/api/src/federation/types/federation-agent.types.ts
- apps/api/src/federation/federation-agent.service.ts
- apps/api/src/federation/federation-agent.service.spec.ts

Files modified:
- apps/api/src/federation/command.service.ts (agent command routing)
- apps/api/src/federation/federation.controller.ts (agent endpoints)
- apps/api/src/federation/federation.module.ts (service registration)
- apps/orchestrator/src/api/agents/agents.controller.ts (status endpoint)
- apps/orchestrator/src/api/agents/agents.module.ts (lifecycle integration)

Testing:
- 12/12 tests passing for FederationAgentService
- All command service tests passing
- TypeScript compilation successful
- Linting passed

Refs #93

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 14:37:06 -06:00

3.2 KiB

Changelog

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

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.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