ci: update pr title lint workflow

Author: gazorby

.github/workflows/lint-pr.yaml

@@ -6,16 +6,47 @@ on:
       - opened
       - reopened
       - edited
+      - synchronize
+
+permissions:
+  pull-requests: write
 
 jobs:
-  main:
+  validate:
     name: Validate PR title
     runs-on: ubuntu-slim
-    permissions:
-      pull-requests: read
+
     steps:
-      - uses: amannn/action-semantic-pull-request@2c9480cf285c2ac02b52e26013f7d627b14a4f95 # v6
+      - name: Check PR title
+        id: lint_pr_title
+        uses: amannn/action-semantic-pull-request@2c9480cf285c2ac02b52e26013f7d627b14a4f95 # v6
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           requireScope: false
+
+      - name: Post error comment
+        uses: marocchino/sticky-pull-request-comment@3d7b8546315c63df45a03981d50a43ec19237f80 # v2
+        # When the previous steps fail, the workflow would stop. By adding this
+        #  condition, execution continues with the populated error message.
+        if: always() && (steps.lint_pr_title.outputs.error_message != null)
+        with:
+          header: pr-title-lint-error
+          message: |
+            Hey there and thank you for opening this pull request! 👋🏼
+
+            We require pull request titles to follow the [Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/) and it looks like your proposed title needs to be adjusted.
+
+            Details:
+
+            ```
+            ${{ steps.lint_pr_title.outputs.error_message }}
+            ```
+
+      # Delete a previous comment when the issue has been resolved
+      - name: Delete previous comment
+        uses: marocchino/sticky-pull-request-comment@3d7b8546315c63df45a03981d50a43ec19237f80 # v2
+        if: ${{ steps.lint_pr_title.outputs.error_message == null }}
+        with:
+          header: pr-title-lint-error
+          delete: true