fix(docs): strip authored ANSI from plain help

[jdx]

Summary

• make Style::PLAIN remove ANSI CSI sequences already embedded in authored help
• keep the usage-argv and usage-lib renderers in parity without adding argv dependencies
• reuse the reference ANSI sanitizer for Markdown and terminal help

This lets adopters such as mise select plain rendering after resolving their own color policy, even when clap-era color_print::cstr! help remains in command metadata.

Addresses the renderer behavior behind jdx/mise#12671.

Verification

• mise run ci
• cargo test -p gate --test fleet every_jdx_cli_matches_the_reference

AI-assisted — Tool: Codex; model: openai/gpt-5; version: unavailable.

---

Note

Low Risk
Output-formatting change limited to stripping escape bytes on plain paths; coloured terminal help is unchanged aside from shared finalization.

Overview
Plain help and docs no longer leak ANSI escapes that were already baked into command metadata (typical when migrating from clap/color_print::cstr! in fields like after_long_help).

The usage-argv renderer centralizes page finalization in finish_page: when Style::PLAIN is selected it strips complete CSI sequences before trim/newline, while coloured output keeps both renderer styling and any authored escapes. The Go argv renderer applies the same rule in assemble via stripANSISequences, since it only emits plain pages.

usage-lib adds a shared docs::strip_ansi helper (regex-based) and wires it into CLI plain rendering and Markdown generation, replacing a duplicate SGR regex in the markdown renderer. Style::PLAIN is documented to include this sanitization.

Tests cover Rust argv, Go argv, and usage-lib styled vs plain behaviour for authored ANSI in long help.

^{Reviewed by Cursor Bugbot for commit 718cd86. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Caution

Review failed

An error occurred during the review process. Please try again later.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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