Show global HelpText when other commands are present and no args were provided

Author: dusrdev

src/ConsoleAppFramework/Emitter.cs

@@ -595,7 +595,15 @@ void EmitRunBody(ILookup<string, CommandWithId> groupedCommands, int depth, bool
             {
                 ifBlock = sb.BeginBlock($"if (args.Length == {depth})");
             }
-            EmitLeafCommand(leafCommand);
+
+            if (ifBlock != null && depth == 0 && leafCommand?.Command.IsRootCommand == true && groupedCommands.Count > 1)
+            {
+                sb.AppendLine("ShowHelp(-1);");
+            }
+            else
+            {
+                EmitLeafCommand(leafCommand);
+            }
             if (ifBlock != null)
             {
                 sb.AppendLine("return;");

tests/ConsoleAppFramework.GeneratorTests/HelpTest.cs

@@ -136,6 +136,32 @@ public void ListWithRoot()
         verifier.Execute(code, args: "--help", expected: """
 Usage: [command] [options...] [-h|--help] [--version]
 
+Options:
+  --x <int>     (Required)
+  --y <int>     (Required)
+
+Commands:
+  a
+  a b c
+  ab
+
+""");
+    }
+
+    [Fact]
+    public void NoArgsShowsGlobalSummary()
+    {
+        var code = """
+var app = ConsoleApp.Create();
+app.Add("", (int x, int y) => { });
+app.Add("a", (int x, int y) => { });
+app.Add("ab", (int x, int y) => { });
+app.Add("a b c", (int x, int y) => { });
+app.Run(args);
+""";
+        verifier.Execute(code, args: "", expected: """
+Usage: [command] [options...] [-h|--help] [--version]
+
 Options:
   --x <int>     (Required)
   --y <int>     (Required)

tests/ConsoleAppFramework.GeneratorTests/SubCommandTest.cs

@@ -22,7 +22,19 @@ public void Zeroargs()
 builder.Run(args);
 """;
 
-        verifier.Execute(code, "", "root");
+        verifier.Execute(code, "", """
+Usage: [command] [-h|--help] [--version]
+
+Commands:
+  a
+  a b c d e f
+  a b1
+  a b2
+  a b2 c
+  a b2 d
+  a b2 d e
+
+""");
         verifier.Execute(code, "a", "a");
         verifier.Execute(code, "a b1", "a b1");
         verifier.Execute(code, "a b2", "a b2");
@@ -78,7 +90,19 @@ public void ZeroargsAsync()
 await builder.RunAsync(args);
 """;
 
-        verifier.Execute(code, "", "root");
+        verifier.Execute(code, "", """
+Usage: [command] [-h|--help] [--version]
+
+Commands:
+  a
+  a b c d e f
+  a b1
+  a b2
+  a b2 c
+  a b2 d
+  a b2 d e
+
+""");
         verifier.Execute(code, "a", "a");
         verifier.Execute(code, "a b1", "a b1");
         verifier.Execute(code, "a b2", "a b2");