refactor(cli): simplify --report handling and update docs

Revert the global_report dest approach. Keep --report as a simple
top-level flag that works only without a subcommand, matching the
original intent. Update version.md and README.md to document the new
cz --version/-v and cz --report top-level flags.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: bearomorphism

commitizen/cli.py

@@ -114,7 +114,6 @@ def __call__(
         {
             "name": ["--report"],
             "action": "store_true",
-            "dest": "global_report",
             "help": "Show system information for reporting bugs",
         },
     ],
@@ -663,7 +662,6 @@ class Args(argparse.Namespace):
         name: str | None = None
         no_raise: str | None = None  # comma-separated string, later parsed as list[int]
         report: bool = False
-        global_report: bool = False
         project: bool = False
         commitizen: bool = False
         verbose: bool = False
@@ -703,13 +701,12 @@ def main() -> None:
         out.write(__version__)
         raise ExpectedExit()
 
-    if getattr(args, "global_report", False):
-        out.write(f"Commitizen Version: {__version__}")
-        out.write(f"Python Version: {sys.version}")
-        out.write(f"Operating System: {platform.system()}")
-        raise ExpectedExit()
-
     if not hasattr(args, "func"):
+        if getattr(args, "report", False):
+            out.write(f"Commitizen Version: {__version__}")
+            out.write(f"Python Version: {sys.version}")
+            out.write(f"Operating System: {platform.system()}")
+            raise ExpectedExit()
         raise NoCommandFoundError()
 
     arguments = vars(args)

docs/README.md

@@ -227,6 +227,8 @@ Commitizen provides a comprehensive CLI with various commands. Here's the comple
 
 | Command | Description | Alias |
 |---------|-------------|-------|
+| `cz --version` | Show installed Commitizen version | `cz -v` |
+| `cz --report` | Show system information for bug reports | - |
 | `cz init` | Initialize Commitizen configuration | - |
 | `cz commit` | Create a new commit | `cz c` |
 | `cz bump` | Bump version and update changelog | - |

docs/commands/version.md

@@ -1,5 +1,12 @@
 Get the version of the installed Commitizen or the current project (default: installed commitizen).
 
+## Quick version and report
+
+The following top-level flags are available for convenience:
+
+- **`cz --version`** (or **`cz -v`**): print the installed Commitizen version and exit.
+- **`cz --report`**: print system information (Commitizen version, Python version, operating system) useful for bug reports, and exit.
+
 ## Usage
 
 ![cz version --help](../images/cli_help/cz_version___help.svg)
@@ -20,6 +27,8 @@ Get the version of the installed Commitizen or the current project (default: ins
 ## Examples
 
 ```bash
+cz --version              # quick: installed commitizen version
+cz --report               # quick: system info for bug reports
 cz version --project
 cz version 2.0.0 --next MAJOR
 cz version --project --major

tests/test_cli.py

@@ -90,24 +90,6 @@ def test_cz_with_report_arg(util: UtilFixture, capsys):
     assert "Operating System:" in out
 
 
-def test_cz_report_flag_takes_precedence_over_subcommand(util: UtilFixture, capsys):
-    """Test that --report takes precedence over non-version subcommands."""
-    with pytest.raises(ExpectedExit):
-        util.run_cli("--report", "bump")
-    out, _ = capsys.readouterr()
-    assert "Commitizen Version:" in out
-
-
-def test_cz_report_flag_takes_precedence_over_version_subcommand(
-    util: UtilFixture, capsys
-):
-    """Test that top-level --report takes precedence over version subcommand."""
-    with pytest.raises(ExpectedExit):
-        util.run_cli("--report", "version")
-    out, _ = capsys.readouterr()
-    assert "Commitizen Version:" in out
-
-
 def test_name(util: UtilFixture, capsys):
     util.run_cli("-n", "cz_jira", "example")
     out, _ = capsys.readouterr()