Revamp GameInput backend and enhance diagnostics for gamepad support

[perditavojo]

This pull request introduces major improvements to the build and release workflow for handling the Microsoft GameInput Redistributable in the InputBox project. The changes ensure that the GameInput redist installer and its license files are bundled in release ZIPs for optional manual installation, update legal attributions, and strengthen packaging validation. The workflows are now more robust and compliant with Microsoft licensing requirements, and documentation has been updated to reflect these changes.

Build & Release Workflow Enhancements

• The release pipeline now builds and bundles the Microsoft GameInput Redistributable (GameInputRedist.msi) and its associated license/notice files into the release ZIP under a redist/ directory. The workflow validates the presence and hash of these files, and updates ThirdPartyNotices.txt accordingly. [1] [2] [3] [4]
• The release workflow now runs on windows-latest to support native build steps and sets new environment variables for the native shim and GameInput redist hash. [1] [2]

CI Workflow Updates

• The CI workflow now includes the tools/** directory for code checks, and adds steps to build and validate the GameInput native shim, including reading and verifying the Microsoft.GameInput package version. [1] [2]

Legal and Attribution Updates

• License and attribution handling has been updated: the workflow now excludes Microsoft.GameInput from the NuGet license tool output and no longer downloads or includes licenses for GameInput.Net, UsbVendorsLibrary, or usb.ids. Instead, it focuses on Microsoft GameInput redist compliance. [1] [2]

Documentation Updates

• The README.md has been updated to clarify that the release ZIP includes the Microsoft GameInput Redistributable for manual installation only, and that InputBox does not auto-install it. Legal attributions for GameInput.Net, UsbVendorsLibrary, and usb.ids have been removed, replaced by an attribution for Microsoft GameInput Redistributable. [1] [2]

Solution File Update

• The solution file (InputBox.slnx) now includes the native shim project for completeness.

[Copilot]

Pull request overview

這個 PR 以「自有 native shim + 受控端窄版 ABI」全面重整 GameInput 後端，並同步強化 CI / Release 的驗證與 Microsoft GameInput Redistributable 的打包合規流程，讓 GameInput 變成可選後端且在失敗時能可靠退避至 XInput，同時提供更完整的診斷資訊。

Changes:

• 新增 InputBox.GameInput.Native（C++）shim 與對應 C# interop/資料模型，並將主程式的 DLL resolver 擴充為同時支援 XInput 與 GameInput shim。
• 更新 GameInput 控制器輪詢/重連/診斷紀錄邏輯，新增多組針對 ABI、exports、VID/PID、missing-reading 等行為的測試守門。
• 重整 CI / Release：在 Windows runner 上建置與驗證 native shim、打包 redist/GameInputRedist.msi 與授權/notice、並對 ZIP 內容做 required/forbidden 驗證。

Reviewed changes

Copilot reviewed 27 out of 27 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tools/Validate-GameInputNativeShim.ps1	新增 shim exports/probe/lifecycle 的 PowerShell 驗證腳本，供 CI/Release 守門。
tests/InputBox.Tests/README.md	更新測試清單與覆蓋範圍說明（GameInput/shim 相關）。
tests/InputBox.Tests/InputBox.Tests.csproj	允許 unsafe 測試並更新 code coverage 套件版本。
tests/InputBox.Tests/GamepadFaceButtonProfileTests.cs	新增 VID/PID identity 下的 Auto 版面解析測試。
tests/InputBox.Tests/GamepadDeadzoneHysteresisTests.cs	新增 deadzone enter/exit 的正負方向對稱性守門測試。
tests/InputBox.Tests/GamepadControllerPauseTests.cs	補強 StopVibration、missing-reading、ClearAllEvents 等回歸測試。
tests/InputBox.Tests/GamepadControllerFactoryTests.cs	新增 GameInput 失敗退避至 XInput 的工廠策略測試。
tests/InputBox.Tests/GameInputPrimitivesTests.cs	新增 shim ABI/常數/exports/資料模型轉換等核心守門測試。
src/InputBox/Program.cs	將 DllImportResolver 改為統一解析控制器相關 native DLL（XInput + shim）。
src/InputBox/MainForm.Gamepad.cs	改用 GamepadControllerFactory 集中處理 GameInput 初始化與 XInput 退避。
src/InputBox/InputBox.csproj	引入 Microsoft.GameInput、加入 vcxproj 參考與 native shim 的 publish/build 複製規則。
src/InputBox/Core/Services/PhraseService.cs	匯出流程改用 PhrasePersistenceLock 包住序列化與寫檔，避免交錯。
src/InputBox/Core/Interop/DllResolver.cs	擴充 DLL resolver：新增 GameInput shim 的載入與 handle 快取。
src/InputBox/Core/Input/XInputGamepadController.cs	改用共用的 GamepadDeadzoneHysteresis.ResolveDirection，並補齊事件清理。
src/InputBox/Core/Input/GamepadControllerFactory.cs	新增集中化工廠：GameInput 失敗保留例外並退避 XInput。
src/InputBox/Core/Input/GameInputPrimitives.cs	新增 shim 受控端資料結構/enum/ABI metadata 定義。
src/InputBox/Core/Input/GameInputNative.cs	新增 shim P/Invoke、SafeHandle、runtime probe 與受控 wrapper。
src/InputBox/Core/Input/GameInputGamepadController.cs	以新 shim 後端重構讀取/診斷/missing reading 重列舉等邏輯。
src/InputBox.GameInput.Native/README.md	說明 shim 的範圍、ABI 規則、安全載入與驗證流程。
src/InputBox.GameInput.Native/InputBoxGameInputNative.cpp	新增 C++ shim：安全載入 GameInput runtime、窄版 ABI、診斷與 callback 管理。
src/InputBox.GameInput.Native/InputBox.GameInput.Native.vcxproj	新增 native shim 的 vcxproj（含 GameInput header 來源設定）。
README.md	更新發佈 ZIP 內含 GameInput redist 的「僅手動安裝」政策與第三方聲明。
InputBox.slnx	將 native shim 專案加入 solution。
docs/engineering/gamepad-api.md	更新 GameInput shim 的架構邊界、CI/Release 驗證規範與安全載入要求。
docs/engineering/gameinput-hardware-verification.md	新增正式發佈/高風險修改前的手動硬體驗證矩陣文件。
.github/workflows/release.yml	Release 改為 windows runner；建置/驗證 shim；打包 redist + license/notice；ZIP 內容驗證。
.github/workflows/ci.yml	CI code filter 納入 tools/**；新增 shim 建置與 Validate 腳本守門步驟。

Comments suppressed due to low confidence (1)

src/InputBox/Core/Interop/DllResolver.cs:42

• ResolveGameInputShim 目前用傳入的 libraryName 直接嘗試 TryLoad(libraryName) / TryLoad($"{libraryName}.dll")。當 libraryName 已經是 "InputBox.GameInput.Native.dll" 時，第二次嘗試會變成 "InputBox.GameInput.Native.dll.dll"，且不會嘗試不含副檔名的候選，導致這個分支在遇到帶 .dll 的請求名稱時可能永遠載不到。建議先正規化名稱（去掉 .dll）或改成同時嘗試 {name} 與 {name}.dll（避免 .dll.dll）。

        if (libraryName.Equals("InputBox.GameInput.Native", StringComparison.OrdinalIgnoreCase) ||
            libraryName.Equals("InputBox.GameInput.Native.dll", StringComparison.OrdinalIgnoreCase))
        {
            return ResolveGameInputShim(libraryName, assembly, searchPath);
        }