using StellaOps.Scheduler.Models;

namespace StellaOps.Scheduler.Plugin;

/// <summary>
/// Callback interface for plugins to report progress and update Run state.
/// </summary>
public interface IRunProgressReporter
{
    /// <summary>
    /// Reports progress as completed/total with an optional message.
    /// </summary>
    Task ReportProgressAsync(int completed, int total, string? message = null, CancellationToken ct = default);

    /// <summary>
    /// Transitions the Run to a new state, optionally recording an error.
    /// </summary>
    Task TransitionStateAsync(RunState newState, string? error = null, CancellationToken ct = default);

    /// <summary>
    /// Appends a log entry to the Run's execution log.
    /// </summary>
    Task AppendLogAsync(string message, string level = "info", CancellationToken ct = default);
}