CLAUDE.md

1# Supervisor
2 
3Node.js app that manages task execution containers. Receives work from the platform, starts Docker/Kubernetes containers, monitors execution, and reports results.
4 
5## Key Directories
6 
7- `src/services/` - Core service logic
8- `src/workloadManager/` - Container orchestration abstraction (Docker or Kubernetes)
9- `src/workloadServer/` - HTTP server for workload communication (heartbeats, snapshots)
10- `src/clients/` - Platform communication (webapp)
11- `src/env.ts` - Environment configuration
12 
13## Architecture
14 
15- **WorkloadManager**: Abstracts Docker vs Kubernetes execution
16- **SupervisorSession**: Manages the dequeue loop with EWMA-based dynamic scaling
17- **ResourceMonitor**: Tracks CPU/memory during execution
18- **PodCleaner/FailedPodHandler**: Kubernetes-specific cleanup
19 
20Communicates with the platform via Socket.io and HTTP. Receives task assignments through the dequeue protocol from the webapp.
21