theus-cli 0.2.83 → 0.2.84

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

@@ -1,173 +0,0 @@
----
-description: Corrige errores de build de C++, problemas de CMake y del enlazador de forma incremental. Invoca al agente resolutor-builds-cpp para arreglos mínimos y quirúrgicos.
----
-
-# Build y corrección de C++
-
-Este comando invoca al agente **resolutor-builds-cpp** para corregir errores de build de C++ de forma incremental y con cambios mínimos.
-
-## Qué hace este comando
-
-1. **Ejecuta diagnósticos**: corre `cmake --build`, `clang-tidy`, `cppcheck`
-2. **Analiza los errores**: los agrupa por archivo y los ordena por severidad
-3. **Corrige incrementalmente**: un error a la vez
-4. **Verifica cada arreglo**: vuelve a ejecutar el build tras cada cambio
-5. **Reporta un resumen**: muestra qué se corrigió y qué queda pendiente
-
-## Cuándo usarlo
-
-Usa `/build-cpp` cuando:
-- `cmake --build build` falla con errores
-- Hay errores del enlazador (referencias sin definir, definiciones múltiples)
-- Fallan instanciaciones de plantillas
-- Hay problemas de includes o dependencias
-- Después de traer cambios que rompen el build
-
-## Comandos de diagnóstico ejecutados
-
-```bash
-# Configuración de CMake
-cmake -B build -S .
-
-# Build
-cmake --build build 2>&1 | head -100
-
-# Análisis estático (si está disponible)
-clang-tidy src/*.cpp -- -std=c++17
-cppcheck --enable=all src/
-```
-
-## Sesión de ejemplo
-
-```text
-Usuario: /build-cpp
-
-Agente:
-# Resolución de build de C++
-
-## Diagnóstico inicial
-
-```bash
-$ cmake --build build
-src/service/user.cpp:25:15: error: use of undeclared identifier 'UserRepository'
-src/handler/api.cpp:42:9: error: no matching function for call to 'process'
-src/handler/api.cpp:58:1: error: non-void function does not return a value
-```
-
-Errores encontrados: 3
-
-## Arreglo 1: identificador sin declarar
-
-Archivo: src/service/user.cpp:25
-Error: use of undeclared identifier 'UserRepository'
-Causa: falta un include
-
-```cpp
-// Include añadido
-#include "repository/user_repository.hpp"
-```
-
-```bash
-$ cmake --build build
-# Quedan 2 errores
-```
-
-## Arreglo 2: no hay función compatible
-
-Archivo: src/handler/api.cpp:42
-Error: no matching function for call to 'process'
-
-```cpp
-// Se cambió
-process(params.get("count"));
-// Por
-process(std::stoi(params.get("count")));
-```
-
-```bash
-$ cmake --build build
-# Queda 1 error
-```
-
-## Arreglo 3: falta el return
-
-Archivo: src/handler/api.cpp:58
-Error: non-void function does not return a value
-
-```cpp
-std::optional<User> getUser(const std::string& id) {
-    if (id.empty()) {
-        return std::nullopt;
-    }
-    auto user = findUser(id);
-    // Return faltante añadido
-    return user;
-}
-```
-
-```bash
-$ cmake --build build
-# ¡Build exitoso!
-```
-
-## Verificación final
-
-```bash
-$ ctest --test-dir build --output-on-failure
-Test project build
-    1/5 Test #1: unit_tests ........   Passed    0.02 sec
-    2/5 Test #2: integration_tests    Passed    0.15 sec
-All tests passed.
-```
-
-## Resumen
-
-| Métrica | Cantidad |
-|---------|----------|
-| Errores de build corregidos | 3 |
-| Errores de enlazador corregidos | 0 |
-| Archivos modificados | 2 |
-| Problemas restantes | 0 |
-
-Estado del build: PASS: ÉXITO
-```
-
-## Errores comunes que corrige
-
-| Error | Arreglo típico |
-|-------|----------------|
-| `undeclared identifier` | Añadir `#include` o corregir el nombre |
-| `no matching function` | Corregir tipos de argumentos o añadir sobrecarga |
-| `undefined reference` | Enlazar la librería o añadir la implementación |
-| `multiple definition` | Usar `inline` o mover al .cpp |
-| `incomplete type` | Sustituir la declaración adelantada por un `#include` |
-| `no member named X` | Corregir el nombre del miembro o el include |
-| `cannot convert X to Y` | Añadir el cast adecuado |
-| `CMake Error` | Corregir la configuración de CMakeLists.txt |
-
-## Estrategia de corrección
-
-1. **Primero los errores de compilación** — el código debe compilar
-2. **Después los errores del enlazador** — resolver referencias sin definir
-3. **Luego los warnings** — corregir con `-Wall -Wextra`
-4. **Un arreglo a la vez** — verificar cada cambio
-5. **Cambios mínimos** — no refactorizar, solo corregir
-
-## Condiciones de parada
-
-El agente se detiene y reporta si:
-- El mismo error persiste tras 3 intentos
-- Un arreglo introduce más errores
-- Se requieren cambios arquitectónicos
-- Faltan dependencias externas
-
-## Comandos relacionados
-
-- `/test-cpp` — ejecutar tests cuando el build pasa
-- `/revisar-cpp` — revisar la calidad del código
-- Skill `skills/bucle-verificacion/` — bucle de verificación completo
-
-## Relacionados
-
-- Agente: `agents/resolutor-builds-cpp.md`
-- Skill: `skills/estandares-cpp/`

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

@@ -1,164 +0,0 @@
----
-description: Corrige errores del analizador de Dart y fallos de build de Flutter de forma incremental. Invoca al agente resolutor-builds-dart para arreglos mínimos y quirúrgicos.
----
-
-# Build y corrección de Flutter
-
-Este comando invoca al agente **resolutor-builds-dart** para corregir errores de build de Dart/Flutter de forma incremental y con cambios mínimos.
-
-## Qué hace este comando
-
-1. **Ejecutar diagnósticos**: ejecuta `flutter analyze`, `flutter pub get`
-2. **Analizar los errores**: agrupa por archivo y ordena por severidad
-3. **Corregir incrementalmente**: un error a la vez
-4. **Verificar cada arreglo**: vuelve a ejecutar el análisis tras cada cambio
-5. **Informar el resumen**: muestra qué se corrigió y qué queda pendiente
-
-## Cuándo usarlo
-
-Usa `/build-flutter` cuando:
-- `flutter analyze` reporta errores
-- `flutter build` falla para cualquier plataforma
-- `dart pub get` / `flutter pub get` falla por conflictos de versión
-- `build_runner` falla al generar código
-- Después de traer cambios que rompen el build
-
-## Comandos de diagnóstico ejecutados
-
-```bash
-# Análisis
-flutter analyze 2>&1
-
-# Dependencias
-flutter pub get 2>&1
-
-# Generación de código (si el proyecto usa build_runner)
-dart run build_runner build --delete-conflicting-outputs 2>&1
-
-# Builds por plataforma
-flutter build apk 2>&1
-flutter build web 2>&1
-```
-
-## Sesión de ejemplo
-
-````text
-Usuario: /build-flutter
-
-Agente:
-# Resolución de build de Flutter
-
-## Diagnóstico inicial
-
-```
-$ flutter analyze
-Analyzing project...
-
-  error • lib/features/user/data/user_repository_impl.dart:34:16 •
-    A value of type 'String?' can't be assigned to a variable of type 'String'. •
-    invalid_assignment
-
-  error • lib/features/cart/presentation/cart_page.dart:58:5 •
-    The method 'add' isn't defined for the type 'List<Item>'.
-    Try correcting the name to the name of an existing method, or defining a method named 'add'. •
-    undefined_method
-
-2 errors found.
-```
-
-## Arreglo 1: null safety
-
-Archivo: lib/features/user/data/user_repository_impl.dart:34
-Error: A value of type 'String?' can't be assigned to type 'String'
-
-Cambiado:
-```dart
-final id = response.id;
-```
-Por:
-```dart
-final id = response.id ?? '';
-```
-
-```
-$ flutter analyze
-1 error found.
-```
-
-## Arreglo 2: lista inmutable
-
-Archivo: lib/features/cart/presentation/cart_page.dart:58
-Error: The method 'add' isn't defined for the type 'List<Item>'
-Causa: el estado guarda una lista no modificable; la mutación pasa por el Cubit
-
-Cambiado:
-```dart
-state.items.add(item);
-```
-Por:
-```dart
-context.read<CartCubit>().addItem(item);
-// Nota: el Cubit expone métodos con nombre (addItem, removeItem);
-// .add(evento) es la API de eventos de BLoC — no las mezcles.
-```
-
-```
-$ flutter analyze
-No issues found!
-```
-
-## Verificación final
-
-```
-$ flutter test
-All tests passed.
-```
-
-## Resumen
-
-| Métrica | Cantidad |
-|---------|----------|
-| Errores de análisis corregidos | 2 |
-| Archivos modificados | 2 |
-| Problemas restantes | 0 |
-
-Estado del build: PASS ✓
-````
-
-## Errores comunes corregidos
-
-| Error | Arreglo típico |
-|-------|----------------|
-| `A value of type 'X?' can't be assigned to 'X'` | Agregar `?? valorPorDefecto` o guarda de null |
-| `The name 'X' isn't defined` | Agregar el import o corregir la errata |
-| `Non-nullable instance field must be initialized` | Agregar inicializador o `late` |
-| `Version solving failed` | Ajustar las restricciones de versión en pubspec.yaml |
-| `Missing concrete implementation of 'X'` | Implementar el método de interfaz faltante |
-| `build_runner: Part of X expected` | Borrar el `.g.dart` obsoleto y regenerar |
-
-## Estrategia de corrección
-
-1. **Primero los errores de análisis** — el código debe quedar sin errores
-2. **Luego el triaje de warnings** — corregir los que puedan causar bugs en runtime
-3. **Tercero los conflictos de pub** — arreglar la resolución de dependencias
-4. **Un arreglo a la vez** — verificar cada cambio
-5. **Cambios mínimos** — no refactorizar, solo corregir
-
-## Condiciones de parada
-
-El agente se detiene e informa si:
-- El mismo error persiste tras 3 intentos
-- Un arreglo introduce más errores
-- Se requieren cambios de arquitectura
-- Un conflicto de actualización de paquetes necesita decisión del usuario
-
-## Comandos relacionados
-
-- `/test-flutter` — Ejecutar los tests cuando el build pase
-- `/revisar-flutter` — Revisar la calidad del código
-- Skill `bucle-verificacion` — Bucle de verificación completo
-
-## Relacionados
-
-- Agente: `agents/resolutor-builds-dart.md`
-- Skill: `skills/revision-codigo-flutter-dart/`

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

@@ -1,183 +0,0 @@
----
-description: Corrige errores de build de Go, avisos de go vet y problemas del linter de forma incremental. Invoca al agente resolutor-builds-go para arreglos mínimos y quirúrgicos.
----
-
-# Build y corrección de Go
-
-Este comando invoca al agente **resolutor-builds-go** para corregir errores de build de Go de forma incremental y con cambios mínimos.
-
-## Qué hace este comando
-
-1. **Ejecuta diagnósticos**: corre `go build`, `go vet`, `staticcheck`
-2. **Analiza los errores**: los agrupa por archivo y los ordena por severidad
-3. **Corrige incrementalmente**: un error a la vez
-4. **Verifica cada arreglo**: vuelve a ejecutar el build tras cada cambio
-5. **Informa un resumen**: muestra qué se corrigió y qué queda pendiente
-
-## Cuándo usarlo
-
-Usa /build-go cuando:
-- `go build ./...` falla con errores
-- `go vet ./...` reporta problemas
-- `golangci-lint run` muestra advertencias
-- Las dependencias del módulo están rotas
-- Después de traer cambios que rompen el build
-
-## Comandos de diagnóstico ejecutados
-
-```bash
-# Verificación principal del build
-go build ./...
-
-# Análisis estático
-go vet ./...
-
-# Linting extendido (si está disponible)
-staticcheck ./...
-golangci-lint run
-
-# Problemas del módulo
-go mod verify
-go mod tidy -v
-```
-
-## Sesión de ejemplo
-
-```text
-Usuario: /build-go
-
-Agente:
-# Resolución del build de Go
-
-## Diagnóstico inicial
-
-```bash
-$ go build ./...
-internal/service/user.go:25:15: undefined: UserRepository
-internal/handler/api.go:42:9: cannot use x (type string) as type int
-internal/handler/api.go:58:2: missing return at end of function
-```
-
-Errores encontrados: 3
-
-## Arreglo 1: identificador no definido
-
-Archivo: internal/service/user.go:25
-Error: undefined: UserRepository
-Causa: import faltante
-
-```go
-// Import agregado
-import "project/internal/repository"
-
-// Se cambió
-var repo UserRepository
-// Por
-var repo repository.UserRepository
-```
-
-```bash
-$ go build ./...
-# Quedan 2 errores
-```
-
-## Arreglo 2: tipos incompatibles
-
-Archivo: internal/handler/api.go:42
-Error: cannot use x (type string) as type int
-
-```go
-// Se cambió
-count := params.Get("count")
-// Por
-countStr := params.Get("count")
-count, _ := strconv.Atoi(countStr)
-```
-
-```bash
-$ go build ./...
-# Queda 1 error
-```
-
-## Arreglo 3: return faltante
-
-Archivo: internal/handler/api.go:58
-Error: missing return at end of function
-
-```go
-func GetUser(id string) (*User, error) {
-    if id == "" {
-        return nil, ErrInvalidID
-    }
-    user := findUser(id)
-    // Return faltante agregado
-    return user, nil
-}
-```
-
-```bash
-$ go build ./...
-# ¡Build exitoso!
-```
-
-## Verificación final
-
-```bash
-$ go vet ./...
-# Sin problemas
-
-$ go test ./...
-ok      project/internal/service   0.015s
-ok      project/internal/handler   0.023s
-```
-
-## Resumen
-
-| Métrica | Cantidad |
-|---------|----------|
-| Errores de build corregidos | 3 |
-| Advertencias de vet corregidas | 0 |
-| Archivos modificados | 2 |
-| Problemas restantes | 0 |
-
-Estado del build: APROBADO: ÉXITO
-```
-
-## Errores comunes corregidos
-
-| Error | Arreglo típico |
-|-------|----------------|
-| `undefined: X` | Agregar import o corregir el nombre |
-| `cannot use X as Y` | Conversión de tipo o corregir la asignación |
-| `missing return` | Agregar la sentencia return |
-| `X does not implement Y` | Agregar el método faltante |
-| `import cycle` | Reestructurar los paquetes |
-| `declared but not used` | Eliminar o usar la variable |
-| `cannot find package` | `go get` o `go mod tidy` |
-
-## Estrategia de corrección
-
-1. **Primero los errores de build** — el código debe compilar
-2. **Segundo las advertencias de vet** — corregir construcciones sospechosas
-3. **Tercero las advertencias del linter** — estilo y buenas prácticas
-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
-- El arreglo introduce más errores
-- Se requieren cambios de arquitectura
-- Faltan dependencias externas
-
-## Comandos relacionados
-
-- /test-go — ejecutar tests después de que el build pase
-- /revisar-go — revisar la calidad del código
-- Skill `bucle-verificacion` — bucle de verificación completo
-
-## Relacionados
-
-- Agente: `agents/resolutor-builds-go.md`
-- Skill: `skills/patrones-go/`

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

@@ -1,75 +0,0 @@
----
-description: Corrige errores de build de Gradle en proyectos Android y KMP
----
-
-# Corrección de build Gradle
-
-Corrige de forma incremental los errores de build y compilación de Gradle en proyectos Android y Kotlin Multiplatform.
-
-## Paso 1: Detectar la configuración del build
-
-Identifica el tipo de proyecto y ejecuta el build apropiado:
-
-| Indicador | Comando de build |
-|-----------|------------------|
-| `build.gradle.kts` + `composeApp/` (KMP) | `./gradlew composeApp:compileKotlinMetadata 2>&1` |
-| `build.gradle.kts` + `app/` (Android) | `./gradlew app:compileDebugKotlin 2>&1` |
-| `settings.gradle.kts` con módulos | `./gradlew assemble 2>&1` |
-| Detekt configurado | `./gradlew detekt 2>&1` |
-
-Revisa también `gradle.properties` y `local.properties` en busca de configuración relevante.
-
-## Paso 2: Analizar y agrupar los errores
-
-1. Ejecuta el comando de build y captura la salida
-2. Separa los errores de compilación de Kotlin de los errores de configuración de Gradle
-3. Agrupa por módulo y ruta de archivo
-4. Ordena: primero los errores de configuración, luego los de compilación por orden de dependencias
-
-## Paso 3: Bucle de corrección
-
-Para cada error:
-
-1. **Lee el archivo** — contexto completo alrededor de la línea del error
-2. **Diagnostica** — categorías comunes:
-   - Import faltante o referencia sin resolver
-   - Tipos incompatibles o discordancia de tipos
-   - Dependencia faltante en `build.gradle.kts`
-   - Discordancia expect/actual (KMP)
-   - Error del compilador de Compose
-3. **Corrige de forma mínima** — el cambio más pequeño que resuelva el error
-4. **Vuelve a ejecutar el build** — verifica el arreglo y busca errores nuevos
-5. **Continúa** — pasa al siguiente error
-
-## Paso 4: Salvaguardas
-
-Detente y pregunta al usuario si:
-- El arreglo introduce más errores de los que resuelve
-- El mismo error persiste tras 3 intentos
-- El error requiere agregar dependencias nuevas o cambiar la estructura de módulos
-- El propio sync de Gradle falla (error en fase de configuración)
-- El error está en código generado (Room, SQLDelight, KSP)
-
-## Paso 5: Resumen
-
-Informa:
-- Errores corregidos (módulo, archivo, descripción)
-- Errores restantes
-- Errores nuevos introducidos (debería ser cero)
-- Próximos pasos sugeridos
-
-## Arreglos comunes de Gradle/KMP
-
-| Error | Arreglo |
-|-------|---------|
-| Referencia sin resolver en `commonMain` | Verificar si la dependencia está en `commonMain.dependencies {}` |
-| Declaración expect sin actual | Agregar la implementación `actual` en cada source set de plataforma |
-| Versión del compilador de Compose discordante | Alinear las versiones de Kotlin y del compilador de Compose en `libs.versions.toml` |
-| Clase duplicada | Buscar dependencias en conflicto con `./gradlew dependencies` |
-| Error de KSP | Ejecutar `./gradlew kspCommonMainKotlinMetadata` para regenerar |
-| Problema de configuration cache | Buscar entradas de tareas no serializables |
-
-## Relacionados
-
-- Agente: `agents/resolutor-builds-kotlin.md`
-- Comandos: /build-kotlin, /test-kotlin, /revisar-kotlin