feat: Add platform compatibility CI integrations

Add three integration points for the cross-platform compatibility checker:

1. GitHub Actions (tests.yml):
   - New `platform-compat` job that runs on every push/PR
   - Generates JSON report as artifact
   - Currently non-blocking (warns but doesn't fail)
   - Change `continue-on-error: false` to make it blocking

2. Pre-commit hook (.pre-commit-config.yaml):
   - Manual stage: `pre-commit run platform-compat`
   - Change to `stages: [commit]` to run on every commit
   - Checks src/, empathy_llm_toolkit/, empathy_software_plugin/, coach_wizards/

3. Pytest integration (test_platform_compat_ci.py):
   - Runs as part of normal test suite
   - Tests for critical platform issues
   - Verifies platform_utils module is importable and functional

Usage:
  # Manual pre-commit check
  pre-commit run platform-compat

  # Run pytest integration
  pytest tests/test_platform_compat_ci.py -v

  # Direct script usage
  python scripts/check_platform_compat.py src/ --fix

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: 2 people

.github/workflows/tests.yml

@@ -76,6 +76,36 @@ jobs:
     - name: Security scan with Bandit
       run: bandit -c .bandit -r src/ empathy_llm_toolkit/ coach_wizards/ empathy_software_plugin/ --severity-level medium --confidence-level medium
 
+  platform-compat:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Check cross-platform compatibility
+      id: compat
+      run: |
+        python scripts/check_platform_compat.py src/ --json > compat-report.json
+        python scripts/check_platform_compat.py src/ --fix
+
+    - name: Upload compatibility report
+      uses: actions/upload-artifact@v4
+      with:
+        name: platform-compat-report
+        path: compat-report.json
+
+    - name: Fail on errors (non-blocking for now)
+      run: |
+        ERRORS=$(python -c "import json; r=json.load(open('compat-report.json')); print(r['summary']['errors'])")
+        if [ "$ERRORS" -gt 0 ]; then
+          echo "::warning::Found $ERRORS cross-platform compatibility errors"
+        fi
+      continue-on-error: true
+
   code-quality:
     runs-on: ubuntu-latest
     steps:

.pre-commit-config.yaml

@@ -106,3 +106,13 @@ repos:
         pass_filenames: false
         stages: [manual]  # Run manually with: pre-commit run pattern-review
         # Change to 'stages: [commit]' to run automatically on every commit
+
+      # Cross-platform compatibility check
+      # Detects hardcoded paths, missing encoding, asyncio issues
+      - id: platform-compat
+        name: Cross-Platform Compatibility Check
+        entry: python scripts/check_platform_compat.py src/ empathy_llm_toolkit/ empathy_software_plugin/ coach_wizards/
+        language: python
+        pass_filenames: false
+        stages: [manual]  # Run manually with: pre-commit run platform-compat
+        # Change to 'stages: [commit]' to run automatically on every commit

tests/test_platform_compat_ci.py

@@ -0,0 +1,103 @@
+"""
+CI integration test for cross-platform compatibility.
+
+Runs the platform compatibility checker as part of pytest to catch
+cross-platform issues during regular test runs.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+
+
+class TestPlatformCompatibility:
+    """Tests for cross-platform compatibility in the codebase."""
+
+    @pytest.fixture
+    def project_root(self) -> Path:
+        """Get the project root directory."""
+        return Path(__file__).parent.parent
+
+    def test_no_critical_platform_issues(self, project_root: Path):
+        """Ensure no critical cross-platform errors in src/ directory."""
+        script = project_root / "scripts" / "check_platform_compat.py"
+
+        if not script.exists():
+            pytest.skip("Platform compatibility script not found")
+
+        result = subprocess.run(
+            [sys.executable, str(script), str(project_root / "src"), "--json"],
+            capture_output=True,
+            text=True,
+            cwd=str(project_root),
+        )
+
+        import json
+
+        try:
+            report = json.loads(result.stdout)
+        except json.JSONDecodeError:
+            pytest.fail(f"Failed to parse compatibility report: {result.stdout}")
+
+        errors = report["summary"]["errors"]
+        assert (
+            errors == 0
+        ), f"Found {errors} platform compatibility errors. Run: python scripts/check_platform_compat.py src/ --fix"
+
+    def test_platform_utils_available(self):
+        """Ensure platform_utils module is importable."""
+        try:
+            from empathy_os.platform_utils import (
+                get_default_data_dir,
+                get_default_log_dir,
+                is_linux,
+                is_macos,
+                is_windows,
+                setup_asyncio_policy,
+            )
+
+            # Verify functions are callable
+            assert callable(is_windows)
+            assert callable(is_macos)
+            assert callable(is_linux)
+            assert callable(get_default_log_dir)
+            assert callable(get_default_data_dir)
+            assert callable(setup_asyncio_policy)
+        except ImportError as e:
+            pytest.fail(f"platform_utils module not importable: {e}")
+
+    def test_platform_detection_consistent(self):
+        """Ensure platform detection is consistent."""
+        from empathy_os.platform_utils import is_linux, is_macos, is_windows
+
+        # At most one should be True
+        platforms = [is_windows(), is_macos(), is_linux()]
+        true_count = sum(platforms)
+
+        assert true_count <= 1, "Multiple platforms detected as True"
+
+    def test_default_directories_are_paths(self):
+        """Ensure directory functions return Path objects."""
+        from empathy_os.platform_utils import (
+            get_default_cache_dir,
+            get_default_config_dir,
+            get_default_data_dir,
+            get_default_log_dir,
+        )
+
+        assert isinstance(get_default_log_dir(), Path)
+        assert isinstance(get_default_data_dir(), Path)
+        assert isinstance(get_default_config_dir(), Path)
+        assert isinstance(get_default_cache_dir(), Path)
+
+    def test_asyncio_policy_runs_without_error(self):
+        """Ensure asyncio policy setup doesn't raise."""
+        from empathy_os.platform_utils import setup_asyncio_policy
+
+        # Should not raise on any platform
+        setup_asyncio_policy()