beads/engdocs/SECURITY-DEPENDENCY-EXCEPTIONS.md
Dustin Brown 4e2eeecc02
Bump Go to 1.26.5 (#4942)
* /{engdocs,examples,go.mod}: bump go version

* deps: bump golang.org/x/text to v0.39.0 (GO-2026-5970)

govulncheck against today's vuln DB flags GO-2026-5970 (infinite loop on
invalid input in x/text, reachable via internal/routing), published after
this PR's original clean scan. Bump x/text to the fixed v0.39.0 (with its
MVS sibling x/* minimums) and re-tidy examples/library-usage, which
builds against the parent via a replace directive and would otherwise
fail with missing go.sum entries.

examples/bd-example-extension-go is left untouched: it already fails
'go build' (needs go mod tidy) at the PR's base state, so its tidy is
pre-existing follow-up work, not fallout from this bump.

Verified: CGO_ENABLED=0 go build -tags gms_pure_go ./cmd/bd; both
example modules build; go test ./internal/routing; govulncheck now
reports 0 affecting vulnerabilities.

Agent-Signature: claude-fable-5-high on behalf of maphew

---------

Co-authored-by: matt wilkie <maphew@gmail.com>
2026-07-23 18:54:32 -07:00

1.5 KiB

Security Dependency Exceptions

Last reviewed: 2026-04-28

This file records dependency advisories that are accepted temporarily because they do not affect shipped runtime code. Runtime dependency advisories are not eligible for this exception without a separate security review.

Website build toolchain

Scope:

  • website/package.json
  • website/package-lock.json
  • Docusaurus, webpack, Mermaid, and related static-site build tooling

Status:

  • npm audit --omit=dev is clean.
  • GOTOOLCHAIN=go1.26.5 govulncheck ./... is clean (last verified 2026-07-24, after bumping golang.org/x/text to v0.39.0 for GO-2026-5970).
  • A full npm audit still reports build-time advisories through the Docusaurus/webpack toolchain, primarily serialize-javascript, uuid, sockjs, and transitive Docusaurus packages.

Risk decision:

The website is built into static files and deployed to GitHub Pages. The production site does not run a Node.js server or load these Node packages at runtime. The dependencies have been moved to devDependencies so production audits track the actual runtime surface.

Required controls:

  • npm audit --omit=dev for website/ must remain clean.
  • The Docusaurus dev server must not be exposed publicly.
  • Renovate must remain enabled for npm and GitHub Actions updates.
  • Full audit findings must be reviewed before each website release and whenever Renovate proposes a Docusaurus or webpack-family update.
  • Remove this exception when upstream Docusaurus resolves the remaining transitive build-tool advisories without a downgrade.