Verificar un paper¶
Cuando tu borrador tiene contenido, belico verify lo valida contra el harness validate_submission (strangler-fig). En este tutorial vas a correr la verificación, interpretar los gates y entender los códigos de salida.
Pre-requisito
El paper debe existir en articles/<paper-id>/paper.md (o draft.md como fallback). Si lo creaste con belico create-paper, el paper-id es el slug que devolvió ese comando.
Paso 1 — Correr la verificación¶
La CLI resuelve el path del paper, invoca el adapter de validación y renderiza una tabla de gates con su estado.
Paso 2 — Leer los estados¶
Cada fila de la tabla es un gate o un issue. Los estados posibles:
| Estado | Significado |
|---|---|
| PASS | El gate pasó sin problemas |
| WARN | Advertencia — no bloquea salvo --strict |
| BLOCKER | Issue crítico — bloquea la submission |
Al pie aparece un resumen con la cuenta de blockers, warnings y gates en verde.
Paso 3 — Modo estricto para CI¶
En un pipeline de CI conviene escalar los warnings a errores:
Con --strict, cualquier WARN devuelve exit code 1.
Paso 4 — Salida JSON para automatización¶
Para parsear el resultado desde un script:
Devuelve un objeto con paper_id, status, passed, blockers, warnings, issues[] y returncode.
Códigos de salida¶
| Código | Significado |
|---|---|
0 |
PASS — sin blockers ni warnings (o warnings sin --strict) |
1 |
WARN + --strict |
2 |
BLOCKER — al menos un issue crítico |
3 |
paper-id no encontrado, o el adapter lanzó excepción |
Paso 5 — Cuando el paper no existe¶
Si pasás un paper-id inexistente, la CLI te muestra la lista de papers disponibles que detecta en articles/. Verificá que escribiste bien el slug.
Qué valida por dentro¶
El comando no reimplementa la lógica de validación: invoca ValidateSubmissionAdapter, que encapsula el harness heredado y devuelve un envelope canónico. Los issues se clasifican heurísticamente en tres niveles (BLOCKER / WARN / INFO) según su texto.
Anti-IA y citas
Los gates anti-prosa-IA, la trazabilidad de datos (RSN, manifest) y el rigor estadístico Q1/Q2 corren dentro del harness. Ver Pipeline → VERIFY y las reglas del stack.
Ver también¶
- Tu primer paper — crear el paper antes de verificarlo.
- Referencia de la CLI — todos los flags de
verify. - FMEA del stack — los modos de falla que estos gates mitigan.