theus-cli-linux-arm64 0.2.84

package/vendor/theus-arsenal/hooks/hooks.json

@@ -0,0 +1,274 @@
+{
+  "description": "Hooks del arsenal Theus: automatizaciones por evento (preflight de Bash, protección de configuración, control de calidad tras ediciones, formato+typecheck en lote al detener, persistencia de sesión y avisos de contexto). Los hooks envueltos en run-with-flags.js respetan THEUS_HOOK_PROFILE y THEUS_DISABLED_HOOKS.",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash|Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/modo-seguro.js\"",
+            "timeout": 10
+          }
+        ],
+        "description": "Modo seguro: aplica las protecciones del modo activo (estado en ~/.theus/arsenal/modo-seguro.json). Se ejecuta siempre; el estado off lo convierte en no-op.",
+        "id": "pre-modo-seguro"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/pre-bash-dispatcher.js\""
+          }
+        ],
+        "description": "Dispatcher consolidado de preflight para Bash: calidad de commits, bloqueo de --no-verify, bloqueo de servidores de desarrollo y avisos previos al push",
+        "id": "pre-bash-dispatcher"
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-write-doc-file-warning scripts/hooks/doc-file-warning.js standard,strict"
+          }
+        ],
+        "description": "Aviso sobre archivos de documentación: advierte al crear archivos de documentación no estándar (exit 0; solo advierte)",
+        "id": "pre-write-doc-file-warning"
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-edit-write-suggest-compact scripts/hooks/suggest-compact.js standard,strict"
+          }
+        ],
+        "description": "Sugiere compactar el contexto manualmente en intervalos lógicos",
+        "id": "pre-edit-write-suggest-compact"
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-config-protection scripts/hooks/config-protection.js standard,strict",
+            "timeout": 5
+          }
+        ],
+        "description": "Bloquea modificaciones a archivos de configuración de linters/formateadores. Orienta al agente a corregir el código en lugar de debilitar la configuración.",
+        "id": "pre-config-protection"
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-edit-write-verificacion-factual scripts/hooks/verificacion-factual.js strict"
+          }
+        ],
+        "description": "Puerta de verificación factual (solo perfil strict): en el primer toque de un archivo exige listar importadores, API afectada y esquemas antes de editar/crear",
+        "id": "pre-edit-write-verificacion-factual"
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-bash-verificacion-factual scripts/hooks/verificacion-factual.js strict"
+          }
+        ],
+        "description": "Puerta de verificación factual para Bash (solo perfil strict): comandos destructivos exigen objetivos y plan de reversión; el primer Bash de la sesión exige citar la instrucción",
+        "id": "pre-bash-verificacion-factual"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-salud-mcp scripts/hooks/salud-mcp.js standard,strict"
+          }
+        ],
+        "description": "Salud MCP (preflight): antes de usar una tool mcp__*, sondea el servidor; si está caído lo bloquea con backoff para que el agente use herramientas no MCP",
+        "id": "pre-salud-mcp"
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-compact scripts/hooks/pre-compact.js standard,strict"
+          }
+        ],
+        "description": "Guarda el estado antes de la compactación del contexto",
+        "id": "pre-compact"
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" session-start scripts/hooks/session-start.js standard,strict"
+          }
+        ],
+        "description": "Carga el contexto previo y detecta el gestor de paquetes al iniciar una sesión nueva",
+        "id": "session-start"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/post-bash-dispatcher.js\"",
+            "async": true,
+            "timeout": 30
+          }
+        ],
+        "description": "Dispatcher consolidado de postflight para Bash: registro de comandos y notificaciones de PR y de build",
+        "id": "post-bash-dispatcher"
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-quality-gate scripts/hooks/quality-gate.js standard,strict",
+            "async": true,
+            "timeout": 30
+          }
+        ],
+        "description": "Ejecuta las verificaciones del control de calidad tras editar archivos",
+        "id": "post-quality-gate"
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-design-quality-check scripts/hooks/design-quality-check.js standard,strict",
+            "timeout": 10
+          }
+        ],
+        "description": "Advierte cuando las ediciones de frontend derivan hacia una interfaz genérica con aspecto de plantilla",
+        "id": "post-edit-design-quality-check"
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-accumulator scripts/hooks/post-edit-accumulator.js standard,strict"
+          }
+        ],
+        "description": "Registra las rutas de archivos JS/TS editados para el formato+typecheck en lote al momento de Stop",
+        "id": "post-edit-accumulator"
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-console-warn scripts/hooks/post-edit-console-warn.js standard,strict"
+          }
+        ],
+        "description": "Advierte sobre sentencias console.log después de las ediciones",
+        "id": "post-edit-console-warn"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-context-monitor scripts/hooks/theus-context-monitor.js standard,strict",
+            "timeout": 10
+          }
+        ],
+        "description": "Inyecta advertencias al agente ante agotamiento del contexto, costo alto, desviación del alcance o bucles de herramientas",
+        "id": "post-context-monitor"
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" stop-format-typecheck scripts/hooks/stop-format-typecheck.js standard,strict",
+            "timeout": 300
+          }
+        ],
+        "description": "Formatea (Biome/Prettier) y verifica tipos (tsc) en lote todos los archivos JS/TS editados en esta respuesta — se ejecuta una sola vez en Stop en lugar de tras cada Edit",
+        "id": "stop-format-typecheck"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" stop-check-console-log scripts/hooks/check-console-log.js standard,strict"
+          }
+        ],
+        "description": "Busca console.log en los archivos modificados después de cada respuesta",
+        "id": "stop-check-console-log"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" stop-session-end scripts/hooks/session-end.js minimal,standard,strict",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Persiste el estado de la sesión después de cada respuesta (Stop incluye transcript_path)",
+        "id": "stop-session-end"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/seguimiento-costos.js\"",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Seguimiento de costos: suma el uso de tokens del transcript de la sesión y añade una fila estimada a ~/.theus/arsenal/metrics/costs.jsonl (lo consume /informe-costos). Nunca bloquea el cierre.",
+        "id": "stop-seguimiento-costos"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" stop-notificacion-escritorio scripts/hooks/notificacion-escritorio.js standard,strict",
+            "async": true,
+            "timeout": 10
+          }
+        ],
+        "description": "Notificación de escritorio nativa (macOS/Linux/WSL) con el resumen de la tarea al terminar cada respuesta; se desactiva con THEUS_ARSENAL_SIN_NOTIFICACIONES=1",
+        "id": "stop-notificacion-escritorio"
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${THEUS_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-salud-mcp scripts/hooks/salud-mcp.js standard,strict"
+          }
+        ],
+        "description": "Salud MCP (post-fallo): si una tool mcp__* falla, marca el servidor como no saludable e intenta la reconexión configurada",
+        "id": "post-salud-mcp"
+      }
+    ]
+  }
+}

package/vendor/theus-arsenal/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "theus-arsenal",
+  "private": true,
+  "type": "commonjs",
+  "//": "Este archivo existe SOLO para fijar el tipo de modulo, y es imprescindible. Los 55 scripts de hooks usan require(), y Node decide el tipo de modulo con el package.json MAS CERCANO. Al empaquetarse dentro del CLI (vendor/theus-arsenal/), el mas cercano pasaba a ser el del CLI, que declara \"type\": \"module\": todos los hooks morian con «require is not defined in ES module scope». El usuario veia una linea roja en el primer render de cada sesion y perdia 22 hooks en silencio, incluido el que carga el indice de habilidades que la pantalla de bienvenida promete. NO borrar sin convertir antes los 55 scripts a ESM o a .cjs."
+}

package/vendor/theus-arsenal/rules/angular/coding-style.md

@@ -0,0 +1,182 @@
+---
+paths:
+  - "**/*.component.ts"
+  - "**/*.component.html"
+  - "**/*.service.ts"
+  - "**/*.directive.ts"
+  - "**/*.pipe.ts"
+  - "**/*.guard.ts"
+  - "**/*.resolver.ts"
+  - "**/*.module.ts"
+---
+# Estilo de código Angular
+
+> Este archivo extiende [common/coding-style.md](../common/coding-style.md) con contenido específico de Angular.
+
+## Conciencia de versión
+
+Comprueba siempre la versión de Angular del proyecto antes de escribir código — las funcionalidades difieren de forma significativa entre versiones. Ejecuta `ng version` o inspecciona `package.json`. Al crear un proyecto nuevo, no fijes una versión salvo que el usuario especifique una.
+
+Después de generar o modificar código Angular, ejecuta siempre `ng build` para detectar errores antes de terminar.
+
+## Nombres de archivo
+
+Sigue las convenciones del CLI de Angular — un artefacto por archivo:
+
+- `user-profile.component.ts` + `user-profile.component.html` + `user-profile.component.spec.ts`
+- `user.service.ts`, `auth.guard.ts`, `date-format.pipe.ts`
+- Carpetas por funcionalidad: `features/users/`, `features/auth/`
+- Genera con el CLI: `ng generate component features/users/user-card`
+
+## Componentes
+
+Prefiere componentes standalone (predeterminado desde v17). Usa detección de cambios `OnPush` en todos los componentes nuevos.
+
+```typescript
+@Component({
+  selector: 'app-user-card',
+  standalone: true,
+  imports: [RouterModule],
+  templateUrl: './user-card.component.html',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class UserCardComponent {
+  user = input.required<User>();
+  select = output<string>();
+}
+```
+
+## Inyección de dependencias
+
+Usa `inject()` en lugar de la inyección por constructor. Mantén los constructores vacíos o elimínalos por completo.
+
+```typescript
+// CORRECTO
+@Injectable({ providedIn: 'root' })
+export class UserService {
+  private http = inject(HttpClient);
+  private router = inject(Router);
+}
+
+// INCORRECTO: la inyección por constructor es verbosa y dificulta el tree-shaking
+constructor(private http: HttpClient, private router: Router) {}
+```
+
+Usa `InjectionToken` para dependencias que no son clases:
+
+```typescript
+const API_URL = new InjectionToken<string>('API_URL');
+
+// Proveer:
+{ provide: API_URL, useValue: 'https://api.example.com' }
+
+// Consumir:
+private apiUrl = inject(API_URL);
+```
+
+## Signals
+
+### Primitivas básicas
+
+```typescript
+count = signal(0);
+doubled = computed(() => this.count() * 2);
+
+increment() {
+  this.count.update(n => n + 1);
+}
+```
+
+### `linkedSignal` — estado derivado escribible
+
+Usa `linkedSignal` cuando un signal debe reiniciarse o adaptarse al cambiar una fuente, pero también ser escribible de forma independiente:
+
+```typescript
+selectedOption = linkedSignal(() => this.options()[0]);
+// Se reinicia a la primera opción cuando cambia options, pero el usuario puede sobreescribirla
+```
+
+### `resource` — datos asíncronos en signals
+
+Usa `resource()` para obtener datos asíncronos de forma reactiva sin suscripciones manuales:
+
+```typescript
+userResource = resource({
+  request: () => ({ id: this.userId() }),
+  loader: ({ request }) => fetch(`/api/users/${request.id}`).then(r => r.json()),
+});
+
+// Acceso: userResource.value(), userResource.isLoading(), userResource.error()
+```
+
+### Uso de `effect`
+
+Usa `effect()` solo para efectos secundarios que deben reaccionar a cambios de signals (logging, manipulación del DOM por librerías de terceros). Nunca uses effects para sincronizar signals — usa `computed` o `linkedSignal` en su lugar. Para trabajo con el DOM después del render, usa `afterRenderEffect`.
+
+```typescript
+// CORRECTO: efecto secundario
+effect(() => console.log('Usuario cambiado:', this.user()));
+
+// INCORRECTO: usa computed en su lugar
+effect(() => { this.fullName.set(`${this.first()} ${this.last()}`); });
+```
+
+## Plantillas
+
+Usa la sintaxis de bloques de v17+. Proporciona siempre `track` en `@for`:
+
+```html
+@for (item of items(); track item.id) {
+  <app-item [item]="item" />
+}
+
+@if (isLoading()) {
+  <app-spinner />
+} @else if (error()) {
+  <app-error [message]="error()" />
+} @else {
+  <app-content [data]="data()" />
+}
+```
+
+Nada de lógica en las plantillas más allá de condicionales simples — muévela a métodos del componente o a pipes.
+
+## Formularios
+
+Elige la estrategia de formularios que coincida con el enfoque existente del proyecto:
+
+- **Signal Forms** (v21+): preferida para proyectos nuevos en v21+. Estado del formulario basado en signals.
+- **Reactive Forms**: `FormBuilder` + `FormGroup` + `FormControl`. La mejor opción para formularios complejos con validación dinámica.
+- **Template-Driven Forms**: `ngModel`. Adecuada solo para formularios simples.
+
+```typescript
+// Reactive Forms — enfoque estándar para la mayoría de las apps
+export class LoginComponent {
+  private fb = inject(FormBuilder);
+
+  form = this.fb.group({
+    email: ['', [Validators.required, Validators.email]],
+    password: ['', [Validators.required, Validators.minLength(8)]],
+  });
+
+  submit() {
+    if (this.form.valid) {
+      // usar this.form.value
+    }
+  }
+}
+```
+
+## Estilos de componente
+
+Usa estilos a nivel de componente con `ViewEncapsulation.Emulated` (predeterminado). Evita `ViewEncapsulation.None` salvo que estés construyendo un sistema de diseño que filtra estilos de forma intencional.
+
+- Acota los estilos al componente — no uses nombres de clases globales dentro de las hojas de estilo del componente
+- Usa `:host` para estilizar el elemento anfitrión
+- Prefiere propiedades personalizadas de CSS para valores tematizables
+
+## Detección de cambios
+
+- `ChangeDetectionStrategy.OnPush` por defecto en todos los componentes nuevos
+- Los signals y el pipe `async` gestionan la detección automáticamente — evita `markForCheck()` y `detectChanges()`
+- Nunca mutes objetos `@Input()` en el sitio cuando uses OnPush

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

@@ -0,0 +1,25 @@
+---
+paths:
+  - "**/*.component.ts"
+  - "**/*.component.html"
+  - "**/*.service.ts"
+  - "**/*.directive.ts"
+  - "**/*.pipe.ts"
+  - "**/*.spec.ts"
+---
+# Hooks para Angular
+
+> Este archivo extiende [common/hooks.md](../common/hooks.md) con contenido específico de Angular.
+
+## Hooks PostToolUse
+
+Configúralos en `~/.theus/settings.json`:
+
+- **Prettier**: autoformatea archivos `.ts` y `.html` después de editarlos
+- **ESLint / ng lint**: ejecuta `ng lint` tras editar código fuente Angular para detectar mal uso de decoradores, errores de plantilla y violaciones de estilo
+- **Chequeo de TypeScript**: ejecuta `tsc --noEmit` tras editar archivos `.ts`
+- **Chequeo de build**: ejecuta `ng build` tras generar o cambiar significativamente código Angular para detectar temprano errores de plantillas y de tipos
+
+## Hooks Stop
+
+- **Auditoría de lint**: ejecuta `ng lint` sobre los archivos modificados antes de finalizar la sesión para detectar violaciones pendientes