wip: doctor/cli/docs/api to vector db consolidation; api hardening for descriptions, tenant, and scopes; migrations and conversions of all DALs to EF v10

src/__Libraries/StellaOps.Artifact.Infrastructure/Postgres/ArtifactDbContextFactory.cs

@@ -0,0 +1,33 @@
+using System;
+using Microsoft.EntityFrameworkCore;
+using Npgsql;
+using StellaOps.Artifact.Infrastructure.EfCore.CompiledModels;
+using StellaOps.Artifact.Infrastructure.EfCore.Context;
+
+namespace StellaOps.Artifact.Infrastructure.Postgres;
+
+/// <summary>
+/// Runtime factory for creating <see cref="ArtifactDbContext"/> instances.
+/// Uses the static compiled model when schema matches the default; falls back to
+/// reflection-based model building for non-default schemas (integration tests).
+/// </summary>
+internal static class ArtifactDbContextFactory
+{
+    public static ArtifactDbContext Create(NpgsqlConnection connection, int commandTimeoutSeconds, string schemaName)
+    {
+        var normalizedSchema = string.IsNullOrWhiteSpace(schemaName)
+            ? ArtifactDataSource.DefaultSchemaName
+            : schemaName.Trim();
+
+        var optionsBuilder = new DbContextOptionsBuilder<ArtifactDbContext>()
+            .UseNpgsql(connection, npgsql => npgsql.CommandTimeout(commandTimeoutSeconds));
+
+        if (string.Equals(normalizedSchema, ArtifactDataSource.DefaultSchemaName, StringComparison.Ordinal))
+        {
+            // Use the static compiled model when schema mapping matches the default model.
+            optionsBuilder.UseModel(ArtifactDbContextModel.Instance);
+        }
+
+        return new ArtifactDbContext(optionsBuilder.Options, normalizedSchema);
+    }
+}