v3(b1-twincat): apply Modbus exemplar pattern to TwinCAT (multi-device)

- Rename TwinCATEquipmentTagParser -> TwinCATTagDefinitionFactory; TryParse ->
  FromTagConfig(tagConfig, rawPath, out def). Drop leading-'{' heuristic + the
  deviceHostAddress key; def.Name = rawPath. Keep strict-enum + Inspect; add a
  Structure guard (sole tag path now) + inverse ToTagConfig.
- Options: Tags -> RawTags (RawTagEntry); keep Devices + protocol fields.
- Driver: _tagsByRawPath (Ordinal); byName-only resolver; build table from
  _options.RawTags via FromTagConfig, threading WriteIdempotent + DeviceName.
  Multi-device: ResolveDeviceHost matches entry.DeviceName against options.Devices
  (by name, then host) -> def.DeviceHostAddress (TODO(v3 WaveC): live host from the
  Device row's DeviceConfig). DiscoverAsync now emits from the table.
- Factory: retire pre-declared tags[] DTO path; bind rawTags; keep Devices.
- Cli: BuildOptions serialises typed defs -> RawTagEntry via ToTagConfig.
- Tests: TwinCATRawTags helper; migrate Tags= -> RawTags=; rename parser tests to
  FromTagConfig; equipment/resolve-host/array tests delivered via RawTags.

Gate: Contracts + Driver build green; Driver.TwinCAT.Tests 192 pass, Cli.Tests 70 pass.

tests/Drivers/ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Tests/TwinCATResolveHostTests.cs

@@ -1,13 +1,16 @@
 using Shouldly;
 using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
 using ZB.MOM.WW.OtOpcUa.Driver.TwinCAT;
 
 namespace ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Tests;
 
 /// <summary>
-///     CONV-4 — <see cref="TwinCATDriver.ResolveHost"/> must resolve an equipment-tag reference
-///     (raw TagConfig JSON) to its OWN device host so per-host breaker keys are correct for
-///     equipment tags, not the first-device fallback.
+///     CONV-4 — <see cref="TwinCATDriver.ResolveHost"/> must resolve an authored raw tag to its OWN
+///     device host so per-host breaker keys are correct for equipment tags, not the first-device
+///     fallback. Under v3 the tag is delivered as a <see cref="RawTagEntry"/> whose
+///     <see cref="RawTagEntry.DeviceName"/> names the owning device; the driver threads that onto the
+///     def's host at Initialize, and ResolveHost reads it back by RawPath.
 /// </summary>
 [Trait("Category", "Unit")]
 public sealed class TwinCATResolveHostTests
@@ -15,29 +18,35 @@ public sealed class TwinCATResolveHostTests
     private const string DeviceA = "ads://5.23.91.23.1.1:851";
     private const string DeviceB = "ads://5.23.91.23.1.2:851";
 
-    private static TwinCATDriver NewDriver() => new(
-        new TwinCATDriverOptions
-        {
-            Devices = [new TwinCATDeviceOptions(DeviceA), new TwinCATDeviceOptions(DeviceB)],
-            Probe = new TwinCATProbeOptions { Enabled = false },
-            EnableControllerBrowse = false,
-        },
-        "twincat-1", new FakeTwinCATClientFactory());
-
-    /// <summary>An equipment-tag ref naming device B resolves to device B's host, not the first device.</summary>
-    [Fact]
-    public void ResolveHost_EquipmentTagRef_ReturnsItsOwnDeviceHost()
+    private static async Task<TwinCATDriver> NewDriverAsync(params RawTagEntry[] rawTags)
     {
-        var drv = NewDriver();
-        var json = $$"""{"deviceHostAddress":"{{DeviceB}}","symbolPath":"MAIN.Speed","dataType":"DInt"}""";
-        drv.ResolveHost(json).ShouldBe(DeviceB);
+        var drv = new TwinCATDriver(
+            new TwinCATDriverOptions
+            {
+                Devices = [new TwinCATDeviceOptions(DeviceA), new TwinCATDeviceOptions(DeviceB)],
+                RawTags = rawTags,
+                Probe = new TwinCATProbeOptions { Enabled = false },
+                EnableControllerBrowse = false,
+            },
+            "twincat-1", new FakeTwinCATClientFactory());
+        await drv.InitializeAsync("{}", CancellationToken.None);
+        return drv;
+    }
+
+    /// <summary>A raw tag naming device B resolves to device B's host, not the first device.</summary>
+    [Fact]
+    public async Task ResolveHost_RawTagOnDeviceB_ReturnsItsOwnDeviceHost()
+    {
+        var blob = """{"symbolPath":"MAIN.Speed","dataType":"DInt"}""";
+        var drv = await NewDriverAsync(new RawTagEntry("equip/Speed", blob, WriteIdempotent: false, DeviceName: DeviceB));
+        drv.ResolveHost("equip/Speed").ShouldBe(DeviceB);
     }
 
     /// <summary>An unresolvable ref keeps the current first-device fallback.</summary>
     [Fact]
-    public void ResolveHost_UnknownRef_KeepsCurrentFallback()
+    public async Task ResolveHost_UnknownRef_KeepsCurrentFallback()
     {
-        var drv = NewDriver();
+        var drv = await NewDriverAsync();
         drv.ResolveHost("totally-unknown").ShouldBe(DeviceA);
     }
 }