Enhance README and implement job history feature in GitLab Runner TUI. Added job history view with recent job runs, status, and duration. Updated main application to support debug mode and improved configuration handling. Introduced HistoryView for displaying job history and integrated it into the main model.

Author: larkinwc

README.md

@@ -6,8 +6,10 @@ A Terminal User Interface (TUI) for managing GitLab runners on Debian hosts. Thi
 
 - **Runner Management**: View all configured GitLab runners with their status
 - **Log Viewer**: Real-time log viewing with filtering and auto-scroll
+- **Job History**: View recent job runs with runner information, status, and duration
 - **Configuration Editor**: Update runner concurrency, limits, and other settings
 - **System Monitor**: View service status, CPU/memory usage, and restart services
+- **Debug Mode**: Enable verbose logging for troubleshooting
 - **Keyboard Navigation**: Easy tab-based navigation between views
 
 ## Prerequisites
@@ -65,14 +67,28 @@ gitlab-runner-tui
 # Run with custom config path
 gitlab-runner-tui -config /path/to/config.toml
 
+# Run in debug mode for verbose logging
+gitlab-runner-tui -debug
+
+# Show help and default paths
+gitlab-runner-tui -help
+
 # If running without sudo, it will check ~/.gitlab-runner/config.toml
 ```
 
+### Default Config Paths
+
+The tool checks for configuration files in this order:
+1. `/etc/gitlab-runner/config.toml` (system-wide)
+2. `~/.gitlab-runner/config.toml` (user-specific)
+
+You can override with the `-config` flag.
+
 ## Keyboard Shortcuts
 
 ### Global
 - `Tab` / `Shift+Tab`: Navigate between tabs
-- `1-4`: Jump to specific tab (Runners, Logs, Config, System)
+- `1-5`: Jump to specific tab (Runners, Logs, Config, System, History)
 - `q`: Quit (or go back from logs view)
 - `Ctrl+C`: Force quit
 
@@ -99,6 +115,10 @@ gitlab-runner-tui -config /path/to/config.toml
 - `r`: Refresh system status
 - `s`: Restart GitLab Runner service
 
+### History View
+- `r`: Refresh job history
+- `↑/↓`: Navigate job list
+
 ## Configuration
 
 The tool reads and modifies the standard GitLab Runner configuration file (usually `/etc/gitlab-runner/config.toml`).

cmd/gitlab-runner-tui/main.go

@@ -19,21 +19,26 @@ type model struct {
 	logsView    *ui.LogsView
 	configView  *ui.ConfigView
 	systemView  *ui.SystemView
+	historyView *ui.HistoryView
 	width       int
 	height      int
 	quitting    bool
+	debugMode   bool
 }
 
-func initialModel(configPath string) model {
+func initialModel(configPath string, debugMode bool) model {
 	service := runner.NewService(configPath)
+	service.SetDebugMode(debugMode)
 
 	return model{
-		tabs:        []string{"Runners", "Logs", "Config", "System"},
+		tabs:        []string{"Runners", "Logs", "Config", "System", "History"},
 		activeTab:   0,
 		runnersView: ui.NewRunnersView(service),
 		logsView:    ui.NewLogsView(service),
 		configView:  ui.NewConfigView(configPath),
 		systemView:  ui.NewSystemView(service),
+		historyView: ui.NewHistoryView(service),
+		debugMode:   debugMode,
 	}
 }
 
@@ -43,6 +48,7 @@ func (m model) Init() tea.Cmd {
 		m.logsView.Init(),
 		m.configView.Init(),
 		m.systemView.Init(),
+		m.historyView.Init(),
 	)
 }
 
@@ -58,6 +64,7 @@ func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		m.logsView.Update(msg)
 		m.configView.Update(msg)
 		m.systemView.Update(msg)
+		m.historyView.Update(msg)
 
 		return m, nil
 
@@ -79,7 +86,7 @@ func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			m.activeTab = (m.activeTab - 1 + len(m.tabs)) % len(m.tabs)
 			return m, nil
 
-		case "1", "2", "3", "4":
+		case "1", "2", "3", "4", "5":
 			if idx := int(msg.String()[0] - '1'); idx < len(m.tabs) {
 				m.activeTab = idx
 			}
@@ -112,6 +119,10 @@ func (m model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		updatedView, cmd := m.systemView.Update(msg)
 		m.systemView = updatedView.(*ui.SystemView)
 		cmds = append(cmds, cmd)
+	case 4:
+		updatedView, cmd := m.historyView.Update(msg)
+		m.historyView = updatedView.(*ui.HistoryView)
+		cmds = append(cmds, cmd)
 	}
 
 	return m, tea.Batch(cmds...)
@@ -134,6 +145,8 @@ func (m model) View() string {
 		content = m.configView.View()
 	case 3:
 		content = m.systemView.View()
+	case 4:
+		content = m.historyView.View()
 	}
 
 	return lipgloss.JoinVertical(
@@ -159,18 +172,49 @@ func (m model) renderTabBar() string {
 
 func main() {
 	var configPath string
-	flag.StringVar(&configPath, "config", "/etc/gitlab-runner/config.toml", "Path to GitLab Runner config file")
+	var debugMode bool
+	var showHelp bool
+	
+	defaultConfig := "/etc/gitlab-runner/config.toml"
+	
+	flag.StringVar(&configPath, "config", defaultConfig, "Path to GitLab Runner config file")
+	flag.BoolVar(&debugMode, "debug", false, "Enable debug mode for verbose logging")
+	flag.BoolVar(&showHelp, "help", false, "Show help information")
+	flag.BoolVar(&showHelp, "h", false, "Show help information")
+	
+	flag.Usage = func() {
+		fmt.Fprintf(os.Stderr, "GitLab Runner TUI - Terminal User Interface for managing GitLab runners\n\n")
+		fmt.Fprintf(os.Stderr, "Usage: %s [options]\n\n", os.Args[0])
+		fmt.Fprintf(os.Stderr, "Options:\n")
+		flag.PrintDefaults()
+		fmt.Fprintf(os.Stderr, "\nDefault config paths checked:\n")
+		fmt.Fprintf(os.Stderr, "  1. %s (system-wide)\n", defaultConfig)
+		fmt.Fprintf(os.Stderr, "  2. $HOME/.gitlab-runner/config.toml (user-specific)\n")
+		fmt.Fprintf(os.Stderr, "\nIf no config is found at the default path, the user-specific path is tried.\n")
+	}
+	
 	flag.Parse()
+	
+	if showHelp {
+		flag.Usage()
+		os.Exit(0)
+	}
 
-	if _, err := os.Stat(configPath); os.IsNotExist(err) {
-		altPath := os.ExpandEnv("$HOME/.gitlab-runner/config.toml")
-		if _, err := os.Stat(altPath); err == nil {
-			configPath = altPath
+	// Check if config exists at specified path
+	if configPath == defaultConfig {
+		if _, err := os.Stat(configPath); os.IsNotExist(err) {
+			altPath := os.ExpandEnv("$HOME/.gitlab-runner/config.toml")
+			if _, err := os.Stat(altPath); err == nil {
+				configPath = altPath
+				if debugMode {
+					fmt.Printf("Using config from: %s\n", configPath)
+				}
+			}
 		}
 	}
 
 	p := tea.NewProgram(
-		initialModel(configPath),
+		initialModel(configPath, debugMode),
 		tea.WithAltScreen(),
 		tea.WithMouseCellMotion(),
 	)

pkg/runner/service.go

@@ -6,6 +6,7 @@ import (
 	"io"
 	"os/exec"
 	"regexp"
+	"strconv"
 	"strings"
 	"time"
 )
@@ -17,6 +18,8 @@ type Service interface {
 	StreamRunnerLogs(name string) (io.ReadCloser, error)
 	RestartRunner() error
 	GetSystemStatus() (*SystemStatus, error)
+	GetJobHistory(limit int) ([]Job, error)
+	SetDebugMode(enabled bool)
 }
 
 type SystemStatus struct {
@@ -30,6 +33,7 @@ type SystemStatus struct {
 
 type gitlabRunnerService struct {
 	configPath string
+	debugMode  bool
 }
 
 func NewService(configPath string) Service {
@@ -126,7 +130,12 @@ func (s *gitlabRunnerService) GetRunnerStatus(name string) (*Runner, error) {
 }
 
 func (s *gitlabRunnerService) GetRunnerLogs(name string, lines int) ([]string, error) {
-	cmd := exec.Command("journalctl", "-u", "gitlab-runner", "-n", fmt.Sprintf("%d", lines), "--no-pager")
+	args := []string{"-u", "gitlab-runner", "-n", fmt.Sprintf("%d", lines), "--no-pager"}
+	if s.debugMode {
+		args = append(args, "-o", "verbose")
+	}
+	
+	cmd := exec.Command("journalctl", args...)
 	output, err := cmd.Output()
 	if err != nil {
 		cmd = exec.Command("tail", "-n", fmt.Sprintf("%d", lines), "/var/log/gitlab-runner.log")
@@ -241,4 +250,130 @@ func extractTimestamp(output string) string {
 		return strings.TrimSpace(parts[1])
 	}
 	return ""
+}
+
+func (s *gitlabRunnerService) GetJobHistory(limit int) ([]Job, error) {
+	var jobs []Job
+	
+	// Try to get job history from journalctl logs
+	cmd := exec.Command("journalctl", "-u", "gitlab-runner", "-n", fmt.Sprintf("%d", limit*10), "--no-pager", "-r")
+	output, err := cmd.Output()
+	if err != nil {
+		// Fallback to log file
+		cmd = exec.Command("tail", "-n", fmt.Sprintf("%d", limit*10), "/var/log/gitlab-runner.log")
+		output, err = cmd.Output()
+		if err != nil {
+			return nil, fmt.Errorf("failed to get job history: %w", err)
+		}
+	}
+
+	lines := strings.Split(string(output), "\n")
+	jobMap := make(map[int]*Job)
+	
+	for _, line := range lines {
+		job := s.parseJobFromLog(line)
+		if job != nil {
+			if existing, ok := jobMap[job.ID]; ok {
+				// Update existing job with new info
+				if job.Status != "" {
+					existing.Status = job.Status
+				}
+				if !job.Started.IsZero() {
+					existing.Started = job.Started
+				}
+				if !job.Finished.IsZero() {
+					existing.Finished = job.Finished
+					existing.Duration = job.Finished.Sub(existing.Started)
+				}
+				if job.RunnerName != "" {
+					existing.RunnerName = job.RunnerName
+				}
+				if job.ExitCode != 0 {
+					existing.ExitCode = job.ExitCode
+				}
+			} else {
+				jobMap[job.ID] = job
+			}
+		}
+		
+		if len(jobMap) >= limit {
+			break
+		}
+	}
+	
+	// Convert map to slice
+	for _, job := range jobMap {
+		jobs = append(jobs, *job)
+	}
+	
+	// Sort by started time (newest first)
+	for i := 0; i < len(jobs)-1; i++ {
+		for j := i + 1; j < len(jobs); j++ {
+			if jobs[i].Started.Before(jobs[j].Started) {
+				jobs[i], jobs[j] = jobs[j], jobs[i]
+			}
+		}
+	}
+	
+	if len(jobs) > limit {
+		jobs = jobs[:limit]
+	}
+	
+	return jobs, nil
+}
+
+func (s *gitlabRunnerService) parseJobFromLog(line string) *Job {
+	// Parse GitLab Runner log lines for job information
+	jobStartRegex := regexp.MustCompile(`job=(\d+).*project=(\d+).*runner=([a-zA-Z0-9_-]+)`)
+	jobStatusRegex := regexp.MustCompile(`job=(\d+).*status=(\w+)`)
+	jobFinishRegex := regexp.MustCompile(`job=(\d+).*duration=([0-9.]+)s`)
+	
+	job := &Job{}
+	
+	// Check for job start
+	if matches := jobStartRegex.FindStringSubmatch(line); len(matches) > 3 {
+		jobID, _ := strconv.Atoi(matches[1])
+		job.ID = jobID
+		job.Project = matches[2]
+		job.RunnerName = matches[3]
+		job.Status = "running"
+		
+		// Try to extract timestamp
+		if idx := strings.Index(line, " "); idx > 0 {
+			timeStr := line[:idx]
+			if t, err := time.Parse("Jan 02 15:04:05", timeStr); err == nil {
+				job.Started = t
+			}
+		}
+		
+		return job
+	}
+	
+	// Check for job status update
+	if matches := jobStatusRegex.FindStringSubmatch(line); len(matches) > 2 {
+		jobID, _ := strconv.Atoi(matches[1])
+		job.ID = jobID
+		job.Status = matches[2]
+		return job
+	}
+	
+	// Check for job completion
+	if matches := jobFinishRegex.FindStringSubmatch(line); len(matches) > 2 {
+		jobID, _ := strconv.Atoi(matches[1])
+		job.ID = jobID
+		job.Status = "completed"
+		
+		if duration, err := strconv.ParseFloat(matches[2], 64); err == nil {
+			job.Duration = time.Duration(duration * float64(time.Second))
+			job.Finished = time.Now()
+		}
+		
+		return job
+	}
+	
+	return nil
+}
+
+func (s *gitlabRunnerService) SetDebugMode(enabled bool) {
+	s.debugMode = enabled
 }

pkg/runner/types.go

@@ -20,14 +20,19 @@ type Runner struct {
 }
 
 type Job struct {
-	ID       int
-	Name     string
-	Status   string
-	Stage    string
-	Project  string
-	Pipeline int
-	Started  time.Time
-	Duration time.Duration
+	ID         int
+	Name       string
+	Status     string
+	Stage      string
+	Project    string
+	Pipeline   int
+	Started    time.Time
+	Finished   time.Time
+	Duration   time.Duration
+	RunnerName string
+	RunnerID   string
+	ExitCode   int
+	URL        string
 }
 
 type Config struct {