¿Qué hace Planificador de actualización de dependencias?
Genere un plan. No actualice nada hasta que el usuario apruebe el plan.
Procedimiento
- Detecte el ecosistema a partir del manifiesto:
package.json,requirements.txtopyproject.toml,go.mod,Cargo.toml,Gemfile,pom.xml. Si existen varios, pregunte cuál planificar, o planifíquelos por separado. - Lea las versiones actuales del manifiesto y del archivo de bloqueo (
package-lock.json,poetry.lock,go.sum,Cargo.lock,Gemfile.lock). - Encuentre las versiones disponibles con la herramienta propia del ecosistema e informe la salida que realmente obtuvo:
- npm:
npm outdated - Python:
pip list --outdatedouv pip list --outdated - Go:
go list -u -m all - Rust:
cargo outdated - Ruby:
bundle outdatedSi la herramienta no está disponible, dígalo y trabaje a partir del manifiesto, marcando las versiones como no verificadas.
- npm:
- Clasifique cada paquete obsoleto:
- Parche / menor — generalmente seguro.
- Mayor — lea el registro de cambios o las notas de la versión para ver los cambios disruptivos antes de planificarlo.
- Seguridad — cualquier cosa marcada por
npm audit,pip-audit,govulncheck,cargo auditobundle audit. Estos van primero.
- Ordene el trabajo en lotes:
- Lote 0: correcciones de seguridad, incluso si son mayores.
- Lote 1: actualizaciones de parche y menor, agrupadas por área.
- Lote 2: versiones mayores sin dependencias cruzadas, uno por commit.
- Lote 3: versiones mayores que deben moverse juntas (por ejemplo, un framework y sus plugins).
- Para cada lote, indique: los paquetes, las versiones de origen/destino, los cambios disruptivos que aplican, el código o la configuración que debe cambiar y cómo verificar.
Plantilla de salida
## Plan de actualización
Ecosistema: <npm / pip / go / cargo / ...>
Manifiesto: <ruta>
### Lote 0 — Seguridad
| Paquete | Desde | Hasta | Motivo | ¿Disruptivo? |
| --- | --- | --- | --- | --- |
### Lote 1 — Parche y menor
...
### Lote 2 — Mayor, independiente
...
### Lote 3 — Mayor, deben moverse juntos
...
### Verificación
Después de cada lote: <el comando exacto que demuestre que nada ha retrocedido>
### Reversión
Por lote: <cómo revertir, p. ej., git revert del commit del lote>
### Diferidos
<Paquetes dejados intencionalmente sin tocar, y por qué>
Reglas
- Nunca edite el manifiesto durante la planificación. Genere el plan y luego deténgase.
- Lea el registro de cambios real para una actualización mayor cuando esté disponible; no asuma que una versión es disruptiva solo porque el número mayor cambió.
- Nombre siempre el comando de verificación. "Ejecute las pruebas" no es un comando;
npm testsí lo es. - Fije el motivo del aplazamiento cuando deje un paquete fuera — por ejemplo, una versión mayor cuyas notas de la versión no pudo leer.
- No ejecute comandos de instalación, actualización o auditoría que modifiquen el árbol.
npm outdated,npm audity sus equivalentes son de solo lectura y están bien.
Archivo de soporte
references/upgrade-strategy.md explica el agrupamiento en lotes, los casos límite de semver y cómo manejar un paquete que debe retrasarse.