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,119 +1,119 @@
# 2026-06-14-completed-specs-archive (index)
dir: 2026-06-14-completed-specs-archive
# openspec/changes/archive/2026-06-14-completed-specs-archive (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive
## role
Historical archive for completed and audited OpenSpec specifications that are no longer active in the project.
Historical archive of completed and audited OpenSpec specifications for reference tracking.
## 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-06-14-completed-specs-archive/api-documentation
index: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.md
- 2026-06-14-completed-specs-archive/auth-oauth
index: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md
- 2026-06-14-completed-specs-archive/database-models
index: 2026-06-14-completed-specs-archive/database-models/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/database-models/.pi-map.md
- 2026-06-14-completed-specs-archive/docker-infrastructure
index: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md
- 2026-06-14-completed-specs-archive/frontend-foundation
index: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md
- 2026-06-14-completed-specs-archive/git-repo
index: 2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/git-repo/.pi-map.md
- 2026-06-14-completed-specs-archive/instance-proxy
index: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md
- 2026-06-14-completed-specs-archive/instance-runtime-health
index: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md
- 2026-06-14-completed-specs-archive/instance-startup-health
index: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md
- 2026-06-14-completed-specs-archive/mobile-list-detail
index: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md
- 2026-06-14-completed-specs-archive/mobile-navigation
index: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md
- 2026-06-14-completed-specs-archive/mobile-repo-workspace
index: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md
- 2026-06-14-completed-specs-archive/mobile-tools-navigation
index: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md
- 2026-06-14-completed-specs-archive/opencode-web-server
index: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md
- 2026-06-14-completed-specs-archive/project-management
index: 2026-06-14-completed-specs-archive/project-management/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/project-management/.pi-map.md
- 2026-06-14-completed-specs-archive/readiness-probe-integration
index: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md
- 2026-06-14-completed-specs-archive/repo-clone-mode
index: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md
- 2026-06-14-completed-specs-archive/session-lifecycle-ux
index: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md
- 2026-06-14-completed-specs-archive/sessions-hub
index: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md
- 2026-06-14-completed-specs-archive/smart-tunnel-recovery
index: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md
- 2026-06-14-completed-specs-archive/ssh-keys
index: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-config-management
index: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-instances
index: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-port-configuration
index: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-terminal
index: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-terminal-startup-command
index: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-type-port-visibility
index: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-type-single-interface
index: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-types
index: 2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-types/.pi-map.md
- 2026-06-14-completed-specs-archive/tool-types-definition
index: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md
- 2026-06-14-completed-specs-archive/traefik-deployment
index: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md
- 2026-06-14-completed-specs-archive/tunnel-health-monitoring
index: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md
- 2026-06-14-completed-specs-archive/user-config
index: 2026-06-14-completed-specs-archive/user-config/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/user-config/.pi-map.md
- 2026-06-14-completed-specs-archive/user-profile
index: 2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/user-profile/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation
index: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth
index: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/database-models
index: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure
index: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation
index: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo
index: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server
index: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/project-management
index: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration
index: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode
index: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux
index: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub
index: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery
index: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys
index: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment
index: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/user-config
index: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile
index: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.md
## files
- README.md
## links
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-14-completed-specs-archive
dir: 2026-06-14-completed-specs-archive
# openspec/changes/archive/2026-06-14-completed-specs-archive
dir: openspec/changes/archive/2026-06-14-completed-specs-archive
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
## role
Historical archive for completed and audited OpenSpec specifications that are no longer active in the project.
Historical archive of completed and audited OpenSpec specifications for reference tracking.
## files
- README.md | Documents archived OpenSpec specifications that have been audited against the source tree and moved to historical reference.
- README.md | Documents archived OpenSpec specifications that have been audited against the source tree, tracking their implementation status for historical reference.
## arch
Simple archival directory structure with README-based documentation; no active code or runtime architecture.
Simple flat-file documentation archive with no active code patterns, serving as read-only audit trail storage.
## tags
readme, documents, archived, openspec, specifications, have, been, audited
## symbols
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/api-documentation (index)
dir: 2026-06-14-completed-specs-archive/api-documentation
# openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation
## role
Defines API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system.
Defines API documentation and health monitoring requirements for a FastAPI-based system
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/api-documentation
dir: 2026-06-14-completed-specs-archive/api-documentation
# openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation
index: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md
## role
Defines API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system.
Defines API documentation and health monitoring requirements for a FastAPI-based system
## files
- spec.md | Define API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system. | dep: FastAPI, Pydantic v2, Swagger UI, Database, Redis
- spec.md | Define API documentation and health monitoring requirements for a FastAPI-based system | dep: FastAPI, Pydantic v2
## arch
Specification-driven documentation architecture using markdown-based requirements definition for API standards, health check endpoints, and onboarding workflows.
Specification-driven documentation using Markdown-based requirements definition with FastAPI OpenAPI/Swagger integration patterns
## tags
fastapi, spec, define, api, documentation, health, monitoring, developer
fastapi, spec, define, api, documentation, health, monitoring, requirements
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/auth-oauth (index)
dir: 2026-06-14-completed-specs-archive/auth-oauth
# openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth
## role
Defines authentication and authorization specifications for OAuth2/OIDC integration with Authentik identity provider.
Defines authentication and authorization requirements for an OAuth2/OIDC-based system using Authentik as the identity provider.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/auth-oauth
dir: 2026-06-14-completed-specs-archive/auth-oauth
# openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth
index: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md
## role
Defines authentication and authorization specifications for OAuth2/OIDC integration with Authentik identity provider.
Defines authentication and authorization requirements for an OAuth2/OIDC-based system using Authentik as the identity provider.
## files
- spec.md | Specifies OAuth2/OIDC authentication requirements using Authentik with secure session handling, token refresh, and logout functionality | dep: Authentik OIDC provider, Database (User model), pytest, mypy, ruff
- spec.md | Specifies authentication requirements for an OAuth2/OIDC system using Authentik with secure session handling, token refresh, and logout | dep: Authentik OIDC provider, Database (User model), pytest, mypy, ruff
## arch
Security-focused specification document outlining token-based authentication flow with session management, refresh mechanisms, and secure logout procedures.
Specification-driven security architecture using standard OAuth2/OIDC flows with session management, token lifecycle handling, and secure logout patterns.
## tags
spec, specifies, oauth2, oidc, authentication, requirements, authentik, secure
spec, specifies, authentication, requirements, oauth2, oidc, system, authentik
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/database-models (index)
dir: 2026-06-14-completed-specs-archive/database-models
# openspec/changes/archive/2026-06-14-completed-specs-archive/database-models (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models
## role
Defines the database schema, SQLAlchemy 2.0 async ORM models, Alembic migrations, and seeding logic for six core entities in the Headquarter platform.
Defines the database schema and SQLAlchemy 2.0 async ORM models for the Headquarter platform's core entities including users, projects, git repositories, SSH keys, and user configuration, with Alembic migration and seeding support.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/database-models/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/database-models/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-14-completed-specs-archive/database-models
dir: 2026-06-14-completed-specs-archive/database-models
# openspec/changes/archive/2026-06-14-completed-specs-archive/database-models
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models
index: 2026-06-14-completed-specs-archive/database-models/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md
## role
Defines the database schema, SQLAlchemy 2.0 async ORM models, Alembic migrations, and seeding logic for six core entities in the Headquarter platform.
Defines the database schema and SQLAlchemy 2.0 async ORM models for the Headquarter platform's core entities including users, projects, git repositories, SSH keys, and user configuration, with Alembic migration and seeding support.
## files
- spec.md | Define database schema and SQLAlchemy 2.0 async models for the Headquarter platform with six core entities, Alembic migrations, and seeding. | dep: PostgreSQL, SQLAlchemy 2.0, asyncpg, Alembic, Fernet, pytest, mypy, ruff
- spec.md | Define database schema and SQLAlchemy 2.0 async models for the Headquarter platform including users, projects, git repositories, SSH keys, and user configuration with Alembic migrations and seeding. | dep: SQLAlchemy 2.0, asyncpg, Alembic, PostgreSQL, Fernet cryptography, pytest, mypy, ruff
## arch
Async SQLAlchemy 2.0 declarative ORM with Alembic for migrations, supporting PostgreSQL with structured seeding and six interconnected domain entities.
Async SQLAlchemy 2.0 declarative ORM with Alembic migrations, seeding utilities, and comprehensive entity relationship modeling for a multi-tenant platform with git integration and SSH key management.
## tags
alembic, spec, define, database, schema, sqlalchemy, async, models
## symbols
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/docker-infrastructure (index)
dir: 2026-06-14-completed-specs-archive/docker-infrastructure
# openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure
## role
Defines Docker-based infrastructure specifications for multi-service development and production deployment environments.
Defines Docker containerization specifications for deploying a multi-service application stack across development and production environments.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/docker-infrastructure
dir: 2026-06-14-completed-specs-archive/docker-infrastructure
# openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure
index: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md
## role
Defines Docker-based infrastructure specifications for multi-service development and production deployment environments.
Defines Docker containerization specifications for deploying a multi-service application stack across development and production environments.
## files
- spec.md | Define Docker-based infrastructure specifications for a multi-service development and production deployment environment | dep: Docker, Docker Compose, Make, Python 3.11, Node.js 20+, nginx, Traefik, Vite, Authentik, Redis, PostgreSQL
- spec.md | Define Docker infrastructure requirements for a multi-service development and production deployment environment with API, web frontend, and supporting services | dep: Docker, Docker Compose, Make, Python 3.11, Node.js 20, Vite, nginx, Traefik, Authentik, Redis, PostgreSQL
## arch
Specification-driven architecture using markdown-based documentation to define container orchestration patterns for cross-environment parity.
Container-based microservices architecture using Docker with service separation (API, web frontend, supporting services), environment-specific configurations, and orchestrated multi-container deployment patterns.
## tags
docker, spec, define, infrastructure, specifications, multi, service, development
docker, spec, define, infrastructure, requirements, multi, service, development
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/frontend-foundation (index)
dir: 2026-06-14-completed-specs-archive/frontend-foundation
# openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation
## role
Defines the technical specification for a modern React 18+ TypeScript frontend foundation with build tooling, routing, styling, and core UI features.
Defines frontend foundation specifications for a modern React 18+ TypeScript application including routing, styling, layout, auth, and form behaviors.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/frontend-foundation
dir: 2026-06-14-completed-specs-archive/frontend-foundation
# openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation
index: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md
## role
Defines the technical specification for a modern React 18+ TypeScript frontend foundation with build tooling, routing, styling, and core UI features.
Defines frontend foundation specifications for a modern React 18+ TypeScript application including routing, styling, layout, auth, and form behaviors.
## files
- spec.md | Define a specification for a modern React 18+ TypeScript frontend with Vite, React Router, Tailwind CSS, authenticated routing, responsive layout, and dashboard/tool workshop features. | dep: React 18+, TypeScript 5+, Vite, React Router, Tailwind CSS, Axios
- spec.md | Define frontend foundation specifications for a modern React 18+ TypeScript application with routing, Tailwind CSS styling, responsive layout, authentication guards, and tool workshop form behaviors. | dep: React 18+, TypeScript 5+, Vite, React Router, Tailwind CSS, Axios
## arch
Specification-driven architecture using Vite for bundling, React Router for client-side navigation with authenticated route guards, Tailwind CSS for utility-first styling, and a component-based layout structure supporting responsive dashboards and tool workshops.
Specification-driven architecture using markdown-based requirements documentation for a React 18+ SPA with Tailwind CSS, client-side routing, responsive design patterns, authentication guards, and form handling conventions.
## tags
react, vite, spec, define, specification, modern, typescript, frontend
spec, define, frontend, foundation, specifications, modern, react, typescript
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/git-repo (index)
dir: 2026-06-14-completed-specs-archive/git-repo
# openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo
## role
Defines specifications for a bare git repository management service that bridges filesystem storage with database-backed metadata and SSH key integration.
Defines requirements for a git repository management system with bare repo lifecycle operations, SSH key integration, and duplicate prevention.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/git-repo/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/git-repo
dir: 2026-06-14-completed-specs-archive/git-repo
# openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo
index: 2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md
## role
Defines specifications for a bare git repository management service that bridges filesystem storage with database-backed metadata and SSH key integration.
Defines requirements for a git repository management system with bare repo lifecycle operations, SSH key integration, and duplicate prevention.
## files
- spec.md | Specifies requirements for managing bare git repositories on disk with database metadata, including creation, SSH key association, cloning, listing, deletion, and duplicate prevention. | dep: Database models (GitRepository, Project, User), Docker volume for repo storage
- spec.md | Defines requirements for a git repository management system that handles bare repository creation, SSH key association, cloning, listing, deletion, and duplicate prevention with on-disk storage and database metadata. | dep: GitRepository, Project, User, Docker volume, SSH key system, pytest, mypy, ruff, npm
## arch
Specification-driven domain design with clear separation between storage operations (create/clone/delete), metadata persistence, and access control (SSH keys), emphasizing idempotency and duplicate prevention constraints.
Specification-driven design using markdown-based requirements documentation with clear functional boundaries between storage layers (filesystem + database) and explicit constraint definitions.
## tags
spec, specifies, requirements, managing, bare, git, repositories, disk
repository, spec, defines, requirements, git, management, system, handles
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/instance-proxy (index)
dir: 2026-06-14-completed-specs-archive/instance-proxy
# openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy
## role
Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-based access control.
Defines API requirements for proxying HTTP and WebSocket traffic from authenticated users to running tool instances with owner-based access control
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/instance-proxy
dir: 2026-06-14-completed-specs-archive/instance-proxy
# openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy
index: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md
## role
Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-based access control.
Defines API requirements for proxying HTTP and WebSocket traffic from authenticated users to running tool instances with owner-based access control
## files
- spec.md | Specifies API requirements for an HTTP/WebSocket proxy endpoint that forwards requests to running tool instances with owner-based access control
- spec.md | Specifies API requirements for proxying HTTP and WebSocket traffic from authenticated users to running tool instances with owner-based access control
## arch
API specification using markdown-based documentation; defines REST/WebSocket endpoint patterns with authentication/authorization requirements, request forwarding semantics, and ownership-based access control policies.
API specification document using requirement-based specification pattern with authentication and authorization constraints
## tags
spec, specifies, api, requirements, http, websocket, proxy, endpoint
spec, specifies, api, requirements, proxying, http, websocket, traffic
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/instance-runtime-health (index)
dir: 2026-06-14-completed-specs-archive/instance-runtime-health
# openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health
## role
Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane.
Defines system requirements for runtime health monitoring, frontend health polling, and container state synchronization for instances with web and terminal access modes.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/instance-runtime-health
dir: 2026-06-14-completed-specs-archive/instance-runtime-health
# openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health
index: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md
## role
Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane.
Defines system requirements for runtime health monitoring, frontend health polling, and container state synchronization for instances with 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 contract pattern with event-based polling architecture, health state machine transitions, and asynchronous status reconciliation between distributed agents and centralized coordinator.
Specification-driven requirements document using system-level functional decomposition with separate concerns for health monitoring, polling mechanisms, and state synchronization across multiple access modes.
## tags
container, spec, specification, document, defining, health, monitoring, polling
health, spec, defines, system, requirements, runtime, monitoring, frontend
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/instance-startup-health (index)
dir: 2026-06-14-completed-specs-archive/instance-startup-health
# openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/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 system requirements for container lifecycle management including startup verification, readiness probes, and health monitoring for Docker-based tool instances.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/instance-startup-health
dir: 2026-06-14-completed-specs-archive/instance-startup-health
# openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health
index: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/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 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 Markdown format with structured sections for overview, requirements, and behavior definitions, following a declarative specification pattern for system behavior documentation.
Specification-driven architecture using markdown-based requirements documentation for container health checking patterns with startup, readiness, and liveness probe semantics.
## tags
spec, defines, requirements, container, startup, verification, readiness, probe
docker, spec, defines, system, requirements, container, lifecycle, management
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/mobile-list-detail (index)
dir: 2026-06-14-completed-specs-archive/mobile-list-detail
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail
## role
Defines mobile UI specifications for list-detail CRUD screens managing tool types and configuration profiles.
Specification document defining mobile UI requirements for list-detail CRUD workflows in a configuration management application.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/mobile-list-detail
dir: 2026-06-14-completed-specs-archive/mobile-list-detail
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail
index: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md
## role
Defines mobile UI specifications for list-detail CRUD screens managing tool types and configuration profiles.
Specification document defining mobile UI requirements for list-detail CRUD workflows in a configuration management application.
## files
- spec.md | Defines mobile UI requirements for a configuration management system with list views, detail views, editing, and CRUD operations for tool types and config profiles.
- spec.md | Mobile UI requirements specification for a configuration management application featuring list views, detail views, editing workflows, and CRUD operations for tool types and config profiles.
## arch
Specification-driven documentation using structured markdown with user stories, acceptance criteria, and screen flow definitions for mobile configuration management interfaces.
Markdown-based requirements specification following a feature-driven documentation pattern with sections for overview, requirements, user stories, and detailed UI/UX specifications for mobile interfaces.
## tags
views, spec, defines, mobile, requirements, configuration, management, system
views, spec, mobile, requirements, specification, configuration, management, application
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/mobile-navigation (index)
dir: 2026-06-14-completed-specs-archive/mobile-navigation
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation
## role
Archives completed mobile bottom navigation specification with grouped items and submenu behavior.
Defines mobile bottom navigation UI requirements for organizing related pages into expandable sub-menu groups.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/mobile-navigation
dir: 2026-06-14-completed-specs-archive/mobile-navigation
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation
index: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md
## role
Archives completed mobile bottom navigation specification with grouped items and submenu behavior.
Defines mobile bottom navigation UI requirements for organizing related pages into expandable sub-menu groups.
## files
- spec.md | Defines requirements for grouped bottom navigation with submenu behavior on mobile
- spec.md | Defines mobile bottom navigation requirements for grouping related pages under expandable sub-menu items
## arch
Specification document archive with no active code architecture; serves as historical reference for mobile UI pattern requirements.
Specification-driven design using markdown-based requirements documentation with date-versioned archival structure.
## tags
spec, defines, requirements, grouped, bottom, navigation, submenu, behavior
spec, defines, mobile, bottom, navigation, requirements, grouping, related
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/mobile-repo-workspace (index)
dir: 2026-06-14-completed-specs-archive/mobile-repo-workspace
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace
## role
Defines mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views
Defines mobile UI specifications for a repository workspace interface with file tree, editor, git, and terminal views.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/mobile-repo-workspace
dir: 2026-06-14-completed-specs-archive/mobile-repo-workspace
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace
index: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md
## role
Defines mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views
Defines mobile UI specifications for a repository workspace interface with file tree, editor, git, and terminal views.
## files
- spec.md | Define mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views
- spec.md | Defines mobile UI requirements for a repository workspace with file tree, editor, git, and terminal views
## arch
Specification document using markdown-based requirements definition with view-based modular decomposition
Specification document using markdown-based requirements definition with dated archival organization.
## tags
spec, define, mobile, requirements, repository, workspace, featuring, tree
spec, defines, mobile, requirements, repository, workspace, tree, editor
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/mobile-tools-navigation (index)
dir: 2026-06-14-completed-specs-archive/mobile-tools-navigation
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation
## role
Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication.
Defines mobile UI specification for a grouped "Tools" entry in bottom navigation with bottom sheet interaction pattern and active state visualization.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-14-completed-specs-archive/mobile-tools-navigation
dir: 2026-06-14-completed-specs-archive/mobile-tools-navigation
# openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation
index: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md
## role
Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication.
Defines mobile UI specification for a grouped "Tools" entry in bottom navigation with bottom sheet interaction pattern and active state visualization.
## files
- spec.md | Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication
- spec.md | Defines mobile UI requirements for a grouped "Tools" bottom navigation entry with bottom sheet behavior and active state indication
## arch
Specification-driven documentation pattern using Markdown-based requirements documents with no executable code.
Specification document using markdown-based requirements definition with behavioral state descriptions and UI interaction patterns.
## tags
bottom, spec, defines, mobile, requirements, grouped, tools, navigation
## symbols
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/opencode-web-server (index)
dir: 2026-06-14-completed-specs-archive/opencode-web-server
# openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server
## role
Defines specifications for a web-based terminal server feature that enables remote container access through browser-based tmux and ranger interfaces.
Defines containerized web server specifications for OpenCode's browser-based terminal interface with tmux and ranger integration.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/opencode-web-server
dir: 2026-06-14-completed-specs-archive/opencode-web-server
# openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server
index: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md
## role
Defines specifications for a web-based terminal server feature that enables remote container access through browser-based tmux and ranger interfaces.
Defines containerized web server specifications for OpenCode's browser-based terminal interface with tmux and ranger integration.
## files
- spec.md | Specifies requirements for OpenCode containers to run a web terminal server on port 3000 with tmux and ranger, exposed through tunnels and UI buttons
- spec.md | Defines requirements for OpenCode containers to run a web server on port 3000 serving a web terminal interface with tmux and ranger support
## arch
Requirements-driven specification document using feature-based organization with functional requirements (port 3000, tmux, ranger), integration patterns (tunnel exposure, UI buttons), and containerized deployment constraints.
Specification-driven architecture using markdown-based requirements document defining container runtime constraints (port 3000), service dependencies (tmux, ranger), and web terminal UI capabilities.
## tags
spec, specifies, requirements, opencode, containers, run, web, terminal
web, spec, defines, requirements, opencode, containers, run, server
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/project-management (index)
dir: 2026-06-14-completed-specs-archive/project-management
# openspec/changes/archive/2026-06-14-completed-specs-archive/project-management (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management
## role
Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management.
Defines archived specification requirements for a project management system with repository grouping, ownership, and SSH key management.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/project-management/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/project-management/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/project-management
dir: 2026-06-14-completed-specs-archive/project-management
# openspec/changes/archive/2026-06-14-completed-specs-archive/project-management
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management
index: 2026-06-14-completed-specs-archive/project-management/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md
## role
Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management.
Defines archived specification requirements for a project management system with repository grouping, ownership, and SSH key management.
## files
- spec.md | Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management. | dep: Project, User, GitRepository, SSHKey, git-repo, ssh-keys
- spec.md | Defines requirements for a project management system that groups repositories with ownership, CRUD operations, and SSH key management. | dep: Database models (Project, User, GitRepository, SSHKey), git-repo, ssh-keys
## arch
Specification-driven requirements document using Markdown format to define functional and non-functional requirements for a repository grouping and access control system.
Specification document using Markdown-based requirements definition with no active code architecture.
## tags
project, management, ssh, spec, defines, requirements, system, groups
management, ssh, spec, defines, requirements, project, system, groups
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/readiness-probe-integration (index)
dir: 2026-06-14-completed-specs-archive/readiness-probe-integration
# openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration
## role
Defines specifications for container readiness probe integration during instance startup to determine when services are ready to receive traffic.
Defines the specification for integrating container readiness probes to determine instance startup completion and health status.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-14-completed-specs-archive/readiness-probe-integration
dir: 2026-06-14-completed-specs-archive/readiness-probe-integration
# openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration
index: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md
## role
Defines specifications for container readiness probe integration during instance startup to determine when services are ready to receive traffic.
Defines the specification for integrating container readiness probes to determine instance startup completion and health status.
## 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 documentation pattern with requirements organized around configuration, execution, and storage concerns.
Specification-driven requirements document using structured markdown with sections for overview, requirements, and implementation details.
## tags
spec, defines, requirements, container, readiness, probe, configuration, execution
## symbols
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/repo-clone-mode (index)
dir: 2026-06-14-completed-specs-archive/repo-clone-mode
# openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode
## role
Defines host-side git repository cloning requirements with SSH key preparation and dirty state detection for containerized tool instances.
Defines requirements for cloning git repositories into host environments with SSH setup and dirty-state detection for containerized tooling workflows.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-14-completed-specs-archive/repo-clone-mode
dir: 2026-06-14-completed-specs-archive/repo-clone-mode
# openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode
index: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md
## role
Defines host-side git repository cloning requirements with SSH key preparation and dirty state detection for containerized tool instances.
Defines requirements for cloning git repositories into host environments with SSH setup and dirty-state detection for containerized tooling workflows.
## files
- spec.md | Specifies requirements for host-side git repository cloning with SSH key preparation and dirty state detection for containerized tool instances. | dep: GitRepository, ToolInstance, SSHKey, Docker Compose, Git, pytest, mypy, ruff, npm
- spec.md | Specifies requirements for host-side git repository cloning with SSH key preparation and dirty state detection for containerized tool instances | dep: GitRepository, ToolInstance, SSHKey, Docker Compose, Git
## arch
Specification-driven architecture using markdown-based requirements document with clear functional boundaries for host/container interaction patterns.
Specification-driven design with clear separation of concerns between SSH key preparation, repository state detection, and clone operation orchestration.
## tags
git, spec, specifies, requirements, host, side, repository, cloning
## symbols
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/session-lifecycle-ux (index)
dir: 2026-06-14-completed-specs-archive/session-lifecycle-ux
# openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux
## role
Defines UI/UX requirements for session lifecycle management including confirmation flows and real-time deletion feedback.
Archives a completed specification for session lifecycle UI behaviors including stop confirmation and immediate delete feedback.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/session-lifecycle-ux
dir: 2026-06-14-completed-specs-archive/session-lifecycle-ux
# openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux
index: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md
## role
Defines UI/UX requirements for session lifecycle management including confirmation flows and real-time deletion feedback.
Archives a completed specification for session lifecycle UI behaviors including stop confirmation and immediate delete feedback.
## files
- spec.md | Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates
- spec.md | Defines software requirements and user scenarios for session management UI behaviors including stop confirmation and immediate delete feedback.
## arch
Specification-driven design using requirements documentation with behavioral definitions for user-facing state transitions.
Document-based specification archive with dated snapshot organization for versioned requirements tracking.
## tags
spec, defines, software, requirements, session, management, behaviors, including
spec, defines, software, requirements, user, scenarios, session, management
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/sessions-hub (index)
dir: 2026-06-14-completed-specs-archive/sessions-hub
# openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub
## role
Defines technical specifications for a "Sessions Hub" feature that manages user sessions in a web application.
Archive of a completed specification for a Sessions Hub feature that provides centralized management of active development sessions with real-time status indicators and quick access capabilities.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/sessions-hub
dir: 2026-06-14-completed-specs-archive/sessions-hub
# openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub
index: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md
## role
Defines technical specifications for a "Sessions Hub" feature that manages user sessions in a web application.
Archive of a completed specification for a Sessions Hub feature that provides centralized management of active development sessions with real-time status indicators and quick access capabilities.
## files
- spec.md | Defines technical specifications for a "Sessions Hub" feature including requirements, API endpoints, UI layouts, state management, and quality gates for managing user sessions in a web application. | dep: REST API, TypeScript, React/frontend framework (implied by UI specs and quality gates), polling-based state management, Pydantic/BaseModel
- spec.md | Specification document for a "Sessions Hub" feature that adds a new navigation tab for managing running development sessions with real-time badge counts, quick creation, and persistence of last accessed session | dep: Users API, Projects API, Repositories API, Instances API, Tool Types API, User Config API, Sessions Context (existing polling system)
## arch
Specification-driven architecture using requirements documentation, API endpoint definitions, UI layout diagrams, state management patterns, and quality gate checklists.
Specification-driven feature design using markdown-based documentation with requirements for real-time UI updates (badge counts), persistent user state (last accessed session), and streamlined workflow integration (quick creation from navigation).
## tags
sessions, spec, defines, technical, specifications, hub, feature, including
sessions, spec, specification, document, hub, feature, adds, new
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/smart-tunnel-recovery (index)
dir: 2026-06-14-completed-specs-archive/smart-tunnel-recovery
# openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery
## role
Defines classification logic and recovery behavior for distinguishing infrastructure tunnel failures from application-level errors in health monitoring.
Defines health-check classification rules to distinguish tunnel failures from application errors for automated tunnel recovery decisions.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/smart-tunnel-recovery
dir: 2026-06-14-completed-specs-archive/smart-tunnel-recovery
# openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery
index: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md
## role
Defines classification logic and recovery behavior for distinguishing infrastructure tunnel failures from application-level errors in health monitoring.
Defines health-check classification rules to distinguish tunnel failures from application 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 requirements document with decision-tree logic mapping error classifications to distinct UI states and automated recovery actions.
Specification-driven requirements document using structured markdown with clear categorization of failure modes and decision criteria.
## tags
spec, specifies, requirements, classifying, tunnel, failures, versus, application
tunnel, spec, specifies, requirements, classifying, failures, versus, application
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/ssh-keys (index)
dir: 2026-06-14-completed-specs-archive/ssh-keys
# openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys
## role
Defines security specifications for SSH key generation and access control for git operations.
Defines the specification for SSH key lifecycle management to enable secure Git authentication with external providers.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/ssh-keys
dir: 2026-06-14-completed-specs-archive/ssh-keys
# openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys
index: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md
## role
Defines security specifications for SSH key generation and access control for git operations.
Defines the specification for SSH key lifecycle management to enable secure Git authentication with external providers.
## files
- spec.md | Specifies requirements for generating, managing, and securing Ed25519 SSH keys for git operations with project-scoped access control. | dep: SSHKey, User, Project, cryptography, pytest, mypy, ruff, npm
- spec.md | Specifies requirements for generating, managing, and associating Ed25519 SSH keys for git operations with external providers. | dep: Database models (SSHKey, User, Project), cryptography library, pytest, mypy, ruff, npm typecheck/lint
## arch
Security specification document establishing Ed25519 cryptographic standards with project-scoped access control patterns.
Requirements specification document using structured markdown with functional requirements, constraints, and operational procedures.
## tags
project, spec, specifies, requirements, generating, managing, securing, ed25519
spec, specifies, requirements, generating, managing, associating, ed25519, ssh
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-config-management (index)
dir: 2026-06-14-completed-specs-archive/tool-config-management
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management
## role
Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation.
Defines requirements for a tool configuration management system with runtime-editable fields, split-pane UI, and JSON editing capabilities.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-config-management
dir: 2026-06-14-completed-specs-archive/tool-config-management
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management
index: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md
## role
Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation.
Defines requirements for a tool configuration management system with runtime-editable fields, split-pane UI, and JSON editing capabilities.
## files
- spec.md | Defines requirements for a tool configuration system with runtime fields, split-pane UI, JSON editors, and validation
- spec.md | Specifies requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation
## arch
Specification-driven architecture with split-pane UI pattern, JSON-based configuration with schema validation, and runtime field computation.
Specification-driven architecture with clear separation between UI presentation layer (split-pane layout, JSON editors) and validation layer, emphasizing runtime configuration mutability and user-friendly field editing patterns.
## tags
spec, defines, requirements, tool, configuration, system, runtime, fields
spec, specifies, requirements, tool, configuration, management, system, runtime
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-instances (index)
dir: 2026-06-14-completed-specs-archive/tool-instances
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances
## role
Defines requirements for a tool instance management system handling lifecycle, networking, and operational state of deployed tool environments.
Defines technical requirements for a tool instance management system that handles container lifecycle, health monitoring, and git-based workspace provisioning.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-instances
dir: 2026-06-14-completed-specs-archive/tool-instances
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances
index: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md
## role
Defines requirements for a tool instance management system handling lifecycle, networking, and operational state of deployed tool environments.
Defines technical requirements for a tool instance management system that handles container lifecycle, health monitoring, and git-based workspace provisioning.
## files
- spec.md | Define modified and added requirements for a tool instance management system including status monitoring, health checks, tunnel management, clone mode operations, and SSH key handling
- spec.md | Technical specification document defining requirements for a tool instance management system with container status tracking, health monitoring, tunnel management, and git clone/mount modes. | dep: Docker containers, HTTP API endpoints, SSH keys, git operations, tunneling service, compose files
## arch
Specification-driven requirements document using structured markdown with sections for functional requirements, status definitions, health check protocols, tunnel/clone/SSH subsystems, and explicit "do not implement" exclusions.
Specification-driven architecture with four core subsystems (container status tracking, health monitoring, tunnel management, git clone/mount modes) designed for infrastructure-as-code deployment patterns.
## tags
management, spec, define, modified, added, requirements, tool, instance
management, spec, technical, specification, document, defining, requirements, tool
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-port-configuration (index)
dir: 2026-06-14-completed-specs-archive/tool-port-configuration
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration
## role
Defines specifications for validating tool port configurations, including default ports, Docker Compose template exposure, and multi-interface support.
Defines requirements for a tool type system with port configuration, validation, and multi-interface support for containerized deployments.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-port-configuration
dir: 2026-06-14-completed-specs-archive/tool-port-configuration
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration
index: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md
## role
Defines specifications for validating tool port configurations, including default ports, Docker Compose template exposure, and multi-interface support.
Defines requirements for a tool type system with port configuration, validation, and multi-interface support for containerized deployments.
## files
- spec.md | Defines requirements for tool type validation including default ports, compose template port exposure, and multiple interface support
- spec.md | Defines requirements for a tool type system including default port validation, compose template port exposure, and multiple interface support
## arch
Specification-driven requirements documentation with structured constraints for port validation rules and template-based configuration patterns.
Specification-driven architecture using markdown-based requirements documents with structured sections for overview, requirements, and port configuration rules.
## tags
spec, defines, requirements, tool, type, validation, including, default
port, spec, defines, requirements, tool, type, system, including
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-terminal-startup-command (index)
dir: 2026-06-14-completed-specs-archive/tool-terminal-startup-command
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command
## role
Defines requirements for a pre-execution command feature in terminal tool sessions that runs before the interactive shell starts.
Defines requirements for a terminal tool feature that runs a startup command before interactive shell sessions begin.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-14-completed-specs-archive/tool-terminal-startup-command
dir: 2026-06-14-completed-specs-archive/tool-terminal-startup-command
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command
index: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md
## role
Defines requirements for a pre-execution command feature in terminal tool sessions that runs before the interactive shell starts.
Defines requirements for a terminal tool feature that runs a startup command before interactive shell sessions begin.
## files
- spec.md | Specifies requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions. | dep: tool-types-definition, tool-terminal
- spec.md | Specifies requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions | dep: tool-types-definition, tool-terminal
## arch
Specification document using requirement-driven design with field-based configuration pattern for tool type extensions.
Specification-driven design using a single markdown document to capture functional requirements for a configuration field extension to terminal tool types.
## tags
terminal, tool, types, spec, specifies, requirements, adding, optional
## symbols
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-terminal (index)
dir: 2026-06-14-completed-specs-archive/tool-terminal
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal
## role
Defines requirements for a browser-based WebSocket terminal interface that enables secure, session-managed access to running Docker containers with bidirectional I/O streaming.
Defines requirements for a browser-based WebSocket terminal system providing shell access to running Docker containers with session management, I/O streaming, and access control.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-terminal
dir: 2026-06-14-completed-specs-archive/tool-terminal
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal
index: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md
## role
Defines requirements for a browser-based WebSocket terminal interface that enables secure, session-managed access to running Docker containers with bidirectional I/O streaming.
Defines requirements for a browser-based WebSocket terminal system providing shell access to running Docker containers with session management, I/O streaming, and access control.
## files
- spec.md | Specifies requirements for a browser-based WebSocket terminal system for accessing running Docker containers with session management, I/O streaming, and access control. | dep: tool-instances, auth-oauth, xterm.js, ptyprocess
- spec.md | Specifies requirements for a browser-based WebSocket terminal system that provides shell access to running Docker containers with session management, I/O streaming, and access control. | dep: tool-instances, auth-oauth, xterm.js, ptyprocess
## arch
Event-driven WebSocket architecture with session-based multiplexing, container-attach abstraction layer, and token-based access control for real-time bidirectional streaming between browser clients and Docker container TTY/stdout/stderr interfaces.
Specification-driven architecture using markdown-based requirements document defining a real-time bidirectional communication system with WebSocket protocol, session state management, and containerized runtime integration.
## tags
spec, specifies, requirements, browser, websocket, terminal, system, accessing
access, spec, specifies, requirements, browser, websocket, terminal, system
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-type-port-visibility (index)
dir: 2026-06-14-completed-specs-archive/tool-type-port-visibility
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility
## role
Defines requirements for conditionally showing/hiding port configuration fields and validating port values based on whether a tool type requires network port access.
Defines requirements for dynamically showing/hiding port configuration fields based on tool type requirements.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-type-port-visibility
dir: 2026-06-14-completed-specs-archive/tool-type-port-visibility
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility
index: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md
## role
Defines requirements for conditionally showing/hiding port configuration fields and validating port values based on whether a tool type requires network port access.
Defines requirements for dynamically showing/hiding port configuration fields based on tool type requirements.
## files
- spec.md | Defines requirements for conditional port configuration visibility and validation based on a tool type's `requires_port` flag
- spec.md | Specifies requirements for conditional port configuration visibility and validation based on a `requires_port` flag for different tool types in a system with UI and API components.
## arch
Specification-driven validation pattern using boolean flag (`requires_port`) to control dynamic UI field visibility and conditional form validation rules.
Specification-driven validation with conditional UI/API field visibility toggled by a boolean flag per tool type.
## tags
port, spec, defines, requirements, conditional, configuration, visibility, validation
port, spec, specifies, requirements, conditional, configuration, visibility, validation
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-type-single-interface (index)
dir: 2026-06-14-completed-specs-archive/tool-type-single-interface
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface
## role
Defines specifications for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration.
Defines requirements for standardizing tool type interfaces to a single interface pattern with validation and legacy data migration.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-type-single-interface
dir: 2026-06-14-completed-specs-archive/tool-type-single-interface
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface
index: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md
## role
Defines specifications for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration.
Defines requirements for standardizing tool type interfaces to a single interface pattern with validation and legacy data migration.
## files
- spec.md | Defines requirements for enforcing single interface types, validating allowed values, and migrating legacy data for a tool type system
- spec.md | Specification document defining requirements for enforcing single interface types, validating allowed values, and migrating legacy data in a tool type system
## arch
Requirements specification document using a constraint-based validation pattern with explicit migration rules for backward compatibility.
Specification-driven architecture using markdown-based requirements documentation with explicit validation rules, allowed value constraints, and phased migration strategy for backward compatibility.
## tags
spec, defines, requirements, enforcing, single, interface, types, validating
spec, specification, document, defining, requirements, enforcing, single, interface
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-types-definition (index)
dir: 2026-06-14-completed-specs-archive/tool-types-definition
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition
## role
Defines specifications for a tool type management system that enables CRUD operations, Docker template validation, and variable substitution for development environments.
Defines software requirements for a Tool Type management system that enables CRUD operations, Docker template validation, and variable substitution for containerized tool definitions.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-types-definition
dir: 2026-06-14-completed-specs-archive/tool-types-definition
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition
index: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md
## role
Defines specifications for a tool type management system that enables CRUD operations, Docker template validation, and variable substitution for development environments.
Defines software requirements for a Tool Type management system that enables CRUD operations, Docker template validation, and variable substitution for containerized tool definitions.
## files
- spec.md | Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments. | dep: REST API, Docker Compose, YAML parser, authentication/authorization system, database ORM
- spec.md | Software specification document defining requirements for a Tool Type management system with CRUD API, Docker template validation, and variable substitution | dep: REST API, Docker Compose, YAML parser, UUID, database/ORM, authentication/authorization system
## arch
Specification-driven architecture with requirements documented in a single markdown file, focusing on API design, template validation, and environment configuration patterns.
Specification-driven architecture using markdown-based requirements documentation with RESTful API patterns, Docker containerization templates, and string-templating variable substitution mechanisms.
## tags
spec, defines, requirements, tool, type, management, system, crud
spec, software, specification, document, defining, requirements, tool, type
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tool-types (index)
dir: 2026-06-14-completed-specs-archive/tool-types
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types
## role
Defines requirements for migrating tool type definitions from code to database storage with validation and migration capabilities.
Defines system requirements for migrating tool types to database-backed storage with Docker Compose validation capabilities.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tool-types/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tool-types
dir: 2026-06-14-completed-specs-archive/tool-types
# openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types
index: 2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md
## role
Defines requirements for migrating tool type definitions from code to database storage with validation and migration capabilities.
Defines system requirements for migrating tool types to database-backed storage with Docker Compose validation capabilities.
## files
- spec.md | Defines modified requirements for a tool type management system with database-stored definitions, Docker Compose template validation, and migration of built-in tools to regular records. | dep: database, docker compose validation, migration system
- spec.md | Defines modified system requirements for a tool type management system with database-stored definitions, Docker Compose template validation, and migration of built-in tools to regular records.
## arch
Specification-driven architecture using markdown-based requirements with Docker Compose template validation and database-backed configuration management.
Specification-driven requirements document using markdown-based documentation pattern with no executable code architecture.
## tags
database, spec, defines, modified, requirements, tool, type, management
system, spec, defines, modified, requirements, tool, type, management
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/traefik-deployment (index)
dir: 2026-06-14-completed-specs-archive/traefik-deployment
# openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment
## role
Defines deployment specifications for the Traefik reverse proxy/load balancer using Docker Compose
Defines infrastructure requirements for deploying Traefik reverse proxy via Docker Compose with environment-specific domain routing rules.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/traefik-deployment
dir: 2026-06-14-completed-specs-archive/traefik-deployment
# openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment
index: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md
## role
Defines deployment specifications for the Traefik reverse proxy/load balancer using Docker Compose
Defines infrastructure requirements for deploying Traefik reverse proxy via Docker Compose with environment-specific domain routing rules.
## files
- spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC
- spec.md | Defines requirements for Traefik Docker Compose deployment configuration with environment-based domain routing | dep: Docker Compose, Traefik, Authentik, OIDC
## arch
Infrastructure-as-code pattern with containerized reverse proxy, environment-based configuration, and declarative service specification
Specification-as-code pattern using markdown-based documentation to capture deployment configuration requirements for containerized ingress controller infrastructure.
## tags
traefik, spec, specifies, requirements, docker, compose, deployment, configuration
traefik, spec, defines, requirements, docker, compose, deployment, configuration
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/tunnel-health-monitoring (index)
dir: 2026-06-14-completed-specs-archive/tunnel-health-monitoring
# openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring
## role
Defines specifications for automated health monitoring and recovery of cloudflared tunnels to ensure persistent connectivity for running instances.
Defines requirements for monitoring cloudflared tunnel health and automatically recreating broken tunnels
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/tunnel-health-monitoring
dir: 2026-06-14-completed-specs-archive/tunnel-health-monitoring
# openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring
index: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md
## role
Defines specifications for automated health monitoring and recovery of cloudflared tunnels to ensure persistent connectivity for running instances.
Defines requirements for monitoring cloudflared tunnel health and automatically recreating broken tunnels
## files
- spec.md | Defines requirements for monitoring and recreating cloudflared tunnels for running instances | dep: cloudflared, HTTP health checks, UI components
- spec.md | Specifies requirements for tunnel health monitoring and broken tunnel recreation functionality in a system using cloudflared tunnels | dep: cloudflared, HTTP, UI
## arch
Requirements-driven specification document using prose-based system design with functional requirements, success criteria, and operational parameters for a tunnel health monitoring subsystem.
Specification-driven requirements document using markdown-based technical specification pattern with functional requirements decomposition
## tags
cloudflared, spec, defines, requirements, monitoring, recreating, tunnels, running
tunnel, cloudflared, spec, specifies, requirements, health, monitoring, broken
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/user-config (index)
dir: 2026-06-14-completed-specs-archive/user-config
# openspec/changes/archive/2026-06-14-completed-specs-archive/user-config (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config
## role
Defines data specifications for a JSONB-based user preference configuration system with frontend theme integration.
Defines a user configuration system specification for storing user preferences as JSONB key-value pairs with frontend integration
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/user-config/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/user-config/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/user-config
dir: 2026-06-14-completed-specs-archive/user-config
# openspec/changes/archive/2026-06-14-completed-specs-archive/user-config
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config
index: 2026-06-14-completed-specs-archive/user-config/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md
## role
Defines data specifications for a JSONB-based user preference configuration system with frontend theme integration.
Defines a user configuration system specification for storing user preferences as JSONB key-value pairs with frontend integration
## files
- spec.md | Defines specifications for a user configuration system that stores JSONB key-value preferences, supports specific config keys, and integrates with frontend theme application. | dep: UserConfig, User, auth-oauth, pytest, mypy, ruff, npm
- spec.md | Defines specification for a user configuration system that stores preferences as JSONB key-value pairs with frontend integration | dep: Database models (UserConfig, User), auth-oauth, pytest, mypy, ruff, npm typecheck, npm lint
## arch
Specification-driven schema design using JSONB key-value store with enumerated config keys and frontend theme mapping pattern.
Specification-driven architecture using JSONB flexible schema pattern for key-value storage with frontend-backend contract definition
## tags
user, spec, defines, specifications, configuration, system, stores, jsonb
spec, defines, specification, user, configuration, system, stores, preferences
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-14-completed-specs-archive/user-profile (index)
dir: 2026-06-14-completed-specs-archive/user-profile
# openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile (index)
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile
## role
Defines functional specifications for user profile retrieval, updates, and local avatar storage.
Defines archived specification requirements for user profile management functionality including data retrieval, updates, and local avatar storage.
## parent
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
## children
-
## files
- spec.md
## links
index: 2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/user-profile/.pi-map.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-14-completed-specs-archive/user-profile
dir: 2026-06-14-completed-specs-archive/user-profile
# openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile
dir: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile
index: 2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md
index: openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md
## role
Defines functional specifications for user profile retrieval, updates, and local avatar storage.
Defines archived specification requirements for user profile management functionality including data retrieval, updates, and local avatar storage.
## files
- spec.md | Defines functional specifications for a user profile management system including profile retrieval, updates, and local avatar storage | dep: auth-oauth, User database model, pytest, mypy, ruff, npm/typecheck, npm/lint
- spec.md | Specifies requirements for user profile management including retrieval, updates, and local avatar storage | dep: auth-oauth, User database model, pytest, mypy, ruff, npm typecheck, npm lint
## arch
Specification-driven design with clear functional requirements documentation.
Specification-driven architecture using markdown-based requirements documentation with dated archival organization for completed feature specifications.
## tags
profile, npm, spec, defines, functional, specifications, user, management
spec, specifies, requirements, user, profile, management, including, retrieval
## symbols
-
## workflows