rails_git_hooks 0.7.0 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b990407e471e8f6dddf8df8741a8ac6de92955bc44470b1b45a19b93644b542
-  data.tar.gz: ed3f378f82db9a1dc81dcf58d90f02d12da0ff32c05697ecc2f1dbb92f8db2ca
+  metadata.gz: 8f679908a499fe6aed2f61cf433d27bf93042bf0dcf1ecfe2e4854f05b0e7b9e
+  data.tar.gz: 481df290f21058504a14d0b6995854861ed7d15099b40a34ec9ccdf6f18fcf3c
 SHA512:
-  metadata.gz: 0b1aa8a31af84e697e05f56d94ff3427a0afa82e0dfabe4de21e5f0ec865f7ba6c7ddd0537f058e852281a415f68b26a063fd6ef8e71f0d0f1a0b7f9c718aa04
-  data.tar.gz: 966f4fbd5dcfac4ce1e4a9ad1d8a3f8209f0d2885030ece2d916c5598e2324aeac348f7bc8e9690e60bd3676fc995e264e0c2e2b1fd80e51cd1563d4cf3bb4d0
+  metadata.gz: 63518e1bcbca51fc17881473b90a0eb510eb2a6e62b26e6471e8890f8fd4e702392b6401f92124d4cd9cc1d398ad0aa03b3c9306a4ce34dc40313d6ab028da52
+  data.tar.gz: c549c30ca8f646f65bdf10a7281e0f2412bb8a796e0665a80e68c05cdac6ed0a39aed58f48011e23b3eba4622db43b6764bae103e434170a601938f4e5f8291e

data/CHANGELOG.md

@@ -4,11 +4,42 @@ 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.0] (latest)
+## [0.7.2]
 
 ### Added
 
-- **Pre-commit debugger check** — Warns (does not block) when staged files contain debugger statements: Ruby (`binding.pry`, `debugger`, `byebug`, `binding.irb`), JavaScript/TypeScript (`.js`, `.jsx`, `.ts`, `.tsx`, `.mjs`, `.cjs` — `debugger`), Python (`breakpoint()`, `pdb.set_trace()`, `ipdb.set_trace()`). On by default with pre-commit.
+- **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
+
+- **Code-first runtime architecture** — Hook behavior now lives in Ruby classes with a central runner, registry, policy resolver, dependency checker, and sparse override config loader.
+- **Sparse override config** — Added optional `.rails_git_hooks.yml` with Overcommit-style per-check overrides for `enabled`, `quiet`, `on_fail`, `on_warn`, `on_missing_dependency`, `include`, `exclude`, and `command`.
+- **Thin hook bootstraps** — `templates/hooks/*` now dispatch into the embedded `rails_git_hooks` runtime instead of loading copied script files per check.
+- **Pre-commit YAML format check** — Warns (does not block) when any staged `.yml` or `.yaml` file fails to parse (invalid YAML). Reports file and line from the parser. On by default with pre-commit.
+- **Pre-commit JSON format check** — Warns (does not block) when any staged `.json` file fails to parse (invalid JSON). Reports file and parser message. On by default with pre-commit.
+- **Pre-commit migrations check** — Warns (does not block) when: (a) migration file(s) are staged but neither `db/schema.rb` nor `db/structure.sql` is staged; (b) data migration file(s) in `db/data/` or `db/data_migrate/` are staged but `db/data_schema.rb` is not. **On by default.** Disable with `rails_git_hooks disable migrations-check`.
+- **Defaults YAML** — `lib/rails_git_hooks/config/defaults.yml` holds default settings for every check and hook. `DefaultsLoader` reads it; `OverrideConfig` uses it as the base when merging with `.rails_git_hooks.yml`. Edit the YAML to change built-in defaults.
+
+### Changed
+
+- **CLI redesign** — Replaced per-check flag-file commands with generic config-driven commands: `install`, `list`, `init`, `enable`, `disable`, `set`, and `show-config`.
+- **Manual install layout** — Manual install is via `bundle exec rails_git_hooks install` only; dropped `rake sync_hooks` and the repo `hooks/` tree.
+- **Dependency handling** — Checks can now declare executables, Ruby libraries, files, and install hints, with centralized `on_missing_dependency` policy handling.
+- **Runtime install** — Installer copies all runtime files (including `config/defaults.yml`), not only `*.rb`, into `.git/hooks/rails_git_hooks/`.
+- **Removed `hooks/` directory** — `/hooks/` added to `.gitignore`. README manual-install section updated.
+
+## [0.7.0]
 
 ### Changed
 
@@ -16,10 +47,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - **Constants:** Extracted `lib/rails_git_hooks/constants.rb` (GEM_ROOT, HOOKS_DIR, DEFAULT_HOOKS, FEATURE_FLAG_FILES). Installer and CLI use it. Single source of truth; no config file.
 - Gemspec includes `templates/**/*`. Version set to 0.7.0.
 
-### Fixed
-
-- **Hook scripts** — `RailsGitHooks::GIT_DIR` was set inside a `module` body, where the script’s local `git_dir` is out of scope (Ruby scope gate), causing `NameError` when hooks ran. All three hooks (commit-msg, pre-commit, pre-push) now set the constant via `RailsGitHooks.const_set(:GIT_DIR, git_dir.freeze)` from the script scope.
-
 ## [0.6.1]
 
 ### Changed

data/README.md

@@ -4,34 +4,38 @@
 [![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)
 
-Most useful git hooks for Rails and Ruby. Install only what you need. Turn hooks off anytime without uninstalling.
-
----
-
-## What’s included
-
-| Hook | Description |
-|------|-------------|
-| **commit-msg** | Adds `[TICKET-123]` to commit messages when your branch name contains a Jira ticket. |
-| **pre-commit** | Blocks commits to `master`/`main`. Warns about debugger statements (Ruby, JS/TS, Python). Optional: RuboCop, trailing-whitespace/conflict checks. |
-| **pre-push** | Runs `bundle exec rspec` before push and blocks push if tests fail. |
-
-- **Installed by default:** `commit-msg` and `pre-commit` (branch protection + debugger warnings; RuboCop and whitespace checks are off).
-- **Optional:** `pre-push`, RuboCop, and whitespace/conflict checks — enable when you want them.
-
----
+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
+
+| 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]`). |
+| **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-push**   | `run-tests`          | Off     | Run test suite before push (default: `bundle exec rspec`). Enable in config to install pre-push. |
+| **post-checkout** | `bundle-install`   | ✅      | Run `bundle install` when Gemfile or Gemfile.lock changed after a branch checkout. |
+| **post-checkout** | `db-migrate`       | ✅      | Run `rails db:migrate` when migrations or schema changed after a branch checkout. |
+| **post-merge** | `bundle-install`     | ✅      | Run `bundle install` when Gemfile or Gemfile.lock changed after a merge. |
+| **post-merge** | `db-migrate`        | ✅      | Run `rails db:migrate` when migrations or schema changed after a merge. |
 
 ## Quick start
 
-### 1. Install the gem
+### 1. Add the gem
 
-**Standalone:**
-
-```bash
-gem install rails_git_hooks
-```
-
-**With Bundler** — add to your `Gemfile`:
+**Gemfile:**
 
 ```ruby
 gem "rails_git_hooks"
@@ -43,121 +47,74 @@ Then:
 bundle install
 ```
 
+Or install globally: `gem install rails_git_hooks`.
+
 ### 2. Install hooks
 
-From your project root (inside the git repo):
+From your project root:
 
 ```bash
 bundle exec rails_git_hooks install
 ```
 
-This installs **commit-msg** and **pre-commit** (default-branch protection only). No Jira project key needed — the hook detects ticket IDs like `APD-123` or `PROJ-456` from the branch name.
+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).
 
-### 3. Optional: add more
+## Configuration
 
-```bash
-# Run tests before every push
-rails_git_hooks install pre-push
-
-# Run RuboCop on staged .rb files before commit
-rails_git_hooks enable rubocop-check
-
-# Reject trailing whitespace and conflict markers in staged files
-rails_git_hooks enable whitespace-check
-```
-
-**Tip:** If a hook doesn’t run, make it executable: `chmod +x .git/hooks/<hook-name>`
+### Priority (low → high)
 
----
+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)
 
-## Command reference
-
-All commands are run from the project root.
-
-| Command | Description |
-|---------|-------------|
-| `rails_git_hooks install [HOOK...]` | Install hooks. No arguments = install default (commit-msg + pre-commit). |
-| `rails_git_hooks list` | List available hook names. |
-| `rails_git_hooks disable HOOK [...]` | Disable hooks or options (use `*` for all). |
-| `rails_git_hooks enable HOOK [...]` | Re-enable hooks or enable optional checks. |
-| `rails_git_hooks disabled` | Show currently disabled hooks. |
-
-**Common examples:**
+**Create the main override file:**
 
 ```bash
-rails_git_hooks install                    # default hooks
-rails_git_hooks install pre-push          # add pre-push
-rails_git_hooks disable pre-commit        # turn off pre-commit temporarily
-rails_git_hooks disable *                 # turn off all
-rails_git_hooks enable pre-commit         # turn pre-commit back on
-rails_git_hooks enable rubocop-check      # run RuboCop on staged .rb files
-rails_git_hooks enable whitespace-check   # reject trailing ws & conflict markers
+bundle exec rails_git_hooks init
 ```
 
-Disabled state is stored in `.git/rails_git_hooks_disabled` and persists until you run `enable`.
-
----
+**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.
 
-## Hooks in detail
+### Example override file
 
-### commit-msg — Jira ticket prefix
+```yaml
+PreCommit:
+  DebuggerCheck:
+    on_fail: fail
 
-**What it does:** If the branch name contains a Jira-style ticket (e.g. `task/APD-1234/fix-bug`), the hook prepends `[APD-1234]` to the commit message — unless the message already starts with that format. Works with any project key (2–5 letters + digits); no config.
-
-**Example:**
-
-- Branch: `task/APD-1234/fix-bug`
-- Command: `git commit -m 'fix bug'`
-- Result: **`[APD-1234] fix bug`**
-
----
-
-### pre-commit — Branch protection and optional checks
-
-**Always on (when installed):**
-
-- Blocks commits to `master` or `main`. You must commit from a feature branch.
-- **Debugger check** — Warns (does not block) when staged files contain debugger statements: Ruby (`binding.pry`, `debugger`, `byebug`, `binding.irb`), JavaScript/TypeScript (`.js`, `.jsx`, `.ts`, `.tsx` — `debugger`), Python (`breakpoint()`, `pdb.set_trace()`, `ipdb.set_trace()`).
-
-**Optional (off by default):**
-
-1. **RuboCop** — Run RuboCop on staged `.rb` files; commit fails if there are offenses.  
-   `rails_git_hooks enable rubocop-check` / `disable rubocop-check`. Requires the `rubocop` gem.
-
-2. **Whitespace & conflict markers** — Reject commits that add trailing spaces/tabs or `<<<<<<<` / `=======` / `>>>>>>>` in staged files.  
-   `rails_git_hooks enable whitespace-check` / `disable whitespace-check`.
-
----
-
-### pre-push — Run tests before push
-
-Runs `bundle exec rspec` before every `git push`. If the suite fails, the push is aborted. Not installed by default; add with `rails_git_hooks install pre-push`. For Minitest, edit the hook to use `bundle exec rake test`.
-
----
-
-## Manual installation (without the gem)
+  RuboCop:
+    enabled: true
+    quiet: true
+    include:
+      - "app/**/*.rb"
+      - "lib/**/*.rb"
+    exclude:
+      - "db/schema.rb"
+```
 
-Copy the **entire** `hooks/` directory into your repo’s `.git/hooks/` (so the hook scripts and the `pre_commit/`, `commit_msg/`, `pre_push/` subdirs are all under `.git/hooks/`). Run `rake sync_hooks` to regenerate `hooks/` from `templates/hooks/` and `templates/shared/`.
+### Per-check options
 
-| Script | Notes |
-|--------|--------|
-| [commit-msg](hooks/commit-msg) | Jira-style ticket prefix; no config. |
-| [pre-commit](hooks/pre-commit) | Branch protection + debugger warnings; optional RuboCop (requires `rubocop` gem). |
-| [pre-push](hooks/pre-push) | Runs `bundle exec rspec`; edit for Minitest if needed. |
+| 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. |
 
----
+## CLI reference
 
-## Development
+| Command | Description |
+|---------|--------------|
+| `rails_git_hooks install` | Install hooks that have at least one enabled check in the merged config (defaults + .rails_git_hooks.yml + .rails_git_hooks.local.yml). |
+| `rails_git_hooks init` | Create an empty `.rails_git_hooks.yml`. |
 
-```bash
-bundle install
-bundle exec rake              # run specs
-bundle exec rake build        # build the gem
-bundle exec rake install      # install locally
-bundle exec rake sync_hooks   # copy templates (hooks + shared subdirs) → hooks/
-```
+## Contributing
 
----
+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/base.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'open3'
+require 'yaml'
+
+module GitHooks
+  module Checks
+    class Base
+      class << self
+        attr_reader :definition
+
+        def check_definition(key:, hook:, description:, config_name: name.split('::').last, **options)
+          @definition = CheckDefinition.new(
+            key: key,
+            config_name: config_name,
+            hook: hook,
+            klass: self,
+            description: description,
+            **options
+          )
+        end
+      end
+
+      attr_reader :config, :context
+
+      def initialize(config:, context:)
+        @config = config
+        @context = context
+      end
+
+      private
+
+      def repo
+        context.fetch(:repo)
+      end
+
+      def applicable_files
+        context.fetch(:applicable_files, [])
+      end
+
+      def argv
+        context.fetch(:argv, [])
+      end
+
+      def stdin
+        context.fetch(:stdin, '')
+      end
+
+      def capture(*command)
+        Open3.capture2e(*command, chdir: repo.root)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module CommitMsg
+      class JiraPrefix < Base
+        TICKET_PATTERN = /([A-Z]{2,5}-\d+)/.freeze
+
+        check_definition key: 'jira-prefix',
+                         hook: :commit_msg,
+                         description: 'Prefix commit messages with ticket id from branch'
+
+        def run
+          message_file = argv.first
+          return CheckResult.pass unless message_file && File.file?(message_file)
+
+          branch = repo.current_branch
+          ticket = branch[TICKET_PATTERN, 1]
+          return CheckResult.pass unless ticket
+
+          message = File.read(message_file)
+          prefix = "[#{ticket}]"
+          return CheckResult.pass if message.lstrip.start_with?(prefix)
+
+          File.write(message_file, "#{prefix} #{message}")
+          CheckResult.pass
+        end
+      end
+    end
+  end
+end

data/lib/rails_git_hooks/checks/commit_msg.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module CommitMsg
+    end
+  end
+end
+
+require_relative 'commit_msg/jira_prefix'

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.rb

@@ -0,0 +1,11 @@
+# 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'

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.rb

@@ -0,0 +1,11 @@
+# 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'

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class DebuggerCheck < Base
+        DEBUGGER_PATTERNS = {
+          '.rb' => [/\bbinding\.pry\b/, /\bbinding\.irb\b/, /\bdebugger\b/, /\bbyebug\b/],
+          '.js' => [/\bdebugger\s*;?/],
+          '.jsx' => [/\bdebugger\s*;?/],
+          '.ts' => [/\bdebugger\s*;?/],
+          '.tsx' => [/\bdebugger\s*;?/],
+          '.mjs' => [/\bdebugger\s*;?/],
+          '.cjs' => [/\bdebugger\s*;?/],
+          '.py' => [/\bbreakpoint\s*\(\s*\)/, /\bpdb\.set_trace\s*\(\s*\)/, /\bipdb\.set_trace\s*\(\s*\)/]
+        }.freeze
+
+        check_definition key: 'debugger-check',
+                         hook: :pre_commit,
+                         description: 'Warn on debugger statements',
+                         file_based: true,
+                         on_fail: :warn
+
+        def run
+          warnings = []
+
+          applicable_files.each do |path|
+            next unless File.file?(path)
+
+            patterns = DEBUGGER_PATTERNS[File.extname(path)]
+            next unless patterns
+
+            File.read(path).lines.each_with_index do |line, index|
+              warnings << "#{path}:#{index + 1}: debugger statement" if patterns.any? { |pattern| line.match?(pattern) }
+            end
+          end
+
+          warnings.empty? ? CheckResult.pass : CheckResult.fail(messages: warnings.uniq)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class DefaultBranch < Base
+        check_definition key: 'default-branch',
+                         hook: :pre_commit,
+                         description: 'Prevent commits on default branch'
+
+        def run
+          branch = repo.current_branch
+          return CheckResult.pass unless %w[master main].include?(branch)
+
+          CheckResult.fail(messages: ["Commits on '#{branch}' are not allowed. Create a feature branch."])
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class JSONFormatCheck < Base
+        check_definition key: 'json-format-check',
+                         hook: :pre_commit,
+                         description: 'Warn on invalid JSON',
+                         file_based: true,
+                         on_fail: :warn
+
+        def run
+          warnings = []
+
+          applicable_files.each do |path|
+            next unless File.file?(path)
+            next unless File.extname(path) == '.json'
+
+            JSON.parse(File.read(path))
+          rescue JSON::ParserError => e
+            warnings << "#{path}: #{e.message}"
+          end
+
+          warnings.empty? ? CheckResult.pass : CheckResult.fail(messages: warnings)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module GitHooks
+  module Checks
+    module PreCommit
+      class MigrationsCheck < Base
+        check_definition key: 'migrations-check',
+                         hook: :pre_commit,
+                         description: 'Warn on missing schema files after migrations',
+                         file_based: true,
+                         on_fail: :warn
+
+        def run
+          messages = []
+          migration_files = applicable_files.grep(%r{\Adb/migrate/.*\.rb\z})
+          schema_staged = applicable_files.include?('db/schema.rb') || applicable_files.include?('db/structure.sql')
+
+          if migration_files.any? && !schema_staged
+            messages << 'Migration file(s) are staged but neither db/schema.rb nor db/structure.sql is staged.'
+            messages << 'Run `rails db:migrate` and add db/schema.rb (or db/structure.sql) to your commit.'
+            migration_files.each { |path| messages << "- #{path}" }
+          end
+
+          data_migration_files = applicable_files.grep(%r{\Adb/(data/|data_migrate/).*\.rb\z})
+          data_schema_staged = applicable_files.include?('db/data_schema.rb')
+          if data_migration_files.any? && !data_schema_staged
+            messages << 'Data migration file(s) are staged but db/data_schema.rb is not staged.'
+            messages << 'Run your data migrate task and add db/data_schema.rb to your commit.'
+            data_migration_files.each { |path| messages << "- #{path}" }
+          end
+
+          messages.empty? ? CheckResult.pass : CheckResult.fail(messages: messages)
+        end
+      end
+    end
+  end
+end