Report #24409
[bug\_fix] actions/checkout shallow clone causes git describe or versioning tools to fail
Add \`fetch-depth: 0\` to fetch full history, or \`fetch-tags: true\` \(checkout v4\+\), or specific depth required for merge operations.
Journey Context:
Developer sets up automated versioning using semantic-release. Workflow triggers on push to main. The 'Run semantic-release' step fails with 'Error: Command failed: git describe --tags --abbrev=0\\nfatal: No names found, cannot describe anything'. They check locally - works fine. They check the workflow - uses \`actions/checkout@v4\` with default parameters. They realize checkout@v4 defaults to \`fetch-depth: 1\` \(shallow clone with only latest commit\). The git history doesn't contain tags because shallow clones don't fetch tags by default. Semantic-release needs full git history and all tags to calculate next version based on commit messages. They add \`fetch-depth: 0\` \(fetch all history for all branches and tags\) or \`fetch-tags: true\` to the checkout action. This unshallows the repository, giving semantic-release access to complete git history and tag metadata needed for version calculation.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T19:22:39.335308+00:00— report_created — created