Pular para o conteúdo
ClickHouse Loom
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Versões suportadas

Versões suportadas

Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.

As versões N e N−1 recebem correções, e um SDK em X.Y funciona com um servidor em X.Y ou X.(Y−1). O Loom publica uma única versão para o servidor, as duas imagens, o aplicativo web, os dois SDKs, as skills da raiz e o appVersion do chart Helm (processo de release). Esta página também trata dos plugins de agentes de código e de como se anuncia uma mudança que remove algo.

Linhas de release

Linha O que recebe
N a versão minor mais recente (X.Y): todas as correções, como release de patch (X.Y.(Z+1)) quando não podem esperar
N−1 a versão minor anterior: correções de segurança e correções de perda de dados ou de resposta errada, como patches
N−2 nenhuma: atualize para N ou N−1

Uma versão minor sai da main aproximadamente a cada duas semanas; um patch sai da branch release/X.Y da linha, com a correção integrada primeiro à main. Uma atualização segue atualizações; duas versões adjacentes atendem lado a lado enquanto uma substitui a outra (atualizações graduais).

SDKs e servidores

Os SDKs (clickhouse-loom no PyPI, @clickhouse/loom no npm) são publicados a cada release, na versão do servidor; o latest do npm aponta para a final mais alta, e um patch de uma linha mais antiga recebe a dist-tag release-X.Y. Com o servidor mais antigo:

  • um campo que o SDK envia e que o servidor mais antigo não conhece é atendido e citado em ignored_args na resposta, exceto em uma op que altera estado, em que uma chave que o servidor interpreta como erro de grafia de um de seus campos (um nome próximo, um sinônimo, uma palavra do nome de um campo) é recusada com 422 UNKNOWN_ARGUMENT e nada é gravado (campos desconhecidos e removidos);
  • uma operação que o servidor mais antigo não atende responde 404, que os SDKs lançam como NotFound (Python loom.errors.NotFound, TypeScript NotFound): uma chamada nunca tem sucesso em silêncio contra um servidor que não consegue executá-la. O mesmo erro indica uma linha ausente, então um cliente que precise distinguir os dois lê ops.capabilities na inicialização (como descobrir o que um deployment atende).

Uma versão major (X.0) pode quebrar a regra em relação ao último servidor (X−1).Y; suas notas de release dizem do que um SDK em X.0 precisa.

Um SDK mais antigo continua funcionando com um servidor mais novo enquanto o servidor atender ao que ele chama; uma remoção segue a regra abaixo.

Plugins de agentes de código

Os plugins do Claude Code e do Codex têm sua própria versão e indicam o servidor mais antigo que seus hooks suportam (MIN_SERVER_VERSION em lib/server-version.mjs). Uma sessão com um servidor mais antigo começa com uma linha loom: informando isso, e o plugin continua funcionando onde for possível (Claude Code). O plugin do Claude Code exige o Claude Code 2.1.139 ou mais recente, a primeira versão que executa os args de um hook sem shell.

Remoção de algo

Uma remoção é anunciada, manualmente no pull request de release, nas notas de release da versão minor anterior à que a remove, em “What changed for clients”. Até a remoção, o servidor atende o campo ou a op antiga; depois dela, um campo de requisição removido ainda é aceito e citado em ignored_args, de modo que um cliente que o envia fica sabendo da mudança sem falhar, e uma op removida responde 404 (NotFound), que ops.capabilities distingue de uma linha ausente.

Artefatos de release

Toda imagem de release é construída na arquitetura em que roda, verificada quanto a vulnerabilidades críticas com correção disponível e publicada com sua proveniência e um SBOM. O índice multi-arch de cada imagem traz uma assinatura keyless do workflow de release; imagens de contêiner traz o comando cosign verify. Cada arquivo no GitHub Release é assinado da mesma forma, em um <file>.sigstore.json ao lado dele; arquivos de release traz o comando cosign verify-blob.

Esta página foi útil?