Repository navigation
v1.0.2
Outpace 1.0.2
For publication status and downloads, see the
GitHub Release.
These notes accompany the reviewed release commit; source documentation can precede publication.
Outpace 1.0.2 is a patch release and the first one published from the
outpace-stream organization. It fixes the warm peer cache on
Android and other hosts whose data directory sits under an execute-only parent, and bounds the
opt-in /metrics endpoint. It also adds a best-effort 32-bit Android archive. It changes no
defaults and needs no configuration change.
Fixes
- The warm peer cache now opens under execute-only parent directories
(#456,
#464). On Android, apps can traverse
but not list directories such as/data, so the cache was never reached. Every start was cold
and the log showed[ace] warm peer cache I/O failed; streaming continues without durable hints.
Termux and any Linux deployment with an execute-only ancestor were affected the same way. On
Linux and Android the cache path is now traversed withO_PATH. Ownership and mode checks,
symlink rejection and the exclusive writer lock are unchanged. Other Unix platforms keep their
previous behavior. GET /metricsscrapes are bounded
(#466,
#468). WithOUTPACE_METRICS=1, at
most two scrapes collect a snapshot at the same time, and each has two seconds. A scrape over
either limit gets503 Service UnavailablewithRetry-After: 1and an empty body, which
Prometheus records as a failed scrape rather than partial values. A normal scrape interval from
one or two Prometheus servers never reaches these limits. Nothing changes with metrics off.
Distribution
- Organization paths. The repository is now
outpace-stream/outpace-engine, and images are
published toghcr.io/outpace-stream/outpace-engine(1.0.2,1.0.2-minimal,latest,
minimal). Images up to 1.0.1 atghcr.io/jamezrin/outpacestay available for rollback but
receive no new tags. The Homebrew tap and Scoop bucket moved to
outpace-stream/homebrew-outpaceandoutpace-stream/scoop-outpace. Archive and package names
are unchanged. - Provenance. 1.0.2 archives, packages and images are attested by
outpace-stream/outpace-engine. Verify a downloaded file with
gh attestation verify <file> --repo outpace-stream/outpace-engine, and an image with
gh attestation verify oci://ghcr.io/outpace-stream/outpace-engine:1.0.2 --repo outpace-stream/outpace-engine.
Releases up to 1.0.1 keep
their original signer identity; see
Installation. - 32-bit Android. A best-effort
armv7-linux-androideabiarchive is published next to
aarch64-linux-android
(#459,
#462), for Android TV boxes that run
a 32-bit userland. Like the 64-bit Android archive, it is optional: a failed Android build never
blocks the release. - Arch Linux. The community AUR packages
outpace-binandoutpace-gitare now documented on
the Installation
page.
Targets, packages and service integrations are otherwise unchanged from
1.0.0.
Upgrade and rollback
Upgrading from 1.0.1 needs no configuration change. If you pull images, switch the image name to
ghcr.io/outpace-stream/outpace-engine:1.0.2. If you installed with Homebrew or Scoop before the
move, re-add the tap or bucket from its new repository. Restart, then check /healthz and
playback. Keep the 1.0.1 binary or image for rollback.
Validation and limits
The cache fix is covered by a regression test that writes, reopens and reads a cache beneath an
execute-only parent, which failed with EACCES before the fix. CI now checks that this test runs as
a normal user instead of skipping
(#469), and cache test fixtures wait for
the real load instead of a 100 ms best-effort window. The metrics bounds are covered by unit tests
for refusal, timeout and the 503 response. No new multi-hour soak, live comparison or hardware
qualification was performed for this release. Preparation checks and candidate CI are recorded in
the release PR.
What's Changed
- chore(github): add issue forms and security policy by @jamezrin in #455
- docs(release): publish 1.0.1 pins and verified status by @jamezrin in #458
- Migrate repositories to Outpace organization by @jamezrin in #460
- Publish best-effort 32-bit Android engine archives by @jamezrin in #462
- chore(hygiene): use the shared identifier hygiene action by @jamezrin in #463
- fix(ace-swarm): traverse execute-only cache ancestors by @jamezrin in #464
- docs: add Arch Linux AUR installation by @jamezrin in #465
- fix(ace-engine): bound /metrics scrapes by @jamezrin in #468
- test(ace-swarm): wait for real warm-peer cache load by @jamezrin in #469
- chore(release): prepare 1.0.2 by @jamezrin in #470
Full Changelog: v1.0.1...v1.0.2