Add TUI Phase 1: interactive browse and detail views

Extract browse queries into commons SDK (BrowseWanted, BrowseFilter,
WantedSummary) for reuse by both CLI and TUI. Add bubbletea/bubbles
dependencies and implement the wl tui subcommand with:

- Browse view: scrollable item list with status/type cycling, search
- Detail view: full item display with completion/stamp data, action hints
- Ayu-themed styling, status bar with key hints, alt-screen mode

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: julianknutsen

cmd/wl/cmd_browse.go

@@ -51,7 +51,7 @@ EXAMPLES:
   wl browse --search auth            # Search in title
   wl browse --ephemeral              # Clone upstream (slow)`,
 		RunE: func(cmd *cobra.Command, _ []string) error {
-			return runBrowse(cmd, stdout, stderr, BrowseFilter{
+			return runBrowse(cmd, stdout, stderr, commons.BrowseFilter{
 				Status:    status,
 				Project:   project,
 				Type:      itemType,
@@ -84,7 +84,7 @@ EXAMPLES:
 	return cmd
 }
 
-func runBrowse(cmd *cobra.Command, stdout, _ io.Writer, filter BrowseFilter, jsonOut, ephemeral bool) error {
+func runBrowse(cmd *cobra.Command, stdout, _ io.Writer, filter commons.BrowseFilter, jsonOut, ephemeral bool) error {
 	cfg, err := resolveWasteland(cmd)
 	if err != nil {
 		return fmt.Errorf("loading wasteland config: %w", err)
@@ -94,7 +94,7 @@ func runBrowse(cmd *cobra.Command, stdout, _ io.Writer, filter BrowseFilter, jso
 		return err
 	}
 
-	query := buildBrowseQuery(filter)
+	query := commons.BuildBrowseQuery(filter)
 
 	if ephemeral {
 		return runBrowseEphemeral(stdout, cfg, query, jsonOut)
@@ -165,53 +165,6 @@ func runBrowseEphemeral(stdout io.Writer, cfg *federation.Config, query string,
 	return renderBrowseTable(stdout, doltPath, cloneDir, query)
 }
 
-// BrowseFilter holds filter parameters for building a browse query.
-type BrowseFilter struct {
-	Status    string
-	Project   string
-	Type      string
-	Priority  int
-	Limit     int
-	PostedBy  string
-	ClaimedBy string
-	Search    string
-}
-
-func buildBrowseQuery(f BrowseFilter) string {
-	var conditions []string
-
-	if f.Status != "" {
-		conditions = append(conditions, fmt.Sprintf("status = '%s'", commons.EscapeSQL(f.Status)))
-	}
-	if f.Project != "" {
-		conditions = append(conditions, fmt.Sprintf("project = '%s'", commons.EscapeSQL(f.Project)))
-	}
-	if f.Type != "" {
-		conditions = append(conditions, fmt.Sprintf("type = '%s'", commons.EscapeSQL(f.Type)))
-	}
-	if f.Priority >= 0 {
-		conditions = append(conditions, fmt.Sprintf("priority = %d", f.Priority))
-	}
-	if f.PostedBy != "" {
-		conditions = append(conditions, fmt.Sprintf("posted_by = '%s'", commons.EscapeSQL(f.PostedBy)))
-	}
-	if f.ClaimedBy != "" {
-		conditions = append(conditions, fmt.Sprintf("claimed_by = '%s'", commons.EscapeSQL(f.ClaimedBy)))
-	}
-	if f.Search != "" {
-		conditions = append(conditions, fmt.Sprintf("title LIKE '%%%s%%'", commons.EscapeSQL(f.Search)))
-	}
-
-	query := "SELECT id, title, project, type, priority, posted_by, status, effort_level FROM wanted"
-	if len(conditions) > 0 {
-		query += " WHERE " + strings.Join(conditions, " AND ")
-	}
-	query += " ORDER BY priority ASC, created_at DESC"
-	query += fmt.Sprintf(" LIMIT %d", f.Limit)
-
-	return query
-}
-
 func renderBrowseCSV(stdout io.Writer, csvData string) error {
 	rows := wlParseCSV(csvData)
 	if len(rows) <= 1 {

cmd/wl/cmd_browse_test.go

@@ -3,6 +3,8 @@ package main
 import (
 	"strings"
 	"testing"
+
+	"github.com/julianknutsen/wasteland/internal/commons"
 )
 
 func TestWlParseCSV_Empty(t *testing.T) {
@@ -132,28 +134,35 @@ func TestWlFormatPriority(t *testing.T) {
 
 func TestBuildBrowseQuery_DefaultFilters(t *testing.T) {
 	t.Parallel()
-	f := BrowseFilter{
+	f := commons.BrowseFilter{
 		Status:   "open",
 		Priority: -1,
 		Limit:    50,
 	}
-	got := buildBrowseQuery(f)
-	want := "SELECT id, title, project, type, priority, posted_by, status, effort_level FROM wanted WHERE status = 'open' ORDER BY priority ASC, created_at DESC LIMIT 50"
-	if got != want {
-		t.Errorf("buildBrowseQuery(default) =\n  %q\nwant\n  %q", got, want)
+	got := commons.BuildBrowseQuery(f)
+	for _, substr := range []string{
+		"SELECT id, title,",
+		"FROM wanted",
+		"WHERE status = 'open'",
+		"ORDER BY priority ASC, created_at DESC",
+		"LIMIT 50",
+	} {
+		if !strings.Contains(got, substr) {
+			t.Errorf("commons.BuildBrowseQuery(default) missing %q in:\n  %q", substr, got)
+		}
 	}
 }
 
 func TestBuildBrowseQuery_AllFilters(t *testing.T) {
 	t.Parallel()
-	f := BrowseFilter{
+	f := commons.BrowseFilter{
 		Status:   "open",
 		Project:  "gastown",
 		Type:     "bug",
 		Priority: 0,
 		Limit:    5,
 	}
-	got := buildBrowseQuery(f)
+	got := commons.BuildBrowseQuery(f)
 	for _, substr := range []string{
 		"status = 'open'",
 		"project = 'gastown'",
@@ -162,32 +171,32 @@ func TestBuildBrowseQuery_AllFilters(t *testing.T) {
 		"LIMIT 5",
 	} {
 		if !strings.Contains(got, substr) {
-			t.Errorf("buildBrowseQuery(all) missing %q in %q", substr, got)
+			t.Errorf("commons.BuildBrowseQuery(all) missing %q in %q", substr, got)
 		}
 	}
 }
 
 func TestBuildBrowseQuery_NoFilters(t *testing.T) {
 	t.Parallel()
-	f := BrowseFilter{
+	f := commons.BrowseFilter{
 		Priority: -1,
 		Limit:    50,
 	}
-	got := buildBrowseQuery(f)
+	got := commons.BuildBrowseQuery(f)
 	if strings.Contains(got, "WHERE") {
-		t.Errorf("buildBrowseQuery(none) should not have WHERE clause: %q", got)
+		t.Errorf("commons.BuildBrowseQuery(none) should not have WHERE clause: %q", got)
 	}
 }
 
 func TestBuildBrowseQuery_EscapesSQL(t *testing.T) {
 	t.Parallel()
-	f := BrowseFilter{
+	f := commons.BrowseFilter{
 		Status:   "it's",
 		Priority: -1,
 		Limit:    50,
 	}
-	got := buildBrowseQuery(f)
+	got := commons.BuildBrowseQuery(f)
 	if !strings.Contains(got, "it''s") {
-		t.Errorf("buildBrowseQuery should escape single quotes: %q", got)
+		t.Errorf("commons.BuildBrowseQuery should escape single quotes: %q", got)
 	}
 }

cmd/wl/cmd_tui.go

@@ -0,0 +1,57 @@
+package main
+
+import (
+	"fmt"
+	"io"
+
+	bubbletea "github.com/charmbracelet/bubbletea"
+	"github.com/julianknutsen/wasteland/internal/commons"
+	"github.com/julianknutsen/wasteland/internal/style"
+	"github.com/julianknutsen/wasteland/internal/tui"
+	"github.com/spf13/cobra"
+)
+
+func newTUICmd(stdout, stderr io.Writer) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "tui",
+		Short: "Interactive terminal UI for browsing the wanted board",
+		Args:  cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			return runTUI(cmd, stdout, stderr)
+		},
+	}
+	return cmd
+}
+
+func runTUI(cmd *cobra.Command, _, stderr io.Writer) error {
+	cfg, err := resolveWasteland(cmd)
+	if err != nil {
+		return fmt.Errorf("loading wasteland config: %w", err)
+	}
+
+	if err := requireDolt(); err != nil {
+		return err
+	}
+
+	// Sync before launching the TUI.
+	sp := style.StartSpinner(stderr, "Syncing with upstream...")
+	err = commons.PullUpstream(cfg.LocalDir)
+	sp.Stop()
+	if err != nil {
+		return fmt.Errorf("pulling upstream: %w", err)
+	}
+
+	upstream := cfg.Upstream
+
+	m := tui.New(tui.Config{
+		DBDir:     cfg.LocalDir,
+		RigHandle: cfg.RigHandle,
+		Upstream:  upstream,
+	})
+
+	p := bubbletea.NewProgram(m, bubbletea.WithAltScreen())
+	if _, err := p.Run(); err != nil {
+		return fmt.Errorf("TUI error: %w", err)
+	}
+	return nil
+}

cmd/wl/main.go

@@ -97,6 +97,7 @@ func newRootCmd(stdout, stderr io.Writer) *cobra.Command {
 		newRequestChangesCmd(stdout, stderr),
 		newMergeCmd(stdout, stderr),
 		newVerifyCmd(stdout, stderr),
+		newTUICmd(stdout, stderr),
 		newDoctorCmd(stdout, stderr),
 		newVersionCmd(stdout),
 	)