Developer
2.0 KiB
openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
role
Design specification package for persistent WebSocket terminal sessions that survive reconnections by reattaching to existing docker exec processes rather than spawning new ones.
files
- .openspec.yaml | Defines an OpenSpec schema configuration file with metadata
- design.md | Design document for implementing persistent terminal sessions that survive WebSocket disconnections while maintaining shell state and allowing reconnection to the same docker exec process. | dep: WebSocket, docker exec, TerminalManager, TerminalSession, PTY, background task scheduler
- proposal.md | Design proposal for implementing persistent WebSocket terminal sessions that survive reconnections by reattaching to existing docker exec processes instead of spawning new ones. | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.py, terminal.tsx, use-terminal.ts
- tasks.md | A task tracking document outlining the refactoring of a terminal session system to support persistent, reconnectable WebSocket connections with circular output buffers, idle timeouts, and reset functionality across backend and frontend components. | dep: WebSocket, Docker, API backend, React/frontend terminal component
arch
Specification-driven design using OpenSpec schema configuration with layered documentation (proposal → design → tasks) following a structured change-archive pattern for tracking system evolution across backend (Go circular buffers, idle timeouts, process reattachment) and frontend (WebSocket reconnection, reset functionality) components.
tags
terminal, websocket, design, persistent, docker, proposal, .openspec, document