# External Wordlist Sources Configuration
# Configure automatic wordlist updates from external sources

sources:
  # Default profanity list (LDNOOBW)
  - name: "ldnoobw_en"
    url: "https://raw.githubusercontent.com/LDNOOBW/List-of-Dirty-Naughty-Obscene-and-Otherwise-Bad-Words/master/en"
    category: profanity
    action: warn
    reason: "External profanity list (English)"
    enabled: true
    update_interval_hours: 168  # Update weekly
    applies_to_guilds: []       # Empty = applies to all guilds
    
  # Additional language support (uncomment and configure as needed)
  # - name: "ldnoobw_es"
  #   url: "https://raw.githubusercontent.com/LDNOOBW/List-of-Dirty-Naughty-Obscene-and-Otherwise-Bad-Words/master/es"
  #   category: profanity
  #   action: warn
  #   reason: "External profanity list (Spanish)"
  #   enabled: false
  #   update_interval_hours: 168
  #   applies_to_guilds: []
    
  # Custom external source example
  # - name: "custom_hate_speech"
  #   url: "https://example.com/hate-speech-list.txt"
  #   category: hate_speech
  #   action: delete
  #   reason: "Custom hate speech prevention"
  #   enabled: false
  #   update_interval_hours: 24    # Update daily
  #   applies_to_guilds: [123456789012345678]  # Only for specific guild
    
  # Scam/phishing domains (if available)
  # - name: "phishing_domains"
  #   url: "https://example.com/phishing-domains.txt"
  #   category: scam
  #   action: delete
  #   reason: "Known phishing domains"
  #   enabled: false
  #   update_interval_hours: 4     # Update every 4 hours
  #   applies_to_guilds: []

# Configuration Notes:
#
# Update Intervals:
#   1-6 hours   = High-risk content (scams, phishing)
#   12-24 hours = Moderate risk content
#   168 hours   = Weekly updates (default for profanity)
#   720 hours   = Monthly updates (stable lists)
#
# Applies to Guilds:
#   []              = Apply to all guilds
#   [123, 456]      = Only apply to specific guild IDs
#   ["all_premium"] = Apply only to premium guilds (if implemented)
#
# Categories determine how content is classified and what AI moderation
# settings apply to the detected content.
#
# Actions determine the default action taken when words from this source
# are detected. Guild-specific overrides can modify this behavior.
#
# URL Requirements:
#   - Must be publicly accessible
#   - Should return plain text with one word/pattern per line
#   - HTTPS URLs preferred for security
#   - Consider rate limiting and source reliability
#
# Security Notes:
#   - External sources are validated before applying
#   - Malformed or suspicious content is logged but not applied
#   - Sources that fail repeatedly are automatically disabled
#   - All updates are logged for audit purposes