fix(tests): stabilize CLI smoke subprocess runs under pytest-cov and document CI rationale

orenlab · orenlab · commit f7cd74d15528 · 2026-02-08T14:26:36.000+05:00
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -38,6 +38,8 @@ jobs:
         run: uv sync --all-extras --dev
 
       - name: Run tests
+        # Smoke CLI tests intentionally disable subprocess coverage collection
+        # to avoid runner-specific flakiness while keeping parent-process coverage strict.
         run: uv run pytest --cov=codeclone --cov-report=term-missing --cov-fail-under=98
 
       - name: Verify baseline exists
diff --git a/tests/test_cli_smoke.py b/tests/test_cli_smoke.py
@@ -11,13 +11,29 @@ def run_cli(
     env = os.environ.copy()
     root_dir = Path(__file__).parents[1]
     env["PYTHONPATH"] = str(root_dir) + os.pathsep + env.get("PYTHONPATH", "")
+    # Keep smoke tests stable under pytest-cov:
+    # subprocess coverage collection is not required here and can create
+    # nondeterministic overhead when child process pools are used.
+    env.pop("COV_CORE_SOURCE", None)
+    env.pop("COV_CORE_CONFIG", None)
+    env.pop("COV_CORE_DATAFILE", None)
+    env.pop("COVERAGE_PROCESS_START", None)
 
     # Try to find venv python
     venv_python = root_dir / ".venv" / "bin" / "python"
     executable = str(venv_python) if venv_python.exists() else sys.executable
 
     return subprocess.run(
-        [executable, "-m", "codeclone.cli", *args],
+        [
+            executable,
+            "-m",
+            "codeclone.cli",
+            *args,
+            "--processes",
+            "1",
+            "--no-progress",
+            "--no-color",
+        ],
         capture_output=True,
         text=True,
         cwd=cwd,
