feat(ui): add main_cli_help.sh — clap option-ordering test

[CGMossa]

AI-written details

Summary

Adds ui/main_cli_help.sh (139 lines) — a UI regression test that captures the full --help output for dvs init / add / get / status so the clap option-ordering layout is pinned down and visible in the published HTML. Anyone refactoring CommonOpts / Cli / per-command structs has an obvious diff to compare against.

Supporting changes:

dvs-cli/src/main.rs (+6/−2):

• #[command(next_display_order = 100)] on each subcommand variant (Init, Add, Status, Get) so per-command options render in a stable order regardless of insertion order.
• display_order = 0 / display_order = 1 on the two global flags (--json, --threads) so they appear at the top of every command's Options section.

justfile (+4/−2):

• Register cli_help in ui_names so just ui-run / ui-render / ui-publish pick the new script up.
• ui-publish-only: conditionally include ui/helpers.sh as a source attachment only when the target script actually sources it. main_cli_help.sh deliberately doesn't source helpers.sh (no set -x, no say) so the published log has no xtrace noise.

History note

Squashed from 10 commits into 1. The intermediate history contained: two abandoned CommonOpts-flatten attempts that mutually reverted, a disable_help_subcommand = true change that was reverted (the help subcommand row is back), 2 cargo-fmt commits, and a doc-refresh churn that moved to #189. The net diff is small and self-contained.

Rejected approaches (kept here for posterity)

• help_heading = "Global Options": arbitrary heading text.
• next_display_order = 1000 on a top-level GlobalOpts flatten: arbitrary magic number, restructures globals.
• CommonOpts #[derive(Args)] flattened into each variant: turns globals from pre-subcommand-allowed into subcommand-only.

Test plan

• just install-all && bash ui/main_cli_help.sh runs to completion (exit 0)
• Output makes the ordering match obvious for all four subcommands
• just ui-publish publishes ui-cli_help to alx without error
• dvs --json <sub> and dvs <sub> --json both work (globals still global)
• Existing ui/main_*.sh scripts continue to pass

Notes

• Docs refresh for specs.md and dvs-rpkg/CLAUDE.md was split off into docs: refresh CLI help blocks + fix dvs_status R signature #189.

---

Drafted by Claude (claude-opus-4-7). Reviewed by the author.

[Keats]

We decided to keep things as currently.

[CGMossa]

We did decide that. But I am adjusting the UI scripts so the testing/validation can stay in the repo.

[CGMossa]

Outputs from the UI tests can be viewed here https://alx.dev.a2-ai.cloud/artifact/a0d5be27-7c84-4572-9a40-cff60ea50a88

[CGMossa]

The help command isn't a problem. I'm removing this disable_help_subcommand, and retain the default clap behavior.

[CGMossa]

The original PR post has changed substantially, and the conversation here is not on the latest proposal. Merging, as it is innocuous as is.