Guías · Checks

Checks

Declarar los checks rápidos en .rei/config.json y ejecutarlos con rei check o rei test.

Checks rápidos · código de salida 0/1

Cuándo usarla

Usa esta guía cuando quieras que rei check ejecute las verificaciones rápidas de tu proyecto —lint, tests de lógica, type-check— y te devuelva un resultado único antes de implementar o de solicitar una revisión.

Requisitos

  • Un proyecto inicializado con .rei/config.json.
  • Los checkpoints rápidos definidos en .rei/docs/project/verification.md.
  • Los comandos disponibles en el PATH del proyecto.
  • Ningún check lento: el build completo, e2e o integración no van en la configuración.

Pasos

  1. Identifica los checkpoints rápidos de verification.md y su identificador estable, por ejemplo V1 o V4.
  2. Declara cada uno en checks dentro de .rei/config.json con id, description y command. El comando es un array de argumentos y se ejecuta sin shell intermedio.
  3. Ejecuta rei check para verificar el arnés y correr los checks declarados. Añade --quiet si quieres omitir los [OK] y el resumen.
  4. Ejecuta rei test cuando solo quieras los checks de .rei/config.json, sin el resto de comprobaciones del arnés.
  5. Si algún check falla, corrige la causa y vuelve a ejecutarlo antes de solicitar revisión.
.rei/config.json
{
  "checks": [
    {
      "id": "V1",
      "description": "ESLint del proyecto",
      "command": ["pnpm", "lint"]
    },
    {
      "id": "V4",
      "description": "Tests de lógica y datos",
      "command": ["pnpm", "test"]
    }
  ]
}
Ejecución
rei check
rei check --quiet
rei test

Verificación

ResultadoCódigoQué significa
Todo pasa0Los checks declarados terminaron sin fallos.
Algún fallo1Hay al menos un [FAIL] o un check del proyecto falló.
Sin checks0rei test informa de que no hay checks configurados.

Corrige el fallo y repite el comando. No solicites revisión con un check en rojo ni lo desactives para que pase: el código de salida es la señal que usa el workflow.

Límites

  • Los checkpoints lentos, como el build de producción, se documentan en verification.md y se ejecutan al cerrar el Work Item.
  • rei check ejecuta los comandos sin shell intermedio: no interpreta redirecciones, tuberías ni variables de shell.
  • La configuración no sustituye verification.md ni justifica checks que no demuestren nada.
  • Un check que tarda demasiado no se añade a la configuración: convierte la verificación diaria en una espera.

Siguiente paso

Con los checks en verde, el Work Item puede ir a revisión. Si quieres actualizar el arnés o el binario, la guía de actualización explica el orden.

Aprobación de la planificación

Pendiente

La firma humana libera la hoja. El silencio no aprueba.

La aprobación se registra desde el CLI; el visor no la sustituye.