feat: complete Steam execution

2026-07-20 15:51:11 -04:00
parent bc0090c63d
commit 7d1077c0cb
13 changed files with 438 additions and 83 deletions
@@ -0,0 +1,28 @@
+# Phase 4 Steam execution evidence
+
+- Date: 2026-07-20
+- Requirement IDs: R-005, R-016, R-018, R-024
+- Phase/gate: phase 4 / Steam execution
+- Scope: typed native and Flatpak Steam launch plans, configuration provenance,
+  argument-safe client submission, private logs, structured errors, and representative
+  native plus Proton execution
+- Exclusions: direct executable launch, provider-client ownership, strong game-lifetime
+  tracking, automatic Steam shutdown, and minimal-session behavior
+- Host: Linux 7.1.4-arch1-1; NVIDIA GeForce RTX 5070 using the `nvidia` driver;
+  Steam 1.0.0.87-1
+- Commands: `kiln launch steam:105600 --dry-run --json`; `kiln launch steam:105600
+  --json`; `kiln launch steam:12810 --dry-run --json`; `kiln launch steam:12810
+  --json`; `make check`
+- Expected result: Kiln emits a typed `steam -silent -applaunch <appid>` plan, submits
+  it without shell interpolation, returns promptly with unknown lifecycle confidence,
+  launches one native and one Proton title through Steam, and reports missing clients
+  as structured failures
+- Observed result: Terraria App ID 105600 loaded through Steam Linux Runtime and its
+  native `Terraria.bin.x86_64`; Overlord II App ID 12810 loaded through
+  `GE-Proton11-1` and `Overlord2.exe`; both returned cleanly after user exit
+- Safety and cleanup: Steam was stopped before the temporary compatibility change and
+  final restore. The original `config.vdf` was restored byte-for-byte with SHA-256
+  `9251c6dbf08602857399916808208bd58dd415b5d5b000acc01f1c9044d89c37`, mode and
+  ownership unchanged, and Steam restarted
+- Automated result: 61 tests passed with the complete local gate
+- Result: pass
@@ -0,0 +1,16 @@
+# Phase 4 status
+
+Phase 4 is complete.
+
+| Exit condition | Evidence | Status |
+|---|---|---|
+| Steam launch plans | Typed native and Flatpak unit tests | Passed |
+| Safe client submission | Shell-free CLI integration test with private logs | Passed |
+| Failure handling | Structured missing-client integration assertion | Passed |
+| Native representative | Terraria App ID 105600 through Steam Linux Runtime | Passed |
+| Proton representative | Overlord II App ID 12810 through GE-Proton11-1 | Passed |
+| Host cleanup | Original Steam config restored byte-for-byte; Steam restarted | Passed |
+| Repository gates | `make check` | Passed |
+
+Full provider-client lifecycle tracking remains later session-hardening work. Phase 5
+can now prove the minimal compositor, terminal, login/session, and recovery path.