Backend Issue 15: Optional Forgejo Webhook Ingest For Issue Updates #16

New Issue

Closed

opened 2026-05-19 02:28:01 -05:00 by null · 0 comments

null commented

2026-05-19 02:28:01 -05:00

Owner

Goal

Allow Forgejo webhooks to update cached issues without waiting for manual sync.

Scope

Add webhook receiver for issue opened, edited, closed, and reopened events.
Validate a shared secret.
Update cached issue records.
Record activity events.

Suggested Endpoint

POST /api/v1/forgejo/webhooks/{repository_id}

Acceptance Criteria

Webhook rejects invalid signatures.
Webhook updates cached issue state and metadata.
Webhook ignores pull-request events in MVP.
Webhook records activity for close/reopen events.
Manual sync still works and remains the repair path.

Out Of Scope

First-pass MVP, Frontend UI.

## Goal Allow Forgejo webhooks to update cached issues without waiting for manual sync. ## Scope - Add webhook receiver for issue opened, edited, closed, and reopened events. - Validate a shared secret. - Update cached issue records. - Record activity events. ## Suggested Endpoint - `POST /api/v1/forgejo/webhooks/{repository_id}` ## Acceptance Criteria - Webhook rejects invalid signatures. - Webhook updates cached issue state and metadata. - Webhook ignores pull-request events in MVP. - Webhook records activity for close/reopen events. - Manual sync still works and remains the repair path. ## Out Of Scope - First-pass MVP, Frontend UI.