Referencia de la CLI¶
La CLI pública de Belico Ecosystem (FASE D — v3.1.0) expone 5 comandos:
create-paper, smoke-check, verify, catalog y ecosystem. Acá tenés la
referencia completa de flags y ejemplos, verificada contra el código fuente en
src/belico/commands/.
Instalación¶
# Desde el clone del repo (recomendado durante alpha)
git clone https://github.com/Mikisbell/Belico_Jarvis.git
cd Belico_Jarvis
pip install -e ".[cli]"
# (Próximamente) desde PyPI
# pip install belico
El idioma de salida se detecta del entorno ($LANG); podés forzarlo con el flag
global --lang es|en o con la variable BELICO_LANG.
1. belico create-paper¶
Crea un paper nuevo desde el template multi-institución (esqueleto IMRaD).
| Flag | Tipo | Default | Descripción |
|---|---|---|---|
--venue |
Q1\|Q2\|Q3\|Q4\|Conference |
— (obligatorio) | Quartile objetivo. |
--domain |
SHM\|biomedical\|hydraulics\|... |
— (obligatorio) | Dominio científico. |
--client |
UC\|Scopus\|SciELO\|PUC\|free |
— (obligatorio) | Cliente target (case-insensitive). |
--output-dir |
path | articles/<auto-slug>/ |
Directorio de salida. |
--briefing |
flag | off | Invoca intake_agent (lazy import). |
--no-intake |
flag | off | Salta intake_agent explícitamente. |
--dry-run |
flag | off | No ejecuta scripts ni crea archivos. |
--lang |
es\|en |
env | Override de idioma de salida. |
# ES (detecta $LANG=es_*)
belico create-paper --venue Q1 --domain SHM --client UC --output-dir ./mi-paper
# Dry run — no escribe archivos
belico create-paper --venue Q2 --domain biomedical --client free --dry-run
2. belico smoke-check¶
Verifica conectividad de las APIs académicas externas (OpenAlex + CrossRef).
| Flag | Tipo | Default | Descripción |
|---|---|---|---|
--apis |
CSV | todas | APIs a probar (ej: openalex,crossref). |
--timeout |
int | 60 |
Timeout por test (segundos). |
--total-timeout |
int | 300 |
Timeout total del subprocess pytest. |
--no-online |
flag | off | Corre sin red (solo verifica que la suite carga). |
--json-output |
flag | off | Output JSON estructurado para CI. |
--lang |
es\|en |
env | Override de idioma. |
# Smoke check (requiere JARVIS_ONLINE_TESTS=1)
belico smoke-check
# Sin red — solo verifica que la suite carga
belico smoke-check --no-online
# JSON para integración CI
belico smoke-check --json-output
3. belico verify¶
Verifica un paper contra el harness validate_submission (patrón strangler-fig).
| Flag | Tipo | Default | Descripción |
|---|---|---|---|
--paper-id |
str | — (obligatorio) | ID del paper en articles/<paper-id>/. |
--strict |
flag | off | Escala warnings a errores (exit 1 si hay warnings). |
--json-output |
flag | off | Output JSON estructurado para CI. |
--lang |
es\|en |
env | Override de idioma. |
# Verificar por ID (busca en articles/<id>/)
belico verify --paper-id uc-shm-20260415
# Strict — warnings escalan a exit 1
belico verify --paper-id mi-paper --strict
# JSON envelope
belico verify --paper-id mi-paper --json-output
4. belico catalog¶
Lista harnesses, sub-agentes, tools y skills disponibles. Es la fuente que alimenta las páginas de catálogo auto-generadas (Harnesses, Skills, Sub-agentes, Tools).
| Flag | Tipo | Default | Descripción |
|---|---|---|---|
--type |
harness\|agent\|tool\|skill\|all |
all |
Filtra por categoría. |
--status |
active\|planned\|planned-v0\|deprecated\|all |
all |
Filtra por estado. |
--output-format |
table\|json\|yaml |
table |
Formato de salida. |
--limit |
int | sin límite | Máximo de filas por categoría. |
--lang |
es\|en |
env | Override de idioma. |
# Todas las categorías
belico catalog
# Filtrar por tipo
belico catalog --type harness
# Filtrar por estado
belico catalog --status active
# Output JSON (consumido por tools/gen_catalog_md.py)
belico catalog --output-format json
5. belico ecosystem¶
Snapshot del estado del ecosystem (commits recientes + roadmap + counts).
| Flag | Tipo | Default | Descripción |
|---|---|---|---|
--status |
flag | on | Muestra el snapshot de estado (default). |
--deep |
flag | off | Incluye parse de coverage (coverage.xml), más lento. |
--commits |
int | 10 |
Cantidad de commits recientes a mostrar. |
--commits-since |
int | 7 |
Días hacia atrás para el git log. |
--output-format |
panel\|json |
panel |
Formato de salida. |
--lang |
es\|en |
env | Override de idioma. |
# Default — panel rich
belico ecosystem
# Deep — incluye coverage (lento)
belico ecosystem --deep
# Últimos 20 commits
belico ecosystem --commits 20
# JSON
belico ecosystem --output-format json
Códigos de salida¶
| Code | Significado |
|---|---|
0 |
Éxito / OK |
1 |
Warnings con --strict |
2 |
Errores blocker o fallo de subprocess |
3 |
Recurso no encontrado (paper-id, etc.) |
130 |
Cancelado por usuario (Ctrl-C) |
Estado
178 tests verdes · coverage TOTAL 89% · CI matrix Ubuntu/Windows/macOS × Python 3.10/3.11/3.12.