test(clap): cover aliases and help metadata

[jdx]

Replaces #1148, which GitHub automatically marked merged when dependent branch refs temporarily matched during a restack. This is the same layer on the corrected stack.\n\n_This pull request was generated by Codex._

---

Note

Low Risk
Test-only and plan-doc updates; no parser, help, or completion implementation changes.

Overview
Extends the clap micro-conformance harness with two paired CLIs so usage and clap agree on alias binding, completion visibility, and help presentation.

aliases_and_case checks that visible and hidden flag/subcommand aliases parse the same values, that case-insensitive value aliases (FAST, quick) bind to the same enum variant, and that completions advertise only visible spellings.

help_metadata checks long help for custom subcommand headings and placeholders, flag help_heading, next_line_help layout, and that hidden flags/subcommands stay out of help. PLAN.md records these rows in the generated clap matrix.

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

[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: Central YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 9ae26690-7d83-47b3-88f6-df3f82a9ed6a

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

---

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.}

[github-actions]

Instruction counts

The comparison never ran — an earlier step failed.

_{3c88304d3cc5 vs `` · measured on the runner, not pushed to the history.}