chore(github): add commit message guard

Author: alexk-dev

.github/workflows/commit-message-check.yml

@@ -0,0 +1,71 @@
+name: Commit Message Check
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - edited
+  push:
+    branches-ignore:
+      - main
+
+jobs:
+  conventional-commits:
+    name: conventional-commits
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate commit messages
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          BEFORE_SHA: ${{ github.event.before }}
+          AFTER_SHA: ${{ github.sha }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: |
+          set -euo pipefail
+
+          regex='^(feat|fix|refactor|test|docs|chore|perf|style|revert)(\([a-z0-9][a-z0-9._/-]*\))?(!)?: [^ ].*[^.]$'
+
+          if [ "$EVENT_NAME" = "pull_request" ]; then
+            range="${BASE_SHA}..${HEAD_SHA}"
+          else
+            if [ "${BEFORE_SHA}" = "0000000000000000000000000000000000000000" ]; then
+              range="${AFTER_SHA}"
+            else
+              range="${BEFORE_SHA}..${AFTER_SHA}"
+            fi
+          fi
+
+          echo "Validating commits in range: ${range}"
+
+          invalid=0
+
+          while IFS=$'\t' read -r sha subject; do
+            if [ -z "${sha}" ]; then
+              continue
+            fi
+
+            if [[ "${subject}" =~ ^Merge[[:space:]] ]]; then
+              continue
+            fi
+
+            if [[ ! "${subject}" =~ ${regex} ]]; then
+              echo "Invalid commit message: ${sha} ${subject}"
+              invalid=1
+            fi
+          done < <(git log --format='%H%x09%s' "${range}")
+
+          if [ "${invalid}" -ne 0 ]; then
+            echo "Commit message validation failed. Use Conventional Commits."
+            exit 1
+          fi
+
+          echo "All commit messages passed Conventional Commit validation."

AGENTS.md

@@ -82,3 +82,42 @@ Before committing:
 
 - run `jq empty models/*.json` and, if applicable, `jq empty providers/**/*.json`
 - keep `README.md` in sync with the supported models actually present in the repository
+
+## Git workflow
+
+- Direct pushes to `main` are prohibited.
+- All changes must go through a feature branch and Pull Request.
+- Keep commits focused and reviewable.
+
+## Commit messages
+
+Use Conventional Commits.
+
+Format:
+
+`<type>[optional scope]: <description>`
+
+Allowed types:
+
+- `feat`
+- `fix`
+- `refactor`
+- `test`
+- `docs`
+- `chore`
+- `perf`
+- `style`
+- `revert`
+
+Rules:
+
+- use imperative mood
+- keep the subject concise
+- do not end the subject with a period
+- use a scope when it improves clarity, for example `models`, `readme`, `registry`, or `github`
+
+Examples:
+
+- `feat(models): add gpt-5.3-codex defaults`
+- `docs(readme): update supported models table`
+- `chore(github): add commit message workflow`