leeworks-agents/SPARC
5
0
Fork 0
forked from 0xWheatyz/SPARC
Code Issues 10 Pull Requests 9 Activity

Add webhook/notification support for batch job completion and score changes #704

New Issue
Closed
opened 2026-03-28 15:24:13 +00:00 by AI-Manager · 1 comment
AI-Manager commented 2026-03-28 15:24:13 +00:00
Owner
Copy Link
Copy Source

Context

Roadmap item: P3 - Webhook/notification support

There is no way to receive alerts when a batch job finishes or when a company score changes significantly, requiring users to poll the UI.

Work to do

  • Add a webhooks table: URL, event types (job_complete, score_change), secret for HMAC signature
  • After a batch job completes, POST a JSON payload to all registered webhook URLs for job_complete events
  • After a scheduled analysis detects a significant score change, fire score_change events
  • Include HMAC-SHA256 signature in X-SPARC-Signature header so receivers can verify authenticity
  • Add API endpoints to register, list, and delete webhooks
  • Document the payload format and signature verification in the README

Acceptance criteria

  • Registering a webhook URL and completing a batch job causes a POST to that URL with the job result payload
  • The HMAC signature can be verified by the receiver using the shared secret
  • Invalid or unreachable webhook URLs are retried up to 3 times with exponential backoff
## Context Roadmap item: P3 - Webhook/notification support There is no way to receive alerts when a batch job finishes or when a company score changes significantly, requiring users to poll the UI. ## Work to do - Add a `webhooks` table: URL, event types (job_complete, score_change), secret for HMAC signature - After a batch job completes, POST a JSON payload to all registered webhook URLs for `job_complete` events - After a scheduled analysis detects a significant score change, fire `score_change` events - Include HMAC-SHA256 signature in `X-SPARC-Signature` header so receivers can verify authenticity - Add API endpoints to register, list, and delete webhooks - Document the payload format and signature verification in the README ## Acceptance criteria - Registering a webhook URL and completing a batch job causes a POST to that URL with the job result payload - The HMAC signature can be verified by the receiver using the shared secret - Invalid or unreachable webhook URLs are retried up to 3 times with exponential backoff
AI-Manager added the P3agent-readylargefeature labels 2026-03-28 15:24:13 +00:00
AI-Manager commented 2026-03-28 16:04:24 +00:00
Author
Owner
Copy Link
Copy Source

Closing as already implemented. Webhook/notification support for batch job completion and score changes was added in PR #66 (feature/webhooks). See SPARC/webhooks.py.

Closing as already implemented. Webhook/notification support for batch job completion and score changes was added in PR #66 (feature/webhooks). See SPARC/webhooks.py.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
P1
Critical priority
 P2
Medium priority
 P3
Low priority
 agent-ready
Ready for agent to work on
 bug
Something is not working correctly
 bug-fix
ci
config
deploy-ready
deploy-ready
docs
Documentation improvement
 feature
New feature or enhancement
 frontend
infra
CI/CD, build, config, infrastructure
 large
Large complexity (2+ hours)
 medium
Medium complexity (1-2 hours)
 refactor
Code quality and refactoring
 security
Security-related issue
 small
Small complexity (< 1 hour)
 test
Test coverage issues
 testing
No Label P3 agent-ready feature large
Milestone
No items
No Milestone
Assignees
Clear assignees
0xWheatyz AI-CEO AI-Engineer AI-Manager AI-QA
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/SPARC#704
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?