pv-review

Bitbucket PR review assistant for VS Code. Fetches pull request comments from Bitbucket Cloud, parses structured TYPE/SEVERITY: prefixes, and displays them in a sidebar tree view with inline editor decorations.

Installation

1. Build and package the extension:

   make build-vscode-review
   make package-vscode-review
   

2. Install the .vsix file: Extensions → ··· → Install from VSIX...

Authentication Setup

pv-review uses Bitbucket Cloud App Passwords for API access.

1. Create an App Password at Bitbucket → Personal settings → App passwords
   • Required permission: Pull requests → Read
2. Set your Bitbucket username in VS Code settings:
   • Settings → search pvReview.bitbucketUsername → enter your username
3. Store your app password:
   • Command Palette → pv-review: Set Bitbucket Credentials
   • The password is stored securely using VS Code's SecretStorage

Usage

1. Click the comment-discussion icon in the Activity Bar to open the PR Review sidebar
2. Paste a Bitbucket PR URL into the input field and click Open
   • Format: https://bitbucket.org/{workspace}/{repo}/pull-requests/{id}
3. Comments load into the tree view grouped by type and severity
4. Click any inline comment to jump to the file and line in your editor
5. Grey inline decorations appear on commented lines showing the comment summary

Commands

Comment Format

Comments with a TYPE/SEVERITY: prefix are grouped into structured categories.

Types

Severities

Examples

COD/A: Fix null pointer dereference on empty input
SOL/B: Consider using a factory pattern here instead
ARC/C: This could be extracted into a shared service later

Comments without a prefix appear in the General section.

Tree Structure

├── COD (Code)
│   ├── A — Must Fix (2)
│   │   ├── [COD/A] Fix null check — @reviewer  src/utils.py:42
│   │   └── ...
│   ├── B — Should Fix (1)
│   └── C — Suggestion (3)
├── SOL (Solution)
│   └── ...
├── General (5)
├── ▸ Outdated (4)          ← collapsed by default
└── ▸ Resolved (7)          ← collapsed by default

Settings