mirror of
https://github.com/CharlesWiltgen/Axiom.git
synced 2026-09-20 19:58:20 +08:00
Charles Wiltgen
545798e3bb
`pi install git:github.com/CharlesWiltgen/Axiom` — the command in README.md and
the Pi setup guide — failed for every user with npm ERESOLVE. Pi runs a bare
`npm install --omit=dev` in its clone; --omit=dev skips INSTALLING
devDependencies but npm still RESOLVES the whole graph, so a docs-toolchain
conflict aborted an install that has nothing to install (the root manifest
declares no runtime dependencies at all).
vitepress-plugin-mermaid peers on vitepress ^1 and has no v2-compatible release,
and mermaid is used on 25 docs pages, so the plugin cannot be dropped. A narrow
`overrides` entry fixes resolution without disabling peer checks repo-wide:
strict `npm ci` now passes, so both workflows drop --legacy-peer-deps. That flag
was what hid this from CI for seven months — it landed 73 seconds after mermaid
did (e53671ac).
Toolchain moved to current while here: vitepress 2.0.0-alpha.15 (Nov 2025) ->
2.0.0-alpha.19, and mermaid 11.12.2 -> 11.17.1 inside the existing ^11 range.
npm audit drops from 15 vulnerabilities (8 moderate, 7 high) to 2, clearing a
DOMPurify XSS. Docs build stays green with all 25 mermaid pages rendering.
Closes #54.