@equilateral_ai/mindmeld 3.0.0

package/src/core/NotificationService.js

@@ -0,0 +1,1032 @@
+/**
+ * Rapport v3 - Notification Service
+ *
+ * Purpose: Sends notifications via email (SES) and Slack webhooks
+ *
+ * Notification Types:
+ * - Pattern promotions (pattern validated/reinforced)
+ * - Weekly digests (team activity summary)
+ * - Critical violations (standards violations)
+ * - Team alerts (attention alerts for managers)
+ * - Curation candidates (patterns ready for review)
+ *
+ * Based on: Tim-Combo pattern with environment-based configuration
+ */
+
+const { SESClient, SendEmailCommand, SendTemplatedEmailCommand } = require('@aws-sdk/client-ses');
+
+class NotificationService {
+    constructor(config = {}) {
+        this.config = {
+            sesRegion: config.sesRegion || process.env.AWS_REGION || 'us-east-2',
+            fromEmail: config.fromEmail || process.env.SES_FROM_EMAIL || 'noreply@mindmeld.dev',
+            fromName: config.fromName || 'MindMeld',
+            slackWebhookUrl: config.slackWebhookUrl || process.env.SLACK_WEBHOOK_URL,
+            slackCriticalWebhookUrl: config.slackCriticalWebhookUrl || process.env.SLACK_CRITICAL_WEBHOOK_URL,
+            appUrl: config.appUrl || process.env.APP_URL || 'https://mindmeld.dev',
+            enabled: config.enabled !== false && process.env.NOTIFICATIONS_ENABLED !== 'false',
+            ...config
+        };
+
+        // Initialize SES client (lazy - created once, reused across invocations)
+        this.sesClient = null;
+    }
+
+    /**
+     * Get SES client (cached single client pattern for Lambda)
+     */
+    getSESClient() {
+        if (!this.sesClient) {
+            this.sesClient = new SESClient({ region: this.config.sesRegion });
+        }
+        return this.sesClient;
+    }
+
+    /**
+     * Send a notification based on type and preferences
+     *
+     * @param {Object} options - Notification options
+     * @param {string} options.type - Notification type (pattern_promotion, weekly_digest, critical_violation, team_alert, curation_candidate)
+     * @param {string} options.email - Recipient email
+     * @param {Object} options.preferences - User notification preferences
+     * @param {Object} options.data - Notification-specific data
+     * @param {string} options.projectId - Optional project ID for project-specific preferences
+     * @returns {Promise<Object>} Send result
+     */
+    async sendNotification({ type, email, preferences, data, projectId }) {
+        if (!this.config.enabled) {
+            console.log('[NotificationService] Notifications disabled, skipping');
+            return { sent: false, reason: 'notifications_disabled' };
+        }
+
+        const results = { email: null, slack: null };
+
+        // Check email preferences
+        if (this.shouldSendEmail(type, preferences, projectId)) {
+            try {
+                results.email = await this.sendEmail(type, email, data);
+            } catch (error) {
+                console.error('[NotificationService] Email send failed:', error);
+                results.email = { sent: false, error: error.message };
+            }
+        }
+
+        // Check Slack preferences (for team/project notifications)
+        if (this.shouldSendSlack(type, preferences, projectId, data)) {
+            try {
+                results.slack = await this.sendSlack(type, data);
+            } catch (error) {
+                console.error('[NotificationService] Slack send failed:', error);
+                results.slack = { sent: false, error: error.message };
+            }
+        }
+
+        return results;
+    }
+
+    /**
+     * Check if email notification should be sent
+     */
+    shouldSendEmail(type, preferences, projectId) {
+        if (!preferences) return true; // Default to enabled if no preferences
+
+        // Check global email preference
+        if (preferences.email_enabled === false) return false;
+
+        // Check type-specific preference
+        const typePrefs = preferences.notification_types || {};
+        if (typePrefs[type]?.email === false) return false;
+
+        // Check project-specific preference
+        if (projectId && preferences.project_overrides) {
+            const projectPrefs = preferences.project_overrides[projectId];
+            if (projectPrefs?.email_enabled === false) return false;
+            if (projectPrefs?.notification_types?.[type]?.email === false) return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Check if Slack notification should be sent
+     */
+    shouldSendSlack(type, preferences, projectId, data) {
+        // Must have webhook URL configured
+        const isCritical = type === 'critical_violation' || data?.severity === 'critical';
+        const webhookUrl = isCritical ? this.config.slackCriticalWebhookUrl : this.config.slackWebhookUrl;
+
+        if (!webhookUrl) return false;
+
+        if (!preferences) return true; // Default to enabled if no preferences
+
+        // Check global Slack preference
+        if (preferences.slack_enabled === false) return false;
+
+        // Check type-specific preference
+        const typePrefs = preferences.notification_types || {};
+        if (typePrefs[type]?.slack === false) return false;
+
+        // Check project-specific preference
+        if (projectId && preferences.project_overrides) {
+            const projectPrefs = preferences.project_overrides[projectId];
+            if (projectPrefs?.slack_enabled === false) return false;
+            if (projectPrefs?.notification_types?.[type]?.slack === false) return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Send email notification via SES
+     */
+    async sendEmail(type, email, data) {
+        const emailContent = this.buildEmailContent(type, data);
+
+        const command = new SendEmailCommand({
+            Source: `${this.config.fromName} <${this.config.fromEmail}>`,
+            Destination: {
+                ToAddresses: [email]
+            },
+            Message: {
+                Subject: {
+                    Data: emailContent.subject,
+                    Charset: 'UTF-8'
+                },
+                Body: {
+                    Html: {
+                        Data: emailContent.html,
+                        Charset: 'UTF-8'
+                    },
+                    Text: {
+                        Data: emailContent.text,
+                        Charset: 'UTF-8'
+                    }
+                }
+            }
+        });
+
+        const result = await this.getSESClient().send(command);
+
+        console.log(`[NotificationService] Email sent: ${type} to ${email}`);
+        return { sent: true, messageId: result.MessageId };
+    }
+
+    /**
+     * Build email content based on notification type
+     */
+    buildEmailContent(type, data) {
+        switch (type) {
+            case 'pattern_promotion':
+                return this.buildPatternPromotionEmail(data);
+            case 'weekly_digest':
+                return this.buildWeeklyDigestEmail(data);
+            case 'critical_violation':
+                return this.buildCriticalViolationEmail(data);
+            case 'team_alert':
+                return this.buildTeamAlertEmail(data);
+            case 'curation_candidate':
+                return this.buildCurationCandidateEmail(data);
+            default:
+                return this.buildGenericEmail(type, data);
+        }
+    }
+
+    /**
+     * Build pattern promotion email
+     */
+    buildPatternPromotionEmail(data) {
+        const { patternName, projectName, newMaturity, evidence } = data;
+
+        const subject = `Pattern Promoted: ${patternName}`;
+
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
+        .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+        .header { background: #2563eb; color: white; padding: 20px; border-radius: 8px 8px 0 0; }
+        .content { background: #f8fafc; padding: 20px; border-radius: 0 0 8px 8px; }
+        .metric { display: inline-block; margin: 10px 20px 10px 0; }
+        .metric-value { font-size: 24px; font-weight: bold; color: #2563eb; }
+        .metric-label { font-size: 12px; color: #64748b; }
+        .button { display: inline-block; background: #2563eb; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; margin-top: 20px; }
+        .footer { margin-top: 20px; font-size: 12px; color: #94a3b8; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>Pattern Promoted</h1>
+        </div>
+        <div class="content">
+            <h2>${patternName}</h2>
+            <p>A pattern in <strong>${projectName}</strong> has been promoted to <strong>${newMaturity}</strong> status.</p>
+
+            ${evidence ? `
+            <div class="metrics">
+                <div class="metric">
+                    <div class="metric-value">${(evidence.correlation * 100).toFixed(0)}%</div>
+                    <div class="metric-label">Success Rate</div>
+                </div>
+                <div class="metric">
+                    <div class="metric-value">${evidence.projectCount || 0}</div>
+                    <div class="metric-label">Projects</div>
+                </div>
+                <div class="metric">
+                    <div class="metric-value">${evidence.developerCount || 0}</div>
+                    <div class="metric-label">Developers</div>
+                </div>
+                <div class="metric">
+                    <div class="metric-value">${evidence.sessionCount || 0}</div>
+                    <div class="metric-label">Sessions</div>
+                </div>
+            </div>
+            ` : ''}
+
+            <a href="${this.config.appUrl}/dashboard/patterns" class="button">View Patterns</a>
+        </div>
+        <div class="footer">
+            <p>You received this because you're a collaborator on ${projectName}.</p>
+            <p><a href="${this.config.appUrl}/settings/notifications">Manage notification preferences</a></p>
+        </div>
+    </div>
+</body>
+</html>`;
+
+        const text = `Pattern Promoted: ${patternName}
+
+A pattern in ${projectName} has been promoted to ${newMaturity} status.
+
+${evidence ? `Evidence:
+- Success Rate: ${(evidence.correlation * 100).toFixed(0)}%
+- Projects: ${evidence.projectCount || 0}
+- Developers: ${evidence.developerCount || 0}
+- Sessions: ${evidence.sessionCount || 0}` : ''}
+
+View patterns: ${this.config.appUrl}/dashboard/patterns
+
+---
+Manage notification preferences: ${this.config.appUrl}/settings/notifications`;
+
+        return { subject, html, text };
+    }
+
+    /**
+     * Build weekly digest email
+     */
+    buildWeeklyDigestEmail(data) {
+        const {
+            userName,
+            weekStart,
+            weekEnd,
+            patternsLearned,
+            patternsReinforced,
+            sessionsCount,
+            teamActivity,
+            loadBearingElements
+        } = data;
+
+        const subject = `Weekly Digest: ${weekStart} - ${weekEnd}`;
+
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
+        .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+        .header { background: linear-gradient(135deg, #2563eb, #7c3aed); color: white; padding: 20px; border-radius: 8px 8px 0 0; }
+        .content { background: #f8fafc; padding: 20px; }
+        .section { background: white; padding: 16px; border-radius: 8px; margin-bottom: 16px; }
+        .section h3 { margin-top: 0; color: #1e293b; }
+        .stat-row { display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #e2e8f0; }
+        .stat-row:last-child { border-bottom: none; }
+        .stat-label { color: #64748b; }
+        .stat-value { font-weight: 600; color: #1e293b; }
+        .footer { margin-top: 20px; font-size: 12px; color: #94a3b8; text-align: center; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>Weekly Digest</h1>
+            <p>${weekStart} - ${weekEnd}</p>
+        </div>
+        <div class="content">
+            <p>Hi ${userName},</p>
+            <p>Here's your team's collaboration summary for the week.</p>
+
+            <div class="section">
+                <h3>Your Activity</h3>
+                <div class="stat-row">
+                    <span class="stat-label">Sessions</span>
+                    <span class="stat-value">${sessionsCount || 0}</span>
+                </div>
+                <div class="stat-row">
+                    <span class="stat-label">Patterns Learned</span>
+                    <span class="stat-value">${patternsLearned || 0}</span>
+                </div>
+                <div class="stat-row">
+                    <span class="stat-label">Patterns Reinforced</span>
+                    <span class="stat-value">${patternsReinforced || 0}</span>
+                </div>
+            </div>
+
+            ${teamActivity ? `
+            <div class="section">
+                <h3>Team Activity</h3>
+                <div class="stat-row">
+                    <span class="stat-label">Total Sessions</span>
+                    <span class="stat-value">${teamActivity.totalSessions || 0}</span>
+                </div>
+                <div class="stat-row">
+                    <span class="stat-label">Active Collaborators</span>
+                    <span class="stat-value">${teamActivity.activeCollaborators || 0}</span>
+                </div>
+                <div class="stat-row">
+                    <span class="stat-label">Shared Patterns</span>
+                    <span class="stat-value">${teamActivity.sharedPatterns || 0}</span>
+                </div>
+            </div>
+            ` : ''}
+
+            ${loadBearingElements && loadBearingElements.length > 0 ? `
+            <div class="section">
+                <h3>Load-Bearing Context (Top ${loadBearingElements.length})</h3>
+                ${loadBearingElements.map(el => `
+                <div class="stat-row">
+                    <span class="stat-label">${el.key}</span>
+                    <span class="stat-value">${(el.correlation * 100).toFixed(0)}% correlation</span>
+                </div>
+                `).join('')}
+            </div>
+            ` : ''}
+        </div>
+        <div class="footer">
+            <p><a href="${this.config.appUrl}/dashboard">View Full Dashboard</a></p>
+            <p><a href="${this.config.appUrl}/settings/notifications">Manage notification preferences</a></p>
+        </div>
+    </div>
+</body>
+</html>`;
+
+        const text = `Weekly Digest: ${weekStart} - ${weekEnd}
+
+Hi ${userName},
+
+Here's your team's collaboration summary for the week.
+
+YOUR ACTIVITY
+- Sessions: ${sessionsCount || 0}
+- Patterns Learned: ${patternsLearned || 0}
+- Patterns Reinforced: ${patternsReinforced || 0}
+
+${teamActivity ? `TEAM ACTIVITY
+- Total Sessions: ${teamActivity.totalSessions || 0}
+- Active Collaborators: ${teamActivity.activeCollaborators || 0}
+- Shared Patterns: ${teamActivity.sharedPatterns || 0}` : ''}
+
+View dashboard: ${this.config.appUrl}/dashboard
+
+---
+Manage notification preferences: ${this.config.appUrl}/settings/notifications`;
+
+        return { subject, html, text };
+    }
+
+    /**
+     * Build critical violation email
+     */
+    buildCriticalViolationEmail(data) {
+        const { violationType, projectName, standardName, details, filePath } = data;
+
+        const subject = `[CRITICAL] Standards Violation: ${standardName}`;
+
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
+        .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+        .header { background: #dc2626; color: white; padding: 20px; border-radius: 8px 8px 0 0; }
+        .content { background: #fef2f2; padding: 20px; border-radius: 0 0 8px 8px; }
+        .alert-box { background: white; border-left: 4px solid #dc2626; padding: 16px; margin: 16px 0; }
+        .code-block { background: #1e293b; color: #e2e8f0; padding: 16px; border-radius: 6px; font-family: monospace; overflow-x: auto; }
+        .button { display: inline-block; background: #dc2626; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; margin-top: 20px; }
+        .footer { margin-top: 20px; font-size: 12px; color: #94a3b8; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>Critical Standards Violation</h1>
+        </div>
+        <div class="content">
+            <div class="alert-box">
+                <strong>Standard:</strong> ${standardName}<br>
+                <strong>Project:</strong> ${projectName}<br>
+                ${filePath ? `<strong>File:</strong> ${filePath}<br>` : ''}
+                <strong>Type:</strong> ${violationType}
+            </div>
+
+            <h3>Details</h3>
+            <p>${details}</p>
+
+            <a href="${this.config.appUrl}/dashboard/violations" class="button">View Violations</a>
+        </div>
+        <div class="footer">
+            <p>This is a critical alert. You received this because you're a project admin.</p>
+            <p><a href="${this.config.appUrl}/settings/notifications">Manage notification preferences</a></p>
+        </div>
+    </div>
+</body>
+</html>`;
+
+        const text = `[CRITICAL] Standards Violation: ${standardName}
+
+Standard: ${standardName}
+Project: ${projectName}
+${filePath ? `File: ${filePath}` : ''}
+Type: ${violationType}
+
+Details:
+${details}
+
+View violations: ${this.config.appUrl}/dashboard/violations
+
+---
+Manage notification preferences: ${this.config.appUrl}/settings/notifications`;
+
+        return { subject, html, text };
+    }
+
+    /**
+     * Build team alert email
+     */
+    buildTeamAlertEmail(data) {
+        const { alertType, severity, userName, details, message } = data;
+
+        const severityColors = {
+            concern: '#dc2626',
+            warning: '#f59e0b',
+            info: '#3b82f6'
+        };
+
+        const subject = `[${severity.toUpperCase()}] Team Alert: ${message}`;
+
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
+        .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+        .header { background: ${severityColors[severity] || '#3b82f6'}; color: white; padding: 20px; border-radius: 8px 8px 0 0; }
+        .content { background: #f8fafc; padding: 20px; border-radius: 0 0 8px 8px; }
+        .alert-box { background: white; border-left: 4px solid ${severityColors[severity] || '#3b82f6'}; padding: 16px; margin: 16px 0; }
+        .button { display: inline-block; background: ${severityColors[severity] || '#3b82f6'}; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; margin-top: 20px; }
+        .footer { margin-top: 20px; font-size: 12px; color: #94a3b8; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>Team Alert</h1>
+        </div>
+        <div class="content">
+            <div class="alert-box">
+                <strong>Team Member:</strong> ${userName}<br>
+                <strong>Alert Type:</strong> ${alertType}<br>
+                <strong>Severity:</strong> ${severity}
+            </div>
+
+            <h3>${message}</h3>
+
+            ${details ? `
+            <ul>
+                ${Object.entries(details).map(([key, value]) => `<li><strong>${key}:</strong> ${value}</li>`).join('')}
+            </ul>
+            ` : ''}
+
+            <a href="${this.config.appUrl}/dashboard/alerts" class="button">View Alerts</a>
+        </div>
+        <div class="footer">
+            <p>You received this because you're a team manager.</p>
+            <p><a href="${this.config.appUrl}/settings/notifications">Manage notification preferences</a></p>
+        </div>
+    </div>
+</body>
+</html>`;
+
+        const text = `[${severity.toUpperCase()}] Team Alert: ${message}
+
+Team Member: ${userName}
+Alert Type: ${alertType}
+Severity: ${severity}
+
+${details ? Object.entries(details).map(([key, value]) => `${key}: ${value}`).join('\n') : ''}
+
+View alerts: ${this.config.appUrl}/dashboard/alerts
+
+---
+Manage notification preferences: ${this.config.appUrl}/settings/notifications`;
+
+        return { subject, html, text };
+    }
+
+    /**
+     * Build curation candidate email
+     */
+    buildCurationCandidateEmail(data) {
+        const { candidateId, patternName, category, evidence } = data;
+
+        const subject = `New Curation Candidate: ${patternName}`;
+
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
+        .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+        .header { background: linear-gradient(135deg, #059669, #10b981); color: white; padding: 20px; border-radius: 8px 8px 0 0; }
+        .content { background: #f0fdf4; padding: 20px; border-radius: 0 0 8px 8px; }
+        .metric { display: inline-block; margin: 10px 20px 10px 0; }
+        .metric-value { font-size: 24px; font-weight: bold; color: #059669; }
+        .metric-label { font-size: 12px; color: #64748b; }
+        .button { display: inline-block; background: #059669; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; margin-top: 20px; margin-right: 10px; }
+        .button-secondary { background: #64748b; }
+        .footer { margin-top: 20px; font-size: 12px; color: #94a3b8; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>New Curation Candidate</h1>
+            <p>Pattern ready for review</p>
+        </div>
+        <div class="content">
+            <h2>${patternName}</h2>
+            <p><strong>Category:</strong> ${category}</p>
+
+            ${evidence ? `
+            <div class="metrics">
+                <div class="metric">
+                    <div class="metric-value">${(evidence.correlation * 100).toFixed(0)}%</div>
+                    <div class="metric-label">Success Rate</div>
+                </div>
+                <div class="metric">
+                    <div class="metric-value">${evidence.projectCount || 0}</div>
+                    <div class="metric-label">Projects</div>
+                </div>
+                <div class="metric">
+                    <div class="metric-value">${evidence.developerCount || 0}</div>
+                    <div class="metric-label">Developers</div>
+                </div>
+                <div class="metric">
+                    <div class="metric-value">${evidence.sessionCount || 0}</div>
+                    <div class="metric-label">Sessions</div>
+                </div>
+            </div>
+            ` : ''}
+
+            <p>This pattern has met all promotion criteria and is ready for human review before being promoted to .equilateral-standards/</p>
+
+            <a href="${this.config.appUrl}/admin/curation/${candidateId}" class="button">Review Candidate</a>
+            <a href="${this.config.appUrl}/admin/curation" class="button button-secondary">View All Candidates</a>
+        </div>
+        <div class="footer">
+            <p>You received this because you're a standards curator.</p>
+            <p><a href="${this.config.appUrl}/settings/notifications">Manage notification preferences</a></p>
+        </div>
+    </div>
+</body>
+</html>`;
+
+        const text = `New Curation Candidate: ${patternName}
+
+Category: ${category}
+
+${evidence ? `Evidence:
+- Success Rate: ${(evidence.correlation * 100).toFixed(0)}%
+- Projects: ${evidence.projectCount || 0}
+- Developers: ${evidence.developerCount || 0}
+- Sessions: ${evidence.sessionCount || 0}` : ''}
+
+This pattern has met all promotion criteria and is ready for human review.
+
+Review candidate: ${this.config.appUrl}/admin/curation/${candidateId}
+View all candidates: ${this.config.appUrl}/admin/curation
+
+---
+Manage notification preferences: ${this.config.appUrl}/settings/notifications`;
+
+        return { subject, html, text };
+    }
+
+    /**
+     * Build generic email
+     */
+    buildGenericEmail(type, data) {
+        const subject = `MindMeld Notification: ${type}`;
+
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
+        .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+        .header { background: #2563eb; color: white; padding: 20px; border-radius: 8px 8px 0 0; }
+        .content { background: #f8fafc; padding: 20px; border-radius: 0 0 8px 8px; }
+        .footer { margin-top: 20px; font-size: 12px; color: #94a3b8; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>MindMeld Notification</h1>
+        </div>
+        <div class="content">
+            <p><strong>Type:</strong> ${type}</p>
+            <pre>${JSON.stringify(data, null, 2)}</pre>
+        </div>
+        <div class="footer">
+            <p><a href="${this.config.appUrl}/settings/notifications">Manage notification preferences</a></p>
+        </div>
+    </div>
+</body>
+</html>`;
+
+        const text = `MindMeld Notification
+
+Type: ${type}
+
+${JSON.stringify(data, null, 2)}
+
+---
+Manage notification preferences: ${this.config.appUrl}/settings/notifications`;
+
+        return { subject, html, text };
+    }
+
+    /**
+     * Send Slack notification via webhook
+     */
+    async sendSlack(type, data) {
+        const isCritical = type === 'critical_violation' || data?.severity === 'critical';
+        const webhookUrl = isCritical ? this.config.slackCriticalWebhookUrl : this.config.slackWebhookUrl;
+
+        if (!webhookUrl) {
+            return { sent: false, reason: 'no_webhook_url' };
+        }
+
+        const payload = this.buildSlackPayload(type, data);
+
+        const response = await fetch(webhookUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload)
+        });
+
+        if (!response.ok) {
+            throw new Error(`Slack webhook failed: ${response.status}`);
+        }
+
+        console.log(`[NotificationService] Slack notification sent: ${type}`);
+        return { sent: true };
+    }
+
+    /**
+     * Build Slack message payload based on notification type
+     */
+    buildSlackPayload(type, data) {
+        switch (type) {
+            case 'pattern_promotion':
+                return this.buildSlackPatternPromotion(data);
+            case 'critical_violation':
+                return this.buildSlackCriticalViolation(data);
+            case 'team_alert':
+                return this.buildSlackTeamAlert(data);
+            case 'curation_candidate':
+                return this.buildSlackCurationCandidate(data);
+            default:
+                return this.buildSlackGeneric(type, data);
+        }
+    }
+
+    /**
+     * Build Slack pattern promotion payload
+     */
+    buildSlackPatternPromotion(data) {
+        const { patternName, projectName, newMaturity, evidence } = data;
+
+        return {
+            blocks: [
+                {
+                    type: 'header',
+                    text: {
+                        type: 'plain_text',
+                        text: 'Pattern Promoted',
+                        emoji: true
+                    }
+                },
+                {
+                    type: 'section',
+                    fields: [
+                        {
+                            type: 'mrkdwn',
+                            text: `*Pattern:*\n${patternName}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Project:*\n${projectName}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*New Status:*\n${newMaturity}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Success Rate:*\n${evidence ? (evidence.correlation * 100).toFixed(0) + '%' : 'N/A'}`
+                        }
+                    ]
+                },
+                {
+                    type: 'actions',
+                    elements: [
+                        {
+                            type: 'button',
+                            text: {
+                                type: 'plain_text',
+                                text: 'View Patterns'
+                            },
+                            url: `${this.config.appUrl}/dashboard/patterns`
+                        }
+                    ]
+                }
+            ]
+        };
+    }
+
+    /**
+     * Build Slack critical violation payload
+     */
+    buildSlackCriticalViolation(data) {
+        const { violationType, projectName, standardName, details, filePath } = data;
+
+        return {
+            blocks: [
+                {
+                    type: 'header',
+                    text: {
+                        type: 'plain_text',
+                        text: 'CRITICAL: Standards Violation',
+                        emoji: true
+                    }
+                },
+                {
+                    type: 'section',
+                    text: {
+                        type: 'mrkdwn',
+                        text: `*${standardName}*\n${details}`
+                    }
+                },
+                {
+                    type: 'section',
+                    fields: [
+                        {
+                            type: 'mrkdwn',
+                            text: `*Project:*\n${projectName}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Type:*\n${violationType}`
+                        }
+                    ]
+                },
+                filePath ? {
+                    type: 'context',
+                    elements: [
+                        {
+                            type: 'mrkdwn',
+                            text: `File: \`${filePath}\``
+                        }
+                    ]
+                } : null,
+                {
+                    type: 'actions',
+                    elements: [
+                        {
+                            type: 'button',
+                            text: {
+                                type: 'plain_text',
+                                text: 'View Violations'
+                            },
+                            style: 'danger',
+                            url: `${this.config.appUrl}/dashboard/violations`
+                        }
+                    ]
+                }
+            ].filter(Boolean)
+        };
+    }
+
+    /**
+     * Build Slack team alert payload
+     */
+    buildSlackTeamAlert(data) {
+        const { alertType, severity, userName, message, details } = data;
+
+        const severityEmoji = {
+            concern: ':red_circle:',
+            warning: ':large_orange_circle:',
+            info: ':large_blue_circle:'
+        };
+
+        return {
+            blocks: [
+                {
+                    type: 'header',
+                    text: {
+                        type: 'plain_text',
+                        text: 'Team Alert',
+                        emoji: true
+                    }
+                },
+                {
+                    type: 'section',
+                    text: {
+                        type: 'mrkdwn',
+                        text: `${severityEmoji[severity] || ''} *${message}*`
+                    }
+                },
+                {
+                    type: 'section',
+                    fields: [
+                        {
+                            type: 'mrkdwn',
+                            text: `*Team Member:*\n${userName}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Severity:*\n${severity}`
+                        }
+                    ]
+                },
+                details ? {
+                    type: 'context',
+                    elements: Object.entries(details).map(([key, value]) => ({
+                        type: 'mrkdwn',
+                        text: `*${key}:* ${value}`
+                    }))
+                } : null,
+                {
+                    type: 'actions',
+                    elements: [
+                        {
+                            type: 'button',
+                            text: {
+                                type: 'plain_text',
+                                text: 'View Alerts'
+                            },
+                            url: `${this.config.appUrl}/dashboard/alerts`
+                        }
+                    ]
+                }
+            ].filter(Boolean)
+        };
+    }
+
+    /**
+     * Build Slack curation candidate payload
+     */
+    buildSlackCurationCandidate(data) {
+        const { candidateId, patternName, category, evidence } = data;
+
+        return {
+            blocks: [
+                {
+                    type: 'header',
+                    text: {
+                        type: 'plain_text',
+                        text: 'New Curation Candidate',
+                        emoji: true
+                    }
+                },
+                {
+                    type: 'section',
+                    text: {
+                        type: 'mrkdwn',
+                        text: `*${patternName}*\nReady for review and promotion to .equilateral-standards/`
+                    }
+                },
+                {
+                    type: 'section',
+                    fields: [
+                        {
+                            type: 'mrkdwn',
+                            text: `*Category:*\n${category}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Success Rate:*\n${evidence ? (evidence.correlation * 100).toFixed(0) + '%' : 'N/A'}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Projects:*\n${evidence?.projectCount || 0}`
+                        },
+                        {
+                            type: 'mrkdwn',
+                            text: `*Developers:*\n${evidence?.developerCount || 0}`
+                        }
+                    ]
+                },
+                {
+                    type: 'actions',
+                    elements: [
+                        {
+                            type: 'button',
+                            text: {
+                                type: 'plain_text',
+                                text: 'Review Candidate'
+                            },
+                            style: 'primary',
+                            url: `${this.config.appUrl}/admin/curation/${candidateId}`
+                        }
+                    ]
+                }
+            ]
+        };
+    }
+
+    /**
+     * Build generic Slack payload
+     */
+    buildSlackGeneric(type, data) {
+        return {
+            blocks: [
+                {
+                    type: 'header',
+                    text: {
+                        type: 'plain_text',
+                        text: `MindMeld: ${type}`,
+                        emoji: true
+                    }
+                },
+                {
+                    type: 'section',
+                    text: {
+                        type: 'mrkdwn',
+                        text: '```' + JSON.stringify(data, null, 2) + '```'
+                    }
+                }
+            ]
+        };
+    }
+
+    /**
+     * Send batch notifications (for weekly digests, etc.)
+     *
+     * @param {Array} recipients - Array of { email, preferences, data }
+     * @param {string} type - Notification type
+     * @returns {Promise<Object>} Batch results
+     */
+    async sendBatch(recipients, type) {
+        const results = {
+            total: recipients.length,
+            sent: 0,
+            failed: 0,
+            skipped: 0,
+            errors: []
+        };
+
+        for (const recipient of recipients) {
+            try {
+                const result = await this.sendNotification({
+                    type,
+                    email: recipient.email,
+                    preferences: recipient.preferences,
+                    data: recipient.data,
+                    projectId: recipient.projectId
+                });
+
+                if (result.email?.sent || result.slack?.sent) {
+                    results.sent++;
+                } else {
+                    results.skipped++;
+                }
+            } catch (error) {
+                results.failed++;
+                results.errors.push({ email: recipient.email, error: error.message });
+            }
+        }
+
+        return results;
+    }
+}
+
+module.exports = { NotificationService };