CLI (acctl)

acctl es la interfaz de operador autorizada para Asset Core. Envuelve los flujos de trabajo que necesitas para validar la gobernanza, realizar diagnósticos, reproducir el estado y recuperarte de fallos cuando la automatización no es suficiente.

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

La lista de comandos a continuación es una referencia. Para obtener orientación centrada en tareas, consulte la Guía del Operador ACCTL.

Comandos disponibles:

Comando	Descripción
`adapters`	Lanzar adaptadores de protocolo (MCP/OpenAI/Gemini)
`auth`	Autenticar, inspeccionar permisos y gestionar tokens
`run`	Lanzar demonios con descubrimiento de configuración y arranque
`namespaces`	Listar, aprovisionar y actualizar espacios de nombres
`read-stream`	Transmitir confirmaciones de demonios de lectura a través de SSE
`tail`	Transmitir sobres desde el registro de sobres
`replay`	Repetir sobres sin conexión para análisis
`query-commits`	Consultar historial de confirmaciones a través de demonios de lectura
`query-container-commits`	Historial de confirmaciones para un contenedor
`list-containers`	Listar contenedores con filtros
`get-container-contents`	Obtener saldos, espacios o contenidos de la cuadrícula
`get-container-grid`	Inspeccionar ocupación de la cuadrícula (región opcional)
`find-grid-free`	Encontrar anclajes de cuadrícula libres para una forma
`list-instances`	Listar instancias con filtros
`get-instance`	Obtener metadatos de la instancia
`owner-summary`	Agregar datos para un propietario
`snapshot`	Crear o restaurar instantáneas
`diag`	Ejecutar diagnósticos del entorno y comprobaciones de puntos finales
`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 del sobre

Transmitir eventos a medida que se confirman:

acctl tail --envelope-log /path/to/envelope.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 \
  --envelope-log /path/to/envelope.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 \
  --envelope-log /path/to/envelope.log \
  --output snapshot.json

Restaurar desde la instantánea:

acctl snapshot restore \
  --input snapshot.json \
  --envelope-log /path/to/envelope.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 URL del daemon de escritura
`ASSETCORE_READ_URL`	Sobrescribir URL del daemon de lectura
`ACCTL_ALLOW_PLAINTEXT_TOKEN_STORE`	Permitir almacenamiento de tokens en texto plano cuando el llavero no está disponible
`ASSETCORE_BASE_DIR`	Sobrescribir el directorio base para rutas resueltas

Próximos pasos

Conceptos básicos de implementación - Ejecución de daemons en producción
Salud y Métricas - Monitoreo de puntos finales
Guía de Herramientas - Superficie de herramientas del adaptador canónico