rga-pressure-bridge-stub
Status: stub. The full-length analysis is queued for a v1.0.x patch release per ADR 0018, section 5, criterion #6. The companion rule page at docs/rules/rga-pressure-bridge-stub.md contains the canonical detection logic + GPU reasoning.
TL;DR
The current vgpr-pressure-warning rule is an AST heuristic. AMD's RGA ("Live VGPR Analysis") produces ground-truth per-block VGPR counts after codegen. The bridge is queued for v0.10; this stub keeps the candidate alive in the rule catalog while the infrastructure is being built.
What the rule fires on
Per ADR 0018 §4.3, this is an infrastructure investment, not a rule per se. Fires once per source compiled under the [experimental.target = rdna4] config gate, emitting a Severity::Note informational diagnostic that points the developer to the future tools/rga-bridge work item.
See the What it detects section of the rule page for the full pattern definition.
Why it matters
The full GPU-mechanism analysis lives in the Why it matters on a GPU section of the companion rule page.
Examples
The bad / good code snippets are kept canonical on the rule page; see rga-pressure-bridge-stub.md -> Examples.
See also
- Rule page -- canonical reference + change log.
- rdna4 overview -- broader context.
- ADR 0018 -- v1.0 readiness plan.
This is a v1.0-ship stub. Full analysis pending; track issue link TBD.
TODO: category-overview missing for rdna4; linked overview is the closest sibling.