Skip to content

Release v0.5.0: version bump and changelogs#407

Open
bburda wants to merge 3 commits into
mainfrom
release/0.5.0
Open

Release v0.5.0: version bump and changelogs#407
bburda wants to merge 3 commits into
mainfrom
release/0.5.0

Conversation

@bburda
Copy link
Copy Markdown
Collaborator

@bburda bburda commented Jun 1, 2026

Summary

Release preparation for v0.5.0:

  • Version bump to 0.5.0 across all 15 packages, the version.hpp fallback constant, docs/conf.py, docs/pyproject.toml, and the version literals in the root / version-info API example responses (via scripts/release.sh bump 0.5.0).
  • Changelogs finalized: the gateway Unreleased and OPC-UA Forthcoming sections are promoted to 0.5.0 (2026-06-01), 0.5.0 entries are added to the remaining packages, and an initial CHANGELOG.rst is added for the new ros2_medkit_sovd_service_interface package (wired into docs/changelog.rst).
  • Bug fix in scripts/release.sh: it pointed at include/ros2_medkit_gateway/version.hpp, but the version constant lives at .../core/version.hpp, so bump silently skipped the kGatewayVersion fallback and verify never validated it. Path corrected; the fallback is now bumped and verified.

The 0.5.0 changelog calls out the breaking changes that already merged this cycle (typed router / HandlerContext API, typed provider ABI, fault-route scoping, plugin API v7 / get_routes(), entity-model shift to Functions, nested x-medkit payload fields).


Issue

Part of #406


Type

  • Bug fix (release.sh version.hpp path)
  • New feature or tests
  • Breaking change
  • Documentation only (changelogs + version)

Testing

  • ./scripts/release.sh verify 0.5.0 → all 15 packages + version.hpp + docs/conf.py + docs/pyproject.toml consistent at 0.5.0.
  • colcon build --packages-up-to ros2_medkit_gateway builds cleanly; info.version reported by /api/v1/docs is 0.5.0.
  • Sphinx docs build of the changelog page is clean (no changelog-related warnings; the only warnings are the pre-existing doxygen-XML/requirements/verification ones that need the doxygen + generation steps CI runs first).

Checklist

  • Breaking changes are clearly described (announced in the gateway/per-package changelogs)
  • Tests were added or updated if needed (no code-logic change; version/changelog only)
  • Docs were updated if behavior or public API changed (changelogs + API example version literals)

bburda added 2 commits June 1, 2026 18:06
bump/verify referenced include/ros2_medkit_gateway/version.hpp, but the
gateway version constant lives at
include/ros2_medkit_gateway/core/version.hpp. As a result bump silently
skipped the kGatewayVersion fallback and verify never validated it.
Correct the path so the fallback constant is bumped and checked.
Bump all 15 packages, the version.hpp fallback, docs/conf.py and
docs/pyproject.toml to 0.5.0, and update the version literals in the
root and version-info API example responses.

Promote the gateway Unreleased and opcua Forthcoming changelog sections
to 0.5.0 (2026-06-01), add 0.5.0 entries to the remaining packages, and
add an initial CHANGELOG for ros2_medkit_sovd_service_interface
(wired into docs/changelog.rst).
Copilot AI review requested due to automatic review settings June 1, 2026 16:08
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Release prep for v0.5.0: bumps version strings across all 15 packages plus docs/script artifacts, promotes the Unreleased/Forthcoming changelog sections to 0.5.0 (2026-06-01), adds new per-package 0.5.0 entries, creates the initial changelog for ros2_medkit_sovd_service_interface, and fixes the release.sh path to the gateway version.hpp (now under core/).

Changes:

  • Version bump to 0.5.0 in all package.xml, core/version.hpp, docs/conf.py, docs/pyproject.toml, and API example responses.
  • Changelog entries finalized for all packages; new CHANGELOG.rst added for ros2_medkit_sovd_service_interface and included in docs/changelog.rst.
  • Bug fix: corrected VERSION_HPP path in scripts/release.sh so the gateway version fallback is actually bumped/verified.

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/ros2_medkit_serialization/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_serialization/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_plugins/ros2_medkit_sovd_service_interface/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_plugins/ros2_medkit_sovd_service_interface/CHANGELOG.rst New initial changelog
src/ros2_medkit_plugins/ros2_medkit_opcua/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_plugins/ros2_medkit_opcua/CHANGELOG.rst Promote Forthcoming → 0.5.0
src/ros2_medkit_plugins/ros2_medkit_graph_provider/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_plugins/ros2_medkit_graph_provider/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_msgs/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_msgs/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_integration_tests/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_integration_tests/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_gateway/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_gateway/include/ros2_medkit_gateway/core/version.hpp Fallback constant → 0.5.0
src/ros2_medkit_gateway/CHANGELOG.rst Promote Unreleased → 0.5.0
src/ros2_medkit_fault_reporter/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_fault_reporter/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_fault_manager/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_fault_manager/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_discovery_plugins/ros2_medkit_topic_beacon/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_discovery_plugins/ros2_medkit_topic_beacon/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_discovery_plugins/ros2_medkit_param_beacon/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_discovery_plugins/ros2_medkit_param_beacon/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_discovery_plugins/ros2_medkit_linux_introspection/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_discovery_plugins/ros2_medkit_linux_introspection/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_discovery_plugins/ros2_medkit_beacon_common/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_discovery_plugins/ros2_medkit_beacon_common/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_diagnostic_bridge/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_diagnostic_bridge/CHANGELOG.rst 0.5.0 entry
src/ros2_medkit_cmake/package.xml Version 0.4.0 → 0.5.0
src/ros2_medkit_cmake/CHANGELOG.rst 0.5.0 entry
scripts/release.sh Fix VERSION_HPP path to core/version.hpp
docs/pyproject.toml Docs project version → 0.5.0
docs/conf.py Sphinx version/release → 0.5.0
docs/changelog.rst Include new sovd_service_interface changelog
docs/api/rest.rst Update version literals in example responses

release.sh now also bumps and verifies docs/Doxyfile PROJECT_NUMBER and the
QUALITY_DECLARATION.md current-version references, which previous releases
missed (Doxyfile was 0.1.0, the quality declaration 0.3.0); both are now
0.5.0 and validated by verify.

Gateway 0.5.0 changelog: add the GET /apps/{id}/belongs-to endpoint, the
pool-backed TopicDataProvider plus /health subscription-executor stats, and
the updates x-medkit.phase field; trim a stray out-of-scope sentence from the
SchemaWriter note.
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