Skip to content

feat(tui): add guided workflow orchestrator with health-first startup (#248)#422

Merged
nextlevelshit merged 2 commits intomainfrom
248-guided-tui-orchestrator
Mar 16, 2026
Merged

feat(tui): add guided workflow orchestrator with health-first startup (#248)#422
nextlevelshit merged 2 commits intomainfrom
248-guided-tui-orchestrator

Conversation

@nextlevelshit
Copy link
Copy Markdown
Collaborator

Summary

  • Adds guided workflow orchestrator to the TUI with health-first startup sequence
  • Implements health check list/detail views showing project doctor results before pipeline selection
  • Adds pipeline suggestion list with DAG preview showing step dependencies and parallelism
  • Introduces content area component system with navigation between health, suggestion, and DAG views
  • Includes comprehensive test coverage for all new TUI components (content, health list, pipeline list, suggest list, suggest DAG, statusbar)

Closes #248

Spec

specs/248-guided-tui-orchestrator/spec.md

Test Plan

  • All new components have dedicated unit tests with table-driven test cases
  • go test -race ./... passes with 0 failures
  • Tests cover view rendering, keyboard navigation, state transitions, and edge cases (empty lists, boundary navigation)

Known Limitations

  • P2 features (fleet monitoring, view toggle navigation) and P3 (sequence/parallel execution wiring) are not yet implemented — tracked in the spec for follow-up
  • DAG preview is read-only; interactive step selection is future work

…#248)

Implement guided TUI mode activated when `wave` is run with no subcommand.
The guided flow progresses through health checks → proposals → fleet
monitoring with a state machine layered above the existing view system.

Key changes:
- GuidedFlowState machine with 4 phases (Health, Proposals, Fleet, Attached)
- Health completion tracking emits HealthAllCompleteMsg for auto-transition
- Tab toggles between Suggest and Pipelines in guided mode
- Number keys 1-8 for direct view navigation
- Suggest list supports skip (s) and modify (m) key handlers
- DAG preview rendering for sequence/parallel proposals
- Archive divider separating active from completed runs in fleet view
- SequenceGroup field on RunningPipeline/FinishedPipeline for grouping
- Guided-specific status bar hints
- 580+ tests passing with zero regressions
@nextlevelshit nextlevelshit merged commit 1e23085 into main Mar 16, 2026
7 checks passed
@nextlevelshit nextlevelshit deleted the 248-guided-tui-orchestrator branch March 30, 2026 16:20
nextlevelshit added a commit that referenced this pull request Apr 12, 2026
feat(tui): add guided workflow orchestrator with health-first startup (#248)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(tui): guided workflow orchestrator — wave as default entry point with health → proposals → execution

1 participant