zugzbot 1.7.0 → 1.8.0

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

@@ -65,11 +65,40 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
     4. **Autopiloto (/loop)**:
        - Si el usuario especificó `/loop N` o `iteraciones=N`, autoselecciona Next.js 16, Console mode, y el diseño `default` nativo.
        - Transiciona atómicamente a F1 con `sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "<nombre-kebab>", loopMode: true, loopTargetIterations: N, loopCurrentIteration: 1 })`.
-    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 = `default` nativo.
-       - Si llegas a preguntar, hazlo solo sobre `verificationMode` (Console vs Visual).
-       - Luego, transiciona con `sdd_set_phase` a `F1_CONTRACT`.
+   5. **Normal (HIL) — Interrogatorio Secuencial (5 preguntas)**: Si NO se detectó Fast-Track Dashboard NI `/loop`, ejecuta un wizard de 5 pasos usando llamadas separadas a `question` (1 por paso). Cada respuesta informa al siguiente paso. **REGLA DURA**: SOLO una pregunta por llamada a `question`. PROHIBIDO hacer arrays de múltiples preguntas en `questions: [...]` — causa errores de JSON parsing con caracteres especiales.
+      - **Defaults razonables** (si el usuario no sabe o aborta): Stack = Next.js 16 + Shadcn UI, Persistencia = localStorage/mock, Diseño = `default` zinc nativo, Track = SDD, Verificación = Console.
+      - **Mecanismo de salida rápida**: el usuario puede escribir "default", "skip" o "recomienda" en cualquier paso y saltas al siguiente asumiendo el default recomendado.
+
+      **5.1 PROPÓSITO** (libre + categorías sugeridas):
+      - Pregunta: *"¿Qué quieres construir? Descríbelo en 1-2 frases."*
+      - Opciones sugeridas (con descripciones cortas): Landing/Marketing, Dashboard/App interna, E-commerce, API/Backend, Script/Tooling, Otro.
+      - **Guarda la respuesta** internamente; se usará para guiar las recomendaciones de stack (5.3) y diseño (5.4).
+
+      **5.2 TRACK (Fast vs SDD)**:
+      - Pregunta: *"¿Modo Fast (1 turno directo, sin contratos/tests/docker) o SDD completo (F0→F4 con contratos, tests y deploy)?"*
+      - Recomendación: **SDD** si el alcance implica >1 componente, persistencia, o deploy; **Fast** solo para micro-fixes triviales o scripts puntuales.
+      - Si elige **Fast** → delega a `@sdd-coder` directamente, llama `sdd_set_phase({ phase: "F2_IMPLEMENTATION", skip_lint_gate: true })` saltando F1/F3/F4, y termina el flujo SDD para esta sesión.
+
+      **5.3 STACK (con recomendaciones priorizadas)**:
+      - Si `sdd_get_initial_session_data` ya reportó `state.stack.core.length > 0` (bootstrap previo) → pregunta: *"Detecté stack existente `[X, Y]`. ¿Lo mantenemos o cambiamos?"*
+      - Si NO hay stack detectado → ofrece top-3 priorizados en este orden:
+        1. **Next.js 16 + Shadcn UI + Tailwind v4** (recomendado para frontend/landing/dashboard).
+        2. **FastAPI + Pydantic + Uvicorn** (recomendado para backend/API).
+        3. **Stack existente en el repo / Agnóstico** (scripts sin UI, Bash, Apps Script, etc.).
+      - Marca con "(Recomendado)" la primera opción.
+
+      **5.4 DISEÑO (con preview_url del catálogo unificado)**:
+      - Si la detección 2.5 ya trajo keywords de catálogo → reutiliza esos resultados (ya traen `preview_url`).
+      - Si NO se detectaron keywords → llama `sdd_catalog_list_blocks({ registry: "all", limit: 5 })` y presenta los top-3 con: nombre, registry (`shadcn`/`basecn`/`reactbits`/`blocks-so`), descripción corta de 1 línea, **`preview_url`** y `install_command`.
+      - **OBLIGATORIO**: incluir SIEMPRE el `preview_url` en la respuesta para que el usuario vea el demo en su navegador antes de elegir. Para reactbits el demo es animado; para blocks.so es live en `https://blocks.so/<category>/<name>`.
+      - Opción final: **"default zinc nativo"** (omite catálogo y usa el tema base del template `nextjs-shadcn`).
+      - Si el usuario eligió un bloque → el spec-writer lo inyectará en `sdd_hints.blocks_to_install[]` del contrato.
+
+      **5.5 VERIFICACIÓN (Console vs Visual)**:
+      - Pregunta: *"¿Verificación Console (5x más rápido, sin Playwright) o Visual (screenshots en `.openspec/ts-*.png` y tests E2E)?"*
+      - Recomendado: **Console** salvo que sea landing pública, portfolio, o el usuario quiera ver el resultado visualmente antes de cerrar.
+
+      **Cierre del wizard**: tras las 5 respuestas (o defaults), llama a `sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "<kebab>", coreStack: [...], databases: [...] })` con los valores inferidos de 5.3. La respuesta de 5.4 se inyectará en `sdd_hints.design_choice` para que el spec-writer la consulte.
   </f0_detect>
 
   <f1_contract>

package/.opencode/commands/loop.md

@@ -10,6 +10,7 @@ Estás ejecutando el ciclo SDD en modo **Autopiloto Autónomo** para resolver la
 > $ARGUMENTS
 
 ## Instrucciones de Autopiloto Obligatorias:
+0. **Bypass total del wizard F0**: este modo bypasea las 5 preguntas secuenciales de F0 (Propósito → Track → Stack → Diseño → Verificación) y salta directo a F1 asumiendo todos los defaults recomendados. El `loop-enforcer` plugin bloquea mecánicamente cualquier intento de usar `question` en este modo.
 1. Activa inmediatamente el modo piloto en el estado llamando a `sdd_set_phase` pasándole `phase: "F1_CONTRACT"`, un `spec_name` descriptivo en kebab-case, `loopMode: true`, `loopTargetIterations: N` (si el usuario ingresó un número en su comando, ej: `/loop 3` o `iteraciones=3`; por defecto 1), y `loopCurrentIteration: 1`.
 2. Tienes estrictamente prohibido usar la herramienta `question` para pedir confirmaciones de diseño, stack o contratos.
 3. Elige los valores recomendados por defecto de forma autónoma (Next.js 16, Console mode, diseño `shadcn-zinc` nativo del template).

package/.opencode/skills/sdd-foundation-overview/SKILL.md

@@ -40,14 +40,14 @@ F4 → deployer genera Dockerfile + build + verify
 ## Reglas duras
 
 1. **Coordinación pura**: el orquestador NO escribe/edita código. Solo delega vía `task`.
-2. **Una pregunta por sesión**: solo Console vs Visual en F0. Todo lo demás por default.
+2. **Hasta 5 preguntas SECUENCIALES en F0 (HIL)**: Propósito → Track (Fast/SDD) → Stack (con recomendaciones priorizadas) → Diseño (con `preview_url` del catálogo unificado) → Verificación (Console/Visual). Cada paso es 1 llamada separada a `question` (PROHIBIDO arrays múltiples — causa errores JSON). `/loop` y Fast-Track Dashboard bypasean TODAS las preguntas y asumen defaults. El usuario puede escribir `default`/`skip`/`recomienda` en cualquier paso para aceptar el default y continuar.
 3. **Fast-Track Dashboard**: si el usuario pide dashboard/admin/panel → usar `@shadcn/dashboard-01` directamente sin preguntar más.
 4. **Brain obligatorio**: save 1-3 lecciones al cerrar cada sesión, read learnings+errors en F0.
 5. **Tests con assertions reales**: nunca stubs con `expect(true).toBe(true)`.
 
 ## Métricas objetivo de una sesión
 
-- F0: 1 ronda de `question` con 1 sola decisión
+- F0 HIL: hasta 5 rondas de `question` (Propósito → Track → Stack → Diseño → Verificación); 0 rondas si `/loop` o Fast-Track Dashboard
 - F1: contract.json 80-120 líneas, 3-5 test_scenarios
 - F2: self-audit limpio en 1 intento
 - F3: lint + tests verdes en 1 intento

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_1174"
+TARGET_SESSION_ID = "ses_1130"
 
 
 def format_timestamp(ts):

package/package.json

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