feat: Implement Policy Engine Evaluation Service and Cache with unit tests

Temp commit to debug

src/Scanner/StellaOps.Scanner.WebService/Contracts/ReportContracts.cs

@@ -55,9 +55,13 @@ public sealed record ReportDocumentDto
     [JsonPropertyOrder(6)]
     public IReadOnlyList<PolicyPreviewVerdictDto> Verdicts { get; init; } = Array.Empty<PolicyPreviewVerdictDto>();
 
-    [JsonPropertyName("issues")]
-    [JsonPropertyOrder(7)]
-    public IReadOnlyList<PolicyPreviewIssueDto> Issues { get; init; } = Array.Empty<PolicyPreviewIssueDto>();
+    [JsonPropertyName("issues")]
+    [JsonPropertyOrder(7)]
+    public IReadOnlyList<PolicyPreviewIssueDto> Issues { get; init; } = Array.Empty<PolicyPreviewIssueDto>();
+
+    [JsonPropertyName("surface")]
+    [JsonPropertyOrder(8)]
+    public SurfacePointersDto? Surface { get; init; }
 }
 
 public sealed record ReportPolicyDto

src/Scanner/StellaOps.Scanner.WebService/Contracts/ScanStatusResponse.cs

@@ -1,13 +1,14 @@
-namespace StellaOps.Scanner.WebService.Contracts;
-
-public sealed record ScanStatusResponse(
-    string ScanId,
-    string Status,
-    ScanStatusTarget Image,
-    DateTimeOffset CreatedAt,
-    DateTimeOffset UpdatedAt,
-    string? FailureReason);
-
-public sealed record ScanStatusTarget(
-    string? Reference,
-    string? Digest);
+namespace StellaOps.Scanner.WebService.Contracts;
+
+public sealed record ScanStatusResponse(
+    string ScanId,
+    string Status,
+    ScanStatusTarget Image,
+    DateTimeOffset CreatedAt,
+    DateTimeOffset UpdatedAt,
+    string? FailureReason,
+    SurfacePointersDto? Surface);
+
+public sealed record ScanStatusTarget(
+    string? Reference,
+    string? Digest);

src/Scanner/StellaOps.Scanner.WebService/Contracts/SurfaceContracts.cs

@@ -0,0 +1,87 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace StellaOps.Scanner.WebService.Contracts;
+
+public sealed record SurfacePointersDto
+{
+    [JsonPropertyName("tenant")]
+    [JsonPropertyOrder(0)]
+    public string Tenant { get; init; } = string.Empty;
+
+    [JsonPropertyName("generatedAt")]
+    [JsonPropertyOrder(1)]
+    public DateTimeOffset GeneratedAt { get; init; }
+        = DateTimeOffset.UtcNow;
+
+    [JsonPropertyName("manifestDigest")]
+    [JsonPropertyOrder(2)]
+    public string ManifestDigest { get; init; } = string.Empty;
+
+    [JsonPropertyName("manifestUri")]
+    [JsonPropertyOrder(3)]
+    public string? ManifestUri { get; init; }
+        = null;
+
+    [JsonPropertyName("manifest")]
+    [JsonPropertyOrder(4)]
+    public SurfaceManifestDocument Manifest { get; init; } = new();
+}
+
+public sealed record SurfaceManifestDocument
+{
+    [JsonPropertyName("schema")]
+    [JsonPropertyOrder(0)]
+    public string Schema { get; init; } = "stellaops.surface.manifest@1";
+
+    [JsonPropertyName("tenant")]
+    [JsonPropertyOrder(1)]
+    public string Tenant { get; init; } = string.Empty;
+
+    [JsonPropertyName("imageDigest")]
+    [JsonPropertyOrder(2)]
+    public string ImageDigest { get; init; } = string.Empty;
+
+    [JsonPropertyName("generatedAt")]
+    [JsonPropertyOrder(3)]
+    public DateTimeOffset GeneratedAt { get; init; } = DateTimeOffset.UtcNow;
+
+    [JsonPropertyName("artifacts")]
+    [JsonPropertyOrder(4)]
+    public IReadOnlyList<SurfaceManifestArtifact> Artifacts { get; init; } = Array.Empty<SurfaceManifestArtifact>();
+}
+
+public sealed record SurfaceManifestArtifact
+{
+    [JsonPropertyName("kind")]
+    [JsonPropertyOrder(0)]
+    public string Kind { get; init; } = string.Empty;
+
+    [JsonPropertyName("uri")]
+    [JsonPropertyOrder(1)]
+    public string Uri { get; init; } = string.Empty;
+
+    [JsonPropertyName("digest")]
+    [JsonPropertyOrder(2)]
+    public string Digest { get; init; } = string.Empty;
+
+    [JsonPropertyName("mediaType")]
+    [JsonPropertyOrder(3)]
+    public string MediaType { get; init; } = string.Empty;
+
+    [JsonPropertyName("format")]
+    [JsonPropertyOrder(4)]
+    public string Format { get; init; } = string.Empty;
+
+    [JsonPropertyName("sizeBytes")]
+    [JsonPropertyOrder(5)]
+    public long SizeBytes { get; init; }
+        = 0;
+
+    [JsonPropertyName("view")]
+    [JsonPropertyOrder(6)]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public string? View { get; init; }
+        = null;
+}