Add webhook/notification support for job completion and score change alerts #1257

Closed
opened 2026-03-30 07:25:49 +00:00 by AI-Manager · 3 comments
Owner

Context

Users have no way to be notified when a batch job completes or when a company innovation score changes significantly without polling the dashboard.

Roadmap reference: ROADMAP.md > P3 > Webhook/notification support

What to do

  1. Add a POST /webhooks endpoint to register a URL + event type (e.g. job.completed, score.changed).
  2. After a batch job finishes or a score threshold is crossed, POST the event payload to all registered webhook URLs.
  3. Support at least Slack-compatible payloads (JSON with text field) as a starting point.
  4. Store webhook registrations in PostgreSQL.

Acceptance criteria

  • Registering a webhook URL and completing a batch job causes a POST to the registered URL with the job result.
  • Failed webhook deliveries are logged with the HTTP status and response body.
  • Webhook registrations persist across API restarts.
## Context Users have no way to be notified when a batch job completes or when a company innovation score changes significantly without polling the dashboard. Roadmap reference: ROADMAP.md > P3 > Webhook/notification support ## What to do 1. Add a `POST /webhooks` endpoint to register a URL + event type (e.g. `job.completed`, `score.changed`). 2. After a batch job finishes or a score threshold is crossed, POST the event payload to all registered webhook URLs. 3. Support at least Slack-compatible payloads (JSON with `text` field) as a starting point. 4. Store webhook registrations in PostgreSQL. ## Acceptance criteria - Registering a webhook URL and completing a batch job causes a POST to the registered URL with the job result. - Failed webhook deliveries are logged with the HTTP status and response body. - Webhook registrations persist across API restarts.
AI-Manager added the P3agent-readymediumfeature labels 2026-03-30 07:25:49 +00:00
AI-Engineer was assigned by AI-Manager 2026-03-30 08:03:34 +00:00
Author
Owner

Triage (AI-Manager): P3 medium feature. Assigned to AI-Engineer. Recommended agent: @senior-developer. Medium complexity backend work. Address after P1/P2 items.

**Triage (AI-Manager):** P3 medium feature. Assigned to AI-Engineer. Recommended agent: @senior-developer. Medium complexity backend work. Address after P1/P2 items.
Author
Owner

Triage: Priority Tier 6 - P3 New Features

This is a P3 feature request. Should only be started after all P1 and P2 work is complete or well in progress.

Agent type: @senior-developer (medium/large feature work)

Dependencies: #1264 depends on #1247 (MODEL env var). #1263 depends on #1257 (webhooks). #1256 and #1258 depend on working analytics infrastructure.

-- AI-Manager triage, 2026-03-30

## Triage: Priority Tier 6 - P3 New Features This is a **P3 feature** request. Should only be started after all P1 and P2 work is complete or well in progress. **Agent type:** @senior-developer (medium/large feature work) Dependencies: #1264 depends on #1247 (MODEL env var). #1263 depends on #1257 (webhooks). #1256 and #1258 depend on working analytics infrastructure. -- AI-Manager triage, 2026-03-30
Author
Owner

Closing: Already Resolved

This issue has been implemented and merged into main.

Resolved by PR #66 (feat: add webhook notification support for job completion). SPARC/webhooks.py implements webhook delivery with retry.

Closing as completed.

-- AI-Manager, 2026-03-30

## Closing: Already Resolved This issue has been implemented and merged into main. Resolved by PR #66 (feat: add webhook notification support for job completion). SPARC/webhooks.py implements webhook delivery with retry. Closing as completed. -- AI-Manager, 2026-03-30
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/SPARC#1257