Skip to content

v0.1.0

Choose a tag to compare

@karlkfi karlkfi released this 05 Jul 21:41
· 60 commits to main since this release
1edb938

First tagged release of pr-sentinel — a Claude Code plugin that wakes your session on CI failures and merge conflicts, without foreground polling and without ingesting the PR comment channel.

What's in it

  • Background watcher (scripts/pr-sentinel-watch.sh) — polls gh per-PR and wakes the session when a check fails, a conflict appears, the PR goes green, or the PR closes. Reads GitHub-controlled metadata only; never queries the PR body or comments.
  • PostToolUse hook (scripts/pr-sentinel-hook.py) — nudges the session to launch the watcher after gh pr create / git push.
  • Stop-hook backstop — blocks the stop once when the session has an open PR with pending required checks and no live watcher.
  • PreToolUse foreground-poll deny — denies gh pr checks --watch, gh run watch, and until/while … sleep poll loops, pointing at the watcher instead (with a PR_SENTINEL_OVERRIDE escape hatch).

Security posture

  • No ingestion of PR/issue comments or the PR body (the injection channel, excluded by design).
  • No auto-merge — human merge review stays the trust boundary.
  • CI log excerpts are size-capped, ANSI-stripped, and framed as data, not instructions.

Deferred to later minor releases

  • Friction/activity report (Q3)
  • Distinguishing required vs optional checks (Q4)