Document WSL VS Code debug requirements

Author: govert

test-explore/TEST_RESULTS.md

@@ -47,6 +47,18 @@ Optional flags:
 
 ## Recent runs
 
+### 2026-01-23 — VS Code harness (WSL Ubuntu, Linux)
+
+Command:
+- `wsl -d Ubuntu -- bash -lc "cd /mnt/c/Work/vbnet-lsp/test-explore/clients/vscode && npm test"`
+
+Outcome: FAIL (11 passing, 5 pending, 3 failing)
+Notes:
+- Debug suite failed to launch netcoredbg; LSP smoke passed.
+- Error: `Unexpected SIGPIPE` during debug session startup.
+- Root cause: `netcoredbg` failed to load `libdbgshim.so` (missing from the bundled debugger folder on WSL).
+- DAP trace: `test-explore/clients/vscode/logs/dap-trace-2026-01-23T161312583Z.log`.
+
 ### 2026-01-23 — VS Code harness (VB.NET server)
 
 Command:

test-explore/clients/vscode/README.md

@@ -70,3 +70,8 @@ npm test
 - If extension installation fails with an EPERM rename, delete `clients/vscode/.vscode-test/extensions` and rerun.
 - LSP smoke tests expect files under `test-explore/vbnet-lsp/fixtures`; if you set `FIXTURE_WORKSPACE` elsewhere, keep `SKIP_VBNET_SMOKE=1` to avoid standalone-document failures.
 
+## WSL notes
+
+- The harness will download the Linux VS Code build into `clients/vscode/.vscode-test` on first run.
+- Debug tests require a Linux `netcoredbg` binary **and** its sibling `libdbgshim.so`. If these are not installed, set `SKIP_VBNET_DEBUG=1` or provide `NETCOREDBG_PATH` in WSL.
+