CLI (acctl)

acctl es la interfaz de línea de comandos para operadores y desarrolladores de Asset Core. Envuelve flujos de trabajo comunes para ejecutar daemons, diagnósticos, reproducción y gestión de adaptadores.

Requisitos Previos

Conjunto de herramientas de Rust (estable)
Binarios de Asset Core construidos (cargo build --release)

Paso 1 - Instalar acctl

Construya la CLI desde el repositorio:

cargo build --release -p acctl

El binario se encuentra en target/release/acctl.

Paso 2 - Ver comandos disponibles

acctl --help

Comandos disponibles:

Comando	Descripción
`run`	Iniciar daemon con descubrimiento de configuración
`tail`	Transmitir eventos desde el registro de confirmaciones
`replay`	Repetir eventos fuera de línea para análisis
`snapshot`	Crear o restaurar instantáneas
`diag`	Ejecutar diagnósticos del entorno
`adapters`	Iniciar adaptadores de protocolo
`bundle-debug`	Crear archivo de depuración para incidentes

Paso 3 - Ejecutar diagnósticos

Verifique su entorno y configuración:

acctl diag --print-config

Esto valida:

Rutas de archivos de configuración
Accesibilidad del registro de commits
Versiones de la cadena de herramientas

Paso 4 - Seguir el registro de commits

Transmitir eventos a medida que se confirman:

acctl tail --commit-log /path/to/commit_log.log

Opciones:

Bandera	Descripción
`--follow`	Continuar transmitiendo nuevos eventos
`--format`	Formato de salida: `json` o `summary`
`--from`	Comenzar desde una secuencia específica

Paso 5 - Repetir para análisis

Reproducir eventos sin conexión para analizar el estado:

acctl replay \
  --commit-log /path/to/commit_log.log \
  --from 0 \
  --to 1000

Replay produce resúmenes deterministas sin ejecutar el daemon completo.

Paso 6 - Crear instantáneas

Exportar el estado actual como un instantáneo JSON:

acctl snapshot create \
  --commit-log /path/to/commit_log.log \
  --output snapshot.json

Restaurar desde la instantánea:

acctl snapshot restore \
  --input snapshot.json \
  --commit-log /path/to/commit_log.log

Paso 7 - Lanzar adaptadores

Inicie el servidor MCP para la integración de herramientas de IA:

acctl adapters \
  --config /path/to/write.toml \
  --read-config /path/to/read.toml \
  --transport stdio

Opciones:

Bandera	Descripción
`--transport`	Protocolo: `stdio` o `sse`
`--port`	Puerto de escucha SSE (solo SSE)

Paso 8 - Crear paquetes de depuración

Empaquetar artefactos para la triage de incidentes:

acctl bundle-debug \
  --config /path/to/write.toml \
  --output debug-bundle.tar.gz

El paquete incluye:

Archivos de configuración
Segmentos del registro de confirmaciones

Puntos de control

Extracción de métricas de Prometheus
Manifiesto con marcas de tiempo

Solución de problemas

”Archivo de configuración no encontrado”

Especifique la ruta completa a su configuración:

acctl run --config /absolute/path/to/config.toml

“Registro de commits no accesible”

Verifique los permisos de archivo y que la ruta exista:

ls -la /path/to/commit_log.log

“Binario del adaptador no encontrado”

Construya primero los adaptadores:

cargo build --release -p assetcore-adapters

Variables de entorno

acctl respeta estas variables de entorno:

Variable	Descripción
`ASSETCORE_WRITE_URL`	Sobrescribir la URL del daemon de escritura
`ASSETCORE_READ_URL`	Sobrescribir la URL del daemon de lectura

Próximos pasos

Conceptos básicos de implementación - Ejecución de daemons en producción
Salud y Métricas - Monitoreo de puntos finales
Integración MCP - Uso del adaptador MCP