Mantenimiento

Mantener separadas las tareas de dependencias, reglas, configuración del alojamiento y datos. Registrar destino, cambio, verificación y plan de reversión antes de una operación real. Este documento no ejecuta tareas ni configura calendarios automáticos.

Al actualizar dependencias, conservar el gestor y lockfile de cada raíz: Bun para el editor y npm para apps/admin. Revisar el parche JWKS y el generador de runtimes al actualizar sus dependencias. Verificar tipos, suites afectadas, builds de editor/panel y presupuesto de bundle; las actualizaciones no deben introducir secretos en el cliente.

Rotar credenciales mediante el gestor del alojamiento. Una rotación de BILLING_ENCRYPTION_KEY no migra los registros existentes: requiere un procedimiento controlado para volver a guardar las credenciales comerciales. Mantener consistentes los orígenes MCP de build y runtime; un cambio exige reconstrucción. Comparar los dos JSON Firebase de cliente como hace CI.

El script scripts/grant-admin-role.mjs modifica claims reales de un proyecto fijo en su fuente. Su sintaxis es node scripts/grant-admin-role.mjs <uid> <correo-confirmado>; exige credenciales Admin (JSON gestionado o ADC) y comprueba la relación UID/correo antes de escribir. Revisar proyecto y destinatario y obtener autorización operativa específica antes de ejecutarlo; no usarlo como smoke test. No incluye una operación inversa de retirada del claim.

Para MCP, conservar recibos permanentes de idempotencia, revisiones referenciadas y hashes de refresh usados durante la vida de la familia. No aplicar TTL general a mcp_idempotency ni borrar auditoría de concesiones revocadas. Persistencia MCP distingue recibos y contadores temporales.

No hay configuración de backups, restauración, retención global, monitorización centralizada ni calendario de rotación verificados en este árbol. Antes de limpiar datos reales, acordar alcance y retención y verificar una copia restaurable en el proveedor; no inventar comandos de backup o borrado. npm run clean solo limpia artefactos locales indicados en desarrollo.

Revisar periódicamente los enlaces documentales y las instrucciones de despliegue contra los archivos actuales. Los planes y auditorías fechados son evidencia histórica; no convertir tareas pendientes en afirmaciones de operación activa.