Regenerate code-reviews index after High/Critical resolution batch

Reflects the resolution of Tests-001/002, IntegrationTests-001/002,
Client.Go-001, Worker-001/002/003 and Worker.Tests-001/002.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.gitignore

@@ -45,7 +45,6 @@ build/
 out/
 tmp/
 temp/
-install/
 
 # .NET
 **/bin/
@@ -147,8 +146,3 @@ generated-scratch/
 
 # Keep empty directories with .gitkeep files when needed
 !.gitkeep
-
-# Documentation review artifacts (CommentChecker output)
-*-docs-issues.md
-*-docs-fixed.md
-*-docs-final.md

CLAUDE.md

@@ -8,10 +8,10 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 The architecture is a two-process design — read `gateway.md` before making structural changes:
 
-- **Gateway** (`src/ZB.MOM.WW.MxGateway.Server`, .NET 10, x64): ASP.NET Core gRPC server. Owns the public API, sessions, auth, the Blazor dashboard, and the Galaxy Repository SQL browse RPCs. **Never instantiates MXAccess COM directly.**
-- **Worker** (`src/ZB.MOM.WW.MxGateway.Worker`, .NET Framework 4.8, **x86**): one process per session. Owns one MXAccess COM instance on a dedicated STA, pumps Windows messages, and converts COM events to protobuf.
+- **Gateway** (`src/MxGateway.Server`, .NET 10, x64): ASP.NET Core gRPC server. Owns the public API, sessions, auth, the Blazor dashboard, and the Galaxy Repository SQL browse RPCs. **Never instantiates MXAccess COM directly.**
+- **Worker** (`src/MxGateway.Worker`, .NET Framework 4.8, **x86**): one process per session. Owns one MXAccess COM instance on a dedicated STA, pumps Windows messages, and converts COM events to protobuf.
 - **IPC**: gateway↔worker uses one bidirectional named pipe per worker (`mxaccess-gateway-{gatewayPid}-{sessionId}`) with length-prefixed `WorkerEnvelope` protobuf frames. Gateway hosts the pipe server and launches the worker. **gRPC is not used inside the worker** — .NET Framework 4.8 doesn't have a first-class gRPC stack.
-- **Contracts** (`src/ZB.MOM.WW.MxGateway.Contracts`): multi-targets `net10.0;net48` and owns the `.proto` files (`mxaccess_gateway.proto`, `mxaccess_worker.proto`, `galaxy_repository.proto`). All other projects consume the generated types from here. Do not hand-edit anything under `Generated/`.
+- **Contracts** (`src/MxGateway.Contracts`): multi-targets `net10.0;net48` and owns the `.proto` files (`mxaccess_gateway.proto`, `mxaccess_worker.proto`, `galaxy_repository.proto`). All other projects consume the generated types from here. Do not hand-edit anything under `Generated/`.
 
 The worker must do all MXAccess COM calls on its dedicated STA thread, and the STA loop must pump Windows messages (`MsgWaitForMultipleObjectsEx` + `PeekMessage`/`DispatchMessage`) so MXAccess events deliver. A plain blocking queue on an STA is not enough.
 
@@ -19,42 +19,42 @@ The worker must do all MXAccess COM calls on its dedicated STA thread, and the S
 
 ```powershell
 # Full solution build (gateway, worker, contracts, tests)
-dotnet build src/ZB.MOM.WW.MxGateway.slnx
+dotnet build src/MxGateway.sln
 
-# Worker must be built x86 — the gateway looks for ZB.MOM.WW.MxGateway.Worker.exe under bin\x86
-dotnet build src/ZB.MOM.WW.MxGateway.Worker/ZB.MOM.WW.MxGateway.Worker.csproj -p:Platform=x86
+# Worker must be built x86 — the gateway looks for MxGateway.Worker.exe under bin\x86
+dotnet build src/MxGateway.Worker/MxGateway.Worker.csproj -p:Platform=x86
 
 # Gateway tests (no MXAccess required — uses FakeWorkerHarness)
-dotnet test src/ZB.MOM.WW.MxGateway.Tests/ZB.MOM.WW.MxGateway.Tests.csproj
-dotnet test src/ZB.MOM.WW.MxGateway.Worker.Tests/ZB.MOM.WW.MxGateway.Worker.Tests.csproj -p:Platform=x86
+dotnet test src/MxGateway.Tests/MxGateway.Tests.csproj
+dotnet test src/MxGateway.Worker.Tests/MxGateway.Worker.Tests.csproj -p:Platform=x86
 
-# Run gateway locally (defaults bound under MxGateway:* in src/ZB.MOM.WW.MxGateway.Server/appsettings.json)
-dotnet run --project src/ZB.MOM.WW.MxGateway.Server/ZB.MOM.WW.MxGateway.Server.csproj
+# Run gateway locally (defaults bound under MxGateway:* in src/MxGateway.Server/appsettings.json)
+dotnet run --project src/MxGateway.Server/MxGateway.Server.csproj
 
 # API-key admin CLI (same exe, "apikey" subcommand)
-dotnet run --project src/ZB.MOM.WW.MxGateway.Server/ZB.MOM.WW.MxGateway.Server.csproj -- apikey create --display-name "dev" --scopes session,invoke,event,metadata,admin
+dotnet run --project src/MxGateway.Server/MxGateway.Server.csproj -- apikey create --display-name "dev" --scopes session,invoke,event,metadata,admin
 ```
 
 Single test by name (xUnit `--filter`):
 
 ```powershell
-dotnet test src/ZB.MOM.WW.MxGateway.Tests/ZB.MOM.WW.MxGateway.Tests.csproj --filter FullyQualifiedName~GatewayEndToEndFakeWorkerSmokeTests
+dotnet test src/MxGateway.Tests/MxGateway.Tests.csproj --filter FullyQualifiedName~GatewayEndToEndFakeWorkerSmokeTests
 ```
 
 Live MXAccess integration tests are **opt-in** because they need installed MXAccess COM and live provider state:
 
 ```powershell
 $env:MXGATEWAY_RUN_LIVE_MXACCESS_TESTS = "1"
-dotnet test src/ZB.MOM.WW.MxGateway.IntegrationTests/ZB.MOM.WW.MxGateway.IntegrationTests.csproj --filter FullyQualifiedName~WorkerLiveMxAccessSmokeTests
+dotnet test src/MxGateway.IntegrationTests/MxGateway.IntegrationTests.csproj --filter FullyQualifiedName~WorkerLiveMxAccessSmokeTests
 ```
 
 Live LDAP tests use `MXGATEWAY_RUN_LIVE_LDAP_TESTS=1`. See `docs/GatewayTesting.md` for the full opt-in matrix and `LiveMxAccessFactAttribute` / `LiveLdapFactAttribute` for the gating logic.
 
 ## Clients
 
-Each language client is in `clients/<lang>/` with its own README. They all consume the shared `.proto` files in `src/ZB.MOM.WW.MxGateway.Contracts/Protos`:
+Each language client is in `clients/<lang>/` with its own README. They all consume the shared `.proto` files in `src/MxGateway.Contracts/Protos`:
 
-- `clients/dotnet`: `dotnet build clients/dotnet/ZB.MOM.WW.MxGateway.Client.slnx`
+- `clients/dotnet`: `dotnet build clients/dotnet/MxGateway.Client.sln`
 - `clients/python`: `python -m pip install -e ".[dev]"; python -m pytest`
 - `clients/rust`: `cargo test --workspace; cargo clippy --workspace --all-targets -- -D warnings`
 - `clients/java`: `gradle test` (Java 21)
@@ -77,7 +77,7 @@ powershell -ExecutionPolicy Bypass -File scripts/run-client-e2e-tests.ps1
 - **Gateway restart does not reattach orphan workers.** The first version terminates orphaned workers on startup; do not design code paths that assume reattachment.
 - **No Blazor UI component libraries.** Dashboard uses local Bootstrap CSS/JS only — do not introduce MudBlazor, Radzen, FluentUI, etc.
 - **Don't log secrets or full tag values by default.** API keys, passwords, `WriteSecured` payloads, and `AuthenticateUser` credentials must never reach logs. Value logging is opt-in and redacted.
-- **Generated code** under `src/ZB.MOM.WW.MxGateway.Contracts/Generated/`, `clients/*/generated*/`, `clients/python/src/mxgateway/generated/`, etc., is build output. Don't hand-edit. To regenerate, build the contracts project (`dotnet build src/ZB.MOM.WW.MxGateway.Contracts/ZB.MOM.WW.MxGateway.Contracts.csproj`) or run the per-client generation step in that client's README.
+- **Generated code** under `src/MxGateway.Contracts/Generated/`, `clients/*/generated*/`, `clients/python/src/mxgateway/generated/`, etc., is build output. Don't hand-edit. To regenerate, build the contracts project (`dotnet build src/MxGateway.Contracts/MxGateway.Contracts.csproj`) or run the per-client generation step in that client's README.
 - **Documentation style** (`StyleGuide.md`): PascalCase filenames, no marketing language, present tense, explain *why* not *what*.
 - **Update docs in the same change as the source.** When public APIs, contracts, configuration, build steps, security behavior, event shapes, value conversion, status mapping, or lifecycle rules change, the affected docs (`gateway.md`, `docs/`, client READMEs, design docs) must change in the same commit. Don't leave stale prose describing old behavior.
 
@@ -85,14 +85,12 @@ powershell -ExecutionPolicy Bypass -File scripts/run-client-e2e-tests.ps1
 
 When source code changes, build and test the affected component before reporting work done. If the change crosses component boundaries, build each affected component — don't rely on a single top-level build:
 
-**Run targeted tests per task, never the full suite each time.** When executing a plan task-by-task, run only the tests that exercise the code that task touched (`dotnet test --filter "FullyQualifiedName~<TestClass>"`, or the per-task test named in the plan). The full gateway suite is slow and leaves orphaned testhost processes — run it at most once per phase (after a related batch of tasks lands), not after every task.
-
 | Changed area | Required verification |
 |---|---|
 | Contracts or `.proto` files | regenerate generated code, then build gateway, worker, and every generated client touched by the contract |
-| Gateway server, sessions, workers, gRPC, dashboard, metrics | `dotnet build src/ZB.MOM.WW.MxGateway.Server` and run affected gateway / fake-worker tests |
-| Worker IPC, STA, MXAccess, conversion | `dotnet build src/ZB.MOM.WW.MxGateway.Worker -p:Platform=x86` and run worker tests |
-| .NET client | `dotnet build clients/dotnet/ZB.MOM.WW.MxGateway.Client.slnx` and run its tests |
+| Gateway server, sessions, workers, gRPC, dashboard, metrics | `dotnet build src/MxGateway.Server` and run affected gateway / fake-worker tests |
+| Worker IPC, STA, MXAccess, conversion | `dotnet build src/MxGateway.Worker -p:Platform=x86` and run worker tests |
+| .NET client | `dotnet build clients/dotnet/MxGateway.Client.sln` and run its tests |
 | Go client | `gofmt`, `go build ./...`, `go test ./...` from `clients/go` |
 | Rust client | `cargo fmt`, `cargo check --workspace`, `cargo test --workspace`, `cargo clippy --all-targets -- -D warnings` from `clients/rust` |
 | Python client | `python -m pytest` from `clients/python` |
@@ -102,7 +100,7 @@ When source code changes, build and test the affected component before reporting
 ## Design Sources To Consult Before Non-Trivial Changes
 
 - `gateway.md` — top-level architecture, command/event surface, IPC envelope, STA thread model, fault handling.
-- `glauth.md` — shared GLAuth LDAP server (`10.100.0.35:3893`, base DN `dc=zb,dc=local`, source of truth `scadaproj/infra/glauth/`) used for dev authn. Dashboard test users (`multi-role`/`password` = Administrator, `gw-viewer`/`password` = Viewer) and the role→capability mapping live there.
+- `glauth.md` — local LDAP server (GLAuth on `localhost:3893`, base DN `dc=lmxopcua,dc=local`) used for dev authn. Pre-provisioned users (`admin/admin123`, `readonly/readonly123`, etc.) and the role→capability mapping live there.
 - `docs/DesignDecisions.md` — v1 choices (MXAccess COM target `LMXProxyServerClass` from `C:\Program Files (x86)\ArchestrA\Framework\Bin\ArchestrA.MXAccess.dll`, API-key-in-SQLite auth, fail-fast event backpressure, etc.).
 - `docs/GatewayProcessDesign.md`, `docs/MxAccessWorkerInstanceDesign.md`, `docs/WorkerFrameProtocol.md`, `docs/WorkerProcessLauncher.md` — detailed component designs.
 - `docs/GatewayConfiguration.md` — full `MxGateway:*` options bound by `GatewayOptions` and validated at startup by `GatewayOptionsValidator`.
@@ -116,9 +114,9 @@ External analysis sources referenced by design docs:
 
 ## Authentication
 
-Gateway gRPC clients authenticate with an API key in metadata: `authorization: Bearer mxgw_<key-id>_<secret>`. Keys are stored hashed (with a peppered SHA) in a gateway-owned SQLite DB (default `C:\ProgramData\MxGateway\gateway-auth.db`). Scopes (`session`, `invoke`, `event`, `metadata`, `admin`) gate specific RPCs; missing → `Unauthenticated`, insufficient → `PermissionDenied`. The `apikey` subcommand on the server exe manages keys; see `src/ZB.MOM.WW.MxGateway.Server/Security/Authentication/`.
+Gateway gRPC clients authenticate with an API key in metadata: `authorization: Bearer mxgw_<key-id>_<secret>`. Keys are stored hashed (with a peppered SHA) in a gateway-owned SQLite DB (default `C:\ProgramData\MxGateway\gateway-auth.db`). Scopes (`session`, `invoke`, `event`, `metadata`, `admin`) gate specific RPCs; missing → `Unauthenticated`, insufficient → `PermissionDenied`. The `apikey` subcommand on the server exe manages keys; see `src/MxGateway.Server/Security/Authentication/`.
 
-Dashboard auth is LDAP-backed (separate from the gRPC API-key model). `/login` binds against `MxGateway:Ldap` and maps the user's LDAP groups to `Admin` or `Viewer` via `MxGateway:Dashboard:GroupToRole`, then issues an HTTP-only secure `__Host-MxGatewayDashboard` cookie. SignalR hubs at `/hubs/{snapshot,alarms,events}` accept either the cookie or a 30-minute bearer minted at `/hubs/token`. `Dashboard:AllowAnonymousLocalhost` bypasses auth on loopback when enabled. `Dashboard:DisableLogin` (default `false`) auto-authenticates every dashboard request — including remote browsers — as `Dashboard:AutoLoginUser` (default `multi-role`) with both Admin and Viewer roles; dev/test only, never enable in production.
+Dashboard auth uses the same verifier but exchanges the API key for an HTTP-only secure cookie at `/dashboard/login`. `Dashboard:AllowAnonymousLocalhost` bypasses cookie auth on loopback when explicitly enabled.
 
 ## Process / Platform Notes
 

REVIEW-PROCESS.md

@@ -3,15 +3,15 @@
 This document describes how to perform a comprehensive, per-module code review of
 the `mxaccessgw` codebase and how to track findings to resolution.
 
-A **module** is one buildable project under `src/` (e.g. `src/ZB.MOM.WW.MxGateway.Worker`)
+A **module** is one buildable project under `src/` (e.g. `src/MxGateway.Worker`)
 or one language client under `clients/` (e.g. `clients/rust`). Each module has
 its own folder under `code-reviews/` containing a single `findings.md`.
 
 ## 1. Before you start
 
 1. Pick the module to review. Its folder is `code-reviews/<Module>/`:
-   - For a `src/` project, `<Module>` is the project name with the `ZB.MOM.WW.MxGateway.`
-     prefix stripped — `src/ZB.MOM.WW.MxGateway.Server` is reviewed in `code-reviews/Server/`.
+   - For a `src/` project, `<Module>` is the project name with the `MxGateway.`
+     prefix stripped — `src/MxGateway.Server` is reviewed in `code-reviews/Server/`.
    - For a language client, `<Module>` is `Client.<Lang>` — `clients/rust` is
      reviewed in `code-reviews/Client.Rust/`.
 2. Identify the design context for the module:
@@ -65,8 +65,8 @@ means the checklist is completed even where it produces no findings — record
 8. **Code organization & conventions** — namespace hierarchy, project layout, the
    Options pattern, separation of concerns, additive-only contract evolution.
 9. **Testing coverage** — are the module's behaviours covered by tests
-   (`src/ZB.MOM.WW.MxGateway.Tests`, `src/ZB.MOM.WW.MxGateway.Worker.Tests`,
-   `src/ZB.MOM.WW.MxGateway.IntegrationTests`)? Note untested critical paths and missing
+   (`src/MxGateway.Tests`, `src/MxGateway.Worker.Tests`,
+   `src/MxGateway.IntegrationTests`)? Note untested critical paths and missing
    edge-case tests.
 10. **Documentation & comments** — XML doc accuracy, misleading or stale comments,
     undocumented non-obvious behaviour.

clients/dotnet/Directory.Build.props

@@ -1,38 +0,0 @@
-<Project>
-  <PropertyGroup>
-    <!-- Build-quality enforcement floor, mirroring src/Directory.Build.props so the
-         .NET client tree is held to the same baseline CLAUDE.md mandates (warnings as
-         errors, code-style enforced at build, latest analyzers, deterministic builds). -->
-    <LangVersion>latest</LangVersion>
-    <Nullable>enable</Nullable>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-    <AnalysisLevel>latest</AnalysisLevel>
-    <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
-    <Deterministic>true</Deterministic>
-  </PropertyGroup>
-
-  <PropertyGroup>
-    <!-- Shared package metadata for clients/dotnet/. Individual projects opt in via <IsPackable>true</IsPackable>. -->
-    <Authors>Joseph Doherty</Authors>
-    <Company>ZB MOM WW</Company>
-    <Copyright>Copyright (c) ZB MOM WW. All rights reserved.</Copyright>
-    <Product>MxAccessGateway Client</Product>
-    <RepositoryUrl>https://gitea.dohertylan.com/dohertj2/mxaccessgw</RepositoryUrl>
-    <RepositoryType>git</RepositoryType>
-    <PackageProjectUrl>https://gitea.dohertylan.com/dohertj2/mxaccessgw</PackageProjectUrl>
-    <PackageTags>mxaccess;mxgateway;grpc;client;archestra</PackageTags>
-    <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
-    <!-- Proprietary/internal package, consistent with the Rust ("Proprietary") and
-         Python ("Proprietary") client license declarations. A LicenseRef SPDX expression
-         is rejected by the current NuGet toolset (NU5124), so the proprietary terms ship
-         as a packaged license file instead. -->
-    <PackageLicenseFile>LICENSE.txt</PackageLicenseFile>
-    <!-- Versioning: bump per release. Symbols ship as snupkg. -->
-    <Version>0.1.1</Version>
-    <IncludeSymbols>true</IncludeSymbols>
-    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
-    <!-- Default: do NOT pack. Each project opts in. -->
-    <IsPackable>false</IsPackable>
-  </PropertyGroup>
-</Project>

clients/dotnet/DotnetClientDesign.md

@@ -16,9 +16,9 @@ Recommended layout:
 
 ```text
 clients/dotnet/
-  ZB.MOM.WW.MxGateway.Client.slnx
-  ZB.MOM.WW.MxGateway.Client/
-    ZB.MOM.WW.MxGateway.Client.csproj
+  MxGateway.Client.sln
+  MxGateway.Client/
+    MxGateway.Client.csproj
     GatewayClient.cs
     MxGatewaySession.cs
     MxGatewayClientOptions.cs
@@ -26,14 +26,14 @@ clients/dotnet/
     Conversion/
     Errors/
     Generated/
-  ZB.MOM.WW.MxGateway.Client.Cli/
-    ZB.MOM.WW.MxGateway.Client.Cli.csproj
+  MxGateway.Client.Cli/
+    MxGateway.Client.Cli.csproj
     Program.cs
     Commands/
-  ZB.MOM.WW.MxGateway.Client.Tests/
-    ZB.MOM.WW.MxGateway.Client.Tests.csproj
-  ZB.MOM.WW.MxGateway.Client.IntegrationTests/
-    ZB.MOM.WW.MxGateway.Client.IntegrationTests.csproj
+  MxGateway.Client.Tests/
+    MxGateway.Client.Tests.csproj
+  MxGateway.Client.IntegrationTests/
+    MxGateway.Client.IntegrationTests.csproj
 ```
 
 Target framework:
@@ -43,7 +43,7 @@ Target framework:
 ```
 
 The scaffold uses a project reference to
-`src/ZB.MOM.WW.MxGateway.Contracts/ZB.MOM.WW.MxGateway.Contracts.csproj` for generated protobuf and
+`src/MxGateway.Contracts/MxGateway.Contracts.csproj` for generated protobuf and
 gRPC types. `clients/dotnet/generated` remains reserved for client-local
 generator output if the .NET client later needs to decouple from the contracts
 project.
@@ -107,7 +107,6 @@ public sealed class MxGatewayClientOptions
     public required string ApiKey { get; init; }
     public bool UseTls { get; init; }
     public string? CaCertificatePath { get; init; }
-    public bool RequireCertificateValidation { get; init; }
     public string? ServerNameOverride { get; init; }
     public TimeSpan ConnectTimeout { get; init; } = TimeSpan.FromSeconds(10);
     public TimeSpan DefaultCallTimeout { get; init; } = TimeSpan.FromSeconds(30);
@@ -125,24 +124,6 @@ or subscription changes because those calls can partially succeed in MXAccess.
 API key may be loaded from `MXGATEWAY_API_KEY` by the CLI, not implicitly by the
 library constructor unless a helper explicitly says it does that.
 
-### TLS trust posture
-
-The gateway can serve a self-signed certificate it generates itself (it has no
-PKI). To make that usable, TLS is **lenient by default**: when `UseTls` is set
-and `CaCertificatePath` is empty, `CreateHttpHandler` installs a
-`RemoteCertificateValidationCallback` that returns `true`, so the gateway's
-self-signed certificate is accepted without verification.
-
-To verify the gateway instead:
-
-- set `CaCertificatePath` to pin a CA — validated via a `CustomRootTrust`
-  `X509Chain` against that root, and the callback additionally rejects a
-  hostname/SAN mismatch (`RemoteCertificateNameMismatch`); or
-- set `RequireCertificateValidation` to `true` to keep the default OS/system-trust
-  verification on a connection with no pinned CA.
-
-Pinning a CA always wins over the lenient default.
-
 ## Auth Interceptor
 
 Use a gRPC call credentials/interceptor layer to attach:
@@ -185,7 +166,7 @@ reply.EnsureMxAccessSuccess();
 
 ## Test CLI
 
-Project: `ZB.MOM.WW.MxGateway.Client.Cli`.
+Project: `MxGateway.Client.Cli`.
 
 Command examples:
 

clients/dotnet/LICENSE.txt

@@ -1,12 +0,0 @@
-Proprietary License
-
-Copyright (c) ZB MOM WW. All rights reserved.
-
-This software and its source code are proprietary and confidential. They are
-licensed, not sold, for internal use within ZB MOM WW and its authorized
-partners only. No part of this package may be reproduced, distributed, or
-transmitted to third parties without the prior written permission of ZB MOM WW.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.

clients/dotnet/MxGateway.Client.Cli/CliArguments.cs

@@ -1,6 +1,6 @@
 using System.Globalization;
 
-namespace ZB.MOM.WW.MxGateway.Client.Cli;
+namespace MxGateway.Client.Cli;
 
 /// <summary>Parses command-line arguments into flags and named values.</summary>
 internal sealed class CliArguments

clients/dotnet/MxGateway.Client.Cli/IMxGatewayCliClient.cs

@@ -1,7 +1,7 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto.Galaxy;
 
-namespace ZB.MOM.WW.MxGateway.Client.Cli;
+namespace MxGateway.Client.Cli;
 
 public interface IMxGatewayCliClient : IAsyncDisposable
 {
@@ -45,27 +45,6 @@ public interface IMxGatewayCliClient : IAsyncDisposable
         StreamEventsRequest request,
         CancellationToken cancellationToken);
 
-    /// <summary>
-    /// Acknowledges an active MXAccess alarm condition through the gateway.
-    /// </summary>
-    /// <param name="request">The acknowledge request — alarm reference, comment, operator user.</param>
-    /// <param name="cancellationToken">Cancellation token for the operation.</param>
-    /// <returns>The acknowledge reply with protocol + native MxStatus.</returns>
-    Task<AcknowledgeAlarmReply> AcknowledgeAlarmAsync(
-        AcknowledgeAlarmRequest request,
-        CancellationToken cancellationToken);
-
-    /// <summary>
-    /// Attaches to the gateway's central alarm feed — the current active-alarm
-    /// snapshot followed by live transitions.
-    /// </summary>
-    /// <param name="request">The stream request, optionally scoped by alarm-reference prefix.</param>
-    /// <param name="cancellationToken">Cancellation token for the operation.</param>
-    /// <returns>An async enumerable of alarm feed messages.</returns>
-    IAsyncEnumerable<AlarmFeedMessage> StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CancellationToken cancellationToken);
-
     /// <summary>
     /// Tests connection to the Galaxy Repository.
     /// </summary>
@@ -105,16 +84,4 @@ public interface IMxGatewayCliClient : IAsyncDisposable
     IAsyncEnumerable<DeployEvent> GalaxyWatchDeployEventsAsync(
         WatchDeployEventsRequest request,
         CancellationToken cancellationToken);
-
-    /// <summary>
-    /// Fetches one page of direct children of a Galaxy parent (or the root
-    /// objects when the parent selector is unset), the primitive that backs the
-    /// lazy-browse helper.
-    /// </summary>
-    /// <param name="request">The browse-children request.</param>
-    /// <param name="cancellationToken">Cancellation token for the operation.</param>
-    /// <returns>The browse-children reply.</returns>
-    Task<BrowseChildrenReply> GalaxyBrowseChildrenAsync(
-        BrowseChildrenRequest request,
-        CancellationToken cancellationToken);
 }

clients/dotnet/MxGateway.Client.Cli/MxGateway.Client.Cli.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <ItemGroup>
-    <ProjectReference Include="..\ZB.MOM.WW.MxGateway.Client\ZB.MOM.WW.MxGateway.Client.csproj" />
+    <ProjectReference Include="..\MxGateway.Client\MxGateway.Client.csproj" />
   </ItemGroup>
 
   <PropertyGroup>

clients/dotnet/MxGateway.Client.Cli/MxGatewayCliClientAdapter.cs

@@ -1,8 +1,8 @@
-using ZB.MOM.WW.MxGateway.Client;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Client;
+using MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto.Galaxy;
 
-namespace ZB.MOM.WW.MxGateway.Client.Cli;
+namespace MxGateway.Client.Cli;
 
 internal sealed class MxGatewayCliClientAdapter : IMxGatewayCliClient
 {
@@ -52,22 +52,6 @@ internal sealed class MxGatewayCliClientAdapter : IMxGatewayCliClient
         return _client.StreamEventsAsync(request, cancellationToken);
     }
 
-    /// <inheritdoc />
-    public Task<AcknowledgeAlarmReply> AcknowledgeAlarmAsync(
-        AcknowledgeAlarmRequest request,
-        CancellationToken cancellationToken)
-    {
-        return _client.AcknowledgeAlarmAsync(request, cancellationToken);
-    }
-
-    /// <inheritdoc />
-    public IAsyncEnumerable<AlarmFeedMessage> StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CancellationToken cancellationToken)
-    {
-        return _client.StreamAlarmsAsync(request, cancellationToken);
-    }
-
     /// <inheritdoc />
     public Task<TestConnectionReply> GalaxyTestConnectionAsync(
         TestConnectionRequest request,
@@ -100,14 +84,6 @@ internal sealed class MxGatewayCliClientAdapter : IMxGatewayCliClient
         return _galaxyClient.Value.WatchDeployEventsRawAsync(request, cancellationToken);
     }
 
-    /// <inheritdoc />
-    public Task<BrowseChildrenReply> GalaxyBrowseChildrenAsync(
-        BrowseChildrenRequest request,
-        CancellationToken cancellationToken)
-    {
-        return _galaxyClient.Value.BrowseChildrenRawAsync(request, cancellationToken);
-    }
-
     /// <inheritdoc />
     public async ValueTask DisposeAsync()
     {

clients/dotnet/MxGateway.Client.Cli/MxGatewayCliSecretRedactor.cs

@@ -1,4 +1,4 @@
-namespace ZB.MOM.WW.MxGateway.Client.Cli;
+namespace MxGateway.Client.Cli;
 
 /// <summary>Utility to redact API keys from error messages for safe output.</summary>
 internal static class MxGatewayCliSecretRedactor

clients/dotnet/MxGateway.Client.Cli/Program.cs

@@ -1,3 +1,3 @@
-using ZB.MOM.WW.MxGateway.Client.Cli;
+using MxGateway.Client.Cli;
 
 return await MxGatewayClientCli.RunAsync(args, Console.Out, Console.Error);

clients/dotnet/MxGateway.Client.Tests/FakeGalaxyRepositoryTransport.cs

@@ -1,7 +1,7 @@
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Contracts.Proto.Galaxy;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 /// <summary>
 /// Fake Galaxy Repository client transport for testing.
@@ -48,7 +48,6 @@ internal sealed class FakeGalaxyRepositoryTransport(MxGatewayClientOptions optio
     /// </summary>
     public DiscoverHierarchyReply DiscoverHierarchyReply { get; set; } = new();
 
-    /// <summary>Gets the queue of discover hierarchy replies; dequeued in FIFO order.</summary>
     public Queue<DiscoverHierarchyReply> DiscoverHierarchyReplies { get; } = new();
 
     /// <summary>
@@ -123,49 +122,6 @@ internal sealed class FakeGalaxyRepositoryTransport(MxGatewayClientOptions optio
                 : DiscoverHierarchyReply);
     }
 
-    /// <summary>Records BrowseChildren RPC calls made by the client.</summary>
-    public List<(BrowseChildrenRequest Request, CallOptions CallOptions)> BrowseChildrenCalls { get; } = [];
-
-    /// <summary>Default reply returned from BrowseChildren when the queue is empty.</summary>
-    public BrowseChildrenReply BrowseChildrenReply { get; set; } = new();
-
-    /// <summary>Queue of replies returned from BrowseChildren; dequeued in FIFO order.</summary>
-    public Queue<BrowseChildrenReply> BrowseChildrenReplies { get; } = new();
-
-    /// <summary>Queue of exceptions to throw from BrowseChildren; dequeued in FIFO order.</summary>
-    public Queue<Exception> BrowseChildrenExceptions { get; } = new();
-
-    /// <summary>
-    /// Optional hook awaited inside BrowseChildren before the reply is produced. Lets a
-    /// test hold an RPC mid-flight to exercise concurrent reads of the in-progress node.
-    /// </summary>
-    public Func<Task>? BrowseChildrenGate { get; set; }
-
-    /// <summary>
-    /// Records the request and either throws a queued exception or returns the configured reply.
-    /// </summary>
-    /// <param name="request">The BrowseChildrenRequest to process.</param>
-    /// <param name="callOptions">Call options specifying RPC behavior.</param>
-    public async Task<BrowseChildrenReply> BrowseChildrenAsync(
-        BrowseChildrenRequest request,
-        CallOptions callOptions)
-    {
-        BrowseChildrenCalls.Add((request, callOptions));
-        if (BrowseChildrenExceptions.TryDequeue(out Exception? exception))
-        {
-            throw exception;
-        }
-
-        if (BrowseChildrenGate is { } gate)
-        {
-            await gate().ConfigureAwait(false);
-        }
-
-        return BrowseChildrenReplies.TryDequeue(out BrowseChildrenReply? reply)
-            ? reply
-            : BrowseChildrenReply;
-    }
-
     /// <summary>
     /// Gets the list of WatchDeployEvents RPC calls made by the client.
     /// </summary>

clients/dotnet/MxGateway.Client.Tests/FakeGatewayTransport.cs

@@ -1,7 +1,7 @@
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 /// <summary>
 /// Fake implementation of IMxGatewayClientTransport for testing.
@@ -51,11 +51,6 @@ internal sealed class FakeGatewayTransport(MxGatewayClientOptions options) : IMx
     /// </summary>
     public List<(QueryActiveAlarmsRequest Request, CallOptions CallOptions)> QueryActiveAlarmsCalls { get; } = [];
 
-    /// <summary>
-    /// Gets the list of captured StreamAlarmsAsync calls.
-    /// </summary>
-    public List<(StreamAlarmsRequest Request, CallOptions CallOptions)> StreamAlarmsCalls { get; } = [];
-
     /// <summary>
     /// Gets the queue of exceptions to throw from AcknowledgeAlarmAsync.
     /// </summary>
@@ -63,7 +58,6 @@ internal sealed class FakeGatewayTransport(MxGatewayClientOptions options) : IMx
 
     private readonly Queue<AcknowledgeAlarmReply> _acknowledgeReplies = new();
     private readonly List<ActiveAlarmSnapshot> _activeAlarmSnapshots = [];
-    private readonly List<AlarmFeedMessage> _alarmFeedMessages = [];
 
     /// <summary>
     /// Gets or sets the reply to return from OpenSessionAsync.
@@ -196,8 +190,6 @@ internal sealed class FakeGatewayTransport(MxGatewayClientOptions options) : IMx
     /// <summary>
     /// Records the acknowledge call and returns the next enqueued reply (or default).
     /// </summary>
-    /// <param name="request">The acknowledge alarm request.</param>
-    /// <param name="callOptions">Call options specifying RPC behavior.</param>
     public Task<AcknowledgeAlarmReply> AcknowledgeAlarmAsync(
         AcknowledgeAlarmRequest request,
         CallOptions callOptions)
@@ -212,6 +204,7 @@ internal sealed class FakeGatewayTransport(MxGatewayClientOptions options) : IMx
             ? _acknowledgeReplies.Dequeue()
             : new AcknowledgeAlarmReply
             {
+                SessionId = request.SessionId,
                 CorrelationId = request.ClientCorrelationId,
                 ProtocolStatus = new ProtocolStatus { Code = ProtocolStatusCode.Ok },
                 Status = new MxStatusProxy { Success = 1, Category = MxStatusCategory.Ok },
@@ -221,8 +214,6 @@ internal sealed class FakeGatewayTransport(MxGatewayClientOptions options) : IMx
     /// <summary>
     /// Records the query call and yields each enqueued snapshot.
     /// </summary>
-    /// <param name="request">The query active alarms request.</param>
-    /// <param name="callOptions">Call options specifying RPC behavior.</param>
     public async IAsyncEnumerable<ActiveAlarmSnapshot> QueryActiveAlarmsAsync(
         QueryActiveAlarmsRequest request,
         CallOptions callOptions)
@@ -238,42 +229,14 @@ internal sealed class FakeGatewayTransport(MxGatewayClientOptions options) : IMx
     }
 
     /// <summary>Enqueues an acknowledge reply.</summary>
-    /// <param name="reply">The acknowledge reply to enqueue.</param>
     public void AddAcknowledgeReply(AcknowledgeAlarmReply reply)
     {
         _acknowledgeReplies.Enqueue(reply);
     }
 
     /// <summary>Enqueues a snapshot to be yielded from QueryActiveAlarmsAsync.</summary>
-    /// <param name="snapshot">The snapshot to enqueue.</param>
     public void AddActiveAlarmSnapshot(ActiveAlarmSnapshot snapshot)
     {
         _activeAlarmSnapshots.Add(snapshot);
     }
-
-    /// <summary>
-    /// Records the stream-alarms call and yields each enqueued feed message.
-    /// </summary>
-    /// <param name="request">The stream alarms request.</param>
-    /// <param name="callOptions">Call options specifying RPC behavior.</param>
-    public async IAsyncEnumerable<AlarmFeedMessage> StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CallOptions callOptions)
-    {
-        StreamAlarmsCalls.Add((request, callOptions));
-
-        foreach (AlarmFeedMessage message in _alarmFeedMessages)
-        {
-            callOptions.CancellationToken.ThrowIfCancellationRequested();
-            await Task.Yield();
-            yield return message;
-        }
-    }
-
-    /// <summary>Enqueues an alarm feed message to be yielded from StreamAlarmsAsync.</summary>
-    /// <param name="message">The alarm feed message to enqueue.</param>
-    public void AddAlarmFeedMessage(AlarmFeedMessage message)
-    {
-        _alarmFeedMessages.Add(message);
-    }
 }

clients/dotnet/MxGateway.Client.Tests/GalaxyRepositoryClientTests.cs

@@ -1,8 +1,8 @@
 using Google.Protobuf.WellKnownTypes;
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Contracts.Proto.Galaxy;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class GalaxyRepositoryClientTests
 {
@@ -181,9 +181,6 @@ public sealed class GalaxyRepositoryClientTests
         Assert.Contains("repeated page token", exception.Message, StringComparison.Ordinal);
     }
 
-    /// <summary>
-    /// Verifies that DiscoverHierarchyAsync maps typed filter options correctly to the request.
-    /// </summary>
     [Fact]
     public async Task DiscoverHierarchyAsync_WithOptions_MapsTypedFilters()
     {
@@ -215,9 +212,6 @@ public sealed class GalaxyRepositoryClientTests
         Assert.True(request.HistorizedOnly);
     }
 
-    /// <summary>
-    /// Verifies that TestConnectionAsync retries on transient gRPC failures.
-    /// </summary>
     [Fact]
     public async Task TestConnectionAsync_RetriesOnTransientGrpcFailure()
     {

clients/dotnet/MxGateway.Client.Tests/MxCommandReplyExtensionsTests.cs

@@ -1,8 +1,8 @@
 using Google.Protobuf;
-using ZB.MOM.WW.MxGateway.Client;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Client;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class MxCommandReplyExtensionsTests
 {

clients/dotnet/MxGateway.Client.Tests/MxGateway.Client.Tests.csproj

@@ -19,8 +19,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\ZB.MOM.WW.MxGateway.Client\ZB.MOM.WW.MxGateway.Client.csproj" />
-    <ProjectReference Include="..\ZB.MOM.WW.MxGateway.Client.Cli\ZB.MOM.WW.MxGateway.Client.Cli.csproj" />
+    <ProjectReference Include="..\MxGateway.Client\MxGateway.Client.csproj" />
+    <ProjectReference Include="..\MxGateway.Client.Cli\MxGateway.Client.Cli.csproj" />
   </ItemGroup>
 
 </Project>

clients/dotnet/MxGateway.Client.Tests/MxGatewayClientAlarmsTests.cs

@@ -1,8 +1,8 @@
 using Google.Protobuf.WellKnownTypes;
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 /// <summary>
 ///     PR E.2 — pins the .NET SDK surface for the new alarm RPCs:
@@ -11,13 +11,13 @@ namespace ZB.MOM.WW.MxGateway.Client.Tests;
 /// </summary>
 public sealed class MxGatewayClientAlarmsTests
 {
-    /// <summary>AcknowledgeAlarmAsync records request and returns reply.</summary>
     [Fact]
     public async Task AcknowledgeAlarmAsync_RecordsRequestShapeAndReturnsReply()
     {
         FakeGatewayTransport transport = CreateTransport();
         transport.AddAcknowledgeReply(new AcknowledgeAlarmReply
         {
+            SessionId = "session-fixture",
             CorrelationId = "corr-1",
             ProtocolStatus = new ProtocolStatus { Code = ProtocolStatusCode.Ok },
             Status = new MxStatusProxy
@@ -31,6 +31,7 @@ public sealed class MxGatewayClientAlarmsTests
 
         AcknowledgeAlarmReply reply = await client.AcknowledgeAlarmAsync(new AcknowledgeAlarmRequest
         {
+            SessionId = "session-fixture",
             ClientCorrelationId = "corr-1",
             AlarmFullReference = "Tank01.Level.HiHi",
             Comment = "investigating",
@@ -47,7 +48,6 @@ public sealed class MxGatewayClientAlarmsTests
         Assert.Equal("Bearer test-api-key", call.CallOptions.Headers?.GetValue("authorization"));
     }
 
-    /// <summary>AcknowledgeAlarmAsync honors cancellation.</summary>
     [Fact]
     public async Task AcknowledgeAlarmAsync_HonorsCancellation()
     {
@@ -64,6 +64,7 @@ public sealed class MxGatewayClientAlarmsTests
             client.AcknowledgeAlarmAsync(
                 new AcknowledgeAlarmRequest
                 {
+                    SessionId = "session-fixture",
                     AlarmFullReference = "Tank01.Level.HiHi",
                     Comment = string.Empty,
                     OperatorUser = "alice",
@@ -71,7 +72,6 @@ public sealed class MxGatewayClientAlarmsTests
                 cancellation.Token));
     }
 
-    /// <summary>AcknowledgeAlarmAsync maps unauthenticated RPC exception to typed exception.</summary>
     [Fact]
     public async Task AcknowledgeAlarmAsync_MapsUnauthenticated_RpcException_ToTypedException()
     {
@@ -89,6 +89,7 @@ public sealed class MxGatewayClientAlarmsTests
         var ex = await Assert.ThrowsAsync<RpcException>(
             () => client.AcknowledgeAlarmAsync(new AcknowledgeAlarmRequest
             {
+                SessionId = "session-fixture",
                 AlarmFullReference = "Tank01.Level.HiHi",
                 Comment = string.Empty,
                 OperatorUser = "alice",
@@ -96,7 +97,6 @@ public sealed class MxGatewayClientAlarmsTests
         Assert.Equal(StatusCode.Unauthenticated, ex.StatusCode);
     }
 
-    /// <summary>QueryActiveAlarmsAsync streams enqueued snapshots.</summary>
     [Fact]
     public async Task QueryActiveAlarmsAsync_StreamsEnqueuedSnapshots()
     {
@@ -121,7 +121,6 @@ public sealed class MxGatewayClientAlarmsTests
         Assert.Single(transport.QueryActiveAlarmsCalls);
     }
 
-    /// <summary>QueryActiveAlarmsAsync passes filter prefix.</summary>
     [Fact]
     public async Task QueryActiveAlarmsAsync_PassesFilterPrefix()
     {
@@ -141,7 +140,6 @@ public sealed class MxGatewayClientAlarmsTests
         Assert.Equal("Tank01.", call.Request.AlarmFilterPrefix);
     }
 
-    /// <summary>QueryActiveAlarmsAsync honors cancellation during enumeration.</summary>
     [Fact]
     public async Task QueryActiveAlarmsAsync_HonorsCancellationDuringEnumeration()
     {

clients/dotnet/MxGateway.Client.Tests/MxGatewayClientCliTests.cs

@@ -0,0 +1,520 @@
+using Google.Protobuf.WellKnownTypes;
+using MxGateway.Client.Cli;
+using MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto.Galaxy;
+
+namespace MxGateway.Client.Tests;
+
+/// <summary>Tests for the CLI command interface.</summary>
+public sealed class MxGatewayClientCliTests
+{
+    /// <summary>Verifies that the version command prints compiled protocol versions.</summary>
+    [Fact]
+    public void Run_Version_PrintsCompiledProtocolVersions()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+
+        var exitCode = MxGatewayClientCli.Run(["version"], output, error);
+
+        Assert.Equal(0, exitCode);
+        Assert.Contains("gateway-protocol=3", output.ToString());
+        Assert.Contains("worker-protocol=1", output.ToString());
+        Assert.Equal(string.Empty, error.ToString());
+    }
+
+    /// <summary>Verifies that the version command with --json flag prints JSON protocol versions.</summary>
+    [Fact]
+    public async Task RunAsync_VersionJson_PrintsJsonProtocolVersions()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+
+        int exitCode = await MxGatewayClientCli.RunAsync(["version", "--json"], output, error);
+
+        Assert.Equal(0, exitCode);
+        Assert.Contains("\"gatewayProtocolVersion\":3", output.ToString());
+        Assert.Equal(string.Empty, error.ToString());
+    }
+
+    /// <summary>Verifies that the write command builds a write request and prints JSON reply.</summary>
+    [Fact]
+    public async Task RunAsync_Write_BuildsWriteCommandAndPrintsJsonReply()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new();
+        fakeClient.InvokeReplies.Enqueue(new MxCommandReply
+        {
+            SessionId = "session-fixture",
+            Kind = MxCommandKind.Write,
+            ProtocolStatus = new ProtocolStatus { Code = ProtocolStatusCode.Ok },
+        });
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "write",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+                "--session-id",
+                "session-fixture",
+                "--server-handle",
+                "12",
+                "--item-handle",
+                "34",
+                "--type",
+                "int32",
+                "--value",
+                "123",
+                "--json",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(0, exitCode);
+        MxCommandRequest request = Assert.Single(fakeClient.InvokeRequests);
+        Assert.Equal(MxCommandKind.Write, request.Command.Kind);
+        Assert.Equal(123, request.Command.Write.Value.Int32Value);
+        Assert.Contains("MX_COMMAND_KIND_WRITE", output.ToString());
+        Assert.Equal(string.Empty, error.ToString());
+    }
+
+    /// <summary>Verifies that error output redacts sensitive API key values.</summary>
+    [Fact]
+    public async Task RunAsync_ErrorOutput_RedactsApiKey()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "open-session",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "secret-api-key",
+            ],
+            output,
+            error,
+            _ => throw new InvalidOperationException("boom secret-api-key"));
+
+        Assert.Equal(1, exitCode);
+        Assert.DoesNotContain("secret-api-key", error.ToString());
+        Assert.Contains("[redacted]", error.ToString());
+    }
+
+    /// <summary>Verifies that stream-events with max-events limit stops output in non-JSON format.</summary>
+    [Fact]
+    public async Task RunAsync_StreamEvents_WithMaxEventsStopsNonJsonOutput()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new();
+        fakeClient.Events.Add(new MxEvent
+        {
+            SessionId = "session-fixture",
+            Family = MxEventFamily.OnDataChange,
+            WorkerSequence = 1,
+        });
+        fakeClient.Events.Add(new MxEvent
+        {
+            SessionId = "session-fixture",
+            Family = MxEventFamily.OnWriteComplete,
+            WorkerSequence = 2,
+        });
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "stream-events",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+                "--session-id",
+                "session-fixture",
+                "--max-events",
+                "1",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(0, exitCode);
+        Assert.Contains("workerSequence", output.ToString());
+        Assert.DoesNotContain("ON_WRITE_COMPLETE", output.ToString());
+    }
+
+
+    /// <summary>Verifies that smoke command closes opened session when a command fails.</summary>
+    [Fact]
+    public async Task RunAsync_Smoke_WhenCommandFails_ClosesOpenedSession()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new()
+        {
+            InvokeFailure = new InvalidOperationException("register failed"),
+        };
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "smoke",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+                "--item",
+                "Area001.Pump001.Speed",
+                "--json",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(1, exitCode);
+        CloseSessionRequest closeRequest = Assert.Single(fakeClient.CloseSessionRequests);
+        Assert.Equal("session-fixture", closeRequest.SessionId);
+    }
+
+    /// <summary>Verifies that galaxy-test-connection command prints JSON reply.</summary>
+    [Fact]
+    public async Task RunAsync_GalaxyTestConnection_PrintsJsonReply()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new()
+        {
+            GalaxyTestConnectionReply = new TestConnectionReply { Ok = true },
+        };
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "galaxy-test-connection",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+                "--json",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(0, exitCode);
+        Assert.Single(fakeClient.GalaxyTestConnectionRequests);
+        Assert.Contains("\"ok\": true", output.ToString());
+        Assert.Equal(string.Empty, error.ToString());
+    }
+
+    /// <summary>Verifies that galaxy-discover command prints hierarchy summary.</summary>
+    [Fact]
+    public async Task RunAsync_GalaxyDiscover_PrintsHierarchySummary()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new();
+        fakeClient.GalaxyDiscoverHierarchyReplies.Enqueue(new DiscoverHierarchyReply
+        {
+            NextPageToken = "7:1",
+            TotalObjectCount = 2,
+            Objects =
+            {
+                new GalaxyObject
+                {
+                    GobjectId = 7,
+                    TagName = "DelmiaReceiver_001",
+                    ContainedName = "DelmiaReceiver",
+                    ParentGobjectId = 1,
+                    Attributes =
+                    {
+                        new GalaxyAttribute
+                        {
+                            AttributeName = "DownloadPath",
+                            FullTagReference = "DelmiaReceiver_001.DownloadPath",
+                        },
+                    },
+                },
+            },
+        });
+        fakeClient.GalaxyDiscoverHierarchyReplies.Enqueue(new DiscoverHierarchyReply
+        {
+            TotalObjectCount = 2,
+            Objects =
+            {
+                new GalaxyObject
+                {
+                    GobjectId = 8,
+                    TagName = "DelmiaReceiver_002",
+                    ContainedName = "DelmiaReceiver",
+                    ParentGobjectId = 1,
+                },
+            },
+        });
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "galaxy-discover",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(0, exitCode);
+        Assert.Equal(2, fakeClient.GalaxyDiscoverHierarchyRequests.Count);
+        Assert.Equal(5000, fakeClient.GalaxyDiscoverHierarchyRequests[0].PageSize);
+        Assert.Equal("", fakeClient.GalaxyDiscoverHierarchyRequests[0].PageToken);
+        Assert.Equal("7:1", fakeClient.GalaxyDiscoverHierarchyRequests[1].PageToken);
+        string text = output.ToString();
+        Assert.Contains("objects=2", text);
+        Assert.Contains("DelmiaReceiver_001", text);
+        Assert.Contains("DelmiaReceiver_002", text);
+        Assert.Contains("attributes=1", text);
+        Assert.Equal(string.Empty, error.ToString());
+    }
+
+    /// <summary>Verifies that galaxy-watch command prints text output for deploy events.</summary>
+    [Fact]
+    public async Task RunAsync_GalaxyWatch_PrintsTextOutputForEvents()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new();
+        DateTime deploy = new(2026, 4, 28, 14, 30, 0, DateTimeKind.Utc);
+        fakeClient.GalaxyDeployEvents.Add(new DeployEvent
+        {
+            Sequence = 1,
+            ObservedAt = Timestamp.FromDateTime(deploy),
+            TimeOfLastDeploy = Timestamp.FromDateTime(deploy),
+            TimeOfLastDeployPresent = true,
+            ObjectCount = 5,
+            AttributeCount = 17,
+        });
+        fakeClient.GalaxyDeployEvents.Add(new DeployEvent
+        {
+            Sequence = 2,
+            ObservedAt = Timestamp.FromDateTime(deploy.AddSeconds(30)),
+            TimeOfLastDeploy = Timestamp.FromDateTime(deploy.AddSeconds(30)),
+            TimeOfLastDeployPresent = true,
+            ObjectCount = 6,
+            AttributeCount = 18,
+        });
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "galaxy-watch",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+                "--last-seen-deploy-time",
+                "2026-04-28T14:00:00Z",
+                "--max-events",
+                "2",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(0, exitCode);
+        WatchDeployEventsRequest request = Assert.Single(fakeClient.GalaxyWatchDeployEventsRequests);
+        Assert.NotNull(request.LastSeenDeployTime);
+        string text = output.ToString();
+        Assert.Contains("sequence=1", text);
+        Assert.Contains("sequence=2", text);
+        Assert.Contains("objects=5", text);
+        Assert.Contains("attributes=18", text);
+        Assert.Equal(string.Empty, error.ToString());
+    }
+
+    /// <summary>Verifies that galaxy-watch with --json emits one JSON object per event.</summary>
+    [Fact]
+    public async Task RunAsync_GalaxyWatch_JsonEmitsOneObjectPerEvent()
+    {
+        using var output = new StringWriter();
+        using var error = new StringWriter();
+        FakeCliClient fakeClient = new();
+        fakeClient.GalaxyDeployEvents.Add(new DeployEvent
+        {
+            Sequence = 42,
+            ObjectCount = 99,
+            AttributeCount = 1024,
+        });
+
+        int exitCode = await MxGatewayClientCli.RunAsync(
+            [
+                "galaxy-watch",
+                "--endpoint",
+                "http://localhost:5000",
+                "--api-key",
+                "test-api-key",
+                "--max-events",
+                "1",
+                "--json",
+            ],
+            output,
+            error,
+            _ => fakeClient);
+
+        Assert.Equal(0, exitCode);
+        string text = output.ToString();
+        Assert.Contains("\"sequence\": \"42\"", text);
+        Assert.Contains("\"objectCount\": 99", text);
+    }
+
+    /// <summary>Fake CLI client for testing.</summary>
+    private sealed class FakeCliClient : IMxGatewayCliClient
+    {
+        /// <summary>Queue of invoke replies to return.</summary>
+        public Queue<MxCommandReply> InvokeReplies { get; } = new();
+
+        /// <summary>List of received invoke requests.</summary>
+        public List<MxCommandRequest> InvokeRequests { get; } = [];
+
+        /// <summary>List of received close session requests.</summary>
+        public List<CloseSessionRequest> CloseSessionRequests { get; } = [];
+
+        /// <summary>List of events to yield when streaming.</summary>
+        public List<MxEvent> Events { get; } = [];
+
+        /// <summary>Exception to throw on invoke, if any.</summary>
+        public Exception? InvokeFailure { get; init; }
+
+        /// <inheritdoc />
+        public ValueTask DisposeAsync()
+        {
+            return ValueTask.CompletedTask;
+        }
+
+        /// <inheritdoc />
+        public Task<OpenSessionReply> OpenSessionAsync(
+            OpenSessionRequest request,
+            CancellationToken cancellationToken)
+        {
+            return Task.FromResult(new OpenSessionReply
+            {
+                SessionId = "session-fixture",
+                ProtocolStatus = new ProtocolStatus { Code = ProtocolStatusCode.Ok },
+                GatewayProtocolVersion = 1,
+                WorkerProtocolVersion = 1,
+            });
+        }
+
+        /// <inheritdoc />
+        public Task<CloseSessionReply> CloseSessionAsync(
+            CloseSessionRequest request,
+            CancellationToken cancellationToken)
+        {
+            CloseSessionRequests.Add(request);
+            return Task.FromResult(new CloseSessionReply
+            {
+                SessionId = request.SessionId,
+                ProtocolStatus = new ProtocolStatus { Code = ProtocolStatusCode.Ok },
+                FinalState = SessionState.Closed,
+            });
+        }
+
+        /// <inheritdoc />
+        public Task<MxCommandReply> InvokeAsync(
+            MxCommandRequest request,
+            CancellationToken cancellationToken)
+        {
+            InvokeRequests.Add(request);
+            if (InvokeFailure is not null)
+            {
+                throw InvokeFailure;
+            }
+
+            return Task.FromResult(InvokeReplies.Dequeue());
+        }
+
+        /// <inheritdoc />
+        public async IAsyncEnumerable<MxEvent> StreamEventsAsync(
+            StreamEventsRequest request,
+            [System.Runtime.CompilerServices.EnumeratorCancellation] CancellationToken cancellationToken)
+        {
+            foreach (MxEvent gatewayEvent in Events)
+            {
+                cancellationToken.ThrowIfCancellationRequested();
+                await Task.Yield();
+                yield return gatewayEvent;
+            }
+        }
+
+        /// <summary>Galaxy test connection reply to return.</summary>
+        public TestConnectionReply GalaxyTestConnectionReply { get; set; } = new() { Ok = true };
+
+        /// <summary>Galaxy get last deploy time reply to return.</summary>
+        public GetLastDeployTimeReply GalaxyGetLastDeployTimeReply { get; set; } = new() { Present = false };
+
+        /// <summary>Galaxy discover hierarchy reply to return.</summary>
+        public DiscoverHierarchyReply GalaxyDiscoverHierarchyReply { get; set; } = new();
+
+        public Queue<DiscoverHierarchyReply> GalaxyDiscoverHierarchyReplies { get; } = new();
+
+        /// <summary>List of received galaxy test connection requests.</summary>
+        public List<TestConnectionRequest> GalaxyTestConnectionRequests { get; } = [];
+
+        /// <summary>List of received galaxy get last deploy time requests.</summary>
+        public List<GetLastDeployTimeRequest> GalaxyGetLastDeployTimeRequests { get; } = [];
+
+        /// <summary>List of received galaxy discover hierarchy requests.</summary>
+        public List<DiscoverHierarchyRequest> GalaxyDiscoverHierarchyRequests { get; } = [];
+
+        /// <inheritdoc />
+        public Task<TestConnectionReply> GalaxyTestConnectionAsync(
+            TestConnectionRequest request,
+            CancellationToken cancellationToken)
+        {
+            GalaxyTestConnectionRequests.Add(request);
+            return Task.FromResult(GalaxyTestConnectionReply);
+        }
+
+        /// <inheritdoc />
+        public Task<GetLastDeployTimeReply> GalaxyGetLastDeployTimeAsync(
+            GetLastDeployTimeRequest request,
+            CancellationToken cancellationToken)
+        {
+            GalaxyGetLastDeployTimeRequests.Add(request);
+            return Task.FromResult(GalaxyGetLastDeployTimeReply);
+        }
+
+        /// <inheritdoc />
+        public Task<DiscoverHierarchyReply> GalaxyDiscoverHierarchyAsync(
+            DiscoverHierarchyRequest request,
+            CancellationToken cancellationToken)
+        {
+            GalaxyDiscoverHierarchyRequests.Add(request);
+            return Task.FromResult(
+                GalaxyDiscoverHierarchyReplies.TryDequeue(out DiscoverHierarchyReply? reply)
+                    ? reply
+                    : GalaxyDiscoverHierarchyReply);
+        }
+
+        /// <summary>List of received galaxy watch deploy events requests.</summary>
+        public List<WatchDeployEventsRequest> GalaxyWatchDeployEventsRequests { get; } = [];
+
+        /// <summary>List of deploy events to yield when watching.</summary>
+        public List<DeployEvent> GalaxyDeployEvents { get; } = [];
+
+        /// <inheritdoc />
+        public async IAsyncEnumerable<DeployEvent> GalaxyWatchDeployEventsAsync(
+            WatchDeployEventsRequest request,
+            [System.Runtime.CompilerServices.EnumeratorCancellation] CancellationToken cancellationToken)
+        {
+            GalaxyWatchDeployEventsRequests.Add(request);
+            foreach (DeployEvent deployEvent in GalaxyDeployEvents)
+            {
+                cancellationToken.ThrowIfCancellationRequested();
+                await Task.Yield();
+                yield return deployEvent;
+            }
+        }
+    }
+}

clients/dotnet/MxGateway.Client.Tests/MxGatewayClientContractInfoTests.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts;
+using MxGateway.Contracts;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class MxGatewayClientContractInfoTests
 {

clients/dotnet/MxGateway.Client.Tests/MxGatewayClientOptionsTests.cs

@@ -1,4 +1,4 @@
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class MxGatewayClientOptionsTests
 {

clients/dotnet/MxGateway.Client.Tests/MxGatewayClientSessionTests.cs

@@ -1,7 +1,7 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 using Grpc.Core;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 /// <summary>Tests for MxGatewaySession and client command behavior.</summary>
 public sealed class MxGatewayClientSessionTests

clients/dotnet/MxGateway.Client.Tests/MxGatewayGeneratedContractTests.cs

@@ -1,4 +1,4 @@
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class MxGatewayGeneratedContractTests
 {

clients/dotnet/MxGateway.Client.Tests/MxStatusProxyExtensionsTests.cs

@@ -1,9 +1,9 @@
 using System.Text.Json;
 using Google.Protobuf;
-using ZB.MOM.WW.MxGateway.Client;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Client;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class MxStatusProxyExtensionsTests
 {

clients/dotnet/MxGateway.Client.Tests/MxValueExtensionsTests.cs

@@ -1,9 +1,9 @@
 using System.Text.Json;
 using Google.Protobuf;
-using ZB.MOM.WW.MxGateway.Client;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Client;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
+namespace MxGateway.Client.Tests;
 
 public sealed class MxValueExtensionsTests
 {

clients/dotnet/MxGateway.Client.sln

@@ -0,0 +1,76 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MxGateway.Client", "MxGateway.Client\MxGateway.Client.csproj", "{7CF9ED88-1F32-4040-BEB1-D0902E304C70}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MxGateway.Contracts", "..\..\src\MxGateway.Contracts\MxGateway.Contracts.csproj", "{9AB807A8-0469-40F7-A000-D240F36B6E5D}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MxGateway.Client.Cli", "MxGateway.Client.Cli\MxGateway.Client.Cli.csproj", "{EB061E77-2475-4322-9257-3F2456DD141C}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MxGateway.Client.Tests", "MxGateway.Client.Tests\MxGateway.Client.Tests.csproj", "{B77B5A8E-0C53-4419-9BCD-227C9753A074}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Debug|x64.Build.0 = Debug|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Debug|x86.Build.0 = Debug|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Release|Any CPU.Build.0 = Release|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Release|x64.ActiveCfg = Release|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Release|x64.Build.0 = Release|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Release|x86.ActiveCfg = Release|Any CPU
+		{7CF9ED88-1F32-4040-BEB1-D0902E304C70}.Release|x86.Build.0 = Release|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Debug|x64.Build.0 = Debug|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Debug|x86.Build.0 = Debug|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Release|x64.ActiveCfg = Release|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Release|x64.Build.0 = Release|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Release|x86.ActiveCfg = Release|Any CPU
+		{9AB807A8-0469-40F7-A000-D240F36B6E5D}.Release|x86.Build.0 = Release|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Debug|x64.Build.0 = Debug|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Debug|x86.Build.0 = Debug|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Release|x64.ActiveCfg = Release|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Release|x64.Build.0 = Release|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Release|x86.ActiveCfg = Release|Any CPU
+		{EB061E77-2475-4322-9257-3F2456DD141C}.Release|x86.Build.0 = Release|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Debug|x64.Build.0 = Debug|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Debug|x86.Build.0 = Debug|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Release|x64.ActiveCfg = Release|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Release|x64.Build.0 = Release|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Release|x86.ActiveCfg = Release|Any CPU
+		{B77B5A8E-0C53-4419-9BCD-227C9753A074}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+EndGlobal

clients/dotnet/MxGateway.Client/DiscoverHierarchyOptions.cs

@@ -0,0 +1,24 @@
+namespace MxGateway.Client;
+
+public sealed record DiscoverHierarchyOptions
+{
+    public int? RootGobjectId { get; init; }
+
+    public string? RootTagName { get; init; }
+
+    public string? RootContainedPath { get; init; }
+
+    public int? MaxDepth { get; init; }
+
+    public IReadOnlyList<int> CategoryIds { get; init; } = Array.Empty<int>();
+
+    public IReadOnlyList<string> TemplateChainContains { get; init; } = Array.Empty<string>();
+
+    public string? TagNameGlob { get; init; }
+
+    public bool? IncludeAttributes { get; init; }
+
+    public bool AlarmBearingOnly { get; init; }
+
+    public bool HistorizedOnly { get; init; }
+}

clients/dotnet/MxGateway.Client/GalaxyRepositoryClient.cs

@@ -2,14 +2,14 @@ using Google.Protobuf.WellKnownTypes;
 using Grpc.Core;
 using Grpc.Net.Client;
 using Microsoft.Extensions.Logging;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Contracts.Proto.Galaxy;
 using Polly;
 using System.Net.Http;
 using System.Net.Security;
 using System.Runtime.CompilerServices;
 using System.Security.Cryptography.X509Certificates;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Provides the .NET client entry point for the public Galaxy Repository gRPC API.
@@ -19,7 +19,6 @@ namespace ZB.MOM.WW.MxGateway.Client;
 public sealed class GalaxyRepositoryClient : IAsyncDisposable
 {
     private const int DiscoverHierarchyPageSize = 5000;
-    private const int BrowseChildrenPageSize = 500;
 
     private readonly GrpcChannel? _channel;
     private readonly IGalaxyRepositoryClientTransport _transport;
@@ -183,10 +182,6 @@ public sealed class GalaxyRepositoryClient : IAsyncDisposable
         return await DiscoverHierarchyAsync(new DiscoverHierarchyOptions(), cancellationToken).ConfigureAwait(false);
     }
 
-    /// <summary>Discovers the Galaxy object hierarchy.</summary>
-    /// <param name="options">Client configuration options.</param>
-    /// <param name="cancellationToken">Token to observe for cancellation.</param>
-    /// <returns>The collection of Galaxy objects in the hierarchy.</returns>
     public async Task<IReadOnlyList<GalaxyObject>> DiscoverHierarchyAsync(
         DiscoverHierarchyOptions options,
         CancellationToken cancellationToken = default)
@@ -279,89 +274,6 @@ public sealed class GalaxyRepositoryClient : IAsyncDisposable
             cancellationToken);
     }
 
-    /// <summary>Returns root-level browse nodes (objects with no parent).</summary>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>The list of root <see cref="LazyBrowseNode"/> instances.</returns>
-    public Task<IReadOnlyList<LazyBrowseNode>> BrowseAsync(CancellationToken cancellationToken = default)
-        => BrowseAsync(null, cancellationToken);
-
-    /// <summary>Returns root-level browse nodes filtered by the given options.</summary>
-    /// <param name="options">Browse filter options. Null applies no filter.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>The list of root <see cref="LazyBrowseNode"/> instances.</returns>
-    public async Task<IReadOnlyList<LazyBrowseNode>> BrowseAsync(
-        BrowseChildrenOptions? options,
-        CancellationToken cancellationToken = default)
-    {
-        BrowseChildrenOptions effective = options ?? new BrowseChildrenOptions();
-        List<LazyBrowseNode> roots = [];
-        string pageToken = string.Empty;
-        HashSet<string> seenPageTokens = new(StringComparer.Ordinal);
-        do
-        {
-            BrowseChildrenRequest request = BuildBrowseChildrenRequest(effective);
-            request.PageToken = pageToken;
-            BrowseChildrenReply reply = await BrowseChildrenRawAsync(request, cancellationToken).ConfigureAwait(false);
-
-            for (int i = 0; i < reply.Children.Count; i++)
-            {
-                bool hint = i < reply.ChildHasChildren.Count && reply.ChildHasChildren[i];
-                roots.Add(new LazyBrowseNode(this, reply.Children[i], hint, effective));
-            }
-
-            pageToken = reply.NextPageToken;
-            if (!string.IsNullOrWhiteSpace(pageToken) && !seenPageTokens.Add(pageToken))
-            {
-                throw new MxGatewayException(
-                    $"Galaxy BrowseChildren returned a repeated page token '{pageToken}'.");
-            }
-        }
-        while (!string.IsNullOrWhiteSpace(pageToken));
-
-        return roots;
-    }
-
-    /// <summary>Issues a raw BrowseChildren RPC without result wrapping.</summary>
-    /// <param name="request">The browse-children request.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>The raw server reply.</returns>
-    public Task<BrowseChildrenReply> BrowseChildrenRawAsync(
-        BrowseChildrenRequest request,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(request);
-        ThrowIfDisposed();
-
-        return ExecuteSafeUnaryAsync(
-            token => _transport.BrowseChildrenAsync(request, CreateCallOptions(token)),
-            cancellationToken);
-    }
-
-    internal static BrowseChildrenRequest BuildBrowseChildrenRequest(BrowseChildrenOptions options)
-    {
-        ArgumentNullException.ThrowIfNull(options);
-
-        BrowseChildrenRequest request = new()
-        {
-            PageSize = BrowseChildrenPageSize,
-            AlarmBearingOnly = options.AlarmBearingOnly,
-            HistorizedOnly = options.HistorizedOnly,
-        };
-        request.CategoryIds.Add(options.CategoryIds);
-        request.TemplateChainContains.Add(options.TemplateChainContains);
-        if (!string.IsNullOrWhiteSpace(options.TagNameGlob))
-        {
-            request.TagNameGlob = options.TagNameGlob;
-        }
-
-        if (options.IncludeAttributes.HasValue)
-        {
-            request.IncludeAttributes = options.IncludeAttributes.Value;
-        }
-
-        return request;
-    }
-
     /// <summary>
     /// Subscribes to Galaxy deploy events. The server emits a bootstrap event with the
     /// current state on subscribe so callers can prime their cache, then emits one event
@@ -490,10 +402,7 @@ public sealed class GalaxyRepositoryClient : IAsyncDisposable
             .ConfigureAwait(false);
     }
 
-    private static HttpMessageHandler CreateHttpHandler(MxGatewayClientOptions options) =>
-        CreateHttpHandlerForTests(options);
-
-    internal static SocketsHttpHandler CreateHttpHandlerForTests(MxGatewayClientOptions options)
+    private static HttpMessageHandler CreateHttpHandler(MxGatewayClientOptions options)
     {
         SocketsHttpHandler handler = new()
         {
@@ -513,11 +422,6 @@ public sealed class GalaxyRepositoryClient : IAsyncDisposable
                 X509Certificate2 trustedRoot = X509CertificateLoader.LoadCertificateFromFile(options.CaCertificatePath);
                 handler.SslOptions.RemoteCertificateValidationCallback = (_, certificate, chain, errors) =>
                 {
-                    if ((errors & System.Net.Security.SslPolicyErrors.RemoteCertificateNameMismatch) != 0)
-                    {
-                        return false;
-                    }
-
                     if (certificate is null)
                     {
                         return false;
@@ -533,10 +437,6 @@ public sealed class GalaxyRepositoryClient : IAsyncDisposable
                     return customChain.Build(certificateToValidate);
                 };
             }
-            else if (!options.RequireCertificateValidation)
-            {
-                handler.SslOptions.RemoteCertificateValidationCallback = (_, _, _, _) => true;
-            }
         }
 
         return handler;

clients/dotnet/MxGateway.Client/GrpcGalaxyRepositoryClientTransport.cs

@@ -1,7 +1,7 @@
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Contracts.Proto.Galaxy;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// gRPC implementation of IGalaxyRepositoryClientTransport.
@@ -74,23 +74,6 @@ internal sealed class GrpcGalaxyRepositoryClientTransport(
         }
     }
 
-    /// <inheritdoc />
-    public async Task<BrowseChildrenReply> BrowseChildrenAsync(
-        BrowseChildrenRequest request,
-        CallOptions callOptions)
-    {
-        try
-        {
-            return await RawClient.BrowseChildrenAsync(request, callOptions)
-                .ResponseAsync
-                .ConfigureAwait(false);
-        }
-        catch (RpcException exception)
-        {
-            throw MapRpcException(exception, callOptions.CancellationToken);
-        }
-    }
-
     /// <inheritdoc />
     public async IAsyncEnumerable<DeployEvent> WatchDeployEventsAsync(
         WatchDeployEventsRequest request,

clients/dotnet/MxGateway.Client/GrpcMxGatewayClientTransport.cs

@@ -1,7 +1,7 @@
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// gRPC implementation of IMxGatewayClientTransport.
@@ -175,48 +175,6 @@ internal sealed class GrpcMxGatewayClientTransport(
         return QueryActiveAlarmsAsync(request, callOptions);
     }
 
-    /// <inheritdoc />
-    public async IAsyncEnumerable<AlarmFeedMessage> StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CallOptions callOptions,
-        [System.Runtime.CompilerServices.EnumeratorCancellation] CancellationToken cancellationToken = default)
-    {
-        CancellationToken effectiveCancellationToken = cancellationToken.CanBeCanceled
-            ? cancellationToken
-            : callOptions.CancellationToken;
-
-        using AsyncServerStreamingCall<AlarmFeedMessage> call = RawClient.StreamAlarms(request, callOptions);
-
-        IAsyncStreamReader<AlarmFeedMessage> responseStream = call.ResponseStream;
-        while (true)
-        {
-            AlarmFeedMessage? message;
-            try
-            {
-                if (!await responseStream.MoveNext(effectiveCancellationToken).ConfigureAwait(false))
-                {
-                    break;
-                }
-
-                message = responseStream.Current;
-            }
-            catch (RpcException exception)
-            {
-                throw MapRpcException(exception, effectiveCancellationToken);
-            }
-
-            yield return message;
-        }
-    }
-
-    /// <inheritdoc />
-    IAsyncEnumerable<AlarmFeedMessage> IMxGatewayClientTransport.StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CallOptions callOptions)
-    {
-        return StreamAlarmsAsync(request, callOptions);
-    }
-
     private static Exception MapRpcException(
         RpcException exception,
         CancellationToken cancellationToken)

clients/dotnet/MxGateway.Client/IGalaxyRepositoryClientTransport.cs

@@ -1,7 +1,7 @@
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
+using MxGateway.Contracts.Proto.Galaxy;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Transport layer for Galaxy Repository gRPC operations.</summary>
 internal interface IGalaxyRepositoryClientTransport
@@ -33,13 +33,6 @@ internal interface IGalaxyRepositoryClientTransport
         DiscoverHierarchyRequest request,
         CallOptions callOptions);
 
-    /// <summary>Returns direct children of a parent in the Galaxy hierarchy.</summary>
-    /// <param name="request">The browse children request.</param>
-    /// <param name="callOptions">gRPC call options (timeout, cancellation, etc.).</param>
-    Task<BrowseChildrenReply> BrowseChildrenAsync(
-        BrowseChildrenRequest request,
-        CallOptions callOptions);
-
     /// <summary>Watches for deployment events from the Galaxy Repository server.</summary>
     /// <param name="request">The watch deploy events request.</param>
     /// <param name="callOptions">gRPC call options (timeout, cancellation, etc.).</param>

clients/dotnet/MxGateway.Client/IMxGatewayClientTransport.cs

@@ -1,7 +1,7 @@
 using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 internal interface IMxGatewayClientTransport
 {
@@ -75,15 +75,4 @@ internal interface IMxGatewayClientTransport
     IAsyncEnumerable<ActiveAlarmSnapshot> QueryActiveAlarmsAsync(
         QueryActiveAlarmsRequest request,
         CallOptions callOptions);
-
-    /// <summary>
-    /// Attaches to the gateway's central alarm feed — the current active-alarm
-    /// snapshot followed by live transitions.
-    /// </summary>
-    /// <param name="request">The stream request, optionally scoped by alarm-reference prefix.</param>
-    /// <param name="callOptions">gRPC call options.</param>
-    /// <returns>An async enumerable of alarm feed messages.</returns>
-    IAsyncEnumerable<AlarmFeedMessage> StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CallOptions callOptions);
 }

clients/dotnet/MxGateway.Client/MxAccessException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Exception thrown when an MXAccess command fails with a non-zero HResult or failing status.</summary>
 public sealed class MxAccessException : MxGatewayCommandException

clients/dotnet/MxGateway.Client/MxCommandReplyExtensions.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Extension methods for checking MxCommandReply success conditions.</summary>
 public static class MxCommandReplyExtensions

clients/dotnet/MxGateway.Client/MxGateway.Client.csproj

@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\src\MxGateway.Contracts\MxGateway.Contracts.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Grpc.Net.Client" Version="2.76.0" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.7" />
+    <PackageReference Include="Polly.Core" Version="8.6.6" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+</Project>

clients/dotnet/MxGateway.Client/MxGatewayAuthenticationException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Exception thrown when an API key is invalid, expired, or malformed.</summary>
 public sealed class MxGatewayAuthenticationException : MxGatewayException

clients/dotnet/MxGateway.Client/MxGatewayAuthorizationException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Exception thrown when the API key lacks required scopes for an operation.</summary>
 public sealed class MxGatewayAuthorizationException : MxGatewayException

clients/dotnet/MxGateway.Client/MxGatewayClient.cs

@@ -1,13 +1,13 @@
 using Grpc.Core;
 using Grpc.Net.Client;
 using Microsoft.Extensions.Logging;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 using Polly;
 using System.Net.Http;
 using System.Net.Security;
 using System.Security.Cryptography.X509Certificates;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Provides the .NET client entry point for the public MXAccess Gateway gRPC API.
@@ -224,28 +224,6 @@ public sealed class MxGatewayClient : IAsyncDisposable
         return _transport.QueryActiveAlarmsAsync(request, CreateStreamCallOptions(cancellationToken));
     }
 
-    /// <summary>
-    /// Attaches to the gateway's central alarm feed. The stream opens with one
-    /// <see cref="AlarmFeedMessage"/> per currently-active alarm (the
-    /// ConditionRefresh snapshot), then a single <c>snapshot_complete</c>, then a
-    /// <c>transition</c> for every subsequent raise / acknowledge / clear. Served
-    /// by the gateway's always-on alarm monitor — no worker session is opened, so
-    /// any number of clients may attach. Optionally scoped by alarm-reference
-    /// prefix (<see cref="StreamAlarmsRequest.AlarmFilterPrefix"/>).
-    /// </summary>
-    /// <param name="request">The stream request, optionally scoped by alarm-reference prefix.</param>
-    /// <param name="cancellationToken">Cancellation token for the stream.</param>
-    /// <returns>An async enumerable of alarm feed messages.</returns>
-    public IAsyncEnumerable<AlarmFeedMessage> StreamAlarmsAsync(
-        StreamAlarmsRequest request,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(request);
-        ThrowIfDisposed();
-
-        return _transport.StreamAlarmsAsync(request, CreateStreamCallOptions(cancellationToken));
-    }
-
     /// <summary>
     /// Disposes the client and releases all resources.
     /// </summary>
@@ -315,10 +293,7 @@ public sealed class MxGatewayClient : IAsyncDisposable
             .ConfigureAwait(false);
     }
 
-    private static HttpMessageHandler CreateHttpHandler(MxGatewayClientOptions options) =>
-        CreateHttpHandlerForTests(options);
-
-    internal static SocketsHttpHandler CreateHttpHandlerForTests(MxGatewayClientOptions options)
+    private static HttpMessageHandler CreateHttpHandler(MxGatewayClientOptions options)
     {
         SocketsHttpHandler handler = new()
         {
@@ -338,11 +313,6 @@ public sealed class MxGatewayClient : IAsyncDisposable
                 X509Certificate2 trustedRoot = X509CertificateLoader.LoadCertificateFromFile(options.CaCertificatePath);
                 handler.SslOptions.RemoteCertificateValidationCallback = (_, certificate, chain, errors) =>
                 {
-                    if ((errors & System.Net.Security.SslPolicyErrors.RemoteCertificateNameMismatch) != 0)
-                    {
-                        return false;
-                    }
-
                     if (certificate is null)
                     {
                         return false;
@@ -358,10 +328,6 @@ public sealed class MxGatewayClient : IAsyncDisposable
                     return customChain.Build(certificateToValidate);
                 };
             }
-            else if (!options.RequireCertificateValidation)
-            {
-                handler.SslOptions.RemoteCertificateValidationCallback = (_, _, _, _) => true;
-            }
         }
 
         return handler;

clients/dotnet/MxGateway.Client/MxGatewayClientContractInfo.cs

@@ -1,17 +1,15 @@
-using ZB.MOM.WW.MxGateway.Contracts;
+using MxGateway.Contracts;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Exposes the protocol versions compiled into this client package.
 /// </summary>
 public static class MxGatewayClientContractInfo
 {
-    /// <inheritdoc cref="GatewayContractInfo.GatewayProtocolVersion"/>
     public const uint GatewayProtocolVersion =
         GatewayContractInfo.GatewayProtocolVersion;
 
-    /// <inheritdoc cref="GatewayContractInfo.WorkerProtocolVersion"/>
     public const uint WorkerProtocolVersion =
         GatewayContractInfo.WorkerProtocolVersion;
 }

clients/dotnet/MxGateway.Client/MxGatewayClientOptions.cs

@@ -1,6 +1,6 @@
 using Microsoft.Extensions.Logging;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Configures the gRPC channel used by the .NET MXAccess Gateway client.
@@ -27,14 +27,6 @@ public sealed class MxGatewayClientOptions
     /// </summary>
     public string? CaCertificatePath { get; init; }
 
-    /// <summary>
-    /// When true, TLS connections without a pinned <see cref="CaCertificatePath"/>
-    /// use the OS trust store. When false (default), the gateway certificate is
-    /// accepted without verification — appropriate for this internal tool's
-    /// auto-generated self-signed certificate. Pinning a CA always verifies.
-    /// </summary>
-    public bool RequireCertificateValidation { get; init; }
-
     /// <summary>
     /// Gets the server name override for SNI during TLS handshake.
     /// </summary>
@@ -55,9 +47,6 @@ public sealed class MxGatewayClientOptions
     /// </summary>
     public TimeSpan? StreamTimeout { get; init; }
 
-    /// <summary>
-    /// Gets the maximum size in bytes for gRPC messages.
-    /// </summary>
     public int MaxGrpcMessageBytes { get; init; } = 16 * 1024 * 1024;
 
     /// <summary>

clients/dotnet/MxGateway.Client/MxGatewayClientRetryOptions.cs

@@ -1,4 +1,4 @@
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Configuration for automatic retry behavior on transient gRPC call failures.</summary>
 public sealed class MxGatewayClientRetryOptions

clients/dotnet/MxGateway.Client/MxGatewayClientRetryPolicy.cs

@@ -1,10 +1,10 @@
 using Grpc.Core;
 using Microsoft.Extensions.Logging;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 using Polly;
 using Polly.Retry;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Factory and helpers for exponential-backoff retry policies on transient gRPC failures.</summary>
 internal static class MxGatewayClientRetryPolicy

clients/dotnet/MxGateway.Client/MxGatewayCommandException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Exception thrown when a gateway command fails due to an unclassified protocol error.</summary>
 public class MxGatewayCommandException : MxGatewayException

clients/dotnet/MxGateway.Client/MxGatewayException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Exception thrown when a gateway RPC call fails or returns an error status.

clients/dotnet/MxGateway.Client/MxGatewaySession.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Represents one gateway-backed MXAccess session.
@@ -502,171 +502,6 @@ public sealed class MxGatewaySession : IAsyncDisposable
         return reply.UnsubscribeBulk?.Results.ToArray() ?? [];
     }
 
-    /// <summary>
-    /// Bulk Write — sequential MXAccess Write per entry on the worker's STA.
-    /// Per-item failures appear as <see cref="BulkWriteResult"/> entries with
-    /// <c>WasSuccessful = false</c>; the call never throws on per-item errors.
-    /// Protocol-level failures still throw via EnsureProtocolSuccess.
-    /// </summary>
-    /// <param name="serverHandle">The ServerHandle from register.</param>
-    /// <param name="entries">Per-item write entries; each carries the item handle, value, and user id.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>One <see cref="BulkWriteResult"/> per requested entry, in request order.</returns>
-    public async Task<IReadOnlyList<BulkWriteResult>> WriteBulkAsync(
-        int serverHandle,
-        IReadOnlyList<WriteBulkEntry> entries,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(entries);
-
-        WriteBulkCommand command = new() { ServerHandle = serverHandle };
-        command.Entries.Add(entries);
-
-        MxCommandReply reply = await InvokeCommandAsync(
-                new MxCommand
-                {
-                    Kind = MxCommandKind.WriteBulk,
-                    WriteBulk = command,
-                },
-                cancellationToken)
-            .ConfigureAwait(false);
-        reply.EnsureProtocolSuccess().EnsureMxAccessSuccess();
-        return reply.WriteBulk?.Results.ToArray() ?? [];
-    }
-
-    /// <summary>
-    /// Bulk Write2 — sequential MXAccess Write2 (timestamped) per entry.
-    /// Per-item failures appear as <see cref="BulkWriteResult"/> entries with
-    /// <c>WasSuccessful = false</c>; the call never throws on per-item errors.
-    /// </summary>
-    /// <param name="serverHandle">The ServerHandle from register.</param>
-    /// <param name="entries">Per-item write entries; each carries the item handle, value, timestamp, and user id.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>One <see cref="BulkWriteResult"/> per requested entry, in request order.</returns>
-    public async Task<IReadOnlyList<BulkWriteResult>> Write2BulkAsync(
-        int serverHandle,
-        IReadOnlyList<Write2BulkEntry> entries,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(entries);
-
-        Write2BulkCommand command = new() { ServerHandle = serverHandle };
-        command.Entries.Add(entries);
-
-        MxCommandReply reply = await InvokeCommandAsync(
-                new MxCommand
-                {
-                    Kind = MxCommandKind.Write2Bulk,
-                    Write2Bulk = command,
-                },
-                cancellationToken)
-            .ConfigureAwait(false);
-        reply.EnsureProtocolSuccess().EnsureMxAccessSuccess();
-        return reply.Write2Bulk?.Results.ToArray() ?? [];
-    }
-
-    /// <summary>
-    /// Bulk WriteSecured — sequential MXAccess WriteSecured per entry.
-    /// Credential-sensitive values must never reach logs; the client mirrors
-    /// the single-item WriteSecured redaction contract.
-    /// </summary>
-    /// <param name="serverHandle">The ServerHandle from register.</param>
-    /// <param name="entries">Per-item write entries; each carries the item handle, value, current user id, and verifier user id.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>One <see cref="BulkWriteResult"/> per requested entry, in request order.</returns>
-    public async Task<IReadOnlyList<BulkWriteResult>> WriteSecuredBulkAsync(
-        int serverHandle,
-        IReadOnlyList<WriteSecuredBulkEntry> entries,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(entries);
-
-        WriteSecuredBulkCommand command = new() { ServerHandle = serverHandle };
-        command.Entries.Add(entries);
-
-        MxCommandReply reply = await InvokeCommandAsync(
-                new MxCommand
-                {
-                    Kind = MxCommandKind.WriteSecuredBulk,
-                    WriteSecuredBulk = command,
-                },
-                cancellationToken)
-            .ConfigureAwait(false);
-        reply.EnsureProtocolSuccess().EnsureMxAccessSuccess();
-        return reply.WriteSecuredBulk?.Results.ToArray() ?? [];
-    }
-
-    /// <summary>
-    /// Bulk WriteSecured2 — sequential MXAccess WriteSecured2 (timestamped) per entry.
-    /// Same redaction rules as <see cref="WriteSecuredBulkAsync"/>.
-    /// </summary>
-    /// <param name="serverHandle">The ServerHandle from register.</param>
-    /// <param name="entries">Per-item write entries; each carries the item handle, value, timestamp, current user id, and verifier user id.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>One <see cref="BulkWriteResult"/> per requested entry, in request order.</returns>
-    public async Task<IReadOnlyList<BulkWriteResult>> WriteSecured2BulkAsync(
-        int serverHandle,
-        IReadOnlyList<WriteSecured2BulkEntry> entries,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(entries);
-
-        WriteSecured2BulkCommand command = new() { ServerHandle = serverHandle };
-        command.Entries.Add(entries);
-
-        MxCommandReply reply = await InvokeCommandAsync(
-                new MxCommand
-                {
-                    Kind = MxCommandKind.WriteSecured2Bulk,
-                    WriteSecured2Bulk = command,
-                },
-                cancellationToken)
-            .ConfigureAwait(false);
-        reply.EnsureProtocolSuccess().EnsureMxAccessSuccess();
-        return reply.WriteSecured2Bulk?.Results.ToArray() ?? [];
-    }
-
-    /// <summary>
-    /// Bulk Read — snapshot the current value for each requested tag.
-    /// Returns the cached OnDataChange value when the tag is already advised
-    /// (<c>WasCached = true</c>), otherwise the worker takes the full AddItem +
-    /// Advise + wait + UnAdvise + RemoveItem snapshot lifecycle. Per-tag
-    /// failures (timeout, invalid tag) appear as <see cref="BulkReadResult"/>
-    /// entries with <c>WasSuccessful = false</c>; the call never throws on
-    /// per-tag errors.
-    /// </summary>
-    /// <param name="serverHandle">The ServerHandle from register.</param>
-    /// <param name="tagAddresses">Tag addresses to read (one per result).</param>
-    /// <param name="timeout">Per-call timeout for the snapshot lifecycle path; <see cref="TimeSpan.Zero"/> uses the gateway default.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>One <see cref="BulkReadResult"/> per requested tag, in request order.</returns>
-    public async Task<IReadOnlyList<BulkReadResult>> ReadBulkAsync(
-        int serverHandle,
-        IReadOnlyList<string> tagAddresses,
-        TimeSpan timeout,
-        CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(tagAddresses);
-
-        ReadBulkCommand command = new()
-        {
-            ServerHandle = serverHandle,
-            TimeoutMs = timeout <= TimeSpan.Zero ? 0u : (uint)Math.Min(timeout.TotalMilliseconds, uint.MaxValue),
-        };
-        command.TagAddresses.Add(tagAddresses);
-
-        MxCommandReply reply = await InvokeCommandAsync(
-                new MxCommand
-                {
-                    Kind = MxCommandKind.ReadBulk,
-                    ReadBulk = command,
-                },
-                cancellationToken)
-            .ConfigureAwait(false);
-        reply.EnsureProtocolSuccess().EnsureMxAccessSuccess();
-        return reply.ReadBulk?.Results.ToArray() ?? [];
-    }
-
     /// <summary>
     /// Writes a value to an item on the MXAccess server.
     /// </summary>

clients/dotnet/MxGateway.Client/MxGatewaySessionException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Exception thrown when a session is not found, not ready, or invalid.</summary>
 public sealed class MxGatewaySessionException : MxGatewayException

clients/dotnet/MxGateway.Client/MxGatewayWorkerException.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Exception thrown when the worker process is unavailable or fails to process a command.</summary>
 public sealed class MxGatewayWorkerException : MxGatewayException

clients/dotnet/MxGateway.Client/MxStatusProxyExtensions.cs

@@ -1,6 +1,6 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>Extension methods for MxStatusProxy values.</summary>
 public static class MxStatusProxyExtensions

clients/dotnet/MxGateway.Client/MxValueExtensions.cs

@@ -1,8 +1,8 @@
 using Google.Protobuf;
 using Google.Protobuf.WellKnownTypes;
-using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using MxGateway.Contracts.Proto;
 
-namespace ZB.MOM.WW.MxGateway.Client;
+namespace MxGateway.Client;
 
 /// <summary>
 /// Creates and projects gateway MXAccess values without hiding the raw

clients/dotnet/MxGateway.Client/Properties/AssemblyInfo.cs

@@ -0,0 +1,3 @@
+using System.Runtime.CompilerServices;
+
+[assembly: InternalsVisibleTo("MxGateway.Client.Tests")]

clients/dotnet/README.md

@@ -7,11 +7,11 @@ CLI, and unit tests.
 
 | Project | Purpose |
 |---------|---------|
-| `ZB.MOM.WW.MxGateway.Client` | .NET 10 library entry point, raw gRPC calls, and session helpers. |
-| `ZB.MOM.WW.MxGateway.Client.Cli` | Test CLI for smoke and diagnostic commands. |
-| `ZB.MOM.WW.MxGateway.Client.Tests` | Unit tests for client options, generated contract wiring, auth metadata, session helpers, cancellation, and event streaming. |
+| `MxGateway.Client` | .NET 10 library entry point, raw gRPC calls, and session helpers. |
+| `MxGateway.Client.Cli` | Test CLI for smoke and diagnostic commands. |
+| `MxGateway.Client.Tests` | Unit tests for client options, generated contract wiring, auth metadata, session helpers, cancellation, and event streaming. |
 
-The projects reference `src/ZB.MOM.WW.MxGateway.Contracts/ZB.MOM.WW.MxGateway.Contracts.csproj` so
+The projects reference `src/MxGateway.Contracts/MxGateway.Contracts.csproj` so
 the client compiles against the same generated protobuf and gRPC types as the
 gateway. `clients/dotnet/generated` remains reserved for generator output if a
 future client build switches to client-local `Grpc.Tools` generation.
@@ -19,8 +19,8 @@ future client build switches to client-local `Grpc.Tools` generation.
 ## Build And Test
 
 ```powershell
-dotnet build clients/dotnet/ZB.MOM.WW.MxGateway.Client.slnx
-dotnet test clients/dotnet/ZB.MOM.WW.MxGateway.Client.slnx --no-build
+dotnet build clients/dotnet/MxGateway.Client.sln
+dotnet test clients/dotnet/MxGateway.Client.sln --no-build
 ```
 
 ## Packaging
@@ -29,8 +29,8 @@ Create local library and CLI artifacts from the repository root:
 
 ```powershell
 $dotnetPackageOutput = Join-Path (Get-Location) 'artifacts/clients/dotnet'
-dotnet pack clients/dotnet/ZB.MOM.WW.MxGateway.Client/ZB.MOM.WW.MxGateway.Client.csproj -c Release -p:PackageOutputPath="$dotnetPackageOutput"
-dotnet publish clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli/ZB.MOM.WW.MxGateway.Client.Cli.csproj -c Release -o artifacts/clients/dotnet/mxgw-dotnet
+dotnet pack clients/dotnet/MxGateway.Client/MxGateway.Client.csproj -c Release -p:PackageOutputPath="$dotnetPackageOutput"
+dotnet publish clients/dotnet/MxGateway.Client.Cli/MxGateway.Client.Cli.csproj -c Release -o artifacts/clients/dotnet/mxgw-dotnet
 ```
 
 The library package references the shared contracts project at build time. The
@@ -39,11 +39,11 @@ published CLI runs from `artifacts/clients/dotnet/mxgw-dotnet`.
 ## Regenerating Protobuf Bindings
 
 The .NET client uses the generated C# types from
-`src/ZB.MOM.WW.MxGateway.Contracts/Generated`. Regenerate those files through the
+`src/MxGateway.Contracts/Generated`. Regenerate those files through the
 contracts project:
 
 ```powershell
-dotnet build src/ZB.MOM.WW.MxGateway.Contracts/ZB.MOM.WW.MxGateway.Contracts.csproj
+dotnet build src/MxGateway.Contracts/MxGateway.Contracts.csproj
 ```
 
 ## Client Usage
@@ -84,15 +84,6 @@ messages. `MxGatewaySession.OpenSessionReply` keeps the raw session-open reply
 available, and command helpers have `*RawAsync` variants when callers need the
 complete `MxCommandReply`.
 
-For alarms, the client exposes `QueryActiveAlarmsAsync` (one-shot snapshot of
-the active alarms the gateway's central monitor currently holds),
-`StreamAlarmsAsync` (server-streaming feed of alarm-state-change messages
-keyed by the same monitor), and `AcknowledgeAlarmAsync` (ack by alarm
-reference, optional comment, ack target). All three accept a cancellation
-token and pass through the `MxGateway:Alarms` configuration on the
-server — when alarms are disabled, the gateway returns an empty list / empty
-stream rather than failing.
-
 `MxGatewaySession.CloseAsync` is explicit and idempotent. Repeated calls return
 the first `CloseSessionReply` instead of sending another close request.
 
@@ -126,17 +117,15 @@ reply.
 The test CLI supports deterministic JSON output for automation:
 
 ```powershell
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- version --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- open-session --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- register --session-id <id> --client-name mxgw-dotnet-cli --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- add-item --session-id <id> --server-handle 1 --item Area001.Pump001.Speed --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- advise --session-id <id> --server-handle 1 --item-handle 1 --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- write --session-id <id> --server-handle 1 --item-handle 1 --type int32 --value 123 --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- write2 --session-id <id> --server-handle 1 --item-handle 1 --type int32 --value 123 --timestamp 2026-01-01T00:00:00Z --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- stream-events --session-id <id> --max-events 1 --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- stream-alarms --filter-prefix Area001 --max-events 1 --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- acknowledge-alarm --reference "\\Galaxy\Area001.Pump001.PumpFault" --comment "ack from cli" --operator operator1 --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- smoke --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --item Area001.Pump001.Speed --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- version --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- open-session --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- register --session-id <id> --client-name mxgw-dotnet-cli --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- add-item --session-id <id> --server-handle 1 --item Area001.Pump001.Speed --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- advise --session-id <id> --server-handle 1 --item-handle 1 --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- write --session-id <id> --server-handle 1 --item-handle 1 --type int32 --value 123 --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- write2 --session-id <id> --server-handle 1 --item-handle 1 --type int32 --value 123 --timestamp 2026-01-01T00:00:00Z --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- stream-events --session-id <id> --max-events 1 --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- smoke --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --item Area001.Pump001.Speed --json
 ```
 
 `smoke` opens a session, registers a client, adds one item, advises it,
@@ -191,70 +180,9 @@ IReadOnlyList<GalaxyObject> pumps = await repository.DiscoverHierarchyAsync(
 The CLI exposes the same operations:
 
 ```powershell
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-test-connection --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-last-deploy --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-discover --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY
-```
-
-### Browsing lazily
-
-For UI trees or OPC UA bridges, use `BrowseChildrenAsync` to walk one level at a
-time instead of paging the full hierarchy. Pass an empty request for root objects;
-subsequent calls supply `ParentGobjectId`, `ParentTagName`, or
-`ParentContainedPath`. Each child's `ChildHasChildren[i]` tells you whether to
-draw an expand triangle. Filter fields match `DiscoverHierarchy`. See
-[Galaxy Repository](../../docs/GalaxyRepository.md#browsechildren) for full
-request and filter semantics.
-
-```csharp
-BrowseChildrenReply roots = await repository.BrowseChildrenAsync(
-    new BrowseChildrenRequest());
-
-for (int i = 0; i < roots.Children.Count; i++)
-{
-    GalaxyObject child = roots.Children[i];
-    bool hasChildren = roots.ChildHasChildren[i];
-    Console.WriteLine($"{child.TagName} expand={hasChildren}");
-}
-```
-
-#### High-level walker
-
-For UI trees, the client provides a `LazyBrowseNode` walker that handles
-sibling pagination and the `child_has_children` hint for you:
-
-```csharp
-await using GalaxyRepositoryClient repository = GalaxyRepositoryClient.Create(
-    new MxGatewayClientOptions { Endpoint = new Uri("http://localhost:5000"), ApiKey = apiKey });
-IReadOnlyList<LazyBrowseNode> roots = await repository.BrowseAsync();
-foreach (LazyBrowseNode root in roots)
-{
-    if (root.HasChildrenHint)
-    {
-        await root.ExpandAsync();
-    }
-    foreach (LazyBrowseNode child in root.Children)
-    {
-        Console.WriteLine($"{child.Object.TagName} ({(child.HasChildrenHint ? "has children" : "leaf")})");
-    }
-}
-```
-
-`ExpandAsync` is idempotent — calling it twice fires only one RPC,
-and is safe under concurrent callers. To refresh after a Galaxy redeploy, call
-`BrowseAsync` again from the root.
-
-The CLI counterpart is `galaxy-browse`. Without `--parent` it walks the root
-objects and eagerly expands `--depth` further levels into an indented tree; with
-`--parent <gobject-id>` it fetches exactly one level of children for that object
-(`--depth` is ignored there). Filter flags map onto `BrowseChildrenOptions`:
-`--category-ids` and `--template-contains` are comma-separated lists,
-`--tag-name-glob` / `--alarm-bearing-only` / `--historized-only` are scalar, and
-`--include-attributes` overrides the server default for attribute population.
-
-```powershell
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-browse --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --depth 1
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-browse --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --parent 42 --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- galaxy-test-connection --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- galaxy-last-deploy --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- galaxy-discover --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY
 ```
 
 ### Watching deploy events
@@ -289,28 +217,17 @@ await foreach (DeployEvent evt in repository.WatchDeployEventsAsync(
 The CLI counterpart streams events until Ctrl+C (or `--max-events`):
 
 ```powershell
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-watch --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-watch --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --last-seen-deploy-time 2026-04-28T14:30:00Z --json
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- galaxy-watch --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --max-events 5 --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- galaxy-watch --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- galaxy-watch --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --last-seen-deploy-time 2026-04-28T14:30:00Z --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- galaxy-watch --endpoint http://localhost:5000 --api-key-env MXGATEWAY_API_KEY --max-events 5 --json
 ```
 
 Use TLS options for a secured gateway:
 
 ```powershell
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- smoke --endpoint https://ZB.MOM.WW.MxGateway.example.local:5001 --tls --ca-file C:\certs\mxgateway-ca.pem --server-name ZB.MOM.WW.MxGateway.example.local --api-key-env MXGATEWAY_API_KEY --item Area001.Pump001.Speed --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- smoke --endpoint https://mxgateway.example.local:5001 --tls --ca-file C:\certs\mxgateway-ca.pem --server-name mxgateway.example.local --api-key-env MXGATEWAY_API_KEY --item Area001.Pump001.Speed --json
 ```
 
-### TLS trust
-
-The gateway can auto-generate its own self-signed certificate (it has no PKI), so
-the client is **lenient by default**: a TLS connection (`UseTls` / `--tls`) with
-no pinned CA accepts whatever certificate the gateway presents. To verify
-instead, pin a CA with `CaCertificatePath` / `--ca-file` (this path also enforces
-the certificate hostname/SAN match), or set `RequireCertificateValidation` to
-force OS/system-trust verification without pinning. Use `ServerNameOverride` /
-`--server-name` when the dialed host differs from the certificate SAN. See
-[Gateway Configuration](../../docs/GatewayConfiguration.md#automatic-self-signed-certificate).
-
 ## Integration Checks
 
 Run live checks only when a gateway and MXAccess-backed worker are available:
@@ -320,32 +237,9 @@ $env:MXGATEWAY_INTEGRATION = '1'
 $env:MXGATEWAY_ENDPOINT = 'http://localhost:5000'
 $env:MXGATEWAY_API_KEY = '<gateway-api-key>'
 $env:MXGATEWAY_TEST_ITEM = 'Area001.Pump001.Speed'
-dotnet run --project clients/dotnet/ZB.MOM.WW.MxGateway.Client.Cli -- smoke --endpoint $env:MXGATEWAY_ENDPOINT --api-key-env MXGATEWAY_API_KEY --item $env:MXGATEWAY_TEST_ITEM --json
+dotnet run --project clients/dotnet/MxGateway.Client.Cli -- smoke --endpoint $env:MXGATEWAY_ENDPOINT --api-key-env MXGATEWAY_API_KEY --item $env:MXGATEWAY_TEST_ITEM --json
 ```
 
-## Installing as a NuGet Package
-
-The client publishes to the internal Gitea NuGet feed at
-`https://gitea.dohertylan.com/api/packages/dohertj2/nuget/index.json`.
-
-Add the feed once:
-
-````bash
-dotnet nuget add source https://gitea.dohertylan.com/api/packages/dohertj2/nuget/index.json \
-    --name dohertj2-gitea \
-    --username <gitea-username> \
-    --password <gitea-token-or-password> \
-    --store-password-in-clear-text
-````
-
-Then add the package to your project:
-
-````bash
-dotnet add package ZB.MOM.WW.MxGateway.Client --version 0.1.1
-````
-
-The `ZB.MOM.WW.MxGateway.Contracts` package is pulled in transitively.
-
 ## Related Documentation
 
 - [Client Packaging](../../docs/ClientPackaging.md)

clients/dotnet/ZB.MOM.WW.MxGateway.Client.Tests/BrowseChildrenSmokeTests.cs

@@ -1,34 +0,0 @@
-using Grpc.Core;
-using Grpc.Net.Client;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
-
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
-
-/// <summary>
-/// Live smoke tests for the BrowseChildren RPC. Skipped by default; set
-/// MXGATEWAY_API_KEY and MXGATEWAY_ENDPOINT to run against a real gateway.
-/// </summary>
-public sealed class BrowseChildrenSmokeTests
-{
-    /// <summary>
-    /// Verifies that BrowseChildren returns a non-zero cache sequence and
-    /// a consistent children/child-has-children count from a live gateway.
-    /// </summary>
-    [Fact(Skip = "Set MXGATEWAY_API_KEY and MXGATEWAY_ENDPOINT to enable.")]
-    public async Task BrowseChildren_LiveGateway_ReturnsRootsWithCacheSequence()
-    {
-        string? apiKey = Environment.GetEnvironmentVariable("MXGATEWAY_API_KEY");
-        string endpoint = Environment.GetEnvironmentVariable("MXGATEWAY_ENDPOINT") ?? "http://localhost:5120";
-
-        Assert.False(string.IsNullOrEmpty(apiKey), "MXGATEWAY_API_KEY must be set.");
-
-        using GrpcChannel channel = GrpcChannel.ForAddress(endpoint);
-        GalaxyRepository.GalaxyRepositoryClient client = new(channel);
-
-        Metadata headers = new() { { "authorization", $"Bearer {apiKey}" } };
-        BrowseChildrenReply reply = await client.BrowseChildrenAsync(new BrowseChildrenRequest(), headers);
-
-        Assert.True(reply.CacheSequence > 0UL);
-        Assert.Equal(reply.Children.Count, reply.ChildHasChildren.Count);
-    }
-}

clients/dotnet/ZB.MOM.WW.MxGateway.Client.Tests/LazyBrowseNodeTests.cs

@@ -1,311 +0,0 @@
-using Grpc.Core;
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
-
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
-
-/// <summary>
-/// Tests for the <see cref="LazyBrowseNode"/> walker over the BrowseChildren RPC.
-/// </summary>
-public sealed class LazyBrowseNodeTests
-{
-    /// <summary>
-    /// Verifies that calling BrowseAsync with no parent returns the root nodes
-    /// from the first BrowseChildren reply and surfaces the per-child has-children hint.
-    /// </summary>
-    [Fact]
-    public async Task Browse_NoParent_ReturnsRoots()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(1, "Plant", isArea: true), BuildObject(2, "Other")],
-            childHasChildren: [true, false],
-            cacheSequence: 1));
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-
-        Assert.Equal(2, roots.Count);
-        Assert.Equal("Plant", roots[0].Object.TagName);
-        Assert.True(roots[0].HasChildrenHint);
-        Assert.False(roots[0].IsExpanded);
-        Assert.Equal("Other", roots[1].Object.TagName);
-        Assert.False(roots[1].HasChildrenHint);
-        Assert.False(roots[1].IsExpanded);
-    }
-
-    /// <summary>
-    /// Verifies that ExpandAsync populates Children and marks the node expanded after one RPC.
-    /// </summary>
-    [Fact]
-    public async Task Expand_PopulatesChildrenAndMarksExpanded()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(1, "Plant", isArea: true)],
-            childHasChildren: [true],
-            cacheSequence: 1));
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(10, "Line1")],
-            childHasChildren: [false],
-            cacheSequence: 1));
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-        await roots[0].ExpandAsync();
-
-        Assert.True(roots[0].IsExpanded);
-        Assert.Single(roots[0].Children);
-        Assert.Equal("Line1", roots[0].Children[0].Object.TagName);
-        Assert.Equal(2, transport.BrowseChildrenCalls.Count);
-    }
-
-    /// <summary>
-    /// Verifies that a second ExpandAsync call is a no-op and issues no additional RPC.
-    /// </summary>
-    [Fact]
-    public async Task Expand_CalledTwice_NoSecondRpc()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(1, "Plant", isArea: true)],
-            childHasChildren: [true],
-            cacheSequence: 1));
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(10, "Line1")],
-            childHasChildren: [false],
-            cacheSequence: 1));
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-        await roots[0].ExpandAsync();
-        await roots[0].ExpandAsync();
-
-        Assert.Equal(2, transport.BrowseChildrenCalls.Count);
-    }
-
-    /// <summary>
-    /// Verifies that an RPC failure (NotFound) during expand is wrapped in MxGatewayException.
-    /// </summary>
-    [Fact]
-    public async Task Expand_UnknownParent_ThrowsMxGatewayException()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(1, "Plant", isArea: true)],
-            childHasChildren: [true],
-            cacheSequence: 1));
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-
-        // Queue the failure for the upcoming ExpandAsync call so it consumes
-        // the exception on its first RPC rather than the BrowseAsync above.
-        transport.BrowseChildrenExceptions.Enqueue(
-            new MxGatewayException(
-                "Parent not found",
-                new RpcException(new Status(StatusCode.NotFound, "Parent not found"))));
-
-        await Assert.ThrowsAsync<MxGatewayException>(async () => await roots[0].ExpandAsync());
-        Assert.False(roots[0].IsExpanded);
-        Assert.Empty(roots[0].Children);
-    }
-
-    /// <summary>
-    /// Verifies that ExpandAsync drains multi-page sibling replies and forwards the page token.
-    /// </summary>
-    [Fact]
-    public async Task Expand_MultiPageSiblings_GathersAllPages()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        // Roots
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(7, "Plant", isArea: true)],
-            childHasChildren: [true],
-            cacheSequence: 1));
-        // First child page (2 children) with a next token
-        BrowseChildrenReply childPage1 = BuildReply(
-            children: [BuildObject(70, "ChildA"), BuildObject(71, "ChildB")],
-            childHasChildren: [false, false],
-            cacheSequence: 1);
-        childPage1.NextPageToken = "7:abc:2";
-        transport.BrowseChildrenReplies.Enqueue(childPage1);
-        // Second child page (1 child) with no next token
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(72, "ChildC")],
-            childHasChildren: [false],
-            cacheSequence: 1));
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-        await roots[0].ExpandAsync();
-
-        Assert.Equal(3, roots[0].Children.Count);
-        Assert.Equal(3, transport.BrowseChildrenCalls.Count);
-        Assert.Equal("7:abc:2", transport.BrowseChildrenCalls[2].Request.PageToken);
-    }
-
-    /// <summary>
-    /// Verifies that ten concurrent ExpandAsync calls issue exactly one RPC, not ten.
-    /// </summary>
-    [Fact]
-    public async Task Expand_CalledConcurrently_OnlyFiresOneRpc()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(1, "Plant", isArea: true)],
-            childHasChildren: [true],
-            cacheSequence: 7));
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(2, "Mixer_001")],
-            childHasChildren: [false],
-            cacheSequence: 7));
-
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-
-        // Fire ten concurrent expands of the same node.
-        Task[] tasks = Enumerable.Range(0, 10)
-            .Select(_ => roots[0].ExpandAsync())
-            .ToArray();
-        await Task.WhenAll(tasks);
-
-        Assert.True(roots[0].IsExpanded);
-        Assert.Single(roots[0].Children);
-        // 1 roots fetch + exactly 1 expand fetch = 2 total
-        Assert.Equal(2, transport.BrowseChildrenCalls.Count);
-    }
-
-    /// <summary>
-    /// Verifies that reading Children/IsExpanded concurrently with an in-flight ExpandAsync
-    /// never throws (no torn enumeration of a mid-append list) and, once IsExpanded flips to
-    /// true, the published Children snapshot is fully populated. Pins the safe-publication
-    /// contract on the lock-free readers (Client.Dotnet-025).
-    /// </summary>
-    [Fact]
-    public async Task Expand_ConcurrentReadOfChildren_NeverTearsAndPublishesAtomically()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(1, "Plant", isArea: true)],
-            childHasChildren: [true],
-            cacheSequence: 1));
-
-        // Multi-page child set so the expand loop spends meaningful time appending,
-        // widening the window for a concurrent reader to observe a torn list.
-        BrowseChildrenReply childPage1 = BuildReply(
-            children: [BuildObject(10, "A"), BuildObject(11, "B"), BuildObject(12, "C")],
-            childHasChildren: [false, false, false],
-            cacheSequence: 1);
-        childPage1.NextPageToken = "1:p:3";
-        transport.BrowseChildrenReplies.Enqueue(childPage1);
-        transport.BrowseChildrenReplies.Enqueue(BuildReply(
-            children: [BuildObject(13, "D"), BuildObject(14, "E")],
-            childHasChildren: [false, false],
-            cacheSequence: 1));
-
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-        IReadOnlyList<LazyBrowseNode> roots = await client.BrowseAsync();
-        LazyBrowseNode node = roots[0];
-
-        // Gate the child-page RPCs so the expand stays mid-flight while the reader spins.
-        using SemaphoreSlim release = new(0, 1);
-        bool firstChildCall = true;
-        transport.BrowseChildrenGate = async () =>
-        {
-            if (firstChildCall)
-            {
-                firstChildCall = false;
-                await release.WaitAsync().ConfigureAwait(false);
-            }
-        };
-
-        using CancellationTokenSource readerStop = new();
-        Exception? readerFailure = null;
-        Task reader = Task.Run(() =>
-        {
-            try
-            {
-                while (!readerStop.IsCancellationRequested)
-                {
-                    bool expanded = node.IsExpanded;
-
-                    // Enumerate the snapshot; a torn/mid-append list would throw here.
-                    int count = 0;
-                    foreach (LazyBrowseNode _ in node.Children)
-                    {
-                        count++;
-                    }
-
-                    // If the node reports expanded, the published snapshot must be complete.
-                    if (expanded)
-                    {
-                        Assert.Equal(5, count);
-                    }
-                }
-            }
-            catch (Exception ex)
-            {
-                readerFailure = ex;
-            }
-        });
-
-        Task expand = node.ExpandAsync();
-        // Let the reader spin against the empty pre-publication snapshot for a moment.
-        await Task.Delay(50);
-        release.Release();
-        await expand;
-
-        // Let the reader observe the post-publication state, then stop it.
-        await Task.Delay(50);
-        readerStop.Cancel();
-        await reader;
-
-        Assert.Null(readerFailure);
-        Assert.True(node.IsExpanded);
-        Assert.Equal(5, node.Children.Count);
-    }
-
-    /// <summary>
-    /// Verifies that BrowseChildrenOptions filter fields are forwarded to the BrowseChildren request.
-    /// </summary>
-    [Fact]
-    public async Task Browse_WithFilter_ForwardsToRequest()
-    {
-        FakeGalaxyRepositoryTransport transport = CreateTransport();
-        await using GalaxyRepositoryClient client = CreateClient(transport);
-
-        await client.BrowseAsync(new BrowseChildrenOptions
-        {
-            TagNameGlob = "Mixer*",
-            AlarmBearingOnly = true,
-        });
-
-        BrowseChildrenRequest request = Assert.Single(transport.BrowseChildrenCalls).Request;
-        Assert.Equal("Mixer*", request.TagNameGlob);
-        Assert.True(request.AlarmBearingOnly);
-    }
-
-    private static GalaxyObject BuildObject(int id, string tag, bool isArea = false)
-        => new() { GobjectId = id, TagName = tag, BrowseName = tag, IsArea = isArea };
-
-    private static BrowseChildrenReply BuildReply(
-        IReadOnlyList<GalaxyObject> children,
-        IReadOnlyList<bool> childHasChildren,
-        ulong cacheSequence)
-    {
-        BrowseChildrenReply reply = new() { TotalChildCount = children.Count, CacheSequence = cacheSequence };
-        reply.Children.AddRange(children);
-        reply.ChildHasChildren.AddRange(childHasChildren);
-        return reply;
-    }
-
-    private static GalaxyRepositoryClient CreateClient(FakeGalaxyRepositoryTransport transport)
-        => new(transport.Options, transport);
-
-    private static FakeGalaxyRepositoryTransport CreateTransport()
-        => new(new MxGatewayClientOptions
-        {
-            Endpoint = new Uri("http://localhost:5000"),
-            ApiKey = "test-api-key",
-        });
-}

clients/dotnet/ZB.MOM.WW.MxGateway.Client.Tests/MxGatewayClientTlsHandlerTests.cs

@@ -1,85 +0,0 @@
-using System.Net.Http;
-using System.Net.Security;
-using ZB.MOM.WW.MxGateway.Client;
-
-namespace ZB.MOM.WW.MxGateway.Client.Tests;
-
-public sealed class MxGatewayClientTlsHandlerTests
-{
-    /// <summary>
-    /// Verifies that when TLS is used with no pinned CA and RequireCertificateValidation is false (default),
-    /// the handler installs an accept-all callback so the gateway's self-signed cert is trusted.
-    /// The callback must return true regardless of chain errors.
-    /// </summary>
-    [Fact]
-    public void Handler_SkipsVerification_WhenTlsAndNoCaPinned()
-    {
-        MxGatewayClientOptions options = new()
-        {
-            Endpoint = new Uri("https://localhost:5120"),
-            ApiKey = "k",
-            UseTls = true,
-        };
-        using SocketsHttpHandler handler = MxGatewayClient.CreateHttpHandlerForTests(options);
-        Assert.NotNull(handler.SslOptions.RemoteCertificateValidationCallback);
-        Assert.True(handler.SslOptions.RemoteCertificateValidationCallback!(null!, null!, null, SslPolicyErrors.RemoteCertificateChainErrors));
-    }
-
-    /// <summary>
-    /// Verifies that when RequireCertificateValidation is true, the callback is left null
-    /// so the OS trust store performs validation.
-    /// </summary>
-    [Fact]
-    public void Handler_KeepsDefaultVerification_WhenRequireCertificateValidation()
-    {
-        MxGatewayClientOptions options = new()
-        {
-            Endpoint = new Uri("https://localhost:5120"),
-            ApiKey = "k",
-            UseTls = true,
-            RequireCertificateValidation = true,
-        };
-        using SocketsHttpHandler handler = MxGatewayClient.CreateHttpHandlerForTests(options);
-        Assert.Null(handler.SslOptions.RemoteCertificateValidationCallback);
-    }
-}
-
-public sealed class GalaxyRepositoryClientTlsHandlerTests
-{
-    /// <summary>
-    /// Verifies that when TLS is used with no pinned CA and RequireCertificateValidation is false (default),
-    /// the Galaxy client handler installs an accept-all callback so the gateway's self-signed cert is trusted.
-    /// The callback must return true regardless of chain errors.
-    /// </summary>
-    [Fact]
-    public void Handler_SkipsVerification_WhenTlsAndNoCaPinned()
-    {
-        MxGatewayClientOptions options = new()
-        {
-            Endpoint = new Uri("https://localhost:5120"),
-            ApiKey = "k",
-            UseTls = true,
-        };
-        using SocketsHttpHandler handler = GalaxyRepositoryClient.CreateHttpHandlerForTests(options);
-        Assert.NotNull(handler.SslOptions.RemoteCertificateValidationCallback);
-        Assert.True(handler.SslOptions.RemoteCertificateValidationCallback!(null!, null!, null, SslPolicyErrors.RemoteCertificateChainErrors));
-    }
-
-    /// <summary>
-    /// Verifies that when RequireCertificateValidation is true, the Galaxy client callback is left null
-    /// so the OS trust store performs validation.
-    /// </summary>
-    [Fact]
-    public void Handler_KeepsDefaultVerification_WhenRequireCertificateValidation()
-    {
-        MxGatewayClientOptions options = new()
-        {
-            Endpoint = new Uri("https://localhost:5120"),
-            ApiKey = "k",
-            UseTls = true,
-            RequireCertificateValidation = true,
-        };
-        using SocketsHttpHandler handler = GalaxyRepositoryClient.CreateHttpHandlerForTests(options);
-        Assert.Null(handler.SslOptions.RemoteCertificateValidationCallback);
-    }
-}

clients/dotnet/ZB.MOM.WW.MxGateway.Client.slnx

@@ -1,11 +0,0 @@
-<Solution>
-  <Configurations>
-    <Platform Name="Any CPU" />
-    <Platform Name="x64" />
-    <Platform Name="x86" />
-  </Configurations>
-  <Project Path="../../src/ZB.MOM.WW.MxGateway.Contracts/ZB.MOM.WW.MxGateway.Contracts.csproj" />
-  <Project Path="ZB.MOM.WW.MxGateway.Client.Cli/ZB.MOM.WW.MxGateway.Client.Cli.csproj" />
-  <Project Path="ZB.MOM.WW.MxGateway.Client.Tests/ZB.MOM.WW.MxGateway.Client.Tests.csproj" />
-  <Project Path="ZB.MOM.WW.MxGateway.Client/ZB.MOM.WW.MxGateway.Client.csproj" />
-</Solution>

clients/dotnet/ZB.MOM.WW.MxGateway.Client/BrowseChildrenOptions.cs

@@ -1,26 +0,0 @@
-namespace ZB.MOM.WW.MxGateway.Client;
-
-/// <summary>
-///     Filters and shape options for <see cref="GalaxyRepositoryClient.BrowseAsync(BrowseChildrenOptions, System.Threading.CancellationToken)"/>.
-///     Mirror of <see cref="DiscoverHierarchyOptions"/> for the lazy-browse path.
-/// </summary>
-public sealed class BrowseChildrenOptions
-{
-    /// <summary>Restrict to children whose Galaxy category is in this set.</summary>
-    public IReadOnlyList<int> CategoryIds { get; init; } = [];
-
-    /// <summary>Restrict to children whose template chain contains any of these tokens.</summary>
-    public IReadOnlyList<string> TemplateChainContains { get; init; } = [];
-
-    /// <summary>Optional glob-style filter on <c>tag_name</c>.</summary>
-    public string? TagNameGlob { get; init; }
-
-    /// <summary>Whether to populate each <c>GalaxyObject.Attributes</c>. Null leaves the server default.</summary>
-    public bool? IncludeAttributes { get; init; }
-
-    /// <summary>Restrict to children that bear at least one alarm attribute.</summary>
-    public bool AlarmBearingOnly { get; init; }
-
-    /// <summary>Restrict to children that have at least one historized attribute.</summary>
-    public bool HistorizedOnly { get; init; }
-}

clients/dotnet/ZB.MOM.WW.MxGateway.Client/DiscoverHierarchyOptions.cs

@@ -1,43 +0,0 @@
-namespace ZB.MOM.WW.MxGateway.Client;
-
-/// <summary>
-/// Filters and shape options for <see cref="GalaxyRepositoryClient.DiscoverHierarchyAsync(DiscoverHierarchyOptions, System.Threading.CancellationToken)"/>.
-/// </summary>
-/// <remarks>
-/// Hand-written ergonomic wrapper around the generated
-/// <c>DiscoverHierarchyRequest</c>: lets callers express a Galaxy-browse
-/// slice with .NET-friendly nullable scalars and collection initializers,
-/// without touching the protobuf message's <c>oneof root</c> directly.
-/// </remarks>
-public sealed class DiscoverHierarchyOptions
-{
-    /// <summary>Restrict to the subtree rooted at this Galaxy <c>gobject_id</c>.</summary>
-    public int? RootGobjectId { get; init; }
-
-    /// <summary>Restrict to the subtree rooted at the object with this tag name.</summary>
-    public string? RootTagName { get; init; }
-
-    /// <summary>Restrict to the subtree rooted at this <c>contained_name</c> path.</summary>
-    public string? RootContainedPath { get; init; }
-
-    /// <summary>Maximum traversal depth, measured from the chosen root.</summary>
-    public int? MaxDepth { get; init; }
-
-    /// <summary>Restrict to objects whose Galaxy category is in this set.</summary>
-    public IReadOnlyList<int> CategoryIds { get; init; } = [];
-
-    /// <summary>Restrict to objects whose template chain contains any of these tokens.</summary>
-    public IReadOnlyList<string> TemplateChainContains { get; init; } = [];
-
-    /// <summary>Optional glob-style filter on <c>tag_name</c>.</summary>
-    public string? TagNameGlob { get; init; }
-
-    /// <summary>Whether to populate each <c>GalaxyObject.Attributes</c>. Null leaves the server default.</summary>
-    public bool? IncludeAttributes { get; init; }
-
-    /// <summary>Restrict to objects that bear at least one alarm attribute.</summary>
-    public bool AlarmBearingOnly { get; init; }
-
-    /// <summary>Restrict to objects that have at least one historized attribute.</summary>
-    public bool HistorizedOnly { get; init; }
-}

clients/dotnet/ZB.MOM.WW.MxGateway.Client/LazyBrowseNode.cs

@@ -1,120 +0,0 @@
-using ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxy;
-
-namespace ZB.MOM.WW.MxGateway.Client;
-
-/// <summary>
-///     One node in a lazy-loaded Galaxy browse tree. Holds the underlying
-///     <see cref="GalaxyObject"/> and exposes <see cref="ExpandAsync"/> to fetch
-///     its direct children on demand. Expansion is one-shot: a second call is a
-///     no-op. Pagination of large sibling sets is handled internally.
-/// </summary>
-public sealed class LazyBrowseNode
-{
-    private readonly GalaxyRepositoryClient _client;
-    private readonly BrowseChildrenOptions _options;
-    private readonly SemaphoreSlim _expandLock = new(1, 1);
-
-    // Published once, under _expandLock, when expansion completes. Lock-free readers
-    // see either the empty pre-expansion snapshot or the fully-populated post-expansion
-    // snapshot — never a partially-filled list — because the snapshot is built in a local
-    // and handed off via Volatile.Write (release) paired with Volatile.Read (acquire).
-    private IReadOnlyList<LazyBrowseNode> _children = [];
-    private volatile bool _isExpanded;
-
-    internal LazyBrowseNode(
-        GalaxyRepositoryClient client,
-        GalaxyObject @object,
-        bool hasChildrenHint,
-        BrowseChildrenOptions options)
-    {
-        _client = client;
-        Object = @object;
-        HasChildrenHint = hasChildrenHint;
-        _options = options;
-    }
-
-    /// <summary>The underlying Galaxy object for this node.</summary>
-    public GalaxyObject Object { get; }
-
-    /// <summary>True when the server reports this node has at least one matching descendant.</summary>
-    public bool HasChildrenHint { get; }
-
-    /// <summary>Direct children loaded by <see cref="ExpandAsync"/>; empty until then.</summary>
-    public IReadOnlyList<LazyBrowseNode> Children => Volatile.Read(ref _children);
-
-    /// <summary>True after the first <see cref="ExpandAsync"/> call completes.</summary>
-    public bool IsExpanded => _isExpanded;
-
-    /// <summary>
-    ///     Fetches direct children from the gateway and populates <see cref="Children"/>.
-    ///     Idempotent: subsequent calls are no-ops.
-    /// </summary>
-    /// <remarks>
-    ///     Thread-safe: concurrent callers see exactly one fetch; subsequent callers
-    ///     (after the first completes) return immediately. <see cref="Children"/> and
-    ///     <see cref="IsExpanded"/> may be read concurrently with an in-flight
-    ///     <see cref="ExpandAsync"/> on another thread; the populated children are
-    ///     published as an immutable snapshot under a release barrier, so a reader that
-    ///     observes <see cref="IsExpanded"/> as <see langword="true"/> always sees the
-    ///     fully-populated <see cref="Children"/>, and a reader never enumerates a
-    ///     partially-built list.
-    /// </remarks>
-    /// <param name="cancellationToken">Token to observe for cancellation.</param>
-    public async Task ExpandAsync(CancellationToken cancellationToken = default)
-    {
-        if (_isExpanded)
-        {
-            return;
-        }
-
-        await _expandLock.WaitAsync(cancellationToken).ConfigureAwait(false);
-        try
-        {
-            if (_isExpanded)
-            {
-                return;
-            }
-
-            // Accumulate into a local list, never the published field, so a lock-free
-            // reader can never observe a half-populated collection or enumerate a list
-            // that is being mutated mid-append.
-            List<LazyBrowseNode> children = [];
-            string pageToken = string.Empty;
-            HashSet<string> seenPageTokens = new(StringComparer.Ordinal);
-            do
-            {
-                BrowseChildrenRequest request = GalaxyRepositoryClient.BuildBrowseChildrenRequest(_options);
-                request.ParentGobjectId = Object.GobjectId;
-                request.PageToken = pageToken;
-
-                BrowseChildrenReply reply = await _client
-                    .BrowseChildrenRawAsync(request, cancellationToken)
-                    .ConfigureAwait(false);
-
-                for (int i = 0; i < reply.Children.Count; i++)
-                {
-                    bool hint = i < reply.ChildHasChildren.Count && reply.ChildHasChildren[i];
-                    children.Add(new LazyBrowseNode(_client, reply.Children[i], hint, _options));
-                }
-
-                pageToken = reply.NextPageToken;
-                if (!string.IsNullOrWhiteSpace(pageToken) && !seenPageTokens.Add(pageToken))
-                {
-                    throw new MxGatewayException(
-                        $"Galaxy BrowseChildren returned a repeated page token '{pageToken}'.");
-                }
-            }
-            while (!string.IsNullOrWhiteSpace(pageToken));
-
-            // Publish the completed, immutable snapshot (release) before marking the node
-            // expanded (the volatile write below). A reader that observes IsExpanded == true
-            // is guaranteed to also observe the fully-populated Children.
-            Volatile.Write(ref _children, children);
-            _isExpanded = true;
-        }
-        finally
-        {
-            _expandLock.Release();
-        }
-    }
-}

clients/dotnet/ZB.MOM.WW.MxGateway.Client/Properties/AssemblyInfo.cs

@@ -1,3 +0,0 @@
-using System.Runtime.CompilerServices;
-
-[assembly: InternalsVisibleTo("ZB.MOM.WW.MxGateway.Client.Tests")]

clients/dotnet/ZB.MOM.WW.MxGateway.Client/ZB.MOM.WW.MxGateway.Client.csproj

@@ -1,41 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\src\ZB.MOM.WW.MxGateway.Contracts\ZB.MOM.WW.MxGateway.Contracts.csproj" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Grpc.Net.Client" Version="2.76.0" />
-    <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.7" />
-    <PackageReference Include="Polly.Core" Version="8.6.6" />
-  </ItemGroup>
-
-  <PropertyGroup>
-    <TargetFramework>net10.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-  </PropertyGroup>
-
-  <PropertyGroup>
-    <IsPackable>true</IsPackable>
-    <PackageId>ZB.MOM.WW.MxGateway.Client</PackageId>
-    <Description>.NET 10 gRPC client for the MxAccessGateway service. Provides typed wrappers, retry, and a lazy-browse walker over the Galaxy Repository hierarchy.</Description>
-    <PackageReadmeFile>README.md</PackageReadmeFile>
-    <!-- Only the shipped library generates XML docs (matching src/Contracts). The Cli and
-         Tests projects are not packable and do not document their public surface, so this
-         stays out of the shared Directory.Build.props to avoid CS1591 on test classes. -->
-    <GenerateDocumentationFile>true</GenerateDocumentationFile>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <None Include="..\README.md" Pack="true" PackagePath="\" />
-    <None Include="..\LICENSE.txt" Pack="true" PackagePath="\" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <AssemblyAttribute Include="System.Runtime.CompilerServices.InternalsVisibleTo">
-      <_Parameter1>ZB.MOM.WW.MxGateway.Client.Tests</_Parameter1>
-    </AssemblyAttribute>
-  </ItemGroup>
-
-</Project>

clients/go/GoClientDesign.md

@@ -104,23 +104,6 @@ Support:
 - `credentials.NewClientTLSFromFile`,
 - custom `tls.Config` for advanced callers.
 
-### Trust posture
-
-The gateway can serve a self-signed certificate it generates itself (it has no
-PKI). To make that usable, TLS is **lenient by default**: when `Plaintext` is
-`false` and no `CACertFile`/`TLSConfig`/`TransportCredentials` is supplied,
-`buildCredentials` dials with `tls.Config{InsecureSkipVerify: true}` (carrying
-`ServerNameOverride` as the SNI when set), so the gateway's self-signed
-certificate is accepted without verification.
-
-To verify the gateway instead:
-
-- set `CACertFile` to pin a CA (full verification against that root), or
-- set `RequireCertificateValidation: true` to verify against the OS/system trust
-  roots without pinning.
-
-Pinning a CA always wins over the lenient default.
-
 ## Streaming
 
 `Events(ctx)` should return a receive channel of:

clients/go/README.md

@@ -75,14 +75,6 @@ client, err := mxgateway.Dial(ctx, mxgateway.Options{
 })
 ```
 
-The gateway can auto-generate its own self-signed certificate (it has no PKI), so
-the client is **lenient by default**: a TLS connection (`Plaintext: false`) with
-no `CACertFile`/`TLSConfig` accepts whatever certificate the gateway presents
-(`InsecureSkipVerify`, with `ServerNameOverride` as the SNI when set). To verify
-instead, set `CACertFile` to pin a CA, or set `RequireCertificateValidation:
-true` to verify against the OS/system trust roots without pinning. See
-[Gateway Configuration](../../docs/GatewayConfiguration.md#automatic-self-signed-certificate).
-
 `Client.OpenSession` returns a `Session` with helpers for `Register`,
 `AddItem`, `AddItem2`, `Advise`, `Write`, `Events`, and `Close`. Prefer
 `SubscribeEvents` or `SubscribeEventsAfter` for long-running streams because the
@@ -92,13 +84,6 @@ goroutine cleanup. Raw protobuf messages remain available through the
 `errors.As` for `GatewayError`, `CommandError`, and `MxAccessError`; command
 errors preserve the raw reply.
 
-For alarms, the package exposes `Client.QueryActiveAlarms` for one-shot
-snapshots, `Client.StreamAlarms` for the server-streaming feed, and
-`Client.AcknowledgeAlarm` to ack an alarm by full reference. The streaming
-call returns a `StreamAlarmsClient`; cancel its context to terminate the
-stream. All three pass straight through to the gateway's central alarm
-monitor.
-
 ## Galaxy Repository browse
 
 The `GalaxyRepository` service (proto package `galaxy_repository.v1`) is a
@@ -129,68 +114,6 @@ reports `present=false` (no deploy recorded). `DiscoverHierarchy` returns
 the generated `*GalaxyObject` slice with each object's dynamic attributes
 populated for direct contract access.
 
-### Browsing lazily
-
-For UI trees or OPC UA bridges, use `BrowseChildren` to walk one level at a
-time instead of loading the full hierarchy. Pass an empty request for root
-objects; subsequent calls set `ParentGobjectId`, `ParentTagName`, or
-`ParentContainedPath`. Filter fields match `DiscoverHierarchy`. Each response
-pairs `Children` with `ChildHasChildren` so you know which nodes to expand. See
-[Galaxy Repository](../../docs/GalaxyRepository.md#browsechildren) for full
-request and filter semantics.
-
-```go
-import pb "gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/internal/generated/galaxy_repository/v1"
-
-reply, err := galaxy.BrowseChildren(ctx, &pb.BrowseChildrenRequest{})
-if err != nil {
-    return err
-}
-for i, child := range reply.GetChildren() {
-    fmt.Printf("%s expand=%v\n", child.GetTagName(), reply.GetChildHasChildren()[i])
-}
-```
-
-#### High-level walker
-
-For UI trees, the client provides a `LazyBrowseNode` walker that handles
-sibling pagination and the `child_has_children` hint for you:
-
-```go
-galaxy, err := mxgateway.DialGalaxy(ctx, mxgateway.Options{
-    Endpoint:  "localhost:5000",
-    APIKey:    os.Getenv("MXGATEWAY_API_KEY"),
-    Plaintext: true,
-})
-if err != nil {
-    log.Fatal(err)
-}
-defer galaxy.Close()
-
-roots, err := galaxy.Browse(ctx, nil)
-if err != nil {
-    log.Fatal(err)
-}
-for _, root := range roots {
-    if root.HasChildrenHint() {
-        if err := root.Expand(ctx); err != nil {
-            log.Fatal(err)
-        }
-    }
-    for _, child := range root.Children() {
-        kind := "leaf"
-        if child.HasChildrenHint() {
-            kind = "has children"
-        }
-        fmt.Printf("%s (%s)\n", child.Object().GetTagName(), kind)
-    }
-}
-```
-
-`Expand` is idempotent — calling it twice fires only one RPC,
-and is safe under concurrent callers. To refresh after a Galaxy redeploy, call
-`Browse` again from the root.
-
 ### Watching deploy events
 
 `WatchDeployEvents` opens a server-streaming subscription. The server emits a
@@ -283,41 +206,6 @@ $env:MXGATEWAY_TEST_ITEM = 'Area001.Tag.Value'
 go run ./cmd/mxgw-go smoke -endpoint $env:MXGATEWAY_ENDPOINT -plaintext -api-key-env MXGATEWAY_API_KEY -item $env:MXGATEWAY_TEST_ITEM -json
 ```
 
-## Installing the Go client
-
-The module is resolved directly from the git repo — no package registry:
-
-````bash
-go get gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go@v0.1.1
-````
-
-Then import:
-
-````go
-import "gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/mxgateway"
-````
-
-If your build environment cannot reach `gitea.dohertylan.com` directly,
-configure `GOPROXY` to point at an internal proxy that fronts the Gitea
-repo, or set `GOPRIVATE=gitea.dohertylan.com/*` to fetch the module
-straight from the VCS — this both bypasses the public module proxy and
-disables checksum-database (`sum.golang.org`) verification for that path.
-Add `GOINSECURE=gitea.dohertylan.com/*` if the host serves the module over
-plain HTTP rather than HTTPS.
-
-## Releasing a new version
-
-Go modules in monorepo subdirectories use prefixed tags. To tag a release
-from this repo:
-
-````bash
-pwsh scripts/tag-go-module.ps1 -Version v0.1.1 -Push
-````
-
-The script validates semver, refuses to tag with uncommitted tracked
-changes, creates an annotated tag `clients/go/v0.1.1`, and (with `-Push`)
-pushes it to origin.
-
 ## Related Documentation
 
 - [Client Packaging](../../docs/ClientPackaging.md)

clients/go/cmd/mxgw-go/main.go

@@ -6,7 +6,6 @@
 package main
 
 import (
-	"bufio"
 	"context"
 	"encoding/json"
 	"errors"
@@ -15,7 +14,6 @@ import (
 	"io"
 	"os"
 	"os/signal"
-	"sort"
 	"strconv"
 	"strings"
 	"syscall"
@@ -91,26 +89,10 @@ func runWithIO(ctx context.Context, args []string, stdout, stderr io.Writer) err
 		return runSubscribeBulk(ctx, args[1:], stdout, stderr)
 	case "unsubscribe-bulk":
 		return runUnsubscribeBulk(ctx, args[1:], stdout, stderr)
-	case "read-bulk":
-		return runReadBulk(ctx, args[1:], stdout, stderr)
-	case "write-bulk":
-		return runWriteBulk(ctx, args[1:], stdout, stderr)
-	case "write2-bulk":
-		return runWrite2Bulk(ctx, args[1:], stdout, stderr)
-	case "write-secured-bulk":
-		return runWriteSecuredBulk(ctx, args[1:], stdout, stderr)
-	case "write-secured2-bulk":
-		return runWriteSecured2Bulk(ctx, args[1:], stdout, stderr)
-	case "bench-read-bulk":
-		return runBenchReadBulk(ctx, args[1:], stdout, stderr)
 	case "write":
 		return runWrite(ctx, args[1:], stdout, stderr)
 	case "stream-events":
 		return runStreamEvents(ctx, args[1:], stdout, stderr)
-	case "stream-alarms":
-		return runStreamAlarms(ctx, args[1:], stdout, stderr)
-	case "acknowledge-alarm":
-		return runAcknowledgeAlarm(ctx, args[1:], stdout, stderr)
 	case "smoke":
 		return runSmoke(ctx, args[1:], stdout, stderr)
 	case "galaxy-test-connection":
@@ -121,12 +103,6 @@ func runWithIO(ctx context.Context, args []string, stdout, stderr io.Writer) err
 		return runGalaxyDiscover(ctx, args[1:], stdout, stderr)
 	case "galaxy-watch":
 		return runGalaxyWatch(ctx, args[1:], stdout, stderr)
-	case "galaxy-browse":
-		return runGalaxyBrowse(ctx, args[1:], stdout, stderr)
-	case "ping":
-		return runPing(ctx, args[1:], stdout, stderr)
-	case "batch":
-		return runBatch(ctx, os.Stdin, stdout, stderr)
 	default:
 		writeUsage(stderr)
 		return fmt.Errorf("unknown command %q", args[0])
@@ -232,52 +208,6 @@ func runCloseSession(ctx context.Context, args []string, stdout, stderr io.Write
 	return nil
 }
 
-func runPing(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	flags := flag.NewFlagSet("ping", flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	sessionID := flags.String("session-id", "", "gateway session id")
-	message := flags.String("message", "ping", "ping payload message")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-	if *sessionID == "" {
-		return errors.New("session-id is required")
-	}
-
-	client, options, err := dialForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	session := mxgateway.NewSessionForID(client, *sessionID)
-	reply, err := session.PingRaw(ctx, *message)
-	if err != nil {
-		return err
-	}
-	if *jsonOutput {
-		return writeJSON(stdout, commandReplyOutput{
-			Command: "ping",
-			Options: options,
-			Reply:   mustMarshalProto(reply),
-		})
-	}
-	// DiagnosticMessage carries the echoed ping text set by the gateway.
-	// Fall back to the kind string when the gateway returns an empty message
-	// (forward-compat guard for future gateway versions). writeCommandOutput
-	// is not reused here because it would print the opaque Kind enum rather
-	// than the human-readable echo.
-	echo := reply.GetDiagnosticMessage()
-	if echo == "" {
-		echo = reply.GetKind().String()
-	}
-	fmt.Fprintln(stdout, echo)
-	return nil
-}
-
 func runRegister(ctx context.Context, args []string, stdout, stderr io.Writer) error {
 	flags := flag.NewFlagSet("register", flag.ContinueOnError)
 	flags.SetOutput(stderr)
@@ -407,378 +337,11 @@ func runUnsubscribeBulk(ctx context.Context, args []string, stdout, stderr io.Wr
 	}
 	defer client.Close()
 
-	handles, err := parseInt32List(*itemHandles)
-	if err != nil {
-		return err
-	}
-
 	session := mxgateway.NewSessionForID(client, *sessionID)
-	results, err := session.UnsubscribeBulk(ctx, int32(*serverHandle), handles)
+	results, err := session.UnsubscribeBulk(ctx, int32(*serverHandle), parseInt32List(*itemHandles))
 	return writeBulkOutput(stdout, *jsonOutput, "unsubscribe-bulk", options, results, err)
 }
 
-func runReadBulk(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	flags := flag.NewFlagSet("read-bulk", flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	sessionID := flags.String("session-id", "", "gateway session id")
-	serverHandle := flags.Int("server-handle", 0, "MXAccess server handle")
-	items := flags.String("items", "", "comma-separated tag addresses")
-	timeoutMs := flags.Int("timeout-ms", 0, "per-tag snapshot timeout in milliseconds (0 = worker default)")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-	if *sessionID == "" || *items == "" {
-		return errors.New("session-id and items are required")
-	}
-
-	client, options, err := dialForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	session := mxgateway.NewSessionForID(client, *sessionID)
-	results, err := session.ReadBulk(ctx, int32(*serverHandle), parseStringList(*items), time.Duration(*timeoutMs)*time.Millisecond)
-	return writeReadBulkOutput(stdout, *jsonOutput, "read-bulk", options, results, err)
-}
-
-func runWriteBulk(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	return runWriteBulkVariant(ctx, args, stdout, stderr, "write-bulk", false)
-}
-
-func runWrite2Bulk(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	return runWriteBulkVariant(ctx, args, stdout, stderr, "write2-bulk", true)
-}
-
-func runWriteSecuredBulk(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	return runWriteBulkVariant(ctx, args, stdout, stderr, "write-secured-bulk", false)
-}
-
-func runWriteSecured2Bulk(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	return runWriteBulkVariant(ctx, args, stdout, stderr, "write-secured2-bulk", true)
-}
-
-// runWriteBulkVariant shares the flag-parsing + entry-build skeleton across
-// the four bulk-write families. The variant is derived from command alone;
-// withTimestamp adds a --timestamp-value flag. To keep wrong-variant flags
-// from silently no-op'ing, secured-only flags (-current-user-id /
-// -verifier-user-id) are only registered for the secured variants, and
-// -user-id only for the non-secured Write/Write2 variants — a wrong-variant
-// flag then surfaces as a clean "flag provided but not defined" error.
-func runWriteBulkVariant(ctx context.Context, args []string, stdout, stderr io.Writer, command string, withTimestamp bool) error {
-	secured := command == "write-secured-bulk" || command == "write-secured2-bulk"
-
-	flags := flag.NewFlagSet(command, flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	sessionID := flags.String("session-id", "", "gateway session id")
-	serverHandle := flags.Int("server-handle", 0, "MXAccess server handle")
-	itemHandles := flags.String("item-handles", "", "comma-separated item handles")
-	valueType := flags.String("type", "string", "value type: bool, int32, int64, float, double, string")
-	values := flags.String("values", "", "comma-separated values (one per item handle)")
-	var (
-		userID         *int
-		currentUserID  *int
-		verifierUserID *int
-	)
-	if secured {
-		currentUserID = flags.Int("current-user-id", 0, "MXAccess current user id (Secured variants)")
-		verifierUserID = flags.Int("verifier-user-id", 0, "MXAccess verifier user id (Secured variants)")
-	} else {
-		userID = flags.Int("user-id", 0, "MXAccess user id (Write/Write2 variants)")
-	}
-	timestampValue := flags.String("timestamp-value", "", "RFC 3339 timestamp shared across all entries (Write2/WriteSecured2 variants)")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-	if *sessionID == "" || *itemHandles == "" || *values == "" {
-		return errors.New("session-id, item-handles, and values are required")
-	}
-
-	handles, err := parseInt32List(*itemHandles)
-	if err != nil {
-		return err
-	}
-	valueTexts := parseStringList(*values)
-	if len(handles) != len(valueTexts) {
-		return fmt.Errorf("item-handles count (%d) does not match values count (%d)", len(handles), len(valueTexts))
-	}
-
-	parsedValues := make([]*mxgateway.MxValue, len(handles))
-	for i, text := range valueTexts {
-		v, err := parseValue(*valueType, text)
-		if err != nil {
-			return fmt.Errorf("entry %d: %w", i, err)
-		}
-		parsedValues[i] = v
-	}
-
-	var tsValue *mxgateway.MxValue
-	if withTimestamp {
-		if *timestampValue == "" {
-			return errors.New("timestamp-value is required for write2/write-secured2 bulk variants")
-		}
-		parsed, err := parseRfc3339Timestamp(*timestampValue)
-		if err != nil {
-			return err
-		}
-		tsValue = parsed
-	}
-
-	client, options, err := dialForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	session := mxgateway.NewSessionForID(client, *sessionID)
-
-	var results []*mxgateway.BulkWriteResult
-	switch command {
-	case "write-bulk":
-		entries := make([]*mxgateway.WriteBulkEntry, len(handles))
-		for i := range handles {
-			entries[i] = &mxgateway.WriteBulkEntry{ItemHandle: handles[i], Value: parsedValues[i], UserId: int32(*userID)}
-		}
-		results, err = session.WriteBulk(ctx, int32(*serverHandle), entries)
-	case "write2-bulk":
-		entries := make([]*mxgateway.Write2BulkEntry, len(handles))
-		for i := range handles {
-			entries[i] = &mxgateway.Write2BulkEntry{ItemHandle: handles[i], Value: parsedValues[i], TimestampValue: tsValue, UserId: int32(*userID)}
-		}
-		results, err = session.Write2Bulk(ctx, int32(*serverHandle), entries)
-	case "write-secured-bulk":
-		entries := make([]*mxgateway.WriteSecuredBulkEntry, len(handles))
-		for i := range handles {
-			entries[i] = &mxgateway.WriteSecuredBulkEntry{
-				ItemHandle:     handles[i],
-				Value:          parsedValues[i],
-				CurrentUserId:  int32(*currentUserID),
-				VerifierUserId: int32(*verifierUserID),
-			}
-		}
-		results, err = session.WriteSecuredBulk(ctx, int32(*serverHandle), entries)
-	case "write-secured2-bulk":
-		entries := make([]*mxgateway.WriteSecured2BulkEntry, len(handles))
-		for i := range handles {
-			entries[i] = &mxgateway.WriteSecured2BulkEntry{
-				ItemHandle:     handles[i],
-				Value:          parsedValues[i],
-				TimestampValue: tsValue,
-				CurrentUserId:  int32(*currentUserID),
-				VerifierUserId: int32(*verifierUserID),
-			}
-		}
-		results, err = session.WriteSecured2Bulk(ctx, int32(*serverHandle), entries)
-	default:
-		return fmt.Errorf("unsupported bulk write command %q", command)
-	}
-	return writeWriteBulkOutput(stdout, *jsonOutput, command, options, results, err)
-}
-
-// parseRfc3339Timestamp parses an RFC 3339 timestamp and returns the
-// MxValue protobuf representation used for the timestamped write families.
-func parseRfc3339Timestamp(text string) (*mxgateway.MxValue, error) {
-	t, err := time.Parse(time.RFC3339Nano, text)
-	if err != nil {
-		return nil, fmt.Errorf("invalid RFC 3339 timestamp %q: %w", text, err)
-	}
-	return mxgateway.TimestampValue(t), nil
-}
-
-// runBenchReadBulk drives the cross-language ReadBulk stress benchmark from Go:
-// opens its own session, subscribes to bulk-size tags so the worker value cache
-// populates from real OnDataChange events, runs ReadBulk in a tight loop for
-// duration-seconds with per-call timing, and emits the shared JSON schema the
-// scripts/bench-read-bulk.ps1 driver collates across all five clients.
-func runBenchReadBulk(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	flags := flag.NewFlagSet("bench-read-bulk", flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	clientName := flags.String("client-name", "mxgw-go-bench", "session client name")
-	durationSeconds := flags.Int("duration-seconds", 30, "steady-state measurement window in seconds")
-	warmupSeconds := flags.Int("warmup-seconds", 3, "warm-up window before measurement, in seconds")
-	bulkSize := flags.Int("bulk-size", 6, "tags per ReadBulk call")
-	tagStart := flags.Int("tag-start", 1, "first machine number")
-	tagPrefix := flags.String("tag-prefix", "TestMachine_", "tag prefix (machine number appended as %03d)")
-	tagAttribute := flags.String("tag-attribute", "TestChangingInt", "attribute appended to each tag prefix")
-	timeoutMs := flags.Int("timeout-ms", 1500, "per-tag snapshot timeout in milliseconds")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-	if *bulkSize < 1 {
-		return errors.New("bulk-size must be positive")
-	}
-	if *durationSeconds < 1 {
-		return errors.New("duration-seconds must be positive")
-	}
-
-	tags := make([]string, *bulkSize)
-	for i := 0; i < *bulkSize; i++ {
-		tags[i] = fmt.Sprintf("%s%03d.%s", *tagPrefix, *tagStart+i, *tagAttribute)
-	}
-
-	client, options, err := dialForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	session, err := client.OpenSession(ctx, mxgateway.OpenSessionOptions{ClientSessionName: *clientName})
-	if err != nil {
-		return err
-	}
-	defer func() {
-		_, _ = session.Close(context.Background())
-	}()
-
-	serverHandle, err := session.Register(ctx, *clientName)
-	if err != nil {
-		return err
-	}
-
-	subscribeResults, err := session.SubscribeBulk(ctx, serverHandle, tags)
-	if err != nil {
-		return err
-	}
-	itemHandles := make([]int32, 0, len(subscribeResults))
-	for _, result := range subscribeResults {
-		if result.GetWasSuccessful() {
-			itemHandles = append(itemHandles, result.GetItemHandle())
-		}
-	}
-	defer func() {
-		if len(itemHandles) > 0 {
-			_, _ = session.UnsubscribeBulk(context.Background(), serverHandle, itemHandles)
-		}
-	}()
-
-	// Warm-up: drive identical calls so any first-call JIT / connection-pool
-	// setup is amortised before the measurement window opens. The ctx.Err()
-	// guard short-circuits on Ctrl+C / parent-cancel instead of spinning
-	// failing ReadBulk calls until the wall-clock deadline elapses.
-	warmupDeadline := time.Now().Add(time.Duration(*warmupSeconds) * time.Second)
-	timeout := time.Duration(*timeoutMs) * time.Millisecond
-	for time.Now().Before(warmupDeadline) && ctx.Err() == nil {
-		_, _ = session.ReadBulk(ctx, serverHandle, tags, timeout)
-	}
-
-	// Steady state: per-call latency captured via time.Now() deltas.
-	latenciesMs := make([]float64, 0, 65536)
-	var totalReadResults int64
-	var cachedReadResults int64
-	var successfulCalls, failedCalls int
-	steadyStart := time.Now()
-	steadyDeadline := steadyStart.Add(time.Duration(*durationSeconds) * time.Second)
-
-	for time.Now().Before(steadyDeadline) && ctx.Err() == nil {
-		callStart := time.Now()
-		results, err := session.ReadBulk(ctx, serverHandle, tags, timeout)
-		elapsed := time.Since(callStart)
-		latenciesMs = append(latenciesMs, float64(elapsed.Nanoseconds())/1e6)
-		if err != nil {
-			failedCalls++
-			continue
-		}
-		successfulCalls++
-		for _, r := range results {
-			totalReadResults++
-			if r.GetWasCached() {
-				cachedReadResults++
-			}
-		}
-	}
-	steadyElapsed := time.Since(steadyStart)
-	totalCalls := successfulCalls + failedCalls
-
-	callsPerSecond := 0.0
-	if steadyElapsed.Seconds() > 0 {
-		callsPerSecond = float64(totalCalls) / steadyElapsed.Seconds()
-	}
-
-	stats := map[string]any{
-		"language":          "go",
-		"command":           "bench-read-bulk",
-		"endpoint":          options.Endpoint,
-		"clientName":        *clientName,
-		"bulkSize":          *bulkSize,
-		"durationSeconds":   *durationSeconds,
-		"warmupSeconds":     *warmupSeconds,
-		"durationMs":        steadyElapsed.Milliseconds(),
-		"tags":              tags,
-		"totalCalls":        totalCalls,
-		"successfulCalls":   successfulCalls,
-		"failedCalls":       failedCalls,
-		"totalReadResults":  totalReadResults,
-		"cachedReadResults": cachedReadResults,
-		"callsPerSecond":    roundTo(callsPerSecond, 2),
-		"latencyMs":         percentileSummary(latenciesMs),
-	}
-	if *jsonOutput {
-		return writeJSON(stdout, stats)
-	}
-	fmt.Fprintln(stdout, callsPerSecond)
-	return nil
-}
-
-// percentileSummary returns the same { p50, p95, p99, max, mean } shape every
-// language bench emits, rounded to 3 decimal places so the PowerShell driver
-// sees one schema across all five clients.
-func percentileSummary(sample []float64) map[string]float64 {
-	if len(sample) == 0 {
-		return map[string]float64{"p50": 0, "p95": 0, "p99": 0, "max": 0, "mean": 0}
-	}
-	sorted := append([]float64(nil), sample...)
-	sort.Float64s(sorted)
-	mean := 0.0
-	maxValue := sorted[len(sorted)-1]
-	for _, v := range sample {
-		mean += v
-	}
-	mean /= float64(len(sample))
-	return map[string]float64{
-		"p50":  roundTo(percentile(sorted, 0.50), 3),
-		"p95":  roundTo(percentile(sorted, 0.95), 3),
-		"p99":  roundTo(percentile(sorted, 0.99), 3),
-		"max":  roundTo(maxValue, 3),
-		"mean": roundTo(mean, 3),
-	}
-}
-
-// percentile uses nearest-rank with linear interpolation; matches the .NET
-// implementation so cross-language comparisons are apples-to-apples.
-func percentile(sorted []float64, quantile float64) float64 {
-	if len(sorted) == 0 {
-		return 0
-	}
-	if len(sorted) == 1 {
-		return sorted[0]
-	}
-	rank := quantile * float64(len(sorted)-1)
-	lower := int(rank)
-	upper := lower + 1
-	if upper >= len(sorted) {
-		return sorted[lower]
-	}
-	fraction := rank - float64(lower)
-	return sorted[lower] + (sorted[upper]-sorted[lower])*fraction
-}
-
-func roundTo(value float64, digits int) float64 {
-	shift := 1.0
-	for i := 0; i < digits; i++ {
-		shift *= 10
-	}
-	return float64(int64(value*shift+0.5)) / shift
-}
-
 func runWrite(ctx context.Context, args []string, stdout, stderr io.Writer) error {
 	flags := flag.NewFlagSet("write", flag.ContinueOnError)
 	flags.SetOutput(stderr)
@@ -865,119 +428,6 @@ func runStreamEvents(ctx context.Context, args []string, stdout, stderr io.Write
 	return nil
 }
 
-func runStreamAlarms(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	flags := flag.NewFlagSet("stream-alarms", flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	filterPrefix := flags.String("filter-prefix", "", "alarm-reference prefix scoping the feed; empty means unscoped")
-	limit := flags.Int("limit", 0, "maximum feed messages to read; 0 means unbounded")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-
-	client, _, err := dialForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	// Mirror runStreamEvents so Ctrl+C on a long-running stream-alarms command
-	// cancels the gRPC stream cleanly (the gateway sees codes.Canceled rather
-	// than a torn TCP connection) and the deferred client.Close() actually runs.
-	signalCtx, stopSignals := signal.NotifyContext(ctx, os.Interrupt, syscall.SIGTERM)
-	defer stopSignals()
-
-	streamCtx, cancelStream := context.WithCancel(signalCtx)
-	defer cancelStream()
-	stream, err := client.StreamAlarms(streamCtx, &mxgateway.StreamAlarmsRequest{AlarmFilterPrefix: *filterPrefix})
-	if err != nil {
-		return err
-	}
-
-	count := 0
-	for {
-		message, err := stream.Recv()
-		if errors.Is(err, io.EOF) {
-			return nil
-		}
-		if err != nil {
-			return err
-		}
-		if *jsonOutput {
-			fmt.Fprintln(stdout, string(mustMarshalProto(message)))
-		} else {
-			fmt.Fprintln(stdout, formatAlarmFeedMessage(message))
-		}
-		count++
-		if *limit > 0 && count >= *limit {
-			cancelStream()
-			return nil
-		}
-	}
-}
-
-// formatAlarmFeedMessage renders one AlarmFeedMessage in the CLI's plain-text
-// output style, distinguishing the active-alarm snapshot, snapshot-complete
-// sentinel, and transition cases of the message's payload oneof.
-func formatAlarmFeedMessage(message *mxgateway.AlarmFeedMessage) string {
-	switch {
-	case message.GetActiveAlarm() != nil:
-		alarm := message.GetActiveAlarm()
-		return fmt.Sprintf("active-alarm %s state=%s severity=%d", alarm.GetAlarmFullReference(), alarm.GetCurrentState(), alarm.GetSeverity())
-	case message.GetSnapshotComplete():
-		return "snapshot-complete"
-	case message.GetTransition() != nil:
-		transition := message.GetTransition()
-		return fmt.Sprintf("transition %s kind=%s severity=%d", transition.GetAlarmFullReference(), transition.GetTransitionKind(), transition.GetSeverity())
-	default:
-		return "unknown"
-	}
-}
-
-func runAcknowledgeAlarm(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	flags := flag.NewFlagSet("acknowledge-alarm", flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	reference := flags.String("reference", "", "full alarm reference to acknowledge")
-	comment := flags.String("comment", "", "operator acknowledge comment")
-	operator := flags.String("operator", "", "operator user performing the acknowledge")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-	if *reference == "" {
-		return errors.New("reference is required")
-	}
-
-	client, options, err := dialForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	reply, err := client.AcknowledgeAlarm(ctx, &mxgateway.AcknowledgeAlarmRequest{
-		AlarmFullReference: *reference,
-		Comment:            *comment,
-		OperatorUser:       *operator,
-	})
-	if err != nil {
-		return err
-	}
-	if *jsonOutput {
-		return writeJSON(stdout, commandReplyOutput{
-			Command: "acknowledge-alarm",
-			Options: options,
-			Reply:   mustMarshalProto(reply),
-		})
-	}
-
-	fmt.Fprintln(stdout, reply.GetHresult())
-	return nil
-}
-
 func runSmoke(ctx context.Context, args []string, stdout, stderr io.Writer) error {
 	flags := flag.NewFlagSet("smoke", flag.ContinueOnError)
 	flags.SetOutput(stderr)
@@ -1064,7 +514,7 @@ func parseStringList(value string) []string {
 	return items
 }
 
-func parseInt32List(value string) ([]int32, error) {
+func parseInt32List(value string) []int32 {
 	parts := strings.Split(value, ",")
 	items := make([]int32, 0, len(parts))
 	for _, part := range parts {
@@ -1074,11 +524,11 @@ func parseInt32List(value string) ([]int32, error) {
 		}
 		parsed, err := strconv.ParseInt(item, 10, 32)
 		if err != nil {
-			return nil, fmt.Errorf("invalid item handle %q: %w", item, err)
+			panic(err)
 		}
 		items = append(items, int32(parsed))
 	}
-	return items, nil
+	return items
 }
 
 func bindCommonFlags(flags *flag.FlagSet) *commonOptions {
@@ -1197,36 +647,6 @@ func writeBulkOutput(stdout io.Writer, jsonOutput bool, command string, options
 	return nil
 }
 
-func writeWriteBulkOutput(stdout io.Writer, jsonOutput bool, command string, options commonOptions, results []*mxgateway.BulkWriteResult, err error) error {
-	if err != nil {
-		return err
-	}
-	if jsonOutput {
-		return writeJSON(stdout, map[string]any{
-			"command": command,
-			"options": options,
-			"results": results,
-		})
-	}
-	fmt.Fprintln(stdout, len(results))
-	return nil
-}
-
-func writeReadBulkOutput(stdout io.Writer, jsonOutput bool, command string, options commonOptions, results []*mxgateway.BulkReadResult, err error) error {
-	if err != nil {
-		return err
-	}
-	if jsonOutput {
-		return writeJSON(stdout, map[string]any{
-			"command": command,
-			"options": options,
-			"results": results,
-		})
-	}
-	fmt.Fprintln(stdout, len(results))
-	return nil
-}
-
 func writeJSON(writer io.Writer, value any) error {
 	encoder := json.NewEncoder(writer)
 	encoder.SetIndent("", "  ")
@@ -1246,67 +666,7 @@ type protojsonMessage interface {
 }
 
 func writeUsage(writer io.Writer) {
-	fmt.Fprintln(writer, "usage: mxgw-go <version|open-session|close-session|ping|register|add-item|advise|subscribe-bulk|unsubscribe-bulk|read-bulk|write-bulk|write2-bulk|write-secured-bulk|write-secured2-bulk|bench-read-bulk|write|stream-events|stream-alarms|acknowledge-alarm|smoke|galaxy-test-connection|galaxy-last-deploy|galaxy-discover|galaxy-watch|galaxy-browse|batch>")
-}
-
-// batchEOR is the end-of-result sentinel emitted to stdout after every command
-// in batch mode, regardless of success or failure.
-const batchEOR = "__MXGW_BATCH_EOR__"
-
-// runBatch reads one command line at a time from in, dispatches each via the
-// normal runWithIO routing, and writes a batchEOR sentinel to stdout after
-// every result. Errors are serialised as JSON to stdout (not stderr) so the
-// harness can parse them without interleaving stderr. Blank lines are
-// skipped; only stdin EOF ends the session.
-//
-// The scanner buffer is widened to 16 MiB so a single long command line
-// (e.g. a bulk-write with several thousand handles) does not trip the
-// default 64 KiB bufio.Scanner token-too-long error and abort the session.
-// If a line still exceeds the cap, the error is surfaced as a per-command
-// error-with-sentinel and the session continues.
-func runBatch(ctx context.Context, in io.Reader, stdout, stderr io.Writer) error {
-	bw := bufio.NewWriter(stdout)
-	scanner := bufio.NewScanner(in)
-	scanner.Buffer(make([]byte, 0, 64*1024), 16*1024*1024)
-	for {
-		if !scanner.Scan() {
-			break
-		}
-		line := scanner.Text()
-		args := strings.Fields(line)
-		if len(args) == 0 {
-			// Skip blank / whitespace-only lines; do NOT terminate. The
-			// session ends only on stdin EOF so a stray blank line in a
-			// PowerShell here-string does not silently drop later commands.
-			continue
-		}
-		if err := runWithIO(ctx, args, bw, stderr); err != nil {
-			// Write error as JSON to stdout (bw) so the harness sees it in the
-			// same stream as normal output, framed by the EOR sentinel.
-			errPayload := map[string]string{
-				"error": err.Error(),
-				"type":  "error",
-			}
-			_ = writeJSON(bw, errPayload)
-		}
-		_, _ = fmt.Fprintln(bw, batchEOR)
-		_ = bw.Flush()
-	}
-	if err := scanner.Err(); err != nil {
-		// Emit the scanner failure as a final error-with-sentinel so the
-		// harness sees the failure framed, then return the error so the
-		// process exit reflects it. This handles bufio.ErrTooLong for any
-		// pathological line above the 16 MiB cap.
-		errPayload := map[string]string{
-			"error": err.Error(),
-			"type":  "error",
-		}
-		_ = writeJSON(bw, errPayload)
-		_, _ = fmt.Fprintln(bw, batchEOR)
-		_ = bw.Flush()
-		return err
-	}
-	return nil
+	fmt.Fprintln(writer, "usage: mxgw-go <version|open-session|close-session|register|add-item|advise|subscribe-bulk|unsubscribe-bulk|write|stream-events|smoke|galaxy-test-connection|galaxy-last-deploy|galaxy-discover|galaxy-watch>")
 }
 
 func dialGalaxyForCommand(ctx context.Context, common *commonOptions) (*mxgateway.GalaxyClient, commonOptions, error) {
@@ -1509,234 +869,6 @@ func runGalaxyWatch(ctx context.Context, args []string, stdout, stderr io.Writer
 	}
 }
 
-// runGalaxyBrowse drives the lazy-browse Galaxy helper from the CLI. Without
-// -parent it walks the root objects via GalaxyClient.Browse and eagerly expands
-// -depth further levels (each level reuses the same BrowseChildrenOptions, like
-// the library helper). With -parent it fetches exactly one level of children for
-// that gobject id via a parent-scoped BrowseChildren request; -depth is not
-// meaningful there and a warning is emitted if combined, mirroring the Rust CLI.
-//
-// Filter flags map onto BrowseChildrenOptions: -category-ids and
-// -template-contains are comma-separated lists (matching this CLI's other
-// list-valued flags), -tag-name-glob / -alarm-bearing-only / -historized-only
-// are scalar, and -include-attributes is a tri-state pointer (left nil unless
-// the flag is provided so the server default applies).
-func runGalaxyBrowse(ctx context.Context, args []string, stdout, stderr io.Writer) error {
-	flags := flag.NewFlagSet("galaxy-browse", flag.ContinueOnError)
-	flags.SetOutput(stderr)
-	common := bindCommonFlags(flags)
-	jsonOutput := flags.Bool("json", false, "write JSON output")
-	parent := flags.Int("parent", -1, "parent gobject id whose children to browse; omit (or <0) for root objects")
-	depth := flags.Int("depth", 0, "additional levels to eagerly expand beneath each root node; ignored with -parent")
-	categoryIDs := flags.String("category-ids", "", "comma-separated Galaxy category ids to restrict results")
-	templateContains := flags.String("template-contains", "", "comma-separated template tag names the chain must contain")
-	tagNameGlob := flags.String("tag-name-glob", "", "restrict to objects whose tag name matches this glob")
-	alarmBearingOnly := flags.Bool("alarm-bearing-only", false, "restrict to alarm-bearing objects")
-	historizedOnly := flags.Bool("historized-only", false, "restrict to historized objects")
-	includeAttributes := flags.Bool("include-attributes", false, "populate attributes on returned objects (overrides server default)")
-
-	if err := flags.Parse(args); err != nil {
-		return err
-	}
-
-	categoryList, err := parseInt32List(*categoryIDs)
-	if err != nil {
-		return err
-	}
-
-	opts := &mxgateway.BrowseChildrenOptions{
-		CategoryIds:           categoryList,
-		TemplateChainContains: parseStringList(*templateContains),
-		TagNameGlob:           *tagNameGlob,
-		AlarmBearingOnly:      *alarmBearingOnly,
-		HistorizedOnly:        *historizedOnly,
-	}
-	// Only override the server default when the flag was actually set; the
-	// pointer form mirrors the proto's optional field.
-	flags.Visit(func(f *flag.Flag) {
-		if f.Name == "include-attributes" {
-			value := *includeAttributes
-			opts.IncludeAttributes = &value
-		}
-	})
-
-	client, options, err := dialGalaxyForCommand(ctx, common)
-	if err != nil {
-		return err
-	}
-	defer client.Close()
-
-	// A specific parent → one level of children via the raw parent-scoped RPC.
-	if *parent >= 0 {
-		if *parent == 0 {
-			fmt.Fprintln(stderr, "warning: -parent 0 is the server root sentinel; omit -parent for the root walk, or use -parent <id> >= 1")
-		}
-		if *depth > 0 {
-			fmt.Fprintln(stderr, "warning: -depth is ignored when -parent is specified")
-		}
-		return runGalaxyBrowseParent(ctx, client, int32(*parent), opts, stdout, *jsonOutput, options)
-	}
-
-	// No parent → walk the lazy-browse tree from the root objects, eagerly
-	// expanding -depth further levels so the print walks cached children
-	// without re-issuing RPCs.
-	nodes, err := client.Browse(ctx, opts)
-	if err != nil {
-		return err
-	}
-	for _, node := range nodes {
-		if err := expandToDepth(ctx, node, *depth); err != nil {
-			return err
-		}
-	}
-
-	if *jsonOutput {
-		jsonNodes := make([]map[string]any, 0, len(nodes))
-		for _, node := range nodes {
-			jsonNodes = append(jsonNodes, lazyNodeToJSON(node))
-		}
-		return writeJSON(stdout, map[string]any{
-			"command": "galaxy-browse",
-			"options": options,
-			"nodes":   jsonNodes,
-		})
-	}
-
-	fmt.Fprintln(stdout, len(nodes))
-	for _, node := range nodes {
-		printLazyNode(stdout, node, 0)
-	}
-	return nil
-}
-
-// runGalaxyBrowseParent fetches exactly one level of children for parentID via a
-// parent-scoped BrowseChildren request, paging until the server stops. It does
-// not lazily wrap the children in nodes; the single level is rendered directly.
-func runGalaxyBrowseParent(
-	ctx context.Context,
-	client *mxgateway.GalaxyClient,
-	parentID int32,
-	opts *mxgateway.BrowseChildrenOptions,
-	stdout io.Writer,
-	jsonOutput bool,
-	options commonOptions,
-) error {
-	var children []*mxgateway.GalaxyObject
-	pageToken := ""
-	seen := map[string]struct{}{}
-	for {
-		req := &mxgateway.BrowseChildrenRequest{
-			PageSize:              browseChildrenCLIPageSize,
-			PageToken:             pageToken,
-			CategoryIds:           opts.CategoryIds,
-			TemplateChainContains: opts.TemplateChainContains,
-			TagNameGlob:           opts.TagNameGlob,
-			AlarmBearingOnly:      opts.AlarmBearingOnly,
-			HistorizedOnly:        opts.HistorizedOnly,
-			IncludeAttributes:     opts.IncludeAttributes,
-			Parent:                &mxgateway.BrowseChildrenRequest_ParentGobjectId{ParentGobjectId: parentID},
-		}
-		reply, err := client.BrowseChildrenRaw(ctx, req)
-		if err != nil {
-			return err
-		}
-		children = append(children, reply.GetChildren()...)
-		pageToken = reply.GetNextPageToken()
-		if pageToken == "" {
-			break
-		}
-		if _, dup := seen[pageToken]; dup {
-			return fmt.Errorf("galaxy browse children returned repeated page token %q", pageToken)
-		}
-		seen[pageToken] = struct{}{}
-	}
-
-	if jsonOutput {
-		jsonChildren := make([]map[string]any, 0, len(children))
-		for _, child := range children {
-			jsonChildren = append(jsonChildren, galaxyObjectToJSON(child))
-		}
-		return writeJSON(stdout, map[string]any{
-			"command":  "galaxy-browse",
-			"options":  options,
-			"parentId": parentID,
-			"children": jsonChildren,
-		})
-	}
-
-	fmt.Fprintln(stdout, len(children))
-	for _, child := range children {
-		fmt.Fprintf(stdout, "%d\t%s\t%s\t(attrs=%d)\n", child.GetGobjectId(), child.GetTagName(), child.GetBrowseName(), len(child.GetAttributes()))
-	}
-	return nil
-}
-
-// browseChildrenCLIPageSize is the per-request page size for the -parent
-// single-level walk. It mirrors the library's browseChildrenPageSize so the
-// CLI and the lazy-browse helper page identically.
-const browseChildrenCLIPageSize = 500
-
-// expandToDepth eagerly expands node and remaining further levels beneath it so
-// a subsequent print walk reads cached children without re-issuing RPCs. A
-// remaining of 0 leaves the node unexpanded (only the requested level prints).
-func expandToDepth(ctx context.Context, node *mxgateway.LazyBrowseNode, remaining int) error {
-	if remaining <= 0 {
-		return nil
-	}
-	if err := node.Expand(ctx); err != nil {
-		return err
-	}
-	for _, child := range node.Children() {
-		if err := expandToDepth(ctx, child, remaining-1); err != nil {
-			return err
-		}
-	}
-	return nil
-}
-
-// printLazyNode renders one node and its already-expanded children as an
-// indent-per-level tree. Only children loaded by a prior Expand are walked.
-func printLazyNode(stdout io.Writer, node *mxgateway.LazyBrowseNode, level int) {
-	indent := strings.Repeat("  ", level)
-	obj := node.Object()
-	fmt.Fprintf(stdout, "%s%d\t%s\t%s\t(attrs=%d, hasChildrenHint=%t)\n",
-		indent, obj.GetGobjectId(), obj.GetTagName(), obj.GetBrowseName(), len(obj.GetAttributes()), node.HasChildrenHint())
-	for _, child := range node.Children() {
-		printLazyNode(stdout, child, level+1)
-	}
-}
-
-// lazyNodeToJSON renders one lazy node and its already-expanded children as a
-// nested JSON object.
-func lazyNodeToJSON(node *mxgateway.LazyBrowseNode) map[string]any {
-	out := galaxyObjectToJSON(node.Object())
-	out["hasChildrenHint"] = node.HasChildrenHint()
-	children := node.Children()
-	jsonChildren := make([]map[string]any, 0, len(children))
-	for _, child := range children {
-		jsonChildren = append(jsonChildren, lazyNodeToJSON(child))
-	}
-	out["children"] = jsonChildren
-	return out
-}
-
-// galaxyObjectToJSON renders the scalar fields of a GalaxyObject for the
-// browse JSON output. Attributes are summarised by count to keep the tree
-// compact; -include-attributes still drives whether the server populates them.
-func galaxyObjectToJSON(obj *mxgateway.GalaxyObject) map[string]any {
-	return map[string]any{
-		"gobjectId":       obj.GetGobjectId(),
-		"tagName":         obj.GetTagName(),
-		"containedName":   obj.GetContainedName(),
-		"browseName":      obj.GetBrowseName(),
-		"parentGobjectId": obj.GetParentGobjectId(),
-		"isArea":          obj.GetIsArea(),
-		"categoryId":      obj.GetCategoryId(),
-		"templateChain":   obj.GetTemplateChain(),
-		"attributeCount":  len(obj.GetAttributes()),
-	}
-}
-
 func formatDeployEvent(event *mxgateway.DeployEvent) string {
 	observed := ""
 	if ts := event.GetObservedAt(); ts != nil {

clients/go/cmd/mxgw-go/main_test.go

@@ -2,15 +2,9 @@ package main
 
 import (
 	"bytes"
-	"context"
 	"encoding/json"
-	"net"
 	"strings"
 	"testing"
-	"time"
-
-	pb "gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/internal/generated"
-	"google.golang.org/grpc"
 )
 
 func TestRunVersionJSON(t *testing.T) {
@@ -53,34 +47,6 @@ func TestCommonOptionsRedactsAPIKey(t *testing.T) {
 	}
 }
 
-func TestRunBatchEmitsEORAfterVersion(t *testing.T) {
-	var stdout bytes.Buffer
-	var stderr bytes.Buffer
-
-	in := strings.NewReader("version --json\n")
-	if err := runBatch(t.Context(), in, &stdout, &stderr); err != nil {
-		t.Fatalf("runBatch() error = %v; stderr = %s", err, stderr.String())
-	}
-
-	out := stdout.String()
-	if !strings.Contains(out, "\n"+batchEOR+"\n") && !strings.HasSuffix(out, batchEOR+"\n") {
-		t.Fatalf("expected EOR marker %q in stdout; got: %q", batchEOR, out)
-	}
-
-	idx := strings.Index(out, batchEOR)
-	if idx <= 0 {
-		t.Fatalf("EOR marker not found or appeared before any output: %q", out)
-	}
-	payload := out[:idx]
-	var output versionOutput
-	if err := json.Unmarshal([]byte(payload), &output); err != nil {
-		t.Fatalf("parse JSON block before EOR: %v (payload=%q)", err, payload)
-	}
-	if output.GatewayProtocolVersion == 0 || output.WorkerProtocolVersion == 0 {
-		t.Fatalf("protocol versions were not populated: %+v", output)
-	}
-}
-
 func TestParseValueBuildsTypedValue(t *testing.T) {
 	value, err := parseValue("int32", "123")
 	if err != nil {
@@ -90,450 +56,3 @@ func TestParseValueBuildsTypedValue(t *testing.T) {
 		t.Fatalf("int32 value = %d, want 123", got)
 	}
 }
-
-// TestRunWriteBulkVariantGatesSecuredFlags pins the Client.Go-022 fix:
-// secured-only flags must be unavailable on non-secured variants, and
-// vice-versa, so a wrong-variant flag fails with a clean "flag provided
-// but not defined" error instead of silently no-op'ing.
-func TestRunWriteBulkVariantGatesSecuredFlags(t *testing.T) {
-	cases := []struct {
-		name string
-		args []string
-	}{
-		{
-			name: "write-bulk-rejects-current-user-id",
-			args: []string{"write-bulk", "-current-user-id", "5", "-item-handles", "1", "-values", "1"},
-		},
-		{
-			name: "write-bulk-rejects-verifier-user-id",
-			args: []string{"write-bulk", "-verifier-user-id", "5", "-item-handles", "1", "-values", "1"},
-		},
-		{
-			name: "write2-bulk-rejects-current-user-id",
-			args: []string{"write2-bulk", "-current-user-id", "5", "-item-handles", "1", "-values", "1"},
-		},
-		{
-			name: "write-secured-bulk-rejects-user-id",
-			args: []string{"write-secured-bulk", "-user-id", "5", "-item-handles", "1", "-values", "1"},
-		},
-		{
-			name: "write-secured2-bulk-rejects-user-id",
-			args: []string{"write-secured2-bulk", "-user-id", "5", "-item-handles", "1", "-values", "1"},
-		},
-	}
-	for _, tc := range cases {
-		t.Run(tc.name, func(t *testing.T) {
-			var stdout, stderr bytes.Buffer
-			err := runWithIO(t.Context(), tc.args, &stdout, &stderr)
-			if err == nil {
-				t.Fatalf("runWithIO(%v) returned no error", tc.args)
-			}
-			if !strings.Contains(err.Error(), "flag provided but not defined") {
-				t.Fatalf("runWithIO(%v) error = %v; want 'flag provided but not defined'", tc.args, err)
-			}
-		})
-	}
-}
-
-// TestRunBenchReadBulkRespectsContextCancellation pins the Client.Go-023
-// fix: the warm-up and steady-state wall-clock loops must honour ctx.Err()
-// so an external cancel (Ctrl+C, parent-cancel from a cross-language bench
-// driver) short-circuits the bench instead of spinning failing ReadBulk
-// calls until the wall-clock deadline elapses.
-func TestRunBenchReadBulkRespectsContextCancellation(t *testing.T) {
-	listener, err := net.Listen("tcp", "127.0.0.1:0")
-	if err != nil {
-		t.Fatalf("listen: %v", err)
-	}
-	server := grpc.NewServer()
-	fake := &benchFakeGateway{}
-	pb.RegisterMxAccessGatewayServer(server, fake)
-	go func() {
-		_ = server.Serve(listener)
-	}()
-	defer server.Stop()
-	defer listener.Close()
-
-	ctx, cancel := context.WithCancel(context.Background())
-	defer cancel()
-
-	// Long warm-up + duration, so if the ctx.Err() guard were missing the
-	// loops would run for ~10s. With the guard, the cancel below short-
-	// circuits both loops within ~one ReadBulk iteration.
-	args := []string{
-		"bench-read-bulk",
-		"-endpoint", listener.Addr().String(),
-		"-plaintext",
-		"-api-key", "test",
-		"-warmup-seconds", "5",
-		"-duration-seconds", "5",
-		"-bulk-size", "1",
-		"-timeout-ms", "100",
-	}
-
-	// Cancel after a brief delay — far less than warmup+duration (10s).
-	go func() {
-		time.Sleep(150 * time.Millisecond)
-		cancel()
-	}()
-
-	var stdout, stderr bytes.Buffer
-	start := time.Now()
-	err = runWithIO(ctx, args, &stdout, &stderr)
-	elapsed := time.Since(start)
-
-	// With the ctx.Err() guard, the loops exit well before the wall-clock
-	// deadlines (warmup=5s + duration=5s = 10s). Allow generous slack for
-	// CI noise but assert clearly less than the un-guarded worst case.
-	if elapsed > 4*time.Second {
-		t.Fatalf("bench-read-bulk took %s after ctx cancel; want <4s (ctx.Err() guard missing?). err=%v stderr=%s", elapsed, err, stderr.String())
-	}
-}
-
-// TestRunPingPlainText verifies the ping subcommand round-trips through the
-// fake gateway and prints the echo (diagnostic_message) in plain-text mode.
-func TestRunPingPlainText(t *testing.T) {
-	listener, err := net.Listen("tcp", "127.0.0.1:0")
-	if err != nil {
-		t.Fatalf("listen: %v", err)
-	}
-	server := grpc.NewServer()
-	fake := &pingFakeGateway{}
-	pb.RegisterMxAccessGatewayServer(server, fake)
-	go func() { _ = server.Serve(listener) }()
-	defer server.Stop()
-	defer listener.Close()
-
-	var stdout, stderr bytes.Buffer
-	args := []string{
-		"ping",
-		"-endpoint", listener.Addr().String(),
-		"-plaintext",
-		"-api-key", "test",
-		"-session-id", "test-session",
-		"-message", "hello",
-	}
-	if err := runWithIO(t.Context(), args, &stdout, &stderr); err != nil {
-		t.Fatalf("runWithIO() error = %v; stderr = %s", err, stderr.String())
-	}
-	got := strings.TrimSpace(stdout.String())
-	if got != "pong:hello" {
-		t.Fatalf("ping plain-text output = %q, want %q", got, "pong:hello")
-	}
-}
-
-// TestRunPingJSON verifies the ping subcommand emits valid JSON in --json mode.
-func TestRunPingJSON(t *testing.T) {
-	listener, err := net.Listen("tcp", "127.0.0.1:0")
-	if err != nil {
-		t.Fatalf("listen: %v", err)
-	}
-	server := grpc.NewServer()
-	fake := &pingFakeGateway{}
-	pb.RegisterMxAccessGatewayServer(server, fake)
-	go func() { _ = server.Serve(listener) }()
-	defer server.Stop()
-	defer listener.Close()
-
-	var stdout, stderr bytes.Buffer
-	args := []string{
-		"ping",
-		"-endpoint", listener.Addr().String(),
-		"-plaintext",
-		"-api-key", "test",
-		"-session-id", "test-session",
-		"-message", "hello",
-		"-json",
-	}
-	if err := runWithIO(t.Context(), args, &stdout, &stderr); err != nil {
-		t.Fatalf("runWithIO() error = %v; stderr = %s", err, stderr.String())
-	}
-	var out commandReplyOutput
-	if err := json.Unmarshal(stdout.Bytes(), &out); err != nil {
-		t.Fatalf("parse JSON: %v\noutput: %s", err, stdout.String())
-	}
-	if out.Command != "ping" {
-		t.Fatalf("command = %q, want %q", out.Command, "ping")
-	}
-	// The fake gateway echoes "pong:<message>" in diagnostic_message; verify the
-	// echo appears in the serialised reply so a future regression that wired
-	// PingRaw to the wrong proto field would be caught here.
-	replyStr := string(out.Reply)
-	if !strings.Contains(replyStr, "pong:hello") {
-		t.Fatalf("ping JSON reply missing echoed message %q; reply = %s", "pong:hello", replyStr)
-	}
-}
-
-// TestRunPingRequiresSessionID verifies the ping subcommand rejects missing session-id.
-func TestRunPingRequiresSessionID(t *testing.T) {
-	var stdout, stderr bytes.Buffer
-	err := runWithIO(t.Context(), []string{"ping", "-plaintext", "-api-key", "test"}, &stdout, &stderr)
-	if err == nil {
-		t.Fatalf("runWithIO(ping without --session-id) returned no error")
-	}
-	if !strings.Contains(err.Error(), "session-id is required") {
-		t.Fatalf("error = %v; want 'session-id is required'", err)
-	}
-}
-
-// pingFakeGateway handles Invoke for MX_COMMAND_KIND_PING by echoing the
-// message back in the diagnostic_message field so the CLI plain-text path
-// has a deterministic, non-empty string to assert on.
-type pingFakeGateway struct {
-	pb.UnimplementedMxAccessGatewayServer
-}
-
-func (g *pingFakeGateway) Invoke(_ context.Context, req *pb.MxCommandRequest) (*pb.MxCommandReply, error) {
-	echo := "pong:" + req.GetCommand().GetPing().GetMessage()
-	return &pb.MxCommandReply{
-		SessionId:         req.GetSessionId(),
-		Kind:              pb.MxCommandKind_MX_COMMAND_KIND_PING,
-		DiagnosticMessage: echo,
-		ProtocolStatus:    &pb.ProtocolStatus{Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK},
-	}, nil
-}
-
-// benchFakeGateway is a minimal MxAccessGatewayServer that satisfies the
-// bench-read-bulk session-setup sequence (OpenSession + Invoke for Register
-// / SubscribeBulk / ReadBulk / UnsubscribeBulk / CloseSession).
-type benchFakeGateway struct {
-	pb.UnimplementedMxAccessGatewayServer
-}
-
-func (g *benchFakeGateway) OpenSession(_ context.Context, _ *pb.OpenSessionRequest) (*pb.OpenSessionReply, error) {
-	return &pb.OpenSessionReply{
-		SessionId:      "bench-session",
-		ProtocolStatus: &pb.ProtocolStatus{Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK},
-	}, nil
-}
-
-func (g *benchFakeGateway) CloseSession(_ context.Context, req *pb.CloseSessionRequest) (*pb.CloseSessionReply, error) {
-	return &pb.CloseSessionReply{
-		SessionId:      req.GetSessionId(),
-		ProtocolStatus: &pb.ProtocolStatus{Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK},
-	}, nil
-}
-
-func (g *benchFakeGateway) Invoke(_ context.Context, req *pb.MxCommandRequest) (*pb.MxCommandReply, error) {
-	kind := req.GetCommand().GetKind()
-	reply := &pb.MxCommandReply{
-		SessionId:      req.GetSessionId(),
-		Kind:           kind,
-		ProtocolStatus: &pb.ProtocolStatus{Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK},
-	}
-	switch kind {
-	case pb.MxCommandKind_MX_COMMAND_KIND_REGISTER:
-		reply.Payload = &pb.MxCommandReply_Register{Register: &pb.RegisterReply{ServerHandle: 1}}
-	case pb.MxCommandKind_MX_COMMAND_KIND_SUBSCRIBE_BULK:
-		reply.Payload = &pb.MxCommandReply_SubscribeBulk{SubscribeBulk: &pb.BulkSubscribeReply{
-			Results: []*pb.SubscribeResult{{ServerHandle: 1, ItemHandle: 1, WasSuccessful: true}},
-		}}
-	case pb.MxCommandKind_MX_COMMAND_KIND_READ_BULK:
-		reply.Payload = &pb.MxCommandReply_ReadBulk{ReadBulk: &pb.BulkReadReply{
-			Results: []*pb.BulkReadResult{{ItemHandle: 1, WasSuccessful: true, WasCached: true}},
-		}}
-	case pb.MxCommandKind_MX_COMMAND_KIND_UNSUBSCRIBE_BULK:
-		reply.Payload = &pb.MxCommandReply_UnsubscribeBulk{UnsubscribeBulk: &pb.BulkSubscribeReply{}}
-	}
-	return reply, nil
-}
-
-// TestRunBenchReadBulkRejectsNonPositiveBulkSize pins the Client.Go-023-adjacent
-// positivity checks so they cannot drift while resolving the cancellation finding.
-func TestRunBenchReadBulkRejectsNonPositiveBulkSize(t *testing.T) {
-	var stdout, stderr bytes.Buffer
-	err := runWithIO(t.Context(), []string{"bench-read-bulk", "-bulk-size", "0"}, &stdout, &stderr)
-	if err == nil || !strings.Contains(err.Error(), "bulk-size must be positive") {
-		t.Fatalf("bench-read-bulk -bulk-size 0 error = %v", err)
-	}
-}
-
-// browseFakeGalaxy implements BrowseChildren for the galaxy-browse subcommand
-// tests. It returns two root objects when no parent is supplied (the first
-// flagged as having children), and one child when the first root's gobject id
-// is supplied as the parent. The recorded last request lets a test assert the
-// CLI forwarded the parent and filter fields onto the wire.
-type browseFakeGalaxy struct {
-	pb.UnimplementedGalaxyRepositoryServer
-	lastRequest *pb.BrowseChildrenRequest
-}
-
-func (g *browseFakeGalaxy) BrowseChildren(_ context.Context, req *pb.BrowseChildrenRequest) (*pb.BrowseChildrenReply, error) {
-	g.lastRequest = req
-	if req.GetParentGobjectId() == 10 {
-		return &pb.BrowseChildrenReply{
-			Children: []*pb.GalaxyObject{
-				{GobjectId: 11, TagName: "Area1.Tank", BrowseName: "Tank"},
-			},
-			ChildHasChildren: []bool{false},
-		}, nil
-	}
-	return &pb.BrowseChildrenReply{
-		Children: []*pb.GalaxyObject{
-			{GobjectId: 10, TagName: "Area1", BrowseName: "Area1"},
-			{GobjectId: 20, TagName: "Area2", BrowseName: "Area2"},
-		},
-		ChildHasChildren: []bool{true, false},
-	}, nil
-}
-
-func startBrowseFakeGalaxy(t *testing.T) (addr string, fake *browseFakeGalaxy) {
-	t.Helper()
-	listener, err := net.Listen("tcp", "127.0.0.1:0")
-	if err != nil {
-		t.Fatalf("listen: %v", err)
-	}
-	server := grpc.NewServer()
-	fake = &browseFakeGalaxy{}
-	pb.RegisterGalaxyRepositoryServer(server, fake)
-	go func() { _ = server.Serve(listener) }()
-	t.Cleanup(func() {
-		server.Stop()
-		_ = listener.Close()
-	})
-	return listener.Addr().String(), fake
-}
-
-// TestRunGalaxyBrowseTextTree verifies the galaxy-browse subcommand issues
-// BrowseChildren for the root walk, eagerly expands one level when --depth is
-// set, and renders an indented tree.
-func TestRunGalaxyBrowseTextTree(t *testing.T) {
-	addr, _ := startBrowseFakeGalaxy(t)
-
-	var stdout, stderr bytes.Buffer
-	args := []string{
-		"galaxy-browse",
-		"-endpoint", addr,
-		"-plaintext",
-		"-api-key", "test",
-		"-depth", "1",
-	}
-	if err := runWithIO(t.Context(), args, &stdout, &stderr); err != nil {
-		t.Fatalf("runWithIO() error = %v; stderr = %s", err, stderr.String())
-	}
-	out := stdout.String()
-	// Both roots present; the first root's eagerly-expanded child appears
-	// indented beneath it.
-	for _, want := range []string{"Area1", "Area2", "Tank"} {
-		if !strings.Contains(out, want) {
-			t.Fatalf("galaxy-browse text output missing %q; got:\n%s", want, out)
-		}
-	}
-	if !strings.Contains(out, "  ") {
-		t.Fatalf("galaxy-browse text output not indented for children; got:\n%s", out)
-	}
-}
-
-// TestRunGalaxyBrowseJSON verifies the galaxy-browse subcommand emits valid
-// nested JSON and forwards filter options onto the BrowseChildren request.
-func TestRunGalaxyBrowseJSON(t *testing.T) {
-	addr, fake := startBrowseFakeGalaxy(t)
-
-	var stdout, stderr bytes.Buffer
-	args := []string{
-		"galaxy-browse",
-		"-endpoint", addr,
-		"-plaintext",
-		"-api-key", "test",
-		"-depth", "1",
-		"-tag-name-glob", "Area%",
-		"-alarm-bearing-only",
-		"-json",
-	}
-	if err := runWithIO(t.Context(), args, &stdout, &stderr); err != nil {
-		t.Fatalf("runWithIO() error = %v; stderr = %s", err, stderr.String())
-	}
-
-	var payload map[string]any
-	if err := json.Unmarshal(stdout.Bytes(), &payload); err != nil {
-		t.Fatalf("parse JSON: %v\noutput: %s", err, stdout.String())
-	}
-	if payload["command"] != "galaxy-browse" {
-		t.Fatalf("command = %v, want galaxy-browse", payload["command"])
-	}
-	nodes, ok := payload["nodes"].([]any)
-	if !ok || len(nodes) != 2 {
-		t.Fatalf("nodes = %v, want 2 root nodes", payload["nodes"])
-	}
-	// Filter fields must have reached the wire.
-	if got := fake.lastRequest.GetTagNameGlob(); got != "Area%" {
-		t.Fatalf("BrowseChildren TagNameGlob = %q, want %q", got, "Area%")
-	}
-	if !fake.lastRequest.GetAlarmBearingOnly() {
-		t.Fatalf("BrowseChildren AlarmBearingOnly = false, want true")
-	}
-}
-
-// TestRunGalaxyBrowseParentSingleLevel verifies that passing --parent fetches a
-// single level of children for that parent via the parent-scoped request.
-func TestRunGalaxyBrowseParentSingleLevel(t *testing.T) {
-	addr, fake := startBrowseFakeGalaxy(t)
-
-	var stdout, stderr bytes.Buffer
-	args := []string{
-		"galaxy-browse",
-		"-endpoint", addr,
-		"-plaintext",
-		"-api-key", "test",
-		"-parent", "10",
-	}
-	if err := runWithIO(t.Context(), args, &stdout, &stderr); err != nil {
-		t.Fatalf("runWithIO() error = %v; stderr = %s", err, stderr.String())
-	}
-	if !strings.Contains(stdout.String(), "Tank") {
-		t.Fatalf("galaxy-browse -parent output missing child %q; got:\n%s", "Tank", stdout.String())
-	}
-	if got := fake.lastRequest.GetParentGobjectId(); got != 10 {
-		t.Fatalf("BrowseChildren ParentGobjectId = %d, want 10", got)
-	}
-}
-
-// TestRunBatchSkipsBlankLinesAndContinuesUntilEOF pins the Client.Go-027 fix:
-// a blank line in the middle of a batch session must NOT terminate the loop —
-// only stdin EOF ends the session.
-func TestRunBatchSkipsBlankLinesAndContinuesUntilEOF(t *testing.T) {
-	var stdout, stderr bytes.Buffer
-
-	// version -> blank -> version (a stray blank line in the middle of a
-	// programmatic session).
-	in := strings.NewReader("version --json\n\nversion --json\n")
-	if err := runBatch(t.Context(), in, &stdout, &stderr); err != nil {
-		t.Fatalf("runBatch() error = %v; stderr = %s", err, stderr.String())
-	}
-
-	out := stdout.String()
-	// Both version commands must have produced a result before the EOR sentinel.
-	if count := strings.Count(out, batchEOR); count != 2 {
-		t.Fatalf("EOR sentinel count = %d, want 2 (one per command, blank line skipped); out = %q", count, out)
-	}
-}
-
-// TestRunBatchHandlesLongCommandLine pins the Client.Go-026 fix: a command
-// line longer than the default bufio.Scanner token size (64 KiB) must not
-// abort the batch session.
-func TestRunBatchHandlesLongCommandLine(t *testing.T) {
-	var stdout, stderr bytes.Buffer
-
-	// Build a single command line larger than 64 KiB. The command itself is
-	// invalid (no real session) but runBatch must still emit an EOR sentinel
-	// and continue to the next command rather than dropping the line on the
-	// floor with a bufio.ErrTooLong from the outer return.
-	huge := strings.Repeat("tag-with-a-reasonably-long-name-and-suffix,", 2000) + "trailing"
-	line := "subscribe-bulk -session-id none -items " + huge
-	if len(line) <= 64*1024 {
-		t.Fatalf("test setup error: long line length = %d, want > 64KiB", len(line))
-	}
-	in := strings.NewReader(line + "\nversion --json\n")
-
-	if err := runBatch(t.Context(), in, &stdout, &stderr); err != nil {
-		t.Fatalf("runBatch() error = %v; stderr = %s", err, stderr.String())
-	}
-
-	out := stdout.String()
-	// Both commands must produce an EOR sentinel — the long line should be a
-	// per-command error (still emitted with EOR), then the version command
-	// should run normally.
-	if count := strings.Count(out, batchEOR); count != 2 {
-		t.Fatalf("EOR sentinel count = %d, want 2 (one per command, even when first is too long); out length = %d", count, len(out))
-	}
-}

clients/go/generate-proto.ps1

@@ -2,7 +2,7 @@ Set-StrictMode -Version Latest
 $ErrorActionPreference = 'Stop'
 
 $repoRoot = Resolve-Path (Join-Path $PSScriptRoot '..\..')
-$protoRoot = Join-Path $repoRoot 'src\ZB.MOM.WW.MxGateway.Contracts\Protos'
+$protoRoot = Join-Path $repoRoot 'src\MxGateway.Contracts\Protos'
 $outputRoot = Join-Path $PSScriptRoot 'internal\generated'
 $modulePath = 'gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/internal/generated'
 $protoc = 'C:\Users\dohertj2\AppData\Local\Microsoft\WinGet\Packages\Google.Protobuf_Microsoft.Winget.Source_8wekyb3d8bbwe\bin\protoc.exe'

clients/go/internal/generated/galaxy_repository.pb.go

@@ -687,32 +687,18 @@ func (x *GalaxyObject) GetAttributes() []*GalaxyAttribute {
 }
 
 type GalaxyAttribute struct {
-	state            protoimpl.MessageState `protogen:"open.v1"`
-	AttributeName    string                 `protobuf:"bytes,1,opt,name=attribute_name,json=attributeName,proto3" json:"attribute_name,omitempty"`
-	FullTagReference string                 `protobuf:"bytes,2,opt,name=full_tag_reference,json=fullTagReference,proto3" json:"full_tag_reference,omitempty"`
-	// Raw Galaxy SQL `dbo.data_type` identifier, passed through unchanged.
-	// This is NOT a member of `mxaccess_gateway.v1.MxDataType` — Galaxy's
-	// type enumeration is distinct from MXAccess's wire data-type enum and
-	// the two must not be cast or compared. The GalaxyRepository service is
-	// metadata-only and deliberately does not share types with
-	// mxaccess_gateway.proto. See docs/GalaxyRepository.md.
-	MxDataType int32 `protobuf:"varint,3,opt,name=mx_data_type,json=mxDataType,proto3" json:"mx_data_type,omitempty"`
-	// Human-readable name from Galaxy's `dbo.data_type` table (e.g. "Float",
-	// "Integer", "Boolean"). Free-form Galaxy text; not a stable enum.
-	DataTypeName          string `protobuf:"bytes,4,opt,name=data_type_name,json=dataTypeName,proto3" json:"data_type_name,omitempty"`
-	IsArray               bool   `protobuf:"varint,5,opt,name=is_array,json=isArray,proto3" json:"is_array,omitempty"`
-	ArrayDimension        int32  `protobuf:"varint,6,opt,name=array_dimension,json=arrayDimension,proto3" json:"array_dimension,omitempty"`
-	ArrayDimensionPresent bool   `protobuf:"varint,7,opt,name=array_dimension_present,json=arrayDimensionPresent,proto3" json:"array_dimension_present,omitempty"`
-	// Raw Galaxy SQL attribute-category identifier, passed through unchanged.
-	// Galaxy-specific; not mapped to any gateway enum. See
-	// docs/GalaxyRepository.md.
-	MxAttributeCategory int32 `protobuf:"varint,8,opt,name=mx_attribute_category,json=mxAttributeCategory,proto3" json:"mx_attribute_category,omitempty"`
-	// Raw Galaxy SQL security-classification identifier, passed through
-	// unchanged. Galaxy-specific; not mapped to any gateway enum. See
-	// docs/GalaxyRepository.md.
-	SecurityClassification int32 `protobuf:"varint,9,opt,name=security_classification,json=securityClassification,proto3" json:"security_classification,omitempty"`
-	IsHistorized           bool  `protobuf:"varint,10,opt,name=is_historized,json=isHistorized,proto3" json:"is_historized,omitempty"`
-	IsAlarm                bool  `protobuf:"varint,11,opt,name=is_alarm,json=isAlarm,proto3" json:"is_alarm,omitempty"`
+	state                  protoimpl.MessageState `protogen:"open.v1"`
+	AttributeName          string                 `protobuf:"bytes,1,opt,name=attribute_name,json=attributeName,proto3" json:"attribute_name,omitempty"`
+	FullTagReference       string                 `protobuf:"bytes,2,opt,name=full_tag_reference,json=fullTagReference,proto3" json:"full_tag_reference,omitempty"`
+	MxDataType             int32                  `protobuf:"varint,3,opt,name=mx_data_type,json=mxDataType,proto3" json:"mx_data_type,omitempty"`
+	DataTypeName           string                 `protobuf:"bytes,4,opt,name=data_type_name,json=dataTypeName,proto3" json:"data_type_name,omitempty"`
+	IsArray                bool                   `protobuf:"varint,5,opt,name=is_array,json=isArray,proto3" json:"is_array,omitempty"`
+	ArrayDimension         int32                  `protobuf:"varint,6,opt,name=array_dimension,json=arrayDimension,proto3" json:"array_dimension,omitempty"`
+	ArrayDimensionPresent  bool                   `protobuf:"varint,7,opt,name=array_dimension_present,json=arrayDimensionPresent,proto3" json:"array_dimension_present,omitempty"`
+	MxAttributeCategory    int32                  `protobuf:"varint,8,opt,name=mx_attribute_category,json=mxAttributeCategory,proto3" json:"mx_attribute_category,omitempty"`
+	SecurityClassification int32                  `protobuf:"varint,9,opt,name=security_classification,json=securityClassification,proto3" json:"security_classification,omitempty"`
+	IsHistorized           bool                   `protobuf:"varint,10,opt,name=is_historized,json=isHistorized,proto3" json:"is_historized,omitempty"`
+	IsAlarm                bool                   `protobuf:"varint,11,opt,name=is_alarm,json=isAlarm,proto3" json:"is_alarm,omitempty"`
 	unknownFields          protoimpl.UnknownFields
 	sizeCache              protoimpl.SizeCache
 }
@@ -824,260 +810,6 @@ func (x *GalaxyAttribute) GetIsAlarm() bool {
 	return false
 }
 
-type BrowseChildrenRequest struct {
-	state protoimpl.MessageState `protogen:"open.v1"`
-	// Parent selector. Empty oneof returns root objects (parent_gobject_id == 0).
-	//
-	// Types that are valid to be assigned to Parent:
-	//
-	//	*BrowseChildrenRequest_ParentGobjectId
-	//	*BrowseChildrenRequest_ParentTagName
-	//	*BrowseChildrenRequest_ParentContainedPath
-	Parent isBrowseChildrenRequest_Parent `protobuf_oneof:"parent"`
-	// Maximum number of direct children to return. Server default 500; cap 5000.
-	PageSize int32 `protobuf:"varint,4,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
-	// Opaque token returned by a previous BrowseChildren response. Bound to the
-	// cache sequence, parent selector, and the filter set; a mismatch returns
-	// InvalidArgument.
-	PageToken string `protobuf:"bytes,5,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
-	// --- Filter parity with DiscoverHierarchy. AND-combined. ---
-	CategoryIds           []int32  `protobuf:"varint,6,rep,packed,name=category_ids,json=categoryIds,proto3" json:"category_ids,omitempty"`
-	TemplateChainContains []string `protobuf:"bytes,7,rep,name=template_chain_contains,json=templateChainContains,proto3" json:"template_chain_contains,omitempty"`
-	TagNameGlob           string   `protobuf:"bytes,8,opt,name=tag_name_glob,json=tagNameGlob,proto3" json:"tag_name_glob,omitempty"`
-	IncludeAttributes     *bool    `protobuf:"varint,9,opt,name=include_attributes,json=includeAttributes,proto3,oneof" json:"include_attributes,omitempty"`
-	AlarmBearingOnly      bool     `protobuf:"varint,10,opt,name=alarm_bearing_only,json=alarmBearingOnly,proto3" json:"alarm_bearing_only,omitempty"`
-	HistorizedOnly        bool     `protobuf:"varint,11,opt,name=historized_only,json=historizedOnly,proto3" json:"historized_only,omitempty"`
-	unknownFields         protoimpl.UnknownFields
-	sizeCache             protoimpl.SizeCache
-}
-
-func (x *BrowseChildrenRequest) Reset() {
-	*x = BrowseChildrenRequest{}
-	mi := &file_galaxy_repository_proto_msgTypes[10]
-	ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
-	ms.StoreMessageInfo(mi)
-}
-
-func (x *BrowseChildrenRequest) String() string {
-	return protoimpl.X.MessageStringOf(x)
-}
-
-func (*BrowseChildrenRequest) ProtoMessage() {}
-
-func (x *BrowseChildrenRequest) ProtoReflect() protoreflect.Message {
-	mi := &file_galaxy_repository_proto_msgTypes[10]
-	if x != nil {
-		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
-		if ms.LoadMessageInfo() == nil {
-			ms.StoreMessageInfo(mi)
-		}
-		return ms
-	}
-	return mi.MessageOf(x)
-}
-
-// Deprecated: Use BrowseChildrenRequest.ProtoReflect.Descriptor instead.
-func (*BrowseChildrenRequest) Descriptor() ([]byte, []int) {
-	return file_galaxy_repository_proto_rawDescGZIP(), []int{10}
-}
-
-func (x *BrowseChildrenRequest) GetParent() isBrowseChildrenRequest_Parent {
-	if x != nil {
-		return x.Parent
-	}
-	return nil
-}
-
-func (x *BrowseChildrenRequest) GetParentGobjectId() int32 {
-	if x != nil {
-		if x, ok := x.Parent.(*BrowseChildrenRequest_ParentGobjectId); ok {
-			return x.ParentGobjectId
-		}
-	}
-	return 0
-}
-
-func (x *BrowseChildrenRequest) GetParentTagName() string {
-	if x != nil {
-		if x, ok := x.Parent.(*BrowseChildrenRequest_ParentTagName); ok {
-			return x.ParentTagName
-		}
-	}
-	return ""
-}
-
-func (x *BrowseChildrenRequest) GetParentContainedPath() string {
-	if x != nil {
-		if x, ok := x.Parent.(*BrowseChildrenRequest_ParentContainedPath); ok {
-			return x.ParentContainedPath
-		}
-	}
-	return ""
-}
-
-func (x *BrowseChildrenRequest) GetPageSize() int32 {
-	if x != nil {
-		return x.PageSize
-	}
-	return 0
-}
-
-func (x *BrowseChildrenRequest) GetPageToken() string {
-	if x != nil {
-		return x.PageToken
-	}
-	return ""
-}
-
-func (x *BrowseChildrenRequest) GetCategoryIds() []int32 {
-	if x != nil {
-		return x.CategoryIds
-	}
-	return nil
-}
-
-func (x *BrowseChildrenRequest) GetTemplateChainContains() []string {
-	if x != nil {
-		return x.TemplateChainContains
-	}
-	return nil
-}
-
-func (x *BrowseChildrenRequest) GetTagNameGlob() string {
-	if x != nil {
-		return x.TagNameGlob
-	}
-	return ""
-}
-
-func (x *BrowseChildrenRequest) GetIncludeAttributes() bool {
-	if x != nil && x.IncludeAttributes != nil {
-		return *x.IncludeAttributes
-	}
-	return false
-}
-
-func (x *BrowseChildrenRequest) GetAlarmBearingOnly() bool {
-	if x != nil {
-		return x.AlarmBearingOnly
-	}
-	return false
-}
-
-func (x *BrowseChildrenRequest) GetHistorizedOnly() bool {
-	if x != nil {
-		return x.HistorizedOnly
-	}
-	return false
-}
-
-type isBrowseChildrenRequest_Parent interface {
-	isBrowseChildrenRequest_Parent()
-}
-
-type BrowseChildrenRequest_ParentGobjectId struct {
-	ParentGobjectId int32 `protobuf:"varint,1,opt,name=parent_gobject_id,json=parentGobjectId,proto3,oneof"`
-}
-
-type BrowseChildrenRequest_ParentTagName struct {
-	ParentTagName string `protobuf:"bytes,2,opt,name=parent_tag_name,json=parentTagName,proto3,oneof"`
-}
-
-type BrowseChildrenRequest_ParentContainedPath struct {
-	ParentContainedPath string `protobuf:"bytes,3,opt,name=parent_contained_path,json=parentContainedPath,proto3,oneof"`
-}
-
-func (*BrowseChildrenRequest_ParentGobjectId) isBrowseChildrenRequest_Parent() {}
-
-func (*BrowseChildrenRequest_ParentTagName) isBrowseChildrenRequest_Parent() {}
-
-func (*BrowseChildrenRequest_ParentContainedPath) isBrowseChildrenRequest_Parent() {}
-
-type BrowseChildrenReply struct {
-	state protoimpl.MessageState `protogen:"open.v1"`
-	// Direct children matching the filter, sorted areas-first then by
-	// case-insensitive display name (same order as the dashboard tree).
-	Children []*GalaxyObject `protobuf:"bytes,1,rep,name=children,proto3" json:"children,omitempty"`
-	// Non-empty when another page of siblings is available.
-	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
-	// Total matching direct children of the parent (post-filter).
-	TotalChildCount int32 `protobuf:"varint,3,opt,name=total_child_count,json=totalChildCount,proto3" json:"total_child_count,omitempty"`
-	// Parallel array, indexed with `children`. True when the child has at least
-	// one matching descendant under the same filter set. Lets a UI choose
-	// whether to draw an expand triangle without an extra round trip.
-	ChildHasChildren []bool `protobuf:"varint,4,rep,packed,name=child_has_children,json=childHasChildren,proto3" json:"child_has_children,omitempty"`
-	// Cache sequence this reply was projected from. Clients may pass it back as
-	// part of the page_token contract. Mismatch on the next page -> InvalidArgument.
-	CacheSequence uint64 `protobuf:"varint,5,opt,name=cache_sequence,json=cacheSequence,proto3" json:"cache_sequence,omitempty"`
-	unknownFields protoimpl.UnknownFields
-	sizeCache     protoimpl.SizeCache
-}
-
-func (x *BrowseChildrenReply) Reset() {
-	*x = BrowseChildrenReply{}
-	mi := &file_galaxy_repository_proto_msgTypes[11]
-	ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
-	ms.StoreMessageInfo(mi)
-}
-
-func (x *BrowseChildrenReply) String() string {
-	return protoimpl.X.MessageStringOf(x)
-}
-
-func (*BrowseChildrenReply) ProtoMessage() {}
-
-func (x *BrowseChildrenReply) ProtoReflect() protoreflect.Message {
-	mi := &file_galaxy_repository_proto_msgTypes[11]
-	if x != nil {
-		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
-		if ms.LoadMessageInfo() == nil {
-			ms.StoreMessageInfo(mi)
-		}
-		return ms
-	}
-	return mi.MessageOf(x)
-}
-
-// Deprecated: Use BrowseChildrenReply.ProtoReflect.Descriptor instead.
-func (*BrowseChildrenReply) Descriptor() ([]byte, []int) {
-	return file_galaxy_repository_proto_rawDescGZIP(), []int{11}
-}
-
-func (x *BrowseChildrenReply) GetChildren() []*GalaxyObject {
-	if x != nil {
-		return x.Children
-	}
-	return nil
-}
-
-func (x *BrowseChildrenReply) GetNextPageToken() string {
-	if x != nil {
-		return x.NextPageToken
-	}
-	return ""
-}
-
-func (x *BrowseChildrenReply) GetTotalChildCount() int32 {
-	if x != nil {
-		return x.TotalChildCount
-	}
-	return 0
-}
-
-func (x *BrowseChildrenReply) GetChildHasChildren() []bool {
-	if x != nil {
-		return x.ChildHasChildren
-	}
-	return nil
-}
-
-func (x *BrowseChildrenReply) GetCacheSequence() uint64 {
-	if x != nil {
-		return x.CacheSequence
-	}
-	return 0
-}
-
 var File_galaxy_repository_proto protoreflect.FileDescriptor
 
 const file_galaxy_repository_proto_rawDesc = "" +
@@ -1151,35 +883,12 @@ const file_galaxy_repository_proto_rawDesc = "" +
 	"\x17security_classification\x18\t \x01(\x05R\x16securityClassification\x12#\n" +
 	"\ris_historized\x18\n" +
 	" \x01(\bR\fisHistorized\x12\x19\n" +
-	"\bis_alarm\x18\v \x01(\bR\aisAlarm\"\x8c\x04\n" +
-	"\x15BrowseChildrenRequest\x12,\n" +
-	"\x11parent_gobject_id\x18\x01 \x01(\x05H\x00R\x0fparentGobjectId\x12(\n" +
-	"\x0fparent_tag_name\x18\x02 \x01(\tH\x00R\rparentTagName\x124\n" +
-	"\x15parent_contained_path\x18\x03 \x01(\tH\x00R\x13parentContainedPath\x12\x1b\n" +
-	"\tpage_size\x18\x04 \x01(\x05R\bpageSize\x12\x1d\n" +
-	"\n" +
-	"page_token\x18\x05 \x01(\tR\tpageToken\x12!\n" +
-	"\fcategory_ids\x18\x06 \x03(\x05R\vcategoryIds\x126\n" +
-	"\x17template_chain_contains\x18\a \x03(\tR\x15templateChainContains\x12\"\n" +
-	"\rtag_name_glob\x18\b \x01(\tR\vtagNameGlob\x122\n" +
-	"\x12include_attributes\x18\t \x01(\bH\x01R\x11includeAttributes\x88\x01\x01\x12,\n" +
-	"\x12alarm_bearing_only\x18\n" +
-	" \x01(\bR\x10alarmBearingOnly\x12'\n" +
-	"\x0fhistorized_only\x18\v \x01(\bR\x0ehistorizedOnlyB\b\n" +
-	"\x06parentB\x15\n" +
-	"\x13_include_attributes\"\xfe\x01\n" +
-	"\x13BrowseChildrenReply\x12>\n" +
-	"\bchildren\x18\x01 \x03(\v2\".galaxy_repository.v1.GalaxyObjectR\bchildren\x12&\n" +
-	"\x0fnext_page_token\x18\x02 \x01(\tR\rnextPageToken\x12*\n" +
-	"\x11total_child_count\x18\x03 \x01(\x05R\x0ftotalChildCount\x12,\n" +
-	"\x12child_has_children\x18\x04 \x03(\bR\x10childHasChildren\x12%\n" +
-	"\x0ecache_sequence\x18\x05 \x01(\x04R\rcacheSequence2\xb6\x04\n" +
+	"\bis_alarm\x18\v \x01(\bR\aisAlarm2\xcc\x03\n" +
 	"\x10GalaxyRepository\x12h\n" +
 	"\x0eTestConnection\x12+.galaxy_repository.v1.TestConnectionRequest\x1a).galaxy_repository.v1.TestConnectionReply\x12q\n" +
 	"\x11GetLastDeployTime\x12..galaxy_repository.v1.GetLastDeployTimeRequest\x1a,.galaxy_repository.v1.GetLastDeployTimeReply\x12q\n" +
 	"\x11DiscoverHierarchy\x12..galaxy_repository.v1.DiscoverHierarchyRequest\x1a,.galaxy_repository.v1.DiscoverHierarchyReply\x12h\n" +
-	"\x11WatchDeployEvents\x12..galaxy_repository.v1.WatchDeployEventsRequest\x1a!.galaxy_repository.v1.DeployEvent0\x01\x12h\n" +
-	"\x0eBrowseChildren\x12+.galaxy_repository.v1.BrowseChildrenRequest\x1a).galaxy_repository.v1.BrowseChildrenReplyB-\xaa\x02*ZB.MOM.WW.MxGateway.Contracts.Proto.Galaxyb\x06proto3"
+	"\x11WatchDeployEvents\x12..galaxy_repository.v1.WatchDeployEventsRequest\x1a!.galaxy_repository.v1.DeployEvent0\x01B#\xaa\x02 MxGateway.Contracts.Proto.Galaxyb\x06proto3"
 
 var (
 	file_galaxy_repository_proto_rawDescOnce sync.Once
@@ -1193,7 +902,7 @@ func file_galaxy_repository_proto_rawDescGZIP() []byte {
 	return file_galaxy_repository_proto_rawDescData
 }
 
-var file_galaxy_repository_proto_msgTypes = make([]protoimpl.MessageInfo, 12)
+var file_galaxy_repository_proto_msgTypes = make([]protoimpl.MessageInfo, 10)
 var file_galaxy_repository_proto_goTypes = []any{
 	(*TestConnectionRequest)(nil),    // 0: galaxy_repository.v1.TestConnectionRequest
 	(*TestConnectionReply)(nil),      // 1: galaxy_repository.v1.TestConnectionReply
@@ -1205,35 +914,30 @@ var file_galaxy_repository_proto_goTypes = []any{
 	(*DeployEvent)(nil),              // 7: galaxy_repository.v1.DeployEvent
 	(*GalaxyObject)(nil),             // 8: galaxy_repository.v1.GalaxyObject
 	(*GalaxyAttribute)(nil),          // 9: galaxy_repository.v1.GalaxyAttribute
-	(*BrowseChildrenRequest)(nil),    // 10: galaxy_repository.v1.BrowseChildrenRequest
-	(*BrowseChildrenReply)(nil),      // 11: galaxy_repository.v1.BrowseChildrenReply
-	(*timestamppb.Timestamp)(nil),    // 12: google.protobuf.Timestamp
-	(*wrapperspb.Int32Value)(nil),    // 13: google.protobuf.Int32Value
+	(*timestamppb.Timestamp)(nil),    // 10: google.protobuf.Timestamp
+	(*wrapperspb.Int32Value)(nil),    // 11: google.protobuf.Int32Value
 }
 var file_galaxy_repository_proto_depIdxs = []int32{
-	12, // 0: galaxy_repository.v1.GetLastDeployTimeReply.time_of_last_deploy:type_name -> google.protobuf.Timestamp
-	13, // 1: galaxy_repository.v1.DiscoverHierarchyRequest.max_depth:type_name -> google.protobuf.Int32Value
+	10, // 0: galaxy_repository.v1.GetLastDeployTimeReply.time_of_last_deploy:type_name -> google.protobuf.Timestamp
+	11, // 1: galaxy_repository.v1.DiscoverHierarchyRequest.max_depth:type_name -> google.protobuf.Int32Value
 	8,  // 2: galaxy_repository.v1.DiscoverHierarchyReply.objects:type_name -> galaxy_repository.v1.GalaxyObject
-	12, // 3: galaxy_repository.v1.WatchDeployEventsRequest.last_seen_deploy_time:type_name -> google.protobuf.Timestamp
-	12, // 4: galaxy_repository.v1.DeployEvent.observed_at:type_name -> google.protobuf.Timestamp
-	12, // 5: galaxy_repository.v1.DeployEvent.time_of_last_deploy:type_name -> google.protobuf.Timestamp
+	10, // 3: galaxy_repository.v1.WatchDeployEventsRequest.last_seen_deploy_time:type_name -> google.protobuf.Timestamp
+	10, // 4: galaxy_repository.v1.DeployEvent.observed_at:type_name -> google.protobuf.Timestamp
+	10, // 5: galaxy_repository.v1.DeployEvent.time_of_last_deploy:type_name -> google.protobuf.Timestamp
 	9,  // 6: galaxy_repository.v1.GalaxyObject.attributes:type_name -> galaxy_repository.v1.GalaxyAttribute
-	8,  // 7: galaxy_repository.v1.BrowseChildrenReply.children:type_name -> galaxy_repository.v1.GalaxyObject
-	0,  // 8: galaxy_repository.v1.GalaxyRepository.TestConnection:input_type -> galaxy_repository.v1.TestConnectionRequest
-	2,  // 9: galaxy_repository.v1.GalaxyRepository.GetLastDeployTime:input_type -> galaxy_repository.v1.GetLastDeployTimeRequest
-	4,  // 10: galaxy_repository.v1.GalaxyRepository.DiscoverHierarchy:input_type -> galaxy_repository.v1.DiscoverHierarchyRequest
-	6,  // 11: galaxy_repository.v1.GalaxyRepository.WatchDeployEvents:input_type -> galaxy_repository.v1.WatchDeployEventsRequest
-	10, // 12: galaxy_repository.v1.GalaxyRepository.BrowseChildren:input_type -> galaxy_repository.v1.BrowseChildrenRequest
-	1,  // 13: galaxy_repository.v1.GalaxyRepository.TestConnection:output_type -> galaxy_repository.v1.TestConnectionReply
-	3,  // 14: galaxy_repository.v1.GalaxyRepository.GetLastDeployTime:output_type -> galaxy_repository.v1.GetLastDeployTimeReply
-	5,  // 15: galaxy_repository.v1.GalaxyRepository.DiscoverHierarchy:output_type -> galaxy_repository.v1.DiscoverHierarchyReply
-	7,  // 16: galaxy_repository.v1.GalaxyRepository.WatchDeployEvents:output_type -> galaxy_repository.v1.DeployEvent
-	11, // 17: galaxy_repository.v1.GalaxyRepository.BrowseChildren:output_type -> galaxy_repository.v1.BrowseChildrenReply
-	13, // [13:18] is the sub-list for method output_type
-	8,  // [8:13] is the sub-list for method input_type
-	8,  // [8:8] is the sub-list for extension type_name
-	8,  // [8:8] is the sub-list for extension extendee
-	0,  // [0:8] is the sub-list for field type_name
+	0,  // 7: galaxy_repository.v1.GalaxyRepository.TestConnection:input_type -> galaxy_repository.v1.TestConnectionRequest
+	2,  // 8: galaxy_repository.v1.GalaxyRepository.GetLastDeployTime:input_type -> galaxy_repository.v1.GetLastDeployTimeRequest
+	4,  // 9: galaxy_repository.v1.GalaxyRepository.DiscoverHierarchy:input_type -> galaxy_repository.v1.DiscoverHierarchyRequest
+	6,  // 10: galaxy_repository.v1.GalaxyRepository.WatchDeployEvents:input_type -> galaxy_repository.v1.WatchDeployEventsRequest
+	1,  // 11: galaxy_repository.v1.GalaxyRepository.TestConnection:output_type -> galaxy_repository.v1.TestConnectionReply
+	3,  // 12: galaxy_repository.v1.GalaxyRepository.GetLastDeployTime:output_type -> galaxy_repository.v1.GetLastDeployTimeReply
+	5,  // 13: galaxy_repository.v1.GalaxyRepository.DiscoverHierarchy:output_type -> galaxy_repository.v1.DiscoverHierarchyReply
+	7,  // 14: galaxy_repository.v1.GalaxyRepository.WatchDeployEvents:output_type -> galaxy_repository.v1.DeployEvent
+	11, // [11:15] is the sub-list for method output_type
+	7,  // [7:11] is the sub-list for method input_type
+	7,  // [7:7] is the sub-list for extension type_name
+	7,  // [7:7] is the sub-list for extension extendee
+	0,  // [0:7] is the sub-list for field type_name
 }
 
 func init() { file_galaxy_repository_proto_init() }
@@ -1246,18 +950,13 @@ func file_galaxy_repository_proto_init() {
 		(*DiscoverHierarchyRequest_RootTagName)(nil),
 		(*DiscoverHierarchyRequest_RootContainedPath)(nil),
 	}
-	file_galaxy_repository_proto_msgTypes[10].OneofWrappers = []any{
-		(*BrowseChildrenRequest_ParentGobjectId)(nil),
-		(*BrowseChildrenRequest_ParentTagName)(nil),
-		(*BrowseChildrenRequest_ParentContainedPath)(nil),
-	}
 	type x struct{}
 	out := protoimpl.TypeBuilder{
 		File: protoimpl.DescBuilder{
 			GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
 			RawDescriptor: unsafe.Slice(unsafe.StringData(file_galaxy_repository_proto_rawDesc), len(file_galaxy_repository_proto_rawDesc)),
 			NumEnums:      0,
-			NumMessages:   12,
+			NumMessages:   10,
 			NumExtensions: 0,
 			NumServices:   1,
 		},

clients/go/internal/generated/galaxy_repository_grpc.pb.go

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-go-grpc. DO NOT EDIT.
 // versions:
-// - protoc-gen-go-grpc v1.6.2
+// - protoc-gen-go-grpc v1.6.1
 // - protoc             v7.34.1
 // source: galaxy_repository.proto
 
@@ -23,7 +23,6 @@ const (
 	GalaxyRepository_GetLastDeployTime_FullMethodName = "/galaxy_repository.v1.GalaxyRepository/GetLastDeployTime"
 	GalaxyRepository_DiscoverHierarchy_FullMethodName = "/galaxy_repository.v1.GalaxyRepository/DiscoverHierarchy"
 	GalaxyRepository_WatchDeployEvents_FullMethodName = "/galaxy_repository.v1.GalaxyRepository/WatchDeployEvents"
-	GalaxyRepository_BrowseChildren_FullMethodName    = "/galaxy_repository.v1.GalaxyRepository/BrowseChildren"
 )
 
 // GalaxyRepositoryClient is the client API for GalaxyRepository service.
@@ -45,11 +44,6 @@ type GalaxyRepositoryClient interface {
 	// increasing per server start; gaps indicate the per-subscriber buffer dropped
 	// older events because the client was too slow.
 	WatchDeployEvents(ctx context.Context, in *WatchDeployEventsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[DeployEvent], error)
-	// Returns the direct children of a parent object (or the root objects when
-	// `parent` is unset). Designed for OPC UA-style lazy expand: clients walk
-	// one level at a time instead of paging the full hierarchy. Filters mirror
-	// DiscoverHierarchy exactly. Backed by the same shared hierarchy cache.
-	BrowseChildren(ctx context.Context, in *BrowseChildrenRequest, opts ...grpc.CallOption) (*BrowseChildrenReply, error)
 }
 
 type galaxyRepositoryClient struct {
@@ -109,16 +103,6 @@ func (c *galaxyRepositoryClient) WatchDeployEvents(ctx context.Context, in *Watc
 // This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
 type GalaxyRepository_WatchDeployEventsClient = grpc.ServerStreamingClient[DeployEvent]
 
-func (c *galaxyRepositoryClient) BrowseChildren(ctx context.Context, in *BrowseChildrenRequest, opts ...grpc.CallOption) (*BrowseChildrenReply, error) {
-	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
-	out := new(BrowseChildrenReply)
-	err := c.cc.Invoke(ctx, GalaxyRepository_BrowseChildren_FullMethodName, in, out, cOpts...)
-	if err != nil {
-		return nil, err
-	}
-	return out, nil
-}
-
 // GalaxyRepositoryServer is the server API for GalaxyRepository service.
 // All implementations must embed UnimplementedGalaxyRepositoryServer
 // for forward compatibility.
@@ -138,11 +122,6 @@ type GalaxyRepositoryServer interface {
 	// increasing per server start; gaps indicate the per-subscriber buffer dropped
 	// older events because the client was too slow.
 	WatchDeployEvents(*WatchDeployEventsRequest, grpc.ServerStreamingServer[DeployEvent]) error
-	// Returns the direct children of a parent object (or the root objects when
-	// `parent` is unset). Designed for OPC UA-style lazy expand: clients walk
-	// one level at a time instead of paging the full hierarchy. Filters mirror
-	// DiscoverHierarchy exactly. Backed by the same shared hierarchy cache.
-	BrowseChildren(context.Context, *BrowseChildrenRequest) (*BrowseChildrenReply, error)
 	mustEmbedUnimplementedGalaxyRepositoryServer()
 }
 
@@ -165,9 +144,6 @@ func (UnimplementedGalaxyRepositoryServer) DiscoverHierarchy(context.Context, *D
 func (UnimplementedGalaxyRepositoryServer) WatchDeployEvents(*WatchDeployEventsRequest, grpc.ServerStreamingServer[DeployEvent]) error {
 	return status.Error(codes.Unimplemented, "method WatchDeployEvents not implemented")
 }
-func (UnimplementedGalaxyRepositoryServer) BrowseChildren(context.Context, *BrowseChildrenRequest) (*BrowseChildrenReply, error) {
-	return nil, status.Error(codes.Unimplemented, "method BrowseChildren not implemented")
-}
 func (UnimplementedGalaxyRepositoryServer) mustEmbedUnimplementedGalaxyRepositoryServer() {}
 func (UnimplementedGalaxyRepositoryServer) testEmbeddedByValue()                          {}
 
@@ -254,24 +230,6 @@ func _GalaxyRepository_WatchDeployEvents_Handler(srv interface{}, stream grpc.Se
 // This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
 type GalaxyRepository_WatchDeployEventsServer = grpc.ServerStreamingServer[DeployEvent]
 
-func _GalaxyRepository_BrowseChildren_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
-	in := new(BrowseChildrenRequest)
-	if err := dec(in); err != nil {
-		return nil, err
-	}
-	if interceptor == nil {
-		return srv.(GalaxyRepositoryServer).BrowseChildren(ctx, in)
-	}
-	info := &grpc.UnaryServerInfo{
-		Server:     srv,
-		FullMethod: GalaxyRepository_BrowseChildren_FullMethodName,
-	}
-	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
-		return srv.(GalaxyRepositoryServer).BrowseChildren(ctx, req.(*BrowseChildrenRequest))
-	}
-	return interceptor(ctx, in, info, handler)
-}
-
 // GalaxyRepository_ServiceDesc is the grpc.ServiceDesc for GalaxyRepository service.
 // It's only intended for direct use with grpc.RegisterService,
 // and not to be introspected or modified (even as a copy)
@@ -291,10 +249,6 @@ var GalaxyRepository_ServiceDesc = grpc.ServiceDesc{
 			MethodName: "DiscoverHierarchy",
 			Handler:    _GalaxyRepository_DiscoverHierarchy_Handler,
 		},
-		{
-			MethodName: "BrowseChildren",
-			Handler:    _GalaxyRepository_BrowseChildren_Handler,
-		},
 	},
 	Streams: []grpc.StreamDesc{
 		{

clients/go/internal/generated/mxaccess_gateway_grpc.pb.go

@@ -1,6 +1,6 @@
 // Code generated by protoc-gen-go-grpc. DO NOT EDIT.
 // versions:
-// - protoc-gen-go-grpc v1.6.2
+// - protoc-gen-go-grpc v1.6.1
 // - protoc             v7.34.1
 // source: mxaccess_gateway.proto
 
@@ -24,7 +24,6 @@ const (
 	MxAccessGateway_Invoke_FullMethodName            = "/mxaccess_gateway.v1.MxAccessGateway/Invoke"
 	MxAccessGateway_StreamEvents_FullMethodName      = "/mxaccess_gateway.v1.MxAccessGateway/StreamEvents"
 	MxAccessGateway_AcknowledgeAlarm_FullMethodName  = "/mxaccess_gateway.v1.MxAccessGateway/AcknowledgeAlarm"
-	MxAccessGateway_StreamAlarms_FullMethodName      = "/mxaccess_gateway.v1.MxAccessGateway/StreamAlarms"
 	MxAccessGateway_QueryActiveAlarms_FullMethodName = "/mxaccess_gateway.v1.MxAccessGateway/QueryActiveAlarms"
 )
 
@@ -39,20 +38,6 @@ type MxAccessGatewayClient interface {
 	Invoke(ctx context.Context, in *MxCommandRequest, opts ...grpc.CallOption) (*MxCommandReply, error)
 	StreamEvents(ctx context.Context, in *StreamEventsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[MxEvent], error)
 	AcknowledgeAlarm(ctx context.Context, in *AcknowledgeAlarmRequest, opts ...grpc.CallOption) (*AcknowledgeAlarmReply, error)
-	// Session-less central alarm feed. The stream opens with the current
-	// active-alarm snapshot (one `active_alarm` per alarm), then a single
-	// `snapshot_complete`, then a `transition` for every subsequent change.
-	// Served by the gateway's always-on alarm monitor; any number of clients
-	// fan out from the single monitor without opening a worker session.
-	StreamAlarms(ctx context.Context, in *StreamAlarmsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[AlarmFeedMessage], error)
-	// Point-in-time snapshot of the currently-active alarm set served from the
-	// gateway's always-on alarm monitor cache (session-less). Used after a
-	// reconnect to seed Part 9 client state, or to reconcile alarms that may
-	// have been missed during a transport blip. Streamed so callers can
-	// begin processing without buffering the full set.
-	// `QueryActiveAlarmsRequest.alarm_filter_prefix` optionally narrows the
-	// snapshot to alarms whose `alarm_full_reference` starts with the given
-	// prefix; an empty prefix returns the full set.
 	QueryActiveAlarms(ctx context.Context, in *QueryActiveAlarmsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[ActiveAlarmSnapshot], error)
 }
 
@@ -123,28 +108,9 @@ func (c *mxAccessGatewayClient) AcknowledgeAlarm(ctx context.Context, in *Acknow
 	return out, nil
 }
 
-func (c *mxAccessGatewayClient) StreamAlarms(ctx context.Context, in *StreamAlarmsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[AlarmFeedMessage], error) {
-	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
-	stream, err := c.cc.NewStream(ctx, &MxAccessGateway_ServiceDesc.Streams[1], MxAccessGateway_StreamAlarms_FullMethodName, cOpts...)
-	if err != nil {
-		return nil, err
-	}
-	x := &grpc.GenericClientStream[StreamAlarmsRequest, AlarmFeedMessage]{ClientStream: stream}
-	if err := x.ClientStream.SendMsg(in); err != nil {
-		return nil, err
-	}
-	if err := x.ClientStream.CloseSend(); err != nil {
-		return nil, err
-	}
-	return x, nil
-}
-
-// This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
-type MxAccessGateway_StreamAlarmsClient = grpc.ServerStreamingClient[AlarmFeedMessage]
-
 func (c *mxAccessGatewayClient) QueryActiveAlarms(ctx context.Context, in *QueryActiveAlarmsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[ActiveAlarmSnapshot], error) {
 	cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...)
-	stream, err := c.cc.NewStream(ctx, &MxAccessGateway_ServiceDesc.Streams[2], MxAccessGateway_QueryActiveAlarms_FullMethodName, cOpts...)
+	stream, err := c.cc.NewStream(ctx, &MxAccessGateway_ServiceDesc.Streams[1], MxAccessGateway_QueryActiveAlarms_FullMethodName, cOpts...)
 	if err != nil {
 		return nil, err
 	}
@@ -172,20 +138,6 @@ type MxAccessGatewayServer interface {
 	Invoke(context.Context, *MxCommandRequest) (*MxCommandReply, error)
 	StreamEvents(*StreamEventsRequest, grpc.ServerStreamingServer[MxEvent]) error
 	AcknowledgeAlarm(context.Context, *AcknowledgeAlarmRequest) (*AcknowledgeAlarmReply, error)
-	// Session-less central alarm feed. The stream opens with the current
-	// active-alarm snapshot (one `active_alarm` per alarm), then a single
-	// `snapshot_complete`, then a `transition` for every subsequent change.
-	// Served by the gateway's always-on alarm monitor; any number of clients
-	// fan out from the single monitor without opening a worker session.
-	StreamAlarms(*StreamAlarmsRequest, grpc.ServerStreamingServer[AlarmFeedMessage]) error
-	// Point-in-time snapshot of the currently-active alarm set served from the
-	// gateway's always-on alarm monitor cache (session-less). Used after a
-	// reconnect to seed Part 9 client state, or to reconcile alarms that may
-	// have been missed during a transport blip. Streamed so callers can
-	// begin processing without buffering the full set.
-	// `QueryActiveAlarmsRequest.alarm_filter_prefix` optionally narrows the
-	// snapshot to alarms whose `alarm_full_reference` starts with the given
-	// prefix; an empty prefix returns the full set.
 	QueryActiveAlarms(*QueryActiveAlarmsRequest, grpc.ServerStreamingServer[ActiveAlarmSnapshot]) error
 	mustEmbedUnimplementedMxAccessGatewayServer()
 }
@@ -212,9 +164,6 @@ func (UnimplementedMxAccessGatewayServer) StreamEvents(*StreamEventsRequest, grp
 func (UnimplementedMxAccessGatewayServer) AcknowledgeAlarm(context.Context, *AcknowledgeAlarmRequest) (*AcknowledgeAlarmReply, error) {
 	return nil, status.Error(codes.Unimplemented, "method AcknowledgeAlarm not implemented")
 }
-func (UnimplementedMxAccessGatewayServer) StreamAlarms(*StreamAlarmsRequest, grpc.ServerStreamingServer[AlarmFeedMessage]) error {
-	return status.Error(codes.Unimplemented, "method StreamAlarms not implemented")
-}
 func (UnimplementedMxAccessGatewayServer) QueryActiveAlarms(*QueryActiveAlarmsRequest, grpc.ServerStreamingServer[ActiveAlarmSnapshot]) error {
 	return status.Error(codes.Unimplemented, "method QueryActiveAlarms not implemented")
 }
@@ -322,17 +271,6 @@ func _MxAccessGateway_AcknowledgeAlarm_Handler(srv interface{}, ctx context.Cont
 	return interceptor(ctx, in, info, handler)
 }
 
-func _MxAccessGateway_StreamAlarms_Handler(srv interface{}, stream grpc.ServerStream) error {
-	m := new(StreamAlarmsRequest)
-	if err := stream.RecvMsg(m); err != nil {
-		return err
-	}
-	return srv.(MxAccessGatewayServer).StreamAlarms(m, &grpc.GenericServerStream[StreamAlarmsRequest, AlarmFeedMessage]{ServerStream: stream})
-}
-
-// This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.
-type MxAccessGateway_StreamAlarmsServer = grpc.ServerStreamingServer[AlarmFeedMessage]
-
 func _MxAccessGateway_QueryActiveAlarms_Handler(srv interface{}, stream grpc.ServerStream) error {
 	m := new(QueryActiveAlarmsRequest)
 	if err := stream.RecvMsg(m); err != nil {
@@ -374,11 +312,6 @@ var MxAccessGateway_ServiceDesc = grpc.ServiceDesc{
 			Handler:       _MxAccessGateway_StreamEvents_Handler,
 			ServerStreams: true,
 		},
-		{
-			StreamName:    "StreamAlarms",
-			Handler:       _MxAccessGateway_StreamAlarms_Handler,
-			ServerStreams: true,
-		},
 		{
 			StreamName:    "QueryActiveAlarms",
 			Handler:       _MxAccessGateway_QueryActiveAlarms_Handler,

clients/go/internal/generated/mxaccess_worker.pb.go

@@ -1179,7 +1179,7 @@ const file_mxaccess_worker_proto_rawDesc = "" +
 	"\x1eWORKER_FAULT_CATEGORY_STA_HUNG\x10\t\x12(\n" +
 	"$WORKER_FAULT_CATEGORY_QUEUE_OVERFLOW\x10\n" +
 	"\x12*\n" +
-	"&WORKER_FAULT_CATEGORY_SHUTDOWN_TIMEOUT\x10\vB&\xaa\x02#ZB.MOM.WW.MxGateway.Contracts.Protob\x06proto3"
+	"&WORKER_FAULT_CATEGORY_SHUTDOWN_TIMEOUT\x10\vB\x1c\xaa\x02\x19MxGateway.Contracts.Protob\x06proto3"
 
 var (
 	file_mxaccess_worker_proto_rawDescOnce sync.Once

clients/go/mxgateway/alarms.go

@@ -51,26 +51,3 @@ func (c *Client) QueryActiveAlarms(ctx context.Context, req *QueryActiveAlarmsRe
 
 	return stream, nil
 }
-
-// StreamAlarms attaches to the gateway's central alarm feed. The stream opens
-// with one AlarmFeedMessage per currently-active alarm (the ConditionRefresh
-// snapshot), then a single snapshot-complete sentinel, then a transition for
-// every subsequent raise / acknowledge / clear. It is served by the gateway's
-// always-on alarm monitor — no worker session is opened — so any number of
-// clients may attach.
-//
-// The returned stream is owned by the caller; cancel ctx to release it.
-// Optional alarm-reference prefix scoping (req.AlarmFilterPrefix) limits the
-// stream to a sub-tree.
-func (c *Client) StreamAlarms(ctx context.Context, req *StreamAlarmsRequest) (StreamAlarmsClient, error) {
-	if req == nil {
-		return nil, errors.New("mxgateway: stream alarms request is required")
-	}
-
-	stream, err := c.raw.StreamAlarms(ctx, req)
-	if err != nil {
-		return nil, &GatewayError{Op: "stream alarms", Err: err}
-	}
-
-	return stream, nil
-}

clients/go/mxgateway/alarms_test.go

@@ -20,6 +20,7 @@ import (
 func TestAcknowledgeAlarmSendsRequestAndReturnsReply(t *testing.T) {
 	fake := &fakeGatewayWithAlarms{
 		acknowledgeReply: &pb.AcknowledgeAlarmReply{
+			SessionId:     "session-1",
 			CorrelationId: "corr-1",
 			ProtocolStatus: &pb.ProtocolStatus{
 				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
@@ -34,6 +35,7 @@ func TestAcknowledgeAlarmSendsRequestAndReturnsReply(t *testing.T) {
 	defer cleanup()
 
 	reply, err := client.AcknowledgeAlarm(context.Background(), &pb.AcknowledgeAlarmRequest{
+		SessionId:           "session-1",
 		ClientCorrelationId: "corr-1",
 		AlarmFullReference:  "Tank01.Level.HiHi",
 		Comment:             "investigating",
@@ -79,6 +81,7 @@ func TestAcknowledgeAlarmMapsUnauthenticated(t *testing.T) {
 	defer cleanup()
 
 	_, err := client.AcknowledgeAlarm(context.Background(), &pb.AcknowledgeAlarmRequest{
+		SessionId:          "session-1",
 		AlarmFullReference: "Tank01.Level.HiHi",
 		OperatorUser:       "alice",
 	})
@@ -147,8 +150,8 @@ func TestQueryActiveAlarmsPassesFilterPrefix(t *testing.T) {
 	defer cleanup()
 
 	stream, err := client.QueryActiveAlarms(context.Background(), &pb.QueryActiveAlarmsRequest{
-		SessionId:         "session-1",
-		AlarmFilterPrefix: "Tank01.",
+		SessionId:          "session-1",
+		AlarmFilterPrefix:  "Tank01.",
 	})
 	if err != nil {
 		t.Fatalf("QueryActiveAlarms() error = %v", err)
@@ -168,66 +171,6 @@ func TestQueryActiveAlarmsPassesFilterPrefix(t *testing.T) {
 	}
 }
 
-func TestStreamAlarmsPassesFilterPrefixAndReceivesFeedMessages(t *testing.T) {
-	fake := &fakeGatewayWithAlarms{
-		feedMessages: []*pb.AlarmFeedMessage{
-			{
-				Payload: &pb.AlarmFeedMessage_ActiveAlarm{
-					ActiveAlarm: &pb.ActiveAlarmSnapshot{
-						AlarmFullReference: "Tank01.Level.HiHi",
-						CurrentState:       pb.AlarmConditionState_ALARM_CONDITION_STATE_ACTIVE,
-					},
-				},
-			},
-			{
-				Payload: &pb.AlarmFeedMessage_SnapshotComplete{
-					SnapshotComplete: true,
-				},
-			},
-		},
-	}
-	client, cleanup := newBufconnClientWithAlarms(t, fake)
-	defer cleanup()
-
-	stream, err := client.StreamAlarms(context.Background(), &pb.StreamAlarmsRequest{
-		AlarmFilterPrefix: "Tank01.",
-	})
-	if err != nil {
-		t.Fatalf("StreamAlarms() error = %v", err)
-	}
-
-	var received []*pb.AlarmFeedMessage
-	for {
-		msg, err := stream.Recv()
-		if errors.Is(err, io.EOF) {
-			break
-		}
-		if err != nil {
-			t.Fatalf("stream.Recv() error = %v", err)
-		}
-		received = append(received, msg)
-	}
-	if len(received) != 2 {
-		t.Fatalf("received count = %d, want 2", len(received))
-	}
-	if got := fake.streamRequest.GetAlarmFilterPrefix(); got != "Tank01." {
-		t.Fatalf("captured filter prefix = %q", got)
-	}
-	if got := fake.streamAuth; got != "Bearer test-api-key" {
-		t.Fatalf("stream authorization metadata = %q", got)
-	}
-}
-
-func TestStreamAlarmsRejectsNilRequest(t *testing.T) {
-	fake := &fakeGatewayWithAlarms{}
-	client, cleanup := newBufconnClientWithAlarms(t, fake)
-	defer cleanup()
-
-	if _, err := client.StreamAlarms(context.Background(), nil); err == nil {
-		t.Fatal("StreamAlarms(nil) returned no error")
-	}
-}
-
 type fakeGatewayWithAlarms struct {
 	pb.UnimplementedMxAccessGatewayServer
 
@@ -238,10 +181,6 @@ type fakeGatewayWithAlarms struct {
 
 	queryRequest    *pb.QueryActiveAlarmsRequest
 	activeSnapshots []*pb.ActiveAlarmSnapshot
-
-	streamRequest *pb.StreamAlarmsRequest
-	feedMessages  []*pb.AlarmFeedMessage
-	streamAuth    string
 }
 
 func (s *fakeGatewayWithAlarms) AcknowledgeAlarm(ctx context.Context, req *pb.AcknowledgeAlarmRequest) (*pb.AcknowledgeAlarmReply, error) {
@@ -254,7 +193,7 @@ func (s *fakeGatewayWithAlarms) AcknowledgeAlarm(ctx context.Context, req *pb.Ac
 		return s.acknowledgeReply, nil
 	}
 	return &pb.AcknowledgeAlarmReply{
-		CorrelationId: req.GetClientCorrelationId(),
+		SessionId: req.GetSessionId(),
 		ProtocolStatus: &pb.ProtocolStatus{
 			Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
 		},
@@ -271,17 +210,6 @@ func (s *fakeGatewayWithAlarms) QueryActiveAlarms(req *pb.QueryActiveAlarmsReque
 	return nil
 }
 
-func (s *fakeGatewayWithAlarms) StreamAlarms(req *pb.StreamAlarmsRequest, stream grpc.ServerStreamingServer[pb.AlarmFeedMessage]) error {
-	s.streamRequest = req
-	s.streamAuth = authorizationFromContext(stream.Context())
-	for _, msg := range s.feedMessages {
-		if err := stream.Send(msg); err != nil {
-			return err
-		}
-	}
-	return nil
-}
-
 func newBufconnClientWithAlarms(t *testing.T, fake *fakeGatewayWithAlarms) (*Client, func()) {
 	t.Helper()
 	listener := bufconn.Listen(bufSize)

clients/go/mxgateway/client.go

@@ -222,22 +222,10 @@ func resolveTransportCredentials(opts Options) (credentials.TransportCredentials
 		return credentials.NewTLS(cfg), nil
 	}
 
-	return credentials.NewTLS(tlsConfigForOptions(opts)), nil
-}
-
-// tlsConfigForOptions returns the *tls.Config for the no-CA, no-custom-config TLS path.
-// It returns nil when the caller should use a different credentials path (CA file or custom TLSConfig).
-// Exposed as an internal helper so unit tests can assert the InsecureSkipVerify posture.
-func tlsConfigForOptions(opts Options) *tls.Config {
-	// CA file and custom TLSConfig take their own paths in resolveTransportCredentials.
-	if opts.CACertFile != "" || opts.TLSConfig != nil {
-		return nil
-	}
-	return &tls.Config{
-		MinVersion:         tls.VersionTLS12,
-		ServerName:         opts.ServerNameOverride,
-		InsecureSkipVerify: !opts.RequireCertificateValidation, //nolint:gosec // internal tool; self-signed gateway cert expected; opt-in strict via RequireCertificateValidation
-	}
+	return credentials.NewTLS(&tls.Config{
+		MinVersion: tls.VersionTLS12,
+		ServerName: opts.ServerNameOverride,
+	}), nil
 }
 
 // OpenSessionOptions describes fields used to create an OpenSessionRequest.

clients/go/mxgateway/client_session_test.go

@@ -230,289 +230,6 @@ func TestSubscribeBulkBuildsOneBulkCommandAndReturnsResults(t *testing.T) {
 	}
 }
 
-func TestWriteBulkBuildsOneBulkCommandAndReturnsPerEntryResults(t *testing.T) {
-	fake := &fakeGatewayServer{
-		invokeReply: &pb.MxCommandReply{
-			SessionId: "session-1",
-			Kind:      pb.MxCommandKind_MX_COMMAND_KIND_WRITE_BULK,
-			ProtocolStatus: &pb.ProtocolStatus{
-				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
-			},
-			Payload: &pb.MxCommandReply_WriteBulk{
-				WriteBulk: &pb.BulkWriteReply{
-					Results: []*pb.BulkWriteResult{
-						{ItemHandle: 10, WasSuccessful: true},
-						{ItemHandle: 11, WasSuccessful: true},
-					},
-				},
-			},
-		},
-	}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	entries := []*WriteBulkEntry{
-		{ItemHandle: 10, Value: Int32Value(7), UserId: 100},
-		{ItemHandle: 11, Value: Int32Value(8), UserId: 100},
-	}
-	results, err := session.WriteBulk(context.Background(), 12, entries)
-	if err != nil {
-		t.Fatalf("WriteBulk() error = %v", err)
-	}
-	if len(results) != 2 {
-		t.Fatalf("results len = %d, want 2", len(results))
-	}
-	req := fake.invokeRequest
-	if req.GetCommand().GetKind() != pb.MxCommandKind_MX_COMMAND_KIND_WRITE_BULK {
-		t.Fatalf("command kind = %s", req.GetCommand().GetKind())
-	}
-	if got := req.GetCommand().GetWriteBulk().GetEntries(); len(got) != 2 {
-		t.Fatalf("entry count = %d, want 2", len(got))
-	}
-}
-
-func TestWriteBulkRejectsNilEntries(t *testing.T) {
-	fake := &fakeGatewayServer{}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	if _, err := session.WriteBulk(context.Background(), 12, nil); err == nil {
-		t.Fatal("WriteBulk(nil) returned no error")
-	}
-	if _, err := session.Write2Bulk(context.Background(), 12, nil); err == nil {
-		t.Fatal("Write2Bulk(nil) returned no error")
-	}
-	if _, err := session.WriteSecuredBulk(context.Background(), 12, nil); err == nil {
-		t.Fatal("WriteSecuredBulk(nil) returned no error")
-	}
-	if _, err := session.WriteSecured2Bulk(context.Background(), 12, nil); err == nil {
-		t.Fatal("WriteSecured2Bulk(nil) returned no error")
-	}
-	if _, err := session.ReadBulk(context.Background(), 12, nil, 0); err == nil {
-		t.Fatal("ReadBulk(nil) returned no error")
-	}
-}
-
-func TestBulkMethodsShortCircuitOnEmptySliceWithoutRoundTrip(t *testing.T) {
-	fake := &fakeGatewayServer{
-		invokeReply: &pb.MxCommandReply{
-			ProtocolStatus: &pb.ProtocolStatus{
-				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
-			},
-		},
-	}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	results, err := session.WriteBulk(context.Background(), 12, []*WriteBulkEntry{})
-	if err != nil {
-		t.Fatalf("WriteBulk(empty) error = %v", err)
-	}
-	if len(results) != 0 {
-		t.Fatalf("WriteBulk(empty) results len = %d, want 0", len(results))
-	}
-	if fake.invokeRequest != nil {
-		t.Fatal("WriteBulk(empty) sent a round trip; expected short-circuit")
-	}
-
-	results2, err := session.Write2Bulk(context.Background(), 12, []*Write2BulkEntry{})
-	if err != nil {
-		t.Fatalf("Write2Bulk(empty) error = %v", err)
-	}
-	if len(results2) != 0 {
-		t.Fatalf("Write2Bulk(empty) results len = %d, want 0", len(results2))
-	}
-	if fake.invokeRequest != nil {
-		t.Fatal("Write2Bulk(empty) sent a round trip; expected short-circuit")
-	}
-
-	results3, err := session.WriteSecuredBulk(context.Background(), 12, []*WriteSecuredBulkEntry{})
-	if err != nil {
-		t.Fatalf("WriteSecuredBulk(empty) error = %v", err)
-	}
-	if len(results3) != 0 {
-		t.Fatalf("WriteSecuredBulk(empty) results len = %d, want 0", len(results3))
-	}
-	if fake.invokeRequest != nil {
-		t.Fatal("WriteSecuredBulk(empty) sent a round trip; expected short-circuit")
-	}
-
-	results4, err := session.WriteSecured2Bulk(context.Background(), 12, []*WriteSecured2BulkEntry{})
-	if err != nil {
-		t.Fatalf("WriteSecured2Bulk(empty) error = %v", err)
-	}
-	if len(results4) != 0 {
-		t.Fatalf("WriteSecured2Bulk(empty) results len = %d, want 0", len(results4))
-	}
-	if fake.invokeRequest != nil {
-		t.Fatal("WriteSecured2Bulk(empty) sent a round trip; expected short-circuit")
-	}
-
-	readResults, err := session.ReadBulk(context.Background(), 12, []string{}, 0)
-	if err != nil {
-		t.Fatalf("ReadBulk(empty) error = %v", err)
-	}
-	if len(readResults) != 0 {
-		t.Fatalf("ReadBulk(empty) results len = %d, want 0", len(readResults))
-	}
-	if fake.invokeRequest != nil {
-		t.Fatal("ReadBulk(empty) sent a round trip; expected short-circuit")
-	}
-}
-
-func TestWrite2BuildsCommandWithTimestampAndReturnsNoError(t *testing.T) {
-	fake := &fakeGatewayServer{
-		invokeReply: &pb.MxCommandReply{
-			SessionId: "session-1",
-			Kind:      pb.MxCommandKind_MX_COMMAND_KIND_WRITE2,
-			ProtocolStatus: &pb.ProtocolStatus{
-				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
-			},
-		},
-	}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	val := Int32Value(99)
-	ts := Int32Value(77)
-	err := session.Write2(context.Background(), 12, 34, val, ts, 100)
-	if err != nil {
-		t.Fatalf("Write2() error = %v", err)
-	}
-
-	req := fake.invokeRequest
-	if req.GetCommand().GetKind() != pb.MxCommandKind_MX_COMMAND_KIND_WRITE2 {
-		t.Fatalf("command kind = %s, want WRITE2", req.GetCommand().GetKind())
-	}
-	w2 := req.GetCommand().GetWrite2()
-	if w2.GetServerHandle() != 12 {
-		t.Fatalf("server handle = %d, want 12", w2.GetServerHandle())
-	}
-	if w2.GetItemHandle() != 34 {
-		t.Fatalf("item handle = %d, want 34", w2.GetItemHandle())
-	}
-	if w2.GetValue().GetInt32Value() != 99 {
-		t.Fatalf("value int32 = %d, want 99", w2.GetValue().GetInt32Value())
-	}
-	if w2.GetTimestampValue().GetInt32Value() != 77 {
-		t.Fatalf("timestamp value int32 = %d, want 77", w2.GetTimestampValue().GetInt32Value())
-	}
-	if w2.GetUserId() != 100 {
-		t.Fatalf("user id = %d, want 100", w2.GetUserId())
-	}
-}
-
-func TestWrite2RawReturnsRawReply(t *testing.T) {
-	fake := &fakeGatewayServer{
-		invokeReply: &pb.MxCommandReply{
-			SessionId: "session-1",
-			Kind:      pb.MxCommandKind_MX_COMMAND_KIND_WRITE2,
-			ProtocolStatus: &pb.ProtocolStatus{
-				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
-			},
-		},
-	}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	reply, err := session.Write2Raw(context.Background(), 12, 34, Int32Value(1), Int32Value(0), 0)
-	if err != nil {
-		t.Fatalf("Write2Raw() error = %v", err)
-	}
-	if reply == nil {
-		t.Fatal("Write2Raw() returned nil reply")
-	}
-	if reply.GetKind() != pb.MxCommandKind_MX_COMMAND_KIND_WRITE2 {
-		t.Fatalf("reply kind = %s, want WRITE2", reply.GetKind())
-	}
-}
-
-func TestWrite2RejectsNilValue(t *testing.T) {
-	fake := &fakeGatewayServer{}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	if err := session.Write2(context.Background(), 12, 34, nil, Int32Value(0), 0); err == nil {
-		t.Fatal("Write2(nil value) returned no error")
-	}
-	if err := session.Write2(context.Background(), 12, 34, Int32Value(1), nil, 0); err == nil {
-		t.Fatal("Write2(nil timestampValue) returned no error")
-	}
-}
-
-func TestReadBulkForwardsTimeoutAndUnpacksCachedFlag(t *testing.T) {
-	fake := &fakeGatewayServer{
-		invokeReply: &pb.MxCommandReply{
-			SessionId: "session-1",
-			Kind:      pb.MxCommandKind_MX_COMMAND_KIND_READ_BULK,
-			ProtocolStatus: &pb.ProtocolStatus{
-				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
-			},
-			Payload: &pb.MxCommandReply_ReadBulk{
-				ReadBulk: &pb.BulkReadReply{
-					Results: []*pb.BulkReadResult{
-						{TagAddress: "Tank01.Level", WasSuccessful: true, WasCached: true},
-						{TagAddress: "Tank02.Level", WasSuccessful: true, WasCached: false},
-					},
-				},
-			},
-		},
-	}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	results, err := session.ReadBulk(context.Background(), 12, []string{"Tank01.Level", "Tank02.Level"}, 250*time.Millisecond)
-	if err != nil {
-		t.Fatalf("ReadBulk() error = %v", err)
-	}
-	if len(results) != 2 {
-		t.Fatalf("results len = %d, want 2", len(results))
-	}
-	if !results[0].GetWasCached() || results[1].GetWasCached() {
-		t.Fatalf("WasCached flags = [%v %v], want [true false]", results[0].GetWasCached(), results[1].GetWasCached())
-	}
-	req := fake.invokeRequest
-	if req.GetCommand().GetKind() != pb.MxCommandKind_MX_COMMAND_KIND_READ_BULK {
-		t.Fatalf("command kind = %s", req.GetCommand().GetKind())
-	}
-	if got := req.GetCommand().GetReadBulk().GetTimeoutMs(); got != 250 {
-		t.Fatalf("timeout ms = %d, want 250", got)
-	}
-}
-
-func TestReadBulkSaturatesTimeoutAboveMaxUint32(t *testing.T) {
-	fake := &fakeGatewayServer{
-		invokeReply: &pb.MxCommandReply{
-			SessionId: "session-1",
-			Kind:      pb.MxCommandKind_MX_COMMAND_KIND_READ_BULK,
-			ProtocolStatus: &pb.ProtocolStatus{
-				Code: pb.ProtocolStatusCode_PROTOCOL_STATUS_CODE_OK,
-			},
-		},
-	}
-	client, cleanup := newBufconnClient(t, fake)
-	defer cleanup()
-	session := NewSessionForID(client, "session-1")
-
-	// 100 days in milliseconds exceeds MaxUint32 (~49.7 days).
-	hugeTimeout := 100 * 24 * time.Hour
-	_, err := session.ReadBulk(context.Background(), 12, []string{"Tank01.Level"}, hugeTimeout)
-	if err != nil {
-		t.Fatalf("ReadBulk() error = %v", err)
-	}
-	got := fake.invokeRequest.GetCommand().GetReadBulk().GetTimeoutMs()
-	if got != ^uint32(0) {
-		t.Fatalf("timeout ms = %d, want %d (MaxUint32)", got, ^uint32(0))
-	}
-}
-
 func TestInvokeReturnsTypedMxAccessErrorWithRawReply(t *testing.T) {
 	hresult := int32(-2147467259)
 	fake := &fakeGatewayServer{

clients/go/mxgateway/client_tls_test.go

@@ -1,59 +0,0 @@
-package mxgateway
-
-import (
-	"crypto/tls"
-	"testing"
-)
-
-// tlsConfigFromOptions is the internal helper under test.
-// It extracts the *tls.Config from the no-CA TLS path of resolveTransportCredentials.
-// We exercise it directly to avoid needing a real dial target.
-
-func TestTLSInsecureSkipVerify_DefaultTrue(t *testing.T) {
-	cfg := tlsConfigForOptions(Options{
-		Endpoint: "localhost:5120",
-	})
-	if cfg == nil {
-		t.Fatal("expected non-nil tls.Config")
-	}
-	if !cfg.InsecureSkipVerify {
-		t.Error("InsecureSkipVerify should be true by default when no CA is pinned")
-	}
-}
-
-func TestTLSInsecureSkipVerify_FalseWhenRequireCertificateValidation(t *testing.T) {
-	cfg := tlsConfigForOptions(Options{
-		Endpoint:                     "localhost:5120",
-		RequireCertificateValidation: true,
-	})
-	if cfg == nil {
-		t.Fatal("expected non-nil tls.Config")
-	}
-	if cfg.InsecureSkipVerify {
-		t.Error("InsecureSkipVerify should be false when RequireCertificateValidation is true")
-	}
-}
-
-func TestTLSInsecureSkipVerify_FalseWhenCACertFileSet(t *testing.T) {
-	// When a CA file is pinned, the CA-verification path is taken instead.
-	// tlsConfigForOptions should return nil (the CA path does not use our helper).
-	cfg := tlsConfigForOptions(Options{
-		Endpoint:   "localhost:5120",
-		CACertFile: "/some/ca.pem",
-	})
-	if cfg != nil {
-		t.Error("expected nil tls.Config when CACertFile is set (CA path taken)")
-	}
-}
-
-func TestTLSInsecureSkipVerify_FalseWhenCustomTLSConfig(t *testing.T) {
-	// When TLSConfig is supplied explicitly, our default skip-verify must not overwrite it.
-	custom := &tls.Config{MinVersion: tls.VersionTLS13}
-	cfg := tlsConfigForOptions(Options{
-		Endpoint:  "localhost:5120",
-		TLSConfig: custom,
-	})
-	if cfg != nil {
-		t.Error("expected nil tls.Config when TLSConfig is already set (custom config path taken)")
-	}
-}

clients/go/mxgateway/errors.go

@@ -85,8 +85,12 @@ func (e *MxAccessError) Error() string {
 }
 
 // Unwrap returns the wrapped CommandError, when one is present.
+//
+// When Command is nil (the HRESULT / MxStatusProxy path) it returns an
+// untyped nil rather than a typed-nil *CommandError, so errors.As does not
+// bind a nil pointer that a caller would then panic on.
 func (e *MxAccessError) Unwrap() error {
-	if e == nil {
+	if e == nil || e.Command == nil {
 		return nil
 	}
 	return e.Command

clients/go/mxgateway/errors_test.go

@@ -0,0 +1,42 @@
+package mxgateway
+
+import (
+	"errors"
+	"testing"
+)
+
+// TestMxAccessErrorUnwrapHResultPathNoTypedNilCommandError reproduces
+// Client.Go-001: an MxAccessError built via the HRESULT / MxStatusProxy path
+// leaves Command nil. Unwrap must not hand back a typed-nil *CommandError,
+// because errors.As would then succeed while binding a nil pointer and a
+// caller dereferencing it would panic.
+func TestMxAccessErrorUnwrapHResultPathNoTypedNilCommandError(t *testing.T) {
+	hresult := int32(-2147467259) // 0x80004005, a failing HRESULT.
+	reply := &MxCommandReply{Hresult: &hresult}
+
+	err := EnsureMxAccessSuccess("invoke", reply)
+	if err == nil {
+		t.Fatal("expected MxAccessError for a failing HRESULT, got nil")
+	}
+
+	var ce *CommandError
+	if errors.As(err, &ce) {
+		t.Fatalf("errors.As bound *CommandError from an HRESULT-only MxAccessError (ce=%v); "+
+			"a caller dereferencing ce.Status would panic", ce)
+	}
+}
+
+// TestMxAccessErrorUnwrapPopulatedCommand confirms the non-nil Command path
+// still unwraps to the wrapped *CommandError.
+func TestMxAccessErrorUnwrapPopulatedCommand(t *testing.T) {
+	command := &CommandError{Op: "invoke"}
+	err := &MxAccessError{Command: command}
+
+	var ce *CommandError
+	if !errors.As(err, &ce) {
+		t.Fatal("errors.As failed to bind the populated *CommandError")
+	}
+	if ce != command {
+		t.Fatalf("errors.As bound an unexpected *CommandError: got %v want %v", ce, command)
+	}
+}

clients/go/mxgateway/galaxy.go

@@ -3,9 +3,7 @@ package mxgateway
 import (
 	"context"
 	"errors"
-	"fmt"
 	"io"
-	"sync"
 	"time"
 
 	pb "gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/internal/generated"
@@ -15,14 +13,6 @@ import (
 	"google.golang.org/protobuf/types/known/timestamppb"
 )
 
-// browseChildrenPageSize is the per-request page size used by the lazy walker.
-const browseChildrenPageSize = 500
-
-// discoverHierarchyPageSize is the per-request page size used by DiscoverHierarchy.
-// Mirrors the .NET client constant so large galaxies are not silently truncated
-// by the server's default page cap.
-const discoverHierarchyPageSize = 5000
-
 // RawGalaxyRepositoryClient is the generated gRPC client interface for the
 // Galaxy Repository service exposed for callers that need direct contract
 // access.
@@ -50,15 +40,6 @@ type (
 	WatchDeployEventsRequest = pb.WatchDeployEventsRequest
 	// DeployEvent is one Galaxy Repository deploy event.
 	DeployEvent = pb.DeployEvent
-	// BrowseChildrenRequest is the request for BrowseChildren.
-	BrowseChildrenRequest = pb.BrowseChildrenRequest
-	// BrowseChildrenReply is the reply for BrowseChildren.
-	BrowseChildrenReply = pb.BrowseChildrenReply
-	// BrowseChildrenRequest_ParentGobjectId selects the parent-by-gobject-id
-	// variant of the BrowseChildrenRequest parent oneof. Exposed so callers
-	// (e.g. the mxgw-go CLI) can issue a parent-scoped single-level browse
-	// without reaching into the generated package.
-	BrowseChildrenRequest_ParentGobjectId = pb.BrowseChildrenRequest_ParentGobjectId //nolint:revive,staticcheck // mirrors generated proto oneof name
 )
 
 // RawDeployEventStream is the generated WatchDeployEvents client stream.
@@ -165,35 +146,16 @@ func (c *GalaxyClient) GetLastDeployTime(ctx context.Context) (time.Time, bool,
 
 // DiscoverHierarchy returns the deployed Galaxy object hierarchy with each
 // object's dynamic attributes. The objects are returned in the order supplied
-// by the server. The call pages over the server's NextPageToken until the
-// server signals it has no more results, matching the .NET client.
+// by the server.
 func (c *GalaxyClient) DiscoverHierarchy(ctx context.Context) ([]*GalaxyObject, error) {
-	var objects []*GalaxyObject
-	pageToken := ""
-	seen := map[string]struct{}{}
-	for {
-		callCtx, cancel := c.callContext(ctx)
-		reply, err := c.raw.DiscoverHierarchy(callCtx, &pb.DiscoverHierarchyRequest{
-			PageSize:  discoverHierarchyPageSize,
-			PageToken: pageToken,
-		})
-		cancel()
-		if err != nil {
-			return nil, &GatewayError{Op: "galaxy discover hierarchy", Err: err}
-		}
-		objects = append(objects, reply.GetObjects()...)
-		pageToken = reply.GetNextPageToken()
-		if pageToken == "" {
-			return objects, nil
-		}
-		if _, dup := seen[pageToken]; dup {
-			return nil, &GatewayError{
-				Op:  "galaxy discover hierarchy",
-				Err: fmt.Errorf("repeated page token %q", pageToken),
-			}
-		}
-		seen[pageToken] = struct{}{}
+	callCtx, cancel := c.callContext(ctx)
+	defer cancel()
+
+	reply, err := c.raw.DiscoverHierarchy(callCtx, &pb.DiscoverHierarchyRequest{})
+	if err != nil {
+		return nil, &GatewayError{Op: "galaxy discover hierarchy", Err: err}
 	}
+	return reply.GetObjects(), nil
 }
 
 // WatchDeployEventsRaw starts the generated WatchDeployEvents stream for callers
@@ -276,206 +238,6 @@ func (c *GalaxyClient) Close() error {
 	return c.conn.Close()
 }
 
-// LazyBrowseNode is one node in a lazy Galaxy hierarchy walk produced by
-// (*GalaxyClient).Browse. Children are not fetched until Expand is called.
-// The node is safe for concurrent use; concurrent Expand calls coalesce onto
-// a single in-flight RPC and do not block snapshot accessors.
-type LazyBrowseNode struct {
-	client          *GalaxyClient
-	object          *pb.GalaxyObject
-	hasChildrenHint bool
-	options         BrowseChildrenOptions
-
-	// expandLock gates inspection and mutation of expand-coordination state
-	// (expanding, expandDone, expandErr). It is held only briefly; the BrowseChildren
-	// RPC itself runs outside this lock so concurrent readers and waiters are not blocked.
-	expandLock sync.Mutex
-	expanding  bool
-	expandDone chan struct{}
-	expandErr  error
-
-	// mu protects the children snapshot and isExpanded flag for concurrent
-	// Children() / IsExpanded() readers.
-	mu         sync.RWMutex
-	children   []*LazyBrowseNode
-	isExpanded bool
-}
-
-// Object returns the underlying GalaxyObject describing this node.
-func (n *LazyBrowseNode) Object() *pb.GalaxyObject { return n.object }
-
-// HasChildrenHint reports the server-supplied hint on whether this node has
-// matching descendants under the current filter set.
-func (n *LazyBrowseNode) HasChildrenHint() bool { return n.hasChildrenHint }
-
-// Children returns a snapshot copy of the currently-loaded child nodes. Returns
-// an empty slice when Expand has not yet been called.
-func (n *LazyBrowseNode) Children() []*LazyBrowseNode {
-	n.mu.RLock()
-	defer n.mu.RUnlock()
-	out := make([]*LazyBrowseNode, len(n.children))
-	copy(out, n.children)
-	return out
-}
-
-// IsExpanded reports whether Expand has completed successfully on this node.
-func (n *LazyBrowseNode) IsExpanded() bool {
-	n.mu.RLock()
-	defer n.mu.RUnlock()
-	return n.isExpanded
-}
-
-// Expand fetches this node's direct children via BrowseChildren when they have
-// not yet been loaded. Subsequent calls after a successful Expand are a no-op
-// and do not issue another RPC.
-//
-// Expand is safe to call concurrently from multiple goroutines: callers that
-// arrive while an expansion is in flight wait on the active RPC and share its
-// result instead of issuing a second RPC. The RPC itself runs without holding
-// the snapshot mutex, so concurrent Children() and IsExpanded() callers are
-// not blocked for the duration of the network round trip.
-//
-// Failure semantics: a failed expansion surfaces the same error to every
-// in-flight waiter, but the node is left in its pre-call state (isExpanded =
-// false, no in-flight expansion). The next Expand call therefore retries with
-// a fresh RPC; failures are not sticky.
-func (n *LazyBrowseNode) Expand(ctx context.Context) error {
-	// Fast path: already expanded.
-	n.mu.RLock()
-	if n.isExpanded {
-		n.mu.RUnlock()
-		return nil
-	}
-	n.mu.RUnlock()
-
-	// Either start a new expansion or wait on an existing one.
-	n.expandLock.Lock()
-	n.mu.RLock()
-	alreadyExpanded := n.isExpanded
-	n.mu.RUnlock()
-	if alreadyExpanded {
-		n.expandLock.Unlock()
-		return nil
-	}
-	if n.expanding {
-		done := n.expandDone
-		n.expandLock.Unlock()
-		select {
-		case <-done:
-			n.expandLock.Lock()
-			err := n.expandErr
-			n.expandLock.Unlock()
-			return err
-		case <-ctx.Done():
-			return ctx.Err()
-		}
-	}
-	n.expanding = true
-	n.expandDone = make(chan struct{})
-	done := n.expandDone
-	n.expandLock.Unlock()
-
-	// Issue the RPC outside any lock so concurrent readers/waiters are not blocked.
-	parentID := n.object.GetGobjectId()
-	children, err := n.client.browseChildrenInner(ctx, &parentID, n.options)
-
-	if err == nil {
-		n.mu.Lock()
-		n.children = children
-		n.isExpanded = true
-		n.mu.Unlock()
-	}
-
-	// Publish result to waiters and clear the in-flight marker so a failed
-	// expansion can be retried by the next Expand call.
-	n.expandLock.Lock()
-	n.expandErr = err
-	n.expanding = false
-	close(done)
-	n.expandLock.Unlock()
-
-	return err
-}
-
-// Browse returns the root nodes of the Galaxy hierarchy. The returned nodes
-// have only their server-supplied hints populated; call Expand on each node to
-// fetch its direct children. When opts is nil the server defaults apply.
-func (c *GalaxyClient) Browse(ctx context.Context, opts *BrowseChildrenOptions) ([]*LazyBrowseNode, error) {
-	effective := BrowseChildrenOptions{}
-	if opts != nil {
-		effective = *opts
-	}
-	return c.browseChildrenInner(ctx, nil, effective)
-}
-
-// BrowseChildrenRaw issues a single BrowseChildren RPC and returns the raw
-// reply for callers that need direct page-token control. Transport-level
-// failures are wrapped in *GatewayError to match the rest of the client.
-func (c *GalaxyClient) BrowseChildrenRaw(ctx context.Context, req *pb.BrowseChildrenRequest) (*pb.BrowseChildrenReply, error) {
-	callCtx, cancel := c.callContext(ctx)
-	defer cancel()
-	reply, err := c.raw.BrowseChildren(callCtx, req)
-	if err != nil {
-		return nil, &GatewayError{Op: "galaxy browse children", Err: err}
-	}
-	return reply, nil
-}
-
-func (c *GalaxyClient) browseChildrenInner(
-	ctx context.Context,
-	parentGobjectID *int32,
-	opts BrowseChildrenOptions,
-) ([]*LazyBrowseNode, error) {
-	var nodes []*LazyBrowseNode
-	pageToken := ""
-	seen := map[string]struct{}{}
-	for {
-		req := &pb.BrowseChildrenRequest{
-			PageSize:              browseChildrenPageSize,
-			PageToken:             pageToken,
-			CategoryIds:           opts.CategoryIds,
-			TemplateChainContains: opts.TemplateChainContains,
-			TagNameGlob:           opts.TagNameGlob,
-			AlarmBearingOnly:      opts.AlarmBearingOnly,
-			HistorizedOnly:        opts.HistorizedOnly,
-		}
-		if parentGobjectID != nil {
-			req.Parent = &pb.BrowseChildrenRequest_ParentGobjectId{ParentGobjectId: *parentGobjectID}
-		}
-		if opts.IncludeAttributes != nil {
-			req.IncludeAttributes = opts.IncludeAttributes
-		}
-
-		reply, err := c.BrowseChildrenRaw(ctx, req)
-		if err != nil {
-			return nil, err
-		}
-
-		for i, child := range reply.GetChildren() {
-			hasChildren := reply.GetChildHasChildren()
-			hint := i < len(hasChildren) && hasChildren[i]
-			nodes = append(nodes, &LazyBrowseNode{
-				client:          c,
-				object:          child,
-				hasChildrenHint: hint,
-				options:         opts,
-			})
-		}
-
-		pageToken = reply.GetNextPageToken()
-		if pageToken == "" {
-			return nodes, nil
-		}
-		if _, dup := seen[pageToken]; dup {
-			return nil, &GatewayError{
-				Op:  "galaxy browse children",
-				Err: fmt.Errorf("repeated page token %q", pageToken),
-			}
-		}
-		seen[pageToken] = struct{}{}
-	}
-}
-
 func (c *GalaxyClient) callContext(ctx context.Context) (context.Context, context.CancelFunc) {
 	timeout := c.opts.CallTimeout
 	if timeout == 0 {

clients/go/mxgateway/galaxy_test.go

@@ -4,14 +4,11 @@ import (
 	"context"
 	"errors"
 	"net"
-	"sync"
 	"testing"
 	"time"
 
 	pb "gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/internal/generated"
 	"google.golang.org/grpc"
-	"google.golang.org/grpc/codes"
-	"google.golang.org/grpc/status"
 	"google.golang.org/grpc/test/bufconn"
 	"google.golang.org/protobuf/types/known/timestamppb"
 )
@@ -58,8 +55,8 @@ func TestGalaxyGetLastDeployTimeReturnsTimestampWhenPresent(t *testing.T) {
 	want := time.Date(2026, 4, 28, 12, 34, 56, 0, time.UTC)
 	fake := &fakeGalaxyServer{
 		deployReply: &pb.GetLastDeployTimeReply{
-			Present:          true,
-			TimeOfLastDeploy: timestamppb.New(want),
+			Present:           true,
+			TimeOfLastDeploy:  timestamppb.New(want),
 		},
 	}
 	client, cleanup := newGalaxyBufconnClient(t, fake)
@@ -147,47 +144,6 @@ func TestGalaxyDiscoverHierarchyReturnsObjects(t *testing.T) {
 	}
 }
 
-func TestGalaxyDiscoverHierarchyPaginatesAcrossMultiplePages(t *testing.T) {
-	page1 := &pb.DiscoverHierarchyReply{
-		Objects: []*pb.GalaxyObject{
-			{GobjectId: 1, TagName: "A"},
-			{GobjectId: 2, TagName: "B"},
-		},
-		NextPageToken:    "page-2",
-		TotalObjectCount: 3,
-	}
-	page2 := &pb.DiscoverHierarchyReply{
-		Objects: []*pb.GalaxyObject{
-			{GobjectId: 3, TagName: "C"},
-		},
-		TotalObjectCount: 3,
-	}
-	fake := &fakeGalaxyServer{
-		discoverHierarchyReplies: []*pb.DiscoverHierarchyReply{page1, page2},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	objs, err := client.DiscoverHierarchy(context.Background())
-	if err != nil {
-		t.Fatalf("DiscoverHierarchy: %v", err)
-	}
-	if got, want := len(objs), 3; got != want {
-		t.Fatalf("len(objs) = %d, want %d", got, want)
-	}
-	if len(fake.discoverHierarchyCalls) != 2 {
-		t.Fatalf("expected 2 RPC calls, got %d", len(fake.discoverHierarchyCalls))
-	}
-	if fake.discoverHierarchyCalls[0].GetPageSize() != discoverHierarchyPageSize {
-		t.Fatalf("first call PageSize = %d, want %d",
-			fake.discoverHierarchyCalls[0].GetPageSize(), discoverHierarchyPageSize)
-	}
-	if fake.discoverHierarchyCalls[1].GetPageToken() != "page-2" {
-		t.Fatalf("second call page token = %q, want %q",
-			fake.discoverHierarchyCalls[1].GetPageToken(), "page-2")
-	}
-}
-
 func TestGalaxyDialReturnsGatewayErrorOnRpcFailure(t *testing.T) {
 	fake := &fakeGalaxyServer{failTest: true}
 	client, cleanup := newGalaxyBufconnClient(t, fake)
@@ -414,20 +370,15 @@ func newGalaxyBufconnClient(t *testing.T, fake *fakeGalaxyServer) (*GalaxyClient
 type fakeGalaxyServer struct {
 	pb.UnimplementedGalaxyRepositoryServer
 
-	testReply                *pb.TestConnectionReply
-	testAuth                 string
-	failTest                 bool
-	deployReply              *pb.GetLastDeployTimeReply
-	discoverReply            *pb.DiscoverHierarchyReply
-	discoverHierarchyCalls   []*pb.DiscoverHierarchyRequest
-	discoverHierarchyReplies []*pb.DiscoverHierarchyReply
-	watchEvents              []*pb.DeployEvent
-	watchRequest             *pb.WatchDeployEventsRequest
-	watchSendInterval        time.Duration
-	watchHoldOpen            bool
-	browseChildrenCalls      []*pb.BrowseChildrenRequest
-	browseChildrenReplies    []*pb.BrowseChildrenReply
-	browseChildrenError      error
+	testReply         *pb.TestConnectionReply
+	testAuth          string
+	failTest          bool
+	deployReply       *pb.GetLastDeployTimeReply
+	discoverReply     *pb.DiscoverHierarchyReply
+	watchEvents       []*pb.DeployEvent
+	watchRequest      *pb.WatchDeployEventsRequest
+	watchSendInterval time.Duration
+	watchHoldOpen     bool
 }
 
 func (s *fakeGalaxyServer) TestConnection(ctx context.Context, req *pb.TestConnectionRequest) (*pb.TestConnectionReply, error) {
@@ -449,12 +400,6 @@ func (s *fakeGalaxyServer) GetLastDeployTime(ctx context.Context, req *pb.GetLas
 }
 
 func (s *fakeGalaxyServer) DiscoverHierarchy(ctx context.Context, req *pb.DiscoverHierarchyRequest) (*pb.DiscoverHierarchyReply, error) {
-	s.discoverHierarchyCalls = append(s.discoverHierarchyCalls, req)
-	if len(s.discoverHierarchyReplies) > 0 {
-		reply := s.discoverHierarchyReplies[0]
-		s.discoverHierarchyReplies = s.discoverHierarchyReplies[1:]
-		return reply, nil
-	}
 	if s.discoverReply != nil {
 		return s.discoverReply, nil
 	}
@@ -480,385 +425,3 @@ func (s *fakeGalaxyServer) WatchDeployEvents(req *pb.WatchDeployEventsRequest, s
 	}
 	return nil
 }
-
-func (s *fakeGalaxyServer) BrowseChildren(ctx context.Context, req *pb.BrowseChildrenRequest) (*pb.BrowseChildrenReply, error) {
-	s.browseChildrenCalls = append(s.browseChildrenCalls, req)
-	if s.browseChildrenError != nil {
-		err := s.browseChildrenError
-		s.browseChildrenError = nil
-		return nil, err
-	}
-	if len(s.browseChildrenReplies) == 0 {
-		return &pb.BrowseChildrenReply{}, nil
-	}
-	reply := s.browseChildrenReplies[0]
-	s.browseChildrenReplies = s.browseChildrenReplies[1:]
-	return reply, nil
-}
-
-func obj(id int32, tag string, isArea bool) *pb.GalaxyObject {
-	return &pb.GalaxyObject{
-		GobjectId:  id,
-		TagName:    tag,
-		BrowseName: tag,
-		IsArea:     isArea,
-	}
-}
-
-func buildBrowseReply(children []*pb.GalaxyObject, hasChildren []bool, seq uint64) *pb.BrowseChildrenReply {
-	return &pb.BrowseChildrenReply{
-		TotalChildCount:  int32(len(children)),
-		CacheSequence:    seq,
-		Children:         children,
-		ChildHasChildren: hasChildren,
-	}
-}
-
-func TestGalaxyBrowseNoParentReturnsRoots(t *testing.T) {
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{
-			buildBrowseReply(
-				[]*pb.GalaxyObject{obj(1, "Plant", true), obj(99, "Other", false)},
-				[]bool{true, false},
-				7,
-			),
-		},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	roots, err := client.Browse(context.Background(), nil)
-	if err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-	if got, want := len(roots), 2; got != want {
-		t.Fatalf("len(roots) = %d, want %d", got, want)
-	}
-	if roots[0].Object().GetTagName() != "Plant" {
-		t.Fatalf("roots[0].TagName = %q", roots[0].Object().GetTagName())
-	}
-	if !roots[0].HasChildrenHint() {
-		t.Fatal("roots[0].HasChildrenHint = false, want true")
-	}
-	if roots[0].IsExpanded() {
-		t.Fatal("roots[0].IsExpanded = true, want false")
-	}
-	if roots[1].HasChildrenHint() {
-		t.Fatal("roots[1].HasChildrenHint = true, want false")
-	}
-	if len(fake.browseChildrenCalls) != 1 {
-		t.Fatalf("BrowseChildren calls = %d, want 1", len(fake.browseChildrenCalls))
-	}
-	if fake.browseChildrenCalls[0].GetParent() != nil {
-		t.Fatalf("root browse should not set Parent oneof, got %T", fake.browseChildrenCalls[0].GetParent())
-	}
-}
-
-func TestGalaxyBrowseExpandPopulatesChildrenAndMarksExpanded(t *testing.T) {
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{
-			buildBrowseReply(
-				[]*pb.GalaxyObject{obj(1, "Plant", true)},
-				[]bool{true},
-				1,
-			),
-			buildBrowseReply(
-				[]*pb.GalaxyObject{obj(10, "Area1", true), obj(11, "Tank1", false)},
-				[]bool{true, false},
-				1,
-			),
-		},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	roots, err := client.Browse(context.Background(), nil)
-	if err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-	if len(roots) != 1 {
-		t.Fatalf("len(roots) = %d, want 1", len(roots))
-	}
-	plant := roots[0]
-	if plant.IsExpanded() {
-		t.Fatal("plant.IsExpanded = true before Expand, want false")
-	}
-	if err := plant.Expand(context.Background()); err != nil {
-		t.Fatalf("Expand: %v", err)
-	}
-	if !plant.IsExpanded() {
-		t.Fatal("plant.IsExpanded = false after Expand, want true")
-	}
-	children := plant.Children()
-	if len(children) != 2 {
-		t.Fatalf("len(children) = %d, want 2", len(children))
-	}
-	if children[0].Object().GetTagName() != "Area1" {
-		t.Fatalf("children[0].TagName = %q, want Area1", children[0].Object().GetTagName())
-	}
-	if !children[0].HasChildrenHint() {
-		t.Fatal("children[0].HasChildrenHint = false, want true")
-	}
-	if children[1].HasChildrenHint() {
-		t.Fatal("children[1].HasChildrenHint = true, want false")
-	}
-	if len(fake.browseChildrenCalls) != 2 {
-		t.Fatalf("BrowseChildren calls = %d, want 2", len(fake.browseChildrenCalls))
-	}
-	parent := fake.browseChildrenCalls[1].GetParent()
-	parentGobj, ok := parent.(*pb.BrowseChildrenRequest_ParentGobjectId)
-	if !ok {
-		t.Fatalf("Parent oneof = %T, want *BrowseChildrenRequest_ParentGobjectId", parent)
-	}
-	if parentGobj.ParentGobjectId != 1 {
-		t.Fatalf("ParentGobjectId = %d, want 1", parentGobj.ParentGobjectId)
-	}
-}
-
-func TestGalaxyBrowseExpandIdempotentNoSecondRpc(t *testing.T) {
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{
-			buildBrowseReply(
-				[]*pb.GalaxyObject{obj(1, "Plant", true)},
-				[]bool{true},
-				1,
-			),
-			buildBrowseReply(
-				[]*pb.GalaxyObject{obj(10, "Area1", true)},
-				[]bool{false},
-				1,
-			),
-		},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	roots, err := client.Browse(context.Background(), nil)
-	if err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-	plant := roots[0]
-	if err := plant.Expand(context.Background()); err != nil {
-		t.Fatalf("Expand #1: %v", err)
-	}
-	callsAfterFirst := len(fake.browseChildrenCalls)
-	if callsAfterFirst != 2 {
-		t.Fatalf("BrowseChildren calls after first Expand = %d, want 2", callsAfterFirst)
-	}
-	if err := plant.Expand(context.Background()); err != nil {
-		t.Fatalf("Expand #2: %v", err)
-	}
-	if got := len(fake.browseChildrenCalls); got != callsAfterFirst {
-		t.Fatalf("BrowseChildren calls after second Expand = %d, want %d (no extra RPC)", got, callsAfterFirst)
-	}
-}
-
-func TestGalaxyBrowseExpandUnknownParentReturnsNotFoundError(t *testing.T) {
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{
-			buildBrowseReply(
-				[]*pb.GalaxyObject{obj(1, "Plant", true)},
-				[]bool{true},
-				1,
-			),
-		},
-		browseChildrenError: status.Error(codes.NotFound, "parent not found"),
-	}
-	// The first Browse() consumes the first reply; the next call (Expand) will
-	// then hit browseChildrenError. We need the error to fire only on the second
-	// call, so seed the reply first and let the call sequence consume them in
-	// order. Because BrowseChildren in the fake consumes browseChildrenError
-	// before falling through to replies, swap the strategy: keep the root reply
-	// but have BrowseChildren return the error on the second call. We do this by
-	// emptying the reply list after the first Browse.
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	// First call returns the error (because browseChildrenError takes precedence).
-	// To avoid that, clear it for the root call by performing a manual setup: we
-	// pre-stage replies first, then set the error after the first call. Easiest:
-	// pre-Browse() with error=nil, then set error before Expand.
-	fake.browseChildrenError = nil
-	roots, err := client.Browse(context.Background(), nil)
-	if err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-	if len(roots) != 1 {
-		t.Fatalf("len(roots) = %d, want 1", len(roots))
-	}
-	fake.browseChildrenError = status.Error(codes.NotFound, "parent not found")
-
-	err = roots[0].Expand(context.Background())
-	if err == nil {
-		t.Fatal("Expand: error = nil, want NotFound")
-	}
-	if status.Code(err) != codes.NotFound {
-		t.Fatalf("status.Code = %s, want NotFound", status.Code(err))
-	}
-	if roots[0].IsExpanded() {
-		t.Fatal("roots[0].IsExpanded = true after failed Expand, want false")
-	}
-}
-
-func TestGalaxyBrowseExpandMultiPageGathersAllPages(t *testing.T) {
-	firstPage := buildBrowseReply(
-		[]*pb.GalaxyObject{obj(1, "Plant", true)},
-		[]bool{true},
-		7,
-	)
-
-	pageA := buildBrowseReply(
-		[]*pb.GalaxyObject{obj(10, "Child1", false), obj(11, "Child2", false)},
-		[]bool{false, false},
-		7,
-	)
-	pageA.NextPageToken = "7:abc:2"
-	pageB := buildBrowseReply(
-		[]*pb.GalaxyObject{obj(12, "Child3", false)},
-		[]bool{false},
-		7,
-	)
-
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{firstPage, pageA, pageB},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	roots, err := client.Browse(context.Background(), nil)
-	if err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-	if err := roots[0].Expand(context.Background()); err != nil {
-		t.Fatalf("Expand: %v", err)
-	}
-	children := roots[0].Children()
-	if len(children) != 3 {
-		t.Fatalf("len(children) = %d, want 3", len(children))
-	}
-	if len(fake.browseChildrenCalls) != 3 {
-		t.Fatalf("BrowseChildren calls = %d, want 3", len(fake.browseChildrenCalls))
-	}
-	if got := fake.browseChildrenCalls[2].GetPageToken(); got != "7:abc:2" {
-		t.Fatalf("third call PageToken = %q, want %q", got, "7:abc:2")
-	}
-}
-
-func TestGalaxyBrowseWithFilterForwardsToRequest(t *testing.T) {
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{
-			buildBrowseReply(nil, nil, 1),
-		},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	include := true
-	opts := &BrowseChildrenOptions{
-		CategoryIds:           []int32{7, 9},
-		TemplateChainContains: []string{"$AppObject"},
-		TagNameGlob:           "Tank*",
-		IncludeAttributes:     &include,
-		AlarmBearingOnly:      true,
-		HistorizedOnly:        true,
-	}
-	if _, err := client.Browse(context.Background(), opts); err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-	if len(fake.browseChildrenCalls) != 1 {
-		t.Fatalf("BrowseChildren calls = %d, want 1", len(fake.browseChildrenCalls))
-	}
-	got := fake.browseChildrenCalls[0]
-	if want := []int32{7, 9}; len(got.GetCategoryIds()) != 2 || got.GetCategoryIds()[0] != want[0] || got.GetCategoryIds()[1] != want[1] {
-		t.Fatalf("CategoryIds = %v, want %v", got.GetCategoryIds(), want)
-	}
-	if want := []string{"$AppObject"}; len(got.GetTemplateChainContains()) != 1 || got.GetTemplateChainContains()[0] != want[0] {
-		t.Fatalf("TemplateChainContains = %v, want %v", got.GetTemplateChainContains(), want)
-	}
-	if got.GetTagNameGlob() != "Tank*" {
-		t.Fatalf("TagNameGlob = %q, want %q", got.GetTagNameGlob(), "Tank*")
-	}
-	if !got.GetIncludeAttributes() {
-		t.Fatal("IncludeAttributes = false, want true")
-	}
-	if !got.GetAlarmBearingOnly() {
-		t.Fatal("AlarmBearingOnly = false, want true")
-	}
-	if !got.GetHistorizedOnly() {
-		t.Fatal("HistorizedOnly = false, want true")
-	}
-}
-
-func TestGalaxyBrowseExpandConcurrentCallersOnlyFireOneRpc(t *testing.T) {
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{
-			// roots
-			buildBrowseReply([]*pb.GalaxyObject{obj(1, "Plant", true)}, []bool{true}, 7),
-			// one expand: one child
-			buildBrowseReply([]*pb.GalaxyObject{obj(2, "Mixer", false)}, []bool{false}, 7),
-		},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	ctx := context.Background()
-	roots, err := client.Browse(ctx, nil)
-	if err != nil {
-		t.Fatalf("Browse: %v", err)
-	}
-
-	var wg sync.WaitGroup
-	errs := make(chan error, 10)
-	for i := 0; i < 10; i++ {
-		wg.Add(1)
-		go func() {
-			defer wg.Done()
-			errs <- roots[0].Expand(ctx)
-		}()
-	}
-	wg.Wait()
-	close(errs)
-	for err := range errs {
-		if err != nil {
-			t.Fatalf("concurrent Expand: %v", err)
-		}
-	}
-
-	if !roots[0].IsExpanded() {
-		t.Fatal("IsExpanded() = false after 10 concurrent expands")
-	}
-	if got, want := len(roots[0].Children()), 1; got != want {
-		t.Fatalf("len(children) = %d, want %d", got, want)
-	}
-	// 1 roots fetch + exactly 1 expand fetch.
-	if got, want := len(fake.browseChildrenCalls), 2; got != want {
-		t.Fatalf("RPC count = %d, want %d", got, want)
-	}
-}
-
-func TestGalaxyBrowseChildrenRejectsRepeatedPageToken(t *testing.T) {
-	// Build a reply that carries a non-empty NextPageToken so browseChildrenInner
-	// will request a second page. Queue the same reply twice so the second response
-	// returns the same page token, triggering the duplicate-token guard.
-	page := buildBrowseReply(
-		[]*pb.GalaxyObject{obj(1, "Plant", true)},
-		[]bool{true},
-		1,
-	)
-	page.NextPageToken = "1:abc:1"
-
-	fake := &fakeGalaxyServer{
-		browseChildrenReplies: []*pb.BrowseChildrenReply{page, page},
-	}
-	client, cleanup := newGalaxyBufconnClient(t, fake)
-	defer cleanup()
-
-	_, err := client.Browse(context.Background(), nil)
-	if err == nil {
-		t.Fatal("Browse: error = nil, want repeated-page-token error")
-	}
-	var gwErr *GatewayError
-	if !errors.As(err, &gwErr) {
-		t.Fatalf("error type = %T, want *GatewayError; err = %v", err, err)
-	}
-}

clients/go/mxgateway/options.go

@@ -34,32 +34,6 @@ type Options struct {
 	TransportCredentials credentials.TransportCredentials
 	// DialOptions are appended to the gRPC dial options after the defaults.
 	DialOptions []grpc.DialOption
-	// RequireCertificateValidation forces TLS certificate verification even when
-	// no CACertFile is pinned. Default false: the gateway's self-signed cert is
-	// accepted without verification (internal-tool posture).
-	RequireCertificateValidation bool
-}
-
-// BrowseChildrenOptions configures lazy Galaxy hierarchy walks performed by
-// (*GalaxyClient).Browse and (*LazyBrowseNode).Expand. All fields are optional;
-// the zero value matches the dashboard default (no filters, all attributes per
-// the server default).
-type BrowseChildrenOptions struct {
-	// CategoryIds restricts results to the listed Galaxy category ids when set.
-	CategoryIds []int32
-	// TemplateChainContains restricts results to objects whose template chain
-	// contains any of the listed template tag names.
-	TemplateChainContains []string
-	// TagNameGlob restricts results to objects whose tag name matches the glob
-	// pattern when non-empty.
-	TagNameGlob string
-	// IncludeAttributes overrides the server default for attribute inclusion when
-	// non-nil. The pointer form mirrors the proto's optional field.
-	IncludeAttributes *bool
-	// AlarmBearingOnly limits results to alarm-bearing objects when true.
-	AlarmBearingOnly bool
-	// HistorizedOnly limits results to historized objects when true.
-	HistorizedOnly bool
 }
 
 // RedactedAPIKey returns a display-safe representation of the configured API

clients/go/mxgateway/session.go

@@ -8,7 +8,6 @@ import (
 	"fmt"
 	"io"
 	"sync"
-	"time"
 
 	pb "gitea.dohertylan.com/dohertj2/mxaccessgw/clients/go/internal/generated"
 	"google.golang.org/grpc/codes"
@@ -388,173 +387,6 @@ func (s *Session) UnsubscribeBulk(ctx context.Context, serverHandle int32, itemH
 	return reply.GetUnsubscribeBulk().GetResults(), nil
 }
 
-// WriteBulk invokes MXAccess Write sequentially for each entry inside one gateway command.
-// Per-entry failures appear as BulkWriteResult entries with WasSuccessful=false; the call
-// never returns an error for per-entry MXAccess failures (it returns an error only for
-// protocol-level failures or transport errors).
-//
-// A non-nil but empty entries slice is treated as a no-op and returns an empty result
-// without a wire round-trip; pass nil to surface a clear "entries are required" error.
-func (s *Session) WriteBulk(ctx context.Context, serverHandle int32, entries []*WriteBulkEntry) ([]*BulkWriteResult, error) {
-	if entries == nil {
-		return nil, errors.New("mxgateway: write bulk entries are required")
-	}
-	if err := ensureBulkSize("write bulk entries", len(entries)); err != nil {
-		return nil, err
-	}
-	if len(entries) == 0 {
-		return []*BulkWriteResult{}, nil
-	}
-	reply, err := s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_WRITE_BULK,
-		Payload: &pb.MxCommand_WriteBulk{
-			WriteBulk: &pb.WriteBulkCommand{
-				ServerHandle: serverHandle,
-				Entries:      entries,
-			},
-		},
-	})
-	if err != nil {
-		return nil, err
-	}
-	return reply.GetWriteBulk().GetResults(), nil
-}
-
-// Write2Bulk invokes MXAccess Write2 (timestamped) for each entry inside one gateway command.
-//
-// A non-nil but empty entries slice is treated as a no-op and returns an empty result
-// without a wire round-trip; pass nil to surface a clear "entries are required" error.
-func (s *Session) Write2Bulk(ctx context.Context, serverHandle int32, entries []*Write2BulkEntry) ([]*BulkWriteResult, error) {
-	if entries == nil {
-		return nil, errors.New("mxgateway: write2 bulk entries are required")
-	}
-	if err := ensureBulkSize("write2 bulk entries", len(entries)); err != nil {
-		return nil, err
-	}
-	if len(entries) == 0 {
-		return []*BulkWriteResult{}, nil
-	}
-	reply, err := s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_WRITE2_BULK,
-		Payload: &pb.MxCommand_Write2Bulk{
-			Write2Bulk: &pb.Write2BulkCommand{
-				ServerHandle: serverHandle,
-				Entries:      entries,
-			},
-		},
-	})
-	if err != nil {
-		return nil, err
-	}
-	return reply.GetWrite2Bulk().GetResults(), nil
-}
-
-// WriteSecuredBulk invokes MXAccess WriteSecured for each entry. Credential-sensitive
-// values must not be logged by callers; mirrors the single-item WriteSecured contract.
-//
-// A non-nil but empty entries slice is treated as a no-op and returns an empty result
-// without a wire round-trip; pass nil to surface a clear "entries are required" error.
-func (s *Session) WriteSecuredBulk(ctx context.Context, serverHandle int32, entries []*WriteSecuredBulkEntry) ([]*BulkWriteResult, error) {
-	if entries == nil {
-		return nil, errors.New("mxgateway: write-secured bulk entries are required")
-	}
-	if err := ensureBulkSize("write-secured bulk entries", len(entries)); err != nil {
-		return nil, err
-	}
-	if len(entries) == 0 {
-		return []*BulkWriteResult{}, nil
-	}
-	reply, err := s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_WRITE_SECURED_BULK,
-		Payload: &pb.MxCommand_WriteSecuredBulk{
-			WriteSecuredBulk: &pb.WriteSecuredBulkCommand{
-				ServerHandle: serverHandle,
-				Entries:      entries,
-			},
-		},
-	})
-	if err != nil {
-		return nil, err
-	}
-	return reply.GetWriteSecuredBulk().GetResults(), nil
-}
-
-// WriteSecured2Bulk invokes MXAccess WriteSecured2 (timestamped) for each entry.
-//
-// A non-nil but empty entries slice is treated as a no-op and returns an empty result
-// without a wire round-trip; pass nil to surface a clear "entries are required" error.
-func (s *Session) WriteSecured2Bulk(ctx context.Context, serverHandle int32, entries []*WriteSecured2BulkEntry) ([]*BulkWriteResult, error) {
-	if entries == nil {
-		return nil, errors.New("mxgateway: write-secured2 bulk entries are required")
-	}
-	if err := ensureBulkSize("write-secured2 bulk entries", len(entries)); err != nil {
-		return nil, err
-	}
-	if len(entries) == 0 {
-		return []*BulkWriteResult{}, nil
-	}
-	reply, err := s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_WRITE_SECURED2_BULK,
-		Payload: &pb.MxCommand_WriteSecured2Bulk{
-			WriteSecured2Bulk: &pb.WriteSecured2BulkCommand{
-				ServerHandle: serverHandle,
-				Entries:      entries,
-			},
-		},
-	})
-	if err != nil {
-		return nil, err
-	}
-	return reply.GetWriteSecured2Bulk().GetResults(), nil
-}
-
-// ReadBulk snapshots the current value of each requested tag.
-//
-// MXAccess COM has no synchronous Read; the worker satisfies this by returning the
-// most recent cached OnDataChange value when the tag is already advised (WasCached=true),
-// or by taking a full AddItem + Advise + wait + UnAdvise + RemoveItem snapshot lifecycle
-// otherwise. timeout bounds the wait per tag in the snapshot case; pass zero to use the
-// worker default. Per-tag failures (timeout, invalid tag) appear as BulkReadResult entries
-// with WasSuccessful=false; the call never returns an error for per-tag MXAccess failures.
-//
-// A non-nil but empty tagAddresses slice is treated as a no-op and returns an empty
-// result without a wire round-trip; pass nil to surface a clear "tag addresses are
-// required" error.
-func (s *Session) ReadBulk(ctx context.Context, serverHandle int32, tagAddresses []string, timeout time.Duration) ([]*BulkReadResult, error) {
-	if tagAddresses == nil {
-		return nil, errors.New("mxgateway: tag addresses are required")
-	}
-	if err := ensureBulkSize("tag addresses", len(tagAddresses)); err != nil {
-		return nil, err
-	}
-	if len(tagAddresses) == 0 {
-		return []*BulkReadResult{}, nil
-	}
-	var timeoutMs uint32
-	if timeout > 0 {
-		ms := timeout.Milliseconds()
-		if ms > int64(^uint32(0)) {
-			timeoutMs = ^uint32(0)
-		} else {
-			timeoutMs = uint32(ms)
-		}
-	}
-	reply, err := s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_READ_BULK,
-		Payload: &pb.MxCommand_ReadBulk{
-			ReadBulk: &pb.ReadBulkCommand{
-				ServerHandle: serverHandle,
-				TagAddresses: tagAddresses,
-				TimeoutMs:    timeoutMs,
-			},
-		},
-	})
-	if err != nil {
-		return nil, err
-	}
-	return reply.GetReadBulk().GetResults(), nil
-}
-
 // Write invokes MXAccess Write.
 func (s *Session) Write(ctx context.Context, serverHandle, itemHandle int32, value *MxValue, userID int32) error {
 	_, err := s.WriteRaw(ctx, serverHandle, itemHandle, value, userID)
@@ -580,46 +412,6 @@ func (s *Session) WriteRaw(ctx context.Context, serverHandle, itemHandle int32,
 	})
 }
 
-// PingRaw sends a diagnostic PING command and returns the raw reply.
-// The message is echoed back by the gateway in the reply's DiagnosticMessage field.
-func (s *Session) PingRaw(ctx context.Context, message string) (*MxCommandReply, error) {
-	return s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_PING,
-		Payload: &pb.MxCommand_Ping{
-			Ping: &pb.PingCommand{Message: message},
-		},
-	})
-}
-
-// Write2 invokes MXAccess Write2 (timestamped single-item write).
-func (s *Session) Write2(ctx context.Context, serverHandle, itemHandle int32, value, timestampValue *MxValue, userID int32) error {
-	_, err := s.Write2Raw(ctx, serverHandle, itemHandle, value, timestampValue, userID)
-	return err
-}
-
-// Write2Raw invokes MXAccess Write2 (timestamped single-item write) and returns the raw reply.
-func (s *Session) Write2Raw(ctx context.Context, serverHandle, itemHandle int32, value, timestampValue *MxValue, userID int32) (*MxCommandReply, error) {
-	if value == nil {
-		return nil, errors.New("mxgateway: write2 value is required")
-	}
-	if timestampValue == nil {
-		return nil, errors.New("mxgateway: write2 timestamp value is required")
-	}
-
-	return s.invokeCommand(ctx, &pb.MxCommand{
-		Kind: pb.MxCommandKind_MX_COMMAND_KIND_WRITE2,
-		Payload: &pb.MxCommand_Write2{
-			Write2: &pb.Write2Command{
-				ServerHandle:   serverHandle,
-				ItemHandle:     itemHandle,
-				Value:          value,
-				TimestampValue: timestampValue,
-				UserId:         userID,
-			},
-		},
-	})
-}
-
 // Events streams ordered session events until the server ends the stream,
 // context cancellation stops Recv, or a terminal error is sent.
 func (s *Session) Events(ctx context.Context) (<-chan EventResult, error) {

clients/go/mxgateway/types.go

@@ -70,32 +70,6 @@ type (
 	WriteCommand = pb.WriteCommand
 	// Write2Command is the payload of an MXAccess Write2 command.
 	Write2Command = pb.Write2Command
-	// WriteBulkCommand is the payload of a bulk Write command.
-	WriteBulkCommand = pb.WriteBulkCommand
-	// WriteBulkEntry is one entry inside a WriteBulkCommand.
-	WriteBulkEntry = pb.WriteBulkEntry
-	// Write2BulkCommand is the payload of a bulk Write2 (timestamped) command.
-	Write2BulkCommand = pb.Write2BulkCommand
-	// Write2BulkEntry is one entry inside a Write2BulkCommand.
-	Write2BulkEntry = pb.Write2BulkEntry
-	// WriteSecuredBulkCommand is the payload of a bulk WriteSecured command.
-	WriteSecuredBulkCommand = pb.WriteSecuredBulkCommand
-	// WriteSecuredBulkEntry is one entry inside a WriteSecuredBulkCommand.
-	WriteSecuredBulkEntry = pb.WriteSecuredBulkEntry
-	// WriteSecured2BulkCommand is the payload of a bulk WriteSecured2 (timestamped) command.
-	WriteSecured2BulkCommand = pb.WriteSecured2BulkCommand
-	// WriteSecured2BulkEntry is one entry inside a WriteSecured2BulkCommand.
-	WriteSecured2BulkEntry = pb.WriteSecured2BulkEntry
-	// ReadBulkCommand is the payload of a bulk Read snapshot command.
-	ReadBulkCommand = pb.ReadBulkCommand
-	// BulkWriteReply aggregates BulkWriteResult entries for a bulk write command.
-	BulkWriteReply = pb.BulkWriteReply
-	// BulkWriteResult is one entry in a bulk write reply list.
-	BulkWriteResult = pb.BulkWriteResult
-	// BulkReadReply aggregates BulkReadResult entries for a bulk read command.
-	BulkReadReply = pb.BulkReadReply
-	// BulkReadResult is one entry in a bulk read reply list.
-	BulkReadResult = pb.BulkReadResult
 	// RegisterReply carries the ServerHandle returned by Register.
 	RegisterReply = pb.RegisterReply
 	// AddItemReply carries the ItemHandle returned by AddItem.
@@ -112,11 +86,6 @@ type (
 	AcknowledgeAlarmReply = pb.AcknowledgeAlarmReply
 	// QueryActiveAlarmsRequest is the gateway QueryActiveAlarms request message.
 	QueryActiveAlarmsRequest = pb.QueryActiveAlarmsRequest
-	// StreamAlarmsRequest is the gateway StreamAlarms request message.
-	StreamAlarmsRequest = pb.StreamAlarmsRequest
-	// AlarmFeedMessage is one message on the StreamAlarms feed — an
-	// active-alarm snapshot row, a snapshot-complete sentinel, or a transition.
-	AlarmFeedMessage = pb.AlarmFeedMessage
 	// ActiveAlarmSnapshot is one row in a ConditionRefresh stream.
 	ActiveAlarmSnapshot = pb.ActiveAlarmSnapshot
 	// OnAlarmTransitionEvent is the body carried by alarm-transition MxEvents.
@@ -135,10 +104,6 @@ type AlarmConditionState = pb.AlarmConditionState
 // QueryActiveAlarms RPC.
 type QueryActiveAlarmsClient = pb.MxAccessGateway_QueryActiveAlarmsClient
 
-// StreamAlarmsClient is the generated server-streaming client for the
-// StreamAlarms RPC.
-type StreamAlarmsClient = pb.MxAccessGateway_StreamAlarmsClient
-
 // Enumerations from the generated contract re-exported for client callers.
 type (
 	// MxCommandKind discriminates which MXAccess command an MxCommand carries.

clients/java/JavaClientDesign.md

@@ -18,13 +18,13 @@ clients/java/
   settings.gradle
   build.gradle
   src/main/generated/
-  zb-mom-ww-mxgateway-client/
+  mxgateway-client/
     build.gradle
-    src/main/java/com/zb/mom/ww/mxgateway/client/
-    src/test/java/com/zb/mom/ww/mxgateway/client/
-  zb-mom-ww-mxgateway-cli/
+    src/main/java/com/dohertylan/mxgateway/client/
+    src/test/java/com/dohertylan/mxgateway/client/
+  mxgateway-cli/
     build.gradle
-    src/main/java/com/zb/mom/ww/mxgateway/cli/
+    src/main/java/com/dohertylan/mxgateway/cli/
 ```
 
 Alternative Maven layout is acceptable if the repo standardizes on Maven.
@@ -112,23 +112,6 @@ Support:
 - custom CA certificate file,
 - server name override for test environments.
 
-### Trust posture
-
-The gateway can serve a self-signed certificate it generates itself (it has no
-PKI). To make that usable, TLS is **lenient by default**: when the channel is not
-plaintext and no `caCertificatePath` is set, the client builds
-`GrpcSslContexts.forClient().trustManager(InsecureTrustManagerFactory.INSTANCE)`
-(grpc-netty-shaded), so the gateway's self-signed certificate is accepted without
-verification.
-
-To verify the gateway instead:
-
-- set `caCertificatePath` to pin a CA (full verification against that root), or
-- set `requireCertificateValidation` to `true` to verify against the JVM trust
-  store without pinning.
-
-Pinning a CA always wins over the lenient default.
-
 ## Streaming
 
 Support both:
@@ -209,8 +192,8 @@ stream for bounded time, and close.
 
 Publish library and CLI separately:
 
-- `zb-mom-ww-mxgateway-client` jar,
-- `zb-mom-ww-mxgateway-cli` runnable distribution.
+- `mxgateway-client` jar,
+- `mxgateway-cli` runnable distribution.
 
 Generated protobuf code should be produced during the build from shared proto
 files and should not be hand-edited.
@@ -223,10 +206,10 @@ Run the Java scaffold checks from `clients/java`:
 gradle test
 ```
 
-The `zb-mom-ww-mxgateway-client` project generates the gateway and worker
-protobuf/gRPC bindings into `src/main/generated`, compiles the generated
-contracts, and runs JUnit 5 tests. The `zb-mom-ww-mxgateway-cli` project
-builds a Picocli-based `mxgw-java` entry point for later command implementation.
+The `mxgateway-client` project generates the gateway and worker protobuf/gRPC
+bindings into `src/main/generated`, compiles the generated contracts, and runs
+JUnit 5 tests. The `mxgateway-cli` project builds a Picocli-based `mxgw-java`
+entry point for later command implementation.
 
 ## Related Documentation
 

clients/java/README.md

@@ -10,23 +10,22 @@ clients/java/
   settings.gradle
   build.gradle
   src/main/generated/
-  zb-mom-ww-mxgateway-client/
-  zb-mom-ww-mxgateway-cli/
+  mxgateway-client/
+  mxgateway-cli/
 ```
 
-`zb-mom-ww-mxgateway-client` generates Java protobuf and gRPC sources from
-`../../src/ZB.MOM.WW.MxGateway.Contracts/Protos`. The Gradle protobuf plugin writes those
+`mxgateway-client` generates Java protobuf and gRPC sources from
+`../../src/MxGateway.Contracts/Protos`. The Gradle protobuf plugin writes those
 generated sources under `src/main/generated`, which matches the client proto
 manifest in `../proto/proto-inputs.json`. Do not edit generated files by hand.
 
-`zb-mom-ww-mxgateway-client` exposes `MxGatewayClientOptions`, `MxGatewayClient`,
+`mxgateway-client` exposes `MxGatewayClientOptions`, `MxGatewayClient`,
 `MxGatewaySession`, value/status helpers, typed gateway exceptions, raw
 generated stubs, and generated protobuf messages for parity tests.
 
-`zb-mom-ww-mxgateway-cli` depends on `zb-mom-ww-mxgateway-client` and provides
-the `mxgw-java` application entry point. The CLI supports version, session,
-command, event streaming, write, and smoke-test commands with deterministic
-JSON output.
+`mxgateway-cli` depends on `mxgateway-client` and provides the `mxgw-java`
+application entry point. The CLI supports version, session, command, event
+streaming, write, and smoke-test commands with deterministic JSON output.
 
 ## Regenerating Protobuf Bindings
 
@@ -34,7 +33,7 @@ Run generation from `clients/java` after the shared `.proto` files or Java
 output path changes:
 
 ```powershell
-gradle :zb-mom-ww-mxgateway-client:generateProto
+gradle :mxgateway-client:generateProto
 ```
 
 ## Client Usage
@@ -57,16 +56,6 @@ try (MxGatewayClient client = MxGatewayClient.connect(options);
 }
 ```
 
-The gateway can auto-generate its own self-signed certificate (it has no PKI), so
-the client is **lenient by default**: a TLS connection (`plaintext(false)`) with
-no `caCertificatePath` accepts whatever certificate the gateway presents (via
-grpc-netty-shaded's `InsecureTrustManagerFactory`). To verify instead, set
-`caCertificatePath` to pin a CA, or set `requireCertificateValidation(true)` to
-verify against the JVM trust store without pinning. Use `serverNameOverride` /
-`--server-name-override` when the dialed host differs from the certificate SAN.
-See
-[Gateway Configuration](../../docs/GatewayConfiguration.md#automatic-self-signed-certificate).
-
 Use `rawBlockingStub`, `rawFutureStub`, `rawAsyncStub`, `openSessionRaw`,
 `closeSessionRaw`, `invoke`, and raw session helper methods when tests need the
 underlying protobuf messages. `MxGatewayCommandException` and
@@ -78,12 +67,6 @@ cancels the underlying gRPC stream. Canceling or timing out a Java client call
 only stops the client from waiting; it does not abort an in-flight MXAccess COM
 call on the worker STA.
 
-For alarms, `MxGatewayClient` exposes `queryActiveAlarms` (one-shot snapshot),
-`streamAlarms` (returns an `MxGatewayAlarmFeedSubscription` whose iterator
-yields alarm-feed messages from the gateway's central monitor), and
-`acknowledgeAlarm` (ack by full alarm reference with an optional comment and
-ack target). Close the subscription to cancel the underlying gRPC stream.
-
 ## Galaxy Repository Browse
 
 The Galaxy Repository service is a separate metadata-only gRPC service exposed
@@ -115,88 +98,17 @@ try (GalaxyRepositoryClient galaxy = GalaxyRepositoryClient.connect(options)) {
 messages directly so callers can read all fields (including the nested
 `GalaxyAttribute` list) without an extra DTO layer.
 
-The CLI exposes matching subcommands: `galaxy-test-connection`,
-`galaxy-last-deploy`, `galaxy-discover`, `galaxy-browse`, and `galaxy-watch`.
-The short names `galaxy-test` and `galaxy-deploy-time` remain as deprecated
-aliases for `galaxy-test-connection` and `galaxy-last-deploy` so existing
-scripts keep working. They take the same `--endpoint`, `--api-key-env`,
-`--plaintext`, `--ca-file`, `--server-name-override`, `--timeout`, and `--json`
-options as the gateway commands.
+The CLI exposes matching subcommands: `galaxy-test`, `galaxy-deploy-time`,
+`galaxy-discover`, and `galaxy-watch`. They take the same `--endpoint`,
+`--api-key-env`, `--plaintext`, `--ca-file`, `--server-name-override`,
+`--timeout`, and `--json` options as the gateway commands.
 
 ```powershell
-gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-test-connection --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-last-deploy --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-discover --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
+gradle :mxgateway-cli:run --args="galaxy-test --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
+gradle :mxgateway-cli:run --args="galaxy-deploy-time --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
+gradle :mxgateway-cli:run --args="galaxy-discover --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
 ```
 
-`galaxy-browse` walks the hierarchy via `BrowseChildren`. Without `--parent` it
-returns the root nodes and eagerly expands `--depth` further levels; with
-`--parent <gobject-id>` it returns exactly one level of children for that
-parent. The filter flags (`--category-ids`, `--template-contains`,
-`--tag-name-glob`, `--alarm-bearing-only`, `--historized-only`,
-`--include-attributes`) match `galaxy-discover`. The `--json` node shape is the
-cross-client browse surface: the flattened object fields plus a
-`hasChildrenHint` flag and a nested `children` array.
-
-```powershell
-gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-browse --depth 1 --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
-```
-
-### Browsing lazily
-
-For UI trees or OPC UA bridges, use `browseChildrenRaw` to walk one level at a
-time instead of loading the full hierarchy with `discoverHierarchy`. Pass a
-default request for root objects; subsequent calls set `parentGobjectId`,
-`parentTagName`, or `parentContainedPath`. Filter fields match
-`DiscoverHierarchy`. Each response pairs `getChildrenList()` with
-`getChildHasChildrenList()` so you know which nodes to expand. See
-[Galaxy Repository](../../docs/GalaxyRepository.md#browsechildren) for full
-request and filter semantics. For most callers the high-level
-`browse()`/`LazyBrowseNode` walker below is the preferred surface;
-`browseChildrenRaw` exposes the single underlying RPC when you need direct
-control of paging.
-
-```java
-BrowseChildrenReply reply = galaxy.browseChildrenRaw(
-        BrowseChildrenRequest.newBuilder().build());
-
-List<GalaxyObject> children = reply.getChildrenList();
-List<Boolean> hasChildren = reply.getChildHasChildrenList();
-for (int i = 0; i < children.size(); i++) {
-    System.out.printf("%s expand=%b%n", children.get(i).getTagName(), hasChildren.get(i));
-}
-```
-
-#### High-level walker
-
-For UI trees, the client provides a `LazyBrowseNode` walker that handles
-sibling pagination and the `child_has_children` hint for you:
-
-```java
-MxGatewayClientOptions options = MxGatewayClientOptions.builder()
-        .endpoint("localhost:5000")
-        .apiKey(System.getenv("MXGATEWAY_API_KEY"))
-        .plaintext(true)
-        .build();
-
-try (GalaxyRepositoryClient galaxy = GalaxyRepositoryClient.connect(options)) {
-    List<LazyBrowseNode> roots = galaxy.browse();
-    for (LazyBrowseNode root : roots) {
-        if (root.hasChildrenHint()) {
-            root.expand();
-        }
-        for (LazyBrowseNode child : root.getChildren()) {
-            String kind = child.hasChildrenHint() ? "has children" : "leaf";
-            System.out.println(child.getObject().getTagName() + " (" + kind + ")");
-        }
-    }
-}
-```
-
-`expand` is idempotent — calling it twice fires only one RPC,
-and is safe under concurrent callers. To refresh after a Galaxy redeploy, call
-`browse` again from the root.
-
 ### Watching deploy events
 
 `GalaxyRepository.WatchDeployEvents` is a server-streaming RPC: the gateway
@@ -244,8 +156,8 @@ The matching CLI subcommand streams events until cancelled (Ctrl+C) and prints
 one line per event in text mode or one JSON object per event with `--json`:
 
 ```powershell
-gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-watch --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-watch --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --last-seen-deploy-time 2026-04-28T18:30:00Z --limit 5"
+gradle :mxgateway-cli:run --args="galaxy-watch --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --json"
+gradle :mxgateway-cli:run --args="galaxy-watch --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --last-seen-deploy-time 2026-04-28T18:30:00Z --limit 5"
 ```
 
 ## CLI Usage
@@ -253,30 +165,24 @@ gradle :zb-mom-ww-mxgateway-cli:run --args="galaxy-watch --endpoint localhost:50
 Run the CLI through Gradle:
 
 ```powershell
-gradle :zb-mom-ww-mxgateway-cli:run --args="version --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="open-session --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --client-session-name java-cli --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="ping --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --message hello --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="register --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --client-name java-cli --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="add-item --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --server-handle 1 --item TestObject.TestInt --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="advise --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --server-handle 1 --item-handle 1 --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="write --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --server-handle 1 --item-handle 1 --type int32 --value 123 --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="stream-events --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --limit 1 --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="stream-alarms --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --filter-prefix Galaxy --limit 1 --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="acknowledge-alarm --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --reference \"\\Galaxy\Area001.Pump001.PumpFault\" --json"
-gradle :zb-mom-ww-mxgateway-cli:run --args="smoke --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --item TestObject.TestInt --json"
+gradle :mxgateway-cli:run --args="version --json"
+gradle :mxgateway-cli:run --args="open-session --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --client-session-name java-cli --json"
+gradle :mxgateway-cli:run --args="register --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --client-name java-cli --json"
+gradle :mxgateway-cli:run --args="add-item --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --server-handle 1 --item TestObject.TestInt --json"
+gradle :mxgateway-cli:run --args="advise --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --server-handle 1 --item-handle 1 --json"
+gradle :mxgateway-cli:run --args="write --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --server-handle 1 --item-handle 1 --type int32 --value 123 --json"
+gradle :mxgateway-cli:run --args="stream-events --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --session-id <id> --limit 1 --json"
+gradle :mxgateway-cli:run --args="smoke --endpoint localhost:5000 --api-key-env MXGATEWAY_API_KEY --plaintext --item TestObject.TestInt --json"
 ```
 
 The CLI accepts `--api-key`, `--api-key-env`, `--plaintext`, `--ca-file`,
-`--server-name-override`, `--require-certificate-validation`, `--timeout`, and
-`--json` on gateway commands. JSON output redacts API keys. TLS is lenient by
-default (the certificate is not verified unless you pin a CA with `--ca-file`);
-pass `--require-certificate-validation` to verify the server certificate against
-the JVM trust store without pinning.
+`--server-name-override`, `--timeout`, and `--json` on gateway commands. JSON
+output redacts API keys.
 
 Use TLS options for a secured gateway:
 
 ```powershell
-gradle :zb-mom-ww-mxgateway-cli:run --args="smoke --endpoint mxgateway.example.local:5001 --ca-file C:\certs\mxgateway-ca.pem --server-name-override mxgateway.example.local --api-key-env MXGATEWAY_API_KEY --item TestObject.TestInt --json"
+gradle :mxgateway-cli:run --args="smoke --endpoint mxgateway.example.local:5001 --ca-file C:\certs\mxgateway-ca.pem --server-name-override mxgateway.example.local --api-key-env MXGATEWAY_API_KEY --item TestObject.TestInt --json"
 ```
 
 ## Build And Test
@@ -296,11 +202,11 @@ in-process gRPC behavior, stream cancellation, and CLI parser/output behavior.
 Create local library and CLI artifacts from `clients/java`:
 
 ```powershell
-gradle :zb-mom-ww-mxgateway-client:jar :zb-mom-ww-mxgateway-cli:installDist
+gradle :mxgateway-client:jar :mxgateway-cli:installDist
 ```
 
-The library jar is under `zb-mom-ww-mxgateway-client/build/libs`. The installed CLI
-distribution is under `zb-mom-ww-mxgateway-cli/build/install/zb-mom-ww-mxgateway-cli`.
+The library jar is under `mxgateway-client/build/libs`. The installed CLI
+distribution is under `mxgateway-cli/build/install/mxgateway-cli`.
 
 ## Integration Checks
 
@@ -311,40 +217,9 @@ $env:MXGATEWAY_INTEGRATION = '1'
 $env:MXGATEWAY_ENDPOINT = 'localhost:5000'
 $env:MXGATEWAY_API_KEY = '<gateway-api-key>'
 $env:MXGATEWAY_TEST_ITEM = 'TestObject.TestInt'
-gradle :zb-mom-ww-mxgateway-cli:run --args="smoke --endpoint $env:MXGATEWAY_ENDPOINT --plaintext --api-key-env MXGATEWAY_API_KEY --item $env:MXGATEWAY_TEST_ITEM --json"
+gradle :mxgateway-cli:run --args="smoke --endpoint $env:MXGATEWAY_ENDPOINT --plaintext --api-key-env MXGATEWAY_API_KEY --item $env:MXGATEWAY_TEST_ITEM --json"
 ```
 
-## Installing from the Gitea Maven repository
-
-The client publishes to the internal Gitea Maven repository at
-`https://gitea.dohertylan.com/api/packages/dohertj2/maven`.
-
-In your consumer project's `build.gradle`:
-
-````groovy
-repositories {
-    maven {
-        url 'https://gitea.dohertylan.com/api/packages/dohertj2/maven'
-        credentials {
-            username = System.getenv('GITEA_USERNAME')
-            password = System.getenv('GITEA_TOKEN')
-        }
-    }
-}
-
-dependencies {
-    implementation 'com.zb.mom.ww.mxgateway:zb-mom-ww-mxgateway-client:0.1.1'
-}
-````
-
-To publish a new version from this repo:
-
-````bash
-export GITEA_USERNAME=dohertj2
-export GITEA_TOKEN=<your-gitea-token>
-gradle :zb-mom-ww-mxgateway-client:publish
-````
-
 ## Related Documentation
 
 - [Client Packaging](../../docs/ClientPackaging.md)

clients/java/build.gradle

@@ -12,8 +12,8 @@ ext {
 }
 
 subprojects {
-    group = 'com.zb.mom.ww.mxgateway'
-    version = '0.1.1'
+    group = 'com.dohertylan.mxgateway'
+    version = '0.1.0'
 
     pluginManager.withPlugin('java') {
         java {
@@ -37,44 +37,4 @@ subprojects {
             testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
         }
     }
-
-    pluginManager.withPlugin('maven-publish') {
-        publishing {
-            publications {
-                maven(MavenPublication) {
-                    from components.java
-                    pom {
-                        url = 'https://gitea.dohertylan.com/dohertj2/mxaccessgw'
-                        description = 'MxAccessGateway Java client'
-                        scm {
-                            url = 'https://gitea.dohertylan.com/dohertj2/mxaccessgw'
-                            connection = 'scm:git:https://gitea.dohertylan.com/dohertj2/mxaccessgw.git'
-                        }
-                        developers {
-                            developer {
-                                id = 'dohertj2'
-                                name = 'Joseph Doherty'
-                            }
-                        }
-                        licenses {
-                            license {
-                                name = 'Proprietary'
-                                distribution = 'repo'
-                            }
-                        }
-                    }
-                }
-            }
-            repositories {
-                maven {
-                    name = 'GiteaPackages'
-                    url = 'https://gitea.dohertylan.com/api/packages/dohertj2/maven'
-                    credentials {
-                        username = System.getenv('GITEA_USERNAME') ?: ''
-                        password = System.getenv('GITEA_TOKEN') ?: ''
-                    }
-                }
-            }
-        }
-    }
 }

clients/java/mxgateway-cli/build.gradle

@@ -0,0 +1,13 @@
+plugins {
+    id 'application'
+}
+
+dependencies {
+    implementation project(':mxgateway-client')
+    implementation "com.google.protobuf:protobuf-java-util:${protobufVersion}"
+    implementation "info.picocli:picocli:${picocliVersion}"
+}
+
+application {
+    mainClass = 'com.dohertylan.mxgateway.cli.MxGatewayCli'
+}

clients/java/mxgateway-cli/src/main/java/com/dohertylan/mxgateway/cli/MxGatewayCli.java

@@ -0,0 +1,985 @@
+package com.dohertylan.mxgateway.cli;
+
+import com.dohertylan.mxgateway.client.DeployEventStream;
+import com.dohertylan.mxgateway.client.GalaxyRepositoryClient;
+import com.dohertylan.mxgateway.client.MxEventStream;
+import com.dohertylan.mxgateway.client.MxGatewayClient;
+import com.dohertylan.mxgateway.client.MxGatewayClientOptions;
+import com.dohertylan.mxgateway.client.MxGatewayClientVersion;
+import com.dohertylan.mxgateway.client.MxGatewaySecrets;
+import com.dohertylan.mxgateway.client.MxGatewaySession;
+import com.dohertylan.mxgateway.client.MxValues;
+import galaxy_repository.v1.GalaxyRepositoryOuterClass.DeployEvent;
+import galaxy_repository.v1.GalaxyRepositoryOuterClass.GalaxyAttribute;
+import galaxy_repository.v1.GalaxyRepositoryOuterClass.GalaxyObject;
+import com.google.protobuf.Message;
+import com.google.protobuf.util.JsonFormat;
+import java.io.PrintWriter;
+import java.nio.file.Path;
+import java.time.Duration;
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.concurrent.Callable;
+import mxaccess_gateway.v1.MxaccessGateway.CloseSessionRequest;
+import mxaccess_gateway.v1.MxaccessGateway.MxCommandReply;
+import mxaccess_gateway.v1.MxaccessGateway.MxEvent;
+import mxaccess_gateway.v1.MxaccessGateway.MxValue;
+import mxaccess_gateway.v1.MxaccessGateway.OpenSessionRequest;
+import mxaccess_gateway.v1.MxaccessGateway.SubscribeResult;
+import picocli.CommandLine;
+import picocli.CommandLine.Command;
+import picocli.CommandLine.Mixin;
+import picocli.CommandLine.Model.CommandSpec;
+import picocli.CommandLine.Option;
+import picocli.CommandLine.Spec;
+
+/**
+ * Picocli entry point for the {@code mxgw-java} test CLI used by the
+ * cross-language smoke matrix.
+ */
+@Command(
+        name = "mxgw-java",
+        mixinStandardHelpOptions = true,
+        description = "MXAccess Gateway Java test CLI.")
+public final class MxGatewayCli implements Callable<Integer> {
+    private final MxGatewayCliClientFactory clientFactory;
+
+    @Spec
+    private CommandSpec spec;
+
+    /**
+     * Builds a CLI bound to the default gRPC client factory.
+     */
+    public MxGatewayCli() {
+        this(new GrpcMxGatewayCliClientFactory());
+    }
+
+    MxGatewayCli(MxGatewayCliClientFactory clientFactory) {
+        this.clientFactory = clientFactory;
+    }
+
+    /**
+     * Process entry point.
+     *
+     * @param args command-line arguments
+     */
+    public static void main(String[] args) {
+        int exitCode = commandLine(new GrpcMxGatewayCliClientFactory()).execute(args);
+        System.exit(exitCode);
+    }
+
+    /**
+     * Test-friendly entry point that runs the CLI against the supplied
+     * {@link PrintWriter} pair instead of the system streams.
+     *
+     * @param out writer that receives standard output
+     * @param err writer that receives standard error
+     * @param args command-line arguments
+     * @return the picocli exit code
+     */
+    public static int execute(PrintWriter out, PrintWriter err, String... args) {
+        return execute(new GrpcMxGatewayCliClientFactory(), out, err, args);
+    }
+
+    static int execute(MxGatewayCliClientFactory clientFactory, PrintWriter out, PrintWriter err, String... args) {
+        CommandLine commandLine = commandLine(clientFactory);
+        commandLine.setOut(out);
+        commandLine.setErr(err);
+        return commandLine.execute(args);
+    }
+
+    @Override
+    public Integer call() {
+        spec.commandLine().usage(spec.commandLine().getOut());
+        return 0;
+    }
+
+    private static CommandLine commandLine(MxGatewayCliClientFactory clientFactory) {
+        CommandLine commandLine = new CommandLine(new MxGatewayCli(clientFactory));
+        commandLine.addSubcommand("version", new VersionCommand());
+        commandLine.addSubcommand("open-session", new OpenSessionCommand(clientFactory));
+        commandLine.addSubcommand("close-session", new CloseSessionCommand(clientFactory));
+        commandLine.addSubcommand("register", new RegisterCommand(clientFactory));
+        commandLine.addSubcommand("add-item", new AddItemCommand(clientFactory));
+        commandLine.addSubcommand("advise", new AdviseCommand(clientFactory));
+        commandLine.addSubcommand("subscribe-bulk", new SubscribeBulkCommand(clientFactory));
+        commandLine.addSubcommand("unsubscribe-bulk", new UnsubscribeBulkCommand(clientFactory));
+        commandLine.addSubcommand("write", new WriteCommand(clientFactory));
+        commandLine.addSubcommand("stream-events", new StreamEventsCommand(clientFactory));
+        commandLine.addSubcommand("smoke", new SmokeCommand(clientFactory));
+        commandLine.addSubcommand("galaxy-test", new GalaxyTestConnectionCommand());
+        commandLine.addSubcommand("galaxy-deploy-time", new GalaxyDeployTimeCommand());
+        commandLine.addSubcommand("galaxy-discover", new GalaxyDiscoverCommand());
+        commandLine.addSubcommand("galaxy-watch", new GalaxyWatchCommand());
+        return commandLine;
+    }
+
+    abstract static class GalaxyCommand implements Callable<Integer> {
+        @Mixin
+        CommonOptions common = new CommonOptions();
+
+        @Option(names = "--json", description = "Write JSON output.")
+        boolean json;
+
+        GalaxyRepositoryClient connect() {
+            return GalaxyRepositoryClient.connect(common.resolved().toClientOptions());
+        }
+    }
+
+    @Command(name = "galaxy-test", description = "Calls GalaxyRepository.TestConnection.")
+    static final class GalaxyTestConnectionCommand extends GalaxyCommand {
+        @Override
+        public Integer call() {
+            try (GalaxyRepositoryClient client = connect()) {
+                boolean ok = client.testConnection();
+                PrintWriter out = common.spec.commandLine().getOut();
+                if (json) {
+                    Map<String, Object> output = new LinkedHashMap<>();
+                    output.put("command", "galaxy-test");
+                    output.put("options", common.redactedJsonMap());
+                    output.put("ok", ok);
+                    out.println(jsonObject(output));
+                } else {
+                    out.println(ok);
+                }
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "galaxy-deploy-time", description = "Calls GalaxyRepository.GetLastDeployTime.")
+    static final class GalaxyDeployTimeCommand extends GalaxyCommand {
+        @Override
+        public Integer call() {
+            try (GalaxyRepositoryClient client = connect()) {
+                Optional<Instant> result = client.getLastDeployTime();
+                PrintWriter out = common.spec.commandLine().getOut();
+                if (json) {
+                    Map<String, Object> output = new LinkedHashMap<>();
+                    output.put("command", "galaxy-deploy-time");
+                    output.put("options", common.redactedJsonMap());
+                    output.put("present", result.isPresent());
+                    output.put("timeOfLastDeploy", result.map(Instant::toString).orElse(""));
+                    out.println(jsonObject(output));
+                } else if (result.isPresent()) {
+                    out.println(result.get());
+                } else {
+                    out.println("(none)");
+                }
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "galaxy-discover", description = "Calls GalaxyRepository.DiscoverHierarchy.")
+    static final class GalaxyDiscoverCommand extends GalaxyCommand {
+        @Override
+        public Integer call() {
+            try (GalaxyRepositoryClient client = connect()) {
+                List<GalaxyObject> objects = client.discoverHierarchy();
+                PrintWriter out = common.spec.commandLine().getOut();
+                if (json) {
+                    Map<String, Object> output = new LinkedHashMap<>();
+                    output.put("command", "galaxy-discover");
+                    output.put("options", common.redactedJsonMap());
+                    output.put("objects", objects.stream().map(MxGatewayCli::galaxyObjectMap).toList());
+                    out.println(jsonObject(output));
+                } else {
+                    out.printf("count=%d%n", objects.size());
+                    for (GalaxyObject obj : objects) {
+                        out.printf("  %s [%s] attrs=%d%n",
+                                obj.getTagName(), obj.getBrowseName(), obj.getAttributesCount());
+                    }
+                }
+            }
+            return 0;
+        }
+    }
+
+    @Command(
+            name = "galaxy-watch",
+            description = "Streams GalaxyRepository.WatchDeployEvents until cancelled.")
+    static final class GalaxyWatchCommand extends GalaxyCommand {
+        @Option(
+                names = "--last-seen-deploy-time",
+                description =
+                        "Optional ISO-8601 instant. When supplied, the bootstrap event is suppressed if the cached"
+                                + " deploy time matches.")
+        String lastSeenDeployTime;
+
+        @Option(names = "--limit", defaultValue = "0", description = "Maximum events to print before exiting.")
+        int limit;
+
+        @Override
+        public Integer call() {
+            Instant after = parseInstant(lastSeenDeployTime);
+            try (GalaxyRepositoryClient client = connect();
+                    DeployEventStream events = client.watchDeployEvents(after)) {
+                PrintWriter out = common.spec.commandLine().getOut();
+                Thread shutdownHook = new Thread(events::close, "galaxy-watch-shutdown");
+                Runtime.getRuntime().addShutdownHook(shutdownHook);
+                try {
+                    int count = 0;
+                    while (events.hasNext()) {
+                        DeployEvent event = events.next();
+                        if (json) {
+                            out.println(protoJson(event));
+                        } else {
+                            out.printf(
+                                    "seq=%d observed=%s deployTime=%s objects=%d attributes=%d%n",
+                                    event.getSequence(),
+                                    formatTimestamp(event.getObservedAt()),
+                                    event.getTimeOfLastDeployPresent()
+                                            ? formatTimestamp(event.getTimeOfLastDeploy())
+                                            : "(none)",
+                                    event.getObjectCount(),
+                                    event.getAttributeCount());
+                        }
+                        out.flush();
+                        count++;
+                        if (limit > 0 && count >= limit) {
+                            events.close();
+                            break;
+                        }
+                    }
+                } finally {
+                    try {
+                        Runtime.getRuntime().removeShutdownHook(shutdownHook);
+                    } catch (IllegalStateException ignored) {
+                        // JVM is already shutting down.
+                    }
+                }
+            }
+            return 0;
+        }
+
+        private static Instant parseInstant(String value) {
+            if (value == null || value.isBlank()) {
+                return null;
+            }
+            return Instant.parse(value);
+        }
+
+        private static String formatTimestamp(com.google.protobuf.Timestamp ts) {
+            return Instant.ofEpochSecond(ts.getSeconds(), ts.getNanos()).toString();
+        }
+    }
+
+    private static Map<String, Object> galaxyObjectMap(GalaxyObject obj) {
+        Map<String, Object> values = new LinkedHashMap<>();
+        values.put("gobjectId", obj.getGobjectId());
+        values.put("tagName", obj.getTagName());
+        values.put("containedName", obj.getContainedName());
+        values.put("browseName", obj.getBrowseName());
+        values.put("parentGobjectId", obj.getParentGobjectId());
+        values.put("isArea", obj.getIsArea());
+        values.put("categoryId", obj.getCategoryId());
+        values.put("hostedByGobjectId", obj.getHostedByGobjectId());
+        values.put("templateChain", new ArrayList<>(obj.getTemplateChainList()));
+        List<Map<String, Object>> attrs = new ArrayList<>();
+        for (GalaxyAttribute attr : obj.getAttributesList()) {
+            Map<String, Object> attrMap = new LinkedHashMap<>();
+            attrMap.put("attributeName", attr.getAttributeName());
+            attrMap.put("fullTagReference", attr.getFullTagReference());
+            attrMap.put("mxDataType", attr.getMxDataType());
+            attrMap.put("dataTypeName", attr.getDataTypeName());
+            attrMap.put("isArray", attr.getIsArray());
+            attrMap.put("arrayDimension", attr.getArrayDimension());
+            attrMap.put("arrayDimensionPresent", attr.getArrayDimensionPresent());
+            attrMap.put("mxAttributeCategory", attr.getMxAttributeCategory());
+            attrMap.put("securityClassification", attr.getSecurityClassification());
+            attrMap.put("isHistorized", attr.getIsHistorized());
+            attrMap.put("isAlarm", attr.getIsAlarm());
+            attrs.add(attrMap);
+        }
+        values.put("attributes", attrs);
+        return values;
+    }
+
+    /**
+     * Picocli subcommand that prints the client and protocol version numbers.
+     */
+    @Command(name = "version", description = "Prints the Java client version.")
+    public static final class VersionCommand implements Callable<Integer> {
+        @Spec
+        private CommandSpec spec;
+
+        @Option(names = "--json", description = "Write JSON output.")
+        private boolean json;
+
+        @Override
+        public Integer call() {
+            Map<String, Object> values = new LinkedHashMap<>();
+            values.put("clientVersion", MxGatewayClientVersion.clientVersion());
+            values.put("gatewayProtocolVersion", MxGatewayClientVersion.gatewayProtocolVersion());
+            values.put("workerProtocolVersion", MxGatewayClientVersion.workerProtocolVersion());
+            if (json) {
+                spec.commandLine().getOut().println(jsonObject(values));
+                return 0;
+            }
+
+            spec.commandLine()
+                    .getOut()
+                    .printf(
+                            "mxgateway-java %s gatewayProtocolVersion=%d workerProtocolVersion=%d%n",
+                            MxGatewayClientVersion.clientVersion(),
+                            MxGatewayClientVersion.gatewayProtocolVersion(),
+                            MxGatewayClientVersion.workerProtocolVersion());
+            return 0;
+        }
+    }
+
+    abstract static class GatewayCommand implements Callable<Integer> {
+        final MxGatewayCliClientFactory clientFactory;
+
+        @Mixin
+        CommonOptions common = new CommonOptions();
+
+        @Option(names = "--json", description = "Write JSON output.")
+        boolean json;
+
+        GatewayCommand(MxGatewayCliClientFactory clientFactory) {
+            this.clientFactory = clientFactory;
+        }
+    }
+
+    @Command(name = "open-session", description = "Opens a gateway session.")
+    static final class OpenSessionCommand extends GatewayCommand {
+        @Option(names = "--client-session-name", description = "Client session name.")
+        String clientSessionName = "";
+
+        @Option(names = "--backend", description = "Requested gateway backend.")
+        String backend = "";
+
+        OpenSessionCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                var reply = client.openSession(OpenSessionRequest.newBuilder()
+                        .setClientSessionName(clientSessionName)
+                        .setRequestedBackend(backend)
+                        .build());
+                writeOutput("open-session", common, json, reply, () -> reply.getSessionId());
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "close-session", description = "Closes a gateway session.")
+    static final class CloseSessionCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        CloseSessionCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                var reply = client.closeSession(CloseSessionRequest.newBuilder()
+                        .setSessionId(sessionId)
+                        .build());
+                writeOutput("close-session", common, json, reply, () -> reply.getFinalState().name());
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "register", description = "Invokes MXAccess Register.")
+    static final class RegisterCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--client-name", required = true, description = "MXAccess client name.")
+        String clientName;
+
+        RegisterCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                MxCommandReply reply = client.session(sessionId).registerRaw(clientName);
+                writeOutput("register", common, json, reply, () -> reply.getKind().name());
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "add-item", description = "Invokes MXAccess AddItem.")
+    static final class AddItemCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--server-handle", required = true, description = "MXAccess server handle.")
+        int serverHandle;
+
+        @Option(names = "--item", required = true, description = "Item definition.")
+        String item;
+
+        AddItemCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                MxCommandReply reply = client.session(sessionId).addItemRaw(serverHandle, item);
+                writeOutput("add-item", common, json, reply, () -> reply.getKind().name());
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "advise", description = "Invokes MXAccess Advise.")
+    static final class AdviseCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--server-handle", required = true, description = "MXAccess server handle.")
+        int serverHandle;
+
+        @Option(names = "--item-handle", required = true, description = "MXAccess item handle.")
+        int itemHandle;
+
+        AdviseCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                MxCommandReply reply = client.session(sessionId).adviseRaw(serverHandle, itemHandle);
+                writeOutput("advise", common, json, reply, () -> reply.getKind().name());
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "subscribe-bulk", description = "Invokes MXAccess SubscribeBulk.")
+    static final class SubscribeBulkCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--server-handle", required = true, description = "MXAccess server handle.")
+        int serverHandle;
+
+        @Option(names = "--items", required = true, description = "Comma-separated item definitions.")
+        String items;
+
+        SubscribeBulkCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                List<SubscribeResult> results =
+                        client.session(sessionId).subscribeBulk(serverHandle, parseStringList(items));
+                writeBulkOutput("subscribe-bulk", common, json, results);
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "unsubscribe-bulk", description = "Invokes MXAccess UnsubscribeBulk.")
+    static final class UnsubscribeBulkCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--server-handle", required = true, description = "MXAccess server handle.")
+        int serverHandle;
+
+        @Option(names = "--item-handles", required = true, description = "Comma-separated item handles.")
+        String itemHandles;
+
+        UnsubscribeBulkCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                List<SubscribeResult> results =
+                        client.session(sessionId).unsubscribeBulk(serverHandle, parseIntList(itemHandles));
+                writeBulkOutput("unsubscribe-bulk", common, json, results);
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "write", description = "Invokes MXAccess Write.")
+    static final class WriteCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--server-handle", required = true, description = "MXAccess server handle.")
+        int serverHandle;
+
+        @Option(names = "--item-handle", required = true, description = "MXAccess item handle.")
+        int itemHandle;
+
+        @Option(names = "--type", defaultValue = "string", description = "Value type.")
+        String type;
+
+        @Option(names = "--value", required = true, description = "Value text.")
+        String value;
+
+        @Option(names = "--user-id", defaultValue = "0", description = "MXAccess user id.")
+        int userId;
+
+        WriteCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                MxCommandReply reply =
+                        client.session(sessionId).writeRaw(serverHandle, itemHandle, parseValue(type, value), userId);
+                writeOutput("write", common, json, reply, () -> reply.getKind().name());
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "stream-events", description = "Streams gateway events.")
+    static final class StreamEventsCommand extends GatewayCommand {
+        @Option(names = "--session-id", required = true, description = "Gateway session id.")
+        String sessionId;
+
+        @Option(names = "--after-worker-sequence", defaultValue = "0", description = "Starting worker sequence.")
+        long afterWorkerSequence;
+
+        @Option(names = "--limit", defaultValue = "0", description = "Maximum events to print.")
+        int limit;
+
+        StreamEventsCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved());
+                    MxEventStream events = client.session(sessionId).streamEventsAfter(afterWorkerSequence)) {
+                int count = 0;
+                while (events.hasNext()) {
+                    MxEvent event = events.next();
+                    if (json) {
+                        client.out().println(protoJson(event));
+                    } else {
+                        client.out().printf("%d %s%n", event.getWorkerSequence(), event.getFamily());
+                    }
+                    count++;
+                    if (limit > 0 && count >= limit) {
+                        events.close();
+                        break;
+                    }
+                }
+            }
+            return 0;
+        }
+    }
+
+    @Command(name = "smoke", description = "Runs a bounded open/register/add/advise flow.")
+    static final class SmokeCommand extends GatewayCommand {
+        @Option(names = "--client-name", defaultValue = "mxgw-java-smoke", description = "MXAccess client name.")
+        String clientName;
+
+        @Option(names = "--item", required = true, description = "Item definition.")
+        String item;
+
+        SmokeCommand(MxGatewayCliClientFactory clientFactory) {
+            super(clientFactory);
+        }
+
+        @Override
+        public Integer call() {
+            try (MxGatewayCliClient client = clientFactory.connect(common.resolved())) {
+                var session = client.openSession(OpenSessionRequest.newBuilder()
+                        .setClientSessionName(clientName)
+                        .build());
+                try {
+                    MxGatewayCliSession cliSession = client.session(session.getSessionId());
+                    int serverHandle = cliSession.register(clientName);
+                    int itemHandle = cliSession.addItem(serverHandle, item);
+                    cliSession.advise(serverHandle, itemHandle);
+                    if (json) {
+                        Map<String, Object> output = new LinkedHashMap<>();
+                        output.put("command", "smoke");
+                        output.put("options", common.redactedJsonMap());
+                        output.put("sessionId", session.getSessionId());
+                        output.put("serverHandle", serverHandle);
+                        output.put("itemHandle", itemHandle);
+                        client.out().println(jsonObject(output));
+                    } else {
+                        client.out().printf(
+                                "session=%s server=%d item=%d%n", session.getSessionId(), serverHandle, itemHandle);
+                    }
+                } finally {
+                    client.closeSession(CloseSessionRequest.newBuilder()
+                            .setSessionId(session.getSessionId())
+                            .build());
+                }
+            }
+            return 0;
+        }
+    }
+
+    static final class CommonOptions {
+        @Spec
+        CommandSpec spec;
+
+        @Option(names = "--endpoint", defaultValue = "localhost:5000", description = "Gateway endpoint.")
+        String endpoint;
+
+        @Option(names = "--api-key", description = "Gateway API key.")
+        String apiKey = "";
+
+        @Option(names = "--api-key-env", defaultValue = "MXGATEWAY_API_KEY", description = "API key environment variable.")
+        String apiKeyEnv;
+
+        @Option(names = "--plaintext", description = "Use plaintext transport.")
+        boolean plaintext;
+
+        @Option(names = "--ca-file", description = "CA certificate file.")
+        Path caFile;
+
+        @Option(names = "--server-name-override", description = "TLS server name override.")
+        String serverNameOverride = "";
+
+        @Option(names = "--timeout", defaultValue = "30s", description = "Per-call timeout.")
+        String timeout;
+
+        private String resolvedApiKey = "";
+        private Duration resolvedTimeout = Duration.ofSeconds(30);
+
+        CommonOptions resolved() {
+            resolvedApiKey = apiKey == null || apiKey.isBlank() ? System.getenv(apiKeyEnv) : apiKey;
+            if (resolvedApiKey == null) {
+                resolvedApiKey = "";
+            }
+            resolvedTimeout = parseDuration(timeout);
+            return this;
+        }
+
+        MxGatewayClientOptions toClientOptions() {
+            return MxGatewayClientOptions.builder()
+                    .endpoint(endpoint)
+                    .apiKey(resolvedApiKey)
+                    .plaintext(plaintext)
+                    .caCertificatePath(caFile)
+                    .serverNameOverride(serverNameOverride)
+                    .callTimeout(resolvedTimeout)
+                    .build();
+        }
+
+        Map<String, Object> redactedJsonMap() {
+            Map<String, Object> values = new LinkedHashMap<>();
+            values.put("endpoint", endpoint);
+            values.put("apiKey", MxGatewaySecrets.redactApiKey(resolvedApiKey));
+            values.put("apiKeyEnv", apiKeyEnv);
+            values.put("plaintext", plaintext);
+            values.put("caFile", caFile == null ? "" : caFile.toString());
+            values.put("serverNameOverride", serverNameOverride);
+            values.put("timeout", timeout);
+            return values;
+        }
+    }
+
+    interface MxGatewayCliClientFactory {
+        MxGatewayCliClient connect(CommonOptions options);
+    }
+
+    interface MxGatewayCliClient extends AutoCloseable {
+        PrintWriter out();
+
+        mxaccess_gateway.v1.MxaccessGateway.OpenSessionReply openSession(OpenSessionRequest request);
+
+        mxaccess_gateway.v1.MxaccessGateway.CloseSessionReply closeSession(CloseSessionRequest request);
+
+        MxGatewayCliSession session(String sessionId);
+
+        @Override
+        void close();
+    }
+
+    interface MxGatewayCliSession {
+        int register(String clientName);
+
+        MxCommandReply registerRaw(String clientName);
+
+        int addItem(int serverHandle, String itemDefinition);
+
+        MxCommandReply addItemRaw(int serverHandle, String itemDefinition);
+
+        void advise(int serverHandle, int itemHandle);
+
+        MxCommandReply adviseRaw(int serverHandle, int itemHandle);
+
+        MxCommandReply writeRaw(int serverHandle, int itemHandle, MxValue value, int userId);
+
+        List<SubscribeResult> subscribeBulk(int serverHandle, List<String> items);
+
+        List<SubscribeResult> unsubscribeBulk(int serverHandle, List<Integer> itemHandles);
+
+        MxEventStream streamEventsAfter(long afterWorkerSequence);
+    }
+
+    static final class GrpcMxGatewayCliClientFactory implements MxGatewayCliClientFactory {
+        @Override
+        public MxGatewayCliClient connect(CommonOptions options) {
+            return new GrpcMxGatewayCliClient(MxGatewayClient.connect(options.toClientOptions()), options.spec.commandLine().getOut());
+        }
+    }
+
+    static final class GrpcMxGatewayCliClient implements MxGatewayCliClient {
+        private final MxGatewayClient client;
+        private final PrintWriter out;
+
+        GrpcMxGatewayCliClient(MxGatewayClient client, PrintWriter out) {
+            this.client = client;
+            this.out = out;
+        }
+
+        @Override
+        public PrintWriter out() {
+            return out;
+        }
+
+        @Override
+        public mxaccess_gateway.v1.MxaccessGateway.OpenSessionReply openSession(OpenSessionRequest request) {
+            return client.openSessionRaw(request);
+        }
+
+        @Override
+        public mxaccess_gateway.v1.MxaccessGateway.CloseSessionReply closeSession(CloseSessionRequest request) {
+            return client.closeSessionRaw(request);
+        }
+
+        @Override
+        public MxGatewayCliSession session(String sessionId) {
+            return new GrpcMxGatewayCliSession(MxGatewaySession.forSessionId(client, sessionId));
+        }
+
+        @Override
+        public void close() {
+            client.close();
+        }
+    }
+
+    record GrpcMxGatewayCliSession(MxGatewaySession session) implements MxGatewayCliSession {
+        @Override
+        public int register(String clientName) {
+            return session.register(clientName);
+        }
+
+        @Override
+        public MxCommandReply registerRaw(String clientName) {
+            return session.registerRaw(clientName);
+        }
+
+        @Override
+        public int addItem(int serverHandle, String itemDefinition) {
+            return session.addItem(serverHandle, itemDefinition);
+        }
+
+        @Override
+        public MxCommandReply addItemRaw(int serverHandle, String itemDefinition) {
+            return session.addItemRaw(serverHandle, itemDefinition);
+        }
+
+        @Override
+        public void advise(int serverHandle, int itemHandle) {
+            session.advise(serverHandle, itemHandle);
+        }
+
+        @Override
+        public MxCommandReply adviseRaw(int serverHandle, int itemHandle) {
+            return session.adviseRaw(serverHandle, itemHandle);
+        }
+
+        @Override
+        public MxCommandReply writeRaw(int serverHandle, int itemHandle, MxValue value, int userId) {
+            return session.writeRaw(serverHandle, itemHandle, value, userId);
+        }
+
+        @Override
+        public List<SubscribeResult> subscribeBulk(int serverHandle, List<String> items) {
+            return session.subscribeBulk(serverHandle, items);
+        }
+
+        @Override
+        public List<SubscribeResult> unsubscribeBulk(int serverHandle, List<Integer> itemHandles) {
+            return session.unsubscribeBulk(serverHandle, itemHandles);
+        }
+
+        @Override
+        public MxEventStream streamEventsAfter(long afterWorkerSequence) {
+            return session.streamEventsAfter(afterWorkerSequence);
+        }
+    }
+
+    interface TextSupplier {
+        String get();
+    }
+
+    private static void writeOutput(
+            String command, CommonOptions common, boolean json, Message reply, TextSupplier textSupplier) {
+        PrintWriter out = common.spec.commandLine().getOut();
+        if (json) {
+            Map<String, Object> output = new LinkedHashMap<>();
+            output.put("command", command);
+            output.put("options", common.redactedJsonMap());
+            output.put("reply", new RawJson(protoJson(reply)));
+            out.println(jsonObject(output));
+            return;
+        }
+        out.println(textSupplier.get());
+    }
+
+    private static void writeBulkOutput(
+            String command, CommonOptions common, boolean json, List<SubscribeResult> results) {
+        PrintWriter out = common.spec.commandLine().getOut();
+        if (json) {
+            Map<String, Object> output = new LinkedHashMap<>();
+            output.put("command", command);
+            output.put("options", common.redactedJsonMap());
+            output.put("results", results.stream().map(MxGatewayCli::subscribeResultMap).toList());
+            out.println(jsonObject(output));
+            return;
+        }
+        out.println(results.size());
+    }
+
+    private static Map<String, Object> subscribeResultMap(SubscribeResult result) {
+        Map<String, Object> values = new LinkedHashMap<>();
+        values.put("serverHandle", result.getServerHandle());
+        values.put("tagAddress", result.getTagAddress());
+        values.put("itemHandle", result.getItemHandle());
+        values.put("wasSuccessful", result.getWasSuccessful());
+        values.put("errorMessage", result.getErrorMessage());
+        return values;
+    }
+
+    private static MxValue parseValue(String type, String text) {
+        return switch (type) {
+            case "bool" -> MxValues.boolValue(Boolean.parseBoolean(text));
+            case "int32" -> MxValues.int32Value(Integer.parseInt(text));
+            case "int64" -> MxValues.int64Value(Long.parseLong(text));
+            case "float" -> MxValues.floatValue(Float.parseFloat(text));
+            case "double" -> MxValues.doubleValue(Double.parseDouble(text));
+            case "string" -> MxValues.stringValue(text);
+            default -> throw new IllegalArgumentException("unsupported value type " + type);
+        };
+    }
+
+    private static List<String> parseStringList(String value) {
+        return Arrays.stream(value.split(","))
+                .map(String::trim)
+                .filter(item -> !item.isBlank())
+                .toList();
+    }
+
+    private static List<Integer> parseIntList(String value) {
+        return parseStringList(value).stream().map(Integer::parseInt).toList();
+    }
+
+    private static Duration parseDuration(String value) {
+        if (value == null || value.isBlank()) {
+            return Duration.ofSeconds(30);
+        }
+        if (value.startsWith("P")) {
+            return Duration.parse(value);
+        }
+        if (value.endsWith("ms")) {
+            return Duration.ofMillis(Long.parseLong(value.substring(0, value.length() - 2)));
+        }
+        if (value.endsWith("s")) {
+            return Duration.ofSeconds(Long.parseLong(value.substring(0, value.length() - 1)));
+        }
+        if (value.endsWith("m")) {
+            return Duration.ofMinutes(Long.parseLong(value.substring(0, value.length() - 1)));
+        }
+        return Duration.parse(value);
+    }
+
+    private static String protoJson(Message message) {
+        try {
+            return JsonFormat.printer().omittingInsignificantWhitespace().print(message);
+        } catch (Exception error) {
+            throw new IllegalStateException("failed to write protobuf JSON", error);
+        }
+    }
+
+    private static String jsonObject(Map<String, Object> values) {
+        StringBuilder builder = new StringBuilder();
+        builder.append('{');
+        boolean first = true;
+        for (Map.Entry<String, Object> entry : values.entrySet()) {
+            if (!first) {
+                builder.append(',');
+            }
+            first = false;
+            builder.append(jsonString(entry.getKey())).append(':').append(jsonValue(entry.getValue()));
+        }
+        builder.append('}');
+        return builder.toString();
+    }
+
+    @SuppressWarnings("unchecked")
+    private static String jsonValue(Object value) {
+        if (value == null) {
+            return "null";
+        }
+        if (value instanceof RawJson rawJson) {
+            return rawJson.value();
+        }
+        if (value instanceof String string) {
+            return jsonString(string);
+        }
+        if (value instanceof Number || value instanceof Boolean) {
+            return value.toString();
+        }
+        if (value instanceof Map<?, ?> map) {
+            return jsonObject((Map<String, Object>) map);
+        }
+        if (value instanceof Iterable<?> iterable) {
+            StringBuilder builder = new StringBuilder();
+            builder.append('[');
+            boolean first = true;
+            for (Object item : iterable) {
+                if (!first) {
+                    builder.append(',');
+                }
+                first = false;
+                builder.append(jsonValue(item));
+            }
+            builder.append(']');
+            return builder.toString();
+        }
+        return jsonString(value.toString());
+    }
+
+    private static String jsonString(String value) {
+        return '"'
+                + value.replace("\\", "\\\\")
+                        .replace("\"", "\\\"")
+                        .replace("\r", "\\r")
+                        .replace("\n", "\\n")
+                + '"';
+    }
+
+    private record RawJson(String value) {
+    }
+}

clients/java/mxgateway-cli/src/test/java/com/dohertylan/mxgateway/cli/MxGatewayCliTests.java

@@ -0,0 +1,309 @@
+package com.dohertylan.mxgateway.cli;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import java.util.ArrayList;
+import java.util.List;
+import mxaccess_gateway.v1.MxaccessGateway.AddItemReply;
+import mxaccess_gateway.v1.MxaccessGateway.CloseSessionReply;
+import mxaccess_gateway.v1.MxaccessGateway.CloseSessionRequest;
+import mxaccess_gateway.v1.MxaccessGateway.MxCommandKind;
+import mxaccess_gateway.v1.MxaccessGateway.MxCommandReply;
+import mxaccess_gateway.v1.MxaccessGateway.MxEvent;
+import mxaccess_gateway.v1.MxaccessGateway.MxValue;
+import mxaccess_gateway.v1.MxaccessGateway.OpenSessionReply;
+import mxaccess_gateway.v1.MxaccessGateway.OpenSessionRequest;
+import mxaccess_gateway.v1.MxaccessGateway.ProtocolStatus;
+import mxaccess_gateway.v1.MxaccessGateway.ProtocolStatusCode;
+import mxaccess_gateway.v1.MxaccessGateway.RegisterReply;
+import mxaccess_gateway.v1.MxaccessGateway.SessionState;
+import mxaccess_gateway.v1.MxaccessGateway.SubscribeResult;
+import org.junit.jupiter.api.Test;
+
+final class MxGatewayCliTests {
+    @Test
+    void versionCommandPrintsProtocolVersions() {
+        CliRun run = execute(new FakeClientFactory(), "version");
+
+        assertEquals(0, run.exitCode());
+        assertEquals("", run.errors());
+        assertTrue(run.output().contains("mxgateway-java 0.1.0"));
+        assertTrue(run.output().contains("gatewayProtocolVersion=3"));
+        assertTrue(run.output().contains("workerProtocolVersion=1"));
+    }
+
+    @Test
+    void versionCommandPrintsJson() {
+        CliRun run = execute(new FakeClientFactory(), "version", "--json");
+
+        assertEquals(0, run.exitCode());
+        assertTrue(run.output().contains("\"clientVersion\":\"0.1.0\""));
+        assertTrue(run.output().contains("\"gatewayProtocolVersion\":3"));
+    }
+
+    @Test
+    void openSessionJsonRedactsApiKey() {
+        CliRun run = execute(
+                new FakeClientFactory(),
+                "open-session",
+                "--endpoint",
+                "localhost:5000",
+                "--api-key",
+                "mxgw_visible_secret",
+                "--plaintext",
+                "--client-session-name",
+                "java-cli",
+                "--json");
+
+        assertEquals(0, run.exitCode());
+        assertTrue(run.output().contains("\"command\":\"open-session\""));
+        assertTrue(run.output().contains("\"sessionId\":\"session-cli\""));
+        assertTrue(run.output().contains("mxgw***********cret"));
+        assertFalse(run.output().contains("visible_secret"));
+    }
+
+    @Test
+    void writeBuildsTypedValueFromParserOptions() {
+        FakeClientFactory factory = new FakeClientFactory();
+        CliRun run = execute(
+                factory,
+                "write",
+                "--session-id",
+                "session-cli",
+                "--server-handle",
+                "12",
+                "--item-handle",
+                "34",
+                "--type",
+                "int32",
+                "--value",
+                "123",
+                "--json");
+
+        assertEquals(0, run.exitCode());
+        assertEquals(123, factory.client.session.lastWriteValue.getInt32Value());
+        assertTrue(run.output().contains("\"kind\":\"MX_COMMAND_KIND_WRITE\""));
+    }
+
+    @Test
+    void smokeCommandRunsOpenRegisterAddAdviseAndClose() {
+        FakeClientFactory factory = new FakeClientFactory();
+        CliRun run = execute(factory, "smoke", "--item", "TestObject.TestInt", "--json");
+
+        assertEquals(0, run.exitCode());
+        assertTrue(factory.client.session.registerCalled);
+        assertTrue(factory.client.session.addItemCalled);
+        assertTrue(factory.client.session.adviseCalled);
+        assertTrue(factory.client.closeCalled);
+        assertTrue(run.output().contains("\"serverHandle\":42"));
+        assertTrue(run.output().contains("\"itemHandle\":7"));
+    }
+
+    @Test
+    void subscribeBulkCommandPrintsResults() {
+        CliRun run = execute(
+                new FakeClientFactory(),
+                "subscribe-bulk",
+                "--session-id",
+                "session-cli",
+                "--server-handle",
+                "42",
+                "--items",
+                "TestMachine_001.TestChangingInt,TestMachine_002.TestChangingInt",
+                "--json");
+
+        assertEquals(0, run.exitCode());
+        assertTrue(run.output().contains("\"command\":\"subscribe-bulk\""));
+        assertTrue(run.output().contains("\"itemHandle\":100"));
+        assertTrue(run.output().contains("\"tagAddress\":\"TestMachine_002.TestChangingInt\""));
+    }
+
+    @Test
+    void unsubscribeBulkCommandPrintsResults() {
+        CliRun run = execute(
+                new FakeClientFactory(),
+                "unsubscribe-bulk",
+                "--session-id",
+                "session-cli",
+                "--server-handle",
+                "42",
+                "--item-handles",
+                "100,101",
+                "--json");
+
+        assertEquals(0, run.exitCode());
+        assertTrue(run.output().contains("\"command\":\"unsubscribe-bulk\""));
+        assertTrue(run.output().contains("\"itemHandle\":101"));
+        assertTrue(run.output().contains("\"wasSuccessful\":true"));
+    }
+
+    private static CliRun execute(MxGatewayCli.MxGatewayCliClientFactory factory, String... args) {
+        StringWriter output = new StringWriter();
+        StringWriter errors = new StringWriter();
+        int exitCode = MxGatewayCli.execute(
+                factory,
+                new PrintWriter(output, true),
+                new PrintWriter(errors, true),
+                args);
+        return new CliRun(exitCode, output.toString(), errors.toString());
+    }
+
+    private record CliRun(int exitCode, String output, String errors) {
+    }
+
+    private static final class FakeClientFactory implements MxGatewayCli.MxGatewayCliClientFactory {
+        private FakeClient client;
+
+        @Override
+        public MxGatewayCli.MxGatewayCliClient connect(MxGatewayCli.CommonOptions options) {
+            client = new FakeClient(options.spec.commandLine().getOut());
+            return client;
+        }
+    }
+
+    private static final class FakeClient implements MxGatewayCli.MxGatewayCliClient {
+        private final PrintWriter out;
+        private final FakeSession session = new FakeSession();
+        private boolean closeCalled;
+
+        private FakeClient(PrintWriter out) {
+            this.out = out;
+        }
+
+        @Override
+        public PrintWriter out() {
+            return out;
+        }
+
+        @Override
+        public OpenSessionReply openSession(OpenSessionRequest request) {
+            return OpenSessionReply.newBuilder()
+                    .setSessionId("session-cli")
+                    .setProtocolStatus(ok())
+                    .build();
+        }
+
+        @Override
+        public CloseSessionReply closeSession(CloseSessionRequest request) {
+            closeCalled = true;
+            return CloseSessionReply.newBuilder()
+                    .setSessionId(request.getSessionId())
+                    .setFinalState(SessionState.SESSION_STATE_CLOSED)
+                    .setProtocolStatus(ok())
+                    .build();
+        }
+
+        @Override
+        public MxGatewayCli.MxGatewayCliSession session(String sessionId) {
+            return session;
+        }
+
+        @Override
+        public void close() {
+        }
+    }
+
+    private static final class FakeSession implements MxGatewayCli.MxGatewayCliSession {
+        private boolean registerCalled;
+        private boolean addItemCalled;
+        private boolean adviseCalled;
+        private MxValue lastWriteValue;
+
+        @Override
+        public int register(String clientName) {
+            registerCalled = true;
+            return 42;
+        }
+
+        @Override
+        public MxCommandReply registerRaw(String clientName) {
+            registerCalled = true;
+            return MxCommandReply.newBuilder()
+                    .setKind(MxCommandKind.MX_COMMAND_KIND_REGISTER)
+                    .setProtocolStatus(ok())
+                    .setRegister(RegisterReply.newBuilder().setServerHandle(42))
+                    .build();
+        }
+
+        @Override
+        public int addItem(int serverHandle, String itemDefinition) {
+            addItemCalled = true;
+            return 7;
+        }
+
+        @Override
+        public MxCommandReply addItemRaw(int serverHandle, String itemDefinition) {
+            addItemCalled = true;
+            return MxCommandReply.newBuilder()
+                    .setKind(MxCommandKind.MX_COMMAND_KIND_ADD_ITEM)
+                    .setProtocolStatus(ok())
+                    .setAddItem(AddItemReply.newBuilder().setItemHandle(7))
+                    .build();
+        }
+
+        @Override
+        public void advise(int serverHandle, int itemHandle) {
+            adviseCalled = true;
+        }
+
+        @Override
+        public MxCommandReply adviseRaw(int serverHandle, int itemHandle) {
+            adviseCalled = true;
+            return MxCommandReply.newBuilder()
+                    .setKind(MxCommandKind.MX_COMMAND_KIND_ADVISE)
+                    .setProtocolStatus(ok())
+                    .build();
+        }
+
+        @Override
+        public MxCommandReply writeRaw(int serverHandle, int itemHandle, MxValue value, int userId) {
+            lastWriteValue = value;
+            return MxCommandReply.newBuilder()
+                    .setKind(MxCommandKind.MX_COMMAND_KIND_WRITE)
+                    .setProtocolStatus(ok())
+                    .build();
+        }
+
+        @Override
+        public List<SubscribeResult> subscribeBulk(int serverHandle, List<String> items) {
+            List<SubscribeResult> results = new ArrayList<>();
+            for (int index = 0; index < items.size(); index++) {
+                results.add(SubscribeResult.newBuilder()
+                        .setServerHandle(serverHandle)
+                        .setTagAddress(items.get(index))
+                        .setItemHandle(100 + index)
+                        .setWasSuccessful(true)
+                        .build());
+            }
+            return results;
+        }
+
+        @Override
+        public List<SubscribeResult> unsubscribeBulk(int serverHandle, List<Integer> itemHandles) {
+            List<SubscribeResult> results = new ArrayList<>();
+            for (Integer itemHandle : itemHandles) {
+                results.add(SubscribeResult.newBuilder()
+                        .setServerHandle(serverHandle)
+                        .setItemHandle(itemHandle)
+                        .setWasSuccessful(true)
+                        .build());
+            }
+            return results;
+        }
+
+        @Override
+        public com.dohertylan.mxgateway.client.MxEventStream streamEventsAfter(long afterWorkerSequence) {
+            throw new UnsupportedOperationException("stream-events is covered by client tests");
+        }
+    }
+
+    private static ProtocolStatus ok() {
+        return ProtocolStatus.newBuilder()
+                .setCode(ProtocolStatusCode.PROTOCOL_STATUS_CODE_OK)
+                .build();
+    }
+}

clients/java/mxgateway-client/build.gradle

@@ -1,7 +1,6 @@
 plugins {
     id 'java-library'
     id 'com.google.protobuf'
-    id 'maven-publish'
 }
 
 dependencies {
@@ -23,7 +22,7 @@ dependencies {
 sourceSets {
     main {
         proto {
-            srcDir rootProject.file('../../src/ZB.MOM.WW.MxGateway.Contracts/Protos')
+            srcDir rootProject.file('../../src/MxGateway.Contracts/Protos')
             include 'mxaccess_gateway.proto'
             include 'mxaccess_worker.proto'
             include 'galaxy_repository.proto'
@@ -31,11 +30,6 @@ sourceSets {
     }
 }
 
-java {
-    withSourcesJar()
-    withJavadocJar()
-}
-
 protobuf {
     protoc {
         artifact = "com.google.protobuf:protoc:${protobufVersion}"

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/DeployEventStream.java

@@ -1,4 +1,4 @@
-package com.zb.mom.ww.mxgateway.client;
+package com.dohertylan.mxgateway.client;
 
 import galaxy_repository.v1.GalaxyRepositoryOuterClass.DeployEvent;
 import galaxy_repository.v1.GalaxyRepositoryOuterClass.WatchDeployEventsRequest;

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/DeployEventSubscription.java

@@ -0,0 +1,65 @@
+package com.dohertylan.mxgateway.client;
+
+import galaxy_repository.v1.GalaxyRepositoryOuterClass.DeployEvent;
+import galaxy_repository.v1.GalaxyRepositoryOuterClass.WatchDeployEventsRequest;
+import io.grpc.stub.ClientCallStreamObserver;
+import io.grpc.stub.ClientResponseObserver;
+import io.grpc.stub.StreamObserver;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.concurrent.atomic.AtomicReference;
+
+/**
+ * Cancellable handle returned by the async {@code watchDeployEvents} variant.
+ * Mirrors {@link MxGatewayEventSubscription} but for the Galaxy Repository
+ * deploy-event stream.
+ */
+public final class DeployEventSubscription implements AutoCloseable {
+    private final AtomicReference<ClientCallStreamObserver<WatchDeployEventsRequest>> requestStream =
+            new AtomicReference<>();
+    private final AtomicBoolean cancelled = new AtomicBoolean();
+
+    ClientResponseObserver<WatchDeployEventsRequest, DeployEvent> wrap(StreamObserver<DeployEvent> observer) {
+        return new ClientResponseObserver<>() {
+            @Override
+            public void beforeStart(ClientCallStreamObserver<WatchDeployEventsRequest> stream) {
+                requestStream.set(stream);
+                if (cancelled.get()) {
+                    stream.cancel("client cancelled deploy event stream", null);
+                }
+            }
+
+            @Override
+            public void onNext(DeployEvent value) {
+                observer.onNext(value);
+            }
+
+            @Override
+            public void onError(Throwable error) {
+                observer.onError(error);
+            }
+
+            @Override
+            public void onCompleted() {
+                observer.onCompleted();
+            }
+        };
+    }
+
+    /**
+     * Cancels the underlying gRPC call. Safe to invoke before the call has
+     * started; cancellation is recorded and applied as soon as the stream
+     * attaches.
+     */
+    public void cancel() {
+        cancelled.set(true);
+        ClientCallStreamObserver<WatchDeployEventsRequest> stream = requestStream.get();
+        if (stream != null) {
+            stream.cancel("client cancelled deploy event stream", null);
+        }
+    }
+
+    @Override
+    public void close() {
+        cancel();
+    }
+}

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/GalaxyRepositoryClient.java

@@ -1,11 +1,9 @@
-package com.zb.mom.ww.mxgateway.client;
+package com.dohertylan.mxgateway.client;
 
 import com.google.common.util.concurrent.FutureCallback;
 import com.google.common.util.concurrent.Futures;
 import com.google.common.util.concurrent.MoreExecutors;
 import galaxy_repository.v1.GalaxyRepositoryGrpc;
-import galaxy_repository.v1.GalaxyRepositoryOuterClass.BrowseChildrenReply;
-import galaxy_repository.v1.GalaxyRepositoryOuterClass.BrowseChildrenRequest;
 import galaxy_repository.v1.GalaxyRepositoryOuterClass.DeployEvent;
 import galaxy_repository.v1.GalaxyRepositoryOuterClass.DiscoverHierarchyReply;
 import galaxy_repository.v1.GalaxyRepositoryOuterClass.DiscoverHierarchyRequest;
@@ -39,7 +37,6 @@ import javax.net.ssl.SSLException;
  */
 public final class GalaxyRepositoryClient implements AutoCloseable {
     private static final int DISCOVER_HIERARCHY_PAGE_SIZE = 5000;
-    private static final int BROWSE_CHILDREN_PAGE_SIZE = 500;
 
     private final ManagedChannel ownedChannel;
     private final MxGatewayClientOptions options;
@@ -216,98 +213,6 @@ public final class GalaxyRepositoryClient implements AutoCloseable {
         return discoverHierarchyPageAsync("", new java.util.ArrayList<>(), new java.util.HashSet<>());
     }
 
-    /**
-     * Lazy-browse entry point: fetches the root layer of the Galaxy hierarchy.
-     * Each returned {@link LazyBrowseNode} can be expanded on demand via
-     * {@link LazyBrowseNode#expand()} to load its direct children.
-     *
-     * @return the root nodes (no parent selector) with default options
-     * @throws MxGatewayException on transport or protocol failure
-     */
-    public List<LazyBrowseNode> browse() {
-        return browse(null);
-    }
-
-    /**
-     * Lazy-browse entry point with caller-supplied filters / shape.
-     *
-     * @param options filter and shape options; {@code null} means {@link BrowseChildrenOptions#empty()}
-     * @return the root nodes matching the options
-     * @throws MxGatewayException on transport or protocol failure
-     */
-    public List<LazyBrowseNode> browse(BrowseChildrenOptions options) {
-        BrowseChildrenOptions effective = options == null ? BrowseChildrenOptions.empty() : options;
-        return browseChildrenInner(null, effective);
-    }
-
-    /**
-     * Issues a single {@code BrowseChildren} RPC and returns the raw reply.
-     * Callers wanting full control over pagination can drive the loop themselves.
-     *
-     * @param request the request to send
-     * @return the reply
-     * @throws MxGatewayException on transport or protocol failure
-     */
-    public BrowseChildrenReply browseChildrenRaw(BrowseChildrenRequest request) {
-        try {
-            return rawBlockingStub().browseChildren(request);
-        } catch (RuntimeException error) {
-            if (error instanceof MxGatewayException) {
-                throw error;
-            }
-            throw MxGatewayErrors.fromGrpc("galaxy browse children", error);
-        }
-    }
-
-    /**
-     * Drives the BrowseChildren paging loop for a single parent (or roots when
-     * {@code parentGobjectId} is {@code null}). Detects repeated page tokens to
-     * avoid infinite loops on a buggy server.
-     */
-    List<LazyBrowseNode> browseChildrenInner(Integer parentGobjectId, BrowseChildrenOptions options) {
-        java.util.ArrayList<LazyBrowseNode> nodes = new java.util.ArrayList<>();
-        java.util.HashSet<String> seenPageTokens = new java.util.HashSet<>();
-        String pageToken = "";
-        while (true) {
-            BrowseChildrenRequest.Builder builder = BrowseChildrenRequest.newBuilder()
-                    .setPageSize(BROWSE_CHILDREN_PAGE_SIZE)
-                    .setPageToken(pageToken)
-                    .setAlarmBearingOnly(options.isAlarmBearingOnly())
-                    .setHistorizedOnly(options.isHistorizedOnly());
-            if (parentGobjectId != null) {
-                builder.setParentGobjectId(parentGobjectId.intValue());
-            }
-            if (!options.getCategoryIds().isEmpty()) {
-                builder.addAllCategoryIds(options.getCategoryIds());
-            }
-            if (!options.getTemplateChainContains().isEmpty()) {
-                builder.addAllTemplateChainContains(options.getTemplateChainContains());
-            }
-            if (!options.getTagNameGlob().isEmpty()) {
-                builder.setTagNameGlob(options.getTagNameGlob());
-            }
-            if (options.getIncludeAttributes() != null) {
-                builder.setIncludeAttributes(options.getIncludeAttributes());
-            }
-
-            BrowseChildrenReply reply = browseChildrenRaw(builder.build());
-
-            for (int i = 0; i < reply.getChildrenCount(); i++) {
-                boolean hint = i < reply.getChildHasChildrenCount() && reply.getChildHasChildren(i);
-                nodes.add(new LazyBrowseNode(this, reply.getChildren(i), hint, options));
-            }
-
-            pageToken = reply.getNextPageToken();
-            if (pageToken == null || pageToken.isEmpty()) {
-                return nodes;
-            }
-            if (!seenPageTokens.add(pageToken)) {
-                throw new MxGatewayException(
-                        "galaxy browse children returned repeated page token: " + pageToken);
-            }
-        }
-    }
-
     /**
      * Subscribes to {@code WatchDeployEvents} via the async stub and consumes
      * results through a blocking iterator. Closing the returned stream cancels

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/MxAccessException.java

@@ -1,4 +1,4 @@
-package com.zb.mom.ww.mxgateway.client;
+package com.dohertylan.mxgateway.client;
 
 import mxaccess_gateway.v1.MxaccessGateway.MxCommandReply;
 import mxaccess_gateway.v1.MxaccessGateway.ProtocolStatus;

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/MxEventStream.java

@@ -1,4 +1,4 @@
-package com.zb.mom.ww.mxgateway.client;
+package com.dohertylan.mxgateway.client;
 
 import io.grpc.Status;
 import io.grpc.StatusRuntimeException;

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/MxGatewayActiveAlarmsSubscription.java

@@ -0,0 +1,67 @@
+package com.dohertylan.mxgateway.client;
+
+import io.grpc.stub.ClientCallStreamObserver;
+import io.grpc.stub.ClientResponseObserver;
+import io.grpc.stub.StreamObserver;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.concurrent.atomic.AtomicReference;
+import mxaccess_gateway.v1.MxaccessGateway.ActiveAlarmSnapshot;
+import mxaccess_gateway.v1.MxaccessGateway.QueryActiveAlarmsRequest;
+
+/**
+ * Cancellable handle returned by {@code queryActiveAlarms}.
+ *
+ * <p>Wraps a caller-supplied {@link StreamObserver} and exposes a
+ * {@link #cancel()} entry point that aborts the underlying gRPC call. The
+ * subscription also implements {@link AutoCloseable} so it can participate in
+ * try-with-resources blocks.
+ */
+public final class MxGatewayActiveAlarmsSubscription implements AutoCloseable {
+    private final AtomicReference<ClientCallStreamObserver<QueryActiveAlarmsRequest>> requestStream = new AtomicReference<>();
+    private final AtomicBoolean cancelled = new AtomicBoolean();
+
+    ClientResponseObserver<QueryActiveAlarmsRequest, ActiveAlarmSnapshot> wrap(StreamObserver<ActiveAlarmSnapshot> observer) {
+        return new ClientResponseObserver<>() {
+            @Override
+            public void beforeStart(ClientCallStreamObserver<QueryActiveAlarmsRequest> stream) {
+                requestStream.set(stream);
+                if (cancelled.get()) {
+                    stream.cancel("client cancelled active-alarms query", null);
+                }
+            }
+
+            @Override
+            public void onNext(ActiveAlarmSnapshot value) {
+                observer.onNext(value);
+            }
+
+            @Override
+            public void onError(Throwable error) {
+                observer.onError(error);
+            }
+
+            @Override
+            public void onCompleted() {
+                observer.onCompleted();
+            }
+        };
+    }
+
+    /**
+     * Cancels the underlying gRPC call. Safe to invoke before the call has
+     * started; cancellation is recorded and applied as soon as the stream
+     * attaches.
+     */
+    public void cancel() {
+        cancelled.set(true);
+        ClientCallStreamObserver<QueryActiveAlarmsRequest> stream = requestStream.get();
+        if (stream != null) {
+            stream.cancel("client cancelled active-alarms query", null);
+        }
+    }
+
+    @Override
+    public void close() {
+        cancel();
+    }
+}

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/MxGatewayAuthInterceptor.java

@@ -1,4 +1,4 @@
-package com.zb.mom.ww.mxgateway.client;
+package com.dohertylan.mxgateway.client;
 
 import io.grpc.CallOptions;
 import io.grpc.Channel;

clients/java/mxgateway-client/src/main/java/com/dohertylan/mxgateway/client/MxGatewayAuthenticationException.java

@@ -1,4 +1,4 @@
-package com.zb.mom.ww.mxgateway.client;
+package com.dohertylan.mxgateway.client;
 
 /**
  * Thrown when the gateway rejects a call because the supplied API key is