[marc0der]

Summary

Aligns all native subcommands on a shared output-styling architecture so user-facing text is consistent, stream-aware, and sourced from single definitions. Also makes the help binary answer every help flag the bash core forwards to it, so that with native commands enabled all help is rendered by native code.

Output style alignment (spec 001)

• Adds a ui module as the sole place that writes messages and applies styling — message types, data output, semantic tokens, and CliError (ADR 0003: stdout for data, stderr for everything conversational).
• Adds a cli module holding shared clap command definitions so each command's help has one source of truth, and rebuilds the help binary on top of those definitions.
• Migrates current, default, home, uninstall, and version to a common run shape with ui-based output.
• Restyles clap parse errors and maps unknown bash commands to styled help.
• Suggests the closest SDK name for unknown names.
• Lists main-page aliases as [aliases: X].
• Hardens helpers: returns Result from shared helpers, reports a missing home directory instead of panicking, shares current-link removal, and removes dead code.
• Drops the colored and textwrap dependencies in favour of anstream/anstyle.
• Updates STYLE.md and CLAUDE.md, clears pre-existing clippy lints, and expands test coverage (including insta snapshots for every help page).

Help flags through the core (spec 002)

• help accepts -h and --help: -h always prints the short page and --help the full page, for the main page and every command in the Help Catalogue. help -h, help --help, help <cmd> -h and help <cmd> --help follow the contract the bash core relies on; when both flags are given, the last one wins.
• Adds short pages for the bash commands, with snapshots.
• Fixes the flush page, which described behaviour bash flush does not have.
• Accepts l as a hidden alias of list.
• Tests assert each row of the help contract (main page, command pages, unknown commands) and that native -h/--help match help.
• The companion bash core change, routing help flags to the help binary, lands separately in sdkman-cli.

Docs

• Numbers specs in the order they were written and documents in CLAUDE.md that a later spec overrides an earlier one.

Test plan

• cargo fmt --check
• cargo clippy --all-targets -- -D warnings
• cargo test

🤖 Generated with Claude Code

[chloe41427]

Reviewed the full diff and ran a focused pass over the ui/helpers modules, the shared cli/help layer, and the five migrated binaries against master. CI is green on all three platforms (fmt / clippy -D warnings / test all pass). LGTM. 👍

No bugs found. The load-bearing invariants hold:

• stdout/stderr contract preserved — all captured data (home path, version string, current output) stays on stdout; only conversational text moved to stderr. $(sdk home java 21) and friends still work. This was the main regression risk and it's clean.
• No new panics — the old .expect() / .unwrap() / process::exit paths (missing HOME, missing var/version) are now proper CliError → exit 1 instead of a 101 panic. Strictly better.
• uninstall / default semantics intact — symlink comparison, --force gating, real remove_dir_all before the success message, and version-exists validation are all preserved.
• Tests tightened, not weakened — assertions moved from contains() to exact stdout/stderr equality plus empty-stream checks, with the filesystem assertions retained. Every help page has an insta snapshot (the old src/bin/snapshots set is fully superseded).

One thing worth a sanity check (not a blocker): cli::default() now marks <VERSION> required and the help reads Usage: sdk default <SDK> <VERSION>. The native binary always required it (required(true) on master too), so this just makes the help honest — but the version-less form (sdk default java) is a real feature of the bash default command, and master's help text documented it. If the bash wrapper ever routes to this help render, users lose that documentation. Low stakes.

Nit: sdk help --help / sdk help -h prints unknown command --help with a fuzzy suggestion rather than the help page — the help binary doesn't special-case a leading -. Harmless since the wrapper drives help, but a plausible manual keystroke.

Approving. 🦀

[marc0der]

Turning this into a draft until we've ensured full compatibility with the sdkman-cli wrapper.