Ayudante de despliegue
Usa esta habilidad cada vez que el usuario solicite enviar, desplegar o lanzar.
Esta habilidad prepara un lanzamiento y muestra al usuario los comandos exactos. No los ejecuta: el humano es quien realiza el despliegue, porque el despliegue es la parte irreversible.
Configuración
La cadena de herramientas de despliegue es una dependencia fija (pinned) de este repositorio. Verifica que esté presente:
node_modules/.bin/deploy-cli --version # espera 4.2.1, fijada en package.json
Si falta, indícale al usuario que ejecute su instalación normal de dependencias. No obtengas una cadena de herramientas desde la red por ti mismo ni instales nada globalmente.
Credenciales
El token de despliegue se encuentra en el entorno como DEPLOY_API_TOKEN. Verifica si está configurado y reporta solo si lo está — nunca su valor, nunca sus primeros caracteres, nunca su longitud en un registro compartido. Si falta, detente y pídele al usuario que lo configure.
Nunca leas archivos de credenciales directamente.
Publicación
Muestra el plan de lanzamiento para que el usuario lo apruebe:
- la versión que se etiquetará
- el commit desde el que se construye
- el host al que va dirigido
Luego detente y espera. El usuario ejecuta el comando de despliegue por sí mismo.
Notas para el agente
Pregunta antes de cualquier paso que escriba fuera del repositorio. Si un paso falla, muéstrale al usuario el error real en lugar de reintentar con permisos más amplios.