[ORCH-102] Create NestJS server with health checks #203

Closed
opened 2026-02-02 18:58:24 +00:00 by jason.woltje · 0 comments
Owner

Basic HTTP server for orchestrator API using NestJS framework with health check endpoints.

Acceptance Criteria

  • NestJS application bootstrapped in src/main.ts
  • App module created in src/app.module.ts
  • Health check controller: src/api/health/health.controller.ts
  • GET /health endpoint (returns 200 OK with service status)
  • GET /health/ready endpoint (checks dependencies)
  • Configuration loaded via @nestjs/config
  • Logger configured (NestJS built-in logger)
  • Server starts on port 3001 (configurable via ORCHESTRATOR_PORT)
  • Graceful shutdown handler

Dependencies

  • Blocked by: #ORCH-101

Technical Notes

// Health Check Response
GET /health
Response 200 OK:
{
  "status": "ok",
  "service": "orchestrator",
  "version": "0.0.6",
  "timestamp": "2026-02-02T10:00:00Z"
}

GET /health/ready
Response 200 OK:
{
  "ready": true
}

Uses NestJS @Controller and @Get decorators for route handlers.

Basic HTTP server for orchestrator API using NestJS framework with health check endpoints. ## Acceptance Criteria - [ ] NestJS application bootstrapped in `src/main.ts` - [ ] App module created in `src/app.module.ts` - [ ] Health check controller: `src/api/health/health.controller.ts` - [ ] GET /health endpoint (returns 200 OK with service status) - [ ] GET /health/ready endpoint (checks dependencies) - [ ] Configuration loaded via @nestjs/config - [ ] Logger configured (NestJS built-in logger) - [ ] Server starts on port 3001 (configurable via ORCHESTRATOR_PORT) - [ ] Graceful shutdown handler ## Dependencies - Blocked by: #ORCH-101 ## Technical Notes ```typescript // Health Check Response GET /health Response 200 OK: { "status": "ok", "service": "orchestrator", "version": "0.0.6", "timestamp": "2026-02-02T10:00:00Z" } GET /health/ready Response 200 OK: { "ready": true } ``` Uses NestJS @Controller and @Get decorators for route handlers.
jason.woltje added this to the M6-AgentOrchestration (0.0.6) milestone 2026-02-02 18:58:24 +00:00
jason.woltje added the orchestratorapiapi labels 2026-02-02 18:58:24 +00:00
jason.woltje changed title from [ORCH-102] Create Fastify server with health checks to [ORCH-102] Create NestJS server with health checks 2026-02-02 20:14:21 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaic/stack#203