feat(api): Add Policy Registry API specification

- Introduced OpenAPI specification for the StellaOps Policy Registry API, covering endpoints for verification policies, policy packs, snapshots, violations, overrides, sealed mode operations, and advisory staleness tracking.
- Defined schemas, parameters, and responses for comprehensive API documentation.

chore(scanner): Add global usings for scanner analyzers

- Created GlobalUsings.cs to simplify namespace usage across analyzer libraries.

feat(scanner): Implement Surface Service Collection Extensions

- Added SurfaceServiceCollectionExtensions for dependency injection registration of surface analysis services.
- Included methods for adding surface analysis, surface collectors, and entry point collectors to the service collection.

src/Scheduler/StellaOps.Scheduler.WebService/GraphJobs/MongoGraphJobStore.cs

@@ -1,82 +0,0 @@
-using System.Collections.Generic;
-using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
-
-namespace StellaOps.Scheduler.WebService.GraphJobs;
-
-internal sealed class MongoGraphJobStore : IGraphJobStore
-{
-    private readonly IGraphJobRepository _repository;
-
-    public MongoGraphJobStore(IGraphJobRepository repository)
-    {
-        _repository = repository ?? throw new ArgumentNullException(nameof(repository));
-    }
-
-    public async ValueTask<GraphBuildJob> AddAsync(GraphBuildJob job, CancellationToken cancellationToken)
-    {
-        await _repository.InsertAsync(job, cancellationToken);
-        return job;
-    }
-
-    public async ValueTask<GraphOverlayJob> AddAsync(GraphOverlayJob job, CancellationToken cancellationToken)
-    {
-        await _repository.InsertAsync(job, cancellationToken);
-        return job;
-    }
-
-    public async ValueTask<GraphJobCollection> GetJobsAsync(string tenantId, GraphJobQuery query, CancellationToken cancellationToken)
-    {
-        var normalized = query.Normalize();
-        var builds = normalized.Type is null or GraphJobQueryType.Build
-            ? await _repository.ListBuildJobsAsync(tenantId, normalized.Status, normalized.Limit ?? 50, cancellationToken)
-            : Array.Empty<GraphBuildJob>();
-
-        var overlays = normalized.Type is null or GraphJobQueryType.Overlay
-            ? await _repository.ListOverlayJobsAsync(tenantId, normalized.Status, normalized.Limit ?? 50, cancellationToken)
-            : Array.Empty<GraphOverlayJob>();
-
-        return GraphJobCollection.From(builds, overlays);
-    }
-
-    public async ValueTask<GraphBuildJob?> GetBuildJobAsync(string tenantId, string jobId, CancellationToken cancellationToken)
-        => await _repository.GetBuildJobAsync(tenantId, jobId, cancellationToken);
-
-    public async ValueTask<GraphOverlayJob?> GetOverlayJobAsync(string tenantId, string jobId, CancellationToken cancellationToken)
-        => await _repository.GetOverlayJobAsync(tenantId, jobId, cancellationToken);
-
-    public async ValueTask<GraphJobUpdateResult<GraphBuildJob>> UpdateAsync(GraphBuildJob job, GraphJobStatus expectedStatus, CancellationToken cancellationToken)
-    {
-        if (await _repository.TryReplaceAsync(job, expectedStatus, cancellationToken).ConfigureAwait(false))
-        {
-            return GraphJobUpdateResult<GraphBuildJob>.UpdatedResult(job);
-        }
-
-        var existing = await _repository.GetBuildJobAsync(job.TenantId, job.Id, cancellationToken).ConfigureAwait(false);
-        if (existing is null)
-        {
-            throw new KeyNotFoundException($"Graph build job '{job.Id}' not found.");
-        }
-
-        return GraphJobUpdateResult<GraphBuildJob>.NotUpdated(existing);
-    }
-
-    public async ValueTask<GraphJobUpdateResult<GraphOverlayJob>> UpdateAsync(GraphOverlayJob job, GraphJobStatus expectedStatus, CancellationToken cancellationToken)
-    {
-        if (await _repository.TryReplaceOverlayAsync(job, expectedStatus, cancellationToken).ConfigureAwait(false))
-        {
-            return GraphJobUpdateResult<GraphOverlayJob>.UpdatedResult(job);
-        }
-
-        var existing = await _repository.GetOverlayJobAsync(job.TenantId, job.Id, cancellationToken).ConfigureAwait(false);
-        if (existing is null)
-        {
-            throw new KeyNotFoundException($"Graph overlay job '{job.Id}' not found.");
-        }
-
-        return GraphJobUpdateResult<GraphOverlayJob>.NotUpdated(existing);
-    }
-
-    public async ValueTask<IReadOnlyCollection<GraphOverlayJob>> GetOverlayJobsAsync(string tenantId, CancellationToken cancellationToken)
-        => await _repository.ListOverlayJobsAsync(tenantId, cancellationToken);
-}

src/Scheduler/StellaOps.Scheduler.WebService/PolicyRuns/PolicyRunService.cs

@@ -5,7 +5,7 @@ using System.ComponentModel.DataAnnotations;
 using System.Linq;
 using Microsoft.Extensions.Logging;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 using StellaOps.Scheduler.WebService;
 
 namespace StellaOps.Scheduler.WebService.PolicyRuns;

src/Scheduler/StellaOps.Scheduler.WebService/PolicySimulations/PolicySimulationMetricsProvider.cs

@@ -6,7 +6,7 @@ using System.Text.Json.Serialization;
 using System.Threading;
 using System.Threading.Tasks;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 
 namespace StellaOps.Scheduler.WebService.PolicySimulations;
 

src/Scheduler/StellaOps.Scheduler.WebService/Runs/InMemoryRunRepository.cs

@@ -3,7 +3,7 @@ using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 
 namespace StellaOps.Scheduler.WebService.Runs;
 

src/Scheduler/StellaOps.Scheduler.WebService/Runs/RunEndpoints.cs

@@ -10,8 +10,7 @@ using Microsoft.AspNetCore.Routing;
 using Microsoft.Extensions.Primitives;
 using StellaOps.Scheduler.ImpactIndex;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
-using StellaOps.Scheduler.Storage.Mongo.Services;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 using StellaOps.Scheduler.WebService.Auth;
 
 namespace StellaOps.Scheduler.WebService.Runs;

src/Scheduler/StellaOps.Scheduler.WebService/Runs/RunStreamCoordinator.cs

@@ -9,7 +9,7 @@ using Microsoft.AspNetCore.Http;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 
 namespace StellaOps.Scheduler.WebService.Runs;
 

src/Scheduler/StellaOps.Scheduler.WebService/SchedulerEndpointHelpers.cs

@@ -2,8 +2,7 @@ using System.ComponentModel.DataAnnotations;
 using System.Globalization;
 using System.Text;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
-using StellaOps.Scheduler.Storage.Mongo.Services;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 
 namespace StellaOps.Scheduler.WebService;
 

src/Scheduler/StellaOps.Scheduler.WebService/Schedules/InMemorySchedulerServices.cs

@@ -2,9 +2,7 @@ using System.Collections.Concurrent;
 using System.Collections.Immutable;
 using MongoDB.Driver;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Projections;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
-using StellaOps.Scheduler.Storage.Mongo.Services;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 
 namespace StellaOps.Scheduler.WebService.Schedules;
 

src/Scheduler/StellaOps.Scheduler.WebService/Schedules/ScheduleContracts.cs

@@ -2,7 +2,7 @@ using System.Collections.Immutable;
 using System.ComponentModel.DataAnnotations;
 using System.Text.Json.Serialization;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Projections;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 
 namespace StellaOps.Scheduler.WebService.Schedules;
 

src/Scheduler/StellaOps.Scheduler.WebService/Schedules/ScheduleEndpoints.cs

@@ -6,8 +6,7 @@ using Microsoft.AspNetCore.Mvc;
 using Microsoft.AspNetCore.Routing;
 using Microsoft.Extensions.Logging;
 using StellaOps.Scheduler.Models;
-using StellaOps.Scheduler.Storage.Mongo.Repositories;
-using StellaOps.Scheduler.Storage.Mongo.Services;
+using StellaOps.Scheduler.Storage.Postgres.Repositories;
 using StellaOps.Scheduler.WebService.Auth;
 
 namespace StellaOps.Scheduler.WebService.Schedules;