From 9e06e977bed7df9f82508a0bcba9bbb519ed588a Mon Sep 17 00:00:00 2001
From: Jason Woltje <jason.woltje@uscllc.com>
Date: Mon, 2 Feb 2026 13:14:36 -0600
Subject: [PATCH] refactor(orchestrator): Convert from Fastify to NestJS

- Replace Fastify with NestJS framework
- Add @nestjs/core, @nestjs/common, @nestjs/config, @nestjs/platform-express
- Add @nestjs/bullmq for queue management (replaced bull with bullmq)
- Update dependencies to match other monorepo apps (v11.x)
- Create module structure:
  - spawner.module.ts (agent spawning)
  - queue.module.ts (task queue management)
  - monitor.module.ts (agent health monitoring)
  - git.module.ts (git workflow automation)
  - killswitch.module.ts (emergency stop)
  - coordinator.module.ts (coordinator integration)
  - valkey.module.ts (Valkey client management)
- Health check controller implemented (GET /health, GET /health/ready)
- Configuration service with environment validation
- nest-cli.json for NestJS tooling
- eslint.config.js for NestJS linting
- Update tsconfig.json for CommonJS (NestJS requirement)
- Remove "type": "module" from package.json
- Update README.md with NestJS architecture and commands
- Update .env.example with all required variables

Architecture matches existing monorepo apps (api, coordinator use NestJS patterns).
All modules are currently empty stubs ready for future implementation.

Tested:
- Build succeeds: pnpm build
- Lint passes: pnpm lint
- Server starts: node dist/main.js
- Health endpoints work: GET /health, GET /health/ready

Issue: Part of orchestrator foundation setup

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>