Git-FED/MuseAi-Skill-video-editing

Realiza una pre-verificación de despliegue en Cloudflare Pages/Workers para detectar fugas de activos antes de publicarlos.

¿Qué es MuseAi-Skill-video-editing?

Esta habilidad está diseñada para desarrolladores que despliegan aplicaciones en Cloudflare Pages o Workers utilizando `wrangler`. Realiza un despliegue en seco (dry-run) e inspecciona qué archivos se subirían realmente, permitiendo detectar errores como una compilación mal dirigida, un paquete demasiado grande o binarios de dependencias que se envían como activos estáticos. Previene fugas de credenciales y subidas no deseadas, asegurando que solo los archivos correctos lleguen a producción. Funciona con proyectos que tienen `wrangler.toml` o `wrangler.jsonc` y requiere que `wrangler` y `node` estén disponibles en el PATH.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Git-FED/MuseAi-Skill-video-editing/tree/HEAD/skills/muse-cloudflare-deploy

Documentación

Qué hace

Ejecuta un despliegue en seco e inspecciona qué se subiría realmente, para que detectes una compilación mal dirigida, un paquete demasiado grande o un binario de dependencia que se está enviando como activo estático — antes de que se publique.

Requisitos previos

wrangler y node en el PATH
Un wrangler.toml (o wrangler.jsonc) en la raíz del proyecto
Credenciales de Cloudflare disponibles para wrangler (mediante variables de entorno, no incluidas en el repositorio)

Verificar el entorno

Ejecuta antes que cualquier otra cosa:

command -v wrangler && command -v node

Si falta alguno, detente e informa: MISSING_DEP: wrangler.

Paso a paso

Confirma que existe la configuración de wrangler:
```
test -f wrangler.toml || test -f wrangler.jsonc
```
Si no existe ninguno, informa MISSING_CONFIG: wrangler.toml.

Confirma que .wrangler/ está en .gitignore (contiene estado local y puede contener tokens):

test -f .gitignore && grep -qxF '.wrangler/' .gitignore || echo "WARN: .wrangler/ not gitignored"

Ejecuta la pre-verificación (dry-run + inspección de subida):
```
bash scripts/preflight.sh
```
Ejecuta la verificación de secretos:
```
bash scripts/check-secrets.sh
```
Solo si ambos pasos son exitosos, despliega:
```
wrangler deploy
```

Nunca asumas

Nunca asumas que wrangler deploy apunta a Pages cuando pensabas en Workers, o viceversa. Confirma el destino en wrangler.toml antes de desplegar.
Nunca asumas que el directorio de salida de la compilación es correcto — wrangler lo descubre automáticamente y puede elegir el equivocado. Revisa la ruta de salida del dry-run.
Nunca asumas que node_modules y los binarios de workerd están excluidos de una subida de activos estáticos. Inspecciona el dry-run.
Nunca hagas eco de un secreto. Si algún paso imprime ${{ secrets.* }} o un token, trátalo como una fuga: informa CREDENTIAL_LEAK y detente.
Nunca incluyas .wrangler/ o .dev.vars en el repositorio.

Resultado

Un informe de tamaño del dry-run, una lista de cualquier binario filtrado y un veredicto de aprobado/fallido. No se realiza ningún despliegue a menos que ambas verificaciones sean exitosas.

Manejo de fallos

wrangler faltante → informa MISSING_DEP: wrangler, detente.
El dry-run falla → muestra el stderr de wrangler textualmente, no reintentes ciegamente.
ASSET_LEAK → detente, corrige la compilación, vuelve a ejecutar. No despliegues.
CREDENTIAL_LEAK → rota la credencial, luego vuelve a ejecutar.