docs: polish CLI help text; introduce Options + Global Options panels

[muhsinking]

Summary

• Options panel (per-command): renamed the cyclopts default Parameters panel to Options via group_parameters=Group("Options", sort_key=100) on the root App — propagates to every subcommand.
• Global Options panel (CLI-wide): single panel that holds --non-interactive, --json, --help, --version and propagates to every subcommand and sub-subcommand level. Replaces the prior split between Common Parameters (which held --non-interactive/--json) and a separate Parameters panel (which only held --help/--version at the root).
• [default: X] rendering: extended the human help formatter (utils/_help_formatter.py) to append [default: X] from entry.default (which cyclopts auto-populates when a parameter has a concrete default). Suppresses noisy False/None/"" defaults so opt-in boolean flags don't get cluttered. Lets us drop most inline (defaults to X) parentheticals.
• Model group hoisted in tg fine-tuning create -h via sort_key=0 — it's the primary mutually-exclusive decision (--model xor --from-checkpoint).
• Beta Commands panel: dropped the ⚠️ from the title — the variation-selector glyph was breaking rich's box-drawing math, so the panel rendered with no borders. Title is now plain Beta Commands.
• Help-text polish: tightened command and parameter descriptions across files, fine-tuning, models, endpoints, evals, telemetry, beta clusters, and beta jig. Removed trailing periods (and one stray mid-sentence period in --from-checkpoint), replaced "API commands" boilerplate with action-oriented summaries (e.g. Files API commands → Upload and manage files for fine-tuning, evals, and inference), shortened verbose flag descriptions in evals create and fine-tuning create, standardized (e.g., → (e.g..

Why "Options" and "Global Options" (not "Parameters" / "Flags")?

CLI terminology hierarchy:

• Argument — anything passed to the CLI after the program name. Includes everything below.
• Parameter — generic/formal term that includes both positional arguments and options. Cyclopts uses this internally for any input slot, which is why the help panel was originally titled "Parameters" / "Common Parameters" — but for a user-facing label it's too broad.
• Option — a named argument that begins with - or -- (e.g. --api-key VALUE, --json). May or may not take a value.
• Flag — informal term for the boolean subset of options (no value; --verbose, --no-color).

Mainstream CLIs (kubectl, docker, git, aws, cargo, gh) all use "Options" for the named-flag panel. "Flags" would also be defensible (and more precise for the global panel where all four entries are currently boolean flags), but "Options" stays correct if a value-taking global is ever added (e.g. --config PATH), and is the broader convention.

Follow-ups for reviewers (deferred functional work, not in this PR)

These were noted during the convention sweep but kept out of scope to keep the PR text-only:

• Standardize negative=() policy across boolean params — currently inconsistent: jig.py boolean flags use negative=() to suppress --no-foo pairs, others don't. Pick one policy and apply uniformly.
• Replace (must be >= 0) with cyclopts numeric validators in endpoints/create.py (MinReplicasParameter, MaxReplicasParameter).
• Replace (required for X type) and the new "mutually exclusive with…" prose with cyclopts cross-parameter validators in evals/create.py — better error messages and the help text can simplify further.
• The _NOISY_DEFAULTS = {"False", "None", '""'} filter in the formatter is a heuristic — if there's appetite, switch to honoring only Parameter(show_default=True) explicit opt-in instead.

Test plan

• tg -h shows a single Global Options panel with all 4 flags and a properly framed Beta Commands panel
• tg endpoints -h and tg endpoints list -h both show the same Global Options panel and an Options panel above it
• tg fine-tuning create -h shows panels in order: Model → Options → Global Options
• tg --version, tg endpoints --version, tg endpoints list --version all print the version
• tg endpoints list --json still routes the flag through to output
• Spot-check [default: X] annotations on tg fine-tuning create -h (e.g. --n-epochs [default: 1], --packing [default: True])
• Spot-check rephrased help text on tg beta clusters get-credentials -h, tg fine-tuning download -h, tg evals create -h
• Render every command path: bash dump-help.sh then skim all-help.txt

🤖 Generated with Claude Code