From 8f922eb69aba6a023e0e8dcb0aa522da3efd79a1 Mon Sep 17 00:00:00 2001 From: zzstoatzz Date: Wed, 22 Jul 2026 12:00:43 -0500 Subject: [PATCH] refresh parity receipt to current Jetstream V2 --- docs/bootstrap-semantic-parity.md | 2 +- docs/configuration-parity.md | 2 +- docs/grafana-dashboard.md | 2 +- docs/opentelemetry.md | 2 +- docs/semantic-parity.md | 7 ++++++- docs/upstream-bootstrap-spec.md | 2 +- docs/upstream-harness.md | 4 ++-- tests/archive_client_e2e.py | 10 +++++----- tests/differential_oracle.py | 8 ++++---- tests/environment_contract.py | 2 +- tests/upstream_oracle/stream_differential_test.go | 2 +- 11 files changed, 24 insertions(+), 19 deletions(-) diff --git a/docs/bootstrap-semantic-parity.md b/docs/bootstrap-semantic-parity.md index 8f4809b..0e1e17f 100644 --- a/docs/bootstrap-semantic-parity.md +++ b/docs/bootstrap-semantic-parity.md @@ -2,7 +2,7 @@ No full-network deployment is allowed while any row in this gate is open. The reference is `bluesky-social/jetstream` commit -`f6d220f3551efd32bfc1a8757abc93f51a713c12` plus Atmos v0.2.14, not the +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6` plus Atmos v0.2.14, not the shape of Stream's API or a small simulator happy path. Recheck the pin before every experiment. diff --git a/docs/configuration-parity.md b/docs/configuration-parity.md index 7a88bc9..7ec1f54 100644 --- a/docs/configuration-parity.md +++ b/docs/configuration-parity.md @@ -1,7 +1,7 @@ # Jetstream V2 configuration parity Authority: pinned upstream commit -`f6d220f3551efd32bfc1a8757abc93f51a713c12`, `cmd/jetstream/main.go` and +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6`, `cmd/jetstream/main.go` and `internal/jetstreamd/options.go`. A row is closed only when the value changes the same runtime mechanism and an offline receipt observes that behavior. diff --git a/docs/grafana-dashboard.md b/docs/grafana-dashboard.md index 9694589..bdc309e 100644 --- a/docs/grafana-dashboard.md +++ b/docs/grafana-dashboard.md @@ -3,7 +3,7 @@ Stream reuses the upstream dashboard rather than maintaining a lookalike. The reviewed artifact is: -- upstream commit: `f6d220f3551efd32bfc1a8757abc93f51a713c12` +- upstream commit: `f29815c391fc2644f8a3dd36b899fb3697dd1ea6` - path: `contrib/grafana/jetstream.json` - SHA-256: `ef6033c182d8c3f9d88af7d91e61126724efbe72e6b940984c9de12e9530cd91` diff --git a/docs/opentelemetry.md b/docs/opentelemetry.md index 3b1b724..03435b7 100644 --- a/docs/opentelemetry.md +++ b/docs/opentelemetry.md @@ -1,7 +1,7 @@ # OpenTelemetry tracing Authority: pinned Jetstream V2 commit -`f6d220f3551efd32bfc1a8757abc93f51a713c12`, specifically +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6`, specifically `internal/obs/tracing.go`, `internal/obs/observe.go`, and its pinned OpenTelemetry Go SDK v1.44.0. diff --git a/docs/semantic-parity.md b/docs/semantic-parity.md index b697386..60d9022 100644 --- a/docs/semantic-parity.md +++ b/docs/semantic-parity.md @@ -3,9 +3,14 @@ Semantic parity means the same durable state transitions and externally observable behavior as `bluesky-social/jetstream`, not merely compatible routes or JSON. The current review receipt is upstream commit -`f6d220f3551efd32bfc1a8757abc93f51a713c12`, Atmos v0.2.14, and the canonical +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6`, Atmos v0.2.14, and the canonical dashboard at `contrib/grafana/jetstream.json` (SHA-256 `ef6033c182d8c3f9d88af7d91e61126724efbe72e6b940984c9de12e9530cd91`). +The 2026-07-22 refresh from the prior `f6d220f` receipt to this pin changed +only the upstream Docker/Nix toolchains and Go module versions: no Go source, +lexicon, fixture, or dashboard file changed. The oracle pin and offline Go +module cache were still advanced so the candidate is exercised with the exact +current dependency graph rather than relying on that source-level comparison. No full-network machine may be provisioned while any deployment blocker in this document or `bootstrap-semantic-parity.md` is open. diff --git a/docs/upstream-bootstrap-spec.md b/docs/upstream-bootstrap-spec.md index 253a283..f258228 100644 --- a/docs/upstream-bootstrap-spec.md +++ b/docs/upstream-bootstrap-spec.md @@ -1,7 +1,7 @@ # upstream bootstrap + lifecycle spec (condensed from agent study 2026-07-09) Current review pin: `bluesky-social/jetstream` -`f6d220f3551efd32bfc1a8757abc93f51a713c12`, Atmos v0.2.14. The pin is an +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6`, Atmos v0.2.14. The pin is an audit receipt, not permission to drift: refresh this comparison immediately before provisioning any full-network experiment. diff --git a/docs/upstream-harness.md b/docs/upstream-harness.md index 9dd6b2a..fd61cdb 100644 --- a/docs/upstream-harness.md +++ b/docs/upstream-harness.md @@ -165,7 +165,7 @@ checks `listSegments`, `getSegment`, `getBlock`, and `planBackfill`, then runs the upstream Go client through whole-segment, DID-filtered block, sentinel-only block, bounded-range, and archive-to-live-cutover plans. The client harness requires upstream HEAD -`f6d220f3551efd32bfc1a8757abc93f51a713c12`, selects a cached Go 1.26.4 +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6`, selects a cached Go 1.26.5 toolchain when necessary, and forces `GOTOOLCHAIN=local`, `GOPROXY=off`, and `GOSUMDB=off` for the actual Go build and run. `uv` is also forced offline; Zig's checksum-pinned dependencies must already be in its global cache. A @@ -260,7 +260,7 @@ parsed-but-idle compatibility flag. ## pinned differential oracle (2026-07-20) `just differential-oracle` refuses to run unless the upstream checkout is at -`f6d220f3551efd32bfc1a8757abc93f51a713c12`. A Go overlay places the committed +`f29815c391fc2644f8a3dd36b899fb3697dd1ea6`. A Go overlay places the committed test source inside upstream's `internal/oracle` package, so the receipt directly reuses its simulator world, physical JSS reader, event-log comparator, independent MST reconstruction, invariant checker, and public archive client. diff --git a/tests/archive_client_e2e.py b/tests/archive_client_e2e.py index 743dbfb..80029d6 100644 --- a/tests/archive_client_e2e.py +++ b/tests/archive_client_e2e.py @@ -6,7 +6,7 @@ The target must contain the deterministic 5,000-row archive produced by: zig build write-sample -- --archive /tmp/stream-xrpc-data No network resolution is permitted. The script rejects any upstream checkout -whose HEAD is not the semantic-parity pin and invokes the exact Go 1.26.4 +whose HEAD is not the semantic-parity pin and invokes the exact Go 1.26.5 toolchain from its module-cache path when the ambient `go` is older. """ @@ -19,7 +19,7 @@ import subprocess import urllib.request -UPSTREAM_PIN = "f6d220f3551efd32bfc1a8757abc93f51a713c12" +UPSTREAM_PIN = "f29815c391fc2644f8a3dd36b899fb3697dd1ea6" UPSTREAM = pathlib.Path( os.environ.get( "STREAM_UPSTREAM_REPO", @@ -46,7 +46,7 @@ def go_binary(): if explicit: return explicit ambient = output("go", "version") - if "go1.26.4 " in ambient: + if "go1.26.5 " in ambient: return "go" modcache = pathlib.Path(output("go", "env", "GOMODCACHE")) goos = {"Darwin": "darwin", "Linux": "linux"}.get(platform.system()) @@ -57,12 +57,12 @@ def go_binary(): raise SystemExit(f"unsupported cached Go toolchain platform: {platform.platform()}") cached = ( modcache - / f"golang.org/toolchain@v0.0.1-go1.26.4.{goos}-{machine}" + / f"golang.org/toolchain@v0.0.1-go1.26.5.{goos}-{machine}" / "bin/go" ) if not cached.is_file(): raise SystemExit( - "Go 1.26.4 is not available offline; install or cache it before this contract" + "Go 1.26.5 is not available offline; install or cache it before this contract" ) return str(cached) diff --git a/tests/differential_oracle.py b/tests/differential_oracle.py index 1cb10c9..90b9883 100644 --- a/tests/differential_oracle.py +++ b/tests/differential_oracle.py @@ -15,7 +15,7 @@ import subprocess import tempfile -PIN = "f6d220f3551efd32bfc1a8757abc93f51a713c12" +PIN = "f29815c391fc2644f8a3dd36b899fb3697dd1ea6" ROOT = Path(__file__).resolve().parents[1] UPSTREAM = Path( os.environ.get( @@ -38,7 +38,7 @@ def go_binary() -> str: explicit = os.environ.get("STREAM_GO") if explicit: return explicit - if "go1.26.4 " in output("go", "version", cwd=ROOT): + if "go1.26.5 " in output("go", "version", cwd=ROOT): return "go" modcache = Path(output("go", "env", "GOMODCACHE", cwd=ROOT)) goos = {"Darwin": "darwin", "Linux": "linux"}.get(platform.system()) @@ -49,12 +49,12 @@ def go_binary() -> str: raise SystemExit(f"unsupported cached Go toolchain platform: {platform.platform()}") cached = ( modcache - / f"golang.org/toolchain@v0.0.1-go1.26.4.{goos}-{machine}" + / f"golang.org/toolchain@v0.0.1-go1.26.5.{goos}-{machine}" / "bin/go" ) if not cached.is_file(): raise SystemExit( - "Go 1.26.4 is not available offline; install or cache it before this contract" + "Go 1.26.5 is not available offline; install or cache it before this contract" ) return str(cached) diff --git a/tests/environment_contract.py b/tests/environment_contract.py index a71a7a5..604f049 100644 --- a/tests/environment_contract.py +++ b/tests/environment_contract.py @@ -17,7 +17,7 @@ import urllib.request BIN = "./zig-out/bin/stream" -PIN = "f6d220f3551efd32bfc1a8757abc93f51a713c12" +PIN = "f29815c391fc2644f8a3dd36b899fb3697dd1ea6" ROOT = pathlib.Path(__file__).resolve().parents[1] UPSTREAM = pathlib.Path( os.environ.get("JETSTREAM_UPSTREAM", pathlib.Path.home() / "github.com/bluesky-social/jetstream") diff --git a/tests/upstream_oracle/stream_differential_test.go b/tests/upstream_oracle/stream_differential_test.go index 5ced1f9..b43dc3d 100644 --- a/tests/upstream_oracle/stream_differential_test.go +++ b/tests/upstream_oracle/stream_differential_test.go @@ -31,7 +31,7 @@ import ( "github.com/stretchr/testify/require" ) -const streamDifferentialPin = "f6d220f3551efd32bfc1a8757abc93f51a713c12" +const streamDifferentialPin = "f29815c391fc2644f8a3dd36b899fb3697dd1ea6" type synchronizedBuffer struct { mu sync.Mutex -- 2.51.2