zugzbot 1.1.1 → 1.1.2

package/.opencode/agents/sdd-coder.md

@@ -2,7 +2,7 @@
 description: Implementa código ajustándose estrictamente a los contratos en specs/
 mode: subagent
 hidden: true
-steps: 25
+steps: 50
 model: deepseek/deepseek-v4-flash
 temperature: 0.35
 frequency_penalty: 0.5

package/.opencode/agents/sdd-deployer.md

@@ -27,6 +27,12 @@ Eres el Desplegador de Software (sdd-deployer) del flujo SDD. Tu único trabajo
   2. `docker compose up -d --build --force-recreate` — construye e inicia
   3. `curl http://localhost:3000` (y opcionalmente `/dashboard`) — verifica
 - **NO cargar skill docker-templates** si el tool está disponible (ahorra 300+ tokens).
+- **Timeout duro Docker daemon (CRÍTICO — bugfix sesión 1186)**: Tienes un límite MÁXIMO de 90 segundos para esperar a que Docker daemon responda. Después de eso, ABORTA inmediatamente con el reporte `❌ Docker daemon no disponible después de 90s` y NO reintentes más allá de ese límite. Pasos:
+  1. `docker info > /dev/null 2>&1 && echo OK || echo FAIL` (1 intento)
+  2. Si FAIL: `open -a Docker` en macOS, o mostrar instrucciones para Linux
+  3. Loop de espera con `sleep 5 && docker info > /dev/null` hasta 90s acumulados
+  4. Si después de 90s sigue FAIL: abortar y dar instrucciones al usuario
+- Esto previene que el deployer quede atrapado esperando Docker daemon indefinidamente (como ocurrió en sesión 118f).
 </constraints>
 
 <deployment>

package/.opencode/agents/sdd-orchestrator.md

@@ -49,15 +49,18 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
   <f0_detect>
     1. **Inicialización Atómica**: Llama obligatoriamente a `sdd_get_initial_session_data` para obtener estado, memorias e Oh-My-Design en un solo turno.
     2. **Brain Pre-carga (OBLIGATORIO)**: Inmediatamente después, invoca `brain_read_memory({ category: "learnings" })` y `brain_read_memory({ category: "errors" })` para extraer errores y lecciones históricas que prevengan repetir problemas conocidos. Guarda el resultado en una variable interna para inyectarlo en cada brief de subagente.
-    3. **Autopiloto (/loop)**:
+    3. **Detección Fast-Track Dashboard (CRÍTICO — bugfix sesión 1186)**: Analiza la petición del usuario. Si contiene ALGUNA de estas keywords: `dashboard`, `admin panel`, `panel de control`, `panel admin`, `crm`, `erp`, `panel`:
+       - **NO preguntes NADA**. Asume todos los defaults: Stack = Next.js 16 + Shadcn UI + Tailwind v4, Persistencia = localStorage/mock, Diseño = primer recomendado (Vercel/Linear/Supabase), Verificación = `console`.
+       - Llama directamente a `sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "dashboard-admin" })` con `coreStack: ["Next.js 16", "Shadcn UI", "Tailwind CSS v4"]` y `skip_lint_gate: true`.
+       - El spec-writer creará automáticamente el spec con `sdd_hints.fast_track: true` y `blocks_to_install: ["@shadcn/dashboard-01"]`.
+    4. **Autopiloto (/loop)**:
        - Si el usuario especificó `/loop N` o `iteraciones=N`, autoselecciona Next.js 16, Console mode, y el primer diseño recomendado.
        - Transiciona atómicamente a F1 con `sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "<nombre-kebab>", loopMode: true, loopTargetIterations: N, loopCurrentIteration: 1 })`.
-    4. **Normal (HIL) — Pregunta Mínima**: Llama **UNA sola vez** a `question` con **una sola decisión clave**:
-       - Modo de verificación: `Console` (rápido, sin Playwright) o `Visual` (con Playwright, +30% tiempo).
+    5. **Normal (HIL) — Pregunta Mínima SINGLE-QUESTION**: Si NO se detectó Fast-Track Dashboard, llama **UNA sola vez** a `question` con **una sola pregunta** (NO múltiples):
+       - **PROHIBIDO** hacer arrays de múltiples preguntas en `questions: [...]` — causa errores de JSON parsing con caracteres especiales. SOLO una pregunta por llamada.
        - **Defaults razonables automáticos** (NO preguntes): Stack = Next.js 16 + Shadcn UI, Persistencia = localStorage/mock, Diseño = primer recomendado.
-       - Si el usuario pide un dashboard/panel/landing explícitamente, **recomienda Console** y usa `dashboard-01` como bloque base sin preguntar nada más.
+       - Si llegas a preguntar, hazlo solo sobre `verificationMode` (Console vs Visual).
        - Luego, transiciona con `sdd_set_phase` a `F1_CONTRACT`.
-    5. **Fast-Track Dashboard (Auto-detect)**: Si la petición del usuario contiene keywords (`dashboard`, `admin panel`, `panel de control`, `panel admin`, `crm`, `erp`), y NO existe un proyecto en `src/`, **recomienda automáticamente** usar `@shadcn/dashboard-01` como bloque base y crea el spec con `sdd_hints.block_strategy = "npx shadcn@latest add @shadcn/dashboard-01"` pre-rellenado. En este modo, F1 se reduce a validación de tokens de diseño únicamente.
   </f0_detect>
 
   <f1_contract>
@@ -72,19 +75,23 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
   </f1_contract>
 
   <f2_implementation>
-    1. **Delega a `@sdd-coder`**: Envía un prompt conciso. NO re-envíes el contrato entero ni el package.json. Pasa solo:
+    1. **Pre-división de sprints OBLIGATORIA (CRÍTICO — bugfix sesión 1186)**: Si `files_affected.length > 5`, divide el trabajo en 2 sprints separados y delega a DOS instancias independientes del coder (NO reusar task_id):
+       - **Sprint 1 (Bootstrap + Block Install)**: Bootstrap del proyecto + instalar bloque(s) shadcn. NUNCA más de 5 archivos.
+       - **Sprint 2 (Personalización + Polish)**: Layout wrapper, ThemeToggle (si aplica), tokens de marca, theme provider. NUNCA más de 5 archivos.
+       - Cada sprint es una **nueva instancia** del coder (sin `task_id` previo).
+       - Esto previene "te quedaste sin pasos" y elimina esperas manuales del usuario.
+    2. **Delega a `@sdd-coder`**: Envía un prompt conciso. NO re-envíes el contrato entero ni el package.json. Pasa solo:
        - Spec name + ruta del contract.json
-       - Lista resumida de `files_affected`
-       - Lista de sprints pre-divididos si `files_affected.length > 5`
+       - Lista resumida de `files_affected` para ESTE sprint (si dividiste)
        - Sección `brain_learnings` del brief
        - *Instrucción clave:* Indica si requiere bootstrap. Prohíbe formalmente el uso de `brain_read_memory` (ya está inyectado). Si el subagente se había quedado sin pasos y debes re-invocarlo con su `task_id`, el prompt DEBE SER EXTREMADAMENTE BREVE (ej. "Te quedaste sin pasos. Tu contexto y tareas ya están en tu historial. Revisa lo que falta y continúa."). NO incluyas código ni listas largas para no contaminar el contexto.
-    2. **Verificación de Servidor**:
+    3. **Verificación de Servidor**:
        - **Si la categoría es 'script' o 'tooling' (Track Agnóstico):** No hay un dev server web que correr. Salta directamente este paso y transiciona de forma inmediata a F3.
        - **De lo contrario (Web Next/FastAPI):**
          - En autopiloto: Aprueba directo si el server corre sin errores fatales. Transiciona a F3.
          - En modo `console`: Dile al usuario que verifique localmente en `http://localhost:3000`. Prohibido usar Playwright.
          - En modo `visual`: Toma screenshot en `.openspec/ts-f2-hil.png` y preséntalo para aprobación.
-    3. Transiciona a `F3_VERIFICATION` llamando a `sdd_set_phase`.
+    4. Transiciona a `F3_VERIFICATION` llamando a `sdd_set_phase`.
   </f2_implementation>
 
   <f3_verification>
@@ -92,6 +99,7 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
     2. **Pre-inyecta el brief al Tester (BLOQUEANTE)**: Antes de delegar al tester, invoca `brain_read_memory({ category: "errors" })` (idempotente, ya lo hiciste en F0) e inyecta el resultado como sección `regressions` en `.openspec/active-brief.md`. Esto previene que el tester repita errores históricos.
     3. Delega a `@sdd-tester` para ejecutar las pruebas unitarias o de integración de la suite. (Si es un App Script o Bash, el Tester verificará la estructura del archivo y sintaxis básica).
        - *Instrucción clave al delegar:* Pasa solo la ruta del spec, la lista de test files a ejecutar, los mockPatterns pre-armados y la sección `regressions`. NO incluyas las listas de test_scenarios completas. PROHIBIDO usar `glob` o `read` masivos: el brief ya tiene todo pre-inyectado. Al igual que en F2, si el subagente se quedó sin pasos y usas su `task_id`, el prompt DEBE SER EXTREMADAMENTE BREVE.
+       - **PROHIBIDO**: pasar al tester una descripción que lo invite a hacer `render()` sobre componentes complejos. En modo `console` solo se permiten smoke tests (`fs.existsSync` + verificación de export).
     4. **Transición**:
        - **Si la categoría es 'script' o 'tooling' (Track Agnóstico):** Omitir la fase F4_DEPLOYMENT por completo (los scripts no requieren Docker en su ciclo estándar). Transiciona directamente a `<completion>`.
        - **De lo contrario (Web):**

package/.opencode/agents/sdd-tester.md

@@ -46,6 +46,9 @@ Eres el Validador de Contratos (sdd-tester) del flujo SDD. Tu trabajo es ejecuta
   - `regressions` (lecciones del Brain sobre fallos históricos)
   - Resumen de los `test_scenarios` del contrato activo
   - Lee solo el `.openspec/active-brief.md` UNA vez. Si necesitas más contexto de un archivo específico, léelo UNA vez por archivo, NUNCA de forma masiva.
+- **PROHIBIDO ABSOLUTO: `render()` en modo `console`** (CRÍTICO — bugfix sesión 1186): En modo `console`, tienes ESTRICTAMENTE PROHIBIDO usar `render()` de `@testing-library/react`, `userEvent`, `screen` ni cualquier API que monte componentes reales. Razón: happy-dom se cuelga 30+ segundos al cargar componentes de shadcn (DataTable, ChartAreaInteractive, AppSidebar) que internamente importan Radix, recharts y otros con cadenas de Context. Si necesitas validación visual, usa modo `visual` con Playwright.
+  - **Patrón obligatorio**: smoke tests. Validar que el archivo del componente EXISTE en disco (`fs.existsSync`), que CONTIENE el export esperado (`grep -E "export (default )?(function|const) Name"`), y que su firma coincide con el contrato.
+  - **Excepción**: PROHIBIDO incluso para ThemeToggle. Valida el contrato sin renderizar.
 - **Prohibición de Duplicar Lógica**: Tienes estrictamente prohibido simular o recrear la lógica de negocio dentro de las pruebas para forzar que pasen. Debes importar y verificar los componentes y funciones reales desde `src/`. Moca dependencias externas o corrige configuraciones en `setup.ts` si es necesario.
 - **Ruta de Capturas de Pantalla**: Cualquier screenshot con `playwright_browser_take_screenshot` debe guardarse obligatoriamente con el prefijo `.openspec/ts-` (ej. `.openspec/ts-home-page.png`). Nunca los guardes en la raíz.
 - **Prohibición de Playwright**: Si `verificationMode === "console"` en contract.json, tienes STRICTAMENTE PROHIBIDO usar cualquier tool o navegador de Playwright.

package/.opencode/tools/sdd_docker.ts

@@ -161,15 +161,20 @@ CMD ["python", "src/main.py"]
       
       const p = "npm"
       let pm = "npm"
-      let installCmd = "npm ci --frozen-lockfile"
+      // v3.0 — Usar `npm install` adaptativo en vez de `npm ci --frozen-lockfile`.
+      // Razón: el bootstrap del harness a menudo agrega packages (shadcn, tailwindcss v4,
+      // etc.) que desincronizan el lockfile con package.json, causando `npm ci`
+      // a fallar con "lock file does not satisfy". `npm install --no-audit --no-fund`
+      // resuelve adaptativamente sin sacrificar la velocidad.
+      let installCmd = "npm install --no-audit --no-fund"
       let buildCmd = "npm run build"
       if (fs.existsSync(path.resolve(targetPath, "pnpm-lock.yaml"))) {
         pm = "pnpm"
-        installCmd = "pnpm install --frozen-lockfile"
+        installCmd = "pnpm install --no-frozen-lockfile"
         buildCmd = "pnpm build"
       } else if (fs.existsSync(path.resolve(targetPath, "yarn.lock"))) {
         pm = "yarn"
-        installCmd = "yarn install --frozen-lockfile"
+        installCmd = "yarn install"
         buildCmd = "yarn build"
       }
 

package/.opencode/tools/sdd_testing.ts

@@ -403,68 +403,40 @@ export const generate_tests = tool({
         }
       } else {
         const componentImport = `@/components/blocks/${feature}`
+        // v3.0 — ESTRATEGIA SMOKE TEST PURO. NO importamos el componente
+        // para evitar cascadas de imports que cuelgan happy-dom (Radix, recharts,
+        // shadcn Sidebar, ThemeProvider, etc.). En su lugar validamos que el
+        // archivo del componente EXISTE en disco, tiene el export esperado
+        // y su firma (function type) coincide con el contrato.
         lines.push('import { describe, it, expect } from "vitest";')
+        lines.push('import * as fs from "fs";')
+        lines.push('import * as path from "path";')
+        lines.push("")
 
-        if (hasReact) {
-          lines.push('')
-          lines.push(`import { ${feature} } from "${componentImport}";`)
-          lines.push('')
-          lines.push('// NOTA: NO importamos render/screen/userEvent aquí a propósito.')
-          lines.push('// Hacer `render(<Component />)` sobre componentes que dependen de Context')
-          lines.push('// (SidebarProvider, ThemeProvider, etc.) cuelga happy-dom indefinidamente.')
-          lines.push('// Estrategia: smoke tests que verifican imports y signatures sin renderizar.')
-          lines.push('// Para tests con interacción real (clicks, eventos), crea un archivo .test.tsx')
-          lines.push('// dedicado que envuelva el componente con sus Providers necesarios.')
-        }
+        lines.push(`describe("${feature} Tests (Contract Scenarios — smoke)", () => {`)
+        lines.push(`  const componentPath = path.resolve(__dirname, "../components/blocks/${feature}.tsx");`)
+        lines.push(`  const componentPathTs = path.resolve(__dirname, "../components/blocks/${feature}.ts");`)
+        lines.push(`  const altPath = path.resolve(__dirname, "../components/${feature}.tsx");`)
+        lines.push(`  const altPathTs = path.resolve(__dirname, "../components/${feature}.ts");`)
         lines.push("")
-        lines.push(`describe("${feature} Tests (Contract Scenarios)", () => {`)
 
         for (const s of scenarios) {
           const tid = s.id || "TS-XX"
           const name = s.name || "Test case"
-          const isIntegration = s.type === "integration"
-          const thenText = (s.then || "").toLowerCase()
-          
           lines.push(`  // ${tid}: ${name}`)
           lines.push(`  // Given: ${s.given || ""}`)
           lines.push(`  // When: ${s.when || ""}`)
           lines.push(`  // Then: ${s.then || ""}`)
-          
-          // PATRÓN SMOKE TEST (default): NO renderizamos componentes.
-          // Solo validamos que el módulo se importa, exporta lo esperado,
-          // y cumple con la firma del contrato. Esto evita el cuelgue de
-          // happy-dom con árboles de componentes que requieren Providers.
-          if (isIntegration && thenText.includes("dark")) {
-            lines.push(`  it("${tid}: ${name} (smoke: importable + toggle contract)", () => {`)
-            lines.push(`    // Verifica que el módulo importa sin errores`)
-            lines.push(`    expect(typeof ${feature}).toBe("function");`)
-            lines.push(`    // Verifica firma del contrato: ThemeToggle expone props esperadas`)
-            lines.push(`    expect(${feature}.length).toBeGreaterThanOrEqual(0); // acepta 0 props`)
-            lines.push(`  });`)
-          } else if (thenText.includes("kpi") || thenText.includes("tarjeta") || thenText.includes("valor")) {
-            lines.push(`  it("${tid}: ${name} (smoke: import + render-safe module shape)", () => {`)
-            lines.push(`    expect(typeof ${feature}).toBe("function");`)
-            lines.push(`    // Verifica que el módulo tiene export default o named export consistente`)
-            lines.push(`    expect(${feature}).toBeDefined();`)
-            lines.push(`  });`)
-          } else if (thenText.includes("sidebar") || thenText.includes("navega")) {
-            lines.push(`  it("${tid}: ${name} (smoke: sidebar module loads)", () => {`)
-            lines.push(`    expect(typeof ${feature}).toBe("function");`)
-            lines.push(`    // El sidebar requiere SidebarProvider; verificar solo import evita cuelgue`)
-            lines.push(`    expect(${feature}).toBeDefined();`)
-            lines.push(`  });`)
-          } else if (thenText.includes("svg") || thenText.includes("chart") || thenText.includes("recharts") || thenText.includes("gráfico") || thenText.includes("grafico")) {
-            lines.push(`  it("${tid}: ${name} (smoke: chart module loads without crashing)", () => {`)
-            lines.push(`    expect(typeof ${feature}).toBe("function");`)
-            lines.push(`    // Los charts requieren Recharts ResponsiveContainer; verificamos solo el módulo`)
-            lines.push(`    expect(${feature}).toBeDefined();`)
-            lines.push(`  });`)
-          } else {
-            lines.push(`  it("${tid}: ${name} (smoke: module + contract signature)", () => {`)
-            lines.push(`    expect(typeof ${feature}).toBe("function");`)
-            lines.push(`    expect(${feature}).toBeDefined();`)
-            lines.push(`  });`)
-          }
+          lines.push(`  it("${tid}: ${name}", () => {`)
+          lines.push(`    // 1. El archivo del componente debe existir en disco`)
+          lines.push(`    const exists = fs.existsSync(componentPath) || fs.existsSync(componentPathTs) || fs.existsSync(altPath) || fs.existsSync(altPathTs);`)
+          lines.push(`    expect(exists, "Component file should exist").toBe(true);`)
+          lines.push(`    // 2. El archivo debe contener el export del componente`)
+          lines.push(`    const candidates = [componentPath, componentPathTs, altPath, altPathTs];`)
+          lines.push(`    const found = candidates.find((p) => fs.existsSync(p));`)
+          lines.push(`    const content = found ? fs.readFileSync(found, "utf8") : "";`)
+          lines.push(`    expect(content).toMatch(new RegExp("(export\\\\s+(default\\\\s+)?(function|const)\\\\s+${feature}|export\\\\s+\\\\{[^}]*\\\\b${feature}\\\\b)"));`)
+          lines.push("  });")
           lines.push("")
         }
         lines.push("});")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zugzbot",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Fácil instalador del arnés SDD de Zugzbot para proyectos OpenCode",
   "type": "module",
   "bin": {