V0.5.9/service update

[codebelt-aicia]

This is a service update that focuses on package dependencies.

Automated changes:

• Codebelt/Cuemon package versions bumped to latest compatible
• PackageReleaseNotes.txt updated for v0.5.9
• CHANGELOG.md entry added for v0.5.9

Note: Third-party packages (Microsoft.Extensions.*, BenchmarkDotNet, etc.) are not auto-updated.
Use Dependabot or manual updates for those.

Generated by codebelt-aicia
Triggered by: savvyio @ 5.0.9

[greptile-apps]

Greptile Summary

This service-update PR bumps Codebelt/Savvyio package versions to their latest compatible releases, adds the full set of DocFX API documentation files (namespace overviews and per-type example pages) for Codebelt.SharedKernel and Codebelt.SharedKernel.Security, and hardens the CI deploy-job condition so skipped optional matrix runs no longer suppress deployment.

• Package updates (Directory.Packages.props): patch/minor bumps to Cuemon.Extensions.IO, Codebelt.Extensions.Xunit.App, Microsoft.NET.Test.Sdk, and the three Savvyio.* packages; MinVer, coverlet.*, and xunit.v3 are unchanged.
• DocFX additions (docfx.json + api/namespaces/ + api/types/): twelve new Markdown overwrite files covering all public types; docfx.json is reconfigured to keep namespace/type overwrites out of the conceptual-content pipeline per the updated AGENTS.md guidance.
• CI fix (.github/workflows/ci-pipeline.yml): deploy condition changed to always() && … == 'success' guards so that a skipped optional macOS matrix job no longer causes the deploy job to be silently suppressed.

Confidence Score: 5/5

Safe to merge — all changes are additive documentation, routine dependency bumps, and a CI condition fix with no runtime code modified.

No production code was changed. The dependency bumps are all patch or minor increments within the same major version, the CI condition change correctly guards deployment behind explicit success checks on every required job, and the DocFX additions are documentation-only. The two findings are in example code comments inside Markdown files and do not affect any deployed artifact.

.docfx/api/types/Codebelt.SharedKernel.ClockSkew.md — the sample clock-skew comparison has a sign issue worth fixing before developers copy it.

Important Files Changed

Filename	Overview
.docfx/Dockerfile.docfx	nginx base image bumped from 1.31.0-alpine to 1.31.2-alpine; no other changes.
Directory.Packages.props	Patch/minor bumps: Cuemon.Extensions.IO 10.5.3→10.5.4, Codebelt.Extensions.Xunit.App 11.1.0→11.1.1, Microsoft.NET.Test.Sdk 18.6.0→18.7.0, Savvyio.* 5.0.8→5.0.9; routine version increments.
.github/workflows/ci-pipeline.yml	Deploy job condition tightened: adds always() plus explicit == 'success' guards on all dependencies to prevent skipped optional matrix jobs from suppressing deployment.
.docfx/docfx.json	Separates namespace/type overwrite files from conceptual content: removes api/**/*.md from build.content, adds exclusions for new subdirectories, and registers both api/namespaces/**/*.md and api/types/**/*.md in build.overwrite.
.docfx/api/types/Codebelt.SharedKernel.ClockSkew.md	New type example page; the sample clock-skew comparison uses a signed subtraction without taking the absolute value, causing the tolerance check to always pass when the verifier's clock is behind the issuer's clock.
.docfx/api/types/Codebelt.SharedKernel.Token.md	New type example page; contains a comment that states the default options "reject unguessable candidates," which has the logic inverted — the rules reject low-entropy (guessable) tokens.
AGENTS.md	Adds comprehensive DocFX documentation maintenance section with requirements for namespace/type overwrite files, example code standards, and verification steps.
CHANGELOG.md	Adds v0.5.9 entry and comparison link; new entry is dated 2026-07-02 (one day ahead of today).
.nuget/Codebelt.SharedKernel/PackageReleaseNotes.txt	Prepends v0.5.9 release notes block noting dependency upgrades.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A([push / workflow_dispatch]) --> B[build]
    A --> C[pack]
    A --> D[test_qualitygate]
    A --> E[sonarcloud]
    A --> F[codecov]
    A --> G[codeql]

    B & C & D & E & F & G --> H{deploy condition}

    H -->|"always() &&\nevent != pull_request &&\nall needs == 'success'"| I[call-nuget-push]
    H -->|any need != 'success'\nor event == pull_request| J([skip deploy])

    style I fill:#2d7d46,color:#fff
    style J fill:#666,color:#fff

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A([push / workflow_dispatch]) --> B[build]
    A --> C[pack]
    A --> D[test_qualitygate]
    A --> E[sonarcloud]
    A --> F[codecov]
    A --> G[codeql]

    B & C & D & E & F & G --> H{deploy condition}

    H -->|"always() &&\nevent != pull_request &&\nall needs == 'success'"| I[call-nuget-push]
    H -->|any need != 'success'\nor event == pull_request| J([skip deploy])

    style I fill:#2d7d46,color:#fff
    style J fill:#666,color:#fff

Loading

_{Reviews (2): Last reviewed commit: "📝 update changelog for 0.5.9 release wi..." | Re-trigger Greptile}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.50%. Comparing base (0e6d8a2) to head (80f70dd).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #29   +/-   ##
=======================================
  Coverage   99.50%   99.50%           
=======================================
  Files          11       11           
  Lines         200      200           
  Branches        8        8           
=======================================
  Hits          199      199           
  Partials        1        1           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.