geesawra.industries/hydraulophone
An unofficial YouTube Music app for iPhone, iPad, and Mac.
MVP validation record
This document records evidence for the merged MVP without treating a passing fixture test or a quiet log as proof of live service or device behavior.
Snapshot
- Latest basic live evidence: 2026-09-22 13:59 local
- Extended live evidence: 2026-09-22 14:06–14:07 local
- Hosted Core/app evidence: 2026-09-22 14:00 local
- Earlier diagnostic snapshot: 2026-09-22 00:24 local
- Toolchain: Xcode 27 / iOS 27
- Simulator destination: iPhone 18 Pro
- Physical iPhone: not available
The implementation target is a single iPhone app. Simulator and device destinations use the same code; the simulator entitlement is selected only for the simulator SDK.
Evidence
| Check | Result | What it demonstrates | What it does not demonstrate |
|---|---|---|---|
swift test | 31 passed | Current offline Hydraulophone Core request, model, parser, and state tests | A live InnerTube response, account session, or AVPlayer stream |
| Hosted Core + app tests | 64 passed; 0 skipped; 0 failed (14:00) | The hosted simulator test run for the current Core and app targets | Physical-device audio or every live service path |
just simulator-smoke (basic live) | Pass (13:59) | Keychain restore; search 17 results; 11 playlists; 100 tracks; native AVPlayer progress for at least two seconds | Every track, physical-device playback, or background audio |
just simulator-smoke-extended | Pass (14:06–14:07) | Same browse path; 30 seconds sustained playback; pause/resume; seek to 65%; next-track progress | Every track, physical-device playback, or background audio |
Historical just simulator-smoke (00:24) | Partial; retained for audit | Session restore passed; anonymous search returned 22 results | Current account behavior or a working stream |
The basic and extended runs used the IOS 21.03.3 candidate with the native
AVAssetResourceLoader/URLSession bridge and full Aura request headers. The
bridge resolved the observed AVPlayer 403. These runs establish a working
direct-AAC simulator checkpoint, not a guarantee that every track or device
route will decode.
The 2026-09-22 12:43 normal run is also retained as historical diagnosis: it
restored the session and reached the IOS candidate, but AVPlayer failed
with NSURLErrorDomain -1. The older 00:24 diagnostic reached authenticated
WEB_REMIX playlist browsing and received HTTP 500, backendError before
streaming. Neither result supersedes the current successful browse and
direct-AAC checkpoint. The temporary in-memory DATASYNC_ID omission
diagnostic was removed after A/B verification; no active omission command is
part of the validation path.
devicectl exposed only a simulator in the validation environment. No
physical-iPhone result is available for background audio, route changes,
interruptions, lock-screen controls, codec compatibility, or Keychain behavior
under device signing.
Current limitations
- The latest runs confirm account restoration, search/library parsing, and a
working direct-AAC simulator checkpoint. The adapter uses the corrected
FEmusic_liked_playlistsandVL<playlist-id>boundaries, keeps rawDATASYNC_IDopaque without sending it asonBehalfOfUser, and carries sessionVISITOR_DATAwhen available. A separatedelegatedSessionIDis populated only from authoritativeDELEGATED_SESSION_IDand emitted only when present. - The runtime uses a pinned
AuraWEB_REMIXconfiguration path. A homepage GET is not mandatory when the API key is absent, avoiding the earlier 302 consent bootstrap dependency. - Native AAC restriction and strict HTTPS host/redirect checks are merged. The URLSession bridge solved the observed AVPlayer 403, and the extended run observed sustained progress, but this is not proof for every track or device route.
- The player has no signature-decipherer or PO-token provider. Cipher-only or provider-dependent responses therefore remain an explicit unavailable state.
- Final range and URL-userinfo review fixes are pending a new hosted test run.
- The approved YouTubeKit signature and
ndeciphering adapter is follow-up work and has not landed. It is not required for the working direct-AAC checkpoint; cipher-only or provider-dependent responses remain unavailable.
Reproduction commands
The Justfile is the source of truth for command behavior; this list avoids
duplicating its scripts.
| Command | Use |
|---|---|
just check | Strict source lint, offline package tests, and app compile |
just simulator-test | Native tests on the configured iPhone simulator |
just simulator | Build, install, and launch the normal app on the simulator |
just simulator-offline | Launch deterministic fixture content without Keychain or network access |
just simulator-smoke | Opt-in bounded live check using an existing simulator Keychain session |
just simulator-smoke-ui | Opt-in authenticated UI navigation check |
just simulator-smoke-extended | Opt-in bounded playback, pause/resume, seek, and next-track check |
just simulator-logs | Stream the redacted Hydraulophone subsystem log |
just simulator-logs-recent | Show the recent redacted Hydraulophone subsystem log |
The smoke commands do not create or print credentials. They may make real
requests and can expose service-side failures; run them only with a dedicated
test account and an existing session that the operator is authorized to use.
The temporary DATASYNC-omission diagnostic is not an active command. The
extended command is owned by the parent Justfile; do not duplicate its
script here. Do not paste cookies, authorization values, visitor data, account
responses, or media URLs into this document or into issue reports.
Follow-up
After the final range and URL-userinfo review fixes, repeat the hosted test run and append a new dated result. The direct-AAC checkpoint is working, but a complete release claim still needs broader track coverage and physical-iPhone validation for device, route, and background behavior.