theus-cli 0.2.83 → 0.2.84

package/vendor/theus-arsenal/rules/web/design-quality.md

@@ -1,75 +0,0 @@
----
-paths:
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/*.sass"
-  - "**/*.less"
-  - "**/*.html"
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
----
-> Este archivo extiende [common/patterns.md](../common/patterns.md) con guía de calidad de diseño específica de web.
-
-# Estándares de calidad de diseño web
-
-## Política anti-plantilla
-
-No entregues interfaces genéricas con aspecto de plantilla. El resultado de frontend debe verse intencional, con criterio propio y específico del producto.
-
-### Patrones prohibidos
-
-- Grillas de tarjetas por defecto con espaciado uniforme y sin jerarquía
-- Sección hero de stock con titular centrado, blob con degradado y CTA genérico
-- Valores por defecto de librerías sin modificar presentados como diseño terminado
-- Layouts planos sin capas, profundidad ni movimiento
-- Radio, espaciado y sombras uniformes en todos los componentes
-- Estilo seguro de gris sobre blanco con un único color de acento decorativo
-- Dashboards "por receta" con sidebar + tarjetas + gráficos y sin punto de vista
-- Pilas de fuentes por defecto usadas sin una razón deliberada
-
-### Cualidades requeridas
-
-Toda superficie de frontend relevante debe demostrar al menos cuatro de estas cualidades:
-
-1. Jerarquía clara mediante contraste de escala
-2. Ritmo intencional en el espaciado, no padding uniforme en todas partes
-3. Profundidad o capas mediante superposición, sombras, superficies o movimiento
-4. Tipografía con carácter y una estrategia real de emparejamiento
-5. Color usado de forma semántica, no solo decorativa
-6. Estados hover, focus y active que se sientan diseñados
-7. Composición editorial o tipo bento que rompa la grilla cuando corresponda
-8. Textura, grano o atmósfera cuando encaje con la dirección visual
-9. Movimiento que aclare el flujo en vez de distraer
-10. Visualización de datos tratada como parte del sistema de diseño, no como un añadido de último momento
-
-## Antes de escribir código de frontend
-
-1. Elige una dirección de estilo específica. Evita valores vagos por defecto como "limpio y minimalista".
-2. Define una paleta con intención.
-3. Elige la tipografía deliberadamente.
-4. Reúne al menos un conjunto pequeño de referencias reales.
-5. Usa las skills de diseño/frontend de Theus cuando sean relevantes.
-
-## Direcciones de estilo que valen la pena
-
-- Editorial / revista
-- Neobrutalismo
-- Glassmorphism con profundidad real
-- Lujo oscuro o lujo claro con contraste disciplinado
-- Layouts bento
-- Scrollytelling
-- Integración 3D
-- Suizo / Internacional
-- Retrofuturismo
-
-No adoptes el modo oscuro por defecto de forma automática. Elige la dirección visual que el producto realmente pide.
-
-## Checklist de componentes
-
-- [ ] ¿Evita parecer una plantilla por defecto de Tailwind o shadcn?
-- [ ] ¿Tiene estados hover/focus/active intencionales?
-- [ ] ¿Usa jerarquía en vez de énfasis uniforme?
-- [ ] ¿Se vería creíble en una captura de pantalla de un producto real?
-- [ ] Si soporta ambos temas, ¿tanto el claro como el oscuro se sienten intencionales?

package/vendor/theus-arsenal/rules/web/hooks.md

@@ -1,141 +0,0 @@
----
-paths:
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/*.sass"
-  - "**/*.less"
-  - "**/*.html"
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
----
-> Este archivo extiende [common/hooks.md](../common/hooks.md) con recomendaciones de hooks específicas de web.
-
-# Hooks web
-
-## Hooks PostToolUse recomendados
-
-Prefiere las herramientas locales del proyecto. No conectes hooks a ejecuciones remotas puntuales de paquetes.
-
-### Formatear al guardar
-
-Usa el punto de entrada del formateador que ya tiene el proyecto después de cada edición:
-
-```json
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "command": "pnpm prettier --write \"$FILE_PATH\"",
-        "description": "Formatear los archivos de frontend editados"
-      }
-    ]
-  }
-}
-```
-
-Los comandos locales equivalentes vía `yarn prettier` o `npm exec prettier --` son válidos siempre que usen dependencias propias del repo.
-
-### Verificación de lint
-
-```json
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "command": "pnpm eslint --fix \"$FILE_PATH\"",
-        "description": "Ejecutar ESLint sobre los archivos de frontend editados"
-      }
-    ]
-  }
-}
-```
-
-### Verificación de tipos
-
-Usa `--incremental` para que las re-ejecuciones reutilicen el `.tsbuildinfo` anterior (1-3 s en código sin cambios en vez de 30-60 s cada vez). Envuélvelo en `timeout` para que un tsc atascado sea eliminado por el sistema operativo en lugar de acumularse entre ediciones — esto evita la acumulación de múltiples procesos que ocurre cuando las ediciones se disparan más rápido de lo que tsc termina.
-
-```json
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "command": "timeout 60 pnpm tsc --noEmit --pretty false --incremental --tsBuildInfoFile node_modules/.cache/tsc-hook.tsbuildinfo",
-        "description": "Verificar tipos tras editar frontend (incremental + con timeout)"
-      }
-    ]
-  }
-}
-```
-
-**Por qué importan ambos flags:**
-- Sin `--incremental`, cada edición vuelve a verificar el programa completo desde cero. En un proyecto Next.js real esto se acumula rápido: ediciones a intervalos de 5-10 s + ejecuciones de tsc de 30-60 s = N procesos tsc concurrentes.
-- Sin `timeout`, un tsc que se cuelga (cambio en una dependencia transitiva, verificador de tipos atascado en un tipo recursivo) nunca termina y queda huérfano cuando el shell padre finaliza.
-- `--tsBuildInfoFile` es obligatorio porque `--noEmit` normalmente suprime la escritura del buildinfo; especificar la ruta explícitamente mantiene el modo incremental funcionando.
-
-Si estás en Windows sin las coreutils de GNU, sustituye `timeout 60` por un wrapper de PowerShell o apóyate en un hook Stop/SessionEnd que barra los procesos tsc obsoletos.
-
-### Lint de CSS
-
-```json
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "command": "pnpm stylelint --fix \"$FILE_PATH\"",
-        "description": "Lintear las hojas de estilo editadas"
-      }
-    ]
-  }
-}
-```
-
-## Hooks PreToolUse
-
-### Vigilar el tamaño de archivo
-
-Bloquea escrituras sobredimensionadas a partir del contenido del tool input, no de un archivo que quizá aún no existe:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Write",
-        "command": "node -e \"let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const c=i.tool_input?.content||'';const lines=c.split('\\n').length;if(lines>800){console.error('[Hook] BLOQUEADO: el archivo supera las 800 líneas ('+lines+' líneas)');console.error('[Hook] Divídelo en módulos más pequeños');process.exit(2)}console.log(d)})\"",
-        "description": "Bloquear escrituras que superen las 800 líneas"
-      }
-    ]
-  }
-}
-```
-
-## Hooks Stop
-
-### Verificación final del build
-
-```json
-{
-  "hooks": {
-    "Stop": [
-      {
-        "command": "pnpm build",
-        "description": "Verificar el build de producción al final de la sesión"
-      }
-    ]
-  }
-}
-```
-
-## Orden
-
-Orden recomendado:
-1. formateo
-2. lint
-3. verificación de tipos
-4. verificación del build

package/vendor/theus-arsenal/rules/web/patterns.md

@@ -1,91 +0,0 @@
----
-paths:
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/*.sass"
-  - "**/*.less"
-  - "**/*.html"
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
----
-> Este archivo extiende [common/patterns.md](../common/patterns.md) con patrones específicos de web.
-
-# Patrones web
-
-## Composición de componentes
-
-### Componentes compuestos
-
-Usa componentes compuestos cuando piezas de UI relacionadas comparten estado y semántica de interacción:
-
-```tsx
-<Tabs defaultValue="overview">
-  <Tabs.List>
-    <Tabs.Trigger value="overview">Resumen</Tabs.Trigger>
-    <Tabs.Trigger value="settings">Configuración</Tabs.Trigger>
-  </Tabs.List>
-  <Tabs.Content value="overview">...</Tabs.Content>
-  <Tabs.Content value="settings">...</Tabs.Content>
-</Tabs>
-```
-
-- El padre es dueño del estado
-- Los hijos lo consumen vía context
-- Prefiere esto sobre el prop drilling para widgets complejos
-
-### Render props / slots
-
-- Usa render props o patrones de slots cuando el comportamiento es compartido pero el marcado debe variar
-- Mantén el manejo de teclado, ARIA y la lógica de foco en la capa headless
-
-### Separación contenedor / presentacional
-
-- Los componentes contenedores son dueños de la carga de datos y los efectos secundarios
-- Los componentes presentacionales reciben props y renderizan la UI
-- Los componentes presentacionales deben mantenerse puros
-
-## Gestión de estado
-
-Trata estos aspectos por separado:
-
-| Aspecto | Herramientas |
-|---------|--------------|
-| Estado del servidor | TanStack Query, SWR, tRPC |
-| Estado del cliente | Zustand, Jotai, signals |
-| Estado en la URL | search params, segmentos de ruta |
-| Estado de formularios | React Hook Form o equivalente |
-
-- No dupliques estado del servidor en stores del cliente
-- Deriva los valores en lugar de almacenar estado calculado redundante
-
-## La URL como estado
-
-Persiste en la URL el estado que deba poder compartirse:
-- filtros
-- orden de clasificación
-- paginación
-- pestaña activa
-- consulta de búsqueda
-
-## Obtención de datos
-
-### Stale-While-Revalidate
-
-- Devuelve los datos cacheados de inmediato
-- Revalida en segundo plano
-- Prefiere librerías existentes en lugar de implementarlo a mano
-
-### Actualizaciones optimistas
-
-- Toma un snapshot del estado actual
-- Aplica la actualización optimista
-- Revierte en caso de fallo
-- Emite feedback de error visible al revertir
-
-### Carga en paralelo
-
-- Obtén datos independientes en paralelo
-- Evita cascadas de peticiones padre-hijo
-- Precarga las rutas o estados siguientes más probables cuando esté justificado

package/vendor/theus-arsenal/rules/web/performance.md

@@ -1,76 +0,0 @@
----
-paths:
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/*.sass"
-  - "**/*.less"
-  - "**/*.html"
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
----
-> Este archivo extiende [common/performance.md](../common/performance.md) con contenido de rendimiento específico de web.
-
-# Reglas de rendimiento web
-
-## Objetivos de Core Web Vitals
-
-| Métrica | Objetivo |
-|---------|----------|
-| LCP | < 2.5s |
-| INP | < 200ms |
-| CLS | < 0.1 |
-| FCP | < 1.5s |
-| TBT | < 200ms |
-
-## Presupuesto de bundle
-
-| Tipo de página | Presupuesto JS (gzip) | Presupuesto CSS |
-|----------------|-----------------------|-----------------|
-| Landing page | < 150kb | < 30kb |
-| Página de app | < 300kb | < 50kb |
-| Microsite | < 80kb | < 15kb |
-
-## Estrategia de carga
-
-1. Inserta inline el CSS crítico above-the-fold cuando esté justificado
-2. Precarga solo la imagen del hero y la fuente principal
-3. Difiere el CSS o JS no crítico
-4. Importa dinámicamente las librerías pesadas
-
-```js
-const gsapModule = await import('gsap');
-const { ScrollTrigger } = await import('gsap/ScrollTrigger');
-```
-
-## Optimización de imágenes
-
-- `width` y `height` explícitos
-- `loading="eager"` más `fetchpriority="high"` solo para el medio del hero
-- `loading="lazy"` para recursos below-the-fold
-- Prefiere AVIF o WebP con fallbacks
-- Nunca sirvas imágenes fuente muy por encima del tamaño renderizado
-
-## Carga de fuentes
-
-- Máximo dos familias tipográficas salvo excepción clara
-- `font-display: swap`
-- Genera subconjuntos (subset) cuando sea posible
-- Precarga solo el peso/estilo verdaderamente crítico
-
-## Rendimiento de animaciones
-
-- Anima únicamente propiedades amigables con el compositor
-- Usa `will-change` de forma acotada y elimínalo al terminar
-- Prefiere CSS para transiciones simples
-- Usa `requestAnimationFrame` o librerías de animación consolidadas para el movimiento en JS
-- Evita la sobrecarga de handlers de scroll; usa IntersectionObserver o librerías de buen comportamiento
-
-## Checklist de rendimiento
-
-- [ ] Todas las imágenes tienen dimensiones explícitas
-- [ ] No hay recursos que bloqueen el renderizado por accidente
-- [ ] No hay desplazamientos de layout por contenido dinámico
-- [ ] El movimiento se mantiene en propiedades amigables con el compositor
-- [ ] Los scripts de terceros cargan async/defer y solo cuando se necesitan

package/vendor/theus-arsenal/rules/web/security.md

@@ -1,69 +0,0 @@
----
-paths:
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/*.sass"
-  - "**/*.less"
-  - "**/*.html"
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
----
-> Este archivo extiende [common/security.md](../common/security.md) con contenido de seguridad específico de web.
-
-# Reglas de seguridad web
-
-## Content Security Policy
-
-Configura siempre una CSP de producción.
-
-### CSP basada en nonce
-
-Usa un nonce por petición para los scripts en lugar de `'unsafe-inline'`.
-
-```text
-Content-Security-Policy:
-  default-src 'self';
-  script-src 'self' 'nonce-{RANDOM}' https://cdn.jsdelivr.net;
-  style-src 'self' 'unsafe-inline' https://fonts.googleapis.com;
-  img-src 'self' data: https:;
-  font-src 'self' https://fonts.gstatic.com;
-  connect-src 'self' https://*.example.com;
-  frame-src 'none';
-  object-src 'none';
-  base-uri 'self';
-```
-
-Ajusta los orígenes al proyecto. No copies este bloque tal cual sin adaptarlo.
-
-## Prevención de XSS
-
-- Nunca inyectes HTML sin sanitizar
-- Evita `innerHTML` / `dangerouslySetInnerHTML` salvo que se sanitice primero
-- Escapa los valores dinámicos de las plantillas
-- Sanitiza el HTML de usuario con un sanitizador local verificado cuando sea absolutamente necesario
-
-## Scripts de terceros
-
-- Cárgalos de forma asíncrona
-- Usa SRI cuando se sirvan desde un CDN
-- Audítalos trimestralmente
-- Prefiere alojar tú mismo las dependencias críticas cuando sea práctico
-
-## HTTPS y cabeceras
-
-```text
-Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
-X-Content-Type-Options: nosniff
-X-Frame-Options: DENY
-Referrer-Policy: strict-origin-when-cross-origin
-Permissions-Policy: camera=(), microphone=(), geolocation=()
-```
-
-## Formularios
-
-- Protección CSRF en los formularios que cambian estado
-- Rate limiting en los endpoints de envío
-- Valida en el cliente y en el servidor
-- Prefiere honeypots o controles antiabuso ligeros en lugar de CAPTCHAs pesados por defecto

package/vendor/theus-arsenal/rules/web/testing.md

@@ -1,67 +0,0 @@
----
-paths:
-  - "**/*.css"
-  - "**/*.scss"
-  - "**/*.sass"
-  - "**/*.less"
-  - "**/*.html"
-  - "**/*.tsx"
-  - "**/*.jsx"
-  - "**/*.vue"
-  - "**/*.svelte"
----
-> Este archivo extiende [common/testing.md](../common/testing.md) con contenido de testing específico de web.
-
-# Reglas de testing web
-
-## Orden de prioridad
-
-### 1. Regresión visual
-
-- Captura pantallas en los breakpoints clave: 320, 768, 1024, 1440
-- Prueba las secciones hero, las secciones de scrollytelling y los estados significativos
-- Usa capturas de Playwright para trabajo con fuerte carga visual
-- Si existen ambos temas, prueba ambos
-
-### 2. Accesibilidad
-
-- Ejecuta verificaciones de accesibilidad automatizadas
-- Prueba la navegación por teclado
-- Verifica el comportamiento con movimiento reducido (reduced motion)
-- Verifica el contraste de color
-
-### 3. Rendimiento
-
-- Ejecuta Lighthouse o equivalente sobre las páginas relevantes
-- Mantén los objetivos de CWV de [performance.md](performance.md)
-
-### 4. Multinavegador
-
-- Mínimo: Chrome, Firefox, Safari
-- Prueba el scroll, el movimiento y el comportamiento de los fallbacks
-
-### 5. Responsive
-
-- Prueba 320, 375, 768, 1024, 1440, 1920
-- Verifica que no haya desbordamientos (overflow)
-- Verifica las interacciones táctiles
-
-## Forma de los E2E
-
-```ts
-import { test, expect } from '@playwright/test';
-
-test('el hero de la landing carga', async ({ page }) => {
-  await page.goto('/');
-  await expect(page.locator('h1')).toBeVisible();
-});
-```
-
-- Evita aserciones inestables basadas en timeouts
-- Prefiere esperas deterministas
-
-## Tests unitarios
-
-- Prueba utilidades, transformaciones de datos y hooks personalizados
-- Para componentes muy visuales, la regresión visual suele aportar más señal que aserciones frágiles sobre el marcado
-- La regresión visual complementa los objetivos de cobertura; no los reemplaza