v0.2.1 — narrowly supported stable release
This release supersedes v0.2.0 as GitHub Latest. Stable describes the exact supported matrix below; it does not claim compatibility with unnamed hosts, browsers, OMP builds, or remote-access paths.
Highlights since v0.2.0
- Working cards give titles the full row and use one compact uptime, project, and model-slug line without wasteful gaps; the reversible device-local action now says Hide instead of looking destructive.
- The all-clear state uses the same compact left-aligned information grid as the directory and no longer repeats counts already present in the masthead.
- Long session titles receive a dedicated mobile shell row and cannot collide with Back, Control, or connection state.
- Managed installs, status, diagnostics, and CLI help report the true 0.2.1 product version.
Advertised combinations
| role | combination |
|---|---|
| host | Debian 13 (trixie) x86-64 |
| host | macOS arm64 (Mac14,3) |
| client | Chrome on Android (Pixel 10 Pro) |
Exact qualified OS, browser, and kernel builds, per-lane evidence, and the qualifying candidate are recorded in docs/RELEASE_STATUS.md and docs/COMPATIBILITY.md at this source commit.
Required deployment preconditions
- Run OMP v17.4.1 at 9350b7990d26ebf69a604edc82d8558ef04adf30 with the patch included in this archive. Stock OMP is not sufficient at any version. Paired OMP packaging is not provided; use the documented versioned omp-gateway-patched route.
- Run Tailscale's TUN-mode client and Tailscale Serve over tailnet HTTPS. Userspace networking, Funnel, Portal Tunnel, and self-hosted or proxied relays are not supported.
Known environment limitation
Android Chrome can wedge its process-wide network state outside the qualified lock/Airplane/Doze transitions. Native EventSource reconnection and the bounded snapshot fallback recover the qualified cases; after an uninterrupted prolonged visible outage the loaded shell exposes force-stop/reopen help. The release does not claim page JavaScript can restart a failed browser process.
Windows remains unadvertised. Background Web Push delivery remains best-effort and is not part of the stable core support claim.
Install or upgrade
Extract omp-session-gateway-0.2.1-bun.tar, then run bun apps/gateway/src/cli.js install --origin https://host.tailnet.ts.net --allow user@example.com with the deployment's real values. Repeat --allow for additional identities. Active reinstall preserves configuration and the publisher token.
Rollback
Run bun apps/gateway/src/cli.js rollback when the predecessor is present in managed installation history. Otherwise reinstall the signed v0.2.0 stable archive with the deployment's existing origin and allowlist. Gateway rollback does not roll back the separately activated patched OMP executable.
- Source commit: 9efef77
- OMP baseline: 9350b7990d26ebf69a604edc82d8558ef04adf30 (tag v17.4.1) with the included patch
- Runtime: Bun 1.3.14; registry protocol 1; Push API 2
- Verification: https://github.com/alphastorm/omp-session-gateway/blob/9efef77820db3d530f54fa89ee9fbac61f13ad3b/docs/RELEASE.md