feat: add PatternKit hosting extensions (#392)

* feat: add PatternKit hosting extensions

* chore: rerun pr validation

* ci: stabilize solution test coverage runs

Author: JerrettDavis

.github/workflows/ci.yml

@@ -54,6 +54,7 @@ jobs:
         run: |
           dotnet test PatternKit.slnx \
             --configuration Release \
+            -p:TestTfmsInParallel=false \
             --collect:"XPlat Code Coverage" \
             -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Format=cobertura \
             -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Include="[PatternKit*]*" \
@@ -167,6 +168,7 @@ jobs:
         run: |
           dotnet test PatternKit.slnx \
             --configuration Release \
+            -p:TestTfmsInParallel=false \
             --collect:"XPlat Code Coverage" \
             -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Format=cobertura \
             -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Include="[PatternKit*]*" \

.github/workflows/pr-validation.yml

@@ -77,8 +77,9 @@ jobs:
           dotnet test PatternKit.slnx \
             --configuration Release \
             --no-build \
+            -p:TestTfmsInParallel=false \
             --verbosity normal \
-            --logger "trx;LogFileName=test-results.trx" \
+            --logger "trx" \
             --collect:"XPlat Code Coverage" \
             --results-directory ./TestResults \
             -- DataCollectionRunSettings.DataCollectors.DataCollector.Configuration.Format=opencover
@@ -117,7 +118,8 @@ jobs:
           # Package all library projects
           for project in src/PatternKit.Core \
                         src/PatternKit.Generators \
-                        src/PatternKit.Generators.Abstractions; do
+                        src/PatternKit.Generators.Abstractions \
+                        src/PatternKit.Hosting.Extensions; do
             if [ -d "$project" ]; then
               echo "  Packing $project..."
               dotnet pack "$project" \

Directory.Packages.props

@@ -7,11 +7,12 @@
     <PackageVersion Include="coverlet.collector" Version="10.0.1" />
     <PackageVersion Include="JetBrains.Annotations" Version="2025.2.4" />
     <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="5.3.0" />
-    <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="5.0.0" />
+    <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="5.3.0" />
     <PackageVersion Include="Microsoft.Extensions.Configuration" Version="10.0.8" />
     <PackageVersion Include="Microsoft.Extensions.Configuration.Abstractions" Version="10.0.8" />
     <PackageVersion Include="Microsoft.Extensions.Configuration.Binder" Version="10.0.8" />
     <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.8" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection.Abstractions" Version="10.0.8" />
     <PackageVersion Include="Microsoft.Extensions.Hosting" Version="10.0.8" />
     <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.8" />
     <PackageVersion Include="Microsoft.Extensions.Options" Version="10.0.8" />
@@ -23,8 +24,8 @@
     <PackageVersion Include="System.Collections.Immutable" Version="10.0.8" />
     <PackageVersion Include="System.Linq.Async" Version="7.0.1" />
     <PackageVersion Include="System.Threading.Tasks.Extensions" Version="4.6.3" />
-    <PackageVersion Include="TinyBDD" Version="0.19.14" />
-    <PackageVersion Include="TinyBDD.Xunit" Version="0.19.14" />
+    <PackageVersion Include="TinyBDD" Version="0.19.21" />
+    <PackageVersion Include="TinyBDD.Xunit" Version="0.19.21" />
     <PackageVersion Include="Testcontainers" Version="4.12.0" />
     <PackageVersion Include="Testcontainers.RabbitMq" Version="4.12.0" />
     <PackageVersion Include="xunit" Version="2.9.3" />

PatternKit.slnx

@@ -10,6 +10,7 @@
     <Project Path="src/PatternKit.Examples/PatternKit.Examples.csproj" />
     <Project Path="src/PatternKit.Generators/PatternKit.Generators.csproj" />
     <Project Path="src/PatternKit.Generators.Abstractions/PatternKit.Generators.Abstractions.csproj" />
+    <Project Path="src/PatternKit.Hosting.Extensions/PatternKit.Hosting.Extensions.csproj" />
   </Folder>
   <Folder Name="/benchmarks/">
     <Project Path="benchmarks\PatternKit.Benchmarks\PatternKit.Benchmarks.csproj" Type="Classic C#" />
@@ -18,5 +19,6 @@
     <Project Path="test/PatternKit.Tests/PatternKit.Tests.csproj" />
     <Project Path="test\PatternKit.Examples.Tests\PatternKit.Examples.Tests.csproj" Type="Classic C#" />
     <Project Path="test\PatternKit.Generators.Tests\PatternKit.Generators.Tests.csproj" Type="Classic C#" />
+    <Project Path="test\PatternKit.Hosting.Extensions.Tests\PatternKit.Hosting.Extensions.Tests.csproj" Type="Classic C#" />
   </Folder>
 </Solution>

README.md

@@ -34,6 +34,33 @@ Install via NuGet:
 dotnet add package PatternKit --version <latest>
 ```
 
+For first-party `IServiceCollection` integration in ASP.NET Core, worker services, or generic host apps:
+
+```bash
+dotnet add package PatternKit.Hosting.Extensions --version <latest>
+```
+
+```csharp
+using Microsoft.Extensions.DependencyInjection;
+using PatternKit.Hosting.DependencyInjection;
+using PatternKit.Messaging.Channels;
+
+var services = new ServiceCollection();
+
+services
+    .AddPatternKitMessageChannel<OrderCommand>(
+        "orders",
+        channel => channel.WithCapacity(100, MessageChannelBackpressurePolicy.Reject))
+    .AddPatternKitRetryPolicy<ServiceReply>(
+        "inventory-retry",
+        retry => retry.WithMaxAttempts(3).HandleResult(static reply => !reply.Available));
+
+public sealed record OrderCommand(string OrderId, decimal Total);
+public sealed record ServiceReply(bool Available);
+```
+
+See [Hosting Extensions](docs/guides/hosting-extensions.md) for reusable DI registrations that do not depend on the examples assembly.
+
 Use a pattern immediately—here’s a simple **Strategy**:
 
 ```csharp