Refactor debug param to --go-debug and hide from CLI

Renamed the `debug` parameter to `goDebug` in `RunAsync` and `DevAsync`, add it on `CleanAsync`, marking it as `[Hidden]` to remove it from the CLI. Updated XML docs and parameter attributes for consistency. Adjusted logic to use `goDebug` for debugger launch.

Author: kzu

src/go/Program.cs

@@ -1,4 +1,3 @@
-using System.Net.Http;
 using System.Text;
 using ConsoleAppFramework;
 using Devlooped;
@@ -14,13 +13,13 @@
 /// Runs a file-based .NET app from a .cs entrypoint.
 /// </summary>
 /// <param name="input">Path to an existing .cs file or remote ref (owner/repo[@ref][:path]).</param>
-/// <param name="r2r">Publish with ReadyToRun instead of native AOT; supports more dynamic .NET features while keeping most publish optimizations. Alias: --go-r2r.</param>
-/// <param name="debug">Launch debugger before executing. Alias: --go-debug.</param>
+/// <param name="r2r">Publish with ReadyToRun instead of native AOT; supports more dynamic .NET features while keeping most publish optimizations. </param>
+/// <param name="goDebug">Launch debugger before executing.</param>
 /// <param name="extraArgs">Arguments before '--' are passed to 'dotnet publish'; arguments after '--' are forwarded to the published app. Without '--', all extra arguments are forwarded to the published app.
 /// </param>
-static async Task<int> RunAsync([Argument] string input, bool r2r = false, bool debug = false, [Argument] params string[] extraArgs)
+static async Task<int> RunAsync([Argument] string input, bool r2r = false, [Hidden] bool goDebug = false, [Argument] params string[] extraArgs)
 {
-    if (debug)
+    if (goDebug)
         System.Diagnostics.Debugger.Launch();
 
     var source = await GetEffectiveSourceAsync(input);
@@ -58,8 +57,12 @@ state.App is not null &&
 /// </summary>
 /// <param name="input">Path to an existing .cs file or remote ref (owner/repo[@ref][:path]).</param>
 /// <param name="all">Delete cached artifacts for all apps instead.</param>
-static int CleanAsync([Argument] string? input = null, bool all = false)
+/// <param name="goDebug">Launch debugger before executing.</param>
+static int CleanAsync([Argument] string? input = null, [Hidden] bool all = false, [Hidden] bool goDebug = false)
 {
+    if (goDebug)
+        System.Diagnostics.Debugger.Launch();
+
     if (all)
     {
         if (input is not null)
@@ -145,13 +148,13 @@ static int CleanAsync([Argument] string? input = null, bool all = false)
 /// Runs a file-based .NET app from a .cs entrypoint using dotnet run for fast iteration.
 /// </summary>
 /// <param name="input">Path to an existing .cs file or remote ref (owner/repo[@ref][:path]).</param>
-/// <param name="r2r">Accepted for consistency (ignored for dev which uses dotnet run). Alias: --go-r2r.</param>
-/// <param name="debug">Launch debugger before executing. Alias: --go-debug.</param>
+/// <param name="r2r">Accepted for consistency (ignored for dev which uses dotnet run).</param>
+/// <param name="goDebug">Launch debugger before executing.</param>
 /// <param name="extraArgs">Arguments before '--' are passed to 'dotnet run'; arguments after '--' are forwarded to the app. Without '--', all extra arguments are forwarded to the app.
 /// </param>
-static async Task<int> DevAsync([Argument] string input, bool r2r = false, bool debug = false, [Argument] params string[] extraArgs)
+static async Task<int> DevAsync([Argument] string input, [Hidden] bool r2r = false, [Hidden] bool goDebug = false, [Argument] params string[] extraArgs)
 {
-    if (debug)
+    if (goDebug)
         System.Diagnostics.Debugger.Launch();
 
     var source = await GetEffectiveSourceAsync(input);