From 02330c5468c619f4f0d3c92c01c817e9d9862425 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sel=C3=A7uk=20G=C3=9CRAL?= <selcukgural@gmail.com>
Date: Wed, 1 Apr 2026 16:16:42 +0300
Subject: [PATCH] feat: Surface generated OpenAPI document paths via MSBuild
 Message

Previously, the GetDocument tool's output was only available via
<Exec> stdout, which Terminal Logger suppresses at default verbosity.

 After the exec completes, read the generated document paths from the cache file and emit them as a high-importance MSBuild <Message>. This surfaces the output through MSBuild's message infrastructure, making it visible to all loggers that respect MessageImportance.High.

 Visibility in Terminal Logger at default verbosity depends on
 dotnet/msbuild#10416 being resolved.

 Fixes #62273
---
 .../Microsoft.Extensions.ApiDescription.Server.targets      | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/Tools/Extensions.ApiDescription.Server/src/build/Microsoft.Extensions.ApiDescription.Server.targets b/src/Tools/Extensions.ApiDescription.Server/src/build/Microsoft.Extensions.ApiDescription.Server.targets
index f5b2839bd16d..36afcd1ff492 100644
--- a/src/Tools/Extensions.ApiDescription.Server/src/build/Microsoft.Extensions.ApiDescription.Server.targets
+++ b/src/Tools/Extensions.ApiDescription.Server/src/build/Microsoft.Extensions.ApiDescription.Server.targets
@@ -65,6 +65,12 @@
     <Message Importance="high" Text="%0AGenerateOpenApiDocuments:" />
     <Message Importance="high" Text="  $(_DotNetGetDocumentCommand)" />
     <Exec Command="$(_DotNetGetDocumentCommand)" LogStandardErrorAsError="true" />
+
+    <!-- Surface generated documents via MSBuild Message so Terminal Logger shows them -->
+    <ReadLinesFromFile File="$(_OpenApiDocumentsCache)">
+      <Output TaskParameter="Lines" ItemName="_GeneratedOpenApiDocuments" />
+    </ReadLinesFromFile>
+    <Message Importance="high" Text="Generated OpenAPI document: %(_GeneratedOpenApiDocuments.Identity)" />
   </Target>
 
   <!-- Unless this is an inner build or default timing is disabled, tie document retrieval into the build. -->