Skip to content

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

Merged
yaananth merged 9 commits into
actions:mainfrom
yaananth:sha256/fix-wellknown-regex
May 4, 2026
Merged

fix: expand commit hash regex to support SHA-256 (64-char) hashes#4347
yaananth merged 9 commits into
actions:mainfrom
yaananth:sha256/fix-wellknown-regex

Conversation

@yaananth

@yaananthyaananth commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Fixeshttps://github.com/github/actions-runtime/issues/5475
Fixeshttps://github.com/github/actions-runtime/issues/5483
Fixeshttps://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>
yaananthand 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 ownerApril 28, 2026 17:37
CopilotAI 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>

CopilotAI left a comment

Copy link
Copy Markdown
Contributor

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
FileDescription
src/Sdk/DTPipelines/Pipelines/Expressions/WellKnownRegularExpressions.csAdds CommitHash key and updates the commit-hash regex to allow 40 or 64 hex chars.
src/Runner.Plugins/Repository/v1.0/RepositoryPlugin.csRemoves unused local SHA1 regex field and uses CommitHash key for hash detection.
src/Runner.Plugins/Repository/v1.1/RepositoryPlugin.csUses CommitHash key for hash detection during checkout input handling.
src/Test/L0/Sdk/WellKnownRegularExpressionsL0.csAdds unit tests validating key behavior and 40/64-char matching.

Copilot's findings

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

Comment threadsrc/Runner.Plugins/Repository/v1.1/RepositoryPlugin.cs
Comment threadsrc/Runner.Plugins/Repository/v1.0/RepositoryPlugin.cs
Comment threadsrc/Test/L0/Sdk/WellKnownRegularExpressionsL0.cs Outdated
@yaananth
yaananth merged commit 5ed0c52 into actions:mainMay 4, 2026
26 of 29 checks passed

@gordolara789-techgordolara789-tech left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Exit

Sign up for freeto 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.

5 participants

@yaananth@TingluoHuang@salmanmkc@gordolara789-tech