Pausar y reanudar Sync Cascade (toggle SYNC_CASCADE_PAUSADO)

Qué hace este toggle

Sync Cascade es el sistema que avisa automáticamente cuando un documento “fuente” cambia y otros documentos vinculados (mirrors:) podrían necesitar actualizarse. Detalle completo en [[feature—supercontext—sync-cascade]].

El toggle SYNC_CASCADE_PAUSADO es un freno de emergencia para apagar todo el sistema sin tocar código. Cuando está activado (true), el workflow de detección no corre ni un segundo — 0 minutos de GitHub Actions consumidos.

No suele hacer falta usarlo en el día a día. El sistema ya está pensado para no dispararse con ediciones normales por la UI del workspace (esas pasan filtradas). Este toggle es para casos puntuales descritos abajo.

Cuándo activarlo

Cómo activarlo (paso a paso con clicks)

Activar la pausa (apagar Sync Cascade)

1. Abre el repo del workspace en GitHub: https://github.com/CreaRackSL/CreaRackSL-workspace

2. En la barra superior del repo, click en Settings (engranaje, a la derecha).

3. En el menú izquierdo, busca la sección Security y dentro click en Secrets and variables → Actions.

   Si no ves “Secrets and variables” desplegado, click sobre él para abrirlo.

4. En la página que se abre verás 2 pestañas arriba:

   • Secrets (no es la que queremos).
   • Variables ← click aquí.

5. Click en el botón verde New repository variable (arriba a la derecha).

6. Rellena los 2 campos:

   • Name: SYNC_CASCADE_PAUSADO
   • Value: true

7. Click en Add variable.

A partir de este momento, el sistema está apagado. Cualquier push a main que normalmente dispararía Sync Cascade lo saltará en seco. Compruébalo: en Actions ya no aparecen runs nuevos del workflow Sync Cascade Detect.

Reanudar (volver a encender Sync Cascade)

Tienes 2 formas, las dos valen:

Forma A · cambiar el valor a false:

1. Settings → Secrets and variables → Actions → pestaña Variables.
2. Localiza la fila SYNC_CASCADE_PAUSADO.
3. Click en el icono de lápiz a la derecha (Edit).
4. Cambia el value de true a false.
5. Click en Update variable.

Forma B · eliminar la variable (equivale a reanudar — si la variable no existe, el sistema asume “no pausado”):

1. Mismo camino: Settings → Secrets and variables → Actions → pestaña Variables.
2. Localiza la fila SYNC_CASCADE_PAUSADO.
3. Click en el icono de papelera 🗑️ a la derecha (Remove).
4. Confirma.

A partir de ahí el sistema vuelve a estar activo. La próxima edición a un doc sembrado dispara cascada normal.

Cómo confirmar el estado actual

¿Está pausado o activo ahora mismo?

1. Settings → Secrets and variables → Actions → pestaña Variables.
2. Mira si aparece una fila SYNC_CASCADE_PAUSADO:
   • Si NO aparece → sistema activo (default).
   • Si aparece con value true → sistema pausado.
   • Si aparece con value false o cualquier otro valor → sistema activo.

Quién puede tocarlo

Solo los Owners del Org CreaRackSL (Edu actualmente). Dani y Txell con role Member pueden ver la variable pero no editarla. Si quieren cambiarla y Edu no está disponible, pueden subirles a Owner temporalmente o pedirle a Edu por el chat del workspace.

Atajo si te peleas con la UI

Si el camino UI te resulta lento, también puedes hacerlo desde tu terminal con gh (CLI de GitHub que ya tienes instalado por el bootstrap):

# Pausar
gh variable set SYNC_CASCADE_PAUSADO --body true --repo CreaRackSL/CreaRackSL-workspace

# Reanudar
gh variable set SYNC_CASCADE_PAUSADO --body false --repo CreaRackSL/CreaRackSL-workspace

# O eliminar la variable (también reanuda)
gh variable delete SYNC_CASCADE_PAUSADO --repo CreaRackSL/CreaRackSL-workspace

# Ver estado
gh variable list --repo CreaRackSL/CreaRackSL-workspace

Si en el futuro queremos un botón real en el workspace

Lo más cómodo a futuro sería un widget en el panel de admin del workspace tipo “Sync Cascade · ON/OFF” que llamase a la API de GitHub para cambiar la variable. Está en la lista de mejoras posibles si el toggle se usa con frecuencia. Por ahora, con esta página + UI de GitHub es suficiente para los casos puntuales en los que toca.

Historial

Referencias

• Workflow: .github/workflows/sync-cascade-detect.yml (línea del if: del job detect).
• Plan completo Sync Cascade: [[feature—supercontext—sync-cascade]].
• Histórico de toggles similares: el Bibliotecario tuvo un toggle BIBLIOTECARIO_PAUSADO análogo en s79 (no llegó a usarse como ritual diario — quedó como freno).

Véase también

• [[feature—supercontext—sync-cascade]]
• [[entity—biblioteca—handler—wiki-propagate-mirror-changes]]
• [[feature—biblioteca—bib-ingest-batch]]