Test managed shims in actual Decky 3.3.0 runtime

Repair Music Control for Decky's real legacy runtime

.github/workflows/decky-runtime.yml

@@ -0,0 +1,32 @@
+name: Decky backend runtime
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  decky-runtime:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, ubuntu-24.04-arm]
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - name: Actual Decky 3.3.0 discovery and safe backend probes
+        run: python3 scripts/framey-test-decky-runtime.py --output "$RUNNER_TEMP/decky-runtime.json"
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: decky-runtime-${{ matrix.os }}
+          path: ${{ runner.temp }}/decky-runtime.json
+          if-no-files-found: warn

docs/evidence/framey-mpris-runtime-2026-10-26.json

@@ -0,0 +1,807 @@
+{
+  "timeUtc": "2026-10-26T21:15:13.918421+00:00",
+  "plugins": [
+    {
+      "id": 12,
+      "name": "MusicControl",
+      "version": "1.1.6",
+      "sha256": "246b89fd653c60a735b1cc401d1b0937d5cb969eea9024561661ff741f081d62",
+      "backend": "Python",
+      "frontendApi": "legacy"
+    },
+    {
+      "id": 111,
+      "name": "Music Control",
+      "version": "1.1.7",
+      "sha256": "3f56a3f56034b277ea74a2c37cc84133b69e382aa6bcb0b43876776aac737ed9",
+      "backend": "Python",
+      "frontendApi": "legacy"
+    }
+  ],
+  "regressions": {
+    "removedBoundMethodShim": {
+      "result": "Plugin._get_dbus_env() missing 1 required positional argument: 'self'",
+      "success": false
+    },
+    "realFrameSubprocessDiagnostic": {
+      "uid": 1000,
+      "ldLibrary": "<Decky PyInstaller extraction directory>",
+      "results": [
+        {
+          "shell": false,
+          "code": 0,
+          "hasArray": true,
+          "stderr": ""
+        },
+        {
+          "shell": true,
+          "code": 1,
+          "hasArray": false,
+          "stderr": "/bin/sh: /usr/lib/libc.so.6: version `GLIBC_2.42' not found (required by <Decky PyInstaller extraction directory>/libtinfo.so.6)\n"
+        }
+      ]
+    }
+  },
+  "realFrame": {
+    "scope": "real Frame ARM64 Decky3.3; only discovery and selected-player read, no player controls",
+    "runtime": {
+      "version": "v3.3.0",
+      "sha256": "8ef5dcf36cbbbb6e97201a6baed5d79c4cc44ec27789fc9af1c5b6ae8f0b25b6"
+    },
+    "before": {
+      "arch": "aarch64",
+      "uid": 1000,
+      "decky": "failed",
+      "panel": "inactive",
+      "artLinkPresent": false,
+      "imagesParentPresent": true,
+      "battery": [
+        100
+      ]
+    },
+    "installs": [
+      {
+        "id": 12,
+        "receipt": {
+          "storeId": 12,
+          "sha256": "246b89fd653c60a735b1cc401d1b0937d5cb969eea9024561661ff741f081d62",
+          "version": "1.1.6",
+          "compatShims": [
+            "music-control-system-dbus-env"
+          ]
+        }
+      },
+      {
+        "id": 111,
+        "receipt": {
+          "storeId": 111,
+          "sha256": "3f56a3f56034b277ea74a2c37cc84133b69e382aa6bcb0b43876776aac737ed9",
+          "version": "1.1.7",
+          "compatShims": [
+            "music-control-system-dbus-env"
+          ]
+        }
+      }
+    ],
+    "calls": [
+      {
+        "id": 12,
+        "method": "sp_list_media_players",
+        "success": true,
+        "playerCount": 0
+      },
+      {
+        "id": 12,
+        "method": "sp_get_media_player",
+        "response": {
+          "result": "org.mpris.MediaPlayer2.spotify",
+          "success": true
+        }
+      },
+      {
+        "id": 111,
+        "method": "sp_list_media_players",
+        "success": true,
+        "playerCount": 0
+      },
+      {
+        "id": 111,
+        "method": "sp_get_media_player",
+        "response": {
+          "result": "org.mpris.MediaPlayer2.spotify",
+          "success": true
+        }
+      }
+    ],
+    "cleanup": {
+      "baseAbsent": true,
+      "unitAbsent": true,
+      "artLinkAbsent": true
+    },
+    "after": {
+      "arch": "aarch64",
+      "uid": 1000,
+      "decky": "failed",
+      "panel": "inactive",
+      "artLinkPresent": false,
+      "imagesParentPresent": true,
+      "battery": [
+        100
+      ]
+    },
+    "lockReleased": true
+  },
+  "isolatedRuntime": {
+    "version": "v3.3.0",
+    "architecture": "amd64",
+    "sha256": "e80d03e641d1766a33a817cb27ab8d2e0a4633685e5d27e4de948a6687526181",
+    "isolation": "Docker network none; no host audio/D-Bus/home/device mounts; dropped capabilities; private dbus-daemon and silent synthetic MPRIS service; archives and scripts read-only"
+  },
+  "backendFixtureChecks": [
+    {
+      "id": 12,
+      "version": "1.1.6",
+      "calls": [
+        {
+          "method": "sp_list_media_players",
+          "kwargs": {},
+          "response": {
+            "result": "org.mpris.MediaPlayer2.FrameySilent",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_set_media_player",
+          "kwargs": {
+            "player": "org.mpris.MediaPlayer2.FrameySilent"
+          },
+          "response": {
+            "result": null,
+            "success": true
+          }
+        },
+        {
+          "method": "sp_get_media_player",
+          "kwargs": {},
+          "response": {
+            "result": "org.mpris.MediaPlayer2.FrameySilent",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_identity",
+          "kwargs": {
+            "orgPath": "org.mpris.MediaPlayer2.FrameySilent"
+          },
+          "response": {
+            "result": "Player",
+            "success": true
+          }
+        },
+        {
+          "method": "get_meta_data",
+          "kwargs": {},
+          "response": {
+            "result": "trackid|/org/framey/TestTrack/1\nlength|180000000\ntitle|Silent Test Track\nartist|Fixture Artist\nalbum|Framey Test Album\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_status",
+          "kwargs": {},
+          "response": {
+            "result": "Paused",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_progress",
+          "kwargs": {},
+          "response": {
+            "result": "12000000",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_can_seek",
+          "kwargs": {},
+          "response": {
+            "result": "true",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_get_volume",
+          "kwargs": {},
+          "response": {
+            "result": "0.4",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_test_volume_control",
+          "kwargs": {},
+          "response": {
+            "result": "true",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_play",
+          "kwargs": {},
+          "response": {
+            "result": "",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_status",
+          "kwargs": {},
+          "response": {
+            "result": "Playing",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_pause",
+          "kwargs": {},
+          "response": {
+            "result": "",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_status",
+          "kwargs": {},
+          "response": {
+            "result": "Paused",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_next",
+          "kwargs": {},
+          "response": {
+            "result": "",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_previous",
+          "kwargs": {},
+          "response": {
+            "result": "",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_seek",
+          "kwargs": {
+            "amount": 2000000
+          },
+          "response": {
+            "result": "",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_progress",
+          "kwargs": {},
+          "response": {
+            "result": "14000000",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_set_position",
+          "kwargs": {
+            "position": 45000000,
+            "trackid": "/org/framey/TestTrack/1"
+          },
+          "response": {
+            "result": "",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_progress",
+          "kwargs": {},
+          "response": {
+            "result": "45000000",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_set_volume",
+          "kwargs": {
+            "volume": 0.25
+          },
+          "response": {
+            "result": "method return time=1793049278.417118 sender=:1.0 -> destination=:1.19 serial=20 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_get_volume",
+          "kwargs": {},
+          "response": {
+            "result": "0.25",
+            "success": true
+          }
+        }
+      ],
+      "independentFixtureState": {
+        "PlaybackStatus": "Paused",
+        "Position": 45000000,
+        "Volume": 0.25,
+        "next": 1,
+        "previous": 1,
+        "writes": [
+          [
+            "PlayPause"
+          ],
+          [
+            "Pause"
+          ],
+          [
+            "Next"
+          ],
+          [
+            "Previous"
+          ],
+          [
+            "Seek",
+            2000000
+          ],
+          [
+            "SetPosition",
+            45000000
+          ],
+          [
+            "Volume",
+            0.25
+          ]
+        ]
+      }
+    },
+    {
+      "id": 111,
+      "version": "1.1.7",
+      "calls": [
+        {
+          "method": "sp_list_media_players",
+          "kwargs": {},
+          "response": {
+            "result": "org.mpris.MediaPlayer2.FrameySilent",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_set_media_player",
+          "kwargs": {
+            "player": "org.mpris.MediaPlayer2.FrameySilent"
+          },
+          "response": {
+            "result": null,
+            "success": true
+          }
+        },
+        {
+          "method": "sp_get_media_player",
+          "kwargs": {},
+          "response": {
+            "result": "org.mpris.MediaPlayer2.FrameySilent",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_identity",
+          "kwargs": {
+            "orgPath": "org.mpris.MediaPlayer2.FrameySilent"
+          },
+          "response": {
+            "result": "Player",
+            "success": true
+          }
+        },
+        {
+          "method": "get_meta_data",
+          "kwargs": {},
+          "response": {
+            "result": "trackid|/org/framey/TestTrack/1\nlength|180000000\ntitle|Silent Test Track\nartist|Fixture Artist\nalbum|Framey Test Album",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_status",
+          "kwargs": {},
+          "response": {
+            "result": "Paused",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_progress",
+          "kwargs": {},
+          "response": {
+            "result": "12000000",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_can_seek",
+          "kwargs": {},
+          "response": {
+            "result": "true",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_get_volume",
+          "kwargs": {},
+          "response": {
+            "result": "0.4",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_test_volume_control",
+          "kwargs": {},
+          "response": {
+            "result": "true",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_play",
+          "kwargs": {},
+          "response": {
+            "result": "method return time=1793049473.137015 sender=:1.0 -> destination=:1.12 serial=13 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_status",
+          "kwargs": {},
+          "response": {
+            "result": "Playing",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_pause",
+          "kwargs": {},
+          "response": {
+            "result": "method return time=1793049473.340963 sender=:1.0 -> destination=:1.14 serial=15 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_status",
+          "kwargs": {},
+          "response": {
+            "result": "Paused",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_next",
+          "kwargs": {},
+          "response": {
+            "result": "method return time=1793049473.547273 sender=:1.0 -> destination=:1.16 serial=17 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_previous",
+          "kwargs": {},
+          "response": {
+            "result": "method return time=1793049473.649558 sender=:1.0 -> destination=:1.17 serial=18 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_seek",
+          "kwargs": {
+            "amount": 2000000
+          },
+          "response": {
+            "result": "method return time=1793049473.752790 sender=:1.0 -> destination=:1.18 serial=19 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_progress",
+          "kwargs": {},
+          "response": {
+            "result": "14000000",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_set_position",
+          "kwargs": {
+            "position": 45000000,
+            "trackid": "/org/framey/TestTrack/1"
+          },
+          "response": {
+            "result": "method return time=1793049473.965468 sender=:1.0 -> destination=:1.20 serial=21 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_track_progress",
+          "kwargs": {},
+          "response": {
+            "result": "45000000",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_set_volume",
+          "kwargs": {
+            "volume": 0.25
+          },
+          "response": {
+            "result": "method return time=1793049474.175137 sender=:1.0 -> destination=:1.22 serial=23 reply_serial=2\n",
+            "success": true
+          }
+        },
+        {
+          "method": "sp_get_volume",
+          "kwargs": {},
+          "response": {
+            "result": "0.25",
+            "success": true
+          }
+        }
+      ],
+      "independentFixtureState": {
+        "PlaybackStatus": "Paused",
+        "Position": 45000000,
+        "Volume": 0.25,
+        "next": 1,
+        "previous": 1,
+        "writes": [
+          [
+            "Volume",
+            0.01
+          ],
+          [
+            "Volume",
+            0.4
+          ],
+          [
+            "PlayPause"
+          ],
+          [
+            "Pause"
+          ],
+          [
+            "Next"
+          ],
+          [
+            "Previous"
+          ],
+          [
+            "Seek",
+            2000000
+          ],
+          [
+            "SetPosition",
+            45000000
+          ],
+          [
+            "Volume",
+            0.25
+          ]
+        ]
+      }
+    }
+  ],
+  "browserChecks": [
+    {
+      "id": 12,
+      "scope": "opaque local Chromium + real amd64 Decky3.3 + private silent MPRIS",
+      "checks": [
+        {
+          "rendered": "Music Control\nCurrently Playing\nSilent Test Track\nFixture Artist\nPlayback Volume\nPlayer\nInfo"
+        },
+        {
+          "clickedButton": 0,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 1,
+            "previous": 2
+          }
+        },
+        {
+          "clickedButton": 2,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "clickedButton": 1,
+          "independentReadback": {
+            "PlaybackStatus": "Playing",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "clickedButton": 1,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "slider": 0,
+          "value": 0.5,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 90000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "slider": 1,
+          "value": 60,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 90000000,
+            "Volume": 0.6,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "infoRoute": "Music Control\nBack to plugin\nMusicControl\nInfoUsageTroubleshooting\nMusicControl allows you to control any media playback that is currently running that implements the MPRIS dbus interface.\nExamples of application that are supported:\nSpotify\nCider\nChrome / Firefox\nStrawberry\nOnly the flatpak versions of these applications have been tested, and not all of them might support the full feature set, so it is recommended to use the discover store to install the applications."
+        },
+        {
+          "reopened": "Music Control\nCurrently Playing\nSilent Test Track\nFixture Artist\nPlayer\nInfo",
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 90000000,
+            "Volume": 0.6,
+            "next": 2,
+            "previous": 2
+          }
+        }
+      ]
+    },
+    {
+      "id": 111,
+      "scope": "opaque local Chromium + real amd64 Decky3.3 + private silent MPRIS",
+      "checks": [
+        {
+          "rendered": "Music Control\nCurrently Playing\nSilent Test Track\nFixture Artist\nPlayback Volume\nPlayer\nInfo"
+        },
+        {
+          "clickedButton": 0,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 1,
+            "previous": 2
+          }
+        },
+        {
+          "clickedButton": 2,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "clickedButton": 1,
+          "independentReadback": {
+            "PlaybackStatus": "Playing",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "clickedButton": 1,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 45000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "slider": 0,
+          "value": 0.5,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 90000000,
+            "Volume": 0.25,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "slider": 1,
+          "value": 60,
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 90000000,
+            "Volume": 0.6,
+            "next": 2,
+            "previous": 2
+          }
+        },
+        {
+          "infoRoute": "Music Control\nBack to plugin\nMusicControl\nInfoUsageTroubleshooting\nMusicControl allows you to control any media playback that is currently running that implements the MPRIS dbus interface.\nExamples of application that are supported:\nSpotify\nCider\nChrome / Firefox\nStrawberry\nOnly the flatpak versions of these applications have been tested, and not all of them might support the full feature set, so it is recommended to use the discover store to install the applications."
+        },
+        {
+          "reopened": "Music Control\nCurrently Playing\nSilent Test Track\nFixture Artist\nPlayer\nInfo",
+          "independentReadback": {
+            "PlaybackStatus": "Paused",
+            "Position": 90000000,
+            "Volume": 0.6,
+            "next": 2,
+            "previous": 2
+          }
+        }
+      ]
+    }
+  ],
+  "limitations": [
+    "Real Frame had no running MPRIS players. No real media transport or volume writes ran.",
+    "The private fixture emits no audio and does not prove playback in a supported media app.",
+    "Album art, physical controller, VR keyboard and worn VR were not tested.",
+    "Both upstream backends truncate multiword Identity to its final word.",
+    "Music Control 1.1.7 automatically probes player volume by writing 0.01 and restoring it; this ran only against the private fixture.",
+    "Existing installed copies require remove/reinstall or an explicit managed update."
+  ],
+  "validation": {
+    "pythonSuite": {
+      "run": 1639,
+      "skipped": 16,
+      "passed": true
+    },
+    "fakeFrame": {
+      "total": 116,
+      "results": {
+        "blocked": 55,
+        "installed-removed": 61
+      },
+      "backendExecution": false
+    },
+    "currentStore": {
+      "checkedAtUtc": "2026-10-26T21:17:39.609721+00:00",
+      "plugins": 116,
+      "allPinnedDigestsUnchanged": true
+    },
+    "independentCleanupAudit": "MPRIS_CLEANUP_AUDIT_PASS: shared lock, test services/runtime directories and owned cache link absent",
+    "pinnedHttpSshFlow": {
+      "command": "scripts/e2e.sh test_framey",
+      "passed": 2,
+      "seconds": 32.59,
+      "scope": "pinned official archive receipt assertions and sample install/update/remove safeguards"
+    }
+  }
+}

docs/evidence/framey-mpris-runtime-2026-10-26.md

@@ -0,0 +1,76 @@
+# MusicControl / Music Control runtime checks, 26 October 2026
+
+Both official entries remain **partial**. Their pure-Python backends need a
+user-session MPRIS player and `dbus-send`, rather than Deck-specific hardware or
+an x86 binary. [Results](framey-mpris-runtime-2026-10-26.json) pin both archives
+and the actual Decky 3.3.0 executables used.
+
+Two runtime failures were reproduced and repaired:
+
+- The #335 `music-control-bound-methods` transformation was incorrect. Neither
+  manifest declares `api_version`, so Decky uses `module.Plugin` and explicitly
+  supplies the class as `self`. The earlier test used `module.Plugin()` and
+  therefore diagnosed a fixture error as an upstream bug. In actual Decky,
+  the transformation breaks discovery with `_get_dbus_env() missing ... self`
+  and transport with `_sp_player_dbus() missing ... parameters`. Managed installs
+  now retain the original class calls. This supersedes the earlier
+  [bound-method evidence](framey-music-control-bound-methods-2026-10-26.md).
+- On Frame OS 0.5.6, MusicControl 1.1.6's `/bin/sh` subprocess inherits Decky's
+  PyInstaller library path. Its bundled `libtinfo.so.6` needs `GLIBC_2.42`, which
+  the Frame's libc lacks. A private diagnostic backend confirmed the same
+  read-only D-Bus command fails with a shell and succeeds without one. Both
+  exact-archive backends now restore `LD_LIBRARY_PATH_ORIG` (or an empty path)
+  only in their copied D-Bus subprocess environment. The Decky process keeps
+  its original environment. The receipt records `music-control-system-dbus-env`.
+
+The patch is gated by store ID, SHA-256 and folder, and checks the expected
+source before editing. Existing installed copies need **remove/reinstall** or
+an explicit managed update; a desktop update alone does not rewrite them.
+The store still shows partial, with the same reason as the docs table.
+
+Actual Decky 3.3.0 amd64 ran each repaired production-managed install separately
+in a container with no network, host audio, host D-Bus, home or device access.
+A private `dbus-daemon` hosted a silent synthetic MPRIS service. Discovery,
+selection, identity, metadata, status, progress, volume/CanSeek reads,
+play/pause, next/previous, seek, track position and volume writes passed through
+the real legacy websocket RPC envelope. The service's own state independently
+confirmed each write. The shared plugin folder prevents co-installation; each
+entry was tested in a fresh container.
+
+Local headless Chromium loaded the shipped `headset.html` and exact official
+frontends inside their ordinary opaque `allow-scripts` iframe. The relay used
+actual Decky backends and allowed only the private fixture. Track/artist
+rendering, previous/next, play/pause, seek to 90 seconds, volume to 60%, Info
+navigation and close/reopen passed for both entries. Chromium retained its
+normal process isolation and sandboxed-origin restrictions. No external media
+or artwork request was permitted.
+
+Under the shared `/tmp/frame-test.lock`, a removable private Decky 3.3.0 ARM64
+user service loaded each corrected managed install on the real Frame.
+Read-only `sp_list_media_players` returned an empty string successfully for
+both, and `sp_get_media_player` returned their default Spotify bus name.
+These final checks used Decky's direct loopback websocket through SSH; they
+do not claim the deployed Framey HTTP/CEF route. Earlier CEF attempts encountered
+transient reinjection failures. No player controls ran on the real Frame.
+The private units, runtimes and owned Steam image-cache link were removed;
+independent follow-up reads confirmed cleanup and lock release. Battery was
+100 → 100. Existing managed Decky remained failed and the headset panel inactive,
+as found. Power settings were not changed.
+
+Remaining gaps: actual media-app playback/volume on ARM64, local-file album-art
+routing, physical controls and worn VR. Both backends truncate multiword player
+names to their last word. Music Control 1.1.7 automatically probes volume by
+writing 0.01 and restoring it; this was exercised only on the silent fixture.
+
+Validation: full Python suite **1,639 tests, 16 skipped**; focused managed-store
+suite **23/23**; shared frontend action checks; all **116** store digests unchanged.
+The complete fake-Frame audit passed: **61 installed/removed, 55 rejected**
+for documented safeguards; official backends are stubbed in that harness. The
+regression test uses Decky's actual legacy class convention for both entries,
+checks original/absent library-path restoration without changing the parent
+environment, and rejects transferring the patch to a different archive digest.
+
+The pinned HTTP/SSH flow also passed `scripts/e2e.sh test_framey`: **2/2**
+tests in 32.590 seconds. Its receipt assertion covers the replacement shim for
+both Music Control entries; the old assertion caused the first hosted e2e
+failure and left a plugin installed, cascading into the following test.

docs/evidence/framey-music-control-bound-methods-2026-10-26.md

@@ -1,34 +1,15 @@
-# Music Control 1.1.7 bound-method compatibility, 26 October 2026
+# Superseded: Music Control bound-method fixture
 
-The official Decky store archive for ID 111, version 1.1.7, is
-`3f56a3f56034b277ea74a2c37cc84133b69e382aa6bcb0b43876776aac737ed9`
-(SHA-256). The pinned `tests/fixtures/framey-official/111.zip` matches that
-digest and includes the upstream license.
+The #335 result was incorrect. Its test instantiated `module.Plugin()`, while
+actual Decky 3.3.0 uses the class `module.Plugin` for this legacy manifest and
+supplies the class as `self`. The published backend's explicit-self calls are
+correct in that runtime. Removing those arguments breaks actual Decky discovery
+and transport.
 
-The unchanged backend fails before it reaches D-Bus: `sp_list_media_players`
-raises `TypeError: Plugin._get_dbus_env() takes 1 positional argument but 2
-were given`, and `sp_play` raises the corresponding `_sp_player_dbus` argument
-error. The source passes `self` explicitly to methods already bound by Python.
-
-For this exact store ID, archive digest and folder, a managed install removes
-the redundant argument at the five affected call sites. It checks the number
-of occurrences before writing `main.py` and records
-`music-control-bound-methods` in the managed receipt. The original ZIP remains
-the verified download; the older ID 12 archive is installed without this
-change.
-
-`test_exact_music_control_backend_calls_work_after_managed_install` installs
-the official ZIP through the production transaction script into a disposable
-home. It imports the patched backend and exercises player enumeration,
-selection, play/pause, next/previous, volume and playback-status calls against
-a private fake `dbus-send` executable that records the actual command
-arguments. It then removes the plugin through the receipt-bound transaction.
-The same test confirms ID 12 retains its original backend source. The focused
-store suite passed **23/23** tests locally. The pinned frontend/fake-Frame
-install/remove tests are part of the hosted gate.
-
-This proves that the Python argument mismatch no longer prevents backend
-command dispatch in the isolated fixture. The fixture is not an MPRIS player.
-Actual Decky 3.3.0 ARM64 execution, live player discovery, media transport,
-volume effects, album-art routing, and wearer-visible VR controls have not
-been verified. Music Control remains **partial**.
+The follow-up [real runtime checks](framey-mpris-runtime-2026-10-26.md) reproduce
+the regression, remove the incorrect transformation and replace the test with
+the actual legacy calling convention. They also identify and repair a separate
+Frame OS system-command library-path failure. Existing copies installed with
+`music-control-bound-methods` must be removed/reinstalled or explicitly updated.
+Both official Music Control entries remain partial; the follow-up describes
+exactly what passed and what remains unverified.

docs/evidence/framey-native-port-blockers-2026-10-26.md

@@ -0,0 +1,44 @@
+# Native plugin packaging blockers, 26 October 2026
+
+This is a static, digest-scoped follow-up. Neither plugin was installed or
+run on the Frame. Their compatibility statuses remain **broken**.
+
+## Decky Cloud Save 1.4.2, store ID 49
+
+The official ZIP SHA-256 is
+`b311d967ddf1b0f0046d36929645855891a40173e3a93f6f0cd8b1576b04b411`.
+It was downloaded and hash-checked without executing any member. Of its 27
+members, `decky-cloud-save/bin/rclone` is a regular executable of **60,776,600
+bytes** with ELF machine **62 (x86_64)**. The installer permits at most 30 MiB
+per member, so this exact ZIP fails before native architecture validation.
+Raising that limit alone would still leave an x86_64 executable on the ARM64
+Frame. No cloud credentials, saves, reads or writes were exercised.
+
+## Emuchievements 2.0.5, store ID 28
+
+The official ZIP SHA-256 is
+`98dcb443e81b9f9011cfe77c69eb659869c8e2df2df8b0a443df66cbfc2f5a89`.
+The [earlier helper check](framey-emuchievements-arm-2026-10-26.md) proved
+one synthetic ROM hash on ARM64, without installing the plugin. The upstream
+source commit `8567e94befffc943434b2adb842487274815f8bb` and its pinned
+libarchive, libchdr and rcheevos submodules were checked out separately for
+this audit. The source is GPL-3.0. An isolated Debian ARM64 cross-build made a
+2.6 MB helper (`c8794558a0d75294930f969a426e7d2ac13a27e3c1ff9bd8aae093e31596b9bd`),
+but it was **not shipped or run on ROM archives**. A complete source bundle
+without Git metadata compressed to about 8 MB; source and license distribution
+would be part of any release-ready port.
+
+The proposed source has an additional blocker. `backend/src/util.cpp` builds
+an extraction destination by appending each raw archive member pathname to
+an owned `/tmp/tmpdir.*` prefix, then passes it to libarchive's disk writer.
+It neither rejects `..`/absolute paths nor enables libarchive's secure path
+flags. `backend/src/main.cpp` later removes the extracted file's parent path.
+With an untrusted archive, those paths may leave the intended temporary
+directory. The plugin's Python backend also invokes `bin/hash` through a
+shell with a path argument. A port needs bounded path validation, secure
+extraction/cleanup, safe subprocess arguments, format coverage and actual
+Decky/backend tests before its official ZIP can be transformed or installed.
+
+The official archive still contains an x86_64 helper. RetroAchievements
+login, real ROM scanning, a packaged ARM64 backend, wearer-visible VR and
+physical controller use remain unverified.

docs/framey-compatibility.md

@@ -29,7 +29,7 @@ A [Free Loader duplicate-entry follow-up](evidence/framey-free-loader-duplicates
 
 The current published digests are pinned in the JSON; if the store changed, retain/download those exact archives for reproduction. Audit downloads permit larger ZIPs for inspection; production installer limits remain 50 MiB ZIP / 150 MiB unpacked / 30 MiB per member.
 
-After the VR job released the shared lock, this audit acquired it and used a private temporary Decky 3.3.0 ARM64 user service. Read-only ProtonDB `get_setting` and Steam Status `get_settings` calls succeeded through the live Steam CEF websocket. The service and private base were removed and the lock released; normal managed services stayed inactive, battery was 100 → 99, and no power setting was changed. [Redacted results](evidence/framey-official-backend-2026-10-25.json) record exactly what ran. A [2026-10-26 follow-up](evidence/framey-events-backend-2026-10-26.json) verified default Notebook drawing/save/reopen across a real backend restart and Simple Timer start/cancel, countdown/completion events, a visible toast and persisted recents/subtle mode. Only private test settings were written. Simple Timer remains partial because its own expired-timer startup raises a missing `timer_task` error; sound/suspend are unsupported. A [local audio follow-up](evidence/framey-audio-backends-2026-10-26.md) exercised Volume Mixer, Volume Boost and Mixer through real Decky 3.3.0 amd64 backends on private silent virtual audio targets. Sliders, numeric volume entry, independent server readbacks and Mixer filter persistence across a runtime restart passed. An [ARM64 audio follow-up](evidence/framey-audio-arm64-2026-10-26.md) verified the unmodified official backends in actual Decky 3.3.0 on the Frame user audio session. Volume Mixer and Mixer now qualify as works for per-app volume: Chromium controls changed only a named silent stream, with independent Pulse readbacks. That run left Volume Boost partial because sink writes were denied. A [Volume Boost follow-up](evidence/framey-volume-boost-arm64-2026-10-26.md) now verifies linked/separate channel controls, re-link and reopen through the actual ARM64 backend. Independent Pulse reads confirmed 125%/150% gain writes while the default sink stayed muted; exact original volume/mute was restored. Volume Boost qualifies as works for sink controls. Audible output, Bluetooth playback and worn VR remain unverified. A [running-context follow-up](evidence/framey-running-context-2026-10-26.md) supplies detached running-app/main-app reads and relays actual Steam lifetime callbacks while a panel is open. Real Frame checks verified an empty list, registration/cleanup and the exact Discord Status ARM64 backend reporting no IPC connection. Nonempty games and transitions were synthetic fixtures; real game events, Discord activity and worn VR remain unverified. Discord Status moves to partial; no new works claim is made. A [library context follow-up](evidence/framey-library-context-2026-10-26.md) read 1,106 app overviews, 895 game IDs and the current public Steam ID from real Frame CEF under the shared lock. Local Chromium replayed this detached snapshot to render Deck Settings game selection, Steamback's empty save panel and PlayTime statistics/settings. Steamback and PlayTime used actual Decky 3.3.0 amd64 backends in an isolated container; their ARM64 backends and automatic game hooks remain unverified. Shotty's frontend now starts, but its published backend fails on missing `click`; it stays broken. A [chunked frontend follow-up](evidence/framey-deck-shelves-browser-2026-10-26.md) loaded Deck Shelves 2.0.0 through a managed JavaScript module route and rendered its settings in an opaque local Chromium panel. Its backend was denied; Steam Home shelves and worn VR remain unverified. A [local module lookup follow-up](evidence/framey-module-lookup-2026-10-26.md) supplies a finite registry of Framey-local controls and CSS. TabMaster QAM/docs now render; Steam library-tab editing remains unavailable. That pass exposed Junk-Store executable-script extraction failures; the follow-up below repairs them. SteamGridDB still requires Steam context-menu internals and DeckSP still fails its published MobX fallback. That pass tested TabMaster/Junk-Store in actual isolated amd64 Decky, without ARM64 or worn-VR coverage. A [script entrypoint follow-up](evidence/framey-script-entrypoints-2026-10-26.md) grants owner execute to shebang scripts and ZIP-declared executables without copying archive privilege/write bits. Junk-Store now passes static menu/backend calls in actual Decky 3.3.0 ARM64 and local Chromium Games/Epic navigation, back and reopen. It moves to partial: About still crashes on missing installed-app metadata, Legendary is absent, and login/game operations remain unverified. Existing installations require update/reinstall to repair permissions. A [read-only installed-metadata follow-up](evidence/framey-installed-context-2026-10-26.md) now repairs the About crash. The library snapshot copies only Steam-supplied installed booleans into detached metadata, preserving unknown values as undefined. Junk-Store About/Dependencies, Back and reopen render in local Chromium with actual Frame library data and the official ARM64 backend. It remains partial: dependency/login/game operations, RSS, the optional Line truncated
+After the VR job released the shared lock, this audit acquired it and used a private temporary Decky 3.3.0 ARM64 user service. Read-only ProtonDB `get_setting` and Steam Status `get_settings` calls succeeded through the live Steam CEF websocket. The service and private base were removed and the lock released; normal managed services stayed inactive, battery was 100 → 99, and no power setting was changed. [Redacted results](evidence/framey-official-backend-2026-10-25.json) record exactly what ran. A [2026-10-26 follow-up](evidence/framey-events-backend-2026-10-26.json) verified default Notebook drawing/save/reopen across a real backend restart and Simple Timer start/cancel, countdown/completion events, a visible toast and persisted recents/subtle mode. Only private test settings were written. Simple Timer remains partial because its own expired-timer startup raises a missing `timer_task` error; sound/suspend are unsupported. A [local audio follow-up](evidence/framey-audio-backends-2026-10-26.md) exercised Volume Mixer, Volume Boost and Mixer through real Decky 3.3.0 amd64 backends on private silent virtual audio targets. Sliders, numeric volume entry, independent server readbacks and Mixer filter persistence across a runtime restart passed. An [ARM64 audio follow-up](evidence/framey-audio-arm64-2026-10-26.md) verified the unmodified official backends in actual Decky 3.3.0 on the Frame user audio session. Volume Mixer and Mixer now qualify as works for per-app volume: Chromium controls changed only a named silent stream, with independent Pulse readbacks. That run left Volume Boost partial because sink writes were denied. A [Volume Boost follow-up](evidence/framey-volume-boost-arm64-2026-10-26.md) now verifies linked/separate channel controls, re-link and reopen through the actual ARM64 backend. Independent Pulse reads confirmed 125%/150% gain writes while the default sink stayed muted; exact original volume/mute was restored. Volume Boost qualifies as works for sink controls. Audible output, Bluetooth playback and worn VR remain unverified. A [running-context follow-up](evidence/framey-running-context-2026-10-26.md) supplies detached running-app/main-app reads and relays actual Steam lifetime callbacks while a panel is open. Real Frame checks verified an empty list, registration/cleanup and the exact Discord Status ARM64 backend reporting no IPC connection. Nonempty games and transitions were synthetic fixtures; real game events, Discord activity and worn VR remain unverified. Discord Status moves to partial; no new works claim is made. A [library context follow-up](evidence/framey-library-context-2026-10-26.md) read 1,106 app overviews, 895 game IDs and the current public Steam ID from real Frame CEF under the shared lock. Local Chromium replayed this detached snapshot to render Deck Settings game selection, Steamback's empty save panel and PlayTime statistics/settings. Steamback and PlayTime used actual Decky 3.3.0 amd64 backends in an isolated container; their ARM64 backends and automatic game hooks remain unverified. Shotty's frontend now starts, but its published backend fails on missing `click`; it stays broken. A [chunked frontend follow-up](evidence/framey-deck-shelves-browser-2026-10-26.md) loaded Deck Shelves 2.0.0 through a managed JavaScript module route and rendered its settings in an opaque local Chromium panel. Its backend was denied; Steam Home shelves and worn VR remain unverified. A [local module lookup follow-up](evidence/framey-module-lookup-2026-10-26.md) supplies a finite registry of Framey-local controls and CSS. TabMaster QAM/docs now render; Steam library-tab editing remains unavailable. That pass exposed Junk-Store executable-script extraction failures; the follow-up below repairs them. SteamGridDB still requires Steam context-menu internals and DeckSP still fails its published MobX fallback. That pass tested TabMaster/Junk-Store in actual isolated amd64 Decky, without ARM64 or worn-VR coverage. A [script entrypoint follow-up](evidence/framey-script-entrypoints-2026-10-26.md) grants owner execute to shebang scripts and ZIP-declared executables without copying archive privilege/write bits. Junk-Store now passes static menu/backend calls in actual Decky 3.3.0 ARM64 and local Chromium Games/Epic navigation, back and reopen. It moves to partial: About still crashes on missing installed-app metadata, Legendary is absent, and login/game operations remain unverified. Existing installations require update/reinstall to repair permissions. A [read-only installed-metadata follow-up](evidence/framey-installed-context-2026-10-26.md) now repairs the About crash. The library snapshot copies only Steam-supplied installed booleans into detached metadata, preserving unknown values as undefined. Junk-Store About/Dependencies, Back and reopen render in local Chromium with actual Frame library data and the official ARM64 backend. It remains partial: dependency/login/game operations, RSS, the optional Line truncated
 
 ## Every current plugin
 
@@ -41,7 +41,7 @@ The API column shows manifest / actual bundled frontend API. Many manifests say
 | 7: CSS Loader 2.1.3 | legacy / legacy | partial | Panel initialization succeeds; CSS themes patch Steam UI and cannot theme the isolated VR shell. | static archive, local browser, fake-Frame |
 | 10: vibrantDeck 2.0.1 | legacy / legacy | N/A | Not supported on Frame: Changes X11 gamescope color properties, not the Frame SteamVR compositor. | static archive, local browser, fake-Frame |
 | 11: Fantastic 0.5.1 | legacy / legacy | N/A | Not supported on Frame: Targets Steam Deck fan hardware; no Frame fan-control mapping is provided. | static archive, local browser, fake-Frame |
-| 12: MusicControl 1.1.6 | legacy / legacy | partial | Legacy media controls initialize; player discovery and playback are unverified. | static archive, local browser, fake-Frame |
+| 12: MusicControl 1.1.6 | legacy / legacy | partial | Managed reinstall preserves Decky’s legacy calling convention and repairs the Frame OS shell library-path failure. Chromium transport/seek/volume against a silent MPRIS fixture and real ARM64 empty-player discovery pass; actual Frame media playback, album art and worn VR remain unverified. Reinstall existing copies to apply. | static archive, local browser, fake-Frame, isolated Decky 3.3.0 + MPRIS fixture, real Frame SSH |
 | 13: Pause Games 1.0.3 | 1 / 2 | partial | Settings and running-game list initialize in local Chromium with an explicit synthetic game; live Frame empty-list reads and lifetime registration/cleanup passed. Process pause/resume, automatic pausing and suspend integration remain unverified/unsupported; backend writes were denied. | static archive, local browser, fake-Frame |
 | 14: ProtonDB Badges 1.3.4 | 2 / 2 | partial | Settings render locally and read-only get_setting RPC returned the default through real Decky 3.3.0 on ARM64 Frame. Steam game-page badges have no patch target; live writes and VR controls unverified. | static archive, local browser, fake-Frame, real Frame SSH |
 | 16: Audio Loader 1.6.1 | legacy / legacy | broken | This plugin needs root and is not supported by the Frame user service. Steam UI sound lookup is present as explicitly unsupported; the frontend still requires Steam m_GamepadUIAudioStore.m_AudioPlaybackManager, which is unavailable in the isolated panel. | static archive, local browser, fake-Frame |
@@ -65,7 +65,7 @@ The API column shows manifest / actual bundled frontend API. Many manifests say
 | 44: DeckMTP 1.0.5 | legacy / legacy | broken | Plugin contains a non-ARM64 Linux binary: DeckMTP/bin/umtprd. | static archive, local browser, fake-Frame |
 | 46: Steamback 1.0.0-1 | legacy / legacy | partial | Panel opens using the real Frame current-user/library snapshot. Account setup and empty save-list reads pass through actual Decky 3.3.0 amd64 in isolation. ARM64 backend, supported-save discovery, automatic backups and restore remain unverified; no backup/restore ran. | static archive, local browser, fake-Frame, real Frame SSH |
 | 48: Quick Launch 1.2.1 | legacy / legacy | broken | This plugin needs root and is not supported by the Frame user service. | static archive, local browser, fake-Frame |
-| 49: Decky Cloud Save 1.4.2 | legacy / legacy | broken | Unsafe plugin archive member. | static archive, local browser, fake-Frame |
+| 49: Decky Cloud Save 1.4.2 | legacy / legacy | broken | The exact official ZIP contains a 60,776,600-byte x86_64 rclone member, above the 30 MiB member limit and unusable on ARM64. Installation remains blocked. | static archive, local browser, fake-Frame |
 | 50: Storage Cleaner 1.4.0 | 1 / 2 | partial | Empty-data panel rendered; cleanup was deliberately not run because it can remove local data. | static archive, local browser, fake-Frame |
 | 52: Game Theme Music 1.7.1-1 | 1 / 2 | partial | An inert local component lets the exact frontend initialize and render its Settings view in opaque Chromium. Backend get_setting and plugin network were denied in the audit; Steam game-page theme injection has no verified target in Framey. Music search, playback, downloads, settings persistence and worn VR remain unverified. | static archive, local browser, fake-Frame |
 | 53: Shotty 0.1.0 | legacy / legacy | partial | The frontend starts with the read-only Frame library snapshot. Frame Control adds a digest-scoped click.get_app_dir compatibility module to the managed install; the exact backend then imports and copies a synthetic Steam screenshot into a temporary Pictures folder in isolated Python. Actual Decky 3.3.0 ARM64 loading, live screenshots/rescue, in-VR panel and physical controller use remain unverified. | static archive, local browser, fake-Frame, real Frame SSH, isolated Python backend |
@@ -119,7 +119,7 @@ The API column shows manifest / actual bundled frontend API. Many manifests say
 | 108: HueSync 3.8.0 | 1 / 2 | N/A | Not supported on Frame: Targets handheld RGB/LED controllers (AYANEO/Ally/MSI), not Frame hardware. | static archive, local browser, fake-Frame |
 | 109: MuraDeck 2.1.4 | 1 / 2 | N/A | Not supported on Frame: Calibration is specifically for defective Samsung Steam Deck OLED panels, not Frame displays. | static archive, local browser, fake-Frame |
 | 110: Dimmer Deck 0.0.4 | 1 / 2 | N/A | Not supported on Frame: Changes gamescope/X11 dimming properties; no mapping to Frame VR display brightness exists. | static archive, local browser, fake-Frame |
-| 111: Music Control 1.1.7 | legacy / legacy | partial | Exact official backend bound-method calls are repaired in managed installs. An isolated fake dbus-send target accepted player discovery, transport and volume commands after the patch; real MPRIS players, actual Decky ARM64, album art and worn VR remain unverified. | static archive, local browser, fake-Frame, isolated Python backend |
+| 111: Music Control 1.1.7 | legacy / legacy | partial | Managed reinstall preserves Decky’s legacy calling convention and repairs the Frame OS shell library-path failure. Chromium transport/seek/volume against a silent MPRIS fixture and real ARM64 empty-player discovery pass; actual Frame media playback, album art and worn VR remain unverified. Reinstall existing copies to apply. | static archive, local browser, fake-Frame, isolated Python backend, isolated Decky 3.3.0 + MPRIS fixture, real Frame SSH |
 | 112: Better Keyboard 0.3.4 | 1 / 2 | broken | This plugin needs root and is not supported by the Frame user service. Frontend audit failed: window.SteamClient.UI.GetUIMode is not a function. | static archive, local browser, fake-Frame |
 | 113: Decky LSFG-VK 0.12.2 | 1 / 2 | partial | Initializer succeeds; runtime LSFG/Windows DLL downloads and Vulkan integration are not ARM64-validated. | static archive, local browser, fake-Frame |
 | 114: Network Sentinel 1.0.4 | 1 / 2 | broken | This plugin needs root and is not supported by the Frame user service. | static archive, local browser, fake-Frame |
@@ -164,7 +164,7 @@ DFL includes exports imported through decky-frontend-lib / @decky/ui. Steam stor
 | CSS Loader | none detected | ButtonItem, ColorPickerModal, ConfirmModal, DialogButton, DialogCheckbox, Dropdown, DropdownItem, Focusable, ModalRoot, Navigation, PanelSection, PanelSectionRow, ScrollPanelGroup, SidebarNavigation, SliderField, Tabs, TextField, Toggle, ToggleField, classMap, definePlugin, findModuleChild, gamepadDialogClasses, gamepadSliderClasses, getGamepadNavigationTrees, replacePatch, showModal, staticClasses | routerHook, toaster, window.SP_REACT, local/Steam routes, toasts, QAM/global tabs, Steam page patches/module lookup | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
 | vibrantDeck | none detected | PanelSection, PanelSectionRow, Router, SliderField, ToggleField, definePlugin, staticClasses | Router, window.SP_REACT | Python | Changes X11 gamescope color properties, not the Frame SteamVR compositor. |
 | Fantastic | none detected | Field, Navigation, PanelSection, PanelSectionRow, ToggleField, definePlugin, staticClasses | window.SP_REACT, QAM/global tabs | Python + native payload; x86_64 | Targets Steam Deck fan hardware; no Frame fan-control mapping is provided. |
-| MusicControl | none detected | ButtonItem, DialogButton, Focusable, Menu, MenuItem, PanelSection, PanelSectionRow, Router, SidebarNavigation, SliderField, SteamSpinner, definePlugin, showContextMenu, staticClasses | Router, routerHook, window.SP_REACT, local/Steam routes | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
+| MusicControl | none detected | ButtonItem, DialogButton, Focusable, Menu, MenuItem, PanelSection, PanelSectionRow, Router, SidebarNavigation, SliderField, SteamSpinner, definePlugin, showContextMenu, staticClasses | Router, routerHook, window.SP_REACT, local/Steam routes | Python | User-session MPRIS player and dbus-send required; no Deck-specific hardware. |
 | Pause Games | Apps, Apps.RegisterForGameActionTaskChange, GameSessions.RegisterForAppLifetimeNotifications, System.RegisterForOnResumeFromSuspend, System.RegisterForOnSuspendRequest, System.UI.RegisterForFocusChangeEvents, System.UI.RegisterForSystemKeyEvents | Button, Field, Focusable, Marquee, PanelSection, PanelSectionRow, Router, Toggle, ToggleField, beforePatch, sleep | Router, window.SP_REACT, Steam page patches/module lookup, Steam stores | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
 | ProtonDB Badges | none detected | ButtonItem, ConfirmModal, DialogButton, DropdownItem, Field, Focusable, Navigation, PanelSection, PanelSectionRow, ScrollPanel, ScrollPanelGroup, ToggleField, afterPatch, appDetailsClasses, appDetailsHeaderClasses, createReactTreePatcher, definePlugin, findInReactTree, findModuleExport, showModal, staticClasses, useParams | SteamUIStore, appStore, routerHook, toaster, local/Steam routes, toasts, QAM/global tabs, Steam page patches/module lookup, Steam stores | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
 | Audio Loader | GameSessions.RegisterForAppLifetimeNotifications, d.ts | ButtonItem, DialogButton, Dropdown, DropdownItem, Focusable, Navigation, PanelSection, PanelSectionRow, Router, SliderField, Tabs, TextField, ToggleField, afterPatch, beforePatch, definePlugin, findModuleChild, gamepadDialogClasses, staticClasses | Router, routerHook, toaster, window.SP_REACT, local/Steam routes, toasts, QAM/global tabs, Steam page patches/module lookup, Steam stores | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
@@ -242,7 +242,7 @@ DFL includes exports imported through decky-frontend-lib / @decky/ui. Steam stor
 | HueSync | Settings.GetCurrentLanguage, System.GetSystemInfo, System.RegisterForBatteryStateChanges, System.RegisterForOnResumeFromSuspend, System.RegisterForOnSuspendRequest, User.RegisterForPrepareForSystemSuspendProgress, User.RegisterForResumeSuspendedGamesProgress | DialogButton, DropdownItem, Field, Focusable, Marquee, ModalRoot, PanelSection, PanelSectionRow, Router, SliderField, TextField, ToggleField, definePlugin, findModuleChild, gamepadSliderClasses, showModal, staticClasses | Router, toaster, window.SP_REACT, toasts, Steam page patches/module lookup, Steam stores | Python + native payload; x86_64 | Targets handheld RGB/LED controllers (AYANEO/Ally/MSI), not Frame hardware. |
 | MuraDeck | System.Display.RegisterForBrightnessChanges | ButtonItem, ConfirmModal, Field, Focusable, Navigation, PanelSection, PanelSectionRow, SideMenu, SidebarNavigation, SliderField, ToggleField, quickAccessControlsClasses, showModal | SteamUIStore, routerHook, window.SP_REACT, local/Steam routes, Steam stores | Python | Calibration is specifically for defective Samsung Steam Deck OLED panels, not Frame displays. |
 | Dimmer Deck | Settings.GetCurrentLanguage, System.Display.RegisterForBrightnessChanges, System.Display.SetBrightness | PanelSection, PanelSectionRow, SliderField, ToggleField, staticClasses | toaster, window.SP_REACT, toasts, Steam stores | Python | Changes gamescope/X11 dimming properties; no mapping to Frame VR display brightness exists. |
-| Music Control | none detected | ButtonItem, DialogButton, Focusable, PanelSection, PanelSectionRow, Router, SidebarNavigation, SliderField, SteamSpinner, definePlugin, staticClasses | Router, routerHook, window.SP_REACT, local/Steam routes | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
+| Music Control | none detected | ButtonItem, DialogButton, Focusable, PanelSection, PanelSectionRow, Router, SidebarNavigation, SliderField, SteamSpinner, definePlugin, staticClasses | Router, routerHook, window.SP_REACT, local/Steam routes | Python | User-session MPRIS player and dbus-send required; no Deck-specific hardware. |
 | Better Keyboard | Settings.GetCurrentLanguage, UI.GetUIMode, UI.RegisterForUIModeChanged | ButtonItem, EUIMode, PanelSection, PanelSectionRow, ToggleField, staticClasses | SteamUIStore, window.SP_REACT, Steam stores | Python | /dev/input |
 | Decky LSFG-VK | none detected | ButtonItem, ConfirmModal, DialogBody, DialogButton, DialogControlsSection, DialogControlsSectionHeader, DialogHeader, Dropdown, Field, Focusable, ModalRoot, PanelSection, PanelSectionRow, Router, SliderField, Spinner, TextField, Toggle, ToggleField, showModal, staticClasses | Router, toaster, window.SP_REACT, toasts | Python | flatpak; x86_64 |
 | Network Sentinel | none detected | ButtonItem, Navigation, PanelSection, PanelSectionRow, SliderField, ToggleField, staticClasses | toaster, window.SP_REACT, toasts | Python | No specific hardware requirement detected statically; runtime requirements unverified. |
@@ -288,11 +288,11 @@ All published Linux native payloads in this snapshot are x86_64; no published aa
 | Fantastic | bin/backend | Fan backend/driver is Deck-specific; an ARM64 rebuild would not provide compatible Frame hardware. |
 | PowerTools | bin/libryzenadj.so, bin/ryzenadj, bin/backend | RyzenAdj and AMD power backend cannot control an ARM64 Frame SoC. |
 | Memory Deck | bin/libscanmem.so.1.0.0 | libscanmem must be rebuilt for aarch64 and validated against target process architecture; memory writes were not tested. |
-| Emuchievements | bin/hash | A source-matched ARM64 bin/hash helper matched the official x86_64 helper on one synthetic ROM on the real Frame (docs/evidence/framey-emuchievements-arm-2026-10-26.md). The official ZIP still bundles x86_64 bytes and remains blocked; format coverage, packaging, plugin backend/UI, login and worn VR are unverified. |
+| Emuchievements | bin/hash | A source-matched ARM64 helper matched one synthetic ROM on the real Frame (docs/evidence/framey-emuchievements-arm-2026-10-26.md). The pinned upstream source proposed for packaging also has unsafe archive extraction and cleanup paths (docs/evidence/framey-native-port-blockers-2026-10-26.md); fix and test those before shipping an ARM64 binary. The official x86_64 ZIP remains blocked; format coverage, plugin backend/UI, login and worn VR are unverified. |
 | MoonDeck | python/externals/yarl/_quoting_c.cpython-313-x86_64-linux-gnu.so, python/externals/aiohttp/_http_parser.cpython-313-x86_64-linux-gnu.so, python/externals/aiohttp/_websocket/reader_c.cpython-313-x86_64-linux-gnu.so, python/externals/aiohttp/_websocket/mask.cpython-313-x86_64-linux-gnu.so, python/externals/aiohttp/_http_writer.cpython-313-x86_64-linux-gnu.so, … 26 total; full list in JSON | Rebuild vendored CPython 3.13 extension wheels for the headset Python ABI and ARM64; buddy/helper dependencies also need ports. |
 | Controller Tools | bin/backend | Native backend needs an ARM64 build and controller/HID dependencies; its direct websocket also bypasses the Framey bridge. |
 | DeckMTP | bin/umtprd | umtprd needs ARM64 libusb/MTP dependencies and USB gadget permissions; root user-service blocker remains. |
-| Decky Cloud Save | bin/rclone | rclone needs an ARM64 artifact; this ZIP also fails safe member validation. Cloud writes were not exercised. |
+| Decky Cloud Save | bin/rclone | An ARM64 rclone artifact and safe package policy are needed; the official 60,776,600-byte x86_64 member fails archive validation. No cloud writes were run (docs/evidence/framey-native-port-blockers-2026-10-26.md). |
 | DeckyFileServer | bin/backend | Native file-server backend needs ARM64 dependencies; root requirement also blocks the user service. |
 | TS3 QuickAccess | bin/ts3-qs4sd.so | TeamSpeak client plugin must match an ARM64 TeamSpeak client and SDK ABI, not merely rebuild the .so. |
 | Syncthing | bin/decky-syncthing-watchdog | The watchdog needs an ARM64 build, plus a supported Syncthing runtime/package and safe path validation. |

docs/testing.md

@@ -549,3 +549,41 @@ Fixtures cover duplicate instance identity, unknown states, GUID matching,
 localised/denied channel data and 6 GHz ambiguity. No tests contact a real Frame.
 A Windows CI runner/VM cannot prove physical Steam dongle behaviour or audio RF
 interference. See [sources and limits](windows-wireless-doctor.md).
+
+### Actual Decky backend shim gate
+
+Fake-Frame tests stub plugin execution, so they cannot prove Decky's Python
+calling convention. `Decky backend runtime` CI separately runs the published,
+SHA-256-pinned **Decky 3.3.0** executable on native amd64 and ARM64 Linux.
+The loader discovers production-managed official archives and calls their public
+methods over its actual websocket API. No test imports or instantiates `Plugin`.
+
+```sh
+python3 scripts/framey-test-decky-runtime.py --output /tmp/decky-runtime.json
+# Offline loader cache (still checked against its pinned native digest):
+python3 scripts/framey-test-decky-runtime.py --loader /path/to/PluginLoader --output /tmp/decky-runtime.json
+```
+
+Run on Linux with Docker. Image build and the pinned loader download need network;
+plugin execution has no network, published ports, host home/audio/D-Bus/device
+mounts, capabilities or writable repository. Each case has its own unprivileged
+container, private tmpfs home and temporary files. Nothing contacts the headset
+or its shared lock. Failed/timed-out containers and the private image tag are
+removed by the runner.
+
+Every `compat_shims.append` in the managed installer must have a case in
+`tests/decky-runtime/cases.json`. Add each affected pinned official archive and
+a safe public-method probe when introducing a shim. Ordinary unit tests reject
+uncovered shim names. The runtime job verifies the managed receipt, loader
+plugin discovery, and a successful backend call; a discovery listing alone
+could conceal a crashed backend process.
+
+Current cases cover both Music Control entries and Shotty. Music Control uses
+the private silent MPRIS fixture to check discovery, metadata, play/pause,
+next/previous, seek and volume, with independent service-state readbacks.
+Shotty checks backend import, rescuer state and empty screenshot aggregation
+inside its disposable home. A fourth negative-control case deliberately
+reintroduces #335's incorrect bound-method transformation and must reproduce
+the real loader's legacy backend-call failure. The gate fails if that regression goes
+undetected. These checks verify backend behavior in a container; they do not
+upgrade any plugin's Frame, actual media playback or worn-VR compatibility claim.

scripts/framey-compatibility-doc.py

@@ -81,9 +81,11 @@ def render(data):
         '[Steam Status/cache](evidence/framey-cache-browser-2026-10-25.md), '
         '[Storage Cleaner](evidence/framey-api-v1-browser-2026-10-25.md), and '
         '[legacy MusicControl](evidence/framey-legacy-2026-10-25.md). '
-        'A [Music Control 1.1.7 backend follow-up](evidence/framey-music-control-bound-methods-2026-10-26.md) '
-        'repairs exact-archive bound-method calls and verifies transport/volume command dispatch against an isolated dbus-send fixture. '
-        'A real MPRIS player and actual ARM64 Decky backend remain unverified.', '',
+        'A [shared Music Control runtime follow-up](evidence/framey-mpris-runtime-2026-10-26.md) corrects the earlier bound-method fixture error: actual Decky uses the legacy class calling convention, so explicit-self calls must stay. '
+        'Exact managed installs also restore the system library path for D-Bus subprocesses, repairing a real Frame OS libtinfo/glibc failure in MusicControl 1.1.6. '
+        'Both official entries pass transport/seek/volume, Info and reopen in local Chromium with actual Decky 3.3.0 amd64 and a private silent MPRIS service. '
+        'Actual ARM64 Decky on the Frame passes read-only empty-player discovery for both. Existing copies need remove/reinstall or an explicit managed update. '
+        'Actual media playback on ARM64, artwork and worn VR remain unverified; both stay partial.', '',
         '## Every current plugin', '',
         'The API column shows manifest / actual bundled frontend API. Many manifests say v1 while their bundle connects API2. '
         'Missing manifest API is labelled legacy; an unrecognized bundle is unknown. Globals and hardware are static signals, not exhaustive dependencies.', '',

scripts/framey-test-decky-runtime.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""Run every managed backend shim in native, isolated, published Decky 3.3.0.
+
+Downloads a digest-pinned loader, or accepts --loader for an offline cached copy.
+Only image build/download use network. All official plugin execution is in
+network/device/session-isolated disposable Docker containers. Never uses Frame.
+"""
+import argparse
+import ast
+import hashlib
+import json
+from pathlib import Path
+import platform
+import shutil
+import subprocess
+import sys
+import tempfile
+import urllib.request
+import uuid
+
+ROOT = Path(__file__).resolve().parents[1]
+RELEASE = 'v3.3.0'
+LOADERS = {
+    'x86_64': ('PluginLoader', 'e80d03e641d1766a33a817cb27ab8d2e0a4633685e5d27e4de948a6687526181', 62),
+    'aarch64': ('PluginLoader-arm64', '8ef5dcf36cbbbb6e97201a6baed5d79c4cc44ec27789fc9af1c5b6ae8f0b25b6', 183),
+}
+
+
+def check_coverage():
+    """A new production shim must declare an actual-runtime probe before CI runs."""
+    sys.path.insert(0, str(ROOT/'ui'))
+    import frame_decky_store
+    tree = ast.parse(frame_decky_store.APPLY)
+    shims = set()
+    for node in ast.walk(tree):
+        if (isinstance(node, ast.Call) and isinstance(node.func, ast.Attribute)
+                and isinstance(node.func.value, ast.Name)
+                and node.func.value.id == 'compat_shims' and node.func.attr == 'append'):
+            if len(node.args) != 1 or not isinstance(node.args[0], ast.Constant) or not isinstance(node.args[0].value, str):
+                raise ValueError('Managed shims must declare a literal name for runtime test coverage')
+            shims.add(node.args[0].value)
+    cases = json.loads((ROOT/'tests/decky-runtime/cases.json').read_text())
+    if shims != {case['shim'] for case in cases}:
+        raise ValueError('Every managed shim needs an actual Decky runtime case')
+    return cases
+
+
+def loader_bytes(path):
+    arch = platform.machine()
+    if arch not in LOADERS:
+        raise ValueError('Run on native Linux x86_64 or aarch64')
+    asset, digest, machine = LOADERS[arch]
+    if path:
+        data = path.read_bytes()
+    else:
+        url = f'https://github.com/SteamDeckHomebrew/decky-loader/releases/download/{RELEASE}/{asset}'
+        request = urllib.request.Request(url, headers={'User-Agent': 'Frame-Control-runtime-tests'})
+        with urllib.request.urlopen(request, timeout=60) as response:
+            data = response.read(80*1024*1024+1)
+    if hashlib.sha256(data).hexdigest() != digest:
+        raise ValueError('Decky 3.3.0 loader digest mismatch')
+    if data[:4] != b'\x7fELF' or int.from_bytes(data[18:20], 'little') != machine:
+        raise ValueError('Loader architecture does not match the native runner')
+    return data, digest
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--loader', type=Path, help='Optional cached, digest-verified native Decky 3.3.0 binary')
+    parser.add_argument('--output', type=Path, required=True)
+    args = parser.parse_args()
+    if sys.platform != 'linux' or not shutil.which('docker'):
+        parser.error('Linux with Docker is required')
+    cases = check_coverage()
+    data, digest = loader_bytes(args.loader)
+    tag = 'framey-decky-runtime:'+uuid.uuid4().hex[:12]
+    report = {'decky': RELEASE, 'architecture': platform.machine(), 'loaderSha256': digest, 'cases': []}
+    try:
+        subprocess.run(['docker', 'build', '-q', '-t', tag, '-f', str(ROOT/'tests/decky-runtime/Containerfile'),
+                        str(ROOT/'tests/decky-runtime')], check=True, timeout=300)
+        with tempfile.TemporaryDirectory(prefix='framey-decky-runtime-') as temp:
+            loader = Path(temp)/'PluginLoader'
+            loader.write_bytes(data)
+            loader.chmod(0o644)  # Private container user copies/chmods its own executable.
+            probes = [(case['id'], False) for case in cases] + [(111, True)]
+            for plugin_id, negative in probes:
+                name = 'framey-decky-'+uuid.uuid4().hex[:12]
+                command = ['docker', 'run', '--rm', '--name', name, '--network', 'none', '--read-only',
+                    '--cap-drop', 'ALL', '--security-opt', 'no-new-privileges', '--pids-limit', '128',
+                    '--tmpfs', '/tmp:rw,exec,mode=1777',
+                    '--tmpfs', '/home/tester:rw,exec,uid=1100,gid=1100,mode=700',
+                    '--tmpfs', '/run/user/1100:rw,uid=1100,gid=1100,mode=700',
+                    '--mount', f'type=bind,source={ROOT},target=/repo,readonly',
+                    '--mount', f'type=bind,source={loader},target=/input/PluginLoader,readonly',
+                    tag, str(plugin_id)]
+                if negative:
+                    command.append('--reproduce-bound-method-regression')
+                try:
+                    result = subprocess.run(command, capture_output=True, text=True, timeout=120)
+                    if result.returncode:
+                        raise RuntimeError(f'Decky runtime case {plugin_id} failed:\n{result.stdout}\n{result.stderr}')
+                    observation = json.loads(result.stdout)
+                    report['cases'].append(observation)
+                    print(f"PASS {plugin_id}: {observation['result']}", flush=True)
+                finally:
+                    subprocess.run(['docker', 'rm', '-f', name], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    finally:
+        args.output.parent.mkdir(parents=True, exist_ok=True)
+        args.output.write_text(json.dumps(report, indent=2)+'\n')
+        subprocess.run(['docker', 'image', 'rm', tag], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+
+
+if __name__ == '__main__':
+    main()

tests/decky-runtime/Containerfile

@@ -0,0 +1,12 @@
+# Native amd64 or ARM64; no emulation, host session bus, audio, devices or home.
+FROM debian:trixie-slim
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      python3 python3-dbus python3-gi python3-websockets dbus-bin dbus-daemon \
+      ca-certificates zlib1g \
+    && rm -rf /var/lib/apt/lists/* \
+    && useradd -m -u 1100 -s /bin/sh tester \
+    && mkdir -p /run/user/1100 && chown tester:tester /run/user/1100
+ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 XDG_RUNTIME_DIR=/run/user/1100
+USER tester
+WORKDIR /repo
+ENTRYPOINT ["python3", "/repo/tests/decky-runtime/check.py"]

tests/decky-runtime/cases.json

@@ -0,0 +1,5 @@
+[
+  {"id": 12, "shim": "music-control-system-dbus-env", "probe": "mpris"},
+  {"id": 111, "shim": "music-control-system-dbus-env", "probe": "mpris"},
+  {"id": 53, "shim": "shotty-click-app-dir", "probe": "screenshots"}
+]

tests/decky-runtime/check.py

@@ -0,0 +1,199 @@
+"""Container-only real Decky backend discovery and smoke tests; no host services."""
+import argparse
+import asyncio
+import hashlib
+import json
+import os
+from pathlib import Path
+import shutil
+import signal
+import subprocess
+import sys
+import time
+import urllib.request
+
+import websockets
+from websockets.exceptions import WebSocketException
+
+ROOT = Path('/repo')
+sys.path[:0] = [str(ROOT/'ui'), str(ROOT/'tests')]
+import frame_decky_store
+from framey_official import PLUGINS, archive
+
+
+async def request(route, args):
+    token = urllib.request.urlopen('http://127.0.0.1:1337/auth/token', timeout=2).read().decode()
+    async with websockets.connect('ws://127.0.0.1:1337/ws?auth='+token,
+                                  open_timeout=3, close_timeout=2) as ws:
+        await ws.send(json.dumps({'type': 0, 'id': 1, 'route': route, 'args': args}))
+        while True:
+            response = json.loads(await asyncio.wait_for(ws.recv(), timeout=8))
+            if response.get('id') != 1:
+                continue
+            await ws.send(json.dumps({'type': 3, 'id': 1}))
+            assert response['type'] == 1, response
+            return response['result']
+
+
+def rpc(route, *args):
+    return asyncio.run(request(route, list(args)))
+
+
+def until_ready(read, description):
+    deadline = time.monotonic()+20
+    last = None
+    while time.monotonic() < deadline:
+        try:
+            value = read()
+            if value:
+                return value
+        except (OSError, ValueError, KeyError, TimeoutError, WebSocketException) as error:
+            last = str(error)
+        time.sleep(.1)
+    raise RuntimeError(f'{description} not ready: {last}')
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('id', type=int)
+    parser.add_argument('--reproduce-bound-method-regression', action='store_true')
+    args = parser.parse_args()
+    assert os.getuid() == 1100 and ROOT.is_dir(), 'Run through framey-test-decky-runtime.py'
+    record = next(p for p in PLUGINS if p['id'] == args.id)
+    case = next(p for p in json.loads((ROOT/'tests/decky-runtime/cases.json').read_text()) if p['id'] == args.id)
+    data = archive(record)
+    assert hashlib.sha256(data).hexdigest() == record['sha256']
+    assert frame_decky_store.archive_info(data, record['sha256'], record['name']) == record['folder']
+    home = Path.home()
+    base = home/'.local/share/frame-control/decky'
+    (base/'plugins').mkdir(parents=True)
+    unit = home/'.config/systemd/user/frame-control-decky.service'
+    unit.parent.mkdir(parents=True)
+    unit.write_text('# Private fixture marker; no real service manager is contacted.\n')
+    tools = home/'bin'
+    tools.mkdir()
+    systemctl = tools/'systemctl'
+    systemctl.write_text('#!/bin/sh\ncase "$*" in *is-active*) exit 3;; *) exit 0;; esac\n')
+    systemctl.chmod(0o700)
+    env = dict(os.environ, PATH=str(tools)+':'+os.environ['PATH'])
+    Path('/tmp/frame-control-decky-plugin-runtime-test').write_bytes(data)
+    install = subprocess.run([sys.executable, '-', 'install', 'runtime-test', str(record['id']),
+        record['sha256'], record['folder'], record['version'], '-'], input=frame_decky_store.APPLY,
+        capture_output=True, text=True, env=env, timeout=15)
+    assert install.returncode == 0, install.stderr
+    plugin = base/'plugins'/record['folder']
+    receipt = json.loads((plugin/'.frame-control-store.json').read_text())
+    assert receipt['compatShims'] == [case['shim']], receipt
+    # Exercise the production manifest's API convention, never import Plugin ourselves.
+    manifest = json.loads((plugin/'plugin.json').read_text())
+    assert 'api_version' not in manifest, manifest
+    if args.reproduce_bound_method_regression:
+        assert record['id'] == 111
+        source = (plugin/'main.py').read_text()
+        for old, new in [('self._get_dbus_env(self)', 'self._get_dbus_env()'),
+                         ('self._sp_player_dbus(self,', 'self._sp_player_dbus(')]:
+            assert old in source
+            source = source.replace(old, new)
+        (plugin/'main.py').write_text(source)
+
+    (home/'.local/share/Steam/steamui/images').mkdir(parents=True)
+    loader = base/'PluginLoader'
+    shutil.copy('/input/PluginLoader', loader)
+    loader.chmod(0o700)
+    env.update(UNPRIVILEGED_PATH=str(base), PRIVILEGED_PATH=str(base), CHOWN_PLUGIN_PATH='0',
+               LIVE_RELOAD='0', USE_CEF_CLOSE_WORKAROUND='0', KEEP_SYSTEMD_SERVICE='1',
+               DBUS_SESSION_BUS_ADDRESS='unix:path=/run/user/1100/bus')
+    processes = []
+    report = {'id': record['id'], 'name': record['name'], 'version': record['version'],
+              'sha256': record['sha256'], 'shim': case['shim'], 'calls': []}
+    with (home/'runtime.log').open('w+') as log:
+        try:
+            if case['probe'] == 'mpris':
+                bus = subprocess.Popen(['dbus-daemon', '--session', '--nofork',
+                    '--address='+env['DBUS_SESSION_BUS_ADDRESS']], env=env, stdout=log, stderr=log,
+                    start_new_session=True)
+                processes.append(bus)
+                until_ready(lambda: Path('/run/user/1100/bus').is_socket(), 'private session bus')
+                player = subprocess.Popen([sys.executable, str(ROOT/'tests/fixtures/framey-mpris/player.py')],
+                    env=env, stdout=log, stderr=log, start_new_session=True)
+                processes.append(player)
+                until_ready(lambda: Path('/tmp/mpris-state.json').is_file(), 'silent MPRIS player')
+            backend = subprocess.Popen([str(loader)], env=env, stdout=log, stderr=log, start_new_session=True)
+            processes.append(backend)
+            discovered = until_ready(lambda: rpc('loader/get_plugins'), 'published Decky plugin discovery')
+            assert len(discovered) == 1 and discovered[0]['name'] == record['name'], discovered
+            assert discovered[0]['version'] == record['version'] and not discovered[0]['disabled'], discovered
+            report['discovered'] = discovered
+
+            def legacy(method, **kwargs):
+                response = rpc('loader/call_legacy_plugin_method', record['name'], method, kwargs)
+                assert response['success'] is True, (method, response)
+                report['calls'].append({'method': method, 'result': response['result']})
+                return response['result']
+
+            if args.reproduce_bound_method_regression:
+                response = rpc('loader/call_legacy_plugin_method', record['name'], 'sp_list_media_players', {})
+                assert response['success'] is False and 'self' in response['result'], response
+                report['expectedRegression'] = response
+                report['result'] = 'historical bad shim rejected by actual Decky legacy dispatch'
+            elif case['probe'] == 'mpris':
+                player_name = 'org.mpris.MediaPlayer2.FrameySilent'
+                assert legacy('sp_list_media_players') == player_name
+                legacy('sp_set_media_player', player=player_name)
+                assert legacy('sp_get_media_player') == player_name
+                assert legacy('sp_identity', orgPath=player_name) == 'Player'  # Upstream truncation.
+                metadata = legacy('get_meta_data')
+                assert 'title|Silent Test Track' in metadata and 'length|180000000' in metadata, metadata
+                assert legacy('sp_track_status') == 'Paused'
+                assert legacy('sp_track_progress') == '12000000'
+                assert legacy('sp_can_seek') == 'true'
+                assert float(legacy('sp_get_volume')) == .4
+                assert legacy('sp_test_volume_control') == 'true'
+                assert json.loads(Path('/tmp/mpris-state.json').read_text())['Volume'] == .4
+                legacy('sp_play')
+                assert legacy('sp_track_status') == 'Playing'
+                legacy('sp_pause')
+                legacy('sp_next')
+                legacy('sp_previous')
+                legacy('sp_seek', amount=2000000)
+                assert legacy('sp_track_progress') == '14000000'
+                legacy('sp_set_position', position=45000000, trackid='/org/framey/TestTrack/1')
+                legacy('sp_set_volume', volume=.25)
+                state = json.loads(Path('/tmp/mpris-state.json').read_text())
+                assert state['PlaybackStatus'] == 'Paused' and state['Volume'] == .25, state
+                assert state['next'] == state['previous'] == 1 and state['Position'] == 45000000, state
+                report['independentState'] = state
+                report['result'] = 'discovery, metadata, transport, seek and volume passed'
+            else:
+                assert case['probe'] == 'screenshots'
+                assert legacy('was_rescued') is False
+                assert legacy('aggregate_all', allapps=[]) == 0
+                report['result'] = 'discovery, backend import and empty screenshot aggregation passed'
+            log.flush()
+            log.seek(0)
+            assert 'Starting Decky version v3.3.0' in log.read()
+            print(json.dumps(report))
+        except Exception:
+            log.flush()
+            log.seek(0)
+            print(log.read()[-12000:], file=sys.stderr)
+            raise
+        finally:
+            for process in reversed(processes):
+                if process.poll() is None:
+                    try:
+                        os.killpg(process.pid, signal.SIGTERM)
+                    except ProcessLookupError:
+                        continue
+                    try:
+                        process.wait(timeout=4)
+                    except subprocess.TimeoutExpired:
+                        try:
+                            os.killpg(process.pid, signal.SIGKILL)
+                        except ProcessLookupError:
+                            pass
+                        process.wait(timeout=4)
+
+
+if __name__ == '__main__':
+    main()

tests/e2e/test_framey.py

@@ -196,9 +196,9 @@ u=h/'.config/systemd/user/frame-control-decky.service'; u.parent.mkdir(parents=T
                     self.assertEqual(ssh(f'test -f {installed}/py_modules/click.py && echo yes').strip(), 'yes')
                     receipt = json.loads(ssh(f'cat {installed}/.frame-control-store.json'))
                     self.assertEqual(receipt['compatShims'], ['shotty-click-app-dir'])
-                if plugin['id'] == 111:
+                if plugin['id'] in (12, 111):
                     receipt = json.loads(ssh(f'cat {installed}/.frame-control-store.json'))
-                    self.assertEqual(receipt['compatShims'], ['music-control-bound-methods'])
+                    self.assertEqual(receipt['compatShims'], ['music-control-system-dbus-env'])
                 job = finished(ok('POST', '/api/decky/plugin',
                                   {'action':'remove','id':plugin['id'],'acknowledged':True}))
                 self.assertFalse(job.get('error'), job)

tests/fixtures/framey-mpris/README.md

@@ -0,0 +1,21 @@
+# Silent MPRIS runtime fixture
+
+`player.py` implements the synthetic target used by the
+[Music Control runtime evidence](../../../docs/evidence/framey-mpris-runtime-2026-10-26.md).
+It produces no audio. It requires system Python `dbus`, `gi` and GLib, and writes
+its independent control state to `/tmp/mpris-state.json`.
+
+Run it only in a disposable container with **no network, devices, host home,
+audio or D-Bus mounts**. Create a private session bus listening at
+`/run/user/<container UID>/bus`: both official backends hard-code that path.
+Set `DBUS_SESSION_BUS_ADDRESS` to that private socket for the fixture. Use a
+private home including `.local/share/Steam/steamui/images`, because the upstream
+plugins create an album-art symlink on startup. Never run these plugins against
+a real user's player during this test: ID111 probes volume automatically.
+
+Install each pinned archive separately through the managed transaction, then
+start the published Decky 3.3.0 loader with private `UNPRIVILEGED_PATH` and
+`PRIVILEGED_PATH`. Do not instantiate the legacy Plugin class: invoke methods
+through Decky's `loader/call_legacy_plugin_method` route with its keyword object.
+The two official entries share the `MusicControl` folder, so cannot coexist.
+This fixture is opt-in and is not imported by ordinary unit tests.

tests/fixtures/framey-mpris/player.py

@@ -0,0 +1,53 @@
+"""Silent MPRIS target. Run only inside the private network/device-isolated container."""
+import json
+from pathlib import Path
+import dbus, dbus.service, dbus.mainloop.glib
+from gi.repository import GLib
+P='org.mpris.MediaPlayer2.Player'
+R='org.mpris.MediaPlayer2'
+D='org.freedesktop.DBus.Properties'
+TRACK='/org/framey/TestTrack/1'
+class Player(dbus.service.Object):
+ def __init__(self,bus):
+  self.name=dbus.service.BusName('org.mpris.MediaPlayer2.FrameySilent',bus=bus)
+  super().__init__(bus,'/org/mpris/MediaPlayer2')
+  self.state={'PlaybackStatus':'Paused','Position':12000000,'Volume':0.4,'next':0,'previous':0,'writes':[]}
+  self.save()
+ def save(self):Path('/tmp/mpris-state.json').write_text(json.dumps(self.state))
+ @dbus.service.method(D,in_signature='ss',out_signature='v')
+ def Get(self,interface,prop):
+  if interface==R and prop=='Identity':return dbus.String('Framey Silent Player')
+  if interface==P:
+   if prop=='Metadata':return dbus.Dictionary({'mpris:trackid':dbus.ObjectPath(TRACK),'mpris:length':dbus.Int64(180000000),'xesam:title':dbus.String('Silent Test Track'),'xesam:artist':dbus.Array(['Fixture Artist'],signature='s'),'xesam:album':dbus.String('Framey Test Album')},signature='sv')
+   if prop=='PlaybackStatus':return dbus.String(self.state[prop])
+   if prop=='Position':return dbus.Int64(self.state[prop])
+   if prop=='Volume':return dbus.Double(self.state[prop])
+   if prop=='CanSeek':return dbus.Boolean(True)
+  raise dbus.exceptions.DBusException('Unknown property')
+ @dbus.service.method(D,in_signature='ssv',out_signature='')
+ def Set(self,interface,prop,value):
+  assert interface==P and prop=='Volume' and 0<=value<=1
+  self.state['Volume']=float(value);self.state['writes'].append(['Volume',float(value)]);self.save()
+ @dbus.service.method(P,in_signature='',out_signature='')
+ def PlayPause(self):
+  self.state['PlaybackStatus']='Playing' if self.state['PlaybackStatus']=='Paused' else 'Paused';self.state['writes'].append(['PlayPause']);self.save()
+ @dbus.service.method(P,in_signature='',out_signature='')
+ def Pause(self):
+  self.state['PlaybackStatus']='Paused';self.state['writes'].append(['Pause']);self.save()
+ @dbus.service.method(P,in_signature='',out_signature='')
+ def Next(self):
+  self.state['next']+=1;self.state['writes'].append(['Next']);self.save()
+ @dbus.service.method(P,in_signature='',out_signature='')
+ def Previous(self):
+  self.state['previous']+=1;self.state['writes'].append(['Previous']);self.save()
+ @dbus.service.method(P,in_signature='x',out_signature='')
+ def Seek(self,offset):
+  self.state['Position']+=int(offset);self.state['writes'].append(['Seek',int(offset)]);self.save()
+ @dbus.service.method(P,in_signature='ox',out_signature='')
+ def SetPosition(self,track,pos):
+  assert str(track)==TRACK and 0<=pos<=180000000
+  self.state['Position']=int(pos);self.state['writes'].append(['SetPosition',int(pos)]);self.save()
+dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
+player=Player(dbus.SessionBus())
+print('READY silent MPRIS fixture',flush=True)
+GLib.MainLoop().run()

tests/test_frame_decky_store.py

@@ -214,7 +214,7 @@ assert copied.read_bytes() == b'local screenshot fixture'
         self.assertFalse((shotty / 'py_modules/click.py').exists())
         self.assertNotIn('compatShims', json.loads((shotty / '.frame-control-store.json').read_text()))
 
-    def test_exact_music_control_backend_calls_work_after_managed_install(self):
+    def test_legacy_music_control_keeps_decky_class_calling_convention(self):
         from framey_official import PLUGINS, archive as official_archive
         plugin = next(p for p in PLUGINS if p['id'] == 111)
         data = official_archive(plugin)
@@ -225,16 +225,16 @@ assert copied.read_bytes() == b'local screenshot fixture'
         self.assertEqual(result.returncode, 0, result.stderr)
         receipt = json.loads((folder / '.frame-control-store.json').read_text())
         self.assertEqual(receipt['sha256'], plugin['sha256'])
-        self.assertEqual(receipt['compatShims'], ['music-control-bound-methods'])
-        with zipfile.ZipFile(io.BytesIO(data)) as bundle:
-            original = bundle.read('MusicControl/main.py').decode()
-        self.assertNotEqual((folder / 'main.py').read_text(), original)
+        self.assertEqual(receipt['compatShims'], ['music-control-system-dbus-env'])
+        self.assertNotIn('api_version', json.loads((folder / 'plugin.json').read_text()))
+        self.assertIn('self._get_dbus_env(self)', (folder / 'main.py').read_text())
 
         dbus = Path(self.tmp.name) / 'dbus-send'
         dbus.write_text('''#!/usr/bin/env python3
 import os, sys
 from pathlib import Path
 args = ' '.join(sys.argv[1:])
+assert os.environ['LD_LIBRARY_PATH'] == os.environ.get('LD_LIBRARY_PATH_ORIG', '')
 with Path(os.environ['MPRIS_CALLS']).open('a') as log: log.write(args + '\\n')
 if 'ListNames' in args:
     print('method return\\n array [\\n string "org.freedesktop.DBus"\\n string "org.mpris.MediaPlayer2.fixture"\\n ]')
@@ -245,29 +245,32 @@ else:
 ''')
         dbus.chmod(0o700)
         calls = Path(self.tmp.name) / 'mpris-calls'
-        source = '''import asyncio, importlib.util, sys, types
+        source = '''import asyncio, importlib.util, os, sys, types
 from pathlib import Path
 decky = types.ModuleType('decky_plugin')
 sys.modules['decky_plugin'] = decky
 spec = importlib.util.spec_from_file_location('music_control', Path(sys.argv[1])/'main.py')
 module = importlib.util.module_from_spec(spec)
 spec.loader.exec_module(module)
-plugin = module.Plugin()
+# Decky 3.3 uses the class for manifests with no api_version.
+plugin = module.Plugin
 async def check():
-    assert await plugin.sp_list_media_players() == 'org.mpris.MediaPlayer2.fixture'
-    await plugin.sp_set_media_player('org.mpris.MediaPlayer2.fixture')
-    assert await plugin.sp_get_media_player() == 'org.mpris.MediaPlayer2.fixture'
-    await plugin.sp_play()
-    await plugin.sp_pause()
-    await plugin.sp_next()
-    await plugin.sp_previous()
-    await plugin.sp_set_volume(0.25)
-    assert await plugin.sp_track_status() == 'Paused'
+    assert await plugin.sp_list_media_players(plugin) == 'org.mpris.MediaPlayer2.fixture'
+    await plugin.sp_set_media_player(plugin, 'org.mpris.MediaPlayer2.fixture')
+    assert await plugin.sp_get_media_player(plugin) == 'org.mpris.MediaPlayer2.fixture'
+    await plugin.sp_play(plugin)
+    await plugin.sp_pause(plugin)
+    await plugin.sp_next(plugin)
+    await plugin.sp_previous(plugin)
+    await plugin.sp_set_volume(plugin, 0.25)
+    assert await plugin.sp_track_status(plugin) == 'Paused'
 asyncio.run(check())
+assert os.environ['LD_LIBRARY_PATH'] == 'FrameyBundledLibraries'
 '''
         called = subprocess.run([sys.executable, '-c', source, str(folder)],
                                 capture_output=True, text=True,
-                                env={**self.env, 'MPRIS_CALLS': str(calls)}, timeout=10)
+                                env={**self.env, 'MPRIS_CALLS': str(calls), 'LD_LIBRARY_PATH': 'FrameyBundledLibraries',
+                                     'LD_LIBRARY_PATH_ORIG': 'FrameySystemLibraries'}, timeout=10)
         self.assertEqual(called.returncode, 0, called.stderr)
         logged = calls.read_text()
         self.assertIn('org.freedesktop.DBus.ListNames', logged)
@@ -275,6 +278,18 @@ asyncio.run(check())
         self.assertIn('org.mpris.MediaPlayer2.Player.Pause', logged)
         self.assertIn('string:Volume variant:double:0.25', logged)
         self.assertIn('org.mpris.MediaPlayer2.fixture', logged)
+        # An explicit same-version update replaces the previously shipped bad shim.
+        main = folder / 'main.py'
+        main.write_text(main.read_text().replace('self._get_dbus_env(self)', 'self._get_dbus_env()'))
+        receipt['compatShims'] = ['music-control-bound-methods']
+        (folder / '.frame-control-store.json').write_text(json.dumps(receipt))
+        result = self.apply('update', data, expected=plugin['sha256'], **args)
+        self.assertEqual(result.returncode, 0, result.stderr)
+        called = subprocess.run([sys.executable, '-c', source, str(folder)],
+                                capture_output=True, text=True,
+                                env={**self.env, 'MPRIS_CALLS': str(calls),
+                                     'LD_LIBRARY_PATH': 'FrameyBundledLibraries'}, timeout=10)
+        self.assertEqual(called.returncode, 0, called.stderr)
         result = self.apply('remove', expected=plugin['sha256'], **args)
         self.assertEqual(result.returncode, 0, result.stderr)
         self.assertFalse(folder.exists())
@@ -284,9 +299,29 @@ asyncio.run(check())
         old_args = {'plugin_id': older['id'], 'folder': older['folder'], 'version': older['version']}
         result = self.apply('install', old_data, **old_args)
         self.assertEqual(result.returncode, 0, result.stderr)
+        self.assertEqual(json.loads((folder / '.frame-control-store.json').read_text())['compatShims'],
+                         ['music-control-system-dbus-env'])
+        self.assertNotIn('api_version', json.loads((folder / 'plugin.json').read_text()))
+        self.assertIn('self._get_dbus_env(self)', (folder / 'main.py').read_text())
+        old_env = {**self.env, 'MPRIS_CALLS': str(calls), 'LD_LIBRARY_PATH': 'FrameyBundledLibraries'}
+        old_env.pop('LD_LIBRARY_PATH_ORIG', None)
+        called = subprocess.run([sys.executable, '-c', source, str(folder)],
+                                capture_output=True, text=True, env=old_env, timeout=10)
+        self.assertEqual(called.returncode, 0, called.stderr)
+        result = self.apply('remove', expected=older['sha256'], **old_args)
+        self.assertEqual(result.returncode, 0, result.stderr)
+
+        # A future archive at the same store ID must retain its own source.
+        other = io.BytesIO()
+        untouched = 'class Plugin: pass\n'
+        with zipfile.ZipFile(other, 'w') as bundle:
+            bundle.writestr('MusicControl/plugin.json', json.dumps({'name': 'Music Control', 'flags': []}))
+            bundle.writestr('MusicControl/dist/index.js', 'export default {};' + ' ' * 1200)
+            bundle.writestr('MusicControl/main.py', untouched)
+        result = self.apply('install', other.getvalue(), **args)
+        self.assertEqual(result.returncode, 0, result.stderr)
+        self.assertEqual((folder / 'main.py').read_text(), untouched)
         self.assertNotIn('compatShims', json.loads((folder / '.frame-control-store.json').read_text()))
-        with zipfile.ZipFile(io.BytesIO(old_data)) as bundle:
-            self.assertEqual((folder / 'main.py').read_bytes(), bundle.read('MusicControl/main.py'))
 
     def test_installed_script_entrypoints_execute_without_zip_exec_bits(self):
         data, _ = archive(extra=('Example/scripts/start.py',

tests/test_framey_decky_runtime.py

@@ -0,0 +1,36 @@
+"""Managed backend shims must stay covered by the actual-Decky CI gate."""
+import sandbox  # noqa: F401
+import importlib.util
+from pathlib import Path
+import unittest
+from unittest.mock import patch
+
+ROOT = Path(__file__).resolve().parents[1]
+spec = importlib.util.spec_from_file_location('decky_runtime_gate', ROOT/'scripts/framey-test-decky-runtime.py')
+gate = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(gate)
+
+
+class RuntimeCoverage(unittest.TestCase):
+    def test_current_shims_have_unique_official_archive_probes(self):
+        from framey_official import PLUGINS
+        cases = gate.check_coverage()
+        official = {record['id'] for record in PLUGINS}
+        self.assertEqual(len(cases), len({case['id'] for case in cases}))
+        for case in cases:
+            self.assertIn(case['id'], official)
+            self.assertIn(case['probe'], ('mpris', 'screenshots'))
+
+    def test_new_shim_without_runtime_case_fails_coverage(self):
+        import frame_decky_store
+        with patch.object(frame_decky_store, 'APPLY', frame_decky_store.APPLY+
+                          '\ncompat_shims.append("uncovered-new-shim")\n'):
+            with self.assertRaisesRegex(ValueError, 'Every managed shim'):
+                gate.check_coverage()
+
+    def test_dynamic_shim_names_cannot_evade_inventory(self):
+        import frame_decky_store
+        with patch.object(frame_decky_store, 'APPLY', frame_decky_store.APPLY+
+                          '\ncompat_shims.append(variable_name)\n'):
+            with self.assertRaisesRegex(ValueError, 'literal name'):
+                gate.check_coverage()

ui/frame_decky_store.py

@@ -228,26 +228,23 @@ try:
                     '        base = os.path.join(os.path.expanduser("~"), ".config")\n'
                     '    return os.path.join(base, app_name)\n',encoding='utf-8')
                 compat_shims.append('shotty-click-app-dir')
-            # Music Control 1.1.7 passes `self` to its own bound methods.
-            # Python has already bound that argument, so even read-only player
-            # discovery raises TypeError. Repair only the SHA-pinned official
-            # source, and fail the transaction if its expected calls change.
-            if int(plugin_id)==111 and digest=='3f56a3f56034b277ea74a2c37cc84133b69e382aa6bcb0b43876776aac737ed9' and folder=='MusicControl':
+            # These legacy backends launch system dbus-send (1.1.6 via /bin/sh).
+            # Decky's PyInstaller LD_LIBRARY_PATH selects bundled libtinfo built
+            # against newer glibc than Frame OS. Restore its saved system path
+            # only in the copied subprocess environment; retain legacy self calls.
+            music_digests={
+                12:'246b89fd653c60a735b1cc401d1b0937d5cb969eea9024561661ff741f081d62',
+                111:'3f56a3f56034b277ea74a2c37cc84133b69e382aa6bcb0b43876776aac737ed9',
+            }
+            if digest==music_digests.get(int(plugin_id)) and folder=='MusicControl':
                 main=unpacked/'main.py'
                 source=main.read_text(encoding='utf-8')
-                fixes={
-                    'self._get_dbus_env(self)':('self._get_dbus_env()',10),
-                    'self._sp_player_dbus(self,':('self._sp_player_dbus(',7),
-                    'self._sp_dbus_set(self,':('self._sp_dbus_set(',1),
-                    'self.sp_get_volume(self)':('self.sp_get_volume()',2),
-                    'self.sp_set_volume(self,':('self.sp_set_volume(',2),
-                }
-                for old,(new,count) in fixes.items():
-                    if source.count(old)!=count:
-                        raise RuntimeError('Music Control compatibility source changed')
-                    source=source.replace(old,new)
+                old='        env = os.environ.copy()\n'
+                if source.count(old)!=1:
+                    raise RuntimeError('Music Control compatibility source changed')
+                source=source.replace(old,old+'        env["LD_LIBRARY_PATH"] = env.get("LD_LIBRARY_PATH_ORIG", "")\n')
                 main.write_text(source,encoding='utf-8')
-                compat_shims.append('music-control-bound-methods')
+                compat_shims.append('music-control-system-dbus-env')
             # Recheck under the transaction lock. Another store operation may
             # have installed a colliding name while this archive downloaded.
             proposed_name=json.loads((unpacked/'plugin.json').read_text()).get('name')

ui/framey-compatibility.json

@@ -474,12 +474,14 @@
         "https://github.com/mirobouma/MusicControl.git"
       ],
       "status": "partial",
-      "reason": "Legacy media controls initialize; player discovery and playback are unverified.",
+      "reason": "Managed reinstall preserves Decky’s legacy calling convention and repairs the Frame OS shell library-path failure. Chromium transport/seek/volume against a silent MPRIS fixture and real ARM64 empty-player discovery pass; actual Frame media playback, album art and worn VR remain unverified. Reinstall existing copies to apply.",
       "blockInstall": false,
       "verification": [
         "static archive",
         "local browser",
-        "fake-Frame"
+        "fake-Frame",
+        "isolated Decky 3.3.0 + MPRIS fixture",
+        "real Frame SSH"
       ],
       "browser": {
         "id": 12,
@@ -506,7 +508,7 @@
         "folder": "MusicControl"
       },
       "backend": "Python",
-      "hardware": "No specific hardware requirement detected statically; runtime requirements unverified.",
+      "hardware": "User-session MPRIS player and dbus-send required; no Deck-specific hardware.",
       "uiSurfaces": [
         "local/Steam routes"
       ],
@@ -515,7 +517,9 @@
         "sha256": "246b89fd653c60a735b1cc401d1b0937d5cb969eea9024561661ff741f081d62",
         "archiveValidation": "accepted",
         "result": "installed-removed"
-      }
+      },
+      "compatShim": "music-control-system-dbus-env",
+      "evidence": "docs/evidence/framey-mpris-runtime-2026-10-26.md"
     },
     {
       "id": 13,
@@ -927,7 +931,7 @@
         "logs": [
           {
             "kind": "error",
-            "message": "[Bluetooth] !! get_bluetooth_status \u2192 Error: All retries failed. Last error: Error: Read-only compatibility audit: backend method blocked"
+            "message": "[Bluetooth] !! get_bluetooth_status → Error: All retries failed. Last error: Error: Read-only compatibility audit: backend method blocked"
           },
           {
             "kind": "error",
@@ -935,7 +939,7 @@
           },
           {
             "kind": "error",
-            "message": "[Bluetooth] !! get_paired_devices_with_info \u2192 Error: All retries failed. Last error: Error: Read-only compatibility audit: backend method blocked"
+            "message": "[Bluetooth] !! get_paired_devices_with_info → Error: All retries failed. Last error: Error: Read-only compatibility audit: backend method blocked"
           },
           {
             "kind": "error",
@@ -1790,7 +1794,7 @@
       },
       "backend": "Python + native payload",
       "hardware": "No specific hardware requirement detected statically; runtime requirements unverified.",
-      "nativePort": "A source-matched ARM64 bin/hash helper matched the official x86_64 helper on one synthetic ROM on the real Frame (docs/evidence/framey-emuchievements-arm-2026-10-26.md). The official ZIP still bundles x86_64 bytes and remains blocked; format coverage, packaging, plugin backend/UI, login and worn VR are unverified.",
+      "nativePort": "A source-matched ARM64 helper matched one synthetic ROM on the real Frame (docs/evidence/framey-emuchievements-arm-2026-10-26.md). The pinned upstream source proposed for packaging also has unsafe archive extraction and cleanup paths (docs/evidence/framey-native-port-blockers-2026-10-26.md); fix and test those before shipping an ARM64 binary. The official x86_64 ZIP remains blocked; format coverage, plugin backend/UI, login and worn VR are unverified.",
       "uiSurfaces": [
         "local/Steam routes",
         "toasts",
@@ -3593,7 +3597,7 @@
         "https://github.com/GedasFX/decky-cloud-save.git"
       ],
       "status": "broken",
-      "reason": "Unsafe plugin archive member.",
+      "reason": "The exact official ZIP contains a 60,776,600-byte x86_64 rclone member, above the 30 MiB member limit and unusable on ARM64. Installation remains blocked.",
       "blockInstall": true,
       "verification": [
         "static archive",
@@ -3628,7 +3632,7 @@
       },
       "backend": "Python + native payload",
       "hardware": "No specific hardware requirement detected statically; runtime requirements unverified.",
-      "nativePort": "rclone needs an ARM64 artifact; this ZIP also fails safe member validation. Cloud writes were not exercised.",
+      "nativePort": "An ARM64 rclone artifact and safe package policy are needed; the official 60,776,600-byte x86_64 member fails archive validation. No cloud writes were run (docs/evidence/framey-native-port-blockers-2026-10-26.md).",
       "uiSurfaces": [
         "local/Steam routes",
         "toasts",
@@ -9582,13 +9586,15 @@
         "https://github.com/martinpl/music-control"
       ],
       "status": "partial",
-      "reason": "Exact official backend bound-method calls are repaired in managed installs. An isolated fake dbus-send target accepted player discovery, transport and volume commands after the patch; real MPRIS players, actual Decky ARM64, album art and worn VR remain unverified.",
+      "reason": "Managed reinstall preserves Decky’s legacy calling convention and repairs the Frame OS shell library-path failure. Chromium transport/seek/volume against a silent MPRIS fixture and real ARM64 empty-player discovery pass; actual Frame media playback, album art and worn VR remain unverified. Reinstall existing copies to apply.",
       "blockInstall": false,
       "verification": [
         "static archive",
         "local browser",
         "fake-Frame",
-        "isolated Python backend"
+        "isolated Python backend",
+        "isolated Decky 3.3.0 + MPRIS fixture",
+        "real Frame SSH"
       ],
       "browser": {
         "id": 111,
@@ -9615,7 +9621,7 @@
         "folder": "MusicControl"
       },
       "backend": "Python",
-      "hardware": "No specific hardware requirement detected statically; runtime requirements unverified.",
+      "hardware": "User-session MPRIS player and dbus-send required; no Deck-specific hardware.",
       "uiSurfaces": [
         "local/Steam routes"
       ],
@@ -9625,8 +9631,8 @@
         "archiveValidation": "accepted",
         "result": "installed-removed"
       },
-      "compatShim": "music-control-bound-methods",
-      "evidence": "docs/evidence/framey-music-control-bound-methods-2026-10-26.md"
+      "compatShim": "music-control-system-dbus-env",
+      "evidence": "docs/evidence/framey-mpris-runtime-2026-10-26.md"
     },
     {
       "id": 112,