[terminal-stylist] Terminal Stylist: Console Output Analysis (Lipgloss/Huh consistency)

[github-actions[bot]]

Summary

Scanned all non-test .go files under pkg/ for console output patterns (fmt.Print*, console.*, Lipgloss, Huh). Overall the codebase shows strong, consistent adoption of the Charmbracelet ecosystem via a well-designed internal abstraction layer.

Architecture found

• pkg/styles — centralizes all color/style definitions using charm.land/lipgloss/v2, with adaptive colors (lipgloss.AdaptiveColor-style Light/Dark pairs) for every semantic color (Error, Warning, Success, Info, Purple, Yellow, Comment, Foreground, Background, Border). Well documented with usage examples and design rationale (Dracula-inspired dark theme, WCAG-minded light theme).
• pkg/console — the single source of truth for terminal I/O (257 files reference it). Provides: FormatInfoMessage/FormatErrorMessage/FormatWarningMessage/FormatSuccessMessage, RenderStruct (table rendering via lipgloss/table), NewSpinner (Bubble Tea + lipgloss, TTY-aware), confirm.go/input.go/list.go/prompt_form.go (Huh-based forms), and WASM no-op stubs (*_wasm.go) for browser builds.
• Accessibility: console.IsAccessibleMode() centrally checks ACCESSIBLE, TERM=dumb, and NO_COLOR, and is respected by spinners/animations — a solid, DRY accessibility gate.
• Huh forms: used extensively across pkg/cli/add_interactive_*.go, run_interactive.go, engine_secrets.go, bootstrap_profile_*.go for structured multi-field prompts, themed via pkg/styles/huh_theme.go.

fmt.Print* usage (24 hits, non-test)

Nearly all are legitimate:

• Most matches are in linter testdata fixtures (pkg/linters/.../testdata/) intentionally demonstrating bad patterns for lint tests — out of scope, not real output code.
• Two production call sites (pkg/cli/status_command.go:295, pkg/cli/view_command.go:168) call fmt.Print(console.RenderStruct(...)) / fmt.Print(output) to emit a string that was already fully rendered by the console package (table/timeline). This is an accepted, minimal pattern — no direct styling bypass.
• No raw/unstyled fmt.Println("some message") calls were found bypassing console.Format*Message in production code.

Raw ANSI / manual escape sequences

Only two intentional occurrences, both are the correct abstraction boundary rather than ad-hoc misuse:

• pkg/console/terminal.go — low-level terminal capability code (expected).
• pkg/stringutil/ansi.go — ANSI stripping/sanitization utility (expected, not styling).

No files were found manually embedding \x1b[...] codes for coloring in place of Lipgloss.

TTY detection

TTY/IsTerminal checks are correctly centralized in pkg/styles/theme.go, pkg/tty/tty.go, plus targeted checks in pkg/workflow/mcp_scripts_generator.go and pkg/cli/compile_update_check.go — no evidence of missing TTY guards causing raw ANSI in piped output.

Table rendering

lipgloss/table usage is centralized in pkg/console/console.go (RenderStruct), so all tabular CLI output (e.g. status_command.go) goes through one code path — good consistency, no duplicated manual column-alignment logic found elsewhere.

Recommendations

1. No urgent fixes required — the console/styles/Huh layering is already the "good pattern" other CLIs should follow.
2. Consider adding a short docs/code-comment note in pkg/console/README.md (if not already present) explicitly stating "always use console.Format*Message, never raw fmt.Print*, for user-facing output" to make the convention discoverable for new contributors.
3. Optionally add a lightweight static-analysis rule (in pkg/linters/, consistent with existing custom analyzers) to flag new fmt.Println/fmt.Print calls in pkg/cli/**.go outside the two accepted "already-rendered string" call sites, to keep this consistency automatically enforced going forward.
4. No Lipgloss or Huh anti-patterns (hardcoded non-adaptive colors, manual ANSI, missing accessibility checks) were identified in production code during this pass.

No code changes were made; this is an analysis-only report.

Generated by 💄 Terminal Stylist · auto · 20.8 AIC · ⌖ 5.6 AIC · ⊞ 8.2K · ◷

• expires on Aug 23, 2026, 12:53 AM UTC-08:00

[github-actions[bot]]

This discussion has been marked as outdated by Terminal Stylist.

A newer discussion is available at Discussion #55050.