v0.10.0 - Servidor de producción, recursos estáticos y MDX

Servidor de producción, recursos estáticos y MDX

v0.10.0 introduce un servidor HTTP de producción dedicado (docmd serve), una canalización sin configuración de recursos estáticos raíz (public/), soporte nativo de componentes MDX impulsado por @docmd/lite-mdx, diagnósticos previos del entorno (docmd doctor) y estandarización general del ecosistema en todas las bibliotecas de soporte.

Added

  • Servidor HTTP de producción (@docmd/core): Introduce el comando docmd serve para servir documentación en producción sin sobrecarga de monitorización de archivos. Incluye compresión Gzip y Deflate, cabeceras de seguridad estándar (CSP, HSTS, protección de marcos), sondas liveness y readiness para contenedores en /healthz y vinculación de host configurable. La imagen Docker ahora utiliza por defecto docmd serve --host 0.0.0.0. Contribuido por @svallory en #273 y #279.
  • MCP opcional a través de HTTP (@docmd/core): Expone capacidades del Protocolo de Contexto de Modelo bajo docmd serve en POST /mcp, mediante un controlador JSON-RPC independiente del transporte protegido con serve.mcp: true y autenticación por token o cabecera. Contribuido por @svallory en #278.
  • Host de acciones de complementos en producción (@docmd/core, @docmd/api): Extiende las acciones de complementos a docmd serve con listas de orígenes permitidos estrictas y validación de identidad del llamador para prevenir modificaciones no autorizadas de contexto. Contribuido por @svallory en #272 y #277.
  • Canalización de recursos estáticos raíz (@docmd/core): Detecta automáticamente un directorio public/ superior (o rutas personalizadas definidas en static dentro de docmd.config.json) y copia los archivos directamente a la raíz compilada preservando la jerarquía para robots.txt, favicon.ico, CNAME y .well-known/funding-manifest-urls.
  • Renderizado de componentes MDX (@docmd/plugin-mdx, @docmd/lite-mdx): Integra soporte MDX de primer nivel en el núcleo mediante el compilador de alto rendimiento @docmd/lite-mdx para componentes JSX interactivos junto con Markdown estándar sin configuración previa.
  • Diagnóstico de entorno con Doctor (@docmd/core, @docmd/tui): Añade el comando docmd doctor para validar el estado del sistema, versiones de Node.js, requisitos de motores, disponibilidad de puertos, plantillas e integridad de complementos con informes coloreados en terminal.
  • Opción headless dinámica (@docmd/core): Añade la opción CLI --no-open y la variable de entorno DOCMD_NO_OPEN=true en dev, serve y ejecutores de pruebas para evitar aperturas accidentales de navegadores en flujos de CI o contenedores.
  • Valores de respaldo dinámicos de versión (@docmd/parser, @docmd/ui): Automatiza la sincronización de reservas de docmd.version y docmd.buildYear en registros del analizador y tiempos de ejecución del cliente.
  • Complemento opcional Iconify (@docmd/plugin-iconify): Proporciona resolución de iconos bajo demanda para más de 100.000 iconos pertenecientes a más de 100 colecciones mediante la sintaxis icon:iconify:<nombre>.

Improved

  • Vinculación de interfaces de red (@docmd/core): Añade la opción CLI --host <dirección> para docmd dev, docmd serve y flujos de trabajo de espacio de trabajo, con 127.0.0.1 como valor predeterminado seguro. Contribuido por @svallory en #269.
  • Aislamiento con Web Workers en Playground (@docmd/plugin-playground): Ejecuta el código en web workers en segundo plano para evitar que scripts bloqueantes congelen el hilo principal de la interfaz de usuario.
  • Limpieza del árbol de compilación: Garantiza que pnpm -r run build mantenga el árbol de trabajo de Git limpio aislando archivos generados. Contribuido por @svallory en #275.
  • Aislamiento del conjunto de pruebas: Asigna raíces temporales dedicadas por proceso de prueba para prevenir condiciones de carrera. Contribuido por @svallory en #276.
  • Metadatos y financiación del ecosistema: Palabras clave estandarizadas, documentación README alineada para complementos internos y manifiestos de repositorio y patrocinio dirigidos a https://docmd.io y la organización docmd-io.

Fixed

  • Ejecución de scripts en navegación SPA (@docmd/ui): Evita que la navegación en aplicaciones de página única reejecute scripts en línea en el cuerpo del documento. Contribuido por @MSOB7YY en #270.
  • Destello del tema de Highlight.js (@docmd/ui, @docmd/template-summer): Aplica los estilos de resaltado de sintaxis inmediatamente en la carga inicial evitando destellos sin estilo. Contribuido por @MSOB7YY en #270.
  • Enlaces a carpetas sin barra final (@docmd/parser): Corrige la resolución de enlaces relativos hacia directorios desde páginas anidadas. Contribuido por @GPT-AGI en #271.
  • Búsqueda en ancestros con Gitignore (@docmd/core): Limita las reglas gitignore desancladas a su propio directorio para evitar exclusiones indebidas de archivos fuente. Contribuido por @svallory en #274.
  • Blindaje de rutas MCP (@docmd/core): Restringe read_doc y list_docs a archivos markdown dentro de las raíces configuradas, bloqueando escapes por enlaces simbólicos. Contribuido por @svallory en #268.
  • Respaldo de esquema de migas de pan (@docmd/plugin-seo): Resuelve elementos intermedios omitidos en el marcado JSON-LD con jerarquías de autorrecuperación.

Security & Maintenance

  • Las vistas previas HTML de Playground se ejecutan en iframes aislados sin allow-same-origin.
  • Cabeceras de seguridad en servidor de producción: docmd serve aplica CSP, HSTS, X-Content-Type-Options y Frame-Options de forma predeterminada.
  • Validación de origen en WebSockets: Aplica listas estrictas de orígenes permitidos y rechaza mensajes no autenticados en el host de acciones.
  • Actualización de docker/login-action a 4.8.0 en PR #281.
  • Actualización de dependencias de tiempo de ejecución del espacio de trabajo en PR #282.

Documentación: https://docs.docmd.io/
Plataforma Cloud: https://cloud.docmd.io/
Habilidades de desarrollo y redacción: https://github.com/docmd-io/docmd-skills

New Contributors

Registro de cambios completo: https://github.com/docmd-io/docmd/compare/0.9.9...0.10.0