codebeltnet · gimlichael · Jan 24, 2026 · Jan 24, 2026 · Jan 24, 2026 · Jan 24, 2026
diff --git a/.docfx/Dockerfile.docfx b/.docfx/Dockerfile.docfx
@@ -1,9 +1,9 @@
-ARG NGINX_VERSION=1.29.3-alpine
+ARG NGINX_VERSION=1.29.4-alpine
 
 FROM --platform=$BUILDPLATFORM nginx:${NGINX_VERSION} AS base
 RUN rm -rf /usr/share/nginx/html/*
 
-FROM --platform=$BUILDPLATFORM codebeltnet/docfx:2.78.3 AS build
+FROM --platform=$BUILDPLATFORM codebeltnet/docfx:2.78.4 AS build
 
 ADD [".", "docfx"]
 

diff --git a/.docfx/docfx.json b/.docfx/docfx.json
@@ -44,7 +44,7 @@
     ],
     "globalMetadata": {
       "_appTitle": "Shared Kernel (DDD) for .NET",
-      "_appFooter": "<span>Generated by <strong>DocFX</strong>. Copyright 2024-2025 Geekle. All rights reserved. Code with passion; love your work; deploy with confidence 👨‍💻️🔥❤️🚀😎</span>",
+      "_appFooter": "<span>Generated by <strong>DocFX</strong>. Copyright 2024-2026 Geekle. All rights reserved. Code with passion; love your work; deploy with confidence 👨‍💻️🔥❤️🚀😎</span>",
       "_appLogoPath": "images/50x50.png",
       "_appFaviconPath": "images/favicon.ico",
       "_googleAnalyticsTagId": "G-NQMBRNRZ5X",

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
diff --git a/.github/prompts/benchmark.prompt.md b/.github/prompts/benchmark.prompt.md
@@ -0,0 +1,164 @@
+---
+mode: agent
+description: 'Writing Performance Benchmarks'
+---
+
+# Benchmark Fixture Prompt (Tuning Benchmarks)
+
+This prompt defines how to generate performance tests (“benchmarks”) for a project/solution using BenchmarkDotNet.  
+Benchmarks are *not* unit tests — they are micro- or component-level performance measurements that belong under the `tuning/` directory and follow strict conventions.
+
+Copilot must follow these guidelines when generating benchmark fixtures.
+
+---
+
+## 1. Naming and Placement
+
+- All benchmark projects live under the `tuning/` folder.  
+  Examples:
+  - `tuning/<ProjectName>.Benchmarks/`
+  - `tuning/<ProjectName>.Console.Benchmarks/`
+
+- **Namespaces must NOT end with `.Benchmarks`.**  
+  They must mirror the production assembly’s namespace.
+
+  Example:  
+  If benchmarking a type inside `YourProject.Console`, then:
+
+  ```csharp
+  namespace YourProject.Console
+  {
+      public class Sha512256Benchmark { … }
+  }
+  ```
+
+* **Benchmark class names must end with `Benchmark`.**
+  Example: `DateSpanBenchmark`, `FowlerNollVoBenchmark`.
+
+* Benchmark files should be located in the matching benchmark project
+  (e.g., benchmarks for `YourProject.Console` go in `YourProject.Console.Benchmarks.csproj`).
+
+* In the `.csproj` for each benchmark project, set the root namespace to the production namespace, for example:
+
+  ```xml
+  <RootNamespace>YourProject.Console</RootNamespace>
+  ```
+
+---
+
+## 2. Attributes and Configuration
+
+Each benchmark class should use:
+
+```csharp
+[MemoryDiagnoser]
+[GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
+```
+
+Optional but strongly recommended where meaningful:
+
+* `[Params(...)]` — define small, medium, large input sizes.
+* `[GlobalSetup]` — deterministic initialization of benchmark data.
+* `[Benchmark(Description = "...")]` — always add descriptions.
+* `[Benchmark(Baseline = true)]` — when comparing two implementations.
+
+Avoid complex global configs; prefer explicit attributes inside the class.
+
+---
+
+## 3. Structure and Best Practices
+
+A benchmark fixture must:
+
+* Measure a **single logical operation** per benchmark method.
+* Avoid I/O, networking, disk access, logging, or side effects.
+* Avoid expensive setup inside `[Benchmark]` methods.
+* Use deterministic data (e.g., seeded RNG or predefined constants).
+* Use `[GlobalSetup]` to allocate buffers, random payloads, or reusable test data only once.
+* Avoid shared mutable state unless reset per iteration.
-Each benchmark class should use:
-
-```csharp
-[MemoryDiagnoser]
-[GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
-```
-
-Optional but strongly recommended where meaningful:
-
-* `[Params(...)]` — define small, medium, large input sizes.
-* `[GlobalSetup]` — deterministic initialization of benchmark data.
-* `[Benchmark(Description = "...")]` — always add descriptions.
-* `[Benchmark(Baseline = true)]` — when comparing two implementations.
-
-Avoid complex global configs; prefer explicit attributes inside the class.
-
---
-
-## 3. Structure and Best Practices
-
-A benchmark fixture must:
-
-* Measure a **single logical operation** per benchmark method.
-* Avoid I/O, networking, disk access, logging, or side effects.
-* Avoid expensive setup inside `[Benchmark]` methods.
-* Use deterministic data (e.g., seeded RNG or predefined constants).
-* Use `[GlobalSetup]` to allocate buffers, random payloads, or reusable test data only once.
-* Avoid shared mutable state unless reset per iteration.
+Each benchmark class should use:
+
-Each benchmark class should use:
-
-```csharp
-[MemoryDiagnoser]
-[GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
-```
-
-Optional but strongly recommended where meaningful:
-
-* `[Params(...)]` — define small, medium, large input sizes.
-* `[GlobalSetup]` — deterministic initialization of benchmark data.
-* `[Benchmark(Description = "...")]` — always add descriptions.
-* `[Benchmark(Baseline = true)]` — when comparing two implementations.
-
-Avoid complex global configs; prefer explicit attributes inside the class.
-
---
-
-## 3. Structure and Best Practices
-
-A benchmark fixture must:
-
-* Measure a **single logical operation** per benchmark method.
-* Avoid I/O, networking, disk access, logging, or side effects.
-* Avoid expensive setup inside `[Benchmark]` methods.
-* Use deterministic data (e.g., seeded RNG or predefined constants).
-* Use `[GlobalSetup]` to allocate buffers, random payloads, or reusable test data only once.
-* Avoid shared mutable state unless reset per iteration.
+Each benchmark class should use:
+
+
+Use representative input sizes such as:
+
+```csharp
+[Params(8, 256, 4096)]
+public int Count { get; set; }
+```
+
+BenchmarkDotNet will run each benchmark for each parameter value.
+
+---
+
+## 4. Method Naming Conventions
+
+Use descriptive names that communicate intent:
+
+* `Parse_Short`
+* `Parse_Long`
+* `ComputeHash_Small`
+* `ComputeHash_Large`
+* `Serialize_Optimized`
+* `Serialize_Baseline`
+
+When comparing approaches, always list them clearly and tag one as the baseline.
+
+---
+
+## 5. Example Benchmark Fixture
+
+```csharp
+using BenchmarkDotNet.Attributes;
+using BenchmarkDotNet.Configs;
+
+namespace YourProject
+{
+    [MemoryDiagnoser]
+    [GroupBenchmarksBy(BenchmarkLogicalGroupRule.ByCategory)]
+    public class SampleOperationBenchmark
+    {
+        [Params(8, 256, 4096)]
+        public int Count { get; set; }
+
+        private byte[] _payload;
+
+        [GlobalSetup]
+        public void Setup()
+        {
+            _payload = new byte[Count];
+            // deterministic initialization
+        }
+
+        [Benchmark(Baseline = true, Description = "Operation - baseline")]
+        public int Operation_Baseline() => SampleOperation.Process(_payload);
+
+        [Benchmark(Description = "Operation - optimized")]
+        public int Operation_Optimized() => SampleOperation.ProcessOptimized(_payload);
+    }
+}
+```
+
+---
+
+## 6. Reporting and CI
+
+* Benchmark projects live exclusively under `tuning/`. They must not affect production builds.
+* Heavy BenchmarkDotNet runs should *not* run in CI unless explicitly configured.
+* Reports are produced by the benchmark runner and stored under the configured artifacts directory.
+
+---
+
+## 7. Additional Guidelines
+
+* Keep benchmark fixtures focused and readable.
+* Document non-obvious reasoning in short comments.
+* Prefer realistic but deterministic data sets.
+* When benchmarks reveal regressions or improvements, reference the associated PR or issue in a comment.
+* Shared benchmark helpers belong in `tuning/` projects, not in production code.
+
+---
+
+## Final Notes
+
+* Benchmarks are performance tests, not unit tests.
+* Use `[Benchmark]` only for pure performance measurement.
+* Avoid `MethodImplOptions.NoInlining` unless absolutely necessary.
+* Use small sets of meaningful benchmark scenarios — avoid combinatorial explosion.
diff --git a/.github/workflows/pipelines.yml → .github/workflows/ci-pipeline.yml b/.github/workflows/pipelines.yml → .github/workflows/ci-pipeline.yml
@@ -1,12 +1,7 @@
-name: Shared Kernel CI/CD Pipeline
+name: Shared Kernel CI Pipeline
 on:
   pull_request:
     branches: [main]
-    paths-ignore:
-      - .codecov/**
-      - .docfx/**
-      - .nuget/**
-      - '**/*.md'
   workflow_dispatch:
     inputs:
       configuration:
@@ -50,7 +45,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-24.04, windows-2022]
+        os: [ubuntu-24.04, windows-2025, ubuntu-24.04-arm, windows-11-arm]
         configuration: [Debug, Release]
     uses: codebeltnet/jobs-dotnet-test/.github/workflows/default.yml@v3
     with:

diff --git a/.nuget/Codebelt.SharedKernel/PackageReleaseNotes.txt b/.nuget/Codebelt.SharedKernel/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version: 0.5.1
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version: 0.5.0
 Availability: .NET 10 and .NET 9
 

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 For more details, please refer to `PackageReleaseNotes.txt` on a per assembly basis in the `.nuget` folder.
 
+## [0.5.1] - 2026-01-24
+
+This is a service update that focuses on package dependencies.
+
 ## [0.5.0] - 2025-11-15
 
 This is a major release that focuses on adapting the latest `.NET 10` release (LTS) in exchange for current `.NET 8` (LTS).

diff --git a/Codebelt.SharedKernel.sln b/Codebelt.SharedKernel.sln
diff --git a/Codebelt.SharedKernel.slnx b/Codebelt.SharedKernel.slnx
@@ -0,0 +1,8 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/Codebelt.SharedKernel/Codebelt.SharedKernel.csproj" />
+  </Folder>
+  <Folder Name="/test/">
+    <Project Path="test/Codebelt.SharedKernel.Tests/Codebelt.SharedKernel.Tests.csproj" />
+  </Folder>
+</Solution>
diff --git a/Directory.Build.props b/Directory.Build.props
@@ -4,6 +4,7 @@
     <IsMainAuthor Condition="'$(EMAIL)' == 'michael@geekle.io'">true</IsMainAuthor>
     <SkipSignAssembly>false</SkipSignAssembly>
     <LangVersion>latest</LangVersion>
+    <PackageReleaseNotesFile>..\..\.nuget\$(MSBuildProjectName)\PackageReleaseNotes.txt</PackageReleaseNotesFile>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(CI)' == 'true'">
@@ -13,7 +14,7 @@
 
   <PropertyGroup Condition="'$(IsTestProject)' == 'false'">
     <TargetFrameworks>net10.0;net9.0</TargetFrameworks>
-    <Copyright>Copyright © Geekle 2024-2025. All rights reserved.</Copyright>
+    <Copyright>Copyright © Geekle 2024-2026. All rights reserved.</Copyright>
     <Authors>gimlichael</Authors>
     <Company>Geekle</Company>
     <Product>Codebelt Shared Kernel (DDD)</Product>

diff --git a/Directory.Build.targets b/Directory.Build.targets
@@ -1,8 +1,4 @@
 <Project>
-  <PropertyGroup>
-   <PackageReleaseNotesFile>..\..\.nuget\$(MSBuildProjectName)\PackageReleaseNotes.txt</PackageReleaseNotesFile>
-  </PropertyGroup>
-
   <Target Name="PreparePackageReleaseNotesFromFile" BeforeTargets="GenerateNuspec" Condition="'$(IsTestProject)' == 'false' AND Exists('$(PackageReleaseNotesFile)')">
     <ReadLinesFromFile File="$(PackageReleaseNotesFile)">
       <Output TaskParameter="Lines" ItemName="PackageReleaseNotesLines"/>

diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -3,17 +3,17 @@
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
   <ItemGroup>
-    <PackageVersion Include="Cuemon.Extensions.IO" Version="10.0.0" />
-    <PackageVersion Include="Codebelt.Extensions.Xunit.App" Version="11.0.0" />
+    <PackageVersion Include="Cuemon.Extensions.IO" Version="10.1.2" />
+    <PackageVersion Include="Codebelt.Extensions.Xunit.App" Version="11.0.4" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
-    <PackageVersion Include="MinVer" Version="6.0.0" />
-    <PackageVersion Include="Savvyio.Domain" Version="5.0.0" />
-    <PackageVersion Include="Savvyio.Extensions.Newtonsoft.Json" Version="5.0.0" />
-    <PackageVersion Include="Savvyio.Extensions.Text.Json" Version="5.0.0" />
+    <PackageVersion Include="MinVer" Version="7.0.0" />
+    <PackageVersion Include="Savvyio.Domain" Version="5.0.1" />
+    <PackageVersion Include="Savvyio.Extensions.Newtonsoft.Json" Version="5.0.1" />
+    <PackageVersion Include="Savvyio.Extensions.Text.Json" Version="5.0.1" />
     <PackageVersion Include="coverlet.collector" Version="6.0.4" />
     <PackageVersion Include="coverlet.msbuild" Version="6.0.4" />
-    <PackageVersion Include="xunit.v3" Version="3.1.0" />
-    <PackageVersion Include="xunit.v3.runner.console" Version="3.2.0" />
+    <PackageVersion Include="xunit.v3" Version="3.2.2" />
+    <PackageVersion Include="xunit.v3.runner.console" Version="3.2.2" />
     <PackageVersion Include="xunit.runner.visualstudio" Version="3.1.5" />
   </ItemGroup>
 </Project>
diff --git a/LICENSE.md b/LICENSE.md
@@ -1,4 +1,4 @@
-MIT Copyright (c) 2024-2025 Geekle
+MIT Copyright (c) 2024-2026 Geekle
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

diff --git a/testenvironments.json b/testenvironments.json
@@ -9,7 +9,7 @@
         {
             "name": "Docker-Ubuntu",
             "type": "docker",
-            "dockerImage": "gimlichael/ubuntu-testrunner:net8.0.416-9.0.307-10.0.100"
+            "dockerImage": "gimlichael/ubuntu-testrunner:net8.0.417-9.0.309-10.0.102"
         }
     ]
 }