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).
1.5 KiB
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.jsonwebsite/package-lock.json- Docusaurus, webpack, Mermaid, and related static-site build tooling
Status:
npm audit --omit=devis clean.GOTOOLCHAIN=go1.26.2 govulncheck ./...is clean.- A full
npm auditstill reports build-time advisories through the Docusaurus/webpack toolchain, primarilyserialize-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=devforwebsite/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.