up

src/Cli/StellaOps.Cli/Services/IVexObservationsClient.cs

@@ -0,0 +1,34 @@
+using System.Threading;
+using System.Threading.Tasks;
+using StellaOps.Cli.Services.Models;
+
+namespace StellaOps.Cli.Services;
+
+/// <summary>
+/// Client for VEX observation queries.
+/// Per CLI-LNM-22-002.
+/// </summary>
+internal interface IVexObservationsClient
+{
+    /// <summary>
+    /// Gets VEX observations matching the query.
+    /// </summary>
+    Task<VexObservationResponse> GetObservationsAsync(
+        VexObservationQuery query,
+        CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Gets a VEX linkset for a vulnerability ID.
+    /// </summary>
+    Task<VexLinksetResponse> GetLinksetAsync(
+        VexLinksetQuery query,
+        CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Gets a single VEX observation by ID.
+    /// </summary>
+    Task<VexObservation?> GetObservationByIdAsync(
+        string tenant,
+        string observationId,
+        CancellationToken cancellationToken);
+}