feat(siteruntime): WaitForAsync/WaitResult + quality-gated WaitAsync (spec §3, §4.2)

src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Instance/WaitForAttribute.cs

@@ -27,6 +27,16 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.Instance;
 /// </param>
 /// <param name="Timeout">How long to wait before self-evicting with a timeout reply.</param>
 /// <param name="OccurredAtUtc">When the request was issued (UTC).</param>
+/// <param name="RequireGoodQuality">
+/// Quality-gated ("Good"-only) mode (spec §4.2): when <see langword="true"/>, a
+/// match additionally requires the attribute quality to be exactly
+/// <c>"Good"</c> (<see cref="System.StringComparison.Ordinal"/>) — a value that
+/// reaches the target / satisfies the predicate at Bad/Uncertain quality is NOT a
+/// match and the waiter stays pending until the value satisfies the test at Good
+/// quality (or times out). Defaults to <see langword="false"/> (quality-agnostic:
+/// the match tests the value only). Trailing/defaulted so existing positional
+/// constructions compile unchanged.
+/// </param>
 public record WaitForAttributeRequest(
     string CorrelationId,
     string InstanceName,
@@ -34,7 +44,8 @@ public record WaitForAttributeRequest(
     string? TargetValueEncoded,
     Func<object?, bool>? Predicate,
     TimeSpan Timeout,
-    DateTimeOffset OccurredAtUtc);
+    DateTimeOffset OccurredAtUtc,
+    bool RequireGoodQuality = false);
 
 /// <summary>
 /// Reply to a <see cref="WaitForAttributeRequest"/>. Exactly one of