mddd-cli 4.0.4 → 4.0.6

package/bin/cli.js

@@ -4,6 +4,7 @@ import { Command } from 'commander';
 import pc from 'picocolors';
 import { FileSystemService } from '../src/services/FileSystemService.js';
 import { InitService } from '../src/services/InitService.js';
+import { validateMermaidSyntax } from '../src/commands/validator.js';
 import * as initCmd from '../src/commands/init.js';
 
 // ─── Services ────────────────────────────────────────────────────────────────
@@ -16,7 +17,7 @@ const program = new Command();
 program
   .name('md')
   .description('Manager for co-located specifications for Mermaid Diagram Driven Development (MDDD)')
-  .version('4.0.4');
+  .version('4.0.6');
 
 // ==========================================
 // COMMAND: md init
@@ -33,5 +34,22 @@ program
     }
   });
 
+  program
+  .command('validate <target>')
+  .description('Validate Mermaid diagrams in .md files (returns JSON)')
+  .action(async (target) => {
+    // Executa a lógica de validação na memória
+    const result = await validateMermaidSyntax(target);
+
+    // Cospe APENAS o JSON no stdout para a IA ler de forma limpa
+    console.log(JSON.stringify(result));
+
+    // Controla o encerramento do processo com o exit code correto
+    if (!result.valid) {
+      process.exit(1);
+    }
+    process.exit(0);
+  });
+
 // ─── Parse ───────────────────────────────────────────────────────────────────
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mddd-cli",
-  "version": "4.0.4",
+  "version": "4.0.6",
   "description": "Official CLI for modular, co-located, and versioned Mermaid Diagram Driven Development (MDDD).",
   "type": "module",
   "exports": "./bin/cli.js",
@@ -39,8 +39,8 @@
   },
   "homepage": "https://github.com/JulioCRFilho/mermaid-diagram-driven-development#readme",
   "dependencies": {
-    "@mermaid-js/mermaid-cli": "^11.15.0",
+    "@mermaid-js/parser": "^1.1.1",
     "commander": "^12.0.0",
     "picocolors": "^1.0.0"
   }
-}
+}

package/src/commands/validator.js

@@ -0,0 +1,57 @@
+import { parse } from '@mermaid-js/parser';
+import fs from 'node:fs';
+
+/**
+ * Filtra o texto para extrair apenas o que está dentro dos blocos ```mermaid
+ */
+function extractMermaidBlocks(text) {
+  const regex = /```mermaid\s*([\s\S]*?)\s*```/g;
+  const blocks = [];
+  let match;
+  
+  while ((match = regex.exec(text)) !== null) {
+    if (match[1].trim()) {
+      blocks.push(match[1].trim());
+    }
+  }
+  
+  return blocks;
+}
+
+/**
+ * Valida o conteúdo recebido (pode ser o caminho de um arquivo ou a string direta)
+ */
+export async function validateMermaidSyntax(input) {
+  let content = input;
+
+  // Se o input for um caminho de arquivo válido no disco, lê o conteúdo dele
+  if (fs.existsSync(input)) {
+    content = fs.readFileSync(input, 'utf-8');
+  }
+
+  // Se houver blocos de Markdown indicando Mermaid, isola os diagramas
+  let diagramsToValidate = [content];
+  if (content.includes('```mermaid')) {
+    diagramsToValidate = extractMermaidBlocks(content);
+    
+    if (diagramsToValidate.length === 0) {
+      return {
+        valid: false,
+        error: "Nenhum bloco de código '```mermaid' estruturado foi encontrado."
+      };
+    }
+  }
+
+  // Valida cada bloco na memória usando o parser oficial
+  try {
+    for (const diagramCode of diagramsToValidate) {
+      await parse(diagramCode);
+    }
+    return { valid: true };
+  } catch (error) {
+    return {
+      valid: false,
+      error: error.message || 'Erro de sintaxe desconhecido no Mermaid.'
+    };
+  }
+}

package/src/skills/md-audit/content.js

@@ -21,7 +21,7 @@ stateDiagram-v2
         CheckCode --> EvaluatedCodeIsChaotic: Draw BOTH current chaotic logic AND ideal target refactored graph (v1.0.0 - draft)
     }
     
-    RenderTopology --> CheckDiagram: Use mmdc -i <path/to/diagram.md> --checkSyntax to validate diagram syntax
+    RenderTopology --> CheckDiagram: Use "npx md validate <path/to/spec.md>" to validate diagram syntax
 
     state CheckDiagram {
         [*] --> DiagramValid: Proceed to next step

package/src/skills/md-edit/content.js

@@ -22,7 +22,7 @@ stateDiagram-v2
         [*] --> IncrementMajor: Increment Major: Bump X in X.Y.Z
     }
 
-    IncrementVersion --> CheckDiagram: Use mmdc -i <path/to/diagram.md> --checkSyntax to validate diagram syntax
+    IncrementVersion --> CheckDiagram: Use "npx md validate <path/to/spec.md>" to validate diagram syntax
 
     state CheckDiagram {
         [*] --> TryRender

package/src/skills/md-new/content.js

@@ -19,7 +19,7 @@ stateDiagram-v2
 
     EvaluateContext --> GenerateBlueprint: Create .spec.md from "src/templates/spec-template.md".
     GenerateBlueprint --> FormatSpecOutput: Format blueprint into target .spec.md structure
-    FormatSpecOutput --> CheckDiagram: Use mmdc -i <path/to/diagram.md> --checkSyntax to validate diagram syntax
+    FormatSpecOutput --> CheckDiagram: Use "npx md validate <path/to/spec.md>" to validate diagram syntax
 
     state CheckDiagram {
         [*] --> DiagramValid: Proceed to next step

package/system_prompt.md

@@ -217,7 +217,7 @@ The UNIVERSAL RULE is now integrated into the main processing diagram at the top
 
 **Before ANY action, the system MUST verify that a `.spec.md` file exists for the target domain/feature.** If no spec exists, only `md-new` and `md-audit` skills are allowed to proceed (to create or propose a spec). All other skills (`md-impl`, `md-edit`, etc.) are DENIED without an existing specification.
 
-Diagrams: Always use npx @mermaid-js/mermaid-cli to Validate Diagrams Syntax (Mandatory)
+Diagrams: Always use mmdc -i <path/to/diagram.md> --checkSyntax to validate diagram syntax (Mandatory)
 
 ```mermaid
 %% @spec-version v2.0.0