a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
5.4 KiB
Como atualizar o MSD Core
Atualize uma instalação existente do MSD Core para a versão mais recente, visualize o changelog antes de confirmar e recupere personalizações locais que a atualização sobrescreveria.
O que você precisa: O mesmo ambiente de execução para o qual o MSD está instalado. O comando de atualização re-executa o instalador internamente, portanto requer Node.js e npx disponíveis (mesmos requisitos da instalação original).
O caminho padrão de atualização
De dentro do seu ambiente de execução de IA, execute:
/msd-update
O MSD irá:
- Detectar a versão instalada e o escopo da instalação (global ou local).
- Verificar no npm a versão mais recente do
@golem15/msd-core. - Buscar o changelog e exibir o que mudou entre sua versão instalada e a mais recente.
- Solicitar confirmação antes de alterar qualquer coisa.
- Fazer backup de quaisquer arquivos adicionados pelo usuário encontrados dentro de diretórios gerenciados pelo MSD para
msd-user-files-backup/. - Executar o instalador (
npx @golem15/msd-core@latest --<runtime> --<scope>). - Limpar o cache de verificação de atualização para que o indicador na barra de status seja redefinido.
- Informar se arquivos MSD modificados localmente foram copiados para
msd-local-patches/.
Reinicie seu ambiente de execução após a atualização para carregar os novos comandos e agentes.
Flags
| Flag | O que faz |
|---|---|
--sync |
Após atualizar, sincroniza habilidades do registro MSD |
--reapply |
Após atualizar, mescla arquivos MSD modificados localmente de volta a partir de msd-local-patches/ |
/msd-update --sync # Update and sync skills
/msd-update --reapply # Update and reapply local patches
Revisando o changelog antes de atualizar
/msd-update sempre exibe o diff do changelog entre sua versão instalada e a mais recente antes de solicitar confirmação. Não é necessário acessar o GitHub separadamente. A saída tem a seguinte aparência:
## MSD Update Available
Installed: 1.39.0
Latest: 1.41.0
### What's New
---
[changelog entries for 1.40.0 and 1.41.0]
---
Proceed with update? [Yes, update now / No, cancel]
Se o changelog não puder ser obtido (sem acesso à rede, falha no npm), a atualização ainda prossegue após a confirmação — ela não é bloqueada pela disponibilidade do changelog.
Recuperando personalizações locais
Arquivos que você adicionou dentro de diretórios gerenciados pelo MSD
Se você colocou arquivos personalizados dentro de diretórios que o MSD gerencia (por exemplo, agentes personalizados com o prefixo msd- ou arquivos extras em commands/msd/), o instalador os detectará e os copiará para msd-user-files-backup/ antes de limpar esses diretórios. Após a atualização, restaure-os manualmente a partir desse local de backup.
Arquivos colocados fora de diretórios gerenciados pelo MSD — agentes personalizados sem o prefixo msd-, comandos personalizados fora de commands/msd/, seus arquivos CLAUDE.md e hooks personalizados — nunca são tocados pelo instalador.
Arquivos MSD que você modificou diretamente
Se você editou um arquivo instalado pelo MSD (por exemplo, ajustando o prompt de sistema de um agente), o instalador detecta a modificação por meio de uma comparação de hash com seu manifesto, faz backup do arquivo em msd-local-patches/ e, em seguida, o substitui pela nova versão. Após a atualização:
/msd-update --reapply
Esse comando mescla suas modificações de msd-local-patches/ de volta aos arquivos recém-instalados.
Se você pulou o --reapply após uma atualização anterior e deseja aplicar os patches agora:
/msd-update --reapply
É seguro executar --reapply de forma independente sem acionar um novo download — se você já estiver na versão mais recente, o MSD ignora a etapa de instalação e vai direto para a reaplicação dos patches.
Quando o npm está indisponível
Se npx @golem15/msd-core@latest falhar devido a uma falha no npm, restrições de rede ou porque você está trabalhando a partir do repositório de código-fonte, use o procedimento de atualização manual em docs/manual-update.md. Esse documento aborda como fazer pull do commit mais recente, compilar o dist dos hooks e executar node bin/install.js diretamente.
Se você já está na versão mais recente
/msd-update encerra imediatamente com uma mensagem de confirmação — sem download, sem instalação, sem necessidade de reinicialização.
Migrações do instalador
Cada versão do MSD pode incluir migrações do instalador que renomeiam, movem ou removem arquivos gerenciados. A camada de migração é executada automaticamente antes que o novo payload do pacote seja gravado. Migrações que afetariam arquivos que você modificou solicitam confirmação em vez de agir silenciosamente. Para o design completo e o registro do contrato de configuração de tempo de execução, consulte docs/installer-migrations.md.