up

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

@@ -45,6 +45,11 @@ public sealed class SignalsOptions
     /// </summary>
     public SignalsOpenApiOptions OpenApi { get; } = new();
 
+    /// <summary>
+    /// Retention policy configuration for runtime facts and artifacts.
+    /// </summary>
+    public SignalsRetentionOptions Retention { get; } = new();
+
     /// <summary>
     /// Validates configured options.
     /// </summary>
@@ -57,5 +62,6 @@ public sealed class SignalsOptions
         Cache.Validate();
         Events.Validate();
         OpenApi.Validate();
+        Retention.Validate();
     }
 }

src/Signals/StellaOps.Signals/Options/SignalsRetentionOptions.cs

@@ -0,0 +1,87 @@
+namespace StellaOps.Signals.Options;
+
+/// <summary>
+/// Retention policy configuration for runtime facts.
+/// </summary>
+public sealed class SignalsRetentionOptions
+{
+    /// <summary>
+    /// Configuration section name.
+    /// </summary>
+    public const string SectionName = "Signals:Retention";
+
+    /// <summary>
+    /// Time-to-live for runtime facts in hours. Default is 720 (30 days).
+    /// Set to 0 to disable automatic expiration.
+    /// </summary>
+    public int RuntimeFactsTtlHours { get; set; } = 720;
+
+    /// <summary>
+    /// Time-to-live for callgraph artifacts in hours. Default is 2160 (90 days).
+    /// Set to 0 to disable automatic expiration.
+    /// </summary>
+    public int CallgraphTtlHours { get; set; } = 2160;
+
+    /// <summary>
+    /// Time-to-live for reachability states in hours. Default is 720 (30 days).
+    /// Set to 0 to disable automatic expiration.
+    /// </summary>
+    public int ReachabilityStateTtlHours { get; set; } = 720;
+
+    /// <summary>
+    /// Maximum number of runtime facts per subject. Default is 10000.
+    /// Older facts are evicted when the limit is reached.
+    /// </summary>
+    public int MaxRuntimeFactsPerSubject { get; set; } = 10000;
+
+    /// <summary>
+    /// Enable automatic cleanup of expired facts. Default is true.
+    /// </summary>
+    public bool EnableAutoCleanup { get; set; } = true;
+
+    /// <summary>
+    /// Cleanup interval in minutes. Default is 60.
+    /// </summary>
+    public int CleanupIntervalMinutes { get; set; } = 60;
+
+    /// <summary>
+    /// Archive expired facts to CAS before deletion. Default is true.
+    /// </summary>
+    public bool ArchiveBeforeDelete { get; set; } = true;
+
+    /// <summary>
+    /// CAS path for archived facts.
+    /// </summary>
+    public string ArchiveCasPath { get; set; } = "cas://signals/archive/runtime-facts";
+
+    /// <summary>
+    /// Validates retention options.
+    /// </summary>
+    public void Validate()
+    {
+        if (RuntimeFactsTtlHours < 0)
+        {
+            throw new ArgumentException("RuntimeFactsTtlHours must be >= 0.");
+        }
+
+        if (CallgraphTtlHours < 0)
+        {
+            throw new ArgumentException("CallgraphTtlHours must be >= 0.");
+        }
+
+        if (ReachabilityStateTtlHours < 0)
+        {
+            throw new ArgumentException("ReachabilityStateTtlHours must be >= 0.");
+        }
+
+        if (MaxRuntimeFactsPerSubject <= 0)
+        {
+            throw new ArgumentException("MaxRuntimeFactsPerSubject must be > 0.");
+        }
+
+        if (CleanupIntervalMinutes <= 0)
+        {
+            throw new ArgumentException("CleanupIntervalMinutes must be > 0.");
+        }
+    }
+}