Highlights

docmd v0.9.0 führt die docmd assistant Engine ein, die eine konfigurationsfreie KI-Dokumentationssuche und interaktiven Chat sowohl für Einzelprojekte als auch für Multi-Projekt-Workspaces bietet. Dieses Release bringt zudem ein minimalistisches TUI-Redesign, strenge Cloud-Origin-Sicherheit, kontextbezogenes seitenrelatives Routing für vollständige Portabilität, einen Offline-Build-Modus sowie wichtige Stabilitätskorrekturen für die Engine.

Minimalistisches TUI-Redesign

  • Rahmenfreie Ausgabe: Vertikale Striche (│), Rahmenzeichnungs-Zeichen (┌─, └─) und störendes visuelles Rauschen wurden aus der CLI-Ausführung, dem Dev-Server-Output und den Test-Pipelines (pnpm prep) vollständig entfernt.
  • Standardisierter visueller Rhythmus: Eingerückte Rahmen wurden durch eine übersichtliche, linksbündige visuelle Hierarchie mit fettgedruckten Großbuchstaben-Abschnittsüberschriften und Standard-Leerzeilenabständen zwischen Gruppen ersetzt.
  • Marken-Auffrischung: Das Kernel-Logo-Branding wurde in allen CLI-Headern auf leuchtendes Blau (chalk.blue) aktualisiert.
  • Schlankeres Plugin-Logging: Die Log-Ausgabe interner Plugins (wie OKF) wurde auf prägnante, einzeilige Statuszusammenfassungen reduziert.

KI-Assistent & Cloud-Sicherheit (@docmd/plugin-ai)

Der KI-Dokumentationsassistent ist jetzt nativ in docmd integriert:

  • docmd Assistant Engine: Angetrieben von docmd-assistant (v0.1.6) bringt er direkte interaktive technische Unterstützung auf Ihre Dokumentationswebsites.
  • Strikte Domain-Origin-Validierung: Gehärtete Cloud-KI-Assistenten-Relay-Endpunkte mit strengen Origin-Prüfungen gegen die registrierte Projektdomain zur Verhinderung unbefugter Nutzung durch Dritte.
  • Plattformverwalteter Localhost-Schalter: Einführung einer Einstellung auf Projektebene im docmd Cloud Dashboard zur Aktivierung lokaler Vorschautests (127.0.0.1 / localhost), ohne clientseitige Konfigurationsparameter preiszugeben.
  • Bring Your Own Key (BYOK): Unterstützung für OpenAI, Anthropic, Gemini, DeepSeek und Ollama Provider, sicher weitergeleitet über das docmd Cloud-Relay.
  • Cloud-Setup: Konfigurieren Sie Assistenten-Zugangsdaten und Projekteinstellungen über docmd cloud.
  • Multi-Projekt-Workspace RAG: Ermöglicht die globale Dokumentationssuche über Geschwister-Suchindizes (_docmd-search/search-index.json) hinweg in Multi-Projekt-Workspaces.
  • Kanonische Link-Auflösung: Automatische Bereinigung und Auflösung interner Hyperlinks für exakte Pfade auf lokalen Vorschau-Servern und in Subpfad-Produktionsumgebungen.
  • Formatierte Antwortdarstellung: Native Unterstützung für GFM Markdown-Tabellen, Inline-Codeblöcke und ein adaptives helles/dunkles UI-Design.

Kontextbezogene Navigation und SPA-Synchronisation

  • Seitenrelatives Routing: Versions-, Sprach- und Projekt-Umschalter bevorzugen jetzt relative Pfade (./, ../), um die vollständige Portabilität der Website über Root-, Subpfad- und lokale Vorschauumgebungen hinweg zu gewährleisten.
  • SPA-Layout-Synchronisation: Obere Menüleiste, Ankündigungs-Banner und Cookie-Hinweise werden bei SPA-Seitenübergängen dynamisch aktualisiert, um korrekte relative Links in jeder Verzeichnistiefe zu erhalten.
  • Dev-Server Routing-Fix: Behebung von Subpfad-Umleitungsfehlern beim Ausführen des lokalen Entwicklungsservers in benutzerdefinierten Workspace-Konfigurationen.

CLI Offline-Build-Modus (--offline)

Einführung des --offline CLI-Flags zum Erstellen eigenständiger Dokumentationspakete für die Offline-Nutzung:

  • Umgeht Suchindexierung und externe Netzwerkzugriffe.
  • Erzwingt .html-Suffixe für alle Links zur direkten Kompatibilität mit dem file://-Protokoll.
  • Fügt einen lokalisierten Hinweis im Suchfenster ein, wenn sich die Website im Offline-Modus befindet.

Engine-Behebungen und Fehlerbehebungen

  • Behobene Kernel-Parser und Engine Issues (#186, #187, #188, #189, #190): Stabilitätskorrekturen für AST-Container-Parsing, Pfadnormalisierung und Plugin-Laufzeitgrenzen.
  • Such-Bridge API: Offenlegung von window.docmdSearch.search für die clientseitige RAG-Integration.
  • Node.js Systemanforderungen: Erhöhung der Mindestanforderung für Node.js auf >=20.0.0 für alle Workspace-Pakete.
Vorherige v0.9.1 - Standardisierte Container-Engine & Mermaid