Files
the-nexus/docs
Alexander Whitestone b64dbdd980
Some checks failed
Review Approval Gate / verify-review (pull_request) Failing after 10s
CI / test (pull_request) Failing after 52s
CI / validate (pull_request) Failing after 52s
feat: build operator inspector rail and session shell patterns (#1695)
Implements the Atlas cockpit operator surface for the Nexus:

- cockpit.js: frontend operator cockpit module
  - InspectorRail: right-side panel with SESSION/FILES/MEMORY/AGENT tabs
  - SessionStore: session taxonomy (group/tag/pin/archive) via localStorage
    + server sync to cockpit_pty.py
  - GitStatusWidget: branch + dirty badge in workspace HUD
  - CockpitTerminal: xterm.js terminal wired to native PTY via WebSocket
  - Cockpit controller: WS lifecycle, git polling (15s), panel toggles

- cockpit_pty.py: native PTY relay server (ws://127.0.0.1:8766)
  - pty_start / pty_input / pty_resize / pty_exit messages
  - git_status: branch, dirty flag, staged/unstaged/untracked counts,
    ahead/behind upstream
  - session_save / session_load: durable session persistence to disk

- index.html: cockpit toolbar (git badge + INSPECT + SHELL buttons),
  inspector rail mount point, terminal panel, xterm.js CDN scripts

- style.css: inspector rail slide-in, tab nav, session cards,
  git status badges (clean/dirty/error), terminal panel, agent health dots

- docs/ADR-cockpit-shell-boundary.md: ADR-001 choosing native local PTY +
  xterm.js over SSH PTY / ttyd / browser-only pseudo-terminal

- docs/ATLAS_COCKPIT_PATTERNS.md: documents patterns adopted, adapted,
  and rejected from dodo-reach/hermes-desktop, outsourc-e/hermes-workspace,
  nesquena/hermes-webui

Fixes #1695

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-22 01:22:14 -04:00
..