Merge b647-opcua-histstatus: OpcUaClient HistoryRead honours per-node StatusCode (#649)

Claude-Session: https://claude.ai/code/session_01Ef2ozxS7QPanGT8uoATbTe

src/Drivers/ZB.MOM.WW.OtOpcUa.Driver.OpcUaClient/OpcUaClientDriver.cs

@@ -2275,7 +2275,7 @@ public sealed class OpcUaClientDriver : IDriver, ITagDiscovery, IReadable, IWrit
             ProcessingInterval = interval.TotalMilliseconds,
             AggregateType = [aggregateId],
         };
-        return await ExecuteHistoryReadAsync(fullReference, new ExtensionObject(details), cancellationToken)
+        return await ExecuteHistoryReadAsync(fullReference, new ExtensionObject(details), cancellationToken, aggregate)
             .ConfigureAwait(false);
     }
 
@@ -2295,11 +2295,16 @@ public sealed class OpcUaClientDriver : IDriver, ITagDiscovery, IReadable, IWrit
 
     /// <summary>
     ///     Shared HistoryRead wire path — used by Raw/Processed/AtTime. Handles NodeId parse,
-    ///     Session.HistoryReadAsync call, Bad-StatusCode passthrough (no translation per §8
-    ///     cascading-quality rule), and HistoryData unwrap into <see cref="DataValueSnapshot"/>.
+    ///     Session.HistoryReadAsync call, per-sample StatusCode passthrough (no translation per §8
+    ///     cascading-quality rule), and HistoryData unwrap into <see cref="DataValueSnapshot"/>. A Bad
+    ///     per-NODE <c>HistoryReadResult.StatusCode</c> is never read as empty data: <c>BadAggregateNotSupported</c>
+    ///     throws <see cref="HistoryAggregateNotSupportedException"/>, any other Bad throws
+    ///     <see cref="HistoryReadStatusException"/> (Gitea #649). Good / GoodNoData / GoodMoreData / Uncertain are
+    ///     unchanged.
     /// </summary>
     private async Task<Core.Abstractions.HistoryReadResult> ExecuteHistoryReadAsync(
-        string fullReference, ExtensionObject historyReadDetails, CancellationToken ct)
+        string fullReference, ExtensionObject historyReadDetails, CancellationToken ct,
+        HistoryAggregateType? aggregate = null)
     {
         // Make sure a session exists before queuing on the gate, but do NOT bind the wire call
         // (or the namespace-relative NodeId parse) to this reference — a reconnect can swap
@@ -2335,6 +2340,16 @@ public sealed class OpcUaClientDriver : IDriver, ITagDiscovery, IReadable, IWrit
             if (resp.Results.Count == 0) return new Core.Abstractions.HistoryReadResult([], null);
             var r = resp.Results[0];
 
+            // The per-node status decides whether the payload means anything. BadNoData is the one Bad code
+            // that legitimately means "nothing in the window", so it stays an empty result.
+            // CodeBits (not Code) so an info/overflow sub-status bit on the upstream code does not dodge the match.
+            if (StatusCode.IsBad(r.StatusCode) && r.StatusCode.CodeBits != StatusCodes.BadNoData)
+            {
+                if (r.StatusCode.CodeBits == StatusCodes.BadAggregateNotSupported && aggregate is { } agg)
+                    throw new HistoryAggregateNotSupportedException(agg);
+                throw new HistoryReadStatusException(r.StatusCode.Code);
+            }
+
             // Unwrap HistoryData from the ExtensionObject-encoded payload the SDK returns.
             // Samples stay in chronological order per OPC UA Part 11; cascading-quality
             // rule: preserve each DataValue's upstream StatusCode + timestamps verbatim.