Skip to main content

Ghsa Advisories

@hmcrum/ghsa-advisoriesv2026.09.17.1· 3d agoMODELS
01README

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=lodash
02Models1
@hmcrum/ghsa-advisoriesv2026.09.17.1ghsa_advisories.ts

Global Arguments

ArgumentTypeDescription
tokenstringGitHub token with public read access, e.g. ${{ vault.get("briefing", "GITHUB_TOKEN") }}
userAgentstringUser-Agent sent to api.github.com — identify yourself honestly
fn advisories(package: string, limit: number)
Look up GHSA advisories for a package + ecosystem (as pulled from a Renovate MR), so a human can judge whether a version bump matters for security. Read-only, one fan-out call: pages through GitHub's securityVulnerabilities connection internally and emits a single resource.
ArgumentTypeDescription
packagestringPackage name exactly as reported (e.g. lodash) — no default
limitnumberMax advisories to return, most-recently-updated first. Paged past GraphQL's 100-per-page cap when larger

Resources

advisories(30m)— Known GitHub Security Advisories for one package in one ecosystem, ranked most-recently-updated first
03Stats
A
100 / 100
Downloads
1
Archive size
10.6 KB
  • 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
  • License declared1/1earned
  • Verified public repository2/2earned
04Platforms
05Labels