ci: adopt the inline pr-agent lane — a public repo cannot call a private reusable workflow - #65
ci: adopt the inline pr-agent lane — a public repo cannot call a private reusable workflow#65yakimoto wants to merge 6 commits into
Conversation
🤖 CodeAnt AI — Review Status
|
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_1df86b51-910d-487b-bd14-3ff0f8c45cf1) |
|
Warning Review limit reachedNext included review available in 27 minutes. View limit detailsLimit details: You’ve used the included review currently available. Your 91 included PR review attempts over the past 7 days set your current allowance at 1 review per hour. Your organization has reached its usage spending cap. Adjust your spending cap in the billing tab. Review configuration: ⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Pro Plus Run ID: 📒 Files selected for processing (2)
Comment |
Reviewer's GuideThis PR replaces the broken reusable pr-agent workflow invocation with an inline, fully self-contained workflow tailored for public repositories, and updates it to match the current reusable lane behavior, including concurrency fixes, timeouts, retry logic, and non-blocking verdict classification. Sequence diagram for PR-Agent retry and verdict classificationsequenceDiagram
participant GitHub
participant Lane as pr_agent job
participant Agent as PR-Agent action
participant Verdict as verdict step
GitHub->>Lane: Start pull_request or trusted slash-command run
Lane->>Agent: Run attempt 1 (6-minute timeout)
alt attempt 1 succeeds
Agent-->>Verdict: success
Verdict-->>GitHub: exit 0
else attempt 1 fails
Agent-->>Lane: failure
Lane->>Lane: sleep 45
Lane->>Agent: Run retry attempt 2 (6-minute timeout)
Agent-->>Verdict: success or failure
Verdict-->>GitHub: classify result and remain non-blocking
else run is cancelled
Agent-->>Verdict: cancelled or no outcome
Verdict-->>GitHub: classify workflow-level cancellation
end
Flow diagram for PR-Agent event isolation and executionflowchart TD
Event[Pull request or issue comment event] --> Group[Concurrency key includes event name and PR number]
Group --> Eligible{Eligible to run?}
Eligible -->|No| Skip[Skip job]
Eligible -->|Yes| Attempt[Run PR-Agent attempt]
Attempt --> Result{Attempt succeeds?}
Result -->|Yes| Pass[Verdict exits 0]
Result -->|No| Retry[Wait 45 seconds and retry]
Retry --> Verdict[Classify success, failure, timeout, or cancellation]
Verdict --> NonBlocking[Advisory outcome does not block the PR]
File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
|
Running ultrareview automatically — Running ultrareview automatically — This change modifies cross-cutting CI/CD infrastructure and security-sensitive authorization logic that will be replicated across dozens of repositories, warranting a deep analysis of potential side effects and concurrency issues.. I'll post findings when complete. |
|
I can't run this ultrareview because your workspace has reached its monthly review limit. cubic has reviewed 100,145 of the 100,000 allowed lines of code this month. Reviews resume on 4 September 2026 (in 13 days). Enable flex capacity to cover overages automatically and resume reviews now. Learn how flex capacity works. To help optimise your usage, you can tune cubic to get the most out of your usage limits:
|
PR Summary by QodoCI: inline PR-Agent workflow to avoid private reusable-workflow calls
AI Description
Diagram
High-Level Assessment
Files changed (1)
|
ApprovabilityVerdict: Not approved Macroscope's review found this PR not approvable — This PR replaces a broken reusable-workflow reference with a substantial secret-bearing CI workflow that changes PR and comment execution, fork handling, concurrency, retries, and automated write-capable review behavior. The workflow is also outside the author’s CODEOWNERS ownership, so designated human review is warranted. Not approved because:
Review your spending limits in Billing settings. You can add or adjust custom eligibility rules. Learn more. |
PR Reviewer Guide 🔍(Review updated until commit 62c65cc)Here are some key observations to aid the review process:
|
|
Note Automatic reviews are paused because your team has used its included automatic processing for this billing period (headroom scales with your seat count). You can still comment "Gitar review" to run one anytime, and automatic reviews resume on their own by September 1. Add seats for more headroom. Code Review ✅ ApprovedReplaces the private reusable workflow reference with an inline PR-agent workflow to fix public repo check failures. No issues found. OptionsDisplay: compact → Showing less information. Comment with these commands to change the behavior for this request:
Was this helpful? React with 👍 / 👎 | Gitar |
There was a problem hiding this comment.
Hey - I've reviewed your changes and they look great!
Sourcery assessment
Needs a human reviewer. If the workflow or pinned action is wrong, a PR-triggered job can use the repository's OPENAI_KEY and write-capable GitHub token, potentially exposing access or making automated repository changes that reverting the workflow cannot undo. The retry and concurrency changes also alter when runs execute, but their ordinary failures are recoverable.
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.
PR Code Suggestions ✨No code suggestions found for the PR. |
Code Review by Qodo
1.
|
|
The job-level .github/workflows/pr-agent.yml |
Qodo Fixer✅ Merged (0) · ☑ Fixed (0) Process
|
…ate reusable workflow This repo's pr-agent.yml calls `wave-av/wave-foundation/.github/workflows/reusable-pr-agent.yml`, and wave-foundation is PRIVATE. GitHub does not permit a PUBLIC repository to call a reusable workflow from a private one, so the `uses:` never resolves: the run dies before any job is created — conclusion: failure, total_count: 0, no log, and no check run on the head sha to read. Every PR here has carried a red check that reports nothing, and external contributors see it. Measured across the org 2026-08-22: 7 public repos / 176 runs / 100% failure; 9 private repos / zero failures — a clean 16/16 split on visibility alone. Three competing hypotheses (missing OPENAI_KEY, dead pinned ref, @main vs a pinned sha) were each tested and refuted. THE FIX already existed and was never adopted: wave-foundation-public/.github/workflows/pr-agent.yml is an INLINE copy of the same lane with no reference to the private repo. This adopts it verbatim. PROVEN BEFORE FANNING OUT. wave-certify#44 took this exact change first and its pr_agent run returned SUCCESS on the pull_request event — a job with a real log, where the broken form produced no job at all. 27 repos were not changed on hope. Two prerequisites named in wave-pen#388 are cleared as of wave-foundation-public#71: the shared concurrency key that let any bot comment cancel a live review ~10s in (wave-pen#386) now keys on github.event_name, and the lane carries step-level timeouts. The job id stays `pr_agent`, so the check-run context is unchanged and no branch protection rule needs touching. Refs wave-pen#388 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
c65ca81 to
62c65cc
Compare
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_6e3fa34e-7f7c-4e45-b40a-3d8f4876ac8a) |
|
Persistent review updated to latest commit 62c65cc |
…t classification Picks up wave-foundation-public#72, which landed after this PR was opened. The template this PR originally copied classified timeouts on TOTAL job time (attempt 1 + 45s backoff + attempt 2) against STEP_BUDGET_S=360, a PER-ATTEMPT budget. Two healthy-but-slow attempts (~180s each) were therefore reported as "TIMED OUT ... A hang, NOT a rate limit", and the else-branch claimed the run was "well inside the budget" from the same misused total. Found by qodo review on wave-monitor#48 and confirmed against the file. Now stamps each attempt separately and classifies on the LONGEST attempt, with if: always() end stamps so an attempt killed BY its step timeout still records one. Verified by dry-running both cases before the template landed. Updated in place rather than as a follow-up PR because this has not merged yet — cheaper, and it keeps the repo from ever carrying the defective version. Refs wave-av/wave-pen#417, wave-av/wave-pen#388
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_461d6c0d-c1e1-491e-bb12-fe0fbd818b95) |
…s step cap Re-syncs this PR to the hardened template before it merges, so it cannot land carrying the two defects it was opened with (wave-pen#418, wave-foundation-public#73). 1. Fork status is now RESOLVED, not assumed. The job-level `if:` refuses forks on the `pull_request` arm; it structurally cannot on `issue_comment`, because fork status is absent from that payload — measured, with a positive control: `issues/<n>.pull_request` carries exactly [diff_url, html_url, merged_at, patch_url, url], while `pulls/<n>.head.repo.fork` answers. A `fork gate` step asks the pulls endpoint and FAILS CLOSED: only a literal `false` proceeds; a 404, a revoked token, a rate limit and `.head.repo = null` all skip. Scope: this lane runs no `actions/checkout`, so fork code is never fetched or executed and no exfiltration path existed. The durable defect was the comment claiming "Forks skipped (no secrets there)" — true of one arm, false of the other, and exactly what would mislead whoever adds a checkout step later. 2. CONFIG__AI_TIMEOUT 600 -> 300, in both env blocks. 600s inside a 360s step is unreachable: the runner killed the step first, so pr-agent never reached its own timeout and never fell back to CONFIG__FALLBACK_MODELS. 3. A latent classifier bug the gate exposed: `stamp attempt 2 end` runs under `if: always()`, so when attempt 2 never ran the arithmetic subtracted from zero and reported a 1787580408-second attempt as a confident TIMED OUT. Fixed at the arithmetic; the verdict also gains an explicit `skipped` branch. The job id stays `pr_agent`, so the check-run context is unchanged and no branch protection rule needs touching. Refs wave-pen#418, wave-pen#417, wave-pen#388 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_bbeca419-d6ea-4696-bb6f-33d1901f4b71) |
…ce of a true
Review of this wave found the fail-closed gate had a fail-OPEN consumer. Two
reviewers flagged it independently, on two different repos, and they were right.
if: steps.gate.outputs.fork != 'true' # grants when the output is EMPTY
The gate could only fail closed if it always wrote an output. It did, on every
path — so this did not fail open today, and the implicit success() on the
consumer covers a gate that errors outright. But the safety rested on an
argument rather than on the structure, and it is the very argument this change
exists to delete: absence must not read as permission.
Two independent changes, so neither carries the invariant alone:
- the gate now assigns a shell variable that STARTS at `true` and writes ONCE
at the end, so no future edit adding an early exit can emit nothing;
- the consumer requires `== 'false'`, an explicit affirmative, so an empty or
missing output skips the agent.
Also braces both sides of the A2 subtraction in the verdict step. The bare
`ATTEMPT2_START` was CORRECT — POSIX arithmetic expansion evaluates a bare name
as a variable, verified identical (180 == 180) — but a reviewer read it as a
literal token and filed it High. An expression that reads wrong on 27 repos gets
re-filed on 27 repos, so it is normalised rather than defended.
RECEIPTS. actionlint clean; zizmor clean; shellcheck clean. The gate was driven
through all six branches plus the reviewers' no-output scenario: only a literal
`false` reaches AGENT RUNS. The verdict was re-run across all six states and is
unchanged on the five that already worked.
LIVE: wave-av/api-spec merged the previous revision and its pull_request run
executed `fork gate (issue_comment only) -> success` in production, then ran the
agent — so the gate does not wrongly refuse a legitimate same-repo PR.
Upstream: wave-av/wave-foundation-public#73. Refs wave-pen#418, wave-pen#417.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_d337fb48-b344-4955-ab74-9ec18d73348e) |
…mber space Review found a SECOND concurrency collision, on a different axis from the one this template already documents (wave-pen#386). `issue_comment` fires for ISSUES as well as PRs, and GitHub draws both from ONE number sequence. So a comment on Issue #30 and a `/review` on PR #30 entered the same concurrency group. Concurrency is evaluated at WORKFLOW level, BEFORE the job-level `if:` runs — so the Issue comment cancelled the PR review already in flight, and was then skipped itself, having done nothing. That is the identical shape as the #386 defect the block above exists to fix, one axis over: a run that will not review taking the lane from the run that would have. #386 separated the two EVENTS; it did not separate the two number spaces inside one event. pull_request PR 433 -> pr-agent-pull_request-pr-433 issue_comment on PR 30 -> pr-agent-issue_comment-pr-30 issue_comment on ISSUE 30 -> pr-agent-issue_comment-issue-30 The last two used to be one group. actionlint and zizmor clean. Upstream: wave-av/wave-foundation-public#73. Refs wave-pen#418, wave-pen#417. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_54cb06d8-3aed-43ea-9a32-232b4971261a) |
A reviewer flagged the missing entry on wave-modules#41. 25 of the 28 repos in this wave keep the same Keep-a-Changelog convention, so the entry lands in all of them rather than only the repo whose review happened to catch it — fixing the reported instance and leaving the class is the pattern this wave keeps undoing. The change IS user-visible, which is why it belongs here: a maintainer's `/review` on a fork PR is now declined with a warning instead of silently running, so contributors on forks see different behaviour. Refs wave-pen#418, wave-av/wave-foundation-public#73 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: serverGenReqId_5a0f38c1-fc7b-4f5d-af9f-0491088ab425) |
User description
User description
User description
User description
User description
Part of the fan-out tracked in wave-pen#388, proven first on wave-certify#44 where
pr_agentreturned success.The defect
pr-agent.ymlhere callswave-av/wave-foundation/.github/workflows/reusable-pr-agent.yml@main, and wave-foundation is private. GitHub does not permit a public repository to call a reusable workflow from a private one, so theuses:never resolves: the run dies before any job is created —conclusion: failure,total_count: 0, no log, and no check run on the head sha at all.That is worse than a normal failure. There is nothing to click through to. Every PR on this repo has been carrying a red check that reports nothing, and external contributors see it.
Measured on this repo today — the last 5
pr-agentruns:Measured across the org on 2026-08-22: 7 public repos / 176 runs / 100% failure; 9 private repos / zero failures. A clean 16/16 split on visibility alone. Three competing hypotheses were each tested and refuted — missing
OPENAI_KEY(present in both populations), a dead pinned ref (150ffae2resolves, file exists at it), and@mainvs a pinned sha (wave-realtime-edgepins@mainand fails,wave-penpins@mainand works).The fix already existed and was never adopted
wave-foundation-public/.github/workflows/pr-agent.ymlis an inline copy of the same lane with no reference to the private repo. Its own header says it was written for exactly this. This PR adopts it verbatim.So this is an adoption gap, not a design gap.
Why now, and not when #388 was filed
#388 named two blockers, and both are cleared as of wave-foundation-public#71:
pr-agent-${{ github.event.pull_request.number || … }}, shared betweenpull_requestandissue_comment, so any bot comment cancelled a live review ~10s in (wave-pen#386). It now keys ongithub.event_name.Fanning out before those landed would have traded a red-with-no-log lane for a cancelled-on-every-comment lane — a different failure, not a fix.
Verified before opening this
wave-foundation/mentions are in comments, not in auses:. Checked rather than assumed, since that is the whole property this depends on.pr_agent. A job's id is its check-run context and branch protection matches on(context, app_id), so nothing needs touching on the protection side.wave-foundation-public's default branch — not from a local checkout that might be parked on another branch.The receipt is this PR, not the diff
A red lane and a working lane are indistinguishable until one actually runs — that is the whole reason 176 failures went unexamined. So the proof is
pr-agentgoing green on this PR. If it does, the remaining 27 repos get the same change with evidence behind it. If it does not, we learn that here, on one low-traffic repo, instead of across the org's entire public surface.Proven before fanning out. wave-certify#44 took this exact change first and its
pr_agentrun returned success on thepull_requestevent — a job with a real log, where the broken form produced no job at all. The other repos were not changed on hope.Refs wave-pen#388
Need help on this PR? Tag
@codesmith-botwith what you need. Autofix is disabled.Note
Medium Risk
CI now holds OPENAI_KEY in-repo and adds fork/slash-command gating plus retry/verdict logic. A gate bug could spend the LLM key or skip reviews; it does not change product auth or data handling.
Overview
Replaces the unusable
uses:of privatewave-foundationreusable pr-agent with a self-contained inline workflow. Public repos cannot call private reusable workflows, so the old job never started (red check, no log).The new lane runs Qodo Merge (
The-PR-Agent/pr-agent@v0.42.0) with event-scoped concurrency so comments no longer cancel in-flight push reviews, a fail-closed fork gate on/commands, 6-minute attempts with a 45s retry, and a verdict step that classifies timeout/cancel/429 and stays neutral so an advisory reviewer cannot block the PR.CONFIG__AI_TIMEOUTis 300s so the agent can fall back before the step is killed.Changelog documents the fork-gate, timeout, and attempt-2 stamp arithmetic fixes. Maintainer
/reviewon fork PRs is now declined instead of running on the org key.Reviewed by Cursor Bugbot for commit 545cf0f. Bugbot is set up for automated code reviews on this repo. Configure here.
Summary by Sourcery
Restore functional, non-blocking pull-request reviews in public repositories by adopting the inline pr-agent workflow and strengthening its safety and failure handling.
Bug Fixes:
Enhancements:
CI:
Documentation:
PR Type
Bug fix, Enhancement
Description
Replaced private workflow reference with inline public version
Fixed concurrency grouping to prevent job collisions
Added fork detection and handling for issue comments
Implemented timeout management and retry logic
Added detailed outcome classification for advisory reviews
Diagram Walkthrough
flowchart TD A["Concurrency Group"] --> B["Fork Gate Check"] B --> C{"Fork?"} C -->|Yes| D["Skip with warning"] C -->|No| E["Attempt 1 (6min)"] E --> F["Stamp Start"] E --> G["Run PR-Agent"] G --> H["Stamp End"] H --> I{"Success?"} I -->|Yes| J["Exit"] I -->|No| K["Backoff 45s"] K --> L["Attempt 2 (6min)"] L --> M["Stamp Start"] L --> N["Run PR-Agent"] N --> O["Stamp End"] O --> P["Verdict Classification"] P --> Q["Report Outcome"]File Walkthrough
pr-agent.yml
Rewrote pr-agent workflow with inline implementation.github/workflows/pr-agent.yml
context
CHANGELOG.md
Updated changelog with workflow improvementsCHANGELOG.md