Files
fusion/plugins/examples/fusion-plugin-notification

Notification Plugin

Sends webhook notifications on Fusion task lifecycle events (task completed, task moved, errors).

Features

  • Webhook Notifications: Send notifications to Slack, Discord, or generic HTTP endpoints
  • Event Filtering: Configure which events trigger notifications
  • Multiple Webhook Formats: Native support for Slack and Discord webhook payloads

Installation

Option 1: Copy to plugins directory

cp -r fusion-plugin-notification ~/.fusion/plugins/

Option 2: Install via CLI

fn plugin install /path/to/fusion-plugin-notification

Configuration

After installation, configure the plugin through the Fusion dashboard:

  1. Go to Settings → Plugins
  2. Find "Notification Plugin" and click the settings icon
  3. Set your webhook URL and preferred webhook type
  4. Optionally filter which events trigger notifications

Settings Reference

Field Type Required Default Description
webhookUrl string Yes URL to send webhook notifications to
webhookType enum No generic Webhook payload format: slack, discord, or generic
events string No (all) Comma-separated list of events: task-completed, task-moved, task-failed. Empty = all events

Example Settings (JSON)

{
  "webhookUrl": "https://hooks.slack.com/services/XXX/YYY/ZZZ",
  "webhookType": "slack",
  "events": "task-completed,task-moved"
}

Webhook Payload Formats

Slack

{
  "text": "✅ Task completed: Fix login bug"
}

Discord

{
  "content": "✅ Task completed: Fix login bug"
}

Generic

{
  "event": "task-completed",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "task": {
    "id": "FN-001",
    "title": "Fix login bug",
    "from": "todo",
    "to": "done"
  }
}

Development

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build
pnpm build

License

MIT