Task 7: Add operational hygiene AI context

Author: 307158-carmax

DBADashAI/Program.cs

@@ -34,6 +34,7 @@
 builder.Services.AddScoped<IAiTool, ReliabilityRiskSummaryTool>();
 builder.Services.AddScoped<IAiTool, CapacityForecastSummaryTool>();
 builder.Services.AddScoped<IAiTool, ConfigRiskDriftSummaryTool>();
+builder.Services.AddScoped<IAiTool, OperationalHygieneSummaryTool>();
 
 var app = builder.Build();
 

DBADashAI/Services/AiIntentRouter.cs

@@ -181,6 +181,21 @@ private static int ComputeScore(string question, IAiTool tool)
             }
         }
 
+        if (tool.Name == "operational-hygiene-summary")
+        {
+            var asksHygiene = question.Contains("hygiene", StringComparison.OrdinalIgnoreCase)
+                              || question.Contains("acknowledge", StringComparison.OrdinalIgnoreCase)
+                              || question.Contains("unacknowledged", StringComparison.OrdinalIgnoreCase)
+                              || question.Contains("stale alert", StringComparison.OrdinalIgnoreCase)
+                              || question.Contains("backlog", StringComparison.OrdinalIgnoreCase)
+                              || question.Contains("alert debt", StringComparison.OrdinalIgnoreCase)
+                              || question.Contains("workflow", StringComparison.OrdinalIgnoreCase);
+            if (asksHygiene)
+            {
+                score += 5;
+            }
+        }
+
         return score;
     }
 }

DBADashAI/Services/Tools/OperationalHygieneSummaryTool.cs

@@ -0,0 +1,97 @@
+using DBADashAI.Models;
+
+namespace DBADashAI.Services.Tools;
+
+public sealed class OperationalHygieneSummaryTool(SqlToolExecutor sql) : IAiTool
+{
+    public const string ToolName = "operational-hygiene-summary";
+
+    public string Name => ToolName;
+
+    public string Description => "Summarize alert hygiene debt such as resolved-unacknowledged and aging alert backlog.";
+
+    public string InputHint => "Use for monitoring process hygiene, acknowledgment debt, and stale alert workflow questions.";
+
+    public string[] Keywords => ["hygiene", "acknowledge", "acknowledgment", "stale alert", "backlog", "resolved unacknowledged", "alert debt"];
+
+    public async Task<AiToolResult> RunAsync(AiAskRequest request, CancellationToken cancellationToken)
+    {
+        const string sqlText = """
+            SELECT TOP 500
+                i.InstanceDisplayName,
+                aa.AlertType,
+                aa.AlertKey,
+                aa.Priority,
+                aa.IsResolved,
+                aa.IsAcknowledged,
+                aa.TriggerDate,
+                aa.UpdatedDate,
+                aa.ResolvedDate,
+                aa.LastMessage
+            FROM Alert.ActiveAlerts aa
+            INNER JOIN dbo.Instances i ON i.InstanceID = aa.InstanceID
+            WHERE i.IsActive = 1
+              AND aa.UpdatedDate >= DATEADD(DAY,-30,SYSUTCDATETIME())
+            ORDER BY aa.UpdatedDate DESC;
+            """;
+
+        var rows = await sql.QueryAsync(sqlText, Math.Max(request.MaxRows, 200), cancellationToken);
+
+        var resolvedUnacked = rows
+            .Where(r => (Get(r, "IsResolved") == "1" || string.Equals(Get(r, "IsResolved"), "True", StringComparison.OrdinalIgnoreCase))
+                        && (Get(r, "IsAcknowledged") == "0" || string.Equals(Get(r, "IsAcknowledged"), "False", StringComparison.OrdinalIgnoreCase)))
+            .ToList();
+
+        var unresolved = rows
+            .Where(r => Get(r, "IsResolved") == "0" || string.Equals(Get(r, "IsResolved"), "False", StringComparison.OrdinalIgnoreCase))
+            .ToList();
+
+        var byInstance = rows
+            .GroupBy(r => Get(r, "InstanceDisplayName"))
+            .Select(g => new
+            {
+                Instance = g.Key,
+                ResolvedUnacknowledged = g.Count(x => (Get(x, "IsResolved") == "1" || string.Equals(Get(x, "IsResolved"), "True", StringComparison.OrdinalIgnoreCase))
+                                                      && (Get(x, "IsAcknowledged") == "0" || string.Equals(Get(x, "IsAcknowledged"), "False", StringComparison.OrdinalIgnoreCase))),
+                UnresolvedCount = g.Count(x => Get(x, "IsResolved") == "0" || string.Equals(Get(x, "IsResolved"), "False", StringComparison.OrdinalIgnoreCase)),
+                TotalRecentAlerts = g.Count()
+            })
+            .OrderByDescending(x => x.ResolvedUnacknowledged)
+            .ThenByDescending(x => x.UnresolvedCount)
+            .ToList();
+
+        return new AiToolResult
+        {
+            RowCount = rows.Count,
+            Data = new
+            {
+                generatedUtc = DateTime.UtcNow,
+                summary = new
+                {
+                    totalRecentAlerts = rows.Count,
+                    resolvedUnacknowledgedCount = resolvedUnacked.Count,
+                    unresolvedCount = unresolved.Count
+                },
+                byInstance,
+                resolvedUnacknowledgedRows = resolvedUnacked,
+                unresolvedRows = unresolved,
+                rows
+            },
+            Evidence =
+            [
+                new AiEvidenceItem
+                {
+                    Source = "Alert.ActiveAlerts + dbo.Instances",
+                    Detail = "Operational hygiene indicators over last 30 days (resolved-unacknowledged backlog and unresolved debt)"
+                }
+            ]
+        };
+    }
+
+    private static string Get(Dictionary<string, object?> row, string key)
+    {
+        return row.TryGetValue(key, out var value) && value is not null
+            ? value.ToString() ?? string.Empty
+            : string.Empty;
+    }
+}

DBADashGUI/AI/AIAssistantControl.cs

@@ -220,6 +220,12 @@ private void SeedExampleQuestions()
         cboExamples.Items.Add("What high-risk SQL configuration changes happened in the last 14 days?");
         cboExamples.Items.Add("Which servers had frequent config changes that need review?");
 
+        // Add new operational hygiene examples
+        cboExamples.Items.Add("Which instances have the highest resolved-but-unacknowledged alert backlog?");
+        cboExamples.Items.Add("Where is alert hygiene debt accumulating right now?");
+        cboExamples.Items.Add("Show unresolved vs resolved-unacknowledged alert counts by instance.");
+        cboExamples.Items.Add("What stale alert workflow issues should be cleaned up today?");
+
         cboExamples.SelectedIndex = 0;
         _seedingExamples = false;
     }