mkdocs-troubleshoot

Diagnose and fix MkDocs build issues — broken mermaid diagrams, plugin errors, package compatibility