Improve CLI help and human output UX

Author: robzolkos

internal/commands/auth.go

@@ -237,7 +237,7 @@ var authListCmd = &cobra.Command{
 				breadcrumb("login", "fizzy auth login <token>", "Log in"),
 				breadcrumb("signup", "fizzy signup", "Sign up"),
 			}
-			printSuccessWithBreadcrumbs([]any{}, "No profiles configured", breadcrumbs)
+			printList([]any{}, authProfileColumns, "No profiles configured", breadcrumbs)
 			return nil
 		}
 
@@ -247,7 +247,7 @@ var authListCmd = &cobra.Command{
 				breadcrumb("login", "fizzy auth login <token>", "Log in"),
 				breadcrumb("signup", "fizzy signup", "Sign up"),
 			}
-			printSuccessWithBreadcrumbs([]any{}, "No profiles configured", breadcrumbs)
+			printList([]any{}, authProfileColumns, "No profiles configured", breadcrumbs)
 			return nil
 		}
 
@@ -282,7 +282,7 @@ var authListCmd = &cobra.Command{
 			breadcrumb("switch", "fizzy auth switch <profile>", "Switch profile"),
 		}
 
-		printSuccessWithBreadcrumbs(entries, fmt.Sprintf("%d profile(s)", len(entries)), breadcrumbs)
+		printList(entries, authProfileColumns, fmt.Sprintf("%d profile(s)", len(entries)), breadcrumbs)
 		return nil
 	},
 }

internal/commands/auth_test.go

@@ -4,9 +4,11 @@ import (
 	"encoding/json"
 	"os"
 	"path/filepath"
+	"strings"
 	"testing"
 
 	"github.com/basecamp/cli/credstore"
+	"github.com/basecamp/cli/output"
 	"github.com/basecamp/cli/profile"
 	"github.com/basecamp/fizzy-cli/internal/config"
 	"gopkg.in/yaml.v3"
@@ -507,6 +509,41 @@ func TestAuthList(t *testing.T) {
 			t.Errorf("expected 0 profiles, got %d", len(profiles))
 		}
 	})
+
+	t.Run("renders styled output with next steps", func(t *testing.T) {
+		credDir := t.TempDir()
+		profileDir := t.TempDir()
+
+		os.Setenv("FIZZY_LIST_STYLED_NO_KR", "1")
+		defer os.Unsetenv("FIZZY_LIST_STYLED_NO_KR")
+		store := credstore.NewStore(credstore.StoreOptions{
+			ServiceName:   "fizzy-list-styled-test",
+			DisableEnvVar: "FIZZY_LIST_STYLED_NO_KR",
+			FallbackDir:   credDir,
+		})
+		profileStore := profile.NewStore(filepath.Join(profileDir, "config.json"))
+		profileStore.Create(&profile.Profile{Name: "acme", BaseURL: "https://app.fizzy.do"})
+		t1, _ := json.Marshal("token1")
+		store.Save("profile:acme", t1)
+
+		mock := NewMockClient()
+		SetTestModeWithSDK(mock)
+		SetTestCreds(store)
+		SetTestProfiles(profileStore)
+		SetTestFormat(output.FormatStyled)
+		defer resetTest()
+
+		err := authListCmd.RunE(authListCmd, []string{})
+		assertExitCode(t, err, 0)
+
+		raw := TestOutput()
+		if !strings.Contains(raw, "Profile") {
+			t.Fatalf("expected styled table output, got:\n%s", raw)
+		}
+		if !strings.Contains(raw, "Next steps:") {
+			t.Fatalf("expected next steps section, got:\n%s", raw)
+		}
+	})
 }
 
 func TestAuthSwitch(t *testing.T) {

internal/commands/column.go

@@ -41,7 +41,7 @@ var columnListCmd = &cobra.Command{
 
 		dataSlice := toSliceAny(items)
 		if dataSlice == nil {
-			printSuccess(items)
+			printDetail(items, "", nil)
 			return nil
 		}
 

internal/commands/columns.go

@@ -39,6 +39,13 @@ var (
 		{Header: "Name", Field: "name"},
 	}
 
+	authProfileColumns = render.Columns{
+		{Header: "Profile", Field: "profile"},
+		{Header: "Active", Field: "active"},
+		{Header: "Board", Field: "board"},
+		{Header: "Base URL", Field: "base_url"},
+	}
+
 	notificationColumns = render.Columns{
 		{Header: "ID", Field: "id"},
 		{Header: "Message", Field: "message"},