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.

src/Drivers/ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Contracts/TwinCATDriverOptions.cs

@@ -1,18 +1,30 @@
 using System.ComponentModel.DataAnnotations;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
 
 namespace ZB.MOM.WW.OtOpcUa.Driver.TwinCAT;
 
 /// <summary>
 ///     TwinCAT ADS driver configuration. One instance supports N targets (each identified by
 ///     an AMS Net ID + port). Compiles + runs without a local AMS router but every wire call
-///     fails with <c>BadCommunicationError</c> until a router is reachable.
+///     fails with <c>BadCommunicationError</c> until a router is reachable. The tags the driver
+///     serves are delivered as authored raw tags in <see cref="RawTags"/>; the driver maps each
+///     through <see cref="TwinCATTagDefinitionFactory.FromTagConfig"/> to build its
+///     RawPath → definition table, routing each to its device by the entry's
+///     <see cref="RawTagEntry.DeviceName"/> (multi-device).
 /// </summary>
 public sealed class TwinCATDriverOptions
 {
     /// <summary>Gets the list of TwinCAT devices to connect to.</summary>
     public IReadOnlyList<TwinCATDeviceOptions> Devices { get; init; } = [];
-    /// <summary>Gets the list of TwinCAT tag definitions.</summary>
-    public IReadOnlyList<TwinCATTagDefinition> Tags { get; init; } = [];
+
+    /// <summary>
+    ///     Authored raw tags this driver serves. The deploy artifact hands each authored raw
+    ///     <c>Tag</c> as a <see cref="RawTagEntry"/> (RawPath identity + driver <c>TagConfig</c> blob +
+    ///     WriteIdempotent flag + owning <see cref="RawTagEntry.DeviceName"/>); the driver maps each
+    ///     through <see cref="TwinCATTagDefinitionFactory.FromTagConfig"/> into its RawPath → definition
+    ///     table and routes it to the matching <see cref="Devices"/> entry by DeviceName.
+    /// </summary>
+    public IReadOnlyList<RawTagEntry> RawTags { get; init; } = [];
     /// <summary>Gets the probe options for TwinCAT connection probing.</summary>
     public TwinCATProbeOptions Probe { get; init; } = new();
     /// <summary>Gets the default communication timeout.</summary>
@@ -33,8 +45,8 @@ public sealed class TwinCATDriverOptions
     /// <summary>
     ///     When <c>true</c>, <c>DiscoverAsync</c> walks each device's symbol table via the
     ///     TwinCAT <c>SymbolLoaderFactory</c> (flat mode) + surfaces controller-resident
-    ///     globals / program locals under a <c>Discovered/</c> sub-folder. Pre-declared tags
-    ///     from <see cref="Tags"/> always emit regardless. Default <c>false</c> to preserve
+    ///     globals / program locals under a <c>Discovered/</c> sub-folder. Authored raw tags
+    ///     from <see cref="RawTags"/> always emit regardless. Default <c>false</c> to preserve
     ///     the strict-config path for deployments where only declared tags should appear.
     /// </summary>
     public bool EnableControllerBrowse { get; init; }