Planejador de Atualização de Dependências
Produza um plano. Não atualize nada até que o usuário aprove o plano.
Procedimento
- Detecte o ecossistema a partir do manifesto:
package.json,requirements.txtoupyproject.toml,go.mod,Cargo.toml,Gemfile,pom.xml. Se vários existirem, pergunte qual planejar, ou planeje-os separadamente. - Leia as versões atuais do manifesto e do arquivo de bloqueio (
package-lock.json,poetry.lock,go.sum,Cargo.lock,Gemfile.lock). - Encontre versões disponíveis com a ferramenta do próprio ecossistema e relate a saída que você realmente obteve:
- npm:
npm outdated - Python:
pip list --outdatedouuv pip list --outdated - Go:
go list -u -m all - Rust:
cargo outdated - Ruby:
bundle outdatedSe a ferramenta não estiver disponível, diga isso e trabalhe a partir do manifesto, marcando versões como não verificadas.
- npm:
- Classifique cada pacote desatualizado:
- Patch / menor — geralmente seguro.
- Principal — leia o changelog ou as notas de versão para mudanças que quebram compatibilidade antes de planejá-lo.
- Segurança — qualquer coisa sinalizada por
npm audit,pip-audit,govulncheck,cargo auditoubundle audit. Esses vão primeiro.
- Ordene o trabalho em lotes:
- Lote 0: correções de segurança, mesmo que sejam principais.
- Lote 1: patches e aumentos menores, agrupados por área.
- Lote 2: principais sem dependência cruzada, um por commit.
- Lote 3: principais que devem se mover juntos (por exemplo, um framework e seus plugins).
- Para cada lote, informe: os pacotes, as versões de/pra, as mudanças que quebram compatibilidade que se aplicam, o código ou configuração que deve mudar e como verificar.
Template de saída
## Plano de atualização
Ecossistema: <npm / pip / go / cargo / ...>
Manifesto: <caminho>
### Lote 0 — Segurança
| Pacote | De | Para | Motivo | Quebra? |
| --- | --- | --- | --- | --- |
### Lote 1 — Patch e menor
...
### Lote 2 — Principal, independente
...
### Lote 3 — Principal, deve mover junto
...
### Verificação
Após cada lote: <o comando exato que prova que nada regrediu>
### Reversão
Por lote: <como reverter, por ex., git revert do commit do lote>
### Adiado
<Pacotes intencionalmente deixados de lado e por quê>
Regras
- Nunca edite o manifesto durante o planejamento. Produza o plano e então pare.
- Leia o changelog real para um aumento principal quando um estiver disponível; não presuma que uma versão quebra compatibilidade só porque o número principal mudou.
- Sempre nomeie o comando de verificação. "Execute os testes" não é um comando;
npm testé. - Explique o motivo do adiamento quando você deixar um pacote de fora — por exemplo, uma versão principal cujas notas de versão você não pôde ler.
- Não execute comandos de instalação, atualização ou auditoria que modifiquem a árvore.
npm outdated,npm audite seus equivalentes são somente leitura e estão ok.
Arquivo de suporte
references/upgrade-strategy.md explica o agrupamento em lotes, casos extremos de semver e como lidar com um pacote que deve ser retido.