chore(project-map): regenerate .pi-map artifacts across the repo

This commit is contained in:
Developer
2026-06-17 11:31:24 +00:00
parent 0dd5f2317b
commit 93da9b42a2
683 changed files with 5075 additions and 4965 deletions
@@ -1,23 +1,23 @@
# 2026-05-22-instance-health-monitoring (index)
dir: 2026-05-22-instance-health-monitoring
# openspec/changes/archive/2026-05-22-instance-health-monitoring (index)
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring
## role
Design and planning package for improving instance health monitoring in a container-based tunnel service, covering architecture proposals, implementation tasks, and OpenSpec configuration.
OpenSpec specification package defining architectural improvements for container instance health monitoring and auto-recovery in a tunnel service system
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-22-instance-health-monitoring/specs
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
- 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: 2026-05-22-instance-health-monitoring/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/.pi-map.md
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
@@ -1,19 +1,19 @@
# 2026-05-22-instance-health-monitoring
dir: 2026-05-22-instance-health-monitoring
# openspec/changes/archive/2026-05-22-instance-health-monitoring
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring
index: 2026-05-22-instance-health-monitoring/.pi-map.index.md
index: openspec/changes/archive/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.
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 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)
- 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
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.
Specification-driven design using OpenSpec schema with phased implementation tracking (proposaldesign → tasks), separating container health from tunnel health concerns and integrating Kubernetes-style readiness probes into startup flow
## tags
health, tunnel, design, container, docker, docker compose, tasks, .openspec
health, container, design, tunnel, startup, docker, docker compose, .openspec
## symbols
-
## workflows
@@ -1,31 +1,31 @@
# 2026-05-22-instance-health-monitoring/specs (index)
dir: 2026-05-22-instance-health-monitoring/specs
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs (index)
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
## role
Contains specification documents defining requirements and design for the instance health monitoring feature.
Contains archived specification documents for an instance health monitoring feature planned for May 22, 2026 release.
## parent
index: 2026-05-22-instance-health-monitoring/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/.pi-map.md
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
- 2026-05-22-instance-health-monitoring/specs/instance-runtime-health
index: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md
- 2026-05-22-instance-health-monitoring/specs/instance-startup-health
index: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md
- 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
index: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md
- 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
index: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md
- 2026-05-22-instance-health-monitoring/specs/tool-instances
index: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md
- 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: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
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
@@ -1,13 +1,13 @@
# 2026-05-22-instance-health-monitoring/specs
dir: 2026-05-22-instance-health-monitoring/specs
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
## role
Contains specification documents defining requirements and design for the instance health monitoring feature.
Contains archived specification documents for an instance health monitoring feature planned for May 22, 2026 release.
## files
## arch
Documentation-as-code pattern using dated directories for version control and traceability of system specifications.
Document-based specification storage using date-versioned directory hierarchy with no active code artifacts.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2026-05-22-instance-health-monitoring/specs/instance-runtime-health (index)
dir: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health
# 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 health monitoring, polling, and container state synchronization requirements for a container/instance management system.
Defines system requirements for monitoring instance runtime health, frontend polling, and container state synchronization across web and terminal access modes.
## parent
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
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: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md
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
@@ -1,16 +1,16 @@
# 2026-05-22-instance-health-monitoring/specs/instance-runtime-health
dir: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health
# 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: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
## role
Defines health monitoring, polling, and container state synchronization requirements for a container/instance management system.
Defines system requirements for monitoring instance runtime health, frontend polling, and container state synchronization across web and terminal access modes.
## 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
- spec.md | Defines system requirements for runtime health monitoring, frontend health polling, and container state synchronization for instances with web and terminal access modes. | dep: Docker, HTTP tunnel, frontend UI, health probe system
## arch
Specification-driven design using requirement documents to formalize system behavior before implementation.
Specification-driven requirements document using markdown-based technical specification pattern with sections for goals, requirements, and implementation details.
## tags
container, spec, specification, document, defining, health, monitoring, polling
health, spec, defines, system, requirements, runtime, monitoring, frontend
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-22-instance-health-monitoring/specs/instance-startup-health (index)
dir: 2026-05-22-instance-health-monitoring/specs/instance-startup-health
# 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 technical specifications for verifying container startup health and readiness in a Docker Compose-based tool instance management system.
Defines system requirements for container lifecycle management including startup verification, readiness probes, and health monitoring for Docker-based tool instances.
## parent
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
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: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md
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
@@ -1,16 +1,16 @@
# 2026-05-22-instance-health-monitoring/specs/instance-startup-health
dir: 2026-05-22-instance-health-monitoring/specs/instance-startup-health
# 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: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
## role
Defines technical specifications for verifying container startup health and readiness in a Docker Compose-based tool instance management system.
Defines system requirements for container lifecycle management including startup verification, readiness probes, and health monitoring for Docker-based tool instances.
## 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
- spec.md | Defines system requirements for container lifecycle management including startup verification, readiness probes, and health monitoring for Docker-based tool instances. | dep: Docker, docker compose, database
## arch
Specification-driven requirements document using prose-based standards with sections for overview, requirements, and implementation notes, targeting integration with Docker Compose health check mechanisms and container orchestration patterns.
Specification document using requirements-driven architecture with clearly defined functional/non-functional requirements, health state machine (Unknown→Pending→Healthy→Unhealthy), and layered monitoring approach (startup verification, readiness probes, runtime health checks).
## tags
spec, defines, requirements, container, startup, verification, readiness, probe
docker, spec, defines, system, requirements, container, lifecycle, management
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration (index)
dir: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
# 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 technical specifications for Kubernetes-style readiness probe integration to determine container startup health state
Defines container readiness probe behavior for instance health monitoring during system startup
## parent
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
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: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md
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
@@ -1,14 +1,14 @@
# 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
dir: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
# 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: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
## role
Defines technical specifications for Kubernetes-style readiness probe integration to determine container startup health state
Defines container readiness probe behavior for instance health monitoring during system startup
## 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
- spec.md | Defines requirements for container readiness probe configuration, execution, and result storage during instance startup | dep: docker, containers, health endpoint, logging system
## arch
Specification-driven requirements document using markdown-based technical specification pattern with functional requirements decomposition
Specification-driven contract defining probe configuration, execution lifecycle, and state persistence patterns
## tags
spec, defines, requirements, container, readiness, probe, configuration, execution
## symbols
@@ -1,18 +1,18 @@
# 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery (index)
dir: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
# 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 requirements for distinguishing network tunnel failures from application-level errors in a health monitoring system to enable appropriate recovery strategies and user-facing behaviors.
Defines health-check classification logic to distinguish infrastructure tunnel failures from application-layer errors for automated tunnel recovery decisions.
## parent
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
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: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md
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
@@ -1,16 +1,16 @@
# 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
dir: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
# 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: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
## role
Defines requirements for distinguishing network tunnel failures from application-level errors in a health monitoring system to enable appropriate recovery strategies and user-facing behaviors.
Defines health-check classification logic to distinguish infrastructure tunnel failures from application-layer errors for automated tunnel recovery decisions.
## files
- spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system with different UI behaviors and recovery actions.
- spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system to determine when tunnel recreation is appropriate | dep: cloudflared, health check system, frontend UI
## arch
Specification-driven design using requirement decomposition with clear separation between failure classification logic, UI state transitions, and automated recovery action definitions.
Specification-driven requirements document using structured markdown with clear categorization of failure modes and decision criteria for a health-monitoring subsystem.
## tags
spec, specifies, requirements, classifying, tunnel, failures, versus, application
tunnel, spec, specifies, requirements, classifying, failures, versus, application
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-22-instance-health-monitoring/specs/tool-instances (index)
dir: 2026-05-22-instance-health-monitoring/specs/tool-instances
# 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 automatic tunnel recovery mechanisms.
Defines specification requirements for container tool instance health monitoring and tunnel lifecycle management.
## parent
index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md
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: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md
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
@@ -1,16 +1,16 @@
# 2026-05-22-instance-health-monitoring/specs/tool-instances
dir: 2026-05-22-instance-health-monitoring/specs/tool-instances
# 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: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
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 automatic tunnel recovery mechanisms.
Defines specification requirements for container tool instance health monitoring and tunnel lifecycle management.
## files
- spec.md | Defines modified and added system requirements for container status monitoring, health check endpoints, and smart tunnel recreation logic.
- spec.md | Defines modified, added, and removed requirements for a system tracking container tool status, health monitoring endpoints, and tunnel lifecycle management.
## arch
Requirements specification document following structured system specification pattern with functional requirements for monitoring, health checking, and self-healing infrastructure.
Requirements-driven specification document using change-tracking format (modified/added/removed) for system behavior definition.
## tags
spec, defines, modified, added, system, requirements, container, status
spec, defines, modified, added, removed, requirements, system, tracking
## symbols
-
## workflows