Add CTRL-C guidance message to aspire run command output (#10203)

* Initial plan

* Add CTRL-C guidance message to aspire run command output

Co-authored-by: mitchdenny <[email protected]>

* Update CTRL-C message

* Fix CTRL-C message formatting and change "app host" to "apphost"

Co-authored-by: maddymontaquila <[email protected]>

* Move CTRL+C message to appear after endpoints in codespaces

Co-authored-by: maddymontaquila <[email protected]>

* Fix CTRL+C message positioning in codespaces by improving environment detection

Co-authored-by: mitchdenny <[email protected]>

* Fixes to implementation.

* Fix formatting (bye bye pink)

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: mitchdenny <[email protected]>
Co-authored-by: Mitch Denny <[email protected]>
Co-authored-by: maddymontaquila <[email protected]>

Author: 3 people

src/Aspire.Cli/Commands/RunCommand.cs

@@ -188,9 +188,13 @@ protected override async Task<int> ExecuteAsync(ParseResult parseResult, Cancell
 
             _ansiConsole.Write(topPadder);
 
-            var isCodespaces = _configuration.GetValue<bool>("CODESPACES", false);
+            // Use the presence of CodespacesUrlWithLoginToken to detect codespaces, as this is more reliable
+            // than environment variables since it comes from the same backend detection logic
+            var isCodespaces = dashboardUrls.CodespacesUrlWithLoginToken is not null;
             var isRemoteContainers = _configuration.GetValue<bool>("REMOTE_CONTAINERS", false);
 
+            AppendCtrlCMessage(longestLocalizedLength);
+
             if (isCodespaces || isRemoteContainers)
             {
                 bool firstEndpoint = true;
@@ -202,6 +206,13 @@ protected override async Task<int> ExecuteAsync(ParseResult parseResult, Cancell
                     {
                         ProcessResourceState(resourceState, (resource, endpoint) =>
                         {
+                            // When we are appending endpoints we need
+                            // to remove the CTRL-C message that was appended
+                            // previously. So we can write the endpoint.
+                            // We will append the CTRL-C message again after
+                            // writing the endpoint.
+                            ClearLines(2);
+
                             var endpointsGrid = new Grid();
                             endpointsGrid.AddColumn();
                             endpointsGrid.AddColumn();
@@ -220,6 +231,8 @@ protected override async Task<int> ExecuteAsync(ParseResult parseResult, Cancell
                             var endpointsPadder = new Padder(endpointsGrid, new Padding(3, 0));
                             _ansiConsole.Write(endpointsPadder);
                             firstEndpoint = false;
+
+                            AppendCtrlCMessage(longestLocalizedLength);
                         });
                     }
                 }
@@ -278,6 +291,34 @@ protected override async Task<int> ExecuteAsync(ParseResult parseResult, Cancell
         }
     }
 
+    private void ClearLines(int lines)
+    {
+        if (lines <= 0)
+        {
+            return;
+        }
+
+        for (var i = 0; i < lines; i++)
+        {
+            _ansiConsole.Write("\u001b[1A");
+            _ansiConsole.Write("\u001b[2K"); // Clear the line
+        }
+    }
+
+    private void AppendCtrlCMessage(int longestLocalizedLength)
+    {
+
+        var ctrlCGrid = new Grid();
+        ctrlCGrid.AddColumn();
+        ctrlCGrid.AddColumn();
+        ctrlCGrid.Columns[0].Width = longestLocalizedLength + 1;
+        ctrlCGrid.AddRow(Text.Empty, Text.Empty);
+        ctrlCGrid.AddRow(new Text(string.Empty), new Markup(RunCommandStrings.PressCtrlCToStopAppHost));
+
+        var ctrlCPadder = new Padder(ctrlCGrid, new Padding(3, 0));
+        _ansiConsole.Write(ctrlCPadder);
+    }
+
     private static FileInfo GetAppHostLogFile()
     {
         var homeDirectory = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);

src/Aspire.Cli/Resources/RunCommandStrings.resx

@@ -143,7 +143,7 @@
     <value>Endpoints</value>
   </data>
   <data name="PressCtrlCToStopAppHost" xml:space="preserve">
-    <value>Press [bold]Ctrl+C[/] to stop the app host and exit.</value>
+    <value>Press [bold]CTRL+C[/] to stop the apphost and exit.</value>
     <comment>[bold] should not be localized</comment>
   </data>
   <data name="ProjectCouldNotBeRun" xml:space="preserve">