Primer resultado satisfactorio con la CLI

Evalúa una pequeña solicitud XLS en CPU y, opcionalmente, valida sin conexión un sobre de trabajo y los límites del código fuente.

Descripción general

Completa primero la verificación y la instalación. Los comandos siguientes utilizan alti desde el directorio PREFIX/bin instalado. Ejecútalos como tu usuario habitual, no como root.

Ejecuta una pequeña evaluación de XLS en CPU

Esta solicitud suma dos valores de 8 bits. Usa el motor XLS nativo acotado, no requiere la cadena de herramientas de Google, GPU ni una sesión de Cloud, y hace visible el desbordamiento en el resultado.

Bash
alti capabilities
alti xls eval --request - <<'JSON'
{
  "schema": "altifigence.xls.operation-request.v1",
  "operation": "eval",
  "input_kind": "xls-ir",
  "source": "package demo\ntop fn compute(x: bits[8], y: bits[8]) -> bits[8] { ret sum: bits[8] = add(x, y) }",
  "top": "compute",
  "backend": "cpu",
  "vectors": [["255", "1"], ["0x10", "0b11"]]
}
JSON

Exige una salida 0 y el resultado del motor para ambos vectores: bits[8]:0x0 y bits[8]:0x13. Esto solo demuestra que se evaluaron estas entradas. Para una compatibilidad más amplia con el lenguaje DSLX, usa la ruta independiente de Google XLS.

Comprobación previa opcional de trabajos sin conexión

El flujo siguiente lee el manifiesto de acciones y valida un sobre de trabajo junto con un archivo fuente local. No lee credenciales, contacta con un servidor, sube código fuente, envía trabajo ni ejecuta un motor RTL. Su comprobante describe únicamente la validación local; el envío y la autoridad del servidor permanecen false.

1. Inspecciona el manifiesto de acciones incluido

Bash
alti commands

Un comando satisfactorio escribe un único array JSON en stdout y nada en stderr. Cada entrada contiene name, description, inputSchema, executes, y class. La CLI pública actual devuelve 25 entradas. El valor de executes describe el contrato de despacho; el comando aún puede requerir un motor local, permiso de cuenta o un servicio alojado.

2. Prepara código fuente local privado

Crea un espacio de trabajo privado en tu directorio de trabajo actual, propiedad de tu usuario:

Bash
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"

Guarda este código fuente inocuo como $ALTI_WORKSPACE/inputs/rtl/top.sv:

SystemVerilog
module top(input logic clock, output logic value);
    always_ff @(posedge clock) value <= ~value;
endmodule

Haz que solo su propietario pueda leer y escribir el código fuente:

Bash
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"

La comprobación previa rechaza código fuente que esté fuera del espacio de trabajo, tenga más de un enlace, no sea propiedad del usuario actual o pueda ser escrito por un grupo u otros usuarios. No relajes la comprobación de permisos.

Guarda lo siguiente como $ALTI_WORKSPACE/job.json:

JSON
{
  "schema": "altifigence.engine.job.v1",
  "job_id": "offline-job-1",
  "operation": {
    "engine_id": "rtl-engine",
    "operation_id": "analyze",
    "contract_id": "rtl-analysis-request.v1"
  },
  "execution_placement": "cloud",
  "device_preference": {
    "selection": { "mode": "class", "value": "cpu" },
    "fallback": "deny"
  },
  "resources": {
    "cpu_slots": 1,
    "memory_bytes": 536870912,
    "device_slots": 0,
    "device_memory_bytes": 0,
    "max_wall_time_ms": 30000
  },
  "inputs": [
    {
      "artifact_id": "rtl-source-bundle",
      "role": "source_bundle",
      "artifact_schema": "rtl-source-bundle.v1",
      "uri": "workspace://inputs/placeholder",
      "sha256": "0000000000000000000000000000000000000000000000000000000000000000"
    }
  ],
  "cancellation": { "cancellation_id": "cancel-offline-job-1" }
}

El cliente sustituye el URI y el resumen criptográfico de marcador de posición, en su copia de validación en memoria, por el código fuente seleccionado relativo al espacio de trabajo y el SHA-256 calculado.

3. Genera el comprobante sin conexión

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

Un resultado satisfactorio es un único objeto JSON en stdout con este contrato:

Campo

Interpretación requerida

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

Debe ser false

server_authority_verified

Debe ser false

job_schema, job_id, operation

La identidad del sobre validada localmente

execution_placement

La ubicación solicitada en el sobre, no evidencia de un envío

source.workspace_uri

El URI de código fuente normalizado relativo al espacio de trabajo

source.sha256, source.size_bytes

La evidencia del código fuente calculada localmente

El estado de salida 0 solo significa que esta comprobación previa del cliente fue satisfactoria. No significa que el código fuente se haya compilado, que un servidor haya aceptado el trabajo ni que se haya ejecutado tarea alguna.

Salida de errores y estado de salida

Con --json, un fallo de validación no escribe un comprobante satisfactorio en stdout y escribe un único objeto altifigence.cli.error.v1 en stderr. Por ejemplo, un JSON de trabajo mal formado produce ENGINE_JOB_JSON_INVALID con retryable: false y termina con estado 1.

Para la inspección del manifiesto y la comprobación previa sin conexión:

Estado de salida

Significado

0

Se imprimió el manifiesto o la comprobación previa sin conexión del cliente fue satisfactoria

1

Fallo de registro, E/S, límites de código fuente o validación del trabajo

2

Fallo de sintaxis de línea de comandos o de análisis de argumentos

Otros comandos alti usan estados de salida que no figuran en esta tabla. 3 es CLASS_NOT_ALLOWED; 4 indica una solicitud rechazada antes del despacho, y tanto alti whoami como alti login terminan con 4 en esta versión; un comando respaldado por un motor transmite el estado de salida propio del motor, además de 126 cuando el motor no puede iniciarse y 127 cuando no se encuentra. Si tu script va a ejecutar algún comando más que los dos anteriores, usa el contrato completo de Referencia de comandos y trata por defecto todo estado distinto de cero como un fallo.

Mantén stdout y stderr separados y comprueba el estado de salida antes de analizar un comprobante. Usa las páginas de comandos de motor y Cloud para ejecutar o enviar explícitamente; ninguna de esas acciones ocurre como efecto secundario de la comprobación previa sin conexión.

Elige el siguiente paso

Conserva el resultado de CPU de los dos vectores como comprobación rápida de instalación. Para evaluar tu propio diseño, cambia una entrada cada vez y conserva la solicitud y el resultado completos. Una función de lenguaje más amplia puede requerir la ruta independiente de Google XLS; una ejecución CUDA requiere seleccionar explícitamente el backend y disponer de un dispositivo utilizable.

Para trabajo RTL gráfico, continúa con Primera ejecución RTL de DDS. Para scripts, usa Comandos de motor. Para archivos guardados remotos, inicia sesión mediante autenticación nativa de Cloud y selecciona la organización y el proyecto correctos.