feat(cli): pure noun-verb help — hide top-level aliases, fix truncation

All commands in --help are now consistently 'noun verb' format:
- Hidden: download (→ version download), infer (→ video infer exists),
  search (→ image search / universe search exist)
- All hidden aliases still work, just not shown in help
- Fixed description truncation: use full short_help instead of
  get_short_help_str() which Click caps at ~45 chars

374 tests pass, all linting clean.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: yeldarby

roboflow/cli/__init__.py

@@ -110,7 +110,9 @@ def _walk(group: Any, prefix: str = "") -> None:
             if hasattr(cmd, "list_commands") and cmd.list_commands(None):
                 _walk(cmd, full)
             else:
-                commands.append((full, cmd.get_short_help_str() or ""))
+                # Use the full short_help (not truncated get_short_help_str)
+                help_text = getattr(cmd, "short_help", None) or cmd.get_short_help_str() or ""
+                commands.append((full, help_text))
 
     _walk(click_app)
     commands.sort(key=lambda x: x[0])
@@ -193,12 +195,6 @@ def _walk(group: Any, prefix: str = "") -> None:
 app.add_typer(batch_app, name="batch")
 app.add_typer(completion_app, name="completion")
 app.add_typer(deployment_app, name="deployment")
-
-# "download" alias — registered here alphabetically (visible shorthand)
-from roboflow.cli.handlers._aliases import register_download_alias  # noqa: E402
-
-register_download_alias(app)
-
 app.add_typer(folder_app, name="folder")
 app.add_typer(image_app, name="image")
 

roboflow/cli/handlers/_aliases.py

@@ -16,10 +16,10 @@
 from roboflow.cli._compat import ctx_to_args
 
 
-def register_download_alias(app: typer.Typer) -> None:
-    """Register the visible ``download`` shorthand at its alphabetical position."""
+def register_hidden_aliases(app: typer.Typer) -> None:
+    """Register all hidden backwards-compat aliases (not shown in --help)."""
 
-    @app.command("download")
+    @app.command("download", hidden=True)
     def download_alias(
         ctx: typer.Context,
         url_or_id: Annotated[
@@ -28,16 +28,12 @@ def download_alias(
         format: Annotated[str, typer.Option("-f", "--format", help="Export format")] = "voc",
         location: Annotated[Optional[str], typer.Option("-l", "--location", help="Download location")] = None,
     ) -> None:
-        """Download a dataset version (shorthand for 'version download')."""
+        """Download a dataset version (alias for 'version download')."""
         from roboflow.cli.handlers.version import _download
 
         args = ctx_to_args(ctx, url_or_id=url_or_id, format=format, location=location)
         _download(args)
 
-
-def register_hidden_aliases(app: typer.Typer) -> None:
-    """Register all hidden backwards-compat aliases (not shown in --help)."""
-
     @app.command("login", hidden=True)
     def login_alias(
         ctx: typer.Context,

roboflow/cli/handlers/infer.py

@@ -12,7 +12,7 @@
 def infer_command(app: typer.Typer) -> None:
     """Register the top-level ``infer`` command on *app*."""
 
-    @app.command("infer")
+    @app.command("infer", hidden=True)
     def infer(
         ctx: typer.Context,
         file: Annotated[str, typer.Argument(help="Path to an image file")],

roboflow/cli/handlers/search.py

@@ -12,7 +12,7 @@
 def search_command(app: typer.Typer) -> None:
     """Register the top-level ``search`` command on *app*."""
 
-    @app.command("search")
+    @app.command("search", hidden=True)
     def search(
         ctx: typer.Context,
         query: Annotated[str, typer.Argument(help="Search query (e.g. 'tag:review' or '*')")],