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>

packages/skills/gantt/examples/critical-path.ts

@@ -1,58 +1,58 @@
 /**
  * Example: Calculate and display critical path for a project
- * 
+ *
  * Usage:
  *   npx tsx examples/critical-path.ts <project-id>
  */
 
-import { createGanttClientFromEnv } from '../index.js';
+import { createGanttClientFromEnv } from "../index.js";
 
 async function main(): Promise<void> {
   const projectId = process.argv[2];
-  
+
   if (!projectId) {
-    console.error('Usage: npx tsx examples/critical-path.ts <project-id>');
+    console.error("Usage: npx tsx examples/critical-path.ts <project-id>");
     process.exit(1);
   }
 
   const client = createGanttClientFromEnv();
-  
+
   console.log(`Calculating critical path for project ${projectId}...\n`);
-  
+
   const criticalPath = await client.calculateCriticalPath(projectId);
-  
+
   console.log(`Critical Path (${criticalPath.totalDuration} days):`);
-  console.log('='.repeat(50));
-  
+  console.log("=".repeat(50));
+
   for (const item of criticalPath.path) {
-    const statusIcon = item.task.status === 'COMPLETED' ? '✓' : 
-                      item.task.status === 'IN_PROGRESS' ? '⊙' : '□';
+    const statusIcon =
+      item.task.status === "COMPLETED" ? "✓" : item.task.status === "IN_PROGRESS" ? "⊙" : "□";
     console.log(`${statusIcon} ${item.task.title}`);
     console.log(`   Duration: ${item.duration} days`);
     console.log(`   Cumulative: ${item.cumulativeDuration} days`);
     console.log(`   Status: ${item.task.status}`);
-    
+
     if (item.task.metadata.dependencies && item.task.metadata.dependencies.length > 0) {
       console.log(`   Depends on: ${item.task.metadata.dependencies.length} task(s)`);
     }
-    
-    console.log('');
+
+    console.log("");
   }
-  
+
   if (criticalPath.nonCriticalTasks.length > 0) {
-    console.log('\nNon-Critical Tasks (can be delayed):');
-    console.log('='.repeat(50));
-    
+    console.log("\nNon-Critical Tasks (can be delayed):");
+    console.log("=".repeat(50));
+
     for (const item of criticalPath.nonCriticalTasks.sort((a, b) => a.slack - b.slack)) {
       console.log(`- ${item.task.title}`);
       console.log(`  Slack: ${item.slack} days`);
       console.log(`  Status: ${item.task.status}`);
-      console.log('');
+      console.log("");
     }
   }
 }
 
-main().catch(error => {
-  console.error('Error:', error.message);
+main().catch((error) => {
+  console.error("Error:", error.message);
   process.exit(1);
 });

packages/skills/gantt/examples/query-timeline.ts

@@ -1,69 +1,73 @@
 /**
  * Example: Query project timeline and display statistics
- * 
+ *
  * Usage:
  *   npx tsx examples/query-timeline.ts <project-id>
  */
 
-import { createGanttClientFromEnv } from '../index.js';
+import { createGanttClientFromEnv } from "../index.js";
 
 async function main(): Promise<void> {
   const projectId = process.argv[2];
-  
+
   if (!projectId) {
-    console.error('Usage: npx tsx examples/query-timeline.ts <project-id>');
+    console.error("Usage: npx tsx examples/query-timeline.ts <project-id>");
     process.exit(1);
   }
 
   const client = createGanttClientFromEnv();
-  
+
   console.log(`Fetching timeline for project ${projectId}...\n`);
-  
+
   const timeline = await client.getProjectTimeline(projectId);
-  
+
   console.log(`Project: ${timeline.project.name}`);
   console.log(`Status: ${timeline.project.status}`);
-  
+
   if (timeline.project.startDate && timeline.project.endDate) {
     console.log(`Timeline: ${timeline.project.startDate} → ${timeline.project.endDate}`);
   }
-  
+
   console.log(`\nTasks (${timeline.stats.total} total):`);
   console.log(`  ✓ Completed: ${timeline.stats.completed}`);
   console.log(`  ⊙ In Progress: ${timeline.stats.inProgress}`);
   console.log(`  □ Not Started: ${timeline.stats.notStarted}`);
   console.log(`  ⏸ Paused: ${timeline.stats.paused}`);
   console.log(`  ⚠ Target passed: ${timeline.stats.targetPassed}`);
-  
-  console.log('\nTask List:');
-  
+
+  console.log("\nTask List:");
+
   const statusIcon = (status: string): string => {
     switch (status) {
-      case 'COMPLETED': return '✓';
-      case 'IN_PROGRESS': return '⊙';
-      case 'PAUSED': return '⏸';
-      case 'ARCHIVED': return '📦';
-      default: return '□';
+      case "COMPLETED":
+        return "✓";
+      case "IN_PROGRESS":
+        return "⊙";
+      case "PAUSED":
+        return "⏸";
+      case "ARCHIVED":
+        return "📦";
+      default:
+        return "□";
     }
   };
-  
+
   const now = new Date();
-  
+
   for (const task of timeline.tasks) {
     const icon = statusIcon(task.status);
-    const dueInfo = task.dueDate
-      ? ` Due: ${task.dueDate}`
-      : '';
-    
-    const targetPassed = task.dueDate && new Date(task.dueDate) < now && task.status !== 'COMPLETED'
-      ? ' (target passed)'
-      : '';
-    
+    const dueInfo = task.dueDate ? ` Due: ${task.dueDate}` : "";
+
+    const targetPassed =
+      task.dueDate && new Date(task.dueDate) < now && task.status !== "COMPLETED"
+        ? " (target passed)"
+        : "";
+
     console.log(`${icon} ${task.title} [${task.status}]${dueInfo}${targetPassed}`);
   }
 }
 
-main().catch(error => {
-  console.error('Error:', error.message);
+main().catch((error) => {
+  console.error("Error:", error.message);
   process.exit(1);
 });