[plan] Add console package README documenting when to use Bubble Tea list vs Huh Select

[github-actions]

Objective

Add a README or inline documentation to pkg/console/ that explains when to use the Bubble Tea list picker (list.go) versus Huh Select form field, so contributors can make informed choices.

Context

From discussion #23683 (Terminal Stylist Analysis): pkg/console/list.go implements a full Bubble Tea interactive list picker. It is the only direct Bubble Tea model implementation outside of Huh. The analysis noted this is a good pattern but lacks guidance on when to prefer one over the other.

Approach

1. Add a pkg/console/README.md (or a prominent doc comment at the top of pkg/console/console.go) covering:
   • When to use console.PickFromList() (Bubble Tea list): long lists with search/filter, programmatic selection without a form context, standalone picker outside a multi-field form
   • When to use Huh Select: part of a multi-field form, when you need WithTheme/WithAccessible automatically, simpler single-item selection in a wizard flow
   • Note that both respect console.IsAccessibleMode() and TTY detection
2. Optionally add a brief doc comment to the PickFromList function in list.go cross-referencing Huh Select

Files to Modify

• Create or update: pkg/console/README.md (preferred) or doc comments in pkg/console/console.go
• Update: pkg/console/list.go (add cross-reference doc comment to PickFromList)

Acceptance Criteria

• Documentation clearly states when to use each approach with concrete examples
• PickFromList function has a doc comment cross-referencing Huh Select
• No code changes required — documentation only
• make agent-finish passes

Generated by Plan Command for issue #discussion #23683 · ◷

• expires on Apr 2, 2026, 12:14 PM UTC

[pelikhan]

/q migrate pkg/console/list.go to Hug instead of bubble tea

[github-actions]

🎩 Mission equipment ready! Q has optimized your workflow. Use wisely, 007! 🔫

[github-actions]

Pull request created: #23700

🎩 Equipped by Q