Endpoint /biblioteca/crons — Health de los 12 cron jobs del workspace

Descripción

El endpoint /biblioteca/crons (y su gemelo server-to-server /api/biblioteca/crons) expone en tiempo real el estado de los 12 cron jobs del workspace CreaRack. Cierra la tarjeta Crons del sistema del Pulse (banda 4), que antes mostraba 9 de 12 crons con —. Con este PR, 11 de 12 crons tienen último-run auténtico.

El único cron sin telemetría es pg_dump · CreaRack-Pro, que corre en PROD (Hetzner) sin acceso D1 desde el workspace — se muestra — honesto con nota explicativa (Regla 13).

Arquitectura

Builder central: functions/_lib/crons.ts

Toda la lógica de agregación reside en buildCronsReport(env: CronsEnv). Es un aggregator sin caché propia: consulta las fuentes en cada request con AbortSignal.timeout(5s) y fallback limpio a null si falla.

CronsEnv
  ├── DB: D1Database
  └── GH_PAT?: string   ← PAT con scope actions:read

Fuentes por cron:

Las 6 llamadas a GitHub Actions API se lanzan en paralelo con Promise.all.

Endpoints CF Pages Functions

Ambos devuelven el mismo CronsReport JSON con Cache-Control: private, max-age=60.

Schema de respuesta

interface CronsReport {
  generated_at: string;   // ISO UTC
  with_data: number;      // crons con lastRun !== null
  total: number;          // siempre 12
  crons: CronStatus[];
}

interface CronStatus {
  key: string;
  label: string;
  group: 'Bibliotecario' | 'Reindex' | 'Wiki' | 'Sync' | 'Backups';
  schedule: string;
  lastRun: string | null;  // ISO UTC o null
  status: 'success' | 'failure' | 'cancelled' | 'skipped' | 'running' | null;
  source: 'github_actions' | 'bib_wiki_log' | 'bib_nodes' | 'activity_log' | 'no-telemetry';
  detailUrl: string | null;  // enlace al run GHA si aplica
  note?: string;             // nota honesta si sin telemetría
}

Integración con PulsePanel

CronsHealthCard (en src/components/biblioteca/PulsePanel.tsx) consume /biblioteca/crons con refresh cada 60 segundos (best-effort). La tarjeta:

• Muestra un dot de color por cron:
  • 🔴 Rojo (--danger): status === 'failure'
  • 🟡 Amarillo (--warning): último run supera el umbral del grupo
  • 🟢 Verde (--success): en plazo
  • ⚫ Gris (--fg-dim): sin datos (lastRun === null)
• Los crons con detailUrl (GHA) enlazan al run en GitHub.
• El title del dot muestra el status del último run.
• Si el endpoint falla: la tarjeta cae a estado “Cargando…” (best-effort, sin romper el Pulse).

Umbrales de staleness por grupo:

Degradación limpia

• Si GH_PAT no tiene scope actions:read → los 6 crons GHA muestran — (sin error).
• Si D1 no responde → los crons D1 muestran — (.catch(() => ({ results: [] })) inline).
• Verificación manual: curl /api/biblioteca/crons (requiere Bearer token).

Archivos clave

Véase también

• [[concept—general—que-es-el-pulse-panel-o-pulsepanel-del-workspace-b]]