Skip to content

V10.2.5/service update - #41

Merged
gimlichael merged 9 commits into
mainfrom
v10.2.5/service-update
Oct 18, 2026
Merged

gimlichael merged 9 commits into
mainfrom
v10.2.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.2.5
  • CHANGELOG.md entry added for v10.2.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: yamldotnet @ 10.1.9

@greptile-apps

greptile-apps Bot commented Oct 17, 2026 •

Copy link
Copy Markdown

RetriggerView in GreptileConfidence Score: 4/5

[Medium impact] The changes reach library builds, test projects, the public documentation site, and repository release work.

Fix the version check before merging so dependency updates can run before a release is tagged.

Fix All in CodexFindings

  1. P1 Updates stop before tagging ▶
  2. P2 Release notes repeat a version ▶
Fix with agent prompt
### Issue 1
.github/workflows/service-update.yml:86-98
The new version check rejects a dated release that has not been tagged yet. After this PR merges, `CHANGELOG.md` will start at dated version `10.2.5`. If `v10.2.5` has not been created, the latest tag remains `v10.2.4`. Neither accepted condition matches, so service-update runs stop before updating packages. Allow this between-release state instead of failing the workflow.

### Issue 2
.github/workflows/service-update.yml:86-88
If `CHANGELOG.md` starts with the next version marked `TBD` and `PackageReleaseNotes.txt` already contains that version's planned changes, the new reuse path selects the same version. The later step then prepends another `Version:` block without checking for an existing one. Package users get two sections for the same release, separating the planned changes from the dependency-update note. Update the existing block when reusing a release.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

This service update upgrades dependencies, changes documentation hosting, and consolidates agent guidance.

  • Test projects and package builds use updated dependencies.
  • The documentation site publishes separate API pages and serves assets with different caching rules.
  • The service-update workflow chooses patch versions from stable Git tags.
  • Test, benchmark, and XML documentation guidance now lives in AGENTS.md.

Reviews (3) · Last reviewed commit: "🩹 scope immutable cache header to succe..." · Reviewed by Greptile

Replaces the test coverage package with Codebelt.Coverlet.MTP, adds the hang dump extension for diagnosing stuck test runs, and moves the xUnit, test SDK and related packages to their latest stable releases.
The DocFX image now builds from the nginx base and serves the generated site with a repository-specific nginx configuration on port 8080. Fingerprinted DocFX assets are cached permanently, while pages and navigation data are revalidated on every request so a new deployment never shows stale content.
Enables the sitemap with the production base URL, renders API members on separate pages, and adds the ms-style template so the published reference matches the expected layout.
The Copilot instructions duplicated and drifted from AGENTS.md, so the test, benchmark, and XML documentation guidance now lives in AGENTS.md as path-scoped sections. The bot folder notes point only at AGENTS.md.
Records the 10.2.5 patch release with its dependency updates, documentation hosting changes, and consolidated agent guidance, and adds the compare link for the release.
Comment thread .docfx/nginx.conf Outdated
Comment thread .docfx/docfx.json Outdated
@github-advanced-security

Copy link
Copy Markdown

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

  • The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
  • Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
  • You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out the documentation.

The workflow derived the next version by scraping CHANGELOG.md, so the branch name and changelog entry could drift from the tags that were actually released. Deriving the version from the latest stable vMAJOR.MINOR.PATCH tag and validating it against the changelog heading keeps branch, changelog, and tag history aligned, and fetching tags makes them available on the runner.
The sitemap pointed at an asp-versioning subdomain that never served the published documentation, so every generated sitemap URL was wrong. Aligning the baseUrl with the canonical versioning.codebelt.net host that the README and package docs already reference makes the sitemap match the live site.
Removing the always flag keeps the one-year immutable Cache-Control directive off error responses, so clients and proxies no longer cache negative results for a year while successful asset responses keep the directive.
Comment on lines +86 to +98
if current_version == next_version and current_status.upper() == "TBD":
# Reuse an already pending next release, such as [5.0.13] - TBD.
new_version = next_version
elif current_version == latest_version and current_status.upper() != "TBD":
# The changelog is at the latest released tag; start the next patch release.
new_version = next_version
else:
print(
f"::error::CHANGELOG.md starts at {current_version} ({current_status}), "
f"but the latest stable Git tag is {latest_tag}. Expected either "
f"[{latest_version}] with a release date or [{next_version}] - TBD."
)
sys.exit(1)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Updates stop before tagging

The new version check rejects a dated release that has not been tagged yet. After this PR merges, CHANGELOG.md will start at dated version 10.2.5. If v10.2.5 has not been created, the latest tag remains v10.2.4. Neither accepted condition matches, so service-update runs stop before updating packages. Allow this between-release state instead of failing the workflow.

Prompt To Fix With AI
This is a comment left during a code review.
Path: .github/workflows/service-update.yml
Line: 86-98

Comment:
**Updates stop before tagging**

The new version check rejects a dated release that has not been tagged yet. After this PR merges, `CHANGELOG.md` will start at dated version `10.2.5`. If `v10.2.5` has not been created, the latest tag remains `v10.2.4`. Neither accepted condition matches, so service-update runs stop before updating packages. Allow this between-release state instead of failing the workflow.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Fix in Codex

Comment on lines +86 to +88
if current_version == next_version and current_status.upper() == "TBD":
# Reuse an already pending next release, such as [5.0.13] - TBD.
new_version = next_version

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 Release notes repeat a version

If CHANGELOG.md starts with the next version marked TBD and PackageReleaseNotes.txt already contains that version's planned changes, the new reuse path selects the same version. The later step then prepends another Version: block without checking for an existing one. Package users get two sections for the same release, separating the planned changes from the dependency-update note. Update the existing block when reusing a release.

Prompt To Fix With AI
This is a comment left during a code review.
Path: .github/workflows/service-update.yml
Line: 86-88

Comment:
**Release notes repeat a version**

If `CHANGELOG.md` starts with the next version marked `TBD` and `PackageReleaseNotes.txt` already contains that version's planned changes, the new reuse path selects the same version. The later step then prepends another `Version:` block without checking for an existing one. Package users get two sections for the same release, separating the planned changes from the dependency-update note. Update the existing block when reusing a release.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Fix in Codex

@sonarqubecloud

Copy link
Copy Markdown

@gimlichael
gimlichael merged commit 604db11 into main Oct 18, 2026
24 checks passed
@gimlichael
gimlichael deleted the v10.2.5/service-update branch October 18, 2026 14:01
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.

3 participants