From 0b6e193e537b86c0d01c5bdcbc1cb024c088de2c Mon Sep 17 00:00:00 2001 From: zzstoatzz Date: Mon, 27 Jul 2026 12:15:27 -0500 Subject: [PATCH] docs: get deployment state and a stale parity verdict out of the README Two problems, both mine. The README carried operational state -- which deployment is promoted, which digest is admitted, which canary was retired. That rots the moment anything ships, and it is already recorded where it belongs: receipts/ for artifacts, the runbook for a run, the field log for history. Worse, it asserted Stream is "not at semantic parity". That was true when it was written and is not true now: the gate's own decision section says every correctness blocker is closed, no row is blocked, and "nothing there behaves differently from upstream". All four remaining partial rows are observability evidence -- per-family producer semantics, dashboard panels, span re-audit, and the differential oracle's own reach. None is a behavioral divergence. I copied that sentence forward without re-reading the gate, in a commit whose stated purpose was removing stale claims -- exactly the rot the gate warns about directly above that section. The README now points at the gate instead of paraphrasing it, so there is one place to be wrong. Also corrected: the collections and segments status views are no longer absent; 824bd5a added them and the gate has that row verified. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 33 +++++++++------------------------ 1 file changed, 9 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 2452f23..fdb6761 100644 --- a/README.md +++ b/README.md @@ -2,25 +2,9 @@ a zig implementation of [jetstream](https://github.com/bluesky-social/jetstream) — the full-network archive and streaming service for atproto. built on [zat](https://tangled.org/zat.dev/zat). -## status - -No public Stream deployment is currently promoted. The former live-only -`stream.waow.tech` canary and the July 2026 isolated experiments have been -retired. - -The implementation is **not** at semantic parity with pinned Jetstream V2 -commit `f29815c`. [`docs/semantic-parity.md`](docs/semantic-parity.md) is the -deployment gate and the only authority on what is proved: 23 verified rows, -4 partial, none blocked. Four experiments' worth of history — including what -each failure bought — is in -[`docs/full-network-experiment-2026-07.md`](docs/full-network-experiment-2026-07.md), -and [`docs/deployment-runbook.md`](docs/deployment-runbook.md) is what to -actually do, in order. - -An artifact is admitted for the next whole-network experiment: -`sha256:43001041…` (`receipts/eb95c14.json`, 20/20 suites, built natively on -linux/amd64). An admitted artifact means those suites passed against *that -digest* — it is not by itself a claim of parity. +Stream targets semantic parity with pinned Jetstream V2 commit `f29815c`. +[`docs/semantic-parity.md`](docs/semantic-parity.md) is the authority on what +that currently rests on, row by row, and no claim here overrides it. ## what it does @@ -50,11 +34,11 @@ digest* — it is not by itself a claim of parity. were unavailable or changed during bootstrap - **crash-resumable timestamp imports** with a durable RocksDB rule map, topology-preserving sealed-segment repair, and bearer-gated operator XRPC -- **operations views** at `/status`, including durable PDS diagnostics at - `/status?tab=hosts` and per-repository reconstruction and authoritative root - verification at `/status?tab=accounts`, plus Prometheus metrics at `/metrics` - on the optional debug listener. Upstream's collections/segments status views - are absent +- **operations views** at `/status` — a summary field report plus hosts, + accounts, collections, and segments tabs, with durable PDS diagnostics, + per-repository reconstruction, and authoritative root verification against + the PDS commit root. Prometheus metrics are on the optional debug listener at + `/metrics` ## develop @@ -84,6 +68,7 @@ Start here depending on what you need: | [`cli.md`](docs/cli.md) | offline operator commands | | [`testing.md`](docs/testing.md) | suites, oracles, receipts | | [`benchmarks.md`](docs/benchmarks.md) | subsystem benchmarks | +| [`full-network-experiment-2026-07.md`](docs/full-network-experiment-2026-07.md) | field log of whole-network runs and what each failure bought | The rest of `docs/` holds the port record: the jss format byte spec and seal spec, upstream bootstrap/compaction/subscribe condensations where every -- 2.51.2