theus-cli 0.2.83 → 0.2.85

package/vendor/theus-arsenal/commands/build-kotlin.md

@@ -1,176 +0,0 @@
----
-description: Corrige incrementalmente errores de build de Kotlin/Gradle, advertencias del compilador y problemas de dependencias. Invoca al agente resolutor-builds-kotlin para arreglos mínimos y quirúrgicos.
----
-
-# Build y corrección de Kotlin
-
-Este comando invoca al agente **resolutor-builds-kotlin** para corregir incrementalmente errores de build de Kotlin con cambios mínimos.
-
-## Qué hace este comando
-
-1. **Ejecutar diagnósticos**: correr `./gradlew build`, `detekt`, `ktlintCheck`
-2. **Parsear errores**: agrupar por archivo y ordenar por severidad
-3. **Corregir incrementalmente**: un error a la vez
-4. **Verificar cada arreglo**: reejecutar el build tras cada cambio
-5. **Informar el resumen**: mostrar qué se corrigió y qué queda pendiente
-
-## Cuándo usarlo
-
-Usa `/build-kotlin` cuando:
-
-- `./gradlew build` falla con errores
-- El compilador de Kotlin reporta errores
-- `./gradlew detekt` reporta violaciones
-- Falla la resolución de dependencias de Gradle
-- Después de traer cambios (pull) que rompen el build
-
-## Comandos de diagnóstico ejecutados
-
-```bash
-# Verificación principal del build
-./gradlew build 2>&1
-
-# Análisis estático
-./gradlew detekt 2>&1 || echo "detekt no configurado"
-./gradlew ktlintCheck 2>&1 || echo "ktlint no configurado"
-
-# Problemas de dependencias
-./gradlew dependencies --configuration runtimeClasspath 2>&1 | head -100
-
-# Refresco profundo opcional cuando las cachés o los metadatos de dependencias son sospechosos
-./gradlew build --refresh-dependencies
-```
-
-## Sesión de ejemplo
-
-````text
-Usuario: /build-kotlin
-
-Agente:
-# Resolución de build de Kotlin
-
-## Diagnóstico inicial
-
-```bash
-$ ./gradlew build
-e: src/main/kotlin/com/example/service/UserService.kt:25:15 Unresolved reference: UserRepository
-e: src/main/kotlin/com/example/routes/UserRoutes.kt:42:9 Type mismatch: inferred type is String but Int was expected
-e: src/main/kotlin/com/example/routes/UserRoutes.kt:58:5 'when' expression must be exhaustive
-```
-
-Errores encontrados: 3
-
-## Arreglo 1: referencia sin resolver
-
-Archivo: src/main/kotlin/com/example/service/UserService.kt:25
-Error: Unresolved reference: UserRepository
-Causa: falta el import
-
-```kotlin
-// Import agregado
-import com.example.repository.UserRepository
-```
-
-```bash
-$ ./gradlew build
-# Quedan 2 errores
-```
-
-## Arreglo 2: incompatibilidad de tipos
-
-Archivo: src/main/kotlin/com/example/routes/UserRoutes.kt:42
-Error: Type mismatch: inferred type is String but Int was expected
-
-```kotlin
-// Se cambió
-val count = call.parameters["count"]
-// Por
-val count = call.parameters["count"]?.toIntOrNull()
-    ?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid count")
-```
-
-```bash
-$ ./gradlew build
-# Queda 1 error
-```
-
-## Arreglo 3: `when` no exhaustivo
-
-Archivo: src/main/kotlin/com/example/routes/UserRoutes.kt:58
-Error: 'when' expression must be exhaustive
-
-```kotlin
-// Rama faltante agregada
-when (user.role) {
-    Role.ADMIN -> handleAdmin(user)
-    Role.USER -> handleUser(user)
-    Role.MODERATOR -> handleModerator(user) // Agregado
-}
-```
-
-```bash
-$ ./gradlew build
-# ¡Build exitoso!
-```
-
-## Verificación final
-
-```bash
-$ ./gradlew detekt
-# Sin problemas
-
-$ ./gradlew test
-# Todas las pruebas pasaron
-```
-
-## Resumen
-
-| Métrica | Cantidad |
-|---------|----------|
-| Errores de build corregidos | 3 |
-| Problemas de detekt corregidos | 0 |
-| Archivos modificados | 2 |
-| Problemas restantes | 0 |
-
-Estado del build: CORRECTO
-````
-
-## Errores comunes corregidos
-
-| Error | Arreglo típico |
-|-------|----------------|
-| `Unresolved reference: X` | Agregar import o dependencia |
-| `Type mismatch` | Corregir la conversión de tipos o la asignación |
-| `'when' must be exhaustive` | Agregar las ramas faltantes de la clase sellada |
-| `Suspend function can only be called from coroutine` | Agregar el modificador `suspend` |
-| `Smart cast impossible` | Usar un `val` local o `let` |
-| `None of the following candidates is applicable` | Corregir los tipos de los argumentos |
-| `Could not resolve dependency` | Corregir la versión o agregar el repositorio |
-
-## Estrategia de corrección
-
-1. **Primero los errores de build** — el código debe compilar
-2. **Segundo las violaciones de detekt** — corregir problemas de calidad de código
-3. **Tercero las advertencias de ktlint** — corregir el formato
-4. **Un arreglo a la vez** — verificar cada cambio
-5. **Cambios mínimos** — no refactorizar, solo corregir
-
-## Condiciones de parada
-
-El agente se detendrá e informará si:
-
-- El mismo error persiste tras 3 intentos
-- Un arreglo introduce más errores
-- Se requieren cambios de arquitectura
-- Faltan dependencias externas
-
-## Comandos relacionados
-
-- `/test-kotlin` — ejecutar las pruebas cuando el build pase
-- `/revisar-kotlin` — revisar la calidad del código
-- Skill `bucle-verificacion` — bucle de verificación completo
-
-## Relacionado
-
-- Agente: `agents/resolutor-builds-kotlin.md`
-- Skill: `skills/patrones-kotlin/`

package/vendor/theus-arsenal/commands/build-react.md

@@ -1,187 +0,0 @@
----
-description: Arregla fallos de build de React (Vite, webpack, Next.js, CRA, Parcel, esbuild, Bun) de forma incremental — errores de compilación JSX/TSX, desajustes de hidratación, fallos de límite entre componentes de servidor/cliente, tipos faltantes. Invoca al agente resolutor-builds-react para correcciones mínimas y quirúrgicas.
----
-
-# Build y arreglo de React
-
-Este comando invoca al agente **resolutor-builds-react** para corregir errores de build de React de forma incremental y con cambios mínimos.
-
-## Qué hace este comando
-
-1. **Detectar el sistema de build**: identifica Vite, webpack, Next.js, CRA, Parcel, esbuild o Bun
-2. **Ejecutar el build**: corre el script de build del proyecto
-3. **Analizar los errores**: los agrupa por capa (TypeScript / configuración del bundler / runtime / hidratación)
-4. **Corregir incrementalmente**: un error a la vez, re-ejecutando el build tras cada cambio
-5. **Reportar un resumen**: muestra qué se corrigió y qué queda pendiente
-
-## Cuándo usarlo
-
-Usa `/build-react` cuando:
-
-- `npm run build` (o el equivalente con pnpm/yarn/bun) falla
-- Hay errores de compilación JSX/TSX tras una actualización de TypeScript o React
-- Aparecen errores de desajuste de hidratación de Next.js en tiempo de ejecución
-- Hay errores de límite entre Server/Client Components en App Router
-- Después de instalar o actualizar `react`, `react-dom`, `@types/react` o un bundler
-- Hay tipos faltantes o errores de "module not found" que involucran a React
-
-## Alcance
-
-Este comando es dueño de los fallos de **build/bundler/hidratación en runtime de React**. Para errores de tipos de TypeScript puros sin React involucrado, usa `/arreglar-build` (genérico).
-
-## Comandos de diagnóstico que se ejecutan
-
-```bash
-# Script de build del proyecto (preferido)
-npm run build --if-present
-pnpm build 2>/dev/null
-yarn build 2>/dev/null
-bun run build 2>/dev/null
-
-# Typecheck independiente
-npm run typecheck --if-present
-tsc --noEmit -p tsconfig.json
-
-# Alternativa específica por bundler
-next build                          # Next.js
-vite build                          # Vite
-react-scripts build                 # CRA
-webpack --mode=production           # webpack
-parcel build src/index.html         # Parcel
-bun build ./src/index.tsx --outdir=dist
-```
-
-## Sesión de ejemplo
-
-````text
-Usuario: /build-react
-
-Agente:
-# Resolución de build de React
-
-## Sistema de build detectado
-Vite (vite.config.ts presente, @vitejs/plugin-react en las dependencias)
-
-## Diagnóstico inicial
-
-```bash
-$ npm run build
-> tsc -b && vite build
-
-src/components/UserCard.tsx:1:8 - error TS6133: 'React' is declared but its value is never read.
-src/components/Modal.tsx:12:15 - error TS7016: Could not find a declaration file for module 'react-portal'.
-src/pages/Home.tsx:42:5 - error: 'useState' is not defined
-```
-
-Errores encontrados: 3
-
-## Corrección 1: resto del transform JSX antiguo
-
-Archivo: src/components/UserCard.tsx:1
-Causa: `tsconfig.json` ya usa `"jsx": "react-jsx"`; el `import React` explícito no se usa.
-
-```tsx
-// Eliminado
-- import React from 'react';
-```
-
-```bash
-$ npm run build
-# Quedan 2 errores
-```
-
-## Corrección 2: tipos faltantes
-
-Archivo: src/components/Modal.tsx
-Causa: `@types/react-portal` no está instalado.
-
-```bash
-$ npm i -D @types/react-portal
-added 1 package
-```
-
-```bash
-$ npm run build
-# Queda 1 error
-```
-
-## Corrección 3: import de hook faltante
-
-Archivo: src/pages/Home.tsx
-Causa: se referencia `useState` pero no está importado.
-
-```tsx
-- import { useEffect } from "react";
-+ import { useEffect, useState } from "react";
-```
-
-```bash
-$ npm run build
-# ¡Build exitoso!
-```
-
-## Verificación final
-
-```bash
-$ npm run build
-✓ built in 2.34s
-
-$ npm test
-✓ 47 tests passed
-```
-
-## Resumen
-
-| Métrica | Cantidad |
-|--------|-------|
-| Errores de build corregidos | 3 |
-| Archivos modificados | 2 |
-| Dependencias añadidas | 1 (@types/react-portal) |
-| Problemas restantes | 0 |
-
-Estado del build: PASS: ÉXITO
-````
-
-## Errores comunes que corrige
-
-| Error | Corrección típica |
-|---|---|
-| `'React' is not defined` | Configurar `"jsx": "react-jsx"` en tsconfig (React 17+) |
-| Falta `@types/react` | `npm i -D @types/react @types/react-dom` |
-| `Unexpected token '<'` | Añadir `@vitejs/plugin-react` / `babel-loader` |
-| `You're importing a component that needs useState` (Next.js) | Añadir `"use client"` o mover el hook a un hijo Client Component |
-| `Module not found: Can't resolve 'fs'` (Next.js) | Quitar el import de `fs` o mover la lógica a un Server Component / ruta de API |
-| `Hydration failed because the initial UI does not match` | Mover `Date.now()`/`Math.random()`/`window.*` a `useEffect` |
-| `Invalid hook call` | Múltiples copias de React — deduplica con `resolutions`/`overrides` |
-| `Element type is invalid` | Desajuste entre import por defecto e import con nombre |
-
-## Estrategia de corrección
-
-1. **Primero los errores de compilación** — el código debe compilar
-2. **Segundo los errores de hidratación** — afectan la corrección en producción
-3. **Tercero la configuración del bundler** — restaurar la corrección de plugins/loaders
-4. **Una corrección a la vez** — verificar cada cambio
-5. **Cambios mínimos** — nunca usar `// @ts-ignore` sin explicación
-6. **Re-ejecutar tras cada corrección** — hacer aflorar errores nuevos de inmediato
-
-## Condiciones de parada
-
-El agente se detendrá y reportará si:
-
-- El mismo error persiste tras 3 intentos
-- Una corrección introduce más errores de los que resuelve
-- Se requiere un cambio arquitectónico que excede la resolución del build (p. ej., rediseñar el límite RSC)
-- La versión del bundler ya no soporta la versión mayor de React instalada
-
-## Comandos relacionados
-
-- `/test-react` — ejecutar tests después de que el build esté en verde
-- `/revisar-react` — revisar la calidad del código después de que el build tenga éxito
-- `/arreglar-build` — arreglador de builds genérico (no React)
-- Skill `bucle-verificacion` — bucle de verificación completo
-
-## Relacionado
-
-- Agente: `agents/resolutor-builds-react.md`
-- Skills: `skills/patrones-react/`, `skills/patrones-frontend/`
-- Reglas: `rules/react/coding-style.md`, `rules/react/patterns.md`

package/vendor/theus-arsenal/commands/build-rust.md

@@ -1,187 +0,0 @@
----
-description: Corrige errores de build de Rust, problemas del borrow checker y de dependencias de forma incremental. Invoca al agente resolutor-builds-rust para arreglos mínimos y quirúrgicos.
----
-
-# Build y corrección de Rust
-
-Este comando invoca al agente **resolutor-builds-rust** para corregir errores de build de Rust de forma incremental y con cambios mínimos.
-
-## Qué hace este comando
-
-1. **Ejecutar diagnósticos**: `cargo check`, `cargo clippy`, `cargo fmt --check`
-2. **Parsear errores**: identificar códigos de error y archivos afectados
-3. **Corregir incrementalmente**: un error a la vez
-4. **Verificar cada arreglo**: volver a ejecutar `cargo check` tras cada cambio
-5. **Informar el resumen**: mostrar qué se corrigió y qué queda pendiente
-
-## Cuándo usarlo
-
-Usa `/build-rust` cuando:
-- `cargo build` o `cargo check` fallan con errores
-- `cargo clippy` reporta advertencias
-- Errores del borrow checker o de lifetimes bloquean la compilación
-- Falla la resolución de dependencias de Cargo
-- Tras hacer pull de cambios que rompen el build
-
-## Comandos de diagnóstico ejecutados
-
-```bash
-# Verificación principal del build
-cargo check 2>&1
-
-# Lints y sugerencias
-cargo clippy -- -D warnings 2>&1
-
-# Verificación de formato
-cargo fmt --check 2>&1
-
-# Problemas de dependencias
-cargo tree --duplicates
-
-# Auditoría de seguridad (si está disponible)
-if command -v cargo-audit >/dev/null; then cargo audit; else echo "cargo-audit no está instalado"; fi
-```
-
-## Ejemplo de sesión
-
-````text
-Usuario: /build-rust
-
-Agente:
-# Resolución del build de Rust
-
-## Diagnóstico inicial
-
-```bash
-$ cargo check
-error[E0502]: cannot borrow `map` as mutable because it is also borrowed as immutable
-  --> src/service/cache.rs:25:5
-error[E0308]: mismatched types
-  --> src/handler/api.rs:42:12
-error[E0425]: cannot find value `db` in this scope
-  --> src/handler/api.rs:58:9
-```
-
-Errores encontrados: 3
-
-## Arreglo 1: error del borrow checker
-
-Archivo: src/service/cache.rs:25
-Error: E0502 — no se puede tomar `map` como mutable porque ya está prestado como inmutable
-Causa: el préstamo inmutable sigue activo durante el insert mutable
-
-```rust
-// Cambio: reestructurado para terminar el préstamo inmutable antes del acceso mutable
-if !map.contains_key("key") {
-    map.insert("key".into(), default);
-}
-```
-
-```bash
-$ cargo check
-# Quedan 2 errores
-```
-
-## Arreglo 2: tipos incompatibles
-
-Archivo: src/handler/api.rs:42
-Error: E0308 — tipos incompatibles: se esperaba `usize`, se encontró `&str`
-
-```rust
-// Antes
-let count = params.get("count");
-// Después
-let count: usize = params.get("count")
-    .and_then(|s| s.parse().ok())
-    .unwrap_or(0);
-```
-
-```bash
-$ cargo check
-# Queda 1 error
-```
-
-## Arreglo 3: nombre sin resolver
-
-Archivo: src/handler/api.rs:58
-Error: E0425 — no se encuentra el valor `db` en este ámbito
-Causa: falta el import
-
-```rust
-// Añadido
-use crate::db;
-```
-
-```bash
-$ cargo check
-# ¡Build exitoso!
-```
-
-## Verificación final
-
-```bash
-$ cargo clippy -- -D warnings
-# Sin advertencias
-
-$ cargo test
-running 6 tests
-test service::cache::tests::test_insert ... ok
-test service::cache::tests::test_get ... ok
-test handler::api::tests::test_parse_count ... ok
-test handler::api::tests::test_missing_count ... ok
-test handler::api::tests::test_db_import ... ok
-test handler::api::tests::test_response ... ok
-
-test result: ok. 6 passed; 0 failed; 0 ignored
-```
-
-## Resumen
-
-| Métrica | Cantidad |
-|--------|-------------|
-| Errores de build corregidos | 3 |
-| Advertencias de clippy corregidas | 0 |
-| Archivos modificados | 2 |
-| Problemas restantes | 0 |
-
-Estado del build: ÉXITO
-````
-
-## Errores comunes corregidos
-
-| Error | Arreglo típico |
-|-------|-------------|
-| `cannot borrow as mutable` | Reestructurar para terminar antes el préstamo inmutable; clonar solo si está justificado |
-| `does not live long enough` | Usar un tipo con propiedad o añadir anotación de lifetime |
-| `cannot move out of` | Reestructurar para tomar la propiedad; clonar solo como último recurso |
-| `mismatched types` | Añadir `.into()`, `as` o una conversión explícita |
-| `trait X not implemented` | Añadir `#[derive(Trait)]` o implementarlo a mano |
-| `unresolved import` | Añadir a Cargo.toml o corregir la ruta del `use` |
-| `cannot find value` | Añadir el import o corregir la ruta |
-
-## Estrategia de corrección
-
-1. **Primero los errores de build** — el código debe compilar
-2. **Luego las advertencias de clippy** — corregir construcciones sospechosas
-3. **Después el formato** — cumplir con `cargo fmt`
-4. **Un arreglo a la vez** — verificar cada cambio
-5. **Cambios mínimos** — no refactorizar, solo corregir
-
-## Condiciones de parada
-
-El agente se detendrá e informará si:
-- El mismo error persiste tras 3 intentos
-- Un arreglo introduce más errores
-- Se requieren cambios de arquitectura
-- Un error del borrow checker exige rediseñar la propiedad de los datos
-
-## Comandos relacionados
-
-- `/test-rust` — ejecutar los tests cuando el build pase
-- `/revisar-rust` — revisar la calidad del código
-- Skill `bucle-verificacion` — bucle de verificación completo
-
-## Relacionados
-
-- Agente: `agents/resolutor-builds-rust.md`
-- Skill: `skills/patrones-rust/`

package/vendor/theus-arsenal/commands/campana-marketing.md

@@ -1,125 +0,0 @@
----
-description: Planifica y ejecuta una campaña de marketing completa. Acepta un brief de producto y devuelve posicionamiento, copy de landing page, secuencia de correos, publicaciones sociales, variantes de anuncios, guiones de video y un calendario de contenidos. También puede auditar copy existente por calidad de conversión.
-allowed-tools: ["Read", "Grep", "Glob", "WebSearch", "WebFetch", "Write"]
----
-
-# /campana-marketing
-
-Planifica y ejecuta una campaña de marketing, desde el brief hasta la suite completa de contenidos.
-
-## Uso
-
-```
-/campana-marketing                              # Solicita el brief de forma interactiva
-/campana-marketing [brief de producto]          # Campaña completa desde un brief en línea
-/campana-marketing copy [tipo]                  # Solo un entregable
-/campana-marketing review [archivo-o-brief]     # Auditoría de copy por conversión y consistencia de marca
-```
-
-## Qué hace
-
-1. **Investigación** — Perfila la audiencia objetivo y mapea a la competencia antes de escribir nada
-2. **Posicionamiento** — Fija primero el ángulo de la campaña y el perfil de tono
-3. **Producción de copy** — Genera la suite completa de contenidos en el orden correcto (landing page → correos → redes sociales → anuncios → guiones de video → calendario)
-4. **Revisión** — Pasa toda la salida por una lista de verificación de conversión y consistencia de marca
-
-## Modos
-
-### Modo de campaña completa
-
-Proporciona un brief de producto que contenga:
-- Nombre y descripción del producto
-- Audiencia objetivo (específica, no genérica)
-- Problema central que el producto resuelve
-- Beneficio / resultado central
-- Guía de tono
-- Canales requeridos
-- Meta de lanzamiento o cronograma
-
-El agente devuelve todos los entregables de la campaña en orden, con un resumen de revisión del copy al final.
-
-### Modo de entregable único
-
-```
-/campana-marketing copy landing-page
-/campana-marketing copy email-sequence
-/campana-marketing copy social-posts
-/campana-marketing copy ads
-/campana-marketing copy video-scripts
-```
-
-Requiere que el posicionamiento esté definido primero. Ejecuta el modo completo o proporciona el ángulo antes de pedir un entregable único.
-
-### Modo de revisión de copy
-
-```
-/campana-marketing review ruta/al/copy.md
-/campana-marketing review "pega el copy aquí"
-```
-
-Devuelve una auditoría estructurada contra:
-- Prueba de claridad de 5 segundos (copy sobre el pliegue)
-- Calidad del CTA (específico, ganado, uno por pieza)
-- Consistencia del tono de marca
-- Especificidad y sustentabilidad de las afirmaciones
-- Ajuste nativo a cada plataforma
-- Consistencia entre canales
-
-## Plantilla de brief
-
-```markdown
-Producto: [nombre]
-Descripción: [1-3 oraciones sobre qué hace]
-Audiencia: [quién, específicamente]
-Problema: [el dolor concreto que el producto resuelve]
-Beneficio: [el resultado que obtiene el usuario]
-Tono: [adjetivos + qué evitar]
-Canales: [landing page, correo, LinkedIn, X, anuncios, video]
-Meta: [lanzamiento, lista de espera, registros, awareness — y cronograma]
-```
-
-## Ubicación de la salida
-
-Al guardar los activos de la campaña, la convención es `.theus/campaigns/{nombre-de-campana}/`:
-
-```
-.theus/campaigns/lanzamiento-producto/
-├── positioning.md
-├── landing-page.md
-├── email-sequence.md
-├── social-posts.md
-├── ad-copy.md
-├── video-scripts.md
-└── content-calendar.md
-```
-
-Confirma la ubicación de guardado antes de escribir archivos.
-
-## Ejemplos
-
-```
-/campana-marketing Construye una campaña de lanzamiento de 7 días para una plataforma de carrera con IA dirigida a estudiantes universitarios del Reino Unido.
-```
-
-```
-/campana-marketing copy landing-page
-```
-
-```
-/campana-marketing review .theus/campaigns/mi-campana/landing-page.md
-```
-
-## Delegación a agentes y skills
-
-Este comando invoca:
-- `estratega-marketing` — planificación de campaña y producción de copy
-- `voz-de-marca` — captura de voz cuando hay que fijar el tono en varias salidas
-- `motor-de-contenido` — producción de contenido social nativo por plataforma
-- `publicacion-cruzada` — distribución multiplataforma
-- `investigacion-profunda` — inteligencia profunda de audiencia o de competencia
-
-## Comandos relacionados
-
-- `/plan` — Planificación estratégica antes de una campaña
-- `/plan-prd` — Documento de requisitos de producto antes de armar el brief de campaña
-- `/revisar-codigo` — Revisar el código detrás de la implementación de una landing page