stabilizaiton work - projects rework for maintenanceability and ui livening

src/__Libraries/StellaOps.Configuration/AuthorityEscalationOptions.cs

@@ -0,0 +1,29 @@
+using System;
+
+namespace StellaOps.Configuration;
+
+/// <summary>
+/// Options controlling escalation enforcement for acknowledgement flows.
+/// </summary>
+public sealed class AuthorityEscalationOptions
+{
+    /// <summary>
+    /// Scope required to mint or execute escalation-bearing ack tokens.
+    /// </summary>
+    public string Scope { get; set; } = "notify.escalate";
+
+    /// <summary>
+    /// When true, escalation requires the caller to also possess <c>notify.admin</c>.
+    /// </summary>
+    public bool RequireAdminScope { get; set; } = true;
+
+    internal void Validate()
+    {
+        if (string.IsNullOrWhiteSpace(Scope))
+        {
+            throw new InvalidOperationException("notifications.escalation.scope must be specified.");
+        }
+
+        Scope = Scope.Trim().ToLowerInvariant();
+    }
+}