feat(mikroorm): add WSL path support for file tag

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: veksen

nodejs/sqlcommenter-nodejs/packages/sqlcommenter-mikroorm/src/path.ts

@@ -54,7 +54,24 @@ export function resolveFilePath(raw: string): string {
   }
   const projectRoot = findProjectRoot();
   const relativePath = filePath.substring(srcIdx);
-  return `${projectRoot}/${relativePath}:${lineCol}`;
+  const resolved = `${projectRoot}/${relativePath}`;
+  return `${applyWslPrefix(resolved)}:${lineCol}`;
+}
+
+/**
+ * Prefixes an absolute path with the WSL network path when running inside WSL.
+ *
+ * Inside WSL, absolute paths like `/home/user/project/...` can't be resolved
+ * from Windows-side tooling (e.g., clickable links in dashboards or VS Code).
+ * The `WSL_DISTRO_NAME` env var is always set inside WSL, and the path format
+ * `//wsl.localhost/<distro>/...` makes paths accessible from Windows.
+ */
+export function applyWslPrefix(filePath: string): string {
+  const distro = process.env.WSL_DISTRO_NAME;
+  if (distro) {
+    return `//wsl.localhost/${distro}${filePath}`;
+  }
+  return filePath;
 }
 
 /** @internal Exposed for testing only */

nodejs/sqlcommenter-nodejs/packages/sqlcommenter-mikroorm/test/path.spec.ts

@@ -5,6 +5,7 @@ import { join } from "node:path";
 import {
   findProjectRoot,
   resolveFilePath,
+  applyWslPrefix,
   _resetProjectRootCache,
 } from "../src/path.js";
 
@@ -68,3 +69,50 @@ test("resolveFilePath", async (t) => {
     assert.strictEqual(result, "/some/path/src/file.ts");
   });
 });
+
+test("applyWslPrefix", async (t) => {
+  const originalWslDistroName = process.env.WSL_DISTRO_NAME;
+
+  t.afterEach(() => {
+    if (originalWslDistroName === undefined) {
+      delete process.env.WSL_DISTRO_NAME;
+    } else {
+      process.env.WSL_DISTRO_NAME = originalWslDistroName;
+    }
+  });
+
+  await t.test("prefixes path when WSL_DISTRO_NAME is set", () => {
+    process.env.WSL_DISTRO_NAME = "Ubuntu-22.04";
+    const path = "/home/user/project/src/file.ts:1:1";
+    const result = applyWslPrefix(path);
+    assert.strictEqual(result, "//wsl.localhost/Ubuntu-22.04/home/user/project/src/file.ts:1:1");
+  });
+
+  await t.test("returns path unchanged when WSL_DISTRO_NAME is not set", () => {
+    delete process.env.WSL_DISTRO_NAME;
+    const path = "/home/user/project/src/file.ts:1:1";
+    const result = applyWslPrefix(path);
+    assert.strictEqual(result, path);
+  });
+});
+
+test("resolveFilePath with WSL", async (t) => {
+  const originalWslDistroName = process.env.WSL_DISTRO_NAME;
+
+  t.afterEach(() => {
+    _resetProjectRootCache();
+    if (originalWslDistroName === undefined) {
+      delete process.env.WSL_DISTRO_NAME;
+    } else {
+      process.env.WSL_DISTRO_NAME = originalWslDistroName;
+    }
+  });
+
+  await t.test("applies WSL prefix to resolved src/ paths", () => {
+    process.env.WSL_DISTRO_NAME = "Ubuntu-22.04";
+    const projectRoot = findProjectRoot();
+    const rawPath = "/wrong/deploy/dir/src/routes/admin.ts:12:15";
+    const result = resolveFilePath(rawPath);
+    assert.strictEqual(result, `//wsl.localhost/Ubuntu-22.04${projectRoot}/src/routes/admin.ts:12:15`);
+  });
+});