Route embedded Khronos OpenXR loaders through FrameBridge

Detect and redirect static loader manifests and Android brokers, ship a runtime negotiation shim and the inner loader chain, and maintain per-game manifests on install and launch. Add the PrimedGun recipe, triage and host coverage.
Catalog: HardBullet (issues: cube loading screen, view freezes during loads)
2026-10-23 20:00:38 +02:00 · 2026-10-18 12:39:35 -04:00 · 2026-10-18 12:17:35 -04:00 · 2026-10-18 12:14:42 -04:00 · 2026-10-18 12:06:49 -04:00
234 changed files with 528 additions and 20560 deletions
@@ -59,21 +59,7 @@ Detailed device findings per game/issue: docs/DEVICE_NOTES.md (read before debug
    agent ends at EOF); sources and costs in docs/FRAME_RUNTIME.md "Monitoring sources"; game card (fps from
    FrameBridge pacing; End game = Steam's Exit game, then cmd_stop), tiles with `C.Sparkline` (Flet canvas, no charts
    extension), details, a pooled process table (Game / Steam & SteamVR / All; right-click: end / force kill / end
-    game; MON_CRITICAL needs force, MON_NEVER is refused)); room (`views/room.py`, persistent, "experimental" pill:
-    scan with progress + Cancel = agent v109 `room_capture_stop`, play area, delete; cache `ui/room_state.py` shared
-    with the Frame page's short card, mesh cached in `<data>/rooms-cache/<frame>/`; in-window 3D `ui/room3d.py`
-    RoomCanvas over `mr/view3d.py` (pure-Python projection, mesh reduced to ≤4k/≤1.5k edges at rest/moving, ≤18 fps
-    worker; each redraw sends NEW shape controls: changing a Points list made Flet diff it item by item, 0.3-1 s);
-    "Open full 3D view" = `mr/room_viewer.py` token server on 127.0.0.1 + hand-written WebGL `mr/viewer_page.py`,
-    stopped on disconnect/close; Test Quest MR tip = `mr.TESTER_*`; editing cards `views/room_edit.py` (agent v109):
-    Clean-up = fp_roomscan's refinement settings, `install/rooms.REFINE_DEFAULTS` = the owner's defaults + slider
-    metadata (agent `ROOM_REFINE_DEFAULTS` must match, a test checks), saved non-defaults in the Frame's
-    `rooms/refine.json`, used by every build; Apply = job → agent `room_refine` (`--refine-only` on a copy of the room
-    folder from `room-raw.txt`/`room-mesh-raw.bin`, scan.json → status `report`/`labels`/`suggestions`); Labels =
-    the label rules' decisions + Add as door / Add as closet; Furniture & screens = box editor (click a box in the
-    canvas: `view3d.pick`) + doors/windows on a wall (`mr.room.plane_on_wall`), Save = `rooms.put_room` → `room_put
-    edited` (keeps raw files, `edits.txt` survives a new clean-up; "Back to the scan's boxes" = keep_edits false); no
-    eraser in the GUI (`rooms.refine(erase=)` only)); settings; welcome; activity panel). Files, Screenshots and the Library share right-click menus
+    game; MON_CRITICAL needs force, MON_NEVER is refused)); settings; welcome; activity panel). Files, Screenshots and the Library share right-click menus
    (one `ft.ContextMenu` per view, filled on right-click; on one of several selected items they act on the whole
    selection, `C.menu_targets`) and click-and-drag multi-select (`C.DragSelect`: pan start/end on the area + item
    hover events, which Flutter also sends with the button held; Flet can't report item positions, so no rubber band).
@@ -469,9 +455,7 @@ Repo is on an NTFS drive (`core.fileMode=false`); line endings are LF (`.gitattr
 - No XR_FB_display_refresh_rate (`xrGetDisplayRefreshRateFB` -7), yet OVRPort's dispatcher offers it and answered 0 Hz
  → FrameBridge always answers with the measured rate (1/predictedDisplayPeriod, else 72). PreyVR (#306, idTech 4:
  `USERCMD_MSEC = 1000 / GetRefresh()`) had 0 ms tics: async thread spinning, `com_frameTime` stuck at 0, menu black.
- Guardian STAGE bounds report 1×1 m (scene emulation uses ≥1.5 m). OVRPlugin treats that rect as a configured
-  boundary but can't outline it ("ovrpBoundary_Outer is not supported"): Demeter's guardian check indexed an empty
-  array → with `scene_emul` the app's STAGE `xrGetReferenceSpaceBoundsRect` returns XR_SPACE_BOUNDS_UNAVAILABLE.
+- Guardian STAGE bounds report 1×1 m (scene emulation uses ≥1.5 m).
 - GL goes through **Zink** (Mesa GL on Vulkan). Mesa GLSL is strict: `#pragma` before `#extension` fails, implicit
  int/float conversions fail (enable `GL_EXT_shader_implicit_conversions`), num_views=2 shaders on single-view FBOs
  give GL_INVALID_OPERATION. Some GLES games hit `zink: DEVICE LOST` (Unity MSAA RTT; Sniper Elite VR even without).
@@ -606,7 +590,6 @@ Toy Master doesn't request a model after that (it uses its own), so the glb load
 **Vader Immortal (GitHub #49):** stuck on its loading card and leaked GPU mappings (solved below: `gl_error_clear`); diagnostics FrameBridge `layer_debug`, `strip_color_bias`, `frame_balance`, `snapshot=N` (`snapshot_gl.c`: saves the submitted left-eye image as `files/fb_snap_*.ppm`). → docs/DEVICE_NOTES.md#vader-immortal-headless-investigation
 **SteamVR overlay apps:** host OpenVR overlays composite over Lepton games; detection `analysis/vroverlay.py`, patch `pcvr.vr_overlay`, Linux fields `vr_overlay`/`vr_overlay_autostart`, agent `register_vr_overlay`/`unregister_vr_overlay`/`launch_vr_overlay`; SteamVR on the Frame reads only `binary_path_linux_arm`; FramePort's own autostart (`ensure_overlay_service`, `frameport-vr-overlays.service`). See also docs/FRAME_RUNTIME.md "Overlay apps". → docs/DEVICE_NOTES.md#steamvr-overlay-apps
 **Vader's leak solved / AC Nexus flips:** stale GL errors broke SteamVR's GL interop → adapter `gl_error_clear` (GLES, catalog for Vader ep1-3); read `xrclient_<pkg>.txt` in Steam's logs for runtime errors; the runtime caps swapchains per session (~15) → flip emulation in place; adapter `flip_dump`. → docs/DEVICE_NOTES.md#vaders-leak-solved--ac-nexus-flips
-**Mixed reality: scanned rooms (branch mr-scene):** agent `room_capture` records Valve's RoomView 3D depth mesh -> `fp_roomscan` -> `room.txt` + `room-mesh.bin` (docs/mr/ROOM_FORMAT.md; refined by default: the owner's cleanup passes + label rules in `native/roomscan/refine.c`/`rules.c`, unrefined output kept as `room-raw.txt` + `room-mesh-raw.bin`, head path/settings/report/labels/door suggestions in `scan.json`, `--refine-only <dir>` re-runs it, `--refine 0` = old output; docs/mr/scan.md "Refinement") in `~/.local/share/frameport/rooms/<universe>/`, copied next to settings.conf (`_room_sync`); FrameBridge (`scene_room.c/scene_meta.c/scene_anchors.c`, all through xrshim) serves walls, volumes, planes, the room mesh, META discovery/persistence, saved anchors and `XR_META_boundary_visibility`; `scene_emul` + `frame.meta_permissions` for every USE_SCENE/USE_ANCHOR_API game (migrations `scene_emul_all`, `scene_permissions`); per-game `scene_hide_bounds` (Demeter). → docs/DEVICE_NOTES.md#mixed-reality-scanned-rooms
 **Unreal's self-restart:** UE 4.21+ restarts itself after the first shader precompile and Lepton ends the container → launch.sh RESTART_BLOCK starts Lepton once more (`upgrade_launchers`; `FRAMEPORT_NO_RESTART=1` off). → docs/DEVICE_NOTES.md#unreals-self-restart
 **xrWaitFrame runs ahead:** the runtime sometimes returns a display time <1 refresh after the last submit and rejects the second submission (`VRCompositorError_AlreadySubmitted`) → the VrApi bridge re-waits (`pacing 2s:` counters). → docs/DEVICE_NOTES.md#xrwaitframe-runs-ahead-journey-of-the-gods
 **Lepton's logcat mirror dies** (EOF, read failure, or silent) → launch.sh `_logcat_keeper` reads `podman exec <container> logcat` itself into launch.log (log `<base>/logcat-keeper.log`). → docs/DEVICE_NOTES.md#leptons-logcat-mirror-dies
@@ -36,9 +36,6 @@ Frame, patches each game so it runs there, uploads it and adds it to your Steam
  in FramePort.
 - **Your Frame from your PC:** Type on Frame (your keyboard on the Frame), Files, Screenshots, Live view (what the
  headset shows, in your browser) and Monitor (frame rate, temperatures, battery, processes).
- **Your room for mixed reality (experimental):** scan the room in the headset, see it in 3D, clean up the scan and
-  fix furniture, screen and door labels, so mixed-reality games get your room. Try it with
-  [Test Quest MR](https://github.com/spoopyghosty0/TestQuestMR).
 - **Updates itself**, and reports problems without personal data.

 Details for each: [Install and first steps](docs/INSTALL.md).
@@ -47,8 +44,6 @@ Details for each: [Install and first steps](docs/INSTALL.md).

 ![Screenshots](docs/images/screenshots.png)

-![Room (experimental): the scanned room in 3D, clean-up and labels](docs/images/room.png)
-
 ## Quick start

 1. [Download](https://github.com/spoopyghosty0/frameport/releases/latest) the build for Windows, macOS (Apple
@@ -14,52 +14,20 @@ e32f9b3222bfe2e58c193db809ac2cf54086df36fd2ec6651aa2e58308f6b39d  ./arm64-v8a/li
 4a13a33e112c9e4e3c5ff4337ed6e988a9e5b3602f48d654df148ef5fafbf426  ./arm64-v8a/libfpglmv.so
 36400eae4ba3807bcfcd54463daa217347032b07218792faa448d8cbbd086a0e  ./arm64-v8a/libframe_xrshim.so
 19ba5ed3c4b780f5ae46251f6958f552acfc5f13c8bb39f995579593fa8990c6  ./arm64-v8a/libglshim.so
-7c33d7fb9fd176ca222efb2d87cf525e2f0604457c16896027a5881594495f76  ./arm64-v8a/libopenxr_loader_generic.so
+f0894d9cc08aed4c0f6468134e76909d583a208c3f5e528bc3ee795f51b19fcb  ./arm64-v8a/libopenxr_loader_generic.so
 1feaeafad467c4cafdf2b018a4d84b0bee200c3f711697b4ce97e66a3ba256ca  ./arm64-v8a/libovrplatformcompat.so
 a4ed80ae45ca90758239f152ea5a2e8c127d491e1e697ea5680db6fd7f72db07  ./arm64-v8a/libvrapi.so
 a4ed80ae45ca90758239f152ea5a2e8c127d491e1e697ea5680db6fd7f72db07  ./arm64-v8a/libvrapi_foveation.so
-19ae0a45e80d8031300eea0d54810c14e4711fa8cd383c29ca65d85a74f577c4  ./armeabi-v7a/libopenxr_loader_generic.so
+4e03a8389981ed5a27b4c159cc83168c4f93d0d75479a445b02e5669aa26a71b  ./armeabi-v7a/libopenxr_loader_generic.so
 1871eae093432d277da4bc751bf5f3269dfcf11f9168260b0c3caadb0dedb19d  ./dex/oculusos-stubs.dex
 b634ab5640e258563c536e658cad87080553df6f34f62269a21d554844e58bfe  ./hevc/COPYING.FFmpeg
-82b11650e8eaab014aaab7e67ec781499df670c2519484f4ec9f2316db17c03c  ./hevc/libstagefrighthw.so
-96c7c947963dce72c3c2633c005f2801de54d16896d14d7afd91304ed1399d22  ./hevc/manifest.json
+141de01f0d40b97d4f9a720db5ab8ea442f6aa35db5272048899292884994a1c  ./hevc/libstagefrighthw.so
+4516971bbb2b635e19b14d2d37b9353962876f7de02043e7457327052c1fcbc0  ./hevc/manifest.json
 46c3dcad2c43cc30bea3b3680b362ed84a99c15d60714bbbbb422c80ecf90405  ./hevc/media_codecs_frameport.xml
 529ea35d5d82474afe9e09ad1216d269317f56dd24a05fb100fced52b7b4dbca  ./hevc/podman.py.txt
 6cda3076a8c09b31bb1f90da614ea89e7ee194589626eeac613e522849604e47  ./licenses/LuaJIT.txt
 1aa733117cf57ccff7cf23f0425dbfd73b0332a3ef1c905ceeca0ccd0449c4e0  ./linux-arm64/XR_APILAYER_FRAMEPORT_timefix.json
 28c2430a02bbd8902c5bfb9562c6fd0e318654f9e05c095bfeb94b0450ab1b07  ./linux-arm64/libxr_frameport_timefix.so
-2cc16b90abcd3d359f1658c581172bd650017bf2725e24268915f50904c000ec  ./linux-arm64-bin/fp_roomscan
 b10b3a5c10c3339fc63fd9f6cb4d01ea29be11a863d0ebad1389ea69fd471940  ./linux-arm64-bin/fp_venc
-00c2dead0fd7497929833467f0e55699d57d26be1b85dce35402993852f7b111  ./roomscan/ceiling.png
-c1962de31ed2810d31c760cf9ee63316ac2b8c9528ccbcd9299ebf5ba39b2995  ./roomscan/done.png
-0dfaea4c68979b0a45a9fef06fdf1a92468ffc8f46f80a3a014fce1d805972d5  ./roomscan/failed.png
-f2bae84f1d1512f87b25e688acdddb29b3f360f3f0d0cd4fdeeb741a79e7b19a  ./roomscan/finish_00.png
-9be7720c45f162e99813cb9a7a03e026fed53b41f06637b30ded309eeac91759  ./roomscan/finish_01.png
-220d699f879b3a8669cfaf4dc714496e8c1db7e7878e7cd12b1a41aec9b62faa  ./roomscan/finish_02.png
-42871b440b77449d4fe41be1c809a930148a874caa8bc92b13b5d25bb6effa83  ./roomscan/finish_03.png
-a470f62624c94ed6791cc7ee03066e1ffb0a676d520658a0a8b02a6af1605b3b  ./roomscan/finish_04.png
-195ff1c649fd9b42bfa6eea29c43a8b67116fd6ffe9b0fe53dcbdb1074bd34fa  ./roomscan/finish_05.png
-a45accab86b02d7b78327a17b84a6fea543ecc549282055dd3182c686fc2b1b8  ./roomscan/finish_06.png
-b88d6c590ea839a9d11b3a4de8c3effb39752f7114318966fddae09995e0fd37  ./roomscan/finish_07.png
-4a3615db26cf765b855a997be3e067aed58464894dab4a6700fdec5c2b854501  ./roomscan/finish_08.png
-f532a83044e707c66dbc74787ce7b844890bc05829d3e9c8f7e33dae9db246a5  ./roomscan/finish_09.png
-ffce61a9f13bbb250fad3582396a5bec82a1bad1d585b7ef9b8f65d343806b26  ./roomscan/finish_10.png
-4a63772adacb31004749ab04b592076bd36cda61eef52f59037d5abdc9e527db  ./roomscan/finish_11.png
-f373e7021cfce0d1078227f473425a10035ee426102b78f13e0fea4833b736d5  ./roomscan/finish_12.png
-1147391822be3f1aa5351374b8fd9ec85f8b5ce40e3cb9f3146d778e6fbc652a  ./roomscan/floor.png
-eb3c8b55a9dbafa030797ca9f06a22c3ee3bbef96cb7adea26d433ebad43d43f  ./roomscan/look_00.png
-6ba965ff6d22a469c558f2a68229bd2ff48fc28badb95889ca245310d1dd3e96  ./roomscan/look_01.png
-0a11cec25ebc76fe11d505d1f2ec162c9b4a6754393065800e73b1f81e2d94c8  ./roomscan/look_02.png
-fa5a4c94d20af56797b9fcc111148767847a6633ade9217cab373de232efad90  ./roomscan/look_03.png
-e80fa493e380fba39084be2ee62859adcff4e39aa66566abee10a4d6339c52e9  ./roomscan/look_04.png
-133617f0d8d1e69c37408aac80033f71856b592b62e3b780cc12b446bd974680  ./roomscan/look_05.png
-d5dd296ff23641c6973c57ac139147e99c7b783316ab60537adb2155dd196880  ./roomscan/look_06.png
-c08570aa78f966ae937b2e21d0bad887c5352fbca56aa579a2a7ef8541fb96ad  ./roomscan/look_07.png
-3767e7db5fb6babc872fa62c42604f749c65936717d332101745b201cd450cd5  ./roomscan/look_08.png
-2924dc65e5c497545340209edc16060e12e1834d11af6871d1c1baa50b7b2562  ./roomscan/look_09.png
-cd0150dfc10b2aea39403c74eff72fd05fb0111178ef39b4c98657a6d16d105e  ./roomscan/look_10.png
-011355e412f73ade3896e9037490e607c4365d0cf8ceb807d236bf68b414d3ed  ./roomscan/look_11.png
-1b8b47ffb47568d540921f065b5958eeb44a6489498d58e0f33f5d1f535154e2  ./roomscan/look_12.png
-926c7bc6a103adee5b9bf938f5d4e39095ab77fd6270b5301be3b0428edd9ae6  ./roomscan/start.png
 c2c70f4af1a5c3e6089dff1130161dd417f8044f99ec639eeecf1083930aab16  ./win-x64/fp_oculushmd.exe
 60ebc5fea05b8945082e2ca8b9f2eb74616012a26eb50133af273dff0fcddc42  ./win-x64/fp_vrsettings.exe
@@ -1,8 +1,8 @@
 {
-  "revision": 11,
+  "revision": 8,
  "runtime_sha256": "456e912c75cd389abcf6a63bc80e2a53bdc334371d00b200c93680388ae955e2",
  "files": {
-    "libstagefrighthw.so": "55aae57d292e9536701f2f8a9dbaf1edcfdd766c5748d07a34da2f5ef197f212",
+    "libstagefrighthw.so": "141de01f0d40b97d4f9a720db5ab8ea442f6aa35db5272048899292884994a1c",
    "podman.py": "529ea35d5d82474afe9e09ad1216d269317f56dd24a05fb100fced52b7b4dbca",
    "media_codecs_frameport.xml": "46c3dcad2c43cc30bea3b3680b362ed84a99c15d60714bbbbb422c80ecf90405",
    "COPYING.FFmpeg": "b634ab5640e258563c536e658cad87080553df6f34f62269a21d554844e58bfe"
@@ -8,21 +8,19 @@ notes: 'Native OpenXR GLES video player. 360 theatres/videos (equirect2 layers,
 details: 'Settings: equirect_emul (GLES worker draws 360 layers into a projection layer), stable_local, focus_hold,
  scale 0.75; frame.swapchain_limit for its 7680x3840 theatre swapchains. Its hardware decoding mode (Java MediaCodec,
  Vr4pMediaPlayer; its own FFmpeg is the software path) gets the Frame''s video hardware with frame.hw_video_decode
-  (added 2026-10-09, not yet checked in the headset). swapchain_pool shares extra GLES panel images to avoid the
-  runtime swapchain count cap (#387); host-tested only, menu interaction needs a headset check.'
+  (added 2026-10-09, not yet checked in the headset).'
 tested_version: 2.0.22
 engine: Other
 xr: OpenXR
 frame:
 - frame.hw_video_decode
 adapter:
-  swapchain_pool: 1
  equirect_emul: 1
  stable_local: 1
  focus_hold: 1
  scale: 0.75
 verified:
  date: '2026-10-01'
-updated: '2026-10-18'
+updated: '2026-10-10'
 min_app: 0.12.1
 source_hint: 4XVR Video Player
@@ -1,16 +0,0 @@
-package: com.And7Limited.Hitstream
-title: Hitstream
-status: works
-tested_version: 2.06bQuest
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-adapter:
-  controller_models: 1
-  haptic_fix: 1
-notes: Fitness rhythm game; uses controller models and haptics fix.
-verified:
-  date: '2026-10-12'
-  known_good_sha256: ecc9e2eee79073ae97ad5d3f70c21e8f049f899f21b51dfd541430bb7dd04cac
-source_hint: Hitstream
@@ -1,26 +0,0 @@
-package: com.EgerterSoftware.MovieDeckforPlex
-title: Movie Deck for Plex
-status: works
-notes: Works out of the box and absolutely fantastically so.
-tested_version: '6.4'
-engine: Unity
-xr: OpenXR
-frame:
- frame.meta_permissions
- frame.unity_text_input
- frame.hw_video_decode
-device:
- device.text_input_window
-adapter:
-  controller_models: 1
-  haptic_fix: 1
-  scene_emul: 1
-verified:
-  date: '2026-10-20'
-  known_good_sha256: 397912f98ded90df0dabeb51d097c56de9b70ef99674303fa0efba84d43c4df0
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 435
-source_hint: Movie Deck For Plex
@@ -1,20 +0,0 @@
-package: com.Iconik.LittleNightmaresVR
-title: Little Nightmares VR
-status: works
-tested_version: 1.0.31
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
- frame.hw_video_decode
-device:
- device.text_input_window
-verified:
-  date: '2026-10-18'
-  known_good_sha256: 171e586bf35ee4494874c6f2c37fb734f718e5b81744b2df9095919398d70839
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 96
-  issue: 421
-source_hint: Little Nightmares VR- Altered Echoes
@@ -1,19 +0,0 @@
-package: com.MoonMonsterStudios.SpaceControl
-title: SpaceControl
-status: works
-tested_version: 1.1.2
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-verified:
-  date: '2026-10-20'
-  known_good_sha256: 60b900a0a73a693426b85d81a489c63fab6cc959939f80efd29632945e0ce559
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 447
-source_hint: Space Control
@@ -1,23 +0,0 @@
-package: com.MyronSoftware.Deisim
-title: Deisim
-status: works
-tested_version: 1.58.543
-engine: Unity
-xr: OpenXR
-frame:
- frame.bhaptics_permission
- frame.photon_voice_audio_route
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-21'
-  known_good_sha256: 91bc0a28ff7ca22a877f4f920984c3a6a2c91828a2bccff0c5eb4affb4dc13ae
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 462
-source_hint: Deisim
@@ -12,7 +12,6 @@ overport_extra:
 - patch_force_passthrough
 adapter:
  scene_emul: 1
-  scene_hide_bounds: 1
 device:
 - device.text_input_window
 verified:
@@ -23,4 +22,4 @@ verified:
 frame:
 - frame.meta_permissions
 - frame.unity_text_input
-updated: '2026-10-17'
+updated: '2026-10-15'
@@ -1,20 +0,0 @@
-package: com.ORIGAMEDIGITAL.UmurangiGenerationVR
-title: Umurangi Generation VR
-status: issues
-notes: The game freezes after taking a photo, while it saves it, which makes it hard to play.
-tested_version: '1.163'
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-22'
-  known_good_sha256: c4dfe227c3e33e611f9a4b8ee542912c0891fe600a7d32e56cbe84b0524ec8d9
-  app: 1.3.0
-  overport_cli: 1.2.5
-  issue: 472
-source_hint: com.ORIGAMEDIGITAL.UmurangiGenerationVR.output
@@ -1,24 +0,0 @@
-package: com.TeravisionGames.OrcsMustDie
-title: 'Orcs Must Die: By The Blade'
-status: works
-notes: Perfect at v151
-tested_version: 1.0.164237
-engine: Unreal
-xr: OpenXR
-alt_overport:
- patch_remove_unreal_force_quit
-frame:
- frame.unreal_ovrp_entrypoints
- frame.hw_video_decode
-adapter:
-  equirect_emul: 1
-  haptic_fix: 1
-verified:
-  date: '2026-10-21'
-  known_good_sha256: 11e5d45587277a5edea8be4862c7af19aa5c38445676607c541bc1e471f473ff
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 453
-source_hint: OrcsMustDie
@@ -5,10 +5,9 @@ source_hint: Assassins Creed Nexus VR
 engine: Unity
 xr: OpenXR
 status: works
-notes: 'FrameBridge turns its upside-down UI panels upright (flip emulation, in place since FramePort 1.2.0). Ubisoft
-  login may not work. frame.unity_text_input and device.text_input_window added from detection (not headset-verified).
-
-  Keeps the Quest 2 headset identity: with Quest 3 it stops drawing after the start (GitHub #424).'
+notes: FrameBridge turns its upside-down UI panels upright (flip emulation, in place since FramePort 1.2.0). Ubisoft
+  login may not work.
+  frame.unity_text_input and device.text_input_window added from detection (not headset-verified).
 details: Ubisoft online login may not work. Data folder holds raw assets (start0..2, .climb, bundles), not .obb
  files; install to obb as-is.
 overport_extra:
@@ -17,8 +16,6 @@ frame:
 - frame.unity_text_input
 device:
 - device.text_input_window
-frame_remove:
- device.headset_model
 verified:
  date: '2026-09-28'
  overport_cli: 1.2.3
@@ -26,5 +23,5 @@ verified:
  known_good_sha256: 89644a12bf8df956fa3d3a9a40540ba9e1fb62f63494714a05c9f05984383ac8
  no_appsw_90: '2026-10-02, OVRPort 1.2.5 (owner: 90 Hz felt better than 72 Hz; same known issues)'
  flip_in_place: '2026-10-14, owner in the headset: launch warnings and tutorial pop-ups upright (GitHub #138)'
-updated: '2026-10-23'
-min_app: 1.3.0
+updated: '2026-10-15'
+min_app: 1.2.0
@@ -1,11 +0,0 @@
-package: com.ZarApps.PianoVision
-title: PianoVision
-status: unsupported
-notes: Starts, but needs camera hand tracking (Android games on the Frame only get hands built from the controllers)
-  and USB MIDI from a piano, which the Frame's Android container doesn't pass through.
-tested_version: 3.0.8
-engine: Unity
-xr: OpenXR
-verified:
-  date: '2026-10-20'
-  issue: 297
@@ -1,22 +0,0 @@
-package: com.astrobotquest.vrhost
-title: Astro VR Host
-status: works
-notes: Runs your own Astro Bot Rescue Mission files (the unpacked CUSA12392 folder, not the .pkg). With the Files
-  tab, copy the folder to Android/data/com.astrobotquest.vrhost/files/games/ in the game's storage and add Android/data/com.astrobotquest.vrhost/files/vrhost.txt
-  with the lines language=<your language, e.g. en-US> and refresh_rate=80. Set FoV to 100% in the game.
-details: 'Tested with AstroQuest v0.23 (https://github.com/bigmak94/AstroQuest). The port caps the resolution at
-  1440 px per eye; vrhost.txt can''t change that. Other vrhost.txt options: https://github.com/bigmak94/AstroQuest/blob/main/README-QUEST-VR.md#installing-and-running'
-tested_version: '0.23'
-engine: Other
-xr: OpenXR
-adapter:
-  refresh_rate: 80.0
-verified:
-  date: '2026-10-22'
-  known_good_sha256: c2e13ab155b947c0037362635bd34112c16b69b804af82b347021f2261ef5bfb
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 464
-source_hint: AstroQuest
@@ -16,7 +16,6 @@ frame:
 - frame.hw_video_decode
 - frame.unity_text_input
 adapter:
-  fixed_resolution: 1
  sync_guard: 1
  surface_native: 1
  fade_quad: 1
@@ -27,6 +26,6 @@ verified:
  overport_cli: 1.2.3
  overport_runtime: 3.4.3-23204ea
  known_good_sha256: 796d1cab08f614d72c50d9702974c719c0908f5de91183cfe02d1fd5eb09551a
-updated: '2026-10-18'
-min_app: 1.2.2
+updated: '2026-10-15'
+min_app: 1.1.0
 source_hint: Batman- Arkham Shadow
@@ -1,26 +0,0 @@
-package: com.com2usroca.Darksword
-title: Darksword
-status: works
-tested_version: 1.6.2.11
-engine: Unreal
-xr: OpenXR
-alt_overport:
- patch_remove_unreal_force_quit
-frame:
- frame.unreal_skip_obb_check
- frame.bhaptics_permission
- frame.unreal_ovrp_entrypoints
- frame.hw_video_decode
-adapter:
-  haptic_fix: 1
-  scale: 1.5
-foveation: tracked
-verified:
-  date: '2026-10-18'
-  known_good_sha256: 47f9968e5fac70a5873b996a4d7b9c01d42d2f0cc1d9dc24013eb2e3b08a8a8e
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 96
-  issue: 410
-source_hint: darksword
@@ -1,19 +0,0 @@
-package: com.drbeef.jkxr
-title: JKXR
-status: issues
-notes: Tested in the early part of Jedi Outcast. Two players report stutters and freezes after 3-15 minutes of play
-  (under investigation in issue 441).
-tested_version: 1.1.28
-engine: Other
-xr: OpenXR
-frame:
- frame.tbxr_vendor
-verified:
-  date: '2026-10-20'
-  known_good_sha256: 771e48b22d3a558ea11869aa1e9070b11908b17ab47a9e8866769bb67efc30a5
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 109
-  issue: 441
-source_hint: QuestAPKs
@@ -1,24 +0,0 @@
-package: com.fasttravelgames.solero
-title: Solero
-status: works
-tested_version: 1.00.109160
-engine: Unreal
-xr: OpenXR
-alt_overport:
- patch_remove_unreal_force_quit
-frame:
- frame.gms_platform_version
- frame.unreal_ovrp_entrypoints
- frame.hw_video_decode
-adapter:
-  equirect_emul: 1
-  haptic_fix: 1
-verified:
-  date: '2026-10-20'
-  known_good_sha256: 2d19ac1ed61cc12d0976155fbb6697fb87ec5d60c6601fe1598c965bc3e48377
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 448
-source_hint: Action Hero
@@ -1,24 +0,0 @@
-package: com.garage.drumsrock
-title: Drums Rock
-status: works
-notes: Let's Rock!
-tested_version: '1.401'
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
- frame.oculusos
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-  scale: 2.0
-verified:
-  date: '2026-10-18'
-  known_good_sha256: 61d724ce51cc5bc17c7f942803922e8606fc5d60bc4ec5134f06754c5172c7eb
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 96
-  issue: 409
-source_hint: drums rock
@@ -1,16 +0,0 @@
-package: com.gevr.port
-title: GoldenEye VR
-status: issues
-notes: No sound; otherwise works great.
-tested_version: 0.5.8
-engine: Other
-xr: OpenXR
-frame:
- frame.sdl_clipboard
-verified:
-  date: '2026-10-18'
-  known_good_sha256: 5bd0d5ad71368178f8478193c215459a670d22ca6828bb155d76c5255908759b
-  app: 1.2.1
-  overport_cli: 1.2.5
-  issue: 412
-source_hint: GoldenEye-VR-v0.5.8
@@ -5,10 +5,8 @@ source_hint: NOPE CHALLENGE
 engine: Unreal
 xr: OpenXR
 status: works
-notes: "Meta XR Audio telemetry patch + nodebug. MR mode: needs a scanned room."
-details: The MR 'Reality Breach' mode needs passthrough and a room; standard VR mode was verified.
-adapter:
-  scene_emul: 1
+notes: Meta XR Audio telemetry patch + nodebug. MR "Reality Breach" mode unavailable.
+details: The MR 'Reality Breach' mode needs passthrough; standard VR mode used.
 alt_overport:
 - patch_remove_unreal_force_quit
 frame:
@@ -1,23 +0,0 @@
-package: com.mrf.tvb.cubism
-title: cubism
-status: works
-notes: works and passthrough play works also
-tested_version: 1.8.0
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-  scene_emul: 1
-verified:
-  date: '2026-10-17'
-  known_good_sha256: fd1ba8eae19efe0f2a17fc146847de677263125f9ec5437cea5c632f0cd88dcf
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 91
-  issue: 403
-source_hint: Cubism
@@ -1,19 +0,0 @@
-package: com.mrf.tvb.laser_dance
-title: Laser Dance
-engine: Unity
-xr: OpenXR
-status: works
-notes: Mixed reality laser obstacle course; requires spatial data and room layout emulation (scene_emul=1). frame.meta_depth_occlusion keeps close lasers visible (its asset fixes only for the build they were made for); tested version not recorded (PR #246).
-details: Mixed reality game that projects lasers across your room; needs Meta scene emulation and spatial data permission.
-adapter:
-  controller_fix: 1
-  haptic_fix: 1
-  scene_emul: 1
-  passthrough_emul: 1
-frame:
- frame.meta_permissions
- frame.meta_depth_occlusion
- frame.unity_scene_active_rooms
- frame.unity_text_input
-min_app: 1.2.2
-updated: '2026-10-18'
@@ -18,12 +18,11 @@ engine: Unity
 xr: OpenXR
 frame:
 - frame.unity_text_input
- frame.pojlib_connection
 device:
 - device.text_input_window
 lepton_env:
  LEPTON_ENV_LIBGL_NOERROR: '1'
 verified:
  date: '2026-10-05'
-updated: '2026-10-23'
+updated: '2026-10-05'
 source_hint: QuestCraft
@@ -1,27 +0,0 @@
-package: com.simpsonsHitAndRun.vr
-title: Simpsons Hit and Run VR
-status: works
-notes: 'Needs the port''s game data: after installing, copy the "SimpsonsHitRun" folder (see the port''s GitHub
-  instructions) into the game''s storage with FramePort''s Files tab. In-game settings: Vehicle lights off, Enhanced
-  materials off, CSM shadows off (otherwise it crashes when starting a new game), Render scale 150% at 120 Hz.'
-details: 'Tested with v1.2 of https://github.com/kote2345/The-Simpsons-Hit-and-Run-VR. Vehicle lights break entities
-  and Enhanced materials break textures. Render scale above 150% can''t keep up at 120 Hz (200% runs at about 100
-  fps). Optional: set the in-game VR tab''s mode to VR to make the menus more comfortable. While paused, a long
-  black texture can appear from the head when looking up; it goes away when the pause menu closes. Contributed in
-  issues 443 and 461.'
-tested_version: '0.93'
-engine: Other
-xr: OpenXR
-frame:
- frame.sdl_clipboard
-adapter:
-  refresh_rate: 120.0
-verified:
-  date: '2026-10-22'
-  known_good_sha256: e406a5da1b2f99fc3a9f95af44f458598ad52d1296a8c577bf1f8e2343738ff2
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 461
-source_hint: SimpsonsHitRun_1.2
@@ -1,22 +0,0 @@
-package: com.stalwart.barbaria
-title: Barbaria
-status: works
-tested_version: 1.10.1.22383.158.OBERON.Quest.release
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-  scale: 2.0
-verified:
-  date: '2026-10-18'
-  known_good_sha256: e0cd063fc14a2bea5503bf63cf83246527b286915f05186ca5a2c42ce6e7d75a
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 96
-  issue: 418
-source_hint: barbaria
@@ -1,26 +0,0 @@
-package: com.team17.killerfrequency
-title: KillerFrequency
-status: works
-tested_version: 1.0.767.38513
-engine: Unity
-xr: VrApi
-frame:
- frame.unity_no_msaa
- frame.unity_text_input
- frame.unity_runtime_msaa_off
- frame.hw_video_decode
- frame.unity_gl_shim
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-  scale: 1.4000000000000001
-verified:
-  date: '2026-10-18'
-  known_good_sha256: a11b008fcc0f5bc7aa5a3bb04d4267144d5ec60b26529a9b20e6499e12dcf079
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 96
-  issue: 402
-source_hint: killer freq
@@ -1,14 +1,13 @@
 package: com.zenstudios.PFXVRQuest
 title: Pinball FX VR
 status: issues
-notes: "Plays; space warp off (fewer stutters). MR mode: needs a scanned room."
+notes: Plays; mixed reality mode not working yet. Space warp off (fewer stutters).
 tested_version: '1.9'
 engine: Unreal
 xr: OpenXR
 alt_overport:
 - patch_remove_unreal_force_quit
 adapter:
-  scene_emul: 1
  equirect_emul: 1
  hide_space_warp: 1
 verified:
@@ -1,26 +0,0 @@
-package: games.b4t.epicrollercoasters.oculus
-title: Epic Roller Coasters
-status: works
-notes: You may need to restart the game for the camera to be placed in front of the menu.
-tested_version: 8.36.04
-engine: Unity
-xr: OpenXR
-overport_extra:
- patch_disable_space_warp
-frame:
- frame.bhaptics_permission
- frame.vivox_audio_route
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-21'
-  known_good_sha256: 5760a135be2e2df634c78eae4f9d177b2a95a9da26a4739fdd6e1f5159ed9320
-  app: 1.3.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 109
-  issue: 456
-source_hint: Epic Roller Coasters
@@ -1,20 +0,0 @@
-package: io.github.spoopyghosty0.testquestmr
-title: Test Quest MR
-status: works
-notes: An MR debug viewer that shows what the Meta MR APIs return (room, planes, mesh, anchors, play area). With
-  FramePort's emulated room it shows a room made from the play area.
-tested_version: 0.2.1
-engine: Other
-xr: OpenXR
-frame:
- frame.meta_permissions
-adapter:
-  scene_emul: 1
-verified:
-  date: '2026-10-18'
-  known_good_sha256: 98936ca80d548a753a6645ab89610af19f6e8c3190b5f5f67854cf854691fba5
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 102
-source_hint: Test Quest MR
@@ -1,21 +0,0 @@
-package: jp.strippers.punchfit
-title: Punch Fit
-status: works
-tested_version: 1.7.2
-engine: Unity
-xr: OpenXR
-frame:
- frame.meta_permissions
- frame.unity_text_input
-adapter:
-  haptic_fix: 1
-  pose_time_fix: 1
-  scene_emul: 1
-  passthrough_emul: 1
-notes: Mixed reality workout arena; composition layer trimming prevents 21+ layer overflow.
-verified:
-  date: '2026-10-12'
-  known_good_sha256: 1a0050272526360542d62e7e6d1fc2daecb765c34378a6fe4ad51568ec550c0d
-source_hint: Punch Fit
-min_app: 1.2.2
-updated: '2026-10-18'
@@ -1,17 +1,17 @@
 package: org.primedgun.v2
 title: PrimedGun v2
-status: issues
-notes: 'Vulkan via a statically linked Khronos OpenXR loader, which bypasses FrameBridge (the picture jumps).
-  The embedded-loader patch is off for now: with it, the game''s loader and the one FramePort adds call each other
-  until the game crashes at Play (GitHub #254). Keep the Vulkan library rename disabled: this game assembles its
-  library name from two pieces, so renaming it prevented Vulkan from loading and VR could not start.'
+status: unknown
+notes: 'Vulkan via a statically linked Khronos OpenXR loader bypassed FrameBridge (GitHub #254).
+  The embedded-loader patch routes it through FrameBridge; device validation is still pending.
+  Keep the Vulkan library rename disabled: this game assembles its library name from two pieces,
+  so renaming it prevented Vulkan from loading and VR could not start. Not yet confirmed in the headset.'
 tested_version: 2.0.0-alpha.4
 engine: Other
 xr: OpenXR
 frame:
 - frame.sdl_clipboard
+- frame.static_openxr_loader
 frame_remove:
 - frame.vk_sanitize
- frame.static_openxr_loader
-updated: '2026-10-23'
+updated: '2026-10-18'
 source_hint: PrimedGun v2 Quest APK (github.com/iChris4/MetroidPrimePortVR)
@@ -6,47 +6,12 @@
 # with diagnostics. Launch tests and real play sessions (agent session_log, `frameport session`) are both matched.
 # Sources: every failure we hit porting 34 games to the Steam Frame (see docs/PLAYBOOK.md).
 signatures:
-  - id: mr-no-room
-    pattern: 'FrameBridge[^\r\n]*scene: (?:capture requested -> (?:guardian box|using guardian room)|room from guardian|room [^\r\n]*(?:from guardian|configured/default size|box))'
-    severity: info
-    diagnosis: 'The game is using a simple fallback room. Scan your room for mixed reality, or use Frame > Room > Use my play area for walls without furniture. A recorded scan can be imported until headset capture is available.'
-    suggest: []
-  - id: mr-discovery-unsupported
-    pattern: '(?:Unknown proc addr:\s*xrDiscoverSpacesMETA|(?:MRUK[^\r\n]*)?NoRoomsFound)'
-    # discovery reached FrameBridge and found the room (OVRPort's "Unknown proc addr" comes before the shim takes over)
-    unless: 'FrameBridge[^\r\n]*scene: discovery request=\d+ results=[1-9]'
-    severity: warning
-    diagnosis: 'The game cannot discover a Meta room. Enable room layout (adapter.scene_emul), rebuild and reinstall for the updated extension shim, then save a room under Frame > Room.'
-    suggest: [adapter.scene_emul]
-  - id: dynamic-resolution-foveation
-    pattern: 'projection view [01](?: rect change)?:[^\r\n]*rect=(?:[1-9]\d*,\d+|0,[1-9]\d*) '
-    unless: 'fixed_resolution: recommended'
-    severity: info
-    diagnosis: The game submits an offset projection viewport. With Valve foveation, dynamic resolution can move the sharp centre or expose a white edge. Keeping full resolution may help; it increases GPU load and needs the updated adapter and OVRPlugin shim in a rebuilt APK.
-    question: With foveated rendering enabled, was the sharp centre misplaced or was there a white line at the picture edge?
-    suggest: [adapter.fixed_resolution]
  - id: static-openxr-loader-bypass
    pattern: 'RuntimeManifestFile::FindManifestFiles - using global runtime file /[^\r\n]*etc/openxr/1/active_runtime(?:\.[A-Za-z0-9_-]+)?\.json'
    unless: 'FrameBridge[: ]|fp_xrruntime[: ]'
    severity: warning
    diagnosis: A Khronos loader loaded the system runtime without FrameBridge. A statically linked loader may bypass the bundled loader chain; analyze again, enable the embedded OpenXR loader patch when detected, then rebuild and reinstall to write its per-game manifest.
    suggest: [frame.static_openxr_loader]
-  - id: cryengine-init-failed
-    pattern: 'Cry\s*:[^\r\n]*Engine initialization failed![^\r\n]*CrySystem initialization failed'
-    severity: fatal
-    diagnosis: CryEngine's start-up failed (CrySystem initialization), and the crash that follows comes from its shutdown. FramePort 1.3.0 builds of The Climb 1/2 failed like this because a dormant diagnostic layer was linked into CryEngine's renderer; a newer FramePort leaves it out, so update FramePort and press Update on Frame. Otherwise attach the diagnostics zip to a report.
-    report: true
-    suggest: []
-  - id: questcraft-no-java-runtime
-    pattern: 'libjvm\.so[^\r\n]*(?:not found|No such file)'
-    severity: fatal
-    diagnosis: QuestCraft's Java runtime isn't there. QuestCraft downloads it only on Wi-Fi, and the Frame's Android reports its network as Ethernet, so the download was skipped. Rebuild with the pojlib connection fix (frame.pojlib_connection), or unpack QuestCraft's JRE.zip into the game's files/runtimes/JRE with the Files tab.
-    suggest: [frame.pojlib_connection]
-  - id: swapchain-limit-reached
-    pattern: 'FrameBridge:\s+xrCreateSwapchain [^\r\n]*\bresult=-10\b'
-    severity: error
-    diagnosis: The Frame runtime reached its swapchain count limit (about 15 live swapchains per session), not necessarily a memory limit. Extra menus or video panels may close or stay gray. Updated FramePort builds provide Share panel images (swapchain limit) for GLES apps; Vulkan apps are unaffected.
-    suggest: []
  - id: quest2-headset-identity
    pattern: 'venderId[^\r\n]*systemName Oculus Quest2'
    severity: info
@@ -116,7 +81,7 @@ signatures:
  - id: no-launcher
    pattern: 'APP_ACTIVITY is empty'
    severity: fatal
-    diagnosis: 'Nothing starts: Lepton found no entry point in the app (an activity with category LAUNCHER; one on an activity-alias alone does not count). Rebuild with the launcher fix (frame.launcher) and reinstall.'
+    diagnosis: 'Nothing starts: Lepton found no entry point in the app (an activity with category LAUNCHER).'
    suggest: [frame.launcher]
  - id: linux-x86-no-fex
    pattern: '(cannot execute binary file: Exec format error|exec format error)'
@@ -424,12 +389,8 @@ signatures:
    diagnosis: Frame controller models are on, but the converted models are missing from the game's files. The agent found no Frame controller render models in SteamVR at install time; see the install log, or run the agent's controller_models command.
    suggest: []
  - id: scene-missing
-    # not extension listings, which every Meta XR game prints: OVRPlugin's "Unavailable OpenXR extension:" and
-    # "Name=XR_FB_scene SpecVersion=1", OVRPort's "overportOXR: - XR_FB_scene 1", Unity's 'Meta XR Feature: ...
-    # Extensions="..."' (GitHub #404); XR_FB_scene_capture alone doesn't count either
-    pattern: '(?m)^(?!.*(?:Unavailable OpenXR extension: |Name=|overportOXR: - |Extensions=")).*XR_FB_scene\b|XR_FB_spatial_entity.*(not supported|UNSUPPORTED)|xrQuerySpacesFB'
-    # FrameBridge serves the room (OVRPort still lists XR_FB_scene and the shim names xrQuerySpacesFB): no finding
-    unless: 'FrameBridge[^\r\n]*scene: emulation active'
+    # not OVRPlugin's routine "Unavailable OpenXR extension: XR_FB_scene" (printed by every OVRPlugin game)
+    pattern: '(?<!Unavailable OpenXR extension: )XR_FB_scene|XR_FB_spatial_entity.*(not supported|UNSUPPORTED)|xrQuerySpacesFB'
    severity: warning
    diagnosis: The game wants Meta's room data (scene API), which the Frame lacks. The adapter can emulate a room from the guardian bounds.
    suggest: [adapter.scene_emul]
@@ -604,12 +565,6 @@ signatures:
    severity: fatal
    diagnosis: 'Games can''t start until the Frame restarts: it ran out of kernel keys. Rootless podman leaks one session keyring per container start; the FramePort agent sets keyring=false in ~/.config/containers/containers.conf, and a reboot frees the leaked keys.'
    suggest: []
-  - id: app-separate-process
-    pattern: 'Start proc \d+:[\w.]+:\w+/\S+ for (pre-)?top-activity'
-    severity: error
-    diagnosis: The game's activity runs in an Android process of its own, while Lepton watches only the app's main process, which never starts. About a minute in, Lepton decides the app "did not start" and closes it, wherever the game is. Newer FramePort versions run the activity in the main process (patch "Start the game in the app's main process"); update FramePort and use Update on Frame.
-    suggest: []
-    supersedes: [app-not-started, force-quit]
  - id: app-not-started
    pattern: 'Target app \(.*\) did not start'
    severity: error
@@ -146,23 +146,11 @@ pose (images drawn only after head turns, or ahead from xrWaitFrame and sometime
 lists its own `/sdcard/4XPlayer`, not Movies: agent v25 `link_media` hard-links sent files into an app's own top-level
 folder (`app_media_dirs`), `frameport frame send --app <pkg>`, GUI game page "Add videos" (players) / "Add videos &
 files…". A 4XVR webm stereo swapchain was refused with XR_ERROR_LIMIT_REACHED (-10) → right eye grey; our projection
-swapchain was originally halved (1536/eye) while investigating memory. Issue #387 below confirms a swapchain
-count cap; reducing image sizes does not avoid it. Frame data snapshot
+swapchain was halved (1536/eye) in case memory is the limit (unverified). Frame data snapshot
 (SteamVR runtimes, Lepton scripts, logs; never commit Valve binaries): `~/frameport-research/frame-data-2026-09-30/`.
 Not yet verified in the headset.


-**Issue #387 (2026-10-18, host-tested only):** 4XVR's extra sub-panels hit the session cap at roughly 15–16 live
-swapchains: the same 256×128 create succeeds then fails in the same millisecond, so shrinking images is not a fix.
-Default-off GLES `swapchain_pool` (catalog enabled for 4XVR) starts at eight live app runtime swapchains, reserving runtime
-headroom for up to two 4096² SRGB atlases. Single-face/layer/sample/mip colour images use private app-context textures;
-submitted panels are blitted into packed atlas rectangles after cylinder strips and rect_clamp. Destroy frees rectangles.
-Vulkan is untouched. No adapter revision bump: this opt-in fix should not mark every installed game for update.
-The new catalog key already makes older apps reject the recipe via `unusable_reason`; triage suggests no unknown setting.
-Headset check: repeatedly open/close all 4XVR submenus while playing stereo and 360 video, verify both eyes, panel crops,
-curved strips, alpha and frame pacing; confirm no new -10 errors or menu closures and reuse after closing panels.
-
-
 ## Companion apps / intents (Stremio + 4XVR)

 **Companion apps / intents (2026-10-03, tested with Stremio + 4XVR):** a second APK can be installed into a running
@@ -753,63 +741,6 @@ can be enabled and persist after restart. Check actual runtime refresh/pacing se
 identity alone does not implement refresh-rate support. Rebuild with Quest 2 for the control: original `Oculus Quest2`,
 original Quest 2 UUID, type 9 if logged, and previous option visibility. Also smoke-test a Unity OVRPlugin game
 with the default Quest 3 choice for regressions. No device access was used during implementation.
-
-## Mixed reality: scanned rooms
-
-Live floor coverage (agent v104) is enabled by default for manual and game-requested scans; the capture
-payload accepts `preview: false`, and `frameport frame room scan --no-preview` disables it. A world-locked,
-upward-facing 6 m square at floor height follows the current raw-to-STAGE calibration and stays centred on the
-scan's first recorded camera position. Every 16th depth vertex contributes to raw-space 10 cm voxels; at most once
-per second, newly occupied cells redraw a 256×256 RGBA map in one colour (FramePort's secondary blue), each cell a
-filled 10 cm square, only the opacity telling floor (<0.3 m, faint), raised surfaces (0.3–1.5 m) and tall surfaces
-(>1.5 m, strongest, the room's outline) apart; unseen transparent. Overlays have no depth (they draw over hands and
-passthrough), so the map stays faint; three colours in 3x3 blotches clashed in the owner's first run. It shows
-coverage, not a validated room boundary. IVROverlay_028 slots 1/3/20/22/33/43/62 (OpenVR 2.15.6 header)
-create/destroy/sort order (1, below the scan prompts' 10)/set width/set absolute STAGE transform/show/upload raw
-pixels. Each upload is 256 KiB (at most 256 KiB/s); timing for the first
-20 uploads and every tenth thereafter, plus failures, goes to `rooms/scans/scan-*.fprs.log` and the built room’s `scan.log`. Overlay errors or an
-upload taking over 50 ms disable the preview while capture continues; headset appearance and upload cost still
-need device validation.
-
-When an MR game asks for a room scan, FramePort scans in the headset and FrameBridge loads the new room before
-answering the game. If no scanner answers within five seconds, the game gets the stored room. Set
-`scene_scan_request=0` to always use the stored room. A scan that starts but fails keeps the old room and reports
-a capture failure to the game.
-
-**Mixed reality: scanned rooms (agent v92, 2026-10-16, branch mr-scene; docs/mr/):** Quest MR games read the room
-through Meta's scene APIs; the Frame offers none, and Valve's chaperone is no room (2D outline raised to 2.43 m, often
-the default 1 m circle -> the Android runtime's STAGE rect falls back to 1x1 m; XRService's plane detection is
-horizontal-only, its persistent map sparse ORB, its XRIPC single-client; cameras are XRService's alone,
-IVRTrackedCamera gives no frames). **The passthrough's RoomView 3D depth mesh is readable** (docs/mr/PHASE0.md:
-IVRBlockQueue_005 `/xrservice/roomview3d/meshData|meshLayout`, metadata through the C++ `IVRPaths_002` on the block
-handle, `meshIsUpToDate` on the queue handle; 132x128 fan, ~30/s; raw->standing moves during a session -> convert
-with the final one), so FramePort scans rooms itself: agent `room_capture` (Background/Overlay OpenVR app, prompts =
-artifacts/roomscan/*.png via IVROverlay_028 slots 1/3/20/22/35/43/44/63, `scripts/mr/render_prompts.py`) -> `.fprs`
-dump -> `fp_roomscan` (native/roomscan, freestanding, offline) -> `room.txt` + `room-mesh.bin`
-(docs/mr/ROOM_FORMAT.md; outline = positive shoelace in x-z, wall inward normal (-dz, dx)) in
-`~/.local/share/frameport/rooms/<universe>/`; launch.sh copies it next to settings.conf (`_room_sync`, games with
-`scene_emul`); FrameBridge (`scene_room.c/scene_meta.c/scene_anchors.c`) serves N walls, volumes (BOUNDED_3D),
-planes, GLOBAL_MESH (XR_META_spatial_entity_mesh), XR_META discovery/persistence (newer Meta SDKs and MRUK), anchors
-saved in `files/framebridge-anchors.txt`; all through xrshim (OVRPort's dispatcher drops unknown META calls).
-`scene_emul` is now suggested for every USE_SCENE/USE_ANCHOR_API game (migration `scene_emul_all`; NOPE and Pinball
-FX had none). PC: Frame page "Room" card, `frameport frame room scan|status|from-boundary|import|export|build|show`.
-Real data (owner's room, 2026-10-16): floor at 0, table surfaces, orthogonal walls found; the ceiling needs "look up".
-
-Scan on request (agent v103): scene-emulation launchers run `_scan_watch` alongside the game. FrameBridge's
-`framebridge-scan-request` in the game's external files directory gets an ack, then the existing prompted headset
-capture/build flow saves and copies the new room before an `ok` result; errors, cancellation and timeout return
-`failed`. Captures share a global lock, stale protocol files are cleared on launch, and the watcher stops with the
-launcher. Logs: `<base>/scan-watch.log`. Device validation is still required.
-
-PR #246 (@alicecatpaw, merged into mr-scene 2026-10-18): FrameBridge trims frames to maxLayerCount (Punch Fit sent
-21+ layers; projection layers and FrameBridge's fade quad always stay), drops quads with zero size or an empty image
-rect, and logs up to 10 quads with pose and swapchain. Two Unity patches, both only from a catalog recipe or the
-user's choice: `frame.meta_depth_occlusion` (Depth API occlusion off; Laser Dance's lasers vanished up close) and
-`frame.unity_scene_active_rooms` (OVRSceneManager's player-in-room check). The PR's own META discovery and boundary
-visibility code was replaced by this branch's (`scene_meta.c`). The PR's recipes were checked on the author's Frame
-only; open question: does OVRPort's dispatcher advertise XR_META_environment_depth (then a FrameBridge setting that
-hides it would fix depth occlusion for every engine).
-
 ## Vulkan pipelines refused: Fossilize and Turnip (Transformers, #349)

 Transformers Beyond Reality: Redux (Unreal, Vulkan) ended its first frames with Unreal's "Shader compilation failures
@@ -856,46 +787,6 @@ B -> B/X/Y, Menu -> View, plus trigger click -> bumper. Games with their own Val
 (Beat Saber, Batman, Accounting+, In Death, ...) use that file instead.


-## Fixed layer resolution / Batman (#406, #394)
-
-Batman: Arkham Shadow (`com.camouflaj.manta`, Unity + OVRPlugin, OpenXR/Vulkan) submits
-`2768x2768`, then corner-anchored `rect=0,32 2736x2736`, `rect=0,64 2704x2704` inside the
-same swapchain. On SteamOS 0.5.6 Valve's FDM injection covers the full swapchain: shrinking
-viewports can move the sharp centre towards the top right and expose a coarse white right edge.
-The runtime recommendation driving OVRPlugin's dynamic resolution remains unverified.
-
-`adapter.fixed_resolution=1` (default off, Batman recipe on) overrides
-`xrGetRecommendedLayerResolutionMETA`: tracked full swapchain dimensions, `isValid=XR_TRUE`.
-The existing rect_clamp size table already records successful xrCreateSwapchain calls and
-retires entries at destruction. Projection views must have matching sizes; quads are supported;
-unknown swapchains, mixed sizes and other layer types retain the runtime behavior. Submitted
-rectangles are never enlarged after rendering. Full resolution may increase GPU load.
-
-The cached OVRPort 3.4.3-aa54c3f dispatcher contains both the extension and function name
-(and a runtime-missing diagnostic). Its fixed routing table is not a guarantee that every
-version forwards the call unchanged. Enable the existing arm64 xrshim for this setting:
-OVRPlugin's loader lookup reaches `framebridge_extension_proc` directly, while native OpenXR
-loaders use the adapter's xrGetInstanceProcAddr hook. No extension hiding: keeping the
-recommendation API available avoids relying on an unverified OVRPlugin fallback. The adapter
-revision stays unchanged because the new setting is opt-in; the catalog requires 1.2.2 so older
-remote clients keep their bundled recipe (`recommend.catalog.unusable_reason`). Rebuild and
-reinstall Batman to receive the binary and shim routing; this is not a settings-only fix for
-an old APK. Device/headset verification is pending.
-
-Headless check: expect `extension shim: xrGetRecommendedLayerResolutionMETA -> FrameBridge`
-for OVRPlugin, then up to five `fixed_resolution: recommended WxH -> 2768x2768 (runtime=...)`
-lines. Compare the size to the actual eye swapchain creation log; scaling can change it.
-`projection view 0 rect change: ... rect=0,0 2768x2768` (and view 1) should remain full size
-through gameplay/loading transitions. Rect changes continue to log at most once per second
-per eye, comparing against the last logged state so a throttled final change is still shown.
-No recommendation logs means this API path was not exercised: do not claim the fix worked.
-Headset check: sharp region centred in both eyes, no white right edge, correct menus/loading
-fades, and acceptable pacing with full-resolution GPU load.
-
-This is separate from #303's `foveation_storage_fix` (clearing SUBSAMPLED allocation flags;
-see PLAYBOOK and FRAME_RUNTIME), which fixes black/coarse storage corruption. It also leaves
-#394's `FOVE_LEVEL=lo/med/hi` presets intact (commits 01ad5e6b, d7f0d514): those select the
-full-swapchain density pattern, not the game's dynamic viewport.
 ## Embedded Khronos OpenXR loaders (GitHub #254)

 PrimedGun v2 (`org.primedgun.v2`, 2.0.0-alpha.4) embeds the Khronos loader in
@@ -920,7 +811,7 @@ need analysis/rewrite support before they can be patched.

 Both broker authorities become `org.fp_null.openxr.*`, causing provider lookup to
 fail and the loader to fall back to files even if a broker is later installed.
-Only the game's copy is changed. Agent v108 writes both manifest spellings into
+Only the game's copy is changed. Agent v103 writes both manifest spellings into
 `<base>/lepton-data/external` (the game's private `/sdcard`), records
 `static_openxr_loader` in deployment.json, and repairs them before every launch.
 Launcher upgrades preserve that repair. A configuration-only finalize also writes
@@ -952,16 +843,6 @@ layouts, idempotence, unchanged other bytes, APK apply/validate with no OVRPort,
 negotiation rejection, Android init forwarding and missing-chain failure. No Frame
 connection or device test was performed.

-**Crash at Play (GitHub #254, 2026-10-23):** the reporter's 1.3.0 build crashed right after `xrCreateInstance`
-(stack overflow in SDLThread: FrameBridge GIPA → `libopenxr_loader_original.so` → the game's library → FrameBridge
-…). Lepton mounts Valve's implicit layer manifest at `/vendor/etc/openxr/1/api_layers/implicit.d/`, and the log shows
-`XR_APILAYER_VALVE_fdm_injection` loaded by BOTH loaders: one shared layer library stacked into two chains, so the
-inner chain's next call landed in the game loader's code. The rewrite now also turns the game loader's implicit-layer
-suffix `/api_layers/implicit.d` into `/api_layers/fp_none.d` (Khronos builds `<partition>/etc` + `openxr/1` + suffix),
-so only FrameBridge's inner loader loads implicit layers, as in every other FramePort game (patch revision 2). Not
-device-verified: headless, PrimedGun stays in its own launcher without the game's disc image, so the catalog keeps
-the patch off until a headset check.
-
 Headless acceptance after rebuilding and installing with this development build:
 `uv run frameport test org.primedgun.v2`. Expect `fp_xrruntime: chain resolved:
 FrameBridge`, `fp_xrruntime: xrInitializeLoaderKHR forwarded to FrameBridge: 0`,
@@ -66,53 +66,6 @@
  `launch.sh` at the new folder and only then deletes the old copy; on the same filesystem it renames instead.
  Moving a game whose Lepton data holds absolute paths, or a PC VR prefix, is not yet verified on the device.

-## Room data
-
-Live floor coverage (agent v104) is enabled by default for manual and game-requested scans; the capture
-payload accepts `preview: false`, and `frameport frame room scan --no-preview` disables it. A world-locked,
-upward-facing 6 m square at floor height follows the current raw-to-STAGE calibration and stays centred on the
-scan's first recorded camera position. Every 16th depth vertex contributes to raw-space 10 cm voxels; at most once
-per second, newly occupied cells redraw a 256×256 RGBA map in one colour (FramePort's secondary blue), each cell a
-filled 10 cm square, only the opacity telling floor (<0.3 m, faint), raised surfaces (0.3–1.5 m) and tall surfaces
-(>1.5 m, strongest, the room's outline) apart; unseen transparent. Overlays have no depth (they draw over hands and
-passthrough), so the map stays faint; three colours in 3x3 blotches clashed in the owner's first run. It shows
-coverage, not a validated room boundary. IVROverlay_028 slots 1/3/20/22/33/43/62 (OpenVR 2.15.6 header)
-create/destroy/sort order (1, below the scan prompts' 10)/set width/set absolute STAGE transform/show/upload raw
-pixels. Each upload is 256 KiB (at most 256 KiB/s); timing for the first
-20 uploads and every tenth thereafter, plus failures, goes to `rooms/scans/scan-*.fprs.log` and the built room’s `scan.log`. Overlay errors or an
-upload taking over 50 ms disable the preview while capture continues; headset appearance and upload cost still
-need device validation.
-
- SteamVR on the Frame has no Meta scene/anchor extensions. Its chaperone supplies only a 2D outline raised to
-  2.43 m, without furniture, ceiling or a room mesh. Valve's default boundary is a 20-point circle of roughly 1 m
-  radius; FramePort refuses to treat it as a room.
- FrameBridge's `scene_emul=1` serves saved room data, with a guardian box when no room is available. OVRPort's
-  loader only dispatches functions in its own table: newer Meta entry points go through FramePort's extension shim.
-  MRUK uses discovery (`xrDiscoverSpacesMETA`, older versions `xrQuerySpacesFB`) and requests Space Setup when
-  discovery returns no rooms. Volumes hang below their top-face anchor in Meta's coordinate convention.
- Room files use STAGE coordinates (metres, +Y up, floor y=0, -Z forward). The format contract is
-  [mr/ROOM_FORMAT.md](mr/ROOM_FORMAT.md). On the Frame: `~/.local/share/frameport/rooms/<universe>/room.txt`,
-  optional `room-mesh.bin` and `scan.log`; `rooms/current` points to the most recently saved room.
- A room belongs to its chaperone universe. The agent reads the last universe switch from `vrserver.txt`, falling
-  back to the newest universe in `~/.config/openvr/config/chaperone_info.vrchap`; dummy 424242 means none.
-  A matching room is selected first, else `current`; the app reports `aligned: false` after a universe change.
- Quest launchers copy that room beside `settings.conf` before Lepton starts; FrameBridge reads
-  `dirname($FRAMEBRIDGE_CONFIG)/room.txt`. Stale copies are removed if no room exists or emulation is disabled.
-  Each game's persistent anchors stay in `/sdcard/Android/data/<pkg>/files/framebridge-anchors.txt`.
- With `scene_emul`, launch.sh starts `_scan_watch <pkg>` after Lepton, closing fd 9; its exit trap stops the
-  watcher, which also exits if the launcher disappears. It polls once a second and logs to `<base>/scan-watch.log`.
-  In `<base>/lepton-data/external/Android/data/<pkg>/files/`, FrameBridge writes `framebridge-scan-request`
-  (`request <id> <unix_seconds>`); the watcher clears stale request/ack/result files at startup, writes
-  `framebridge-scan-ack` (`ack <id>`), reuses the headset capture/build worker, stores the current room and copies
-  it beside settings.conf before atomically writing `framebridge-scan-result` (`ok <id>` or `failed <id> <reason>`).
-  A global `rooms/.scan.lock` excludes concurrent captures, including manual scans; `rooms/.lock` still protects
-  room publication. Launcher exit cancels the scan; a 350-second deadline leaves time for the six-minute protocol timeout.
- Frame → Room and `frameport frame room` manage rooms. `from-boundary` creates walls without furniture;
-  `import` / `export` transfer room files; `show` writes an SVG preview; `build <dump.fprs>` syncs the bundled
-  `fp_roomscan` by SHA-256 and runs it on the Frame with `--offline`. `scan` = agent `room_capture`: records the
-  RoomView meshes (`/xrservice/roomview3d/meshData` + `/meshLayout`, `IVRBlockQueue_005`) while in-headset prompts
-  guide the player, then builds the room from that recording.
-
 ## Save backups (Quest games, agent v101, discussion #352)
 - A Lepton game's saves are two folders of `<base>/lepton-data`: `internal/<pkg>` (= `/data/data/<pkg>`:
  `shared_prefs/`, `files/`, `databases/`; Unreal's `files/UE4Game|UnrealGame/.../Saved` often lives here) and
@@ -42,7 +42,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Creed | Quest | ✅ Works |  |
 | Crisis Zone VR | Quest | ✅ Works |  |
 | cubism | Quest | ✅ Works |  |
-| cubism | Quest | ✅ Works |  |
 | Dance Central | Quest | ✅ Works |  |
 | Deep Cuts | Quest | ✅ Works |  |
 | Demeo | Quest | ✅ Works |  |
@@ -67,7 +66,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Gravity Lab | Quest | ✅ Works |  |
 | Gunjack | Quest | ✅ Works |  |
 | H.U.N.T | Quest | ✅ Works |  |
-| Hitstream | Quest | ✅ Works |  |
 | I Am Cat | Quest | ✅ Works |  |
 | I Am Monkey | Quest | ✅ Works |  |
 | I Expect You To Die 2 | Quest | ✅ Works |  |
@@ -79,10 +77,8 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Jurassic World Aftermath Collection | Quest | ✅ Works |  |
 | Keep Talking and Nobody Explodes | Quest | ✅ Works |  |
 | Kill It With Fire VR | Quest | ✅ Works |  |
-| KillerFrequency | Quest | ✅ Works |  |
 | Ladder | Quest | ✅ Works |  |
 | Lambda1VR | Quest | ✅ Works |  |
-| Laser Dance | Quest | ✅ Works |  |
 | LEGO® Bricktales | Quest | ✅ Works |  |
 | Lost Recipes | Quest | ✅ Works |  |
 | Lucky's Tale | Quest | ✅ Works |  |
@@ -111,7 +107,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Pistol Whip | PC VR | ✅ Works |  |
 | Please Don't Touch Anything | Quest | ✅ Works |  |
 | PowerWash Simulator VR | Quest | ✅ Works |  |
-| Punch Fit | Quest | ✅ Works |  |
 | QuestCraft | Quest | ✅ Works |  |
 | Racket: Nx | Quest | ✅ Works |  |
 | RacketPinball | Quest | ✅ Works |  |
@@ -149,7 +144,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Taskmaster | Quest | ✅ Works |  |
 | Tea For God | Quest | ✅ Works |  |
 | Test Quest Controllers | Quest | ✅ Works |  |
-| Test Quest MR | Quest | ✅ Works |  |
 | TetrisEffect | Quest | ✅ Works |  |
 | The Boys VR | Quest | ✅ Works |  |
 | The Climb | Quest | ✅ Works |  |
@@ -198,7 +192,7 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Majora's Mask VR | Quest | ⚠️ Works with issues | Audio on the file select screen sounds crunchy. |
 | Myst | Quest | ⚠️ Works with issues | Minor graphical glitches on some objects. |
 | Phantom: Covert Ops | Quest | ⚠️ Works with issues | DLC/store button crashes (no Meta store). |
-| Pinball FX VR | Quest | ⚠️ Works with issues | Plays; space warp off (fewer stutters). |
+| Pinball FX VR | Quest | ⚠️ Works with issues | Plays; mixed reality mode not working yet. |
 | Plezy | Quest | ⚠️ Works with issues | Some videos play with strong artifacts and wrong colours; the cause is unknown, possibly hardware video decoding. |
 | Puzzling Places | Quest | ⚠️ Works with issues | Works fine, but pointers dont show well on main menu, easy to work around. |
 | Quantum Void | Quest | ⚠️ Works with issues | no hands |
@@ -183,29 +183,6 @@ Website owners: see [Install button](INSTALL_BUTTON.md).
  so stop it when you're done.
 - **Screenshots** shows the screenshots you took in the headset, sorted by game and day, to view or download.

-## Your room (mixed reality, experimental)
-
-Mixed-reality games ask for your room: walls, furniture and its surfaces. **Room** (in the sidebar) keeps it:
-
- **Scan room in the headset**, then put the headset on with passthrough and look around for about a minute; the tab
-  shows how far the scan is. **Cancel scan** stops it and keeps your saved room. **Use my play area** makes walls from
-  the SteamVR play area instead (no furniture).
- The room shows in 3D: drag to turn it, scroll to zoom, right-drag to move it, double-click to see all of it.
-  **Open full 3D view** shows every detail of the scan in your browser (a page on this PC only).
- **Clean-up** tidies every scan (flat walls, no scan behind walls or where you walked, no loose bits). The
-  recommended settings suit most rooms; change them (**More settings** has all of them) and press **Apply** to clean
-  up your saved scan again. Your settings are also used for your next scans.
- **Labels** shows what the scanner's boxes became and why. A tall, thin box by a wall can be **Add as door** or
-  **Add as closet**.
- **Furniture & screens**: pick a box in the list or click it in the 3D view to change its type, place or size, add
-  or delete boxes, and add doors and windows on a wall. **Save** sends them to the Frame; they stay when you clean up
-  the scan again (**Back to the scan's boxes** under Labels drops them).
- The free **Test Quest MR** app (Get Test Quest MR on the tab) shows what a game receives from your scan.
-
-![Room](images/room.png)
-
-![Room: a box picked to edit, and the labels of the clean-up](images/room-editing.png)
-
 ## Updating

 FramePort checks for a new version at start and every 6 hours. When there is one, the Library shows **Update now**:
@@ -2,7 +2,7 @@

 # Patches

-Every patch and game setting FramePort knows: 195 entries in 5 groups. A game's recipe is its chosen patches and settings; tested games get theirs from the catalog ([GAMES.md](GAMES.md)), and other games get the patches FramePort suggests from its analysis. You change them on the game page under Customize.
+Every patch and game setting FramePort knows: 187 entries in 5 groups. A game's recipe is its chosen patches and settings; tested games get theirs from the catalog ([GAMES.md](GAMES.md)), and other games get the patches FramePort suggests from its analysis. You change them on the game page under Customize.

 Each entry says what the patch does, whether it changes the APK or only the install, when FramePort suggests it, its options, the catalog games whose recipe names it and the launch-test signatures that suggest it. Patches that are on by default are on for every game, so the catalog rarely names them.

@@ -11,8 +11,8 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 ## Groups

 - [Patches from OVRPort](#group-overport) (25)
- [Steam Frame patches](#group-frame) (66)
- [Game settings](#group-adapter) (81)
+- [Steam Frame patches](#group-frame) (62)
+- [Game settings](#group-adapter) (77)
 - [Files and settings on the Frame](#group-device) (10)
 - [PC VR (Proton and Revive)](#group-pcvr) (13)

@@ -27,7 +27,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Copy OVRPlugin if VrApi is present](#patch_copy_ovrplugin_vrapi) | `patch_copy_ovrplugin_vrapi` | Patches from OVRPort | default |
 | [Disable controller tracking offset](#patch_disable_controller_offset) | `patch_disable_controller_offset` | Patches from OVRPort |  |
 | [Disable Meta XR Audio telemetry](#patch_disable_meta_xr_audio_telemetry) | `patch_disable_meta_xr_audio_telemetry` | Patches from OVRPort |  |
-| [Disable application space warp if used](#patch_disable_space_warp) | `patch_disable_space_warp` | Patches from OVRPort | 5 |
+| [Disable application space warp if used](#patch_disable_space_warp) | `patch_disable_space_warp` | Patches from OVRPort | 4 |
 | [Fix minimal Android SDK](#patch_fix_min_android_sdk) | `patch_fix_min_android_sdk` | Patches from OVRPort | default |
 | [Fix UE4 crash with Unity stub](#patch_fix_unreal_crash) | `patch_fix_unreal_crash` | Patches from OVRPort | default |
 | [Force enable passthrough](#patch_force_passthrough) | `patch_force_passthrough` | Patches from OVRPort | 3 |
@@ -39,7 +39,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Patch Oculus detection for Unity](#patch_oculus_unity) | `patch_oculus_unity` | Patches from OVRPort | default |
 | [Patch Oculus detection for Unreal](#patch_oculus_unreal) | `patch_oculus_unreal` | Patches from OVRPort | default |
 | [Remove localized app names](#patch_remove_localized_names) | `patch_remove_localized_names` | Patches from OVRPort | default |
-| [Remove Unreal's ForceQuit](#patch_remove_unreal_force_quit) | `patch_remove_unreal_force_quit` | Patches from OVRPort | 49 |
+| [Remove Unreal's ForceQuit](#patch_remove_unreal_force_quit) | `patch_remove_unreal_force_quit` | Patches from OVRPort | 46 |
 | [Remove uses-library](#patch_remove_uses_library) | `patch_remove_uses_library` | Patches from OVRPort | default |
 | [Remove VrApi library](#patch_remove_vrapi) | `patch_remove_vrapi` | Patches from OVRPort |  |
 | [Replace application label and icon](#patch_replace_icon_label) | `patch_replace_icon_label` | Patches from OVRPort | default |
@@ -50,63 +50,59 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Content files from the game's data](#frame-asset_files) | `frame.asset_files` | Steam Frame patches | 2 |
 | [Asset-file service bypass](#frame-asset_files_stub) | `frame.asset_files_stub` | Steam Frame patches |  |
 | [Skip Meta avatars](#frame-avatar_stub) | `frame.avatar_stub` | Steam Frame patches | 1 |
-| [bHaptics: skip the Bluetooth permission request](#frame-bhaptics_permission) | `frame.bhaptics_permission` | Steam Frame patches | 9 |
+| [bHaptics: skip the Bluetooth permission request](#frame-bhaptics_permission) | `frame.bhaptics_permission` | Steam Frame patches | 6 |
 | [BlazeRush: controllers without Meta avatars, own shader cache](#frame-blazerush) | `frame.blazerush` | Steam Frame patches | 1 |
 | [Cortopia games: don't wait for Meta's org-scoped id](#frame-cortopia_org_id) | `frame.cortopia_org_id` | Steam Frame patches | 1 |
 | [Epic Online Services: stop the keychain retry loop](#frame-eos_keychain_loop) | `frame.eos_keychain_loop` | Steam Frame patches |  |
 | [OpenGL ES: multiview shaders on flat panels (HUD, menus)](#frame-gl_multiview_fbo) | `frame.gl_multiview_fbo` | Steam Frame patches | 1 |
 | [GL shim (Mesa GLSL compatibility)](#frame-gl_shim) | `frame.gl_shim` | Steam Frame patches | 2 |
-| [Play services: Android 11 version checks](#frame-gms_platform_version) | `frame.gms_platform_version` | Steam Frame patches | 2 |
+| [Play services: Android 11 version checks](#frame-gms_platform_version) | `frame.gms_platform_version` | Steam Frame patches | 1 |
 | [Godot apps: start without a clipboard service](#frame-godot_clipboard) | `frame.godot_clipboard` | Steam Frame patches | 1 |
-| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 40 |
+| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 34 |
 | [Language packs from the game's files](#frame-langpacks) | `frame.langpacks` | Steam Frame patches |  |
 | [Launcher category (INFO → LAUNCHER)](#frame-launcher) | `frame.launcher` | Steam Frame patches | default |
 | [GL wrapper: OpenGL ES depth formats (Minecraft)](#frame-ltw_depth) | `frame.ltw_depth` | Steam Frame patches | default |
 | [Fix Lua startup crashes on Frame](#frame-luajit_pointers) | `frame.luajit_pointers` | Steam Frame patches | 1 |
-| [Start the game in the app's main process](#frame-main_process) | `frame.main_process` | Steam Frame patches | default |
-| [Unity: disable Meta depth occlusion](#frame-meta_depth_occlusion) | `frame.meta_depth_occlusion` | Steam Frame patches | 1 |
-| [Declare Meta-only permissions](#frame-meta_permissions) | `frame.meta_permissions` | Steam Frame patches | 8 |
+| [Declare Meta-only permissions](#frame-meta_permissions) | `frame.meta_permissions` | Steam Frame patches | 4 |
 | [Meta XR Audio: skip Quest telemetry class](#frame-metaxr_telemetry) | `frame.metaxr_telemetry` | Steam Frame patches | default |
 | [Clear android:debuggable](#frame-nodebug) | `frame.nodebug` | Steam Frame patches | 3 |
-| [Oculus OS telemetry class stubs](#frame-oculusos) | `frame.oculusos` | Steam Frame patches | 18 |
+| [Oculus OS telemetry class stubs](#frame-oculusos) | `frame.oculusos` | Steam Frame patches | 17 |
 | [Fix crash when the game prepares the microphone](#frame-ovr_microphone) | `frame.ovr_microphone` | Steam Frame patches | 1 |
 | [Keep the same Meta user between starts](#frame-ovr_stable_user) | `frame.ovr_stable_user` | Steam Frame patches | default |
 | [Trace Meta platform requests (diagnostics)](#frame-ovr_trace) | `frame.ovr_trace` | Steam Frame patches |  |
 | [Platform compat (ovrMessageType_ToString)](#frame-ovrplatformcompat) | `frame.ovrplatformcompat` | Steam Frame patches | default |
 | [Stub missing Meta platform functions](#frame-ovrstubs) | `frame.ovrstubs` | Steam Frame patches | default |
 | [Unpaired pointer-authentication checks](#frame-pac_hints) | `frame.pac_hints` | Steam Frame patches | 1 |
-| [Photon Voice: skip Android 12 audio routing](#frame-photon_voice_audio_route) | `frame.photon_voice_audio_route` | Steam Frame patches | 2 |
-| [QuestCraft: count the Frame's network as online](#frame-pojlib_connection) | `frame.pojlib_connection` | Steam Frame patches | 1 |
-| [SDL apps: start without a clipboard service](#frame-sdl_clipboard) | `frame.sdl_clipboard` | Steam Frame patches | 8 |
+| [Photon Voice: skip Android 12 audio routing](#frame-photon_voice_audio_route) | `frame.photon_voice_audio_route` | Steam Frame patches | 1 |
+| [SDL apps: start without a clipboard service](#frame-sdl_clipboard) | `frame.sdl_clipboard` | Steam Frame patches | 6 |
 | [Stress Level Zero: let Unity start Vulkan itself](#frame-slz_vulkan_hooks) | `frame.slz_vulkan_hooks` | Steam Frame patches | 1 |
 | [Start straight in VR (skip the 2D launcher)](#frame-start_activity) | `frame.start_activity` | Steam Frame patches |  |
-| [Embedded OpenXR loader: use FrameBridge](#frame-static_openxr_loader) | `frame.static_openxr_loader` | Steam Frame patches |  |
+| [Embedded OpenXR loader: use FrameBridge](#frame-static_openxr_loader) | `frame.static_openxr_loader` | Steam Frame patches | 1 |
 | [Allow swapchains larger than 4096 px](#frame-swapchain_limit) | `frame.swapchain_limit` | Steam Frame patches | default |
-| [Team Beef ports: treat the Frame as a Meta headset](#frame-tbxr_vendor) | `frame.tbxr_vendor` | Steam Frame patches | 2 |
+| [Team Beef ports: treat the Frame as a Meta headset](#frame-tbxr_vendor) | `frame.tbxr_vendor` | Steam Frame patches | 1 |
 | [Unity App UI: no Android 12 vibrator](#frame-unity_appui_vibrator) | `frame.unity_appui_vibrator` | Steam Frame patches |  |
-| [GL shim for Unity (no multisampled render-to-texture)](#frame-unity_gl_shim) | `frame.unity_gl_shim` | Steam Frame patches | 27 |
+| [GL shim for Unity (no multisampled render-to-texture)](#frame-unity_gl_shim) | `frame.unity_gl_shim` | Steam Frame patches | 26 |
 | [Unity: render each eye separately (no multiview)](#frame-unity_multipass) | `frame.unity_multipass` | Steam Frame patches | 2 |
-| [Unity: disable MSAA](#frame-unity_no_msaa) | `frame.unity_no_msaa` | Steam Frame patches | 11 |
+| [Unity: disable MSAA](#frame-unity_no_msaa) | `frame.unity_no_msaa` | Steam Frame patches | 10 |
 | [Unity: skip OVROverlay layers (fades, splash screens)](#frame-unity_no_overlay_copy) | `frame.unity_no_overlay_copy` | Steam Frame patches | 2 |
 | [Unity: start VR without Meta's system apps](#frame-unity_oculus_check) | `frame.unity_oculus_check` | Steam Frame patches | 14 |
-| [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 33 |
-| [Unity: skip Meta's player-in-room check](#frame-unity_scene_active_rooms) | `frame.unity_scene_active_rooms` | Steam Frame patches | 1 |
-| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 130 |
+| [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 32 |
+| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 118 |
 | [Unity: share thread keys (games that run out of them)](#frame-unity_tls_key_pool) | `frame.unity_tls_key_pool` | Steam Frame patches | 1 |
 | [Unity: headset always counts as worn](#frame-unity_user_presence) | `frame.unity_user_presence` | Steam Frame patches | 1 |
 | [GL shim for Unreal (no multisampled render-to-texture)](#frame-unreal_gl_shim) | `frame.unreal_gl_shim` | Steam Frame patches | 1 |
 | [Unreal: match multiview depth to the eye size](#frame-unreal_multiview_depth) | `frame.unreal_multiview_depth` | Steam Frame patches | 1 |
 | [Unreal: reserve memory like on Quest](#frame-unreal_noreserve) | `frame.unreal_noreserve` | Steam Frame patches |  |
-| [Unreal: stand-ins for OVRPlugin functions OVRPort lacks](#frame-unreal_ovrp_entrypoints) | `frame.unreal_ovrp_entrypoints` | Steam Frame patches | 6 |
+| [Unreal: stand-ins for OVRPlugin functions OVRPort lacks](#frame-unreal_ovrp_entrypoints) | `frame.unreal_ovrp_entrypoints` | Steam Frame patches | 3 |
 | [Unreal: Quest controller bindings (RPOC key map)](#frame-unreal_quest_keymap) | `frame.unreal_quest_keymap` | Steam Frame patches | 3 |
 | [Unreal: don't wait for the Quest shader precompile](#frame-unreal_quest_precompile) | `frame.unreal_quest_precompile` | Steam Frame patches | 3 |
-| [Unreal: start without the OBB check](#frame-unreal_skip_obb_check) | `frame.unreal_skip_obb_check` | Steam Frame patches | 10 |
+| [Unreal: start without the OBB check](#frame-unreal_skip_obb_check) | `frame.unreal_skip_obb_check` | Steam Frame patches | 9 |
 | [Unreal: skip the OBB delivery check](#frame-unreal_skip_obb_delivery) | `frame.unreal_skip_obb_delivery` | Steam Frame patches | 1 |
 | [Unreal: bypass the stalled loading splash](#frame-unreal_splash_bypass) | `frame.unreal_splash_bypass` | Steam Frame patches | 1 |
 | [Unreal: thumb follows the capacitive touches](#frame-unreal_thumb_touch) | `frame.unreal_thumb_touch` | Steam Frame patches | 8 |
 | [USB MIDI: don't poll for USB devices](#frame-usb_midi_watcher) | `frame.usb_midi_watcher` | Steam Frame patches |  |
 | [Vermillion: paint canvases in the scene](#frame-vermillion_scene_canvas) | `frame.vermillion_scene_canvas` | Steam Frame patches | 1 |
-| [Vivox voice chat: skip Android 12 audio routing](#frame-vivox_audio_route) | `frame.vivox_audio_route` | Steam Frame patches | 4 |
+| [Vivox voice chat: skip Android 12 audio routing](#frame-vivox_audio_route) | `frame.vivox_audio_route` | Steam Frame patches | 3 |
 | [Vulkan: drop invalid render-pass pointers](#frame-vk_sanitize) | `frame.vk_sanitize` | Steam Frame patches | default · 1 |
 | [VrApi → OpenXR bridge](#frame-vrapi_bridge) | `frame.vrapi_bridge` | Steam Frame patches | 4 |
 | [Quiet Meta's VrApi loader (OpenXR games)](#frame-vrapi_stub) | `frame.vrapi_stub` | Steam Frame patches | 2 |
@@ -116,12 +112,12 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Pointer angle](#adapter-aim_pitch) | `adapter.aim_pitch` | Game settings |  |
 | [Pointer turn](#adapter-aim_yaw) | `adapter.aim_yaw` | Game settings |  |
 | [Fix inside-out mixed reality](#adapter-alpha_blend_emul) | `adapter.alpha_blend_emul` | Game settings |  |
-| [Use controllers](#adapter-controller_fix) | `adapter.controller_fix` | Game settings | 2 |
-| [Show Steam Frame controllers](#adapter-controller_models) | `adapter.controller_models` | Game settings | 8 |
+| [Use controllers](#adapter-controller_fix) | `adapter.controller_fix` | Game settings | 1 |
+| [Show Steam Frame controllers](#adapter-controller_models) | `adapter.controller_models` | Game settings | 6 |
 | [Show cube loading screens](#adapter-cube_quads) | `adapter.cube_quads` | Game settings |  |
 | [Stand in for cube layers](#adapter-cube_standin) | `adapter.cube_standin` | Game settings |  |
 | [Show curved menus and screens](#adapter-cylinder_strips) | `adapter.cylinder_strips` | Game settings |  |
-| [Show 360° backgrounds and videos](#adapter-equirect_emul) | `adapter.equirect_emul` | Game settings | 9 |
+| [Show 360° backgrounds and videos](#adapter-equirect_emul) | `adapter.equirect_emul` | Game settings | 7 |
 | [360° detail](#adapter-equirect_face) | `adapter.equirect_face` | Game settings |  |
 | [360° picture orientation](#adapter-equirect_flip) | `adapter.equirect_flip` | Game settings |  |
 | [360° video frame rate limit](#adapter-equirect_fps) | `adapter.equirect_fps` | Game settings |  |
@@ -130,7 +126,6 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Per-eye diagnostics (log)](#adapter-eye_debug) | `adapter.eye_debug` | Game settings |  |
 | [Draw fades over the picture](#adapter-fade_quad) | `adapter.fade_quad` | Game settings | 2 |
 | [Colour space support](#adapter-fb_color_space) | `adapter.fb_color_space` | Game settings |  |
-| [Keep full resolution (no dynamic resolution)](#adapter-fixed_resolution) | `adapter.fixed_resolution` | Game settings | 1 |
 | [Upside-down panel images (diagnostics)](#adapter-flip_dump) | `adapter.flip_dump` | Game settings |  |
 | [Fix upside-down menus](#adapter-flip_emul) | `adapter.flip_emul` | Game settings |  |
 | [Rotate panels 180°](#adapter-flip_quads) | `adapter.flip_quads` | Game settings |  |
@@ -143,7 +138,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [GL shim: high-precision vertex shaders](#adapter-gl_highp_markers) | `adapter.gl_highp_markers` | Game settings | 1 |
 | [GL shim: integer vertex inputs](#adapter-gl_int_attribs) | `adapter.gl_int_attribs` | Game settings | 1 |
 | [Flat panel diagnostics (log)](#adapter-gl_mv_debug) | `adapter.gl_mv_debug` | Game settings |  |
-| [Fix freezes when controllers vibrate](#adapter-haptic_fix) | `adapter.haptic_fix` | Game settings | 116 |
+| [Fix freezes when controllers vibrate](#adapter-haptic_fix) | `adapter.haptic_fix` | Game settings | 103 |
 | [Vibration strength](#adapter-haptic_scale) | `adapter.haptic_scale` | Game settings |  |
 | [Turn off Quest Vulkan foveation](#adapter-hide_fb_foveation) | `adapter.hide_fb_foveation` | Game settings |  |
 | [Turn off space warp](#adapter-hide_space_warp) | `adapter.hide_space_warp` | Game settings | 5 |
@@ -153,23 +148,21 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Vulkan format workaround](#adapter-mutable_fix) | `adapter.mutable_fix` | Game settings |  |
 | [Unity frame loop: wait for skipped frames](#adapter-ovrp_begin_gate) | `adapter.ovrp_begin_gate` | Game settings | 1 |
 | [Steadier hands (older Unity)](#adapter-ovrp_hold_physics) | `adapter.ovrp_hold_physics` | Game settings | 1 |
-| [See your room](#adapter-passthrough_emul) | `adapter.passthrough_emul` | Game settings | 2 |
+| [See your room](#adapter-passthrough_emul) | `adapter.passthrough_emul` | Game settings |  |
 | [Steadier head tracking](#adapter-pose_consistency) | `adapter.pose_consistency` | Game settings | 2 |
 | [Pose timing diagnostics (log)](#adapter-pose_debug) | `adapter.pose_debug` | Game settings |  |
-| [Fix hands lagging behind controllers](#adapter-pose_time_fix) | `adapter.pose_time_fix` | Game settings | 17 |
+| [Fix hands lagging behind controllers](#adapter-pose_time_fix) | `adapter.pose_time_fix` | Game settings | 16 |
 | [Treat newer Quest controllers as Touch](#adapter-profile_remap) | `adapter.profile_remap` | Game settings |  |
 | [Animate fingers from touch](#adapter-proximity_emul) | `adapter.proximity_emul` | Game settings |  |
 | [Controller buttons](#adapter-quest_buttons) | `adapter.quest_buttons` | Game settings |  |
 | [Keep pictures in bounds](#adapter-rect_clamp) | `adapter.rect_clamp` | Game settings |  |
-| [Refresh rate](#adapter-refresh_rate) | `adapter.refresh_rate` | Game settings | 5 |
+| [Refresh rate](#adapter-refresh_rate) | `adapter.refresh_rate` | Game settings | 3 |
 | [Wait for the game's GPU](#adapter-release_wait) | `adapter.release_wait` | Game settings |  |
 | [Re-create play space](#adapter-respace_kick) | `adapter.respace_kick` | Game settings |  |
-| [Render resolution (supersampling)](#adapter-scale) | `adapter.scale` | Game settings | 18 |
+| [Render resolution (supersampling)](#adapter-scale) | `adapter.scale` | Game settings | 14 |
 | [Room depth](#adapter-scene_depth) | `adapter.scene_depth` | Game settings |  |
-| [Use room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 19 |
+| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 12 |
 | [Room height](#adapter-scene_height) | `adapter.scene_height` | Game settings |  |
-| [Hide play-area size](#adapter-scene_hide_bounds) | `adapter.scene_hide_bounds` | Game settings | 1 |
-| [Scan when requested](#adapter-scene_scan_request) | `adapter.scene_scan_request` | Game settings |  |
 | [Room width](#adapter-scene_width) | `adapter.scene_width` | Game settings |  |
 | [Eye-image snapshots (diagnostics)](#adapter-snapshot) | `adapter.snapshot` | Game settings |  |
 | [Keep menus in place](#adapter-stable_local) | `adapter.stable_local` | Game settings | 1 |
@@ -179,7 +172,6 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Native video surfaces (Batman renderer)](#adapter-surface_native) | `adapter.surface_native` | Game settings | 1 |
 | [Swap eyes](#adapter-swap_eyes) | `adapter.swap_eyes` | Game settings |  |
 | [Retry refused picture formats](#adapter-swapchain_fix) | `adapter.swapchain_fix` | Game settings |  |
-| [Share panel images (swapchain limit)](#adapter-swapchain_pool) | `adapter.swapchain_pool` | Game settings | 1 |
 | [Steady controller input after focus](#adapter-sync_guard) | `adapter.sync_guard` | Game settings | 3 |
 | [Hide Vulkan foveation](#adapter-vk_hide_fdm) | `adapter.vk_hide_fdm` | Game settings | 1 |
 | [Without Steam's shader cache layer](#adapter-vk_no_fossilize) | `adapter.vk_no_fossilize` | Game settings | 1 |
@@ -195,13 +187,13 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Keep the game's saved resolution in step](#device-config_sync) | `device.config_sync` | Files and settings on the Frame | 1 |
 | [Show as VR or as a flat window](#device-display_mode) | `device.display_mode` | Files and settings on the Frame |  |
 | [Settings files for the game](#device-files) | `device.files` | Files and settings on the Frame | 3 |
-| [Foveated rendering (Valve)](#device-foveation) | `device.foveation` | Files and settings on the Frame | 6 |
+| [Foveated rendering (Valve)](#device-foveation) | `device.foveation` | Files and settings on the Frame | 5 |
 | [Headset model](#device-headset_model) | `device.headset_model` | Files and settings on the Frame | default |
 | [Hide Android's navigation bar](#device-hide_navbar) | `device.hide_navbar` | Files and settings on the Frame |  |
 | [Game language](#device-language) | `device.language` | Files and settings on the Frame |  |
 | [Extra Lepton settings](#device-lepton_env) | `device.lepton_env` | Files and settings on the Frame | 3 |
 | [Controllers as a gamepad (Steam Input)](#device-steam_gamepad) | `device.steam_gamepad` | Files and settings on the Frame |  |
-| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 130 |
+| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 121 |
 | [Launch options (SteamVR or OpenXR)](#pcvr-launch_args) | `pcvr.launch_args` | PC VR (Proton and Revive) | 2 |
 | [Provide the Oculus runtime from Revive (Frame)](#pcvr-libovr_redirect) | `pcvr.libovr_redirect` | PC VR (Proton and Revive) |  |
 | [No Unreal crash reporter](#pcvr-no_crash_reporter) | `pcvr.no_crash_reporter` | PC VR (Proton and Revive) |  |
@@ -310,7 +302,7 @@ Turns off Meta's frame-rate trick, which causes glitches or hangs outside Quest
 - **Changes:** Changes the APK (during the OVRPort conversion).
 - **Suggested (on):** Very heavy game (… GiB) using OVRPlugin: application space warp causes artifacts/hangs off-Quest.
 - **Offered (off):** Enable if the game shows warping artifacts or hangs (uses OVRPlugin space warp).
- **Catalog games (5):** Asgard's Wrath 2, Batman: Arkham Shadow, Epic Roller Coasters, Marvel's Deadpool VR, Puzzling Places.
+- **Catalog games (4):** Asgard's Wrath 2, Batman: Arkham Shadow, Marvel's Deadpool VR, Puzzling Places.
 - **Source:** [patches/overport.py](../src/frameport/patches/overport.py)

 > For heavy games that use application space warp: it causes artifacts or hangs on non-Quest runtimes (for example Asgard's Wrath 2, Batman: Arkham Shadow).
@@ -446,7 +438,7 @@ Stops some Unreal games from closing themselves right after starting.
 - `patch_remove_unreal_force_quit`
 - **Changes:** Changes the APK (during the OVRPort conversion).
 - **Offered (off):** Built as the alternate APK for Unreal games (use it if the game quits itself).
- **Catalog games (49):** Asgard's Wrath 2, BARTENDER VR SIMULATOR, Breathedge VR, Carve Snowboarding, Creed, Dance Central, Darksword, Espire 1: VR Operative (Quest Edition) and 41 more.
+- **Catalog games (46):** Asgard's Wrath 2, BARTENDER VR SIMULATOR, Breathedge VR, Carve Snowboarding, Creed, Dance Central, Espire 1: VR Operative (Quest Edition), Espire 2 and 38 more.
 - **Suggested by launch-test signatures:**
  - `force-quit` (error): The game quit itself right after starting.
 - **Source:** [patches/overport.py](../src/frameport/patches/overport.py)
@@ -593,7 +585,7 @@ Stops bHaptics from asking for a Bluetooth permission the Frame doesn't have (th
 - `frame.bhaptics_permission` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** bHaptics asks for an Android 12 Bluetooth permission at start; the permission screen interrupts the game on the Frame.
- **Catalog games (9):** Darksword, Deisim, Epic Roller Coasters, Quantum Void, Ragnarock, Smash Drums, Tea For God, Vampire: The Masquerade - Justice and 1 more.
+- **Catalog games (6):** Quantum Void, Ragnarock, Smash Drums, Tea For God, Vampire: The Masquerade - Justice, Vendetta Forever.
 - **Suggested by launch-test signatures:**
  - `bhaptics-permission-prompt` (error): The game asked for Android 12's Bluetooth permission (bHaptics' vest SDK, for example Yupitergrad).
 - **Source:** [patches/frame/bhaptics_permission.py](../src/frameport/patches/frame/bhaptics_permission.py)
@@ -674,7 +666,7 @@ Lets games with Google Play services code start on the Frame (they'd crash at st
 - `frame.gms_platform_version` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Google Play services' Android 12 checks were built in as 'always true'; on Lepton (Android 11) the game would crash at start.
- **Catalog games (2):** Solero, Table Troopers.
+- **Catalog games (1):** Table Troopers.
 - **Suggested by launch-test signatures:**
  - `gms-android12-call` (fatal): Google Play services' code in the game called an Android 12 method (the game was built for Android 12 and newer, so its version checks were built in as "always true") and Lepton runs Android 11; the game crashes on its GoogleApiHandler thread at start (for example Titan Isles).
 - **Source:** [patches/frame/gms_platform_version.py](../src/frameport/patches/frame/gms_platform_version.py)
@@ -702,7 +694,7 @@ Plays the game's videos on the Frame's video hardware, so 4K and 8K video runs s
 - `frame.hw_video_decode` · also for 2D apps
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** The game plays video through Android's decoders (MediaCodec, ExoPlayer or VLC): decode it on the Frame's hardware.
- **Catalog games (40):** 4XVR Video Player, AugmentedEmpire, Batman: Arkham Shadow, Battlemarked, BattleTalent, Breathedge VR, Dance Central, Darksword and 32 more.
+- **Catalog games (34):** 4XVR Video Player, AugmentedEmpire, Batman: Arkham Shadow, Battlemarked, BattleTalent, Breathedge VR, Dance Central, Exploding Kittens VR and 26 more.
 - **Source:** [patches/frame/hw_video_decode.py](../src/frameport/patches/frame/hw_video_decode.py)

 > Decodes the game's videos on the Frame's hardware video decoder instead of Android's software decoders, which stutter or fall behind with 4K/8K video (for example video players, Batman: Arkham Shadow's cutscenes). Adds FramePort's codec plugin (OMX.frameport.avc/hevc/vp9.decoder) to this game's container only; the APK isn't changed. When the hardware is busy (for example Steam's own hardware video decoding is on) the video is decoded in software as before.
@@ -727,7 +719,7 @@ Makes the game start from the Frame's Steam library.
 - **Suggested (on):** Manifest uses category INFO only; Lepton needs LAUNCHER.
 - **Suggested (on):** Applied automatically if the manifest needs it.
 - **Suggested by launch-test signatures:**
-  - `no-launcher` (fatal): Nothing starts: Lepton found no entry point in the app (an activity with category LAUNCHER; one on an activity-alias alone does not count).
+  - `no-launcher` (fatal): Nothing starts: Lepton found no entry point in the app (an activity with category LAUNCHER).
 - **Source:** [patches/frame/manifest_fixes.py](../src/frameport/patches/frame/manifest_fixes.py)

 > Lepton only launches an activity with category LAUNCHER (Quest apps often use INFO). Symptom when missing: launch.log says 'APP_ACTIVITY is empty' and nothing starts.
@@ -757,29 +749,6 @@ Lets games with a verified older Lua engine get past a startup crash on the Fram

 > Older xLua/LuaJIT engines reject native pointers outside their 47-bit range, causing a startup error and sometimes a second crash during Unity shutdown (e.g. BattleTalent). Uses a Lua engine that preserves full pointer values while keeping the game's original xLua bindings and native helpers. Applied only to the verified compatible library build.

-### <a id="frame-main_process"></a>Start the game in the app's main process
-
-Keeps the game from being closed about a minute after it starts (it runs in a separate Android process the Frame doesn't watch).
-
- `frame.main_process` · on by default · also for 2D apps
- **Changes:** Changes the APK (a rebuild and reinstall apply it).
- **Suggested (on):** … runs in its own process, which Lepton doesn't watch: it would close the game about a minute in.
- **Source:** [patches/frame/manifest_fixes.py](../src/frameport/patches/frame/manifest_fixes.py)
-
-> Some apps run their game activity in a process of its own (android:process, e.g. Halo CE VR's ":halo_game"), started from a 2D launcher activity. Lepton starts the game activity directly and watches only the app's main process, which then never exists: about a minute in, Lepton decides the app "did not start" and closes it, at whatever point the game has reached. This runs those activities in the main process (only their android:process value changes).
-
-### <a id="frame-meta_depth_occlusion"></a>Unity: disable Meta depth occlusion
-
-Keeps objects visible up close in mixed-reality games that would hide them behind your room using Meta's depth sensor, which the Frame lacks (for example Laser Dance).
-
- `frame.meta_depth_occlusion`
- **Changes:** Changes the APK (a rebuild and reinstall apply it).
- **Offered (off):** Uses Meta's Depth API occlusion (HARD_OCCLUSION / SOFT_OCCLUSION): turn on if objects vanish when you come close to them.
- **Catalog games (1):** Laser Dance.
- **Source:** [patches/frame/meta_depth_occlusion.py](../src/frameport/patches/frame/meta_depth_occlusion.py)
-
-> The Frame has no depth sensor (XR_META_environment_depth), so the environment depth Meta's Depth API reads is never valid. Shaders using it then hide virtual objects near the player behind a room that isn't there (for example Laser Dance's lasers vanish when approached). Rewrites EnvironmentDepthManager's support/availability checks and its occlusion-keyword setter in libil2cpp.so (found with Cpp2IL), and renames the HARD_OCCLUSION / SOFT_OCCLUSION shader keywords in the game's asset files that contain them, so occlusion is never turned on. For Laser Dance's known build it also keeps the laser beams' materials and close-range LODs visible. Only for games with this symptom.
-
 ### <a id="frame-meta_permissions"></a>Declare Meta-only permissions

 Declares Meta's permissions some mixed-reality games ask for, so they don't stop.
@@ -787,8 +756,7 @@ Declares Meta's permissions some mixed-reality games ask for, so they don't stop
 - `frame.meta_permissions`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Mixed-reality game that needs the room model: its 'use spatial data' permission must be granted (for example Demeter).
- **Suggested (on):** Uses Meta's room or anchor APIs: their permissions must be granted, or the game never asks for the room (for example NOPE's MR mode).
- **Catalog games (8):** Arkio, BattleTalent, Demeter, Laser Dance, Movie Deck for Plex, Punch Fit, Real VR Fishing, Test Quest MR.
+- **Catalog games (4):** Arkio, BattleTalent, Demeter, Real VR Fishing.
 - **Source:** [patches/frame/manifest_fixes.py](../src/frameport/patches/frame/manifest_fixes.py)

 > Declares com.oculus.permission.* / horizonos.permission.* that the app uses, so Android grants them at install (for example the 'use spatial data' permission of mixed-reality games like Demeter).
@@ -831,7 +799,7 @@ Provides stand-ins for Quest system calls some games make at start.
 - **Suggested (on):** The Unreal build of Meta XR Audio looks up com.oculus.os.AnalyticsEvent and aborts without it (for example NOPE Challenge).
 - **Suggested (on):** Several Meta SDK libraries look up com.oculus.os.AnalyticsEvent (…); games like this abort without the stub (for example Nano).
 - **Offered (off):** … references com.oculus.os.AnalyticsEvent; usually harmless (for example Batman: Arkham Shadow and LEGO Bricktales run without it). Enable if the game aborts with ClassNotFoundException.
- **Catalog games (18):** AgeOfJoy, AllInOneSports, Caves, Deep Cuts, Does it Stack?, Drums Rock, Nano, Neko Atsume Purrfect and 10 more.
+- **Catalog games (17):** AgeOfJoy, AllInOneSports, Caves, Deep Cuts, Does it Stack?, Nano, Neko Atsume Purrfect, NOPE CHALLENGE and 9 more.
 - **Suggested by launch-test signatures:**
  - `oculus-os-class` (fatal): The game looks up a Quest-only system class and aborts.
 - **Source:** [patches/frame/telemetry.py](../src/frameport/patches/frame/telemetry.py)
@@ -921,27 +889,13 @@ Stops games with Photon Voice chat from crashing on the Frame when voice chat st
 - `frame.photon_voice_audio_route` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Photon Voice calls Android 12 audio methods, which Lepton (Android 11) lacks, and crashes when voice chat starts.
- **Catalog games (2):** Deisim, Table Troopers.
+- **Catalog games (1):** Table Troopers.
 - **Suggested by launch-test signatures:**
  - `photon-voice-api31` (fatal): The game's Photon Voice microphone plugin calls Android 12 audio-routing methods (AudioManager communication devices) without checking the Android version; Lepton runs Android 11, so the app crashes when voice chat starts (for example Table Troopers at the tutorial).
 - **Source:** [patches/frame/photon_voice_audio_route.py](../src/frameport/patches/frame/photon_voice_audio_route.py)

 > Photon Voice's microphone plugin (for example Table Troopers) picks the audio device with Android 12 methods (AudioManager communication devices) without checking the Android version; Lepton runs Android 11, so the game crashes with a NoSuchMethodError when voice chat starts. That method returns at once instead (an in-place edit of classes.dex); the microphone keeps Android's default audio route.

-### <a id="frame-pojlib_connection"></a>QuestCraft: count the Frame's network as online
-
-Lets QuestCraft download its Java runtime: it waits for Wi-Fi, and the Frame's Android reports its network as Ethernet.
-
- `frame.pojlib_connection` · also for 2D apps
- **Changes:** Changes the APK (a rebuild and reinstall apply it).
- **Suggested (on):** QuestCraft only downloads its Java runtime on Wi-Fi; the Frame's Android reports its network as Ethernet.
- **Catalog games (1):** QuestCraft.
- **Suggested by launch-test signatures:**
-  - `questcraft-no-java-runtime` (fatal): QuestCraft's Java runtime isn't there.
- **Source:** [patches/frame/pojlib_connection.py](../src/frameport/patches/frame/pojlib_connection.py)
-
-> QuestCraft downloads its Java runtime only when Android reports a Wi-Fi connection; the Frame's Android reports Ethernet, so the download is skipped and Minecraft can't start. The connection check answers yes instead (an in-place edit of classes.dex).
-
 ### <a id="frame-sdl_clipboard"></a>SDL apps: start without a clipboard service

 Lets SDL and LÖVE games start on the Frame (they'd crash looking for a clipboard).
@@ -949,7 +903,7 @@ Lets SDL and LÖVE games start on the Frame (they'd crash looking for a clipboar
 - `frame.sdl_clipboard` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** SDL app: it crashes at start in Lepton, which has no clipboard service.
- **Catalog games (8):** Crisis Zone VR, GoldenEye VR, Majora's Mask VR, PrimedGun v2, Simpsons Hit and Run VR, Time Crisis II VR (Test), Time Crisis VR (Experimental), WiiCompiled VR.
+- **Catalog games (6):** Crisis Zone VR, Majora's Mask VR, PrimedGun v2, Time Crisis II VR (Test), Time Crisis VR (Experimental), WiiCompiled VR.
 - **Suggested by launch-test signatures:**
  - `sdl-no-clipboard` (fatal): The app crashed at start because the Frame's Android has no clipboard.
 - **Source:** [patches/frame/sdl_clipboard.py](../src/frameport/patches/frame/sdl_clipboard.py)
@@ -986,10 +940,11 @@ Opens the app straight in VR, skipping its flat launcher screen. Turn off to use

 Makes an embedded OpenXR loader use FrameBridge and your game settings.

- `frame.static_openxr_loader` · revision 2
+- `frame.static_openxr_loader`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** The embedded Khronos OpenXR loader bypasses FrameBridge.
 - **Requires:** [`frame.adapter`](#frame-adapter)
+- **Catalog games (1):** PrimedGun v2.
 - **Suggested by launch-test signatures:**
  - `static-openxr-loader-bypass` (warning): A Khronos loader loaded the system runtime without FrameBridge.
 - **Source:** [patches/frame/static_openxr_loader.py](../src/frameport/patches/frame/static_openxr_loader.py)
@@ -1017,7 +972,7 @@ Lets Team Beef ports (for example Lambda1VR) start on the Frame.
 - `frame.tbxr_vendor` · revision 2
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Team Beef port: it picks its OpenXR setup by headset maker, which the Frame reports as "valve".
- **Catalog games (2):** JKXR, Lambda1VR.
+- **Catalog games (1):** Lambda1VR.
 - **Source:** [patches/frame/tbxr_vendor.py](../src/frameport/patches/frame/tbxr_vendor.py)

 > Team Beef's ports (for example Lambda1VR, RTCWQuest) load an OpenXR library named after the headset maker and pick their VR setup by maker; for "valve" they stop at start (libopenxr_loader_valve.so not found) or take the Pico path. Adds that library and lets them take the Meta path. Keeps GL4ES in charge of its desktop OpenGL draw calls so animated models don't turn into stretched triangles.
@@ -1042,7 +997,7 @@ Stops a gray or frozen screen in Unity games that turn on anti-aliasing while ru
 - `frame.unity_gl_shim`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unity GLES game that may switch to MSAA at runtime: hide multisampled render-to-texture, which crashes the Frame's GL driver (for example The Room VR).
- **Catalog games (27):** Audica, BattleSisters, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight, End Space and 19 more.
+- **Catalog games (26):** Audica, BattleSisters, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight, End Space and 18 more.
 - **Suggested by launch-test signatures:**
  - `unreal-msrtt-crash` (fatal): The game's graphics crashed a few seconds after start.
 - **Source:** [patches/frame/vrapi_bridge.py](../src/frameport/patches/frame/vrapi_bridge.py)
@@ -1069,7 +1024,7 @@ Turns off a smoothing setting that crashes some older Unity games on the Frame.
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Legacy VrApi Unity game on GLES with MSAA (… quality levels): multisampled render-to-texture hangs the Frame's GL driver (for example Sniper Elite VR).
 - **Offered (off):** GLES Unity game with MSAA on (… quality levels); enable if it hangs the GPU ('zink: DEVICE LOST').
- **Catalog games (11):** Audica, BattleSisters, Eye of the Temple, I Expect You To Die 2, IEYTD3, Jurassic World Aftermath Collection, KillerFrequency, Mini Motor Racing X and 3 more.
+- **Catalog games (10):** Audica, BattleSisters, Eye of the Temple, I Expect You To Die 2, IEYTD3, Jurassic World Aftermath Collection, Mini Motor Racing X, Sniper Elite VR and 2 more.
 - **Suggested by launch-test signatures:**
  - `zink-device-lost` (fatal): The GPU hung, so the game froze or closed.
 - **Source:** [patches/frame/unity_no_msaa.py](../src/frameport/patches/frame/unity_no_msaa.py)
@@ -1111,7 +1066,7 @@ Keeps a smoothing setting off that the game turns on itself and that can freeze
 - `frame.unity_runtime_msaa_off` · revision 2
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** GLES Unity game whose OVRManager turns 4x MSAA on at runtime: multisampled render-to-texture can hang the Frame's GPU.
- **Catalog games (33):** Audica, BattleSisters, BattleTalent, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight and 25 more.
+- **Catalog games (32):** Audica, BattleSisters, BattleTalent, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight and 24 more.
 - **Suggested by launch-test signatures:**
  - `unity-render-crash` (fatal): The game's graphics crashed, so the picture freezes or stays gray.
  - `unity-runtime-msaa` (info): The game turns MSAA on at runtime, which can hang the Frame's GPU.
@@ -1120,18 +1075,6 @@ Keeps a smoothing setting off that the game turns on itself and that can freeze

 > Meta's OVRManager switches Unity to the headset's recommended MSAA level (4x) while the game runs, whatever its quality settings say (log: "Switching to the recommended level"). Multisampled render-to-texture on GLES can hang the Frame's GPU, up to a restart of the whole headset (for example Lucky's Tale in a menu) or a crash of its GL driver (for example The Room VR, whose own code sets 4x). Rewrites OVRDisplay.recommendedMSAALevel -&gt; 0 and makes QualitySettings.antiAliasing's setter do nothing in libil2cpp.so (found with Cpp2IL), so MSAA stays off.

-### <a id="frame-unity_scene_active_rooms"></a>Unity: skip Meta's player-in-room check
-
-Lets a mixed-reality game load the room even if it thinks you stand outside it (for example Laser Dance asking again and again to scan your room).
-
- `frame.unity_scene_active_rooms`
- **Changes:** Changes the APK (a rebuild and reinstall apply it).
- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
- **Catalog games (1):** Laser Dance.
- **Source:** [patches/frame/unity_runtime.py](../src/frameport/patches/frame/unity_runtime.py)
-
-> Meta's OVRSceneManager (ActiveRoomsOnly) loads only the room whose floor outline contains the player (IsUserInRoom). If the player is outside the emulated room's floor, loading stops with 'No scene model found' (for example Laser Dance with the play-area room). Rewrites OVRSceneManager.IsUserInRoom and PointInPolygon2D -&gt; true in libil2cpp.so (found with Cpp2IL), so the room loads wherever the player stands. Only for games with this symptom: a scanned room around the player usually passes the check by itself.
-
 ### <a id="frame-unity_text_input"></a>Make Unity text fields work

 Lets you type into this app's text fields on the Frame (they'd close at once).
@@ -1139,7 +1082,7 @@ Lets you type into this app's text fields on the Frame (they'd close at once).
 - `frame.unity_text_input` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unity app with text fields (…): they close at once on the Frame because it has no system keyboard.
- **Catalog games (130):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable, Audica and 122 more.
+- **Catalog games (118):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable, Audica and 110 more.
 - **Source:** [patches/frame/unity_text_input.py](../src/frameport/patches/frame/unity_text_input.py)

 > Unity's TMP_InputField / InputField wait for Android's on-screen keyboard and close themselves a frame later when there is none (Lepton has no on-screen keyboard; Meta's system keyboard does this on a Quest), so a selected text field only flashes a caret. Rewrites TouchScreenKeyboardShouldBeUsed -&gt; false and isKeyboardUsingEvents (TMP) / InPlaceEditing (uGUI) -&gt; true in libil2cpp.so, found per game with Cpp2IL (downloaded on first use), so fields stay selected and take key presses: Steam's keyboard (with "Show the app window") or Type on Frame from the PC.
@@ -1219,7 +1162,7 @@ Lets older Unreal games start VR on the Frame (for example Star Wars Pinball VR)
 - `frame.unreal_ovrp_entrypoints`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unreal looks up OVRPlugin function(s) OVRPort's OVRPlugin lacks: ……. Without them Unreal starts no VR.
- **Catalog games (6):** Darksword, Ghostbusters: Rise of the Ghost Lord, Orcs Must Die: By The Blade, Puzzling Places, Solero, Star Wars Pinball VR.
+- **Catalog games (3):** Ghostbusters: Rise of the Ghost Lord, Puzzling Places, Star Wars Pinball VR.
 - **Source:** [patches/frame/unreal_ovrp.py](../src/frameport/patches/frame/unreal_ovrp.py)

 > Unreal's Oculus module looks up every OVRPlugin function it was built against and starts no VR when one is missing; OVRPort's OpenXR OVRPlugin lacks some old ones (for example ovrp_GetPTWNear, which Unreal 4.25 builds like Star Wars Pinball VR look up). The game then never starts an OpenXR session and crashes a few seconds in. Adds a generated library to libOVRPlugin.so with a stand-in for each missing function that reports failure (ovrpFailure), so Unreal's Oculus support starts. The functions OVRPort has are untouched.
@@ -1255,7 +1198,7 @@ Starts Unreal games without re-checking their data file (they'd seem to hang on
 - `frame.unreal_skip_obb_check` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unreal checks the OBB's contents before starting (bVerifyOBBOnStartUp); on the Frame a failed or slow check can't be seen and the game seems to hang.
- **Catalog games (10):** Dance Central, Darksword, Kill It With Fire VR, Lost Recipes, MacacoVR, Maestro, Puzzling Places, Ragnarock and 2 more.
+- **Catalog games (9):** Dance Central, Kill It With Fire VR, Lost Recipes, MacacoVR, Maestro, Puzzling Places, Ragnarock, Scared By Squares and 1 more.
 - **Suggested by launch-test signatures:**
  - `unreal-obb-check-stuck` (fatal): The game stays on Unreal's OBB check screen (DownloaderActivity), which the Frame doesn't show, and never starts VR (for example Contractors, GitHub #159).
 - **Source:** [patches/frame/unreal_obb_check.py](../src/frameport/patches/frame/unreal_obb_check.py)
@@ -1334,7 +1277,7 @@ Lets games with Vivox voice chat start on the Frame (they'd crash on an Android
 - `frame.vivox_audio_route` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Vivox voice chat: it calls Android 12 audio methods, which Lepton (Android 11) lacks, and crashes.
- **Catalog games (4):** Black Hole Pool, Dungeons of Eternity, Epic Roller Coasters, Real VR Fishing.
+- **Catalog games (3):** Black Hole Pool, Dungeons of Eternity, Real VR Fishing.
 - **Suggested by launch-test signatures:**
  - `vivox-api31` (fatal): The game's Vivox voice-chat SDK calls Android 12 audio-routing methods (AudioManager communication devices) without checking the Android version; Lepton runs Android 11, so the app crashes (for example Green Hell VR).
 - **Source:** [patches/frame/vivox_audio_route.py](../src/frameport/patches/frame/vivox_audio_route.py)
@@ -1484,7 +1427,7 @@ Turn off only for games you play with your hands instead of controllers.
 - **Options:**
  - Value: int, default `1` (always written).
  - Game settings → Controllers → "Use controllers".
- **Catalog games (2):** Laser Dance, Silhouette.
+- **Catalog games (1):** Silhouette.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Reports Frame controllers as Oculus Touch and hides synthetic hand tracking. Set 0 for games that require hand tracking (for example Silhouette).
@@ -1499,7 +1442,7 @@ For games that show the headset's own controllers. Takes effect after a reinstal
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Controllers → "Show Steam Frame controllers".
- **Catalog games (8):** Hitstream, Movie Deck for Plex, Neko Atsume Purrfect, Ocean Rift, Real VR Fishing, SynthRiders, VR HOT Quest, Walkabout Mini Golf.
+- **Catalog games (6):** Neko Atsume Purrfect, Ocean Rift, Real VR Fishing, SynthRiders, VR HOT Quest, Walkabout Mini Golf.
 - **Suggested by launch-test signatures:**
  - `render-model-requested` (info): The game shows Quest controllers (or none) because the Frame doesn't provide controller models.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
@@ -1558,7 +1501,7 @@ Video players' virtual theaters and 360° videos would otherwise stay black.
 - **Options:**
  - Value: int, default `0`.
  - Game settings → 360° pictures and video → "Show 360° backgrounds and videos".
- **Catalog games (9):** 4XVR Video Player, EndoparasiticVR, Into The Radius 2, Orcs Must Die: By The Blade, Pinball FX VR, Puzzling Places, Riven, Solero and 1 more.
+- **Catalog games (7):** 4XVR Video Player, EndoparasiticVR, Into The Radius 2, Pinball FX VR, Puzzling Places, Riven, Tea For God.
 - **Suggested by launch-test signatures:**
  - `equirect-layers-dropped` (warning): The game's 360° pictures (for example a video player's theater or 360° videos) are missing because the Frame's runtime can't show equirect layers.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
@@ -1680,23 +1623,6 @@ For games that stop at start because the headset reports no colour space (for ex

 > Offers Meta's colour-space extension when the Frame's runtime lacks it: the game is told the headset uses Rec.709 and may choose any colour space (no conversion is done). For games that quit before their VR session with "Rec.709 color space unavailable" (for example OutRun Quest VR, GitHub #336). Only reaches games that use their own OpenXR loader; OVRPort's dispatcher can't forward the new functions.

-### <a id="adapter-fixed_resolution"></a>Keep full resolution (no dynamic resolution)
-
-Prevents dynamic resolution from moving Valve foveation off-centre or leaving a white edge line. May increase GPU load. Used at the next launch.
-
- `adapter.fixed_resolution`
- **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
- **Options:**
-  - Value: int, default `0`.
-  - Game settings → Picture → "Keep full resolution (no dynamic resolution)" (advanced).
- **Catalog games (1):** Batman: Arkham Shadow.
- **Suggested by launch-test signatures:**
-  - `dynamic-resolution-foveation` (info): The game submits an offset projection viewport.
- **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
-
-> Keeps OpenXR layer recommendations at the full swapchain size. Prevents dynamic resolution from moving Valve foveation off-centre or leaving a coarse white edge line. May increase GPU load.
-
 ### <a id="adapter-flip_dump"></a>Upside-down panel images (diagnostics)

 Saves a few UI panels before and after FrameBridge turns them upright, for testing without the headset.
@@ -1884,7 +1810,7 @@ For games that freeze the Frame when a controller vibrates (for example Lucky's
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Controllers → "Fix freezes when controllers vibrate" (advanced).
- **Catalog games (116):** AgeOfJoy, Ancient_Dungeon, Attack on Titan VR: Unbreakable, Audica, AugmentedEmpire, Barbaria, Battlemarked, BattleSisters and 108 more.
+- **Catalog games (103):** AgeOfJoy, Ancient_Dungeon, Attack on Titan VR: Unbreakable, Audica, AugmentedEmpire, Battlemarked, BattleSisters, BattleTalent and 95 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Routes OVRPlugin through FramePort's extension shim, which turns Meta's amplitude-envelope vibrations into plain ones: OVRPort's loader reads their nanosecond duration as seconds and allocates gigabytes, freezing the Frame when the game vibrates a controller (for example Lucky's Tale's save slots, GitHub #9). Needs a rebuild.
@@ -2032,7 +1958,6 @@ Shows the Frame's cameras where the game expects passthrough.
 - **Options:**
  - Value: int, default `1`.
  - Game settings → Mixed reality → "See your room".
- **Catalog games (2):** Laser Dance, Punch Fit.
 - **Suggested by launch-test signatures:**
  - `passthrough-missing` (error): The game needs Meta passthrough (the camera view), which the Frame lacks; the adapter emulates it.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
@@ -2079,7 +2004,7 @@ For games whose hands trail the controllers when you move them (for example Batt
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Controllers → "Fix hands lagging behind controllers" (advanced).
- **Catalog games (17):** Battlemarked, BattleSisters, Beat Saber, Dance Central, Dungeons of Eternity, Mini Motor Racing X, OrbusVR, Phantom: Covert Ops and 9 more.
+- **Catalog games (16):** Battlemarked, BattleSisters, Beat Saber, Dance Central, Dungeons of Eternity, Mini Motor Racing X, OrbusVR, Phantom: Covert Ops and 8 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Poses a game asks for at a CLOCK_MONOTONIC time, or more than 0.5 s before the frame's display time, are located at the same moment in the runtime's time (or now). Meta's OVRPlugin passes the monotonic clock on as the OpenXR time, which on the Frame runs seconds behind the runtime's clock, so its "now" poses (Unity's physics step, controller poses) came from the past: hands trailing the controllers (for example BattleSisters, Sniper Elite VR).
@@ -2150,7 +2075,7 @@ How often the picture updates. Higher is smoother if the game can keep up.
 - **Options:**
  - Value: float, default `0.0`.
  - Game settings → Picture → "Refresh rate": Game's choice (`0`), 72 Hz (`72`), 80 Hz (`80`), 90 Hz (`90`), 96 Hz (`96`), 108 Hz (`108`), 120 Hz (`120`), 144 Hz (`144`).
- **Catalog games (5):** Astro VR Host, Does it Stack?, Majora's Mask VR, Simpsons Hit and Run VR, Vacation Simulator.
+- **Catalog games (3):** Does it Stack?, Majora's Mask VR, Vacation Simulator.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Display refresh rate for this game (72, 80, 90, 96, 108, 120 or 144; 0 = the game's choice). Applied through SteamVR before the game starts. A video's frame rate that divides the refresh rate plays smoothest (for example 30 fps at 90 Hz, 24 fps at 72 Hz).
@@ -2193,7 +2118,7 @@ Changes the game's render resolution. Higher is sharper but slower; 1.0× is the
 - **Options:**
  - Value: float, default `1.0` (always written).
  - Game settings → Picture → "Render resolution (supersampling)": slider 0.5–2 in steps of 0.1.
- **Catalog games (18):** 4XVR Video Player, Barbaria, BlazeRush, CrazyTaxiVR, cubism, Darksword, Drums Rock, FGO VR and 10 more.
+- **Catalog games (14):** 4XVR Video Player, BlazeRush, CrazyTaxiVR, cubism, FGO VR, I Expect You To Die 2, Spectre, Survival Nation and 6 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Multiplies the recommended eye-buffer width and height (0.5–2.0). 1.5 ≈ 2.25× pixels.
@@ -2212,23 +2137,23 @@ Changes the game's render resolution. Higher is sharper but slower; 1.0× is the

 > Override the guardian depth (0 = use guardian, min 1.5 m).

-### <a id="adapter-scene_emul"></a>Use room layout
+### <a id="adapter-scene_emul"></a>Pretend room layout

-Scene games get your saved room. Without one, they get a simple room from the play area.
+Mixed-reality games that build their level from your room get a simple room with walls.

 - `adapter.scene_emul`
 - **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
- **Suggested (on), value `1`:** The game uses Meta's scene or spatial anchor APIs: serve the saved room on the Frame, or a simple play-area room until one is scanned.
+- **Suggested (on), value `1`:** Mixed-reality game that builds its level from the room model: emulate a guardian-sized room (for example Demeter).
+- **Suggested (on), value `1`:** The game asks Meta's system for your room layout (scene), which the Frame doesn't have: emulate a room from the play area (for example VR HOT's room setup).
 - **Options:**
  - Value: int, default `0`.
-  - Game settings → Mixed reality → "Use room layout".
- **Catalog games (19):** Arkio, AugmentedEmpire, Battlemarked, BattleTalent, cubism, Demeo, Demeter, Ghostbusters: Rise of the Ghost Lord and 11 more.
+  - Game settings → Mixed reality → "Pretend room layout".
+- **Catalog games (12):** Arkio, AugmentedEmpire, Battlemarked, BattleTalent, Demeo, Demeter, Ghostbusters: Rise of the Ghost Lord, Neko Atsume Purrfect and 4 more.
 - **Suggested by launch-test signatures:**
-  - `mr-discovery-unsupported` (warning): The game cannot discover a Meta room.
  - `scene-missing` (warning): The game wants Meta's room data (scene API), which the Frame lacks.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

-> Serve Meta scene and spatial entity APIs from the saved room (walls, furniture and mesh). Without a saved room, use a simple play-area box (for example Demeter).
+> Fake XR_FB_scene/spatial entities: a guardian-sized room with floor, ceiling and four walls, for mixed-reality games that build their level from the room (for example Demeter).

 ### <a id="adapter-scene_height"></a>Room height

@@ -2244,35 +2169,6 @@ Ceiling height of the pretend room.

 > Ceiling height for scene_emul.

-### <a id="adapter-scene_hide_bounds"></a>Hide play-area size
-
-For games that reject the room because of the play area.
-
- `adapter.scene_hide_bounds`
- **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
- **Options:**
-  - Value: int, default `0`.
-  - Game settings → Mixed reality → "Hide play-area size" (advanced); shown while `adapter.scene_emul` is on.
- **Catalog games (1):** Demeter.
- **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
-
-> With scene_emul, the game's play-area (STAGE bounds) query answers "no play area". The Frame reports a 1x1 m area whose outline OVRPlugin can't give, and some Unity MR games then fail their guardian check (for example Demeter). Off by default: other games stalled without a play area.
-
-### <a id="adapter-scene_scan_request"></a>Scan when requested
-
-Scan your room in the headset when the game asks for a room scan.
-
- `adapter.scene_scan_request`
- **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
- **Options:**
-  - Value: int, default `1`.
-  - Game settings → Mixed reality → "Scan when requested" (advanced); shown while `adapter.scene_emul` is on.
- **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
-
-> With scene_emul, let FramePort scan your room in the headset when the game requests a scan. If no scanner answers, use the saved room. Turn off to always use the saved room.
-
 ### <a id="adapter-scene_width"></a>Room width

 0 = the size of your play area.
@@ -2403,21 +2299,6 @@ Lets OpenGL ES games start when the Frame refuses their picture format. Leave it

 > Retry rejected GLES formats/MSAA with sRGB, samples=1.

-### <a id="adapter-swapchain_pool"></a>Share panel images (swapchain limit)
-
-Keeps extra menus and panels working when the Frame reaches its image count limit. GLES apps only; Vulkan apps are unaffected.
-
- `adapter.swapchain_pool`
- **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
- **Options:**
-  - Value: int, default `0`.
-  - Game settings → Troubleshooting → "Share panel images (swapchain limit)" (advanced).
- **Catalog games (1):** 4XVR Video Player.
- **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
-
-> Share GLES panel images in runtime atlases to avoid the Frame's swapchain count limit (about 15 per session). Useful when opening extra menus closes them or leaves panels gray. Vulkan apps are unaffected.
-
 ### <a id="adapter-sync_guard"></a>Steady controller input after focus

 For games that crash right after you return to them (for example after the Steam menu).
@@ -2663,7 +2544,7 @@ Render less detail outside your gaze; adjust the full-resolution area or darken
  - `mode`: str, default empty — Catalog default: tracked, fixed or off (empty = Valve's default)
  - `level`: str, default empty — Runtime profile: lo, med, hi (empty = Default)
  - `test`: bool, default `False` — Darken lower-resolution regions (diagnostic)
- **Catalog games (6):** Darksword, Ocean Rift, Quantum Void, Tea For God, The 7th Guest VR, Vampire: The Masquerade - Justice.
+- **Catalog games (5):** Ocean Rift, Quantum Void, Tea For God, The 7th Guest VR, Vampire: The Masquerade - Justice.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Reduces shading away from the full-resolution area, following each eye's gaze. Default keeps the runtime profile unchanged. Low has the largest full-resolution center; medium and high use smaller centers and stronger peripheral detail reduction. Larger areas retain more detail but save less GPU work. Fixed stops the area following your eyes. The optional test darkens actual coarse-shaded fragments. Runtime choices are in Game settings. Tested on RE4, Deadpool and Asgard's Wrath 2. The Climb 2 gets a version-guarded private bridge at 1.0 scale; Batman gets its hash-verified allocation fix (unsupported OVRPlugin versions are refused). Other games may need additional fixes; turn this off if artifacts appear.
@@ -2725,13 +2606,9 @@ Lets the game use your controllers as a gamepad instead of a pointer, for 2D gam
 - `device.steam_gamepad` · also for 2D apps
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** 2D app that declares gamepad support (android.hardware.gamepad or Android TV's launcher): pass the controllers to it as a gamepad.
- **Options:**
-  - `swap_sticks`: bool, default `False` — Swap the sticks: the right stick moves through menus like the left one (for using one controller)
-  - `swap_ab`: bool, default `False` — Swap A and B
-  - `keys`: str, default empty — Own key layout lines (Android .kl), separated by ';', e.g. 'key 304 DPAD_DOWN' (A presses D-pad down) or 'key 305 BACK'
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

-> Lepton's Android only gets a keyboard, a pointer and touch from the Frame, so a 2D game never sees a controller (the controllers only move the pointer; SDL games show their touch controls). This passes Steam Input's virtual gamepad ("Microsoft X-Box 360 pad", made by Steam for the Frame's controllers and paired Bluetooth pads) into this app's container with an Xbox 360 key layout, and tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes later isn't seen until the next start). The APK isn't changed. Off for one start: FRAMEPORT_NO_GAMEPAD=1 in the game's launch options. Steam Input's own per-game remapping may not reach the app (GitHub #162); the options below change the buttons inside the app instead (applied with Update on Frame).
+> Lepton's Android only gets a keyboard, a pointer and touch from the Frame, so a 2D game never sees a controller (the controllers only move the pointer; SDL games show their touch controls). This passes Steam Input's virtual gamepad ("Microsoft X-Box 360 pad", made by Steam for the Frame's controllers and paired Bluetooth pads) into this app's container with an Xbox 360 key layout, and tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes later isn't seen until the next start). The APK isn't changed. Off for one start: FRAMEPORT_NO_GAMEPAD=1 in the game's launch options.

 ### <a id="device-text_input_window"></a>Show the app's Android window (for typing)

@@ -2740,7 +2617,7 @@ Lets typing reach this app from Steam's on-screen keyboard or your PC's keyboard
 - `device.text_input_window`
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** App with text fields: key presses only reach a shown Android window.
- **Catalog games (130):** AFFECTED: The Manor, AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable and 122 more.
+- **Catalog games (121):** AFFECTED: The Manor, AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable and 113 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Lepton runs VR apps headless: their Android window is never shown, so it never gets keyboard focus and no key press (Steam's on-screen keyboard, a USB/Bluetooth keyboard, Type on Frame) reaches the app's text fields. With Lepton's lepton-show-flatscreen marker the window is shown (behind the VR view, which keeps working) and Steam's keyboard opens for a selected text field. Steam lists the shown window as "Gamescope" (the Frame's compositor). Pairs with "Make Unity text fields work without a system keyboard".
@@ -14,7 +14,6 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Symptom | Cause | Fix |
 | `RuntimeManifestFile::FindManifestFiles - using global runtime file /vendor/etc/openxr/1/active_runtime.json`, no FrameBridge lines (#254) | Embedded Khronos loader bypasses the APK loader chain | `frame.static_openxr_loader`: redirect its manifest paths and broker authorities, bundle runtime shim + inner loader + FrameBridge; reinstall to write `/sdcard/fp_openxr_runtime.json`. Device check pending |
 |---|---|---|
-| Valve foveation sharp centre moves to the top right or a white line appears at the right edge as Batman shrinks its projection rect (#406 / #394) | Dynamic resolution draws a corner-anchored subrect inside the full swapchain used by Valve FDM | Enable `adapter.fixed_resolution` (Game settings → Picture), rebuild/reinstall for the new adapter and OVRPlugin shim; verify `fixed_resolution: recommended ... -> ...` and full-size `projection view ... rect change` logs. Headset verification pending; more GPU load |
 | Quest 3-only options missing; OVRPlugin logs `venderId 10291, systemName Oculus Quest2` (#373, Asgard's Wrath 2) | OVRPort's dispatcher overwrites FrameBridge's name and supplies a Quest 2 `XR_META_headset_id`; OVRPlugin prioritizes that UUID | `device.headset_model`: Quest 3 by default, per-game Quest 3S / Quest Pro / Quest 2; rebuild the APK. Byte-checked dispatcher name + UUID edit; Quest 2 leaves the dispatcher unchanged. See DEVICE_NOTES 'Per-game headset identity' |
 | Startup exits through `libxlua.so (lj_err_throw)`, then Unity aborts in mutex cleanup; captured Lua error is `bad light userdata pointer` (GitHub #257, BattleTalent 4.7) | This older LuaJIT encodes lightuserdata in 47 bits; Frame supplies valid wider native pointers. Controlled tests with the unchanged library pass a real low-address allocation and fail its own high-address static pointer | `frame.luajit_pointers` automatically selects a full-pointer Lua engine only for the verified library SHA-256, retaining xLua bindings and custom helpers. The scoped patch reaches OpenXR startup for 60 s headless; rendering and gameplay remain unverified. A `lj_err_throw` cleanup stack without the original error message is insufficient to infer this cause |
 | A GL4ES Team Beef game draws stretched triangles or spikes across characters and the scene (GitHub #191, Lambda1VR) | The newer GL shim exports GLES draw functions that intercept GL4ES's desktop OpenGL calls, bypassing its client-array and immediate-mode translation | `frame.tbxr_vendor` keeps the shim's five draw symbols private when the APK bundles `libgl4es.so`. GL queries and single-sampled framebuffer fixes remain active; other games retain the draw hooks. A/B eye captures on SteamOS 0.4.5: old shim normal, current shim spikes, current shim with private draw symbols normal at ~72 fps. Worn-headset gameplay still needs confirmation |
@@ -62,7 +61,6 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | The game quits right after start: `Something failed to initialize. Quitting!` / `We don't have write permission to …/files/cloud/data` (for example SUPERHOT); or stays at loading with `UnauthorizedAccessException` in `StartupLoading.Start` (GitHub #239, Jurassic World Aftermath) | The game created a cloud-save folder with mode 1700; inside Lepton the app writes through the folder's group. Its startup routine can fail before the permission watchdog repairs the newly created folder | launch.sh `fix_perms` adds owner + group write to every folder in the game's storage (agent 41). Close and start the game again without uninstalling: the folders are now repaired (Aftermath confirmed in the headset). Agent 84 creates `files/cloud/data` before `fix_perms` and startup, including in upgraded launchers, to prevent the first-start race. Triage `startup-save-permission` fails the launch test despite rendering frames |
 | The whole Frame slows to a halt, then the game is killed (`Out of memory: Killed process … anon-rss:10+ GB`), for example Lucky's Tale | The game's own memory grows ~1 GB/s on Unity's `Loading.PreloadManager` thread (perf page-fault profile); not the flat window, not the text-input patches | none yet: mark unsupported; profile with `perf record -p <pid> -e page-faults --call-graph fp` (works as steamos, `perf_event_paranoid` 2) |
 | A Linux app exits at once: `cannot execute binary file: Exec format error` in launch.log | an x86_64 program started directly (installed before FramePort ran x86 builds through FEX, or by hand) | reinstall it: x86_64 Linux apps install FEX on the Frame and start through it (agent v61, `kind: linux_x86`; FEX also needs `STEAM_COMPAT_DATA_PATH`: "No compat data path?" in launch.log = an agent v60 launcher, reinstall); triage `linux-x86-no-fex`. Prefer an arm64 build when the app offers one |
-| The game closes about a minute after starting, at a different spot each time; `Start proc …:<pkg>:<name> for pre-top-activity`, then `Target app (<pkg>) did not start` (GitHub #178) | The started activity runs in its own process (`android:process`); Lepton watches only the main process (triage `app-separate-process`) | `frame.main_process` (automatic) |
 | `APP_ACTIVITY is empty`, nothing starts | Manifest has category INFO only; Lepton needs LAUNCHER | `frame.launcher` (automatic) |
 | PC VR game on the Frame shows as a flat window / Revive: `Unable to load LibOVRRT DLL` / `LoaderInstance::CreateInstance chained CreateInstance call failed` | Frame SteamVR runtime rejects OpenXR apiVersion 1.1 (`XR_ERROR_API_VERSION_UNSUPPORTED`), which Proton 11's VR helper requests | `pcvr.xr_timefix` (Frame OpenXR layer, default on): retries xrCreateInstance as 1.0 |
 | Unreal PC VR game on the Frame runs as a flat window although OpenXR works (no `LogHMD` OVRPlugin lines; Unreal logs nothing when it skips the Oculus plugin) / launch.log: `FramePort oculushmd: could not create the OculusHMDConnected event` | UE's OculusHMD (and LibOVR's `ovr_Detect`) only start when the Windows event `OculusHMDConnected` exists and is signaled; on a PC the Oculus service creates it. Revive hooks `OpenEventW` for it, but that relies on Detours patching Wine's (ARM64EC) kernelbase | `pcvr.oculus_unreal` (default for Unreal Rift games; PC VR counterpart of overport's `patch_oculus_unreal`): launch.sh runs the injector through `fp_oculushmd.exe`, which provides the real event until the game exits |
@@ -83,10 +81,6 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | A game from an AXRB download starts and stops at once (Steam shows Resume), no OBB on the Frame; or a SideQuest backup adds a second game named after an APK in its `obb/` folder (reddit 2026-10-11) | AXRB keeps its own PC builds in `AXRB/patched/<package>/*-axrb.apk` (OVRPort-converted for its runtime, no OBBs); the scan added them over the original `AXRB/<app id>/<binary id>/base.apk`. SideQuest's VR4 backup has Unreal's `VR4-Android-Shipping-arm64.apk` next to the OBBs | `quest_dump._axrb_patched` skips AXRB's patched copies; a rescan replaces entries made from them; AXRB downloads send every non-APK file next to `base.apk` (DLC, assets) and are named after the package; APKs inside another game's data folder are ignored; SideQuest backups are named after the package folder, not the backup time. docs/FAQ.md has both layouts |
 | Game hangs at start / never loads although its .obb files are right there: next to the APK, in an `obb` folder beside an `apk` folder inside a `<package>` folder, or a SideQuest backup (`<timestamp>_<versionCode>.apk`) (GitHub #85, #91) | No folder named after the package, so the folder-layout checks found nothing and no OBB was uploaded | `quest_dump.find_data` then looks for the files by name, `(main\|patch).<versionCode>.<package>.obb` (any case), in the APK's folder, its parent and up to 3 levels below each (folders with their own APKs are other games); prefers the folder and files of the APK's own versionCode, else the newest older, else any version. When that folder also holds other things (the APK itself, other games' OBBs), the library entry gets `data_files` and only those files are uploaded, counted and deleted with the game. Add the folder again |
 | CryEngine game: `Powered by CRYENGINE`, then SIGTRAP in `libAndroidLauncher.so` during `CreateSystemInterface`, before any OpenXR instance (GitHub #238, The Climb 666.0) | Installed without its OBB: the SideQuest backup has `apk/com.crytek.climb.apk` + `obb/main.com.crytek.climb.obb`, but the scan required a versionCode in the OBB name and skipped it. The reported backtrace's fatal-error call formats `Engine initialization failed: Open Engine Paks: Unable to find "engine" pak files (%s)` | `quest_dump.find_data` accepts `(main\|patch).<package>.obb` as well as numbered names, keeping the original filename. Update on Frame finds the previously skipped data; a rescan finds it too. Analysis version 12 recognizes monolithic CryEngine through `assets/game.cryproject`, Vulkan through `assets/system.cfg` (`r_Driver = vk`), and an expected OBB through the launcher's expansion-path format strings; a missing OBB now gets the existing `missing-obb` warning/finding. This fixes the original missing-content startup failure; the rendering failures below were found once the data was installed |
-| CryEngine game (The Climb 1/2) on FramePort 1.3.0: `Messagebox: cap: Engine initialization failed!  text:CrySystem initialization failed!` right after the renderer lists its Vulkan device extensions, then SIGSEGV in `CSystem::ShutDown` (GitHub #432/#449) | 1.3.0 links the dormant foveation diagnostic `libVkLayer_fdm_darken.so` into every arm64 game's engine library; in CryEngine's `libCryRenderVulkan.so` that stops CrySystem from starting. Bisected headless on the dev Frame: the new build runs once only its renderer is the unmodified one | `foveation.diagnostic_support` skips `libCryRender*` (Climb 2's private VrApi bridge still loads the layer); `frame.adapter` package revision 3 for both Climb games marks their builds for Update on Frame. Triage `cryengine-init-failed` |
-| QuestCraft: Minecraft never starts, `libjvm.so not found`; no `files/runtimes/` folder in the game's storage; the log shows `Transports: ETHERNET` (GitHub #18, #468) | pojlib's `API.hasConnection()` only counts Wi-Fi and Lepton's Android reports Ethernet, so the Java runtime download is skipped | `frame.pojlib_connection` makes `hasConnection()` return true (dex edit; catalog + QuestCraft's package, new scans by analysis field). Workaround: unpack QuestCraft's `JRE.zip` into `files/runtimes/JRE` with the Files tab. Triage `questcraft-no-java-runtime` |
-| Nothing starts, `APP_ACTIVITY is empty`, although the manifest has category LAUNCHER: it sits on an `<activity-alias>` (Flycast-based HOTD2 VR: `MainActivity` → `NativeGLActivity`, GitHub #400/#469) | Lepton only starts real activities | `frame.launcher` gives the alias's target activity its own MAIN/LAUNCHER intent-filter (the alias's categories; inserted after the activity's start element) and turns the alias's LAUNCHER into INFO (`axml.launcher_from_alias`); the validator's "Launchable in Lepton" check now requires a real activity |
-| A game shows UTC instead of local time (Walkabout Mini Golf's clock, GitHub #429); in the container `getprop persist.sys.timezone` = `../usr/share/zoneinfo/<Zone>` | Lepton sets the zone from a bare `readlink /etc/localtime` minus `/usr/share/zoneinfo/`, and SteamOS' link is relative | Lepton launchers put `~/.local/share/frameport/lepton-shims` first on PATH (agent `TZ_LINE`, `upgrade_launchers` adds it); its `readlink` answers `/etc/localtime` with the resolved path. Checked on the dev Frame: `America/New_York`, `date` in EDT. A boot property line from FramePort can't override it (Lepton writes its own line later) |
 | The Climb 666.0: audio with no headset picture, `OVRPortVrApi: Unsupported frame flags or swap interval`; then SIGSEGV in `vulkan.freedreno.so` during `vkCmdEndRenderPass` once frames are accepted (GitHub #238) | The game submits the obsolete Quest texture-density debug flag (`0x100`), which the bridge rejected. It also binds the bridge's full-rate texture as a fragment-density attachment even though foveation support is reported off; Turnip reads density maps on the CPU, but an ordinary sampled image has no mapped backing memory | Updated `frame.vrapi_bridge` accepts the compositor debug/volume flags and creates the compatibility texture with `VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT`. Do not gate that usage on the advertised format features (the Frame reports R8G8_UNORM without the density bit). `device.files` selects `r_vr_foveated = 0` when the engine contains that cvar; The Climb 2 keeps `r_variable_rate_shading = 0`. Triage `vrapi-frame-rejected` marks rejected frames as fatal despite pacing logs. Picture confirmed on the headset. With the corrected config, an uncapped launch stayed running for over four minutes at a median 72 fps with no native crash or GPU fault. The user confirmed working menus and gameplay on 2026-10-12 |
 | Unreal game: `JNI_OnLoad` (OVRPlugin), then silence: no OpenXR instance, no crash, no frames (GitHub #85 TRIANGLE STRATEGY; launch-test finding `missing-obb`) | Installed without its OBB: the manifest says `com.epicgames.ue4.GameActivity.bHasOBBFiles` = true (UE5: `com.epicgames.unreal.…`) but the library has no data folder (`data_dir` null, `data_bytes` 0) | Put the .obb files in a `<package>` (or `obb/`) folder next to the APK, add the folder again, reinstall. Analysis `extra.expects_obb`; the game page, the install question and `frameport scan`/`install` warn; launch tests that sent no frames get the `missing-obb` finding from the library (the game logs nothing). Unity split-binary builds count too (`extra.unity_split`, `analysis/unity_split.py`): an XR-plugin build (Oculus XR Plugin / Unity OpenXR library) without `assets/bin/Data/UnitySubsystems/` in the APK, or BuildSettings listing more scenes than the APK has `levelN` files (globalgamemanagers loose or read from the head of data.unity3d); exact on the 48 Unity APKs of the dumps (13 split, 17 full games; OBBs of full builds are asset bundles or sound banks) |
 | Unreal game: launch.log ends with `ActivityTaskManager: START u0 {… cmp=<pkg>/.DownloaderActivity}` and `Displayed <pkg>/.DownloaderActivity`, then nothing: no OpenXR instance, no crash (GitHub #159 Contractors; triage `unreal-obb-check-stuck`, also when the OBB is on the Frame) | Epic's DownloaderActivity (started by GameActivity.onResume before the engine's main init) checks every OBB's name + size compiled into the APK (OBBData); with manifest meta-data `com.epicgames.ue4.GameActivity.bVerifyOBBOnStartUp=true` it then reads the whole OBB and compares each entry's CRC32 (cached in `files/cacheFile.txt` by the OBB's mtime). Its progress and error screens are invisible in Lepton (headless VR); a CRC mismatch waits for a button forever. A missing / wrong-size OBB starts Google Play's downloader (or a "No Google Play Store Key" dialog) and also waits | `frame.unreal_skip_obb_check` (suggested by analysis `unreal_verify_obb`): sets that meta-data to false (one boolean in the manifest, `axml.set_meta_data_bool`), which skips only the CRC pass. Still stuck: the OBB doesn't match the APK version (name `main.<versionCode>.<pkg>.obb` and its size) - copy APK + OBB from the same install |
@@ -123,7 +117,7 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Vermillion: the hand and brush disappear over the canvas while painting, but still paint (GitHub #200) | the game shows a canvas being painted as its own compositor (quad) layer and turns the canvas's scene renderer off; the Frame draws quad layers above every projection layer whatever the order, so the canvas covers the hand (Vulkan game: no GL layer emulation) | `frame.vermillion_scene_canvas` (catalog): `PaintableMesh.HasCompositorLayerAvailable` / `ShouldUseCompositorOverlay` -> false in libil2cpp.so (Cpp2IL), so the game's own fallback draws the canvas in the scene (Klownicle's finding) |
 | Unity game hangs right after its first frames, no `pacing:` lines; SIGQUIT dump shows UnityMain in a game library's `JNI_OnLoad` → `usleep` (for example SKYBOX: `libskybox.so`, `SignatureChecker`) | the game checks its APK signing certificate; every port is re-signed | can't be fixed without defeating anti-tamper (FramePort doesn't): mark "Can't run". Diagnose hangs: `podman exec <container> kill -3 <pid>` writes all thread stacks to launch.log |
 | Video player doesn't list sent videos (for example 4XVR "Internal Storage" only shows some) | the player lists its own /sdcard folder (4XVR: /sdcard/4XPlayer), not /sdcard/Movies; Android's media index doesn't work in Lepton | game page "Add videos" / game menu "Add videos and files" (Videos + the app's own folder, hard links) or `frameport frame send <files> --app <pkg>` |
-| One eye gray in a stereo video, log `xrCreateSwapchain … result=-10` | the runtime refused a swapchain (XR_ERROR_LIMIT_REACHED) | GLES: `adapter.swapchain_pool=1` shares extra panel images in atlases (#387; headset validation pending). This is a count cap, so lowering resolution does not fix it; Vulkan unaffected |
+| One eye gray in a stereo video, log `xrCreateSwapchain … result=-10` | the runtime refused a swapchain (XR_ERROR_LIMIT_REACHED) | fewer/smaller swapchains: lower `equirect_res`; unresolved |
 | VrApi game (32-bit bridge or `frame.vrapi_bridge`): holding the menu button to recenter turns the view ~90-120 degrees to the side | the bridge's app space is LOCAL + the head's yaw at the start; the Frame's recenter moves LOCAL to the head, so the old yaw was added again | fixed in the VrApi bridge (2026-10-13): on XR_TYPE_EVENT_DATA_REFERENCE_SPACE_CHANGE_PENDING (LOCAL) and on `vrapi_RecenterPose` it takes the origin from the head again (log `recentered: head yaw …`); rebuild the game |
 | Menu/screen jumps to where you look (for example 4XVR) | the app re-creates LOCAL spaces (4XVR: every 2–4 s) and the Frame places them at the current head yaw, or the app recenters after the Frame's brief focus dips | turn on `adapter.layer_debug`, check `that LOCAL space sits at … deg` vs `focus_hold: hid a … ms focus dip`; patches: `adapter.stable_local` (new LOCAL spaces line up with the first) / `adapter.focus_hold` (on by default: hides dips up to `focus_hold_ms` once the game has been focused for a second; never at start-up: a global debounce broke AC Nexus) |
 | Pointer misses menu items | the Frame's aim pose differs from Touch's | `adapter.layer_debug` logs `aim in grip … pitch/yaw`; correct with `aim_pitch`/`aim_yaw`/`aim_forward` (`frameport settings`, no rebuild) |
@@ -206,16 +200,7 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Mixed reality inside out: the room shows on the game's objects, black where the room should be (Unreal, for example Star Wars: Beyond Victory, GitHub #329) | Unreal keeps 1 - coverage in the scene alpha and OVRPlugin chains XrCompositionLayerAlphaBlendFB (colour factors ONE_MINUS_SRC_ALPHA / SRC_ALPHA, `layer_debug` shows `n=1000041001(3,2/3,2)`) to the eye layer; the Frame's runtime ignores it | adapter `alpha_blend_emul=1` (default, Vulkan): inverts the alpha of the eye images in place while passthrough is emulated; logs `alpha_blend: inverting the alpha of swapchain=…` |
 | Quest Touch controllers (or none) shown in a game that uses Meta's runtime controller models | XR_FB_render_model missing on the Frame | adapter `controller_models=1`: the agent converts the Frame's SteamVR controller models to glb at install, the adapter serves them. Games with their own controller meshes aren't affected (none of the 34 catalog games use runtime models) |
 | `overportOXR: Unknown proc addr: xr…` for a function the adapter emulates | overport's dispatcher only forwards functions in its own table | route the plugin's lookups through `native/xrshim` (done for XR_FB_render_model when `controller_models=1`) |
-| MR game asks for a room scan | The game requested a new room through Meta scene capture | FramePort scans in the headset and loads the new room. `scene_scan_request=0` turns it off and uses the stored room. |
-| MR game stuck waiting for room data (e.g. Demeter) | No Meta scene API | `adapter.scene_emul=1` (+ `frame.meta_permissions`); Frame → Room → Use my play area, or import a scanned room |
-| Unity MR game rejects every room / its "use guardian" fallback does nothing; `ovrpBoundary_Outer is not supported`, `IndexOutOfRangeException` in a guardian check (e.g. Demeter's `RemoveObjectNotInGuardian`) | OVRPlugin calls the Frame's 1x1 m STAGE rect a configured boundary but can't give its outline | `adapter.scene_hide_bounds=1` (with `scene_emul`): FrameBridge then answers the app's STAGE `xrGetReferenceSpaceBoundsRect` with `XR_SPACE_BOUNDS_UNAVAILABLE` (log `scene: STAGE bounds hidden`). Per game only: NOPE stalled without a play area. Demeter also needs a floor of at least 2.5 x 2.5 m, as on a Quest |
-| MR game with `scene_emul` never asks for the room (no `scene: query`/`discovery` lines), black screen or MR mode with no room (e.g. NOPE, Pinball FX); `m_XR_META_boundary_visibility extension is not supported` every frame | Meta's scene/anchor permissions undeclared (Lepton can't grant them); boundary suppression unsupported | `frame.meta_permissions` (now with every `scene_emul` recipe of a USE_SCENE/USE_ANCHOR_API game, migration `scene_permissions`); FrameBridge emulates `XR_META_boundary_visibility` (log `scene: boundary suppressed`). `passthrough:` lines show the app's passthrough calls |
-| Build says `Unity text fields: not fixed: Cpp2IL couldn't start on this PC` (older versions: `Cpp2IL couldn't read this game's code: at Cpp2IL.Program.Main`) | .NET aborts without libicu (fresh WSL/Linux) | FramePort runs Cpp2IL with `DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1`; such failures aren't cached, so the next build retries |
-| MR uses an empty/simple room; FrameBridge `scene: capture requested -> guardian box` / `using guardian room`, `room from guardian`, or fallback box dimensions (`mr-no-room`) | No saved room, so FrameBridge uses its guardian box | Save a room in Frame → Room. A real SteamVR boundary supplies walls; Valve's default circle is refused. Import a scanner-built room for furniture/mesh; headset capture is not implemented yet |
-| `Unknown proc addr: xrDiscoverSpacesMETA` or MRUK `NoRoomsFound` (`mr-discovery-unsupported`) | Scene discovery is unavailable or no room was discovered | Enable `adapter.scene_emul`, rebuild/reinstall to get the updated extension shim, then save a room. All games declaring USE_SCENE or USE_ANCHOR_API now get this suggestion |
-| MR game: virtual objects (e.g. Laser Dance's lasers) vanish when you come close to them | Meta's Depth API occlusion: the Frame has no depth sensor (XR_META_environment_depth), so the environment depth the occlusion shaders read is never valid and near objects count as hidden behind the room | `frame.meta_depth_occlusion` (Unity IL2CPP; offered, not turned on, when the game has the HARD_OCCLUSION / SOFT_OCCLUSION keywords; analysis `meta_depth_occlusion`): EnvironmentDepthManager's checks -> false and its keyword setter does nothing (Cpp2IL), the keywords renamed in the asset files that contain them; Laser Dance's known build also gets its laser materials/LODs fixed. From PR #246; not checked in the owner's headset yet |
-| Unity MR game keeps asking for a room scan / `No scene model found` although FrameBridge served a room (OVRSceneManager with ActiveRoomsOnly) | OVRSceneManager loads only the room whose floor outline contains the player (IsUserInRoom); with the play-area room the player can stand outside it (FrameBridge logs the head against the floor outline: `scene: head in STAGE ... OUTSIDE the floor outline`) | Scan the room first (Frame → Room). Still stuck: `frame.unity_scene_active_rooms` (catalog or by hand, Unity IL2CPP scene games): IsUserInRoom / PointInPolygon2D -> true (Cpp2IL). From PR #246 (Laser Dance) |
-| MR game with many quads (21+): frames refused with `XR_ERROR_LAYER_LIMIT_EXCEEDED` (e.g. Punch Fit) | The runtime takes at most maxLayerCount (16) layers | FrameBridge keeps the projection layers and its own fade quad, then the app's other layers in submission order up to the limit (log `xrEndFrame: N layers exceed the runtime limit 16`). From PR #246 |
+| MR game stuck waiting for room data (Demeter) | no Meta scene API | adapter `scene_emul=1` (+ `frame.meta_permissions`) |
 | Hand-tracking game janky (Silhouette) | Frame synthesizes hands from controllers | `controller_fix=0` passes hands through; not really fixable |
 | Eye distortion while moving (Arcsmith, Time Stall) | unknown (not eye swap, tracking, Valve layers, depth or pacing) | unresolved |
 | The Climb 666.0: hand outlines ripple in both eyes while menus and gameplay work (GitHub #238) | Unknown. Sessions paced around 72 fps, controller tracking reported valid, and SteamVR motion smoothing was already off; these checks do not establish the cause | Unresolved after wearer comparisons on 2026-10-12: disabling Valve's Vulkan layers, setting `r_AntialiasingMode = 1`, and setting `r_AntialiasingMode = 0` with `r_MotionBlur = 0` each gave the same or worse result. These were config comparisons; runtime cvar values were not verified. Restored the playable configuration (`r_vr_foveated = 0` with the default Vulkan layers), retaining the startup/rendering crash fixes above. Do not keep the unsuccessful experimental settings as a fix |
@@ -117,10 +117,6 @@ Hooks (`steps.HOOKS`) cover what a real Frame would do:
 - `pairing_done`: the Frame ran the setup command, so FramePort connects.
 - `live_stream`: a test picture through the real relay.
 - `monitor_details`, `type_tab`, `select_files` and `settings_section`.
- `open_room` (the Room tab with the pretend Frame's room drawn) and `room_editing` (its editing cards: `cleanup`,
-  `more`, `box`, `doors`, `suggestion`). The room is a made-up bedroom built in code (`fakes.fake_room`, never a real
-  scan): a bed under a wall-mounted TV, a desk with two monitors under a window, a closet, a door, a lamp and a plant,
-  with a noisy scanned-surface mesh and a clean-up report and labels that match it.

 In a video, clicking Install runs the scripted install, and the game is then installed on the pretend Frame.

@@ -1,49 +0,0 @@
-# Phase 0: reading Valve's RoomView 3D mesh (dev Frame, SteamOS 0.4.5 build 20261007, 2026-10-16)
-
-Result: **a third-party OpenVR client can read the passthrough depth mesh, and it carries enough of the room for
-a scan** (floor, table-height surfaces, orthogonal walls; the ceiling only weakly).
-
-## Access
- Background OpenVR app (`VR_InitInternal2(..., VRApplication_Background)`, never starts SteamVR) through
-  `/opt/steamvr/bin/linuxarm64/libopenvr_api.so`.
- `FnTable:IVRBlockQueue_005`: `Connect("/xrservice/roomview3d/meshData")` and `.../meshLayout` work (created by
-  Valve's cv driver; no exclusivity seen next to the compositor's own reader). Read with
-  `WaitAndAcquireReadOnlyBlock(queue, &block, &buffer, EBlockQueueReadType_New, timeout_ms)` + `ReleaseReadOnlyBlock`.
- Metadata through the C++ interface `IVRPaths_002` (vtable slot 0 `ReadPathBatch(root, PathRead_t*, n)`, slot 2
-  `StringToHandle(&handle, path)`; `FnTable:IVRPaths_001` doesn't exist), root = the **block** handle, except
-  `/meshData/meshIsUpToDate` which is a property of the **queue** handle:
-
-| path | tag | meaning |
-|---|---|---|
-| `/meshLayout/layoutId` | 3 (u64) | id of the index layout (static while the mesh resolution stays) |
-| `/meshLayout/vertexCount` | 2 (i32) | 16896 = 132 x 128 |
-| `/meshLayout/indexCount` | 2 | 99822 (u32 triangle indices into the grid, row width 132) |
-| `/meshData/meshId` | 3 | frame counter (~30 per second while passthrough runs) |
-| `/meshData/layoutId` | 3 | matches the layout block |
-| `/meshData/elementCount` | 2 | floats in the data block (vertexCount x 3) |
-| `/meshData/rawFromMeshPose` | 20 (HmdMatrix34) | mesh -> SteamVR raw tracking space |
-| `/meshData/posePredictionBaseTime` | 7 (f64) | seconds (system uptime clock) |
-| `/meshData/meshIsUpToDate` (queue) | 4 (bool) | false in standby / headset off |
-
- STAGE (= standing universe) = `IVRSystem_023` vtable slot 13 `GetRawZeroPoseToStandingAbsoluteTrackingPose()` x
-  rawFromMeshPose. Check: the mesh origin is 6.7 cm from `GetDeviceToAbsoluteTrackingPose(Standing)`'s head
-  position in every frame (camera vs head centre). **The raw->standing transform changes during a session** (its
-  height went 1.60 -> 1.07 m while recording: Valve's floor estimate) -> capture raw poses and convert all frames
-  with the transform at the end of the capture.
-
-## The mesh
- A fixed fan of view directions, +Z forward, rows top->bottom (row 0 = up in the image, -Y), ~126 deg across the
-  corners (corner directions ~(+-0.67, +-0.66, 0.34)); one depth per grid point. Not head-locked in world terms:
-  its pose is the passthrough camera pose at capture.
- Range: reliable ~0.3-4 m; far values are inpainted (up to ~10 m) -> drop > 4 m. Strongly smoothed (soft edges,
-  small objects lost); locally planar: plane-fit residual of 12x12 patches median 5-17 mm.
- First frames after tracking starts can have NaN poses -> skip non-finite frames.
- Fused normals (60 s of looking around, ~3 frames/s used): floor clearly at y ~= 0, a table-height surface at
-  0.7 m, a lower one at 0.5 m; vertical surfaces in two orientation clusters ~85 deg apart (orthogonal walls), wall
-  offsets readable; ceiling: few down-facing points (people rarely look straight up; prompt for it).
- Data rate: 16896 x 12 B vertices + 99822 x 4 B indices per frame (the dump repeats the indices per frame).
-
-## Consequences for the design
- Capture = stdlib Python on the Frame (ctypes), as above; the C scanner works offline on the dump.
- Scanner input quality: smooth, noisy at depth discontinuities; walls/floor via normals + RANSAC are robust;
-  furniture only as coarse boxes; ceiling needs a guided "look up" step, else the default height.
@@ -1,113 +0,0 @@
-# FramePort room files (mixed reality)
-
-Quest MR games read a room model (floor, ceiling, walls, furniture, a global mesh) through Meta's scene APIs. The
-Steam Frame has no such data for apps (see docs/FRAME_RUNTIME.md "Room data"), so FramePort scans the room itself
-(`fp_roomscan`) and FrameBridge (`native/adapter/scene_emu.c`) serves it to games. This file is the contract between
-the scanner, the Frame agent, the PC app and FrameBridge.
-
-## Coordinates
- Everything is in **STAGE space** = SteamVR's standing universe = OpenXR `XR_REFERENCE_SPACE_TYPE_STAGE`:
-  metres, right-handed, +Y up, floor at y = 0, -Z = the universe's forward.
- A room belongs to one chaperone universe (`universe` line). The Frame sometimes starts a new universe without
-  relocalizing; then the stored room may be misaligned (the agent reports `aligned: false`, nothing breaks).
-
-## room.txt (UTF-8 text, one record per line, `#` starts a comment, fields separated by spaces)
-```
-frameport-room 1                    # magic + format version (required, first line)
-universe <decimal u64>              # chaperone universe id the room was scanned in (0 = unknown)
-source scan|boundary|box|manual     # how it was made
-time <unix seconds>
-room <uuid>                         # the room anchor
-floor <uuid> <y>                    # floor height (normally 0)
-ceiling <uuid> <y>                  # ceiling height
-outline <n> x0 z0 x1 z1 ... x(n-1) z(n-1)
-                                    # floor polygon, n >= 3, not closed, POSITIVE signed area:
-                                    # sum(x[i]*z[i+1] - x[i+1]*z[i]) > 0 (turning from +X towards +Z; seen from
-                                    # above with -Z forward that is clockwise). Readers reverse a negative outline.
-wall <uuid> x0 z0 x1 z1 <y0> <y1> [LABEL]
-                                    # one wall face from (x0,z0) to (x1,z1), bottom y0, top y1.
-                                    # Its normal points INTO the room: walls follow the outline's order, and the
-                                    # inward normal is (-dz, dx)/|d| for d = (x1-x0, z1-z0).
-                                    # LABEL (optional, default WALL_FACE): INVISIBLE_WALL_FACE for an edge the
-                                    # scanner closed without seeing a wall (open side of a room, doorway gap).
-volume <uuid> <LABEL> cx cz top_y yaw_deg w d h
-                                    # furniture box: top-face centre (cx, top_y, cz), yaw about +Y in degrees
-                                    # (0 = local X along world X), width w along local X, depth d along the
-                                    # horizontal local axis perpendicular to it, height h downwards from the top
-plane <uuid> <LABEL> px py pz qx qy qz qw w h
-                                    # extra 2D plane (DOOR_FRAME, WINDOW_FRAME, WALL_ART, ...): pose of its centre,
-                                    # Meta convention (bounds in local XY, local +Z = the plane's normal)
-mesh <uuid> <file name> <vertex count> <index count>
-                                    # global mesh sidecar in the same folder (GLOBAL_MESH entity)
-```
- `<uuid>` = 32 lowercase hex digits (no dashes). New ones per scan; FrameBridge uses them as the XrUuidEXT bytes.
- Labels are Meta's semantic label strings: FLOOR, CEILING, WALL_FACE, INVISIBLE_WALL_FACE, TABLE, COUCH, BED,
-  STORAGE, SCREEN, LAMP, PLANT, DOOR_FRAME, WINDOW_FRAME, WALL_ART, OTHER, GLOBAL_MESH.
- Readers ignore unknown record types (forward compatibility) and reject a file whose first line isn't
-  `frameport-room <version>` with a version they know. Missing ceiling -> 2.5 m above the floor. Missing walls ->
-  walls from the outline edges. Missing outline -> the bounding rectangle of the walls.
-
-### How FrameBridge maps records to Meta entities (scene_emu.c)
- ROOM: ROOM_LAYOUT (floor, ceiling, walls in file order) + SPACE_CONTAINER (every other entity) + LOCATABLE/STORABLE.
- floor/ceiling: pose at the outline centroid at height y; local +Z = +Y (floor) / -Y (ceiling);
-  BOUNDED_2D = the outline's bounding rect in local XY; BOUNDARY_2D = the outline polygon in local XY.
- wall: pose at the segment midpoint, height (y0+y1)/2; local +X along the wall (x0,z0)->(x1,z1), local +Y up,
-  local +Z = inward normal; BOUNDED_2D = length x (y1-y0) centred.
- volume: pose at the top-face centre, rotation = yaw about +Y then local +Z pointing up (+Y); BOUNDED_3D offset
-  (-w/2, -d/2, -h), extent (w, d, h) (Meta: volumes hang below their anchor); BOUNDED_2D = the top face (w x d).
- plane: pose as given; BOUNDED_2D = w x h centred.
- mesh: entity at the identity pose labelled GLOBAL_MESH with TRIANGLE_MESH (XR_META_spatial_entity_mesh).
-
-## room-mesh.bin (little-endian)
-```
-char[4] "FPRM", u32 version = 1, u32 vertex_count, u32 index_count,
-float32 xyz[vertex_count], u32 indices[index_count]   (triangles; counter-clockwise seen from the room's inside)
-```
-Coordinates in STAGE space. Kept below 200k triangles (decimated).
-
-## Raw files and scan.json (scanner sidecars)
-`fp_roomscan` refines its output by default (docs/mr/scan.md "Refinement"). `room.txt` + `room-mesh.bin` are always
-the refined room (what games and the GUI read; the contract above is unchanged). Next to them:
- `room-raw.txt` + `room-mesh-raw.bin`: the scanner's unrefined output in the same formats (its `mesh` record names
-  `room-mesh-raw.bin`). Same UUIDs as the refined room.txt, so anchors stay the same when the room is refined again.
-  The refined room differs in: the ceiling height (re-estimated from the scan, wall tops follow it), the volumes
-  (after the label rules) and the mesh. Records the scanner doesn't model (e.g. `plane`) are copied verbatim.
- `scan.json` (UTF-8 JSON, `version` 1):
-  ```
-  {"version": 1,
-   "heads": [[x, y, z], ...],          # head path of the recording (STAGE), <= 2000 points, decimated evenly
-   "refine": {"refine": 1, "walls": "panels", "band": 0.35, ..., "erase": [[x, y, z, r], ...]},
-                                       # every refinement setting used (keys = the CLI options, docs/mr/scan.md)
-   "report": {"triangles", "kept", "structural", "near_walls", "outside", "small_pieces", "thin_pieces",
-              "erased", "walked", "tops", "panel_triangles", "truncated", "walked_skipped", "floor_y",
-              "ceiling_y", "boxes", "relabelled", "removed_boxes", "suggestions",
-              "plane_shifts": [{"kind": "wall"|"floor"|"ceiling", "wall": i, "shift": m}, ...]},
-   "labels": [{"from": "COUCH", "to": "TABLE"|null, "reason": "top 0.69 m", "suggest": "door"|"closet" (optional),
-               "id": "<volume uuid>", "box": {"cx", "cz", "top_y", "yaw_deg", "w", "d", "h"}}, ...],
-                                       # one per scanner volume, in room-raw.txt order; to = null: removed
-   "suggestions": [{"kind": "door"|"closet", "box": {...}, "wall": i, "along": t, "reason": "..."}, ...]}
-                                       # tall thin slabs; never applied by the scanner. wall = index of the nearest
-                                       # wall record in room-raw.txt, along = 0..1 position on it (from x0,z0)
-  ```
-  `report` counts triangles of the raw mesh per pass (`panel_triangles` are added ones), `wall` in `plane_shifts`
-  indexes the wall records. Readers ignore unknown keys.
- `fp_roomscan --refine-only <dir>` re-runs only the refinement from these files (an older folder without them:
-  its room.txt + mesh are copied to the raw names first). Publishing order: [raw mesh, raw text,] `scan.json`,
-  `room-mesh.bin`, `room.txt`.
-
-## Where the files live
- Frame: `~/.local/share/frameport/rooms/<universe>/room.txt` + `room-mesh.bin` (+ `scan.log`, the raw files and
-  `scan.json` above).
-  `~/.local/share/frameport/rooms/current` = symlink to the newest room's folder.
- Per game: launch.sh copies the current universe's room (else `current`) to `<app_dir>/room.txt` (+ mesh) before
-  Lepton starts, next to `settings.conf`; FrameBridge reads `dirname($FRAMEBRIDGE_CONFIG)/room.txt`. No room ->
-  the old guardian box.
- A game's own saved anchors: `/sdcard/Android/data/<pkg>/files/framebridge-anchors.txt`
-  (`anchor <uuid> px py pz qx qy qz qw` per line, STAGE space), written by FrameBridge on save/erase.
-
-## Scan dumps (*.fprs) — recorded RoomView 3D meshes, input of `fp_roomscan --offline`
-```
-char[4] "FPRS", u32 version = 1, then frames until EOF:
-  f64 time_s, float32 pose[7] (px py pz qx qy qz qw: mesh -> STAGE), u32 vertex_count, u32 index_count,
-  float32 xyz[vertex_count] (mesh space), u32 indices[index_count]
-```
@@ -1,216 +0,0 @@
-# Scene emulation stream
-
-Implemented against `ROOM_FORMAT.md` without changing the contract, patch revisions, agent version or analysis version.
-No Frame access or external downloads were used. Headset behavior still needs maintainer verification.
-
-## Implementation
-
- `scene_emu.c` owns entities, component APIs, pose transforms, bounded query snapshots and the event queue.
-  `scene_room.c` parses room files and meshes; `scene_meta.c` implements META discovery and batch persistence;
-  `scene_anchors.c` implements per-game saved anchors. All are included by the adapter, with no new dependencies.
- At session creation, read `dirname(FRAMEBRIDGE_CONFIG)/room.txt`. Invalid magic/version, unusable geometry or
-  absent files retain the original guardian box, settings and seven deterministic UUIDs. Unknown records are
-  ignored; malformed records are logged and skipped. Missing ceiling, outline and walls follow the contract.
- Floor/ceiling use the polygon area centroid and real local-XY polygons. Walls retain file order, with local +X
-  along their segment, +Y up and +Z inward. Furniture poses use yaw then +Z up; volume bounds extend downwards.
-  The room container includes every other room-file entity, excluding independently created application anchors.
- Geometry exposes BOUNDED_2D, BOUNDED_3D, semantic labels and TRIANGLE_MESH as appropriate. OpenXR has no separate
-  `BOUNDARY_2D` component enum: `xrGetSpaceBoundary2DFB` belongs to BOUNDED_2D. Labels preserve comma-separated strings.
-  All variable-sized outputs support count-only and insufficient-capacity calls, including independent mesh arrays.
- Limits: 2,048 entities including application anchors, 1,024 outline points, 255 label bytes, 64 KiB record lines,
-  one global mesh, 600,000 vertices/indices (200,000 triangles) and 16 MiB mesh payload. Sidecar filenames cannot
-  escape the config directory. Magic, version, counts, exact byte size, finite coordinates and indices are checked.
- FB queries and META discovery snapshot results under the mutation lock, before queuing available/complete events.
-  META component/UUID filters intersect; unrecognized filters impose no restriction. FB max-result limits are honored.
-  There are 64 retained query snapshots and 63 queued events; calls that cannot fit their events return
-  `XR_ERROR_LIMIT_REACHED`. Geometry readers share the mutation lock with persistence.
- Application anchors use kernel randomness (`getrandom`, then `/dev/urandom`), never index-derived UUIDs.
-  Saved poses are in STAGE space. FB/META saves write a private temporary file, flush/fsync, then rename to
-  `/sdcard/Android/data/<package>/files/framebridge-anchors.txt`. A process suffix such as `:game` is stripped.
-  Erase removes application anchors from disk and the discoverable in-memory set. Failed writes report failure
-  through completion events and restore memory. Room-file entities remain owned by the scan: save/erase are no-ops
-  for those entities. Storage is local; there is no cloud synchronization.
- A new session reloads the room and saved anchors. Fake handles fit both adapter ABIs and include a session
-  generation; erased/stale fake spaces are never passed to SteamVR. Session generations wrap after 256 sessions.
- Capture completes immediately and logs exactly `scene: capture requested -> scanned room` for a usable room file,
-  or `scene: capture requested -> guardian box` for the fallback. The former covers all file sources, including manual
-  and boundary files. The load summary preserves the actual `source` and `universe`.
-
-The cached `openxr-f2448a8797` headers already contain discovery, persistence and mesh declarations and enum values.
-No local structure/enum substitutes were necessary. Both META extensions are added to the existing conditional
-extension advertisement/instance filtering. Their system capability structures report support when emulation is active.
-Passthrough and unrelated adapter settings are unchanged.
-
-## Routing and integration
-
-All of the following use `scene_emulation` through **both** the adapter's normal `xrGetInstanceProcAddr` and
-`framebridge_extension_proc`, reached through xrshim's existing name-agnostic lookup:
-
-```
-xrQuerySpacesFB                         xrRetrieveSpaceQueryResultsFB
-xrGetSpaceUuidFB                        xrEnumerateSpaceSupportedComponentsFB
-xrSetSpaceComponentStatusFB             xrGetSpaceComponentStatusFB
-xrGetSpaceContainerFB                   xrGetSpaceRoomLayoutFB
-xrGetSpaceBoundingBox2DFB               xrGetSpaceBoundingBox3DFB
-xrGetSpaceBoundary2DFB                  xrGetSpaceSemanticLabelsFB
-xrRequestSceneCaptureFB                xrCreateSpatialAnchorFB
-xrSaveSpaceFB                          xrEraseSpaceFB
-xrGetSpaceTriangleMeshMETA              xrDiscoverSpacesMETA
-xrRetrieveSpaceDiscoveryResultsMETA     xrSaveSpacesMETA
-xrEraseSpacesMETA
-```
-
-The shim additionally routes `xrPollEvent`, `xrGetSystemProperties`, `xrLocateSpace`, `xrLocateSpaces`,
-`xrLocateSpacesKHR` and `xrDestroySpace` to the adapter while scene emulation is active. Other shim names continue to
-OVRPort, preserving existing haptics/render-model handling. The real shim is host-tested against a dispatcher that
-refuses every scene function; every emulated scene lookup succeeds and an actual discovery/retrieve round trip runs.
-
-**Plumb-stream requirement:** ensure `scene_emul=1` also installs xrshim and rewrites OVRPlugin's loader string to it.
-The pre-existing adapter patch only did this for other shim settings. These files are outside this stream's ownership.
-Delivery of room files before Lepton starts and detection of universe misalignment also belong to plumb. FrameBridge
-serves the supplied coordinates; it does not silently transform a room belonging to another universe.
-
-No contract changes are needed. Whether each MRUK version accepts a room without further permissions, how it chooses
-volume versus mesh geometry, and whether its visible placement matches the scan need headset tests. The existing
-single-active-session architecture is retained; simultaneous independent sessions are not implemented.
-
-## Offline verification
-
- 25 host tests passed, compiling the actual emulation and shim. Coverage includes malformed records, unknown
-  records, mesh corruption/path/cap checks, derived geometry, 300 walls, poses/normals, all buffer sizing idioms,
-  discovery event order/filters/backpressure, UUID query/discovery of saved anchors, new sessions/processes,
-  FB/META save/erase and atomic-write failure rollback.
- ASan/UBSan: scanned room, generated walls and box cases passed. LeakSanitizer was disabled because this sandbox
-  prohibits ptrace; its default exit failed with that environmental limitation.
- `python native/build.py --only adapter,xrshim` succeeded from cached tools. Two final builds were byte-identical,
-  including `SHA256SUMS`. The shim was rebuilt and is byte-identical to its previous artifact (the routing lives in
-  the adapter). Artifact content changes are the two adapter binaries and two checksum lines.
- Full pytest was attempted: **1,771 passed, 40 skipped, 11 failed, 16 errors**. All 27 failing/erroring tests create
-  local HTTP sockets, which the sandbox prohibits (`PermissionError: [Errno 1] Operation not permitted`). They are
-  in `test_deeplink`, `test_devkit`, `test_install_links_extra`, `test_livestream`, `test_setup_url` and `test_ui_state`.
-  With exactly those 27 tests deselected, and the additional real-shim test included: **1,772 passed, 40 skipped,
-  27 deselected**. An unrestricted maintainer run of the whole suite is still required.
- The worktree had no usable venv. Verification reused the existing local dependencies through an ignored venv
-  `.pth`, with `PYTHONPATH="$PWD/src"`, `UV_CACHE_DIR=/tmp/frameport-uv-cache`, `UV_OFFLINE=true` and
-  `uv run --no-sync pytest`. No dependencies were downloaded. The build cache was made a local directory with
-  symlinks to cached tools/headers so generated shader files stayed inside this writable worktree.
-
-Adapter SHA-256:
-
-```
-arm64-v8a:   a90c8d58904857bc198a48fd7a411b7807f68f14fa58fd268c57e2c2ca87e389
-armeabi-v7a: 92daecaf5b86e1857ee8a61b76598e5645f8b427e5f373067c1f87bf8ff99d07
-```
-
-## Maintainer device tests
-
-These commands are a handoff, not commands run by this agent. Use an isolated populated `FRAMEPORT_HOME`, cached
-build tools, a paired Frame and legally obtained game sources. Stop games before changing their files. Back up the
-existing recipe, APK, room files and saved anchors first. Integrate plumb before testing normal room delivery.
-
-On the PC, from the integrated checkout (replace `frame.local` if necessary):
-
-```sh
-export FRAMEPORT_HOME="$PWD/.home"
-export FRAMEPORT_NO_UPDATE_CHECK=1 FRAMEPORT_NO_CATALOG_UPDATE=1
-FRAME=steamos@frame.local
-PKG=com.Novelab.Demeter
-uv run frameport recipe "$PKG" --set scene_emul=1
-uv run frameport install "$PKG" --frame "$FRAME" --force
-uv run frameport test "$PKG" --frame "$FRAME" --seconds 45
-ssh "$FRAME"
-```
-
-In that Frame shell, find the deployment's actual base (also supports a game moved to another drive):
-
-```sh
-PKG=com.Novelab.Demeter
-BASE=$(python3 -c 'import json,os,sys; p=os.path.expanduser("~/Applications/quest-frame/"+sys.argv[1]+"/deployment.json"); print(json.load(open(p)).get("base",os.path.dirname(p)))' "$PKG")
-grep -E 'scene:|extension shim:.*(Spaces|TriangleMesh|BoundingBox3D|PollEvent)' "$BASE/launch.log"
-```
-
-With a current scan delivered beside `settings.conf`, expect:
-
-```
-scene: room from scan file (N walls, M volumes, P planes, K mesh triangles, universe U)
-scene: capture requested -> scanned room
-```
-
-The capture line appears only if the game requests capture. A source made from a boundary/manual file names that
-source in the summary. The shim logs each requested function, for example
-`extension shim: xrDiscoverSpacesMETA -> FrameBridge`. There must be no `Unknown proc addr` for a scene function
-that the game obtains through the shim. Repeat the rebuild/install/headset check for `com.gritGames.Nope` and
-`com.zenstudios.PFXVRQuest` with `scene_emul=1`; these exercise newer MRUK discovery/persistence paths.
-
-Wear the headset and launch from Steam. Enter each game's MR mode and request room setup if offered. Verify the
-floor polygon, every wall, ceiling and furniture match the scan; tables sit below their top-face anchors; doors and
-windows have the correct orientation. Headless startup alone cannot prove tracking or visual placement.
-
-Fallback/undo test, while stopped: preserve `$BASE/room.txt` and `$BASE/room-mesh.bin` under a separate backup
-folder, then disable plumb's room delivery for this run or move the source room out of `rooms/current` as well.
-Without that precaution launch.sh will restore the file. Launch again; expect the original box summary and
-`scene: capture requested -> guardian box`. Test `scene_width=3 scene_depth=4 scene_height=2.7` with the existing
-`frameport settings` command and expect `scene: room 3.00 x 4.00 x 2.70 m`. Restore the saved files, recipe/settings
-and normal room delivery afterward. Do not delete a real game's saved anchors to test the fallback.
-
-### Android persistence probe (independent of a game's UI)
-
-This probe uses the **real scene code with the fake runtime from the host harness**. It checks Android storage,
-process-name handling and both persistence APIs; the headset tests above check the real SteamVR integration.
-The following cross-compilation command was verified offline:
-
-```sh
-native/.cache/ndk-27.2.12479018/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android29-clang \
-  -std=gnu11 -O2 -Wall -Wextra -Werror -Wno-unused-function \
-  -I native/.cache/openxr-f2448a8797 -I native/adapter tests/native/scene_emu_test.c \
-  -lm -o /tmp/frameport-scene-test-android
-scp /tmp/frameport-scene-test-android "$FRAME":/tmp/
-```
-
-Keep a freshly installed game running so its Lepton container exists, then run in the Frame shell:
-
-```sh
-APPID=$(python3 -c 'import json,os,sys; print(json.load(open(os.path.expanduser("~/Applications/quest-frame/"+sys.argv[1]+"/deployment.json")))["appid"])' "$PKG")
-CONTAINER=lepton-steamlaunch-$APPID
-podman cp /tmp/frameport-scene-test-android "$CONTAINER":/data/local/tmp/frameport-scene-test
-podman exec "$CONTAINER" test ! -e /sdcard/Android/data/org.frameport.scenetest
-# Continue only if that test succeeds: use a fresh test-only package directory.
-podman exec "$CONTAINER" mkdir -p /sdcard/Android/data/org.frameport.scenetest/files /data/local/tmp/frameport-scene-probe
-for mode in save reload erase-failure reload erase empty; do
-  podman exec "$CONTAINER" sh -c "FRAMEBRIDGE_CONFIG=/data/local/tmp/frameport-scene-probe/settings.conf exec -a org.frameport.scenetest /data/local/tmp/frameport-scene-test $mode" || break
-done
-podman exec "$CONTAINER" wc -l /sdcard/Android/data/org.frameport.scenetest/files/framebridge-anchors.txt
-```
-
-Every invocation must exit 0 without `FAIL`; logs show `anchors saved`, `loaded 2 saved anchors`, a deliberate
-`anchor write failed` during `erase-failure` (then the following reload still finds two), and `anchors erased`.
-The final file has zero lines. `save` also recreates a session internally, while separate invocations validate
-new-process reload. Undo, before stopping this container:
-
-```sh
-podman exec "$CONTAINER" rm -rf /sdcard/Android/data/org.frameport.scenetest /data/local/tmp/frameport-scene-probe
-podman exec "$CONTAINER" rm -f /data/local/tmp/frameport-scene-test
-rm -f /tmp/frameport-scene-test-android
-```
-
-Remove the PC's temporary probe binary too. Restore backed-up game files/settings and install the previous APK if
-rolling the feature back. No probe command changes real application anchors.
-
-## Commit handoff under the sandbox
-
-This worktree's real Git metadata is on a read-only mount. Commits therefore live on `mr/emul` in
-`/tmp/frameport-mr-emul.git`, with a portable bundle at `/tmp/frameport-mr-emul.bundle`. The actual worktree contains
-all final source/artifact edits but its original branch metadata cannot be advanced here. No local instruction,
-app-data or credential files were staged. The base is `4bf48d3`.
-
-After reviewing the worktree and verifying it contains exactly these changes, the maintainer can import the commits
-and align the existing worktree index without discarding its files:
-
-```sh
-git bundle verify /tmp/frameport-mr-emul.bundle
-git fetch /tmp/frameport-mr-emul.bundle mr/emul
-git log --oneline 4bf48d3..FETCH_HEAD
-git reset --mixed FETCH_HEAD
-```
-
-Run the unrestricted whole suite before merging. The bundle preserves the ordered implementation/test/build commits.
@@ -1,171 +0,0 @@
-# Room plumbing stream
-
-Implemented on `mr/plumb`; no Frame access or device verification. The shared `ROOM_FORMAT.md`, agent version,
-analysis version and patch revisions were left unchanged. No native binaries belong to this stream.
-
-## What changed
-
- `frameport.mr.room`: room/entity dataclasses, v1 text and binary-mesh validation, canonical serialization,
-  missing ceiling/wall/outline defaults, clockwise outline/wall repair, summaries and top-down SVG previews.
-  Mesh counts, indices, finite coordinates, UUIDs and sidecar basenames are checked before import.
- Standalone stdlib agent room commands live in one marked block. Rooms are staged under
-  `~/.local/share/frameport/rooms/<universe>/`; a `current` symlink selects the latest saved room. Uploads validate
-  before replacing a room. Deleting the current room selects the newest remaining room.
- `room_status` returns `rooms`, current `universe`, selected `room`, `room_text`, `aligned`, `default_circle`
-  (null when no usable boundary exists) and `scanner_installed`. Summaries include wall/plane counts, furniture
-  counts by label, floor area and ceiling height. Status text lets the UI preview a room without another transfer.
- Universe detection takes the last matching vrserver log line, then the newest chaperone record if no log match
-  exists. Dummy universe 424242 means unknown. Boundary conversion chains collision quads' bottom edges and refuses
-  the default 20-point, roughly 1 m circle. Boundary ceilings default to 2.5 m; SteamVR's 2.43 m wall extrusion
-  does not measure the real ceiling.
- Finalize records `scene_room` from adapter settings. A marked `_room_sync` launcher line follows the existing
-  config-sync pattern, before Lepton starts. Launcher upgrades also handle old recipes listing
-  `adapter.scene_emul`. Matching universe wins over `current`; absent rooms remove stale sidecars. Live setting
-  changes update the launcher and clear copies when disabled. Non-scene launchers keep their existing layout.
- PC room helpers implement status/import/export/delete/boundary/build/show/capture. Scanner upload reuses the
-  SHA-256 helper extracted from live view; `fp_venc` retains its soft-failure behavior. Import uploads canonical
-  text. Export checks mesh counts; build uploads FPRS dumps, runs the scanner and cleans its staging directory.
- CLI: `frameport frame room status|from-boundary|import|export|delete|build|show`, with `--frame` on each command.
-  `show --output <path.svg>` writes a preview (default below `FRAMEPORT_HOME/rooms`). Build accepts `--universe`.
- Frame page Room card: checklist, asset-URL preview, boundary/delete/capture actions, refresh and recoverable errors.
-  SSH and preview writes run in a background worker; state is cached per connection. Scene-game pages link to Room
-  setup when the connected Frame has no room. `ui_smoke.py --fake-frame` supplies local room-command answers.
- Every USE_SCENE/USE_ANCHOR_API game gets the scene-emulation suggestion. Migration `scene_emul_all` enables it once
-  in automatic recipes, preserving user recipes. NOPE and Pinball FX keep their other recipe fields and now request
-  scene emulation. Triage explains guardian fallback and missing discovery; patch docs and translation template
-  were regenerated.
-
-## Integration questions and limits
-
-1. Headset capture is intentionally unfinished: `room_capture` returns `{"error":"not implemented yet"}`. The
-   `capture_roomview(seconds, out_path)` hook documents the pending RoomView queue work. The GUI explains this and
-   offers the boundary path. Do not present the capture button as a completed scan workflow yet.
-2. This branch has no `fp_roomscan` artifact; merge the scan stream before using `frame room build`. The exact scanner
-   invocation is `fp_roomscan --offline <dump> --out <temporary directory> --universe U --json`. Stdout must contain
-   one JSON value, stderr is saved as `scan.log`, and output must include a valid `room.txt` with the requested U.
-3. Merge the emulation/shim stream before expecting games to use saved rooms, meshes or new Meta entry points.
-   Runtime log spelling is owned there; triage accepts both existing `using guardian room`/dimension logs and the
-   brief's `guardian box`/`room from guardian` messages. Reconcile new success logs at integration.
-4. Confirm the chaperone JSON path, exact universe-switch logs and whether collision quads are already in STAGE on
-   the device. This implementation follows the brief's path and coordinate contract; it does not apply a second
-   standing-origin transform. A universe match alone cannot detect Valve changing an origin without changing its ID.
-5. Agent and desktop perform independent validation because the deployed agent cannot import the desktop package.
-   The desktop canonicalizes outlines and fills defaults; the agent preserves scanner output and validates it.
-   The format contract needed no changes.
-6. Rooms are shared across games; per-game saved anchors are not deleted or rewritten by these commands. Replacing
-   a room creates new entity UUIDs, so a game may need its own room-setup reset. No automatic game reset was added.
-
-## Offline validation
-
-All commands used `FRAMEPORT_HOME` in this worktree (tests use temporary isolated homes), an existing dependency
-venv and offline/no-sync uv settings. No dependencies or native toolchains were downloaded.
-
- Room, PC/CLI, UI, heuristics, migration, MR triage and translation checks passed: 63 tests. The related
-  agent/launcher/screenshots/codec/gamepad regression group passed 170 tests. The final deployment/configuration
-  regression check passed 48 tests, including all four recipe/settings precedence cases.
- Ruff over changed Python files and `scripts/patch_docs.py --check` passed. The UI detector reported no findings.
-  `scripts/i18n_extract.py` regenerated `src/frameport/locales/template.json`.
- `pytest -m games`: 3 skipped (no game dumps). Dev/holdout evaluation used only the checked-in demo analysis
-  snapshot, 21 catalog matches: dev dated 9/17 exact, F1 81.1%; holdout dated 1/4 exact, F1 73.3%. These are limited
-  fixture results, not a new score for the owner's complete collection; the evaluator exits 1 for recipe differences.
- Final full suite: **1790 passed, 40 skipped, 11 failed, 16 errors** in 87.35 s. All 27 failures/errors are
-  `PermissionError: [Errno 1] Operation not permitted` when existing tests create sockets. The whole-suite green
-  requirement cannot be met in this sandbox; rerun `uv run pytest -q` on a host permitting loopback sockets.
-  Browser UI smoke also requires a loopback server, so it
-  was not run. New UI tests construct the real Flet controls and exercise deferred preview/error/cache states.
-
-## Exact device checks (maintainer only)
-
-Run these after integrating emul + scan. Substitute the paired Frame address below; keep the current worktree's
-`FRAMEPORT_HOME=.home` and use explicit `--frame` so the test does not open another app data directory. The source
-connection syncs the agent by digest even without a version bump, unless the Frame has a newer agent version.
-The maintainer must perform integration version bumps before testing against a newer installed agent.
-
-```sh
-export FRAME='steamos@<frame>'
-export PKG='com.gritGames.Nope'  # repeat with com.zenstudios.PFXVRQuest and a known scene game
-uv run frameport frame info --frame "$FRAME"
-uv run frameport frame room status --frame "$FRAME" > .home/mr-status.json
-# Back up ALL rooms on the Frame before destructive checks; use an unused backup name.
-ssh "$FRAME" 'test ! -e ~/.local/share/frameport/rooms.before-mr-test && { test ! -d ~/.local/share/frameport/rooms || cp -a ~/.local/share/frameport/rooms ~/.local/share/frameport/rooms.before-mr-test; }'
-```
-
-1. Inspect status: no room gives `room: null`, `aligned: false`. With Valve's default circle, `default_circle: true`;
-   `uv run frameport frame room from-boundary --frame "$FRAME"` must fail with the default-circle explanation.
-   Set a real play area in SteamVR, repeat `from-boundary`: expect source `boundary`, one wall per boundary edge,
-   correct floor area and `aligned: true`. Open Frame → Room: visible preview, warning for the unscanned room,
-   aligned row ready; the capture button should show the friendly unavailable message without crashing.
-2. Exercise import/export and preview with a manual fixture in the current universe:
-
-```sh
-uv run frameport frame room status --frame "$FRAME" > .home/mr-status.json
-uv run python - <<'PY'
-import json
-from pathlib import Path
-from frameport.mr.room import Mesh, Volume, box_room, dumps, write_mesh
-p = Path('.home/mr-check'); p.mkdir(parents=True, exist_ok=True)
-r = box_room(4, 3, 2.5)
-r.source = 'manual'
-r.universe = json.loads(Path('.home/mr-status.json').read_text())['universe']
-r.volumes.append(Volume('a'*32, 'TABLE', .5, 0, .8, 20, 1.2, .7, .8))
-r.mesh = Mesh(vertices=[(-2, 0, -1.5), (2, 0, -1.5), (2, 0, 1.5)], indices=[0, 1, 2])
-(p/'room.txt').write_text(dumps(r))
-(p/'room-mesh.bin').write_bytes(write_mesh(r.mesh))
-PY
-uv run frameport frame room import .home/mr-check/room.txt --frame "$FRAME"
-uv run frameport frame room export .home/mr-export --frame "$FRAME"
-uv run frameport frame room show --output .home/mr-check/preview.svg --frame "$FRAME"
-cmp .home/mr-check/room-mesh.bin .home/mr-export/room-mesh.bin
-```
-
-   Expect four walls, one TABLE, area 12 m² and height 2.5 m. The preview must label TABLE and the game must show it
-   hanging below its top-face anchor. Check the corresponding universe folder and `rooms/current` on the Frame.
-3. Use a recorded dump from the same standing universe (do not invent one). Copy it to `.home/mr-check/scan.fprs`,
-   then run the command below. Expect the scanner JSON under `report`, source `scan`, aligned room data, `scan.log`
-   on the Frame and an installed executable. Run twice: an unchanged scanner must not upload again.
-
-```sh
-uv run frameport frame room build .home/mr-check/scan.fprs --frame "$FRAME"
-uv run frameport frame room status --frame "$FRAME"
-```
-
-   If the recording is from another universe, pass its original `--universe <id>`; do not relabel its coordinates.
-4. Prepare the game's source and its existing backed-up signing key in the isolated test library, then force a
-   rebuild/reinstall after integration: `uv run frameport install "$PKG" --frame "$FRAME" --force --apk-only`.
-   Repeat for both catalog games. In each deployment, expect `scene_room: true`. Run `frame info` twice to upgrade
-   old launchers and check one marker only:
-
-```sh
-uv run frameport frame info --frame "$FRAME"
-uv run frameport frame info --frame "$FRAME"
-ssh "$FRAME" "grep -c '# frameport-room-sync' ~/Applications/quest-frame/$PKG/launch.sh"
-uv run frameport settings "$PKG" scene_emul=1 --frame "$FRAME"
-```
-
-   Expected marker count: 1. Start the game with Steam's Play button in the headset, enter its MR mode, then inspect
-   `<deployment.base>/room-sync.log`: JSON has the selected universe and alignment. The two room files must be
-   beside `<deployment.base>/settings.conf`. FrameBridge must load that room; `xrDiscoverSpacesMETA` must resolve
-   through the extension shim, with no `Unknown proc addr`/MRUK `NoRoomsFound`. Exact new native success log strings
-   should be taken from the emul stream. Verify walls/table placement physically; never infer alignment from FPS.
-5. Exit the game. Switch `scene_emul=0` using Game settings (or the settings command above with 0): marker and game
-   sidecars disappear. Switch it back to 1: one marker returns. Delete the room and launch again: stale copies are
-   removed and existing FrameBridge guardian fallback logs trigger informational `mr-no-room` triage.
-6. To check a universe mismatch, back up/export the room, change its `universe` record to another valid ID and import
-   it, then delete the original universe's room with `frame room delete --universe <original-id>`. Status must select
-   `current` but report `aligned: false`; the Room card warns. Restore the original file before playing physically.
-   The dummy universe 424242 should report current universe 0 rather than claim alignment.
-
-## Undo device checks
-
-Close all games. Restore the backed-up store (or remove only the fixture universes if there was no previous store):
-
-```sh
-ssh "$FRAME" 'if test -d ~/.local/share/frameport/rooms.before-mr-test; then rm -rf ~/.local/share/frameport/rooms; mv ~/.local/share/frameport/rooms.before-mr-test ~/.local/share/frameport/rooms; fi'
-```
-
-Set each tested game's `scene_emul` back to its recorded original value. To remove a test room without a backup:
-`uv run frameport frame room delete --universe <fixture-universe> --frame "$FRAME"`. Start a scene game once to
-refresh/remove its copies. The scanner can be removed with
-`ssh "$FRAME" 'rm -f ~/.local/share/frameport/bin/fp_roomscan'`; the next build reinstalls it. Game saves and
-`framebridge-anchors.txt` are untouched. Restore the previous app/agent/native artifacts through the maintainer's
-normal integration rollback if testing the combined native implementation fails.
@@ -1,452 +0,0 @@
-# Offline room scanner (scan stream)
-
-`fp_roomscan` converts recorded FPRS v1 meshes to the [room contract](ROOM_FORMAT.md), including the optional
-wall label adopted from upstream commit `8cb2783`:
-`room.txt` and `room-mesh.bin`, refined by default (see "Refinement" below), plus the unrefined `room-raw.txt` +
-`room-mesh-raw.bin` and `scan.json` (head path, settings, per-pass report, label decisions, door/closet
-suggestions; ROOM_FORMAT.md "Raw files and scan.json"). It does not capture RoomView queues, contact a headset, install rooms, or modify
-the current-room symlink. Scanner work changes `native/roomscan/`, its build target and artifact/checksum,
-`scripts/mr/synth_scan.py`, `tests/test_roomscan.py`, and this note. The upstream contract commit also brings its
-existing prompt assets and renderer unchanged. No runtime, agent, patch, or analysis versions were bumped.
-
-## Build and run
-
-Use the cached NDK; no downloads are needed for this target:
-
-```sh
-python native/build.py --only roomscan
-```
-
-The result is `artifacts/linux-arm64-bin/fp_roomscan`, a static aarch64 Linux ELF with its own `_start`, raw Linux
-syscalls, and no interpreter, dynamic section, libc, libm, UAPI headers, generated tables, or new dependencies.
-`platform.h` is the reconstruction code's entire I/O/allocation boundary. The same eight C sources compile on the
-host:
-
-```sh
-cc -std=c11 -O2 -Wall -Wextra -Werror -ffp-contract=off -fno-math-errno -DFP_HOSTED native/roomscan/*.c -o /tmp/fp_roomscan
-python scripts/mr/synth_scan.py /tmp/room.fprs
-/tmp/fp_roomscan --offline /tmp/room.fprs --out /tmp/scanned-room --universe 0 --json
-```
-
-The output directory's parent must exist; the scanner creates the final directory if needed. It always prints
-exactly one JSON summary, whether `--json` is supplied or omitted. Success exits 0, errors exit 2 with
-`{"ok":false,"error":"..."}`. `--help` prints usage and exits 0. Successful summaries contain:
-
-```json
-{"ok":true,"frames":30,"skipped_frames":0,"far_vertices":0,"discontinuity_triangles":0,
- "walls":4,"detected_walls":4,"volumes":2,"floor_y":-0.0023,
- "ceiling_y":2.5992,"coverage_percent":100.0,"hint_used":false,"triangles":70997,
- "accepted_triangles":118804,"rejected_triangles":704,"heads":28,
- "refine":{"triangles":70997,"kept":7159,"structural":46121,"near_walls":148,"outside":0,"small_pieces":38,
-  "thin_pieces":0,"erased":0,"walked":203,"tops":1896,"panel_triangles":12,"truncated":0,"walked_skipped":false,
-  "floor_y":-0.0051,"ceiling_y":2.6028,"boxes":2,"relabelled":1,"removed_boxes":0,"suggestions":0,
-  "plane_shifts":[{"kind":"wall","wall":0,"shift":-0.0004},...,{"kind":"ceiling","shift":-0.0021}],
-  "output_triangles":7171,"output_volumes":2},"warnings":[],
- "timings_ms":{"read":0,"fusion":0,"model":0,"mesh":0,"refine":0,"total":0}}
-```
-
-The example above illustrates the schema; actual counts and timings depend on the input. Heights are absolute
-STAGE coordinates. `frames` includes skipped frames; `skipped_frames`, `far_vertices`, and
-`discontinuity_triangles` count input exclusions once, not once per pass. `walls` counts output polygon
-edges including synthesized edges; `detected_walls` counts fitted physical planes. Coverage means the percentage
-of the output perimeter supported by observed wall planes, **not camera coverage of all room surfaces**. Timings
-include parsing, fusion, structural/furniture modelling, mesh generation, refinement, and total time including
-output. The scanner fields describe the unrefined scan (`triangles`, `volumes`, `ceiling_y` are the raw files');
-`refine` is the refinement report (same keys as scan.json's `report`) plus the refined `output_triangles` and
-`output_volumes`. `heads` counts the head-path points kept for the walked-volume pass.
-
-All frame headers, timestamps/vertices/poses, approximately unit quaternions, counts, indices and EOF boundaries
-are checked before publication. A non-finite timestamp/pose/vertex or invalid tracking quaternion skips the entire
-frame after consuming and structurally validating its record, with a count and warning. A bad frame never erases
-usable frames elsewhere in the dump. Vertices outside the camera-relative range (default 4 m) and every triangle
-touching them are discarded. Triangles with a camera-depth jump over `--depth-jump + --depth-ratio * nearest_depth`
-are rejected before fusion; this complements long-edge and grazing rejection. Frame counts are capped at
-1 million vertices / 3 million indices;
-oversized records fail rather than allocating from untrusted counts. A header-only dump or one without usable
-triangles fails. Empty frames may accompany useful frames. Structural corruption (truncation, unsupported header,
-bad counts or indices) remains fatal, preserves any existing output byte for byte and creates no output directory.
-UUIDs come from `getrandom`, fresh per scan; mesh geometry is repeatable.
-
-All files are computed first, then each is written to an exclusive, randomly named temporary file and renamed, in
-the order `room-mesh-raw.bin`, `room-raw.txt`, `scan.json`, `room-mesh.bin`, `room.txt` (meshes before their room
-text, `room.txt` last). A write failure removes the temporary files. These are atomic **file** replacements, not a
-multi-file filesystem transaction: the installer should scan into a fresh staging directory
-and publish that directory/symlink after success. Do not run concurrent writers into the same output directory.
-There is no fsync-based power-loss durability promise. Neither scan nor build writes application data outside
-the worktree's `FRAMEPORT_HOME`; fixtures and test output use temporary directories.
-
-## Reconstruction
-
-1. The first streaming pass validates every frame, rotates its mesh by the supplied quaternion, and translates
-   it into STAGE. It rejects degenerate triangles, excessively long edges, out-of-range points, and grazing
-   surfaces. Winding is corrected toward the observing camera. A deterministic bounded reservoir of 32,768
-   accepted triangle centroids determines median position and padded bounds. No frames are retained across reads.
-2. The second pass rasterizes accepted triangles at 0.75 voxel spacing. Per-cell surfels average positions and
-   inward normals, weighted by area and squared incidence. A capped accumulated weight lets later views correct
-   earlier ones. The grid is sized from the sample bounds and capped at 8 x 8 x 4 metres about the data median.
-   Unobserved cells have zero weight. This implementation uses a bounded dense backing array for the sparse
-   observations, rather than a hash table; the 4.2-million-cell hard cap bounds all later work. Complete regular
-   fans are recognized from their index topology, without hardcoding a camera resolution. Their normals come from
-   12 x 12 neighbourhood covariance plane fits, rejecting patches above `--patch-residual` RMS; irregular meshes
-   retain triangle normals. Each cell counts contributing frames once and needs `--min-views` evidence, capped at
-   ten percent of usable frames (rounded down, at least one) for brief captures. This suppresses transient stereo
-   geometry without requiring a short scan to see each surface five times.
-3. Horizontal normal/height histograms select the dominant floor within the STAGE floor band and a ceiling above
-   the minimum ceiling height. Missing floor uses STAGE y=0 with a warning; missing ceiling uses floor plus
-   `--ceiling-default`, warning exactly `ceiling not seen`. A ceiling must also have at least 15% as many supported
-   cells as all upward-facing horizontal surfaces, so a few isolated down-facing patches do not invent a ceiling.
-4. RANSAC fits near-vertical planes using distance and normal agreement, then refines them by position covariance.
-   Minimum height, span, and area reject furniture faces. Wall directions within the snap tolerance of the
-   dominant wall's orthogonal directions are snapped, with offsets refitted. Directed wall segments are connected
-   by nearest endpoints and adjacent line intersections. This preserves the L-shaped fixture's re-entrant corner.
-   Parallel same-facing planes within 25 cm / approximately 14° merge, suppressing duplicate softened faces.
-   Planes below 20% of the strongest original plane's area are discarded. When at least 65% of candidate wall area
-   supports an orthogonal family, directions outside 12° of that family are discarded (`--snap-degrees 0` disables
-   this orthogonal consensus filter). Large gaps close along observed endpoints. Ambiguous endpoints with three
-   or four planes can use inward half-plane intersections; concave rooms retain segment ordering. Otherwise a
-   warned observed-bounds rectangle is used. Polygon checks reject crossing edges. The output follows the contract's positive
-   shoelace ordering in (x,z), with left-facing inward normals.
-5. Furniture tops are clustered separately from vertical faces, within supported horizontal height bands. A
-   softened edge connecting a tabletop to a wall can no longer absorb the whole room into one box. Top boxes use
-   a minimum-area horizontal orientation search and the median surface height; vertical screen candidates use
-   face-direction harmonics / PCA. Bounds trim the outer 2% to suppress stereo halos. Top boxes extend down to the
-   floor (the footprint and lower extent remain geometric estimates). Weak/sparse top patches are discarded.
-   Labels follow height, area, long-side (with two voxels of measurement tolerance),
-   thinness and near-wall rules, in order BED, COUCH, TABLE, SCREEN, STORAGE, OTHER. Only volumes are emitted;
-   optional table plane records are not required. Floor/ceiling/wall surfaces are excluded before clustering.
-6. Surfel splats form an incidence/area-weighted signed distance field within three voxels of each surface. The
-   sign is positive in observed free room space. Marching cubes traces zero crossings on cube faces, resolving
-   ambiguous faces from their centre sign. It fans closed contours and orients triangles toward the positive
-   gradient. Unknown corners suppress extraction rather than bridging unobserved space. If necessary, extraction
-   is repeated on a coarser lattice (strides 2–4) until at most 200,000 triangles remain, with a decimation warning;
-   excess beyond that fails. Vertices are unshared triangle vertices, so at most 600,000 vertices. Structural
-   planes are semantic anchors, not substituted for the observed global mesh.
-
-## Refinement
-
-After the mesh, the scanner cleans the room the way the owner tuned it in the room-scan cleanup page (2026-10-18);
-`native/roomscan/refine.c` and `rules.c` port that page's `refine()` and label rules pass for pass (local parity
-check on the owner's recording: identical counts and bit-identical refined meshes, see below). `--refine 0`
-switches it off: room.txt and room-mesh.bin are then byte-for-byte what the scanner wrote before refinement existed
-(the raw files and scan.json are still written, so refinement can be switched on later without a new scan).
-
-The input is exactly what the raw files hold: the raw room is written as text and read back (doubles parsed from the
-4-decimal text, like the page reads it), the head path is rounded the same way. Therefore `--refine-only <dir>`
-on the raw files reproduces the scan's refined files byte for byte. The mesh is welded at 1 mm (quantized, as the
-page does) for the passes that need topology; the output is again unshared triangle vertices.
-
-1. **Label rules** (`rules.c`, `--label-rules 0` off) on the scanner's volumes, using the raw room (walls, outline,
-   floor): a box that holds >= 60% of two boxes whose centres are >= 1 m apart covers several things (removed); a
-   box >= 75% inside a bigger box with a top no higher (+5 cm) is part of it (removed); a centre > 10 cm outside the
-   outline is behind a wall (removed). A tall thin slab from the floor (thinner than 22 cm, >= 1.8 m high, bottom
-   <= 0.3 m, at most 0.5 m behind the wall line) becomes a door (<= 1.1 m wide) or closet **suggestion** in
-   scan.json (box removed, nothing added: the GUI decides). Thin (< 22 cm) upright boxes are SCREEN only when
-   raised >= 0.3 m, top <= 2.2 m, width/height >= 1.2, within 15 degrees of the nearest wall (when closer than
-   0.35 m) and flat: the raw mesh's depth spread inside the box <= 3 cm (with >= 30 triangles; fewer = unknown,
-   accepted); otherwise removed. Then BED (top 0.25-0.65 m, area >= 2 m^2, long side 1.8-3 m), COUCH (top
-   0.35-0.6 m, long side >= 1.4 m), TABLE (top 0.6-1.1 m), STORAGE (>= 1.1 m high, >= 25 cm deep, within 0.35 m of a
-   wall); anything taller than 1.1 m otherwise is removed, the rest is OTHER. Every box gets a reason in scan.json.
-   These thresholds are constants in `rules.c` (the page's `RULES0`).
-2. **Furniture**: triangles within 10 cm of a ruled box (after the rules) are furniture; the passes below never
-   classify, clear or walk them away, and the tubes pass keeps pieces that are mostly furniture.
-3. **Planes**: seen walls (`WALL_FACE` records), floor and ceiling. Each plane's offset moves to the median signed
-   distance of the non-furniture triangles facing it (normal within `--facing-deg`) within `--band` of it (walls:
-   within their length + band), when there are more than 50. An unseen ceiling (floor + 2.5 m) moves to the real
-   one; the re-estimated ceiling is written to the refined room.txt (ceiling record and wall tops).
-4. **Structural triangles**: facing a plane, not furniture, behind it by less than `--band`, in front of it by less
-   than `--band-in` (walls), `--floor-in`, `--ceil-in`; in a wall's top `--top-strip` below the ceiling the full
-   band applies in front too (the depth bends where wall meets ceiling). The nearest qualifying plane owns it.
-5. **Erase spheres** (`--erase "x,y,z,r;..."`, from the GUI's eraser) drop every triangle whose centroid is inside.
-6. **Walked volume** (`--walked` = radius R, 0 off): where the user stood, nothing solid can be. Non-furniture
-   triangles from 0.2 m above the floor up to 0.25 m above a head position, within R horizontally of it, go.
-   Needs the head path (scan.json); without it the pass is skipped (`walked_skipped`).
-7. **Walls** (`--walls`): `panels` (default) removes the structural triangles, then non-furniture triangles closer
-   than `--near` to any plane (within the wall's extent), and adds flat panels: one quad per seen wall (moved by its
-   offset shift) from floor to ceiling, and the outline ear-clipped at the floor and the ceiling heights, all wound
-   counter-clockwise seen from inside. `snap` instead projects every vertex of a structural triangle onto its plane
-   (the last owner wins). `off` keeps them.
-8. **Furniture tops** (`--tops`, 0 off): upward-facing (normal y > 0.8) triangles within `--tops` of a box top and
-   inside its footprint are flattened onto it.
-9. **Clip**: centroids further than `--clip` outside the outline (`--clip` + `--clip-open` past an unseen wall), or
-   further than `--clip` above the ceiling / below the floor plane go. `--clip 1 --clip-open 2` switches it off.
-10. **Islands**: connected pieces smaller than `--island` m^2 go (`--protect 1` keeps furniture triangles).
-11. **Thin floating pieces** (`--tubes`, 0 off): pieces of >= 10 triangles, < 1 m^2, at most half furniture, whose
-    longest principal axis (vertex PCA, std) is >= `--tubes` times the second and the second <= `--tube-thick`.
-12. **Smoothing**: `--smooth` Taubin iterations (lambda 0.5, mu -0.53) over the kept triangles.
-
-Output: the kept scan triangles, then the panels (`refine.panel_triangles`), at most 200,000 triangles (more kept
-triangles would be cut, `truncated`, with a warning). The refinement adds about 20 ms on the host for the owner's
-64k-triangle scan; its buffers (welding hash, double positions, union-find, adjacency) stay below ~170 MiB for a
-200k-triangle mesh and the fusion grid is freed before it runs, so peak memory is still the fusion phase's.
-
-`--refine-only <room dir> [refinement options] [--json]` runs only steps 1-12 from `room-raw.txt` +
-`room-mesh-raw.bin` (+ the head path from `scan.json`) and rewrites scan.json, room-mesh.bin and room.txt. A folder
-from an older scanner without raw files: its room.txt + mesh become the raw files first (the room text is rewritten
-with the mesh record pointing at `room-mesh-raw.bin`), a warning says so, and there is no head path. Its JSON:
-`{"ok":true,"refine_only":true,"raw_triangles":..,"volumes":..,"floor_y":..,"ceiling_y":..,"heads":..,
-"refine":{...},"warnings":[...],"timings_ms":{"refine":..,"total":..}}`.
-
-Local parity (2026-10-18, private recording `room1.fprs`, not in the repository): the reference page's functions run
-under node on this scanner's raw output give the same per-pass counts, the same label decisions and reasons, and
-bit-identical refined meshes for the defaults, snap, off + protect, erase spheres + tubes 2, and a wide-band setting
-(one triangle differs there: a facing test exactly at the threshold), and the same on an older 128k-triangle room
-folder. Distance ties at outline corners decide which wall's clip allowance applies, so the corner distance uses
-V8's Math.hypot algorithm.
-
-Peak allocation stays below 260 MiB, including maximum frame buffers, the grid, model worklists and mesh buffers
-(the latter phases do not retain frame buffers). Default synthetic scenes use a much smaller grid. Thresholds
-are CLI options below or named constants next to their algorithms. No room-specific coordinates or dimensions are
-used; on-device quality and speed still need validation.
-
-## Tuning
-
-Distances are metres, areas m², volumes m³. `--universe` accepts the full unsigned 64-bit range; 0 means unknown.
-
-| Option | Default | Accepted range / meaning |
-| --- | ---: | --- |
-| `--voxel` | 0.05 | 0.04–0.20, spatial resolution; lower values cost more memory/work |
-| `--ceiling-default` | 2.5 | 1.8–3.8, height above floor when ceiling is unseen |
-| `--truncation` | 3 | 1–5, TSDF band in voxel units |
-| `--max-edge` | 0.6 | 0.05–1.5, reject longer triangle edges |
-| `--grazing` | 0.12 | 0.01–0.9, minimum absolute camera/normal cosine |
-| `--range` | 4 | 1–10, maximum camera-relative vertex distance; >4 m opts back into inpainted depth |
-| `--depth-jump` | 0.25 | 0.02–1, absolute part of a triangle's maximum depth discontinuity |
-| `--depth-ratio` | 0.12 | 0–0.5, additional fraction of nearest vertex depth |
-| `--min-views` | 5 | 1–16, temporal support target; brief scans cap it as described above |
-| `--patch-residual` | 0.03 | 0.005–0.1, maximum RMS residual of a regular-fan normal patch |
-| `--plane-distance` | 0.045 | 0.01–0.15, point-to-plane inlier tolerance |
-| `--min-plane-area` | 0.45 | 0.1–4, minimum occupied plane area estimate |
-| `--wall-height` | 1.5 | 0.5–3, minimum observed vertical wall span |
-| `--snap-degrees` | 5 | 0–15, orthogonal snap tolerance |
-| `--floor-band` | 0.35 | 0.05–1, floor search distance from STAGE y=0 |
-| `--ceiling-min` | 1.8 | 1.5–3, minimum absolute ceiling y |
-| `--min-volume` | 0.05 | 0.005–1, reject smaller furniture boxes |
-| `--cluster-gap` | 0.10 | 0.04–0.20, voxel neighbourhood gap (rounded up to cells) |
-| `--gap` | 0.65 | 0.1–1.5, maximum adjacent-wall endpoint extrapolation |
-| `--horizontal` | 0.85 | 0.6–0.99, minimum floor/ceiling/top normal cosine |
-
-Refinement (all distances metres; defaults = the owner's settings):
-
-| Option | Default | Accepted range / meaning |
-| --- | ---: | --- |
-| `--refine` | 1 | 0/1; 0 = the unrefined output in room.txt/room-mesh.bin |
-| `--walls` | panels | `off`, `snap` (project onto the planes) or `panels` (flat wall/floor/ceiling panels) |
-| `--band` | 0.35 | 0.02–1, structural band behind a surface; plane re-estimation window |
-| `--facing-deg` | 60 | 5–89, maximum angle between a triangle's normal and the surface's |
-| `--band-in` | 0.12 | 0–1, band in front of a wall (room side) |
-| `--floor-in` | 0.08 | 0–1, band above the floor |
-| `--ceil-in` | 0.25 | 0–1, band below the ceiling |
-| `--top-strip` | 0.5 | 0–2, top part of a wall where the full band applies in front too |
-| `--near` | 0.03 | 0–0.3, panels: also clear non-furniture scan this close to a plane |
-| `--clip` | 0.05 | 0–1, clip distance outside the outline / beyond floor and ceiling |
-| `--clip-open` | 0.10 | 0–2, extra allowance past unseen walls (`--clip 1 --clip-open 2` = no clipping) |
-| `--island` | 0.20 | 0–5 m^2, minimum connected piece area (0 off) |
-| `--smooth` | 8 | 0–50 integer, Taubin iterations |
-| `--tops` | 0.10 | 0–0.5, flatten upward scan this close to a box top (0 off) |
-| `--protect` | 0 | 0/1, islands never remove furniture triangles |
-| `--tubes` | 3 | 0–20, elongation (PCA axis ratio) of a thin floating piece (0 off) |
-| `--tube-thick` | 0.15 | 0.01–1, maximum second PCA axis (std) of a thin floating piece |
-| `--walked` | 0.40 | 0 or 0.05–1.5, walked-volume radius around the head path (0 off) |
-| `--label-rules` | 1 | 0/1, label rules on the scanner's volumes |
-| `--erase` | none | `"x,y,z,r;..."`, up to 64 spheres (r 0–5 m) whose scan is removed |
-
-Additional constants in `model.c` include RANSAC trials, normal agreement, wall span, furniture margins,
-label height/area thresholds, box trimming and circle recognition. Fusion sampling/weight limits are in
-`fusion.c`; mesh splat radii/decimation limits in `mesh.c`; hard resource limits in `scan.h`.
-
-`--hint outline.txt` accepts one `x z` point per line, decimal/scientific notation, optional `#` comments, either
-winding, at most 96 points / 8 KiB. At least eight points with radial coefficient of variation below 5% count as
-the default circle and are ignored. A non-circular hint is used only when walls are incomplete **and every
-observed wall has a compatible hint edge** within `--gap`. Complete scans are never constrained to chaperone.
-Incompatible inset play boundaries are ignored with a warning. Hint-completed edges retain synthesized status.
-
-## Limits for integration
-
- Synthesized wall records now append `INVISIBLE_WALL_FACE` as their optional eighth field. Observed walls omit
-  the label and default to `WALL_FACE`; comments are no longer used to carry semantics. This matches upstream's
-  authorized contract change exactly; adapters need that same contract revision.
- A private RoomView recording was used for offline robustness work. It, its derived geometry, and its results
-  stay outside committed files. Synthetic fixtures independently exercise the input characteristics. They are
-  regressions, not proof
-  of headset accuracy. Furniture labels are geometric heuristics; adjacent/touching objects can merge, occluded
-  objects may split, top-only clusters have inferred depth, and thin fragments can be screen candidates. Nearby
-  parallel walls and small wall jogs can merge under coarse depth uncertainty. Large disconnected coplanar wall segments are
-  currently fitted together; complicated rooms can fall back to a warned rectangle.
- Cropped or sparse captures can produce an incomplete mesh and synthesized outline. Surfaces are not filled
-  through unseen regions. Furniture is not an accessibility/safety boundary. Rooms beyond the grid cap are
-  cropped with a warning. Default-circle recognition may also ignore an intentionally circular boundary.
- Output paths are fixed by the contract. The plumbing stream should stage a new directory and switch `current`
-  after scanner success, preserving the previous room for rollback. Assign the recording's actual universe id;
-  this standalone scanner cannot query SteamVR or validate universe alignment.
-
-## Offline validation
-
-`tests/test_roomscan.py` builds with the host compiler (skips only if none exists). Its tests cover the noisy
-4 x 3 x 2.6 m room with table/couch, six-wall L, moving and rotated/translated mesh poses, ceiling fallback, a single
-frame, missing walls, circular/matching hints, correct UUIDs/wire layout, interior mesh winding, triangle budget,
-repeatable mesh bytes with fresh UUIDs, truncated/corrupt dumps, invalid counts/indices/poses and invalid CLI values.
-Refinement tests: a floating pole and a column in the walked path (`synth_scan.py` `TUBE`/`GHOST`, `extra=`)
-are meshed by the scanner and removed by the tubes / walked passes (each kept with its pass off, the table top kept);
-panels wind into the room on the re-estimated planes; `--refine-only` reproduces a scan's files byte for byte;
-`--refine 0` equals the raw output (and refining it later equals the default); scan.json settings/report/heads; head
-path decimation to <= 2000 points; erase spheres; the label rules on a hand-written older room folder (merged,
-nested, behind a wall, SCREEN from a flat panel, a door suggestion with wall and position, unknown records kept,
-idempotent, `--label-rules 0`); invalid refinement options.
-The test module takes about fourteen seconds including synthetic rendering and compilation (under the 60 s budget).
-New cases cover non-finite frames before/after usable frames, per-vertex far rejection, depth jumps below the edge
-limit, weak ceiling evidence, wall labels and a complete camera-fan scan. The deterministic stdlib renderer now
-defaults to a 132 x 128 full index fan (99,822 indices), +Z forward / -Y image up, with poses mapping to STAGE.
-It adds separable depth smoothing, spatially correlated noise, far inpainting, two initial NaN poses, 3 Hz timestamps
-and head-height drift from 0.9 to 1.7 m. `--profile legacy` retains the smaller 110° x 76° test cone. New CLI controls
-are `--profile`, `--invalid-start`, `--smoothing` and optional resolution overrides. Use `--invalid-start 0` for a
-usable one-frame fixture; default RoomView warm-up frames otherwise have no valid tracking.
-
-```sh
-UV_OFFLINE=1 UV_CACHE_DIR=/tmp/frameport-uv-cache uv run pytest -q tests/test_roomscan.py
-UV_OFFLINE=1 UV_CACHE_DIR=/tmp/frameport-uv-cache uv run ruff check scripts/mr/synth_scan.py tests/test_roomscan.py
-```
-
-The synthetic camera fan passes AddressSanitizer + UndefinedBehaviorSanitizer. Two consecutive final native builds
-produce identical SHA-256 `2cc16b90abcd3d359f1658c581172bd650017bf2725e24268915f50904c000ec` (97,808 bytes, with refinement),
-matching `artifacts/SHA256SUMS`. ELF inspection confirms aarch64, little-endian, no PT_INTERP / PT_DYNAMIC, and no
-embedded local build paths.
-
-The required full `uv run pytest -q` run completed with **1,788 passed, 40 skipped, 11 failed, 16 errors** in 79 s.
-All 27 failures/errors are the sandbox's `PermissionError: [Errno 1] Operation not permitted` on socket creation
-in existing HTTP/pairing/live-stream tests (`test_deeplink`, `test_devkit`, `test_install_links_extra`,
-`test_livestream`, `test_setup_url`, `test_ui_state`). This environment forbids sockets, including loopback.
-The unchanged baseline had the identical 27 failures/errors before the scanner tests were added (1,747 passed).
-Consequently the whole-suite-pass requirement cannot be satisfied here; rerun it outside that restriction at
-integration. No tests were changed/skipped to hide the restriction and no network/device access was attempted.
-No patch/settings/catalog/triage files were touched, so the conditional patch documentation regeneration is
-unnecessary.
-
-## Ten-minute capture budget (synthetic benchmark)
-
-The scanner is streaming and single-threaded. On an Intel Core i7-14700K host, a **synthetic-only** 1,800-frame
-132 x 128 dump (1,083,751,208 bytes, equivalent to ten minutes at 3 Hz) took **7.41 s elapsed / 7.08 s CPU**, with
-**27,208 KiB maximum RSS** at the default voxel size. The file repeats a 30-view synthetic sweep, including its
-warm-up frames; it tests parsing/fusion throughput rather than 1,800 independent viewpoints. Geometry-dependent
-model/mesh work and storage caches affect timing. No private recording or derived room data is in that benchmark.
-
-Reproduce with bounded copies rather than loading a gigabyte into Python:
-
-```sh
-python scripts/mr/synth_scan.py /tmp/roomview.fprs
-python - <<'PY'
-import shutil
-with open('/tmp/roomview.fprs', 'rb') as source, open('/tmp/roomscan-1800.fprs', 'wb') as out:
-    out.write(source.read(8))
-    for repeat in range(60):
-        source.seek(8)
-        shutil.copyfileobj(source, out, 1024 * 1024)
-PY
-/usr/bin/time -v /tmp/fp_roomscan --offline /tmp/roomscan-1800.fprs --out /tmp/roomscan-benchmark --json
-```
-
-For the Frame's Cortex-A720/X4-class cores, budgeting **3–5 times the host CPU time plus storage** gives roughly
-**23–38 s** for this workload, leaving headroom under the requested ~60 s. This is an estimate, not an ARM
-measurement or an 8-core speedup claim. Worst-case allocations are bounded below 260 MiB independently of frame
-count (48-byte cells, 4.2-million-cell cap, bounded frame buffers/worklists), below both the original 300 MB and
-follow-up 600 MB limits. A maximum-sized complex room can add model/mesh work beyond this small synthetic sweep.
-The maintainer must time a ten-minute real capture on the Frame and check CPU time, wall time and RSS before
-claiming the target is achieved on-device. Hardware square root instructions replace iterative division; neither
-build links libm. The build and host command both require `-fno-math-errno` for that intrinsic.
-
-## Exact device checks (maintainer only; none executed by this stream)
-
-1. On the development PC, build, then render the canonical fixtures:
-
-   ```sh
-   python native/build.py --only roomscan
-   python scripts/mr/synth_scan.py /tmp/box.fprs
-   python scripts/mr/synth_scan.py /tmp/l.fprs --shape l
-   python scripts/mr/synth_scan.py /tmp/down.fprs --no-ceiling
-   python scripts/mr/synth_scan.py /tmp/one.fprs --frames 1 --invalid-start 0
-   scp artifacts/linux-arm64-bin/fp_roomscan /tmp/box.fprs /tmp/l.fprs /tmp/down.fprs /tmp/one.fprs steamos@<FRAME>:~/Downloads/
-   ```
-
-2. In a terminal **on the Frame**, use an isolated directory; no game or current room is changed:
-
-   ```sh
-   mkdir -p "$HOME/.local/share/frameport/roomscan-test"
-   cd "$HOME/.local/share/frameport/roomscan-test"
-   cp "$HOME/Downloads/fp_roomscan" ./fp_roomscan
-   chmod 700 ./fp_roomscan
-   ./fp_roomscan --help
-   ./fp_roomscan --offline "$HOME/Downloads/box.fprs" --out box --universe 0 --json > box.json
-   cat box.json
-   ./fp_roomscan --offline "$HOME/Downloads/l.fprs" --out l --json > l.json
-   ./fp_roomscan --offline "$HOME/Downloads/down.fprs" --out down --ceiling-default 2.7 --json > down.json
-   ./fp_roomscan --offline "$HOME/Downloads/one.fprs" --out one --json > one.json
-   ```
-
-   Expected JSON: box has `ok:true`, `walls:4`, `detected_walls:4`, `volumes:2`, floor within 5 cm of 0,
-   ceiling within 5 cm of 2.6, coverage 100; the only expected box warnings concern skipped warm-up frames and
-   out-of-range vertices. `box/room.txt` includes TABLE and COUCH volume records.
-   L has six walls and the concave corner near (0,0), rather than a rectangle. Down includes exactly the warning
-   string `ceiling not seen` (other warnings are expected), with ceiling minus floor 2.7. One includes
-   `few frames; scan more viewpoints`. Every mesh should have at most 200,000 triangles. JSON is the scanner log;
-   there are no expected stderr status lines.
-
-3. Verify sidecars, wall labels and the corrupt-input exit status on the Frame:
-
-   ```sh
-   python3 - <<'PY'
-   import json, pathlib, struct
-   for name in ('box', 'l', 'down', 'one'):
-       report = json.loads(pathlib.Path(name + '.json').read_text())
-       data = pathlib.Path(name, 'room-mesh.bin').read_bytes()
-       magic, version, nv, ni = struct.unpack_from('<4sIII', data)
-       assert report['ok'] and magic == b'FPRM' and version == 1
-       assert ni % 3 == 0 and 0 < ni // 3 <= 200000
-       assert len(data) == 16 + nv * 12 + ni * 4
-       for line in pathlib.Path(name, 'room.txt').read_text().splitlines():
-           if line.startswith('wall '):
-               fields = line.split()
-               assert len(fields) in (8, 9)
-               if len(fields) == 9:
-                   assert fields[-1] == 'INVISIBLE_WALL_FACE'
-       print(name, nv, ni // 3, report['warnings'])
-   pathlib.Path('broken.fprs').write_bytes(b'FPRS\x01\0\0\0\0')
-   PY
-   ./fp_roomscan --offline broken.fprs --out broken --json
-   echo "$?"
-   test ! -e broken/room.txt
-   test ! -e broken/room-mesh.bin
-   ```
-
-   Expected: `{"ok":false,"error":"truncated frame header"}`, exit status 2, no `broken` outputs.
-
-4. Record actual RoomView dumps with the maintainer's recorder (FPRS v1, mesh-to-STAGE poses, stable universe).
-   Copy the recording to `~/Downloads/capture.fprs`. Look around slowly for about a minute, including floor,
-   ceiling, every wall, and furniture from several directions. With the **recorded universe id** assigned below:
-
-   ```sh
-   scan_universe=0  # replace 0 with the recorder's actual decimal universe id
-   /usr/bin/time -v ./fp_roomscan --offline "$HOME/Downloads/capture.fprs" --out real --universe "$scan_universe" --json > real.json 2> real-timing.log
-   cat real.json real-timing.log
-   cat real/room.txt
-   ```
-
-   Measure wall offsets/yaws, ceiling and table top physically and compare to the records (target 5 cm / 2°).
-   Check resident memory below 300 MB, sensible coverage/warnings, tabletop labels and no false wall/furniture
-   blobs from smeared edges. Repeat with `--max-edge 0.35 --grazing 0.2` into `real-stricter` if edges smear;
-   try `--voxel 0.08 --plane-distance 0.07` into `real-coarser` if depth is noisy. Keep both JSON logs and raw
-   dumps **outside git** for threshold calibration. These are proposed tuning probes, not established device fixes.
-
-5. Repeat the synthetic 1,800-frame benchmark from the preceding section on the Frame, using the same command
-   and `/usr/bin/time -v`. Then test a ten-minute independent real capture. Target: about 60 s elapsed or less,
-   less than 600 MB RSS, successful JSON and bounded mesh size. Record CPU time as well as wall time so storage
-   overhead is visible. With difficult stereo edges compare `--min-views 8 --patch-residual 0.02` in a fresh output
-   directory; short captures cap view support automatically. Include the JSON's exclusion counters in triage;
-   skipped frames may occur anywhere in the capture. Keep all personal results outside git.
-
-6. After merging plumbing/emulation, publish this staged room through that stream's room-install path and try
-   Demeter, then an MRUK discovery/mesh game. Check room loading, furniture alignment, and warning/fallback
-   behaviour in-headset; the scanner alone cannot verify the Meta API path. Do not replace `rooms/current` by hand
-   during these standalone checks.
-
-Undo standalone checks: remove only the isolated `~/.local/share/frameport/roomscan-test` directory and the five
-test files copied to `~/Downloads` (plus `capture.fprs` if no longer needed). No Steam settings, games, agent,
-room universe folder, or current-room symlink were changed by these steps.
@@ -108,21 +108,3 @@ shots:
    steps:
      - go: settings
      - wait_for: "Portal (OLED)"
-
-  - name: room             # experimental: the pretend Frame's made-up bedroom scan (fakes.fake_room), no real scan
-    docs: [README.md, docs/INSTALL.md]
-    viewport: [1280, 1690]
-    steps:
-      - hook: open_room
-      - wait_for: "Furniture & screens"
-      - park: true
-
-  - name: room-editing     # a box picked in the list (its type, place and size) next to the clean-up's labels
-    docs: [docs/INSTALL.md]
-    viewport: [1280, 2000]  # (tall enough that nothing scrolls)
-    steps:
-      - hook: open_room
-      - wait_for: "Furniture & screens"
-      - hook: {name: room_editing, args: [box]}
-      - park: true
-    crop: {anchor: "Furniture & screens", left: -26, top: -28, width: 670, height: 1262}
@@ -4,14 +4,6 @@ FrameBridge includes automatic metadata retirement for the verified Meta XR Audi
 Wwise build; see [AUDIO_METADATA.md](../docs/AUDIO_METADATA.md) for its lifetime
 invariant and regression coverage. It uses the existing adapter installation.

-`adapter/swapchain_pool.c` implements default-off GLES `swapchain_pool` (#387): at eight live app runtime
-swapchains, eligible single-layer colour images use private GL textures packed into up to two lazy 4096² sRGB
-runtime atlases. EndFrame copies each referenced source once and rewrites the final quads (including cylinder
-strips), cylinders and stereo projection views after existing layer fixes. OpenXR image ownership, GL bindings,
-scissor state, source fences, rectangle reuse and session cleanup are covered by `tests/test_swapchain_pool.py`
-(`FRAMEPORT_NATIVE_TESTS=1`, host compiler + cached OpenXR and GLES/EGL headers). Vulkan is unaffected. Host-tested;
-4XVR submenu interaction, visual correctness and copy cost still need a headset check.
-
 Sources of the prebuilt binaries in `../artifacts/` (committed, with `SHA256SUMS`). End users never compile anything;
 developers rebuild with `python native/build.py` (downloads NDK r27c, OpenXR headers at pinned commits, d8 into
 `native/.cache/`, git-ignored). The adapter, GL shim and platform compat rebuild byte-identically; the VrApi bridge
@@ -40,9 +32,3 @@ missing symbols (no compiler needed).

 After changing anything here: `python native/build.py`, commit artifacts + SHA256SUMS, then run `frameport parity`
 (the report marks updated binaries as "expected") and a device launch test.
-
-`adapter.fixed_resolution` (off by default, #406/#394) keeps META recommended layer
-resolution at tracked full swapchain size. Both adapter GIPA and xrshim's existing
-extension entry point serve it; the setting adds OVRPlugin shim routing. The extension
-stays visible, avoiding dependence on a plugin fallback. No adapter revision bump for
-this opt-in fix. See DEVICE_NOTES "Fixed layer resolution / Batman" for verification.
@@ -42,8 +42,7 @@ static XRAPI_ATTR XrResult XRAPI_CALL eye_hook_xrReleaseSwapchainImage(XrSwapcha
    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
    if (is_standin(swapchain)) return XR_SUCCESS;
    if (release_wait_active()) eye_wait_for_gpu();
-    int pooled = pool_find(swapchain);
-    XrResult result = pooled >= 0 ? pool_cycle(pooled, 2, NULL) : fn(swapchain, info);
+    XrResult result = fn(swapchain, info);
    if (eye_debug) {
        int64_t now = monotonic_ns();
        pthread_mutex_lock(&eye_lock);
@@ -1,22 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-only
-// swapchain_size is the adapter's mutex-protected table, shared with rect_clamp.
-static int fixed_layer_size(const XrCompositionLayerBaseHeader *layer, XrExtent2Di *full) {
-    if (!layer) return 0;
-    uint32_t w = 0, h = 0;
-    if (layer->type == XR_TYPE_COMPOSITION_LAYER_PROJECTION) {
-        const XrCompositionLayerProjection *p = (const XrCompositionLayerProjection *)layer;
-        if (!p->viewCount || !p->views) return 0;
-        for (uint32_t v = 0; v < p->viewCount; ++v) {
-            uint32_t vw, vh;
-            if (!swapchain_size(p->views[v].subImage.swapchain, &vw, &vh)) return 0;
-            if (v && (vw != w || vh != h)) return 0; // no single full size for this layer
-            w = vw; h = vh;
-        }
-    } else if (layer->type == XR_TYPE_COMPOSITION_LAYER_QUAD) {
-        const XrCompositionLayerQuad *q = (const XrCompositionLayerQuad *)layer;
-        if (!swapchain_size(q->subImage.swapchain, &w, &h)) return 0;
-    } else return 0; // preserve runtime behavior for other layer types
-    if (!w || !h || w > INT32_MAX || h > INT32_MAX) return 0;
-    full->width = (int32_t)w; full->height = (int32_t)h;
-    return 1;
-}
Author	SHA1	Message	Date
Codex	b5dab15149	Route embedded Khronos OpenXR loaders through FrameBridge Detect and redirect static loader manifests and Android brokers, ship a runtime negotiation shim and the inner loader chain, and maintain per-game manifests on install and launch. Add the PrimedGun recipe, triage and host coverage.	2026-10-18 12:39:35 -04:00
spoopyghosty0andClaude Opus 5.5	54effe9ab0	Catalog: HardBullet (issues: cube loading screen, view freezes during loads) Closes #385 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-18 12:17:35 -04:00
spoopyghosty0andClaude Opus 5.5	d78fcbd20a	OpenGL ES shader dump/fix offered for Unity games whose boot.config mentions Vulkan; either setting brings in the shader-fix layer (#382 ) SynthRiders is analysed as 'Vulkan (Unity boot.config)' but renders with GLES on Zink, so the dump was hidden in Game settings and session triage's suggestion was dropped; the dump setting alone also never added the layer. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-18 12:14:42 -04:00
spoopyghosty0andClaude Opus 5.5	0322b8b4d6	Catalog: BattleTalent online rooms need Meta's account check, LAN works (#408 ) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-18 12:06:49 -04:00