Add AI-generated command description to MCP approval dialog

The AI risk analyzer now generates a concise description of what the
command does, displayed prominently in the approval dialog to help
users quickly understand the command's purpose.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: gfraiteur

src/PostSharp.Engineering.McpApprovalServer/Mcp/Models/RiskAssessment.cs

@@ -36,6 +36,12 @@ public sealed class RiskAssessment
 
     public required string Reason { get; init; }
 
+    /// <summary>
+    /// Gets a description of what the command does (for AI-driven assessments).
+    /// Null for regex-based assessments.
+    /// </summary>
+    public string? Description { get; init; }
+
     /// <summary>
     /// Gets the name of the rule that triggered this assessment (for regex-based rules).
     /// Null for AI-driven assessments.
@@ -52,6 +58,7 @@ public static RiskAssessment Parse( string output )
         var level = RiskLevel.Medium;
         var recommendation = Recommendation.Approve;
         var reason = "Unable to parse risk assessment";
+        string? description = null;
 
         var lines = output.Split( '\n', StringSplitOptions.RemoveEmptyEntries );
 
@@ -87,8 +94,12 @@ public static RiskAssessment Parse( string output )
             {
                 reason = trimmedLine.Substring( 7 ).Trim();
             }
+            else if ( trimmedLine.StartsWith( "DESCRIPTION:", StringComparison.OrdinalIgnoreCase ) )
+            {
+                description = trimmedLine.Substring( 12 ).Trim();
+            }
         }
 
-        return new RiskAssessment { Level = level, Recommendation = recommendation, Reason = reason };
+        return new RiskAssessment { Level = level, Recommendation = recommendation, Reason = reason, Description = description };
     }
 }

src/PostSharp.Engineering.McpApprovalServer/Mcp/Services/RiskAnalyzer.cs

@@ -336,11 +336,12 @@ private static async Task<string> BuildAnalysisPromptAsync(
         // Response format
         sb.AppendLine( "## Response Format" );
         sb.AppendLine();
-        sb.AppendLine( "Respond with EXACTLY these three lines (no additional text):" );
+        sb.AppendLine( "Respond with EXACTLY these four lines (no additional text):" );
         sb.AppendLine( "```" );
+        sb.AppendLine( "DESCRIPTION: <one concise sentence describing what the command does>" );
         sb.AppendLine( "RISK: LOW|MEDIUM|HIGH|CRITICAL" );
         sb.AppendLine( "RECOMMEND: APPROVE|REJECT" );
-        sb.AppendLine( "REASON: <one concise sentence explaining your assessment>" );
+        sb.AppendLine( "REASON: <one concise sentence explaining your risk assessment>" );
         sb.AppendLine( "```" );
 
         return sb.ToString();

src/PostSharp.Engineering.McpApprovalServer/ViewModels/ApprovalViewModel.cs

@@ -46,6 +46,11 @@ public ApprovalViewModel( ApprovalRequest request, ApprovalRequestQueue queue )
 
     public RiskAssessment RegexAssessment => this._request.RegexAssessment;
 
+    /// <summary>
+    /// Gets the AI-generated description of what the command does.
+    /// </summary>
+    public string CommandDescription => this._request.AiAssessment.Description ?? "No description available";
+
     // UI helpers
     public bool HasRuleName => !string.IsNullOrEmpty( this._request.RegexAssessment.RuleName );
 

src/PostSharp.Engineering.McpApprovalServer/Views/ApprovalWindow.xaml

@@ -57,6 +57,7 @@
                 <RowDefinition Height="Auto" />
                 <RowDefinition Height="Auto" />
                 <RowDefinition Height="Auto" />
+                <RowDefinition Height="Auto" />
             </Grid.RowDefinitions>
             <Grid.ColumnDefinitions>
                 <ColumnDefinition Width="120" />
@@ -90,16 +91,20 @@
                        Foreground="#1976D2"
                        Margin="0,5" />
 
-            <TextBlock Grid.Row="3" Grid.Column="0" Text="Purpose:" FontWeight="Bold" Margin="0,5" />
-            <TextBox Grid.Row="3" Grid.Column="1"
-                     Text="{Binding ClaimedPurpose, Mode=OneWay}"
-                     IsReadOnly="True"
-                     TextWrapping="Wrap"
-                     Background="#F5F5F5"
-                     Margin="0,5" />
+            <TextBlock Grid.Row="3" Grid.Column="0" Text="Description:" FontWeight="Bold" Margin="0,5" />
+            <TextBlock Grid.Row="3" Grid.Column="1"
+                       Text="{Binding CommandDescription}"
+                       TextWrapping="Wrap"
+                       Margin="0,5" />
+
+            <TextBlock Grid.Row="4" Grid.Column="0" Text="Purpose:" FontWeight="Bold" Margin="0,5" />
+            <TextBlock Grid.Row="4" Grid.Column="1"
+                       Text="{Binding ClaimedPurpose}"
+                       TextWrapping="Wrap"
+                       Margin="0,5" />
 
-            <TextBlock Grid.Row="4" Grid.Column="0" Text="Received:" FontWeight="Bold" Margin="0,5" />
-            <TextBlock Grid.Row="4" Grid.Column="1" Text="{Binding ReceivedAt}" Margin="0,5" />
+            <TextBlock Grid.Row="5" Grid.Column="0" Text="Received:" FontWeight="Bold" Margin="0,5" />
+            <TextBlock Grid.Row="5" Grid.Column="1" Text="{Binding ReceivedAt}" Margin="0,5" />
         </Grid>
 
         <!-- Risk assessments in tabs -->