mddd-cli 4.0.5 → 4.1.0

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.5');
+  .version('4.1.0');
 
 // ==========================================
 // 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.5",
+  "version": "4.1.0",
   "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,76 @@
+import { parse } from '@mermaid-js/parser';
+import fs from 'node:fs';
+
+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;
+}
+
+/**
+ * Limpa comentários do topo do diagrama que quebram o parser do Mermaid
+ * @param {string} code 
+ * @returns {string}
+ */
+function cleanDiagramCode(code) {
+  // Remove linhas que começam com %% no topo do arquivo antes da declaração do tipo
+  const lines = code.split('\n');
+  const cleanedLines = [];
+  let foundTypeDeclaration = false;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    
+    // Ignora linhas vazias ou comentários iniciais até achar a declaração do diagrama
+    if (!foundTypeDeclaration && (trimmed === '' || trimmed.startsWith('%%'))) {
+      continue; 
+    }
+    
+    foundTypeDeclaration = true;
+    cleanedLines.push(line);
+  }
+
+  return cleanedLines.join('\n').trim();
+}
+
+export async function validateMermaidSyntax(input) {
+  let content = input;
+
+  if (fs.existsSync(input)) {
+    content = fs.readFileSync(input, 'utf-8');
+  }
+
+  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."
+      };
+    }
+  }
+
+  try {
+    for (const diagramCode of diagramsToValidate) {
+      // Aplica a limpeza antes de mandar para o parser em memória
+      const readyCode = cleanDiagramCode(diagramCode);
+      await parse(readyCode);
+    }
+    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