Automatically add AB# tag from id in source branch

[davetevans]

Loving the latest enhancements by the way, thanks!

I have another feature request that would really help automation and reduce developer toil.
Can you add a new option that attempts to automatically add the AB# link to the PR body/title by scanning the head branch name for a work item id

e.g.
I create a PR to merge branch task/12345/make-it-better into main
AB#12345 is added to the PR body

I guess there will be other variations of branch name that contain the work item id
task/12345/make-it-better
task/12345-make-it-better
task/12345
task-12345
12345-make-it-better
12345make-it-better
12345

[joshjohanning]

Thanks for the feature request @davetevans! 🎉

I've implemented this as a new add-work-item-from-branch input. When enabled, the action extracts work item IDs from the head branch name and automatically adds AB#<id> to the PR body if it's not already present.

Supported branch formats

All of your examples are supported -- the action looks for digit sequences preceded by the start of the branch name or a separator (/, -, _):

Branch name	Extracted
task/12345/make-it-better	AB#12345
task/12345-make-it-better	AB#12345
task/12345	AB#12345
task-12345	AB#12345
12345-make-it-better	AB#12345
12345make-it-better	AB#12345
12345	AB#12345

It also handles multiple IDs in a single branch name (e.g. fix/12345/67890 adds both AB#12345 and AB#67890), and skips any IDs already referenced in the PR body.

Usage

- uses: joshjohanning/azdo_commit_message_validator@v2
  with:
    add-work-item-from-branch: true
    check-pull-request: true
    check-commits: true
    fail-if-missing-workitem-commit-link: true
    link-commits-to-pull-request: true
    azure-devops-organization: my-azdo-org
    azure-devops-token: ${{ secrets.AZURE_DEVOPS_PAT }}

The branch extraction runs before the commit/PR validation checks, so the newly added tags will satisfy subsequent check-pull-request validation.

This is off by default (false) so it's fully opt-in.

Let me know if you have any feedback or if there are other branch naming patterns you'd like supported!

[davetevans]

Perfect, thanks Josh!