Highlights

docmd v0.9.5 delivers autonomous AI assistant agent tools with an expanded 200k context window, a complete redesign of the collaborative Threads plugin with right-docked handle and inline comment previews, template UI refinements across Summer and Default templates, and OpenAPI multi-project workspace path resolution.

AI Assistant Agent Tools & Extended Context Window (@docmd/plugin-ai & docmd-assistant)

  • Autonomous MCP Tool Suite: Integrated five client-side autonomous tools directly into the browser assistant runtime:
    • get_site_structure: Inspects the site’s complete version trees (current and historical), supported locales, project boundaries, and page hierarchy.
    • search_documentation: Queries documentation pages with full-text keyword matching and optional semantic vector search.
    • read_documentation_page: Fetches and reads clean, structured Markdown prose from any page across workspace boundaries.
    • navigate_to_page: Smoothly navigates visitors directly to relevant documentation chapters and subsections.
    • copy_code_snippet: Extracts code blocks and command snippets directly to the visitor’s clipboard with visual feedback.
  • Uncapped Context Window (200k Default): Eliminated hardcoded 15,000 and 40,000 character truncation bottlenecks. The engine now passes full retrieved documentation context (up to 200,000 characters by default) for comprehensive technical explanations and complete configuration examples.
  • Configurable contextWindow: Added optional contextWindow (or contextLimit) option to plugins.ai configuration, allowing projects to tailor context sizes for specific token quotas or cost optimisation.
  • Enhanced Code Block UI: Refined assistant markdown code rendering with syntax highlighting, language badges, and one-click copy buttons.
  • Cloud Relay Telemetry & Query Analytics Fixes: Fixed an issue where multi-turn autonomous tool execution repeatedly logged internal follow-up turns in Cloud analytics, and fixed stray quote prefixes on longer queries.

Threads Collaborative Discussion Plugin (@docmd/plugin-threads)

  • Card Persistence on Sidebar Reopen: Replaced mutable DOM node re-parenting with decoupled in-memory rendering and CSS-driven preview toggling (body.tc-panel-open .threads-thread--inline). Thread cards remain permanently visible and persistent across open/close/reopen cycles.
  • Zero-Reload Commenting & Replying: Adding new threads, replying, and resolving now operate strictly in-place with immediate UI updates, eliminating full-page browser reloads.
  • Redesigned Inline Comment Preview: Sleek inline preview card below highlighted text featuring an anchor quote badge ("...") and an “Open in sidebar” link that smooth-scrolls and highlights the thread in the panel.
  • Right-Docked Slide Tab: Moved .threads-fab to a slide tab docked at top: 50%; right: 0, completely avoiding collisions with .summer-totop and the bottom AI prompt trigger.
  • Modern Stroke Iconography: Overhauled plugin icons to match docmd’s core aesthetic with Lucide/Feather stroke SVGs (messages-square, quote, external-link, reply, trash, plus, check, x).
  • Summer & Default Template Styling: First-class design token inheritance across Default and Summer templates (--summer-surface, --summer-border, --summer-accent, etc.).
  • Hover-Revealed Heading Actions: Redesigned the “+ New Thread” button on section headings to reveal smoothly upon heading hover or keyboard focus, eliminating visual clutter.

OpenAPI Plugin Enhancements (@docmd/plugin-openapi)

  • Multi-Project Workspace Resolution: Resolved specification file lookup in complex workspaces and subprojects (e.g. assets/docmd-api.json within sub-site directories). The plugin now checks the active markdown file’s directory, project boundary root, and workspace root automatically.
  • Download Button Respects Config: Fixed the OpenAPI download button to honour download: true and emit root-relative download links.
  • Inline OpenAPI Specifications: Fenced blocks tagged with ```openapi now directly accept raw JSON or YAML OpenAPI specifications embedded in the markdown file without requiring a separate external file.
  • Robust Error Diagnostics: Missing or invalid spec paths now surface clear, contextual .oa-error callouts in development builds instead of silent rendering fallbacks.

Live Server Manifest Capability & Universal Runtime Detection (@docmd/api)

  • requiresLiveServer Manifest Capability: Plugins that depend on an active live development server RPC bridge (such as collaborative editing, hot file persistence, or live commenting like @docmd/plugin-threads) can now declare requiresLiveServer: true in their plugin descriptor (PluginDescriptor) and package manifest (package.json#docmd.requiresLiveServer).
  • Zero-Overhead Static Builds: During static production builds (docmd build), docmd automatically omits client-side scripts, meta tags, and style assets for live-only plugins while keeping markdown container and syntax parsing intact. Static production sites remain completely lightweight, zero-overhead, and error-free without missing markdown formatting.
  • Universal Live Server Detection (docmd.isLive() & docmd.ping()): Added built-in live server status checking to the @docmd/api browser client and dev server RPC bridge. Client plugins can call docmd.isLive() for synchronous WebSocket connectivity status, or await docmd.ping() for an end-to-end heartbeat with the server’s built-in system:ping action handler.