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_argsna 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 com422 UNKNOWN_ARGUMENTe nada é gravado (campos desconhecidos e removidos); - uma operação que o servidor mais antigo não atende responde
404, que os SDKs lançam comoNotFound(Pythonloom.errors.NotFound, TypeScriptNotFound): 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.capabilitiesna 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.