chore(cli): show sub-command help string in execute --help output (#1878)

* chore(cli): show sub-command help in `execute --help` output

* chore(cli): make sub-command help strings good one-liners

Previously:
```
Commands:
  hive     Execute tests using hive in dev-mode as backend, requires hive...
  recover  Recover funds from a failed test execution using a remote RPC...
  remote   Execute tests using a remote RPC endpoint.
```

Now:
```
Commands:
  hive     Execute tests using hive dev-mode as a backend (`./hive --dev`).
  recover  Recover funds from test executions using a remote RPC endpoint.
  remote   Execute tests using a remote RPC endpoint.
```

* test(execute): add framework tests for missing help

Author: danceratopz

src/cli/pytest_commands/execute.py

@@ -27,10 +27,11 @@ def _create_execute_subcommand(
 
     @execute.command(
         name=command_name,
+        help=help_text,
         context_settings={"ignore_unknown_options": True},
     )
     @common_pytest_options
-    def command(pytest_args: List[str], **kwargs) -> None:
+    def command(pytest_args: List[str], **_kwargs) -> None:
         pytest_command = PytestCommand(
             config_file=config_file,
             argument_processors=[HelpFlagsProcessor(f"execute-{command_name}")],
@@ -45,10 +46,7 @@ def command(pytest_args: List[str], **kwargs) -> None:
 hive = _create_execute_subcommand(
     "hive",
     "pytest-execute-hive.ini",
-    (
-        "Execute tests using hive in dev-mode as backend, requires hive to be running "
-        "(using command: `./hive --dev`)."
-    ),
+    "Execute tests using hive as a backend (`./hive --dev`).",
 )
 
 remote = _create_execute_subcommand(
@@ -60,5 +58,5 @@ def command(pytest_args: List[str], **kwargs) -> None:
 recover = _create_execute_subcommand(
     "recover",
     "pytest-execute-recover.ini",
-    "Recover funds from a failed test execution using a remote RPC endpoint.",
+    "Recover funds from test executions using a remote RPC endpoint.",
 )

src/cli/tests/test_pytest_execute_command.py

@@ -0,0 +1,43 @@
+"""Tests for execute command click CLI."""
+
+import pytest
+from click.testing import CliRunner
+
+from ..pytest_commands.execute import execute
+
+
+@pytest.fixture
+def runner():
+    """Provide a Click CliRunner for invoking command-line interfaces."""
+    return CliRunner()
+
+
+def test_execute_help_shows_subcommand_docstrings(runner):
+    """Test that execute --help shows sub-command docstrings."""
+    result = runner.invoke(execute, ["--help"])
+    assert result.exit_code == 0
+
+    # Check that all sub-commands are shown with their help text
+    assert "hive" in result.output
+    assert "Execute tests using hive as a backend" in result.output
+
+    assert "remote" in result.output
+    assert "Execute tests using a remote RPC endpoint" in result.output
+
+    assert "recover" in result.output
+    assert "Recover funds from test executions" in result.output
+
+
+def test_execute_subcommands_have_help_text(runner):
+    """Test that execute sub-commands have proper help text defined."""
+    from ..pytest_commands.execute import hive, recover, remote
+
+    # Test that each sub-command has a docstring
+    assert hive.__doc__ is not None
+    assert "hive" in hive.__doc__.lower()
+
+    assert remote.__doc__ is not None
+    assert "remote" in remote.__doc__.lower()
+
+    assert recover.__doc__ is not None
+    assert "recover" in recover.__doc__.lower()