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

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

## role
Design and planning package for a container health monitoring and tunnel recovery system that prevents false-positive tunnel recreations by distinguishing container health from tunnel health.
## 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
Specification-driven design using OpenSpec schema definitions, with phased implementation tracked through task-based project management (design → proposal → tasks), employing readiness probes and smart auto-recovery patterns for container-based tunnel services.
## tags
health, tunnel, design, container, docker, docker compose, tasks, .openspec
## symbols
-
## workflows
-
## dirty
-