makuco update · Makuco

makuco update [-c] [-v] [-r <caminho>] [-p <política>] [--allow-downgrade]

Atualiza os ativos entregues pelo pacote da CLI preservando o que você alterou. Ele compara o que está no disco com o que a versão nova traz e pergunta o que fazer em cada divergência.

Flag	O que faz
`-c, --check`	Só relata o estado dos ativos, sem escrever nada.
`-v, --verbose`	Mostra também os ativos que já estão em dia.
`-r, --root <caminho>`	Raiz do projeto (padrão: diretório atual).
`-p, --policy <política>`	Decide sem perguntar: `keep` \| `accept` \| `skip`.
`--allow-downgrade`	Permite retroceder para uma versão anterior dos ativos.

Códigos de saída: 0 sucesso · 1 falha · 2 pendências não resolvidas.

Exceção do update

Hooks e demais ativos gerenciados pelo Makuco são atualizados sem perguntar, mesmo quando customizados ou removidos à mão.

O que ele não atualiza

Desde a 3.1.0: conteúdo do Hub tem comando próprio

O conteúdo da unidade e os itens avulsos instalados com skill/agent/prompt add vêm do Makuco Hub e não entram no makuco update. Quando há itens do Hub no projeto, o update imprime quantos são e manda rodar o makuco unit sync — sem essa linha, a unidade ficaria parada em silêncio.

Quando ele se recusa a rodar

Situação	O que a CLI faz
Nenhuma ferramenta de IA detectada	Recusa e manda rodar o `makuco init`.
Ativos entregues por uma versão mais nova que a que está rodando	Bloqueia o retrocesso. Atualize a CLI, ou use `--allow-downgrade` se o retrocesso for intencional.
`--policy accept` com o catálogo de proveniência indisponível	Bloqueia. Sem o catálogo, todo ativo divergente é classificado como customizado e a política sobrescreveria as suas alterações. Use `--check`, `--policy keep` ou o modo interativo.
`--policy` com valor desconhecido	Avisa e segue com `skip`.

Diagnóstico sem escrever nada

makuco update --check --verbose

Relata o estado de cada ativo — em dia, desatualizado, customizado, removido — sem tocar no disco. Sai com 2 quando há divergência, o que serve como gate em pipeline.