feat(host/steam): default the gadget Deck on for SteamOS (glass-confirmed)

The virtual Steam Deck is validated glass-to-glass on a Deck: it appears as a
distinct second Steam controller, a held A drives Steam's overlay ("Resume
Game"), and a button press registers in a real game (confirmed in-game).

gadget_preferred() now defaults ON for SteamOS hosts (/etc/os-release ID=steamos
or ID_LIKE), OFF elsewhere where the universal UHID path stays the default;
PUNKTFUNK_STEAM_GADGET=1/0 forces it. A Deck-as-host with a physical Deck never
reaches this path — resolve_gamepad's conflict gate degrades SteamDeck → DualSense
first, so the two-Deck case never happens in production (it was only a test-rig
confound on the dev Deck).

The feature is complete: a virtual Steam Deck that Steam Input recognizes +
promotes, churn-free, with input flowing to games. Workspace clippy/fmt/test
green. Not pushed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

crates/punktfunk-host/src/inject/linux/steam_controller.rs

@@ -384,8 +384,8 @@ impl SteamControllerManager {
         if idx >= MAX_PADS || self.pads[idx].is_some() || self.broken {
             return;
         }
-        // Prefer the USB gadget on SteamOS (the only transport Steam Input promotes); fall back to the
-        // universal UHID pad if the gadget is unavailable or not opted in.
+        // Prefer the USB gadget on SteamOS (default there — the only transport Steam Input promotes);
+        // fall back to the universal UHID pad if the gadget is unavailable or disabled.
         let opened = if crate::inject::steam_gadget::gadget_preferred() {
             crate::inject::steam_gadget::ensure_modules();
             match crate::inject::steam_gadget::SteamDeckGadget::open(idx as u8) {

crates/punktfunk-host/src/inject/linux/steam_gadget.rs

@@ -606,11 +606,24 @@ pub fn ensure_modules() {
     }
 }
 
-/// Whether to prefer the USB-gadget Deck over the UHID `SteamDeckPad`. SteamOS-host only (needs the
-/// gadget modules + root) and opt-in for now (`PUNKTFUNK_STEAM_GADGET=1`) while the full Steam-Input
-/// feature contract is hardened; defaults off, so the universal UHID path stays the default.
+/// Whether to prefer the USB-gadget Deck over the UHID `SteamDeckPad` — the only transport Steam Input
+/// promotes (validated glass-to-glass on a Deck). Defaults **on for SteamOS** hosts (which ship the
+/// gadget modules + run Steam Input); off elsewhere, where the universal UHID path stays the default.
+/// `PUNKTFUNK_STEAM_GADGET=1`/`0` forces it on/off. A Deck-as-host with a *physical* Deck never reaches
+/// here: `resolve_gamepad`'s conflict gate degrades `SteamDeck` → DualSense before the manager is built.
 pub fn gadget_preferred() -> bool {
-    std::env::var("PUNKTFUNK_STEAM_GADGET")
-        .map(|v| v == "1" || v.eq_ignore_ascii_case("true"))
+    if let Ok(v) = std::env::var("PUNKTFUNK_STEAM_GADGET") {
+        return v == "1" || v.eq_ignore_ascii_case("true");
+    }
+    is_steamos()
+}
+
+/// True on SteamOS-class hosts (`/etc/os-release` `ID=steamos`, or `ID_LIKE` naming it).
+fn is_steamos() -> bool {
+    std::fs::read_to_string("/etc/os-release")
+        .map(|s| {
+            s.lines()
+                .any(|l| l == "ID=steamos" || (l.starts_with("ID_LIKE=") && l.contains("steamos")))
+        })
         .unwrap_or(false)
 }