Primeiro sucesso com a CLI

Avalie uma pequena solicitação XLS na CPU e, opcionalmente, valide offline um envelope de job e o limite de acesso ao código-fonte.

Visão geral

Conclua primeiro a verificação e a instalação. Os comandos abaixo usam alti do diretório instalado PREFIX/bin. Execute-os como seu usuário comum, não como root.

Execute uma pequena avaliação XLS na CPU

Esta solicitação soma dois valores de 8 bits. Ela usa a engine XLS nativa limitada, não exige toolchain Google, GPU ou sessão Cloud e torna o overflow visível no 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

Exija saída 0 e o resultado da engine para ambos os vetores: bits[8]:0x0 e bits[8]:0x13. Isso comprova somente que essas entradas foram avaliadas. Para suporte mais amplo à linguagem DSLX, use o caminho Google XLS separado.

Preflight offline opcional de job

O fluxo abaixo lê o manifesto de ações e valida um envelope de job mais um arquivo de código-fonte local. Ele não lê credenciais, contata um servidor, envia código-fonte, submete trabalho ou executa uma engine RTL. Seu comprovante descreve somente a validação local; o envio e a autoridade do servidor permanecem como false.

1. Examine o manifesto de ações fornecido

Bash
alti commands

Um comando bem-sucedido escreve um array JSON em stdout e nada em stderr. Cada entrada contém name, description, inputSchema, executes, e class. A CLI pública atual retorna 25 entradas. O valor de executes descreve o contrato de despacho; o comando ainda pode exigir uma engine local, permissão de conta ou serviço hospedado.

2. Prepare um código-fonte local privado

Crie um espaço de trabalho privado no diretório de trabalho atual pertencente ao seu usuário:

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

Salve este código-fonte inofensivo como $ALTI_WORKSPACE/inputs/rtl/top.sv:

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

Torne o código-fonte legível e gravável somente por seu proprietário:

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

O preflight rejeita um código-fonte que esteja fora do espaço de trabalho, tenha mais de um vínculo, não pertença ao usuário atual ou seja gravável por um grupo ou por outros usuários. Não flexibilize a verificação de permissões.

Salve o seguinte 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" }
}

O cliente substitui a URI e o digest de exemplo na cópia de validação em memória pelo código-fonte selecionado relativo ao espaço de trabalho e pelo SHA-256 calculado.

3. Produza o comprovante offline

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

Um resultado bem-sucedido é um objeto JSON em stdout com este contrato:

Campo

Interpretação obrigatória

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

Deve ser false

server_authority_verified

Deve ser false

job_schema, job_id, operation

A identidade do envelope validada localmente

execution_placement

O posicionamento solicitado no envelope, não evidência de envio

source.workspace_uri

A URI normalizada do código-fonte relativo ao espaço de trabalho

source.sha256, source.size_bytes

As evidências do código-fonte calculadas localmente

O status de saída 0 significa apenas que esse preflight do cliente foi aprovado. Não significa que o código-fonte compilou, que um servidor aceitou o job ou que algum trabalho foi executado.

Saída de falha e status de saída

Com --json, uma falha de validação não escreve comprovante de sucesso em stdout e escreve um objeto altifigence.cli.error.v1 em stderr. Por exemplo, um JSON de job malformado produz ENGINE_JOB_JSON_INVALID com retryable: false e sai com status 1.

Para inspeção do manifesto e preflight offline:

Status de saída

Significado

0

O manifesto foi impresso ou o preflight offline do cliente foi aprovado

1

Falha de registro, E/S, limite de acesso ao código-fonte ou validação de job

2

Falha de sintaxe da linha de comando ou análise de argumentos

Outros comandos alti usam status de saída não listados nesta tabela. 3 é CLASS_NOT_ALLOWED; 4 marca uma solicitação recusada antes do despacho, e tanto alti whoami quanto alti login saem com 4 nesta versão; um comando respaldado por engine repassa o próprio status de saída da engine, além de 126 quando a engine não pode ser iniciada e 127 quando ela não é encontrada. Se seu script executar algo além dos dois comandos acima, use o contrato completo em Referência de comandos e trate todo status diferente de zero como falha por padrão.

Mantenha stdout e stderr separados e verifique o status de saída antes de analisar um comprovante. Use as páginas de comandos de engine e Cloud para execução ou envio explícitos; nenhum deles ocorre como efeito colateral do preflight offline.

Escolha a próxima etapa

Mantenha o resultado dos dois vetores na CPU como uma verificação rápida da instalação. Para avaliar seu próprio projeto, altere uma entrada por vez e preserve a solicitação e o resultado completos. Um recurso mais amplo da linguagem pode exigir o caminho Google XLS separado; uma execução CUDA exige seleção explícita do backend e um dispositivo utilizável.

Para trabalho RTL gráfico, continue com Primeira execução RTL no DDS. Para scripts, use Comandos de engine. Para arquivos remotos salvos, entre com autenticação Cloud nativa e selecione a organização e o projeto corretos.