feat(esg): --timeout-seconds on external-system create/update (management command + CLI, additive contract)

Claude-Session: https://claude.ai/code/session_01MtdgwpEeCUn6cUA5f1LMPj
2026-07-10 04:20:05 -04:00
parent 0b916ff0c5
commit eabd2820eb
5 changed files with 144 additions and 5 deletions
@@ -0,0 +1,79 @@
+using System.CommandLine;
+using ZB.MOM.WW.ScadaBridge.CLI.Commands;
+
+namespace ZB.MOM.WW.ScadaBridge.CLI.Tests.Commands;
+
+/// <summary>
+/// PLAN-06 Task 11: <c>external-system create</c> and <c>external-system update</c>
+/// must expose an optional <c>--timeout-seconds</c> (<see cref="int"/>?) flag that
+/// carries the per-system ESG HTTP timeout. Omitting it preserves the existing value
+/// (update) / uses the gateway default (create).
+/// </summary>
+public class ExternalSystemTimeoutOptionTests
+{
+    private static readonly Option<string> Url = new("--url") { Recursive = true };
+    private static readonly Option<string> Format = new("--format") { Recursive = true };
+    private static readonly Option<string> Username = new("--username") { Recursive = true };
+    private static readonly Option<string> Password = new("--password") { Recursive = true };
+
+    private static Command Group() => ExternalSystemCommands.Build(Url, Format, Username, Password);
+
+    private static Option? FindOption(Command command, string name)
+        => command.Options.SingleOrDefault(o => o.Name == name);
+
+    [Fact]
+    public void Create_HasOptionalTimeoutSecondsOption()
+    {
+        var create = Group().Subcommands.Single(c => c.Name == "create");
+        var option = FindOption(create, "--timeout-seconds");
+        Assert.NotNull(option);
+        Assert.False(option!.Required);
+    }
+
+    [Fact]
+    public void Update_HasOptionalTimeoutSecondsOption()
+    {
+        var update = Group().Subcommands.Single(c => c.Name == "update");
+        var option = FindOption(update, "--timeout-seconds");
+        Assert.NotNull(option);
+        Assert.False(option!.Required);
+    }
+
+    [Fact]
+    public void Create_ParsesTimeoutSecondsValue()
+    {
+        var parse = Group().Parse(new[]
+        {
+            "create", "--name", "Sys", "--endpoint-url", "http://x",
+            "--auth-type", "none", "--timeout-seconds", "15",
+        });
+
+        Assert.Empty(parse.Errors);
+        Assert.Equal(15, parse.GetValue<int?>("--timeout-seconds"));
+    }
+
+    [Fact]
+    public void Update_ParsesTimeoutSecondsValue()
+    {
+        var parse = Group().Parse(new[]
+        {
+            "update", "--id", "7", "--name", "Sys", "--endpoint-url", "http://x",
+            "--auth-type", "none", "--timeout-seconds", "20",
+        });
+
+        Assert.Empty(parse.Errors);
+        Assert.Equal(20, parse.GetValue<int?>("--timeout-seconds"));
+    }
+
+    [Fact]
+    public void Create_OmittedTimeoutSeconds_ParsesWithoutError()
+    {
+        var parse = Group().Parse(new[]
+        {
+            "create", "--name", "Sys", "--endpoint-url", "http://x", "--auth-type", "none",
+        });
+
+        Assert.Empty(parse.Errors);
+        Assert.Null(parse.GetValue<int?>("--timeout-seconds"));
+    }
+}