chore: track all project map and index files
Add generated .pi-map.md and .pi-map.index.md files across the repository so the project navigation maps are shared and versioned. These artifacts are maintained by project_map_init/patch/validate and must be kept in sync with source edits. Note: .cache/ remains ignored (added in previous commit).
This commit is contained in:
Developer
@@ -0,0 +1,24 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring
|
||||
|
||||
## role
|
||||
Defines an archived specification for improving instance health monitoring in a container-based tunnel service by separating container and tunnel health concerns with readiness probes and smart recovery.
|
||||
## parent
|
||||
index: openspec/changes/archive/.pi-map.index.md
|
||||
map: openspec/changes/archive/.pi-map.md
|
||||
## children
|
||||
- openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## files
|
||||
- .openspec.yaml
|
||||
- design.md
|
||||
- proposal.md
|
||||
- tasks.md
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,22 @@
|
||||
# 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
|
||||
Defines an archived specification for improving instance health monitoring in a container-based tunnel service by separating container and tunnel health concerns with readiness probes and smart recovery.
|
||||
## 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 architecture using OpenSpec metadata with design/proposal/task documents following a structured change-management pattern for incremental feature delivery.
|
||||
## tags
|
||||
health, tunnel, design, container, docker, docker compose, tasks, .openspec
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,32 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
|
||||
|
||||
## role
|
||||
Contains archived specification documents for instance health monitoring features from a 2026-05-22 change cycle.
|
||||
## parent
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md
|
||||
## children
|
||||
- openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md
|
||||
- openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md
|
||||
- openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md
|
||||
- openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md
|
||||
- openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md
|
||||
## files
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,18 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
|
||||
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Contains archived specification documents for instance health monitoring features from a 2026-05-22 change cycle.
|
||||
## files
|
||||
## arch
|
||||
Flat directory structure storing dated, versioned specification archives with no active code or architectural patterns.
|
||||
## tags
|
||||
-
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health
|
||||
|
||||
## role
|
||||
Defines the specification for instance runtime health monitoring in a container/instance management system
|
||||
## parent
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health
|
||||
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the specification for instance runtime health monitoring in a container/instance management system
|
||||
## files
|
||||
- spec.md | Specification document defining health monitoring, polling, and container state synchronization requirements for a container/instance management system | dep: Docker, HTTP tunneling, REST API
|
||||
## arch
|
||||
Specification-driven design with requirements for polling-based health checks, state synchronization, and container lifecycle management
|
||||
## tags
|
||||
container, spec, specification, document, defining, health, monitoring, polling
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health
|
||||
|
||||
## role
|
||||
Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose
|
||||
## parent
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health
|
||||
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose
|
||||
## files
|
||||
- spec.md | Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose | dep: docker compose, docker ps, readiness probes, tunnels, health endpoints, database
|
||||
## arch
|
||||
Specification-driven architecture using markdown-based requirements documentation with Docker Compose integration patterns for health monitoring and startup lifecycle management
|
||||
## tags
|
||||
spec, defines, requirements, container, startup, verification, readiness, probe
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
|
||||
|
||||
## role
|
||||
Defines the specification for integrating Kubernetes-style readiness probes into instance startup health monitoring to determine when containers are ready to receive traffic.
|
||||
## parent
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
|
||||
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the specification for integrating Kubernetes-style readiness probes into instance startup health monitoring to determine when containers are ready to receive traffic.
|
||||
## files
|
||||
- spec.md | Defines requirements for container readiness probe configuration, execution, and result storage during instance startup | dep: docker, container orchestration, health endpoint, logging system
|
||||
## arch
|
||||
Specification-driven requirements document using markdown-based technical specification pattern with structured sections for goals, requirements, and implementation details.
|
||||
## tags
|
||||
spec, defines, requirements, container, readiness, probe, configuration, execution
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
|
||||
|
||||
## role
|
||||
Defines health monitoring requirements for distinguishing infrastructure tunnel failures from application-level errors to enable appropriate recovery actions and UI feedback.
|
||||
## parent
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
|
||||
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines health monitoring requirements for distinguishing infrastructure tunnel failures from application-level errors to enable appropriate recovery actions and UI feedback.
|
||||
## files
|
||||
- spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system with different UI behaviors and recovery actions.
|
||||
## arch
|
||||
Specification-driven requirements document using scenario-based classification pattern with decision matrix mapping failure types to distinct UI behaviors and automated recovery procedures.
|
||||
## tags
|
||||
spec, specifies, requirements, classifying, tunnel, failures, versus, application
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances (index)
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances
|
||||
|
||||
## role
|
||||
Defines system requirements for container health monitoring and tunnel management functionality.
|
||||
## parent
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
|
||||
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
+19
@@ -0,0 +1,19 @@
|
||||
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances
|
||||
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances
|
||||
|
||||
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines system requirements for container health monitoring and tunnel management functionality.
|
||||
## files
|
||||
- spec.md | Defines modified and added system requirements for container status monitoring, health check endpoints, and smart tunnel recreation logic.
|
||||
## arch
|
||||
Specification-driven requirements documentation using markdown-based system specification format with functional requirement decomposition.
|
||||
## tags
|
||||
spec, defines, modified, added, system, requirements, container, status
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
Reference in New Issue
Block a user