zugzbot 1.0.41 → 1.0.43

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

@@ -3,7 +3,7 @@ description: Implementa código ajustándose estrictamente a los contratos en sp
 mode: subagent
 hidden: true
 steps: 10
-model: google/gemini-3.5-flash
+model: deepseek/deepseek-v4-flash
 temperature: 0.35
 frequency_penalty: 0.5
 presence_penalty: 0.2

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

@@ -2,7 +2,7 @@
 description: Limpia Docker y realiza el despliegue local del sistema
 mode: subagent
 hidden: true
-model: google/gemini-3.5-flash
+model: deepseek/deepseek-v4-flash
 temperature: 0.1
 tools:
   write: true

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

@@ -1,7 +1,7 @@
 ---
 description: Coordinador principal del flujo SDD y del stack cerrado
 mode: primary
-model: google/gemini-3.5-flash
+model: deepseek/deepseek-v4-flash
 temperature: 0.1
 tools:
   write: false

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

@@ -2,7 +2,7 @@
 description: Realiza una auditoría/revisión de código contra el contrato y el linter
 mode: subagent
 hidden: false
-model: google/gemini-3.5-flash
+model: deepseek/deepseek-v4-flash
 temperature: 0.1
 tools:
   write: false

package/.opencode/agents/sdd-spec-writer.md

@@ -2,7 +2,7 @@
 description: Redacta y valida contratos OpenAPI e interfaces en specs/
 mode: subagent
 hidden: true
-model: google/gemini-3.5-flash
+model: deepseek/deepseek-v4-flash
 temperature: 0.1
 tools:
   write: true

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

@@ -3,7 +3,7 @@ description: Diseña y corre pruebas unitarias, integración y visuales (Playwri
 mode: subagent
 hidden: true
 steps: 15
-model: google/gemini-3.5-flash
+model: deepseek/deepseek-v4-flash
 temperature: 0.35
 frequency_penalty: 0.5
 presence_penalty: 0.2

package/.opencode/rules/sdd-global.md

@@ -26,7 +26,9 @@ Cuando el estado del sistema tiene `loopMode === true` (activado mediante el com
 Para optimizar el tiempo de desarrollo, garantizar una experiencia visual premium y evitar la invención de layouts o formularios comunes desde cero:
 - **Prioridad de Bloques**: Al diseñar cualquier interfaz de usuario (Layouts, Dashboards, Paneles de Control, Vistas de Configuración, Páginas de Autenticación, Tablas de Datos, Gráficos), los agentes **deben** buscar y utilizar de forma prioritaria los bloques prehechos del registro oficial `@shadcn` (como `dashboard-01`, `sidebar-01` al `16`, `login-01` al `05`, `signup-01` al `05`).
 - **Búsqueda Proactiva**: El Spec-Writer **debe** consultar el registro utilizando las herramientas del MCP `shadcn` (`shadcn_search_items_in_registries`, `shadcn_list_items_in_registries`) al redactar el contrato (F1) para identificar qué bloques se ajustan a la necesidad, y declararlos en `frontend.components` y `files_affected` de `contract.json`. Además, el Spec-Writer **debe** invocar `shadcn_view_items_in_registries` sobre los bloques complejos seleccionados para inspeccionar por adelantado sus archivos, rutas y dependencias inyectadas por defecto, anticipando cualquier colisión de ruteo y documentándolo con precisión en el contrato.
-- **Inyección Zero-Touch y Migración Física en Fase A**: El Coder (F2) **debe** instalar el bloque usando `npx shadcn@latest add <block-name>`. Los archivos se descargarán en `src/components/blocks/<block-name>/`. Queda **estrictamente prohibido** importar el `page.tsx` del bloque como un simple componente hijo (ej: `return <BlockPage />` desde la raíz de la app), ya que esto rompe el router, layouts y metadata de Next.js. El Coder debe **copiar íntegramente el contenido del código** de `src/components/blocks/<block-name>/page.tsx` hacia el `page.tsx` de la ruta destino, y **reescribir todos los imports relativos** de componentes y datos locales (ej. `./components/...` o `./data.json`) para usar aliases absolutos que apunten a la ruta física descargada por Shadcn (ej. `@/components/blocks/<block-name>/components/...` o `@/components/blocks/<block-name>/data.json`). El archivo de datos locales `data.json` debe preservarse e importarse para garantizar un renderizado visual clonado perfecto.
+- **Inyección Zero-Touch y Preservación del Bloque en Fase A (MANDATORIO)**: El Coder (F2) **debe** instalar el bloque usando `npx shadcn@latest add <block-name>`. La CLI inteligente de Shadcn colocará automáticamente el archivo de página (ej. `src/app/dashboard/page.tsx` o `src/app/page.tsx`) y los componentes y datos locales asociados (ej. `src/components/` o `src/app/dashboard/data.json`) en las carpetas de producción correctas listas para renderizar.
+  - **No realizar migraciones físicas o reescrituras de imports artificiales**: Si la CLI ya colocó los archivos en sus rutas funcionales de producción de manera nativa, queda **estrictamente prohibido** mover los archivos a carpetas artificiales (como `src/components/blocks/...`) o reescribir sus imports usando alias complejos. Esto rompe la integración de Shadcn y destruye la sincronización de estilos y gráficos en modo oscuro. ¡Conserva el esqueleto tal como lo instala la CLI!
+  - **Preservación de Datos Dummy**: El archivo de datos del bloque (por ejemplo, `data.json` o constantes locales) debe mantenerse intacto en su ruta inyectada por la CLI en esta Fase A para garantizar que la vista se muestre de inmediato en el navegador exactamente idéntica al demo real.
 - **Sustitución Atómica de Datos en Fase B**: Una vez que el bloque compila e interactúa en el navegador de manera idéntica al demo con los datos de ejemplo, el Coder procederá de forma exclusiva a sustituir los datos mock por lógica y fetchings de datos dinámicos del backend, manteniendo intactos los contenedores estructurales del bloque (grids de diseño, paddings y contenedores flex) sin alteración alguna para evitar aberraciones visuales.
 - **Resolución Activa de Conflictos de Ruteo por Inyección de Bloques**: Si la CLI de Shadcn inyecta automáticamente una estructura de rutas (ej: `src/app/dashboard/page.tsx`) que compite con las rutas del contrato (como un route group `(dashboard)` o una ruta raíz), el Coder **debe** borrar o refactorizar de inmediato el código inyectado por defecto para evitar bucles de redirección infinitos o colisiones en el router.
 
@@ -72,3 +74,9 @@ Para optimizar el diseño, evitar cambios de arquitectura estructurales a mitad
 Para mantener la limpieza y disciplina en la ventana de contexto de la sesión:
 - **Orquestador No-Coder:** El orquestador principal (`sdd-orchestrator`) tiene estrictamente prohibido usar herramientas de edición (`edit` o `write`) para modificar código de producción o archivos de test.
 - **Rollback Disciplinado:** Si en la fase `F3_VERIFICATION` el linter o los tests reportan errores, el orquestador **debe** transicionar el estado a `F2_IMPLEMENTATION` mediante `sdd_core_set_phase` y re-invocar al subagente experto (`sdd-coder`) para que realice la corrección cleanly. No se permiten parches rápidos a mitad de fase de test.
+
+## 9. Segmentación de Specs y Compilación Atómica (Evitar Coder-Exhaustion)
+Para evitar que los subagentes se queden sin pasos (step/token exhaustion) o acumulen errores difíciles de depurar al final de la sesión:
+- **Regla de Micro-Specs:** Si una funcionalidad requiere implementar múltiples vistas complejas o formularios densos, el Spec-Writer **debe** dividirla obligatoriamente en specs incrementales secuenciales de máximo 3 componentes principales por contrato. No intentes implementar todo un panel de administración en una sola iteración de contrato.
+- **Compilación Atómica:** El Coder **debe** implementar y compilar exitosamente cada archivo de forma individual antes de escribir el siguiente. Está estrictamente prohibido escribir todos los componentes de golpe sin ejecutar validaciones intermedias de TypeScript (`tsc --noEmit`).
+- **Verificación Temprana de Dependencias:** El Coder **debe** comprobar en el primer paso de F2 que dependencias de pruebas críticas como `@testing-library/dom` estén correctamente instaladas en proyectos React 19 para evitar fallos intermitentes de tipado en Vitest.

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

@@ -77,12 +77,11 @@ Utiliza las plantillas y bloques existentes de Shadcn como el estándar absoluto
 
 Para garantizar interfaces de usuario premium y visualmente idénticas a los demos oficiales de Shadcn, se debe seguir de manera mandatoria la **Metodología de Arquitectura Block-First**:
 
-1. **El Bloque es el Esqueleto Absoluto (Fase A - Inyección Pura y Migración Física)**:
+1. **El Bloque es el Esqueleto Absoluto (Fase A - Inyección Pura y Preservación de Estructura)**:
    - El Coder (F2) **debe** instalar el bloque de Shadcn correspondiente mediante la CLI (`npx shadcn@latest add <block-name>`).
-   - El bloque se descargará en `src/components/blocks/<block-name>/`. El Coder tiene **estrictamente prohibido** importar el `page.tsx` del bloque como un simple componente hijo (ej: `return <BlockPage />` desde la raíz de la app), ya que esto rompe la estructura del router de Next.js, layouts y metadata.
-   - **Acción Obligatoria**: El Coder debe **copiar el contenido íntegro del código** de `src/components/blocks/<block-name>/page.tsx` hacia el `page.tsx` de tu ruta destino (por ejemplo, `src/app/page.tsx` o `src/app/dashboard/page.tsx`).
-   - **Corrección de Imports de forma Manual**: Al mover el código de la ruta de componentes al App Router de Next.js, los imports relativos en ese archivo se romperán. El Coder tiene la obligación de **reescribir todos los imports relativos de componentes e información locales** (ej. `./components/app-sidebar` o `./data.json`) para usar aliases absolutos que apunten a la ubicación física descargada por Shadcn (ej. `@/components/blocks/<block-name>/components/app-sidebar` o `@/components/blocks/<block-name>/data.json`).
-   - **Preservación de Datos Mock/Dummy**: El archivo de datos del bloque (por ejemplo, `data.json` o constantes internas) **debe ser preservado e importado de manera intacta** durante esta Fase A para garantizar que la vista renderice con datos idénticos al demo original en el navegador.
+   - La CLI de Shadcn colocará automáticamente la página del bloque (ej: `src/app/dashboard/page.tsx`) y los componentes y datos asociados en las ubicaciones de producción correctas de tu proyecto.
+   - **Acción Obligatoria / Prohibición de Migración**: Queda **estrictamente prohibido** mover los archivos del bloque a carpetas artificiales (como `src/components/blocks/...`) o reescribir manualmente sus imports si la CLI ya los ha ubicado en sus posiciones funcionales definitivas. Esto evita errores sutiles de compilación, rotura de imports y degradación de los estilos de modo oscuro en gráficos de Recharts.
+   - **Preservación de Datos Mock/Dummy**: El archivo de datos del bloque (por ejemplo, `data.json` o constantes locales) **debe ser preservado e importado de manera intacta en su ruta nativa** durante esta Fase A para garantizar que la vista renderice con datos idénticos al demo original en el navegador.
    - **Meta**: Al terminar la Fase A, la aplicación debe renderizarse de manera *pixel-perfect* (idéntica) al demo oficial de Shadcn en local, sin un solo error de compilación o de imports rotos.
 
 2. **Sustitución de Datos Atómica (Fase B - Conexión de Lógica)**:

package/.opencode/tools/sdd_bootstrap.ts

@@ -99,6 +99,59 @@ function detectPythonPackageManager(root: string): "uv" | "pip" {
   }
 }
 
+const DEFAULT_PACKAGE_JSON = {
+  "name": "nextjs-shadcn-sdd",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "next": "^15.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "lucide-react": "^0.468.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.5.5",
+    "class-variance-authority": "^0.7.1",
+    "recharts": "^2.15.0",
+    "next-themes": "^0.4.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "@types/node": "^20.17.9",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
+    "tailwindcss": "^4.0.0-alpha.30",
+    "@tailwindcss/postcss": "^4.0.0-alpha.30",
+    "postcss": "^8.4.49",
+    "eslint": "^9.16.0",
+    "eslint-config-next": "^15.1.0",
+    "vitest": "^2.1.8",
+    "@vitejs/plugin-react": "^4.3.4",
+    "jsdom": "^25.0.1",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/dom": "^10.4.0"
+  }
+}
+
+const getTemplatePackageJson = (templateDir: string): any => {
+  const tmplPkgPath = path.join(templateDir, "package.json")
+  if (fs.existsSync(tmplPkgPath)) {
+    try {
+      return JSON.parse(fs.readFileSync(tmplPkgPath, "utf8"))
+    } catch {
+      // ignore
+    }
+  }
+  return DEFAULT_PACKAGE_JSON
+}
+
 // Tool: sdd_bootstrap_status
 export const bootstrap_status = tool({
   description: "Reporta el estado de bootstrap del proyecto.",
@@ -141,6 +194,8 @@ export const bootstrap_status = tool({
   }
 })
 
+export const status = bootstrap_status
+
 // Tool: sdd_bootstrap_nextjs_shadcn
 export const bootstrap_nextjs_shadcn = tool({
   description: "Inicializa un proyecto Next.js 16 + Shadcn UI + Tailwind v4 + Vitest.",
@@ -206,10 +261,11 @@ export const bootstrap_nextjs_shadcn = tool({
 
     const userPkgPath = path.resolve(targetPath, "package.json")
     let mergedPkg: any = null
+    const tmplPkg = getTemplatePackageJson(templateDir)
+
     if (fs.existsSync(userPkgPath) && !args.force) {
       try {
         const userPkg = JSON.parse(fs.readFileSync(userPkgPath, "utf8"))
-        const tmplPkg = JSON.parse(fs.readFileSync(path.join(templateDir, "package.json"), "utf8"))
         for (const key of ["dependencies", "devDependencies", "peerDependencies"]) {
           if (tmplPkg[key]) {
             userPkg[key] = { ...tmplPkg[key], ...(userPkg[key] || {}) }
@@ -220,10 +276,12 @@ export const bootstrap_nextjs_shadcn = tool({
         fs.writeFileSync(userPkgPath, JSON.stringify(userPkg, null, 2), "utf8")
         filesCopied.push("package.json (merged)")
       } catch (e) {
-        copyFileSafe("package.json")
+        fs.writeFileSync(userPkgPath, JSON.stringify(tmplPkg, null, 2), "utf8")
+        filesCopied.push("package.json")
       }
     } else {
-      copyFileSafe("package.json")
+      fs.writeFileSync(userPkgPath, JSON.stringify(tmplPkg, null, 2), "utf8")
+      filesCopied.push("package.json")
     }
 
     const userNextConfig = path.resolve(targetPath, "next.config.ts")
@@ -266,6 +324,28 @@ export const bootstrap_nextjs_shadcn = tool({
     ]
     for (const f of standardFiles) copyFileSafe(f)
 
+    if (targetDir !== ".") {
+      const configFiles = [
+        "tsconfig.json",
+        "vitest.config.ts",
+        "components.json",
+        "next.config.ts",
+        "eslint.config.mjs",
+        "postcss.config.mjs",
+      ]
+      for (const file of configFiles) {
+        const rootFile = path.resolve(root, file)
+        if (fs.existsSync(rootFile)) {
+          try {
+            fs.unlinkSync(rootFile)
+            filesCopied.push(`${file} (cleaned from root)`)
+          } catch {
+            // ignore
+          }
+        }
+      }
+    }
+
     const pm = detectPackageManager(targetPath)
 
     let installDuration = 0

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

package/opencode.json

@@ -6,7 +6,7 @@
       "permission": {
         "webfetch": "deny"
       },
-      "model": "google/gemini-3.5-flash"
+      "model": "deepseek/deepseek-v4-flash"
     }
   },
   "permission": {
@@ -43,7 +43,7 @@
         "./.opencode/oh-my-design/packages/mcp/dist/index.mjs"
       ],
       "enabled": true,
-      "purpose": "Busca, consulta y aplica temas de dise\u00f1o (Toss, Stripe, Supabase, etc.)."
+      "purpose": "Busca, consulta y aplica temas de diseño (Toss, Stripe, Supabase, etc.)."
     },
     "shadcn": {
       "type": "local",
@@ -76,7 +76,7 @@
         "--isolated"
       ],
       "enabled": true,
-      "purpose": "Ejecuta pruebas de regresi\u00f3n visual y capturas de pantalla de Playwright."
+      "purpose": "Ejecuta pruebas de regresión visual y capturas de pantalla de Playwright."
     },
     "next-devtools": {
       "type": "local",

package/package.json

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