Skip to content

Fix package-lock.json sync so npm ci succeeds in deploy#5

Merged
ethanj merged 1 commit intomainfrom
docs-fix-lockfile-sync
Apr 20, 2026
Merged

Fix package-lock.json sync so npm ci succeeds in deploy#5
ethanj merged 1 commit intomainfrom
docs-fix-lockfile-sync

Conversation

@ethanj
Copy link
Copy Markdown
Contributor

@ethanj ethanj commented Apr 20, 2026

Problem

The Deploy Docs workflow (run 24659336800) failed on `npm ci` with:

```
npm error Missing: search-insights@2.17.3 from lock file
npm error Missing: docusaurus-plugin-sass@0.2.6 from lock file
npm error Invalid: lock file's picomatch@2.3.2 does not satisfy picomatch@4.0.4
```

Cause

During the Phase 5 plugin install, `npm install --legacy-peer-deps` wrote a lock file that didn't fully resolve some transitive deps pulled in by `docusaurus-plugin-openapi-docs` / `docusaurus-theme-openapi-docs`. `npm ci` refuses to install against an out-of-sync lock.

Fix

Regenerated the lock file with a clean `rm -rf node_modules package-lock.json && npm install` (no `--legacy-peer-deps` flag — the peer tree resolves cleanly on its own). Verified `npm ci` now succeeds against the new lock locally.

Test plan

  • `rm -rf node_modules && npm ci` exits 0
  • `node_modules/docusaurus-plugin-openapi-docs/` populated
  • `npm run build` still succeeds

The Phase 5 install used --legacy-peer-deps, which left some transitive
deps (search-insights, docusaurus-plugin-sass, picomatch 2.3.2) missing
from the lock. npm ci refuses to install when the lock is out of sync,
so CI's 'Deploy Docs' workflow was failing on npm ci.

Regenerated the lock with a clean 'rm -rf node_modules package-lock.json
&& npm install' (no --legacy-peer-deps needed — the peer tree is fine
on its own). Verified 'npm ci' succeeds against the new lock.
@ethanj ethanj merged commit 6df76ab into main Apr 20, 2026
@ethanj ethanj deleted the docs-fix-lockfile-sync branch April 20, 2026 09:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant