Add wslc shell script for WSL interop

Add a shell script that allows WSL users to run 'wslc' without the
.exe extension, similar to how VS Code ships a 'code' script alongside
code.exe. The script resolves wslc.exe relative to its own location
and forwards all arguments.

- src/windows/wslc/wslc: new shell script
- msipackage: include the script in the MSI package
- test/windows/SimpleTests.cpp: add WslcShellScript smoke test

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Ben Hillis

msipackage/CMakeLists.txt

@@ -27,6 +27,9 @@ foreach(binary ${WINDOWS_BINARIES})
     list(APPEND BINARIES_DEPENDENCIES "${PACKAGE_INPUT_DIR}/${binary}")
 endforeach()
 
+# Shell script for WSL interop (allows running 'wslc' without the .exe extension inside WSL)
+list(APPEND BINARIES_DEPENDENCIES "${CMAKE_SOURCE_DIR}/src/windows/wslc/wslc")
+
 set(LINUX_BINARIES init;initrd.img)
 foreach(binary ${LINUX_BINARIES})
     list(APPEND BINARIES_DEPENDENCIES "${BIN}/${binary}")

msipackage/package.wix.in

@@ -28,6 +28,7 @@
 
                 <File Id="wslg.exe" Name="wslg.exe" Source="${PACKAGE_INPUT_DIR}/wslg.exe" />
                 <File Id="wslc.exe" Name="wslc.exe" Source="${PACKAGE_INPUT_DIR}/wslc.exe" />
+                <File Id="wslc" Name="wslc" Source="${CMAKE_SOURCE_DIR}/src/windows/wslc/wslc" />
                 <File Id="wslhost.exe" Name="wslhost.exe" Source="${PACKAGE_INPUT_DIR}/wslhost.exe" />
                 <File Id="wslrelay.exe" Name="wslrelay.exe" Source="${PACKAGE_INPUT_DIR}/wslrelay.exe" />
                 <File Id="wslserviceproxystub.dll" Name="wslserviceproxystub.dll" Source="${PACKAGE_INPUT_DIR}/wslserviceproxystub.dll" />

src/windows/wslc/.gitattributes

@@ -0,0 +1,2 @@
+# Shell scripts must keep Unix (LF) line endings to work in WSL
+wslc text eol=lf

src/windows/wslc/wslc

@@ -0,0 +1,12 @@
+#!/usr/bin/env sh
+#
+# Copyright (c) Microsoft. All rights reserved.
+#
+# Shell script to allow running wslc from within a WSL distribution
+# without needing the .exe extension (e.g. 'wslc' instead of 'wslc.exe').
+
+WSL_PATH="$(dirname "$(realpath "$0")")"
+WSLC_EXE="$WSL_PATH/wslc.exe"
+
+"$WSLC_EXE" "$@"
+exit $?

test/windows/SimpleTests.cpp

@@ -294,5 +294,14 @@ class SimpleTests
         VERIFY_IS_TRUE(output.find(L"/mnt/c/Program Files (x86)/Common Files") != std::wstring::npos);
         VERIFY_IS_TRUE(output.find(L"/mnt/c/Users/Test User/AppData/Local/Programs/Microsoft VS Code/bin") != std::wstring::npos);
     }
+
+    TEST_METHOD(WslcShellScript)
+    {
+        // Verify that the 'wslc' shell script (no .exe extension) invokes wslc.exe
+        // and produces the same output as calling wslc.exe directly.
+        auto [exeOutput, exeErr] = LxsstuLaunchWslAndCaptureOutput(L"wslc.exe version");
+        auto [scriptOutput, scriptErr] = LxsstuLaunchWslAndCaptureOutput(L"wslc version");
+        VERIFY_ARE_EQUAL(exeOutput, scriptOutput);
+    }
 };
 } // namespace SimpleTests