ci: standardize commit messages

Author: ted-palmer

.github/workflows/pr-title.yml

@@ -0,0 +1,24 @@
+---
+name: PR Title
+on:
+  pull_request:
+    types:
+      - opened
+      - edited
+      - synchronize
+
+permissions:
+  contents: read
+
+jobs:
+  pr-title:
+    name: PR title format
+    if: github.actor != 'dependabot[bot]' && github.actor != 'github-actions[bot]'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - name: Check PR title
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+        run: node scripts/check-commit-message.mjs --message "$PR_TITLE"

AGENTS.md

@@ -95,6 +95,19 @@ haptic('light') // fire haptic
 - Data fetching: TanStack Query v5 via hooks package (`useQuote`, `useTokenList`, `useRelayChains`)
 - localStorage key: `relay-ui-kit` (starred chains, accepted unverified tokens)
 
+## Commit messages
+
+PR titles use conventional commits:
+
+```
+type(scope): subject
+```
+
+- Types: `build`, `chore`, `ci`, `docs`, `feat`, `fix`, `obs`, `perf`, `refactor`, `revert`, `style`, `test`
+- Scope is optional (`fix(ui): ...`); `!` before the colon marks a breaking change
+- PRs are squash-merged, so the PR title is what lands on `main` and must follow this
+  format (CI checks it); local branch commits are not restricted
+
 ## Writing changesets
 
 Every changeset becomes a public changelog entry at

scripts/check-commit-message.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// Validates a PR title: type(scope): subject
+//
+// Usage: node scripts/check-commit-message.mjs --message "<title>"
+
+const TYPES = [
+  'build',
+  'chore',
+  'ci',
+  'docs',
+  'feat',
+  'fix',
+  'obs',
+  'perf',
+  'refactor',
+  'revert',
+  'style',
+  'test'
+]
+
+const EXEMPT = [/^Revert ".+"$/, /^Version Packages/, /^Release the: /]
+
+const HEADER_RE = new RegExp(`^(${TYPES.join('|')})(\\([^)]+\\))?!?: \\S.*$`)
+
+const title = (process.argv[2] === '--message' ? process.argv[3] : process.argv[2])?.trim()
+
+if (title && (EXEMPT.some((re) => re.test(title)) || HEADER_RE.test(title))) {
+  process.exit(0)
+}
+
+console.error(`✖ Invalid PR title:
+
+    ${title ?? ''}
+
+  Expected format:
+
+    type(scope): subject     (scope is optional, "!" marks breaking changes)
+
+  Allowed types: ${TYPES.join(', ')}
+
+  Examples:
+
+    feat(ui): add XRP destination support
+    fix: block token contract addresses in recipient field
+    chore(sdk): sync api types
+`)
+process.exit(1)