athackst/ci
athackst/ci
Documentation
Documentation
Actions
Changelog Jekyll Config List Repos Mkdocs Config Pr Labeler Release Draft Resolve Config Setup Labels Version Resolver
Copier
Ci Update Pr Automerge Pr Bump Pr Labeler Release Draft Setup Labels Site
Workflows
Automerge Bump Ci Updater Deploy Site Htmlproofer Site Jekyll Site Labeler Mkdocs Site Release Drafter
Workflow Status

Version Resolver

Resolve the changelog base ref and next semantic version from merged pull request labels.

Usage

- name: Resolve version metadata
  id: version
  uses: athackst/ci/actions/version-resolver@main
  with:
    gh-token: $

Inputs

Name Description Default
configuration-path (optional) Path to the version resolver config. Bundled versions.yml
repo (optional) Repository in owner/repo format used for pull request lookup. $
gh-token (optional) GitHub token used for API lookup. $
pr-info-path (optional) Output file path for resolver PR info JSON data. $/version-resolver-pr-info.json

Outputs

Name Description
from-ref Resolved changelog base reference.
latest-semver-tag Latest reachable semantic version tag detected by the resolver, if any.
resolved-version Resolved semantic version.
major-version Resolved major version component.
minor-version Resolved minor version component.
patch-version Resolved patch version component.
pr-info-path Path to the resolver PR info JSON data file.

Permissions

  • Requires a token that can read repository contents and pull request metadata. contents: read and pull-requests: read are typically sufficient.

Advanced

  • Checks the origin remote for missing tags and shallow history, then fetches tags/history before resolving the version when needed.
  • Uses the latest reachable vX.Y.Z or X.Y.Z tag as from-ref; if no semantic version tag exists, it falls back to the repository’s first commit.
  • Emits resolver diagnostics in logs and outputs (latest-semver-tag) so callers can verify tag detection behavior.
  • Pull request discovery combines GraphQL search results with paginated closed pull request listing, so temporary GitHub search gaps do not silently drop merged PRs.
  • Any configured major label wins over minor, and any configured minor label wins over patch.
  • If no merged PR labels match configured major or minor labels, the version defaults to a patch bump.
  • The action writes the full resolver JSON file to pr-info-path; actions/changelog reads the pr_info.pull_requests section from that payload.

Examples

Use a repository-specific version config:

- name: Resolve version metadata
  id: version
  uses: athackst/ci/actions/version-resolver@main
  with:
    configuration-path: .github/versions.yml
    gh-token: $
Edit this page

In this article