Update to Litestream 0.5.17

[cole-robertson]

Second of two, stacked on #2 (the runner). Contains only the version bump and what it forces; the dashboard redesign is a later PR, and so is IPC support, which fractaledmind#73 already implements and which should land on top of this as an optional enrichment rather than the only path.

What changes

• Binary 0.3.13 → 0.5.17. Tarballs pinned by sha256 for all four assets (Upstream::CHECKSUMS), verified in memory before extraction. A sidecar exe/<platform>/litestream.sha256 records what was packaged, so a cached binary from an earlier version is re-downloaded rather than shipped. No zip assets upstream any more, so rubyzip is dropped.
• Commands. generations, snapshots, wal are gone in 0.5; ltx and status replace them. status expands a relative database path: Litestream 0.5 filters status by the absolute path while ltx and restore match the config string, so without this the documented --database=storage/production.sqlite3 form printed an empty table. The three removed methods and rake tasks remain for one release as tombstones that raise with a pointer to ltx.
• Dashboard, minimal. Reads status -json (local, no daemon) and ltx -level all -json (replica). A command failure is isolated to that database; anything else raises. Process detection via systemctl/ps is unchanged and still matches a 0.5 daemon. This deliberately does not use the 0.5 IPC socket: it is off by default and only reachable from the process tree running replicate, so on Kamal or Docker with a separate replicate role a socket-based dashboard shows nothing. The socket does expose better data where it is reachable (a real last-sync timestamp, and a daemon-confirmed replica TXID from sync -wait), which is what Litestream v0.5.9 update fractaledmind/litestream-ruby#73 builds on. The two compose well: keep these CLI calls as the baseline that always works, and read the socket to enrich them when the config enables it and the file exists.
• Config. Generator template, dummy config and README in the 0.5 shape: single replica: per database, root-level snapshot: block. README's restore section lists the 0.5 flags; an "Upgrading from 0.3" section covers the config edit, the databases key rename (replicas → replica), the tombstones, and rollback.

Not touched: Puma plugin, engine, VerificationJob, executable, auth, version.rb (left for the release commit).

Verified

• Fresh Rails 8 app consuming the packaged native gem (bundled binary, no override): install generator, Puma plugin replicating to a local replica, dashboard over HTTP with and without basic auth and with the daemon stopped, the restore button, every rake task including the tombstones, and VerificationJob.

• 85 tests, 0 failures (the 39 tests for the removed commands are replaced by ltx/status/tombstone tests); standardrb clean; fork CI green.

• Native Gems workflow on the fork: all six platform packages build; linux-x86_64, darwin-arm64 and plain-ruby installs pass. (darwin-x86_64-install never starts because the workflow asks for the retired macos-13 runner; same on upstream.)

• rake gem:x86_64-linux from a clean tree: download, checksum OK, gem built; installed into a fresh, isolated GEM_HOME, litestream version → 0.5.17. Planting a wrong sidecar checksum triggers a re-download.

• Real 0.5.17 binary against a replica holding both 0.3 generations/ and 0.5 ltx/ history: status and ltx in JSON and table modes, the tombstones, and Litestream.databases in the dummy app returning status plus 16 LTX rows.

• Running in production at Rebulk (Nightrail Cloud): the readiness probe (status + ltx, six databases, every five minutes) and the weekly restore drill go through this gem.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: d9c68f3c-3e34-4861-b33e-be25cac887bb

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}