up

src/Cli/StellaOps.Cli/Services/IPromotionAssembler.cs

@@ -0,0 +1,42 @@
+using System.Threading;
+using System.Threading.Tasks;
+using StellaOps.Cli.Services.Models;
+
+namespace StellaOps.Cli.Services;
+
+/// <summary>
+/// Assembler for promotion attestations.
+/// Per CLI-PROMO-70-001/002.
+/// </summary>
+internal interface IPromotionAssembler
+{
+    /// <summary>
+    /// Assembles a promotion attestation from the provided request.
+    /// </summary>
+    Task<PromotionAssembleResult> AssembleAsync(
+        PromotionAssembleRequest request,
+        CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Resolves image digest from registry.
+    /// </summary>
+    Task<string?> ResolveImageDigestAsync(
+        string imageRef,
+        CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Signs a promotion predicate and produces a DSSE bundle.
+    /// Per CLI-PROMO-70-002.
+    /// </summary>
+    Task<PromotionAttestResult> AttestAsync(
+        PromotionAttestRequest request,
+        CancellationToken cancellationToken);
+
+    /// <summary>
+    /// Verifies a promotion attestation bundle offline.
+    /// Per CLI-PROMO-70-002.
+    /// </summary>
+    Task<PromotionVerifyResult> VerifyAsync(
+        PromotionVerifyRequest request,
+        CancellationToken cancellationToken);
+}