prep docs and service updates

src/Signals/StellaOps.Signals/Options/SignalsOpenApiOptions.cs

@@ -0,0 +1,28 @@
+namespace StellaOps.Signals.Options;
+
+/// <summary>
+/// OpenAPI exposure options.
+/// </summary>
+public sealed class SignalsOpenApiOptions
+{
+    /// <summary>
+    /// Whether to expose OpenAPI description.
+    /// </summary>
+    public bool Enabled { get; set; } = false;
+
+    /// <summary>
+    /// UI path if enabled (e.g., /signals/swagger).
+    /// </summary>
+    public string UiPath { get; set; } = "/signals/swagger";
+
+    /// <summary>
+    /// JSON path if enabled (e.g., /signals/openapi.json).
+    /// </summary>
+    public string JsonPath { get; set; } = "/signals/openapi.json";
+
+    public void Validate()
+    {
+        if (string.IsNullOrWhiteSpace(UiPath)) UiPath = "/signals/swagger";
+        if (string.IsNullOrWhiteSpace(JsonPath)) JsonPath = "/signals/openapi.json";
+    }
+}

src/Signals/StellaOps.Signals/Options/SignalsOptions.cs

@@ -39,6 +39,11 @@ public sealed class SignalsOptions
     /// Cache configuration.
     /// </summary>
     public SignalsCacheOptions Cache { get; } = new();
+
+    /// <summary>
+    /// OpenAPI exposure (if enabled).
+    /// </summary>
+    public SignalsOpenApiOptions OpenApi { get; } = new();
 
     /// <summary>
     /// Validates configured options.
@@ -51,5 +56,6 @@ public sealed class SignalsOptions
         AirGap.Validate();
         Scoring.Validate();
         Cache.Validate();
+        OpenApi.Validate();
     }
 }