fix(management): 5-min Ask timeout for transport/deploy commands (arch-review S1)

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

src/ZB.MOM.WW.ScadaBridge.ManagementService/ManagementEndpoints.cs

@@ -32,6 +32,31 @@ public static class ManagementEndpoints
         return DefaultAskTimeout;
     }
 
+    private static readonly TimeSpan DefaultLongRunningTimeout = TimeSpan.FromMinutes(5);
+
+    /// <summary>Transport/deploy commands legitimately run for minutes (the CLI already
+    /// uses a 5-minute client timeout for bundles); a 30 s server-side Ask 504s while the
+    /// piped ProcessCommand keeps applying — the caller then retries and double-applies
+    /// (arch-review S1). These command types get LongRunningCommandTimeout instead.</summary>
+    private static readonly HashSet<Type> LongRunningCommands =
+    [
+        typeof(ImportBundleCommand), typeof(PreviewBundleCommand), typeof(ExportBundleCommand),
+        typeof(MgmtDeployArtifactsCommand), typeof(MgmtDeployInstanceCommand),
+    ];
+
+    /// <summary>
+    /// Resolves the ManagementActor Ask timeout for a specific command type. Long-running
+    /// transport/deploy commands use <see cref="ManagementServiceOptions.LongRunningCommandTimeout"/>
+    /// (default 5 min); all other commands fall through to <see cref="ResolveAskTimeout(ManagementServiceOptions?)"/>.
+    /// </summary>
+    /// <param name="options">The management service options, or <c>null</c> if not configured.</param>
+    /// <param name="commandType">The runtime type of the command being dispatched.</param>
+    /// <returns>The resolved Ask timeout for the command.</returns>
+    public static TimeSpan ResolveAskTimeout(ManagementServiceOptions? options, Type commandType)
+        => LongRunningCommands.Contains(commandType)
+            ? (options is { LongRunningCommandTimeout.Ticks: > 0 } o ? o.LongRunningCommandTimeout : DefaultLongRunningTimeout)
+            : ResolveAskTimeout(options);
+
     /// <summary>Registers the <c>POST /management</c> endpoint on the given route builder.</summary>
     /// <param name="endpoints">The route builder to add the endpoint to.</param>
     /// <returns>The same <paramref name="endpoints"/> instance for chaining.</returns>
@@ -99,7 +124,8 @@ public static class ManagementEndpoints
         var envelope = new ManagementEnvelope(authenticatedUser, command, correlationId);
 
         var askTimeout = ResolveAskTimeout(
-            context.RequestServices.GetService<IOptions<ManagementServiceOptions>>()?.Value);
+            context.RequestServices.GetService<IOptions<ManagementServiceOptions>>()?.Value,
+            command.GetType());
 
         object response;
         try

src/ZB.MOM.WW.ScadaBridge.ManagementService/ManagementServiceOptions.cs

@@ -4,4 +4,7 @@ public class ManagementServiceOptions
 {
     /// <summary>Maximum time to wait for a management command to complete before returning a timeout error; default 30 seconds.</summary>
     public TimeSpan CommandTimeout { get; set; } = TimeSpan.FromSeconds(30);
+
+    /// <summary>Maximum time to wait for a long-running transport/deploy command (import/preview/export bundle, deploy artifacts/instance) before returning a timeout error; default 5 minutes.</summary>
+    public TimeSpan LongRunningCommandTimeout { get; set; } = TimeSpan.FromMinutes(5);
 }