rename: prefix gateway projects/namespaces with ZB.MOM.WW + sln→slnx

Apply the ZB.MOM.WW. prefix to all gateway-side projects, folders, .csproj/.sln contents, C# namespaces, using directives, generated proto C# (csharp_namespace + checked-in generated files), InternalsVisibleTo attributes, project-name string literals (LoadProject, .sln lookups, worker exe paths, staticwebassets manifest), and the install/script/doc references that point at any of the above. Migrate the solution from .sln to .slnx via `dotnet sln migrate` and delete the old file. External-runtime identifiers are intentionally NOT prefixed so external configuration keeps working: - GatewayMetrics.cs MeterName ("MxGateway.Server") - DashboardAuthenticationDefaults Scheme/Policy ("MxGateway.Dashboard") - GatewayRequestLoggingMiddleware logger category ("MxGateway.Request") - StaRuntime thread name ("MxGateway.Worker.STA") - appsettings.json root section "MxGateway" + env-var prefix MxGateway__... and secret-name MxGateway:ApiKeyPepper - C:\ProgramData\MxGateway\ data dir paths Also fixes two tests that were not rename-related but became visible while validating the rename: - WorkerLiveMxAccessSmokeTests.ShutDownAsync: cancellation that the gateway service correctly maps to RpcException(Cancelled) per gRPC convention was being misclassified as a stream fault. Added a sibling catch on RpcException with StatusCode.Cancelled. - IntegrationTestEnvironment.ResolveRepositoryRoot: extracted IsRepositoryRoot and made it accept either a .git marker OR a .sln/.slnx next to src/ so the worker-exe walker works in non-git working copies. clients/proto/proto-inputs.json's protoRoot updated to point at src/ZB.MOM.WW.MxGateway.Contracts/Protos. Verified by `dotnet build` and a full `dotnet test` of the .slnx with MXGATEWAY_RUN_LIVE_{MXACCESS,LDAP,GALAXY}_TESTS=1: Tests: 472/472 pass Worker.Tests: 280/280 pass (4 dev-rig [Fact(Skip=...)] skipped) IntegrationTests: 18/18 pass Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 16:22:23 -04:00
parent 867bf18116
commit dc9c0c950c
491 changed files with 32854 additions and 8414 deletions
@@ -0,0 +1,120 @@
+using System;
+using ZB.MOM.WW.MxGateway.Contracts.Proto;
+
+namespace ZB.MOM.WW.MxGateway.Worker.MxAccess;
+
+/// <summary>
+///     Sink for native MxAccess alarm transitions. Bridges
+///     <see cref="WnWrapAlarmConsumer"/> to the worker's event queue,
+///     producing <see cref="OnAlarmTransitionEvent"/> messages via
+///     <see cref="MxAccessEventMapper.CreateOnAlarmTransition"/>.
+/// </summary>
+/// <remarks>
+///     <para>
+///         <see cref="AlarmDispatcher"/> owns the wire-up: it constructs the
+///         consumer/sink pair, calls <see cref="Attach"/> to propagate the
+///         session id, and subscribes the consumer's
+///         <see cref="IMxAccessAlarmConsumer.AlarmTransitionEmitted"/> event
+///         so each decoded transition reaches <see cref="EnqueueTransition"/>.
+///         The <see cref="Attach"/> method here carries only the session id —
+///         the alarm path needs no COM-event subscription of its own because
+///         the consumer already polls and raises transition events. The
+///         captured payload schema is described in
+///         <c>docs/AlarmClientDiscovery.md</c> "Option A — captured".
+///     </para>
+/// </remarks>
+public sealed class MxAccessAlarmEventSink : IMxAccessEventSink
+{
+    private readonly MxAccessEventMapper eventMapper;
+    private readonly MxAccessEventQueue eventQueue;
+    private string sessionId = string.Empty;
+    private bool attached;
+
+    public MxAccessAlarmEventSink()
+        : this(new MxAccessEventQueue(), new MxAccessEventMapper())
+    {
+    }
+
+    public MxAccessAlarmEventSink(
+        MxAccessEventQueue eventQueue,
+        MxAccessEventMapper eventMapper)
+    {
+        this.eventQueue = eventQueue ?? throw new ArgumentNullException(nameof(eventQueue));
+        this.eventMapper = eventMapper ?? throw new ArgumentNullException(nameof(eventMapper));
+    }
+
+    /// <inheritdoc />
+    public void Attach(object mxAccessComObject, string sessionId)
+    {
+        if (mxAccessComObject is null) throw new ArgumentNullException(nameof(mxAccessComObject));
+        this.sessionId = sessionId ?? string.Empty;
+
+        // The alarm path needs no COM-event subscription here: the wnwrap
+        // consumer is polled by the worker's STA and raises transition events
+        // that AlarmDispatcher routes into EnqueueTransition. Attach only
+        // records the session id stamped onto every emitted MxEvent.
+        attached = true;
+    }
+
+    /// <inheritdoc />
+    public void Detach()
+    {
+        if (!attached) return;
+        attached = false;
+        sessionId = string.Empty;
+    }
+
+    /// <summary>
+    ///     Enqueues a decoded alarm transition. The COM-side delegate registered
+    ///     in <see cref="Attach"/> calls this method once it pulls the alarm
+    ///     fields out of the MxAccess event payload. Exposed internal so unit
+    ///     tests can drive the proto build path without a real COM event
+    ///     source.
+    /// </summary>
+    internal void EnqueueTransition(
+        string alarmFullReference,
+        string sourceObjectReference,
+        string alarmTypeName,
+        AlarmTransitionKind transitionKind,
+        int severity,
+        DateTime? originalRaiseTimestampUtc,
+        DateTime transitionTimestampUtc,
+        string operatorUser,
+        string operatorComment,
+        string category,
+        string description)
+    {
+        try
+        {
+            MxEvent mxEvent = eventMapper.CreateOnAlarmTransition(
+                sessionId,
+                alarmFullReference,
+                sourceObjectReference,
+                alarmTypeName,
+                transitionKind,
+                severity,
+                originalRaiseTimestampUtc,
+                transitionTimestampUtc,
+                operatorUser,
+                operatorComment,
+                category,
+                description,
+                statuses: null);
+            eventQueue.Enqueue(mxEvent);
+        }
+        catch (Exception exception)
+        {
+            eventQueue.RecordFault(new WorkerFault
+            {
+                Category = WorkerFaultCategory.MxaccessEventConversionFailed,
+                ExceptionType = exception.GetType().FullName ?? string.Empty,
+                DiagnosticMessage = $"{exception.GetType().FullName}: HRESULT 0x{unchecked((uint)exception.HResult):X8}",
+                ProtocolStatus = new ProtocolStatus
+                {
+                    Code = ProtocolStatusCode.MxaccessFailure,
+                    Message = "MXAccess alarm event conversion failed.",
+                },
+            });
+        }
+    }
+}