All notable DeckDoc changes are recorded here. The project follows
Semantic Versioning; dates use YYYY-MM-DD.
- External-display blackout coverage for desktop mode (#29):
display_blackout.shnow inspects connected non-eDP connectors in a KWin session, matches each display's EDID against the stored KWin output policy, and emitsEXTERNAL_BLACKOUT_SIGNATURE: FULLSCREEN_SYNC_POLICY_GAP,SYNC_POLICY_UNDETERMINED(policy unreadable — treated as unpinned, never as fixed), orSYNC_POLICY_ALREADY_PINNEDwhen a physical-black symptom is declared with a healthy deck-side link — the discriminator for fullscreen adaptive-sync blanking on a monitor or dock chain. The internal and external assessments are independent, so an extended desktop reports both. - A guarded
rem_external_display.shremediation behind the new--fix-external-display-blackoutflag: pins adaptive sync off (kscreen-doctor vrrpolicy.never) for connected external outputs after desktop-session and symptom prechecks, with config backup and verification scoped to each targeted output (live state and per-EDID persistence). Shares the internal-panel remediation's no-power/brightness/clock-write contract; the pinned policy itself persists per-display by KWin design and is reversible viavrrpolicy.automaticor the saved backup.
- A connected-but-disabled internal panel (docked, external-only setups) no longer claims the
internal
LIVE_RENDER_TO_PHYSICAL_SCANOUT_GAPsignature ahead of an active external display; the panel must be enabled in the output configuration for that classification.
3.4.0 - 2026-07-21
- A versioned model and capability manifest that distinguishes Jupiter LCD, Galileo OLED, unknown hardware, supported/readable evidence, inaccessible evidence, absence, and non-applicability.
- Shared public-safe filtering for full reports, continuous-probe incidents, remediations, and Rescue archives, applied before persistent log writes with no intentionally retained raw variant.
- Adversarial privacy fixtures and model fixtures for Jupiter, Galileo, unknown, and inaccessible evidence states.
- A first-class RyuDeck application adapter that classifies guest startup stalls, active rendering, stale title-cache suspicion, stalled telemetry, and renderer/process fatal markers without emitting titles, IDs, paths, arguments, filenames, or raw app-log lines.
- Hardware consumers now use discovered DRM, battery, storage, and Wi-Fi paths from the manifest instead of assuming one fixed device path where discovery is available.
- Core, Steam, filesystem, mount, and block evidence is minimized to diagnostic fields rather than arbitrary filenames, paths, mount labels, or process inventories.
3.3.0 - 2026-07-21
- DeckMD's six-category guided entry point with 12 nested primary symptoms.
- Twenty-seven explicit contradiction rules that remove incompatible diagnostic paths.
- A grouped, searchable Browse all checks fallback covering all 128 diagnostic facts.
- Keyboard, pointer, mobile, URL-state, and no-match interaction validation for DeckMD.
- A local DeckMD favicon with no external runtime dependency.
- DeckMD now presents one focused follow-up group at a time and initially ranks only the three strongest matching branches.
- README and Pages copy now describe DeckDoc as a full diagnostic platform rather than a black-screen utility.
3.2.0 - 2026-07-21
- Expanded full-system coverage to 17 read-only diagnostic modules and two guarded remediations.
- Opt-in, resource-limited continuous incident probe with bounded private captures.
- Dock, USB-C, Power Delivery, Alt Mode, Ethernet, and external-display evidence collection.
- Read-only DeckDoc Rescue collector and unsigned ArchISO alpha builder.
- Root-owned, exact-command privileged diagnostic authorization prototype.
- Research-backed diagnostic wiki, issue index, and hardware-failure decision guide.
- Initial private, static DeckMD symptom checker and GitHub Pages deployment.
- Findings distinguish current-boot evidence from retained history and inaccessible sources.
- Steam, memory, thermal, Gamescope, display, and crash signatures gained tighter evidence boundaries.
3.1.0 - 2026-07-21
- LCD physical-blackout diagnosis and reversible Gamescope forced-composition testing.
- Optional persisted display-stability policy with backup, verification, and rollback.
- LCD blackout investigation notes and user-facing recovery documentation.
3.0.0 - 2026-06-25
- Diagnosis-first remediation lifecycle:
PRE_CHECK -> BACKUP -> EXECUTE -> VERIFY -> REPORT. - Guarded SOF audio reload for a current-boot Vangogh DSP failure signature.
- Display blackout diagnostic module and explicit
--fixmode.
2.0.0 - 2026-06-25
- Nine software and operating-system diagnostic modules covering audio, crashes, Wi-Fi, Gamescope, memory, Steam, microSD, suspend/resume, and GPU page faults.
- Mock regression coverage for the expanded diagnostic set.
1.0.1 - 2026-06-25
- Initial Steam Deck hardware diagnostic scaffold for GPU, battery, thermals, NVMe, and filesystems.