v0.10.0 - Produktionsserver, statische Assets & MDX

Produktionsserver, statische Assets & MDX

v0.10.0 führt einen dedizierten Produktions-HTTP-Server (docmd serve), eine konfigurationslose Pipeline für statische Root-Assets (public/), native MDX-Komponentenunterstützung powered by @docmd/lite-mdx, Systemdiagnosen (docmd doctor) und eine einheitliche Ökosystem-Standardisierung über unterstützende Bibliotheken hinweg ein.

Added

  • Dedizierter Produktionsserver (@docmd/core): Führt den Befehl docmd serve für produktive Dokumentationsseiten ohne Dateiüberwachungs-Overhead ein. Beinhaltet integrierte Gzip- und Deflate-Komprimierung, Standard-Sicherheits-Header (CSP, HSTS, Frame-Schutz), Container-Liveness- und Readiness-Probes unter /healthz sowie konfigurierbare Host-Bindung. Das Docker-Image verwendet standardmäßig docmd serve --host 0.0.0.0. Beigesteuert von @svallory in #273 und #279.
  • Opt-in MCP über HTTP (@docmd/core): Stellt Model Context Protocol-Funktionen unter docmd serve an POST /mcp bereit, basierend auf einem transportunabhängigen JSON-RPC-Handler, gesichert über serve.mcp: true und Token- oder Header-Authentifizierung. Beigesteuert von @svallory in #278.
  • Plugin-Action-Host für die Produktion (@docmd/core, @docmd/api): Erweitert Plugin-Aktionen auf docmd serve mit strikten Origin-Allowlists und Aufrufer-Identitätsprüfung, um unbefugte Kontextänderungen in der Produktion zu verhindern. Beigesteuert von @svallory in #272 und #277.
  • Pipeline für statische Root-Assets (@docmd/core): Erkennt automatisch ein übergeordnetes public/-Verzeichnis (oder benutzerdefinierte Pfade über static in docmd.config.json) und kopiert Dateien direkt in das Build-Wurzelverzeichnis, wobei Hierarchien für robots.txt, favicon.ico, CNAME und .well-known/funding-manifest-urls erhalten bleiben.
  • MDX-Komponenten-Rendering (@docmd/plugin-mdx, @docmd/lite-mdx): Bündelt erstklassige MDX-Unterstützung im Kern mithilfe des schnellen @docmd/lite-mdx-Compilers für interaktive JSX-Komponenten neben Standard-Markdown ohne zusätzliche Konfiguration.
  • Systemdiagnose vor dem Start (@docmd/core, @docmd/tui): Fügt den Befehl docmd doctor hinzu, um Umgebung, Node.js-Version, Engine-Voraussetzungen, Portverfügbarkeit, Layouts und Plugin-Integrität mit strukturierter Terminalausgabe zu prüfen.
  • Dynamischer Headless-Flag (@docmd/core): Ergänzt das --no-open-CLI-Flag und die Umgebungsvariable DOCMD_NO_OPEN=true für dev, serve und Test-Runner zur Vermeidung ungewollter Browseraufrufe in CI- und Container-Umgebungen.
  • Dynamische Versions-Fallbacks (@docmd/parser, @docmd/ui): Automatisiert die Fallback-Synchronisation für docmd.version und docmd.buildYear in Parser-Registries und Client-Runtimes.
  • Optionales Iconify-Plugin (@docmd/plugin-iconify): Bietet On-Demand-Iconauflösung für über 100.000 Icons aus mehr als 100 Icon-Sets über die Syntax icon:iconify:<name>.

Improved

  • Netzwerkschnittstellen-Bindung (@docmd/core): Ergänzt das --host <adresse>-Flag für docmd dev, docmd serve und Workspace-Workflows mit sicherem Standard 127.0.0.1. Beigesteuert von @svallory in #269.
  • Playground Web-Worker-Sandboxing (@docmd/plugin-playground): Verlagert Codeausführungen in Hintergrund-Web-Worker, damit blockierende Skripte den Browser-UI-Thread nicht einfrieren.
  • Saubere Build-Verzeichnisse: Stellt sicher, dass pnpm -r run build einen sauberen Git-Status hinterlässt. Beigesteuert von @svallory in #275.
  • Test-Isolation: Weist jedem Testprozess ein dediziertes temporäres Verzeichnis zu, um Nebenläufigkeitskonflikte zu verhindern. Beigesteuert von @svallory in #276.
  • Ökosystem-Metadaten & Funding: Vereinheitlichte Paket-Keywords, README-Dokumentation für interne Plugins und Ausrichtung aller Repositories und Funding-Manifeste auf https://docmd.io und die Organisation docmd-io.

Fixed

  • SPA Body-Skriptausführung (@docmd/ui): Verhindert die erneute Ausführung von Inline-Body-Skripten bei SPA-Navigationen. Beigesteuert von @MSOB7YY in #270.
  • Highlight.js Theme-Flackern (@docmd/ui, @docmd/template-summer): Wendet Syntax-Highlight-Stile sofort beim ersten Laden an. Beigesteuert von @MSOB7YY in #270.
  • Nicht-Index-Ordnerlinks (@docmd/parser): Korrigiert relative Links auf Ordnerpfade ohne abschließenden Schrägstrich aus verschachtelten Seiten. Beigesteuert von @GPT-AGI in #271.
  • Gitignore-Vorfahren-Filterung (@docmd/core): Begrenzt ungesicherte Gitignore-Muster auf das eigene Verzeichnis. Beigesteuert von @svallory in #274.
  • MCP-Pfadprüfungen gehärtet (@docmd/core): Beschränkt read_doc und list_docs auf Markdown-Dateien im Quellverzeichnis und verhindert Symlink-Escapes. Beigesteuert von @svallory in #268.
  • Breadcrumb-Schema-Fallback (@docmd/plugin-seo): Behebt fehlende Zwischenelemente in JSON-LD-Breadcrumbs mit robuster Hierarchie-Ergänzung.

Security & Maintenance

  • Playground HTML previews laufen in isolierten sandboxed Iframes ohne allow-same-origin.
  • Produktions-Sicherheits-Header: docmd serve erzwingt standardmäßig CSP, HSTS, X-Content-Type-Options und Frame-Options.
  • WebSocket-Origin-Prüfung: Erzwingt strikte Origin-Allowlists und blockiert unautorisierte Nachrichten im Action-Host.
  • Aktualisierung von docker/login-action auf 4.8.0 in PR #281.
  • Aktualisierung von Workspace-Laufzeitabhängigkeiten in PR #282.

Dokumentation: https://docs.docmd.io/
Cloud-Plattform: https://cloud.docmd.io/
Dev & Writing Skills: https://github.com/docmd-io/docmd-skills

New Contributors

Vollständiges Changelog: https://github.com/docmd-io/docmd/compare/0.9.9...0.10.0