chore: organize solution into module folders (Core/Server/Drivers/Client/Tooling)

Group all 69 projects into category subfolders under src/ and tests/ so the
Rider Solution Explorer mirrors the module structure. Folders: Core, Server,
Drivers (with a nested Driver CLIs subfolder), Client, Tooling.

- Move every project folder on disk with git mv (history preserved as renames).
- Recompute relative paths in 57 .csproj files: cross-category ProjectReferences,
  the lib/ HintPath+None refs in Driver.Historian.Wonderware, and the external
  mxaccessgw refs in Driver.Galaxy and its test project.
- Rebuild ZB.MOM.WW.OtOpcUa.slnx with nested solution folders.
- Re-prefix project paths in functional scripts (e2e, compliance, smoke SQL,
  integration, install).

Build green (0 errors); unit tests pass. Docs left for a separate pass.

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

src/Client/ZB.MOM.WW.OtOpcUa.Client.Shared/IOpcUaClientService.cs

@@ -0,0 +1,144 @@
+using Opc.Ua;
+using ZB.MOM.WW.OtOpcUa.Client.Shared.Models;
+using BrowseResult = ZB.MOM.WW.OtOpcUa.Client.Shared.Models.BrowseResult;
+
+namespace ZB.MOM.WW.OtOpcUa.Client.Shared;
+
+/// <summary>
+///     Shared OPC UA client service contract for CLI and UI consumers.
+/// </summary>
+public interface IOpcUaClientService : IDisposable
+{
+    /// <summary>
+    /// Gets a value indicating whether the client is currently connected to an OPC UA endpoint.
+    /// </summary>
+    bool IsConnected { get; }
+
+    /// <summary>
+    /// Gets the current connection metadata shown to CLI and UI operators after a successful connect or failover.
+    /// </summary>
+    ConnectionInfo? CurrentConnectionInfo { get; }
+
+    /// <summary>
+    /// Connects the client to the configured OPC UA endpoint set, including failover-capable endpoints when provided.
+    /// </summary>
+    /// <param name="settings">The endpoint, security, and authentication settings used to establish the session.</param>
+    /// <param name="ct">The cancellation token that aborts the connect workflow.</param>
+    Task<ConnectionInfo> ConnectAsync(ConnectionSettings settings, CancellationToken ct = default);
+
+    /// <summary>
+    /// Disconnects from the active OPC UA endpoint and tears down subscriptions owned by the client.
+    /// </summary>
+    /// <param name="ct">The cancellation token that aborts disconnect cleanup.</param>
+    Task DisconnectAsync(CancellationToken ct = default);
+
+    /// <summary>
+    /// Reads the current value of an OPC UA node.
+    /// </summary>
+    /// <param name="nodeId">The node whose value should be retrieved.</param>
+    /// <param name="ct">The cancellation token that aborts the read request.</param>
+    Task<DataValue> ReadValueAsync(NodeId nodeId, CancellationToken ct = default);
+
+    /// <summary>
+    /// Writes an operator-supplied value to an OPC UA node after applying client-side type conversion when needed.
+    /// </summary>
+    /// <param name="nodeId">The node whose value should be updated.</param>
+    /// <param name="value">The raw value supplied by the CLI or UI workflow.</param>
+    /// <param name="ct">The cancellation token that aborts the write request.</param>
+    Task<StatusCode> WriteValueAsync(NodeId nodeId, object value, CancellationToken ct = default);
+
+    /// <summary>
+    /// Browses the children of a node so the client can build an address-space tree for operators.
+    /// </summary>
+    /// <param name="parentNodeId">The node to browse, or <see cref="ObjectIds.ObjectsFolder"/> when omitted.</param>
+    /// <param name="ct">The cancellation token that aborts the browse request.</param>
+    Task<IReadOnlyList<BrowseResult>> BrowseAsync(NodeId? parentNodeId = null, CancellationToken ct = default);
+
+    /// <summary>
+    /// Subscribes to live data changes for a node.
+    /// </summary>
+    /// <param name="nodeId">The node whose value changes should be monitored.</param>
+    /// <param name="intervalMs">The monitored-item sampling and publishing interval in milliseconds.</param>
+    /// <param name="ct">The cancellation token that aborts subscription creation.</param>
+    Task SubscribeAsync(NodeId nodeId, int intervalMs = 1000, CancellationToken ct = default);
+
+    /// <summary>
+    /// Removes a previously created live-data subscription for a node.
+    /// </summary>
+    /// <param name="nodeId">The node whose live-data subscription should be removed.</param>
+    /// <param name="ct">The cancellation token that aborts the unsubscribe request.</param>
+    Task UnsubscribeAsync(NodeId nodeId, CancellationToken ct = default);
+
+    /// <summary>
+    /// Subscribes to OPC UA alarm and condition events for a source node or the server root.
+    /// </summary>
+    /// <param name="sourceNodeId">The event source to monitor, or the server object when omitted.</param>
+    /// <param name="intervalMs">The publishing interval in milliseconds for the alarm subscription.</param>
+    /// <param name="ct">The cancellation token that aborts alarm subscription creation.</param>
+    Task SubscribeAlarmsAsync(NodeId? sourceNodeId = null, int intervalMs = 1000, CancellationToken ct = default);
+
+    /// <summary>
+    /// Removes the active alarm subscription.
+    /// </summary>
+    /// <param name="ct">The cancellation token that aborts alarm subscription cleanup.</param>
+    Task UnsubscribeAlarmsAsync(CancellationToken ct = default);
+
+    /// <summary>
+    /// Requests retained alarm conditions again so a client can repopulate its alarm list after reconnecting.
+    /// </summary>
+    /// <param name="ct">The cancellation token that aborts the condition refresh request.</param>
+    Task RequestConditionRefreshAsync(CancellationToken ct = default);
+
+    /// <summary>
+    /// Acknowledges an active condition using the event identifier returned by an alarm notification.
+    /// </summary>
+    /// <param name="conditionNodeId">The condition node associated with the alarm event being acknowledged.</param>
+    /// <param name="eventId">The event identifier returned by the OPC UA server for the alarm event.</param>
+    /// <param name="comment">The operator acknowledgment comment to write with the method call.</param>
+    /// <param name="ct">The cancellation token that aborts the acknowledgment request.</param>
+    Task<StatusCode> AcknowledgeAlarmAsync(string conditionNodeId, byte[] eventId, string comment, CancellationToken ct = default);
+
+    /// <summary>
+    /// Reads raw historical samples for a historized node.
+    /// </summary>
+    /// <param name="nodeId">The historized node whose samples should be read.</param>
+    /// <param name="startTime">The inclusive start of the requested history range.</param>
+    /// <param name="endTime">The inclusive end of the requested history range.</param>
+    /// <param name="maxValues">The maximum number of raw values to return.</param>
+    /// <param name="ct">The cancellation token that aborts the history read.</param>
+    Task<IReadOnlyList<DataValue>> HistoryReadRawAsync(NodeId nodeId, DateTime startTime, DateTime endTime,
+        int maxValues = 1000, CancellationToken ct = default);
+
+    /// <summary>
+    /// Reads aggregate historical values for a historized node using an OPC UA aggregate function.
+    /// </summary>
+    /// <param name="nodeId">The historized node whose processed values should be read.</param>
+    /// <param name="startTime">The inclusive start of the requested processed-history range.</param>
+    /// <param name="endTime">The inclusive end of the requested processed-history range.</param>
+    /// <param name="aggregate">The aggregate function the operator selected for processed history.</param>
+    /// <param name="intervalMs">The processing interval, in milliseconds, for each aggregate bucket.</param>
+    /// <param name="ct">The cancellation token that aborts the processed history request.</param>
+    Task<IReadOnlyList<DataValue>> HistoryReadAggregateAsync(NodeId nodeId, DateTime startTime, DateTime endTime,
+        AggregateType aggregate, double intervalMs = 3600000, CancellationToken ct = default);
+
+    /// <summary>
+    /// Reads redundancy status data such as redundancy mode, service level, and partner endpoint URIs.
+    /// </summary>
+    /// <param name="ct">The cancellation token that aborts redundancy inspection.</param>
+    Task<RedundancyInfo> GetRedundancyInfoAsync(CancellationToken ct = default);
+
+    /// <summary>
+    /// Raised when a subscribed node produces a new live data value.
+    /// </summary>
+    event EventHandler<DataChangedEventArgs>? DataChanged;
+
+    /// <summary>
+    /// Raised when an alarm or condition event is received from the server.
+    /// </summary>
+    event EventHandler<AlarmEventArgs>? AlarmEvent;
+
+    /// <summary>
+    /// Raised when the client changes connection state during connect, disconnect, or failover.
+    /// </summary>
+    event EventHandler<ConnectionStateChangedEventArgs>? ConnectionStateChanged;
+}