@bugzy-ai/bugzy 1.19.0 → 1.19.1

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 +152 -13
  4. package/dist/cli/index.cjs.map +1 -1
  5. package/dist/cli/index.js +151 -12
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/index.cjs +148 -10
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.js +148 -10
  10. package/dist/index.js.map +1 -1
  11. package/dist/subagents/index.cjs +145 -10
  12. package/dist/subagents/index.cjs.map +1 -1
  13. package/dist/subagents/index.js +145 -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,133 @@ 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
+ **Core Responsibilities:**
4926
+
4927
+ 1. **Task Creation & Management**: Generate detailed tasks with reproduction steps, environment details, and test evidence. Include severity assessment and proper project/section assignment.
4928
+
4929
+ 2. **Duplicate Detection**: Before creating new tasks, always search for existing similar tasks to avoid duplicates and link related work.
4930
+
4931
+ 3. **Lifecycle Management**: Track task status, mark tasks complete when verified, add comments with test findings and status updates.
4932
+
4933
+ 4. ${MEMORY_READ_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
4934
+
4935
+ **Memory Sections for Issue Tracker (Asana)**:
4936
+ - Asana workspace GID, project GIDs, and section mappings
4937
+ - Recently reported tasks with their GIDs and status
4938
+ - Search queries that work well for finding duplicates
4939
+ - Task naming conventions and description templates
4940
+ - Project-specific workflows and assignee mappings
4941
+
4942
+ **Operational Workflow:**
4943
+
4944
+ 1. **Initial Check**: Always begin by reading \`.bugzy/runtime/memory/issue-tracker.md\` to load your Asana configuration and recent task history
4945
+
4946
+ 2. **Duplicate Detection**:
4947
+ - Check memory for recently reported similar tasks
4948
+ - Use \`asana-cli task search --query "error keywords"\` to search
4949
+ - Look for matching names, descriptions, or error messages
4950
+ - If duplicate found, add a comment to the existing task instead
4951
+
4952
+ 3. **Task Creation**:
4953
+ - Use the project GID from memory
4954
+ - Include comprehensive details: reproduction steps, expected vs actual behavior, environment
4955
+ - Set appropriate assignee and due date when known
4956
+ - Add test evidence and screenshots references in the description
4957
+
4958
+ 4. ${MEMORY_UPDATE_INSTRUCTIONS.replace(/{ROLE}/g, "issue-tracker")}
4959
+
4960
+ Specifically for issue-tracker (Asana), consider updating:
4961
+ - **Created Tasks**: Add newly created tasks with their GIDs
4962
+ - **Project Mappings**: Track which projects map to which areas
4963
+ - **Search Patterns**: Save effective search queries
4964
+ - **Assignee Mappings**: Track who handles what areas
4965
+ - Update pattern library with new issue types
4966
+
4967
+ **Memory File Structure** (\`.bugzy/runtime/memory/issue-tracker.md\`):
4968
+ \`\`\`markdown
4969
+ # Issue Tracker Memory
4970
+
4971
+ ## Last Updated: [timestamp]
4972
+
4973
+ ## Asana Configuration
4974
+ - Workspace GID: 12345
4975
+ - Default Project GID: 67890
4976
+ - Project: My Project
4977
+
4978
+ ## Project Mappings
4979
+ - Auth issues \u2192 Project "Auth" (GID: 11111)
4980
+ - Payment issues \u2192 Project "Payments" (GID: 22222)
4981
+ - UI issues \u2192 Project "Frontend" (GID: 33333)
4982
+
4983
+ ## Assignee Mappings
4984
+ - Auth bugs \u2192 user GID 44444
4985
+ - Payment bugs \u2192 user GID 55555
4986
+
4987
+ ## Recent Tasks (Last 30 days)
4988
+ - [Date] GID 98765: Login timeout on Chrome - Status: Open
4989
+ - [Date] GID 98766: Payment validation error - Status: Completed
4990
+
4991
+ ## Effective Search Queries
4992
+ - Login issues: --query "login" --project 11111
4993
+ - Payment bugs: --query "payment" --project 22222
4994
+ - Recent failures: --query "fail" (no project filter)
4995
+
4996
+ ## Issue Patterns
4997
+ - Timeout errors: Usually infrastructure-related
4998
+ - Validation failures: Often missing edge case handling
4999
+ - Browser-specific: Test across Chrome, Firefox, Safari
5000
+ \`\`\`
5001
+
5002
+ **Task Creation Standards:**
5003
+
5004
+ - Always search before creating to prevent duplicates
5005
+ - Task names: \`Bug: [Component] Short description\` or \`[Type]: Short description\`
5006
+ - Description includes: reproduction steps, expected behavior, actual behavior, environment details, test evidence
5007
+ - Set assignee when the responsible team member is known
5008
+ - Set due date for urgent/critical bugs
5009
+
5010
+ **Quality Assurance:**
5011
+
5012
+ - Verify project GIDs are current
5013
+ - Update task status after verification
5014
+ - Maintain accurate recent task list in memory
5015
+ - Prune old patterns that no longer apply
5016
+
5017
+ 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.`;
5018
+
5019
+ // src/subagents/templates/issue-tracker/notion.ts
5020
+ init_esm_shims();
5021
+ var FRONTMATTER14 = {
4890
5022
  name: "issue-tracker",
4891
5023
  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
5024
  user: "The submit button on the checkout page doesn't work on mobile Safari"
@@ -4898,7 +5030,7 @@ assistant: "Let me use the issue-tracker agent to update the story status to 'QA
4898
5030
  model: "haiku",
4899
5031
  color: "red"
4900
5032
  };
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.
5033
+ 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
5034
 
4903
5035
  **Core Responsibilities:**
4904
5036
 
@@ -5046,7 +5178,7 @@ You are meticulous about maintaining your memory file as a critical resource tha
5046
5178
 
5047
5179
  // src/subagents/templates/issue-tracker/slack.ts
5048
5180
  init_esm_shims();
5049
- var FRONTMATTER14 = {
5181
+ var FRONTMATTER15 = {
5050
5182
  name: "issue-tracker",
5051
5183
  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
5184
  user: "3 critical tests failed in the payment flow - looks like the Stripe integration is broken"
@@ -5058,7 +5190,7 @@ assistant: "Let me use the issue-tracker agent to update the story thread with Q
5058
5190
  model: "sonnet",
5059
5191
  color: "red"
5060
5192
  };
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.
5193
+ 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
5194
 
5063
5195
  **Core Responsibilities:**
5064
5196
 
@@ -5281,7 +5413,7 @@ You are focused on creating clear, organized issue threads that leverage Slack's
5281
5413
 
5282
5414
  // src/subagents/templates/changelog-historian/github.ts
5283
5415
  init_esm_shims();
5284
- var FRONTMATTER15 = {
5416
+ var FRONTMATTER16 = {
5285
5417
  name: "changelog-historian",
5286
5418
  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
5419
  user: "The checkout flow test is failing in staging. What changed recently?"
@@ -5293,7 +5425,7 @@ assistant: "I'll use the changelog-historian agent to compare the two releases a
5293
5425
  model: "haiku",
5294
5426
  color: "gray"
5295
5427
  };
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.
5428
+ 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
5429
 
5298
5430
  ## Core Responsibilities
5299
5431
 
@@ -5465,19 +5597,23 @@ var TEMPLATES = {
5465
5597
  frontmatter: FRONTMATTER12,
5466
5598
  content: CONTENT12
5467
5599
  },
5468
- notion: {
5600
+ asana: {
5469
5601
  frontmatter: FRONTMATTER13,
5470
5602
  content: CONTENT13
5471
5603
  },
5472
- slack: {
5604
+ notion: {
5473
5605
  frontmatter: FRONTMATTER14,
5474
5606
  content: CONTENT14
5607
+ },
5608
+ slack: {
5609
+ frontmatter: FRONTMATTER15,
5610
+ content: CONTENT15
5475
5611
  }
5476
5612
  },
5477
5613
  "changelog-historian": {
5478
5614
  github: {
5479
- frontmatter: FRONTMATTER15,
5480
- content: CONTENT15
5615
+ frontmatter: FRONTMATTER16,
5616
+ content: CONTENT16
5481
5617
  }
5482
5618
  }
5483
5619
  };
@@ -7604,6 +7740,9 @@ var MCP_SERVERS = {
7604
7740
  }
7605
7741
  }
7606
7742
  },
7743
+ // asana: CLI-only integration — no MCP server needed.
7744
+ // Agent uses `asana-cli task search|create|update|comment` via Bash.
7745
+ // Package is installed globally in the container for CLI access.
7607
7746
  // github-modelcontextprotocol: {
7608
7747
  // provider: 'github',
7609
7748
  // name: 'GitHub',