pr_comments 0.2.1

Fetch GitHub PR comments via CLI and MCP
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# CLAUDE.md - pr_comments Tool

## Overview
The pr_comments tool fetches GitHub PR comments with support for filtering by resolution status on review comments.

## Key Implementation Details
- Uses hybrid REST + GraphQL approach for resolution filtering
- Only `get_review_comments` supports resolution filtering
- Default behavior: show only unresolved comments (breaking change in v0.2.0)
- `get_all_comments` always includes all review comments regardless of resolution

## Common Commands
```bash
# Run tests
make test

# Check for linting issues
make check

# Build the tool
make build

# Install locally
make install
```

## Testing Resolution Filtering
```bash
# Test with a PR that has resolved comments
pr_comments review-comments --pr 123  # Shows only unresolved
pr_comments review-comments --pr 123 --include-resolved  # Shows all
pr_comments all --pr 123  # Shows all comments (no filtering)
```

## Architecture Notes
- GraphQL query runs only when filtering resolved comments (performance optimization)
- Comment IDs are matched between REST and GraphQL APIs via database_id field
- Pagination is handled for both REST and GraphQL queries
- If a comment isn't found in the GraphQL response, it's included by default (fail-open)