huggy-pr-agent 1.8.0 โ 1.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +15 -0
- package/CHANGELOG.md +57 -0
- package/INSTALL.md +3 -1
- package/README.md +74 -11
- package/action.yml +222 -121
- package/assets/huggy-blocked.svg +165 -0
- package/assets/huggy-fixing.svg +276 -0
- package/assets/huggy-good.svg +107 -0
- package/assets/huggy-judging.svg +252 -0
- package/assets/huggy-reviewing.svg +690 -227
- package/assets/huggy-serious.svg +113 -0
- package/assets/huggy-testing.svg +230 -0
- package/assets/huggy-thinking.svg +234 -0
- package/assets/pi-marketplace-card.png +0 -0
- package/docs/research-sota-pr-review.md +69 -0
- package/docs/self-hosting-gcp.md +166 -0
- package/examples/dependabot.yml +1 -1
- package/examples/gcp/cloud-run/Dockerfile +33 -0
- package/examples/gcp/cloud-run/entrypoint.sh +32 -0
- package/examples/gcp/cloud-run/webhook.py +185 -0
- package/examples/gcp/gce-setup.sh +111 -0
- package/examples/google-vertex.yml +6 -3
- package/examples/node-pnpm.yml +1 -1
- package/examples/swift-macos.yml +1 -1
- package/extensions/huggy.ts +5 -0
- package/package.json +5 -3
- package/pi-prompts/huggy-review.md +3 -1
- package/prompts/judge.md +23 -7
- package/prompts/review.md +46 -29
- package/scripts/fetch_pr_context.py +481 -25
- package/scripts/post_progress.py +227 -25
- package/scripts/post_review.py +273 -57
- package/scripts/prepare_command.py +270 -1
- package/scripts/run_fix.py +566 -0
- package/scripts/run_review.py +360 -47
- package/skills/huggy-review/SKILL.md +4 -2
package/AGENTS.md
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Huggy PR Agent โ Repository Instructions (`AGENTS.md`)
|
|
2
|
+
|
|
3
|
+
`huggy-pr-agent` is a zero-dependency Python 3 stdlib + GitHub Composite Action + Pi Package (`extensions/huggy.ts`) + Agent Skills bundle (`skills/`).
|
|
4
|
+
|
|
5
|
+
## Core Invariants
|
|
6
|
+
|
|
7
|
+
1. **Zero Python third-party runtime dependencies:** All orchestrator scripts under `scripts/` (`fetch_pr_context.py`, `run_review.py`, `post_review.py`, `post_progress.py`, `prepare_command.py`) must use Python 3 standard library only so GitHub Actions runners need zero `pip install` steps.
|
|
8
|
+
2. **Strict Secret & Token Isolation (`SECURITY.md`):**
|
|
9
|
+
- `GH_TOKEN` must **never** be passed into `env:` of any step that runs `pi` or `verify_cmd`, and must **never** be persisted into `.git/config` or `.git/FETCH_HEAD` (`persist-credentials: false` + ephemeral `git -c http.https://github.com/.extraheader=...` + `rm -f .git/FETCH_HEAD`).
|
|
10
|
+
- **GitHub GraphQL `resolveReviewThread` quirk (`orgs/community#20469`):** GitHub's GraphQL `resolveReviewThread` mutation rejects `GITHUB_TOKEN` with `FORBIDDEN: Resource not accessible by integration` unless **both** `contents: write` and `pull-requests: write` are granted on the `review` job. Do not flag `contents: write` on `review` jobs when `persist-credentials: false` and `.git/config` / `FETCH_HEAD` scrubbing are in place.
|
|
11
|
+
- `AGENTS.md`, `CLAUDE.md`, `REVIEW.md`, `.instructions.md`, and `.gitattributes` are always read from the `base` branch (`git show base:...`), never from untrusted PR head files.
|
|
12
|
+
3. **Tests & Validation:**
|
|
13
|
+
- Every behavior change in `scripts/` must be covered in `tests/test_post_review.py` (`python3 tests/test_post_review.py -v`).
|
|
14
|
+
- Every pixel-art SVG in `assets/` must parse as valid XML with `shape-rendering="crispEdges"`.
|
|
15
|
+
- Never merge a PR while `review` is pending or while any review thread remains unresolved (`required_conversation_resolution: true`).
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,63 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to `huggy-pr-agent` are documented in this file.
|
|
4
4
|
|
|
5
|
+
## [1.13.0] - 2026-11-19
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
- **Coalesced Parallel `@huggy` / `@pi` Multi-Comment Fix Swarm & Test-Gate Self-Repair (`scripts/prepare_command.py`, `scripts/run_fix.py`, `scripts/post_progress.py`, `action.yml`)**: coalesces all unanswered `@huggy` / `@pi` / `/fix` comments across open PR review threads and comments into a single batch (so multi-comment PR reviews never lose items to GitHub Actions' 1-pending concurrency cap, and duplicate queued runs exit in 0 tokens via `already_handled=true`), merges same-file edits while running disjoint-file fixes concurrently across the Lead + Wingman worker pool (`ThreadPoolExecutor`), runs `setup_cmd` and `verify_cmd` once (with 1 automatic Lead repair pass if `verify_cmd` fails), commits and pushes atomically, and updates + auto-resolves every addressed thread in parallel.
|
|
9
|
+
- **Active Verification Judge (`scripts/run_review.py`, `prompts/judge.md`)**: equips `--phase judge` with read-only repository tools (`read,grep,find,ls`) and an explicit base-branch policy trust boundary so the Judge verifies claims extending beyond the 20-line excerpt against real files and callers before keeping findings.
|
|
10
|
+
- **Zero-DB Living Team Memory (`scripts/fetch_pr_context.py`, `scripts/run_review.py`)**: combines optional `.github/huggy-learnings.md` from `base-tip` with automatic GraphQL mining of recent closed/merged PR review threads where maintainers reacted `๐` or pushed back (*"intentional"*, *"by design"*, *"wontfix"*), feeding `<team_learnings>` to both Finders and Judge.
|
|
11
|
+
- **Mini Codegraph Downstream Caller Map (`scripts/fetch_pr_context.py`)**: extracts modified public/exported declarations from the PR diff and attaches external `file:line` call sites outside the PR diff (`Downstream Callers of Modified Symbols`) into `<pr_context>`.
|
|
12
|
+
|
|
13
|
+
## [1.12.3] - 2026-11-16
|
|
14
|
+
|
|
15
|
+
### Added
|
|
16
|
+
- **Desk Plant in Review Status Animation (`assets/huggy-reviewing.svg`, `scripts/post_progress.py`, `README.md`)**: widens the desk scene to `232x112` (`58x28` at `4px` pixel grid) to place a 16-bit terracotta pot and V-split green sprout (`#86EFAC` / `#4ADE80` / `#22C55E`) with a subtle breeze sway beside Huggy's laptop.
|
|
17
|
+
|
|
18
|
+
## [1.12.2] - 2026-11-16
|
|
19
|
+
|
|
20
|
+
### Fixed
|
|
21
|
+
- **Exact `head.sha` Line Resolution When Target Branch Moves Ahead (`action.yml`, `scripts/post_review.py`)**: checks out `pull_request.head.sha` and diffs against `git merge-base base-tip HEAD` instead of `refs/pull/<pr>/merge` (`HEAD^1..HEAD`), eliminating `HTTP 422 "Line could not be resolved"` line-number drift when new commits land on the target branch after a PR opens (while continuing to read trusted rubrics, `.github/pi-review-prompt.md`, and `.gitattributes` from `base-tip`). `submit_inline_comments()` also pins `"commit_id": head_sha` and retries individual comments if a multi-comment batch `POST` returns `422`.
|
|
22
|
+
|
|
23
|
+
## [1.12.1] - 2026-11-14
|
|
24
|
+
|
|
25
|
+
### Fixed
|
|
26
|
+
- **Polished Coffee-Sip Choreography & Zero-Ghosting SMIL (`assets/huggy-reviewing.svg`)**: re-choreographs `huggy-reviewing.svg` into a smooth 36-beat (`6.12s`) pixel-art loop โ brisk typing, a clear pause on the home row, glancing left and reaching across to grip the mug handle on the desk, lifting to mouth height below the sunglasses, tilting the mug + head `1px` back to sip with rising steam, setting the mug back down on the desk, and returning the hand to resume typing โ driven by discrete `visibility` (`begin="0s"`) with explicit base `visibility` matching each layer's first beat so browsers never alpha-blend overlapping layers.
|
|
27
|
+
|
|
28
|
+
## [1.12.0] - 2026-11-14
|
|
29
|
+
|
|
30
|
+
### Added
|
|
31
|
+
- **Google Cloud Self-Hosting Guides & Turnkey Templates (`docs/self-hosting-gcp.md`, `examples/gcp/`)**: documents and ships ready-to-run templates for both **Option A (Dedicated GCE VM Multi-Slot Runner, `examples/gcp/gce-setup.sh`)** and **Option B (Serverless Scale-to-Zero Ephemeral Runners on Cloud Run Jobs, `examples/gcp/cloud-run/`)** โ keeping GitHub-hosted `runs-on: ubuntu-latest` as the zero-config default while letting high-volume private orgs eliminate GitHub Actions minute usage on GCP Startup Credits with a 1-line `runs-on:` switch.
|
|
32
|
+
|
|
33
|
+
## [1.11.1] - 2026-11-13
|
|
34
|
+
|
|
35
|
+
### Fixed
|
|
36
|
+
- **Verified GraphQL `resolveReviewThread` & Ephemeral Fetch Auth (`scripts/post_review.py`, `scripts/fetch_pr_context.py`, `action.yml`)**: inspects GraphQL `errors` and `thread.isResolved` before counting threads as resolved, uses `persist-credentials: false` + ephemeral `-c http.<server>/.extraheader` + `FETCH_HEAD` cleanup so `GH_TOKEN` never persists on disk during `Run Pi`, and reads `.gitattributes` from `base` via `GIT_ATTR_SOURCE=base`.
|
|
37
|
+
- **Provisional `review.md` on `--phase find` (`scripts/run_review.py`)**: writes a provisional `review.md` before handing off to `--phase judge` so `post_review.py` never fails if the Judge step is skipped or interrupted, and preserves `Security: Needs attention` on `nits` verdicts.
|
|
38
|
+
- **Ambiguous Fingerprint & Security Badge Handling (`scripts/post_review.py`)**: avoids cross-line overwrites or premature thread resolution when two findings in the same file share a fingerprint, and displays a distinct `nits ยท security` alert badge when security attention is flagged without High-severity findings.
|
|
39
|
+
|
|
40
|
+
## [1.11.0] - 2026-11-13
|
|
41
|
+
|
|
42
|
+
### Added
|
|
43
|
+
- **Multi-Act Review Animation with Coffee-Sip Loop (`assets/huggy-reviewing.svg`)**: `huggy-reviewing.svg` now runs a 24-beat (`6.72s`) discrete pixel-art loop โ brisk typing on the laptop with a porcelain mug resting on the desk, followed by an occasional stoic coffee sip before returning to the keyboard.
|
|
44
|
+
- **Expressive Verdict Header Icons & Colored Verdict Badges (`assets/huggy-good.svg`, `assets/huggy-serious.svg`, `scripts/post_review.py`)**: the finished `Review by Huggy` header now adapts to the outcome at a glance โ cheerful smile + emerald badge on `looks good` / `nits`, stoic neutral + amber badge on `Medium` `needs changes`, and furrowed V-brows with crimson lens glint + red alert badge whenever `High` or security findings are present.
|
|
45
|
+
|
|
46
|
+
## [1.10.0] - 2026-11-13
|
|
47
|
+
|
|
48
|
+
### Added
|
|
49
|
+
- **Full-Lifecycle 16-Bit Pixel-Art Live Animations (`assets/huggy-{judging,fixing,testing,thinking,blocked}.svg` + `scripts/post_progress.py`)**: live animated status cards now cover every stage of Huggy's workflow โ transitioning from `huggy-reviewing.svg` to `huggy-judging.svg` during the precision Judge pass, from `huggy-fixing.svg` to `huggy-testing.svg` when `@huggy` runs `verify_cmd`, showing `huggy-thinking.svg` on `/ask` & `/describe`, and displaying `huggy-blocked.svg` on guarded-boundary refusals โ before replacing themselves cleanly in-place once finished.
|
|
50
|
+
- **Pi Marketplace Hero Card (`assets/pi-marketplace-card.png`)**: custom `1280x720` pixel-art gallery thumbnail for `pi.dev/packages/huggy-pr-agent`, plus animated pixel-art walkthroughs across `README.md`.
|
|
51
|
+
- **Two-Phase Split Execution (`--phase find` / `--phase judge`)**: updates the PR review banner to the Judge pass between bundle discovery and verification while keeping `GH_TOKEN` strictly isolated from every Pi invocation step.
|
|
52
|
+
|
|
53
|
+
## [1.9.0] - 2026-11-12
|
|
54
|
+
|
|
55
|
+
### Added
|
|
56
|
+
- **Lead + Wingmen Parallel Worker Pool & Blast-Radius Risk Router (`wingman_model` + `scripts/run_review.py`)**: computes best-effort reverse-import blast radius (`compute_blast_radius`) and domain criticality (`migrations/`, `auth`, `billing`, `security`, `contracts`, `api/v1`) before dispatching bundles so the highest-risk bundle and Judge pass run Lead-first on `model` (e.g. `google-vertex/gemini-4-carbon`) while parallel sibling bundles run concurrently on `wingman_model` (e.g. `google-vertex/gemini-4-argon`), falling back to `fallback_model` only on failure/timeout.
|
|
57
|
+
- **Line-Shift-Resilient Thread Fingerprints & Multi-Comment Auto-Resolve (`scripts/post_review.py`)**: embeds `<!-- pi id=<hash> -->` markers so open findings survive line shifts across pushes, auto-resolves fixed threads even after developer/agent replies (while preserving open human questions), and respects `๐` downvoted suggestions across re-runs.
|
|
58
|
+
- **`๐ค Prompt for AI Agents` Handoff Block**: automatically attaches a collapsible agent-ready fix prompt on `High`/`Medium` inline findings that span multiple lines/files and cannot be committed as a 1-click `suggestion`.
|
|
59
|
+
- **Direct Target Issue Extraction & `huggy:deep` Label Trigger (`scripts/fetch_pr_context.py`)**: extracts direct target issues from branch names (`feat/123-...`), PR titles, and `Closes/Fixes` lines, and automatically enables `deep` dual-lens review when a PR carries the `huggy:deep` or `review:deep` label.
|
|
60
|
+
- **Ponytail Senior-On-Call Discipline & Anti-Hedging Gate (`prompts/review.md`, `prompts/judge.md`)**: calibrates scale findings against expected load, prioritizes smallest fixes (preferring deletion/reusing existing repo helpers over new abstractions), respects documented `shortcut:` / `ponytail:` limits, and filters out speculative hedging and self-contradictory rambling.
|
|
61
|
+
|
|
5
62
|
## [1.8.0] - 2026-11-12
|
|
6
63
|
|
|
7
64
|
### Added
|
package/INSTALL.md
CHANGED
|
@@ -78,7 +78,7 @@ jobs:
|
|
|
78
78
|
runs-on: ubuntu-latest
|
|
79
79
|
timeout-minutes: 60
|
|
80
80
|
permissions:
|
|
81
|
-
contents:
|
|
81
|
+
contents: write # required by GitHub GraphQL resolveReviewThread
|
|
82
82
|
pull-requests: write
|
|
83
83
|
concurrency:
|
|
84
84
|
group: huggy-review-${{ github.event.pull_request.number }}
|
|
@@ -140,3 +140,5 @@ jobs:
|
|
|
140
140
|
- Automatic inline review on every PR push
|
|
141
141
|
- `@huggy <instruction>` (or `@pi <instruction>` / `/fix <instruction>`) on any diff line or PR comment to push a verified fix and auto-resolve the review thread
|
|
142
142
|
- `/describe`, `/improve`, `/ask <question>`, `/review`
|
|
143
|
+
|
|
144
|
+
> **Optional โ Zero GitHub Actions Minutes on GCP (Private Orgs Only):** Keep `runs-on: ubuntu-latest` by default. If the user explicitly asks to run on Google Cloud / self-hosted runners to save private-org Actions minutes, follow [`docs/self-hosting-gcp.md`](https://github.com/tripplen23/huggy-pr-agent/blob/main/docs/self-hosting-gcp.md) (Option A: GCE VM via `examples/gcp/gce-setup.sh`, or Option B: Serverless Ephemeral Cloud Run Jobs via `examples/gcp/cloud-run/`).
|
package/README.md
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
[](https://github.com/tripplen23/huggy-pr-agent/releases)
|
|
16
16
|
[](LICENSE)
|
|
17
17
|
|
|
18
|
-
[Quick Start](#quick-start) ยท [Providers & Vertex AI](#model-providers--google-vertex-ai) ยท [Commands](#commands--capabilities) ยท [How It Works](#how-it-works) ยท [Configuration](#configuration--inputs) ยท [Agent Install Spec](https://github.com/tripplen23/huggy-pr-agent/blob/main/INSTALL.md)
|
|
18
|
+
[Quick Start](#quick-start) ยท [Providers & Vertex AI](#model-providers--google-vertex-ai) ยท [Self-Host on GCP](https://github.com/tripplen23/huggy-pr-agent/blob/main/docs/self-hosting-gcp.md) ยท [Commands](#commands--capabilities) ยท [How It Works](#how-it-works) ยท [Configuration](#configuration--inputs) ยท [Agent Install Spec](https://github.com/tripplen23/huggy-pr-agent/blob/main/INSTALL.md)
|
|
19
19
|
|
|
20
20
|
</div>
|
|
21
21
|
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
While a review pipeline is running, Huggy shows a compact pixel-art status indicator, then replaces it with a clean summary and inline diff comments once finished:
|
|
27
27
|
|
|
28
28
|
<div align="center">
|
|
29
|
-
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-reviewing.svg" alt="Huggy reviewing animation" width="
|
|
29
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-reviewing.svg" alt="Huggy reviewing animation" width="232" />
|
|
30
30
|
</div>
|
|
31
31
|
|
|
32
32
|
<br />
|
|
@@ -95,7 +95,7 @@ jobs:
|
|
|
95
95
|
runs-on: ubuntu-latest
|
|
96
96
|
timeout-minutes: 60
|
|
97
97
|
permissions:
|
|
98
|
-
contents:
|
|
98
|
+
contents: write # required by GitHub GraphQL resolveReviewThread
|
|
99
99
|
pull-requests: write
|
|
100
100
|
concurrency:
|
|
101
101
|
group: huggy-review-${{ github.event.pull_request.number }}
|
|
@@ -146,7 +146,7 @@ jobs:
|
|
|
146
146
|
- **Interactive comment commands (`issue_comment`, `pull_request_review_comment`)** activate as soon as `.github/workflows/huggy.yml` lands on your default branch.
|
|
147
147
|
- **Staying in sync with upstream updates:**
|
|
148
148
|
- **Zero-click automatic updates:** Referencing `tripplen23/huggy-pr-agent@v1` automatically picks up every engine, Judge, and prompt improvement as soon as a new `v1.x` release ships.
|
|
149
|
-
- **1-click PR approval updates:** Prefer explicit version review before upgrading? Pin `uses: tripplen23/huggy-pr-agent@v1.
|
|
149
|
+
- **1-click PR approval updates:** Prefer explicit version review before upgrading? Pin `uses: tripplen23/huggy-pr-agent@v1.12.0` and drop [`examples/dependabot.yml`](https://github.com/tripplen23/huggy-pr-agent/blob/main/examples/dependabot.yml) into `.github/dependabot.yml` (or use Renovate) โ GitHub opens a 1-click Merge PR with full release notes whenever a new version is published.
|
|
150
150
|
- **Local Pi package updates:** Run `pi update --extensions` (and `/huggy sync` inside any repo to refresh workflow templates).
|
|
151
151
|
|
|
152
152
|
---
|
|
@@ -179,7 +179,13 @@ By default, `huggy-pr-agent` uses `opencode-go/deepseek-v4.1-flash` with `openco
|
|
|
179
179
|
api_key: ${{ secrets.OPENCODE_GO_KEY }}
|
|
180
180
|
max_parallel_bundles: "2"
|
|
181
181
|
```
|
|
182
|
-
See [`examples/google-vertex.yml`](examples/google-vertex.yml) for a full workflow file.
|
|
182
|
+
See [`examples/google-vertex.yml`](https://github.com/tripplen23/huggy-pr-agent/blob/main/examples/google-vertex.yml) for a full workflow file.
|
|
183
|
+
|
|
184
|
+
### Zero GitHub Actions Minutes on GCP (Optional Self-Hosted Runners)
|
|
185
|
+
|
|
186
|
+
GitHub-hosted `runs-on: ubuntu-latest` is the default and requires zero infrastructure. If your private organization hits GitHub's 2,000 included Actions minutes/month, see **[`docs/self-hosting-gcp.md`](https://github.com/tripplen23/huggy-pr-agent/blob/main/docs/self-hosting-gcp.md)** for two turnkey Google Cloud options (both 100% Google for Startups Cloud Credit eligible, requiring only a 1-line `runs-on: [self-hosted, gcp-huggy]` change):
|
|
187
|
+
- **Option A โ Dedicated GCE VM Multi-Slot Runner** ([`examples/gcp/gce-setup.sh`](https://github.com/tripplen23/huggy-pr-agent/blob/main/examples/gcp/gce-setup.sh)): 0s cold-start and warm SSD caches across 3 concurrent runner slots.
|
|
188
|
+
- **Option B โ Serverless Ephemeral Runners on Cloud Run Jobs** ([`examples/gcp/cloud-run/`](https://github.com/tripplen23/huggy-pr-agent/tree/main/examples/gcp/cloud-run)): isolated `--ephemeral` container per job that scales down to 0 when idle.
|
|
183
189
|
|
|
184
190
|
---
|
|
185
191
|
|
|
@@ -211,14 +217,62 @@ Generic AI reviewers fail in two predictable ways: **single-call diff wrappers**
|
|
|
211
217
|
- Small/medium PRs run in a single fast pass; massive PRs (10k+ lines / dozens of files) are deterministically grouped into semantic counterpart bundles (`foo.ts` + `contracts/foo.ts` + `foo.test.ts`) and reviewed concurrently (`review_timeout_minutes: auto`), with an optional `review_depth: deep` (`/review deep`) dual-lens pass (Logic/Callers + Security/Spec).
|
|
212
218
|
- Uses review-shaped tool discipline (`--tools read,grep,find,ls --thinking high`): forms hypotheses from the diff first, batches `grep`/`find` caller discovery, then reads narrow `offset`/`limit` ranges.
|
|
213
219
|
3. **Confidence-Scored (`โฅ 80`) Judge Pass & Two-Channel Output (`prompts/judge.md`, `scripts/post_review.py`)**
|
|
214
|
-
-
|
|
220
|
+
- Once the Lead + Wingmen workers finish scanning their risk-ranked bundles, the live banner transitions to the **Judge pass** while an independent tool-free Judge scores every candidate `0โ100` against ground-truth file lines and the `AGENTS.md` rubric, enforcing hard exclusions (no pre-existing code, no hedged speculation, no hallucinated rules) so only `confidence โฅ 80` defects reach inline diff threads.
|
|
215
221
|
- Under `review_profile: chill` (default), `High` and `Medium` defects are posted inline while `Low` nitpicks are collapsed inside `<details><summary>๐งน Nitpicks</summary>` in the sticky summary.
|
|
216
|
-
- Content-anchored sliding-window relocation repairs minor `1โ5` line drift on `suggestion` blocks, disarms unsafe/unbalanced blocks, auto-resolves fixed threads, and replaces the live
|
|
222
|
+
- Content-anchored sliding-window relocation repairs minor `1โ5` line drift on `suggestion` blocks, disarms unsafe/unbalanced blocks, auto-resolves fixed threads, and replaces the live animation with the static `Review by Huggy` summary.
|
|
223
|
+
|
|
224
|
+
<div align="center">
|
|
225
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-judging.svg" alt="Huggy precision Judge pass" width="196" />
|
|
226
|
+
<br />
|
|
227
|
+
<sub><em>Live precision Judge indicator โ verifies candidate findings before transforming into one of three verdict expressions:</em></sub>
|
|
228
|
+
</div>
|
|
229
|
+
|
|
230
|
+
<br />
|
|
231
|
+
|
|
232
|
+
<div align="center">
|
|
233
|
+
<table>
|
|
234
|
+
<tr>
|
|
235
|
+
<td align="center" width="210">
|
|
236
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-good.svg" alt="Huggy looks good" width="44" /><br />
|
|
237
|
+
<sub><strong><code>looks good</code> / <code>nits</code></strong></sub>
|
|
238
|
+
</td>
|
|
239
|
+
<td align="center" width="210">
|
|
240
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-icon.svg" alt="Huggy needs changes" width="44" /><br />
|
|
241
|
+
<sub><strong><code>needs changes</code> (Medium)</strong></sub>
|
|
242
|
+
</td>
|
|
243
|
+
<td align="center" width="210">
|
|
244
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-serious.svg" alt="Huggy high-severity alert" width="44" /><br />
|
|
245
|
+
<sub><strong><code>High</code> / Security alert</strong></sub>
|
|
246
|
+
</td>
|
|
247
|
+
</tr>
|
|
248
|
+
</table>
|
|
249
|
+
</div>
|
|
217
250
|
|
|
218
251
|
---
|
|
219
252
|
|
|
220
253
|
## Commands & Capabilities
|
|
221
254
|
|
|
255
|
+
Every interactive command posts an in-place pixel-art status reply while running โ transitioning automatically from **code patching** to **verification test gating** โ and replaces itself cleanly with the final answer or commit SHA once finished:
|
|
256
|
+
|
|
257
|
+
<div align="center">
|
|
258
|
+
<table>
|
|
259
|
+
<tr>
|
|
260
|
+
<td align="center" width="240">
|
|
261
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-fixing.svg" alt="Huggy applying a fix" width="176" /><br />
|
|
262
|
+
<sub><strong><code>@huggy <fix></code></strong> ยท Patching code</sub>
|
|
263
|
+
</td>
|
|
264
|
+
<td align="center" width="240">
|
|
265
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-testing.svg" alt="Huggy running verify_cmd tests" width="176" /><br />
|
|
266
|
+
<sub><strong><code>verify_cmd</code></strong> ยท Running test gate</sub>
|
|
267
|
+
</td>
|
|
268
|
+
<td align="center" width="240">
|
|
269
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-thinking.svg" alt="Huggy tracing callers for /ask" width="176" /><br />
|
|
270
|
+
<sub><strong><code>/ask</code> ยท <code>/describe</code></strong> ยท Deep trace</sub>
|
|
271
|
+
</td>
|
|
272
|
+
</tr>
|
|
273
|
+
</table>
|
|
274
|
+
</div>
|
|
275
|
+
|
|
222
276
|
Comment any of these in the **PR conversation**, inside an **inline diff review thread**, or at the bottom of a **Quote reply** (`@pi` and `/pi` aliases work identically to `@huggy` and `/huggy`):
|
|
223
277
|
|
|
224
278
|
| Trigger / Command | Mode | What it does |
|
|
@@ -241,8 +295,9 @@ Comment any of these in the **PR conversation**, inside an **inline diff review
|
|
|
241
295
|
| `gcp_project` | `""` | Google Cloud project ID when using `google-vertex/*` models (auto-detected from `gcp_credentials_json` if omitted). |
|
|
242
296
|
| `gcp_location` | `global` | Google Cloud region or `global` when using `google-vertex/*` models. |
|
|
243
297
|
| `gcp_credentials_json` | `""` | Google Cloud Service Account JSON key for `google-vertex/*` models (omit when using Workload Identity Federation). |
|
|
244
|
-
| `model` | `opencode-go/deepseek-v4.1-flash` | Primary model ID passed to `pi --model
|
|
245
|
-
| `
|
|
298
|
+
| `model` | `opencode-go/deepseek-v4.1-flash` | Primary / Lead model ID passed to `pi --model` (reviews the highest-risk bundle and runs the Judge pass). |
|
|
299
|
+
| `wingman_model` | `""` | Optional Wingman model ID for parallel non-lead bundles (e.g. `google-vertex/gemini-4-argon`). Must be reachable with the same credentials configured for `model` (`api_key`/`api_key_env` or Vertex `gcp_*`). Defaults to `model` when empty. |
|
|
300
|
+
| `fallback_model` | `opencode-go/glm-5.3-flash` | Emergency fallback model tried only after `model` or `wingman_model` fails (error, non-zero exit, missing verdict, or timeout) โ supports cross-provider failover. |
|
|
246
301
|
| `thinking` | `high` | Thinking depth (`off`, `minimal`, `low`, `medium`, `high`). |
|
|
247
302
|
| `review_tools` | `read,grep,find,ls` | Built-in Pi tools enabled during read-only PR reviews. |
|
|
248
303
|
| `review_timeout_minutes` | `auto` | Review timeout budget in minutes, or `auto` to scale dynamically with PR size (24m on small PRs up to 50m on massive multi-bundle PRs). |
|
|
@@ -270,7 +325,15 @@ Comment any of these in the **PR conversation**, inside an **inline diff review
|
|
|
270
325
|
|
|
271
326
|
## Security Model
|
|
272
327
|
|
|
273
|
-
|
|
328
|
+
<div align="center">
|
|
329
|
+
<img src="https://raw.githubusercontent.com/tripplen23/huggy-pr-agent/main/assets/huggy-blocked.svg" alt="Huggy guarded boundary alert" width="184" />
|
|
330
|
+
<br />
|
|
331
|
+
<sub><em>Guarded boundary alert โ shown when a fix attempts to modify protected workflows, lockfiles, or migrations.</em></sub>
|
|
332
|
+
</div>
|
|
333
|
+
|
|
334
|
+
<br />
|
|
335
|
+
|
|
336
|
+
See [SECURITY.md](https://github.com/tripplen23/huggy-pr-agent/blob/main/SECURITY.md) for the full threat model. Key invariants:
|
|
274
337
|
|
|
275
338
|
- **Write-permission verification** โ interactive `@huggy` / `@pi` commands verify true repository `write`/`maintain`/`admin` access via `/repos/{owner}/{repo}/collaborators/{username}/permission` before checking out code or running `setup_cmd` (working seamlessly even when organization memberships are Private).
|
|
276
339
|
- **Base-branch rubric isolation** โ `AGENTS.md` / `CLAUDE.md` and custom prompt files are read from `base` via `git show`, and Pi runs with `--no-context-files --no-approve`. A PR cannot poison its own review checklist or auto-load `.pi/` extensions.
|
|
@@ -281,6 +344,6 @@ See [SECURITY.md](SECURITY.md) for the full threat model. Key invariants:
|
|
|
281
344
|
|
|
282
345
|
## Contributing & License
|
|
283
346
|
|
|
284
|
-
Contributions, bug reports, and prompt improvements are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for local development and testing instructions.
|
|
347
|
+
Contributions, bug reports, and prompt improvements are welcome! See [CONTRIBUTING.md](https://github.com/tripplen23/huggy-pr-agent/blob/main/CONTRIBUTING.md) for local development and testing instructions.
|
|
285
348
|
|
|
286
349
|
Licensed under the [MIT License](LICENSE).
|