save progress

src/__Libraries/StellaOps.Facet/IFacetDriftDetector.cs

@@ -0,0 +1,35 @@
+// <copyright file="IFacetDriftDetector.cs" company="StellaOps">
+// Copyright (c) StellaOps. Licensed under AGPL-3.0-or-later.
+// </copyright>
+
+namespace StellaOps.Facet;
+
+/// <summary>
+/// Detects drift between a baseline seal and current state.
+/// </summary>
+public interface IFacetDriftDetector
+{
+    /// <summary>
+    /// Compare current extraction result against a baseline seal.
+    /// </summary>
+    /// <param name="baseline">The baseline facet seal.</param>
+    /// <param name="current">The current extraction result.</param>
+    /// <param name="ct">Cancellation token.</param>
+    /// <returns>Drift report with per-facet analysis.</returns>
+    Task<FacetDriftReport> DetectDriftAsync(
+        FacetSeal baseline,
+        FacetExtractionResult current,
+        CancellationToken ct = default);
+
+    /// <summary>
+    /// Compare two seals.
+    /// </summary>
+    /// <param name="baseline">The baseline seal.</param>
+    /// <param name="current">The current seal.</param>
+    /// <param name="ct">Cancellation token.</param>
+    /// <returns>Drift report with per-facet analysis.</returns>
+    Task<FacetDriftReport> DetectDriftAsync(
+        FacetSeal baseline,
+        FacetSeal current,
+        CancellationToken ct = default);
+}