From c2e41711923c56c69ebd92ba7f446c5d355b6abb Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 11:34:17 -0600
Subject: [PATCH 01/30] feat: add conventional commit validation workflow

---
 .../reusable-pr-conventional-commit-title.yml | 104 ++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 .github/workflows/reusable-pr-conventional-commit-title.yml

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
new file mode 100644
index 0000000..aff22db
--- /dev/null
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -0,0 +1,104 @@
+on:
+  workflow_call:
+    inputs:
+      task_types:
+        type: string
+        default: '["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
+        description: 'A JSON array of task types that are allowed. Default: ["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
+        required: true
+      scope_types:
+        type: string
+        default: ""
+        description: 'A JSON array of valid scope types. If omitted, any scope is allowed. If given, include the empty scope with "". Example: ["login","signup","checkout","payment", ""]'
+        required: false
+      title_regex:
+        type: string
+        description: 'Regular expression for custom title validation; disabled by default. Example: ''PROJECT-\d{2,5}$'' for trailing issue ticket, ''"^[^:]+: [A-Z]"''  for capitalized title'
+        required: false
+      add_label:
+        type: boolean
+        description: "Whether to add labels to your pull request. Default: true"
+        required: false
+        default: true
+      add_scope_label:
+        type: boolean
+        description: 'Whether to add labels to your pull request. Example: the ''login'' scope will be added for this PR title: "fix(login): fix message in login page". Default: true'
+        required: false
+        default: true
+      custom_labels:
+        type: string
+        description: 'A JSON object mapping task types to custom label names. Example: {"feat": "feature", "fix": "fix", "docs": "documentation", "test": "test", "ci": "CI/CD", "refactor": "refactor", "perf": "performance", "chore": "chore", "revert": "revert", "wip": "WIP"}'
+        required: false
+      comment_on_failure:
+        type: boolean
+        description: "Whether to comment on the pull request if the title validation fails. Default: true"
+        required: false
+        default: true
+
+permissions:
+  pull-requests: write
+  contents: read
+
+jobs:
+  validate-title:
+    name: Validate Pull Request Title
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate inputs
+        run: |
+          node -e "try { const val = JSON.parse(process.argv[1]); if (!Array.isArray(val)) throw new Error('Not an array'); } catch(e) { console.error('Input \'task_types\' is not a valid JSON array.'); process.exit(1); }" "${{ inputs.task_types }}"
+          node -e "try { const val = JSON.parse(process.argv[1]); if (!Array.isArray(val)) throw new Error('Not an array'); } catch(e) { console.error('Input \'scope_types\' is not a valid JSON array.'); process.exit(1); }" "${{ inputs.scope_types }}"
+          node -e "try { new RegExp(process.argv[1]); } catch(e) { console.error('Input \'title_regex\' is not a valid regular expression.'); process.exit(1); }" "${{ inputs.title_regex }}"
+          node -e "try { const val = JSON.parse(process.argv[1]); if (typeof val !== 'object' || val === null || Array.isArray(val)) throw new Error('Not an object'); } catch(e) { console.error('Input \'custom_labels\' is not a valid JSON object.'); process.exit(1); }" "${{ inputs.custom_labels }}"
+
+      - name: PR Conventional Commit Validation
+        uses: ytanikin/pr-conventional-commits@1.4.0
+        with:
+          task_types: ${{ inputs.task_types }}
+          scope_types: ${{ inputs.scope_types }}
+          title_regex: ${{ inputs.title_regex }}
+          add_label: ${{ inputs.add_label }}
+          add_scope_label: ${{ inputs.add_scope_label }}
+          token: ${{ github.token }}
+          custom_labels: ${{ inputs.custom_labels }}
+
+      - name: Create failure comment based on inputs
+        id: create-failure-comment
+        if: failure() && inputs.comment_on_failure == 'true'
+        run: |
+          COMMENT=""
+          COMMENT+="### ❌ Pull Request Title Validation Failed\n"
+          COMMENT+="Your pull request title does not conform to the Conventional Commits specification.\n"
+          COMMENT+="Please ensure your title follows the format: `<type>(<scope>): <description>`.\n"
+          COMMENT+="- **Type** must be one of the following: ${{ inputs.task_types }}."
+          COMMENT+="- **Scope** must be one of the following: ${{ inputs.scope_types || 'any' }}."
+          COMMENT+="- **Description** should be a brief summary of the changes.\n"
+          if [ -n "${{ inputs.title_regex }}" ]; then
+            COMMENT+="- Additionally, your description must match the custom regex: `${{ inputs.title_regex }}`.\n"
+          fi
+          COMMENT+="\nIf you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details."
+          echo "comment=$COMMENT" >> $GITHUB_OUTPUT
+
+      - name: Comment on Failure
+        if: failure() && inputs.comment_on_failure == 'true'
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          body: ${{ steps.create-failure-comment.outputs.comment }}
+          edit-mode: replace
+
+      - name: Find previous failure comment
+        id: find-comment
+        if: success() && inputs.comment_on_failure == 'true'
+        uses: peter-evans/find-comment@v4
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-author: github-actions[bot]
+          body-includes: "Pull Request Title Validation Failed"
+
+      - name: Cleanup Failure Comment on Success
+        if: success() && inputs.comment_on_failure == 'true'
+        run: |
+          if [ "${{ steps.find-comment.outputs.comment-found }}" == "true" ]; then
+            gh api -X DELETE repos/${{ github.repository }}/issues/comments/${{ steps.find-comment.outputs.comment-id }} --silent
+          fi

From 14049e921d2107c3bb01c8f6660ce8d7a4e818a7 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 11:41:14 -0600
Subject: [PATCH 02/30] fix: do not require task_types

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index aff22db..ce14de2 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -5,7 +5,7 @@ on:
         type: string
         default: '["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
         description: 'A JSON array of task types that are allowed. Default: ["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
-        required: true
+        required: false
       scope_types:
         type: string
         default: ""

From 69a0f6be09fc832a6a0ae5104ee54766eded974d Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 11:46:48 -0600
Subject: [PATCH 03/30] fix: github-script over node -e

---
 .../reusable-pr-conventional-commit-title.yml | 51 +++++++++++++++++--
 1 file changed, 46 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index ce14de2..1ff6cac 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -45,11 +45,52 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Validate inputs
-        run: |
-          node -e "try { const val = JSON.parse(process.argv[1]); if (!Array.isArray(val)) throw new Error('Not an array'); } catch(e) { console.error('Input \'task_types\' is not a valid JSON array.'); process.exit(1); }" "${{ inputs.task_types }}"
-          node -e "try { const val = JSON.parse(process.argv[1]); if (!Array.isArray(val)) throw new Error('Not an array'); } catch(e) { console.error('Input \'scope_types\' is not a valid JSON array.'); process.exit(1); }" "${{ inputs.scope_types }}"
-          node -e "try { new RegExp(process.argv[1]); } catch(e) { console.error('Input \'title_regex\' is not a valid regular expression.'); process.exit(1); }" "${{ inputs.title_regex }}"
-          node -e "try { const val = JSON.parse(process.argv[1]); if (typeof val !== 'object' || val === null || Array.isArray(val)) throw new Error('Not an object'); } catch(e) { console.error('Input \'custom_labels\' is not a valid JSON object.'); process.exit(1); }" "${{ inputs.custom_labels }}"
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const taskTypes = `${{ inputs.task_types }}`;
+            const scopeTypes = `${{ inputs.scope_types }}`;
+            const titleRegex = `${{ inputs.title_regex }}`;
+            const customLabels = `${{ inputs.custom_labels }}`;
+
+            // Validate task_types is a valid JSON array
+            if (taskTypes) {
+              try {
+                const val = JSON.parse(taskTypes);
+                if (!Array.isArray(val)) throw new Error('Not an array');
+              } catch(e) {
+                core.setFailed("Input 'task_types' is not a valid JSON array.");
+              }
+            }
+
+            // Validate scope_types is a valid JSON array (if provided)
+            if (scopeTypes) {
+              try {
+                const val = JSON.parse(scopeTypes);
+                if (!Array.isArray(val)) throw new Error('Not an array');
+              } catch(e) {
+                core.setFailed("Input 'scope_types' is not a valid JSON array.");
+              }
+            }
+
+            // Validate title_regex is a valid regular expression (if provided)
+            if (titleRegex) {
+              try {
+                new RegExp(titleRegex);
+              } catch(e) {
+                core.setFailed("Input 'title_regex' is not a valid regular expression.");
+              }
+            }
+
+            // Validate custom_labels is a valid JSON object (if provided)
+            if (customLabels) {
+              try {
+                const val = JSON.parse(customLabels);
+                if (typeof val !== 'object' || val === null || Array.isArray(val)) throw new Error('Not an object');
+              } catch(e) {
+                core.setFailed("Input 'custom_labels' is not a valid JSON object.");
+              }
+            }
 
       - name: PR Conventional Commit Validation
         uses: ytanikin/pr-conventional-commits@1.4.0

From a23ffaa07ea395a97dc2c67d528116e80eb9131d Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 11:49:59 -0600
Subject: [PATCH 04/30] fix: bump action version

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 1ff6cac..5288421 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -93,7 +93,7 @@ jobs:
             }
 
       - name: PR Conventional Commit Validation
-        uses: ytanikin/pr-conventional-commits@1.4.0
+        uses: ytanikin/pr-conventional-commits@1.5.1
         with:
           task_types: ${{ inputs.task_types }}
           scope_types: ${{ inputs.scope_types }}

From 72cef325cfb13547fd7ab5b379fa5323cac4952f Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 11:52:12 -0600
Subject: [PATCH 05/30] fix: continue-on-error

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 5288421..333c4ba 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -102,6 +102,7 @@ jobs:
           add_scope_label: ${{ inputs.add_scope_label }}
           token: ${{ github.token }}
           custom_labels: ${{ inputs.custom_labels }}
+        continue-on-error: true
 
       - name: Create failure comment based on inputs
         id: create-failure-comment

From 4a0ccee1116d08a6135a3db7b1702206478f5cc7 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:01:20 -0600
Subject: [PATCH 06/30] fix: rework if statements

---
 .../workflows/reusable-pr-conventional-commit-title.yml  | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 333c4ba..38ad201 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -93,6 +93,7 @@ jobs:
             }
 
       - name: PR Conventional Commit Validation
+        id: pr-validation
         uses: ytanikin/pr-conventional-commits@1.5.1
         with:
           task_types: ${{ inputs.task_types }}
@@ -106,7 +107,7 @@ jobs:
 
       - name: Create failure comment based on inputs
         id: create-failure-comment
-        if: failure() && inputs.comment_on_failure == 'true'
+        if: steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure == 'true'
         run: |
           COMMENT=""
           COMMENT+="### ❌ Pull Request Title Validation Failed\n"
@@ -122,7 +123,7 @@ jobs:
           echo "comment=$COMMENT" >> $GITHUB_OUTPUT
 
       - name: Comment on Failure
-        if: failure() && inputs.comment_on_failure == 'true'
+        if: steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure == 'true'
         uses: peter-evans/create-or-update-comment@v5
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -131,7 +132,7 @@ jobs:
 
       - name: Find previous failure comment
         id: find-comment
-        if: success() && inputs.comment_on_failure == 'true'
+        if: steps.pr-validation.outcome == 'success' && inputs.comment_on_failure == 'true'
         uses: peter-evans/find-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -139,7 +140,7 @@ jobs:
           body-includes: "Pull Request Title Validation Failed"
 
       - name: Cleanup Failure Comment on Success
-        if: success() && inputs.comment_on_failure == 'true'
+        if: steps.pr-validation.outcome == 'success' && steps.find-comment.outcome == 'success' && inputs.comment_on_failure == 'true'
         run: |
           if [ "${{ steps.find-comment.outputs.comment-found }}" == "true" ]; then
             gh api -X DELETE repos/${{ github.repository }}/issues/comments/${{ steps.find-comment.outputs.comment-id }} --silent

From aefa51263cfcdde6c05197f0d11fe6786124389e Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:03:53 -0600
Subject: [PATCH 07/30] fix: rework if statements

---
 .../workflows/reusable-pr-conventional-commit-title.yml  | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 38ad201..3b41a47 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -103,11 +103,10 @@ jobs:
           add_scope_label: ${{ inputs.add_scope_label }}
           token: ${{ github.token }}
           custom_labels: ${{ inputs.custom_labels }}
-        continue-on-error: true
 
       - name: Create failure comment based on inputs
         id: create-failure-comment
-        if: steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure == 'true'
+        if: ${{ failure() && inputs.comment_on_failure }}
         run: |
           COMMENT=""
           COMMENT+="### ❌ Pull Request Title Validation Failed\n"
@@ -123,7 +122,7 @@ jobs:
           echo "comment=$COMMENT" >> $GITHUB_OUTPUT
 
       - name: Comment on Failure
-        if: steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure == 'true'
+        if: ${{ steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure }}
         uses: peter-evans/create-or-update-comment@v5
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -132,7 +131,7 @@ jobs:
 
       - name: Find previous failure comment
         id: find-comment
-        if: steps.pr-validation.outcome == 'success' && inputs.comment_on_failure == 'true'
+        if: ${{ steps.pr-validation.outcome == 'success' && inputs.comment_on_failure }}
         uses: peter-evans/find-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -140,7 +139,7 @@ jobs:
           body-includes: "Pull Request Title Validation Failed"
 
       - name: Cleanup Failure Comment on Success
-        if: steps.pr-validation.outcome == 'success' && steps.find-comment.outcome == 'success' && inputs.comment_on_failure == 'true'
+        if: ${{ steps.pr-validation.outcome == 'success' && steps.find-comment.outcome == 'success' && inputs.comment_on_failure }}
         run: |
           if [ "${{ steps.find-comment.outputs.comment-found }}" == "true" ]; then
             gh api -X DELETE repos/${{ github.repository }}/issues/comments/${{ steps.find-comment.outputs.comment-id }} --silent

From 4c559ed720dcb07521a4a76efbee2c9fa49aa6b1 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:08:17 -0600
Subject: [PATCH 08/30] fix: adjust how comment is constructed

---
 .../reusable-pr-conventional-commit-title.yml | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 3b41a47..b33a88f 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -108,21 +108,21 @@ jobs:
         id: create-failure-comment
         if: ${{ failure() && inputs.comment_on_failure }}
         run: |
-          COMMENT=""
-          COMMENT+="### ❌ Pull Request Title Validation Failed\n"
-          COMMENT+="Your pull request title does not conform to the Conventional Commits specification.\n"
-          COMMENT+="Please ensure your title follows the format: `<type>(<scope>): <description>`.\n"
-          COMMENT+="- **Type** must be one of the following: ${{ inputs.task_types }}."
-          COMMENT+="- **Scope** must be one of the following: ${{ inputs.scope_types || 'any' }}."
-          COMMENT+="- **Description** should be a brief summary of the changes.\n"
-          if [ -n "${{ inputs.title_regex }}" ]; then
-            COMMENT+="- Additionally, your description must match the custom regex: `${{ inputs.title_regex }}`.\n"
-          fi
-          COMMENT+="\nIf you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details."
+          cat << EOC >> $COMMENT
+          ### ❌ Pull Request Title Validation Failed
+          Your pull request title does not conform to the Conventional Commits specification.
+          Please ensure your title follows the format: `<type>(<scope>): <description>`.
+          - **Type** must be one of the following: ${{ inputs.task_types }}.
+          - **Scope** must be one of the following: ${{ inputs.scope_types || 'any' }}.
+          - **Description** should be a brief summary of the changes.
+          ${{ inputs.title_regex && format('- Additionally, your description must match the custom regex: `{0}`.', inputs.title_regex) || '' }}
+
+          If you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details.
+          EOC
           echo "comment=$COMMENT" >> $GITHUB_OUTPUT
 
       - name: Comment on Failure
-        if: ${{ steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure }}
+        if: ${{ failure() && inputs.comment_on_failure }}
         uses: peter-evans/create-or-update-comment@v5
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -131,7 +131,7 @@ jobs:
 
       - name: Find previous failure comment
         id: find-comment
-        if: ${{ steps.pr-validation.outcome == 'success' && inputs.comment_on_failure }}
+        if: ${{ success() && inputs.comment_on_failure }}
         uses: peter-evans/find-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
@@ -139,7 +139,7 @@ jobs:
           body-includes: "Pull Request Title Validation Failed"
 
       - name: Cleanup Failure Comment on Success
-        if: ${{ steps.pr-validation.outcome == 'success' && steps.find-comment.outcome == 'success' && inputs.comment_on_failure }}
+        if: ${{ success() && steps.find-comment.outcome == 'success' && inputs.comment_on_failure }}
         run: |
           if [ "${{ steps.find-comment.outputs.comment-found }}" == "true" ]; then
             gh api -X DELETE repos/${{ github.repository }}/issues/comments/${{ steps.find-comment.outputs.comment-id }} --silent

From 316708d54f84d737928dfe12ac4455357952e3b6 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:10:41 -0600
Subject: [PATCH 09/30] fix: adjust how comment is constructed

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index b33a88f..df7a528 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -108,7 +108,7 @@ jobs:
         id: create-failure-comment
         if: ${{ failure() && inputs.comment_on_failure }}
         run: |
-          cat << EOC >> $COMMENT
+          cat << EOC >> pr-title-failure-comment.md
           ### ❌ Pull Request Title Validation Failed
           Your pull request title does not conform to the Conventional Commits specification.
           Please ensure your title follows the format: `<type>(<scope>): <description>`.
@@ -119,14 +119,13 @@ jobs:
 
           If you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details.
           EOC
-          echo "comment=$COMMENT" >> $GITHUB_OUTPUT
 
       - name: Comment on Failure
         if: ${{ failure() && inputs.comment_on_failure }}
         uses: peter-evans/create-or-update-comment@v5
         with:
           issue-number: ${{ github.event.pull_request.number }}
-          body: ${{ steps.create-failure-comment.outputs.comment }}
+          body-file: pr-title-failure-comment.md
           edit-mode: replace
 
       - name: Find previous failure comment

From f8f7e70a63d37be7e4d2ba91c4693203a179c3c1 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:14:30 -0600
Subject: [PATCH 10/30] fix: escape backticks

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index df7a528..42bc492 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -111,7 +111,7 @@ jobs:
           cat << EOC >> pr-title-failure-comment.md
           ### ❌ Pull Request Title Validation Failed
           Your pull request title does not conform to the Conventional Commits specification.
-          Please ensure your title follows the format: `<type>(<scope>): <description>`.
+          Please ensure your title follows the format: \`<type>(<scope>): <description>\`.
           - **Type** must be one of the following: ${{ inputs.task_types }}.
           - **Scope** must be one of the following: ${{ inputs.scope_types || 'any' }}.
           - **Description** should be a brief summary of the changes.

From 202ca466c2ebd2c994462c52df00124ba6c2ec05 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:17:00 -0600
Subject: [PATCH 11/30] adjust verbiage

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 42bc492..5edbd6e 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -113,10 +113,9 @@ jobs:
           Your pull request title does not conform to the Conventional Commits specification.
           Please ensure your title follows the format: \`<type>(<scope>): <description>\`.
           - **Type** must be one of the following: ${{ inputs.task_types }}.
-          - **Scope** must be one of the following: ${{ inputs.scope_types || 'any' }}.
+          ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}.', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}.
           - **Description** should be a brief summary of the changes.
-          ${{ inputs.title_regex && format('- Additionally, your description must match the custom regex: `{0}`.', inputs.title_regex) || '' }}
-
+          ${{ inputs.title_regex && format('- Additionally, your description must match the custom regex: `{0}`.\n', inputs.title_regex) || '' }}
           If you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details.
           EOC
 

From b93412bc832c519ee0b73b284c9452c3a6cd5e8d Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:20:23 -0600
Subject: [PATCH 12/30] fix: reorder comment retrieval, use to populate
 replacement

---
 .../reusable-pr-conventional-commit-title.yml | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 5edbd6e..1d7d237 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -112,30 +112,31 @@ jobs:
           ### ❌ Pull Request Title Validation Failed
           Your pull request title does not conform to the Conventional Commits specification.
           Please ensure your title follows the format: \`<type>(<scope>): <description>\`.
-          - **Type** must be one of the following: ${{ inputs.task_types }}.
-          ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}.', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}.
+          - **Type** must be one of the following: ${{ inputs.task_types }}
+          ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}.
           - **Description** should be a brief summary of the changes.
           ${{ inputs.title_regex && format('- Additionally, your description must match the custom regex: `{0}`.\n', inputs.title_regex) || '' }}
           If you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details.
           EOC
 
-      - name: Comment on Failure
-        if: ${{ failure() && inputs.comment_on_failure }}
-        uses: peter-evans/create-or-update-comment@v5
-        with:
-          issue-number: ${{ github.event.pull_request.number }}
-          body-file: pr-title-failure-comment.md
-          edit-mode: replace
-
       - name: Find previous failure comment
         id: find-comment
-        if: ${{ success() && inputs.comment_on_failure }}
+        if: ${{ always() && inputs.comment_on_failure }}
         uses: peter-evans/find-comment@v4
         with:
           issue-number: ${{ github.event.pull_request.number }}
           comment-author: github-actions[bot]
           body-includes: "Pull Request Title Validation Failed"
 
+      - name: Comment on Failure
+        if: ${{ failure() && inputs.comment_on_failure }}
+        uses: peter-evans/create-or-update-comment@v5
+        with:
+          issue-number: ${{ github.event.pull_request.number }}
+          comment-id: ${{ steps.find-comment.outputs.comment-id }}
+          body-file: pr-title-failure-comment.md
+          edit-mode: replace
+
       - name: Cleanup Failure Comment on Success
         if: ${{ success() && steps.find-comment.outcome == 'success' && inputs.comment_on_failure }}
         run: |

From f9320889282eaaf985d7af6144f721c7068b243f Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:38:14 -0600
Subject: [PATCH 13/30] fix: stray dot

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 1d7d237..25554a3 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -113,7 +113,7 @@ jobs:
           Your pull request title does not conform to the Conventional Commits specification.
           Please ensure your title follows the format: \`<type>(<scope>): <description>\`.
           - **Type** must be one of the following: ${{ inputs.task_types }}
-          ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}.
+          ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}
           - **Description** should be a brief summary of the changes.
           ${{ inputs.title_regex && format('- Additionally, your description must match the custom regex: `{0}`.\n', inputs.title_regex) || '' }}
           If you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details.

From 99468083d8097e8d8036e9b136ffcfdce645b3ed Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:44:16 -0600
Subject: [PATCH 14/30] fix: pr title in comment

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 25554a3..3a579c4 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -110,7 +110,7 @@ jobs:
         run: |
           cat << EOC >> pr-title-failure-comment.md
           ### ❌ Pull Request Title Validation Failed
-          Your pull request title does not conform to the Conventional Commits specification.
+          Your pull request title (\`${{ github.event.pull_request.title }}\`) does not conform to the Conventional Commits specification.
           Please ensure your title follows the format: \`<type>(<scope>): <description>\`.
           - **Type** must be one of the following: ${{ inputs.task_types }}
           ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}

From 723ffc8e3573f3c7f76d28beb586d1a60a933c80 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:48:44 -0600
Subject: [PATCH 15/30] fix: cleanup behavior

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 3a579c4..f36536b 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -140,6 +140,6 @@ jobs:
       - name: Cleanup Failure Comment on Success
         if: ${{ success() && steps.find-comment.outcome == 'success' && inputs.comment_on_failure }}
         run: |
-          if [ "${{ steps.find-comment.outputs.comment-found }}" == "true" ]; then
+          if [ "${{ steps.find-comment.outputs.comment-id }}" != "" ]; then
             gh api -X DELETE repos/${{ github.repository }}/issues/comments/${{ steps.find-comment.outputs.comment-id }} --silent
           fi

From e56cb34e0a7773e89df1c2b0b95675264288d310 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:50:11 -0600
Subject: [PATCH 16/30] fix: pass token

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index f36536b..358f1b0 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -139,6 +139,8 @@ jobs:
 
       - name: Cleanup Failure Comment on Success
         if: ${{ success() && steps.find-comment.outcome == 'success' && inputs.comment_on_failure }}
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
           if [ "${{ steps.find-comment.outputs.comment-id }}" != "" ]; then
             gh api -X DELETE repos/${{ github.repository }}/issues/comments/${{ steps.find-comment.outputs.comment-id }} --silent

From a03a5bba7d913eca03a682ab24f2b915a473ad73 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 12:52:57 -0600
Subject: [PATCH 17/30] fix: default

---
 .../workflows/reusable-pr-conventional-commit-title.yml    | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 358f1b0..0f197db 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -3,14 +3,14 @@ on:
     inputs:
       task_types:
         type: string
-        default: '["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
         description: 'A JSON array of task types that are allowed. Default: ["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
         required: false
+        default: '["feat","fix","docs","test","ci","refactor","perf","chore","revert"]'
       scope_types:
         type: string
-        default: ""
         description: 'A JSON array of valid scope types. If omitted, any scope is allowed. If given, include the empty scope with "". Example: ["login","signup","checkout","payment", ""]'
         required: false
+        default: ""
       title_regex:
         type: string
         description: 'Regular expression for custom title validation; disabled by default. Example: ''PROJECT-\d{2,5}$'' for trailing issue ticket, ''"^[^:]+: [A-Z]"''  for capitalized title'
@@ -27,8 +27,9 @@ on:
         default: true
       custom_labels:
         type: string
-        description: 'A JSON object mapping task types to custom label names. Example: {"feat": "feature", "fix": "fix", "docs": "documentation", "test": "test", "ci": "CI/CD", "refactor": "refactor", "perf": "performance", "chore": "chore", "revert": "revert", "wip": "WIP"}'
+        description: 'A JSON object mapping task types to custom label names. Default: {"feat": "feature", "fix": "fix", "docs": "documentation", "test": "test", "ci": "CI/CD", "refactor": "refactor", "perf": "performance", "chore": "chore", "revert": "revert", "wip": "WIP"}'
         required: false
+        default: '{"feat": "feature", "fix": "fix", "docs": "documentation", "test": "test", "ci": "CI/CD", "refactor": "refactor", "perf": "performance", "chore": "chore", "revert": "revert", "wip": "WIP"}'
       comment_on_failure:
         type: boolean
         description: "Whether to comment on the pull request if the title validation fails. Default: true"

From e50147fc7de8b9f3b7ed3ad1486bac70253282d6 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 13:00:59 -0600
Subject: [PATCH 18/30] fix: clear old scope labels by default

---
 .../reusable-pr-conventional-commit-title.yml         | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 0f197db..2a32d0c 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -35,6 +35,11 @@ on:
         description: "Whether to comment on the pull request if the title validation fails. Default: true"
         required: false
         default: true
+      clear_labels:
+        type: boolean
+        description: "Whether to clear existing labels when the workflow is run. This helps clean up scope labels added by this action when the scope changes. Default: true"
+        required: false
+        default: true
 
 permissions:
   pull-requests: write
@@ -93,6 +98,12 @@ jobs:
               }
             }
 
+      - name: Clear labels
+        id: clear-labels
+        if: ${{ inputs.clear_labels_when_run }}
+        run: |
+          gh pr edit ${{ github.event.pull_request.number }} --remove-label $(gh pr view ${{ github.event.pull_request.number }} --json labels --template '{{range .labels}}{{.name}} {{end}}')
+
       - name: PR Conventional Commit Validation
         id: pr-validation
         uses: ytanikin/pr-conventional-commits@1.5.1

From e5326bf0d4f54684603f6b9f7714f7141e254a1a Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 13:02:29 -0600
Subject: [PATCH 19/30] fix: clear old scope labels by default

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 2a32d0c..2a77866 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -100,7 +100,7 @@ jobs:
 
       - name: Clear labels
         id: clear-labels
-        if: ${{ inputs.clear_labels_when_run }}
+        if: ${{ inputs.clear_labels }}
         run: |
           gh pr edit ${{ github.event.pull_request.number }} --remove-label $(gh pr view ${{ github.event.pull_request.number }} --json labels --template '{{range .labels}}{{.name}} {{end}}')
 

From d202360ebd736486d6dc1b2a411b04cd444fd030 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 13:03:33 -0600
Subject: [PATCH 20/30] fix: pass token

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 2a77866..ca9a633 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -101,6 +101,8 @@ jobs:
       - name: Clear labels
         id: clear-labels
         if: ${{ inputs.clear_labels }}
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
           gh pr edit ${{ github.event.pull_request.number }} --remove-label $(gh pr view ${{ github.event.pull_request.number }} --json labels --template '{{range .labels}}{{.name}} {{end}}')
 

From a10416cdcc076bb77d48ca6c1af752bae66a91cb Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 13:04:14 -0600
Subject: [PATCH 21/30] fix: failure comment only if the validation fails, not
 prior steps

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index ca9a633..5e3273b 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -143,7 +143,7 @@ jobs:
           body-includes: "Pull Request Title Validation Failed"
 
       - name: Comment on Failure
-        if: ${{ failure() && inputs.comment_on_failure }}
+        if: ${{ failure() && steps.pr-validation.outcome == 'failure' && inputs.comment_on_failure }}
         uses: peter-evans/create-or-update-comment@v5
         with:
           issue-number: ${{ github.event.pull_request.number }}

From 39c6f61d27ab8007a66fc64aa8f662e142d75629 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 13:06:47 -0600
Subject: [PATCH 22/30] fix: adjust label removal

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 5e3273b..31bb637 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -42,8 +42,8 @@ on:
         default: true
 
 permissions:
-  pull-requests: write
   contents: read
+  pull-requests: write
 
 jobs:
   validate-title:
@@ -104,7 +104,7 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
-          gh pr edit ${{ github.event.pull_request.number }} --remove-label $(gh pr view ${{ github.event.pull_request.number }} --json labels --template '{{range .labels}}{{.name}} {{end}}')
+          gh api -X PUT repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/labels -f labels='[]'
 
       - name: PR Conventional Commit Validation
         id: pr-validation

From 44f2b991b028e1ea863f703f40ef3543cbd8e5ed Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 13:10:21 -0600
Subject: [PATCH 23/30] fix: adjust label removal

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 31bb637..fb9b851 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -104,7 +104,7 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
-          gh api -X PUT repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/labels -f labels='[]'
+          echo '{"labels":[]}' | gh api -X PUT repos/${{ github.repository }}/issues/${{ github.event.pull_request.number }}/labels --input -
 
       - name: PR Conventional Commit Validation
         id: pr-validation

From 6e0a32dd73a773cb6ba0205f39f3db51bc24e935 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 15:49:15 -0600
Subject: [PATCH 24/30] fix: add note about breaking changes

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index fb9b851..4f8c443 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -129,6 +129,7 @@ jobs:
           - **Type** must be one of the following: ${{ inputs.task_types }}
           ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}
           - **Description** should be a brief summary of the changes.
+          - If you have a breaking change, ensure the exclamation mark (\`!\`) is placed immediately after the type or scope, e.g., \`feat!: ...\` or \`feat(scope)!: ...\`.
           ${{ inputs.title_regex && format('- Additionally, your description must match the custom regex: `{0}`.\n', inputs.title_regex) || '' }}
           If you have any questions, please refer to the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation for more details.
           EOC

From e0a647121876383e64ccb79255c1c89f22c7c555 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 16:19:57 -0600
Subject: [PATCH 25/30] docs: create workflow config, usage doc

---
 .../reusable-pr-conventional-commit-title.yml |  2 +
 docs/reusable-pr-conventional-commit-title.md | 46 +++++++++++++++++++
 2 files changed, 48 insertions(+)
 create mode 100644 docs/reusable-pr-conventional-commit-title.md

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index 4f8c443..a437010 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -15,6 +15,7 @@ on:
         type: string
         description: 'Regular expression for custom title validation; disabled by default. Example: ''PROJECT-\d{2,5}$'' for trailing issue ticket, ''"^[^:]+: [A-Z]"''  for capitalized title'
         required: false
+        default: ""
       add_label:
         type: boolean
         description: "Whether to add labels to your pull request. Default: true"
@@ -125,6 +126,7 @@ jobs:
           cat << EOC >> pr-title-failure-comment.md
           ### ❌ Pull Request Title Validation Failed
           Your pull request title (\`${{ github.event.pull_request.title }}\`) does not conform to the Conventional Commits specification.
+
           Please ensure your title follows the format: \`<type>(<scope>): <description>\`.
           - **Type** must be one of the following: ${{ inputs.task_types }}
           ${{ inputs.scope_types && format('- **Scope** must be one of the following: {0}', inputs.scope_types) || '- **Scope** is optional and can be any value or omitted entirely.' }}
diff --git a/docs/reusable-pr-conventional-commit-title.md b/docs/reusable-pr-conventional-commit-title.md
new file mode 100644
index 0000000..b503fa6
--- /dev/null
+++ b/docs/reusable-pr-conventional-commit-title.md
@@ -0,0 +1,46 @@
+# Enforce Conventional Commits on PR titles
+
+This workflow will ensure that your pull request's title matches the Conventional Commits specification. This format is often used to drive downstream workflows like automated versioning and changelogs.
+
+This is intended for use with repositories that utilize Squash merges, as the title of the pull request is what lands on the base branch when a PR is merged. 
+
+## Configuration
+
+This workflow exposes several configuration items that you can supply through your repository's workflow invocation that will be passed through to the underlying [ytanikin/pr-conventional-commits](https://github.com/ytanikin/pr-conventional-commits) workflow:
+
+| Configuration Key | Type                | Default Value                                                                                                                                                                                          | Notes                                                                                                                                                                                        |
+|-------------------|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| task_types        | string (JSON array) | ["feat","fix","docs","test","ci","refactor","perf","chore","revert"]                                                                                                                                   | Configures the valid prefixes for your commit message. Prefixes can be given a particular label by using the `custom_labels` setting below.                                                  |
+| scope_types       | string (JSON array) | ""                                                                                                                                                                                                     | Valid scopes, e.g. `["login", "signup", "checkout", "payment"]`. If not supplied, any scope is valid.                                                                                        |
+| title_regex       | string              | ""                                                                                                                                                                                                     | Regular expression to apply to the title. Typically this is used to validate a ticket number is included, e.g. `.+ JIRA-\d{3,6} .+`. If not specified, bypasses regular expression checking. |
+| add_label         | boolean             | true                                                                                                                                                                                                   | Whether to add a label to the pull request with the type of the pull request.                                                                                                                |
+| add_scope_label   | boolean             | true                                                                                                                                                                                                   | Whether to add a label to the pull request for the scope (if supplied).                                                                                                                      |
+| custom_labels     | string (JSON map)   | {"feat": "feature", "fix": "fix", "docs": "documentation", "test": "test",<br>  "ci": "CI/CD", "refactor": "refactor", "perf": "performance", "chore": "chore",<br>  "revert": "revert", "wip": "WIP"} | A map of task_types and their stylized label text. With the default values, a task_type of `perf` will result in a label called `Performance`.                                               |
+
+There are two additional configurations that are not passed to the underlying workflow, but control additional behaviors:
+
+| Configuration Key  | Type    | Default Value | Notes                                                                                                                                                                                                                                                                                        |
+|--------------------|---------|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| comment_on_failure | boolean | true          | Whether to comment on the pull request if the title validation fails.                                                                                                                                                                                                                        |
+| clear_labels       | boolean | true          | Whether to clear the existing labels on the pull request when the workflow is run. This helps clean up scope labels added by this action when the scope changes, as they persist if you rename your pull request and change the scope. If you have another labeling solution, turn this off. |
+
+
+## Usage
+
+To validate your PR titles using our default configuration, add the following workflow to your repository:
+
+```yaml
+on:
+  pull_request:
+    types: [opened, reopened, edited]
+
+jobs:
+  validate-title:
+    name: Validate PR Title
+    permissions:
+      contents: read
+      pull-requests: write
+    uses: launchbynttdata/launch-workflows/.github/workflows/reusable-pr-conventional-commit-title.yml@ref
+```
+
+Be sure you replace `ref` with an appropriate ref to this repository.

From e49341314d90a4319ee28fac1bf091231ac3d344 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 16:32:06 -0600
Subject: [PATCH 26/30] fix: normalize workflow names

---
 .github/workflows/reusable-pr-conventional-commit-title.yml | 2 +-
 docs/reusable-pr-conventional-commit-title.md               | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/reusable-pr-conventional-commit-title.yml b/.github/workflows/reusable-pr-conventional-commit-title.yml
index a437010..d8a29c1 100644
--- a/.github/workflows/reusable-pr-conventional-commit-title.yml
+++ b/.github/workflows/reusable-pr-conventional-commit-title.yml
@@ -48,7 +48,7 @@ permissions:
 
 jobs:
   validate-title:
-    name: Validate Pull Request Title
+    name: Validate PR Title
     runs-on: ubuntu-latest
     steps:
       - name: Validate inputs
diff --git a/docs/reusable-pr-conventional-commit-title.md b/docs/reusable-pr-conventional-commit-title.md
index b503fa6..4ec21dc 100644
--- a/docs/reusable-pr-conventional-commit-title.md
+++ b/docs/reusable-pr-conventional-commit-title.md
@@ -30,6 +30,8 @@ There are two additional configurations that are not passed to the underlying wo
 To validate your PR titles using our default configuration, add the following workflow to your repository:
 
 ```yaml
+name: Validate PR Title
+
 on:
   pull_request:
     types: [opened, reopened, edited]
@@ -44,3 +46,6 @@ jobs:
 ```
 
 Be sure you replace `ref` with an appropriate ref to this repository.
+
+> [!NOTE]
+> By default, your repository may not require this workflow to succeed before a change is merged. 
\ No newline at end of file

From 9986d4bdde5771ee2ef9eece2a64fee907987ee8 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 16:41:58 -0600
Subject: [PATCH 27/30] doc: required workflow note

---
 docs/images/all-required-checks-passed.png    | Bin 0 -> 22478 bytes
 docs/images/required-status-check.png         | Bin 0 -> 64779 bytes
 docs/reusable-pr-conventional-commit-title.md |  12 ++++++++++--
 3 files changed, 10 insertions(+), 2 deletions(-)
 create mode 100644 docs/images/all-required-checks-passed.png
 create mode 100644 docs/images/required-status-check.png

diff --git a/docs/images/all-required-checks-passed.png b/docs/images/all-required-checks-passed.png
new file mode 100644
index 0000000000000000000000000000000000000000..1bdb84bed32e2fcf2e71eb38854edac03bb8ccae
GIT binary patch
literal 22478
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

literal 0
HcmV?d00001

diff --git a/docs/images/required-status-check.png b/docs/images/required-status-check.png
new file mode 100644
index 0000000000000000000000000000000000000000..02149c7672a26c45f40a8207a5c882287378704b
GIT binary patch
literal 64779
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%0Djw-A4u@Vwk5e{RF~7UD
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
aUVh>xf-Os*Vy=V&ek9+^iIxiM`TQ@P6Z+r)

literal 0
HcmV?d00001

diff --git a/docs/reusable-pr-conventional-commit-title.md b/docs/reusable-pr-conventional-commit-title.md
index 4ec21dc..18bb5a5 100644
--- a/docs/reusable-pr-conventional-commit-title.md
+++ b/docs/reusable-pr-conventional-commit-title.md
@@ -47,5 +47,13 @@ jobs:
 
 Be sure you replace `ref` with an appropriate ref to this repository.
 
-> [!NOTE]
-> By default, your repository may not require this workflow to succeed before a change is merged. 
\ No newline at end of file
+> [!CAUTION]
+> By default, your repository likely does not require this workflow to succeed before a change is merged. By making this workflow required, you ensure that a successful run must be achieved prior to merge, which ensures your commit messages are consistent!
+> 
+> To make this workflow required, visit your repository's settings and create a new Ruleset with a required status check, as shown below:
+
+![Required status check in the GitHub settings page](images/required-status-check.png)
+
+By doing so, you should see the `Required` indicator on your pull request's checks section, as shown below:
+
+![Pull request with a required status check showing a passing state](images/required-status-check.png)

From 502a9a254d40b941d9809f5cc91398a23df1c27f Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 16:44:24 -0600
Subject: [PATCH 28/30] doc: adjust image path

---
 docs/reusable-pr-conventional-commit-title.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reusable-pr-conventional-commit-title.md b/docs/reusable-pr-conventional-commit-title.md
index 18bb5a5..3d21bb5 100644
--- a/docs/reusable-pr-conventional-commit-title.md
+++ b/docs/reusable-pr-conventional-commit-title.md
@@ -56,4 +56,4 @@ Be sure you replace `ref` with an appropriate ref to this repository.
 
 By doing so, you should see the `Required` indicator on your pull request's checks section, as shown below:
 
-![Pull request with a required status check showing a passing state](images/required-status-check.png)
+![Pull request with a required status check showing a passing state](docs/images/all-required-checks-passed.png)

From a10dcc2d91dcb4ec14ee1a44d5a287dddd89e7c5 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 16:46:10 -0600
Subject: [PATCH 29/30] doc: adjust image path again

---
 docs/reusable-pr-conventional-commit-title.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reusable-pr-conventional-commit-title.md b/docs/reusable-pr-conventional-commit-title.md
index 3d21bb5..28fde7b 100644
--- a/docs/reusable-pr-conventional-commit-title.md
+++ b/docs/reusable-pr-conventional-commit-title.md
@@ -56,4 +56,4 @@ Be sure you replace `ref` with an appropriate ref to this repository.
 
 By doing so, you should see the `Required` indicator on your pull request's checks section, as shown below:
 
-![Pull request with a required status check showing a passing state](docs/images/all-required-checks-passed.png)
+![Pull request with a required status check showing a passing state](/docs/images/all-required-checks-passed.png)

From c6db9b5a5e36b6b7458d2cf73e646f79fd73d437 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris11.taylor@nttdata.com>
Date: Tue, 27 Jan 2026 16:47:25 -0600
Subject: [PATCH 30/30] doc: adjust image path yet again

---
 docs/reusable-pr-conventional-commit-title.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reusable-pr-conventional-commit-title.md b/docs/reusable-pr-conventional-commit-title.md
index 28fde7b..c2eabee 100644
--- a/docs/reusable-pr-conventional-commit-title.md
+++ b/docs/reusable-pr-conventional-commit-title.md
@@ -56,4 +56,4 @@ Be sure you replace `ref` with an appropriate ref to this repository.
 
 By doing so, you should see the `Required` indicator on your pull request's checks section, as shown below:
 
-![Pull request with a required status check showing a passing state](/docs/images/all-required-checks-passed.png)
+![Pull request with a required status check showing a passing state](images/all-required-checks-passed.png)