From 93bbfd64ea4d1cc3b6177a75ea433a2e3167fcbe Mon Sep 17 00:00:00 2001
From: Palash Debnath <4178343+debpalash@users.noreply.github.com>
Date: Mon, 7 Sep 2026 12:03:38 +0530
Subject: [PATCH] docs(device): explain optional accelerator probe fallbacks

---
 backend/core/device_caps.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/backend/core/device_caps.py b/backend/core/device_caps.py
index 6749d4ed..8a311c8f 100644
--- a/backend/core/device_caps.py
+++ b/backend/core/device_caps.py
@@ -538,6 +538,7 @@ def _probe() -> HostCaps:
     try:
         import intel_extension_for_pytorch  # noqa: F401
     except Exception:
+        # Optional IPEX may be absent or incompatible; still probe native torch XPU.
         pass
     try:
         if hasattr(torch, "xpu") and torch.xpu.is_available():
@@ -562,9 +563,11 @@ def _probe() -> HostCaps:
                 try:
                     device_name = torch.npu.get_device_name(0)
                 except Exception:
+                    # An unavailable display name does not invalidate a usable NPU.
                     pass
             notes.append("NPU VRAM not queried")
     except Exception:
+        # Missing or broken vendor backends mean no usable NPU; continue probing.
         pass
 
     # ── Apple Silicon MPS ────────────────────────────────────────────────