feat: Add tests for RichGraphPublisher and RichGraphWriter

- Implement unit tests for RichGraphPublisher to verify graph publishing to CAS.
- Implement unit tests for RichGraphWriter to ensure correct writing of canonical graphs and metadata.

feat: Implement AOC Guard validation logic

- Add AOC Guard validation logic to enforce document structure and field constraints.
- Introduce violation codes for various validation errors.
- Implement tests for AOC Guard to validate expected behavior.

feat: Create Console Status API client and service

- Implement ConsoleStatusClient for fetching console status and streaming run events.
- Create ConsoleStatusService to manage console status polling and event subscriptions.
- Add tests for ConsoleStatusClient to verify API interactions.

feat: Develop Console Status component

- Create ConsoleStatusComponent for displaying console status and run events.
- Implement UI for showing status metrics and handling user interactions.
- Add styles for console status display.

test: Add tests for Console Status store

- Implement tests for ConsoleStatusStore to verify event handling and state management.

src/Scanner/__Libraries/StellaOps.Scanner.Reachability/ReachabilityRichGraphPublisherService.cs

@@ -0,0 +1,41 @@
+using System;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using StellaOps.Scanner.Cache.Abstractions;
+using StellaOps.Scanner.Surface.Env;
+
+namespace StellaOps.Scanner.Reachability;
+
+public interface IRichGraphPublisherService
+{
+    Task<RichGraphPublishResult> PublishAsync(ReachabilityUnionGraph graph, string analysisId, CancellationToken cancellationToken = default);
+}
+
+/// <summary>
+/// Service wrapper that builds richgraph-v1 from a union graph and stores it in CAS.
+/// </summary>
+public sealed class ReachabilityRichGraphPublisherService : IRichGraphPublisherService
+{
+    private readonly ISurfaceEnvironment _environment;
+    private readonly IFileContentAddressableStore _cas;
+    private readonly IRichGraphPublisher _publisher;
+
+    public ReachabilityRichGraphPublisherService(
+        ISurfaceEnvironment environment,
+        IFileContentAddressableStore cas,
+        IRichGraphPublisher publisher)
+    {
+        _environment = environment ?? throw new ArgumentNullException(nameof(environment));
+        _cas = cas ?? throw new ArgumentNullException(nameof(cas));
+        _publisher = publisher ?? throw new ArgumentNullException(nameof(publisher));
+    }
+
+    public Task<RichGraphPublishResult> PublishAsync(ReachabilityUnionGraph graph, string analysisId, CancellationToken cancellationToken = default)
+    {
+        var richGraph = RichGraphBuilder.FromUnion(graph, "scanner.reachability", "0.1.0");
+        var workRoot = Path.Combine(_environment.Settings.CacheRoot.FullName, "reachability");
+        Directory.CreateDirectory(workRoot);
+        return _publisher.PublishAsync(richGraph, analysisId, _cas, workRoot, cancellationToken);
+    }
+}