Skip to content

V5.1.2/service update - #33

Merged
gimlichael merged 8 commits into
mainfrom
v5.1.2/service-update
Jul 1, 2026
Merged

V5.1.2/service update#33
gimlichael merged 8 commits into
mainfrom
v5.1.2/service-update

Conversation

@codebelt-aicia

@codebelt-aicia codebelt-aicia Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

This is a service update that focuses on package dependencies.

Automated changes:

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

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: swashbuckle-aspnetcore @ 10.2.3

@greptile-apps

greptile-apps Bot commented Jul 1, 2026

Copy link
Copy Markdown

Greptile Summary

This PR bumps all Codebelt/Cuemon and Microsoft.Extensions package versions to their latest patch releases (e.g. Cuemon 10.5.4, net9/net10 Microsoft packages to 9.0.17/10.0.9), adds a full set of DocFX type-overwrite files with compilable code examples, and tightens the CI deployment gate.

  • Dependency upgrades (Directory.Packages.props): patch bumps across Codebelt, Cuemon, Microsoft.Extensions, and test infrastructure packages for both net9 and net10 TFMs.
  • DocFX documentation (docfx.json + new api/types/** and api/namespaces/** overwrite files): separates overwrite Markdown from conceptual content, adds per-type example files for every public non-abstraction type, and expands namespace overview pages with richer guidance text.
  • CI pipeline (.github/workflows/ci-pipeline.yml): replaces the bare github.event_name != 'pull_request' deploy condition with an explicit always() + needs.<job>.result == 'success' expression, preventing skipped optional matrix entries from inadvertently suppressing deployment while still blocking on any genuine job failure.

Confidence Score: 5/5

Safe to merge — all changes are additive (documentation, version bumps, CI hardening) with no modifications to library source code.

Every changed file is either a patch-level package version bump, new or updated DocFX overwrite documentation, a CHANGELOG/release-notes entry, or a CI condition refactor. None of these touch runtime library code, and the CI change makes job-success checks more explicit without altering the intended deployment gate.

No files require special attention.

Important Files Changed

Filename Overview
Directory.Packages.props Clean patch-level version bumps for Codebelt, Cuemon, Microsoft.Extensions, and test SDK packages across net9 and net10 TFMs.
.github/workflows/ci-pipeline.yml Deploy job condition changed from a bare event-name check to an explicit always()+needs-result expression, making job-success requirements visible and preventing skipped optional matrix entries from suppressing deployment.
.docfx/docfx.json Separates overwrite MD files (namespaces/types) from conceptual content by removing api//*.md from build.content and adding explicit excludes; overwrite section now covers both api/namespaces//.md and api/types/**/.md per AGENTS.md guidance.
CHANGELOG.md Adds 5.1.2 entry with correct date and description; also adds the previously-missing [5.1.1] comparison link and updates [Unreleased] to reference v5.1.2.
AGENTS.md Adds a comprehensive DocFX maintenance block covering type/namespace overwrite requirements, realistic code-example standards, TFM-selection patterns, verification workflow, and completion gates.
.docfx/Dockerfile.docfx Bumps nginx base image from 1.31.0-alpine to 1.31.2-alpine; no other changes.
.nuget/Codebelt.Bootstrapper/PackageReleaseNotes.txt Prepends 5.1.2 release entry noting dependency upgrades; consistent with all other PackageReleaseNotes files in this PR.
.docfx/api/types/Codebelt.Bootstrapper.BootstrapperLifetime.md New type overwrite file with a realistic, compilable example showing BootstrapperLifetime registration and callback subscription.
.docfx/api/types/Codebelt.Bootstrapper.Console.HostApplicationBuilderExtensions.md New type overwrite covering UseBootstrapperProgram and UseMinimalConsoleProgram with three separate compilable examples for class-level, method-level, and combined usage.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Push to branch] --> B{github.event_name\n!= pull_request?}
    B -- No --> Z[Skip deploy]
    B -- Yes --> C[build job]
    C --> D[pack job]
    C --> E[test_qualitygate job]
    C --> F[sonarcloud job]
    C --> G[codecov job]
    C --> H[codeql job]
    D & E & F & G & H --> I{always + all\nneeds == success?}
    I -- Any failure/skip --> Z
    I -- All success --> J[deploy: call-nuget-push]
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 to branch] --> B{github.event_name\n!= pull_request?}
    B -- No --> Z[Skip deploy]
    B -- Yes --> C[build job]
    C --> D[pack job]
    C --> E[test_qualitygate job]
    C --> F[sonarcloud job]
    C --> G[codecov job]
    C --> H[codeql job]
    D & E & F & G & H --> I{always + all\nneeds == success?}
    I -- Any failure/skip --> Z
    I -- All success --> J[deploy: call-nuget-push]
Loading

Reviews (2): Last reviewed commit: "🔧 update changelog for patch release 5...." | Re-trigger Greptile

@codecov

codecov Bot commented Jul 1, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (e563e96) to head (42768f5).

Additional details and impacted files
@@            Coverage Diff            @@
##              main       #33   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           21        21           
  Lines          291       291           
  Branches        23        23           
=========================================
  Hits           291       291           

☔ 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.

aicia-bot and others added 7 commits July 1, 2026 19:20
Upgrade Microsoft.NET.Test.Sdk to 18.7.0 and framework-specific packages (AspNetCore, Extensions) to latest patch versions (9.0.17 and 10.0.9 respectively) to stay on security updates and stability improvements.
Update nginx image to 1.31.2 and reconfigure docfx.json to exclude namespace/type overwrite files from conceptual content while including them in overwrite sources. This separates API documentation infrastructure from auto-generated API YAML.
Generate type-level DocFX overwrite pages for 12 public types: BootstrapperLifetime, BootstrapperLogMessages, extension methods (3 namespaces), hosted services, program factories, and startup factories. Each includes usage examples, availability markers, and parameter guidance.
Update namespace overwrite pages for Codebelt.Bootstrapper, Console, Web, and Worker with entry-point guidance, extension method tables, and key factory/builder references. Provides clear navigation for users choosing among application hosting patterns.
Replace brief API doc guidance with comprehensive DocFX section covering: type/namespace page requirements, realistic usage examples, availability patterns, TFM-selection for conditionally compiled APIs, verification workflows, interim artifact cleanup, skip markers, and completion gates. Provides complete policy for ongoing documentation maintenance.
Change deploy job conditional from simple skip predicate to explicit job-result checks. Using always() + needs.<job>.result == 'success' ensures optional skipped jobs (e.g. disabled macOS matrix) do not suppress deployment, while keeping failures in required jobs from proceeding.
@gimlichael
gimlichael merged commit e8e1e7f into main Jul 1, 2026
24 checks passed
@gimlichael
gimlichael deleted the v5.1.2/service-update branch July 1, 2026 17:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants