zugzbot-sdd 1.5.21 → 1.5.23

package/.opencode/tools/sdd_bdd_tester.js

@@ -30,7 +30,11 @@ export default tool({
             return `[BDD Tester Blocked] Error: No hay un cambio de desarrollo activo especificado o registrado en el sdd-lock.`;
         }
         // 2. Localizar spec.md
-        const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
+        const changeDir = path.join(projectRoot, ".openspec/changes", changeName);
+        let specPath = path.join(changeDir, "specs/spec.md");
+        if (!fs.existsSync(specPath)) {
+            specPath = path.join(changeDir, "spec.md");
+        }
         if (!fs.existsSync(specPath)) {
             return `[BDD Tester Blocked] Error: No se pudo localizar el archivo de especificación en '${path.relative(projectRoot, specPath)}'.`;
         }

package/.opencode/tools/sdd_compact_context.js

@@ -33,7 +33,10 @@ export default tool({
         }
         // 2. Leer artefactos individuales
         const proposalPath = path.join(changeDir, "proposal.md");
-        const specPath = path.join(changeDir, "specs/spec.md");
+        let specPath = path.join(changeDir, "specs/spec.md");
+        if (!fs.existsSync(specPath)) {
+            specPath = path.join(changeDir, "spec.md");
+        }
         const archPath = path.join(changeDir, "orchestrator_architecture.md");
         const tasksPath = path.join(changeDir, "orchestrator_tasks.md");
         let proposalSummary = "No disponible";

package/.opencode/tools/sdd_requirement_tracker.js

@@ -44,7 +44,11 @@ export default tool({
             }, null, 2);
         }
         // 2. Leer spec.md
-        const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
+        const changeDir = path.join(projectRoot, ".openspec/changes", changeName);
+        let specPath = path.join(changeDir, "specs/spec.md");
+        if (!fs.existsSync(specPath)) {
+            specPath = path.join(changeDir, "spec.md");
+        }
         if (!fs.existsSync(specPath)) {
             return JSON.stringify({
                 status: "FAILED",

package/.opencode/tools/sdd_security_vulnerability_scanner.js

@@ -14,7 +14,10 @@ export default tool({
         let filesToScan = [];
         try {
             // Intenta obtener los archivos modificados desde la spec o diagnostics
-            const specPath = path.join(changeDir, "specs/spec.md");
+            let specPath = path.join(changeDir, "specs/spec.md");
+            if (!fs.existsSync(specPath)) {
+                specPath = path.join(changeDir, "spec.md");
+            }
             if (fs.existsSync(specPath)) {
                 const specContent = fs.readFileSync(specPath, "utf-8");
                 const fileMatches = specContent.match(/`([^`\s\/]+(?:\.[a-zA-Z0-9]+)+)`/g);

package/.opencode/tools/sdd_spec_validator.js

@@ -26,17 +26,15 @@ export default tool({
             }
             catch (e) { }
         }
-        if (!changeName || changeName === "nuevo-cambio") {
-            return JSON.stringify({
-                status: "FAILED",
-                reason: "No se pudo autodetectar un cambio de desarrollo activo en .openspec/sdd-lock.json. Asegúrate de iniciar la Fase 1 primero."
-            }, null, 2);
+        const changeDir = path.join(projectRoot, ".openspec/changes", changeName || "nuevo-cambio");
+        let specPath = path.join(changeDir, "specs/spec.md");
+        if (!fs.existsSync(specPath)) {
+            specPath = path.join(changeDir, "spec.md");
         }
-        const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
         if (!fs.existsSync(specPath)) {
             return JSON.stringify({
                 status: "FAILED",
-                reason: `No se encuentra el archivo de especificación specs/spec.md para el cambio '${changeName}'. Ruta esperada: ${path.relative(projectRoot, specPath)}`
+                reason: `No se encuentra el archivo de especificación spec.md para el cambio '${changeName || "nuevo-cambio"}'. Ruta esperada: .openspec/changes/${changeName || "nuevo-cambio"}/[specs/]spec.md`
             }, null, 2);
         }
         const specContent = fs.readFileSync(specPath, "utf-8");

package/.opencode/tools/sdd_transition.js

@@ -120,7 +120,11 @@ export default tool({
             }
             catch (e) { }
             // Extracción de checklist de tareas desde spec.md para el monitor de estados
-            const specPath = path.join(projectRoot, ".openspec/changes", activeChangeName, "specs/spec.md");
+            const changeDir = path.join(projectRoot, ".openspec/changes", activeChangeName);
+            let specPath = path.join(changeDir, "specs/spec.md");
+            if (!fs.existsSync(specPath)) {
+                specPath = path.join(changeDir, "spec.md");
+            }
             if (fs.existsSync(specPath)) {
                 try {
                     const specContent = fs.readFileSync(specPath, "utf-8");

package/.opencode/tools/sdd_ui_auditor.js

@@ -156,7 +156,11 @@ export default tool({
             catch (e) { }
         }
         // B. Buscar archivos listados en el spec.md activo
-        const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
+        const changeDir = path.join(projectRoot, ".openspec/changes", changeName);
+        let specPath = path.join(changeDir, "specs/spec.md");
+        if (!fs.existsSync(specPath)) {
+            specPath = path.join(changeDir, "spec.md");
+        }
         if (fs.existsSync(specPath)) {
             try {
                 const specContent = fs.readFileSync(specPath, "utf-8");

package/agents/sdd-deployer.md

@@ -17,35 +17,40 @@ permission:
 - Código implementado
 
 ## DO
-1. **Identificar Método de Despliegue**: Inspecciona el codebase para identificar el mecanismo de deploy del proyecto:
-   - **Apps Script (Google Apps Script)**: Si existe `.clasp.json`, ejecuta de manera obligatoria `npx clasp push`.
-   - **C++ (PlatformIO / ESP32)**: Si existe `platformio.ini`, ejecuta `pio run -t upload` o similar para subir el firmware al dispositivo.
-   - **Ecosistemas Web/Backend (Node, Python)**: Si existe un comando de deploy en `package.json` (como `npm run deploy` o `npm run build`), ejecútalo.
-   - **Otros**: Ejecuta el pipeline o comando de despliegue nativo configurado en el proyecto.
-2. **Ejecutar Despliegue Físico**: Usa tu permiso de terminal (`bash`) para ejecutar activamente el comando de despliegue real en el entorno del host.
-3. **Verificación de Éxito**: Captura el output y confirma que el despliegue fue exitoso (ej: "Pushed X files", "SUCCESS", "Upload successful", etc.). Si falla, reintenta hasta 2 veces.
+- **Estandarización del Despliegue de Desarrollo**: Tu objetivo primordial en la Fase 4 es realizar el despliegue del código sanitizado **únicamente a un entorno de desarrollo / sandbox / staging** del proyecto (ej: la versión del script de pruebas en GAS, servidor de staging local, rama de desarrollo de pruebas, o Sandbox simulado) para que el usuario pueda validarlo empíricamente.
+- **Identificar Configuración de Desarrollo**: Inspecciona el codebase para identificar cómo compilar/subir el código de forma localizada a desarrollo:
+  - **Google Apps Script**: Si existe `.clasp.json`, valida la conexión y ejecuta de manera obligatoria `npx clasp push` (asegúrate de que está apuntando al script de desarrollo/sandbox).
+  - **Ecosistemas Web/Frontend**: Busca scripts de despliegue de desarrollo en `package.json` (como `npm run deploy`, `npm run build:dev` o `npm run deploy:dev`).
+  - **Otros Ecosistemas**: Utiliza el comando nativo de subida de pruebas o integración local.
+- **Instalación y Diagnóstico Autocontrolado**: Si detectas que herramientas globales como `clasp` o `pio` no están instaladas o fallan en caliente, realiza una instalación local de emergencia (ej: `npm install --no-save @google/clasp` local) para no interrumpir el flujo.
+- **Ejecutar Despliegue Físico**: Usa tu permiso de terminal (`bash`) para ejecutar el despliegue físico de desarrollo.
+- **Verificación y Reporte de Salud**: Captura el log del despliegue y certifica que los archivos se subieron correctamente. Si el deploy falla, reintenta hasta 2 veces.
 
 ## WRITE
 - `.openspec/changes/<change-name>/deployment_report.md`
 
 ## FORMAT (deployment_report.md)
 ```markdown
-# Deployment Report
+# Reporte de Despliegue en Entorno de Desarrollo (Fase 4)
 
-## Deploy
-- Comando: [Comando ejecutado, ej: npx clasp push, pio run -t upload]
-- Estado: ÉXITO / FALLO
-- Detalle / Archivos subidos: [Detalle del output]
-- Errores: [si los hay]
+## 🚀 Despliegue a Desarrollo / Sandbox
+- **Comando Ejecutado**: [ej: npx clasp push]
+- **Entorno Destino**: [Desarrollo / Sandbox / Staging]
+- **Estado final del deploy**: ÉXITO / FALLO
+- **Métricas / Archivos subidos**: [Detalle del output]
 
-## Verificación
-- [ ] Despliegue verificado con éxito en el host
+## 🔍 Enlace de Verificación de QA
+- **Dirección de Visualización**: [Inserta URL del script de pruebas de GAS, Web App dev, o localhost para testear]
+
+## 📋 Criterios a Validar en Caliente
+- [ ] Validar que la interfaz se renderice correctamente en desarrollo.
+- [ ] Validar que la lógica nueva responda sin excepciones.
 ```
 
 ## RETURN
-- Resumen: "Deploy [ÉXITO/FALLO]. Archivos: X"
+- Resumen: "Despliegue a desarrollo completado con éxito. Listo para revisión de QA."
 - Estado: success / error
-- Si error: "Deploy falló después de 3 intentos: ..."
+- Si error: "Deploy a desarrollo fallido: [detalles del error]"
 
 ---
 
@@ -54,13 +59,14 @@ permission:
 > [!CRITICAL]
 > LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
 
-- ❌ Editar, modificar o eliminar ningún archivo de código fuente
-- ❌ Modificar specs, spec.md, validation_report.md o cualquier archivo en `.openspec/`
+- ❌ Editar, modificar o eliminar ningún archivo de código fuente del proyecto
+- ❌ Modificar specs, spec.md, validation_report.md o cualquier archivo en `.openspec/` excepto el entregable `deployment_report.md`
 - ❌ Crear tests, suites de validación o archivos de reporte más allá del `deployment_report.md`
 - ❌ Usar herramientas diferentes a las asignadas (`sdd_transition` únicamente)
-- ❌ Ejecutar linters, auditorías o validaciones de código
-- ❌ Revertir, rollbackear o deshacer cambios ya hechos
-- ❌ Hacer más de 3 intentos de deploy (después del 3ro, debe retornar error y delegar a revisión humana)
+- ❌ Ejecutar linters, auditorías o validaciones de código fuente
+- ❌ Revertir, rollbackear o deshacer cambios ya hechos de forma no autorizada
+- ❌ Realizar deploys a entornos de **PRODUCCIÓN** reales directamente sin aprobación manual humana (HIL)
+- ❌ Hacer más de 3 intentos de deploy de desarrollo
 
 > [!IMPORTANT]
-> SÓLO DEBE hacer: ejecutar `npx clasp push`, verificar output, generar `deployment_report.md`, invocar `sdd_transition` al completar
+> SÓLO DEBE hacer: ejecutar el despliegue al entorno de desarrollo/sandbox, verificar el output del deploy, generar `deployment_report.md` con enlaces de prueba, e invocar `sdd_transition` para detener el ciclo en espera de validación manual (HIL).

package/agents/zugzbot.md

@@ -103,8 +103,8 @@ Ciclo cerrado (solo si 100% tasks completed)
 > [!CRITICAL]
 > LÍMITES ABSOLUTOS — ESTE AGENTE NO PUEDE:
 
-- ❌ Editar, crear o eliminar ningún archivo de código fuente
-- ❌ Ejecutar comandos bash de ningún tipo
+- ❌ Editar, crear o eliminar ningún archivo de código fuente o configuración (HTML, JS, TS, GS, CSS, JSON, etc.)
+- ❌ Ejecutar comandos bash o terminal de ningún tipo (ej: git, npm, clasp push, pio run, etc.) — DEBE DELEGAR 100% de estas tareas a sus subagentes correspondientes según la fase activa del ciclo SDD.
 - ❌ Ejecutar herramientas LSP de diagnóstico propio (solo delegar)
 - ❌ Escribir specs, reports, o cualquier archivo del proyecto
 - ❌ Modificar el lockfile `sdd-lock.json` directamente (SOLO via `sdd_transition`)
@@ -114,3 +114,4 @@ Ciclo cerrado (solo si 100% tasks completed)
 > [!IMPORTANT]
 > SÓLO DEBE hacer: leer lockfile, delegar a agente correspondiente, mostrar roadmap, verificar tareas pendientes, invocar `sdd_transition` para avanzar fases.
 > Todos los archivos generados dentro de `.openspec/` (ej: spec.md, diagnostics.md, validation_report.md, deployment_report.md, sdd-lock.json) deben quedar impecablemente estructurados y guardados con rigurosidad profesional.
+> Queda estrictamente PROHIBIDO al orquestador realizar tareas de codificación, testeo, o despliegue por sí mismo. Su rol es puramente de coordinación estratégica y toma de decisiones.

package/package.json

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

package/tools/sdd_bdd_tester.ts

@@ -33,7 +33,11 @@ export default tool({
     }
 
     // 2. Localizar spec.md
-    const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
+    const changeDir = path.join(projectRoot, ".openspec/changes", changeName);
+    let specPath = path.join(changeDir, "specs/spec.md");
+    if (!fs.existsSync(specPath)) {
+      specPath = path.join(changeDir, "spec.md");
+    }
     if (!fs.existsSync(specPath)) {
       return `[BDD Tester Blocked] Error: No se pudo localizar el archivo de especificación en '${path.relative(projectRoot, specPath)}'.`;
     }

package/tools/sdd_compact_context.ts

@@ -37,7 +37,10 @@ export default tool({
 
     // 2. Leer artefactos individuales
     const proposalPath = path.join(changeDir, "proposal.md");
-    const specPath = path.join(changeDir, "specs/spec.md");
+    let specPath = path.join(changeDir, "specs/spec.md");
+    if (!fs.existsSync(specPath)) {
+      specPath = path.join(changeDir, "spec.md");
+    }
     const archPath = path.join(changeDir, "orchestrator_architecture.md");
     const tasksPath = path.join(changeDir, "orchestrator_tasks.md");
 

package/tools/sdd_requirement_tracker.ts

@@ -47,7 +47,11 @@ export default tool({
     }
 
     // 2. Leer spec.md
-    const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
+    const changeDir = path.join(projectRoot, ".openspec/changes", changeName);
+    let specPath = path.join(changeDir, "specs/spec.md");
+    if (!fs.existsSync(specPath)) {
+      specPath = path.join(changeDir, "spec.md");
+    }
     if (!fs.existsSync(specPath)) {
       return JSON.stringify({
         status: "FAILED",

package/tools/sdd_security_vulnerability_scanner.ts

@@ -17,7 +17,10 @@ export default tool({
 
     try {
       // Intenta obtener los archivos modificados desde la spec o diagnostics
-      const specPath = path.join(changeDir, "specs/spec.md")
+      let specPath = path.join(changeDir, "specs/spec.md")
+      if (!fs.existsSync(specPath)) {
+        specPath = path.join(changeDir, "spec.md")
+      }
       if (fs.existsSync(specPath)) {
         const specContent = fs.readFileSync(specPath, "utf-8")
         const fileMatches = specContent.match(/`([^`\s\/]+(?:\.[a-zA-Z0-9]+)+)`/g)

package/tools/sdd_spec_validator.ts

@@ -28,18 +28,16 @@ export default tool({
       } catch (e) {}
     }
 
-    if (!changeName || changeName === "nuevo-cambio") {
-      return JSON.stringify({
-        status: "FAILED",
-        reason: "No se pudo autodetectar un cambio de desarrollo activo en .openspec/sdd-lock.json. Asegúrate de iniciar la Fase 1 primero."
-      }, null, 2);
+    const changeDir = path.join(projectRoot, ".openspec/changes", changeName || "nuevo-cambio");
+    let specPath = path.join(changeDir, "specs/spec.md");
+    if (!fs.existsSync(specPath)) {
+      specPath = path.join(changeDir, "spec.md");
     }
 
-    const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
     if (!fs.existsSync(specPath)) {
       return JSON.stringify({
         status: "FAILED",
-        reason: `No se encuentra el archivo de especificación specs/spec.md para el cambio '${changeName}'. Ruta esperada: ${path.relative(projectRoot, specPath)}`
+        reason: `No se encuentra el archivo de especificación spec.md para el cambio '${changeName || "nuevo-cambio"}'. Ruta esperada: .openspec/changes/${changeName || "nuevo-cambio"}/[specs/]spec.md`
       }, null, 2);
     }
 

package/tools/sdd_transition.ts

@@ -129,7 +129,11 @@ export default tool({
       } catch (e) {}
 
       // Extracción de checklist de tareas desde spec.md para el monitor de estados
-      const specPath = path.join(projectRoot, ".openspec/changes", activeChangeName, "specs/spec.md");
+      const changeDir = path.join(projectRoot, ".openspec/changes", activeChangeName);
+      let specPath = path.join(changeDir, "specs/spec.md");
+      if (!fs.existsSync(specPath)) {
+        specPath = path.join(changeDir, "spec.md");
+      }
       if (fs.existsSync(specPath)) {
         try {
           const specContent = fs.readFileSync(specPath, "utf-8");

package/tools/sdd_ui_auditor.ts

@@ -153,7 +153,11 @@ export default tool({
     }
 
     // B. Buscar archivos listados en el spec.md activo
-    const specPath = path.join(projectRoot, ".openspec/changes", changeName, "specs/spec.md");
+    const changeDir = path.join(projectRoot, ".openspec/changes", changeName);
+    let specPath = path.join(changeDir, "specs/spec.md");
+    if (!fs.existsSync(specPath)) {
+      specPath = path.join(changeDir, "spec.md");
+    }
     if (fs.existsSync(specPath)) {
       try {
         const specContent = fs.readFileSync(specPath, "utf-8");