From 74ba889deab0bfde00f7d29654709e1abfbc0127 Mon Sep 17 00:00:00 2001 From: Joseph Doherty Date: Tue, 25 Aug 2026 12:47:54 -0400 Subject: [PATCH] docs: record cycle-3 client release --- .../2026-08-19/remediation/00-tracking.md | 35 +++++++++++++++---- docs/ClientPackaging.md | 17 +++++---- docs/plans/2026-08-25-cycle-3-p2-followups.md | 18 +++++----- 3 files changed, 47 insertions(+), 23 deletions(-) diff --git a/archreview/2026-08-19/remediation/00-tracking.md b/archreview/2026-08-19/remediation/00-tracking.md index b797b2d..02e1051 100644 --- a/archreview/2026-08-19/remediation/00-tracking.md +++ b/archreview/2026-08-19/remediation/00-tracking.md @@ -112,7 +112,7 @@ The continuation runs serially in the isolated `.worktrees/c3-p2-followups` work | K — client alarm parity | CLI-47/48/49/50 | `gpt-5.6-terra` high | Done | All five client suites green | | L — live watch-list/proto wave | watch-list refresh follow-up + WRK-32 proto comment | `gpt-5.6-sol` high | Done | Codegen clean; portable alarm/contract tests green; windev Worker.Tests green | | M — Windows gateway CI | TST-35 | `gpt-5.6-terra` medium | Done | windev `live` mode proves Worker, gateway, full-slnx, and live smoke tiers | -| N — integration and release | publish five clients + Contracts | `gpt-5.6-sol` high | In progress | Full local/windev gates; merged `main`; registry coordinates and Go tag verified | +| N — integration and release | publish five clients + Contracts | `gpt-5.6-sol` high | Done | Full local/windev gates; merged `main`; registry coordinates and Go tag verified | ### Continuation tasklist @@ -220,12 +220,12 @@ in 53 s; and the live-MXAccess smoke passed **8/8** in 1m46s. TST-35 commit: - [x] Run `git diff --check`, codegen, client-version, README, NonWindows build, and full gateway suite gates. - [x] Run all five client suites on the final candidate. -- [ ] Run final windev `live` gate at the exact candidate SHA. -- [ ] Merge/push the verified continuation to `main`; wait for green CI. -- [ ] Re-query all package coordinates and Go tag immediately before publish; abort on collision. -- [ ] Publish .NET Client + Contracts 0.2.1, Python 0.2.1, Rust 0.2.1, Java 0.2.2. -- [ ] Create/push `clients/go/v0.2.1` at the exact release commit. -- [ ] Verify every registry coordinate and Go module/tag, update `docs/ClientPackaging.md`, and record immutable release evidence here. +- [x] Run final windev `live` gate at the exact candidate SHA. +- [x] Merge/push the verified continuation to `main`; wait for green CI. +- [x] Re-query all package coordinates and Go tag immediately before publish; abort on collision. +- [x] Publish .NET Client + Contracts 0.2.1, Python 0.2.1, Rust 0.2.1, Java 0.2.2. +- [x] Create/push `clients/go/v0.2.1` at the exact release commit. +- [x] Verify every registry coordinate and Go module/tag, update `docs/ClientPackaging.md`, and record immutable release evidence here. Batch-N portable verification (2026-08-25): `git diff --check`, codegen freshness, client-version freshness, and the generated README check all passed without changing @@ -236,3 +236,24 @@ green (respectively **134 passed / 1 live skip**, all Go packages built/tested w clean `gofmt`, **169 passed / 1 opt-in TLS skip** from a clean virtual environment, **108 passed** plus clean `cargo fmt`/Clippy, and **132 passed / 0 failed** with the generated Java tree unchanged). + +Batch-N integration/release verification (2026-08-25): `main` was integrated and +released at exact commit `5776021970cbbe59813ba57579abe00d9fc61a46`; Gitea CI +run **783** concluded success. Windev `live` mode at that SHA built the x86/net48 +Worker with **0 warnings / 0 errors**, passed Worker.Tests **529 passed / 11 +opt-in skips / 0 failed**, built the full Windows solution with **0 warnings / 0 +errors**, passed the Windows gateway suite **1193/1193**, and passed the live +MXAccess smoke **8/8**. One preceding full-suite attempt hit a transient fake-worker +disconnect in the reconnect/replay test; the test then passed **50/50** isolated +macOS runs and **20/20** isolated windev runs before the clean full-gate pass. + +Immediately before publication, all five package coordinates returned HTTP 404 +and `clients/go/v0.2.1` was absent locally/remotely. The published coordinates are +NuGet `ZB.MOM.WW.MxGateway.Client` **0.2.1** and +`ZB.MOM.WW.MxGateway.Contracts` **0.2.1**, PyPI +`zb-mom-ww-mxaccess-gateway-client` **0.2.1**, Cargo +`zb-mom-ww-mxgateway-client` **0.2.1**, and Maven +`com.zb.mom.ww.mxgateway:zb-mom-ww-mxgateway-client` **0.2.2**. Each exact Gitea +package API coordinate returned HTTP 200 after publication. Annotated Go tag +`clients/go/v0.2.1` resolves locally, remotely, and through `go list -m` to +`5776021970cbbe59813ba57579abe00d9fc61a46`. diff --git a/docs/ClientPackaging.md b/docs/ClientPackaging.md index 47d008f..6bb9a21 100644 --- a/docs/ClientPackaging.md +++ b/docs/ClientPackaging.md @@ -140,13 +140,16 @@ publish while the version constants still read the already-published 0.2.0/0.2.1 numbers above — see `clients/python/README.md` for the user-facing warning. **0.2.0 is superseded by 0.2.1; do not install it.** -As of this remediation (CLI-46), the in-source version constants for the -.NET, Go, Python, and Rust clients (plus Contracts) read **0.2.1**, and the -Java client reads **0.2.2**. These are not yet published — the numbers -above (0.2.0 four clients + Contracts, 0.2.1 Java) remain the live registry -state until the next `pack-clients.ps1` / `tag-go-module.ps1` run. Once that -publish lands, update this section with the new coordinates and commit(s), -the same way the 2026-08-07 record above was written after the fact. +On 2026-08-25 the superseding release shipped from commit +`5776021970cbbe59813ba57579abe00d9fc61a46`. Published coordinates on +`gitea.dohertylan.com` are `nuget` `ZB.MOM.WW.MxGateway.Client` **0.2.1** and +`ZB.MOM.WW.MxGateway.Contracts` **0.2.1**, `pypi` +`zb-mom-ww-mxaccess-gateway-client` **0.2.1**, `cargo` +`zb-mom-ww-mxgateway-client` **0.2.1**, and `maven` +`com.zb.mom.ww.mxgateway:zb-mom-ww-mxgateway-client` **0.2.2**. The Go module +tag `clients/go/v0.2.1` points to that same commit. Every exact package +coordinate returned HTTP 200 through the Gitea package API after publication, +and `go list -m` resolved `v0.2.1` to the tagged commit. ## .NET diff --git a/docs/plans/2026-08-25-cycle-3-p2-followups.md b/docs/plans/2026-08-25-cycle-3-p2-followups.md index 08a6c21..026ac0d 100644 --- a/docs/plans/2026-08-25-cycle-3-p2-followups.md +++ b/docs/plans/2026-08-25-cycle-3-p2-followups.md @@ -394,12 +394,12 @@ Query every exact registry coordinate for HTTP 200 and resolve the Go module/tag ## Final Tasklist Exit Gate -- [ ] All 16 open P2 findings are Done with commit/test evidence. -- [ ] WRK-34 is corrected to Done (`3679e59`). -- [ ] Live watch-list refresh passes portable and windev tests. -- [ ] WRK-32 public proto comment is regenerated through every client surface. -- [ ] TST-35 nightly Windows gateway suite is proven on windev. -- [ ] Full NonWindows gateway suite and all five client suites pass. -- [ ] Worker.Tests and Windows gateway suite pass at the integrated release SHA. -- [ ] Five client releases plus Contracts are confirmed in registries; Go tag resolves. -- [ ] `archreview/2026-08-19/remediation/00-tracking.md` contains no stale Deferred row for completed work. +- [x] All 16 open P2 findings are Done with commit/test evidence. +- [x] WRK-34 is corrected to Done (`3679e59`). +- [x] Live watch-list refresh passes portable and windev tests. +- [x] WRK-32 public proto comment is regenerated through every client surface. +- [x] TST-35 nightly Windows gateway suite is proven on windev. +- [x] Full NonWindows gateway suite and all five client suites pass. +- [x] Worker.Tests and Windows gateway suite pass at the integrated release SHA. +- [x] Five client releases plus Contracts are confirmed in registries; Go tag resolves. +- [x] `archreview/2026-08-19/remediation/00-tracking.md` contains no stale Deferred row for completed work.