pr-shepherd 0.12.0 → 0.12.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pr-shepherd",
   "description": "Autonomous PR CI monitor and review-comment resolver for agentic coding tools",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "author": {
     "name": "Jonathan Ong",
     "email": "jonathanrichardong@gmail.com"

package/README.md

@@ -276,14 +276,14 @@ actions:
   autoMarkReady: false # disable to stay draft until you manually promote
 ```
 
-Environment variables: `GH_TOKEN` / `GITHUB_TOKEN` (auth; falls back to `gh auth token`), `PR_SHEPHERD_STATE_DIR` (override loop-state and log base dir), `PR_SHEPHERD_LOG_DISABLED=1` (disable the per-worktree debug log), `AGENT=codex` or `CODEX_CI=1` (emit Codex-compatible monitor instructions).
+Environment variables: `GH_TOKEN` / `GITHUB_TOKEN` (auth; falls back to `gh auth token`, then `GITHUB_PERSONAL_ACCESS_TOKEN`), `PR_SHEPHERD_STATE_DIR` (override loop-state and log base dir), `PR_SHEPHERD_LOG_DISABLED=1` (disable the per-worktree debug log), `AGENT=codex` or `CODEX_CI=1` (emit Codex-compatible monitor instructions).
 
 See [docs/configuration.md](docs/configuration.md) for full semantics and deprecated-key migration.
 
 ## Requirements
 
 - Node.js ≥ 22.0.0
-- A GitHub token: set `GH_TOKEN` or `GITHUB_TOKEN`, **or** install and authenticate the `gh` CLI (`gh auth login`) — pr-shepherd uses `gh auth token` as a fallback. The `repo` scope is required for private repositories.
+- A GitHub token: set `GH_TOKEN` or `GITHUB_TOKEN`, **or** install and authenticate the `gh` CLI (`gh auth login`) — pr-shepherd uses `gh auth token` as a fallback before trying `GITHUB_PERSONAL_ACCESS_TOKEN`. The `repo` scope is required for private repositories.
 - `git`
 
 ## Docs

package/bin/commands/iterate/fix-code.mjs

@@ -52,12 +52,10 @@ export async function handleFixCode(ctx) {
     const checks = toAgentChecks(failingChecks);
     const { changesRequestedReviews } = report;
     const hasConflicts = report.mergeStatus.status === "CONFLICTS";
-    const needsPush = threads.length > 0 ||
-        actionableComments.length > 0 ||
-        checks.length > 0 ||
-        changesRequestedReviews.length > 0 ||
-        hasConflicts;
-    const inProgressRunIds = needsPush ? buildInProgressRunIds(report, cancelledSet) : [];
+    const hasGuaranteedSupersedingPush = threads.length > 0 || checks.length > 0 || changesRequestedReviews.length > 0 || hasConflicts;
+    const inProgressRunIds = hasGuaranteedSupersedingPush
+        ? buildInProgressRunIds(report, cancelledSet)
+        : [];
     const allCommentIds = [...actionableComments.map((c) => c.id), ...reviewSummaryIds];
     const resolveCommand = buildResolveCommand(threads, resolutionOnlyThreads, allCommentIds, changesRequestedReviews, checks, prNumber);
     if (baseLookup.isFallback && (resolveCommand.requiresHeadSha || hasConflicts)) {

package/bin/commands/iterate/render.mjs

@@ -60,7 +60,7 @@ export function buildFixInstructions(threads, actionableComments, checks, review
     if (reviews.length > 0) {
         instructions.push(`For each bullet under \`## Changes-requested reviews\` above: read the review body and apply the requested changes.`);
     }
-    const hasCodeChanges = threads.length > 0 || actionableComments.length > 0 || checks.length > 0 || reviews.length > 0;
+    const hasCodeChanges = threads.length > 0 || checks.length > 0 || reviews.length > 0;
     const needsPush = hasCodeChanges || hasConflicts;
     if (hasCodeChanges) {
         instructions.push(`Commit changed files: \`git add <files> && git commit -m "<descriptive message>"\``);

package/bin/github/http.mjs

@@ -30,7 +30,12 @@ async function resolveToken() {
     catch {
         // fall through to error
     }
-    throw new Error("No GitHub token found. Set GH_TOKEN or GITHUB_TOKEN, or run `gh auth login`.");
+    const codexToken = process.env["GITHUB_PERSONAL_ACCESS_TOKEN"];
+    if (codexToken) {
+        _token = codexToken;
+        return _token;
+    }
+    throw new Error("No GitHub token found. Set GH_TOKEN, GITHUB_TOKEN, or GITHUB_PERSONAL_ACCESS_TOKEN, or run `gh auth login`.");
 }
 async function makeHeaders() {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pr-shepherd",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Autonomous PR CI monitor and review-comment resolver for agentic coding tools",
   "license": "MIT",
   "author": "Jonathan Ong",