Skip to content

fix: expand commit hash regex to support SHA-256 (64-char) hashes#4347

Open
yaananth wants to merge 8 commits intoactions:mainfrom
yaananth:sha256/fix-wellknown-regex
Open

fix: expand commit hash regex to support SHA-256 (64-char) hashes#4347
yaananth wants to merge 8 commits intoactions:mainfrom
yaananth:sha256/fix-wellknown-regex

Conversation

@yaananth
Copy link
Copy Markdown
Contributor

@yaananth yaananth commented Apr 14, 2026

Fixes https://github.com/github/actions-runtime/issues/5475
Fixes https://github.com/github/actions-runtime/issues/5483
Fixes https://github.com/github/actions-runtime/issues/5484

Summary

Expand runner commit-hash handling to support both SHA-1 (40-char) and SHA-256 (64-char) commit hashes, preparing the runner for Git's SHA-256 transition.

Changes

  • WellKnownRegularExpressions.cs: Update the commit-hash regex from \b[0-9a-f]{40}\b to \b(?:[0-9a-f]{40}|[0-9a-f]{64})\b; add CommitHash as the canonical key while keeping SHA1 as a backward-compatible alias.
  • RepositoryPlugin.cs (v1.0/v1.1): Update repository plugin callers to use WellKnownRegularExpressions.CommitHash instead of the legacy SHA1 key; remove the unused v1.0 _validSha1 field.
  • WellKnownRegularExpressionsL0.cs: Add coverage for 40-char SHA-1, 64-char SHA-256, 63/65-char boundaries, mixed-case matching, alias compatibility, and unknown keys.
  • ConstantGenerationL0.cs: Fold in the former test: update CommitHash length assertion for SHA-256 support #4348 assertion update so generated CommitHash may be either 40-char SHA-1 or 64-char SHA-256 and is hex-only.
  • ActionManagerL0.cs: Add validation for 64-character resolved SHAs in action archive cache and symlink cache paths.

Validation

  • Focused local verification passed:
    • dotnet test src/Test/Test.csproj --filter "FullyQualifiedName~WellKnownRegularExpressionsL0|FullyQualifiedName~ConstantGenerationL0" --no-restore
    • dotnet test src/Test/Test.csproj --filter "FullyQualifiedName~ActionManagerL0" --no-restore --logger "console;verbosity=minimal"
  • CI is green on the latest commit.

PR consolidation

Context


Automated by project-board-agents-plugin via /project-board-agents:lead
Board: https://github.com/orgs/github/projects/24272/views/1
Item: [P0] Fix core SHA-1 regex in actions/runner WellKnownRegularExpressions.cs
Run: sha256-p0-runner-00050

- update WellKnownRegularExpressions to match both 40-char (SHA-1) and 64-char (SHA-256) hex strings
- add CommitHash constant as canonical name while keeping SHA1 for backward compatibility
- remove dead _validSha1 field in RepositoryPlugin v1.0

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
yaananth and others added 2 commits April 16, 2026 15:26
Add dedicated test class covering:
- 40-char SHA-1 match (regression guard)
- 64-char SHA-256 match (new behavior)
- 63/65-char boundary rejection
- Mixed-case matching (IgnoreCase)
- SHA1 and CommitHash keys return same regex instance
- Unknown key returns null

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@yaananth yaananth marked this pull request as ready for review April 28, 2026 17:37
@yaananth yaananth requested a review from a team as a code owner April 28, 2026 17:37
Copilot AI review requested due to automatic review settings April 28, 2026 17:37
Allow CommitHash to be either 40 chars (SHA-1) or 64 chars (SHA-256).
Add hex format validation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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

Updates the runner’s well-known commit-hash regular expression to recognize both SHA-1 (40 hex) and SHA-256 (64 hex) commit IDs, and updates checkout plugins to use a new canonical CommitHash key while preserving the existing SHA1 key for compatibility.

Changes:

  • Add CommitHash well-known regex key and map both SHA1 and CommitHash to the updated commit-hash regex.
  • Expand commit-hash regex from 40-hex to 40-or-64-hex.
  • Update repository checkout plugins (v1.0/v1.1) to use CommitHash, and add L0 tests for the new behavior.
Show a summary per file
File Description
src/Sdk/DTPipelines/Pipelines/Expressions/WellKnownRegularExpressions.cs Adds CommitHash key and updates the commit-hash regex to allow 40 or 64 hex chars.
src/Runner.Plugins/Repository/v1.0/RepositoryPlugin.cs Removes unused local SHA1 regex field and uses CommitHash key for hash detection.
src/Runner.Plugins/Repository/v1.1/RepositoryPlugin.cs Uses CommitHash key for hash detection during checkout input handling.
src/Test/L0/Sdk/WellKnownRegularExpressionsL0.cs Adds unit tests validating key behavior and 40/64-char matching.

Copilot's findings

  • Files reviewed: 5/5 changed files
  • Comments generated: 4

Comment thread src/Runner.Plugins/Repository/v1.1/RepositoryPlugin.cs
Comment thread src/Runner.Plugins/Repository/v1.0/RepositoryPlugin.cs
Comment thread src/Test/L0/Sdk/WellKnownRegularExpressionsL0.cs Outdated
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.

4 participants