feat(cli): visual and UX polish across all commands

[chrisdeeming]

Summary

• Full visual/UX pass over every command: one output language (single ✓ summary box per outcome, → hints, consistent empty states, dates, plurals, punctuation), grouped and styled --help, a native styled ps table, and TTY-gated spinners/progress so piped output is ANSI-free and NO_COLOR is respected.
• New error model: styled ✗ renderer with remediation hints, internal classification sentinels never leak into messages, prompt/menu cancellation exits 0 silently, and passthrough commands (php, composer, compose, exec, direct XF commands) propagate the child's exit code with no redundant Error: trailer.
• Fixes five real bugs found during the audit: init step counting ([8/7] drift), xf debug dropping all arguments after the first, an unchecked checksum slice panic in download, review-screen validation warnings being wiped before they could be read, and the keychain missing-entry sentinel.

Testing

• go build ./... && go vet ./... && gofmt -l . && go test ./... — all green.
• Full output audit of every command against the style rules, piped (| cat -v, NO_COLOR=1) and on a TTY.
• Manual runs: doctor, auth status (all token states), cache list/purge/path, worktree list/prune, lifecycle (up/ps/down), error and exit-code paths.
• Not exercised live: self-update install and a full upgrade run (no target install available); verified by reading and unit tests.

Visual evidence

Errors, before → after:

  

auth status with an expired token, before → after:

  

--help is now grouped with styled headings instead of one flat alphabetical list of 22 commands, before → after:

  

Notes

• Stacked on feat(worktree): create and manage development worktrees #14 (worktree management) — that branch created the worktree/init code this PR restyles. Retarget to main once feat(worktree): create and manage development worktrees #14 merges.
• Deliberate behaviour changes: Esc/Cancel in prompts exits 0 (Ctrl-C still 130); a failing passthrough child exits with its own code; cache purge without flags is now a usage error (exit 1); doctor failure exits 1 without a duplicate error line.
• CHANGELOG updated under Unreleased.

Checklist

• The change is focused and does not include unrelated work.
• Relevant automated and/or manual testing has been performed.
• UI changes include screenshots or video where appropriate.
• Upgrade, compatibility, and performance implications have been considered.

Note

Polish visual output and UX across all CLI commands

• Adds structured command groups ("Getting started", "Environment", "Run tools", "Maintenance") to help output with styled headings via a custom Cobra usage template in cmd/xf/root.go.
• Standardises terminal output across all commands: spinners use a single shared instance per operation, success results use SuccessBox, empty states use PrintEmpty, hints use PrintHint, and dates use FormatDate/FormatDateTime.
• Adds new ui utilities in internal/ui/ui.go: Plural, FormatDate, FormatDateTime, IsTerminal, ShortHome, PrintHint, PrintEmpty, ClearScreen, and ProgressBar.Abandon; removes Box, Subheader, Italic, Underline, and StatusTableStyle.
• Propagates child process exit codes via passthroughError and exitCodeError so CLI exits mirror subprocess status; SIGTERM is now handled alongside SIGINT with signal-derived exit codes (128+signum).
• Adds runner.PSInfo to internal/dockercompose/runner.go for structured container status, and rewrites xf ps to render a formatted table with colored state columns.
• xf doctor now exits non-zero when checks fail and prints an aggregated summary; xf cache purge now errors when called without --all or --license.
• Risk: several commands change exit codes — xf doctor now exits 1 on failures, child-command wrappers now forward subprocess exit codes instead of always exiting 1, and ErrCancelled now exits 0.

^{Macroscope summarized 3c7004b.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3910bb82-800e-4863-b1e0-08fbe9605f9b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

❌ Patch coverage is 26.00382% with 774 lines in your changes missing coverage. Please review.
✅ Project coverage is 36.11%. Comparing base (fe1ffde) to head (81a01c8).

❌ Your patch check has failed because the patch coverage (26.00%) is below the target coverage (30.00%). You can increase the patch coverage or adjust the target coverage.

Additional details and impacted files

@@                     Coverage Diff                     @@
##           dev/worktree-management      #15      +/-   ##
===========================================================
+ Coverage                    33.16%   36.11%   +2.94%     
===========================================================
  Files                           57       58       +1     
  Lines                         6310     6709     +399     
===========================================================
+ Hits                          2093     2423     +330     
- Misses                        3891     3943      +52     
- Partials                       326      343      +17     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.