using System;
using System.Collections.Generic;

namespace GB5Shared.GEF;

/// <summary>
/// Deterministic characterization of "what's going on" with an entity — populated by
/// <see cref="IGEFEngine.EvaluateAsync"/> from a bound qualifier's Document facts
/// (SituationType/Severity/Confidence/SupportingSignals). Null when no qualifier is configured
/// for the caller's EntityCode/Stage yet — GEF degrades gracefully rather than throwing.
/// </summary>
public class SituationDTO
{
    public string SituationType { get; set; } = string.Empty;

    public string Severity { get; set; } = string.Empty;

    /// <summary>0.0-1.0 confidence score.</summary>
    public double Confidence { get; set; }

    public IReadOnlyList<string> SupportingSignals { get; set; } = Array.Empty<string>();
}