Skip to content

V10.1.5/service update - #33

Merged
gimlichael merged 6 commits into
mainfrom
v10.1.5/service-update
Jun 30, 2026
Merged

V10.1.5/service update#33
gimlichael merged 6 commits into
mainfrom
v10.1.5/service-update

Conversation

@codebelt-aicia

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 v10.1.5
  • CHANGELOG.md entry added for v10.1.5

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: xunit @ 11.1.1

@greptile-apps

greptile-apps Bot commented Jun 25, 2026

Copy link
Copy Markdown

Greptile Summary

This is a routine service-update PR that bumps Codebelt/Cuemon package dependencies to their latest compatible versions, adds comprehensive DocFX API documentation and overwrite files for all public namespaces and types, and improves CI/CD robustness.

  • Package versions: Codebelt.Extensions.Xunit → 11.1.1, Cuemon.* → 10.5.4, Microsoft.NET.Test.Sdk → 18.7.0, YamlDotNet → 18.1.0; all bumps are consistent between Directory.Packages.props and CHANGELOG.md.
  • CI deploy fix: The deploy job condition was extended with always() and explicit result == 'success' checks for every dependency, preventing skipped optional jobs (macOS matrix) from auto-suppressing deployment on push events.
  • DocFX restructure: docfx.json now routes namespace and type overwrite Markdown through dedicated api/namespaces/ and api/types/ subdirectories, matching the new AGENTS.md documentation-maintenance policy.

Confidence Score: 5/5

Safe to merge — changes are dependency bumps, documentation additions, and a CI condition tightening with no functional code changes.

All code changes are in configuration, documentation, and CI/CD. Package bumps are patch/minor increments within the same major version, consistent between Directory.Packages.props and CHANGELOG. The deploy condition rewrite is additive and conservative — it can only prevent a deploy that should not have run, never allow one that should not.

No files require special attention.

Important Files Changed

Filename Overview
Directory.Packages.props Central package version bumps: Codebelt.Extensions.Xunit → 11.1.1, Cuemon.* family → 10.5.4, Microsoft.NET.Test.Sdk → 18.7.0, YamlDotNet → 18.1.0; all in-lock with CHANGELOG.
CHANGELOG.md Adds v10.1.5 entry (dated 2026-07-01) and the previously missing [10.1.4] compare link; all bumped package versions are consistent with Directory.Packages.props.
.github/workflows/ci-pipeline.yml Deploy condition enhanced with always() and explicit per-job result checks to prevent skipped optional jobs (e.g. macOS matrix) from auto-suppressing deployment; logic is correct and guards all required jobs.
.docfx/docfx.json Splits overwrite globs into api/namespaces//*.md and api/types//*.md, and excludes both directories from build.content to prevent overwrite Markdown being treated as conceptual content — aligns with AGENTS.md policy.
AGENTS.md Replaces the brief 'Official Documentation' section with a detailed dotnet-docfx-digest block covering per-type example requirements, docfx.json structure rules, compilation verification, and completion gates for automated agents.
.docfx/Dockerfile.docfx nginx base image bumped from 1.31.0-alpine to 1.31.2-alpine for the docs site.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A([push / workflow_dispatch]) --> B[build]
    A --> C[pack]
    B --> D[test_linux]
    B --> E[test_windows]
    B --> F{run-mac-tests?}
    F -- true --> G[test_mac]
    F -- false --> H([skipped])
    D & E & G & H --> I["test_qualitygate\n(always())"]
    I --> J["sonarcloud\n(run-privileged-jobs)"]
    I --> K["codecov\n(run-privileged-jobs)"]
    I --> L["codeql\n(run-privileged-jobs)"]
    B & C & I & J & K & L --> M{"deploy condition\nalways() &&\nevent != PR &&\nall == success"}
    M -- all success --> N[NuGet push]
    M -- any skipped/failed --> O([no deploy])
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]
    B --> D[test_linux]
    B --> E[test_windows]
    B --> F{run-mac-tests?}
    F -- true --> G[test_mac]
    F -- false --> H([skipped])
    D & E & G & H --> I["test_qualitygate\n(always())"]
    I --> J["sonarcloud\n(run-privileged-jobs)"]
    I --> K["codecov\n(run-privileged-jobs)"]
    I --> L["codeql\n(run-privileged-jobs)"]
    B & C & I & J & K & L --> M{"deploy condition\nalways() &&\nevent != PR &&\nall == success"}
    M -- all success --> N[NuGet push]
    M -- any skipped/failed --> O([no deploy])
Loading

Reviews (3): Last reviewed commit: "📝 update changelog for 10.1.5 patch rel..." | Re-trigger Greptile

Comment thread Directory.Packages.props
<PackageVersion Include="xunit.v3.runner.console" Version="3.2.2" />
<PackageVersion Include="xunit.runner.visualstudio" Version="3.1.5" />
</ItemGroup>
</Project>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Missing trailing newline at end of file — the diff shows No newline at end of file on the closing </Project> tag. Many editors and POSIX-compliant tools expect files to end with a newline; its absence can generate noisy diffs or warnings in CI toolchains. Adding a single trailing newline would fix this.

Prompt To Fix With AI
This is a comment left during a code review.
Path: Directory.Packages.props
Line: 26

Comment:
**Missing trailing newline at end of file** — the diff shows `No newline at end of file` on the closing `</Project>` tag. Many editors and POSIX-compliant tools expect files to end with a newline; its absence can generate noisy diffs or warnings in CI toolchains. Adding a single trailing newline would fix this.

How can I resolve this? If you propose a fix, please make it concise.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Completes DocFX API documentation for all public types and namespaces in YamlDotNet extension libraries. Includes type-level examples, namespace overviews, and documentation infrastructure updates.
Expands agent guidance with DocFX documentation maintenance requirements, including namespace pages, type examples, availability notes, compilation verification, and repository-aligned validation procedures.
Updates Microsoft.NET.Test.Sdk to 18.7.0 and YamlDotNet to 18.1.0 to maintain compatibility with latest stable releases and improve testing capabilities.
Updates deploy job condition to prevent skipped optional jobs (such as disabled macOS matrix runs) from suppressing deployment. Adds explicit success checks for all prerequisite build, pack, test, quality, and security jobs.
@codecov

codecov Bot commented Jun 30, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.10%. Comparing base (c000635) to head (aaaf705).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #33   +/-   ##
=======================================
  Coverage   97.10%   97.10%           
=======================================
  Files          18       18           
  Lines         621      621           
  Branches       57       57           
=======================================
  Hits          603      603           
  Misses         18       18           

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

@gimlichael
gimlichael merged commit 9abf797 into main Jun 30, 2026
24 checks passed
@gimlichael
gimlichael deleted the v10.1.5/service-update branch June 30, 2026 22:45
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