Add host-type pivot to session grouping (#195)

Group and pivot sessions by host type (GitHub, Azure DevOps) in the TUI,
alongside the existing folder/repo/branch/date pivots. Adds the host pivot
to the cycle order, a dedicated host icon, and friendly group labels at
render time. Falls back safely when the store schema predates host_type.

Closes #190

Co-authored-by: Copilot App <[email protected]>

Author: jongio

internal/config/config.go

@@ -52,7 +52,7 @@ type NamedView struct {
 	// SortOrder is the sort direction ("asc" or "desc").
 	SortOrder string `json:"sort_order,omitempty"`
 
-	// Pivot is the grouping mode (e.g. "none", "folder", "repo", "branch", "date").
+	// Pivot is the grouping mode (e.g. "none", "folder", "repo", "branch", "date", "host").
 	Pivot string `json:"pivot,omitempty"`
 
 	// FavoritesOnly restricts the list to favorited sessions.
@@ -93,7 +93,7 @@ func (v *NamedView) Validate() error {
 	}
 	if v.Pivot != "" {
 		switch v.Pivot {
-		case PivotNone, PivotFolder, PivotRepo, PivotBranch, PivotDate:
+		case PivotNone, PivotFolder, PivotRepo, PivotBranch, PivotDate, PivotHost:
 		default:
 			return fmt.Errorf("named view %q: invalid pivot %q", v.Name, v.Pivot)
 		}
@@ -128,7 +128,7 @@ type Config struct {
 	DefaultSortOrder string `json:"default_sort_order,omitempty"`
 
 	// DefaultPivot is the default grouping applied to session lists.
-	// Valid values: "none", "folder", "repo", "branch", "date".
+	// Valid values: "none", "folder", "repo", "branch", "date", "host".
 	DefaultPivot string `json:"default_pivot"`
 
 	// ShowPreview controls whether the detail/preview panel is visible.
@@ -339,6 +339,7 @@ const (
 	PivotRepo   = "repo"
 	PivotBranch = "branch"
 	PivotDate   = "date"
+	PivotHost   = "host"
 )
 
 // EffectivePaneDirection returns the configured pane direction, defaulting

internal/data/models.go

@@ -269,6 +269,9 @@ const (
 	PivotByBranch PivotField = "branch"
 	// PivotByDate groups sessions by date (YYYY-MM-DD).
 	PivotByDate PivotField = "date"
+	// PivotByHost groups sessions by host type (the provider that created
+	// the session, e.g. "github" or "ado").
+	PivotByHost PivotField = "host_type"
 )
 
 // SessionGroup holds a set of sessions that share a common pivot label.

internal/data/store.go

@@ -431,6 +431,8 @@ func pivotExpr(p PivotField) string {
 		return "COALESCE(s.branch, '')"
 	case PivotByDate:
 		return lastActiveExpr
+	case PivotByHost:
+		return "COALESCE(s.host_type, '')"
 	default: // PivotByFolder and any unknown value
 		return coalesceCwd
 	}
@@ -1004,6 +1006,11 @@ func (s *Store) GroupSessions(ctx context.Context, pivot PivotField, filter Filt
 	fb.apply(s.withAutoExclusions(filter))
 
 	expr := pivotExpr(pivot)
+	// Older schemas (pre-v3) have no host_type column. Fall back to a single
+	// empty-label group rather than issuing a query that would error.
+	if pivot == PivotByHost && !s.hasHostType {
+		expr = "''"
+	}
 	q := fmt.Sprintf("SELECT %s AS pivot_label, %s FROM sessions s%s%s%s ORDER BY pivot_label, %s %s",
 		expr, s.sessionColumns(), countJoins, fb.joinSQL(), fb.whereSQL(), sortColumn(sort.Field), sortDir(sort.Order))
 

internal/data/store_coverage_test.go

@@ -304,6 +304,7 @@ func TestCovPivotExpr_AllFields(t *testing.T) {
 		{PivotByRepo, "COALESCE(s.repository, '')"},
 		{PivotByBranch, "COALESCE(s.branch, '')"},
 		{PivotByDate, lastActiveExpr},
+		{PivotByHost, "COALESCE(s.host_type, '')"},
 		{PivotByFolder, "COALESCE(s.cwd, '')"},
 		{"unknown", "COALESCE(s.cwd, '')"},
 	}
@@ -372,7 +373,7 @@ func TestCovGroupSessions_AllPivots(t *testing.T) {
 	defer func() { _ = s.Close() }()
 	populateTestData(t, s)
 
-	pivots := []PivotField{PivotByFolder, PivotByRepo, PivotByBranch, PivotByDate}
+	pivots := []PivotField{PivotByFolder, PivotByRepo, PivotByBranch, PivotByDate, PivotByHost}
 	for _, p := range pivots {
 		t.Run(string(p), func(t *testing.T) {
 			groups, err := s.GroupSessions(context.Background(), p, FilterOptions{}, SortOptions{Field: SortByUpdated, Order: Descending}, 100)

internal/data/store_test.go

@@ -1675,6 +1675,7 @@ func TestPivotExpr(t *testing.T) {
 		{PivotByRepo, "COALESCE(s.repository, '')"},
 		{PivotByBranch, "COALESCE(s.branch, '')"},
 		{PivotByDate, lastActiveExpr},
+		{PivotByHost, "COALESCE(s.host_type, '')"},
 		{PivotField("unknown"), "COALESCE(s.cwd, '')"}, // defaults to folder
 	}
 	for _, tt := range tests {

internal/tui/components/sessionlist.go

@@ -107,7 +107,7 @@ func (s *SessionList) SetGroups(groups []data.SessionGroup) {
 }
 
 // SetPivotField stores the current pivot mode so that group header icons
-// reflect the active grouping dimension (folder, repo, branch, date).
+// reflect the active grouping dimension (folder, repo, branch, date, host).
 func (s *SessionList) SetPivotField(pivot string) {
 	s.pivotField = pivot
 }
@@ -697,6 +697,9 @@ func (s SessionList) renderFolderRow(item displayItem, selected bool) string {
 	}
 
 	folder := AbbrevHome(item.folderPath)
+	if s.pivotField == "host" {
+		folder = hostGroupLabel(item.folderPath)
+	}
 	count := strconv.Itoa(item.count)
 
 	prefix := " " + arrow + " "
@@ -716,6 +719,21 @@ func (s SessionList) renderFolderRow(item displayItem, selected bool) string {
 	return styles.GroupHeaderStyle.Render(PadToWidth(line, s.width))
 }
 
+// hostGroupLabel maps a raw host type value to a readable group label for the
+// host pivot. Empty values fall into a single clearly named group.
+func hostGroupLabel(hostType string) string {
+	switch hostType {
+	case "github":
+		return "GitHub"
+	case "ado":
+		return "Azure DevOps"
+	case "":
+		return "No host"
+	default:
+		return hostType
+	}
+}
+
 func (s SessionList) renderSessionRow(sess data.Session, selected bool, hidden bool, aiFound bool, favorited bool) string {
 	w := s.width
 	if w <= 0 {

internal/tui/components/sessionlist_hostpivot_test.go

@@ -0,0 +1,48 @@
+package components
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/jongio/dispatch/internal/data"
+)
+
+func TestHostGroupLabel(t *testing.T) {
+	tests := []struct {
+		in   string
+		want string
+	}{
+		{"github", "GitHub"},
+		{"ado", "Azure DevOps"},
+		{"", "No host"},
+		{"other", "other"},
+	}
+	for _, tt := range tests {
+		if got := hostGroupLabel(tt.in); got != tt.want {
+			t.Errorf("hostGroupLabel(%q) = %q, want %q", tt.in, got, tt.want)
+		}
+	}
+}
+
+func TestHostPivotRendersFriendlyLabels(t *testing.T) {
+	sl := NewSessionList()
+	sl.SetPivotField("host")
+	sl.SetGroups([]data.SessionGroup{
+		{Label: "github", Count: 2, Sessions: []data.Session{
+			{ID: "1", HostType: "github"},
+			{ID: "2", HostType: "github"},
+		}},
+		{Label: "", Count: 1, Sessions: []data.Session{
+			{ID: "3"},
+		}},
+	})
+	sl.SetSize(80, 20)
+
+	view := sl.View()
+	if !strings.Contains(view, "GitHub") {
+		t.Errorf("expected view to contain friendly host label 'GitHub'\n%s", view)
+	}
+	if !strings.Contains(view, "No host") {
+		t.Errorf("expected view to contain 'No host' for empty host type\n%s", view)
+	}
+}

internal/tui/model.go

@@ -137,6 +137,7 @@ const (
 	pivotRepo   = "repo"
 	pivotBranch = "branch"
 	pivotDate   = "date"
+	pivotHost   = "host"
 )
 
 // ---------------------------------------------------------------------------
@@ -199,7 +200,7 @@ type Model struct {
 	filter     data.FilterOptions
 	sort       data.SortOptions
 	timeRange  string         // "1h", "1d", "7d", "all"
-	pivot      string         // "none", "folder", "repo", "branch", "date"
+	pivot      string         // "none", "folder", "repo", "branch", "date", "host"
 	pivotOrder data.SortOrder // group header sort direction
 
 	// Loaded data.
@@ -2858,7 +2859,7 @@ func (m *Model) toggleSortOrder() {
 	m.saveConfig()
 }
 
-var pivotModes = []string{pivotNone, pivotFolder, pivotRepo, pivotBranch, pivotDate}
+var pivotModes = []string{pivotNone, pivotFolder, pivotRepo, pivotBranch, pivotDate, pivotHost}
 
 func (m *Model) cyclePivot() {
 	for i, p := range pivotModes {
@@ -4012,6 +4013,8 @@ func pivotFieldFromString(s string) data.PivotField {
 		return data.PivotByBranch
 	case pivotDate:
 		return data.PivotByDate
+	case pivotHost:
+		return data.PivotByHost
 	default:
 		return data.PivotByFolder
 	}

internal/tui/model_coverage_test.go

@@ -497,8 +497,8 @@ func TestCovCyclePivotFullCycle(t *testing.T) {
 	m := newTestModel()
 	m.pivot = pivotNone
 
-	// pivotModes = [none, folder, repo, branch, date]
-	expected := []string{pivotFolder, pivotRepo, pivotBranch, pivotDate, pivotNone}
+	// pivotModes = [none, folder, repo, branch, date, host]
+	expected := []string{pivotFolder, pivotRepo, pivotBranch, pivotDate, pivotHost, pivotNone}
 	for _, exp := range expected {
 		m.cyclePivot()
 		if m.pivot != exp {

internal/tui/model_helpers_test.go

@@ -56,6 +56,7 @@ func TestPivotFieldFromString(t *testing.T) {
 		{"repo", data.PivotByRepo},
 		{"branch", data.PivotByBranch},
 		{"date", data.PivotByDate},
+		{"host", data.PivotByHost},
 		{"none", data.PivotByFolder}, // unknown → folder
 		{"", data.PivotByFolder},
 		{"unknown", data.PivotByFolder},
@@ -755,7 +756,7 @@ func TestCyclePivot(t *testing.T) {
 	m := newTestModel()
 	m.pivot = pivotNone
 
-	expected := []string{pivotFolder, pivotRepo, pivotBranch, pivotDate, pivotNone}
+	expected := []string{pivotFolder, pivotRepo, pivotBranch, pivotDate, pivotHost, pivotNone}
 	for _, exp := range expected {
 		m.cyclePivot()
 		if m.pivot != exp {