Realtek: per-device MinVersion floor; fix RTL8157/8159 stale-driver pick

[jm2]

What

Adds an optional per-device MinVersion floor to the catalog scrape engine and uses it to fix RTL8157/8159 selecting an ancient driver.

Why

A Gemini check flagged that several Realtek USB/PCIe parts pull older drivers than their siblings. Running the actual engine + verifying against the live catalog split this into two cases:

RTL8157 / RTL8159 — real defect (fixed here). The catalog has no modern (11XX-line NetAdapterCx) driver for these USB 5G/10G parts. The only HWID match is a 2016/2018 generic NDIS driver (11.19.602.2025) whose INF blankets ~16 legacy PIDs. "Highest [version] wins" then shipped that 9-year-old driver, while siblings 8153/8156 correctly get current 115x.x builds (Jan 2026).

RTL8126 / RTL8127 — NOT a bug (no change). The engine already selects their newest catalog driver (1126.27 / 1127.27, Sep 2025). They trail 8125/8168 only because Realtek shipped a newer release (rel-29, Feb 2026) for the mainstream 1G/2.5G parts but not the niche 5G/10G PCIe parts. Confirmed by dumping the full dual-query candidate sets — there is nothing newer to fetch.

How

Invoke-DriverScrape now reads an optional MinVersion per device; candidates below it are dropped, and a device left with no survivors is SKIPPED with the reason recorded in the manifest. realtek.psd1 floors RTL8157 at 1157 and RTL8159 at 1159, so:

• the 2016 generic driver (11.x < 1157/1159) is skipped today, and
• a real per-chip driver is auto-selected the moment Realtek publishes a 115x.x build (its [version] major clears the floor) — no future code change needed.

Live run confirms: 8153→1153.22.113.2026, 8156→1156.22.113.2026, 8157/8159 → "all candidates below MinVersion; none selected" → SKIPPED.

Compatibility / tests

• Backward-compatible: devices without MinVersion behave exactly as before (the floor-less PCIe entries cannot regress).
• Test-CatalogScrape.ps1: +5 assertions (MinVersion floor semantics + psd1 wiring). 74 passed / 0 failed.

🤖 Generated with Claude Code

[gemini-code-assist]

Code Review

This pull request introduces an optional per-device MinVersion floor configuration to filter out stale, generic legacy drivers from the Microsoft Update Catalog, ensuring only modern, chip-specific drivers are selected. It also updates the manifest generation to report when a device is skipped due to this floor and adds corresponding unit tests and configurations for Realtek devices. The review feedback suggests adding a warning if a configured MinVersion fails to parse to prevent silent failures, and optimizing a pipeline check in the loop by using member enumeration and the -notin operator instead of Where-Object.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

If MinVersion is defined in the configuration but fails to parse (due to a typo or invalid format), it will silently return $null and skip the floor check. Adding a warning when MinVersion is present but cannot be parsed helps prevent silent failures and configuration errors.

            $minVersion = $null
            if ($Device.ContainsKey('MinVersion')) {
                $minVersion = ConvertTo-CsVersion $Device.MinVersion
                if (-not $minVersion) {
                    Write-Warning "Device $label has an unparseable MinVersion '$($Device.MinVersion)'."
                }
            }

[gemini-code-assist]

Using a pipeline with Where-Object inside a loop to check for the existence of a key in $AvailablePackages is inefficient and less idiomatic in PowerShell. Since $AvailablePackages is an array of custom objects, you can leverage member enumeration ($AvailablePackages.Key) and the -notin operator for a cleaner, faster, and more direct check.

            if ($minVersion -and $floorDropped -gt 0 -and $deviceKey -notin $AvailablePackages.Key) {