v0.1.0
Initial release: a PreToolUse hook for Bash that guards the session's main-thread time.
Class A catches foreground polling/watching — gh pr checks --watch, gh run watch, kubectl logs -f / get -w, tail -f, journalctl -f, docker logs -f, watch, sleep-polling loops, repeat-with-sleep chains, and bare sleep at or above a configurable floor — and prompts ask (config may escalate to deny). Class B catches commands the repo has registered as slow when they are about to run with an inadequate Bash-call timeout, naming the exact fix; its registry ships empty and is populated per-repo in .claude/foreground-guard.json. Exemptions: run_in_background: true, a detaching &, and timeout N wraps. The hook never emits allow, so it composes with the sibling guards; FOREGROUND_GUARD_OVERRIDE=<reason> downgrades a config-escalated deny to a confirmation prompt.
Full Changelog: https://github.com/karlkfi/claude-foreground-guard/commits/v0.1.0