@bugzy-ai/bugzy 1.19.0 → 1.19.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +273 -273
  3. package/dist/cli/index.cjs +157 -13
  4. package/dist/cli/index.cjs.map +1 -1
  5. package/dist/cli/index.js +156 -12
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/index.cjs +153 -10
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.js +153 -10
  10. package/dist/index.js.map +1 -1
  11. package/dist/subagents/index.cjs +150 -10
  12. package/dist/subagents/index.cjs.map +1 -1
  13. package/dist/subagents/index.js +150 -10
  14. package/dist/subagents/index.js.map +1 -1
  15. package/dist/subagents/metadata.cjs +8 -0
  16. package/dist/subagents/metadata.cjs.map +1 -1
  17. package/dist/subagents/metadata.js +8 -0
  18. package/dist/subagents/metadata.js.map +1 -1
  19. package/dist/tasks/index.cjs.map +1 -1
  20. package/dist/tasks/index.js.map +1 -1
  21. package/package.json +95 -95
  22. package/templates/init/.bugzy/runtime/hooks/pre-compact.sh +53 -53
  23. package/templates/init/.bugzy/runtime/hooks/session-start.sh +68 -68
  24. package/templates/init/.bugzy/runtime/knowledge-base.md +61 -61
  25. package/templates/init/.bugzy/runtime/knowledge-maintenance-guide.md +140 -140
  26. package/templates/init/.bugzy/runtime/project-context.md +35 -35
  27. package/templates/init/.bugzy/runtime/subagent-memory-guide.md +122 -122
  28. package/templates/init/.bugzy/runtime/templates/event-examples.md +194 -194
  29. package/templates/init/.bugzy/runtime/templates/test-plan-template.md +50 -50
  30. package/templates/init/.bugzy/runtime/templates/test-result-schema.md +498 -498
  31. package/templates/init/.claude/settings.json +49 -49
  32. package/templates/init/.env.testdata +18 -18
  33. package/templates/init/.gitignore-template +24 -24
  34. package/templates/init/AGENTS.md +155 -155
  35. package/templates/init/CLAUDE.md +157 -157
  36. package/templates/init/test-runs/README.md +45 -45
  37. package/templates/init/tests/CLAUDE.md +199 -199
  38. package/templates/init/tests/docs/test-execution-strategy.md +535 -535
  39. package/templates/init/tests/docs/testing-best-practices.md +724 -724
  40. package/templates/playwright/BasePage.template.ts +190 -190
  41. package/templates/playwright/auth.setup.template.ts +89 -89
  42. package/templates/playwright/dataGenerators.helper.template.ts +148 -148
  43. package/templates/playwright/dateUtils.helper.template.ts +96 -96
  44. package/templates/playwright/pages.fixture.template.ts +50 -50
  45. package/templates/playwright/playwright.config.template.ts +97 -97
  46. package/templates/playwright/reporters/__tests__/bugzy-reporter-failure-classification.test.ts +299 -299
  47. package/templates/playwright/reporters/__tests__/bugzy-reporter-manifest-merge.test.ts +329 -329
  48. package/templates/playwright/reporters/__tests__/playwright.config.ts +5 -5
  49. package/templates/playwright/reporters/bugzy-reporter.ts +784 -784
  50. package/dist/templates/init/.bugzy/runtime/knowledge-base.md +0 -61
  51. package/dist/templates/init/.bugzy/runtime/knowledge-maintenance-guide.md +0 -97
  52. package/dist/templates/init/.bugzy/runtime/project-context.md +0 -35
  53. package/dist/templates/init/.bugzy/runtime/subagent-memory-guide.md +0 -87
  54. package/dist/templates/init/.bugzy/runtime/templates/test-plan-template.md +0 -50
  55. package/dist/templates/init/.bugzy/runtime/templates/test-result-schema.md +0 -498
  56. package/dist/templates/init/.bugzy/runtime/test-execution-strategy.md +0 -535
  57. package/dist/templates/init/.bugzy/runtime/testing-best-practices.md +0 -632
  58. package/dist/templates/init/.gitignore-template +0 -25
package/dist/cli/index.js CHANGED
@@ -20,12 +20,12 @@ var __copyProps = (to, from, except, desc) => {
20
20
  };
21
21
  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
22
22
 
23
- // node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
23
+ // node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
24
24
  import path from "path";
25
25
  import { fileURLToPath } from "url";
26
26
  var getFilename, getDirname, __dirname;
27
27
  var init_esm_shims = __esm({
28
- "node_modules/.pnpm/tsup@8.5.0_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
28
+ "node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
29
29
  "use strict";
30
30
  getFilename = () => fileURLToPath(import.meta.url);
31
31
  getDirname = () => path.dirname(getFilename());
@@ -2454,6 +2454,13 @@ var INTEGRATIONS = {
2454
2454
  integrationType: "oauth"
2455
2455
  // Uses Nango with API key auth for PAT
2456
2456
  },
2457
+ asana: {
2458
+ id: "asana",
2459
+ name: "Asana",
2460
+ provider: "asana",
2461
+ // No requiredMCP — uses asana-mcp-server CLI (CLI tool), not MCP server
2462
+ integrationType: "oauth"
2463
+ },
2457
2464
  notion: {
2458
2465
  id: "notion",
2459
2466
  name: "Notion",
@@ -2558,6 +2565,7 @@ var SUBAGENTS = {
2558
2565
  INTEGRATIONS.jira,
2559
2566
  INTEGRATIONS["jira-server"],
2560
2567
  INTEGRATIONS["azure-devops"],
2568
+ INTEGRATIONS.asana,
2561
2569
  INTEGRATIONS.notion,
2562
2570
  INTEGRATIONS.slack
2563
2571
  ],
@@ -4884,9 +4892,138 @@ Your memory file becomes more valuable over time:
4884
4892
 
4885
4893
  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.`;
4886
4894
 
4887
- // src/subagents/templates/issue-tracker/notion.ts
4895
+ // src/subagents/templates/issue-tracker/asana.ts
4888
4896
  init_esm_shims();
4889
4897
  var FRONTMATTER13 = {
4898
+ name: "issue-tracker",
4899
+ 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.
4900
+ user: "3 tests failed in the checkout flow - payment validation is broken"
4901
+ assistant: "I'll use the issue-tracker agent to create Asana tasks for these failures with detailed reproduction steps and test evidence."
4902
+ <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.
4903
+ user: "Task 1234567890 has been verified on staging"
4904
+ assistant: "Let me use the issue-tracker agent to mark the task as complete and add verification comments."
4905
+ <commentary>Use the issue-tracker agent to update task status and document QA validation results.</commentary></example>`,
4906
+ model: "sonnet",
4907
+ color: "red"
4908
+ };
4909
+ 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.
4910
+
4911
+ **Important: CLI-First Approach**
4912
+
4913
+ Always prefer CLI commands via Bash over MCP tool calls. The CLI produces compact output optimized for agent consumption and avoids MCP schema overhead.
4914
+
4915
+ **Primary Interface \u2014 CLI Commands (via Bash):**
4916
+
4917
+ - **Search tasks**: \`asana-cli task search --query "login bug" [--project GID] [--assignee GID]\`
4918
+ - **Get task details**: \`asana-cli task get <gid>\`
4919
+ - **Create task**: \`asana-cli task create --name "Bug: ..." --project GID [--description "..."] [--assignee GID] [--due YYYY-MM-DD]\`
4920
+ - **Update task**: \`asana-cli task update <gid> [--name "..."] [--completed] [--assignee GID] [--due YYYY-MM-DD]\`
4921
+ - **Add comment**: \`asana-cli task comment <gid> --body "Test evidence: ..."\`
4922
+ - **List projects**: \`asana-cli project list\`
4923
+ - **All commands**: Add \`--json\` for structured JSON output when parsing is needed
4924
+
4925
+ **Attribution:** Always prefix your comments and task descriptions with "[Bugzy]:" to clearly identify actions taken by the Bugzy integration. For example:
4926
+ - Comment: "[Bugzy]: Test evidence shows the login form fails on Chrome 120..."
4927
+ - Task description: "[Bugzy]: Reproduction steps: 1. Navigate to..."
4928
+ Do NOT prefix task names \u2014 keep them clean (e.g. "Bug: Login timeout").
4929
+
4930
+ **Core Responsibilities:**
4931
+
4932
+ 1. **Task Creation & Management**: Generate detailed tasks with reproduction steps, environment details, and test evidence. Include severity assessment and proper project/section assignment.
4933
+
4934
+ 2. **Duplicate Detection**: Before creating new tasks, always search for existing similar tasks to avoid duplicates and link related work.
4935
+
4936
+ 3. **Lifecycle Management**: Track task status, mark tasks complete when verified, add comments with test findings and status updates.
4937
+
4938
+ 4. ${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
4939
+
4940
+ **Memory Sections for Issue Tracker (Asana)**:
4941
+ - Asana workspace GID, project GIDs, and section mappings
4942
+ - Recently reported tasks with their GIDs and status
4943
+ - Search queries that work well for finding duplicates
4944
+ - Task naming conventions and description templates
4945
+ - Project-specific workflows and assignee mappings
4946
+
4947
+ **Operational Workflow:**
4948
+
4949
+ 1. **Initial Check**: Always begin by reading \`.bugzy/runtime/memory/issue-tracker.md\` to load your Asana configuration and recent task history
4950
+
4951
+ 2. **Duplicate Detection**:
4952
+ - Check memory for recently reported similar tasks
4953
+ - Use \`asana-cli task search --query "error keywords"\` to search
4954
+ - Look for matching names, descriptions, or error messages
4955
+ - If duplicate found, add a comment to the existing task instead
4956
+
4957
+ 3. **Task Creation**:
4958
+ - Use the project GID from memory
4959
+ - Include comprehensive details: reproduction steps, expected vs actual behavior, environment
4960
+ - Set appropriate assignee and due date when known
4961
+ - Add test evidence and screenshots references in the description
4962
+
4963
+ 4. ${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
4964
+
4965
+ Specifically for issue-tracker (Asana), consider updating:
4966
+ - **Created Tasks**: Add newly created tasks with their GIDs
4967
+ - **Project Mappings**: Track which projects map to which areas
4968
+ - **Search Patterns**: Save effective search queries
4969
+ - **Assignee Mappings**: Track who handles what areas
4970
+ - Update pattern library with new issue types
4971
+
4972
+ **Memory File Structure** (\`.bugzy/runtime/memory/issue-tracker.md\`):
4973
+ \`\`\`markdown
4974
+ # Issue Tracker Memory
4975
+
4976
+ ## Last Updated: [timestamp]
4977
+
4978
+ ## Asana Configuration
4979
+ - Workspace GID: 12345
4980
+ - Default Project GID: 67890
4981
+ - Project: My Project
4982
+
4983
+ ## Project Mappings
4984
+ - Auth issues \u2192 Project "Auth" (GID: 11111)
4985
+ - Payment issues \u2192 Project "Payments" (GID: 22222)
4986
+ - UI issues \u2192 Project "Frontend" (GID: 33333)
4987
+
4988
+ ## Assignee Mappings
4989
+ - Auth bugs \u2192 user GID 44444
4990
+ - Payment bugs \u2192 user GID 55555
4991
+
4992
+ ## Recent Tasks (Last 30 days)
4993
+ - [Date] GID 98765: Login timeout on Chrome - Status: Open
4994
+ - [Date] GID 98766: Payment validation error - Status: Completed
4995
+
4996
+ ## Effective Search Queries
4997
+ - Login issues: --query "login" --project 11111
4998
+ - Payment bugs: --query "payment" --project 22222
4999
+ - Recent failures: --query "fail" (no project filter)
5000
+
5001
+ ## Issue Patterns
5002
+ - Timeout errors: Usually infrastructure-related
5003
+ - Validation failures: Often missing edge case handling
5004
+ - Browser-specific: Test across Chrome, Firefox, Safari
5005
+ \`\`\`
5006
+
5007
+ **Task Creation Standards:**
5008
+
5009
+ - Always search before creating to prevent duplicates
5010
+ - Task names: \`Bug: [Component] Short description\` or \`[Type]: Short description\`
5011
+ - Description includes: reproduction steps, expected behavior, actual behavior, environment details, test evidence
5012
+ - Set assignee when the responsible team member is known
5013
+ - Set due date for urgent/critical bugs
5014
+
5015
+ **Quality Assurance:**
5016
+
5017
+ - Verify project GIDs are current
5018
+ - Update task status after verification
5019
+ - Maintain accurate recent task list in memory
5020
+ - Prune old patterns that no longer apply
5021
+
5022
+ 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.`;
5023
+
5024
+ // src/subagents/templates/issue-tracker/notion.ts
5025
+ init_esm_shims();
5026
+ var FRONTMATTER14 = {
4890
5027
  name: "issue-tracker",
4891
5028
  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.
4892
5029
  user: "The submit button on the checkout page doesn't work on mobile Safari"
@@ -4898,7 +5035,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to 'QA
4898
5035
  model: "haiku",
4899
5036
  color: "red"
4900
5037
  };
4901
- 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.
5038
+ 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.
4902
5039
 
4903
5040
  **Core Responsibilities:**
4904
5041
 
@@ -5046,7 +5183,7 @@ You are meticulous about maintaining your memory file as a critical resource tha
5046
5183
 
5047
5184
  // src/subagents/templates/issue-tracker/slack.ts
5048
5185
  init_esm_shims();
5049
- var FRONTMATTER14 = {
5186
+ var FRONTMATTER15 = {
5050
5187
  name: "issue-tracker",
5051
5188
  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.
5052
5189
  user: "3 critical tests failed in the payment flow - looks like the Stripe integration is broken"
@@ -5058,7 +5195,7 @@ assistant: "Let me use the issue-tracker agent to update the story thread with Q
5058
5195
  model: "sonnet",
5059
5196
  color: "red"
5060
5197
  };
5061
- 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.
5198
+ 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.
5062
5199
 
5063
5200
  **Core Responsibilities:**
5064
5201
 
@@ -5281,7 +5418,7 @@ You are focused on creating clear, organized issue threads that leverage Slack's
5281
5418
 
5282
5419
  // src/subagents/templates/changelog-historian/github.ts
5283
5420
  init_esm_shims();
5284
- var FRONTMATTER15 = {
5421
+ var FRONTMATTER16 = {
5285
5422
  name: "changelog-historian",
5286
5423
  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.
5287
5424
  user: "The checkout flow test is failing in staging. What changed recently?"
@@ -5293,7 +5430,7 @@ assistant: "I'll use the changelog-historian agent to compare the two releases a
5293
5430
  model: "haiku",
5294
5431
  color: "gray"
5295
5432
  };
5296
- 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.
5433
+ 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.
5297
5434
 
5298
5435
  ## Core Responsibilities
5299
5436
 
@@ -5465,19 +5602,23 @@ var TEMPLATES = {
5465
5602
  frontmatter: FRONTMATTER12,
5466
5603
  content: CONTENT12
5467
5604
  },
5468
- notion: {
5605
+ asana: {
5469
5606
  frontmatter: FRONTMATTER13,
5470
5607
  content: CONTENT13
5471
5608
  },
5472
- slack: {
5609
+ notion: {
5473
5610
  frontmatter: FRONTMATTER14,
5474
5611
  content: CONTENT14
5612
+ },
5613
+ slack: {
5614
+ frontmatter: FRONTMATTER15,
5615
+ content: CONTENT15
5475
5616
  }
5476
5617
  },
5477
5618
  "changelog-historian": {
5478
5619
  github: {
5479
- frontmatter: FRONTMATTER15,
5480
- content: CONTENT15
5620
+ frontmatter: FRONTMATTER16,
5621
+ content: CONTENT16
5481
5622
  }
5482
5623
  }
5483
5624
  };
@@ -7604,6 +7745,9 @@ var MCP_SERVERS = {
7604
7745
  }
7605
7746
  }
7606
7747
  },
7748
+ // asana: CLI-only integration — no MCP server needed.
7749
+ // Agent uses `asana-cli task search|create|update|comment` via Bash.
7750
+ // Package is installed globally in the container for CLI access.
7607
7751
  // github-modelcontextprotocol: {
7608
7752
  // provider: 'github',
7609
7753
  // name: 'GitHub',