Highlights

docmd v0.9.0 introduces the docmd assistant engine, providing zero-config AI documentation search and interactive chat across single-project and multi-project workspace environments. This release also delivers a clean minimalist TUI redesign, strict Cloud origin security, contextual page-relative routing for complete site portability, an offline build mode, and key engine stability fixes.

Minimalist TUI Redesign

  • Border-Free Output: Completely removed vertical pipes (│), box-drawing frames (┌─, └─), and heavy visual noise from CLI execution, dev server output, and maintenance test pipelines (pnpm prep).
  • Standardized Visual Rhythm: Replaced indented borders with a clean flush-left visual hierarchy featuring bold uppercase section headers and standard blank line spacing between groups.
  • Brand Refresh: Updated the core logo branding to vibrant blue (chalk.blue) across all CLI headers.
  • Streamlined Plugin Logging: Reduced log verbosity across internal plugins (such as OKF) down to clean, single-line status summaries.

AI Assistant & Cloud Security (@docmd/plugin-ai)

The AI documentation assistant is now natively integrated into docmd:

  • docmd Assistant Engine: Powered by docmd-assistant (v0.1.6), bringing conversational technical guidance directly to documentation sites.
  • Strict Domain Origin Validation: Hardened Cloud AI assistant relay endpoints with strict origin checks against project domain registration to prevent unauthorized third-party usage.
  • Platform-Managed Localhost Toggle: Introduced a project-level setting in the docmd Cloud dashboard to enable local preview testing (127.0.0.1 / localhost) without exposing client-side configuration parameters.
  • Bring Your Own Key (BYOK): Supports OpenAI, Anthropic, Gemini, DeepSeek, and Ollama providers routed securely via docmd cloud relay.
  • Cloud Setup: Configure assistant credentials and project settings via docmd cloud.
  • Multi-Project Workspace RAG: Enables global documentation discovery across sibling search indexes (_docmd-search/search-index.json) in multi-project workspace configurations.
  • Canonical Link Resolution: Automatically sanitises and resolves internal hyperlinks to exact site paths across local preview servers and subpath production deployments.
  • Formatted Response Rendering: Native support for GFM Markdown tables, inline code blocks, and adaptive light/dark UI themes.

Contextual Navigation and SPA Sync

  • Page-Relative Routing: Version, language, and project switchers now prioritise relative paths (./, ../), ensuring complete site portability across root, subpath, and local preview environments.
  • SPA Layout Swapping: Top menubar, announcement banner, and cookie consent elements are dynamically updated during SPA transitions to maintain correct relative links at any directory depth.
  • Dev Server Routing Fix: Resolved subpath redirection mismatches when running local development servers in custom workspace configurations.

CLI Offline Build Mode (--offline)

Introduced the --offline CLI flag for building self-contained documentation packages suitable for offline distribution:

  • Bypasses search indexing and external network fetches.
  • Enforces .html link suffixing for direct compatibility with the file:// protocol.
  • Injects a localised notice inside the search interface indicating offline status.

Engine and Bug Fixes

  • Core Parser and Engine Fixes (#186, #187, #188, #189, #190): Resolved issues across AST container parsing, path normalisation, and plugin runtime execution bounds.
  • Search Bridge API: Exposed window.docmdSearch.search for client-side RAG integration.
  • Node.js Engine Requirement: Updated minimum Node.js requirement to >=20.0.0 across all workspace packages.

Upgrade

upgrade
npx @docmd/core@0.9.0 build
Previous Node API Reference