feat(stack): add hooks subcommand for status display

[jd]

Add a new stack hooks command that displays the status of both git
hooks and Claude hooks. The existing stack setup command becomes an
alias for stack hooks --setup.

• mergify stack hooks shows detailed status of all hooks
• mergify stack hooks --setup installs/upgrades hooks
• mergify stack hooks --setup --force forces wrapper reinstall
• mergify stack setup works as before (backwards compatible)
• mergify stack setup --check shows status (deprecated in favor of hooks)

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

[jd]

This pull request is part of a stack:

1. feat(stack): add hooks subcommand for status display (#933) 👈
2. refactor(stack): extract _get_hooks_dir() helper (#934)
3. refactor(stack): extract _get_script_resource_path() helper (#935)
4. 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 22edf5f.

🟢 All jobs passed!

But CI Insights is watching 👀

[mergify]

@jd this pull request is now in conflict 😩

Pull request has been modified.

[Copilot]

Pull request overview

This PR adds a new stack hooks subcommand that displays the status of both git hooks and Claude hooks, improving the user experience by providing better visibility into hook installation state. The existing stack setup command is preserved as an alias for backwards compatibility.

Changes:

• Added new stack hooks command to display detailed hook status and optionally install/upgrade hooks with --setup flag
• Refactored setup.py to extract helper functions (_get_hook_command, _read_claude_settings, _claude_script_needs_update, _get_claude_hook_scripts) for better code organization
• Added get_hooks_status() and _get_claude_hooks_status() functions to gather detailed status information
• Maintained backwards compatibility by making stack setup an alias that calls the same underlying functions

Reviewed changes

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

File	Description
mergify_cli/tests/stack/test_setup.py	Added comprehensive tests for the new get_hooks_status() function and CLI commands, testing various hook installation states and command interactions
mergify_cli/stack/setup.py	Refactored to extract helper functions, added status-checking functions, and removed the check_only parameter from stack_setup()
mergify_cli/stack/cli.py	Added new hooks command with status display and setup functionality, updated setup command to delegate to new functions

---

💡 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 22edf5f

This pull request spent 14 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 hooks subcommand for status display #933
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by>=2
      • feat(stack): add hooks subcommand for status display #933
    • author = dependabot[bot]
      • feat(stack): add hooks subcommand for status display #933
    • author = mergify-ci-bot
      • feat(stack): add hooks subcommand for status display #933
    • author = renovate[bot]
      • feat(stack): add hooks subcommand for status display #933
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • feat(stack): add hooks subcommand for status display #933
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • feat(stack): add hooks subcommand for status display #933
  • #review-requested = 0
    • feat(stack): add hooks subcommand for status display #933
  • #review-threads-unresolved = 0
    • feat(stack): add hooks subcommand for status display #933
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success=ci-gate