@bbearai/mcp-server 0.7.1 → 0.7.2

package/dist/index.js

@@ -1034,6 +1034,33 @@ const tools = [
             required: ['name'],
         },
     },
+    {
+        name: 'update_test_run',
+        description: 'Update a test run\'s status or metadata. Use to activate, pause, complete, or archive a test run.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                test_run_id: {
+                    type: 'string',
+                    description: 'UUID of the test run to update (required)',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['draft', 'active', 'paused', 'completed', 'archived'],
+                    description: 'New status for the test run',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Updated name for the test run',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Updated description for the test run',
+                },
+            },
+            required: ['test_run_id'],
+        },
+    },
     {
         name: 'list_test_assignments',
         description: 'List test assignments showing which tests are assigned to which testers, with status tracking. Joins test case and tester info.',
@@ -1280,6 +1307,24 @@ const tools = [
             },
         },
     },
+    {
+        name: 'get_tester_report',
+        description: 'Get a comprehensive analytics report for a single tester — time spent, pass/fail ratios, comment quality, activity streaks, and recent tests. All computed server-side in one query.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                tester_id: {
+                    type: 'string',
+                    description: 'UUID of the tester (required)',
+                },
+                days: {
+                    type: 'number',
+                    description: 'Number of days to look back (default: 30, 0 = all time, max: 365)',
+                },
+            },
+            required: ['tester_id'],
+        },
+    },
     // === PROJECT MANAGEMENT TOOLS ===
     {
         name: 'list_projects',
@@ -1451,7 +1496,159 @@ const tools = [
             },
         },
     },
+    // === EMAIL TESTING TOOLS ===
+    {
+        name: 'list_captured_emails',
+        description: 'List captured emails for the project. Use to review intercepted email sends during QA testing. Returns subject, recipients, template, delivery status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                template_id: {
+                    type: 'string',
+                    description: 'Filter by template ID',
+                },
+                delivery_status: {
+                    type: 'string',
+                    enum: ['pending', 'sent', 'delivered', 'bounced', 'dropped', 'deferred'],
+                    description: 'Filter by delivery status',
+                },
+                capture_mode: {
+                    type: 'string',
+                    enum: ['capture', 'intercept'],
+                    description: 'Filter by capture mode',
+                },
+                search: {
+                    type: 'string',
+                    description: 'Search subject line (case-insensitive)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Max results (default: 20, max: 100)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Offset for pagination (default: 0)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_email_preview',
+        description: 'Get full email content including HTML body, metadata, delivery tracking, and extracted links. Use to inspect a specific captured email.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                email_id: {
+                    type: 'string',
+                    description: 'UUID of the email capture to preview',
+                },
+            },
+            required: ['email_id'],
+        },
+    },
+    {
+        name: 'get_email_coverage',
+        description: 'Get email template coverage — shows which templates have been captured/tested and how often. Use to identify untested email templates.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'number',
+                    description: 'Look-back period in days (default: 30)',
+                },
+            },
+        },
+    },
 ];
+// === EMAIL TESTING ===
+async function listCapturedEmails(args) {
+    const projectId = requireProject();
+    const limit = Math.min(args.limit || 20, 100);
+    const offset = args.offset || 0;
+    let query = supabase
+        .from('email_captures')
+        .select('id, to_addresses, from_address, subject, template_id, capture_mode, was_delivered, delivery_status, created_at, tester_id, metadata', { count: 'exact' })
+        .eq('project_id', projectId)
+        .order('created_at', { ascending: false })
+        .range(offset, offset + limit - 1);
+    if (args.template_id)
+        query = query.eq('template_id', args.template_id);
+    if (args.delivery_status)
+        query = query.eq('delivery_status', args.delivery_status);
+    if (args.capture_mode)
+        query = query.eq('capture_mode', args.capture_mode);
+    if (args.search) {
+        const escaped = args.search.replace(/\\/g, '\\\\').replace(/%/g, '\\%').replace(/_/g, '\\_');
+        query = query.ilike('subject', `%${escaped}%`);
+    }
+    const { data, error, count } = await query;
+    if (error)
+        return { error: error.message };
+    return {
+        emails: data || [],
+        total: count ?? data?.length ?? 0,
+    };
+}
+async function getEmailPreview(args) {
+    const projectId = requireProject();
+    if (!args.email_id || !UUID_REGEX.test(args.email_id)) {
+        return { error: 'email_id must be a valid UUID' };
+    }
+    const { data, error } = await supabase
+        .from('email_captures')
+        .select('id, to_addresses, from_address, subject, html_content, text_content, template_id, metadata, capture_mode, was_delivered, delivery_status, opened_at, clicked_at, bounced_at, delivery_error, created_at')
+        .eq('id', args.email_id)
+        .eq('project_id', projectId)
+        .single();
+    if (error || !data)
+        return { error: error?.message || 'Email not found' };
+    // Extract links from HTML
+    const links = [];
+    if (data.html_content) {
+        const hrefRegex = /href="([^"]+)"/gi;
+        let match;
+        while ((match = hrefRegex.exec(data.html_content)) !== null) {
+            if (match[1] && !match[1].startsWith('mailto:')) {
+                links.push(match[1]);
+            }
+        }
+    }
+    return { email: data, links };
+}
+async function getEmailCoverage(args) {
+    const projectId = requireProject();
+    const days = args.days || 30;
+    const since = new Date(Date.now() - days * 86400000).toISOString();
+    const { data, error } = await supabase
+        .from('email_captures')
+        .select('template_id, created_at')
+        .eq('project_id', projectId)
+        .gte('created_at', since)
+        .not('template_id', 'is', null)
+        .order('created_at', { ascending: false });
+    if (error)
+        return { error: error.message };
+    // Group by template_id
+    const templates = new Map();
+    for (const row of data || []) {
+        const existing = templates.get(row.template_id);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            templates.set(row.template_id, { count: 1, lastCaptured: row.created_at });
+        }
+    }
+    return {
+        templates: Array.from(templates.entries()).map(([id, stats]) => ({
+            templateId: id,
+            captureCount: stats.count,
+            lastCaptured: stats.lastCaptured,
+        })),
+        totalCaptures: data?.length || 0,
+        periodDays: days,
+    };
+}
 // === TEST EXECUTION INTELLIGENCE ===
 async function getTestImpact(args) {
     const projectId = requireProject();
@@ -5347,6 +5544,54 @@ async function createTestRun(args) {
         message: `Test run "${data.name}" created. Use assign_tests to add test assignments.`,
     };
 }
+async function updateTestRun(args) {
+    if (!isValidUUID(args.test_run_id)) {
+        return { error: 'Invalid test_run_id format' };
+    }
+    const validStatuses = ['draft', 'active', 'paused', 'completed', 'archived'];
+    if (args.status && !validStatuses.includes(args.status)) {
+        return { error: `Invalid status. Must be one of: ${validStatuses.join(', ')}` };
+    }
+    const updates = {};
+    if (args.status)
+        updates.status = args.status;
+    if (args.name)
+        updates.name = args.name.trim();
+    if (args.description !== undefined)
+        updates.description = args.description?.trim() || null;
+    if (args.status === 'active' && !updates.started_at) {
+        updates.started_at = new Date().toISOString();
+    }
+    if (args.status === 'completed') {
+        updates.completed_at = new Date().toISOString();
+    }
+    if (Object.keys(updates).length === 0) {
+        return { error: 'No updates provided. Specify at least one of: status, name, description.' };
+    }
+    const { data, error } = await supabase
+        .from('test_runs')
+        .update(updates)
+        .eq('id', args.test_run_id)
+        .eq('project_id', currentProjectId)
+        .select('id, name, description, status, total_tests, started_at, completed_at')
+        .single();
+    if (error) {
+        return { error: error.message };
+    }
+    return {
+        success: true,
+        testRun: {
+            id: data.id,
+            name: data.name,
+            description: data.description,
+            status: data.status,
+            totalTests: data.total_tests,
+            startedAt: data.started_at,
+            completedAt: data.completed_at,
+        },
+        message: `Test run "${data.name}" updated to status: ${data.status}.`,
+    };
+}
 async function listTestAssignments(args) {
     const limit = Math.min(args.limit || 50, 200);
     if (args.tester_id && !isValidUUID(args.tester_id)) {
@@ -6124,6 +6369,22 @@ async function getTestingVelocity(args) {
         daily: dailyArray,
     };
 }
+async function getTesterReport(args) {
+    const projectId = requireProject();
+    if (!isValidUUID(args.tester_id))
+        return { error: 'Invalid tester_id format' };
+    const days = args.days !== undefined ? Math.min(Math.max(args.days, 0), 365) : 30;
+    const { data, error } = await supabase.rpc('get_tester_report', {
+        p_project_id: projectId,
+        p_tester_id: args.tester_id,
+        p_days: days || null,
+    });
+    if (error)
+        return { error: error.message };
+    if (data?.error)
+        return { error: data.error };
+    return data;
+}
 // Main server setup
 async function main() {
     initSupabase();
@@ -6283,6 +6544,9 @@ async function main() {
                 case 'create_test_run':
                     result = await createTestRun(args);
                     break;
+                case 'update_test_run':
+                    result = await updateTestRun(args);
+                    break;
                 case 'list_test_assignments':
                     result = await listTestAssignments(args);
                     break;
@@ -6317,6 +6581,9 @@ async function main() {
                 case 'get_testing_velocity':
                     result = await getTestingVelocity(args);
                     break;
+                case 'get_tester_report':
+                    result = await getTesterReport(args);
+                    break;
                 // === PROJECT MANAGEMENT ===
                 case 'list_projects':
                     result = await listProjects();
@@ -6353,6 +6620,16 @@ async function main() {
                 case 'generate_tests_from_errors':
                     result = await generateTestsFromErrors(args);
                     break;
+                // === EMAIL TESTING TOOLS ===
+                case 'list_captured_emails':
+                    result = await listCapturedEmails(args);
+                    break;
+                case 'get_email_preview':
+                    result = await getEmailPreview(args);
+                    break;
+                case 'get_email_coverage':
+                    result = await getEmailCoverage(args);
+                    break;
                 default:
                     return {
                         content: [{ type: 'text', text: `Unknown tool: ${name}` }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbearai/mcp-server",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "MCP server for BugBear - allows Claude Code to query bug reports",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -1051,6 +1051,33 @@ const tools = [
       required: ['name'],
     },
   },
+  {
+    name: 'update_test_run',
+    description: 'Update a test run\'s status or metadata. Use to activate, pause, complete, or archive a test run.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        test_run_id: {
+          type: 'string',
+          description: 'UUID of the test run to update (required)',
+        },
+        status: {
+          type: 'string',
+          enum: ['draft', 'active', 'paused', 'completed', 'archived'],
+          description: 'New status for the test run',
+        },
+        name: {
+          type: 'string',
+          description: 'Updated name for the test run',
+        },
+        description: {
+          type: 'string',
+          description: 'Updated description for the test run',
+        },
+      },
+      required: ['test_run_id'],
+    },
+  },
   {
     name: 'list_test_assignments',
     description: 'List test assignments showing which tests are assigned to which testers, with status tracking. Joins test case and tester info.',
@@ -1297,6 +1324,24 @@ const tools = [
       },
     },
   },
+  {
+    name: 'get_tester_report',
+    description: 'Get a comprehensive analytics report for a single tester — time spent, pass/fail ratios, comment quality, activity streaks, and recent tests. All computed server-side in one query.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        tester_id: {
+          type: 'string',
+          description: 'UUID of the tester (required)',
+        },
+        days: {
+          type: 'number',
+          description: 'Number of days to look back (default: 30, 0 = all time, max: 365)',
+        },
+      },
+      required: ['tester_id'],
+    },
+  },
   // === PROJECT MANAGEMENT TOOLS ===
   {
     name: 'list_projects',
@@ -1468,8 +1513,177 @@ const tools = [
       },
     },
   },
+  // === EMAIL TESTING TOOLS ===
+  {
+    name: 'list_captured_emails',
+    description: 'List captured emails for the project. Use to review intercepted email sends during QA testing. Returns subject, recipients, template, delivery status.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        template_id: {
+          type: 'string',
+          description: 'Filter by template ID',
+        },
+        delivery_status: {
+          type: 'string',
+          enum: ['pending', 'sent', 'delivered', 'bounced', 'dropped', 'deferred'],
+          description: 'Filter by delivery status',
+        },
+        capture_mode: {
+          type: 'string',
+          enum: ['capture', 'intercept'],
+          description: 'Filter by capture mode',
+        },
+        search: {
+          type: 'string',
+          description: 'Search subject line (case-insensitive)',
+        },
+        limit: {
+          type: 'number',
+          description: 'Max results (default: 20, max: 100)',
+        },
+        offset: {
+          type: 'number',
+          description: 'Offset for pagination (default: 0)',
+        },
+      },
+    },
+  },
+  {
+    name: 'get_email_preview',
+    description: 'Get full email content including HTML body, metadata, delivery tracking, and extracted links. Use to inspect a specific captured email.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        email_id: {
+          type: 'string',
+          description: 'UUID of the email capture to preview',
+        },
+      },
+      required: ['email_id'],
+    },
+  },
+  {
+    name: 'get_email_coverage',
+    description: 'Get email template coverage — shows which templates have been captured/tested and how often. Use to identify untested email templates.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        days: {
+          type: 'number',
+          description: 'Look-back period in days (default: 30)',
+        },
+      },
+    },
+  },
 ];
 
+// === EMAIL TESTING ===
+
+async function listCapturedEmails(args: {
+  template_id?: string;
+  delivery_status?: string;
+  capture_mode?: string;
+  search?: string;
+  limit?: number;
+  offset?: number;
+}) {
+  const projectId = requireProject();
+  const limit = Math.min(args.limit || 20, 100);
+  const offset = args.offset || 0;
+
+  let query = supabase
+    .from('email_captures')
+    .select('id, to_addresses, from_address, subject, template_id, capture_mode, was_delivered, delivery_status, created_at, tester_id, metadata', { count: 'exact' })
+    .eq('project_id', projectId)
+    .order('created_at', { ascending: false })
+    .range(offset, offset + limit - 1);
+
+  if (args.template_id) query = query.eq('template_id', args.template_id);
+  if (args.delivery_status) query = query.eq('delivery_status', args.delivery_status);
+  if (args.capture_mode) query = query.eq('capture_mode', args.capture_mode);
+  if (args.search) {
+    const escaped = args.search.replace(/\\/g, '\\\\').replace(/%/g, '\\%').replace(/_/g, '\\_');
+    query = query.ilike('subject', `%${escaped}%`);
+  }
+
+  const { data, error, count } = await query;
+  if (error) return { error: error.message };
+
+  return {
+    emails: data || [],
+    total: count ?? data?.length ?? 0,
+  };
+}
+
+async function getEmailPreview(args: { email_id: string }) {
+  const projectId = requireProject();
+
+  if (!args.email_id || !UUID_REGEX.test(args.email_id)) {
+    return { error: 'email_id must be a valid UUID' };
+  }
+
+  const { data, error } = await supabase
+    .from('email_captures')
+    .select('id, to_addresses, from_address, subject, html_content, text_content, template_id, metadata, capture_mode, was_delivered, delivery_status, opened_at, clicked_at, bounced_at, delivery_error, created_at')
+    .eq('id', args.email_id)
+    .eq('project_id', projectId)
+    .single();
+
+  if (error || !data) return { error: error?.message || 'Email not found' };
+
+  // Extract links from HTML
+  const links: string[] = [];
+  if (data.html_content) {
+    const hrefRegex = /href="([^"]+)"/gi;
+    let match;
+    while ((match = hrefRegex.exec(data.html_content)) !== null) {
+      if (match[1] && !match[1].startsWith('mailto:')) {
+        links.push(match[1]);
+      }
+    }
+  }
+
+  return { email: data, links };
+}
+
+async function getEmailCoverage(args: { days?: number }) {
+  const projectId = requireProject();
+  const days = args.days || 30;
+  const since = new Date(Date.now() - days * 86400000).toISOString();
+
+  const { data, error } = await supabase
+    .from('email_captures')
+    .select('template_id, created_at')
+    .eq('project_id', projectId)
+    .gte('created_at', since)
+    .not('template_id', 'is', null)
+    .order('created_at', { ascending: false });
+
+  if (error) return { error: error.message };
+
+  // Group by template_id
+  const templates = new Map<string, { count: number; lastCaptured: string }>();
+  for (const row of data || []) {
+    const existing = templates.get(row.template_id!);
+    if (existing) {
+      existing.count++;
+    } else {
+      templates.set(row.template_id!, { count: 1, lastCaptured: row.created_at });
+    }
+  }
+
+  return {
+    templates: Array.from(templates.entries()).map(([id, stats]) => ({
+      templateId: id,
+      captureCount: stats.count,
+      lastCaptured: stats.lastCaptured,
+    })),
+    totalCaptures: data?.length || 0,
+    periodDays: days,
+  };
+}
+
 // === TEST EXECUTION INTELLIGENCE ===
 
 async function getTestImpact(args: { changed_files: string[] }) {
@@ -6047,6 +6261,64 @@ async function createTestRun(args: {
   };
 }
 
+async function updateTestRun(args: {
+  test_run_id: string;
+  status?: string;
+  name?: string;
+  description?: string;
+}) {
+  if (!isValidUUID(args.test_run_id)) {
+    return { error: 'Invalid test_run_id format' };
+  }
+
+  const validStatuses = ['draft', 'active', 'paused', 'completed', 'archived'];
+  if (args.status && !validStatuses.includes(args.status)) {
+    return { error: `Invalid status. Must be one of: ${validStatuses.join(', ')}` };
+  }
+
+  const updates: Record<string, any> = {};
+  if (args.status) updates.status = args.status;
+  if (args.name) updates.name = args.name.trim();
+  if (args.description !== undefined) updates.description = args.description?.trim() || null;
+
+  if (args.status === 'active' && !updates.started_at) {
+    updates.started_at = new Date().toISOString();
+  }
+  if (args.status === 'completed') {
+    updates.completed_at = new Date().toISOString();
+  }
+
+  if (Object.keys(updates).length === 0) {
+    return { error: 'No updates provided. Specify at least one of: status, name, description.' };
+  }
+
+  const { data, error } = await supabase
+    .from('test_runs')
+    .update(updates)
+    .eq('id', args.test_run_id)
+    .eq('project_id', currentProjectId)
+    .select('id, name, description, status, total_tests, started_at, completed_at')
+    .single();
+
+  if (error) {
+    return { error: error.message };
+  }
+
+  return {
+    success: true,
+    testRun: {
+      id: data.id,
+      name: data.name,
+      description: data.description,
+      status: data.status,
+      totalTests: data.total_tests,
+      startedAt: data.started_at,
+      completedAt: data.completed_at,
+    },
+    message: `Test run "${data.name}" updated to status: ${data.status}.`,
+  };
+}
+
 async function listTestAssignments(args: {
   tester_id?: string;
   test_run_id?: string;
@@ -6952,6 +7224,25 @@ async function getTestingVelocity(args: {
   };
 }
 
+async function getTesterReport(args: {
+  tester_id: string;
+  days?: number;
+}) {
+  const projectId = requireProject();
+  if (!isValidUUID(args.tester_id)) return { error: 'Invalid tester_id format' };
+  const days = args.days !== undefined ? Math.min(Math.max(args.days, 0), 365) : 30;
+
+  const { data, error } = await supabase.rpc('get_tester_report', {
+    p_project_id: projectId,
+    p_tester_id: args.tester_id,
+    p_days: days || null,
+  });
+
+  if (error) return { error: error.message };
+  if (data?.error) return { error: data.error };
+  return data;
+}
+
 // Main server setup
 async function main() {
   initSupabase();
@@ -7120,6 +7411,9 @@ async function main() {
         case 'create_test_run':
           result = await createTestRun(args as any);
           break;
+        case 'update_test_run':
+          result = await updateTestRun(args as any);
+          break;
         case 'list_test_assignments':
           result = await listTestAssignments(args as any);
           break;
@@ -7154,6 +7448,9 @@ async function main() {
         case 'get_testing_velocity':
           result = await getTestingVelocity(args as any);
           break;
+        case 'get_tester_report':
+          result = await getTesterReport(args as any);
+          break;
         // === PROJECT MANAGEMENT ===
         case 'list_projects':
           result = await listProjects();
@@ -7190,6 +7487,16 @@ async function main() {
         case 'generate_tests_from_errors':
           result = await generateTestsFromErrors(args as any);
           break;
+        // === EMAIL TESTING TOOLS ===
+        case 'list_captured_emails':
+          result = await listCapturedEmails(args as any);
+          break;
+        case 'get_email_preview':
+          result = await getEmailPreview(args as any);
+          break;
+        case 'get_email_coverage':
+          result = await getEmailCoverage(args as any);
+          break;
         default:
           return {
             content: [{ type: 'text', text: `Unknown tool: ${name}` }],