ci: add PR title conventional commits check (#28)

* ci: add PR title conventional commits check

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Committed-By-Agent: claude

* ci: pin ubuntu-24.04 and add explicit permissions block

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Committed-By-Agent: claude

* ci: disable label creation and narrow permissions to read-only

Committed-By-Agent: claude

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lucasloisp

.github/workflows/pr-title.yml

@@ -0,0 +1,19 @@
+name: PR Title
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  pull-requests: read   # Read PR details
+  contents: read        # Read repository content
+
+jobs:
+  conventional-commits:
+    timeout-minutes: 5
+    name: conventional-commits
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: ytanikin/pr-conventional-commits@639145d78959c53c43112365837e3abd21ed67c1
+        with:
+          task_types: '["feat","fix","docs","test","ci","refactor","perf","chore","revert","style","build"]'
+          add_label: 'false'

CONTRIBUTING.md

@@ -2,6 +2,25 @@
 
 For questions or support, email <support@privy.io>.
 
+## Pull requests
+
+PR titles **must** follow [Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```
+type(optional scope): description
+```
+
+Allowed types: `feat`, `fix`, `docs`, `test`, `ci`, `refactor`, `perf`, `chore`, `revert`, `style`, `build`.
+
+Examples:
+
+```
+feat: add wallet balance endpoint
+fix(auth): handle expired tokens
+chore: update dependencies
+```
+
+A CI check will block merge if the PR title does not match this format.
 
 ### Code style & formatting