sprints and audit work

src/Scanner/__Libraries/StellaOps.Scanner.Gate/VexGateDecision.cs

@@ -0,0 +1,38 @@
+// -----------------------------------------------------------------------------
+// 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
+}