fix(cli): exit on --version and --help before side effects

Author: harryswift01

CodeEntropy/cli.py

@@ -4,16 +4,18 @@
 correlation entropy workflow.
 
 The entry point is intentionally small and only responsible for:
-  1) Creating a job folder.
-  2) Constructing a CodeEntropyRunner.
-  3) Executing the entropy workflow.
-  4) Handling fatal errors with a non-zero exit code.
+  1) Handling informational flags such as ``--version``.
+  2) Creating a job folder.
+  3) Constructing a CodeEntropyRunner.
+  4) Executing the entropy workflow.
+  5) Handling fatal errors with a non-zero exit code.
 """
 
 from __future__ import annotations
 
 import logging
 
+from CodeEntropy.config.argparse import ConfigResolver
 from CodeEntropy.config.runtime import CodeEntropyRunner
 
 logger = logging.getLogger(__name__)
@@ -22,9 +24,15 @@
 def main() -> None:
     """Run the entropy workflow.
 
+    Arguments are parsed before any side effects so that informational flags such
+    as ``--version`` and ``--help`` exit without creating a job folder or
+    rendering the splash screen.
+
     Raises:
         SystemExit: Exits with status code 1 on any unhandled exception.
     """
+    ConfigResolver().build_parser().parse_known_args()
+
     folder = CodeEntropyRunner.create_job_folder()
 
     try:

tests/unit/CodeEntropy/cli/test_cli.py

@@ -36,3 +36,17 @@ def test_main_logs_and_exits_nonzero_on_exception(monkeypatch):
 
     assert exc.value.code == 1
     fake_runner.run_entropy_workflow.assert_called_once_with()
+
+
+def test_main_version_flag_exits_before_creating_job_folder(monkeypatch, capsys):
+    fake_runner_cls = MagicMock()
+    monkeypatch.setattr(entry, "CodeEntropyRunner", fake_runner_cls)
+    monkeypatch.setattr("sys.argv", ["CodeEntropy", "--version"])
+
+    with pytest.raises(SystemExit) as exc:
+        entry.main()
+
+    assert exc.value.code == 0
+    assert "CodeEntropy" in capsys.readouterr().out
+    fake_runner_cls.create_job_folder.assert_not_called()
+    fake_runner_cls.assert_not_called()