Skip to content

Complete Phase 3 TUI navigation #38

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
royisme merged 2 commits into from
Nov 18, 2025
Merged

Complete Phase 3 TUI navigation #38

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
030ac50
Add Phase 3 TUI navigation and views
royisme Nov 18, 2025
66864e4
Refactor proxy state strings
royisme Nov 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
207 changes: 134 additions & 73 deletions internal/ui/dashboard.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,16 +39,50 @@ const (

// UI constants for repeated strings
const (
proxyStatusRunning = "running"
proxyStatusStopped = "stopped"
proxyStatusChecking = "checking"
iconCircleFilled = "●"
iconCircleEmpty = "○"
iconCheckmark = "✓"
iconCross = "✗"
helpTextNavigation = "[1-6] Switch View [↑/↓] Navigate [Tab] Next View [Q] Quit"
proxyStatusRunning = "running"
proxyStatusStopped = "stopped"
proxyStatusChecking = "checking"
proxyStateOn = "ON"
proxyStateOff = "OFF"
iconCircleFilled = "●"
iconCircleEmpty = "○"
iconCheckmark = "✓"
iconCross = "✗"
helpTextNavigation = "[1-9,0,H,C,?] Switch View [↑/↓] Navigate [Tab] Next View [Q] Quit"
)

const totalViews viewMode = viewHelp + 1

type reportOption struct {
label string
desc string
}

var reportOptions = []reportOption{
{"Last 7 Days Report", "Generate usage report for the past 7 days"},
{"Last 30 Days Report", "Generate monthly usage report"},
{"Custom Date Range", "Specify custom start and end dates"},
{"JSON Format", "Export report as JSON (default)"},
{"CSV Format", "Export report as CSV for spreadsheet tools"},
{"HTML Format", "Generate visual HTML report with charts"},
}

type configFile struct {
name string
file string
desc string
}

var configFiles = []configFile{
{"Providers", "providers.yaml", "AI provider configurations and API endpoints"},
{"Tools", "tools.yaml", "CLI tool detection and management"},
{"Bindings", "bindings.yaml", "Tool-to-provider bindings and proxy settings"},
{"Secrets", "secrets.yaml", "Encrypted API keys (edit with caution!)"},
{"Routes", "routes.yaml", "Context-based routing rules"},
{"Pricing", "pricing.yaml", "Token pricing for cost calculations"},
{"Settings", "settings.yaml", "Global application settings"},
}

// DashboardModel represents the control plane dashboard
type DashboardModel struct {
home string
Expand Down Expand Up @@ -295,10 +329,10 @@ func (m *DashboardModel) buildTableRows() []table.Row {
}

// Proxy status
proxyStatus := "OFF"
if binding.UseProxy {
proxyStatus = "ON"
}
proxyStatus := proxyStateOff
if binding.UseProxy {
proxyStatus = proxyStateOn
}

rows = append(rows, table.Row{
tool.Name,
Expand Down Expand Up @@ -428,19 +462,19 @@ func (m DashboardModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
m.selectedIndex = 0
return m, nil

case "h":
case "h", "H":
m.currentView = viewHooks
m.selectedIndex = 0
return m, nil

case "c":
case "c", "C":
m.currentView = viewConfig
m.selectedIndex = 0
return m, nil

case "tab":
// Cycle through views
m.currentView = (m.currentView + 1) % 13
m.currentView = (m.currentView + 1) % totalViews
m.selectedIndex = 0
switch m.currentView {
case viewStats:
Expand All @@ -465,11 +499,15 @@ func (m DashboardModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
return m, nil

case "x":
// Toggle proxy for selected tool (only in dashboard view)
if m.currentView == viewDashboard {
// Toggle proxy for selected tool or binding depending on view
switch m.currentView {
case viewDashboard:
return m.handleToggleProxy()
case viewBindings:
return m.handleToggleBindingProxy()
default:
return m, nil
}
return m, nil

case "s":
// Check proxy status
Expand All @@ -495,23 +533,7 @@ func (m DashboardModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {

case "down", "j":
// Navigate down in list views
maxIndex := 0
switch m.currentView {
case viewProviders:
maxIndex = len(m.providers.Providers) - 1
case viewTools:
maxIndex = len(m.tools.Tools) - 1
case viewBindings:
maxIndex = len(m.bindings.Bindings) - 1
case viewSecrets:
maxIndex = len(m.providers.Providers) - 1 // Secrets are per-provider
case viewSuggestions:
maxIndex = len(m.suggestions) - 1
case viewReports:
maxIndex = 5 // 6 report options
case viewConfig:
maxIndex = 6 // 7 config files
}
maxIndex := m.maxSelectableIndex()
if m.currentView != viewDashboard && m.selectedIndex < maxIndex {
m.selectedIndex++
}
Expand All @@ -532,6 +554,27 @@ func (m DashboardModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
return m, cmd
}

func (m DashboardModel) maxSelectableIndex() int {
switch m.currentView {
case viewProviders:
return len(m.providers.Providers) - 1
case viewTools:
return len(m.tools.Tools) - 1
case viewBindings:
return len(m.bindings.Bindings) - 1
case viewSecrets:
return len(m.providers.Providers) - 1 // Secrets are per-provider
case viewSuggestions:
return len(m.suggestions) - 1
case viewReports:
return len(reportOptions) - 1
case viewConfig:
return len(configFiles) - 1
default:
return 0
}
}

// updateTableSize adjusts table dimensions based on window size
func (m *DashboardModel) updateTableSize() {
// Calculate available height for table
Expand Down Expand Up @@ -614,11 +657,49 @@ func (m DashboardModel) handleToggleProxy() (tea.Model, tea.Cmd) {
m.table.SetRows(m.buildTableRows())

// Set success message
proxyState := "OFF"
if binding.UseProxy {
proxyState = "ON"
proxyState := proxyStateOff
if binding.UseProxy {
proxyState = proxyStateOn
}
m.message = fmt.Sprintf("Proxy %s for %s", proxyState, tool.Name)

return m, nil
}

// handleToggleBindingProxy toggles proxy usage for the selected binding in the bindings view
func (m DashboardModel) handleToggleBindingProxy() (tea.Model, tea.Cmd) {
if len(m.bindings.Bindings) == 0 {
m.message = "No bindings configured"
return m, nil
}

if m.selectedIndex < 0 || m.selectedIndex >= len(m.bindings.Bindings) {
m.message = "No binding selected"
return m, nil
}

binding := &m.bindings.Bindings[m.selectedIndex]

toolName := binding.ToolID
if tool, err := m.tools.FindTool(binding.ToolID); err == nil {
toolName = tool.Name
}

binding.UseProxy = !binding.UseProxy

if err := core.SaveBindings(m.home, m.bindings); err != nil {
m.message = fmt.Sprintf("Failed to save binding: %v", err)
return m, nil
}
m.message = fmt.Sprintf("Proxy %s for %s", proxyState, tool.Name)

proxyState := proxyStateOff
if binding.UseProxy {
proxyState = proxyStateOn
}

// Update dashboard table rows to keep views consistent
m.table.SetRows(m.buildTableRows())
m.message = fmt.Sprintf("Proxy %s for %s", proxyState, toolName)

return m, nil
}
Expand Down Expand Up @@ -710,7 +791,7 @@ func (m DashboardModel) renderDashboardView() string {
}

// Footer/Help
helpText := "[1-9] Views [0] Reports [H] Hooks [C] Config [?] Help [R] Run [X] Proxy [Tab] Next [Q] Quit"
helpText := "[1-9,0,H,C,?] Switch View [R] Run Tool [X] Toggle Proxy [Tab] Next View [Q] Quit"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand Down Expand Up @@ -1312,9 +1393,9 @@ func (m DashboardModel) renderProxyView() string {
// Footer/Help
var helpText string
if m.proxyStatus == proxyStatusRunning {
helpText = "[1-9] Switch View [S] Refresh Status [Tab] Next View [Q] Quit"
helpText = "[1-9,0,H,C,?] Switch View [S] Refresh Status [Tab] Next View [Q] Quit"
} else {
helpText = "[1-9] Switch View [S] Refresh Status [Tab] Next View [Q] Quit\n Note: Use 'boba proxy serve' in terminal to start the proxy server"
helpText = "[1-9,0,H,C,?] Switch View [S] Refresh Status [Tab] Next View [Q] Quit\n Note: Use 'boba proxy serve' in terminal to start the proxy server"
}
content.WriteString(helpStyle.Render(helpText))

Expand Down Expand Up @@ -1395,7 +1476,7 @@ func (m DashboardModel) renderRoutingView() string {
content.WriteString("\n\n")

// Footer/Help
helpText := "[1-9] Switch View [Tab] Next View [Q] Quit\n Use CLI: boba route test <text|@file>"
helpText := "[1-9,0,H,C,?] Switch View [Tab] Next View [Q] Quit\n Use CLI: boba route test <text|@file>"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand Down Expand Up @@ -1450,7 +1531,7 @@ func (m DashboardModel) renderSuggestionsView() string {
if m.suggestionsError != "" {
content.WriteString(dangerStyle.Render(fmt.Sprintf(" Error: %s", m.suggestionsError)))
content.WriteString("\n\n")
helpText := "[1-9] Switch View [R] Retry [Tab] Next View [Q] Quit"
helpText := "[1-9,0,H,C,?] Switch View [R] Retry [Tab] Next View [Q] Quit"
content.WriteString(helpStyle.Render(helpText))
return content.String()
}
Expand Down Expand Up @@ -1538,7 +1619,7 @@ func (m DashboardModel) renderSuggestionsView() string {
content.WriteString("\n")

// Footer/Help
helpText := "[1-9] Switch View [↑/↓] Navigate [Tab] Next View [Q] Quit\n Use CLI: boba action [--auto] to apply suggestions"
helpText := "[1-9,0,H,C,?] Switch View [↑/↓] Navigate [Tab] Next View [Q] Quit\n Use CLI: boba action [--auto] to apply suggestions"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand Down Expand Up @@ -1575,17 +1656,8 @@ func (m DashboardModel) renderReportsView() string {
content.WriteString(titleStyle.Render("📊 Generate Usage Report"))
content.WriteString("\n\n")

// Report options
reportOptions := []struct {
label string
desc string
}{
{"Last 7 Days Report", "Generate usage report for the past 7 days"},
{"Last 30 Days Report", "Generate monthly usage report"},
{"Custom Date Range", "Specify custom start and end dates"},
{"JSON Format", "Export report as JSON (default)"},
{"CSV Format", "Export report as CSV for spreadsheet tools"},
{"HTML Format", "Generate visual HTML report with charts"},
if m.selectedIndex >= len(reportOptions) {
m.selectedIndex = 0
}

content.WriteString(headerStyle.Render("Report Options"))
Expand Down Expand Up @@ -1629,7 +1701,7 @@ func (m DashboardModel) renderReportsView() string {
content.WriteString("\n\n")

// Footer/Help
helpText := "[1-9] Switch View [↑/↓] Navigate Options [Tab] Next View [Q] Quit\n Use CLI: boba report --format <json|csv|html> --days <N> --out <file>"
helpText := "[1-9,0,H,C,?] Switch View [↑/↓] Navigate Options [Tab] Next View [Q] Quit\n Use CLI: boba report --format <json|csv|html> --days <N> --out <file>"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand Down Expand Up @@ -1720,7 +1792,7 @@ func (m DashboardModel) renderHooksView() string {
content.WriteString("\n\n")

// Footer/Help
helpText := "[1-9] Switch View [Tab] Next View [Q] Quit\n Use CLI: boba hooks install (to install hooks) | boba hooks remove (to uninstall)"
helpText := "[1-9,0,H,C,?] Switch View [Tab] Next View [Q] Quit\n Use CLI: boba hooks install (to install hooks) | boba hooks remove (to uninstall)"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand All @@ -1744,19 +1816,8 @@ func (m DashboardModel) renderConfigView() string {
content.WriteString(headerStyle.Render("Configuration Files"))
content.WriteString("\n")

// Config files
configFiles := []struct {
name string
file string
desc string
}{
{"Providers", "providers.yaml", "AI provider configurations and API endpoints"},
{"Tools", "tools.yaml", "CLI tool detection and management"},
{"Bindings", "bindings.yaml", "Tool-to-provider bindings and proxy settings"},
{"Secrets", "secrets.yaml", "Encrypted API keys (edit with caution!)"},
{"Routes", "routes.yaml", "Context-based routing rules"},
{"Pricing", "pricing.yaml", "Token pricing for cost calculations"},
{"Settings", "settings.yaml", "Global application settings"},
if m.selectedIndex >= len(configFiles) {
m.selectedIndex = 0
}

for i, cfg := range configFiles {
Expand Down Expand Up @@ -1801,7 +1862,7 @@ func (m DashboardModel) renderConfigView() string {
content.WriteString("\n\n")

// Footer/Help
helpText := "[1-9] Switch View [↑/↓] Navigate [Tab] Next View [Q] Quit\n Use CLI: boba edit <target> (to open in editor)"
helpText := "[1-9,0,H,C,?] Switch View [↑/↓] Navigate [Tab] Next View [Q] Quit\n Use CLI: boba edit <target> (to open in editor)"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand Down Expand Up @@ -1892,7 +1953,7 @@ func (m DashboardModel) renderHelpView() string {
content.WriteString("\n\n")

// Footer/Help
helpText := "Press any number key (1-9, 0) to switch views | [Tab] Next View | [Q] Quit"
helpText := "Use navigation keys (1-9, 0, H, C, ?) to switch views | [Tab] Next View | [Q] Quit"
content.WriteString(helpStyle.Render(helpText))

return content.String()
Expand Down
Loading