zugzbot 1.1.2 → 1.1.3

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

@@ -99,6 +99,7 @@ Eres el Programador de Código (sdd-coder) del arnés SDD. Tu trabajo es codific
   - Usa siempre `router.replace("/")` en lugar de `push` para redirecciones de login.
   - Para evitar efectos concurrentes o solapados en Strict Mode, usa un `useRef(false)` en redirecciones asíncronas para dispararlas solo una vez.
   - En layouts protegidos por SSR, para evitar que parpadeen spinners o modales antes de hidratar la sesión en cliente, declara un estado `mounted` (`useEffect` asignando `setMounted(true)`) y retorna `null` si `!mounted`.
+- **Shadcn Sidebar + Tailwind v4 Fix (Bug Crítico)**: Si instalas el componente `sidebar` o bloques como `dashboard-01` que lo incluyen, debes parchear OBLIGATORIAMENTE el archivo `src/components/ui/sidebar.tsx` transformando la sintaxis arbitraria a explícita: `w-[--sidebar-width]` → `w-[var(--sidebar-width)]`, `w-[--sidebar-width-icon]` → `w-[var(--sidebar-width-icon)]` y `max-w-[--skeleton-width]` → `max-w-[var(--skeleton-width)]`. De lo contrario, el layout colapsará.
 - **Iconos**: Importa desde `lucide-react`. Usa `data-icon="inline-start"` para espaciados automáticos.
 </coding_cheatsheet>
 

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

@@ -51,6 +51,7 @@ Cualquier desarrollo de interfaz de usuario (Dashboards, Landings, Formularios,
   - Está estrictamente prohibido usar variables CSS puras directamente en `stroke` o `fill` de SVG si estas no son resueltas de forma dinámica. Si es necesario, utiliza una paleta de colores hexadecimales fija de alto contraste y compatible con ambos modos claro y oscuro (ej: `#0072f5` para líneas y barras, o una paleta de sectores sólida para PieCharts) que garantice legibilidad 100% en fondos claros y oscuros, manteniendo solo los ejes y rejillas de fondo (grids) referenciando variables semánticas.
 - **Evitar Solapamiento de Sidebar (Sidebar Overlap Prevention):**
   - Al implementar barras laterales colapsables de Shadcn (`Sidebar`), el Coder debe asegurarse de que el contenedor del contenido principal use de forma robusta `<SidebarInset>` o una estructura flexbox flexible (ej: `flex flex-1 flex-col`) que responda al estado del sidebar. Está estrictamente prohibido usar posicionamiento fijo o absoluto en el sidebar sin un espaciador o contenedor dinámico que evite que el sidebar se sobreponga al contenido en pantallas anchas.
+  - **Fix Crítico Tailwind v4 + Shadcn Sidebar**: La CLI de Shadcn inyecta clases arbitrarias con variables CSS directas (`w-[--sidebar-width]`, `w-[--sidebar-width-icon]`, `max-w-[--skeleton-width]`) que en Tailwind v4 generan CSS inválido (`width: --sidebar-width;` sin `var()`). El Coder **debe** parchear inmediatamente `src/components/ui/sidebar.tsx` transformando a sintaxis explícita: `w-[var(--sidebar-width)]`, `w-[var(--sidebar-width-icon)]`, `max-w-[var(--skeleton-width)]`. Sin este fix, el espaciador colapsa a 0px y el contenido principal se solapa bajo el sidebar fijo.
 - **Robustez HTML y Regla de No-Nesting en Triggers:**
   - Al utilizar componentes contenedores de Radix/Shadcn UI (como `TooltipTrigger`, `DropdownMenuTrigger`, `DialogTrigger`, `SheetTrigger`), está estrictamente PROHIBIDO anidar un elemento interactivo nativo (como `<button>` o `<a>`) directamente dentro de otro trigger que ya renderice un botón por defecto.
   - Para evitar la hidratación rota y HTML inválido, se debe usar siempre el prop `asChild` en el trigger de Radix o delegar los props correctamente usando las directivas del componente de base.

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

@@ -100,6 +100,16 @@ Para garantizar interfaces de usuario premium y visualmente idénticas a los dem
 **REGLA CRÍTICA DE RUTAS DUPLICADAS POR SHADCN CLI**:
 Al agregar un bloque interactivo complejo (como `dashboard-01`), el CLI de Shadcn puede inyectar automáticamente archivos en directorios fijos (como `src/app/dashboard/page.tsx`). El Coder **debe** verificar inmediatamente si existe una colisión con la estructura de rutas establecida por el contrato (`contract.json`) —por ejemplo, si el contrato establece un Route Group `src/app/(dashboard)/page.tsx` que sirve en la raíz `/`—. Si ocurre esto, el Coder tiene la obligación de **borrar, mover o refactorizar de inmediato el archivo inyectado automáticamente** para eliminar la duplicidad de rutas, evitando así bucles infinitos de redirección o errores fatales de compilación del router de Next.js.
 
+**REGLA CRÍTICA DE COMPATIBILIDAD TAILWIND V4 + SHADCN UI (Sidebar Overlap Fix)**:
+Al instalar componentes que usan `sidebar` (como `dashboard-01`, `sidebar-01` a `sidebar-16`, o el componente `sidebar` individual), la CLI de Shadcn inyecta código con sintaxis de variables CSS arbitrarias propias de Tailwind v3 (`w-[--sidebar-width]`, `w-[--sidebar-width-icon]`, `max-w-[--skeleton-width]`) que **rompen en Tailwind v4** generando CSS inválido (`width: --sidebar-width;` sin `var()`). Esto hace que el espaciador invisible del sidebar colapse a 0px, provocando que el contenido principal se solape bajo el sidebar fijo.
+
+**Acción obligatoria inmediata tras instalar**: El Coder debe parchear `src/components/ui/sidebar.tsx` en el mismo paso de instalación transformando:
+- `w-[--sidebar-width]` → `w-[var(--sidebar-width)]`
+- `w-[--sidebar-width-icon]` → `w-[var(--sidebar-width-icon)]`
+- `max-w-[--skeleton-width]` → `max-w-[var(--skeleton-width)]`
+
+Sin este fix, el dashboard renderizará con el sidebar tapando el contenido. Verificar con `npx tsc --noEmit` y comprobación visual tras la instalación.
+
 ### 3.2 Form Layouts (FieldGroup + Field)
 Para estructurar campos de formularios, no uses `div`s arbitrarios con clases de espaciado complejas. Usa las composiciones semánticas oficiales de Shadcn:
 ```tsx

package/.opencode/skills/stack-validator/SKILL.md

@@ -52,7 +52,7 @@ Para garantizar consistencia y escalabilidad en todos los proyectos, la estructu
 │   └── integration/            # Pruebas de integración
 ├── components.json             # Configuración Shadcn (style, registries, aliases)
 ├── package.json                # Dependencias frontend (incluye @radix-ui/*, class-variance-authority, clsx, tailwind-merge, lucide-react)
-└── tailwind.config.ts          # Configuración de TailwindCSS v4
+└── src/app/globals.css         # Configuración TailwindCSS v4 vía @theme inline (no existe tailwind.config.ts)
 ```
 
 ## Convenciones de Shadcn UI y Next.js (OBLIGATORIAS)

package/.opencode/templates/nextjs-shadcn/components.json

@@ -4,7 +4,6 @@
   "rsc": true,
   "tsx": true,
   "tailwind": {
-    "config": "tailwind.config.ts",
     "css": "src/app/globals.css",
     "baseColor": "zinc",
     "cssVariables": true,

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

package/package.json

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