feat(ci): Add local CI runner script

Created run_local_ci.py for faster development:

Features:
- Run all CI checks locally in seconds instead of minutes
- No waiting for GitHub Actions queue
- Immediate feedback on errors
- Can run specific checks individually
- Saves GitHub Actions quota

Usage:
- python run_local_ci.py              # Run all checks
- python run_local_ci.py --syntax    # Run only syntax check
- python run_local_ci.py --lint      # Run only linting
- python run_local_ci.py --import    # Run only import check
- python run_local_ci.py --type      # Run only type check
- python run_local_ci.py --config    # Run only config check
- python run_local_ci.py --build     # Run only build test

Benefits:
- 10-100x faster than GitHub Actions
- Interactive debugging
- Unlimited runs
- Free (uses own computer)
- Same environment as development (Windows)

This complements GitHub Actions CI for faster iteration.

Author: Ian-bug

.github/scripts/config_validation.py

@@ -3,8 +3,12 @@
 import sys
 import os
 
-# Add current directory to Python path
-sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+# Get repository root (2 levels up from this script)
+repo_root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+print(f"Repository root: {repo_root}")
+
+# Add repository root to Python path
+sys.path.insert(0, repo_root)
 
 # Suppress Qt warnings for CI
 os.environ['QT_QPA_PLATFORM'] = 'offscreen'

.github/scripts/type_check.py

@@ -8,7 +8,8 @@ def check_file(filepath):
     """Check type hints in a Python file."""
     try:
         with open(filepath, 'r', encoding='utf-8') as f:
-            ast.parse(f, filepath)
+            source = f.read()
+            ast.parse(source, filepath)
         return True, None
     except SyntaxError as e:
         return False, str(e)

run_local_ci.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""Run GitHub Actions CI jobs locally for faster development iteration."""
+import subprocess
+import sys
+import os
+from pathlib import Path
+
+def run_command(name, command, description):
+    """Run a command and display result."""
+    print(f"\n{'='*60}")
+    print(f"Running: {name}")
+    print(f"Description: {description}")
+    print(f"{'='*60}\n")
+
+    result = subprocess.run(command, shell=True)
+
+    if result.returncode == 0:
+        print(f"\n[SUCCESS] {name} passed!")
+        return True
+    else:
+        print(f"\n[FAILED] {name} failed with exit code {result.returncode}")
+        return False
+
+def run_syntax_check():
+    """Run Python syntax check locally."""
+    return run_command(
+        "Python Syntax Check",
+        "python .github/scripts/syntax_check.py",
+        "Validate Python syntax for all files"
+    )
+
+def run_lint_check():
+    """Run linting check locally."""
+    return run_command(
+        "Code Linting",
+        "pyflakes main.py core/*.py core/ui/*.py",
+        "Check code quality with pyflakes"
+    )
+
+def run_import_check():
+    """Run import validation locally."""
+    return run_command(
+        "Import Validation",
+        "python -c \"import main, core.overlay, core.input_mon, core.settings_manager, core.configuration, core.gui, core.ui.components, core.logging_config\"",
+        "Test all module imports"
+    )
+
+def run_type_check():
+    """Run type validation locally."""
+    return run_command(
+        "Type Validation",
+        "python .github/scripts/type_check.py",
+        "Validate type hints in all files"
+    )
+
+def run_config_validation():
+    """Run configuration validation locally."""
+    return run_command(
+        "Configuration Validation",
+        "python .github/scripts/config_validation.py",
+        "Validate configuration schema and operations"
+    )
+
+def run_build_test():
+    """Run build test locally."""
+    return run_command(
+        "Windows Build Test",
+        "python build.py",
+        "Test PyInstaller build process"
+    )
+
+def run_all_checks():
+    """Run all CI checks sequentially."""
+    checks = [
+        ("Syntax Check", run_syntax_check),
+        ("Linting Check", run_lint_check),
+        ("Import Check", run_import_check),
+        ("Type Check", run_type_check),
+        ("Config Check", run_config_validation),
+        ("Build Test", run_build_test),
+    ]
+
+    results = {}
+    for name, check_func in checks:
+        results[name] = check_func()
+
+    # Print summary
+    print(f"\n{'='*60}")
+    print("LOCAL CI SUMMARY")
+    print(f"{'='*60}\n")
+
+    all_passed = True
+    for name, passed in results.items():
+        status = "[PASS]" if passed else "[FAIL]"
+        print(f"{status} {name}")
+        if not passed:
+            all_passed = False
+
+    print(f"\n{'='*60}")
+    if all_passed:
+        print("ALL CHECKS PASSED!")
+    else:
+        print("SOME CHECKS FAILED!")
+    print(f"{'='*60}\n")
+
+    return 0 if all_passed else 1
+
+def main():
+    """Main entry point."""
+    print("Local GitHub Actions CI Runner")
+    print("="*60)
+    print("\nThis script runs all CI checks locally for faster development.")
+    print("\nUsage:")
+    print("  python run_local_ci.py              # Run all checks")
+    print("  python run_local_ci.py --syntax    # Run only syntax check")
+    print("  python run_local_ci.py --lint      # Run only linting")
+    print("  python run_local_ci.py --import    # Run only import check")
+    print("  python run_local_ci.py --type      # Run only type check")
+    print("  python run_local_ci.py --config    # Run only config check")
+    print("  python run_local_ci.py --build     # Run only build test")
+    print("\n" + "="*60 + "\n")
+
+    # Parse arguments
+    if len(sys.argv) > 1:
+        arg = sys.argv[1].lower()
+
+        if arg == '--syntax':
+            sys.exit(0 if run_syntax_check() else 1)
+        elif arg == '--lint':
+            sys.exit(0 if run_lint_check() else 1)
+        elif arg == '--import':
+            sys.exit(0 if run_import_check() else 1)
+        elif arg == '--type':
+            sys.exit(0 if run_type_check() else 1)
+        elif arg == '--config':
+            sys.exit(0 if run_config_validation() else 1)
+        elif arg == '--build':
+            sys.exit(0 if run_build_test() else 1)
+        else:
+            print(f"Unknown argument: {arg}")
+            print("\nRun 'python run_local_ci.py' for usage.")
+            sys.exit(1)
+    else:
+        # Run all checks
+        sys.exit(run_all_checks())
+
+if __name__ == "__main__":
+    main()