up

src/Signals/StellaOps.Signals/Persistence/IProcSnapshotRepository.cs

@@ -0,0 +1,42 @@
+using StellaOps.Signals.Models;
+
+namespace StellaOps.Signals.Persistence;
+
+/// <summary>
+/// Repository for persisting and querying proc snapshot documents.
+/// </summary>
+public interface IProcSnapshotRepository
+{
+    /// <summary>
+    /// Upsert a proc snapshot document.
+    /// </summary>
+    Task<ProcSnapshotDocument> UpsertAsync(ProcSnapshotDocument document, CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Get a proc snapshot by ID.
+    /// </summary>
+    Task<ProcSnapshotDocument?> GetByIdAsync(string id, CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Get all proc snapshots for a specific image digest.
+    /// </summary>
+    Task<IReadOnlyList<ProcSnapshotDocument>> GetByImageDigestAsync(
+        string tenant,
+        string imageDigest,
+        int limit = 100,
+        CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get the most recent proc snapshot for an image digest and runtime type.
+    /// </summary>
+    Task<ProcSnapshotDocument?> GetLatestAsync(
+        string tenant,
+        string imageDigest,
+        string runtimeType,
+        CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Delete expired proc snapshots.
+    /// </summary>
+    Task<int> DeleteExpiredAsync(CancellationToken cancellationToken);
+}