Add curated TUI table overrides for list commands (#4731)

## Why

PR #4729 adds an interactive table for list commands, but its default
behavior is to fall through to template rendering when no table
configuration is registered. For the commands people use most, the table
should start with the fields they actually care about, and it should
enable search where the backend supports it.

These 15 commands were selected based on CLI usage as some of the most
frequently used list commands by customer count.

## Changes

Before: interactive list commands used template rendering with no
curated table configuration.

Now: 15 common list commands register curated columns, and jobs list
plus pipelines list-pipelines also enable / search in the TUI.

This PR builds on #4729. It does not change the table engine itself. It
adds per-command overrides that:

- Choose the columns and column order for each command
- Preserve the existing non-interactive template output
- Enable server-side search where the API supports filtering

Commands covered: jobs list, clusters list, pipelines list-pipelines,
warehouses list, catalogs list, schemas list, tables list, apps list,
repos list, instance-pools list, serving-endpoints list, volumes list,
external-locations list, alerts list, workspace list

### Post-review fixes

- Disable TUI search when `--filter` is already set on pipelines
(composite filters are unsupported)
- Clear stale pagination state (`PageToken`, `Offset`) before
constructing search iterators
- Add backslash escaping to pipelines LIKE filter
- Extract repeated type assertions in apps Extract closures to local
variables

## Test plan

- `go build ./...`
- Manual smoke test: verify curated columns for jobs list, clusters
list, catalogs list, warehouses list, serving-endpoints list
- Manual smoke test: verify / search for jobs list and pipelines
list-pipelines
- `make checks` passes
- `make lintfull` passes (0 issues)

Author: simonfaltum

cmd/workspace/alerts/overrides.go

@@ -0,0 +1,32 @@
+package alerts
+
+import (
+	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
+	"github.com/databricks/databricks-sdk-go/service/sql"
+	"github.com/spf13/cobra"
+)
+
+func listOverride(listCmd *cobra.Command, listReq *sql.ListAlertsRequest) {
+	listCmd.Annotations["template"] = cmdio.Heredoc(`
+	{{range .}}{{green "%s" .Id}}	{{.DisplayName}}	{{.State}}
+	{{end}}`)
+
+	columns := []tableview.ColumnDef{
+		{Header: "ID", Extract: func(v any) string {
+			return v.(sql.ListAlertsResponseAlert).Id
+		}},
+		{Header: "Name", Extract: func(v any) string {
+			return v.(sql.ListAlertsResponseAlert).DisplayName
+		}},
+		{Header: "State", Extract: func(v any) string {
+			return string(v.(sql.ListAlertsResponseAlert).State)
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{Columns: columns})
+}
+
+func init() {
+	listOverrides = append(listOverrides, listOverride)
+}

cmd/workspace/apps/overrides.go

@@ -5,6 +5,7 @@ import (
 
 	appsCli "github.com/databricks/cli/cmd/apps"
 	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
 	"github.com/databricks/databricks-sdk-go/service/apps"
 	"github.com/spf13/cobra"
 )
@@ -15,6 +16,33 @@ func listOverride(listCmd *cobra.Command, listReq *apps.ListAppsRequest) {
 	listCmd.Annotations["template"] = cmdio.Heredoc(`
 	{{range .}}{{.Name | green}}	{{.Url}}	{{if .ComputeStatus}}{{if eq .ComputeStatus.State "ACTIVE"}}{{green "%s" .ComputeStatus.State }}{{else}}{{blue "%s" .ComputeStatus.State}}{{end}}{{end}}	{{if .ActiveDeployment}}{{if eq .ActiveDeployment.Status.State "SUCCEEDED"}}{{green "%s" .ActiveDeployment.Status.State }}{{else}}{{blue "%s" .ActiveDeployment.Status.State}}{{end}}{{end}}
 	{{end}}`)
+
+	columns := []tableview.ColumnDef{
+		{Header: "Name", Extract: func(v any) string {
+			a := v.(apps.App)
+			return a.Name
+		}},
+		{Header: "URL", Extract: func(v any) string {
+			a := v.(apps.App)
+			return a.Url
+		}},
+		{Header: "Compute Status", Extract: func(v any) string {
+			a := v.(apps.App)
+			if a.ComputeStatus != nil {
+				return string(a.ComputeStatus.State)
+			}
+			return ""
+		}},
+		{Header: "Deploy Status", Extract: func(v any) string {
+			a := v.(apps.App)
+			if a.ActiveDeployment != nil && a.ActiveDeployment.Status != nil {
+				return string(a.ActiveDeployment.Status.State)
+			}
+			return ""
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{Columns: columns})
 }
 
 func listDeploymentsOverride(listDeploymentsCmd *cobra.Command, listDeploymentsReq *apps.ListAppDeploymentsRequest) {

cmd/workspace/apps/overrides_test.go

@@ -0,0 +1,68 @@
+package apps
+
+import (
+	"testing"
+
+	"github.com/databricks/cli/libs/tableview"
+	sdkapps "github.com/databricks/databricks-sdk-go/service/apps"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestListTableConfig(t *testing.T) {
+	cmd := newList()
+
+	cfg := tableview.GetConfig(cmd)
+	require.NotNil(t, cfg)
+	require.Len(t, cfg.Columns, 4)
+
+	tests := []struct {
+		name        string
+		app         sdkapps.App
+		wantName    string
+		wantURL     string
+		wantCompute string
+		wantDeploy  string
+	}{
+		{
+			name: "with nested fields",
+			app: sdkapps.App{
+				Name: "test-app",
+				Url:  "https://example.com",
+				ComputeStatus: &sdkapps.ComputeStatus{
+					State: sdkapps.ComputeStateActive,
+				},
+				ActiveDeployment: &sdkapps.AppDeployment{
+					Status: &sdkapps.AppDeploymentStatus{
+						State: sdkapps.AppDeploymentStateSucceeded,
+					},
+				},
+			},
+			wantName:    "test-app",
+			wantURL:     "https://example.com",
+			wantCompute: "ACTIVE",
+			wantDeploy:  "SUCCEEDED",
+		},
+		{
+			name: "nil nested fields",
+			app: sdkapps.App{
+				Name:             "test-app",
+				Url:              "https://example.com",
+				ActiveDeployment: &sdkapps.AppDeployment{},
+			},
+			wantName:    "test-app",
+			wantURL:     "https://example.com",
+			wantCompute: "",
+			wantDeploy:  "",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			assert.Equal(t, tt.wantName, cfg.Columns[0].Extract(tt.app))
+			assert.Equal(t, tt.wantURL, cfg.Columns[1].Extract(tt.app))
+			assert.Equal(t, tt.wantCompute, cfg.Columns[2].Extract(tt.app))
+			assert.Equal(t, tt.wantDeploy, cfg.Columns[3].Extract(tt.app))
+		})
+	}
+}

cmd/workspace/catalogs/overrides.go

@@ -2,6 +2,7 @@ package catalogs
 
 import (
 	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
 	"github.com/databricks/databricks-sdk-go/service/catalog"
 	"github.com/spf13/cobra"
 )
@@ -12,6 +13,20 @@ func listOverride(listCmd *cobra.Command, listReq *catalog.ListCatalogsRequest)
 	listCmd.Annotations["template"] = cmdio.Heredoc(`
 	{{range .}}{{.Name|green}}	{{blue "%s" .CatalogType}}	{{.Comment}}
 	{{end}}`)
+
+	columns := []tableview.ColumnDef{
+		{Header: "Name", Extract: func(v any) string {
+			return v.(catalog.CatalogInfo).Name
+		}},
+		{Header: "Type", Extract: func(v any) string {
+			return string(v.(catalog.CatalogInfo).CatalogType)
+		}},
+		{Header: "Comment", MaxWidth: 40, Extract: func(v any) string {
+			return v.(catalog.CatalogInfo).Comment
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{Columns: columns})
 }
 
 func init() {

cmd/workspace/clusters/overrides.go

@@ -4,6 +4,7 @@ import (
 	"strings"
 
 	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
 	"github.com/databricks/databricks-sdk-go/service/compute"
 	"github.com/spf13/cobra"
 )
@@ -17,6 +18,20 @@ func listOverride(listCmd *cobra.Command, listReq *compute.ListClustersRequest)
 	{{range .}}{{.ClusterId | green}}	{{.ClusterName | cyan}}	{{if eq .State "RUNNING"}}{{green "%s" .State}}{{else if eq .State "TERMINATED"}}{{red "%s" .State}}{{else}}{{blue "%s" .State}}{{end}}
 	{{end}}`)
 
+	columns := []tableview.ColumnDef{
+		{Header: "Cluster ID", Extract: func(v any) string {
+			return v.(compute.ClusterDetails).ClusterId
+		}},
+		{Header: "Name", Extract: func(v any) string {
+			return v.(compute.ClusterDetails).ClusterName
+		}},
+		{Header: "State", Extract: func(v any) string {
+			return string(v.(compute.ClusterDetails).State)
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{Columns: columns})
+
 	listReq.FilterBy = &compute.ListClustersFilterBy{}
 	listCmd.Flags().BoolVar(&listReq.FilterBy.IsPinned, "is-pinned", false, "Filter clusters by pinned status")
 	listCmd.Flags().StringVar(&listReq.FilterBy.PolicyId, "policy-id", "", "Filter clusters by policy id")

cmd/workspace/external-locations/overrides.go

@@ -2,6 +2,7 @@ package external_locations
 
 import (
 	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
 	"github.com/databricks/databricks-sdk-go/service/catalog"
 	"github.com/spf13/cobra"
 )
@@ -12,6 +13,20 @@ func listOverride(listCmd *cobra.Command, listReq *catalog.ListExternalLocations
 	listCmd.Annotations["template"] = cmdio.Heredoc(`
 	{{range .}}{{.Name|green}}	{{.CredentialName|cyan}}	{{.Url}}
 	{{end}}`)
+
+	columns := []tableview.ColumnDef{
+		{Header: "Name", Extract: func(v any) string {
+			return v.(catalog.ExternalLocationInfo).Name
+		}},
+		{Header: "Credential", Extract: func(v any) string {
+			return v.(catalog.ExternalLocationInfo).CredentialName
+		}},
+		{Header: "URL", Extract: func(v any) string {
+			return v.(catalog.ExternalLocationInfo).Url
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{Columns: columns})
 }
 
 func init() {

cmd/workspace/instance-pools/overrides.go

@@ -2,13 +2,32 @@ package instance_pools
 
 import (
 	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
+	"github.com/databricks/databricks-sdk-go/service/compute"
 	"github.com/spf13/cobra"
 )
 
 func listOverride(listCmd *cobra.Command) {
 	listCmd.Annotations["template"] = cmdio.Heredoc(`
 	{{range .}}{{.InstancePoolId|green}}	{{.InstancePoolName}}	{{.NodeTypeId}}	{{.State}}
 	{{end}}`)
+
+	columns := []tableview.ColumnDef{
+		{Header: "Pool ID", Extract: func(v any) string {
+			return v.(compute.InstancePoolAndStats).InstancePoolId
+		}},
+		{Header: "Name", Extract: func(v any) string {
+			return v.(compute.InstancePoolAndStats).InstancePoolName
+		}},
+		{Header: "Node Type", Extract: func(v any) string {
+			return v.(compute.InstancePoolAndStats).NodeTypeId
+		}},
+		{Header: "State", Extract: func(v any) string {
+			return string(v.(compute.InstancePoolAndStats).State)
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{Columns: columns})
 }
 
 func init() {

cmd/workspace/jobs/overrides.go

@@ -1,7 +1,12 @@
 package jobs
 
 import (
+	"context"
+	"strconv"
+
+	"github.com/databricks/cli/libs/cmdctx"
 	"github.com/databricks/cli/libs/cmdio"
+	"github.com/databricks/cli/libs/tableview"
 	"github.com/databricks/databricks-sdk-go/service/jobs"
 	"github.com/spf13/cobra"
 )
@@ -10,6 +15,33 @@ func listOverride(listCmd *cobra.Command, listReq *jobs.ListJobsRequest) {
 	listCmd.Annotations["template"] = cmdio.Heredoc(`
 	{{range .}}{{green "%d" .JobId}}	{{.Settings.Name}}
 	{{end}}`)
+
+	columns := []tableview.ColumnDef{
+		{Header: "Job ID", Extract: func(v any) string {
+			return strconv.FormatInt(v.(jobs.BaseJob).JobId, 10)
+		}},
+		{Header: "Name", Extract: func(v any) string {
+			if v.(jobs.BaseJob).Settings != nil {
+				return v.(jobs.BaseJob).Settings.Name
+			}
+			return ""
+		}},
+	}
+
+	tableview.RegisterConfig(listCmd, tableview.TableConfig{
+		Columns: columns,
+		Search: &tableview.SearchConfig{
+			Placeholder: "Search by exact name...",
+			NewIterator: func(ctx context.Context, query string) tableview.RowIterator {
+				req := *listReq
+				req.Name = query
+				req.PageToken = ""
+				req.Offset = 0
+				w := cmdctx.WorkspaceClient(ctx)
+				return tableview.WrapIterator(w.Jobs.List(ctx, req), columns)
+			},
+		},
+	})
 }
 
 func listRunsOverride(listRunsCmd *cobra.Command, listRunsReq *jobs.ListRunsRequest) {

cmd/workspace/jobs/overrides_test.go

@@ -0,0 +1,50 @@
+package jobs
+
+import (
+	"testing"
+
+	"github.com/databricks/cli/libs/tableview"
+	sdkjobs "github.com/databricks/databricks-sdk-go/service/jobs"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestListTableConfig(t *testing.T) {
+	cmd := newList()
+
+	cfg := tableview.GetConfig(cmd)
+	require.NotNil(t, cfg)
+	require.Len(t, cfg.Columns, 2)
+
+	tests := []struct {
+		name     string
+		job      sdkjobs.BaseJob
+		wantID   string
+		wantName string
+	}{
+		{
+			name: "with settings",
+			job: sdkjobs.BaseJob{
+				JobId:    123,
+				Settings: &sdkjobs.JobSettings{Name: "test-job"},
+			},
+			wantID:   "123",
+			wantName: "test-job",
+		},
+		{
+			name: "nil settings",
+			job: sdkjobs.BaseJob{
+				JobId: 456,
+			},
+			wantID:   "456",
+			wantName: "",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			assert.Equal(t, tt.wantID, cfg.Columns[0].Extract(tt.job))
+			assert.Equal(t, tt.wantName, cfg.Columns[1].Extract(tt.job))
+		})
+	}
+}