Referencia de comandos de la CLI

Descripción general

Usa el binario instalado después de la verificación y instalación. Esta referencia distingue el descubrimiento de comandos, resultados de ejecución, comprobantes de comprobación previa y respuestas de servicio.

Manifiesto de acciones

Una ejecución correcta escribe una matriz JSON. Cada entrada tiene name, description, inputSchema, executes, y class. El manifiesto de cliente integrado tiene 25 acciones, de las cuales 22 tienen executes: true. altifigence.analyze.run, altifigence.evolve.launch, y altifigence.verify.run solo generan planes. Los subcomandos nativos de CLI tienen su propia ayuda final más allá de este manifiesto del cliente. La respuesta del servidor determina si una operación de servicio está autorizada y lista.

Usa la ayuda de la operación final para los argumentos nativos:

alti commands

alti xls upstream run --help
alti compute rtl-evolve --help
alti ide workspace hierarchy-plan --help
alti ide cloud search --help
alti ide service workspace replace --help

Comprobación previa de trabajos sin conexión

Prepara las fuentes y el sobre en Primer éxito con la CLI y después ejecuta:

El esquema de éxito es altifigence.cli.engine-job-preflight.v1. submitted: false y server_authority_verified: false son obligatorios: el hash fuente y la estructura del trabajo se comprobaron localmente, pero no se envió ni ejecutó ningún trabajo. El execution_placement solicitado en un sobre no cambia esto.

alti --json job validate \
  --job "$ALTI_WORKSPACE/job.json" \
  --workspace-root "$ALTI_WORKSPACE" \
  --source rtl/top.sv

Contrato de errores JSON

Un --json job validate fallido no escribe ningún comprobante de éxito en stdout y emite un objeto altifigence.cli.error.v1 en stderr:

Usa error.code cuando esté disponible. Otras familias de comandos tienen sus propios esquemas de error; no supongas que este sobre se aplica a todos los comandos de CLI.

{
  "schema": "altifigence.cli.error.v1",
  "error": {
    "code": "ENGINE_JOB_JSON_INVALID",
    "message": "The engine job JSON is invalid.",
    "retryable": false
  }
}

Estado de salida

Comprueba siempre el estado de salida antes de analizar stdout y conserva stderr separado. Un archivo de salida vacío o parcial no es un resultado correcto. Un plan guardado no es una transacción aplicada, y la aceptación del servidor no es la finalización de un trabajo.

Comandos de Engine: qué se ejecuta realmente

Los adaptadores XLS, compute y DDS nativo utilizan ejecutables hermanos fijos empaquetados. La ejecución instalada autentica el runner correspondiente contra su registro firmado de publicación; añadir otro ejecutable a PATH no puede reparar la ausencia de un hermano requerido. Algunos comandos antiguos de compatibilidad conservan su comportamiento documentado de resolución. Consulta Superficie de comandos.

Sin --json, stdout del motor se transmite para poder guardar directamente un plan nativo opaco. Con --json, una invocación de Engine normalmente produce altifigence.local-engine-execution.v1; sus campos stdout y stderr contienen los flujos del hijo como cadenas. Analiza el resultado interior por separado.

Para planes de archivos y jerarquías, pasa el resultado completo del plan nativo al comando de aplicación correspondiente. No pases el sobre externo de la CLI ni solo un resumen criptográfico del plan. El backend nativo valida hashes actuales de archivos y las condiciones de su transacción.

Salida de servicio y transmisión

ide service devuelve altifigence.dds.service-receipt.v1 con operation, ok, httpStatus y la respuesta acotada body. HTTP 409 de una sustitución sigue siendo un conflicto y no se reintenta. Una respuesta DELETE correcta y vacía se conserva vacía; no se inventa un objeto JSON del servidor.

La búsqueda DDS nativa y la búsqueda Cloud exponen su propia evidencia de coincidencias/contenido. Usa la identidad proporcionada por el backend en el que escribirás; un hash calculado para otro backend de búsqueda no es automáticamente un token CAS válido.

ide cloud terminal transmite bytes de terminal por stdout y el estado de conexión por stderr. No es un comprobante JSON único, incluso con la opción global --json. Acota la duración de la conexión y conserva el cursor si prevés reconectar.

--json release install y --json release uninstall emiten altifigence.cli.release-bootstrap.v1 con operation, ok y exitCode. Los diagnósticos del instalador van a stderr. Los fallos de verificación o privilegios pueden ocurrir antes de que exista un sobre de éxito.

Captura un resultado para automatización

Selecciona un directorio de salida nuevo para cada invocación. Guarda stdout y stderr por separado, captura el estado de salida inmediatamente y analiza un esquema de éxito solo tras salir con cero. Con un sobre de Engine, analiza su cadena stdout como documento nativo solo cuando el contrato del comando diga que contiene JSON.

Para un flujo de plan/aplicación, conserva el plan nativo bruto completo y usa el mismo proyecto. Revisa los archivos afectados y los hashes actuales antes de aplicar. Un conflicto requiere una lectura nueva y un plan revisado; no justifica descartar comprobaciones de hashes. Consulta Automatización y CI para una comprobación local reproducible.