fix: change agent hook default from PostToolBatch/postToolUse to Stop/stop

[skoshx]

Summary

Changes the default agent hook timing from PostToolBatch/postToolUse to Stop/stop for better performance and token efficiency.

Problem

On long agent sessions with many uncommitted files, react-doctor was running after every tool batch (Claude) or tool use (Cursor), causing ~4s scans repeatedly throughout the session. This was:

• Token inefficient (agent sees output many times)
• Slow (multiple 4s delays per session)
• Poor UX for users working on larger changes

Solution

Install hooks on the Stop/stop event instead, which fires once when the agent finishes responding. Benefits:

• Runs once at session end instead of many times during
• More token efficient
• Faster overall
• --scope changed already filters to edited files, so no tool filtering needed

Changes

• Claude Code: PostToolBatch → Stop
• Cursor: postToolUse → stop
• Removed tool name filtering (no longer needed)
• Updated hook script output format for Stop event (followup_message)
• Strip legacy hooks from both old and new event types during install
• Updated all tests

Closes #1647

  

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/eslint-plugin-react-doctor@1648

npm i https://pkg.pr.new/oxlint-plugin-react-doctor@1648

npm i https://pkg.pr.new/react-doctor@1648

commit: a4e47e8

[github-actions]

React Doctor found no new issues. 🎉

_{Reviewed by React Doctor for commit a4e47e8.}

[github-actions]

Interactive terminal E2E

Terminal Control verified the built CLI at a4e47e8 in a real PTY:

• selected a project interactively and observed Scanning... before the three-second Git delay completed
• waited for the clean result and exercised the compact report
• opened copy context and the GitHub Actions confirmation, then cancelled safely

Download the edited MP4 and PNG evidence