// -----------------------------------------------------------------------------
// VexGateDecision.cs
// Sprint: SPRINT_20260106_003_002_SCANNER_vex_gate_service
// Description: VEX gate decision enum for pre-triage filtering.
// -----------------------------------------------------------------------------

using System.Text.Json.Serialization;

namespace StellaOps.Scanner.Gate;

/// <summary>
/// Decision outcome from VEX gate evaluation.
/// Determines whether a finding proceeds to triage and with what flags.
/// </summary>
[JsonConverter(typeof(JsonStringEnumConverter<VexGateDecision>))]
public enum VexGateDecision
{
    /// <summary>
    /// Finding cleared by VEX evidence - no action needed.
    /// Typically when vendor status is NotAffected with sufficient trust.
    /// </summary>
    [JsonStringEnumMemberName("pass")]
    Pass,

    /// <summary>
    /// Finding has partial evidence - proceed with caution.
    /// Used when evidence is inconclusive or conditions partially met.
    /// </summary>
    [JsonStringEnumMemberName("warn")]
    Warn,

    /// <summary>
    /// Finding requires immediate attention - exploitable and reachable.
    /// Highest priority for triage queue.
    /// </summary>
    [JsonStringEnumMemberName("block")]
    Block
}