Auto: abcip-5.1 — HSBY paired-IP role probing

Closes #242

src/ZB.MOM.WW.OtOpcUa.Driver.AbCip.Cli/AbCipCommandBase.cs

@@ -40,6 +40,18 @@ public abstract class AbCipCommandBase : DriverCommandBase
         "walk; unsupported on Micro800 (silent fallback to Symbolic with warning).")]
     public AddressingMode AddressingMode { get; init; } = AddressingMode.Auto;
 
+    /// <summary>
+    ///     PR abcip-5.1 — partner gateway URI for HSBY (Hot-Standby) paired chassis. When
+    ///     supplied, every CLI command auto-enables HSBY role probing on the device options
+    ///     so subcommands like <c>hsby-status</c> + diagnostics surface the active chassis
+    ///     without extra flags. Unset for non-redundant deployments.
+    /// </summary>
+    [CommandOption("partner", Description =
+        "Partner gateway URI for ControlLogix HSBY pair (e.g. ab://10.0.0.6/1,0). When " +
+        "set, the driver runs a second role-probe loop and the hsby-status command can " +
+        "surface which chassis is currently Active. Optional.")]
+    public string? Partner { get; init; }
+
     /// <inheritdoc />
     public override TimeSpan Timeout
     {
@@ -58,7 +70,17 @@ public abstract class AbCipCommandBase : DriverCommandBase
             HostAddress: Gateway,
             PlcFamily: Family,
             DeviceName: $"cli-{Family}",
-            AddressingMode: AddressingMode)],
+            AddressingMode: AddressingMode,
+            // PR abcip-5.1 — surface --partner through the device options so commands that
+            // use BuildOptions can take advantage of HSBY role probing without subclassing.
+            // Hsby auto-enables only when a partner was actually supplied; pre-5.1 invocations
+            // (no --partner) see exactly the legacy options shape.
+            PartnerHostAddress: Partner,
+            Hsby: string.IsNullOrWhiteSpace(Partner) ? null : new AbCipHsbyOptions
+            {
+                Enabled = true,
+                ProbeInterval = TimeSpan.FromSeconds(2),
+            })],
         Tags = tags,
         Timeout = Timeout,
         Probe = new AbCipProbeOptions { Enabled = false },