web-widgets: Skill for Claude Code

Fix Vulnerable Transitive Dependency

Use when a security advisory identifies a vulnerable transitive package (one not directly in any package.json) and you need to force it to a safe version across the monorepo without bumping unrelated packages.

The user will provide the package name and the fixed versions from the advisory.

Process

1. Discover all versions in use

Run pnpm why -r to see every resolved version and the full dependency chain explaining why each exists:

pnpm why -r <package>

Each top-level line (<package>@x.y.z) is a distinct version in the graph. The tree below it shows which packages pull it in — useful for understanding whether a version can be collapsed or must stay separate.

To extract just the version list:

pnpm why -r <package> | grep '^<package>@'

2. Find latest safe version per major

For each major currently in the lockfile, find the latest available version on npm:

npm view <package> versions --json | node -e "
const v = JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'));
const majors = {};
v.forEach(ver => {
  const m = parseInt(ver.split('.')[0]);
  if (!majors[m]) majors[m] = [];
  majors[m].push(ver);
});
Object.entries(majors).forEach(([m, vers]) => {
  console.log('Major', m, '— latest:', vers[vers.length-1]);
});
"

Cross-reference with the advisory's "Fixed in" versions — use whichever is higher.

3. Add overrides to root package.json

In the pnpm.overrides section of the root package.json, add one entry per major using the @major selector syntax:

"pnpm": {
  "overrides": {
    "<package>@1": "1.x.y",
    "<package>@2": "2.x.y",
    "<package>@5": "5.x.y"
  }
}

Only add majors that are actually present in the lockfile.

4. First pnpm install — update the lockfile

pnpm install

This writes the pinned versions into pnpm-lock.yaml.

5. Remove the overrides from package.json

Delete the entries added in step 3. The lockfile now has the correct versions recorded and will enforce them on its own.