vaults-diagram-tools

Kit de herramientas portátil de Mermaid y diagramas de código fuente para renderizado SVG/JPEG, activos sin conexión y flujos de trabajo MCP.

Qué incluye

• Renderizador de Mermaid extraído de la cadena de herramientas Vaults.

• Generador de diagramas Mermaid a partir de código fuente.

• Servidor MCP stdio con tres herramientas explícitas.

• Activos de lanzamiento con capacidad sin conexión para distribución en zip y contenedor.

• Plantillas de empaquetado para Homebrew, deb/rpm, VS Code, CDN, Docker y Podman.

No incluye: OCR/conversión de documentos, auditorías de bóveda Claro, importación CPQ, recortes o herramientas PDF de Casa Conectada.

Instalación

Paquete npm desde GitHub

npm install github:malnati/vaults-diagram-tools

Clonación local

git clone https://github.com/malnati/vaults-diagram-tools.git
cd vaults-diagram-tools
npm ci
npm test

Contenedor

docker build -f containers/Containerfile -t vaults-diagram-tools:local .
podman build -f containers/Containerfile -t vaults-diagram-tools:local .

Las imágenes de lanzamiento se publican en el Registro de Contenedores de GitHub como ghcr.io/malnati/vaults-diagram-tools.

Uso de la línea de comandos

vaults-mermaid-render path/to/diagram.mmd --output-dir out --png --ascii --manifest out/manifest.json
vaults-source-diagrams --source-dir src --output-dir diagrams --langs auto --diagrams dependency,class
vaults-diagram-mcp

Equivalentes de clonación local:

node packages/renderer/render-mermaid-assets.mjs examples/simple/flowchart.mmd --output-dir /tmp/vaults-diagram-tools
node packages/source-diagrams/source-diagrams.mjs --source-dir packages/source-diagrams/tests/fixtures/js-project --output-dir /tmp/source-diagrams
node packages/mcp/server.mjs

Las CLI públicas admitidas son los tres comandos anteriores. Los binarios de paquetes adicionales son puntos de entrada de compatibilidad para rutas de Vaults antiguas y pueden quedar obsoletos en una futura versión principal.

Herramientas MCP

vaults-diagram-mcp expone exactamente tres herramientas:

• render_mermaid_text

• render_mermaid_file

• generate_source_diagrams

Política de diagramas Markdown

El Markdown generado debe enlazar artefactos y mostrar el código fuente en un bloque delimitado por mermaid:

#### Diagram title
- Links: [Mermaid source](assets/diagram.mmd) / [SVG](assets/diagram.svg) / [JPEG](assets/diagram.jpg)

```mermaid
flowchart TD
  A --> B
```

Los archivos SVG y JPEG son artefactos de entrega. El Markdown debe enlazarlos en lugar de incrustarlos como imágenes de forma predeterminada.

Entorno de ejecución de proveedor sin conexión

El árbol de fuentes no incluye node_modules. Los trabajos de compilación y lanzamiento crean activos de proveedor sin conexión con:

npm run vendor:refresh
npm run test:vendor:offline

El renderizador puede ejecutarse desde dependencias npm normales durante el desarrollo, o desde packages/renderer/vendor/node cuando MMDC_VENDOR_ONLY=1.

Estado de distribución

Funciona en v1:

• Metadatos del paquete npm y flujo de instalación de GitHub

• Imagen de Docker/Podman

• Servidor MCP

• Lanzamiento zip

• Flujos de trabajo de CI, lanzamiento, CodeQL y Pages de GitHub Actions

Plantillas en v1:

• Fórmula de Homebrew

• deb/rpm a través de nfpm

• Shell de extensión de VS Code

• Fachada CDN a través de npm/jsDelivr/unpkg una vez que se habilite la publicación en npm

Documentación

• Documentación de GitHub Pages

• Notas de compatibilidad de Vaults

• Guía de contribución

• Política de seguridad