Jorge
5e77619d37
Crea el slash command `/md-lint` para barrer cualquier `.md` del repo contra un set mínimo de reglas (MD004, MD030, MD031, MD032, MD036, MD040, MD026, MD047, MD034) sin añadir markdownlint-cli2 como devDep. Aplica el primer pase: 7 fences sin lenguaje declarado pasan a `text` en check.md, md-lint.md, SKILL.md, EVENTS-RABBITMQ.md y HOUSE-STYLE.md. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
---
|
|
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.
|