Release notes for docmd 0.6.0 release
This landmark release marks a complete architectural overhaul of the docmd monorepo, transitioning the entire engine to TypeScript and ESM while launching a premium suite of automated developer tools.
✨ Highlights
🛡️ The docmd Dev Environment Tools
We’ve transformed the contributor workflow into a professional, automated experience. No more manual npm install blocks or confusing build sequences.
pnpm onboard: A single command to set up a fresh fork. It silently handles dependency installation and monorepo builds. Use--link-docmdto instantly adddocmdto your system path.pnpm verify: Our new production-grade verification suite. It runs a branded E2E failsafe process, ensuring every parser rule, theme asset, and plugin lifecycle is 100% sound before release.pnpm reset: A total environmental purge. Safely stops background servers, unlinks global binaries, and wipes all build caches for a truly fresh start.
🏗️ TypeScript & ESM Native
The core engine has “grown up.” We’ve migrated the entire monorepo from JavaScript (CJS) to TypeScript (ESM) to ensure long-term stability and developer agility.
- Type-Safe Core: Internal APIs (Parser, Builder, Plugin System) now feature full type definitions, making contributions safer and eliminating “undefined” runtime errors.
- Modern Modules (ESM): Dropped legacy CommonJS in favor of native ECMAScript Modules, resulting in faster execution and better compatibility with the modern JS ecosystem.
- Plugin Ecosystem Upgrade: We didn’t stop at the core! All official plugins (
plugin-mermaid,plugin-pwa,plugin-search,plugin-seo,plugin-sitemap,plugin-analytics,plugin-installer,plugin-llms) have been rewritten in fully typed ESM. Frontend assets are now independently bundled withesbuild. - Version-Specific Navigation: You can now override the global
navigationfor specific versions, allowing you to tailor the sidebar for legacy documentation versions.
📝 Complete Changelog
🤖 CI/CD Guardrails
- Automated Verification: Introduced GitHub Actions that automatically run
pnpm verifyon every Push and Pull Request to themainbranch. - Release Automation: Modernized the NPM publish workflow to use the new branded verification suite as a final release gatekeeper.
🐛 Refinements & Fixes
- Branded CLI: All developer commands now feature the blue
docmdbranding and consistent dimmed status feedback. - Playground Bridges: Added
playground:addandplayground:removeworkspace aliases to allow testing CLI features safely inside an isolated playground context. - Optimized Failsafe: The verification suite now automatically handles monorepo builds and supports a
--skip-setupflag for lightning-fast CI execution.