Archestra Dependency Override Sweep
SkillSecurityUse when asked to sweep, clean up, or revisit pnpm overrides and minimumReleaseAge exclusions in platform/pnpm-workspace.yaml — unwinding a matured temporary CVE pin once its fix has cleared the 7-day window, or removing an override the dependency graph has made redundant. This skill only sweeps existing pins; it does not author new CVE fixes.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Archestra Dependency Override Sweep skill
What this skill tells your AI
The instructions your AI receives, as published by archestra-ai/archestra in .agents/skills/archestra-dev-override-sweep/SKILL.md and read by ahel’s review.
CVE fixes for transitive or pinned deps — the ones Dependabot can't auto-fix — live as
overrides in platform/pnpm-workspace.yaml. Two kinds of cruft collect there, and this
skill removes them:
- Matured temporary pins. When a fix is newer than the repo's 7-day
minimumReleaseAge(10080minutes) it's pinned exact and the package is added tominimumReleaseAgeExcludeso pnpm installs it anyway. Those are temporary — unwind them once the fix has cleared the window. - Redundant overrides. As the dependency graph catches up, an override stops doing anything: the package already resolves to a compliant version without it.
Out of scope: authoring new CVE fixes (adding overrides for freshly-flagged advisories). This skill only sweeps overrides that already exist.
Work from platform/. Make one override change at a time — one matured pin unwound
(Mode A) or one redundant override removed (Mode B), never several and never one of each.
Smallest blast radius, trivially revertible, easy to bisect.
Mode A — unwind one matured temporary pin
- Find the temporary entries: the
TEMPORARY:comment blocks and theminimumReleaseAgeExcludelist (ignore non-CVE excludes likenext/@next/*— they're kept for other reasons). - Pick one whose pinned fix version has now been published ≥7 days ago — check
npm view <pkg> time --jsonrather than trusting the comment's date. If unsure, proceed anyway: pnpm is the backstop — re-resolving rejects a still-immature version withERR_PNPM_NO_MATURE_MATCHING_VERSION, which simply means leave it quarantined. - For that one package: drop it (and any
@scope/*siblings) fromminimumReleaseAgeExcludealong with itsTEMPORARY:comment, and relax its exact override pin to a>=floor at the fix version — or drop the override entirely if the graph resolves to a non-vulnerable version without it. Leave pins held for a non-CVE reason alone. - Verify (below).
Mode B — drop one redundant override
-
Pick one override to test. Remove its line from
overrides:(and any comment that documents only that line). -
Re-resolve:
corepack pnpm install --lockfile-only --ignore-scripts. -
Judge from
git diff platform/pnpm-lock.yaml. Redundant ⇒ the diff is empty, or at most drops the override's own line from the topoverrides:block / flips aspecifier:reflection. What proves the override was load-bearing is any edit under the resolution sections —importers(dependency refs),packages(aname@version:key, e.g.+ picomatch@2.3.2:), orsnapshots(dependency edges); revert if any of those moved. Read the whole diff — don't grep forversion:alone, since a shift usually shows up as a new/removed package key, not aversion:line.pnpm (v11) often leaves the now-orphaned override line in the lockfile's
overrides:block, so an empty lockfile diff is the normal redundant result, not a sign nothing ran. That stale line is inert metadata — not a re-applied override — and the--frozen-lockfilecheck below confirms it. Don't force a full reinstall orpnpm dedupeto purge it; that adds unrelated graph churn for no resolution benefit. -
Verify (below).
Watch for false positives: a nested override (e.g. mammoth>@xmldom/xmldom) can look
redundant only because a sibling top-level floor (@xmldom/xmldom) is what actually holds
it — removing it adds a package key / shifts a version, which the diff exposes. Treat exact
pins that hold a version down conservatively; they may be pinning out a regression.
Verify (both modes)
- No new CVE. Before editing, note the high/critical advisory set from
corepack pnpm audit --json(the entries withseverityhigh/critical); after re-resolving, take it again and confirm nothing new appeared. A new advisory → revert. - Lockfile + types stay sound:
corepack pnpm install --frozen-lockfile --prefer-offline --ignore-scripts # must say "up to date" corepack pnpm install --fix-lockfile --lockfile-only --ignore-scripts # immature-deps check, must not error corepack pnpm --filter @backend --filter @frontend type-check pnpm auditonly sees npm-package advisories, not base-image OS packages — treat it as a local proxy, not the last word on the image's CVEs.
Notes
- After a sweep the lockfile stays at the resolved version regardless of removing the exclusion; the exclusion only governs install-time maturity enforcement.
- Overrides come in several shapes — plain (
lodash: '>=4.18.0'), exact pins (vite: 7.3.5), major-scoped selectors (ws@>=8,picomatch@<4), and nested (mammoth>@xmldom/xmldom). The lockfile-diff check in Mode B is what actually proves a removal is safe, whatever the shape. minimumReleaseAge(7 days) is a supply-chain defense; only bypass it via the exclude list for a known security fix, and undo it promptly — that's Mode A.
Signals
- GitHub stars
- 4k
- Forks
- 1k
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
archestra-dev-override-sweep- Source
- github.com/archestra-ai/archestra