zugzbot-sdd 1.5.23 → 1.5.25

package/.opencode/tools/sdd_syntax_and_linter_auditor.js

@@ -0,0 +1,182 @@
+import { tool } from "@opencode-ai/plugin";
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+export default tool({
+    description: "Audita estáticamente cualquier archivo (o conjunto de archivos modificados) para diagnosticar fallas de sintaxis, paréntesis/llaves rotas, errores sintácticos o problemas de formato en múltiples tecnologías (JS, TS, Python, JSON, HTML).",
+    args: {
+        filePath: tool.schema.string().optional().describe("Ruta absoluta o relativa del archivo a auditar de forma quirúrgica. Si se omite, detectará automáticamente los archivos modificados vía git.")
+    },
+    async execute(args, context) {
+        const projectRoot = context.worktree || context.directory;
+        const diagnostics = [];
+        let filesToAudit = [];
+        if (args.filePath) {
+            const absolutePath = path.isAbsolute(args.filePath) ? args.filePath : path.join(projectRoot, args.filePath);
+            if (fs.existsSync(absolutePath) && fs.statSync(absolutePath).isFile()) {
+                filesToAudit.push(absolutePath);
+            }
+        }
+        else {
+            // Autodetectar vía git status
+            try {
+                const gitStatus = execSync("git status --porcelain", { cwd: projectRoot, encoding: "utf-8" });
+                gitStatus.split("\n").forEach(line => {
+                    const trimmed = line.trim();
+                    if (trimmed) {
+                        // git status --porcelain outputs e.g., "M src/index.js" or "A src/test.js"
+                        const parts = trimmed.split(/\s+/);
+                        if (parts.length >= 2) {
+                            const relPath = parts.slice(1).join(" ");
+                            const absolutePath = path.join(projectRoot, relPath);
+                            if (fs.existsSync(absolutePath) && fs.statSync(absolutePath).isFile()) {
+                                filesToAudit.push(absolutePath);
+                            }
+                        }
+                    }
+                });
+            }
+            catch (e) { }
+        }
+        if (filesToAudit.length === 0) {
+            return JSON.stringify({
+                status: "APPROVED",
+                message: "✓ No se encontraron archivos para auditar o todo está limpio.",
+                diagnostics: []
+            }, null, 2);
+        }
+        for (const file of filesToAudit) {
+            const ext = path.extname(file);
+            const relFile = path.relative(projectRoot, file);
+            try {
+                const content = fs.readFileSync(file, "utf-8");
+                // 1. Validar JSON
+                if (ext === ".json") {
+                    try {
+                        JSON.parse(content);
+                    }
+                    catch (err) {
+                        const lineMatch = err.message.match(/line (\d+)/i);
+                        diagnostics.push({
+                            file: relFile,
+                            type: "JSON Syntax Error",
+                            line: lineMatch ? parseInt(lineMatch[1]) : undefined,
+                            message: err.message
+                        });
+                    }
+                }
+                // 2. Validar JavaScript / Google Apps Script
+                else if (ext === ".js" || ext === ".jsx" || ext === ".gs") {
+                    try {
+                        execSync(`node --check "${file}"`, { stdio: "pipe" });
+                    }
+                    catch (err) {
+                        const stderr = err.stderr?.toString() || err.message || "";
+                        // Parse line number from node check, e.g. "index.js:5" or "line 5"
+                        const lineMatch = stderr.match(/:(\d+)\r?\n/m) || stderr.match(/line (\d+)/i);
+                        diagnostics.push({
+                            file: relFile,
+                            type: "JavaScript Syntax Error",
+                            line: lineMatch ? parseInt(lineMatch[1]) : undefined,
+                            message: stderr.split("\n")[0] || "Syntax error detected"
+                        });
+                    }
+                }
+                // 3. Validar TypeScript
+                else if (ext === ".ts" || ext === ".tsx") {
+                    try {
+                        // Intentar un tsc --noEmit localizado o verificar balanceo de tokens
+                        const hasBalancedParentheses = (str) => {
+                            const stack = [];
+                            const pairs = { ')': '(', '}': '{', ']': '[' };
+                            for (let i = 0; i < str.length; i++) {
+                                const char = str[i];
+                                if (['(', '{', '['].includes(char)) {
+                                    stack.push(char);
+                                }
+                                else if ([')', '}', ']'].includes(char)) {
+                                    if (stack.pop() !== pairs[char])
+                                        return false;
+                                }
+                            }
+                            return stack.length === 0;
+                        };
+                        if (!hasBalancedParentheses(content)) {
+                            diagnostics.push({
+                                file: relFile,
+                                type: "TypeScript Token Mismatch",
+                                message: "Falla de balanceo en paréntesis, llaves o corchetes detectada mediante auditoría estática."
+                            });
+                        }
+                    }
+                    catch (err) { }
+                }
+                // 4. Validar Python
+                else if (ext === ".py") {
+                    try {
+                        execSync(`python -m py_compile "${file}"`, { stdio: "pipe" });
+                    }
+                    catch (err) {
+                        const stderr = err.stderr?.toString() || err.message || "";
+                        const lineMatch = stderr.match(/line (\d+)/i);
+                        diagnostics.push({
+                            file: relFile,
+                            type: "Python Syntax Error",
+                            line: lineMatch ? parseInt(lineMatch[1]) : undefined,
+                            message: stderr.split("\n")[0] || "Python syntax compilation failed"
+                        });
+                    }
+                }
+                // 5. Validar HTML
+                else if (ext === ".html") {
+                    const unclosedTags = [];
+                    const tags = content.match(/<[^>]+>/g) || [];
+                    const stack = [];
+                    tags.forEach(tag => {
+                        const match = tag.match(/<\/?([a-zA-Z0-9:-]+)/);
+                        if (match) {
+                            const name = match[1];
+                            if (tag.startsWith("</")) {
+                                if (stack.length > 0 && stack[stack.length - 1] === name) {
+                                    stack.pop();
+                                }
+                                else {
+                                    unclosedTags.push(`Tag de cierre huérfano: ${tag}`);
+                                }
+                            }
+                            else if (!tag.endsWith("/>") && !["img", "br", "hr", "input", "meta", "link"].includes(name)) {
+                                stack.push(name);
+                            }
+                        }
+                    });
+                    if (stack.length > 0 || unclosedTags.length > 0) {
+                        diagnostics.push({
+                            file: relFile,
+                            type: "HTML Tag Mismatch",
+                            message: `Estructura HTML mal balanceada. Tags sin cerrar: ${stack.join(", ")}. ${unclosedTags.join("; ")}`
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                diagnostics.push({
+                    file: relFile,
+                    type: "Read Error",
+                    message: `Imposible leer o analizar el archivo: ${e.message}`
+                });
+            }
+        }
+        if (diagnostics.length > 0) {
+            return JSON.stringify({
+                status: "FAILED",
+                message: `❌ VALIDACIÓN DE SINTAXIS FALLIDA: Se detectaron ${diagnostics.length} errores de sintaxis o balanceo en los archivos modificados.`,
+                diagnostics
+            }, null, 2);
+        }
+        return JSON.stringify({
+            status: "APPROVED",
+            message: "✓ Validación de sintaxis exitosa. Todos los archivos auditados se encuentran 100% íntegros y limpios.",
+            diagnostics: []
+        }, null, 2);
+    }
+});

package/agents/sdd-builder.md

@@ -16,6 +16,7 @@ permission:
     "sdd_visual_regression_diff": allow
     "sdd_auto_api_mocker": allow
     "sdd_spec_compliance_linter": allow
+    "sdd_syntax_and_linter_auditor": allow
 ---
 
 # @sdd-builder
@@ -27,6 +28,7 @@ permission:
 ## DO
 - Implementa los cambios en el código según el spec, asegurándote de revisar `.openspec/brain.md` para cumplir estrictamente con los patrones técnicos exitosos y evitar reintroducir malas prácticas.
 - Usa `edit` para parches quirúrgicos (prohibido reescribir archivos completos).
+- **Pre-chequeo Local de Sintaxis**: Ejecuta OBLIGATORIAMENTE la herramienta premium `sdd_syntax_and_linter_auditor` sobre tus archivos modificados antes de finalizar para certificar la total integridad sintáctica de tus cambios (erradicando paréntesis, corchetes o llaves abiertas, y problemas de balanceo en general).
 - **Escaneo SAST Quirúrgico**: Ejecuta `sdd_security_vulnerability_scanner` sobre tus archivos modificados antes de cerrar tu implementación.
 - **Validación de Secretos**: Corre `sdd_secret_scanner` para asegurarte de no dejar tokens/passwords temporales de desarrollo.
 - **Linter de Especificación**: Ejecuta `sdd_spec_compliance_linter` para certificar que todos los criterios de aceptación del Spec estén cubiertos.
@@ -50,7 +52,7 @@ permission:
 - ❌ Escribir o autogenerar suites de tests unitarios o de integración
 - ❌ Ejecutar validación de linter o auditorías UI por cuenta propia (delegar a `@sdd-tester`)
 - ❌ Realizar deploys, pushes, o publicaciones de ningún tipo
-- ❌ Usar herramientas que no le fueron asignadas (`sdd_transition`, `sdd_ui_auditor`, `sdd_secret_scanner`, `sdd_security_vulnerability_scanner`, `sdd_visual_regression_diff`, `sdd_auto_api_mocker`, `sdd_spec_compliance_linter`)
+- ❌ Usar herramientas que no le fueron asignadas (`sdd_transition`, `sdd_ui_auditor`, `sdd_secret_scanner`, `sdd_security_vulnerability_scanner`, `sdd_visual_regression_diff`, `sdd_auto_api_mocker`, `sdd_spec_compliance_linter`, `sdd_syntax_and_linter_auditor`)
 - ❌ Modificar `package.json`, `tsconfig.json`, o archivos de configuración de proyecto
 - ❌ Ignorar el spec.md — toda implementación debe trackear contra los criterios de aceptación del spec
 

package/agents/sdd-tester.md

@@ -22,6 +22,7 @@ permission:
     "sdd_test_scaffold_generator": allow
     "sdd_spec_compliance_linter": allow
     "sdd_sandbox_patcher": allow
+    "sdd_syntax_and_linter_auditor": allow
 ---
 
 # @sdd-tester
@@ -34,15 +35,20 @@ permission:
 ## DO
 1. **Detección de Regresiones Históricas**: Lee `.openspec/brain.md` para identificar qué fallas específicas o comportamientos errados ocurrieron en el pasado. Debes verificar de manera explícita y prioritaria que la nueva implementación **no reintroduzca ninguno de los bugs o comportamientos incorrectos registrados en el Cerebro**.
 2. **Identificar Ecosistema Tecnológico**: Inspecciona la raíz del codebase (archivos como `package.json`, `requirements.txt`, `pyproject.toml`, `platformio.ini`, `CMakeLists.txt`, `go.mod`, etc.) para detectar el stack técnico del proyecto.
-3. **Validación y Auditorías**:
+3. **Configuración Proactiva de Linter/Calidad**:
+   - Si el proyecto no cuenta con una configuración mínima de linter o validador de sintaxis estática (como `.eslintrc`, `tsconfig.json` o similar) o carece de dependencias básicas de validación, **DEBES configurar proactivamente** los archivos iniciales mínimos o instalar localmente los paquetes de desarrollo requeridos (`npm install --save-dev eslint` o configuraciones nativas ligeras) para asegurar que el entorno sea capaz de diagnosticar la calidad del código.
+4. **Chequeo Obligatorio de Sintaxis y Compilación (Por Archivo Modificado)**:
+   - Identifica todos los archivos modificados en la sesión. Para realizar un diagnóstico completo y universal de sintaxis, **DEBES ejecutar OBLIGATORIAMENTE la herramienta premium `sdd_syntax_and_linter_auditor`** sobre cada archivo modificado o para el conjunto completo de cambios.
+   - Si la herramienta reporta un estado `FAILED` con errores de sintaxis (paréntesis, llaves o corchetes rotos, archivos JSON mal formateados, tags HTML sin balancear, etc.), **BLOQUEA de inmediato la transición** (marcando success/blocked a `blocked`), a menos que sea un error simple corregible usando `sdd_sandbox_patcher`.
+5. **Validación y Auditorías del Swarm**:
    - Ejecuta `sdd_spec_compliance_linter` para cruzar requerimientos.
    - Ejecuta `sdd_security_vulnerability_scanner` para detectar vulnerabilidades en el código.
    - Corre `sdd_visual_regression_diff` para auditar la interfaz y estilos.
    - Ejecuta `sdd_performance_regress_profiler` para medir latencias y rendimiento.
    - Usa `sdd_diff_impact_analyzer` para calcular el radio de impacto final.
-4. **Ejecutar Suite de Pruebas**: Corre la suite de tests nativos del proyecto (ej: `npm run test` / `npx vitest run`).
-5. **Autocorrección con Patcher**: Si detectas fallos unitarios simples, invoca `sdd_sandbox_patcher` para aplicar correcciones automáticas inmediatas sin retroceder de fase.
-6. **Validación UI**: Ejecuta `sdd_ui_auditor` si el proyecto es una app web/frontend con visualización o HTML.
+6. **Ejecutar Suite de Pruebas**: Corre la suite de tests nativos del proyecto (ej: `npm run test` / `npx vitest run`).
+7. **Autocorrección con Patcher**: Si detectas fallos unitarios simples o de sintaxis menores, invoca `sdd_sandbox_patcher` para aplicar correcciones automáticas inmediatas sin retroceder de fase.
+8. **Validación UI**: Ejecuta `sdd_ui_auditor` si el proyecto es una app web/frontend con visualización o HTML.
 
 ## WRITE
 - `.openspec/changes/<change-name>/validation_report.md`
@@ -84,7 +90,7 @@ permission:
 - ❌ Reescribir archivos de código — solo autocorregir errores de sintaxis simples usando `sdd_sandbox_patcher`
 - ❌ Escribir tests unitarios o de integración nuevos
 - ❌ Modificar archivos fuera de `.openspec/changes/<change-name>/`
-- ❌ Usar herramientas que no le fueron asignadas (`sdd_transition`, `sdd_ui_auditor`, `sdd_spec_validator`, `sdd_regression_detector`, `sdd_bdd_tester`, `sdd_requirement_tracker`, `sdd_diff_impact_analyzer`, `sdd_security_vulnerability_scanner`, `sdd_visual_regression_diff`, `sdd_performance_regress_profiler`, `sdd_auto_api_mocker`, `sdd_test_scaffold_generator`, `sdd_spec_compliance_linter`, `sdd_sandbox_patcher`)
+- ❌ Usar herramientas que no le fueron asignadas (`sdd_transition`, `sdd_ui_auditor`, `sdd_spec_validator`, `sdd_regression_detector`, `sdd_bdd_tester`, `sdd_requirement_tracker`, `sdd_diff_impact_analyzer`, `sdd_security_vulnerability_scanner`, `sdd_visual_regression_diff`, `sdd_performance_regress_profiler`, `sdd_auto_api_mocker`, `sdd_test_scaffold_generator`, `sdd_spec_compliance_linter`, `sdd_sandbox_patcher`, `sdd_syntax_and_linter_auditor`)
 
 > [!IMPORTANT]
 > SÓLO DEBE hacer: ejecutar linter, auditorías UI, validaciones estáticas, generar `validation_report.md`, invocar `sdd_transition` al completar.

package/bin/zugzbot.js

@@ -137,7 +137,8 @@ function buildOpencodeJson(models) {
             "sdd_security_vulnerability_scanner": "allow",
             "sdd_visual_regression_diff": "allow",
             "sdd_auto_api_mocker": "allow",
-            "sdd_spec_compliance_linter": "allow"
+            "sdd_spec_compliance_linter": "allow",
+            "sdd_syntax_and_linter_auditor": "allow"
           }
         }
       },
@@ -163,7 +164,8 @@ function buildOpencodeJson(models) {
             "sdd_auto_api_mocker": "allow",
             "sdd_test_scaffold_generator": "allow",
             "sdd_spec_compliance_linter": "allow",
-            "sdd_sandbox_patcher": "allow"
+            "sdd_sandbox_patcher": "allow",
+            "sdd_syntax_and_linter_auditor": "allow"
           }
         }
       },

package/opencode.json

@@ -74,7 +74,8 @@
           "sdd_security_vulnerability_scanner": "allow",
           "sdd_visual_regression_diff": "allow",
           "sdd_auto_api_mocker": "allow",
-          "sdd_spec_compliance_linter": "allow"
+          "sdd_spec_compliance_linter": "allow",
+          "sdd_syntax_and_linter_auditor": "allow"
         }
       }
     },
@@ -100,7 +101,8 @@
           "sdd_auto_api_mocker": "allow",
           "sdd_test_scaffold_generator": "allow",
           "sdd_spec_compliance_linter": "allow",
-          "sdd_sandbox_patcher": "allow"
+          "sdd_sandbox_patcher": "allow",
+          "sdd_syntax_and_linter_auditor": "allow"
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zugzbot-sdd",
-  "version": "1.5.23",
+  "version": "1.5.25",
   "description": "Zugzbot SDD Swarm - Spec-Driven Development Harness for OpenCode",
   "main": "index.js",
   "type": "module",

package/tools/sdd_syntax_and_linter_auditor.ts

@@ -0,0 +1,187 @@
+import { tool } from "@opencode-ai/plugin"
+import fs from "fs"
+import path from "path"
+import { execSync } from "child_process"
+
+export default tool({
+  description: "Audita estáticamente cualquier archivo (o conjunto de archivos modificados) para diagnosticar fallas de sintaxis, paréntesis/llaves rotas, errores sintácticos o problemas de formato en múltiples tecnologías (JS, TS, Python, JSON, HTML).",
+  args: {
+    filePath: tool.schema.string().optional().describe("Ruta absoluta o relativa del archivo a auditar de forma quirúrgica. Si se omite, detectará automáticamente los archivos modificados vía git.")
+  },
+  async execute(args, context) {
+    const projectRoot = context.worktree || context.directory
+    const diagnostics: Array<{ file: string; type: string; line?: number; message: string }> = []
+    
+    let filesToAudit: string[] = []
+
+    if (args.filePath) {
+      const absolutePath = path.isAbsolute(args.filePath) ? args.filePath : path.join(projectRoot, args.filePath)
+      if (fs.existsSync(absolutePath) && fs.statSync(absolutePath).isFile()) {
+        filesToAudit.push(absolutePath)
+      }
+    } else {
+      // Autodetectar vía git status
+      try {
+        const gitStatus = execSync("git status --porcelain", { cwd: projectRoot, encoding: "utf-8" })
+        gitStatus.split("\n").forEach(line => {
+          const trimmed = line.trim()
+          if (trimmed) {
+            // git status --porcelain outputs e.g., "M src/index.js" or "A src/test.js"
+            const parts = trimmed.split(/\s+/)
+            if (parts.length >= 2) {
+              const relPath = parts.slice(1).join(" ")
+              const absolutePath = path.join(projectRoot, relPath)
+              if (fs.existsSync(absolutePath) && fs.statSync(absolutePath).isFile()) {
+                filesToAudit.push(absolutePath)
+              }
+            }
+          }
+        })
+      } catch (e) {}
+    }
+
+    if (filesToAudit.length === 0) {
+      return JSON.stringify({
+        status: "APPROVED",
+        message: "✓ No se encontraron archivos para auditar o todo está limpio.",
+        diagnostics: []
+      }, null, 2)
+    }
+
+    for (const file of filesToAudit) {
+      const ext = path.extname(file)
+      const relFile = path.relative(projectRoot, file)
+      
+      try {
+        const content = fs.readFileSync(file, "utf-8")
+
+        // 1. Validar JSON
+        if (ext === ".json") {
+          try {
+            JSON.parse(content)
+          } catch (err: any) {
+            const lineMatch = err.message.match(/line (\d+)/i)
+            diagnostics.push({
+              file: relFile,
+              type: "JSON Syntax Error",
+              line: lineMatch ? parseInt(lineMatch[1]) : undefined,
+              message: err.message
+            })
+          }
+        }
+        
+        // 2. Validar JavaScript / Google Apps Script
+        else if (ext === ".js" || ext === ".jsx" || ext === ".gs") {
+          try {
+            execSync(`node --check "${file}"`, { stdio: "pipe" })
+          } catch (err: any) {
+            const stderr = err.stderr?.toString() || err.message || ""
+            // Parse line number from node check, e.g. "index.js:5" or "line 5"
+            const lineMatch = stderr.match(/:(\d+)\r?\n/m) || stderr.match(/line (\d+)/i)
+            diagnostics.push({
+              file: relFile,
+              type: "JavaScript Syntax Error",
+              line: lineMatch ? parseInt(lineMatch[1]) : undefined,
+              message: stderr.split("\n")[0] || "Syntax error detected"
+            })
+          }
+        }
+
+        // 3. Validar TypeScript
+        else if (ext === ".ts" || ext === ".tsx") {
+          try {
+            // Intentar un tsc --noEmit localizado o verificar balanceo de tokens
+            const hasBalancedParentheses = (str: string) => {
+              const stack: string[] = []
+              const pairs: Record<string, string> = { ')': '(', '}': '{', ']': '[' }
+              for (let i = 0; i < str.length; i++) {
+                const char = str[i]
+                if (['(', '{', '['].includes(char)) {
+                  stack.push(char)
+                } else if ([')', '}', ']'].includes(char)) {
+                  if (stack.pop() !== pairs[char]) return false
+                }
+              }
+              return stack.length === 0
+            }
+            if (!hasBalancedParentheses(content)) {
+              diagnostics.push({
+                file: relFile,
+                type: "TypeScript Token Mismatch",
+                message: "Falla de balanceo en paréntesis, llaves o corchetes detectada mediante auditoría estática."
+              })
+            }
+          } catch (err: any) {}
+        }
+
+        // 4. Validar Python
+        else if (ext === ".py") {
+          try {
+            execSync(`python -m py_compile "${file}"`, { stdio: "pipe" })
+          } catch (err: any) {
+            const stderr = err.stderr?.toString() || err.message || ""
+            const lineMatch = stderr.match(/line (\d+)/i)
+            diagnostics.push({
+              file: relFile,
+              type: "Python Syntax Error",
+              line: lineMatch ? parseInt(lineMatch[1]) : undefined,
+              message: stderr.split("\n")[0] || "Python syntax compilation failed"
+            })
+          }
+        }
+
+        // 5. Validar HTML
+        else if (ext === ".html") {
+          const unclosedTags: string[] = []
+          const tags = content.match(/<[^>]+>/g) || []
+          const stack: string[] = []
+          
+          tags.forEach(tag => {
+            const match = tag.match(/<\/?([a-zA-Z0-9:-]+)/)
+            if (match) {
+              const name = match[1]
+              if (tag.startsWith("</")) {
+                if (stack.length > 0 && stack[stack.length - 1] === name) {
+                  stack.pop()
+                } else {
+                  unclosedTags.push(`Tag de cierre huérfano: ${tag}`)
+                }
+              } else if (!tag.endsWith("/>") && !["img", "br", "hr", "input", "meta", "link"].includes(name)) {
+                stack.push(name)
+              }
+            }
+          })
+          
+          if (stack.length > 0 || unclosedTags.length > 0) {
+            diagnostics.push({
+              file: relFile,
+              type: "HTML Tag Mismatch",
+              message: `Estructura HTML mal balanceada. Tags sin cerrar: ${stack.join(", ")}. ${unclosedTags.join("; ")}`
+            })
+          }
+        }
+
+      } catch (e: any) {
+        diagnostics.push({
+          file: relFile,
+          type: "Read Error",
+          message: `Imposible leer o analizar el archivo: ${e.message}`
+        })
+      }
+    }
+
+    if (diagnostics.length > 0) {
+      return JSON.stringify({
+        status: "FAILED",
+        message: `❌ VALIDACIÓN DE SINTAXIS FALLIDA: Se detectaron ${diagnostics.length} errores de sintaxis o balanceo en los archivos modificados.`,
+        diagnostics
+      }, null, 2)
+    }
+
+    return JSON.stringify({
+      status: "APPROVED",
+      message: "✓ Validación de sintaxis exitosa. Todos los archivos auditados se encuentran 100% íntegros y limpios.",
+      diagnostics: []
+    }, null, 2)
+  }
+})