agent-reviews 1.0.0 → 1.0.2

package/.claude-plugin/plugin.json

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

package/README.md

@@ -53,6 +53,20 @@ For cloud/remote environments or HTTPS proxy setups, set `GITHUB_TOKEN` or `GH_T
 3. `.env.local` in the repo root
 4. `gh auth token` (GitHub CLI)
 
+### Custom API host
+
+Set `GITHUB_API_URL` to point agent-reviews at a GitHub Enterprise host or any API-compatible server (useful for testing, recording, or routing through a local mediator). Defaults to `https://api.github.com`.
+
+```bash
+# GitHub Enterprise Server
+GITHUB_API_URL=https://github.example.com/api/v3 agent-reviews
+
+# Local API-compatible server
+GITHUB_API_URL=http://127.0.0.1:8080 agent-reviews
+```
+
+GraphQL endpoint resolution: agent-reviews uses `${GITHUB_API_URL}/graphql` by default. For GitHub Enterprise Server, where REST lives under `/api/v3` and GraphQL under `/api/graphql` on the same origin, the trailing `/api/v3` is rewritten to `/api/graphql` automatically. Set `GITHUB_GRAPHQL_URL` directly if you need full control over the GraphQL endpoint.
+
 ## CLI Usage
 
 ```bash
@@ -145,6 +159,7 @@ Bot review bodies (`REVIEW` type) are always filtered out since actionable findi
 | Sourcery | Reviewer's guide and PR summary |
 | Codacy | Analysis summary and coverage summary |
 | SonarCloud | Quality Gate pass/fail summary |
+| Gemini Code Assist | "Summary of Changes" issue comment |
 
 ### Reply status
 
@@ -162,6 +177,11 @@ Polls the GitHub API at a configurable interval and reports new comments as they
 
 ## Changelog
 
+### 1.0.2
+
+- GitHub Enterprise Server support via `GITHUB_API_URL` env var (also works for local API-compatible servers used in testing). REST and GraphQL endpoints both honor it, with GHES `/api/v3` automatically rewritten to `/api/graphql`. Optional `GITHUB_GRAPHQL_URL` for unusual setups.
+- Gemini Code Assist meta-comment filtering: the bot's `## Summary of Changes` issue comment is now dropped, while inline severity-badged findings are preserved.
+
 ### 1.0.0
 
 **Three skills instead of one.** The single `agent-reviews` skill has been split into three, each tailored for different workflows:

package/lib/comments.js

@@ -8,13 +8,32 @@
 
 const USER_AGENT = "agent-reviews";
 
+// Base URL for the GitHub REST API. Defaults to api.github.com.
+// Set GITHUB_API_URL to point at a GitHub Enterprise host or a local
+// API-compatible server (e.g., for testing or recording). Trailing
+// whitespace and slashes are stripped so callers can pass either
+// "https://host/api/v3" or "https://host/api/v3/".
+const API_BASE = (process.env.GITHUB_API_URL || "https://api.github.com")
+  .trim()
+  .replace(/\/+$/, "");
+
+// GitHub Enterprise Server splits REST (/api/v3) and GraphQL (/api/graphql)
+// onto sibling paths under the same origin, so we can't just append /graphql
+// to the REST base. Detect the GHES shape and rewrite; otherwise append.
+// GITHUB_GRAPHQL_URL fully overrides the derivation for unusual setups.
+const GRAPHQL_URL =
+  process.env.GITHUB_GRAPHQL_URL?.trim().replace(/\/+$/, "") ||
+  (API_BASE.endsWith("/api/v3")
+    ? API_BASE.replace(/\/api\/v3$/, "/api/graphql")
+    : API_BASE + "/graphql");
+
 // ---------------------------------------------------------------------------
 // GitHub API helpers
 // ---------------------------------------------------------------------------
 
 async function findPRForBranch(owner, repo, branch, token, proxyFetch) {
   const response = await proxyFetch(
-    `https://api.github.com/repos/${owner}/${repo}/pulls?head=${owner}:${branch}&state=open`,
+    `${API_BASE}/repos/${owner}/${repo}/pulls?head=${owner}:${branch}&state=open`,
     {
       headers: {
         Authorization: `Bearer ${token}`,
@@ -71,7 +90,7 @@ async function fetchAllPages(url, token, proxyFetch) {
 }
 
 async function fetchPRComments(owner, repo, prNumber, token, proxyFetch) {
-  const baseUrl = `https://api.github.com/repos/${owner}/${repo}`;
+  const baseUrl = `${API_BASE}/repos/${owner}/${repo}`;
 
   // Fetch all comment types in parallel
   const [reviewComments, issueComments, reviews] = await Promise.all([
@@ -145,6 +164,10 @@ const DEFAULT_META_FILTERS = [
       user === "sonarqube-cloud-us[bot]" ||
       user === "sonarqube-cloud-us") &&
     body.includes("Quality Gate"),
+  // Gemini Code Assist "Summary of Changes" issue comment (not inline findings)
+  (user, body) =>
+    (user === "gemini-code-assist[bot]" || user === "gemini-code-assist") &&
+    body.startsWith("## Summary of Changes"),
 ];
 
 function isMetaComment(user, body, metaFilters = DEFAULT_META_FILTERS) {
@@ -168,6 +191,7 @@ const KNOWN_BOT_LOGINS = new Set([
   "sonarcloud",
   "sonarqubecloud",
   "sonarqube-cloud-us",
+  "gemini-code-assist",
 ]);
 
 function isBot(username) {
@@ -364,7 +388,7 @@ async function replyToComment(
 ) {
   // Try review comment reply endpoint first
   const response = await proxyFetch(
-    `https://api.github.com/repos/${owner}/${repo}/pulls/${prNumber}/comments/${commentId}/replies`,
+    `${API_BASE}/repos/${owner}/${repo}/pulls/${prNumber}/comments/${commentId}/replies`,
     {
       method: "POST",
       headers: {
@@ -380,7 +404,7 @@ async function replyToComment(
   if (!response.ok) {
     // Fallback to issue comment endpoint
     const issueResponse = await proxyFetch(
-      `https://api.github.com/repos/${owner}/${repo}/issues/${prNumber}/comments`,
+      `${API_BASE}/repos/${owner}/${repo}/issues/${prNumber}/comments`,
       {
         method: "POST",
         headers: {
@@ -437,7 +461,7 @@ async function resolveThread(owner, repo, prNumber, commentId, token, proxyFetch
   let thread = null;
 
   while (!thread) {
-    const response = await proxyFetch("https://api.github.com/graphql", {
+    const response = await proxyFetch(GRAPHQL_URL, {
       method: "POST",
       headers: {
         Authorization: `Bearer ${token}`,
@@ -490,7 +514,7 @@ async function resolveThread(owner, repo, prNumber, commentId, token, proxyFetch
     }
   `;
 
-  const resolveResponse = await proxyFetch("https://api.github.com/graphql", {
+  const resolveResponse = await proxyFetch(GRAPHQL_URL, {
     method: "POST",
     headers: {
       Authorization: `Bearer ${token}`,

package/package.json

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

package/skills/resolve-agent-reviews/SKILL.md

@@ -3,10 +3,10 @@ name: resolve-agent-reviews
 description: Resolve PR review bot findings on current PR. Fetches unanswered bot comments, evaluates each finding, fixes real bugs, dismisses false positives, replies to every comment, and watches for new findings until bots go quiet.
 license: MIT
 compatibility: Requires git, gh (GitHub CLI), and Node.js installed.
-allowed-tools: Bash(npx agent-reviews *) Bash(pnpm exec agent-reviews *) Bash(yarn exec agent-reviews *) Bash(bunx agent-reviews *) Bash(git config *) Bash(git add *) Bash(git commit *) Bash(git push *)
+allowed-tools: Bash(npx agent-reviews *) Bash(pnpm dlx agent-reviews *) Bash(yarn dlx agent-reviews *) Bash(bunx agent-reviews *) Bash(git config *) Bash(git add *) Bash(git commit *) Bash(git push *)
 metadata:
   author: pbakaus
-  version: "1.0.0"
+  version: "1.0.2"
   homepage: https://github.com/pbakaus/agent-reviews
 ---
 
@@ -14,7 +14,7 @@ Automatically resolve findings from PR review bots (Copilot, Cursor Bugbot, Code
 
 ## Prerequisites
 
-All commands below use `npx agent-reviews`. If the project uses a different package manager, substitute the appropriate runner (e.g., `pnpm exec agent-reviews` for pnpm, `yarn exec agent-reviews` for Yarn, `bunx agent-reviews` for Bun). Honor the user's package manager preference throughout.
+All commands below use `npx agent-reviews`. If the project uses a different package manager, substitute the appropriate runner (e.g., `pnpm dlx agent-reviews` for pnpm, `yarn dlx agent-reviews` for Yarn, `bunx agent-reviews` for Bun). Honor the user's package manager preference throughout.
 
 **Cloud environments only** (e.g., Codespaces, remote agents): verify git author identity so CI checks can map commits to the user. Run `git config --global --get user.email` and if empty or a placeholder, set it manually. Skip this check in local environments.
 

package/skills/resolve-human-reviews/SKILL.md

@@ -3,10 +3,10 @@ name: resolve-human-reviews
 description: Resolve human PR review comments on current PR. Fetches unanswered human comments, evaluates each piece of feedback, applies fixes, and replies to every comment with the outcome.
 license: MIT
 compatibility: Requires git, gh (GitHub CLI), and Node.js installed.
-allowed-tools: Bash(npx agent-reviews *) Bash(pnpm exec agent-reviews *) Bash(yarn exec agent-reviews *) Bash(bunx agent-reviews *) Bash(git config *) Bash(git add *) Bash(git commit *) Bash(git push *)
+allowed-tools: Bash(npx agent-reviews *) Bash(pnpm dlx agent-reviews *) Bash(yarn dlx agent-reviews *) Bash(bunx agent-reviews *) Bash(git config *) Bash(git add *) Bash(git commit *) Bash(git push *)
 metadata:
   author: pbakaus
-  version: "1.0.0"
+  version: "1.0.2"
   homepage: https://github.com/pbakaus/agent-reviews
 ---
 
@@ -14,7 +14,7 @@ Automatically resolve human review comments on the current PR. Fetches unanswere
 
 ## Prerequisites
 
-All commands below use `npx agent-reviews`. If the project uses a different package manager, substitute the appropriate runner (e.g., `pnpm exec agent-reviews` for pnpm, `yarn exec agent-reviews` for Yarn, `bunx agent-reviews` for Bun). Honor the user's package manager preference throughout.
+All commands below use `npx agent-reviews`. If the project uses a different package manager, substitute the appropriate runner (e.g., `pnpm dlx agent-reviews` for pnpm, `yarn dlx agent-reviews` for Yarn, `bunx agent-reviews` for Bun). Honor the user's package manager preference throughout.
 
 **Cloud environments only** (e.g., Codespaces, remote agents): verify git author identity so CI checks can map commits to the user. Run `git config --global --get user.email` and if empty or a placeholder, set it manually. Skip this check in local environments.
 

package/skills/resolve-reviews/SKILL.md

@@ -3,10 +3,10 @@ name: resolve-reviews
 description: Resolve all PR review comments (human and bot) on current PR. Fetches unanswered comments, evaluates each one, fixes real issues, dismisses false positives, and replies to every comment with the outcome.
 license: MIT
 compatibility: Requires git, gh (GitHub CLI), and Node.js installed.
-allowed-tools: Bash(npx agent-reviews *) Bash(pnpm exec agent-reviews *) Bash(yarn exec agent-reviews *) Bash(bunx agent-reviews *) Bash(git config *) Bash(git add *) Bash(git commit *) Bash(git push *)
+allowed-tools: Bash(npx agent-reviews *) Bash(pnpm dlx agent-reviews *) Bash(yarn dlx agent-reviews *) Bash(bunx agent-reviews *) Bash(git config *) Bash(git add *) Bash(git commit *) Bash(git push *)
 metadata:
   author: pbakaus
-  version: "1.0.0"
+  version: "1.0.2"
   homepage: https://github.com/pbakaus/agent-reviews
 ---
 
@@ -14,7 +14,7 @@ Automatically resolve all review comments (both human and bot) on the current PR
 
 ## Prerequisites
 
-All commands below use `npx agent-reviews`. If the project uses a different package manager, substitute the appropriate runner (e.g., `pnpm exec agent-reviews` for pnpm, `yarn exec agent-reviews` for Yarn, `bunx agent-reviews` for Bun). Honor the user's package manager preference throughout.
+All commands below use `npx agent-reviews`. If the project uses a different package manager, substitute the appropriate runner (e.g., `pnpm dlx agent-reviews` for pnpm, `yarn dlx agent-reviews` for Yarn, `bunx agent-reviews` for Bun). Honor the user's package manager preference throughout.
 
 **Cloud environments only** (e.g., Codespaces, remote agents): verify git author identity so CI checks can map commits to the user. Run `git config --global --get user.email` and if empty or a placeholder, set it manually. Skip this check in local environments.