feat(cli): add expressive interactive renderer with animated progress

[ian-pascoe]

Summary

• add a dedicated CLI renderer module with strict plain vs interactive mode boundaries to keep machine-readable output contracts stable
• introduce semantic ANSI color styling and operation-specific animated progress indicators for install/upgrade/update/uninstall/self-update flows on TTYs
• centralize command output through renderer helpers, expand contract-focused tests, and update architecture/install docs for additive interactive behavior

Test Plan

• rustup run stable cargo fmt --all --check
• rustup run stable cargo clippy -p crosspack-cli --all-targets -- -D warnings
• rustup run stable cargo test -p crosspack-cli

[ian-pascoe]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 55c3392b54

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Avoid marking failed self-update progress as complete

If run_current_exe_command fails (for example, install resolution/download fails), the code still calls progress.finish(), and finish() renders a line ending in complete in ... for rich mode. That produces a contradictory success-looking completion message immediately before returning an error, which is misleading during incident/debug workflows for interactive users.

Useful? React with 👍 / 👎.

[ian-pascoe]

Adjusted self-update progress completion behavior: the renderer now has separate finish_success() and finish_abandon() paths. run_self_update_command only emits the completion summary on success and clears the progress UI without a success-looking line when the install step fails.

[chatgpt-codex-connector]

Prevent overlapping progress bars in self-update

When self-update runs without --registry-root, this function starts a self-update progress bar before it calls run_update_command, and run_update_command now starts its own progress bar too. Because both are active in the same interactive run, their animated draws can interleave and garble terminal output, making step/status messages hard to read.

Useful? React with 👍 / 👎.

[ian-pascoe]

Updated self-update sequencing to avoid overlapping progress bars. The self-update progress bar now starts only after the optional nested run_update_command returns, so the nested update bar finishes before self-update progress starts. This removes concurrent animated draws in the same terminal session.