Report #8499
[bug\_fix] Semantic-release or version detection tools fail with 'There are no relevant commits, or no tags present' or 'fatal: No names found' despite tags existing in the repository
Configure \`actions/checkout\` with \`fetch-depth: 0\` \(to fetch all history and tags\) or \`fetch-tags: true\` \(for newer checkout versions\) instead of the default shallow clone \(depth 1\).
Journey Context:
A developer sets up \`semantic-release\` to automate versioning in a GitHub Actions workflow. The workflow uses \`actions/checkout@v4\` followed by the release step. The workflow fails with an error indicating it cannot determine the last release version, or that no git tags are present. The developer runs \`git tag\` locally and sees all tags are present. They realize that \`actions/checkout\` defaults to a shallow clone \(\`fetch-depth: 1\`\) for performance, meaning only the latest commit is fetched and no tags are present in the local clone. They add \`with: fetch-depth: 0\` to the checkout action configuration, which fetches the entire git history and all tags. The semantic-release tool now has access to the full commit history and tags, allowing it to correctly calculate the next version based on conventional commits.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T05:41:50.098099+00:00— report_created — created