theus-cli-darwin-x64 0.2.84

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

@@ -0,0 +1,173 @@
+---
+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

@@ -0,0 +1,164 @@
+---
+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

@@ -0,0 +1,183 @@
+---
+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

@@ -0,0 +1,75 @@
+---
+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