Add hooks-based real-time waste monitor

[lgriffin]

Summary

• Adds ter hook monitor CLI subcommand that acts as a Claude Code PostToolUse hook handler
• Detects 5 waste patterns in real-time (bash antipatterns, repetitive reads, edit fragmentation, duplicate tool calls, repeated commands) using pure stdlib — no embeddings, starts in milliseconds
• Returns additionalContext (guidance for Claude) and systemMessage (notification for the user) when waste is detected
• Includes SessionStart hook example so users see "TER Waste Monitor active" on launch
• 61 unit tests, all passing

How to use

Add to any project's .claude/settings.json:

{
  "hooks": {
    "SessionStart": [{"hooks": [{"type": "command", "command": "python -c \"import json; print(json.dumps({'systemMessage': 'TER Waste Monitor active'}))\"", "timeout": 5}]}],
    "PostToolUse": [{"matcher": "Bash|Read|Edit|Write|Glob|Grep", "hooks": [{"type": "command", "command": "ter hook monitor", "timeout": 15, "statusMessage": "TER checking for waste..."}]}]
  }
}

See docs/hooks-guide.md for full setup, threshold tuning, and troubleshooting.

Test plan

• pytest tests/unit/test_hook_monitor.py — 61 tests passing
• ruff check — clean
• Manual end-to-end: pipe hook JSON through ter hook monitor, verify output
• Tested in live Claude Code session on separate project (eveomni) — SessionStart message confirmed visible

🤖 Generated with Claude Code