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

Inside WSL, absolute paths like /home/user/project/... can't be
resolved from Windows-side tooling (dashboards, VS Code terminal).
This detects the WSL_DISTRO_NAME env var and prefixes resolved paths
with //wsl.localhost/<distro> to make them accessible from Windows.

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

Author: veksen

nodejs/sqlcommenter-nodejs/packages/sqlcommenter-typeorm/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-typeorm/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,53 @@ test("resolveFilePath", async (t) => {
     assert.strictEqual(result, "/some/path/src/file.ts");
   });
 });
+
+test("applyWslPrefix", async (t) => {
+  const originalWslDistro = process.env.WSL_DISTRO_NAME;
+
+  t.afterEach(() => {
+    if (originalWslDistro === undefined) {
+      delete process.env.WSL_DISTRO_NAME;
+    } else {
+      process.env.WSL_DISTRO_NAME = originalWslDistro;
+    }
+  });
+
+  await t.test("prefixes path when WSL_DISTRO_NAME is set", () => {
+    process.env.WSL_DISTRO_NAME = "Ubuntu";
+    const result = applyWslPrefix("/home/user/project/src/index.ts");
+    assert.strictEqual(
+      result,
+      "//wsl.localhost/Ubuntu/home/user/project/src/index.ts",
+    );
+  });
+
+  await t.test("returns path unchanged when WSL_DISTRO_NAME is not set", () => {
+    delete process.env.WSL_DISTRO_NAME;
+    const result = applyWslPrefix("/home/user/project/src/index.ts");
+    assert.strictEqual(result, "/home/user/project/src/index.ts");
+  });
+});
+
+test("resolveFilePath with WSL", async (t) => {
+  const originalWslDistro = process.env.WSL_DISTRO_NAME;
+
+  t.afterEach(() => {
+    _resetProjectRootCache();
+    if (originalWslDistro === undefined) {
+      delete process.env.WSL_DISTRO_NAME;
+    } else {
+      process.env.WSL_DISTRO_NAME = originalWslDistro;
+    }
+  });
+
+  await t.test("applies WSL prefix to resolved src/ paths", () => {
+    process.env.WSL_DISTRO_NAME = "Ubuntu";
+    const projectRoot = findProjectRoot();
+    const result = resolveFilePath("/wrong/path/src/routes/admin.ts:12:15");
+    assert.strictEqual(
+      result,
+      `//wsl.localhost/Ubuntu${projectRoot}/src/routes/admin.ts:12:15`,
+    );
+  });
+});