makuco unit sync

Disponível a partir da versão 3.1.0

Este comando não existe em versões anteriores — a CLI sai com erro de comando desconhecido. Confira com makuco --version. O comando depende do Makuco Hub.

makuco unit sync [-r <caminho>] [-p <política>]

Atualiza o conteúdo da unidade configurada no projeto sem rodar a inicialização inteira. Antes da 3.1.0 a única forma de trazer conteúdo novo da unidade era rodar o makuco init de novo, que repergunta tudo e reinstala o pacote.

Flag	O que faz
`-r, --root <caminho>`	Raiz do projeto (padrão: diretório atual).
`-p, --policy <política>`	Decide sem perguntar no item customizado: `keep` \| `accept` \| `skip`.

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

O que acontece com cada item

Estado do item no projeto	O que o `unit sync` faz
Igual ao que o Hub publica	Não faz nada.
Intocado, com versão nova no Hub	Atualiza sozinho, sem perguntar.
Customizado por você	Abre decisão: manter o seu, substituir, ver a diferença ou pular. Cópia de segurança antes de substituir.
Ausente (apagado à mão)	Reinstala.
Saiu da unidade no Hub	É reportado e mantido no projeto — remova à mão se quiser. A CLI não apaga arquivo seu.

O comando sincroniza de uma vez o conteúdo da unidade registrada e todos os itens avulsos instalados no projeto, mesmo os de outras unidades.

Versão fixada sobrevive à sincronização

Item instalado com @versão (makuco skill add lughy/lughy-code-review@1.2.0) fica fixado: o unit sync resolve a versão registrada, não a última publicada. Quem fixou não é desafixado por uma sincronização. Item sem @versão acompanha a última publicada.

Automação e CI

Em terminal não interativo e sem --policy, todo item customizado é skip — o comando sai com 2 e nada é sobrescrito. Para uma decisão determinística no pipeline:

# Sempre traz o que o Hub publica, sobrescrevendo customizações (com backup).
makuco unit sync --policy accept
 
# Nunca sobrescreve: o que você alterou fica como está.
makuco unit sync --policy keep

--policy accept sobrescreve o que você alterou

A cópia de segurança em .makuco/backups/<AAAAMMDD-HHMMSS-mmm>/ é gravada antes de cada substituição, mas o arquivo no lugar dele passa a ser o do Hub. Use accept só quando o conteúdo da unidade for a fonte da verdade do projeto.

Quando ele não faz nada

Situação	Mensagem
Nenhuma ferramenta de IA detectada	Manda rodar o `makuco init` primeiro.
Sem unidade configurada e sem item avulso	Manda rodar o `makuco init` para escolher uma unidade.
Nenhum item avulso resolvido pelo Hub nesta execução	Avisa que o que está no projeto continua como está.
Unidade não resolve no Hub	Erro: nada é alterado no projeto.
Um item específico não resolve (Hub instável)	Avisa e deixa aquele item de fora — sem anunciar que ele saiu da unidade.

Conteúdo executável

Antes de gravar, a CLI lista os itens que executam código na sua máquina — hooks e scripts que rodam com as suas permissões. Confira a origem antes de aceitar.