stabilizaiton work - projects rework for maintenanceability and ui livening

src/__Libraries/StellaOps.Provcache/ProvcacheStatistics.cs

@@ -0,0 +1,44 @@
+using System;
+
+namespace StellaOps.Provcache;
+
+/// <summary>
+/// Cache statistics for monitoring and diagnostics.
+/// </summary>
+public sealed record ProvcacheStatistics
+{
+    /// <summary>
+    /// Total number of entries in the cache.
+    /// </summary>
+    public long TotalEntries { get; init; }
+
+    /// <summary>
+    /// Total number of cache hits.
+    /// </summary>
+    public long TotalHits { get; init; }
+
+    /// <summary>
+    /// Number of entries expiring within the next hour.
+    /// </summary>
+    public long ExpiringWithinHour { get; init; }
+
+    /// <summary>
+    /// Number of unique policy hashes.
+    /// </summary>
+    public int UniquePolicies { get; init; }
+
+    /// <summary>
+    /// Number of unique signer set hashes.
+    /// </summary>
+    public int UniqueSignerSets { get; init; }
+
+    /// <summary>
+    /// Oldest entry timestamp.
+    /// </summary>
+    public DateTimeOffset? OldestEntry { get; init; }
+
+    /// <summary>
+    /// Newest entry timestamp.
+    /// </summary>
+    public DateTimeOffset? NewestEntry { get; init; }
+}