@equilateral_ai/mindmeld 3.5.3 → 4.0.1

package/src/handlers/alerts/alertsGet.js

@@ -1,250 +0,0 @@
-/**
- * Alerts Get Handler
- * Retrieves attention alerts (own alerts or team alerts for managers)
- *
- * GET /api/alerts
- * Auth: Cognito JWT required
- *
- * Query Parameters:
- * - status: 'active' (default), 'acknowledged', 'resolved', or 'all'
- * - type: Filter by alert type (optional)
- * - severity: Filter by severity (optional)
- */
-
-const { wrapHandler, executeQuery, createSuccessResponse, createErrorResponse } = require('./helpers');
-
-exports.handler = wrapHandler(async ({ requestContext, queryStringParameters }) => {
-    const Request_ID = requestContext.requestId;
-    const email = requestContext.authorizer?.claims?.email || requestContext.authorizer?.jwt?.claims?.email;
-
-    if (!email) {
-        return createErrorResponse(401, 'Authentication required');
-    }
-
-    // Check user role
-    const userCheck = await executeQuery(`
-        SELECT
-            ue.company_id,
-            ue.manager,
-            ue.admin,
-            u.super_admin
-        FROM rapport.user_entitlements ue
-        JOIN rapport.users u ON ue.email_address = u.email_address
-        WHERE ue.email_address = $1
-    `, [email]);
-
-    if (userCheck.rowCount === 0) {
-        return createErrorResponse(403, 'Access denied');
-    }
-
-    const userRole = userCheck.rows[0];
-    const isManager = userRole.manager || userRole.admin || userRole.super_admin;
-    const companyId = userRole.company_id;
-
-    // Parse query parameters
-    const status = queryStringParameters?.status || 'active';
-    const alertType = queryStringParameters?.type || null;
-    const severity = queryStringParameters?.severity || null;
-
-    let result;
-
-    if (isManager) {
-        // Get team alerts with optional filters
-        let query = `
-            SELECT
-                aa.alert_id,
-                aa.email_address,
-                CONCAT(u.first_name, ' ', u.last_name) as user_name,
-                aa.alert_type,
-                aa.severity,
-                aa.details,
-                aa.status,
-                aa.acknowledged_by,
-                aa.acknowledged_at,
-                aa.expires_at,
-                aa.created_at
-            FROM rapport.attention_alerts aa
-            JOIN rapport.users u ON aa.email_address = u.email_address
-            WHERE aa.company_id = $1
-        `;
-
-        const params = [companyId];
-        let paramIndex = 2;
-
-        // Status filter
-        if (status !== 'all') {
-            query += ` AND aa.status = $${paramIndex}`;
-            params.push(status);
-            paramIndex++;
-        }
-
-        // Alert type filter
-        if (alertType) {
-            query += ` AND aa.alert_type = $${paramIndex}`;
-            params.push(alertType);
-            paramIndex++;
-        }
-
-        // Severity filter
-        if (severity) {
-            query += ` AND aa.severity = $${paramIndex}`;
-            params.push(severity);
-            paramIndex++;
-        }
-
-        // Order by severity (critical > warning > info) then by date
-        query += `
-            ORDER BY
-                CASE aa.severity
-                    WHEN 'critical' THEN 1
-                    WHEN 'warning' THEN 2
-                    ELSE 3
-                END,
-                aa.created_at DESC
-        `;
-
-        result = await executeQuery(query, params);
-    } else {
-        // Get own alerts only
-        let query = `
-            SELECT
-                aa.alert_id,
-                aa.email_address,
-                aa.alert_type,
-                aa.severity,
-                aa.details,
-                aa.status,
-                aa.expires_at,
-                aa.created_at
-            FROM rapport.attention_alerts aa
-            WHERE aa.email_address = $1
-        `;
-
-        const params = [email];
-        let paramIndex = 2;
-
-        if (status !== 'all') {
-            query += ` AND aa.status = $${paramIndex}`;
-            params.push(status);
-            paramIndex++;
-        }
-
-        if (alertType) {
-            query += ` AND aa.alert_type = $${paramIndex}`;
-            params.push(alertType);
-            paramIndex++;
-        }
-
-        if (severity) {
-            query += ` AND aa.severity = $${paramIndex}`;
-            params.push(severity);
-            paramIndex++;
-        }
-
-        query += ` ORDER BY aa.created_at DESC`;
-
-        result = await executeQuery(query, params);
-    }
-
-    const alerts = result.rows.map(alert => ({
-        alert_id: alert.alert_id,
-        email_address: alert.email_address,
-        user_name: alert.user_name || null,
-        alert_type: alert.alert_type,
-        severity: alert.severity,
-        details: alert.details,
-        status: alert.status,
-        acknowledged_by: alert.acknowledged_by || null,
-        acknowledged_at: alert.acknowledged_at || null,
-        expires_at: alert.expires_at || null,
-        created_at: alert.created_at,
-        message: getAlertMessage(alert.alert_type, alert.details),
-        recommendation: getAlertRecommendation(alert.alert_type, alert.severity)
-    }));
-
-    // Calculate summary statistics
-    const summary = {
-        total: alerts.length,
-        by_severity: {
-            critical: alerts.filter(a => a.severity === 'critical').length,
-            warning: alerts.filter(a => a.severity === 'warning').length,
-            info: alerts.filter(a => a.severity === 'info').length
-        },
-        by_type: {}
-    };
-
-    for (const alert of alerts) {
-        summary.by_type[alert.alert_type] = (summary.by_type[alert.alert_type] || 0) + 1;
-    }
-
-    return createSuccessResponse(
-        { Records: alerts, summary, is_manager_view: isManager },
-        'Alerts retrieved',
-        { Total_Records: alerts.length, Request_ID, Timestamp: new Date().toISOString() }
-    );
-});
-
-/**
- * Generate human-readable message for alert
- */
-function getAlertMessage(alertType, details) {
-    switch (alertType) {
-        case 'stale_commits':
-            return `No commits in ${details.days_since_commit} days`;
-
-        case 'low_conversion':
-            return `Low session-to-commit conversion: ${details.conversion_pct}%`;
-
-        case 'no_ai_usage':
-            return `Active committer not using AI assistance (${details.commits_30d} commits, 0 sessions)`;
-
-        case 'high_violation_rate':
-            return `High standards violation rate: ${details.violation_rate}% (${details.violations}/${details.standards_shown})`;
-
-        case 'stalled_patterns':
-            return `Stalled patterns: ${details.stale_patterns} patterns unused, ${details.provisional_patterns} stuck in provisional`;
-
-        case 'declining_activity':
-            const decline = details.decline_pct || 0;
-            return `Activity declined ${decline}% (was ${details.avg_previous_weeks} sessions/week, now ${details.current_week})`;
-
-        default:
-            return `Alert: ${alertType}`;
-    }
-}
-
-/**
- * Generate actionable recommendation for alert
- */
-function getAlertRecommendation(alertType, severity) {
-    const recommendations = {
-        stale_commits: {
-            critical: 'Schedule a 1:1 to check in on progress and identify blockers',
-            warning: 'Consider reaching out to offer assistance',
-            info: 'Monitor for continued inactivity'
-        },
-        low_conversion: {
-            critical: 'Review session recordings to identify workflow issues',
-            warning: 'Check if developer needs additional training on AI tools',
-            info: 'Provide tips for effective AI-assisted development'
-        },
-        no_ai_usage: {
-            info: 'Share AI adoption resources and success stories from team'
-        },
-        high_violation_rate: {
-            critical: 'Schedule standards review session with developer',
-            warning: 'Share relevant standards documentation',
-            info: 'Consider adding standards to onboarding materials'
-        },
-        stalled_patterns: {
-            warning: 'Review patterns for promotion or deprecation',
-            info: 'Encourage pattern documentation and sharing'
-        },
-        declining_activity: {
-            warning: 'Check in on workload and well-being',
-            info: 'Monitor for continued decline'
-        }
-    };
-
-    return recommendations[alertType]?.[severity] || recommendations[alertType]?.info || 'Monitor and follow up as needed';
-}

package/src/handlers/analytics/activitySummaryGet.js

@@ -1,234 +0,0 @@
-/**
- * Activity Summary Get Handler
- * Aggregates activity metrics for analytics dashboards
- *
- * GET /api/analytics/activity-summary
- * Auth: Cognito JWT required
- *
- * Query Parameters:
- * - project_id (optional): filter to a specific project
- * - period: 7d | 30d | 90d (default: 7d)
- *
- * Returns harvests, injections, promotions, violations, and top standards
- * broken down by day and category.
- */
-
-const { wrapHandler, executeQuery, createSuccessResponse, createErrorResponse } = require('./helpers');
-
-async function getActivitySummary({ requestContext, queryStringParameters }) {
-    const Request_ID = requestContext.requestId;
-    const email = requestContext.authorizer?.claims?.email || requestContext.authorizer?.jwt?.claims?.email;
-
-    if (!email) {
-        return createErrorResponse(401, 'Authentication required');
-    }
-
-    // Verify user access
-    const userCheck = await executeQuery(`
-        SELECT ue.company_id
-        FROM rapport.user_entitlements ue
-        WHERE ue.email_address = $1
-        LIMIT 1
-    `, [email]);
-
-    if (userCheck.rowCount === 0) {
-        return createErrorResponse(403, 'Access denied');
-    }
-
-    const companyId = userCheck.rows[0].company_id;
-    const params = queryStringParameters || {};
-    const projectId = params.project_id || null;
-    const period = params.period || '7d';
-
-    const periodDays = parsePeriod(period);
-    const periodStart = new Date();
-    periodStart.setDate(periodStart.getDate() - periodDays);
-
-    // Build project filter clause
-    const projectFilter = projectId ? 'AND at.project_id = $3' : '';
-    const baseParams = projectId
-        ? [companyId, periodStart.toISOString(), projectId]
-        : [companyId, periodStart.toISOString()];
-
-    // Harvests: patterns created in the period
-    let harvests = { total: 0, by_day: [] };
-    try {
-        const harvestResult = await executeQuery(`
-            SELECT
-                DATE(p.created_at) as date,
-                COUNT(*) as count
-            FROM rapport.patterns p
-            JOIN rapport.user_entitlements ue ON p.created_by = ue.email_address
-            WHERE ue.company_id = $1
-            AND p.created_at >= $2
-            ${projectId ? 'AND p.project_id = $3' : ''}
-            GROUP BY DATE(p.created_at)
-            ORDER BY date
-        `, baseParams);
-
-        const byDay = harvestResult.rows.map(row => ({
-            date: row.date,
-            count: parseInt(row.count, 10)
-        }));
-        const total = byDay.reduce((sum, d) => sum + d.count, 0);
-        harvests = { total, by_day: byDay };
-    } catch (err) {
-        console.log('[ActivitySummary] Harvests query failed:', err.message);
-    }
-
-    // Injections: count from session_standards joined through sessions
-    let injections = { total: 0, by_day: [] };
-    try {
-        const injectionResult = await executeQuery(`
-            SELECT
-                DATE(ss.created_at) as date,
-                COUNT(*) as count
-            FROM rapport.session_standards ss
-            JOIN rapport.sessions s ON s.session_id = ss.session_id
-            JOIN rapport.user_entitlements ue ON s.email_address = ue.email_address
-            WHERE ue.company_id = $1
-            AND ss.created_at >= $2
-            ${projectId ? 'AND s.project_id = $3' : ''}
-            GROUP BY DATE(ss.created_at)
-            ORDER BY date
-        `, baseParams);
-
-        const byDay = injectionResult.rows.map(row => ({
-            date: row.date,
-            count: parseInt(row.count, 10)
-        }));
-        const total = byDay.reduce((sum, d) => sum + d.count, 0);
-        injections = { total, by_day: byDay };
-    } catch (err) {
-        console.log('[ActivitySummary] Injections query failed:', err.message);
-    }
-
-    // Promotions: standard_promoted events + current state counts
-    let promotions = { total: 0, by_state: { proposed: 0, active: 0 } };
-    try {
-        const promotionResult = await executeQuery(`
-            SELECT COUNT(*) as count
-            FROM rapport.audit_trail at
-            JOIN rapport.user_entitlements ue ON at.email_address = ue.email_address
-            WHERE ue.company_id = $1
-            AND at.action = 'standard_promoted'
-            AND at.created_at >= $2
-            ${projectFilter}
-        `, baseParams);
-
-        const total = parseInt(promotionResult.rows[0].count, 10) || 0;
-
-        // Get current state breakdown
-        const stateResult = await executeQuery(`
-            SELECT
-                p.status,
-                COUNT(*) as count
-            FROM rapport.patterns p
-            JOIN rapport.user_entitlements ue ON p.created_by = ue.email_address
-            WHERE ue.company_id = $1
-            AND p.status IN ('proposed', 'active')
-            ${projectId ? 'AND p.project_id = $3' : ''}
-            GROUP BY p.status
-        `, baseParams);
-
-        const byState = { proposed: 0, active: 0 };
-        for (const row of stateResult.rows) {
-            if (row.status === 'proposed') byState.proposed = parseInt(row.count, 10);
-            if (row.status === 'active') byState.active = parseInt(row.count, 10);
-        }
-
-        promotions = { total, by_state: byState };
-    } catch (err) {
-        console.log('[ActivitySummary] Promotions query failed:', err.message);
-    }
-
-    // Violations: violation_detected events by category
-    let violations = { total: 0, by_category: [] };
-    try {
-        const violationResult = await executeQuery(`
-            SELECT
-                COALESCE(at.details->>'category', 'uncategorized') as category,
-                COUNT(*) as count
-            FROM rapport.audit_trail at
-            JOIN rapport.user_entitlements ue ON at.email_address = ue.email_address
-            WHERE ue.company_id = $1
-            AND at.action = 'violation_detected'
-            AND at.created_at >= $2
-            ${projectFilter}
-            GROUP BY COALESCE(at.details->>'category', 'uncategorized')
-            ORDER BY count DESC
-        `, baseParams);
-
-        const byCategory = violationResult.rows.map(row => ({
-            category: row.category,
-            count: parseInt(row.count, 10)
-        }));
-        const total = byCategory.reduce((sum, c) => sum + c.count, 0);
-        violations = { total, by_category: byCategory };
-    } catch (err) {
-        console.log('[ActivitySummary] Violations query failed:', err.message);
-    }
-
-    // Top standards by usage count from session_standards
-    let topStandards = [];
-    try {
-        const standardsResult = await executeQuery(`
-            SELECT
-                ss.standard_name,
-                COUNT(*) as count
-            FROM rapport.session_standards ss
-            JOIN rapport.sessions s ON s.session_id = ss.session_id
-            JOIN rapport.user_entitlements ue ON s.email_address = ue.email_address
-            WHERE ue.company_id = $1
-            AND ss.created_at >= $2
-            ${projectId ? 'AND s.project_id = $3' : ''}
-            GROUP BY ss.standard_name
-            ORDER BY count DESC
-            LIMIT 10
-        `, baseParams);
-
-        topStandards = standardsResult.rows.map(row => ({
-            standard_name: row.standard_name,
-            count: parseInt(row.count, 10)
-        }));
-    } catch (err) {
-        console.log('[ActivitySummary] Top standards query failed:', err.message);
-    }
-
-    return createSuccessResponse(
-        {
-            period,
-            period_days: periodDays,
-            period_start: periodStart.toISOString(),
-            period_end: new Date().toISOString(),
-            harvests,
-            injections,
-            promotions,
-            violations,
-            top_standards: topStandards
-        },
-        'Activity summary retrieved',
-        { Request_ID, Timestamp: new Date().toISOString() }
-    );
-}
-
-exports.handler = wrapHandler(getActivitySummary);
-
-/**
- * Parse period string into number of days
- * @param {string} period - Period string (7d, 30d, 90d)
- * @returns {number} Number of days
- */
-function parsePeriod(period) {
-    const match = period.match(/^(\d+)([d])$/);
-    if (!match) return 7;
-
-    const [, num] = match;
-    const days = parseInt(num, 10);
-
-    // Cap at 90 days
-    if (days > 90) return 90;
-    if (days < 1) return 7;
-
-    return days;
-}