WRNexusJSDoc/docs/site-audit.md

WRNexusJS site audit

Date: 2026-07-12. Baseline: Bun 1.3.14, framework 0.2.15.

Baseline results

• bun install: pass (169 installs / 209 packages, unchanged).
• docs generation: pass (25 package pages and 5 prior site pages).
• tests: 6 pass. Check: pass. Production build: pass, 30 routes.
• Access test with an empty npm config: @wrnexus/cli and @wrnexus/core returned npm E404.
• Repository: private WorkRoot Git remote; no public LICENSE, SECURITY, or CHANGELOG file found.

Findings

The prior generator duplicated package H1s, descriptions, install blocks, and dumped full declarations. It also rewrote hand-authored core pages, used four desktop-only nav links, hid navigation on mobile, branded inconsistently, and presented an unusable public create command. Metadata lacked explicit canonicals and route coverage. No sitemap, robots file, docs index, release/access route, security/support/license policy, showcase evidence notes, benchmarks methodology page, or 404 source existed.

Audit limitations

Browser tooling, Lighthouse, axe, screenshots, and an authenticated clean scaffold were unavailable. Scores are therefore not fabricated; post-deploy measurements remain required under docs/audits/.