Bundle libdbgshim for Linux netcoredbg

Author: govert

CHANGELOG.md

@@ -11,7 +11,7 @@ All notable changes to this project will be documented in this file.
 - _None yet._
 
 ### Fixed
-- _None yet._
+- Linux/WSL debugger bundling now ensures `libdbgshim.so` is included with netcoredbg.
 
 ### Known issues
 - _None yet._

src/extension/CHANGELOG.md

@@ -11,7 +11,7 @@ All notable changes to this project will be documented in this file.
 - _None yet._
 
 ### Fixed
-- _None yet._
+- Linux/WSL debugger bundling now ensures `libdbgshim.so` is included with netcoredbg.
 
 ### Known issues
 - _None yet._

src/extension/scripts/copy-debugger.js

@@ -55,6 +55,10 @@ const targetAsset = assets.targets?.[targetPlatform];
 const configuredDebuggerPath = resolveConfiguredPath(process.env.NETCOREDBG_PATH);
 const configuredLicensePath = resolveConfiguredPath(process.env.NETCOREDBG_LICENSE);
 const defaultExeName = targetPlatform.startsWith('win32') ? 'netcoredbg.exe' : 'netcoredbg';
+const requiredCompanion =
+    targetPlatform.startsWith('linux') ? 'libdbgshim.so'
+    : targetPlatform.startsWith('darwin') ? 'libdbgshim.dylib'
+    : '';
 const targetDir = path.join(extensionRoot, '.debugger');
 const targetExe = path.join(targetDir, defaultExeName);
 const targetLicense = path.join(targetDir, 'LICENSE.netcoredbg');
@@ -87,6 +91,13 @@ const findNetcoredbg = (root, exeName) => {
     return '';
 };
 
+const hasRequiredCompanion = (root) => {
+    if (!requiredCompanion) {
+        return true;
+    }
+    return fs.existsSync(path.join(root, requiredCompanion));
+};
+
 const downloadFile = (url, destination) =>
     new Promise((resolve, reject) => {
         const request = (currentUrl) => {
@@ -139,7 +150,13 @@ const resolveSourceExe = async () => {
 
     const localCandidate = path.join(sourceDir, defaultExeName);
     if (fs.existsSync(localCandidate)) {
-        return localCandidate;
+        if (!hasRequiredCompanion(path.dirname(localCandidate))) {
+            console.warn(
+                `Local netcoredbg at ${localCandidate} is missing ${requiredCompanion}; downloading target asset instead.`
+            );
+        } else {
+            return localCandidate;
+        }
     }
 
     if (!targetAsset?.url) {

test-explore/TEST_RESULTS.md

@@ -52,6 +52,15 @@ Optional flags:
 Command:
 - `wsl -d Ubuntu -- bash -lc "cd /mnt/c/Work/vbnet-lsp/test-explore/clients/vscode && npm test"`
 
+Outcome: PASS (14 passing, 5 pending; non-fatal DAP warnings)
+Notes:
+- DAP trace: `test-explore/clients/vscode/logs/dap-trace-2026-01-23T175654395Z.log`.
+
+### 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.