Fixes: Github Actions and mypy bugs.

.github/workflows/ci.yml

@@ -40,7 +40,7 @@ jobs:
 
     - name: Type check with Mypy
       run: |
-        mypy stackbox/core/compose.py
+        mypy stackbox/
 
     - name: Run unit tests
       run: |
@@ -84,7 +84,7 @@ jobs:
     - name: Check Docker is running
       run: |
         docker --version
-        docker-compose --version
+        docker compose version
         docker ps
 
     - name: Run integration tests

.github/workflows/pre-commit.yml

@@ -39,7 +39,7 @@ jobs:
     - name: Mypy - Type Checking
       run: |
         echo "::group::Mypy Type Checking"
-        mypy stackbox/core/compose.py
+        mypy stackbox/
         echo "::endgroup::"
 
     - name: Comment on PR if checks fail

pyproject.toml

@@ -113,6 +113,27 @@ norecursedirs = [
     ".venv",
 ]
 
+# ============================================================================
+# Coverage.py - Code Coverage
+# ============================================================================
+[tool.coverage.run]
+source = ["stackbox"]
+omit = [
+    "stackbox/cli/*",  # Stub commands - no implementation yet (Issue #3)
+    "stackbox/jobs/*",  # Not yet implemented
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if __name__ == .__main__.:",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]
+
 # ============================================================================
 # Tool Configurations
 # ============================================================================

stackbox/core/compose.py

@@ -3,11 +3,21 @@
 import contextlib
 from pathlib import Path
 import subprocess
+from typing import TypedDict
 
 from jinja2 import Template
 import yaml
 
 
+class ValidationResult(TypedDict):
+    """Result from validate_environment()."""
+
+    docker_running: bool
+    ports_available: bool
+    unavailable_ports: list[int]
+    kvm_available: bool
+
+
 def generate_compose_file(output_path: Path, config: dict[str, str] | None = None) -> Path:
     """
     Generate docker-compose.yml from Jinja2 template.
@@ -109,7 +119,7 @@ def _check_kvm_available() -> bool:
     return kvm_device.exists() and kvm_device.is_char_device()
 
 
-def validate_environment() -> dict[str, bool | list[int]]:
+def validate_environment() -> ValidationResult:
     """
     Run pre-flight checks for infrastructure requirements.