agent-reviews 0.3.0 → 0.3.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-reviews",
   "description": "Manage GitHub PR review comments from Claude Code. Automatically triage, fix, and respond to bot findings.",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "author": {
     "name": "Paul Bakaus",
     "url": "https://github.com/pbakaus"

package/bin/agent-reviews.js

@@ -362,12 +362,6 @@ async function main() {
       process.exit(1);
     }
 
-    if (!options.json) {
-      console.log(
-        `${colors.dim}Finding PR for branch: ${branch}...${colors.reset}`
-      );
-    }
-
     const pr = await findPRForBranch(
       repoInfo.owner,
       repoInfo.repo,
@@ -396,12 +390,6 @@ async function main() {
       process.exit(1);
     }
 
-    if (!options.json) {
-      console.log(
-        `${colors.dim}Replying to comment ${options.replyTo}...${colors.reset}`
-      );
-    }
-
     const result = await replyToComment(
       repoInfo.owner,
       repoInfo.repo,
@@ -433,12 +421,6 @@ async function main() {
       process.exit(1);
     }
 
-    if (!options.json) {
-      console.log(
-        `${colors.dim}Fetching comments for PR #${prNumber}...${colors.reset}`
-      );
-    }
-
     const rawData = await fetchPRComments(
       repoInfo.owner,
       repoInfo.repo,
@@ -476,12 +458,6 @@ async function main() {
   }
 
   // Default: fetch and display comments
-  if (!options.json) {
-    console.log(
-      `${colors.dim}Fetching comments for PR #${prNumber}...${colors.reset}`
-    );
-  }
-
   const rawData = await fetchPRComments(
     repoInfo.owner,
     repoInfo.repo,
@@ -495,9 +471,6 @@ async function main() {
 
   console.log(formatOutput(filtered, options));
 
-  if (!options.json && prUrl) {
-    console.log(`\n${colors.dim}PR: ${prUrl}${colors.reset}`);
-  }
 }
 
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-reviews",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "CLI and Claude Code skill for managing GitHub PR review comments. List, filter, reply, and watch for bot findings.",
   "license": "MIT",
   "author": "Paul Bakaus",

package/skills/agent-reviews/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: agent-reviews
-description: Review and fix PR review bot findings on current PR, loop until resolved
-allowed-tools: Bash(node scripts/agent-reviews.js *), Bash(gh *), Bash(git *), Read, Glob, Grep, Edit, Write, AskUserQuestion, Task, TaskOutput
+description: Review and fix PR review bot findings on current PR, loop until resolved. Fetches unanswered bot comments, evaluates each finding, fixes real bugs, dismisses false positives, and replies to every comment with the outcome.
+license: MIT
+compatibility: Requires git and gh (GitHub CLI) installed. Designed for Claude Code.
+metadata:
+  author: pbakaus
+  version: "0.3.1"
+  homepage: https://github.com/pbakaus/agent-reviews
+allowed-tools: Bash(scripts/agent-reviews.js *), Bash(gh *), Bash(git *), Read, Glob, Grep, Edit, Write, AskUserQuestion, Task, TaskOutput
 ---
 
 Automatically review, fix, and respond to findings from PR review bots on the current PR. Uses a deterministic two-phase workflow: first fix all existing issues, then poll once for new ones.
@@ -19,12 +25,12 @@ If no PR exists, notify the user and exit.
 ### Step 2: Fetch All Bot Comments
 
 ```bash
-node scripts/agent-reviews.js --bots-only --json
+scripts/agent-reviews.js --bots-only --unanswered
 ```
 
-Parse the JSON output. Count how many have `hasAnyReply: false` (unanswered).
+This shows only unanswered bot comments. Each comment shows its ID in brackets (e.g., `[12345678]`), the author, file path, and a truncated body.
 
-If zero unanswered comments, print "No unanswered bot comments found" and skip to Phase 2.
+If zero comments are returned, print "No unanswered bot comments found" and skip to Phase 2.
 
 ### Step 3: Process Each Unanswered Comment
 
@@ -33,16 +39,11 @@ For each comment where `hasAnyReply === false`:
 #### A. Get Full Detail
 
 ```bash
-node scripts/agent-reviews.js --detail <comment_id>
+scripts/agent-reviews.js --detail <comment_id>
 ```
 
 This shows the full comment body (no truncation), the diff hunk (code context), and all replies. Use this instead of `gh` CLI for comment details.
 
-For structured data, use:
-```bash
-node scripts/agent-reviews.js --detail <comment_id> --json
-```
-
 #### B. Evaluate the Finding
 
 Read the referenced code and determine:
@@ -103,21 +104,21 @@ Now that the commit hash exists, reply to every processed comment:
 
 **For each TRUE POSITIVE:**
 ```bash
-node scripts/agent-reviews.js --reply <comment_id> "Fixed in {hash}.
+scripts/agent-reviews.js --reply <comment_id> "Fixed in {hash}.
 
 {Brief description of the fix}"
 ```
 
 **For each FALSE POSITIVE:**
 ```bash
-node scripts/agent-reviews.js --reply <comment_id> "Won't fix: {reason}
+scripts/agent-reviews.js --reply <comment_id> "Won't fix: {reason}
 
 {Explanation of why this is intentional or not applicable}"
 ```
 
 **For each SKIPPED:**
 ```bash
-node scripts/agent-reviews.js --reply <comment_id> "Skipped per user request"
+scripts/agent-reviews.js --reply <comment_id> "Skipped per user request"
 ```
 
 **DO NOT start Phase 2 until all replies are posted.**
@@ -131,7 +132,7 @@ node scripts/agent-reviews.js --reply <comment_id> "Skipped per user request"
 Launch the watcher in the background. It polls every 30 seconds and exits after 10 minutes of inactivity (no new comments):
 
 ```bash
-node scripts/agent-reviews.js --watch --bots-only
+scripts/agent-reviews.js --watch --bots-only
 ```
 
 This runs as a background task.

package/skills/agent-reviews/scripts/agent-reviews.js

@@ -320,7 +320,7 @@ async function main() {
   const options = parseArgs();
 
   if (options.version) {
-    console.log("0.3.0");
+    console.log("0.3.1");
     process.exit(0);
   }
 
@@ -361,12 +361,6 @@ async function main() {
       process.exit(1);
     }
 
-    if (!options.json) {
-      console.log(
-        `${colors.dim}Finding PR for branch: ${branch}...${colors.reset}`
-      );
-    }
-
     const pr = await findPRForBranch(
       repoInfo.owner,
       repoInfo.repo,
@@ -395,12 +389,6 @@ async function main() {
       process.exit(1);
     }
 
-    if (!options.json) {
-      console.log(
-        `${colors.dim}Replying to comment ${options.replyTo}...${colors.reset}`
-      );
-    }
-
     const result = await replyToComment(
       repoInfo.owner,
       repoInfo.repo,
@@ -432,12 +420,6 @@ async function main() {
       process.exit(1);
     }
 
-    if (!options.json) {
-      console.log(
-        `${colors.dim}Fetching comments for PR #${prNumber}...${colors.reset}`
-      );
-    }
-
     const rawData = await fetchPRComments(
       repoInfo.owner,
       repoInfo.repo,
@@ -475,12 +457,6 @@ async function main() {
   }
 
   // Default: fetch and display comments
-  if (!options.json) {
-    console.log(
-      `${colors.dim}Fetching comments for PR #${prNumber}...${colors.reset}`
-    );
-  }
-
   const rawData = await fetchPRComments(
     repoInfo.owner,
     repoInfo.repo,
@@ -494,9 +470,6 @@ async function main() {
 
   console.log(formatOutput(filtered, options));
 
-  if (!options.json && prUrl) {
-    console.log(`\n${colors.dim}PR: ${prUrl}${colors.reset}`);
-  }
 }
 
 main().catch((error) => {