V0.6.0/double digits

.bot/README.md

@@ -7,4 +7,4 @@ This folder is reserved for local-only AI working material such as:
 - design alternatives
 - temporary agent state
 
-Keep this folder out of source control. Move only finalized, non-confidential guidance into `AGENTS.md`.
+The `.bot/README.md` file itself is intentionally tracked in source control. All other `.bot/` working material remains local-only and excluded from source control. Move only finalized, non-confidential guidance into `AGENTS.md`.

.docfx/BuildDocfxImage.ps1

@@ -1,4 +1,4 @@
-$version = minver -i -t v -v w
+$version = minver -i -t v -v w
 docfx metadata docfx.json
 docker buildx build -t sharedkernel-docfx:$version --platform linux/arm64,linux/amd64 --load -f Dockerfile.docfx .
 get-childItem -recurse -path api -include *.yml, .manifest | remove-item

.docfx/filterConfig.yml

@@ -1,4 +1,4 @@
-apiRules:
+apiRules:
 - exclude:
       uidRegex: ^System\.Object
-      type: Type
+      type: Type

.docfx/includes/availability-modern.md

@@ -1 +1 @@
-Availability: .NET 10 and .NET 9
+Availability: .NET 10 and .NET 11

.docfx/nginx.conf

@@ -18,6 +18,8 @@ server {
     # cached permanently because changed content is published under a different URL.
     location ~ "^/public/.+-[A-Z0-9]{8}(?:-[A-Z0-9]{8})?(?:\.min)?\.(?:(?:css|js)(?:\.map)?|woff2?)$" {
         try_files $uri =404;
+        # Range errors are generated after headers are set, so serve complete assets.
+        max_ranges 0;
         add_header Cache-Control $fingerprinted_asset_cache_control always;
         add_header Vary "Accept-Encoding" always;
     }

.docfx/templates/shared-kernel/layout/_master.tmpl

@@ -137,4 +137,4 @@
     <script async src="https://context7.com/widget.js" data-library="/codebeltnet/shared-kernel"></script>
   </body>
   {{/redirect_url}}
-</html>
+</html>

.docfx/templates/shared-kernel/partials/namespace.tmpl.partial

@@ -11,4 +11,4 @@
     <h4><xref uid="{{uid}}" altProperty="fullName" displayProperty="name"/></h4>
     <section>{{{summary}}}</section>
   {{/children}}
-{{/children}}
+{{/children}}

.docfx/templates/shared-kernel/public/main.js

@@ -6,4 +6,4 @@ export default {
         title: 'GitHub'
       }
     ]
-  }
+  }

.editorconfig

@@ -37,7 +37,7 @@ dotnet_diagnostic.IDE0063.severity = none
 dotnet_diagnostic.IDE0071.severity = none
 
 # S3267: Loops should be simplified with "LINQ" expressions
-# https://rules.sonarsource.com/csharp/RSPEC-3267
+# https://sonarcloud.io/organizations/sonarcloud/rules?open=csharpsquid:S3267&rule_key=csharpsquid:S3267
 dotnet_diagnostic.S3267.severity = none
 
 # CA1859: Use concrete types when possible for improved performance
@@ -57,9 +57,10 @@ indent_size = 4
 
 # IDE0161: Namespace declaration preferences
 # https://learn.microsoft.com/en-us/dotnet/fundamentals/code-analysis/style-rules/ide0161
-# Prefer file-scoped namespaces for new files; existing block-scoped files should not be converted unless explicitly asked
+# File-scoped namespaces are mandatory for new and existing C# files.
 [*.cs]
-csharp_style_namespace_declarations = file_scoped:suggestion
+csharp_style_namespace_declarations = file_scoped:error
+dotnet_diagnostic.IDE0161.severity = error
 
 # Top-level statements: DO NOT USE
 # https://learn.microsoft.com/en-us/dotnet/fundamentals/code-analysis/style-rules/ide0210-ide0211

.gitattributes

@@ -1,7 +1,7 @@
 ###############################################################################
 # Set default behavior to automatically normalize line endings.
 ###############################################################################
-* text=auto
+* text=auto eol=lf
 
 ###############################################################################
 # Set default behavior for command prompt diff.
@@ -17,7 +17,7 @@
 #
 # Merging from the command prompt will add diff markers to the files if there
 # are conflicts (Merging from VS is not affected by the settings below, in VS
-# the diff markers are never inserted). Diff markers may cause the following 
+# the diff markers are never inserted). Diff markers may cause the following
 # file extensions to fail to load in VS. An alternative would be to treat
 # these files as binary and thus will always conflict and require user
 # intervention with every merge. To do so, just uncomment the entries below
@@ -46,9 +46,9 @@
 
 ###############################################################################
 # diff behavior for common document formats
-# 
+#
 # Convert binary document formats to text before diffing them. This feature
-# is only available from the command line. Turn it on by uncommenting the 
+# is only available from the command line. Turn it on by uncommenting the
 # entries below.
 ###############################################################################
 #*.doc   diff=astextplain

.github/CODE_OF_CONDUCT.md

@@ -1,4 +1,4 @@
-# Contributor Covenant Code of Conduct
+# Contributor Covenant Code of Conduct
 
 This document is adapted from the Contributor Covenant which is used by many open source projects,
 including those under the [.NET Foundation](https://dotnetfoundation.org/code-of-conduct).
@@ -132,4 +132,4 @@ at [https://www.contributor-covenant.org/translations][translations].
 [v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
 [Mozilla CoC]: https://github.com/mozilla/diversity
 [FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations
+[translations]: https://www.contributor-covenant.org/translations

.github/CONTRIBUTING.md

@@ -5,7 +5,7 @@ This repository is part of the Codebelt .NET library estate. The instructions be
 ## Before you start
 
 - Read the repository `README.md` and open an issue before starting a non-trivial feature or behavioral change.
-- Use an installed .NET SDK that can build the target frameworks listed below. This repository currently targets: **net10.0, net9.0**.
+- Use an installed .NET SDK that can build the target frameworks listed below. This repository currently targets: **net10.0, net11.0**.
 - The solution is `Codebelt.SharedKernel.slnx`. Central package versions are maintained in `Directory.Packages.props`.
 - The shared build behavior is in `Directory.Build.props` and `Directory.Build.targets`; repository-specific TFMs, package references and metadata remain local to this library.
 
@@ -43,8 +43,9 @@ The CI test plan currently runs **1** project(s) and excludes **0** project(s).
 
 ## Integration and infrastructure
 
-- `WSL-Ubuntu` — WSL distribution `Ubuntu-24.04`.
-- `Docker-Ubuntu` — Docker image `codebeltnet/ubuntu-testrunner:8-9-10-11`.
+- `WSL-Ubuntu` — WSL distribution `Ubuntu-26.04`.
+- `Docker-Ubuntu (net10.0)` — Docker image `codebeltnet/ubuntu-testrunner:10`.
+- `Docker-Ubuntu (net11.0)` — Docker image `codebeltnet/ubuntu-testrunner:11`.
 
 This repository has no repository-local `docker-compose.yml` service dependency in the current checkout.
 Use the environments declared in `testenvironments.json` when you need the estate test runner.

.github/codecov.yml

@@ -1,2 +1,2 @@
 ignore:
-  - "test"
+  - "test"

.github/workflows/ci-pipeline.yml

@@ -23,7 +23,7 @@ permissions:
 jobs:
   init:
     name: initialize
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-26.04
     outputs:
       run-mac-tests: ${{ steps.vars.outputs.run-mac-tests }}
       run-privileged-jobs: ${{ steps.vars.outputs.run-privileged-jobs }}
@@ -60,9 +60,10 @@ jobs:
     uses: codebeltnet/jobs-dotnet-build/.github/workflows/default.yml@v3
     with:
       configuration: ${{ matrix.configuration }}
+      include-preview: true
       strong-name-key-filename: ${{ needs.init.outputs.strong-name-key-filename }}
       build-switches: ${{ needs.init.outputs.build-switches }}
-      runs-on: ${{ matrix.arch == 'ARM64' && 'ubuntu-24.04-arm' || 'ubuntu-24.04' }}
+      runs-on: ${{ matrix.arch == 'ARM64' && 'ubuntu-26.04-arm' || 'ubuntu-26.04' }}
       upload-build-artifact-name: build-${{ matrix.configuration }}-${{ matrix.arch }}
     secrets: inherit
 
@@ -75,6 +76,7 @@ jobs:
     uses: codebeltnet/jobs-dotnet-pack/.github/workflows/default.yml@v3
     with:
       configuration: ${{ matrix.configuration }}
+      include-preview: true
       version: ${{ needs.build.outputs.version }}
       download-build-artifact-pattern: build-${{ matrix.configuration }}-X64
 
@@ -88,8 +90,9 @@ jobs:
         configuration: [Debug, Release]
     uses: codebeltnet/jobs-dotnet-test/.github/workflows/default.yml@v3
     with:
-      runs-on: ${{ matrix.arch == 'ARM64' && 'ubuntu-24.04-arm' || 'ubuntu-24.04' }}
+      runs-on: ${{ matrix.arch == 'ARM64' && 'ubuntu-26.04-arm' || 'ubuntu-26.04' }}
       configuration: ${{ matrix.configuration }}
+      include-preview: true
       build-switches: -p:SkipSignAssembly=true
       restore: true
       build: true # required for xunitv3
@@ -107,6 +110,7 @@ jobs:
     with:
       runs-on: ${{ matrix.arch == 'ARM64' && 'windows-11-arm' || 'windows-2025' }}
       configuration: ${{ matrix.configuration }}
+      include-preview: true
       build-switches: -p:SkipSignAssembly=true
       restore: true
       build: true # required for xunitv3
@@ -125,6 +129,7 @@ jobs:
     with:
       runs-on: ${{ matrix.arch == 'ARM64' && 'macos-26' || 'macos-26-intel' }}
       configuration: ${{ matrix.configuration }}
+      include-preview: true
       build-switches: -p:SkipSignAssembly=true
       restore: true
       build: true # required for xunitv3
@@ -134,7 +139,7 @@ jobs:
     if: ${{ always() }}
     name: test-qualitygate
     needs: [init, test_linux, test_windows, test_mac]
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-26.04
     steps:
       - name: Evaluate test results
         shell: bash
@@ -180,6 +185,7 @@ jobs:
     needs: [init, build, test_qualitygate]
     uses: codebeltnet/jobs-sonarcloud/.github/workflows/default.yml@v3
     with:
+      include-preview: true
       organization: geekle
       projectKey: sharedkernel
       version: ${{ needs.build.outputs.version }}
@@ -193,12 +199,14 @@ jobs:
     with:
       repository: codebeltnet/shared-kernel
     secrets: inherit
-          
+
   codeql:
     if: ${{always() && needs.init.outputs.run-privileged-jobs == 'true' && needs.build.result == 'success' && needs.test_qualitygate.result == 'success'}}
     name: call-codeql
     needs: [init, build, test_qualitygate]
     uses: codebeltnet/jobs-codeql/.github/workflows/default.yml@v3
+    with:
+      include-preview: true
     permissions:
       security-events: write