Uh oh!
There was an error while loading. Please reload this page.
fix(pr-followup): skip informational bot comments instead of blocking on them - #709
Merged
Merged
Conversation
added 2 commits
August 4, 2026 20:49
… on them The comment path ingested every non-author comment on a bot PR as REVIEW_FEEDBACK, so a CI bot posting a size-diff table became a work item: classifyFeedback finds no actionable pattern in markdown, defaults to needs_human, and the PR sits BLOCKED on a human forever. Observed on misospace/llmkube-images#114 — a MERGEABLE, unreviewed PR blocked since 2026-08-04 by an app-size-diff comment reporting +0 B (+0%). Same cause on #46 and #99. The queue read 9 NEEDS_HUMAN items when only informational noise and already-merged PRs were behind them. Gate the comment descriptor on a new isInformationalComment(): sticky comment markers (the sticky-pull-request-comment convention embeds one so the action can update in place, which makes it a structural signal rather than a prose guess) plus dispatch's own pr-fix-blocked notice. An ai-pr-reviewer comment stays ingestible even when it carries a marker — it ships structured findings and is genuine review feedback. Does not address the stale-item half of the same symptom (#692): items already queued when their PR merges are still never reaped. Signed-off-by: Jory Irving <jory.irving@users.noreply.github.com>
The informational-comment tests use vi.restoreAllMocks(); vitest globals make that work at runtime, so the suite passed while tsc and next build failed on TS2304. Signed-off-by: Jory Irving <jory.irving@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
AI Automated Review
Full PR review.
Analysis engine: self-hosted@https://litellm.jory.dev/v1 (openai) — fallback (primary failed)
PR Review: fix(pr-followup): skip informational bot comments instead of blocking on them
Recommendation
Approve — This is a well-scoped fix that addresses a real bug where CI bot comments (size-diff tables, coverage summaries) were being ingested as REVIEW_FEEDBACK, causing mergeable PRs to be permanently BLOCKED in NEEDS_HUMAN. The implementation uses structural HTML comment markers for reliable detection and includes comprehensive test coverage.
Change-by-Change Findings
src/lib/pr-followup-ingestion.ts
- Added
isInformationalComment()function (lines 203-227): Correctly identifies informational comments using structural markers (<!-- Sticky Pull Request Comment,<!-- dispatch-pr-fix-blocked -->) rather than prose-based heuristics. The ai-pr-reviewer exemption is properly handled — structured findings payloads are still ingested as genuine feedback. - Modified comment ingestion gate (line 311): Changed from
() => trueto(event) => !isInformationalComment(event.body). This is the minimal, correct change to prevent informational comments from entering the queue.
src/lib/pr-followup-ingestion.test.ts
- Added
isInformationalCommenttest suite (lines 786-820): Covers sticky CI comments, dispatch's own BLOCKED notice, ai-pr-reviewer exemption with marker, and plain prose/empty/null cases. - Added integration regression test (lines 822-853): Verifies the real PR 114 scenario — size-diff comment is not enqueued, while genuine prose comments still enqueue as NORMAL. This is exactly the bug being fixed.
Standards Compliance
- ✅ No hardcoded agent or repo names in generic logic (uses configurable markers)
- ✅ Error handling follows existing patterns
- ✅ Tests cover edge cases (null, empty, exempt payloads)
- ✅ Implementation is internally consistent with existing
parseAiReviewerFindingspattern - ✅ CI checks all pass (Docker Build, Build, Lint, Typecheck, Tests)
Tool Harness Findings
Tool harness completed 4 planned requests across 2 loop rounds. All file reads succeeded. No tool failures or anomalies detected.
Unknowns or Needs Verification
- The PR body mentions "17 of the 18 currently-BLOCKED items are for already-merged PRs" — this is a separate issue (PR 692) and is correctly scoped out of this PR.
- No verification needed beyond what's covered by the test suite and CI results.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
isInformationalComment()gates the comment ingestion descriptor: sticky CI comments and dispatch's ownpr-fix-blockednotice are no longer ingested asREVIEW_FEEDBACK.ai-pr-reviewercomments stay ingestible even when they carry a sticky marker — they ship structured findings and are genuine feedback (the fix(pr-followup): route ai-pr-reviewer CHANGES_REQUESTED reviews by structured findings #630 path).Why
A CI bot saying nothing changed was enough to permanently block a mergeable PR.
misospace/llmkube-images#114—MERGEABLE, unreviewed — has beenBLOCKEDinNEEDS_HUMANsince 2026-08-04 because of this comment body:Every non-author comment on a bot PR was ingested;
classifyFeedbackcan't find an actionable pattern in a markdown table, so it defaults toneeds_humanand the item blocks. Same cause on #46 and #99.The discriminator is structural, not prose-based: the sticky-comment convention embeds a hidden marker (
<!-- Sticky Pull Request Comment... -->) precisely so the action can update its comment in place.Verification
vitest run: 2078 passed (118 files). New tests:isInformationalComment(sticky / dispatch-notice / ai-reviewer-exempt / plain prose), plus aningestCommentEventregression using the real Move issue grooming and queue reconciliation into Dispatch #114 body asserting nothing is enqueued, and a companion asserting genuine prose still enqueues asNORMAL.tsc --noEmit+eslintclean.Scope note
This fixes the misclassification half. The stale half — items already queued when their PR merges are never reaped — is #692 and still open; 17 of the 18 currently-BLOCKED items are for already-merged PRs.