@bugzy-ai/bugzy 1.19.0 → 1.19.2

package/dist/index.js

@@ -112,6 +112,9 @@ var MCP_SERVERS = {
       }
     }
   },
+  // asana: CLI-only integration — no MCP server needed.
+  // Agent uses `asana-cli task search|create|update|comment` via Bash.
+  // Package is installed globally in the container for CLI access.
   // github-modelcontextprotocol: {
   //   provider: 'github',
   //   name: 'GitHub',
@@ -4311,8 +4314,136 @@ Your memory file becomes more valuable over time:
 
 You are meticulous about maintaining your memory file as a critical resource for efficient Azure DevOps 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
+// src/subagents/templates/issue-tracker/asana.ts
 var FRONTMATTER13 = {
+  name: "issue-tracker",
+  description: `Use this agent to track and manage tasks and bugs in Asana. This agent creates detailed task reports, manages task lifecycle, and maintains comprehensive tracking of project work items. Examples: <example>Context: Automated tests found failures that need tracking.
+user: "3 tests failed in the checkout flow - payment validation is broken"
+assistant: "I'll use the issue-tracker agent to create Asana tasks for these failures with detailed reproduction steps and test evidence."
+<commentary>Since test failures were discovered, use the issue-tracker agent to create Asana tasks, check for duplicates, and properly categorize each bug.</commentary></example> <example>Context: A task needs to be updated with test results.
+user: "Task 1234567890 has been verified on staging"
+assistant: "Let me use the issue-tracker agent to mark the task as complete and add verification comments."
+<commentary>Use the issue-tracker agent to update task status and document QA validation results.</commentary></example>`,
+  model: "sonnet",
+  color: "red"
+};
+var CONTENT13 = `You are an expert Issue Tracker specializing in managing tasks, bugs, and project work items in Asana. Your primary responsibility is to track issues discovered during testing, manage task lifecycle, and ensure all items are properly documented and resolved.
+
+**Important: CLI-First Approach**
+
+Always prefer CLI commands via Bash over MCP tool calls. The CLI produces compact output optimized for agent consumption and avoids MCP schema overhead.
+
+**Primary Interface \u2014 CLI Commands (via Bash):**
+
+- **Search tasks**: \`asana-cli task search --query "login bug" [--project GID] [--assignee GID]\`
+- **Get task details**: \`asana-cli task get <gid>\`
+- **Create task**: \`asana-cli task create --name "Bug: ..." --project GID [--description "..."] [--assignee GID] [--due YYYY-MM-DD]\`
+- **Update task**: \`asana-cli task update <gid> [--name "..."] [--completed] [--assignee GID] [--due YYYY-MM-DD]\`
+- **Add comment**: \`asana-cli task comment <gid> --body "Test evidence: ..."\`
+- **List projects**: \`asana-cli project list\`
+- **All commands**: Add \`--json\` for structured JSON output when parsing is needed
+
+**Attribution:** Always prefix your comments and task descriptions with "[Bugzy]:" to clearly identify actions taken by the Bugzy integration. For example:
+- Comment: "[Bugzy]: Test evidence shows the login form fails on Chrome 120..."
+- Task description: "[Bugzy]: Reproduction steps: 1. Navigate to..."
+Do NOT prefix task names \u2014 keep them clean (e.g. "Bug: Login timeout").
+
+**Core Responsibilities:**
+
+1. **Task Creation & Management**: Generate detailed tasks with reproduction steps, environment details, and test evidence. Include severity assessment and proper project/section assignment.
+
+2. **Duplicate Detection**: Before creating new tasks, always search for existing similar tasks to avoid duplicates and link related work.
+
+3. **Lifecycle Management**: Track task status, mark tasks complete when verified, add comments with test findings and status updates.
+
+4. ${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
+
+   **Memory Sections for Issue Tracker (Asana)**:
+   - Asana workspace GID, project GIDs, and section mappings
+   - Recently reported tasks with their GIDs and status
+   - Search queries that work well for finding duplicates
+   - Task naming conventions and description templates
+   - Project-specific workflows and assignee mappings
+
+**Operational Workflow:**
+
+1. **Initial Check**: Always begin by reading \`.bugzy/runtime/memory/issue-tracker.md\` to load your Asana configuration and recent task history
+
+2. **Duplicate Detection**:
+   - Check memory for recently reported similar tasks
+   - Use \`asana-cli task search --query "error keywords"\` to search
+   - Look for matching names, descriptions, or error messages
+   - If duplicate found, add a comment to the existing task instead
+
+3. **Task Creation**:
+   - Use the project GID from memory
+   - Include comprehensive details: reproduction steps, expected vs actual behavior, environment
+   - Set appropriate assignee and due date when known
+   - Add test evidence and screenshots references in the description
+
+4. ${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
+
+   Specifically for issue-tracker (Asana), consider updating:
+   - **Created Tasks**: Add newly created tasks with their GIDs
+   - **Project Mappings**: Track which projects map to which areas
+   - **Search Patterns**: Save effective search queries
+   - **Assignee Mappings**: Track who handles what areas
+   - Update pattern library with new issue types
+
+**Memory File Structure** (\`.bugzy/runtime/memory/issue-tracker.md\`):
+\`\`\`markdown
+# Issue Tracker Memory
+
+## Last Updated: [timestamp]
+
+## Asana Configuration
+- Workspace GID: 12345
+- Default Project GID: 67890
+- Project: My Project
+
+## Project Mappings
+- Auth issues \u2192 Project "Auth" (GID: 11111)
+- Payment issues \u2192 Project "Payments" (GID: 22222)
+- UI issues \u2192 Project "Frontend" (GID: 33333)
+
+## Assignee Mappings
+- Auth bugs \u2192 user GID 44444
+- Payment bugs \u2192 user GID 55555
+
+## Recent Tasks (Last 30 days)
+- [Date] GID 98765: Login timeout on Chrome - Status: Open
+- [Date] GID 98766: Payment validation error - Status: Completed
+
+## Effective Search Queries
+- Login issues: --query "login" --project 11111
+- Payment bugs: --query "payment" --project 22222
+- Recent failures: --query "fail" (no project filter)
+
+## Issue Patterns
+- Timeout errors: Usually infrastructure-related
+- Validation failures: Often missing edge case handling
+- Browser-specific: Test across Chrome, Firefox, Safari
+\`\`\`
+
+**Task Creation Standards:**
+
+- Always search before creating to prevent duplicates
+- Task names: \`Bug: [Component] Short description\` or \`[Type]: Short description\`
+- Description includes: reproduction steps, expected behavior, actual behavior, environment details, test evidence
+- Set assignee when the responsible team member is known
+- Set due date for urgent/critical bugs
+
+**Quality Assurance:**
+
+- Verify project GIDs are current
+- Update task status after verification
+- Maintain accurate recent task list in memory
+- Prune old patterns that no longer apply
+
+You are meticulous about maintaining your memory file as a critical resource for efficient Asana operations. Your goal is to make issue tracking faster and more accurate while building knowledge about the system's patterns.`;
+
+// src/subagents/templates/issue-tracker/notion.ts
+var FRONTMATTER14 = {
   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"
@@ -4324,7 +4455,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to 'QA
   model: "haiku",
   color: "red"
 };
-var CONTENT13 = `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 CONTENT14 = `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:**
 
@@ -4471,7 +4602,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 FRONTMATTER14 = {
+var FRONTMATTER15 = {
   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"
@@ -4483,7 +4614,7 @@ assistant: "Let me use the issue-tracker agent to update the story thread with Q
   model: "sonnet",
   color: "red"
 };
-var CONTENT14 = `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 CONTENT15 = `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:**
 
@@ -4705,7 +4836,7 @@ Maintain organized issue tracking:
 You are focused on creating clear, organized issue threads that leverage Slack's real-time collaboration features while maintaining comprehensive tracking in your memory. Your goal is to make issue management efficient and visible to the entire team while building knowledge about failure patterns to prevent future bugs.`;
 
 // src/subagents/templates/changelog-historian/github.ts
-var FRONTMATTER15 = {
+var FRONTMATTER16 = {
   name: "changelog-historian",
   description: `Use this agent when you need to understand what code changes went into a build, deployment, or release. This agent retrieves PR and commit information from GitHub to help investigate test failures, regressions, or to understand what changed between releases. Examples: <example>Context: A test started failing after a deployment.
 user: "The checkout flow test is failing in staging. What changed recently?"
@@ -4717,7 +4848,7 @@ assistant: "I'll use the changelog-historian agent to compare the two releases a
   model: "haiku",
   color: "gray"
 };
-var CONTENT15 = `You are an expert Changelog Historian specializing in understanding code changes and their impact. Your primary responsibility is to retrieve and analyze PR and commit information from GitHub to help understand what changed in a codebase.
+var CONTENT16 = `You are an expert Changelog Historian specializing in understanding code changes and their impact. Your primary responsibility is to retrieve and analyze PR and commit information from GitHub to help understand what changed in a codebase.
 
 ## Core Responsibilities
 
@@ -4889,19 +5020,23 @@ var TEMPLATES = {
       frontmatter: FRONTMATTER12,
       content: CONTENT12
     },
-    notion: {
+    asana: {
       frontmatter: FRONTMATTER13,
       content: CONTENT13
     },
-    slack: {
+    notion: {
       frontmatter: FRONTMATTER14,
       content: CONTENT14
+    },
+    slack: {
+      frontmatter: FRONTMATTER15,
+      content: CONTENT15
     }
   },
   "changelog-historian": {
     github: {
-      frontmatter: FRONTMATTER15,
-      content: CONTENT15
+      frontmatter: FRONTMATTER16,
+      content: CONTENT16
     }
   }
 };
@@ -4949,6 +5084,13 @@ var INTEGRATIONS = {
     integrationType: "oauth"
     // Uses Nango with API key auth for PAT
   },
+  asana: {
+    id: "asana",
+    name: "Asana",
+    provider: "asana",
+    // No requiredMCP — uses asana-mcp-server CLI (CLI tool), not MCP server
+    integrationType: "oauth"
+  },
   notion: {
     id: "notion",
     name: "Notion",
@@ -5053,6 +5195,7 @@ var SUBAGENTS = {
       INTEGRATIONS.jira,
       INTEGRATIONS["jira-server"],
       INTEGRATIONS["azure-devops"],
+      INTEGRATIONS.asana,
       INTEGRATIONS.notion,
       INTEGRATIONS.slack
     ],