fix(FN-868): add terminal bootstrap error handling with retry and improve workflow step manager

- Add bootstrap error state and retry logic to useTerminalSessions hook to prevent indefinite 'Starting terminal' hang
- Add error/retry UI states in TerminalModal component with CSS styling
- Add tests for useTerminalSessions bootstrap error and retry behavior
- Refactor WorkflowStepManager with template support and improved UX
- Extract CSS from inline styles to stylesheet for terminal and workflow components
- Document terminal startup error handling and non-hanging guarantee in dashboard README
This commit is contained in:
gsxdsm
2026-04-04 07:11:40 -07:00
parent f5430f6ed2
commit 6c3f540e0e
6 changed files with 352 additions and 10 deletions

View File

@@ -160,6 +160,12 @@ Saved scripts (managed via the Scripts modal or QuickScripts dropdown in the hea
- Sessions can be restarted when shell exits
- Graceful shutdown with SIGTERM, then SIGKILL fallback
**Startup Failure Handling**:
- Terminal startup never hangs indefinitely — if the backend session cannot be created (server unavailable, network error, etc.), the modal shows a clear error message instead of a stuck loading spinner
- Users see an actionable error with a "Retry" button that re-attempts terminal creation without closing the modal
- On successful retry, the terminal initializes normally; the error state clears automatically
- Existing sessions (tabs) that are already connected are not affected by bootstrap errors on new tabs
### Git Manager
The Git Manager provides comprehensive repository visualization and management directly from the web UI. Access it via the Git Branch icon button in the header (desktop: inline with other utility buttons, mobile: in the overflow menu).
- **Safety Validation**: Dangerous commands (rm -rf /, etc.) are automatically blocked