beads/engdocs/SECURITY-DEPENDENCY-EXCEPTIONS.md
Chris Sells 0e017821f4 docs: move internal/maintainer docs from docs/ to engdocs/
Relocate contributor- and maintainer-facing material out of docs/ so the
directory can become the user-facing Mintlify site. Moves preserve subpaths
(adr/, design/, staged-for-removal/ intact). messaging.md, UI_PHILOSOPHY.md,
and AGENT_SIGNING.md move per their DOC_INVENTORY dispositions (design doc,
design philosophy, maintainer convention).

Inbound links updated repo-wide: root guides, CONTRIBUTING, AGENTS,
workflows, lint config, scripts (check-doc-freshness now resolves the
inventory at engdocs/DOC_INVENTORY.md), Go comments, and the synced website
metadata page (regenerated via sync-website-docs.sh + generate-llms-full.sh).

The emitted help text in cmd/bd/init_safety_help.go still references
docs/adr/0002-init-safety-invariants.md; changing it would change bd's
runtime output, which is out of scope for this branch (flagged in the PR).
2026-07-12 10:37:07 -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.2 govulncheck ./... is clean.
  • 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.