From 6269425b3308f47a735313b63ed9b9d159564179 Mon Sep 17 00:00:00 2001 From: Elijah Date: Sat, 24 Oct 2026 09:39:41 -0700 Subject: [PATCH] Document verified live update from 0.1.0 to 0.1.1 --- docs/runtime-verification.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/runtime-verification.md b/docs/runtime-verification.md index c675ae7..4b297d2 100644 --- a/docs/runtime-verification.md +++ b/docs/runtime-verification.md @@ -35,3 +35,20 @@ The final release recheck after adding the app baseline rules passed again: medi - Built with `Build.ps1 -Release -Test`: optimized release, existing unit test and lint passed (zero errors, existing warnings/hints remain). Installed in place on the authorized onn with the existing encrypted session intact, then installed the baseline profile and compiled only Kaleido with `speed-profile`. - Recorded and inspected the actual cold-start sequence, Home and Movies/TV screenshots, and both rating states. `verify_ui.py browse` passed all six checks; `repro_runtime.py sections` passed startup tab switching, TV loading and cached Movies return. The harness now waits for the splash's accessibility description to disappear instead of counting wordmark text nodes. - Private evidence: `ratings-home.png`, `final-movies-discover.png`, `kaleido-startup-review.mp4`, and the trimmed `kaleido-intro.mp4` in ignored `evidence/private/`. No playback checks or new frame-pacing benchmark were needed for these cosmetic changes. Left the optimized release on Home. + +## First published release and live updater test - 2026-10-24 + +Published [Kaleido 0.1.1](https://git.elijahkuntz.com/Elijah/Kaleido/releases/tag/v0.1.1), version code 2, from commit `c3917c6`. Both the main validation workflow and matching tag publication workflow passed. The locally signed distribution retains the installed application's signing certificate. Anonymous requests to the release API, APK and checksum returned HTTP 200 without redirects; the release asset and immutable tagged repository APK matched the local SHA-256 (`6f1d42ee5167dcb3743b7dafbecfed9942e496ee10b8b277ba2a3ba66c6407ba`). The packaged APK was also checked for the private Plex token, `.env` and signing keys; none were embedded. + +The onn stayed on version 0.1.0 / code 1 until the actual in-app installation. No ADB install of 0.1.1, downgrade, sign-out or app-data reset was used: + +1. In Settings, the existing app's manual check reached the public server. Before a Forgejo release existed, it discovered 0.1.1 using `distribution/latest.json` and its immutable tag URLs. +2. After the tag workflow published the release, another manual check discovered the published release. Selecting **Download & install 0.1.1** completed download, checksum, package, increasing-version and signing-certificate validation, then opened Android's source-permission screen. +3. Enabled **Kaleido only** in Install unknown apps. Returning to Kaleido automatically opened Android's **Do you want to update this app?** confirmation. Selected **Update**, and Android reported **App installed.** +4. Selected **Open**. Live Plex Home returned with the existing encrypted connection intact. Settings retained Direct stream, 1080p / 20 Mbps conversion quality and the 80% watched threshold. +5. Android and Kaleido both reported 0.1.1 / code 2. The APK pulled from the installed package matched the published APK byte for byte. Another manual check reported **Kaleido is up to date.**, with no redundant download action. +6. Reinstalled the baseline profile and compiled only Kaleido with `speed-profile`; left the updated release on Home. + +For future live checks, start with an installed lower version signed by the same key, publish a genuinely higher version/code, navigate to Settings > Software updates with the D-pad, and follow the sequence above. Never clear app data to manufacture an update scenario. Android's source permission is a one-time, per-app step; the package installer still requires explicit confirmation for each update. Wait for the TV Settings source list to populate before selecting Kaleido. + +Private evidence remains in ignored `evidence/private/`: `updater-results.json`, `published-release.json`, `updater-before.png`, `updater-fallback-discovery.png`, `updater-release-discovery.png`, `updater-source-allowed.png`, `updater-confirmation.png`, `updater-installed.png`, `updater-after.png` and `updater-final-home.png`. This verifies manual discovery, the manifest fallback and a real release download/install. It does not independently test the six-hour automatic-check interval, permission denial/retry, or rejection of deliberately corrupted/wrong-signed APKs.