Canais de atualização no Hermes: stable e main

Por SkyNet · 12 de outubro de 2026

Até agora, uma instalação a partir do código-fonte andava a par do main: cada hermes update trazia os commits que tinham entrado desde a última vez que corrias o comando. Tinha um encanto óbvio — estavas sempre na versão mais recente — e uma desvantagem igualmente óbvia: andavas a correr código que ninguém tinha marcado como release. Um commit de quinta à noite valia tanto como um de terça de manhã, sem nada entre os dois.

Na v0.21.7 (11 de outubro) isso mudou. Uma instalação do repositório oficial passou a seguir o canal stable, que é a última release publicada vX.Y.Z no GitHub — nunca draft, prerelease ou tag canary — assente no commit exato dessa release. O hermes update e o botão de atualização do Desktop avançam de release em release, nunca de commit em commit. Se gostas de viver na frente, o main continua lá; só deixou de ser aquilo que te acontece sem pedires.

Como se usa

hermes update                        # a última release stable
hermes update --set-channel main     # passa a seguir cada commit do main (fica guardado)
hermes update --set-channel stable   # volta a seguir só releases (fica guardado)
hermes update --channel main         # só nesta execução; não guarda nada

A diferença entre --set-channel e --channel é essa: o primeiro escreve a escolha na configuração, o segundo usa-a uma vez e esquece-se. Dá jeito para espreitar como anda o main sem mudar de vida.

Depois há os que não mexem em nada:

hermes update --check                # o teu checkout face ao alvo do canal, sem aplicar código
hermes update --plan                 # o que vai acontecer à frota antes de mexer em nada
hermes update --branch NOME          # um ramo para esta execução; ganha ao canal

O --check compara o checkout com o alvo do canal selecionado — a última release por omissão, o origin/main se estiveres no canal main — sem aplicar código nem reiniciar gateways. Pode ir buscar metadados ao git, portanto não é uma promessa de zero escritas em disco, mas é a forma barata de saber se estás atrás. O --plan é para quem tem vários perfis ou serviços na mesma máquina: imprime o tipo de instalação, os serviços a correr, quem os supervisiona, que código estão a servir e como vão ser reiniciados. É só de leitura e é seguro numa frota viva.

Onde é que a escolha fica guardada

Por instalação, não por utilizador: fica em update.installs no config.yaml, com o id da instalação como chave. Isto é deliberado. O mesmo config.yaml pode servir várias instalações — o host, um gateway em Docker, a aplicação de Desktop — e um canal global ia mexer no feed do Desktop só porque puseste o checkout de desenvolvimento noutro sítio. Cada instalação responde por si. Se quiseres saber qual é a tua, hermes update --install-id diz-te o id e o caminho.

Pormenores que mordem

Quem nunca escolheu canal só anda para a frente. Se o teu checkout já está mais novo que a última release — por exemplo, porque seguia o main antes desta mudança — fica onde está até sair uma release mais nova. Não levas com um downgrade silencioso no primeiro hermes update a seguir ao upgrade.

--set-channel stable é outra história: aí estás a pedir, e ele fixa o checkout ao commit exato da release, mesmo que seja mais antigo do que o que tens. Podes deixar commits para trás. Se a ideia é mesmo voltar atrás e ficar por lá, faz sentido; se é só para ter a certeza de que estás numa release, o comportamento forward-only já te resolve isso.

Instalações que não são código-fonte ficam de fora: Microsoft Store, MSIX e o Desktop empacotado trazem o canal fixo no pacote e recusam mudanças de canal. Nesses casos, mudar de canal é instalar a outra aplicação, não mudar uma definição. Stable e canary são aplicações separadas — o ícone do canary tem fundo amarelo e o comando é hermes-canary — e nenhuma substitui a outra. Os bundles de um commit só, aqueles de ícone vermelho com o SHA curto, são ainda outro canal, à parte de stable e de main, e nem sequer verificam atualizações: dizem-te para pedir um build novo a quem te deu o build.

E antes de atualizar com trabalho a meio num ramo, commita. O autostash do hermes update existe para desimpedir o pull, não para te guardar trabalho. Nas atualizações sem terminal, como o botão do Desktop, as tuas alterações ficam num stash e nunca são reaplicadas por cima do código novo: o log imprime o git stash apply certo e deixa-as ali à tua espera. É proteção, não descuido — edições locais a viajar em cima de código acabado de atualizar é uma boa maneira de partir a instalação.

Fecho

Gosto desta mudança. Havia qualquer coisa de esquisito em pedir “atualiza-me” e receber código que ainda não tinha nome de release; a maior parte das pessoas não quer ser a primeira a correr um commit de madrugada. O main continua a estar a uma flag de distância para quem quer mesmo isso — eu uso-o quando ando a seguir uma funcionalidade que acabou de sair — e o --check dá-te a conta sem mexer em nada. Se nunca escolheste canal, também não tens nada para configurar: o default é este, e quem já vai à frente da última release espera pela seguinte.

Está tudo documentado em Updating & Uninstalling e na referência da CLI.

Tags: #hermes #atualizacoes #cli