Merge branch 'main' of https://git.stella-ops.org/stella-ops.org/git.stella-ops.org

src/Notifier/StellaOps.Notifier/StellaOps.Notifier.WebService/Contracts/PackApprovalAckRequest.cs

@@ -1,9 +1,35 @@
-using System.ComponentModel.DataAnnotations;
-
-namespace StellaOps.Notifier.WebService.Contracts;
-
-public sealed class PackApprovalAckRequest
-{
-    [Required]
-    public string AckToken { get; init; } = string.Empty;
-}
+using System.ComponentModel.DataAnnotations;
+using System.Text.Json.Serialization;
+
+namespace StellaOps.Notifier.WebService.Contracts;
+
+/// <summary>
+/// Request payload for acknowledging a pack approval decision.
+/// </summary>
+public sealed class PackApprovalAckRequest
+{
+    /// <summary>
+    /// Acknowledgement token from the notification.
+    /// </summary>
+    [Required]
+    [JsonPropertyName("ackToken")]
+    public string AckToken { get; init; } = string.Empty;
+
+    /// <summary>
+    /// Approval decision: "approved" or "rejected".
+    /// </summary>
+    [JsonPropertyName("decision")]
+    public string? Decision { get; init; }
+
+    /// <summary>
+    /// Optional comment for audit trail.
+    /// </summary>
+    [JsonPropertyName("comment")]
+    public string? Comment { get; init; }
+
+    /// <summary>
+    /// Identity acknowledging the approval.
+    /// </summary>
+    [JsonPropertyName("actor")]
+    public string? Actor { get; init; }
+}