shoc-backend/SeaHaven.Services/Interfaces/IWorkOrderReconciliationRunner.cs

namespace SeaHaven.Services.Interfaces
{
    /// <summary>
    /// Trusted internal surface for work-order reconciliation, used by hosted services and other
    /// server-derived callers. Unlike <see cref="IWorkOrderReconciliationService"/> it does not
    /// accept a <see cref="System.Security.Claims.ClaimsPrincipal"/> because callers are already
    /// server-side and never expose an HTTP principal.
    /// </summary>
    public interface IWorkOrderReconciliationRunner
    {
        Task<WorkOrderReconciliationTriggerResult> TriggerAsync(
            string reason,
            CancellationToken cancellationToken);

        Task<bool> RunPendingAsync(CancellationToken cancellationToken);
    }
}