v2 mxgw migration — Phase 1+2+3.1 wiring (7 PRs)

Foundational PRs from lmx_mxgw_impl.md, all green. Bodies only — DI/wiring
deferred to PR 1+2.W (combined wire-up) and PR 3.W.

PR 1.1 — IHistorianDataSource lifted to Core.Abstractions/Historian/
  Reuses existing DataValueSnapshot + HistoricalEvent shapes; sidecar (PR
  3.4) translates byte-quality → uint StatusCode internally.

PR 1.2 — IHistoryRouter + HistoryRouter on the server
  Longest-prefix-match resolution, case-insensitive, ObjectDisposed-guarded,
  swallow-on-shutdown disposal of misbehaving sources.

PR 1.3 — DriverNodeManager.HistoryRead* dispatch through IHistoryRouter
  Per-tag resolution with LegacyDriverHistoryAdapter wrapping
  `_driver as IHistoryProvider` so existing tests + drivers keep working
  until PR 7.2 retires the fallback.

PR 2.1 — AlarmConditionInfo extended with five sub-attribute refs
  InAlarmRef / PriorityRef / DescAttrNameRef / AckedRef / AckMsgWriteRef.
  Optional defaulted parameters preserve all existing 3-arg call sites.

PR 2.2 — AlarmConditionService state machine in Server/Alarms/
  Driver-agnostic port of GalaxyAlarmTracker. Sub-attribute refs come from
  AlarmConditionInfo, values arrive as DataValueSnapshot, ack writes route
  through IAlarmAcknowledger. State machine preserves Active/Acknowledged/
  Inactive transitions, Acked-on-active reset, post-disposal silence.

PR 2.3 — DriverNodeManager wires AlarmConditionService
  MarkAsAlarmCondition registers each alarm-bearing variable with the
  service; DriverWritableAcknowledger routes ack-message writes through
  the driver's IWritable + CapabilityInvoker. Service-raised transitions
  route via OnAlarmServiceTransition → matching ConditionSink. Legacy
  IAlarmSource path unchanged for null service.

PR 3.1 — Driver.Historian.Wonderware shell project (net48 x86)
  Console host shell + smoke test; SDK references + code lift come in
  PR 3.2.

Tests: 9 (PR 1.1) + 5 (PR 2.1) + 10 (PR 1.2) + 19 (PR 2.2) + 1 (PR 3.1)
all pass. Existing AlarmSubscribeIntegrationTests + HistoryReadIntegrationTests
unchanged.

Plan + audit docs (lmx_backend.md, lmx_mxgw.md, lmx_mxgw_impl.md)
included so parallel subagent worktrees can read them.

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

src/ZB.MOM.WW.OtOpcUa.Core.Abstractions/IAddressSpaceBuilder.cs

@@ -62,10 +62,41 @@ public interface IVariableHandle
 /// <param name="SourceName">Human-readable alarm name used for the <c>SourceName</c> event field.</param>
 /// <param name="InitialSeverity">Severity at address-space build time; updates arrive via <see cref="IAlarmConditionSink"/>.</param>
 /// <param name="InitialDescription">Initial description; updates arrive via <see cref="IAlarmConditionSink"/>.</param>
+/// <param name="InAlarmRef">
+///     Driver-side full reference for the boolean attribute that toggles when the
+///     alarm condition becomes active. Consumed by the server-level alarm-condition
+///     service to subscribe to active/inactive transitions. Null when the driver
+///     reports alarm transitions through some other channel.
+/// </param>
+/// <param name="PriorityRef">
+///     Driver-side full reference for the integer attribute carrying the alarm's
+///     current priority / severity. Live updates flow through the same subscription
+///     pipeline as <paramref name="InAlarmRef"/>. Null when the driver does not
+///     expose live priority changes.
+/// </param>
+/// <param name="DescAttrNameRef">
+///     Driver-side full reference for the string attribute carrying the human-readable
+///     description / message. Null when the driver does not expose a live description.
+/// </param>
+/// <param name="AckedRef">
+///     Driver-side full reference for the boolean attribute that toggles when the
+///     alarm is acknowledged. Null when acknowledgement is not observable on the
+///     driver side.
+/// </param>
+/// <param name="AckMsgWriteRef">
+///     Driver-side full reference the server writes to acknowledge the condition,
+///     typically the alarm's <c>.AckMsg</c> attribute. Null when the driver does not
+///     accept acknowledgement writes (or routes them through a separate API).
+/// </param>
 public sealed record AlarmConditionInfo(
     string SourceName,
     AlarmSeverity InitialSeverity,
-    string? InitialDescription);
+    string? InitialDescription,
+    string? InAlarmRef = null,
+    string? PriorityRef = null,
+    string? DescAttrNameRef = null,
+    string? AckedRef = null,
+    string? AckMsgWriteRef = null);
 
 /// <summary>
 ///     Sink a concrete address-space builder returns from <see cref="IVariableHandle.MarkAsAlarmCondition"/>.