Commit Health Gate

A language-agnostic code-quality gate for Pull Requests. It automatically analyzes the commits in a PR and fails or warns if they contain "mega commits" (too many lines or files changed) or commits with suspicious patterns.

This helps maintain a clean, reviewable, and high-quality commit history in your repository.

• 🚦 Language Agnostic: Works with any repository regardless of the programming language.
• 🐘 Detects Mega Commits: Configurable thresholds for lines changed and files changed to discourage massive commits that are hard to review.
• 🕵️ Identifies Suspicious Patterns: Automatically spots commits that have questionable messages or patterns.
• 🕒 Identifies Burnout Commits: Flags commits made outside configured working hours to protect team health.
• 🚀 Fast Native Binary: Uses a pre-compiled native binary for near-instant startup, with a fallback to Dart source execution.
• 💬 Sticky PR Comments: Posts a summary comment on the Pull Request highlighting any violations found.

Create a workflow file (e.g., .github/workflows/commit-health.yml) in your repository:

name: Commit Health Check

on:
  pull_request:
    types: [opened, synchronize, reopened]

permissions:
  pull-requests: write # Required to post sticky comments on PRs
  contents: read

jobs:
  check-commits:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # Required to analyze commits

      - name: Run Commit Health Gate
        uses: rw-core/commit-health-gate@v1
        with:
          # Optional: Specify thresholds
          # github-token: ${{ github.token }}
          # mega-commit-line-threshold: '500'
          # mega-commit-file-threshold: '20'
          # Set to true to fail the workflow on violations
          # fail-on-violation: 'false'
          # Burnout check configuration
          # fail-on-burnout: 'false'
          # work-hours-start: '9'
          # work-hours-end: '17'
          # working-directory: '.'

🚦 Commit Health Gate

❌ 2 violation(s) found.

🐘 Mega Commits

• a1b2c3d: Commit is too large (600 lines changed, threshold: 500).

🕵️ Suspicious Patterns

• e4f5g6h: Suspicious commit message detected ("fix stuff").