feat(stack): add git hooks with sourcing architecture

[jd]

Implement a new hook structure that separates user-modifiable wrappers
from managed scripts:

• .git/hooks/{hook} - Thin wrapper (user can add custom logic)
• .git/hooks/mergify-hooks/{hook}.sh - Managed script (auto-upgradable)

This allows automatic upgrades of hook logic without touching user
customizations. Legacy hooks are detected and can be migrated with
--force flag.

CLI changes:

• mergify stack setup --force: Force reinstall wrappers
• mergify stack setup --check: Check status without changes
• mergify stack push --no-upgrade-hooks: Skip auto-upgrade

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

[jd]

This pull request is part of a stack:

1. feat(stack): add git hooks with sourcing architecture (#926) 👈
2. feat(stack): add hooks subcommand for status display (#933)
3. refactor(stack): extract _get_hooks_dir() helper (#934)
4. refactor(stack): extract _get_script_resource_path() helper (#935)
5. refactor(stack): use as_file() for package resource copying (#937)

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 🤖 Continuous Integration

Wonderful, this rule succeeded.

• all of:
  • check-success=ci-gate

🟢 👀 Review Requirements

Wonderful, this rule succeeded.

• any of:
  • #approved-reviews-by>=2
  • author = dependabot[bot]
  • author = mergify-ci-bot
  • author = renovate[bot]

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?:

🟢 🔎 Reviews

Wonderful, this rule succeeded.

• #changes-requested-reviews-by = 0
• #review-requested = 0
• #review-threads-unresolved = 0

🟢 📕 PR description

Wonderful, this rule succeeded.

• body ~= (?ms:.{48,})

[mergify]

🧪 CI Insights

Here's what we observed from your CI run for 3a3cb1c.

🟢 All jobs passed!

But CI Insights is watching 👀

Pull request has been modified.

[mergify]

@jd this pull request is now in conflict 😩

[Copilot]

Pull request overview

Adds a new Git hook “sourcing” architecture so hook logic can be upgraded automatically without overwriting user-customized wrappers.

Changes:

• Introduces wrapper hooks in .git/hooks/{hook} that source managed scripts in .git/hooks/mergify-hooks/{hook}.sh.
• Updates stack setup to support --force and --check, and adds automatic managed-script upgrades via stack push (toggleable with --no-upgrade-hooks).
• Refactors hook installation/update logic and adjusts tests/fixtures accordingly.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
mergify_cli/tests/conftest.py	Updates test fixture to install wrapper + managed script layout.
mergify_cli/stack/setup.py	Implements new install/update/check flows for wrappers + managed scripts; adds auto-upgrade helper.
mergify_cli/stack/hooks/wrappers/prepare-commit-msg	Adds new wrapper that sources the managed script and provides a user customization section.
mergify_cli/stack/hooks/wrappers/commit-msg	Adds new wrapper that sources the managed script and provides a user customization section.
mergify_cli/stack/hooks/scripts/prepare-commit-msg.sh	Converts hook logic to be sourced (replaces early exit with return) and adds header.
mergify_cli/stack/hooks/scripts/commit-msg.sh	Converts hook logic to be sourced (replaces exit with return) and adds header.
mergify_cli/stack/cli.py	Adds CLI flags for setup/check/force and push hook auto-upgrade control.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mergify]

Merge Queue Status

✅ The pull request has been merged at 3a3cb1c

This pull request spent 8 seconds in the queue, with no time running CI.
The checks were run in-place.

Required conditions to merge

• all of [🛡 Merge Protections rule Enforce conventional commit]:
  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?:
    • feat(stack): add git hooks with sourcing architecture #926
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by>=2
      • feat(stack): add git hooks with sourcing architecture #926
    • author = dependabot[bot]
      • feat(stack): add git hooks with sourcing architecture #926
    • author = mergify-ci-bot
      • feat(stack): add git hooks with sourcing architecture #926
    • author = renovate[bot]
      • feat(stack): add git hooks with sourcing architecture #926
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • feat(stack): add git hooks with sourcing architecture #926
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • feat(stack): add git hooks with sourcing architecture #926
  • #review-requested = 0
    • feat(stack): add git hooks with sourcing architecture #926
  • #review-threads-unresolved = 0
    • feat(stack): add git hooks with sourcing architecture #926
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success=ci-gate