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>

README.md

@@ -19,19 +19,19 @@ Mosaic Stack is a modern, PDA-friendly platform designed to help users manage th
 
 ## Technology Stack
 
-| Layer | Technology |
-|-------|------------|
-| **Frontend** | Next.js 16 + React + TailwindCSS + Shadcn/ui |
-| **Backend** | NestJS + Prisma ORM |
-| **Database** | PostgreSQL 17 + pgvector |
-| **Cache** | Valkey (Redis-compatible) |
-| **Auth** | Authentik (OIDC) via BetterAuth |
-| **AI** | Ollama (local or remote) |
-| **Messaging** | MoltBot (stock + plugins) |
-| **Real-time** | WebSockets (Socket.io) |
-| **Monorepo** | pnpm workspaces + TurboRepo |
-| **Testing** | Vitest + Playwright |
-| **Deployment** | Docker + docker-compose |
+| Layer          | Technology                                   |
+| -------------- | -------------------------------------------- |
+| **Frontend**   | Next.js 16 + React + TailwindCSS + Shadcn/ui |
+| **Backend**    | NestJS + Prisma ORM                          |
+| **Database**   | PostgreSQL 17 + pgvector                     |
+| **Cache**      | Valkey (Redis-compatible)                    |
+| **Auth**       | Authentik (OIDC) via BetterAuth              |
+| **AI**         | Ollama (local or remote)                     |
+| **Messaging**  | MoltBot (stock + plugins)                    |
+| **Real-time**  | WebSockets (Socket.io)                       |
+| **Monorepo**   | pnpm workspaces + TurboRepo                  |
+| **Testing**    | Vitest + Playwright                          |
+| **Deployment** | Docker + docker-compose                      |
 
 ## Quick Start
 
@@ -105,6 +105,7 @@ docker compose down
 ```
 
 **What's included:**
+
 - PostgreSQL 17 with pgvector extension
 - Valkey (Redis-compatible cache)
 - Mosaic API (NestJS)
@@ -204,6 +205,7 @@ The **Knowledge Module** is a powerful personal wiki and knowledge management sy
 ### Quick Examples
 
 **Create an entry:**
+
 ```bash
 curl -X POST http://localhost:3001/api/knowledge/entries \
   -H "Authorization: Bearer YOUR_TOKEN" \
@@ -217,6 +219,7 @@ curl -X POST http://localhost:3001/api/knowledge/entries \
 ```
 
 **Search entries:**
+
 ```bash
 curl -X GET 'http://localhost:3001/api/knowledge/search?q=react+hooks' \
   -H "Authorization: Bearer YOUR_TOKEN" \
@@ -224,6 +227,7 @@ curl -X GET 'http://localhost:3001/api/knowledge/search?q=react+hooks' \
 ```
 
 **Export knowledge base:**
+
 ```bash
 curl -X GET 'http://localhost:3001/api/knowledge/export?format=markdown' \
   -H "Authorization: Bearer YOUR_TOKEN" \
@@ -241,6 +245,7 @@ curl -X GET 'http://localhost:3001/api/knowledge/export?format=markdown' \
 
 **Wiki-links**
 Connect entries using double-bracket syntax:
+
 ```markdown
 See [[Entry Title]] or [[entry-slug]] for details.
 Use [[Page|custom text]] for custom display text.
@@ -248,6 +253,7 @@ Use [[Page|custom text]] for custom display text.
 
 **Version History**
 Every edit creates a new version. View history, compare changes, and restore previous versions:
+
 ```bash
 # List versions
 GET /api/knowledge/entries/:slug/versions
@@ -261,12 +267,14 @@ POST /api/knowledge/entries/:slug/restore/:version
 
 **Backlinks**
 Automatically discover entries that link to a given entry:
+
 ```bash
 GET /api/knowledge/entries/:slug/backlinks
 ```
 
 **Tags**
 Organize entries with tags:
+
 ```bash
 # Create tag
 POST /api/knowledge/tags
@@ -279,12 +287,14 @@ GET /api/knowledge/search/by-tags?tags=react,frontend
 ### Performance
 
 With Valkey caching enabled:
+
 - **Entry retrieval:** ~2-5ms (vs ~50ms uncached)
 - **Search queries:** ~2-5ms (vs ~200ms uncached)
 - **Graph traversals:** ~2-5ms (vs ~400ms uncached)
 - **Cache hit rates:** 70-90% for active workspaces
 
 Configure caching via environment variables:
+
 ```bash
 VALKEY_URL=redis://localhost:6379
 KNOWLEDGE_CACHE_ENABLED=true
@@ -342,14 +352,14 @@ Mosaic Stack follows strict **PDA-friendly design principles**:
 
 We **never** use demanding or stressful language:
 
-| ❌ NEVER | ✅ ALWAYS |
-|----------|-----------|
-| OVERDUE | Target passed |
-| URGENT | Approaching target |
-| MUST DO | Scheduled for |
-| CRITICAL | High priority |
+| ❌ NEVER    | ✅ ALWAYS            |
+| ----------- | -------------------- |
+| OVERDUE     | Target passed        |
+| URGENT      | Approaching target   |
+| MUST DO     | Scheduled for        |
+| CRITICAL    | High priority        |
 | YOU NEED TO | Consider / Option to |
-| REQUIRED | Recommended |
+| REQUIRED    | Recommended          |
 
 ### Visual Principles
 
@@ -456,6 +466,7 @@ POST /api/knowledge/cache/stats/reset
 ```
 
 **Example response:**
+
 ```json
 {
   "enabled": true,