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