reeflog-client 0.7.25 → 0.7.27

package/README.md

@@ -10,11 +10,11 @@ durable cursor, no catch-up. Every project rebuilds reconnect, dedup,
 gap-fill, and reorg handling, or silently loses events. reeflog makes that
 one daemon, one file, one cursor.
 
-**Status: v0.7.25 (2026-11-13), live against mainnet-beta — no Rust toolchain needed: `npm install reeflog-client`, then `import { bootstrap } from 'reeflog-client'; await bootstrap()` (downloads the prebuilt release archive and verifies its sha256 against what the GitHub release API publishes). The client itself is zero-dependency: one package, no `node_modules` of its own, and it installs without `git` on the machine.**
+**Status: v0.7.27 (2026-11-15), live against mainnet-beta — no Rust toolchain needed: `npm install reeflog-client`, then `import { bootstrap } from 'reeflog-client'; await bootstrap()` (downloads the prebuilt release archive and verifies its sha256 against what the GitHub release API publishes). The client itself is zero-dependency: one package, no `node_modules` of its own, and it installs without `git` on the machine.**
 
 The same client from the tagged release:
-`npm install github:auroraxo/reeflog#v0.7.25`. Or from source:
-`cargo install --git https://github.com/auroraxo/reeflog --tag v0.7.25`.
+`npm install github:auroraxo/reeflog#v0.7.27`. Or from source:
+`cargo install --git https://github.com/auroraxo/reeflog --tag v0.7.27`.
 
 **Honest state:** it works, and it is measured — but so far every real
 consumer belongs to the project itself. There is no unaffiliated third-party
@@ -37,7 +37,7 @@ no data source on public RPC serves that), or a managed hosted feed
 ## Quickstart (verified run, ~1 minute)
 
 Everything below was executed against `api.mainnet-beta.solana.com` on
-2026-11-13 with the published v0.7.24 binary; your numbers will differ with
+2026-11-13 with the published v0.7.25 binary; your numbers will differ with
 chain traffic.
 
 ```bash
@@ -155,6 +155,7 @@ detail and every raw number in
 | Archive depth | 39 holes at ~24 h depth filled and verified anchored |
 | Retractions | proven against a **real fork of a real chain**, 47/47 checks |
 | Refusals | every documented CLI line runs against the binary in CI (`tests/documented_surface.rs`); unknown flags are refused, never ignored |
+| Gap ledger | one hole = one episode: the published v0.7.26 asset counted scans (one hole → two open rows, `gaps_open: 1` forever on a healed journal); measured on the published asset, fixed in v0.7.27 |
 
 ## Conditions and limits — the honest part
 
@@ -180,6 +181,19 @@ detail and every raw number in
 - **A consumer must read the exit code.** `tail` exits 3 when a row's
   payload is still owed and holds the cursor there; treating every
   non-zero as "retry everything" replays forever. `exit 1` is a refusal.
+- **A `--limit` is a budget, not a hint, and the push report is the queue.**
+  `webhook push --limit 0` sends zero bytes and moves no cursor; a bounded
+  pass reports `remaining_behind_cursor` and `truncated` so a page can never
+  read as a drained mailbox (measured on the published v0.7.25 asset, fixed
+  in v0.7.26 — see the deep dive).
+- **One hole is one episode, and a heal closes it.** The gap ledger used to
+  count SCANS: every `verify` over the same hole opened another `hole` row,
+  and `repair` closed only the oldest one — so a journal the chain called
+  whole still reported `gaps_open: 1`, forever. `gaps_open` is the field
+  every operator and monitoring caller reads to decide whether the mailbox
+  is whole; a permanent false alarm there trains the reader to ignore it.
+  Measured on the published v0.7.26 asset, fixed in v0.7.27 (see the deep
+  dive).
 - **The client is zero-dependency since v0.7.25.** Until then the npm
   manifest named *itself* as a dependency on github:, so every
   `npm install reeflog-client` also cloned a second, older copy of the
@@ -192,7 +206,7 @@ detail and every raw number in
 ## Deep dives
 
 - [docs/measured-history.md](https://github.com/auroraxo/reeflog/blob/main/docs/measured-history.md) — the complete
-  README measurement and contract history through v0.7.25, unbroken.
+  README measurement and contract history through v0.7.27, unbroken.
 - [`research/`](research/) — every committed measurement artifact behind the
   numbers above (raw JSON reports, pinned by tests).
 - [`tests/`](tests/) and [`test/`](test/) — the contract tests: the CLI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reeflog-client",
-  "version": "0.7.25",
+  "version": "0.7.27",
   "description": "Node client for reeflog, the durable local mailbox for Solana events: cursor-based event delivery, retractions, health and repair.",
   "license": "MIT",
   "type": "module",