chore: archive 15 completed OpenSpec changes

Move the following audited-and-implemented changes into
openspec/changes/archive/2026-06-12-completed-changes-archive/:

- backend-frontend-refactoring
- config-profile-git-mounts
- config-profile-includes-ui
- config-profile-multi-repo-mounts
- container-monitoring-notifications
- git-mount-url-validation
- home-path-expansion
- mobile-terminal-ux
- mount-specificity-ordering
- notification-center
- persistent-terminal-sessions
- session-list-overhaul
- ssh-key-mounting
- terminal-fullscreen-unified-header
- tool-session-progress-and-updates

Also regenerated .pi-map*.md files for openspec/changes so the
remaining active changes (multi-session-terminal-ux, reorganize-long-files,
working-copies, workspace-first-ui) reflect the new layout.
This commit is contained in:
Developer
2026-06-12 14:26:55 +00:00
parent 30549f4863
commit caadd59441
493 changed files with 3563 additions and 3490 deletions
@@ -1,23 +1,23 @@
# openspec/changes/archive/2026-05-22-instance-health-monitoring (index)
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring
# archive/2026-05-22-instance-health-monitoring (index)
dir: 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.
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.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: 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
- archive/2026-05-22-instance-health-monitoring/specs
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2026-05-22-instance-health-monitoring
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring
# archive/2026-05-22-instance-health-monitoring
dir: archive/2026-05-22-instance-health-monitoring
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
index: 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.
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 architecture using OpenSpec metadata with design/proposal/task documents following a structured change-management pattern for incremental feature delivery.
Specification-driven design using OpenSpec schema definitions, with phased implementation tracked through task-based project management (designproposaltasks), employing readiness probes and smart auto-recovery patterns for container-based tunnel services.
## tags
health, tunnel, design, container, docker, docker compose, tasks, .openspec
## symbols
@@ -1,31 +1,31 @@
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs (index)
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
# archive/2026-05-22-instance-health-monitoring/specs (index)
dir: 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.
Contains historical specification documents for a May 2026 instance health monitoring feature, serving as archived design documentation.
## 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
index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
map: 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
- archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health
index: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md
- archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health
index: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md
- archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
index: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md
- archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
index: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md
- archive/2026-05-22-instance-health-monitoring/specs/tool-instances
index: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
dir: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs
# archive/2026-05-22-instance-health-monitoring/specs
dir: archive/2026-05-22-instance-health-monitoring/specs
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
index: 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.
Contains historical specification documents for a May 2026 instance health monitoring feature, serving as archived design documentation.
## files
## arch
Flat directory structure storing dated, versioned specification archives with no active code or architectural patterns.
Document-based architecture with date-versioned directory structure for preserving feature specifications outside active codebase.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health (index)
dir: 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
Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane.
## 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
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health
dir: 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
index: 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
Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane.
## 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
Specification-driven design using polling-based health checks with state machine transitions for container lifecycle management.
## tags
container, spec, specification, document, defining, health, monitoring, polling
## symbols
@@ -1,18 +1,18 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health (index)
dir: 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
Defines technical specifications for container health verification and lifecycle monitoring in a tool 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
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health
dir: 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
index: 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
Defines technical specifications for container health verification and lifecycle monitoring in a tool instance management system.
## 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
Requirements-driven specification document using Docker Compose for container orchestration with startup probes, readiness checks, and health monitoring patterns.
## tags
spec, defines, requirements, container, startup, verification, readiness, probe
## symbols
@@ -1,18 +1,18 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration (index)
dir: 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.
Defines technical specifications for integrating container readiness probes into instance health monitoring during startup.
## 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
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration
dir: 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
index: 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.
Defines technical specifications for integrating container readiness probes into instance health monitoring during 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
## arch
Specification-driven requirements document using markdown-based technical specification pattern with structured sections for goals, requirements, and implementation details.
Specification-driven design using requirements documentation as the single source of truth for probe configuration, execution, and result storage behavior.
## tags
spec, defines, requirements, container, readiness, probe, configuration, execution
## symbols
@@ -1,18 +1,18 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery (index)
dir: 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.
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.
## 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
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery
dir: 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
index: 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.
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.
## 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.
Specification-driven design using requirement-based decomposition with clear separation between failure classification logic, UI state mapping, and recovery action orchestration.
## tags
spec, specifies, requirements, classifying, tunnel, failures, versus, application
## symbols
@@ -1,18 +1,18 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/tool-instances (index)
dir: archive/2026-05-22-instance-health-monitoring/specs/tool-instances
## role
Defines system requirements for container health monitoring and tunnel management functionality.
Defines system requirements for container health monitoring and tunnel management capabilities in the tool instances infrastructure.
## 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
index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md
map: 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
index: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 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
# archive/2026-05-22-instance-health-monitoring/specs/tool-instances
dir: 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
index: 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.
Defines system requirements for container health monitoring and tunnel management capabilities in the tool instances infrastructure.
## 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.
Requirements specification document using structured markdown with modified/added requirement tracking for incremental system capability definition.
## tags
spec, defines, modified, added, system, requirements, container, status
## symbols