// <copyright file="IFacetDriftDetector.cs" company="StellaOps">
// Copyright (c) StellaOps. Licensed under BUSL-1.1.
// </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);
}