Ghsa Advisories
Look up known GitHub Security Advisories (GHSA) for a package + ecosystem — the same {ecosystem, package} shape a Renovate merge request reports.
Built to complement a Renovate triage flow: given what a bump MR names, returns ranked advisories (GHSA id, associated CVE ids, severity, vulnerable version range, first patched version) so a human reviewing the MR can judge whether it matters for security, not just how far the version number moved.
One method, advisories. Read-only, host-locked to api.github.com, pages GitHub's GraphQL securityVulnerabilities connection internally, and never throws: a missing token, an exhausted rate-limit retry, or a GraphQL error all degrade into errors/unreadable fields on the result rather than an exception, so a partial result can never be mistaken for "no advisories".
Requires a GitHub token (GraphQL rejects anonymous calls) — no special scopes needed for public advisory data.
Quick Start
--global-arg 'token=${{ vault.get("briefing", "GITHUB_TOKEN") }}'
swamp model method run advisories advisories \
--input ecosystem=NPM --input package=lodashGlobal Arguments
| Argument | Type | Description |
|---|---|---|
| token | string | GitHub token with public read access, e.g. ${{ vault.get("briefing", "GITHUB_TOKEN") }} |
| userAgent | string | User-Agent sent to api.github.com — identify yourself honestly |
| Argument | Type | Description |
|---|---|---|
| package | string | Package name exactly as reported (e.g. lodash) — no default |
| limit | number | Max advisories to return, most-recently-updated first. Paged past GraphQL's 100-per-page cap when larger |
Resources
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License1/2partial
no SPDX license declared
- Verified public repository2/2earned