mcp-state-machine-test-framework 1.2.7 → 1.3.2

package/bin/init.js

@@ -1,53 +1,75 @@
-#!/usr/bin/env node
-import fs from "fs/promises";
-import path from "path";
-import { execSync } from "child_process";
-
-async function init() {
-    console.log("🚀 Iniciando instalación universal del State Machine Framework...");
-    const root = process.cwd();
-
-    // 1. Asegurar package.json
-    try {
-        await fs.access(path.join(root, "package.json"));
-    } catch (e) {
-        console.log("📦 No se encontró package.json. Inicializando proyecto Node...");
-        execSync("npm init -y", { stdio: "inherit" });
-    }
-
-    // 2. Crear carpetas
-    const dirs = ['maps', 'suites', 'test_cases', 'reports', 'data'];
-    for (const dir of dirs) {
-        await fs.mkdir(path.join(root, dir), { recursive: true });
-    }
-
-    // 3. Crear mcp_config.json
-    const mcpConfig = {
-        mcpServers: {
-            "mcp-sms": {
-                "command": "npx",
-                "args": ["-y", "mcp-state-machine-test-framework"]
-            }
-        }
-    };
-    await fs.writeFile(path.join(root, "mcp_config.json"), JSON.stringify(mcpConfig, null, 2));
-    console.log("🔌 mcp_config.json creado.");
-
-    // 4. Crear Templates
-    const templates = {
-        'maps/template_map.json': { nodos: { HOME: { transiciones: { IR_A_LOGIN: { destino: "LOGIN", accion: "mcp:wdio-mcp/click_element { \"selector\": \"~Login\" }" } } }, LOGIN: { transiciones: { VOLVER: { destino: "HOME", accion: "mcp:wdio-mcp/click_element { \"selector\": \"~Back\" }" } } } } },
-        'test_cases/template_case.json': { name: "Template Case", steps: [ { name: "Ir a Login", action: "IR_A_LOGIN" } ] },
-        'suites/template_suite.json': { name: "Template Suite", state_map: "template_map.json", tests: ["template_case"] }
-    };
-
-    for (const [relPath, content] of Object.entries(templates)) {
-        await fs.writeFile(path.join(root, relPath), JSON.stringify(content, null, 2));
-    }
-
-    console.log("✅ ¡Instalación completada con éxito! Ya puedes usar las herramientas MCP.");
-}
-
-init().catch(err => {
-    console.error("❌ Error durante la instalación:", err.message);
-    process.exit(1);
-});
+#!/usr/bin/env node
+import fs from "fs/promises";
+import path from "path";
+import { execSync } from "child_process";
+
+async function init() {
+    console.log("🚀 Iniciando instalación universal del State Machine Framework...");
+    const root = process.cwd();
+
+    // 1. Asegurar package.json
+    try {
+        await fs.access(path.join(root, "package.json"));
+    } catch (e) {
+        console.log("📦 No se encontró package.json. Inicializando proyecto Node...");
+        execSync("npm init -y", { stdio: "inherit" });
+    }
+
+    // 2. Crear carpetas
+    const dirs = ['maps', 'suites', 'test_cases', 'reports', 'data'];
+    for (const dir of dirs) {
+        await fs.mkdir(path.join(root, dir), { recursive: true });
+    }
+
+    // 3. Instalar localmente para evitar problemas de npx en Windows
+    console.log("📦 Instalando dependencias locales...");
+    execSync("npm install mcp-state-machine-test-framework", { stdio: "inherit" });
+
+    // 4. Crear mcp_config.json con ruta local estable
+    const mcpConfig = {
+        mcpServers: {
+            "mcp-sms": {
+                "command": "node",
+                "args": ["node_modules/mcp-state-machine-test-framework/index.js"]
+            }
+        }
+    };
+    await fs.writeFile(path.join(root, "mcp_config.json"), JSON.stringify(mcpConfig, null, 2));
+    console.log("🔌 mcp_config.json creado.");
+
+    // 4. Crear Templates
+    const templates = {
+        'maps/template_map.json': {
+            nodos: {
+                HOME: {
+                    fingerprint: { selectors: ["~Login_Button"] },
+                    transiciones: { IR_A_LOGIN: { destino: "LOGIN", accion: "mcp:wdio-mcp/click_element {\"selector\":\"~Login_Button\"}" } }
+                },
+                LOGIN: {
+                    fingerprint: { selectors: ["~Back_Button", "id:login_title"] },
+                    transiciones: { VOLVER: { destino: "HOME", accion: "mcp:wdio-mcp/click_element {\"selector\":\"~Back_Button\"}" } }
+                }
+            }
+        },
+        'test_cases/template_case.json': {
+            name: "TC_Template",
+            steps: [
+                { name: "Navegar a Login", action: "transicion:IR_A_LOGIN", assert: "sh:echo 'Validación de UI exitosa'" }
+            ]
+        },
+        'suites/template_suite.json': { name: "Suite_Template", state_map: "template_map.json", tests: ["TC_Template"] }
+    };
+
+    for (const [relPath, content] of Object.entries(templates)) {
+        await fs.writeFile(path.join(root, relPath), JSON.stringify(content, null, 2));
+    }
+
+    console.log("\n✅ ¡Instalación completada con éxito!");
+    console.log("👉 PRÓXIMO PASO: Dile al agente:");
+    console.log("   'Agente, inicia el diseño del mapa para MiApp'");
+}
+
+init().catch(err => {
+    console.error("❌ Error durante la instalación:", err.message);
+    process.exit(1);
+});

package/index.js

@@ -68,7 +68,7 @@ export class MaquinaDeEstados {
     async ejecutarSuite(suiteName) {
         const suite = this.suites.get(suiteName);
         if (!suite) throw new Error(`Suite '${suiteName}' no encontrada.`);
-        
+
         const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
         const reportDir = path.join(REPORTS_ROOT, `exec_${suiteName}_${timestamp}`);
         await fs.mkdir(reportDir, { recursive: true });
@@ -83,13 +83,13 @@ export class MaquinaDeEstados {
                     const executeAction = async (act) => {
                         const subRes = (act === action) ? actionRes : { action: act, status: "passed" };
                         if (act !== action) targetRes.push(subRes);
-                        
+
                         if (act.startsWith("transicion:")) {
                             const transName = act.replace("transicion:", "").trim();
                             const mapPath = path.join(__dirname, 'maps', suite.state_map);
                             const mapData = JSON.parse(await fs.readFile(mapPath, 'utf8'));
                             const nodes = mapData.nodos || mapData;
-                            
+
                             let foundAction, destNodeName;
                             for (const [nodeName, node] of Object.entries(nodes)) {
                                 if (node.transiciones && node.transiciones[transName]) {
@@ -217,68 +217,72 @@ server.tool("init_project", "Instalación Inicial. Crea carpetas y archivos de p
     return { content: [{ type: "text", text: "✨ Entorno Inicializado. Usa 'sms_builder' para empezar el diseño." }] };
 });
 
-server.tool("sms_builder", "Diseño Guiado: Nodos -> Tests -> Suite.", {
+server.tool("sms_builder", "ASISTENTE PROACTIVO de Diseño. GUÍA AL USUARIO paso a paso. Instrucciones: 1. Empieza SIEMPRE con action: 'start' { mapName }. 2. No preguntes qué hacer, sugiere el siguiente paso lógico (Nodo -> Huella -> Test).", {
     action: z.enum(["start", "add_node", "add_fingerprint", "done_node", "add_test", "add_step", "add_assert", "save_test", "assemble_suite"]),
     data: z.record(z.any())
 }, async ({ action, data }) => {
     const ctxPath = path.join(__dirname, '.sms_builder_context.json');
     let ctx = { step: "IDLE", nodes: {}, tests: [] };
-    try { ctx = JSON.parse(fsSync.readFileSync(ctxPath, 'utf8')); } catch (e) {}
+    try { ctx = JSON.parse(fsSync.readFileSync(ctxPath, 'utf8')); } catch (e) { }
 
     switch (action) {
         case "start":
-            ctx = { step: "DESIGN", mapName: data.mapName, nodes: {}, tests: [] };
+            ctx = { step: "ADD_NODE", mapName: data.mapName, nodes: {}, tests: [] };
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `🏗️ Diseñando Mapa: ${data.mapName}. Añade un nodo (action: 'add_node' { nodeName }).` }] };
-        
+            return { content: [{ type: "text", text: `🏗️ DISEÑO INICIADO: ${data.mapName}\n\n👉 ACCIÓN REQUERIDA: 'add_node' { nodeName: "HOME" }.` }] };
+
         case "add_node":
             ctx.currentNode = { name: data.nodeName, transiciones: {}, fingerprint: null };
+            ctx.step = "ADD_FINGERPRINT";
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `📍 Nodo '${data.nodeName}'. MANDATORIO: Añade huella (action: 'add_fingerprint' { selector }).` }] };
-        
+            return { content: [{ type: "text", text: `📍 NODO '${data.nodeName}' CREADO.\n\n👉 ACCIÓN OBLIGATORIA: 'add_fingerprint' { selector: "..." }.` }] };
+
         case "add_fingerprint":
             if (!ctx.currentNode.fingerprint) ctx.currentNode.fingerprint = { selectors: [] };
             ctx.currentNode.fingerprint.selectors.push(data.selector);
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `🧬 Vector añadido. ¿Otro o 'done_node'?` }] };
-        
+            return { content: [{ type: "text", text: `🧬 VECTOR AÑADIDO.\n\n👉 OPCIONES: 1. 'add_fingerprint' (más vectores) | 2. 'done_node' (finalizar nodo).` }] };
+
         case "done_node":
             ctx.nodes[ctx.currentNode.name] = { fingerprint: ctx.currentNode.fingerprint, transiciones: ctx.currentNode.transiciones };
             await fs.writeFile(path.join(__dirname, 'maps', `${ctx.mapName}.json`), JSON.stringify({ nodos: ctx.nodes }, null, 2));
             delete ctx.currentNode;
+            ctx.step = "DECIDE_NEXT";
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `✅ Nodo guardado. ¿Otro ('add_node') o Tests ('add_test')?` }] };
+            return { content: [{ type: "text", text: `✅ NODO GUARDADO.\n\n👉 OPCIONES: 1. 'add_node' (otro nodo) | 2. 'add_test' (empezar pruebas).` }] };
 
         case "add_test":
             ctx.currentTest = { name: data.testName, steps: [] };
+            ctx.step = "ADD_STEP";
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `🧪 Test '${data.testName}'. Añade pasos (action: 'add_step' { name, action }).` }] };
-        
+            return { content: [{ type: "text", text: `🧪 TEST '${data.testName}' EN PROCESO.\n\n👉 ACCIÓN REQUERIDA: 'add_step' { name, action }.` }] };
+
         case "add_step":
             ctx.currentStep = { name: data.name, action: data.action };
+            ctx.step = "DECIDE_STEP";
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `✅ Paso añadido. ¿Assert? (action: 'add_assert' { assert }) o siguiente ('add_step').` }] };
-        
+            return { content: [{ type: "text", text: `✅ PASO AÑADIDO.\n\n👉 OPCIONES: 1. 'add_assert' (validación) | 2. 'add_step' (más pasos) | 3. 'save_test'.` }] };
+
         case "add_assert":
             ctx.currentStep.assert = data.assert;
             ctx.currentTest.steps.push(ctx.currentStep);
             delete ctx.currentStep;
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `🛡️ Assert añadido. ¿Siguiente paso ('add_step') o guardar ('save_test')?` }] };
-        
+            return { content: [{ type: "text", text: `🛡️ ASSERT REGISTRADO.\n\n👉 OPCIONES: 1. 'add_step' | 2. 'save_test'.` }] };
+
         case "save_test":
             if (ctx.currentStep) ctx.currentTest.steps.push(ctx.currentStep);
             await fs.writeFile(path.join(__dirname, 'test_cases', `${ctx.currentTest.name}.json`), JSON.stringify(ctx.currentTest, null, 2));
             ctx.tests.push(ctx.currentTest.name);
             delete ctx.currentTest;
             fsSync.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2));
-            return { content: [{ type: "text", text: `✅ Test guardado. ¿Otro ('add_test') o Suite ('assemble_suite')?` }] };
-        
+            return { content: [{ type: "text", text: `✅ TEST GUARDADO.\n\n👉 OPCIONES: 1. 'add_test' | 2. 'assemble_suite'.` }] };
+
         case "assemble_suite":
             const suite = { name: data.suiteName, state_map: `${ctx.mapName}.json`, tests: ctx.tests };
             await fs.writeFile(path.join(__dirname, 'suites', `${data.suiteName}.json`), JSON.stringify(suite, null, 2));
             fsSync.unlinkSync(ctxPath);
-            return { content: [{ type: "text", text: `🎊 Suite '${data.suiteName}' lista. Corre con 'sms_executor'.` }] };
+            return { content: [{ type: "text", text: `🎊 DISEÑO FINALIZADO. Suite '${data.suiteName}' lista.\n\n👉 ACCIÓN FINAL: Usa 'sms_executor' { suiteName: '${data.suiteName}' }.` }] };
     }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-state-machine-test-framework",
-  "version": "1.2.7",
+  "version": "1.3.2",
   "description": "High-fidelity State Machine MCP Server for autonomous E2E testing orchestration.",
   "main": "index.js",
   "type": "module",