Configuración
.rei/config.json: checks, integración con GitHub Issues, visor y códigos de salida.
El archivo
.rei/config.json es la configuración del proyecto para el arnés: declara los checks rápidos que ejecuta rei check, la integración opcional con GitHub Issues y el comportamiento del visor. Vive en la raíz de .rei/ y se escribe con rei init; después se edita a mano o con los comandos que lo modifican.
{
"checks": [
{
"id": "V1",
"description": "ESLint del proyecto",
"command": ["pnpm", "lint"]
},
{
"id": "V4",
"description": "Tests de lógica y datos",
"command": ["pnpm", "test"]
}
],
"integrations": {
"github": {
"enabled": true,
"repo": "owner/name",
"base": "main",
"mergeStrategy": "squash"
}
},
"viewer": {
"autoOpenOnReady": true
}
}Las tres claves son independientes: puedes declarar checks sin GitHub Issues y configurar el visor sin checks. La ausencia de integrations.github significa que la integración está desactivada.
checks
checks es un array de checkpoints rápidos. rei check los ejecuta, además de sus propias comprobaciones del arnés, y refleja el resultado en su código de salida.
| Campo | Contenido |
|---|---|
id | Identificador estable del checkpoint, como V1 o V4. |
description | Qué valida el check, en una frase. |
command | Array de argumentos del comando. Se ejecuta sin shell intermedio. |
commandno interpreta redirecciones, tuberías ni variables de shell: cada elemento del array es un argumento literal.- Solo van aquí los checks rápidos. El build completo, e2e o la integración se documentan en
.rei/docs/project/verification.mdy se ejecutan al cerrar el Work Item. - Los ids y los comandos deben coincidir con los checkpoints declarados en la documentación del proyecto.
integrations.github
La integración con GitHub Issues es opcional y se configura bajo integrations.github. El CLI nunca llama a GitHub: los comandos solo escriben esta configuración y el agente ejecuta las acciones con gh y git.
| Campo | Valor |
|---|---|
enabled | true activa la integración; false la desactiva y conserva repo, base, mergeStrategy y los enlaces locales. |
repo | Repositorio de destino en formato owner/name. No tiene valor por defecto: sin flag ni valor previo se detecta desde el remoto origin. |
base | Rama base de respaldo. Usa main cuando no hay valor previo ni detección desde origin/HEAD. |
mergeStrategy | Estrategia de merge del PR: squash, merge o rebase. Usa squash por defecto. |
base es solo el fallback: la base efectiva se decide por Work Item en la puerta y vive en links.json, no en .rei/config.json. rei github status es offline y no conoce la base efectiva de cada Work Item.
viewer
viewer.autoOpenOnReady es un booleano. Con true, el Leader abre el visor con rei view <id> --open en la puerta de aprobación, sin bloquear la conversación. Con false o sin la clave, no ejecuta nada y el flujo es idéntico.
rei view --enableactivaviewer.autoOpenOnReadyen.rei/config.json.rei view --disablelo desactiva.- Ambos flags solo cambian esa clave y conservan el resto del archivo.
- El visor es de solo lectura: no aprueba ni modifica documentos,
meta.jsonni el estado del Work Item.
Precedencia de valores
rei github enable resuelve cada valor con la misma precedencia: flag explícito > valor previo de integrations.github > detección desde git > valor por defecto. Un enable sin flags no sobrescribe valores ya configurados.
- El flag explícito manda:
--repo owner/name,--base <rama>o--strategy squash|merge|rebase. - Si falta, se conserva el valor previo de
integrations.github. - Si tampoco existe, se detecta desde
git: origin pararepoy origin/HEAD parabase. - Si la detección falla,
baseusa main ymergeStrategyusa squash;repono tiene default y exige un origin resoluble.
Un flag desconocido, repetido, sin valor o inválido es uso incorrecto (código 2) y no escribe la configuración. Los fallos operativos —configuración inválida, remoto no resoluble o error de escritura— salen con 1.
Códigos de salida
| Código | Significado |
|---|---|
| 0 | La operación terminó correctamente, también cuando solo había avisos. |
| 1 | Falló una comprobación o el comando no pudo completarse. |
| 2 | Uso incorrecto: flag desconocido, repetido, sin valor o inválido. |
En los checks, 0 significa que todo pasó y 1 que hay al menos un [FAIL] o un check del proyecto falló. rei test informa y sale 0 cuando no hay checks configurados. El código de salida es la señal que usa el workflow: no se desactiva un check para que pase.
La firma humana libera la hoja. El silencio no aprueba.