Skip to main content

Feature Pack 004: Containerized Compose Runtime

linux/mac support windows support

Status: Implemented (pending release validation/tag)

This pack defines the next state after 003-agentic-harness-foundation.

Primary intent:

  • move from process-based local runtime to Docker/Docker Compose orchestration,
  • use NGINX as the containerized ingress layer for browser/API/WebSocket entry,
  • preserve approved functional behavior,
  • document runtime NFR changes explicitly in spec artifacts.

Implemented architecture artifacts:

  • system/architecture.model.json + generated system/architecture.md
  • system/runtime-topology.md
  • system/docker-compose.spec.yaml
  • scripts/start-state-004-containerized-generated.sh
  • scripts/test-state-004-containerized.sh
  • tests/smoke/README.md

Runtime lifecycle:

  • default build + start: ./scripts/start-state-004-containerized-generated.sh
  • restart without image rebuild: ./scripts/start-state-004-containerized-generated.sh --skip-build
  • PowerShell equivalent is planned for Phase 2: ./scripts/start-state-004-containerized-generated.ps1