fn_registry/dev/flows/0004-gitea-releases-monitor.md

name, id, status, created, updated, priority, risk, related_issues, apps, trigger, schedule, expected_runtime_s, tags

name	id	status	created	updated	priority	risk	related_issues	apps	trigger	schedule	expected_runtime_s	tags
gitea-releases-monitor	0004	pending	2026-05-16	2026-05-16	medium	low		registry_api data_factory agents_and_robots	webhook		5	git webhook multi-repo monitoring

Goal

Probar webhooks como trigger (no cron, no manual). Cada push a un repo dataforge/* registra commit en data_factory + notifica via Matrix bot. Demuestra reactividad event-driven.

Pre-requisitos

• gitea_create_webhook_bash_infra disponible.
• Servidor HTTP receptor (reusar registry_api o deploy_server).
• Bot Matrix en sala #fn-registry-releases.
• GITEA_TOKEN en pass registry/api-token.

Flow

1. Crear endpoint receptor POST /webhook/gitea en una app (probable: nueva mini-app gitea_webhook_listener o anadir a deploy_server).
2. Iterar repos dataforge/<name> (35 apps + analyses). Instalar webhook en cada uno apuntando al receptor:

   for app in $(ls apps/); do
     gitea_create_webhook "dataforge" "$app" "http://<vps>/webhook/gitea" "$secret"
   done
   

3. Receptor parsea payload Gitea (event push): {ref, commits: [{id, message, author, url}]}.
4. INSERT en data_factory.runs con node_id='gitea_push_<repo>' (upsert node si no existe).
5. Notifica Matrix:

   [<repo>] <author>: <commit message>
   <url>
   

6. dag_engine recibe trigger api con info del run.
7. data_factory tab Extractors muestra gitea_push_<repo> por cada repo con activity.

Acceptance

• Webhook instalado en >=3 repos.
• Push de prueba dispara recepcion + entry en data_factory.runs.
• Matrix recibe mensaje formateado.
• data_factory muestra nodos gitea_push_<repo> con last_run reciente.
• Receptor maneja fallos (timeout, payload invalido) sin crash.

Telemetria esperada

• data_factory.runs con trigger='api'.
• Por repo: 1 nodo extractor.
• Matrix: 1 msg por push.

Notas

• Webhook secret debe estar en pass gitea/webhook-secret o env var.
• Si el receptor se cae, los pushes se pierden (no hay queue). Mejora futura: redis/sqlite queue.
• Cuidado con loops: commits que GENERA el bot pueden disparar webhooks.