test: handle Windows short paths in CI

Author: BhaveshY

tests/test_agent_readiness.py

@@ -10,6 +10,46 @@
 ROOT = Path(__file__).resolve().parents[1]
 
 
+def _long_windows_path(path):
+    text = str(path)
+    if os.name != "nt":
+        return text
+    try:
+        import ctypes
+
+        buffer = ctypes.create_unicode_buffer(32768)
+        result = ctypes.windll.kernel32.GetLongPathNameW(text, buffer, len(buffer))
+        if result:
+            return buffer.value
+    except Exception:
+        pass
+    return text
+
+
+def _path_variants(path):
+    values = {str(path), _long_windows_path(path)}
+    return {value for value in values if value}
+
+
+def _paths_equal(left, right):
+    left_values = {os.path.normcase(os.path.normpath(value)) for value in _path_variants(left)}
+    right_values = {os.path.normcase(os.path.normpath(value)) for value in _path_variants(right)}
+    return not left_values.isdisjoint(right_values)
+
+
+def _assert_path_equal(testcase, left, right):
+    testcase.assertTrue(_paths_equal(left, right), f"{left!r} is not the same path as {right!r}")
+
+
+def _assert_path_in_text(testcase, path, text):
+    escaped_variants = {value.replace("\\", "\\\\") for value in _path_variants(path)}
+    testcase.assertTrue(any(value in text for value in escaped_variants), f"none of {escaped_variants!r} found in text")
+
+
+def _assert_path_in_values(testcase, path, values):
+    testcase.assertTrue(any(_paths_equal(value, path) for value in values), f"{path!r} not found in {values!r}")
+
+
 class AgentReadinessTests(unittest.TestCase):
     def test_project_mcp_config_uses_bootstrap_runner(self):
         config = json.loads((ROOT / ".mcp.json").read_text(encoding="utf-8"))