rails_git_hooks 0.7.1 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b95455f85a5e5f3789055e84fc610dcfa199f593d3fc34e5dfb94b781b0ad050
-  data.tar.gz: d2f37971fb832ba3c0e2b3651c7d27b4ca8a7665d6fdac879a43eac8ca38b022
+  metadata.gz: 3e545765ea7576f3a3f3f20cb93e3137d24b9286d28d1fbf1a9a2750d8992b42
+  data.tar.gz: 7b2873f1099d4e1dbfdfc180bce56862fc782a21ff9131f9403d86f164cc1773
 SHA512:
-  metadata.gz: 93b5d01ffd6b14ed1d94543a41e95286afbcaa1f808d9c1d4045dd193e9de3a9f02b3b8a5d5374eadaea450028b28ee89a09c1af20869e30cd8cdeeb8620f259
-  data.tar.gz: 549b45c9aeb5f9607c5aa779d4fdf71196d7d08525f79cfde5e3bf2c3a7df107aa34e397258d4218e45a026e6ed474ab6bb4fc906174af0876eb61ba5cd4e44b
+  metadata.gz: dbb863f5890def3ef2cee7e3f762b428f81d9aaf3236325956adb302db92145e5b6eb1f0eeb500a2e996825439101df1e2e949ef1345f30670289a6cbd536c3c
+  data.tar.gz: 17b2b1e96f64cd8f1d59494ab40193e7f065bd1f450ea9e55365699f6b58ec3c79a08e49c392de0476cdbb06bba90b977fecbd8bb04d4a6dcd889969cae7d296

data/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [0.7.2]
+
+### Added
+
+- **post-checkout hook** — Runs after branch checkout. Includes `bundle-install` (run `bundle install` when Gemfile/Gemfile.lock changed) and `db-migrate` (run `rails db:migrate` when migrations or schema changed). Both enabled by default.
+- **post-merge hook** — Runs after merge. Same checks as post-checkout: `bundle-install` and `db-migrate`, enabled by default. Keeps the app bundled and migrated when pulling or merging (inspired by [hookup](https://rubygems.org/gems/hookup)).
+- **Shared check modules** — `checks/shared/bundle_install_check.rb` and `checks/shared/db_migrate_check.rb` hold common logic and options for the post-checkout and post-merge bundle/migrate checks.
+- **Specs for every check** — RSpec examples for all 13 checks (pre-commit, commit-msg, pre-push, post-checkout, post-merge) under `spec/rails_git_hooks/checks/`.
+
+### Changed
+
+- **Default install** — With no config file, `install` now installs **commit-msg**, **pre-commit**, **post-checkout**, and **post-merge** (post-checkout/post-merge bundle and db-migrate checks are on by default).
+- **Runner** — `modified_files` now supports `post_checkout` (files changed between refs on branch checkout) and `post_merge` (files changed between ORIG_HEAD and HEAD). Repository adds `changed_files(ref1, ref2)`.
+- **defaults.yml** — PostCheckout and PostMerge sections: `BundleInstall` and `DbMigrate` set to `enabled: true` by default.
+
 ## [0.7.1]
 
 ### Added

data/README.md

@@ -4,45 +4,80 @@
 [![Build Status](https://github.com/NikitaNazarov1/rails_git_hooks/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/NikitaNazarov1/rails_git_hooks/actions/workflows/tests.yml?query=branch%3Amain)
 [![RuboCop](https://github.com/NikitaNazarov1/rails_git_hooks/actions/workflows/rubocop.yml/badge.svg?branch=main)](https://github.com/NikitaNazarov1/rails_git_hooks/actions/workflows/rubocop.yml?query=branch%3Amain)
 
-Git hooks for Rails and Ruby projects with built-in defaults, optional sparse overrides, and Overcommit-style per-check policies.
-
-## What changed
-
-The project now uses a **code-first hook runtime**:
-
-- checks declare their defaults in Ruby
-- hook scripts are thin bootstraps
-- `.rails_git_hooks.yml` is optional and contains only overrides
-- checks can be configured with `enabled`, `quiet`, `on_fail`, `on_warn`, `on_missing_dependency`, `include`, and `exclude`
-
-## Included hooks
-
-| Git hook | Purpose |
-|---|---|
-| `commit-msg` | Prefix commit messages with Jira-style ticket IDs from the current branch |
-| `pre-commit` | Run commit-time checks like branch protection, debugger detection, format validation, and optional code quality checks |
-| `pre-push` | Run the test suite before push |
+Git hooks for Rails and Ruby projects: sensible defaults out of the box, optional YAML overrides, and per-check policies (enable/disable, fail vs warn, include/exclude).
+
+## Features
+
+- **Code-first runtime** — Checks are Ruby classes; hook scripts are thin bootstraps that delegate to a shared runtime.
+- **Sparse config** — Defaults live in the gem ([config/defaults.yml](https://github.com/NikitaNazarov1/rails_git_hooks/blob/main/lib/rails_git_hooks/config/defaults.yml)). But you can redefine them via your own yml config file in a root repository.
+- **Flexible configuration options** — Per check: `enabled`, `quiet`, `on_fail`, `on_warn`, `on_missing_dependency`, `include`, `exclude`, `command`.
+- **Dependency handling** — Checks declare executables/libraries; missing deps are handled by a single policy (`on_missing_dependency`).
+
+## Included hooks and checks
+
+### When hooks trigger
+
+| Hook | Triggers at |
+|------|-------------|
+| **commit-msg** | After the user finishes editing the commit message, before the commit is created. |
+| **pre-commit** | Before the commit is created (when running `git commit`). |
+| **pre-push** | Before pushing to the remote (when running `git push`). |
+| **post-checkout** | After switching branches or restoring files (e.g. `git checkout`). |
+| **post-merge** | After a merge completes (when running `git merge`). |
+
+### Checks by hook
+
+| Hook         | Check key            | Enabled By Default | Description |
+|-------------|----------------------|---------|-------------|
+| **commit-msg** | `jira-prefix`        | ✅      | Prefix commit messages with Jira-style ticket IDs from the branch name (e.g. `[TICKET-123]`). |
+| **commit-msg** | `not-empty`          | ✅      | Reject empty commit messages. |
+| **pre-commit** | `default-branch`     | ✅      | Block commits on `master` / `main`, prompt to use a feature branch. |
+| **pre-commit** | `debugger-check`     | ✅      | Warn (or fail) on debugger statements in Ruby, JavaScript/TypeScript, and Python. |
+| **pre-commit** | `yaml-format-check`  | ✅      | Warn on invalid `.yml` / `.yaml` files. |
+| **pre-commit** | `json-format-check`  | ✅      | Warn on invalid `.json` files. |
+| **pre-commit** | `migrations-check`   | ✅      | Warn when migration files are staged but schema/data_schema files are not. |
+| **pre-commit** | `whitespace-check`   | Off     | Fail on trailing whitespace and merge conflict markers. |
+| **pre-commit** | `rubocop-check`      | Off     | Run RuboCop on staged Ruby files (requires `rubocop` in the project). |
+| **pre-commit** | `rails-best-practices` | Off   | Warn on Rails best practices violations (requires `rails_best_practices` gem). |
+| **pre-commit** | `erblint-check`       | Off   | Run `erblint` on staged ERB files (requires `erblint` gem). |
+| **pre-commit** | `eslint-check`        | Off   | Run `eslint` on staged JavaScript files (.js, .jsx, .mjs, .cjs). You can set `command` in config to use an npm script (e.g. `npm run lint`). |
+| **pre-commit** | `golint-check`        | Off   | Run `golint` on staged Go files (requires `golint`). |
+| **pre-commit** | `haml-lint-check`     | Off   | Run `haml-lint` on staged HAML files (requires `haml_lint` gem). |
+| **pre-commit** | `jslint-check`        | Off   | Run `jslint` on staged JavaScript files (.js, .jsx, .mjs, .cjs). |
+| **pre-commit** | `php-lint-check`      | Off   | Run `php -l` (syntax check) on staged PHP files. |
+| **pre-commit** | `pylint-check`        | Off   | Run `pylint` on staged Python files. |
+| **pre-commit** | `scss-lint-check`     | Off   | Run `scss-lint` on staged SCSS files (requires `scss_lint` gem). |
+| **pre-commit** | `go-vet-check`        | Off   | Run `go vet` on staged Go files. |
+| **pre-push**   | `run-tests`          | Off     | Run test suite before push (default: `bundle exec rspec`). Enable in config to install pre-push. |
+| **pre-push**   | `run-pytest`         | Off     | Run pytest test suite before push. Enable in config to install pre-push. |
+| **pre-push**   | `run-go-test`        | Off     | Run `go test` suite before push. Enable in config to install pre-push. |
+| **post-checkout** | `bundle-install`   | Off     | Run `bundle install` when Gemfile or Gemfile.lock changed after a branch checkout. |
+| **post-checkout** | `db-migrate`       | Off     | Run `rails db:migrate` when migrations or schema changed after a branch checkout. |
+| **post-checkout** | `npm-install`      | Off     | Run `npm install` when package.json or package-lock.json changed after a branch checkout. |
+| **post-checkout** | `yarn-install`     | Off     | Run `yarn install` when package.json or yarn.lock changed after a branch checkout. |
+| **post-merge** | `bundle-install`     | Off     | Run `bundle install` when Gemfile or Gemfile.lock changed after a merge. |
+| **post-merge** | `db-migrate`        | Off     | Run `rails db:migrate` when migrations or schema changed after a merge. |
+| **post-merge** | `npm-install`       | Off     | Run `npm install` when package.json or package-lock.json changed after a merge. |
+| **post-merge** | `yarn-install`      | Off     | Run `yarn install` when package.json or yarn.lock changed after a merge. |
 
 ## Quick start
 
-### 1. Install the gem
-
-```bash
-gem install rails_git_hooks
-```
+### 1. Add the gem
 
-Or add it to your `Gemfile`:
+**Gemfile:**
 
 ```ruby
 gem "rails_git_hooks"
 ```
 
-Then install dependencies:
+Then:
 
 ```bash
 bundle install
 ```
 
+Or install globally: `gem install rails_git_hooks`.
+
 ### 2. Install hooks
 
 From your project root:
@@ -51,53 +86,25 @@ From your project root:
 bundle exec rails_git_hooks install
 ```
 
-This installs `commit-msg` and `pre-commit` by default.
-
-### 3. Inspect available checks
-
-```bash
-bundle exec rails_git_hooks list
-```
+With default config this installs **commit-msg**, **pre-commit**, **post-checkout**, and **post-merge** into `.git/hooks/` and copies the runtime there (pre-push is off by default; enable `run-tests` in config to add it).
 
-### 4. Override behavior only when needed
+## Configuration
 
-Enable RuboCop:
+### Priority (low → high)
 
-```bash
-bundle exec rails_git_hooks enable rubocop-check
-```
+1. **Built-in defaults** (in the gem’s `config/defaults.yml`)
+2. **`.rails_git_hooks.yml`** in the repo root (sparse overrides; commit this)
+3. **`.rails_git_hooks.local.yml`** in the repo root (optional; overrides the above, typically gitignored)
 
-Make debugger statements fail instead of warn:
-
-```bash
-bundle exec rails_git_hooks set debugger-check on_fail fail
-```
-
-Disable migrations warnings:
-
-```bash
-bundle exec rails_git_hooks disable migrations-check
-```
-
-Show effective config:
-
-```bash
-bundle exec rails_git_hooks show-config
-```
-
-## Config model
-
-You do **not** need a config file for the defaults to work.
-
-If you want overrides, create one:
+**Create the main override file:**
 
 ```bash
 bundle exec rails_git_hooks init
 ```
 
-This creates `.rails_git_hooks.yml`. The file is sparse: only your changes are stored there.
+**Optional:** Create `.rails_git_hooks.local.yml` in the repo root for personal overrides (merged on top of `.rails_git_hooks.yml`). Add it to `.gitignore` if you don’t want to commit it.
 
-Example:
+### Example override file
 
 ```yaml
 PreCommit:
@@ -112,118 +119,29 @@ PreCommit:
       - "lib/**/*.rb"
     exclude:
       - "db/schema.rb"
-```
-
-### Supported per-check options
 
-| Option | Meaning |
-|---|---|
-| `enabled` | Enable or disable a check |
-| `quiet` | Hide normal output unless the check warns or fails |
-| `on_fail` | Map a check failure to `fail`, `warn`, or `pass` |
-| `on_warn` | Map a warning to `warn`, `fail`, or `pass` |
-| `on_missing_dependency` | Control behavior when required tools/libraries are missing |
-| `include` | File paths or glob patterns that the check should apply to |
-| `exclude` | File paths or glob patterns to remove from the included set |
-| `command` | Override the command used by command-based checks |
-
-## Dependency model
-
-Checks can declare dependencies such as:
-
-- executables like `bundle`
-- Ruby libraries like `rubocop`
-- required files
-
-If a dependency is missing, the runner produces a structured result and applies the check’s `on_missing_dependency` policy. This makes missing-tool behavior consistent across all checks.
-
-## Default checks
-
-### `commit-msg`
-
-- `jira-prefix`
-  - enabled by default
-  - prefixes commit messages with `[TICKET-123]` when the branch name contains a Jira-style ticket ID
-
-### `pre-commit`
-
-- `default-branch`
-  - enabled by default
-  - fails on `master` / `main`
-
-- `debugger-check`
-  - enabled by default
-  - warns on debugger statements in Ruby, JavaScript/TypeScript, and Python
-
-- `yaml-format-check`
-  - enabled by default
-  - warns on invalid `.yml` / `.yaml`
-
-- `json-format-check`
-  - enabled by default
-  - warns on invalid `.json`
-
-- `migrations-check`
-  - enabled by default
-  - warns when schema/data schema files appear to be missing after migrations
-
-- `whitespace-check`
-  - disabled by default
-  - fails on trailing whitespace and merge conflict markers
-
-- `rubocop-check`
-  - disabled by default
-  - runs RuboCop on staged Ruby files
-  - default dependency behavior warns if `rubocop` is missing
-
-### `pre-push`
-
-- `run-tests`
-  - enabled by default when `pre-push` is installed
-  - runs `bundle exec rspec`
-
-## CLI reference
-
-| Command | Description |
-|---|---|
-| `rails_git_hooks install [HOOK...]` | Install hook scripts into `.git/hooks` |
-| `rails_git_hooks list` | List available git hooks and check keys |
-| `rails_git_hooks init` | Create `.rails_git_hooks.yml` |
-| `rails_git_hooks enable CHECK_NAME` | Set `enabled: true` for a check override |
-| `rails_git_hooks disable CHECK_NAME` | Set `enabled: false` for a check override |
-| `rails_git_hooks set CHECK_NAME OPTION VALUE` | Set a single override option |
-| `rails_git_hooks show-config` | Print effective merged configuration |
-
-Examples:
-
-```bash
-rails_git_hooks install
-rails_git_hooks install pre-push
-rails_git_hooks enable rubocop-check
-rails_git_hooks disable migrations-check
-rails_git_hooks set debugger-check on_fail fail
-rails_git_hooks set rubocop-check quiet true
-rails_git_hooks show-config
+  # Run eslint via your npm script (useful if the script has its own config):
+  Eslint:
+    enabled: true
+    command: [npm, run, lint]
 ```
 
-## Manual installation
+### Per-check options
 
-From your project (with the gem in the Gemfile or installed), run:
+| Option | Description |
+|--------|--------------|
+| `enabled` | Turn the check on or off. |
+| `quiet` | Suppress normal output unless the check warns or fails. |
+| `on_fail` | `fail`, `warn`, or `pass` when the check fails. |
+| `on_warn` | `warn`, `fail`, or `pass` when the check would warn. |
+| `on_missing_dependency` | Behavior when a required executable/library is missing. |
+| `include` | Glob patterns for files the check applies to. |
+| `exclude` | Glob patterns to exclude from `include`. |
+| `command` | Override the command for checks that run external commands. |
 
-```bash
-bundle exec rails_git_hooks install
-```
-
-This installs the thin hook bootstraps and the embedded `rails_git_hooks` runtime into `.git/hooks/`.
-
-## Development
+## Contributing
 
-```bash
-bundle install
-bundle exec rake              # run specs
-bundle exec rake build        # build the gem
-bundle exec rake install      # install locally
-```
+Contributions are welcome. Open an [issue](https://github.com/NikitaNazarov1/rails_git_hooks/issues) for bugs or ideas, or submit a pull request.
 
 ## License
 

data/lib/rails_git_hooks/checks/commit_msg/not_empty.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module CommitMsg
+      class NotEmpty < Base
+        check_definition key: 'not-empty',
+                         hook: :commit_msg,
+                         description: 'Reject empty commit messages'
+
+        def run
+          message_file = argv.first
+          return CheckResult.pass unless message_file && File.file?(message_file)
+
+          message = File.read(message_file)
+          # Strip comment lines (git uses # in the message template) and blank lines
+          content = message.lines.reject { |line| line.strip.start_with?('#') || line.strip.empty? }.join.strip
+          return CheckResult.pass unless content.empty?
+
+          CheckResult.fail(messages: ['Commit message must not be empty.'])
+        end
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/commit_msg.rb

@@ -8,3 +8,4 @@ module GitHooks
 end
 
 require_relative 'commit_msg/jira_prefix'
+require_relative 'commit_msg/not_empty'

data/lib/rails_git_hooks/checks/post_checkout/bundle_install.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostCheckout
+      class BundleInstall < Base
+        include BundleInstallCheck
+
+        check_definition key: 'bundle-install',
+                         hook: :post_checkout,
+                         description: 'Run bundle install when Gemfile or Gemfile.lock changed (branch checkout)',
+                         **BundleInstallCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_checkout/db_migrate.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostCheckout
+      class DbMigrate < Base
+        include DbMigrateCheck
+
+        check_definition key: 'db-migrate',
+                         hook: :post_checkout,
+                         description: 'Run db:migrate when migrations or schema changed (branch checkout)',
+                         **DbMigrateCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_checkout/npm_install.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostCheckout
+      class NpmInstall < Base
+        include NpmInstallCheck
+
+        check_definition key: 'npm-install',
+                         hook: :post_checkout,
+                         description: 'Run npm install when package.json or package-lock.json changed (branch checkout)',
+                         **NpmInstallCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_checkout/yarn_install.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostCheckout
+      class YarnInstall < Base
+        include YarnInstallCheck
+
+        check_definition key: 'yarn-install',
+                         hook: :post_checkout,
+                         description: 'Run yarn install when package.json or yarn.lock changed (branch checkout)',
+                         **YarnInstallCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_checkout.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostCheckout
+    end
+  end
+end
+
+require_relative 'post_checkout/bundle_install'
+require_relative 'post_checkout/db_migrate'
+require_relative 'post_checkout/npm_install'
+require_relative 'post_checkout/yarn_install'

data/lib/rails_git_hooks/checks/post_merge/bundle_install.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostMerge
+      class BundleInstall < Base
+        include BundleInstallCheck
+
+        check_definition key: 'bundle-install',
+                         hook: :post_merge,
+                         description: 'Run bundle install when Gemfile or Gemfile.lock changed (after merge)',
+                         **BundleInstallCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_merge/db_migrate.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostMerge
+      class DbMigrate < Base
+        include DbMigrateCheck
+
+        check_definition key: 'db-migrate',
+                         hook: :post_merge,
+                         description: 'Run db:migrate when migrations or schema changed (after merge)',
+                         **DbMigrateCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_merge/npm_install.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostMerge
+      class NpmInstall < Base
+        include NpmInstallCheck
+
+        check_definition key: 'npm-install',
+                         hook: :post_merge,
+                         description: 'Run npm install when package.json or package-lock.json changed (after merge)',
+                         **NpmInstallCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_merge/yarn_install.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostMerge
+      class YarnInstall < Base
+        include YarnInstallCheck
+
+        check_definition key: 'yarn-install',
+                         hook: :post_merge,
+                         description: 'Run yarn install when package.json or yarn.lock changed (after merge)',
+                         **YarnInstallCheck::DEFINITION_OPTIONS
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/post_merge.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PostMerge
+    end
+  end
+end
+
+require_relative 'post_merge/bundle_install'
+require_relative 'post_merge/db_migrate'
+require_relative 'post_merge/npm_install'
+require_relative 'post_merge/yarn_install'

data/lib/rails_git_hooks/checks/pre_commit/erblint.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class ErbLint < Base
+        check_definition key: 'erblint-check',
+                         hook: :pre_commit,
+                         description: 'Run erblint on staged ERB files',
+                         file_based: true,
+                         enabled: false,
+                         quiet: true,
+                         dependencies: { 'executables' => ['bundle'], 'libraries' => ['erblint'] },
+                         command: %w[bundle exec erblint],
+                         install_hint: 'Add `gem "erblint"` to your Gemfile and run bundle install'
+
+        def run
+          erb_files = applicable_files.select { |path| path.end_with?('.erb') && File.file?(path) }
+          return CheckResult.pass if erb_files.empty?
+
+          output, status = capture(*Array(config['command']), *erb_files)
+          return CheckResult.pass if status.success?
+
+          messages = output.split("\n").map(&:rstrip).reject(&:empty?)
+          CheckResult.fail(messages: messages)
+        end
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/pre_commit/eslint.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class Eslint < Base
+        JS_EXTENSIONS = %w[.js .jsx .mjs .cjs].freeze
+
+        check_definition key: 'eslint-check',
+                         hook: :pre_commit,
+                         description: 'Run eslint on staged JavaScript files',
+                         file_based: true,
+                         enabled: false,
+                         quiet: true,
+                         dependencies: { 'executables' => ['eslint'] },
+                         command: %w[eslint],
+                         install_hint: 'Install eslint (e.g. npm install -D eslint) or override command in config'
+
+        def run
+          js_files = applicable_files.select do |path|
+            File.file?(path) && JS_EXTENSIONS.include?(File.extname(path))
+          end
+          return CheckResult.pass if js_files.empty?
+
+          output, status = capture(*Array(config['command']), *js_files)
+          return CheckResult.pass if status.success?
+
+          messages = output.split("\n").map(&:rstrip).reject(&:empty?)
+          CheckResult.fail(messages: messages)
+        end
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/pre_commit/go_vet.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class GoVet < Base
+        check_definition key: 'go-vet-check',
+                         hook: :pre_commit,
+                         description: 'Run go vet on staged Go files',
+                         file_based: true,
+                         enabled: false,
+                         quiet: true,
+                         dependencies: { 'executables' => ['go'] },
+                         command: %w[go vet],
+                         install_hint: 'Ensure Go toolchain is installed and on PATH'
+
+        def run
+          go_files = applicable_files.select { |path| File.file?(path) && File.extname(path) == '.go' }
+          return CheckResult.pass if go_files.empty?
+
+          output, status = capture(*Array(config['command']), *go_files)
+          return CheckResult.pass if status.success?
+
+          messages = output.split("\n").map(&:rstrip).reject(&:empty?)
+          CheckResult.fail(messages: messages)
+        end
+      end
+    end
+  end
+end