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.
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
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:
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:
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:
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:
{
"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
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 |
|---|---|
|
|
|
|
| Deve ser |
| Deve ser |
| A identidade do envelope validada localmente |
| O posicionamento solicitado no envelope, não evidência de envio |
| A URI normalizada do código-fonte relativo ao espaço de trabalho |
| 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 |
|---|---|
| O manifesto foi impresso ou o preflight offline do cliente foi aprovado |
| Falha de registro, E/S, limite de acesso ao código-fonte ou validação de job |
| 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.