chore: track all project map and index files
Add generated .pi-map.md and .pi-map.index.md files across the repository so the project navigation maps are shared and versioned. These artifacts are maintained by project_map_init/patch/validate and must be kept in sync with source edits. Note: .cache/ remains ignored (added in previous commit).
This commit is contained in:
Developer
@@ -0,0 +1,124 @@
|
||||
# openspec/specs (index)
|
||||
dir: openspec/specs
|
||||
|
||||
## role
|
||||
Contains formal specification documents defining requirements, APIs, algorithms, and test strategies for core platform features across configuration management, container orchestration, terminal I/O, and tool definition systems.
|
||||
## parent
|
||||
index: openspec/.pi-map.index.md
|
||||
map: openspec/.pi-map.md
|
||||
## children
|
||||
- openspec/specs/api-documentation
|
||||
index: openspec/specs/api-documentation/.pi-map.index.md
|
||||
map: openspec/specs/api-documentation/.pi-map.md
|
||||
- openspec/specs/auth-oauth
|
||||
index: openspec/specs/auth-oauth/.pi-map.index.md
|
||||
map: openspec/specs/auth-oauth/.pi-map.md
|
||||
- openspec/specs/database-models
|
||||
index: openspec/specs/database-models/.pi-map.index.md
|
||||
map: openspec/specs/database-models/.pi-map.md
|
||||
- openspec/specs/docker-infrastructure
|
||||
index: openspec/specs/docker-infrastructure/.pi-map.index.md
|
||||
map: openspec/specs/docker-infrastructure/.pi-map.md
|
||||
- openspec/specs/frontend-foundation
|
||||
index: openspec/specs/frontend-foundation/.pi-map.index.md
|
||||
map: openspec/specs/frontend-foundation/.pi-map.md
|
||||
- openspec/specs/git-repo
|
||||
index: openspec/specs/git-repo/.pi-map.index.md
|
||||
map: openspec/specs/git-repo/.pi-map.md
|
||||
- openspec/specs/instance-proxy
|
||||
index: openspec/specs/instance-proxy/.pi-map.index.md
|
||||
map: openspec/specs/instance-proxy/.pi-map.md
|
||||
- openspec/specs/instance-runtime-health
|
||||
index: openspec/specs/instance-runtime-health/.pi-map.index.md
|
||||
map: openspec/specs/instance-runtime-health/.pi-map.md
|
||||
- openspec/specs/instance-startup-health
|
||||
index: openspec/specs/instance-startup-health/.pi-map.index.md
|
||||
map: openspec/specs/instance-startup-health/.pi-map.md
|
||||
- openspec/specs/mobile-list-detail
|
||||
index: openspec/specs/mobile-list-detail/.pi-map.index.md
|
||||
map: openspec/specs/mobile-list-detail/.pi-map.md
|
||||
- openspec/specs/mobile-navigation
|
||||
index: openspec/specs/mobile-navigation/.pi-map.index.md
|
||||
map: openspec/specs/mobile-navigation/.pi-map.md
|
||||
- openspec/specs/mobile-repo-workspace
|
||||
index: openspec/specs/mobile-repo-workspace/.pi-map.index.md
|
||||
map: openspec/specs/mobile-repo-workspace/.pi-map.md
|
||||
- openspec/specs/mobile-tools-navigation
|
||||
index: openspec/specs/mobile-tools-navigation/.pi-map.index.md
|
||||
map: openspec/specs/mobile-tools-navigation/.pi-map.md
|
||||
- openspec/specs/opencode-web-server
|
||||
index: openspec/specs/opencode-web-server/.pi-map.index.md
|
||||
map: openspec/specs/opencode-web-server/.pi-map.md
|
||||
- openspec/specs/project-management
|
||||
index: openspec/specs/project-management/.pi-map.index.md
|
||||
map: openspec/specs/project-management/.pi-map.md
|
||||
- openspec/specs/readiness-probe-integration
|
||||
index: openspec/specs/readiness-probe-integration/.pi-map.index.md
|
||||
map: openspec/specs/readiness-probe-integration/.pi-map.md
|
||||
- openspec/specs/repo-clone-mode
|
||||
index: openspec/specs/repo-clone-mode/.pi-map.index.md
|
||||
map: openspec/specs/repo-clone-mode/.pi-map.md
|
||||
- openspec/specs/session-lifecycle-ux
|
||||
index: openspec/specs/session-lifecycle-ux/.pi-map.index.md
|
||||
map: openspec/specs/session-lifecycle-ux/.pi-map.md
|
||||
- openspec/specs/sessions-hub
|
||||
index: openspec/specs/sessions-hub/.pi-map.index.md
|
||||
map: openspec/specs/sessions-hub/.pi-map.md
|
||||
- openspec/specs/smart-tunnel-recovery
|
||||
index: openspec/specs/smart-tunnel-recovery/.pi-map.index.md
|
||||
map: openspec/specs/smart-tunnel-recovery/.pi-map.md
|
||||
- openspec/specs/ssh-keys
|
||||
index: openspec/specs/ssh-keys/.pi-map.index.md
|
||||
map: openspec/specs/ssh-keys/.pi-map.md
|
||||
- openspec/specs/tool-config-management
|
||||
index: openspec/specs/tool-config-management/.pi-map.index.md
|
||||
map: openspec/specs/tool-config-management/.pi-map.md
|
||||
- openspec/specs/tool-instances
|
||||
index: openspec/specs/tool-instances/.pi-map.index.md
|
||||
map: openspec/specs/tool-instances/.pi-map.md
|
||||
- openspec/specs/tool-port-configuration
|
||||
index: openspec/specs/tool-port-configuration/.pi-map.index.md
|
||||
map: openspec/specs/tool-port-configuration/.pi-map.md
|
||||
- openspec/specs/tool-terminal
|
||||
index: openspec/specs/tool-terminal/.pi-map.index.md
|
||||
map: openspec/specs/tool-terminal/.pi-map.md
|
||||
- openspec/specs/tool-terminal-startup-command
|
||||
index: openspec/specs/tool-terminal-startup-command/.pi-map.index.md
|
||||
map: openspec/specs/tool-terminal-startup-command/.pi-map.md
|
||||
- openspec/specs/tool-type-port-visibility
|
||||
index: openspec/specs/tool-type-port-visibility/.pi-map.index.md
|
||||
map: openspec/specs/tool-type-port-visibility/.pi-map.md
|
||||
- openspec/specs/tool-type-single-interface
|
||||
index: openspec/specs/tool-type-single-interface/.pi-map.index.md
|
||||
map: openspec/specs/tool-type-single-interface/.pi-map.md
|
||||
- openspec/specs/tool-types
|
||||
index: openspec/specs/tool-types/.pi-map.index.md
|
||||
map: openspec/specs/tool-types/.pi-map.md
|
||||
- openspec/specs/tool-types-definition
|
||||
index: openspec/specs/tool-types-definition/.pi-map.index.md
|
||||
map: openspec/specs/tool-types-definition/.pi-map.md
|
||||
- openspec/specs/traefik-deployment
|
||||
index: openspec/specs/traefik-deployment/.pi-map.index.md
|
||||
map: openspec/specs/traefik-deployment/.pi-map.md
|
||||
- openspec/specs/tunnel-health-monitoring
|
||||
index: openspec/specs/tunnel-health-monitoring/.pi-map.index.md
|
||||
map: openspec/specs/tunnel-health-monitoring/.pi-map.md
|
||||
- openspec/specs/user-config
|
||||
index: openspec/specs/user-config/.pi-map.index.md
|
||||
map: openspec/specs/user-config/.pi-map.md
|
||||
- openspec/specs/user-profile
|
||||
index: openspec/specs/user-profile/.pi-map.index.md
|
||||
map: openspec/specs/user-profile/.pi-map.md
|
||||
## files
|
||||
- config-profile-multi-repo-mounts.md
|
||||
- home-path-expansion.md
|
||||
- mount-specificity-ordering.md
|
||||
- terminal-responsiveness.md
|
||||
- tool-definition-manifest.md
|
||||
## links
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,23 @@
|
||||
# openspec/specs
|
||||
dir: openspec/specs
|
||||
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Contains formal specification documents defining requirements, APIs, algorithms, and test strategies for core platform features across configuration management, container orchestration, terminal I/O, and tool definition systems.
|
||||
## files
|
||||
- config-profile-multi-repo-mounts.md | Specifies requirements, API contracts, and test strategy for supporting multiple directory mappings per git repository mount in configuration profiles
|
||||
- home-path-expansion.md | Specifies requirements for expanding `~` and `$HOME` in container mount paths during Docker compose generation based on manifest user configuration.
|
||||
- mount-specificity-ordering.md | Specifies requirements and algorithm for sorting Docker volume mounts by target path depth to ensure parent mounts are applied before child mounts | dep: manifest_compiler.py, tool_instances.py, logging
|
||||
- terminal-responsiveness.md | Specification document for a high-performance web terminal I/O pipeline rewrite targeting sub-frame latency with event-driven PTY reading, output batching, flow control, and WebGL rendering. | dep: asyncio, pty, docker, WebSocket, xterm.js, WebGL, TypeScript, Python
|
||||
- tool-definition-manifest.md | Specifies a declarative manifest system for defining tool containers without Dockerfiles, including compilation to Docker/Compose, versioning, permission policies, and backward compatibility. | dep: Docker, Docker Compose, JSON Schema, database (PostgreSQL with JSONB), Alembic, Python/FastAPI (implied by paths)
|
||||
## arch
|
||||
Specification-driven development pattern using Markdown-based RFCs/ADRs that separate design documentation from implementation, covering behavioral contracts, edge cases, and verification strategies before coding.
|
||||
## tags
|
||||
mounts, docker, specifies, mount, manifest, requirements, home, path
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/api-documentation (index)
|
||||
dir: openspec/specs/api-documentation
|
||||
|
||||
## role
|
||||
Defines OpenAPI specification, health monitoring, and developer onboarding requirements for the FastAPI-based system.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/api-documentation/.pi-map.index.md
|
||||
map: openspec/specs/api-documentation/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/api-documentation
|
||||
dir: openspec/specs/api-documentation
|
||||
|
||||
index: openspec/specs/api-documentation/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines OpenAPI specification, health monitoring, and developer onboarding requirements for the 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
|
||||
## arch
|
||||
Specification-driven documentation using Markdown-based requirements with FastAPI-native patterns (OpenAPI, health endpoints, auto-generated docs).
|
||||
## tags
|
||||
fastapi, spec, define, api, documentation, health, monitoring, developer
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/auth-oauth (index)
|
||||
dir: openspec/specs/auth-oauth
|
||||
|
||||
## role
|
||||
Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/auth-oauth/.pi-map.index.md
|
||||
map: openspec/specs/auth-oauth/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/auth-oauth
|
||||
dir: openspec/specs/auth-oauth
|
||||
|
||||
index: openspec/specs/auth-oauth/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik 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
|
||||
## arch
|
||||
Specification-driven contract using markdown-based OpenAPI-style documentation for security requirements, session lifecycle, and token management patterns
|
||||
## tags
|
||||
spec, specifies, oauth2, oidc, authentication, requirements, authentik, secure
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/database-models (index)
|
||||
dir: openspec/specs/database-models
|
||||
|
||||
## role
|
||||
Defines the database schema, SQLAlchemy 2.0 async ORM models, and migration infrastructure for the Headquarter platform's six core entities.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/database-models/.pi-map.index.md
|
||||
map: openspec/specs/database-models/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/database-models
|
||||
dir: openspec/specs/database-models
|
||||
|
||||
index: openspec/specs/database-models/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the database schema, SQLAlchemy 2.0 async ORM models, and migration infrastructure for the Headquarter platform's six core entities.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven architecture using SQLAlchemy 2.0 async declarative models with Alembic for migrations, seeding support, and strict separation between schema definition and implementation.
|
||||
## tags
|
||||
alembic, spec, define, database, schema, sqlalchemy, async, models
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/docker-infrastructure (index)
|
||||
dir: openspec/specs/docker-infrastructure
|
||||
|
||||
## role
|
||||
Defines Docker-based infrastructure specifications for multi-service development and production deployment environments.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/docker-infrastructure/.pi-map.index.md
|
||||
map: openspec/specs/docker-infrastructure/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/docker-infrastructure
|
||||
dir: openspec/specs/docker-infrastructure
|
||||
|
||||
index: openspec/specs/docker-infrastructure/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines Docker-based infrastructure specifications for multi-service development and production deployment 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
|
||||
## arch
|
||||
Infrastructure-as-code specification using Docker containerization with environment-specific configurations for development and production deployments.
|
||||
## tags
|
||||
docker, spec, define, infrastructure, specifications, multi, service, development
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/frontend-foundation (index)
|
||||
dir: openspec/specs/frontend-foundation
|
||||
|
||||
## role
|
||||
Defines the frontend foundation specification for a modern React 18+ TypeScript application with Vite tooling, routing, styling, and authentication patterns.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/frontend-foundation/.pi-map.index.md
|
||||
map: openspec/specs/frontend-foundation/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/frontend-foundation
|
||||
dir: openspec/specs/frontend-foundation
|
||||
|
||||
index: openspec/specs/frontend-foundation/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the frontend foundation specification for a modern React 18+ TypeScript application with Vite tooling, routing, styling, and authentication patterns.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven architecture using Vite for build tooling, React Router for client-side routing with authenticated route guards, Tailwind CSS for utility-first styling, and a modular dashboard/tool workshop layout pattern.
|
||||
## tags
|
||||
react, vite, spec, define, specification, modern, typescript, frontend
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/git-repo (index)
|
||||
dir: openspec/specs/git-repo
|
||||
|
||||
## role
|
||||
Defines the specification for a bare git repository management service that coordinates on-disk git storage with database-backed metadata.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/git-repo/.pi-map.index.md
|
||||
map: openspec/specs/git-repo/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/git-repo
|
||||
dir: openspec/specs/git-repo
|
||||
|
||||
index: openspec/specs/git-repo/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the specification for a bare git repository management service that coordinates on-disk git storage with database-backed metadata.
|
||||
## 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
|
||||
## arch
|
||||
Domain-driven specification pattern with clear separation between storage concerns (filesystem git operations) and metadata concerns (database records), using SSH key-based access control and duplicate prevention logic.
|
||||
## tags
|
||||
spec, specifies, requirements, managing, bare, git, repositories, disk
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/instance-proxy (index)
|
||||
dir: openspec/specs/instance-proxy
|
||||
|
||||
## role
|
||||
Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-scoped access control.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/instance-proxy/.pi-map.index.md
|
||||
map: openspec/specs/instance-proxy/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/instance-proxy
|
||||
dir: openspec/specs/instance-proxy
|
||||
|
||||
index: openspec/specs/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-scoped 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
|
||||
## arch
|
||||
Specification-driven API design using markdown-based OpenAPI-style documentation with WebSocket upgrade support, reverse proxy patterns, and owner-based authorization middleware.
|
||||
## tags
|
||||
spec, specifies, api, requirements, http, websocket, proxy, endpoint
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/instance-runtime-health (index)
|
||||
dir: openspec/specs/instance-runtime-health
|
||||
|
||||
## role
|
||||
Defines health monitoring and container state synchronization requirements for container lifecycle management.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/instance-runtime-health/.pi-map.index.md
|
||||
map: openspec/specs/instance-runtime-health/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/instance-runtime-health
|
||||
dir: openspec/specs/instance-runtime-health
|
||||
|
||||
index: openspec/specs/instance-runtime-health/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines health monitoring and container state synchronization requirements for container lifecycle management.
|
||||
## files
|
||||
- spec.md | Specification document defining health monitoring, polling, and container state synchronization requirements for a container/instance management system | dep: Docker, HTTP tunneling, REST API
|
||||
## arch
|
||||
Specification-driven design using requirement-based documentation with polling-based health checks and state reconciliation patterns.
|
||||
## tags
|
||||
container, spec, specification, document, defining, health, monitoring, polling
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/instance-startup-health (index)
|
||||
dir: openspec/specs/instance-startup-health
|
||||
|
||||
## role
|
||||
Defines behavioral specifications for container health verification during tool instance startup lifecycle.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/instance-startup-health/.pi-map.index.md
|
||||
map: openspec/specs/instance-startup-health/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/instance-startup-health
|
||||
dir: openspec/specs/instance-startup-health
|
||||
|
||||
index: openspec/specs/instance-startup-health/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines behavioral specifications for container health verification during tool instance startup lifecycle.
|
||||
## files
|
||||
- spec.md | Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose | dep: docker compose, docker ps, readiness probes, tunnels, health endpoints, database
|
||||
## arch
|
||||
Specification-driven validation using Markdown-based requirements documentation with Docker Compose integration patterns.
|
||||
## tags
|
||||
spec, defines, requirements, container, startup, verification, readiness, probe
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-list-detail (index)
|
||||
dir: openspec/specs/mobile-list-detail
|
||||
|
||||
## role
|
||||
Defines mobile UI specification for a configuration management system with list/detail views and CRUD operations.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/mobile-list-detail/.pi-map.index.md
|
||||
map: openspec/specs/mobile-list-detail/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-list-detail
|
||||
dir: openspec/specs/mobile-list-detail
|
||||
|
||||
index: openspec/specs/mobile-list-detail/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines mobile UI specification for a configuration management system with list/detail views and CRUD operations.
|
||||
## 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.
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements documentation for mobile list-detail UI pattern with editing capabilities.
|
||||
## tags
|
||||
views, spec, defines, mobile, requirements, configuration, management, system
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-navigation (index)
|
||||
dir: openspec/specs/mobile-navigation
|
||||
|
||||
## role
|
||||
Defines mobile navigation UI requirements for grouped bottom navigation with expandable submenu behavior.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/mobile-navigation/.pi-map.index.md
|
||||
map: openspec/specs/mobile-navigation/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-navigation
|
||||
dir: openspec/specs/mobile-navigation
|
||||
|
||||
index: openspec/specs/mobile-navigation/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines mobile navigation UI requirements for grouped bottom navigation with expandable submenu behavior.
|
||||
## files
|
||||
- spec.md | Defines requirements for grouped bottom navigation with submenu behavior on mobile
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirement documentation with behavioral state definitions for mobile-responsive interaction patterns.
|
||||
## tags
|
||||
spec, defines, requirements, grouped, bottom, navigation, submenu, behavior
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-repo-workspace (index)
|
||||
dir: openspec/specs/mobile-repo-workspace
|
||||
|
||||
## role
|
||||
Defines functional requirements and user interaction specifications for the mobile repository workspace interface.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/mobile-repo-workspace/.pi-map.index.md
|
||||
map: openspec/specs/mobile-repo-workspace/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-repo-workspace
|
||||
dir: openspec/specs/mobile-repo-workspace
|
||||
|
||||
index: openspec/specs/mobile-repo-workspace/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines functional requirements and user interaction specifications for the mobile repository workspace interface.
|
||||
## files
|
||||
- spec.md | Define mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views
|
||||
## arch
|
||||
Specification-driven design using modular view decomposition (file tree, editor, git, terminal) with responsive mobile UX patterns.
|
||||
## tags
|
||||
spec, define, mobile, requirements, repository, workspace, featuring, tree
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-tools-navigation (index)
|
||||
dir: openspec/specs/mobile-tools-navigation
|
||||
|
||||
## role
|
||||
Defines the specification for mobile bottom navigation UI behavior and interaction patterns for the Tools menu.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/mobile-tools-navigation/.pi-map.index.md
|
||||
map: openspec/specs/mobile-tools-navigation/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/mobile-tools-navigation
|
||||
dir: openspec/specs/mobile-tools-navigation
|
||||
|
||||
index: openspec/specs/mobile-tools-navigation/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the specification for mobile bottom navigation UI behavior and interaction patterns for the Tools menu.
|
||||
## files
|
||||
- spec.md | Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements documentation with behavioral state definitions for UI components.
|
||||
## tags
|
||||
bottom, spec, defines, mobile, requirements, grouped, tools, navigation
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/opencode-web-server (index)
|
||||
dir: openspec/specs/opencode-web-server
|
||||
|
||||
## role
|
||||
Defines the specification for a web-based terminal server container that provides browser-accessible development tools via tmux and ranger.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/opencode-web-server/.pi-map.index.md
|
||||
map: openspec/specs/opencode-web-server/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/opencode-web-server
|
||||
dir: openspec/specs/opencode-web-server
|
||||
|
||||
index: openspec/specs/opencode-web-server/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the specification for a web-based terminal server container that provides browser-accessible development tools via tmux and ranger.
|
||||
## 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
|
||||
## arch
|
||||
Container-based microservice specification with tunnel-based networking exposure and UI integration points for embedded terminal access.
|
||||
## tags
|
||||
spec, specifies, requirements, opencode, containers, run, web, terminal
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/project-management (index)
|
||||
dir: openspec/specs/project-management
|
||||
|
||||
## role
|
||||
Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/project-management/.pi-map.index.md
|
||||
map: openspec/specs/project-management/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/project-management
|
||||
dir: openspec/specs/project-management
|
||||
|
||||
index: openspec/specs/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.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements documentation.
|
||||
## tags
|
||||
project, management, ssh, spec, defines, requirements, system, groups
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/readiness-probe-integration (index)
|
||||
dir: openspec/specs/readiness-probe-integration
|
||||
|
||||
## role
|
||||
Defines requirements for container readiness probe configuration, execution, and result storage during instance startup
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/readiness-probe-integration/.pi-map.index.md
|
||||
map: openspec/specs/readiness-probe-integration/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/readiness-probe-integration
|
||||
dir: openspec/specs/readiness-probe-integration
|
||||
|
||||
index: openspec/specs/readiness-probe-integration/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines requirements for container readiness probe configuration, execution, and result storage during instance startup
|
||||
## files
|
||||
- spec.md | Defines requirements for container readiness probe configuration, execution, and result storage during instance startup | dep: docker, container orchestration, health endpoint, logging system
|
||||
## arch
|
||||
Specification-driven documentation pattern using markdown-based requirements definition with no executable code architecture
|
||||
## tags
|
||||
spec, defines, requirements, container, readiness, probe, configuration, execution
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/repo-clone-mode (index)
|
||||
dir: openspec/specs/repo-clone-mode
|
||||
|
||||
## role
|
||||
Defines the contract for host-side git repository cloning operations to enable containerized tools to work with local code.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/repo-clone-mode/.pi-map.index.md
|
||||
map: openspec/specs/repo-clone-mode/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/repo-clone-mode
|
||||
dir: openspec/specs/repo-clone-mode
|
||||
|
||||
index: openspec/specs/repo-clone-mode/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the contract for host-side git repository cloning operations to enable containerized tools to work with local code.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements documentation with SSH key management and dirty-state detection concerns.
|
||||
## tags
|
||||
git, spec, specifies, requirements, host, side, repository, cloning
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/session-lifecycle-ux (index)
|
||||
dir: openspec/specs/session-lifecycle-ux
|
||||
|
||||
## role
|
||||
Defines user experience requirements for session lifecycle management interactions
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/session-lifecycle-ux/.pi-map.index.md
|
||||
map: openspec/specs/session-lifecycle-ux/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/session-lifecycle-ux
|
||||
dir: openspec/specs/session-lifecycle-ux
|
||||
|
||||
index: openspec/specs/session-lifecycle-ux/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines user experience requirements for session lifecycle management interactions
|
||||
## files
|
||||
- spec.md | Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates
|
||||
## arch
|
||||
Specification-driven requirements documentation using behavioral scenario descriptions with explicit user flow states and UI feedback expectations
|
||||
## tags
|
||||
spec, defines, software, requirements, session, management, behaviors, including
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/sessions-hub (index)
|
||||
dir: openspec/specs/sessions-hub
|
||||
|
||||
## role
|
||||
Defines technical specifications for a centralized user session management feature that enables viewing, filtering, and terminating active sessions across devices.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/sessions-hub/.pi-map.index.md
|
||||
map: openspec/specs/sessions-hub/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/sessions-hub
|
||||
dir: openspec/specs/sessions-hub
|
||||
|
||||
index: openspec/specs/sessions-hub/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines technical specifications for a centralized user session management feature that enables viewing, filtering, and terminating active sessions across devices.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven design using structured documentation with hierarchical sections (requirements, API, UI, state, quality gates) to enforce contract-first development between frontend and backend teams.
|
||||
## tags
|
||||
sessions, spec, defines, technical, specifications, hub, feature, including
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/smart-tunnel-recovery (index)
|
||||
dir: openspec/specs/smart-tunnel-recovery
|
||||
|
||||
## role
|
||||
Defines health check classification requirements to distinguish infrastructure tunnel failures from application-level errors and specify their respective UI behaviors and automated recovery procedures.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/smart-tunnel-recovery/.pi-map.index.md
|
||||
map: openspec/specs/smart-tunnel-recovery/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/smart-tunnel-recovery
|
||||
dir: openspec/specs/smart-tunnel-recovery
|
||||
|
||||
index: openspec/specs/smart-tunnel-recovery/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines health check classification requirements to distinguish infrastructure tunnel failures from application-level errors and specify their respective UI behaviors and automated recovery procedures.
|
||||
## files
|
||||
- spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system with different UI behaviors and recovery actions.
|
||||
## arch
|
||||
Specification-driven requirements document using scenario-based behavioral specification with clear separation between failure domains (tunnel vs. application), state-based recovery actions, and conditional UI response patterns.
|
||||
## tags
|
||||
spec, specifies, requirements, classifying, tunnel, failures, versus, application
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/ssh-keys (index)
|
||||
dir: openspec/specs/ssh-keys
|
||||
|
||||
## role
|
||||
Defines security requirements for SSH key generation, storage, and access control for Git operations.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/ssh-keys/.pi-map.index.md
|
||||
map: openspec/specs/ssh-keys/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/ssh-keys
|
||||
dir: openspec/specs/ssh-keys
|
||||
|
||||
index: openspec/specs/ssh-keys/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines security requirements for SSH key generation, storage, and access control for Git operations.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven security policy using Ed25519 cryptography with project-scoped RBAC for multi-tenant key isolation.
|
||||
## tags
|
||||
project, spec, specifies, requirements, generating, managing, securing, ed25519
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-config-management (index)
|
||||
dir: openspec/specs/tool-config-management
|
||||
|
||||
## role
|
||||
Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-config-management/.pi-map.index.md
|
||||
map: openspec/specs/tool-config-management/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-config-management
|
||||
dir: openspec/specs/tool-config-management
|
||||
|
||||
index: openspec/specs/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.
|
||||
## files
|
||||
- spec.md | Defines requirements for a tool configuration system with runtime fields, split-pane UI, JSON editors, and validation
|
||||
## arch
|
||||
Specification-driven architecture using markdown-based requirements documentation with UI/UX patterns for split-pane interfaces, JSON schema validation, and runtime field configuration.
|
||||
## tags
|
||||
spec, defines, requirements, tool, configuration, system, runtime, fields
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-instances (index)
|
||||
dir: openspec/specs/tool-instances
|
||||
|
||||
## role
|
||||
Defines requirements for managing tool instances with health monitoring, tunnel connectivity, clone mode, and SSH key operations.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-instances/.pi-map.index.md
|
||||
map: openspec/specs/tool-instances/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-instances
|
||||
dir: openspec/specs/tool-instances
|
||||
|
||||
index: openspec/specs/tool-instances/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines requirements for managing tool instances with health monitoring, tunnel connectivity, clone mode, and SSH key operations.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven requirements document using structured markdown with sections for status, health checks, tunnels, clone mode, and SSH keys.
|
||||
## tags
|
||||
management, spec, define, modified, added, requirements, tool, instance
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-port-configuration (index)
|
||||
dir: openspec/specs/tool-port-configuration
|
||||
|
||||
## role
|
||||
Defines validation requirements for tool port configurations including default ports, compose template exposure, and multi-interface support.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-port-configuration/.pi-map.index.md
|
||||
map: openspec/specs/tool-port-configuration/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-port-configuration
|
||||
dir: openspec/specs/tool-port-configuration
|
||||
|
||||
index: openspec/specs/tool-port-configuration/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines validation requirements for tool port configurations including default ports, compose template exposure, and multi-interface support.
|
||||
## files
|
||||
- spec.md | Defines requirements for tool type validation including default ports, compose template port exposure, and multiple interface support
|
||||
## arch
|
||||
Specification-driven requirements document using markdown-based declarative specification pattern.
|
||||
## tags
|
||||
spec, defines, requirements, tool, type, validation, including, default
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-terminal-startup-command (index)
|
||||
dir: openspec/specs/tool-terminal-startup-command
|
||||
|
||||
## role
|
||||
Defines requirements for pre-shell initialization commands in terminal tool configurations.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-terminal-startup-command/.pi-map.index.md
|
||||
map: openspec/specs/tool-terminal-startup-command/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-terminal-startup-command
|
||||
dir: openspec/specs/tool-terminal-startup-command
|
||||
|
||||
index: openspec/specs/tool-terminal-startup-command/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines requirements for pre-shell initialization commands in terminal tool configurations.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements documents with field extension patterns for tool type schemas.
|
||||
## tags
|
||||
terminal, tool, types, spec, specifies, requirements, adding, optional
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-terminal (index)
|
||||
dir: openspec/specs/tool-terminal
|
||||
|
||||
## role
|
||||
Defines the specification for a browser-based terminal interface that enables secure, real-time access to running Docker containers via WebSocket connections.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-terminal/.pi-map.index.md
|
||||
map: openspec/specs/tool-terminal/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-terminal
|
||||
dir: openspec/specs/tool-terminal
|
||||
|
||||
index: openspec/specs/tool-terminal/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines the specification for a browser-based terminal interface that enables secure, real-time access to running Docker containers via WebSocket connections.
|
||||
## 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
|
||||
## arch
|
||||
WebSocket-based streaming architecture with session management, bidirectional I/O streaming, and access control for containerized environments.
|
||||
## tags
|
||||
spec, specifies, requirements, browser, websocket, terminal, system, accessing
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-type-port-visibility (index)
|
||||
dir: openspec/specs/tool-type-port-visibility
|
||||
|
||||
## role
|
||||
Defines validation rules for conditionally showing or hiding port configuration fields based on whether a tool type requires network port settings.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-type-port-visibility/.pi-map.index.md
|
||||
map: openspec/specs/tool-type-port-visibility/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-type-port-visibility
|
||||
dir: openspec/specs/tool-type-port-visibility
|
||||
|
||||
index: openspec/specs/tool-type-port-visibility/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines validation rules for conditionally showing or hiding port configuration fields based on whether a tool type requires network port settings.
|
||||
## files
|
||||
- spec.md | Defines requirements for conditional port configuration visibility and validation based on a tool type's `requires_port` flag
|
||||
## arch
|
||||
Specification-driven validation pattern using a single markdown specification file to declaratively define conditional UI visibility and form validation requirements.
|
||||
## tags
|
||||
port, spec, defines, requirements, conditional, configuration, visibility, validation
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-type-single-interface (index)
|
||||
dir: openspec/specs/tool-type-single-interface
|
||||
|
||||
## role
|
||||
Defines specification requirements for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-type-single-interface/.pi-map.index.md
|
||||
map: openspec/specs/tool-type-single-interface/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-type-single-interface
|
||||
dir: openspec/specs/tool-type-single-interface
|
||||
|
||||
index: openspec/specs/tool-type-single-interface/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines specification requirements for a tool type system that enforces single interface constraints, validates allowed values, and handles 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
|
||||
## arch
|
||||
Specification-driven architecture using markdown-based requirements documentation with validation rules, allowed value constraints, and data migration patterns for backward compatibility.
|
||||
## tags
|
||||
spec, defines, requirements, enforcing, single, interface, types, validating
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-types-definition (index)
|
||||
dir: openspec/specs/tool-types-definition
|
||||
|
||||
## role
|
||||
Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-types-definition/.pi-map.index.md
|
||||
map: openspec/specs/tool-types-definition/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-types-definition
|
||||
dir: openspec/specs/tool-types-definition
|
||||
|
||||
index: openspec/specs/tool-types-definition/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements documentation with Docker template patterns and variable substitution mechanisms for environment configuration.
|
||||
## tags
|
||||
spec, defines, requirements, tool, type, management, system, crud
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-types (index)
|
||||
dir: openspec/specs/tool-types
|
||||
|
||||
## role
|
||||
Defines specifications for a database-driven tool type management system that replaces hardcoded tool definitions with configurable, migratable records.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tool-types/.pi-map.index.md
|
||||
map: openspec/specs/tool-types/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tool-types
|
||||
dir: openspec/specs/tool-types
|
||||
|
||||
index: openspec/specs/tool-types/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines specifications for a database-driven tool type management system that replaces hardcoded tool definitions with configurable, migratable records.
|
||||
## 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
|
||||
## arch
|
||||
Specification-driven design using markdown-based requirements docs with Docker Compose validation rules and migration patterns for built-in to dynamic tool type conversion.
|
||||
## tags
|
||||
database, spec, defines, modified, requirements, tool, type, management
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/traefik-deployment (index)
|
||||
dir: openspec/specs/traefik-deployment
|
||||
|
||||
## role
|
||||
Defines requirements and documentation standards for Traefik reverse proxy deployment using Docker Compose.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/traefik-deployment/.pi-map.index.md
|
||||
map: openspec/specs/traefik-deployment/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/traefik-deployment
|
||||
dir: openspec/specs/traefik-deployment
|
||||
|
||||
index: openspec/specs/traefik-deployment/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines requirements and documentation standards for Traefik reverse proxy deployment using Docker Compose.
|
||||
## files
|
||||
- spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC
|
||||
## arch
|
||||
Specification-driven configuration with environment-based parameterization and infrastructure-as-code patterns.
|
||||
## tags
|
||||
traefik, spec, specifies, requirements, docker, compose, deployment, configuration
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tunnel-health-monitoring (index)
|
||||
dir: openspec/specs/tunnel-health-monitoring
|
||||
|
||||
## role
|
||||
Defines behavioral specifications for health monitoring and automatic recovery of cloudflared tunnel connections to ensure high availability.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/tunnel-health-monitoring/.pi-map.index.md
|
||||
map: openspec/specs/tunnel-health-monitoring/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/tunnel-health-monitoring
|
||||
dir: openspec/specs/tunnel-health-monitoring
|
||||
|
||||
index: openspec/specs/tunnel-health-monitoring/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines behavioral specifications for health monitoring and automatic recovery of cloudflared tunnel connections to ensure high availability.
|
||||
## files
|
||||
- spec.md | Defines requirements for monitoring and recreating cloudflared tunnels for running instances | dep: cloudflared, HTTP health checks, UI components
|
||||
## arch
|
||||
Specification-driven requirements document using markdown-based behavioral specification pattern with no executable code, focusing on system-level observability and self-healing tunnel infrastructure.
|
||||
## tags
|
||||
cloudflared, spec, defines, requirements, monitoring, recreating, tunnels, running
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/user-config (index)
|
||||
dir: openspec/specs/user-config
|
||||
|
||||
## role
|
||||
Defines data models and API contracts for a user-configurable preferences system with JSONB storage and theme integration.
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/user-config/.pi-map.index.md
|
||||
map: openspec/specs/user-config/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/user-config
|
||||
dir: openspec/specs/user-config
|
||||
|
||||
index: openspec/specs/user-config/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines data models and API contracts for a user-configurable preferences system with JSONB storage and theme 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
|
||||
## arch
|
||||
Specification-driven architecture using markdown-based API documentation with JSONB schema definitions for flexible key-value storage.
|
||||
## tags
|
||||
user, spec, defines, specifications, configuration, system, stores, jsonb
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/user-profile (index)
|
||||
dir: openspec/specs/user-profile
|
||||
|
||||
## role
|
||||
Defines functional specifications for user profile management capabilities including retrieval, updates, and local avatar storage
|
||||
## parent
|
||||
index: openspec/specs/.pi-map.index.md
|
||||
map: openspec/specs/.pi-map.md
|
||||
## children
|
||||
-
|
||||
## files
|
||||
- spec.md
|
||||
## links
|
||||
index: openspec/specs/user-profile/.pi-map.index.md
|
||||
map: openspec/specs/user-profile/.pi-map.md
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
@@ -0,0 +1,19 @@
|
||||
# openspec/specs/user-profile
|
||||
dir: openspec/specs/user-profile
|
||||
|
||||
index: openspec/specs/user-profile/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Defines functional specifications for user profile management capabilities including 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
|
||||
## arch
|
||||
Specification-driven documentation pattern using markdown-based requirements definition without implementation code
|
||||
## tags
|
||||
profile, npm, spec, defines, functional, specifications, user, management
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
-
|
||||
## dirty
|
||||
-
|
||||
Reference in New Issue
Block a user