ci: add commit lint workflow

Author: metaclips

.github/workflows/comment.yml

@@ -2,7 +2,7 @@ name: PR Comment
 
 on:
   workflow_run:
-    workflows: ['e2e-tests', 'PR Description']
+    workflows: ['e2e-tests', 'PR Description', 'Lint Pull Request Title']
     types:
       - completed
 

.github/workflows/pr-title-lint.yml

@@ -0,0 +1,61 @@
+name: Pull Request Title
+
+on:
+  pull_request:
+    types:
+      - opened
+      - edited
+      - reopened
+      - synchronize
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      ERR_MSG: |-
+        The PR title `${{ github.event.pull_request.title }}` does not follow the Calimero-Network Commit Message Convention
+        https://github.com/calimero-network/core/blob/master/CONTRIBUTING.md#commit-message-style
+
+        Our PR title should have the following structure:
+
+          <type>(<scope>): <subject>
+
+        Common errors to avoid:
+        1. The commit header <type>(<scope>): <subject> must be in lower case.
+        2. Allowed type values are: build, ci, docs, feat, fix, perf, refactor, test.
+
+        The linting rules are defined in:
+        https://github.com/calimero-network/core/blob/master/commitlint.config.js
+
+        More about the Commit Message Convention
+        https://github.com/calimero-network/core/blob/master/CONTRIBUTING.md#commit-message-style
+
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        id: lint_pr_title
+
+      - name: Create PR Comment Payload
+        if: ${{ !cancelled() }}
+        shell: bash
+        run: >-
+          jq -n
+            --arg pr '${{ github.event.number }}'
+            --arg tag pr-lint-check
+            --arg mode "${{ steps.lint_pr_title.outputs.error_message != null && 'recreate' || 'delete' }}"
+            --arg message "${{ env.ERR_MSG }}"
+            '{pr: $pr, tag: $tag, mode: $mode, message: $message}' | tee payload.json
+
+      - name: Upload Comment
+        if: ${{ !cancelled() }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: pr-comment-payload
+          path: payload.json