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

namespace SeaHaven.Services.Interfaces
{
    public interface IWorkOrderReconciliationService
    {
        Task<WorkOrderReconciliationTriggerResult> TriggerAsync(
            string reason,
            CancellationToken cancellationToken);

        Task<WorkOrderReconciliationStatus> GetStatusAsync(CancellationToken cancellationToken);

        Task<bool> RunPendingAsync(CancellationToken cancellationToken);
    }

    public sealed record WorkOrderReconciliationTriggerResult(bool Queued, Guid RunId);

    public sealed record WorkOrderReconciliationStatus(
        Guid? RunId,
        string State,
        string? Reason,
        DateTimeOffset? RequestedAt,
        DateTimeOffset? StartedAt,
        DateTimeOffset? CompletedAt,
        int WorkOrdersProcessed,
        int CommentsProcessed,
        string? ErrorCode);
}