The binary encoding was using 16-bit unsigned integers which failed when:
- Terminal has many rows (>65k)
- Cursor is above the viewport (negative relative position)
Changes:
- Upgrade to version 2 of the binary format
- Use 32-bit integers for dimensions and positions
- Use signed integers for viewport/cursor positions
- Update header size from 16 to 32 bytes
- Update documentation to reflect new format
This fixes the issue where cursorY could be negative when the cursor
is above the visible viewport (e.g., cursorY=0, viewportY=46 results
in relative cursorY=-46).
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major architectural change: replaced tail -f streaming with direct file watching
and server-side terminal state management for better performance and efficiency.
Key changes:
- Add StreamWatcher class using fs.watch() instead of tail -f process
- Benchmarks showed fs.watch() is faster and more efficient
- Handles multiple SSE clients per session without duplicate processes
- Streams existing content then watches for new data
- Add TerminalManager class for server-side xterm.js instances
- Maintains headless terminal state per session
- Watches stream files and feeds data into terminals
- Provides binary buffer snapshots on demand
- Add new /api/sessions/{id}/buffer endpoint
- Returns efficient binary terminal buffer snapshots
- Supports viewportY and lines parameters for partial updates
- Uses run-length encoding for compression
- Create comprehensive binary format documentation (snapshot-format.md)
- 16-byte header with dimensions and cursor position
- Variable-length cell encoding with UTF-8 and RGB support
- ~75% size reduction compared to JSON
- Fix cmdline.join() error with defensive programming
- Handle cases where cmdline might not be an array
This enables session-list.ts to efficiently show terminal states without
overwhelming client/server resources.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
