Complete management API and CLI command parity

2026-09-10 00:51:45 -04:00
parent 477e2abe97
commit 2750bd2809
38 changed files with 1637 additions and 199 deletions
@@ -0,0 +1,60 @@
+using System.CommandLine;
+using ZB.MOM.WW.ScadaBridge.CLI.Commands;
+
+namespace ZB.MOM.WW.ScadaBridge.CLI;
+
+/// <summary>Constructs the production CLI command tree for execution and surface verification.</summary>
+public static class CliApplication
+{
+    /// <summary>Builds an independent root command with every supported operation.</summary>
+    /// <returns>The configured CLI root.</returns>
+    public static RootCommand BuildRoot()
+    {
+        var rootCommand = new RootCommand("ScadaBridge CLI — manage the ScadaBridge SCADA system");
+
+        var urlOption = new Option<string>("--url") { Description = "Management API URL", Recursive = true };
+        var usernameOption = new Option<string>("--username") { Description = "LDAP username", Recursive = true };
+        var passwordOption = new Option<string>("--password") { Description = "LDAP password", Recursive = true };
+        // No DefaultValueFactory: format precedence (explicit --format -> config/env -> "json")
+        // is resolved by CommandHelpers.ResolveFormat, which needs to distinguish an absent flag.
+        // CliOptions.CreateFormatOption also constrains the accepted values (json/table).
+        var formatOption = CliOptions.CreateFormatOption();
+
+        rootCommand.Add(urlOption);
+        rootCommand.Add(usernameOption);
+        rootCommand.Add(passwordOption);
+        rootCommand.Add(formatOption);
+
+        // Register command groups
+        rootCommand.Add(TemplateCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(InstanceCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(SiteCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(DeployCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        var dataConnectionCommand = DataConnectionCommands.Build(urlOption, formatOption, usernameOption, passwordOption);
+        // Attach the site-routed browse/search/verify-endpoint/certs subcommands (actor parity, arch-review C4).
+        ConnectionBrowseCommands.AddTo(dataConnectionCommand, urlOption, formatOption, usernameOption, passwordOption);
+        rootCommand.Add(dataConnectionCommand);
+        rootCommand.Add(ExternalSystemCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(NotificationCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(SecurityCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(AuditLogCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(AuditCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(HealthCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(DebugCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(SharedSchemaCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(SharedScriptCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(DbConnectionCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(ApiMethodCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(BundleCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(CachedCallCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(SecuredWriteCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+        rootCommand.Add(FlowDebugCommands.Build(urlOption, formatOption, usernameOption, passwordOption));
+
+        rootCommand.SetAction(_ =>
+        {
+            Console.WriteLine("Use --help to see available commands.");
+        });
+
+        return rootCommand;
+    }
+}