headquarter/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.md

openspec/changes/archive/2026-05-22-instance-proxy

dir: openspec/changes/archive/2026-05-22-instance-proxy

index: openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md

role

Defines an OpenSpec change proposal for implementing an authenticated HTTP/WebSocket proxy to expose internal Docker tool instances through a unified API endpoint.

files

• .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
• design.md | Design document for implementing an HTTP/WebSocket proxy in FastAPI to allow users to access internal Docker tool instances through a single authenticated API endpoint. | dep: FastAPI, httpx, starlette.websockets, Docker, Docker network, ToolInstance model
• proposal.md | Proposes adding an HTTP/WebSocket proxy endpoint to expose Docker-hosted tool instances to users over HTTPS instead of broken localhost links | dep: Docker, backend API, frontend, WebSocket, HTTPS
• tasks.md | A completed task list tracking the implementation of a proxy endpoint system for tool instances, including backend proxy functionality, frontend URL updates, and testing/quality verification.

arch

Documentation-driven specification pattern using OpenSpec change tracking with phased task breakdown (backend proxy → frontend integration → testing) for FastAPI-based WebSocket/HTTP proxy architecture.

tags

proxy, docker, design, websocket, tool, instances, endpoint, .openspec

symbols

workflows

dirty