Contrato de ações e capacidades
Distinga descoberta de ações, relatórios de capacidades instaladas, preflight, execução e autoridade do servidor.
Visão geral
A CLI oferece um manifesto de ações, preflight offline, descoberta de capacidades instaladas e comandos nativos explícitos. O bootstrap 0.1.9 cria a estrutura instalada assinada necessária para as capacidades. Essas saídas respondem a perguntas diferentes; nenhuma deve ser tratada como prova das outras.
Manifesto de ações do cliente
O manifesto versionado contém 25 ações:
22 ações são marcadas como
executes=true;altifigence.analyze.run,altifigence.evolve.launchealtifigence.verify.runsão as três ações que apenas geram planos.
executes=true significa que a ação é definida como executável. O comando real ainda pode precisar de uma engine local, permissão de conta ou serviço remoto. Uma ação que apenas gera planos valida e retorna um plano sem executar um job.
Use alti commands para examinar o manifesto fornecido com o binário atual. Não copie uma lista de comandos de outra versão.
Comprovante de preflight offline
O fluxo offline de job validate verifica um envelope RTL limitado de CPU e um código-fonte seguro relativo ao espaço de trabalho. Um comprovante bem-sucedido declara explicitamente submitted: false e server_authority_verified: false. Ele não executa uma engine local nem contata um serviço hospedado. Consulte Primeiro sucesso com a CLI.
Contrato de capacidades da engine instalada
O esquema de capacidades define estes estados para uma versão corretamente instalada e respaldada por comprovantes:
Estado | Significado |
|---|---|
| A versão instalada oferece a interface local documentada |
| Somente o subconjunto informado está disponível |
| A versão instalada não pode oferecer a interface |
| A interface exige adesão explícita e documentada |
| A ação retorna um plano em vez de evidências de execução |
Siga Verificar downloads e Instalar no Linux antes de usar alti capabilities. O bootstrap embutido cria a estrutura autenticada de catálogo e comprovantes; não copie um binário para outro local nem fabrique esse estado. A prontidão instalada informa as capacidades disponíveis. As evidências de que um projeto ou job de GPU foi executado vêm do resultado de sua execução.
Pergunta | Respondida por |
|---|---|
Este comando foi executado aqui e com qual resultado? | O próprio status de saída do comando e a linha do comprovante que identifica o binário, a resolução e o status |
Esta versão instalada informa que a capacidade está disponível? | Um relatório bem-sucedido de |
Um comando local bem-sucedido informa o que foi executado naquela máquina. Automações que dependem de uma capacidade do produto instalado também devem exigir o relatório de capacidades.
O envio de código-fonte exige adesão
No modo padrão de cliente, o servidor MCP stdio empacotado oculta as três ações de plano que podem incluir arquivos de código-fonte. Elas exigem credenciais de ambiente separadas e usam o cliente Cloud. A versão pública atual não oferece um fluxo completo de execução remota para elas.
O modo separado ALTI_MCP_MODE=local-xls expõe ferramentas XLS locais fixas sem despacho para o Cloud. As operações nativas de ide cloud usam seu próprio login e regras explícitas de envio; o estado das ações de cliente que apenas geram planos não descreve todas as operações de espaços de trabalho Cloud.
Uma adesão permite a transmissão; não transforma uma ação de plano em uma execução real nem torna um serviço remoto disponível.
Trate cada resultado separadamente
Ao automatizar a CLI, trate estes resultados como estados diferentes:
uma capacidade local está disponível;
uma solicitação foi validada;
um plano foi retornado sem execução;
o trabalho foi aceito por uma autoridade explicitamente habilitada;
o trabalho foi concluído e produziu evidências;
uma capacidade ou autoridade estava indisponível.
Reduzir esses estados a um único valor de sucesso pode fazer um plano ou uma prévia parecer trabalho de engenharia concluído.
Selecione o contrato de resultado correto
Para uma execução local, registre a engine selecionada, o digest da entrada, o status de saída nativo e o resultado completo. Para uma alteração de arquivo salvo, preserve o plano e o comprovante de aplicação e releia o arquivo. Para um job remoto, acompanhe seu ID até um estado terminal, depois obtenha e verifique o resultado real. Uma entrada no manifesto de ações apenas descreve a interface que pode ser chamada.
Mantenha envelopes de solicitações de engines locais, ações de plano do cliente e jobs RTL salvos no Cloud separados na automação. Eles diferem no esquema de entrada, na localização do código-fonte, na autenticação, no envio e no tratamento dos resultados, mesmo quando seus nomes contêm “analyze” ou “evolve”.