codebeltnet · gimlichael · Jan 21, 2026 · Jan 20, 2026 · Jan 20, 2026 · Jan 20, 2026
diff --git a/.docfx/Dockerfile.docfx b/.docfx/Dockerfile.docfx
@@ -1,4 +1,4 @@
-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/*

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -152,6 +152,37 @@ namespace Cuemon
 For further examples, refer to existing test files such as  
 [`test/Cuemon.Core.Tests/DisposableTest.cs`](test/Cuemon.Core.Tests/DisposableTest.cs) and  [`test/Cuemon.Core.Tests/Security/HashFactoryTest.cs`](test/Cuemon.Core.Tests/Security/HashFactoryTest.cs).
 
+## 9. Avoid `InternalsVisibleTo` in Tests
+
+- **Do not** use `InternalsVisibleTo` to access internal types or members from test projects.
+- Prefer **indirect testing via public APIs** that depend on the internal implementation (public facades, public extension methods, or other public entry points).
+
+### Preferred Pattern
+
+**Pattern name:** Public Facade Testing (also referred to as *Public API Proxy Testing*)
+
+**Description:**  
+Internal classes and methods must be validated by exercising the public API that consumes them. Tests should assert observable behavior exposed by the public surface rather than targeting internal implementation details directly.
+
+### Example Mapping
+
+- **Internal helper:** `DelimitedString` (internal static class)  
+- **Public API:** `TestOutputHelperExtensions.WriteLines()` (public extension method)  
+- **Test strategy:** Write tests for `WriteLines()` and verify its public behavior. The internal call to `DelimitedString.Create()` is exercised implicitly.
+
+### Benefits
+
+- Avoids exposing internal types to test assemblies.
+- Ensures tests reflect real-world usage patterns.
+- Maintains strong encapsulation and a clean public API.
+- Tests remain resilient to internal refactoring as long as public behavior is preserved.
+
+### When to Apply
+
+- Internal logic is fully exercised through existing public APIs.
+- Public entry points provide sufficient coverage of internal code paths.
+- The internal implementation exists solely as a helper or utility for public-facing functionality.
+
 ---
 description: 'Writing Performance Tests in Cuemon'
 applyTo: "tuning/**, **/*Benchmark*.cs"

diff --git a/.github/prompts/nuget.prompt.md b/.github/prompts/nuget.prompt.md
@@ -0,0 +1,36 @@
+---
+mode: agent
+description: 'Prompt for populating PackageReleaseNotes.txt files under .nuget/**'
+params:
+  version: '10.0.0'
+---
+
+Purpose: deterministic, low-analysis instructions so automated runs prepend a single, consistent release block.
+
+Behavior (exact):
+- For every file matching `.nuget/**/PackageReleaseNotes.txt`:
+  1. Read the file and find the first line that starts with `Availability:` (case-sensitive).
+  2. If found, capture the remainder of that line as `previous-tfm` and prepend the exact template shown below (substituting `{{version}}` and `{{previous-tfm}}`).
+  3. If not found within the first 3 lines, do nothing for that file.
+  4. Apply the template exactly as shown, preserving all whitespace and blank lines (including NBSP U+00A0 characters).
+  5. Save the file in-place - do not open PRs or create branches.
+  6. Continue to the next file until all matching files have been processed.
+  7. Do not assume that each file are the same - process each file independently.
-  7. Do not assume that each file are the same - process each file independently.
+  7. Do not assume that each file is the same - process each file independently.
-  7. Do not assume that each file are the same - process each file independently.
+  7. Do not assume that each file is the same - process each file independently.
+
+Exact template to prepend (preserve whitespace and trailing NBSP U+00A0 on the blank lines):
+```
+Version {{version}}
+Availability: {{previous-tfm}}
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
+```
+Notes:
+- Do not attempt to infer versions or parse changelogs — use the provided `params.version` value.
+- Keep edits minimal: only prepend the template block; preserve the rest of the file unchanged for human interference.
+- DO NOT REMOVE THE ASCII 0xA0 NBSP CHARACTERS OR RUN ANY SORT OF TRIM on the blank lines in the template!
+- DO NOT RUN ANY SORT OF GIT COMMANDS - once the files are saved, you are done.
+
+Example run command (agent):
+`run: /nuget version={{version}}`
diff --git a/.nuget/Cuemon.AspNetCore.App/PackageReleaseNotes.txt b/.nuget/Cuemon.AspNetCore.App/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -84,4 +90,4 @@ Availability: .NET 9 and .NET 8
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.AspNetCore.Authentication/PackageReleaseNotes.txt b/.nuget/Cuemon.AspNetCore.Authentication/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -103,4 +109,4 @@ Availability: .NET 9 and .NET 8
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.AspNetCore.Mvc/PackageReleaseNotes.txt b/.nuget/Cuemon.AspNetCore.Mvc/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -88,4 +94,4 @@ Availability: .NET 9 and .NET 8
 # Improvements
 - EXTENDED ExceptionDescriptorResult class in the Cuemon.AspNetCore.Mvc namespace to have an extra overload that accepts ProblemDetails
 - CHANGED FaultDescriptorFilter class in the Cuemon.AspNetCore.Mvc.Filters.Diagnostics namespace to support preferred fault descriptor (e.g., FaultDetails or ProblemDetails)
-
+
diff --git a/.nuget/Cuemon.AspNetCore.Razor.TagHelpers/PackageReleaseNotes.txt b/.nuget/Cuemon.AspNetCore.Razor.TagHelpers/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -84,4 +90,4 @@ Availability: .NET 9 and .NET 8
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.AspNetCore/PackageReleaseNotes.txt b/.nuget/Cuemon.AspNetCore/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -94,4 +100,4 @@ Availability: .NET 9 and .NET 8
 # Improvements
 - EXTENDED FaultDescriptorOptions class in the Cuemon.AspNetCore.Diagnostics namespace to include a property named FaultDescriptor (PreferredFaultDescriptor); default is PreferredFaultDescriptor.FaultDetails
 - EXTENDED HttpExceptionDescriptor class in the Cuemon.AspNetCore.Diagnostics namespace to include two new properties; Instance (Uri) and TraceId (string)
-
+
diff --git a/.nuget/Cuemon.Core.App/PackageReleaseNotes.txt b/.nuget/Cuemon.Core.App/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
@@ -146,4 +152,4 @@ Availability: .NET 9, .NET 8 and .NET Standard 2.0
 - Cuemon.Security.Cryptography
 - Cuemon.Threading
 - Cuemon.Xml
-
+
diff --git a/.nuget/Cuemon.Core/PackageReleaseNotes.txt b/.nuget/Cuemon.Core/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
@@ -170,4 +176,4 @@ Availability: .NET 9, .NET 8 and .NET Standard 2.0
 - EXTENDED Validator class in the Cuemon namespace with five new methods: ThrowIfContainsReservedKeyword, ThrowIfNotDifferent, ThrowIfDifferent, ThrowIfContainsAny and ThrowIfNotContainsAny
 - CHANGED Validator class in the Cuemon namespace to comply with RSPEC-3343
 - EXTENDED Decorator class in the Cuemon namespace with an additional method: RawEnclose
-
+
diff --git a/.nuget/Cuemon.Data.Integrity/PackageReleaseNotes.txt b/.nuget/Cuemon.Data.Integrity/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
@@ -84,4 +90,4 @@ Availability: .NET 9, .NET 8 and .NET Standard 2.0
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.Data.SqlClient/PackageReleaseNotes.txt b/.nuget/Cuemon.Data.SqlClient/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
@@ -85,4 +91,4 @@ Availability: .NET 9, .NET 8 and .NET Standard 2.0
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.Data/PackageReleaseNotes.txt b/.nuget/Cuemon.Data/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
@@ -84,4 +90,4 @@ Availability: .NET 9, .NET 8 and .NET Standard 2.0
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.Diagnostics/PackageReleaseNotes.txt b/.nuget/Cuemon.Diagnostics/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10, .NET 9 and .NET Standard 2.0
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10, .NET 9 and .NET Standard 2.0
 
@@ -84,4 +90,4 @@ Availability: .NET 9, .NET 8 and .NET Standard 2.0
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Authentication/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Authentication/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -84,4 +90,4 @@ Availability: .NET 9 and .NET 8
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Mvc.Formatters.Text.Json/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Mvc.Formatters.Text.Json/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -87,4 +93,4 @@ Availability: .NET 9 and .NET 8
 
 # Breaking Changes
 - REMOVED HttpExceptionDescriptorResponseHandlerExtensions class from the Cuemon.Extensions.AspNetCore.Mvc.Formatters.Text.Json namespace
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Mvc.Formatters.Xml/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Mvc.Formatters.Xml/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -87,4 +93,4 @@ Availability: .NET 9 and .NET 8
 
 # Breaking Changes
 - REMOVED HttpExceptionDescriptorResponseHandlerExtensions class from the Cuemon.Extensions.AspNetCore.Mvc.Formatters.Xml namespace
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Mvc.RazorPages/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Mvc.RazorPages/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -84,4 +90,4 @@ Availability: .NET 9 and .NET 8
 # ALM
 - CHANGED Dependencies to latest and greatest with respect to TFMs
 - REMOVED Support for TFM .NET 6 (LTS)
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Mvc/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Mvc/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -93,4 +99,4 @@ Availability: .NET 9 and .NET 8
 - REMOVED YamlSerializationOutputFormatter class from the Cuemon.Extensions.AspNetCore.Mvc.Formatters.Text.Yaml namespace
 - REMOVED MvcBuilderExtensions class from the Cuemon.Extensions.AspNetCore.Mvc.Filters namespace
 - REMOVED MvcCoreBuilderExtensions class from the Cuemon.Extensions.AspNetCore.Mvc.Filters namespace
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Text.Json/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Text.Json/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -87,4 +93,4 @@ Availability: .NET 9 and .NET 8
 
 # Improvements
 - EXTENDED JsonConverterCollectionExtensions class in the Cuemon.Extensions.AspNetCore.Text.Json.Converters namespace to include two new extension methods: AddProblemDetailsConverter and AddHeaderDictionaryConverter
-
+
diff --git a/.nuget/Cuemon.Extensions.AspNetCore.Xml/PackageReleaseNotes.txt b/.nuget/Cuemon.Extensions.AspNetCore.Xml/PackageReleaseNotes.txt
@@ -1,3 +1,9 @@
+Version 10.1.2
+Availability: .NET 10 and .NET 9
+
+# ALM
+- CHANGED Dependencies have been upgraded to the latest compatible versions for all supported target frameworks (TFMs)
+
 Version 10.1.1
 Availability: .NET 10 and .NET 9
 
@@ -87,4 +93,4 @@ Availability: .NET 9 and .NET 8
 
 # Improvements
 - EXTENDED XmlConverterExtensions class in the Cuemon.Extensions.AspNetCore.Xml.Converters namespace to include one new extension method: AddProblemDetailsConverter
-
+