sf-sim/.claude/commands/check.md

---
description: Comprueba typecheck, lint, format y tests del workspace. Opcional, no bloqueante. No hay CI que lo ejecute, así que el repo arrastra errores legacy.
---

# /check — verificación local manual

Ejecuta las comprobaciones del workspace. Argumento opcional: ruta de package o fichero para acotar (ej. `packages/sim-consumidor-nos`).

## Cómo ejecutar

Si **no** hay argumento, corre las cuatro comprobaciones del workspace completo:

```bash
yarn typecheck
yarn lint
yarn format:check
yarn vitest run
```

Si hay argumento (`$ARGUMENTS`), acota:

- `$ARGUMENTS` apunta a un package → ejecuta los comandos dentro de ese workspace cuando sea posible (`yarn workspace <name> typecheck` no existe globalmente; usa `yarn lint $ARGUMENTS` para acotar lint, y `yarn vitest run $ARGUMENTS/**/*.test.ts` para acotar tests).
- `$ARGUMENTS` apunta a un fichero `.test.ts` → solo ejecuta `yarn vitest run $ARGUMENTS`.

Ejecuta los comandos en paralelo cuando sean independientes; reporta los resultados al final.

## Cómo interpretar los resultados

**Importante:** este repo NO tiene CI ejecutando estas comprobaciones. Es esperable que arrastre errores legacy de typecheck, lint y format. La regla:

- **NO bloquees** el trabajo del usuario por errores preexistentes.
- **SÍ alerta** sobre errores que el cambio actual haya introducido o tocado.
- Si no puedes distinguir nuevos vs preexistentes (no tienes diff de referencia), reporta el conteo total y deja al usuario decidir.

## Formato de reporte

Resumen breve, por comprobación:

```text
typecheck: 47 errores (estado del repo, no necesariamente de tu cambio)
lint:      132 errores, 89 warnings (idem)
format:    3 ficheros con formato incorrecto
tests:     ✅ 24/24 passing
```

Si has hecho cambios en esta sesión y puedes correlacionar errores con esos cambios, sepáralos:

```text
typecheck:
  - 1 error nuevo en packages/sim-shared/domain/Order.ts:42 (introducido por este cambio)
  - 46 errores preexistentes (sin cambios)
```

## Cuándo invocarlo

Es **opcional**. Casos de uso típicos:

- Antes de abrir un PR, para tener una idea del estado.
- Tras un cambio grande, para detectar si has roto algo.
- Para acotar a un package que estás tocando (`/check packages/sim-consumidor-nos`).

No lo invoques de oficio en cada turno — solo cuando aporte valor.