Improve agent-readable documentation output

[ihsraham]

Summary

• update llms.txt to the proposed structure with 332 direct Markdown links
• serialize each docs article before repeated navigation while preserving the desktop layout and accessible mobile drawer behavior
• enforce exact HTML/Markdown/llms.txt route parity, article-first source order, and malformed-artifact regressions in the production build

Validation

• Node 22.22.2 / npm 10.9.7: npm run quality
  • 43 artifact/source-order tests and 2 routing tests passed
  • 338 static routes and 332 per-page Markdown files generated
  • 0 broken internal, anchor, external, or output links
• production export served on localhost
  • npm run check:llm-md -- --base-url http://127.0.0.1:8080
  • GET/HEAD, MIME, body-hash, missing-route, and retired-route checks passed
  • hydrated Chrome checks passed on five desktop pages and at 390×844 and 320×568, including focus trapping, inert background, all close paths, resize cleanup, and client routing
• AFDocs 0.18.7 and 0.19.0, deterministic full 332-page corpus
  • 332/332 links resolve as Markdown
  • 332/332 pages support .md URLs
  • content starts within the first 10% on all pages (median 3%)
  • localhost sitemap coverage was skipped by AFDocs; route parity is enforced independently by the build gate

Notes

• the mobile focus wrapper depends on the DOM contract of the pinned Fumadocs version; its browser matrix should be rerun with future Fumadocs upgrades
• preview should recheck uppercase-path and encoded-dot behavior because the macOS localhost filesystem/server normalizes those probes