Files
headquarter/openspec/changes/persistent-terminal-sessions/.pi-map.md
T
Developer 070cd4d5a5 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).
2026-06-12 13:46:23 +00:00

1.7 KiB

openspec/changes/persistent-terminal-sessions

dir: openspec/changes/persistent-terminal-sessions

index: openspec/changes/persistent-terminal-sessions/.pi-map.index.md

role

Defines requirements and architecture for persistent WebSocket terminal sessions that maintain shell state across reconnections without spawning new docker exec processes.

files

  • .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date 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: TerminalManager, TerminalSession, WebSocket, docker exec, PTY
  • proposal.md | Proposes architectural changes to make WebSocket terminal sessions persistent across reconnections instead of spawning new docker exec processes each time | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.tsx, use-terminal.ts
  • tasks.md | This file is a project task list tracking the implementation of persistent terminal sessions with WebSocket reconnection, reset functionality, and idle timeout management across backend and frontend components. | dep: TerminalSession, TerminalManager, WebSocket, docker exec, API endpoints, frontend terminal component, terminal hook

arch

Specification-driven design using OpenSpec schema with phased implementation (backend session state management, frontend reconnection logic, idle timeout handling) documented across design/proposal/task files.

tags

websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec

symbols

workflows

dirty