Skip to content

chore(docs-deps): refresh lockfile to clear both critical advisories - #342

Merged
glennko merged 1 commit into
mainfrom
chore/docs-deps-audit-refresh
Sep 3, 2026
Merged

chore(docs-deps): refresh lockfile to clear both critical advisories#342
glennko merged 1 commit into
mainfrom
chore/docs-deps-audit-refresh

Conversation

@glennko

@glennko glennko commented Aug 29, 2026

Copy link
Copy Markdown
Member

Summary

Single npm audit fix --package-lock-only pass on the docs site. package.json is untouched — no declared range changes, only the resolved tree.

before after
critical 2 0
high 33 18
moderate 14 6
low 6 0
total 55 24

Both criticals cleared:

Neither had an open PR — dependabot never proposed a fix for either.

Supersedes the open docs dependabot PRs

Every one targeted a version that is no longer sufficient:

PR wanted why it falls short this PR
#314 / #330 node-forge 1.3.2 4 highs need 1.4.0 dropped from tree
#311 / #331 js-yaml 3.14.2 / 4.1.1 highs need 3.15.1 / 4.3.1 4.3.2
#317 lodash 4.17.23 already in main, still vulnerable; needs 4.18.0 4.18.1
#326 / #329 webpack 5.105.1 (sufficient, but subsumed) 5.110.1
#332 qs 6.14.2 CVE-2026-8723 needs 6.15.2 6.15.3
#309, #325 already satisfied in main

What remains

The 24 remaining sit inside the Docusaurus dependency tree — image-size, serialize-javascript, and the webpack-dev-serversockjsuuid chain. Most report no non-breaking fix and would need a Docusaurus major upgrade. The dev-server chain affects docusaurus start, not docusaurus build.

npm audit fix --force was deliberately not used — it would churn the Docusaurus major version and risk the docs build, for issues that are dev-time only.

Scope note

All 69 GitHub advisories for this repo are in docs/package-lock.json. The docs site is private: true and never published, so none of this ships to users of the Python package.

Checklist

  • Tested — npm ci then npm run build: both bundles compile, static files generated
  • Documented — supersession table above

xpt1x
xpt1x previously approved these changes Aug 31, 2026

@xpt1x xpt1x left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍

Single `npm audit fix --package-lock-only` pass on the docs site.
package.json is untouched -- no declared range changes, only the
resolved tree.

Regenerated against current main, which now carries the merged
dependabot bumps (#347, #346, #332, #326, #314, #352, #351, #349,
#348). Those bumps did not reach either critical, and dependabot
never proposed a fix for websocket-driver at all.

           before  after
critical        2      0
high           27     18
moderate       14      8
low             5      0
total          48     26

Both criticals cleared:
- shell-quote     1.8.3 -> 1.10.0  (CVE-2026-9277)
- websocket-driver 0.7.4 -> 0.7.5  (CVE-2026-54466)

Also lodash 4.17.23 -> 4.18.1 and node-forge dropped from the tree.

The remaining 26 sit inside the Docusaurus dependency tree --
image-size, serialize-javascript, and the webpack-dev-server ->
sockjs -> uuid chain. Most report no non-breaking fix and would need
a Docusaurus major upgrade. The dev-server chain affects
`docusaurus start`, not `docusaurus build`.

`npm audit fix --force` was deliberately not used -- it would churn
the Docusaurus major version and risk the docs build, for issues that
are dev-time only.
@glennko
glennko force-pushed the chore/docs-deps-audit-refresh branch from 3b9736f to 482f23f Compare September 3, 2026 03:49
@glennko
glennko merged commit 2173e28 into main Sep 3, 2026
4 checks passed
@glennko
glennko deleted the chore/docs-deps-audit-refresh branch September 3, 2026 04:30
glennko added a commit that referenced this pull request Sep 3, 2026
)

There was no .github/dependabot.yml, so Dependabot ran on defaults and
opened one PR per package against docs/package-lock.json. Twelve such
PRs accumulated; they conflicted with each other and with hand-written
lockfile work (#342), and each merge forced the rest to rebase. Three
were already redundant by the time they were reviewed.

Group all docs npm minor/patch bumps into a single weekly PR so the
lockfile is only rewritten once per cycle, and cap concurrent PRs at 3.
Majors stay ungrouped so they still get individual review.

Also groups github-actions bumps, which are low volume.

Note the docs site is `private: true` and never published, so these are
build-time dependencies only.

Co-authored-by: Glenn Ko <glennko@users.noreply.github.com>
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.

2 participants