v0.3.0 — narrowly supported stable release
This release supersedes v0.2.1 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.1
- Exact patched OMP v18.1.14 integration and Bun 1.4.0 toolchain.
- Native MathML formula rendering without external fonts, stylesheets, or a weaker CSP.
- Transcript tail recovery when collaboration reconnects; View, Ask, and photo-composer boundaries remain intact.
- Managed upgrades preserve existing configuration unless an option is explicitly overridden.
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 v18.1.14 at daf07999c2fee9b22edc7bf8fea1fb6272e0df5e 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.3.0-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.1 stable archive with the deployment's existing origin and allowlist. Gateway rollback does not roll back the separately activated patched OMP executable.
- Source commit: 8a699ee
- OMP baseline: daf07999c2fee9b22edc7bf8fea1fb6272e0df5e (tag v18.1.14) with the included patch
- Runtime: Bun 1.4.0; registry protocol 1; Push API 2
- Verification: https://github.com/alphastorm/omp-session-gateway/blob/8a699ee3446b2aa7a6db9243e525e549040dca1c/docs/RELEASE.md