mr-version/Complete Version Release
Complete release workflow for monorepo projects using Mister.Version - calculates versions, creates tags, and generates reports
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Nov 20, 2025
- License
- MIT
Pinned Snippet
uses: mr-version/release@39a36c26f43ba0ab17ca4844498318a6fe208924 # v1tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| repository-path | Path to the Git repository root | no | . |
| projects | Glob pattern or comma-separated list of project files to process | no | **/*.csproj |
| prerelease-type | Type of prerelease (alpha, beta, rc, none) | no | none |
| tag-prefix | Prefix for version tags | no | v |
| force-version | Force a specific version for all projects | no | — |
| create-tags | Create git tags for the calculated versions | no | true |
| create-global-tags | Create global tags for major releases | no | false |
| global-tag-strategy | Strategy for global tags (major-only, all, none) | no | major-only |
| tag-message-template | Template for tag messages (use {version}, {project}, {type} placeholders) | no | Release {type} {version} |
| sign-tags | Sign tags with GPG (requires git config user.signingkey) | no | false |
| generate-report | Generate a version report | no | true |
| report-format | Report output format (text, json, csv, markdown) | no | markdown |
| report-file | File path to save the report | no | — |
| post-report-to-pr | Post the report as a PR comment (requires pull_request event) | no | false |
| include-test-projects | Include test projects in processing | no | false |
| include-non-packable | Include non-packable projects in processing | no | false |
| only-changed | Only process projects with version changes | no | true |
| dry-run | Show what would be done without making changes | no | false |
| fail-on-no-changes | Fail if no version changes are detected | no | false |
| fail-on-existing-tags | Fail if a tag already exists | no | false |
| token | GitHub token for PR comments and API access | no | ${{ github.token }} |
Outputs
| name | description |
|---|---|
| projects | JSON array of all analyzed projects with their versions |
| changed-projects | JSON array of projects with version changes |
| has-changes | Whether any version changes were detected |
| has-validation-errors | Whether any projects have validation errors |
| has-validation-warnings | Whether any projects have validation warnings |
| validation-errors-count | Number of projects with validation errors |
| validation-warnings-count | Number of projects with validation warnings |
| tags-created | JSON array of tags that were created |
| tags-count | Total number of tags created |
| report-content | The generated report content |
| report-file | Path to the generated report file |