[release/13.2] Suppress animated banner auto-display in CI/non-interactive environments

src/Aspire.Cli/Program.cs

@@ -484,8 +484,10 @@ internal static async Task DisplayFirstTimeUseNoticeIfNeededAsync(IServiceProvid
         var sentinel = serviceProvider.GetRequiredService<IFirstTimeUseNoticeSentinel>();
         var isFirstRun = !sentinel.Exists();
 
-        // Show banner if explicitly requested OR on first run (unless suppressed by noLogo)
-        if (showBanner || (isFirstRun && !noLogo))
+        var hostEnvironment = serviceProvider.GetRequiredService<ICliHostEnvironment>();
+
+        // Show banner if explicitly requested OR on first run (unless suppressed by noLogo or non-interactive output)
+        if (showBanner || (isFirstRun && !noLogo && hostEnvironment.SupportsInteractiveOutput))
         {
             var bannerService = serviceProvider.GetRequiredService<IBannerService>();
             await bannerService.DisplayBannerAsync(cancellationToken);

tests/Aspire.Cli.Tests/Commands/RootCommandTests.cs

@@ -344,6 +344,47 @@ public async Task InformationalFlag_DoesNotCreateSentinel_OnSubsequentFirstRun()
         Assert.True(sentinel.WasCreated);
     }
 
+    [Fact]
+    public async Task FirstTimeUseNotice_BannerNotDisplayedInNonInteractiveEnvironment()
+    {
+        using var workspace = TemporaryWorkspace.Create(outputHelper);
+        var sentinel = new TestFirstTimeUseNoticeSentinel { SentinelExists = false };
+        var bannerService = new TestBannerService();
+
+        var services = CliTestHelper.CreateServiceCollection(workspace, outputHelper, options =>
+        {
+            options.FirstTimeUseNoticeSentinelFactory = _ => sentinel;
+            options.BannerServiceFactory = _ => bannerService;
+            options.CliHostEnvironmentFactory = _ => TestHelpers.CreateNonInteractiveHostEnvironment();
+        });
+        var provider = services.BuildServiceProvider();
+
+        await Program.DisplayFirstTimeUseNoticeIfNeededAsync(provider, []);
+
+        Assert.False(bannerService.WasBannerDisplayed);
+        Assert.True(sentinel.WasCreated);
+    }
+
+    [Fact]
+    public async Task Banner_DisplayedWithExplicitBannerFlag_InNonInteractiveEnvironment()
+    {
+        using var workspace = TemporaryWorkspace.Create(outputHelper);
+        var sentinel = new TestFirstTimeUseNoticeSentinel { SentinelExists = true }; // Not first run
+        var bannerService = new TestBannerService();
+
+        var services = CliTestHelper.CreateServiceCollection(workspace, outputHelper, options =>
+        {
+            options.FirstTimeUseNoticeSentinelFactory = _ => sentinel;
+            options.BannerServiceFactory = _ => bannerService;
+            options.CliHostEnvironmentFactory = _ => TestHelpers.CreateNonInteractiveHostEnvironment();
+        });
+        var provider = services.BuildServiceProvider();
+
+        await Program.DisplayFirstTimeUseNoticeIfNeededAsync(provider, [CommonOptionNames.Banner]);
+
+        Assert.True(bannerService.WasBannerDisplayed);
+    }
+
     [Fact]
     public void SetupCommand_NotAvailable_WhenBundleIsNotAvailable()
     {