Files
headquarter/openspec/changes/archive/2026-05-14-codeserver-spawn/proposal.md
T
alex 78aaddb2b5
CI / Web CI (push) Failing after 12s
CI / API CI (push) Failing after 1m1s
docs(openspec): add OpenSpec changes for FN-005, FN-006, FN-008, FN-009, FN-010
- Add frontend-foundation change (FN-005) with 46 tasks
- Add deployment-config change (FN-006) with 27 tasks
- Add runfusion-poc/opencode-poc change (FN-008) with 25 tasks
- Add config-secrets change (FN-009) with 31 tasks
- Add codeserver-spawn change (FN-010) with 38 tasks
- Include project specsheet and configuration
- Archive completed deployment-config change
2026-05-14 17:35:20 +02:00

1.6 KiB

Why

Tool registry (FN-003) and deployment config (FN-006) are prerequisites for spawning tools. code-server is the primary user-facing tool in MVP. Without a spawn flow, users cannot launch development environments, which is the core value proposition.

What Changes

  • code-server manifest refinement: Update the built-in manifest with proper Docker image, ports, volumes, and config options
  • Spawn flow API: Backend endpoint that creates a tool instance, generates Docker Compose service, and starts the container
  • Frontend spawn UI: Form for selecting tool, project, and optional config overrides
  • Runtime integration: Mount workspace, configs, secrets, and SSH keys into the code-server container
  • Auth proxy: Ensure code-server is protected behind the platform's auth (no separate code-server password)
  • Status tracking: Poll container status and expose it via API

Capabilities

New Capabilities

  • tool-spawn-api: Backend endpoint for spawning tool instances
  • codeserver-manifest: Refined code-server manifest with runtime configuration
  • spawn-ui: Frontend form for tool selection and spawn configuration
  • container-lifecycle: Start, stop, and status tracking for tool containers

Modified Capabilities

  • None (extends existing tool registry)

Impact

  • apps/api/app/tools/manifests/code-server.yml: Updated manifest
  • apps/api/app/routers/tool_instances.py: Spawn endpoint enhancements
  • apps/api/app/services/spawn.py: New spawn orchestration service
  • apps/web/src/: New spawn UI components
  • docker-compose.yml: May need updates for Docker socket access