Pr Watcher
@mgreten/pr-watcherv2026.06.27.2
01README
Autonomous PR-feedback investigation engine: watch a feed of pull-request feedback, spawn a coding agent to investigate each PR against its diff, propose actions, notify via ntfy with an Approve button, and optionally apply an approved fix inside an isolated worktree (build, test, push to the PR branch).
02Models
@mgreten/pr-watcherv2026.06.27.2pr_watcher.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| feedModel | string | |
| repoPath | string | |
| githubRepo | string | |
| repoDescription | string | |
| cliAgentModel | string | |
| ntfyTopic | string | |
| ntfyBaseUrl | string | |
| ntfyExtraTag | string | |
| investigateProvider | string | |
| investigateModelId | string | |
| investigateTimeoutMs | number | |
| tdPath | string | |
| todoistProject | string | |
| todoistLabel | string | |
| worktreeModel | string | |
| phaseRunnerModel | string | |
| approvalTopic | string | |
| suppressFixNotifications | boolean |
fn investigate(prNumber: number, eventIds?: array)
Investigate new feedback on a PR by spawning a coding agent via
| Argument | Type | Description |
|---|---|---|
| prNumber | number | PR number to investigate |
| eventIds? | array | Specific event IDs to investigate (defaults to all for the PR) |
fn investigateBatch(prNumbers: array)
Investigate new feedback on multiple PRs in a single execution.
| Argument | Type | Description |
|---|---|---|
| prNumbers | array | PR numbers to investigate in this batch |
fn notify(investigationId: string)
Send an ntfy notification summarizing an investigation with proposed
| Argument | Type | Description |
|---|---|---|
| investigationId | string | ID of the investigation to notify about |
fn approve(investigationId: string, decision: enum, userNote?: string)
Record a user decision (approve, reject, modify, defer) for an
| Argument | Type | Description |
|---|---|---|
| investigationId | string | |
| decision | enum | |
| userNote? | string |
fn act(investigationId: string)
Execute approved non-write actions for an investigation (draft
| Argument | Type | Description |
|---|---|---|
| investigationId | string |
fn executeWorktreeFix(investigationId: string)
Autonomously apply an approved push_fix inside a throwaway worktree,
| Argument | Type | Description |
|---|---|---|
| investigationId | string |
Resources
investigation(14d)— cli-agent investigation result with proposed actions for PR feedback
action(14d)— User decision record for an investigation (approved, rejected, modified)
fixRun(14d)— Audit record of a worktree-isolated autonomous push_fix execution:
03Previous Versions
2026.06.27.1Jun 27, 2026
2026.06.26.3Jun 27, 2026
Add suppressFixNotifications globalArg: lets a caller deliver the fix result notification itself (for quiet-hours deferral).
2026.06.26.2Jun 27, 2026
Fix: emoji in ntfy HTTP headers (Title/Actions) broke every notification with a ByteString error; emoji moved to ntfy tag names + body, asciiHeader() guard added.
2026.06.26.1Jun 27, 2026
Initial release: generic PR-feedback investigation engine (investigate, notify, approve, act) with opt-in worktree-isolated autonomous fixes.
04Stats
A
100 / 100
Downloads
3
Archive size
30.1 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms