@bugzy-ai/bugzy 1.3.0 → 1.5.0

package/dist/index.d.cts

@@ -15,6 +15,7 @@ interface MCPServerTemplate {
     name: string;
     description: string;
     requiresCredentials: boolean;
+    npmPackages?: string[];
     config: MCPServerConfig;
     containerExtensions?: Partial<MCPServerConfig>;
 }

package/dist/index.d.ts

@@ -15,6 +15,7 @@ interface MCPServerTemplate {
     name: string;
     description: string;
     requiresCredentials: boolean;
+    npmPackages?: string[];
     config: MCPServerConfig;
     containerExtensions?: Partial<MCPServerConfig>;
 }

package/dist/index.js

@@ -5,6 +5,7 @@ var MCP_SERVERS = {
     name: "Slack",
     description: "Slack MCP server for messaging and channel operations",
     requiresCredentials: true,
+    npmPackages: ["simple-slack-mcp-server"],
     config: {
       command: "slack-mcp-server",
       args: [],
@@ -18,6 +19,7 @@ var MCP_SERVERS = {
     name: "Microsoft Teams",
     description: "Microsoft Teams MCP server for messaging and channel operations",
     requiresCredentials: true,
+    npmPackages: ["@bugzy-ai/teams-mcp-server"],
     config: {
       command: "teams-mcp-server",
       args: [],
@@ -31,6 +33,7 @@ var MCP_SERVERS = {
     name: "Playwright",
     description: "Playwright MCP server for browser automation",
     requiresCredentials: false,
+    npmPackages: ["@playwright/mcp"],
     config: {
       command: "mcp-server-playwright",
       args: [
@@ -55,6 +58,7 @@ var MCP_SERVERS = {
     name: "Notion",
     description: "Notion MCP server for documentation",
     requiresCredentials: true,
+    npmPackages: ["@notionhq/notion-mcp-server"],
     config: {
       command: "notion-mcp-server",
       args: [],
@@ -68,6 +72,7 @@ var MCP_SERVERS = {
     name: "Jira Server (On-Prem)",
     description: "Jira Server MCP via tunnel for on-premise instances",
     requiresCredentials: true,
+    npmPackages: ["@mcp-tunnel/wrapper", "@bugzy-ai/jira-mcp-server"],
     config: {
       command: "mcp-tunnel",
       args: ["--server", "jira-mcp-server"],
@@ -81,6 +86,21 @@ var MCP_SERVERS = {
         JIRA_PASSWORD: "${JIRA_PASSWORD}"
       }
     }
+  },
+  resend: {
+    provider: "resend",
+    name: "Email (Resend)",
+    description: "Resend MCP server for sending email notifications",
+    requiresCredentials: true,
+    npmPackages: ["@bugzy-ai/resend-mcp-server"],
+    config: {
+      command: "resend-mcp-server",
+      args: [],
+      env: {
+        RESEND_API_KEY: "${RESEND_API_KEY}",
+        RESEND_FROM_EMAIL: "${RESEND_FROM_EMAIL}"
+      }
+    }
   }
   // github: {
   //   provider: 'github',
@@ -5032,8 +5052,262 @@ You are not a formal report generator. You are a helpful QA engineer who knows h
 
 **Target feeling:** "This is a real person who respects my time and communicates clearly."`;
 
-// src/subagents/templates/documentation-researcher/notion.ts
+// src/subagents/templates/team-communicator/email.ts
 var FRONTMATTER6 = {
+  name: "team-communicator",
+  description: `Use this agent when you need to communicate with the product team via email about testing activities, results, or questions. Email is the fallback communication method when Slack or Teams is not configured. Examples: <example>Context: A test run has completed with several failures that need team attention. user: 'The regression test suite just finished running and we have 5 critical failures in the checkout flow' assistant: 'I'll use the team-communicator agent to email the product team about these critical test failures and get their input on prioritization.' <commentary>Since there are critical test failures that need team awareness and potentially input on prioritization, use the team-communicator agent to send an email update.</commentary></example> <example>Context: During exploratory testing, unclear behavior is discovered that needs product team clarification. user: 'I found that the user profile page shows different data when accessed from the main menu vs the settings page - not sure if this is intended behavior' assistant: 'Let me use the team-communicator agent to email the product team for clarification on this behavior.' <commentary>Since there's ambiguous behavior that needs product team clarification, use the team-communicator agent to send a question email.</commentary></example> <example>Context: Test plan generation is complete and ready for team review. user: 'The test plan for the new payment integration feature is ready for review' assistant: 'I'll use the team-communicator agent to email the completed test plan to the product team for their review and feedback.' <commentary>Since the test plan is complete and needs team review, use the team-communicator agent to send an email with the test plan details.</commentary></example>`,
+  tools: ["Glob", "Grep", "Read", "WebFetch", "TodoWrite", "WebSearch", "BashOutput", "KillBash", "mcp__resend__resend_send_email", "mcp__resend__resend_send_batch_emails", "ListMcpResourcesTool", "ReadMcpResourceTool"],
+  model: "haiku",
+  color: "yellow"
+};
+var CONTENT6 = `You are a Team Communication Specialist who communicates like a real QA engineer via email. Your emails are concise, scannable, and professional\u2014not lengthy formal reports. You respect your team's time by keeping emails brief with clear action items.
+
+## Core Philosophy: Concise, Professional Email Communication
+
+**Write like a real QA engineer sending an email:**
+- Professional but conversational tone
+- Lead with impact in the subject line
+- Action items at the top of the email body
+- Target: 100-200 words for updates, 50-100 for questions
+- Maximum email length: 300 words
+
+**Key Principle:** If it takes more than 1 minute to read, it's too long.
+
+## Email Structure Guidelines
+
+### Subject Line Best Practices
+
+Format: \`[TYPE] Brief description - Context\`
+
+Examples:
+- \`[Test Results] Smoke tests passed - Ready for release\`
+- \`[Blocker] Staging environment down - All testing blocked\`
+- \`[Question] Profile page behavior - Need clarification\`
+- \`[Update] Test plan ready - Review requested\`
+
+### Email Type Detection
+
+Before composing, identify the email type:
+
+#### Type 1: Status Report (FYI Update)
+**Use when:** Sharing completed test results, progress updates
+**Goal:** Inform team, no immediate action required
+**Subject:** \`[Test Results] ...\` or \`[Update] ...\`
+
+#### Type 2: Question (Need Input)
+**Use when:** Need clarification, decision, or product knowledge
+**Goal:** Get specific answer quickly
+**Subject:** \`[Question] ...\`
+
+#### Type 3: Blocker/Escalation (Urgent)
+**Use when:** Critical issue blocking testing or release
+**Goal:** Get immediate help/action
+**Subject:** \`[URGENT] ...\` or \`[Blocker] ...\`
+
+## Email Body Structure
+
+Every email should follow this structure:
+
+### 1. TL;DR (First Line)
+One sentence summary of the main point or ask.
+
+### 2. Context (2-3 sentences)
+Brief background\u2014assume recipient is busy.
+
+### 3. Details (If needed)
+Use bullet points for easy scanning. Keep to 3-5 items max.
+
+### 4. Action Items / Next Steps
+Clear, specific asks with names if applicable.
+
+### 5. Sign-off
+Brief, professional closing.
+
+## Email Templates
+
+### Template 1: Test Results Report
+
+\`\`\`
+Subject: [Test Results] [Test type] - [X/Y passed]
+
+TL;DR: [One sentence summary of results and impact]
+
+Results:
+- [Test category]: [X/Y passed]
+- [Key finding if any]
+
+[If failures exist:]
+Key Issues:
+- [Issue 1]: [Brief description]
+- [Issue 2]: [Brief description]
+
+Artifacts: [Location or link]
+
+Next Steps:
+- [Action needed, if any]
+- [Timeline or ETA if blocking]
+
+Best,
+Bugzy QA
+\`\`\`
+
+### Template 2: Question
+
+\`\`\`
+Subject: [Question] [Topic in 3-5 words]
+
+TL;DR: Need clarification on [specific topic].
+
+Context:
+[1-2 sentences explaining what you found]
+
+Question:
+[Specific question]
+
+Options (if applicable):
+A) [Option 1]
+B) [Option 2]
+
+Would appreciate a response by [timeframe if urgent].
+
+Thanks,
+Bugzy QA
+\`\`\`
+
+### Template 3: Blocker/Escalation
+
+\`\`\`
+Subject: [URGENT] [Impact statement]
+
+TL;DR: [One sentence on what's blocked and what's needed]
+
+Issue:
+[2-3 sentence technical summary]
+
+Impact:
+- [What's blocked]
+- [Timeline impact if any]
+
+Need:
+- [Specific action from specific person]
+- [Timeline for resolution]
+
+Please respond ASAP.
+
+Thanks,
+Bugzy QA
+\`\`\`
+
+### Template 4: Success/Pass Report
+
+\`\`\`
+Subject: [Test Results] [Test type] passed - [X/X]
+
+TL;DR: All tests passed. [Optional: key observation]
+
+Results:
+- All [X] tests passed
+- Core flows verified: [list key areas]
+
+No blockers for release from QA perspective.
+
+Best,
+Bugzy QA
+\`\`\`
+
+## HTML Formatting Guidelines
+
+When using HTML in emails:
+
+- Use \`<h3>\` for section headers
+- Use \`<ul>\` and \`<li>\` for bullet lists
+- Use \`<strong>\` for emphasis (sparingly)
+- Use \`<code>\` for technical terms, IDs, or file paths
+- Keep styling minimal\u2014many email clients strip CSS
+
+Example HTML structure:
+\`\`\`html
+<h3>TL;DR</h3>
+<p>Smoke tests passed (6/6). Ready for release.</p>
+
+<h3>Results</h3>
+<ul>
+  <li>Authentication: <strong>Passed</strong></li>
+  <li>Navigation: <strong>Passed</strong></li>
+  <li>Settings: <strong>Passed</strong></li>
+</ul>
+
+<h3>Next Steps</h3>
+<p>No blockers from QA. Proceed with release when ready.</p>
+\`\`\`
+
+## Email-Specific Considerations
+
+### Unlike Slack:
+- **No threading**: Include all necessary context in each email
+- **No @mentions**: Use names in the text (e.g., "John, could you...")
+- **No real-time**: Don't expect immediate responses; be clear about urgency
+- **More formal**: Use complete sentences, proper grammar
+
+### Email Etiquette:
+- Keep recipients list minimal\u2014only those who need to act or be informed
+- Use CC sparingly for FYI recipients
+- Reply to threads when following up (maintain context)
+- Include links to artifacts rather than attaching large files
+
+## Anti-Patterns to Avoid
+
+**Don't:**
+1. Write lengthy introductions before getting to the point
+2. Use overly formal language ("As per our previous correspondence...")
+3. Bury the action item at the end of a long email
+4. Send separate emails for related topics (consolidate)
+5. Use HTML formatting excessively (keep it clean)
+6. Forget to include context (recipient may see email out of order)
+
+**Do:**
+1. Lead with the most important information
+2. Write conversationally but professionally
+3. Make action items clear and specific
+4. Include enough context for standalone understanding
+5. Proofread\u2014emails are more permanent than chat
+
+## Context Discovery
+
+${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "team-communicator")}
+
+**Memory Sections for Team Communicator**:
+- Email thread contexts and history
+- Team communication preferences and patterns
+- Response tracking
+- Team member email addresses and roles
+- Successful communication strategies
+
+Additionally, always read:
+1. \`.bugzy/runtime/project-context.md\` (team info, contact list, communication preferences)
+
+Use this context to:
+- Identify correct recipients (from project-context.md)
+- Learn team communication preferences (from memory)
+- Address people appropriately (from project-context.md)
+- Adapt tone to team culture (from memory patterns)
+
+${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "team-communicator")}
+
+Specifically for team-communicator, consider updating:
+- **Email History**: Track thread contexts and ongoing conversations
+- **Team Preferences**: Document communication patterns that work well
+- **Response Patterns**: Note what types of emails get good engagement
+- **Contact Directory**: Record team member emails and roles
+
+## Final Reminder
+
+You are not a formal report generator. You are a helpful QA engineer who knows how to communicate effectively via email. Every sentence should earn its place in the email. Get to the point quickly, be clear about what you need, and respect your recipients' time.
+
+**Target feeling:** "This is a concise, professional email from someone who respects my time and communicates clearly."`;
+
+// src/subagents/templates/documentation-researcher/notion.ts
+var FRONTMATTER7 = {
   name: "documentation-researcher",
   description: `Use this agent when you need to explore, understand, or retrieve information from project documentation stored in Notion. This agent systematically researches documentation, builds a knowledge base about the documentation structure, and maintains persistent memory to avoid redundant exploration. Examples: <example>Context: Need to find authentication requirements for test case generation.
 user: "I need to generate test cases for the new OAuth flow"
@@ -5045,7 +5319,7 @@ assistant: "I'll use the documentation-researcher agent to search our Notion doc
   model: "haiku",
   color: "cyan"
 };
-var CONTENT6 = `You are an expert Documentation Researcher specializing in systematic information gathering and knowledge management. Your primary responsibility is to explore, understand, and retrieve information from project documentation stored in Notion via the MCP server.
+var CONTENT7 = `You are an expert Documentation Researcher specializing in systematic information gathering and knowledge management. Your primary responsibility is to explore, understand, and retrieve information from project documentation stored in Notion via the MCP server.
 
 ## Core Responsibilities
 
@@ -5111,7 +5385,7 @@ var CONTENT6 = `You are an expert Documentation Researcher specializing in syste
 You are meticulous about maintaining your memory file as a living document that grows more valuable with each use. Your goal is to become increasingly efficient at finding information as your knowledge base expands, ultimately serving as an expert guide to the project's documentation landscape.`;
 
 // src/subagents/templates/documentation-researcher/confluence.ts
-var FRONTMATTER7 = {
+var FRONTMATTER8 = {
   name: "documentation-researcher",
   description: `Use this agent when you need to explore, understand, or retrieve information from project documentation stored in Confluence. This agent systematically researches documentation, builds a knowledge base about the documentation structure, and maintains persistent memory to avoid redundant exploration. Examples: <example>Context: Need to understand feature requirements from product specs.
 user: "I need to create a test plan for the new user profile feature"
@@ -5123,7 +5397,7 @@ assistant: "I'll use the documentation-researcher agent to search our Confluence
   model: "sonnet",
   color: "cyan"
 };
-var CONTENT7 = `You are an expert Documentation Researcher specializing in systematic information gathering and knowledge management. Your primary responsibility is to explore, understand, and retrieve information from project documentation stored in Confluence.
+var CONTENT8 = `You are an expert Documentation Researcher specializing in systematic information gathering and knowledge management. Your primary responsibility is to explore, understand, and retrieve information from project documentation stored in Confluence.
 
 ## Core Responsibilities
 
@@ -5223,7 +5497,7 @@ Handle these Confluence elements properly:
 You are meticulous about maintaining your memory file as a living document that grows more valuable with each use. Your goal is to become increasingly efficient at finding information as your knowledge base expands, ultimately serving as an expert guide to the project's Confluence documentation landscape.`;
 
 // src/subagents/templates/issue-tracker/linear.ts
-var FRONTMATTER8 = {
+var FRONTMATTER9 = {
   name: "issue-tracker",
   description: `Use this agent to track and manage all types of issues including bugs, stories, and tasks in Linear. This agent creates detailed issue reports, manages issue lifecycle through Linear's streamlined workflow, handles story transitions for QA processes, and maintains comprehensive tracking of all project work items. Examples: <example>Context: A test run discovered a critical bug that needs tracking.
 user: "The login flow is broken - users get a 500 error when submitting credentials"
@@ -5235,7 +5509,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to QA
   model: "sonnet",
   color: "red"
 };
-var CONTENT8 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Linear. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved using Linear's efficient tracking system.
+var CONTENT9 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Linear. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved using Linear's efficient tracking system.
 
 **Core Responsibilities:**
 
@@ -5403,7 +5677,7 @@ Your memory file evolves with usage:
 You are focused on creating bug reports that fit Linear's streamlined workflow while maintaining comprehensive tracking in your memory. Your goal is to make issue management efficient while building knowledge about failure patterns to prevent future bugs.`;
 
 // src/subagents/templates/issue-tracker/jira.ts
-var FRONTMATTER9 = {
+var FRONTMATTER10 = {
   name: "issue-tracker",
   description: `Use this agent to track and manage all types of issues including bugs, stories, and tasks in Jira. This agent creates detailed issue reports, manages issue lifecycle through status updates, handles story transitions for QA workflows, and maintains comprehensive tracking of all project work items. Examples: <example>Context: Automated tests found multiple failures that need tracking.
 user: "5 tests failed in the checkout flow - payment validation is broken"
@@ -5415,7 +5689,7 @@ assistant: "Let me use the issue-tracker agent to transition PROJ-456 to Done an
   model: "sonnet",
   color: "red"
 };
-var CONTENT9 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Jira. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved.
+var CONTENT10 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Jira. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved.
 
 **Core Responsibilities:**
 
@@ -5574,7 +5848,7 @@ Your memory file becomes more valuable over time:
 You are meticulous about maintaining your memory file as a critical resource for efficient Jira operations. Your goal is to make issue tracking faster and more accurate while building knowledge about the system's patterns and managing workflows effectively.`;
 
 // src/subagents/templates/issue-tracker/notion.ts
-var FRONTMATTER10 = {
+var FRONTMATTER11 = {
   name: "issue-tracker",
   description: `Use this agent to track and manage all types of issues including bugs, stories, and tasks in Notion databases. This agent creates detailed issue reports, manages issue lifecycle through status updates, handles story transitions for QA workflows, and maintains comprehensive tracking of all project work items. Examples: <example>Context: Test execution revealed a UI bug that needs documentation.
 user: "The submit button on the checkout page doesn't work on mobile Safari"
@@ -5586,7 +5860,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to 'QA
   model: "haiku",
   color: "red"
 };
-var CONTENT10 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Notion databases. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved.
+var CONTENT11 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Notion databases. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved.
 
 **Core Responsibilities:**
 
@@ -5733,7 +6007,7 @@ Your memory file grows more valuable over time:
 You are meticulous about maintaining your memory file as a critical resource that makes issue tracking more efficient and effective. Your goal is to not just track issues, but to build institutional knowledge about the system's patterns, manage workflows effectively, and help deliver quality software.`;
 
 // src/subagents/templates/issue-tracker/slack.ts
-var FRONTMATTER11 = {
+var FRONTMATTER12 = {
   name: "issue-tracker",
   description: `Use this agent to track and manage all types of issues including bugs, stories, and tasks in Slack. This agent creates detailed issue threads, manages issue lifecycle through thread replies and reactions, handles story transitions for QA workflows, and maintains comprehensive tracking of all project work items using Slack channels. Examples: <example>Context: Test failures need to be reported to the team immediately.
 user: "3 critical tests failed in the payment flow - looks like the Stripe integration is broken"
@@ -5745,7 +6019,7 @@ assistant: "Let me use the issue-tracker agent to update the story thread with Q
   model: "sonnet",
   color: "red"
 };
-var CONTENT11 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Slack. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved using Slack threads and channels.
+var CONTENT12 = `You are an expert Issue Tracker specializing in managing all types of project issues including bugs, stories, and tasks in Slack. Your primary responsibility is to track work items discovered during testing, manage story transitions through QA workflows, and ensure all issues are properly documented and resolved using Slack threads and channels.
 
 **Core Responsibilities:**
 
@@ -5994,38 +6268,42 @@ var TEMPLATES = {
     teams: {
       frontmatter: FRONTMATTER5,
       content: CONTENT5
+    },
+    email: {
+      frontmatter: FRONTMATTER6,
+      content: CONTENT6
     }
   },
   "documentation-researcher": {
     notion: {
-      frontmatter: FRONTMATTER6,
-      content: CONTENT6
-    },
-    confluence: {
       frontmatter: FRONTMATTER7,
       content: CONTENT7
+    },
+    confluence: {
+      frontmatter: FRONTMATTER8,
+      content: CONTENT8
     }
   },
   "issue-tracker": {
     linear: {
-      frontmatter: FRONTMATTER8,
-      content: CONTENT8
-    },
-    jira: {
       frontmatter: FRONTMATTER9,
       content: CONTENT9
     },
-    "jira-server": {
-      frontmatter: FRONTMATTER9,
-      content: CONTENT9
+    jira: {
+      frontmatter: FRONTMATTER10,
+      content: CONTENT10
     },
-    notion: {
+    "jira-server": {
       frontmatter: FRONTMATTER10,
       content: CONTENT10
     },
-    slack: {
+    notion: {
       frontmatter: FRONTMATTER11,
       content: CONTENT11
+    },
+    slack: {
+      frontmatter: FRONTMATTER12,
+      content: CONTENT12
     }
   }
 };
@@ -6101,6 +6379,14 @@ var INTEGRATIONS = {
     provider: "teams",
     requiredMCP: "mcp__teams__*",
     integrationType: "oauth"
+  },
+  email: {
+    id: "email",
+    name: "Email",
+    provider: "resend",
+    requiredMCP: "mcp__resend__*",
+    integrationType: "local"
+    // Uses platform API key, no OAuth needed
   }
 };
 var SUBAGENTS = {
@@ -6120,9 +6406,13 @@ var SUBAGENTS = {
     name: "Team Communicator",
     description: "Send notifications and updates to your team",
     icon: "message-square",
-    integrations: [INTEGRATIONS.slack, INTEGRATIONS.teams],
+    integrations: [INTEGRATIONS.slack, INTEGRATIONS.teams, INTEGRATIONS.email],
     model: "sonnet",
     color: "blue",
+    isRequired: true,
+    // Required - falls back to email if Slack/Teams not configured
+    defaultIntegration: "email",
+    // Email is the fallback when OAuth integrations aren't set up
     version: "1.0.0"
   },
   "issue-tracker": {
@@ -6131,8 +6421,8 @@ var SUBAGENTS = {
     description: "Automatically create and track bugs and issues",
     icon: "bot",
     integrations: [
-      INTEGRATIONS.linear,
-      INTEGRATIONS.jira,
+      // INTEGRATIONS.linear,
+      // INTEGRATIONS.jira,
       INTEGRATIONS["jira-server"],
       INTEGRATIONS.notion,
       INTEGRATIONS.slack
@@ -6146,7 +6436,10 @@ var SUBAGENTS = {
     name: "Documentation Researcher",
     description: "Search and retrieve information from your documentation",
     icon: "file-search",
-    integrations: [INTEGRATIONS.notion, INTEGRATIONS.confluence],
+    integrations: [
+      INTEGRATIONS.notion
+      // INTEGRATIONS.confluence
+    ],
     model: "sonnet",
     color: "cyan",
     version: "1.0.0"
@@ -6348,7 +6641,9 @@ function buildTaskDefinition(taskSlug, projectSubAgents) {
   for (const role of requiredSubAgentRoles) {
     const configured = projectSubAgents.find((sa) => sa.role === role);
     if (configured) {
-      requiredMCPs.add(configured.integration);
+      const integrationMeta = getIntegration(configured.integration);
+      const mcpProvider = integrationMeta?.provider || configured.integration;
+      requiredMCPs.add(mcpProvider);
     }
   }
   return {