Circuit-Forge/peregrine
2
0
Fork 0
Code Issues 22 Pull requests 2 Projects Releases 6 Packages Wiki Activity Actions

[Integration] Map & test Discord notification integration #34

New issue
Open
opened 2026-03-23 08:39:18 -07:00 by pyr0ball · 0 comments
pyr0ball commented 2026-03-23 08:39:18 -07:00
Owner
Copy link

Discord — Job Pipeline Notifications

Send Discord messages on pipeline events via a webhook. Mirrors Slack integration but targets Discord channels.

Current state

scripts/integrations/discord.py exists (34 lines, 4 methods). Uses Discord Webhook API — same POST-to-URL pattern as Slack.

Tasks

Mapping

  • Document credential: Discord webhook URL (created per-channel in Discord server settings)
  • Map notification events → Discord embed format (richer than Slack plain text):
    • Use embeds with color coding: blue = new jobs, green = offer, red = rejected, yellow = interview
  • Config file format: config/integrations/discord.yaml

Implementation

  • Confirm DiscordIntegration.connect() validates webhook URL format
  • Implement DiscordIntegration.test() — POST a test embed to the webhook
  • Implement rich embed formatting with color coding and field layout
  • Reuse the same event hook points as Slack (share event emitter if added)

Testing

  • Unit test: embed payload structure is valid Discord API format
  • Integration test: test() sends a visible embed to a real Discord channel
  • Test graceful failure: webhook deleted → log warning, don't crash

Acceptance criteria

  • Settings → Integrations shows Discord card with webhook URL field
  • Test posts a rich embed to the configured Discord channel
  • Notification events match Slack integration (same triggers, Discord embed format)
## Discord — Job Pipeline Notifications Send Discord messages on pipeline events via a webhook. Mirrors Slack integration but targets Discord channels. ### Current state `scripts/integrations/discord.py` exists (34 lines, 4 methods). Uses Discord Webhook API — same POST-to-URL pattern as Slack. ### Tasks **Mapping** - [ ] Document credential: Discord webhook URL (created per-channel in Discord server settings) - [ ] Map notification events → Discord embed format (richer than Slack plain text): - Use embeds with color coding: blue = new jobs, green = offer, red = rejected, yellow = interview - [ ] Config file format: `config/integrations/discord.yaml` **Implementation** - [ ] Confirm `DiscordIntegration.connect()` validates webhook URL format - [ ] Implement `DiscordIntegration.test()` — POST a test embed to the webhook - [ ] Implement rich embed formatting with color coding and field layout - [ ] Reuse the same event hook points as Slack (share event emitter if added) **Testing** - [ ] Unit test: embed payload structure is valid Discord API format - [ ] Integration test: test() sends a visible embed to a real Discord channel - [ ] Test graceful failure: webhook deleted → log warning, don't crash ### Acceptance criteria - Settings → Integrations shows Discord card with webhook URL field - Test posts a rich embed to the configured Discord channel - Notification events match Slack integration (same triggers, Discord embed format)
pyr0ball added this to the Paid Tier GA milestone 2026-03-23 08:39:18 -07:00
pyr0ball added the
feature-request
 label 2026-03-23 08:39:18 -07:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feature/vue-wizard
feature/vue-streamlit-parity
feature/orch-auto-lifecycle
feature/shared-task-scheduler
feature/vue-spa
feature/feedback-button
v0.8.5
v0.8.4
v0.8.3
v0.8.2
v0.8.1
v0.8.0
v0.7.1
v0.7.0
v0.6.2
v0.6.1
v0.6.0
v0.5.0
v0.4.1
v0.4.0
v0.3.0
v0.2.5
v0.2.4
v0.2.3
v0.2.2
v0.2.1
v0.2.0
v0.1.0
Labels
Clear labels   
backlog

   
beta-feedback

   
bug

   
enhancement

New feature or improvement to an existing feature

  
feature-request

   
frontend

Frontend / UI concerns

  
needs-triage

   
question

   
vue

Vue 3 SPA frontend

No labels
backlog
beta-feedback
bug
enhancement
feature-request
frontend
needs-triage
question
vue
Milestone
Clear milestone
No items
No milestone
Paid Tier GA
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Circuit-Forge/peregrine#34
No description provided.
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?