sheplu/Dependency Guard

Scan Node.js dependencies for outdated/deprecated packages with policy enforcement.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
versionVersion spec of @sheplu/dependency-guard to run via npx. Accepts any spec npm understands: an exact version ("0.1.0"), a semver range ("^0.1.0"), a dist-tag ("latest", "next"), or a git/file URL. Defaults to "latest" for getting-started ergonomics; pin for reproducible builds. nolatest
working-directoryDirectory containing package.json. Ignored if "path" is set.no.
pathExplicit package.json path. Overrides "working-directory".no
formatOutput format printed to the action log: table | json | markdown.notable
fail-onFail the job if updates are needed at this level: major | minor | patch | any | deprecated.no
max-age-daysFail if any dependency version is older than N days.no
onlyComma-separated package names to analyze (e.g. "react,lodash").no
ignore-scopesComma-separated npm scopes to skip (e.g. "@internal,@private").no
filterComma-separated dependency buckets to include: prod, dev, peer, optional, overrides, resolutions, pnpm-overrides.no
include-transitiveExpand analysis via lockfile to include transitive dependencies.nofalse
registryCustom npm registry URL.no
no-cacheDisable registry response cache.nofalse
cache-clearClear the registry cache before running.nofalse
cache-ttlCache TTL in minutes.no
sortSort by: age | status | name.no
all-columnsTable format: show empty patch/minor/major columns.nofalse
update-levelWARNING: Rewrites package.json. One of: patch | minor | major | all. Pair with dry-run for safety.no
dry-runPreview --update changes without writing.nofalse
quietSuppress summary line in non-JSON formats.nofalse
summaryWrite a markdown report to $GITHUB_STEP_SUMMARY.notrue
namedescription
totalTotal dependencies analyzed.
up-to-dateCount of up-to-date dependencies.
patch-updatesCount of dependencies needing patch updates.
minor-updatesCount of dependencies needing minor updates.
major-updatesCount of dependencies needing major updates.
deprecatedCount of deprecated dependencies.
policy-passed"true" if exit code was 0; "false" if --fail-on or --max-age tripped (exit 2).
report-jsonFull JSON report from dependency-guard, inline. Omitted (empty string) when the report exceeds GitHub's ~1 MB output limit; read "report-path" instead.
report-pathFilesystem path to the full JSON report. Always set; use for large reports.