feat(#15): AI sharpness via Maxine VSR (Denoise/Deblur)

.github/workflows/ci.yml

@@ -16,6 +16,16 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      # The runner host has an x86 .NET (no SDK) at "C:\Program Files (x86)\dotnet"
+      # that can shadow the x64 SDK on PATH -> `dotnet build` fails "No .NET SDKs were
+      # found". Prepend the x64 install so the SDK wins for all later steps.
+      - name: Prefer x64 .NET on PATH
+        shell: pwsh
+        run: |
+          if (Test-Path "C:\Program Files\dotnet\dotnet.exe") {
+            "C:\Program Files\dotnet" | Out-File -FilePath $env:GITHUB_PATH -Append -Encoding utf8
+          }
+
       - name: Build native shim (SDK config, x64 Release)
         shell: pwsh
         run: |

.github/workflows/release.yml

@@ -25,6 +25,16 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      # The runner host has an x86 .NET (no SDK) at "C:\Program Files (x86)\dotnet"
+      # that can shadow the x64 SDK on PATH -> `dotnet build` (inside build-installer.ps1)
+      # fails "No .NET SDKs were found". Prepend the x64 install for all later steps.
+      - name: Prefer x64 .NET on PATH
+        shell: pwsh
+        run: |
+          if (Test-Path "C:\Program Files\dotnet\dotnet.exe") {
+            "C:\Program Files\dotnet" | Out-File -FilePath $env:GITHUB_PATH -Append -Encoding utf8
+          }
+
       # Self-hosted runner runs as NETWORK SERVICE, but _work is owned by Administrators,
       # so git's dubious-ownership guard blocks `gh release create --verify-tag` (which
       # shells out to git). Trust the workspace under THIS account's gitconfig — an

.gitignore

@@ -1,6 +1,7 @@
 [Bb]in/
 [Oo]bj/
 dist/
+.env
 *.user
 .vs/
 *.suo

CLAUDE.md

@@ -81,6 +81,7 @@ Three projects: `src/CameraOnScreen.Core` (pure .NET 8 logic, no WinUI/Win32 typ
 ## Maxine SDKs (not in repo; redistribution governed by the 2025 NVIDIA Software License + Open/Community Model Licenses)
 
 - **VFX** green screen (`nvvfxgreenscreen`) and **AR** eye contact (gaze) are separate NVIDIA products. No import `.lib` — link via the SDKs' proxy stubs (`nvVideoEffectsProxy.cpp`, `nvCVImageProxy.cpp`, `nvARProxy.cpp`) compiled into the shim. Models are prebuilt per-arch TensorRT engines; the bundle ships **sm75/86/89/100** (Turing/Ampere/Ada/Blackwell) — fetched from NGC by arch. **sm86 is the only arch verified on real silicon (RTX 3090); the others ship best-effort and grey out gracefully if an engine fails to deserialize.**
+- **VFX feature catalog — verify availability + the REAL API BEFORE coding an effect (cost ~6 wasted tasks once).** Authoritative installable set: `<VFX_SDK>\features\install_feature.ps1 -list_features` (NGC key via `NGC_CLI_API_KEY`). VFX 1.2.0.0 = `aigsrelighting, backgroundblur, denoising, greenscreen, relighting, transfer, upscale, videosuperres` (8). **There is NO `nvvfxartifactreduction`** — it's in the script's help text but NOT the catalog (removed since older VFX SDKs); coding against it = a dead, always-unavailable effect. **Super Resolution = NGX VSR** (`nvvfxvideosuperres`; ships `nvngx_vsr.dll`, NOT a per-arch TRT engine — "no models" is normal): real header `features\nvvfxvideosuperres\include\nvVFXVideoSuperRes.h` → selector `NVVFX_FX_VIDEO_SUPER_RES "VideoSuperRes"` + param `NVVFX_QUALITY_LEVEL` (NOT `"SuperRes"`/`NVVFX_MODE`/scale-from-dims). A feature's real selector + params + image format live ONLY in its per-feature header (`features\<name>\include\*.h`), installed on demand — never infer them; if the NGC key is the gate, get it up front.
 - **App-relative discovery** (`paths.{h,cpp}` `ShimModuleDir()` via `GetModuleHandleExW(FROM_ADDRESS)`, CWD-independent): both resolvers gain an `<app>\maxine\` tier so a shipped app finds the runtimes beside the exe with no env vars. Single shared co-versioned `maxine\` root (one TRT/CUDA runtime, dispatcher + feature DLLs, `models\vfx` + `models\ar`).
 - **Stage + Bundler.** Two steps now (dispatcher + per-feature-DLL SDK layout): (1) `scripts/assemble-maxine-stage.ps1` curates a co-versioned flat **stage** from the VFX 1.2.0.0 + AR 1.1.1.0 SDK trees (shared DLLs from VFX; AR dispatcher + 3 gaze feature DLLs from AR; the 6 license files; multi-arch engines via `scripts/fetch-maxine-engines.ps1`, NGC key). (2) `scripts/bundle-maxine.ps1 -OutDir X -MaxineStage <stage>` PRUNES the stage to the manifest's verified load-closure (`native/shim/bundle/maxine-manifest.psd1`; the 19-DLL `Dlls` list was produced by `native/shim/smoke/trace_closure.cpp`) + model globs + required `LicenseFiles`, into `<output>\maxine\`. Co-version is enforced at stage assembly, not by the bundler. `trace_closure`/`bundle_probe` re-run against the produced bundle (`COS_*` unset → both effects load) is the verify gate. End-user need: an **RTX GPU + recent driver**; no NVIDIA account or SDK download.
 - **Installer** (`scripts/bundle-maxine.ps1` consumer): `scripts/build-installer.ps1 -MaxineStage <stage>`