# openspec/changes/archive/2026-05-22-instance-health-monitoring
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring

index: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md

## role
OpenSpec specification package defining architectural improvements for container instance health monitoring and auto-recovery in a tunnel service system
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for improving container instance health monitoring by distinguishing container health from tunnel health and integrating readiness probes into startup flow | dep: Docker, docker compose, cloudflared, Docker API, HTTP/tunnel networking, ToolType model
- proposal.md | Proposes architectural improvements to instance health monitoring, startup verification, and auto-recovery for a container-based tunnel service | dep: Docker, docker compose, Docker API, React/TypeScript frontend, REST API
- tasks.md | Project task checklist tracking backend and frontend implementation for container startup verification, readiness probes, health checks, tunnel recovery, and status display | dep: Docker, Docker Compose, Python (FastAPI), TypeScript/React, curl, ruff, mypy, tsc
## arch
Specification-driven design using OpenSpec schema with phased implementation tracking (proposal → design → tasks), separating container health from tunnel health concerns and integrating Kubernetes-style readiness probes into startup flow
## tags
health, container, design, tunnel, startup, docker, docker compose, .openspec
## symbols
-
## workflows
-
## dirty
-