# 2026-05-22-instance-health-monitoring
dir: 2026-05-22-instance-health-monitoring

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

## role
Design and planning package for improving instance health monitoring in a container-based tunnel service, covering architecture proposals, implementation tasks, and OpenSpec configuration.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for improving instance health monitoring by distinguishing container health from tunnel health, integrating readiness probes, and preventing false-positive tunnel recreation | dep: Docker, Docker Compose, cloudflared, Docker API, Python, JSON, HTTP/REST API, WebSocket (mentioned as non-goal), database (tool_types table)
- 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/Next.js (frontend), Python API backend
- tasks.md | Tracks completed backend and frontend tasks for implementing container startup verification, readiness probes, health checks, smart tunnel recovery, and status display UI | dep: Docker, docker compose, curl, ruff, mypy, tsc, FastAPI/Flask (implied by api/tool_instances.py), React/Vue (implied by frontend components)
## arch
Documentation-driven design with structured specifications (OpenSpec YAML), phased architectural proposals (design/proposal docs), and task-tracked implementation covering health check separation, readiness probes, and smart auto-recovery patterns.
## tags
health, tunnel, design, container, docker, docker compose, tasks, .openspec
## symbols
-
## workflows
-
## dirty
-
