fix(install): make psutil a hard win32 dependency

pyproject.toml

@@ -11,17 +11,20 @@ license = "MIT"
 license-files = ["LICENSE"]
 authors = [{ name = "BMad Code, LLC" }]
 requires-python = ">=3.11"
-dependencies = ["pyyaml>=6.0"]
+dependencies = [
+  "pyyaml>=6.0",
+  # win32 liveness needs psutil (no /proc; os.kill(pid,0) is destructive there);
+  # without it the TUI shows every run as `?`. Hard dep so no install path misses it.
+  "psutil>=7.2.2; sys_platform == 'win32'",
+]
 
 [project.scripts]
 bmad-loop = "bmad_loop.cli:main"
 
 [project.optional-dependencies]
 tui = ["textual>=8.0,<9", "tomlkit>=0.13", "pyte>=0.8.2"]
-# Process discovery on non-Linux (no /proc): the Unity plugin's teardown lazily
-# imports psutil whenever it runs off Linux — macOS as well as a native-Windows
-# backend. The core stays dep-free; install with `pip install bmad-loop[non-linux]`
-# on those platforms.
+# macOS opt-in for psutil (identity/force-kill niceties); win32 gets it as a core
+# dep above, Linux stays dep-free. `pip install bmad-loop[non-linux]` on macOS.
 non-linux = ["psutil>=7.2.2"]
 
 [dependency-groups]

src/bmad_loop/data/plugins/unity/unity_teardown.py

@@ -48,16 +48,17 @@
 
 
 def _psutil():
-    """Lazily import psutil (the optional ``non-linux`` extra), used only for
-    non-Linux process discovery (macOS and Windows). The dep-free core never imports
-    it; raise a clear, actionable error if it's missing on a platform that needs it."""
+    """Lazily import psutil — a core dep on Windows, the ``non-linux`` extra on
+    macOS — used only for non-Linux process discovery (macOS and Windows). The
+    dep-free core never imports it; raise a clear, actionable error if it's missing
+    on a platform that needs it."""
     try:
         import psutil  # noqa: PLC0415  (intentional lazy import — keeps the core dep-free)
     except ImportError as exc:  # pragma: no cover - exercised only off Linux
         raise RuntimeError(
             f"unity_teardown: process discovery on {sys.platform!r} needs psutil; "
-            "install the optional extra (pip install 'bmad-loop[non-linux]') or run "
-            "under Linux/WSL"
+            "on Windows reinstall bmad-loop (psutil is a required dependency there), "
+            "on macOS run `pip install 'bmad-loop[non-linux]'`"
         ) from exc
     return psutil
 

src/bmad_loop/process_host.py

@@ -219,17 +219,17 @@ def _proc_starttime(pid: int) -> float | None:
 
 
 def _psutil():
-    """Lazily import psutil (the optional ``non-linux`` extra), used only for the
-    non-destructive Windows/macOS liveness + identity probes. The dep-free core
-    never imports it on Linux; raise a clear, actionable error if it's missing where
-    it's needed."""
+    """Lazily import psutil — a core dep on Windows, the ``non-linux`` extra on
+    macOS — used only for the non-destructive Windows/macOS liveness + identity
+    probes. The dep-free core never imports it on Linux; raise a clear, actionable
+    error if it's missing where it's needed."""
     try:
         import psutil  # noqa: PLC0415  (intentional lazy import — keeps the core dep-free)
     except ImportError as exc:  # pragma: no cover - exercised only off Linux
         raise ProcessHostError(
             f"process_host: pid operations on {sys.platform!r} need psutil; "
-            "install the optional extra (pip install 'bmad-loop[non-linux]') or run "
-            "under Linux/WSL"
+            "on Windows reinstall bmad-loop (psutil is a required dependency there), "
+            "on macOS run `pip install 'bmad-loop[non-linux]'`"
         ) from exc
     return psutil