feat: Implement ScannerSurfaceSecretConfigurator for web service options

- Added ScannerSurfaceSecretConfigurator to configure ScannerWebServiceOptions using surface secrets.
- Integrated ISurfaceSecretProvider to fetch and apply secrets for artifact store configuration.
- Enhanced logging for secret retrieval and application processes.

feat: Implement ScannerStorageSurfaceSecretConfigurator for worker options

- Introduced ScannerStorageSurfaceSecretConfigurator to configure ScannerStorageOptions with surface secrets.
- Utilized ISurfaceSecretProvider to retrieve and apply secrets for object store settings.
- Improved logging for secret handling and configuration.

feat: Create SurfaceManifestPublisher for publishing surface manifests

- Developed SurfaceManifestPublisher to handle the creation and storage of surface manifests.
- Implemented methods for serializing manifest documents and storing payloads in the object store.
- Added dual write functionality for mirror storage of manifests.

feat: Add SurfaceManifestStageExecutor for processing scan stages

- Created SurfaceManifestStageExecutor to execute the manifest publishing stage in scan jobs.
- Integrated with SurfaceManifestPublisher to publish manifests based on collected payloads.
- Enhanced logging for job processing and manifest storage.

feat: Define SurfaceManifest models for manifest structure

- Established SurfaceManifestDocument, SurfaceManifestSource, SurfaceManifestArtifact, and SurfaceManifestStorage records.
- Implemented serialization attributes for JSON handling of manifest models.

feat: Implement CasAccessSecret and SurfaceSecretParser for secret handling

- Created CasAccessSecret record to represent surface access secrets.
- Developed SurfaceSecretParser to parse and validate surface secrets from JSON payloads.

test: Add unit tests for CasAccessSecretParser

- Implemented tests for parsing CasAccessSecret from JSON payloads and metadata fallbacks.
- Verified expected values and behavior for secret parsing logic.

test: Add unit tests for ScannerSurfaceSecretConfigurator

- Created tests for ScannerSurfaceSecretConfigurator to ensure correct application of surface secrets to web service options.
- Validated artifact store settings after configuration.

test: Add unit tests for ScannerStorageSurfaceSecretConfigurator

- Implemented tests for ScannerStorageSurfaceSecretConfigurator to verify correct application of surface secrets to storage options.
- Ensured accurate configuration of object store settings.

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

@@ -1,6 +1,6 @@
 using System;
-using System.Collections.Generic;
 using System.Text.Json.Serialization;
+using StellaOps.Scanner.Surface.FS;
 
 namespace StellaOps.Scanner.WebService.Contracts;
 
@@ -28,60 +28,3 @@ public sealed record SurfacePointersDto
     [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;
-}