ws049: fix CI build break — gate pywifi to Python <3.12 (no 3.12 release)

The release CI (GitHub Actions, Python 3.12) failed at `pip install
-r requirements-windows.txt` with "No matching distribution found for
pywifi>=1.1.12": pywifi's latest (1.1.12) declares Requires-Python <3.12, so on
the 3.12 runner every version is filtered out. Pre-existing latent break
(identical on master; unrelated to the ws046-048 agent-code changes) that only
surfaces on a clean 3.12 install.

pywifi is an OPTIONAL hardware-fingerprint signal (Windows WiFi SSID scan) the
code already degrades gracefully without (hardware_detector.py wraps
`from pywifi import PyWiFi` in try/except → "skipping Windows WiFi scan"). So:
- requirements-windows.txt: add `and python_version < "3.12"` so pip skips it on
  3.12 instead of failing the whole install.
- hook-pywifi.py: only declare the hidden imports when pywifi is importable, so
  PyInstaller doesn't warn about bundling a missing module on 3.12.

Tradeoff: 3.12 builds ship without the WiFi-scan fingerprint signal (gracefully
skipped). Alternative if that signal matters: pin CI Python to 3.11.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: scszcoder

build_system/pyinstaller_hooks/hook-pywifi.py

@@ -6,14 +6,23 @@
 """
 import sys
 
-# Only include pywifi modules on Windows
+# Only include pywifi modules on Windows AND only when it is actually installed.
+# pywifi has no release for Python >=3.12, so on a 3.12 build it is absent and the
+# runtime falls back gracefully (hardware_detector.py skips the WiFi scan). Guard
+# the hidden imports on importability so PyInstaller doesn't warn/fail on a missing
+# module it was told to bundle.
 if sys.platform == 'win32':
-    hiddenimports = [
-        'pywifi',
-        'pywifi.const',
-        'pywifi.ifaces',
-    ]
-    print("[HOOK] Including pywifi for Windows")
+    import importlib.util
+    if importlib.util.find_spec('pywifi') is not None:
+        hiddenimports = [
+            'pywifi',
+            'pywifi.const',
+            'pywifi.ifaces',
+        ]
+        print("[HOOK] Including pywifi for Windows")
+    else:
+        hiddenimports = []
+        print("[HOOK] Skipping pywifi (not installed — e.g. Python >=3.12)")
 else:
     hiddenimports = []
     print("[HOOK] Skipping pywifi (not Windows)")

requirements-windows.txt

@@ -4,5 +4,11 @@
 # Windows specific packages
 pywin32>=310; platform_system == "Windows"
 pywin32-ctypes>=0.2.2; platform_system == "Windows"
-pywifi>=1.1.12; platform_system == "Windows"
+# pywifi caps at Requires-Python <3.12, so on the 3.12 CI/runtime it has NO
+# installable release ("No matching distribution found"). It is an OPTIONAL
+# hardware-fingerprint signal (Windows WiFi SSID scan) that the code already
+# degrades gracefully without (hardware_detector.py: try/except ImportError ->
+# "pywifi not installed; skipping Windows WiFi scan"), so gate it to <3.12
+# instead of failing the entire install on 3.12.
+pywifi>=1.1.12; platform_system == "Windows" and python_version < "3.12"
 comtypes>=1.2.0; platform_system == "Windows"  # Required by pywifi for COM interface