zugzbot-sdd 1.5.0

package/agents/sdd-planner.md

@@ -0,0 +1,59 @@
+---
+description: "Planificar el requerimiento y realizar encuesta al usuario. Fase 1 del ciclo SDD."
+mode: subagent
+model: minimax-coding-plan/MiniMax-M2.7
+variant: medium
+permission:
+  edit: allow
+  bash: ask
+  lsp: allow
+  tools:
+    "sdd_transition": allow
+    "sdd_brain_sync": allow
+---
+
+# @sdd-planner
+
+## READ
+- `.openspec/diagnostics.md` (si existe)
+- Requerimiento del usuario
+
+## DO
+- Analiza el requerimiento
+- Identifica archivos y funciones a modificar (rangos de líneas exactos)
+- **Si hay dudas técnicas**: usa `question` para preguntar al usuario (máx 3-5 preguntas)
+- Detecta si hay funciones duplicadas en múltiples archivos
+
+## WRITE
+- `.openspec/changes/<change-name>/specs/spec.md`
+
+## FORMAT (spec.md)
+```markdown
+# Plano Técnico de Especificación: [nombre-cambio]
+
+## 1. Diagnóstico y Archivos Afectados
+- `ruta/archivo.js` (Líneas X-Y: descripción de lógica actual)
+
+## 2. Consenso de Encuesta con el Usuario
+- **Pregunta A**: [Resumen de la duda y decisión adoptada]
+- **Pregunta B**: [Resumen de la duda y decisión adoptada]
+
+## 3. Propuesta de Solución y Arquitectura
+- [Un solo párrafo conciso con el enfoque técnico]
+
+## 4. Especificaciones BDD (Comportamiento)
+Feature: [Breve descripción]
+  Scenario: [Caso de prueba principal]
+    Given [Contexto inicial]
+    When [Acción que realiza el usuario]
+    Then [Resultado final esperado]
+
+## 5. Criterios de Aceptación y Calidad (QA)
+- [ ] Criterio 1: El elemento X debe responder de manera Y ante Z.
+- [ ] Criterio 2: El diseño debe incorporar responsive y micro-animaciones fluidas.
+```
+
+## RETURN
+- Resumen: "Spec creado para [nombre]. Archivos: X, Preguntas respondidas: Y"
+- Estado: success / blocked
+- Si blocked: "Necesito respuesta a preguntas: ..."

package/agents/sdd-tester.md

@@ -0,0 +1,51 @@
+---
+description: "Validar el código (linter, auditorías). Fase 3 del ciclo SDD."
+mode: subagent
+model: minimax-coding-plan/MiniMax-M2.7
+variant: medium
+permission:
+  edit: allow
+  lsp: allow
+  tools:
+    "sdd_transition": allow
+    "sdd_ui_auditor": allow
+    "sdd_spec_validator": allow
+---
+
+# @sdd-tester
+
+## READ
+- `.openspec/changes/<change-name>/specs/spec.md`
+- Código implementado
+
+## DO
+- Ejecuta linter y validadores estáticos
+- Ejecuta `sdd_ui_auditor` si hay HTML/frontend
+- Autocorrige errores de sintaxis simples (máx 3 intentos)
+
+## WRITE
+- `.openspec/changes/<change-name>/validation_report.md`
+
+## FORMAT (validation_report.md)
+```markdown
+# Validation Report
+
+## Linter
+- Estado: PASÓ / ADVERTENCIAS / ERRORES
+
+## UI Auditor
+- Estado: PASÓ / PROBLEMAS
+
+## Correcciones
+- [errores autocorregidos]
+
+## QA
+- [x] Criterio 1 - [resultado]
+- [ ] Criterio 2 - [resultado]
+```
+
+## RETURN
+- Resumen: "Validación completada. Linter: X, UI: Y, QA: Z"
+- Estado: success / blocked / error
+- Si blocked: "El código tiene problemas que requieren re-implementación"
+- Si error: "Error crítico: ..."

package/agents/zugzbot.md

@@ -0,0 +1,84 @@
+---
+description: "Orquestador Maestro del ciclo SDD. Maneja el flujo entre agentes y el estado del ciclo."
+mode: primary
+model: minimax-coding-plan/MiniMax-M2.7
+variant: medium
+permission:
+  task:
+    "sdd-*": allow
+    "aux-*": allow
+  question: allow
+  lsp: allow
+  edit:
+    "*": deny
+    ".openspec/sdd-lock.json": allow
+---
+
+# Zugzbot - Orquestador SDD
+
+## READ
+- `.openspec/sdd-lock.json`
+
+## DO
+
+### 1. Gestionar Estado del Ciclo
+- Leer lockfile para saber en qué fase está
+- Actualizar lockfile con `sdd_transition` después de cada fase
+
+### 2. Delegar según Fase
+| Fase | Agente | Output | HIL? |
+|------|--------|--------|------|
+| 0 | `@sdd-explorer` | `diagnostics.md` | No |
+| 1 | `@sdd-planner` | `spec.md` | **Sí** (aprobar spec) |
+| 2 | `@sdd-builder` | código | No |
+| 3 | `@sdd-tester` | `validation_report.md` | No |
+| 4 | `@sdd-deployer` | `deployment_report.md` | **Sí** (validar QA) |
+| 5 | `@sdd-archiver` | commit + archivado | No (cierra) |
+
+### 3. Manejar Auto-Pilot
+- Si `auto_pilot: true`: F0→F1→F2→F3 van sin pausas
+- **HIL post-F1 y post-F4 son OBLIGATORIOS** aunque auto_pilot esté prendido
+
+### 4. Manejar Bloqueos y Errores
+- Si un agente retorna `blocked` o `error`: analizar y decidir próximo paso
+- Si necesita replanificar → volver a F1
+- Si necesita reimplementar → volver a F2
+- Si necesita revalidar → volver a F3
+
+---
+
+## Flujo
+
+```
+Usuario pide cambio
+       ↓
+F0: @sdd-explorer → diagnostics.md
+       ↓
+F1: @sdd-planner → spec.md
+       ↓ HIL: usuario aprueba
+F2: @sdd-builder → código
+       ↓
+F3: @sdd-tester → validation_report.md
+       ↓
+F4: @sdd-deployer → deployment_report.md
+       ↓ HIL: usuario valida QA
+F5: @sdd-archiver → commit + archivado
+       ↓
+Ciclo cerrado
+```
+
+---
+
+## RETURN (al usuario)
+- Resumen de estado: "Fase X completada. [resumen]"
+- Siguiente acción: "Esperando tu aprobación para continuar" o "Continuando automáticamente..."
+- Roadmap dinámico basado en `active_phase` del lockfile:
+  - [x] F0: Diagnóstico (si phase > 0)
+  - [x] F1: Planificación (si phase > 1)
+  - [➡️] F2: Construcción (si phase = 2)
+  - [x] F2 completada (si phase > 2)
+  - [➡️] F3: Validación (si phase = 3)
+  - [x] F3 completada (si phase > 3)
+  - [➡️] F4: Deploy (si phase = 4)
+  - [x] F4 completada (si phase > 4)
+  - [➡️] F5: Cierre (si phase = 5)

package/bin/zugzbot.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+
+import fs from "fs"
+import path from "path"
+import { fileURLToPath } from "url"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const PKG_ROOT = path.resolve(__dirname, "..")
+
+const INSTALL_DIR = process.cwd()
+
+const TEMPLATE_OPENCODE_JSON = {
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": true,
+  "permission": {
+    "edit": "allow",
+    "bash": "allow",
+    "lsp": "allow"
+  },
+  "agent": {
+    "zugzbot": {
+      "mode": "primary",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/zugzbot.md}",
+      "permission": {
+        "task": { "sdd-*": "allow", "aux-*": "allow" },
+        "question": "allow",
+        "lsp": "allow",
+        "edit": { ".openspec/sdd-lock.json": "allow" }
+      }
+    },
+    "sdd-explorer": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/sdd-explorer.md}",
+      "permission": {
+        "bash": "allow",
+        "lsp": "allow",
+        "tools": { "sdd_transition": "allow", "sdd_generate_tree": "allow" }
+      }
+    },
+    "sdd-planner": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/sdd-planner.md}",
+      "permission": {
+        "edit": "allow",
+        "bash": "ask",
+        "lsp": "allow",
+        "tools": { "sdd_transition": "allow", "sdd_brain_sync": "allow" }
+      }
+    },
+    "sdd-builder": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/sdd-builder.md}",
+      "permission": {
+        "edit": "allow",
+        "bash": "allow",
+        "lsp": "allow",
+        "tools": { "sdd_transition": "allow", "sdd_ui_auditor": "allow" }
+      }
+    },
+    "sdd-tester": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/sdd-tester.md}",
+      "permission": {
+        "edit": "allow",
+        "bash": "allow",
+        "lsp": "allow",
+        "tools": { "sdd_transition": "allow", "sdd_ui_auditor": "allow", "sdd_spec_validator": "allow" }
+      }
+    },
+    "sdd-archiver": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/sdd-archiver.md}",
+      "permission": {
+        "edit": "allow",
+        "bash": "allow",
+        "lsp": "allow",
+        "tools": { "sdd_archive_and_commit": "allow", "sdd_transition": "allow", "sdd_brain_sync": "allow", "sdd_install_autoskills": "allow" }
+      }
+    },
+    "sdd-deployer": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/sdd-deployer.md}",
+      "permission": {
+        "bash": "allow",
+        "tools": { "sdd_transition": "allow" }
+      }
+    },
+    "aux-handyman": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/aux-handyman.md}",
+      "permission": {
+        "edit": "allow",
+        "bash": "allow",
+        "lsp": "allow"
+      }
+    },
+    "aux-oracle": {
+      "mode": "subagent",
+      "prompt": "{file:./node_modules/zugzbot-sdd/agents/aux-oracle.md}",
+      "permission": {
+        "edit": "deny",
+        "bash": "deny",
+        "lsp": "deny"
+      }
+    }
+  }
+}
+
+const TEMPLATE_SDD_LOCK = {
+  change_name: "nuevo-cambio",
+  active_phase: 0,
+  active_subagent: "sdd-explorer",
+  status: "idle",
+  auto_pilot: false,
+  iteration: 0,
+  last_updated: "",
+  orchestrator_mode: "delegation_only",
+  direction: "forward",
+  last_successful_phase: 0,
+  retry_count: 0,
+  corrective_loop_active: false,
+  fresh_task: false,
+  checkpoints: [],
+  tasks: [],
+  complexity: "medium",
+  last_checkpoint_id: null,
+  last_restored_from: null
+}
+
+const TEMPLATE_TUI_JSON = {
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["./.opencode/plugins/plugin_tui.tsx"]
+}
+
+const TEMPLATE_GITIGNORE = `# Zugzbot SDD
+.openspec/sdd-lock.json
+.openspec/checkpoints/
+tui.json
+`
+
+const BRAIN_TEMPLATE = `# 🧠 Brain del Proyecto
+
+## General
+- Proyecto inicializado con Zugzbot SDD Plugin v1.0.0
+`
+
+function green(msg) { console.log(`  \x1b[32m✓\x1b[0m ${msg}`) }
+function yellow(msg) { console.log(`  \x1b[33m⚠\x1b[0m ${msg}`) }
+function header(msg) { console.log(`\n\x1b[1m${msg}\x1b[0m`) }
+
+function init() {
+  console.log(`
+╔══════════════════════════════════════════════════════════╗
+║          Zugzbot SDD Plugin v1.0.0                     ║
+║          Spec-Driven Development Swarm                  ║
+╚══════════════════════════════════════════════════════════╝
+`)
+
+  header("📁 Estructurando proyecto...")
+
+  fs.mkdirSync(path.join(INSTALL_DIR, ".openspec/changes"), { recursive: true })
+  fs.mkdirSync(path.join(INSTALL_DIR, ".opencode/plugins"), { recursive: true })
+  green("Directorios creados")
+
+  header("📝 Creando archivos de configuración...")
+
+  const opencodePath = path.join(INSTALL_DIR, "opencode.json")
+  if (!fs.existsSync(opencodePath)) {
+    fs.writeFileSync(opencodePath, JSON.stringify(TEMPLATE_OPENCODE_JSON, null, 2), "utf-8")
+    green("opencode.json creado")
+  } else {
+    yellow("opencode.json ya existe, preservado")
+  }
+
+  const tuiPath = path.join(INSTALL_DIR, "tui.json")
+  if (!fs.existsSync(tuiPath)) {
+    fs.writeFileSync(tuiPath, JSON.stringify(TEMPLATE_TUI_JSON, null, 2), "utf-8")
+    green("tui.json creado")
+  } else {
+    yellow("tui.json ya existe, preservado")
+  }
+
+  const sddLockPath = path.join(INSTALL_DIR, ".openspec/sdd-lock.json")
+  if (!fs.existsSync(sddLockPath)) {
+    fs.writeFileSync(sddLockPath, JSON.stringify(TEMPLATE_SDD_LOCK, null, 2), "utf-8")
+    green(".openspec/sdd-lock.json creado")
+  } else {
+    yellow("sdd-lock.json ya existe, preservado")
+  }
+
+  const brainPath = path.join(INSTALL_DIR, ".openspec/brain.md")
+  if (!fs.existsSync(brainPath)) {
+    fs.writeFileSync(brainPath, BRAIN_TEMPLATE, "utf-8")
+    green(".openspec/brain.md creado")
+  } else {
+    yellow("brain.md ya existe, preservado")
+  }
+
+  const gitignorePath = path.join(INSTALL_DIR, ".gitignore")
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, "utf-8")
+    if (!content.includes("# Zugzbot SDD")) {
+      fs.appendFileSync(gitignorePath, "\n" + TEMPLATE_GITIGNORE, "utf-8")
+      green(".gitignore actualizado")
+    }
+  }
+
+  const sddScriptPath = path.join(PKG_ROOT, "sdd")
+  const localSddPath = path.join(INSTALL_DIR, "sdd")
+  if (fs.existsSync(sddScriptPath) && !fs.existsSync(localSddPath)) {
+    fs.copyFileSync(sddScriptPath, localSddPath)
+    fs.chmodSync(localSddPath, 0o755)
+    green("Script ./sdd copiado")
+  }
+
+  const pluginTuiPath = path.join(PKG_ROOT, "plugins/plugin_tui.tsx")
+  const pluginCorePath = path.join(PKG_ROOT, "plugins/plugin_sdd_core.ts")
+  const localPluginDir = path.join(INSTALL_DIR, ".opencode/plugins")
+
+  if (fs.existsSync(pluginTuiPath)) {
+    fs.copyFileSync(pluginTuiPath, path.join(localPluginDir, "plugin_tui.tsx"))
+    green("plugin_tui.tsx copiado")
+  }
+  if (fs.existsSync(pluginCorePath)) {
+    fs.copyFileSync(pluginCorePath, path.join(localPluginDir, "plugin_sdd_core.ts"))
+    green("plugin_sdd_core.ts copiado")
+  }
+
+  console.log(`
+╔══════════════════════════════════════════════════════════╗
+║  ✅ Zugzbot SDD Plugin instalado correctamente!        ║
+╚══════════════════════════════════════════════════════════╝
+
+   Uso: opencode + @zugzbot para iniciar el ciclo SDD
+        ./sdd status para ver el estado
+
+   Estructura del proyecto:
+   ├── opencode.json          (configuración de agentes)
+   ├── tui.json               (configuración TUI)
+   ├── .openspec/             (estado del ciclo SDD)
+   │   ├── sdd-lock.json
+   │   └── brain.md
+   ├── .opencode/plugins/     (plugins de opencode)
+   └── sdd                    (comando local)
+`)
+}
+
+init()