docmd v0.8.3 is a major architectural update that introduces Workspaces, enabling centralized management of multiple documentation projects. This release also prioritizes Security & Stability with hardened rendering across the ecosystem and improved routing reliability.

✨ Highlights

🚀 Workspaces Architecture

The multi-project system has been completely reimagined as Workspaces. You can now manage multiple independent documentation projects from a single root configuration with powerful new capabilities:

• Global Configuration Cascading: Define your theme, menubar, navigation, and logo at the root to apply them across all projects automatically.
• Premium Project Switcher: A new slim UI component for seamless navigation between projects, supporting multiple positions (sidebar-top, sidebar-bottom, and options-menu).
• Flexible Overrides: Projects can selectively override global defaults in their own local configuration.
• Backward Compatibility: Existing multi-project configurations are automatically normalized to the new workspace schema.

🛡️ Enhanced Security & Stability

This release introduces a series of internal improvements to harden the documentation engine and its plugins against edge-case rendering issues:

• Hardened Rendering: Systematically replaced innerHTML usage with secure DOM APIs (createElement, DOMParser) across the core and plugins.
• Universal Security Audit: The monorepo Failsafe pipeline now includes a specialized, AST-based security audit to detect and block unsafe DOM patterns (innerHTML, outerHTML, document.write) before any release.
• Improved Search Safety: Search results now use a more robust rendering pipeline to ensure content is always handled securely.
• Dev Server Isolation: Enhanced directory traversal protection in the local development server for improved environment isolation.

🛠 Improvements & Fixes

Auto-Designated Index Normalization

Fixed a bug in the Zero-Config auto-router where files designated as directory indexes (when no index.md is present) failed to render correctly due to a trailing slash mismatch. The engine now correctly normalizes these paths, ensuring stable routing and correct index.html generation for all auto-indexed directories.

Routing Stability

Improved path predictability in the Auto-Router to resolve trailing slash inconsistencies in directories without a dedicated index file.

TUI Pipeline & Workspace Build Clarity

Refined the terminal output (TUI) for multi-project Workspace builds. Build logs are now consistently structured into strict sections (Data Indexing, Publishing, etc.) across both standalone and workspace builds, preventing overlapping text, looping spinners, and disconnected status messages.

UI Sidebar Adjustments

Fixed a layout bug where dropdown menus (Version, Language, and Project Switchers) inside the sidebar would get cropped by the sidebar’s bounding box. These menus now securely render over the main content area and dynamically align to the sidebar width, preventing them from overflowing the browser viewport.

📦 Package Updates

• Node.js Types: Updated @types/node to v25.8.0.
• GitHub Actions: Updated CI/CD workflows to latest stable versions for improved reliability.

📝 Complete Changelog

🚀 New Features

• Core Engine: Introduced workspace schema for centralized project management.
• UI Components: Added project-switcher partial and event delegation logic.
• Config Loader: Implemented global default merging and menubar item aliasing (title/path).
• Pipeline: Integrated a static-analysis Security Audit into the Universal Failsafe V5.0 to enforce strict DOM safety standards across all packages.

🐛 Bug Fixes

• Threads Plugin: Hardened comment rendering and metadata escaping by moving to DOMParser.
• Search Plugin: Improved results rendering and data attribute safety, replacing innerHTML.
• Icon Renderer: Hardened icon attribute rendering for SVG icons.
• Tabs Component: Improved attribute safety in tab navigation items.
• Core Engine: Fixed path normalization for auto-designated index files in the generator.
• Routing: Removed implicit index designation in the Auto-Router to improve path predictability.
• Dev Server: Enhanced path validation for static file serving.
• UI Assets: Removed overflow: hidden from sidebar and refactored positioning contexts to prevent cropped dropdown menus.
• CLI / TUI: Fixed dangling status messages and unclosed UI sections during workspace and dev builds.

🚀 Infrastructure

• Refactoring: Renamed workspace engine to workspace.ts and refactored terminology across the monorepo.
• Dependencies: Bumped @types/node from 25.7.0 to 25.8.0.
• Workflows: Updated GitHub Actions group to latest versions.