zugzbot 1.1.5 → 1.1.7

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

@@ -85,13 +85,15 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
        - 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.
-    3. **Verificación de Servidor**:
+    3. **Micro-Fixes (Anti-Spec Spam)**: Si el usuario reporta un bug, un desajuste visual o pide una pequeña corrección sobre lo que acabas de entregar, **TIENES PROHIBIDO crear un nuevo spec en F1**. Debes mantener el estado actual en `activeContract`, transicionar/mantener a `F2_IMPLEMENTATION`, y delegar el arreglo al Coder. Solo crea nuevos specs en F1 si el usuario solicita una característica completamente nueva.
+    4. **Verificación de Servidor y HMR**:
        - **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):**
+         - Next.js y tu stack frontend usan **Hot Module Replacement (HMR)**. Queda ESTRICTAMENTE PROHIBIDO detener y reiniciar el servidor (`sdd_network_stop_server` / `start_server`) para comprobar cambios de interfaz, CSS o componentes. El servidor se actualiza solo en vivo. Únicamente reinicia el servidor si hubo cambios en `next.config.ts`, `tailwind.config`, o instalación de dependencias muy pesadas.
          - 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.
-    4. Transiciona a `F3_VERIFICATION` llamando a `sdd_set_phase`.
+    5. Transiciona a `F3_VERIFICATION` llamando a `sdd_set_phase`. **Bajo ninguna circunstancia te saltes la fase F3 después de que el Coder haya intervenido, incluso para micro-fixes visuales**.
   </f2_implementation>
 
   <f3_verification>
@@ -115,8 +117,9 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
   </f4_deployment>
 
   <rollbacks>
-    1. Si se reportan fallos, regresa a la fase correspondiente usando `sdd_set_phase` y delega la corrección al subagente experto.
+    1. Si se reportan fallos en tests o linter en F3, haz un rollback de la estructura y regresa a `F2_IMPLEMENTATION` usando `sdd_set_phase` y delega la corrección al subagente experto (`@sdd-coder`). Bajo ninguna circunstancia puedes usar la herramienta `edit` o `write` para arreglar código, ni siquiera en modo autopiloto.
     2. Si una misma fase falla más de 2 veces consecutivas, presenta el error al usuario con el contexto completo en vez de seguir intentando.
+    3. **Estado Corrupto**: Si detectas que el estado actual es `F2_IMPLEMENTATION` o superior, pero la propiedad `activeContract` está vacía o el archivo del contrato ya no existe, asume que la sesión previa se corrompió. Limpia el estado transicionando automáticamente a `F0_DETECT` antes de procesar el requerimiento del usuario.
   </rollbacks>
 
   <completion>

package/.opencode/skills/shadcn-templates/SKILL.md

@@ -152,8 +152,44 @@ El `@sdd-spec-writer` utiliza de manera proactiva el MCP `shadcn` (`shadcn_searc
 ### Fase F2 (Implementation)
 El `@sdd-coder` utiliza el template base `nextjs-shadcn`. Si el contrato no detalla todos los sub-componentes o el Coder necesita verificar el comportamiento de un bloque antes de acoplarlo con el backend, debe ejecutar `shadcn_get_item_examples_from_registries` para ver ejemplos funcionales del componente real. Tras ejecutar la instalación con `npx shadcn@latest add`, el Coder debe contrastar los archivos inyectados con el mapa del contrato y limpiar de inmediato cualquier archivo redundante (como una página de inicio duplicada) que no coincida con el router oficial.
 
-### Fase F3 (Verification)
-El `@sdd-tester` ejecuta las pruebas según el modo de verificación especificado en el contrato (`settings.verificationMode`):
-- Si es `"console"`, verifica la compilación correcta y la ausencia de errores de consola/hidratación en el navegador.
-- Si es `"visual"`, ejecuta tests de regresión visual de Playwright tomando capturas de pantalla para comprobar la responsividad del layout.
+## 5. Catálogo Externo Oficial: Shadcn UI Blocks (Akash)
+
+Además del catálogo nativo de Shadcn UI, dispones de acceso autónomo a más de 200 bloques de alta calidad del repositorio **Shadcn UI Blocks (por Akash)**. Si el usuario solicita una interfaz relacionada con landings, marketing, autenticación, footers o dashboards, **TIENES LA OBLIGACIÓN** de explorar este catálogo ANTES de proponer crear componentes desde cero.
+
+### 5.1 Flujo de Descubrimiento (Fase F1 - Spec-Writer)
+Si el usuario solicita una interfaz (ej: "necesito un hero", "haz un footer"), no asumas que debes programarlo a mano. Primero consulta la lista maestra de bloques en tiempo real:
+- **Comando a usar:** Ejecuta la herramienta `webfetch` apuntando a la API de GitHub:
+  `webfetch("https://api.github.com/repos/akash3444/shadcn-ui-blocks/contents/public/r/radix")`
+- **Análisis de resultados:** El JSON devuelto listará todos los bloques (`hero-01.json`, `footer-05.json`, `pricing-02.json`, etc.). Selecciona mentalmente los que coincidan con la necesidad.
+
+### 5.2 Selección de Bloques (Interactiva o Autónoma)
+Cuando existan múltiples opciones para un mismo tipo de bloque (ej. 10 footers distintos):
+- **Modo Asistido (Por defecto):** Utiliza la herramienta `question` para preguntarle al usuario o dile explícitamente en el chat: *"Tengo acceso a la galería de Shadcn UI Blocks. He encontrado X opciones de [categoria]. ¿Quieres que revise algunas en particular o te dejo el enlace visual (`https://www.shadcnui-blocks.com/blocks/categories/[categoria]`) para que elijas la que más te guste?"*.
+- **Modo Autopiloto (`/loop`):** Si estás actuando de forma 100% autónoma, lee el código fuente de 2 o 3 opciones al azar utilizando `webfetch("https://raw.githubusercontent.com/akash3444/shadcn-ui-blocks/main/public/r/radix/[bloque].json")` para analizar qué código encaja mejor con la petición y elígelo autónomamente sin preguntar.
+
+### 5.3 Inyección e Instalación (Contrato y Coder)
+- **Spec-Writer (F1):** En el `contract.json`, dentro de `frontend.components`, anota el bloque utilizando la URL remota directa:
+  ```json
+  "frontend": {
+    "components": [
+      "https://shadcnui-blocks.com/r/radix/footer-04.json"
+    ]
+  }
+  ```
+- **Coder (F2):** Para instalar estos bloques externos, utiliza la capacidad nativa de la CLI v3 de Shadcn. Ejecuta directamente el comando apuntando a la URL:
+  ```bash
+  npx shadcn@latest add https://shadcnui-blocks.com/r/radix/footer-04.json
+  ```
+  La CLI se encargará automáticamente de descargar el código y resolver dependencias internas.
+
+---
+
+## 6. Patrones Avanzados de Layout CSS
+
+### 6.1 Patrón de Fullscreen Layouts y Centrado (CRÍTICO)
+Cuando necesites crear un Hero, Landing, o Splash screen que deba ocupar el 100% de la pantalla visible y tener su contenido perfectamente centrado, evita mezclar clases CSS que peleen entre sí. Sigue **estrictamente** este patrón:
+- **Contenedor Padre**: Usa `min-h-[100dvh] flex flex-col`.
+- **Contenedor Interno (Wrapper)**: Usa `flex-1 flex items-center justify-center w-full`.
+- **Contenido Central**: Usa `mx-auto max-w-[ancho-deseado] flex flex-col items-center text-center`.
+- **PROHIBICIÓN ESTRICTA DE `w-full` EN FLEX HIJOS**: Si el contenedor padre usa `flex` con `items-center` para centrar, **NO** le pongas `w-full` al hijo interno si quieres que no se "pegue" a la izquierda en pantallas ultra anchas. El `w-full` forzará al elemento a ocupar el 100% del contenedor padre flex y anulará el centrado horizontal. Usa siempre `mx-auto` explícitamente en el elemento hijo para garantizar que quede centrado dentro de su propia columna.
 

package/.utils/export_opencode_session.py

@@ -9,7 +9,7 @@ DB_PATH = "/Users/wavesbyte/.local/share/opencode/opencode.db"
 
 # Escribe aquí el ID de la sesión que deseas exportar (ejemplo: "ses_1234...")
 # Si se deja vacío, el script requerirá el ID como argumento al ejecutarlo
-TARGET_SESSION_ID = "ses_1180"
+TARGET_SESSION_ID = "ses_117b"
 
 
 def format_timestamp(ts):

package/opencode.json

@@ -1,10 +1,17 @@
 {
   "$schema": "https://opencode.ai/config.json",
   "agent": {
+    "sdd-orchestrator": {
+      "permission": {
+        "edit": "deny",
+        "write": "deny",
+        "bash": "deny"
+      }
+    },
     "sdd-spec-writer": {
       "mode": "subagent",
       "permission": {
-        "webfetch": "deny"
+        "webfetch": "allow"
       },
       "model": "deepseek/deepseek-v4-flash"
     }

package/package.json

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