Repo hygiene round following a full review. No shim behaviour changes.
Leak risk:
- .gitignore: ignore CLAUDE.md (personal assistant-lane config, was one
`git add -A` away from a public commit) and scratch_obj/.
Docs vs. reality:
- shim/README.md: rewritten. It described a pre-implementation skeleton with
"core fns are TODO stubs returning -1005", three mutually inconsistent stub
counts, and four completed milestones listed as open. Now carries the verified
breakdown: 438/438 exports = 371 generated stubs + 46 core + 7 layers + 2
Vulkan queries + 12 passthru trampolines.
- TESTING.md: dropped the self-contradicting "NOT yet" block (5 of 6 items were
done or misstated, and contradicted the same file 45 lines above). Path B now
points at tools/desktop-harness, which exists, instead of the orphaned
shim/tests/harness.c. Path A prereqs marked as the record they are.
- HOST.md: corrected the runtime assumption. The OpenXR runtime inside Lepton is
SteamVR (vendor/etc/openxr/1/active_runtime.json -> vrclient.so), not Monado.
Favourable: SteamVR emulates Oculus Touch by default and advertises the
XR_FB_foveation family, so the existing input and foveation paths should carry
over. The old "remaining unknowns" are resolved by Lepton's published source
and replaced with the items to check before a first Frame boot.
- README.md: same runtime correction.
- docs/research/RECON.md: the four passages prescribing an entitlement
NOP/stub/bypass are corrected in place rather than merely disclaimed by the
top banner, which they contradicted.
Build correctness:
- shim/build_android.sh: missing patchelf is now fatal. It warned and exited 0,
producing a .so that cannot resolve the OpenXR loader at runtime.
- scripts/fetch_deps.sh + packaging/build_openxr_loader.sh: pin the OpenXR and
Vulkan header versions (were tracking `main`), overridable via OPENXR_TAG /
VULKAN_HEADERS_TAG; require cmake for the loader build.
- packaging/steamframe_patches.sh: use the apktool.jar that fetch_deps.sh
downloads. Its prereq check demanded an `apktool` binary on PATH that the
documented setup never provides, so it could not run after a clean setup.
- shim/gen_stubs.sh: it reads all_exports.txt, not shim_surface.txt; comment and
emitted banner corrected. stubs.c regenerated (banner line only).
- shim/src/core.c: split seven `if (out) ...; return ...;` one-liners. Host
build now compiles with zero warnings, down from seven.
Verified: host build 0 warnings; gen_stubs.sh output identical on regeneration;
bash -n clean on all edited scripts; pinned header/tarball URLs return 200 and
the tag tarball extracts to the expected directory name.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
- ovrp_GetTimeInSeconds: real export returning double (legacy direct-return
ABI); the autogen ovrpResult stub left d0 uninitialized and the game reads it
- seqlock writer: fence the odd-mark before the data stores (torn-pose window)
- drain the frameState ring on STOPPING/shutdown (stale displayTime + permanent
one-frame skew after every session pause)
- begin_frame FIFO bail: bound the wait (surface-teardown deadlock) and measure
the deadline on CLOCK_MONOTONIC, immune to wall-clock steps
- passthru: pthread_once takeover + acquire/release PT_FWD pointer cache
(first-use race could run the shim path mid-takeover)
- luma/dump/barcode readback disabled for non-4-byte swapchain formats
(staging buffers assumed 4 B/texel; wider fallback formats would overflow)
- vkWaitForFences: honor timeouts everywhere; never reset a pending cmd buffer
- detect_ue_queue: keep the caller's queue family/index when detection fails
- xrr_get_node_pose: g_spaceLock vs the sitting/standing appSpace recreate
(locate on a freed XrSpace)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Consolidate the two inline notes into one prominent note at the top of the doc, so
the "this stub approach was not carried into the project" framing is seen before any
of the entitlement-stub passages rather than only beside them.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D6sFYGXZPsq3v7xtcDES6g
The deployable arm64 artifact was built with no -O flag (-O0) while the host build
used -O2. For a latency/throughput-focused shim that's a real miss — bring the
Android build to -O2 to match.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D6sFYGXZPsq3v7xtcDES6g
An independent reimplementation of Meta's libOVRPlugin ABI on top of OpenXR, so
VrApi-era Meta Quest VR titles can run on non-Meta OpenXR runtimes (Monado,
Steam Frame) instead of being locked to Meta hardware. Original code only — no
Meta/Epic/Capcom binaries, headers, or assets. Includes a desktop harness that
drives the shim against Monado headless.
Scope/legal: interoperability; entitlement handling is out of scope. See README
for the legal/scope section and docs/ for the research trail and design notes.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D6sFYGXZPsq3v7xtcDES6g
