theus-cli 0.2.83 → 0.2.84

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

@@ -1,274 +0,0 @@
-{
-  "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

@@ -1,6 +0,0 @@
-{
-  "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

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

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