@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
@@ -1,195 +1,195 @@
1
- # Event Examples Template
2
-
3
- This template provides examples of different event formats that can be processed by the `/process-event` command. Use these as references when triggering events.
4
-
5
- ## Natural Language Events
6
-
7
- ### Test Failures
8
- ```bash
9
- /process-event "Login test failed with timeout error on Chrome"
10
- /process-event "The checkout process is broken - users can't complete payment"
11
- /process-event "TC-001 failed: Element not found after waiting 10 seconds"
12
- ```
13
-
14
- ### Discoveries
15
- ```bash
16
- /process-event "Found new admin panel at /admin that's not documented"
17
- /process-event "Discovered that users can bypass authentication by going directly to /dashboard"
18
- /process-event "New feature: dark mode toggle in settings menu"
19
- ```
20
-
21
- ### User Feedback
22
- ```bash
23
- /process-event "Customer complaint: checkout process too complicated, abandoned cart"
24
- /process-event "Support ticket: users reporting slow page loads on mobile"
25
- /process-event "User suggestion: add keyboard shortcuts for common actions"
26
- ```
27
-
28
- ## Structured Events (Key-Value Pairs)
29
-
30
- ### Test Event
31
- ```bash
32
- /process-event --type test.failed --test-id TC-001 --error "Button not clickable" --browser Chrome
33
- /process-event --type test.passed --test-id TC-045 --duration 45s --previously-flaky true
34
- ```
35
-
36
- ### Bug Report
37
- ```bash
38
- /process-event --type bug.found --component auth --severity high --title "Login bypass vulnerability"
39
- /process-event --type bug.fixed --bug-id BUG-123 --resolution "Updated validation logic"
40
- ```
41
-
42
- ### Feature Event
43
- ```bash
44
- /process-event --type feature.added --name "Quick Actions" --location "dashboard" --documented false
45
- /process-event --type requirement.changed --feature "Password Policy" --change "Minimum 12 characters"
46
- ```
47
-
48
- ## JSON Format Events
49
-
50
- ### Complex Test Failure
51
- ```bash
52
- /process-event '{
53
- "type": "test.failed",
54
- "test_id": "TC-001",
55
- "title": "Login with valid credentials",
56
- "error": {
57
- "message": "Element not found",
58
- "selector": ".login-button",
59
- "timeout": 10000
60
- },
61
- "environment": {
62
- "browser": "Chrome 120",
63
- "os": "macOS",
64
- "viewport": "1920x1080"
65
- },
66
- "timestamp": "2025-01-25T10:30:00Z"
67
- }'
68
- ```
69
-
70
- ### User Feedback with Context
71
- ```bash
72
- /process-event '{
73
- "type": "user.feedback",
74
- "source": "support",
75
- "ticket_id": "SUP-456",
76
- "user_type": "premium",
77
- "issue": {
78
- "area": "checkout",
79
- "description": "Payment method not saving",
80
- "impact": "Cannot complete purchase",
81
- "frequency": "Always"
82
- }
83
- }'
84
- ```
85
-
86
- ### Performance Issue
87
- ```bash
88
- /process-event '{
89
- "type": "performance.issue",
90
- "page": "/dashboard",
91
- "metrics": {
92
- "load_time": 8500,
93
- "time_to_interactive": 12000,
94
- "largest_contentful_paint": 6500
95
- },
96
- "threshold_exceeded": true
97
- }'
98
- ```
99
-
100
- ## YAML-like Format
101
-
102
- ### Simple Events
103
- ```bash
104
- /process-event "type: test.failed, test: TC-001, browser: Firefox"
105
- /process-event "type: bug.found, severity: medium, component: search"
106
- /process-event "type: discovery, feature: API endpoint, path: /api/v2/users"
107
- ```
108
-
109
- ## Batch Events
110
-
111
- ### Multiple Related Issues
112
- ```bash
113
- /process-event "Multiple login failures today: TC-001, TC-002, TC-003 all failing with similar timeout errors. Seems to be a systematic issue with the authentication service."
114
- ```
115
-
116
- ### Exploratory Testing Results
117
- ```bash
118
- /process-event "Exploratory testing session results: Found 3 UI inconsistencies, 1 broken link, new feature in settings, and performance degradation on search page"
119
- ```
120
-
121
- ## Event Chains
122
-
123
- Sometimes events are related and should reference each other:
124
-
125
- ### Initial Event
126
- ```bash
127
- /process-event --type deployment --version 2.1.0 --environment staging
128
- ```
129
-
130
- ### Follow-up Event
131
- ```bash
132
- /process-event "After deployment 2.1.0: 5 tests failing that were passing before"
133
- ```
134
-
135
- ## Special Cases
136
-
137
- ### Flaky Test Pattern
138
- ```bash
139
- /process-event "TC-089 failed 3 times out of 10 runs - appears to be flaky"
140
- ```
141
-
142
- ### Environment-Specific
143
- ```bash
144
- /process-event "All Safari tests failing but Chrome and Firefox pass"
145
- ```
146
-
147
- ### Data-Dependent
148
- ```bash
149
- /process-event "Tests pass with test data but fail with production data"
150
- ```
151
-
152
- ## Tips for Event Creation
153
-
154
- 1. **Be Specific**: Include test IDs, error messages, and environment details
155
- 2. **Add Context**: Mention if issue is new, recurring, or related to recent changes
156
- 3. **Include Impact**: Describe how the issue affects users or testing
157
- 4. **Provide Evidence**: Include screenshots paths, logs, or session IDs if available
158
- 5. **Link Related Items**: Reference bug IDs, test cases, or previous events
159
-
160
- ## Common Patterns to Trigger
161
-
162
- ### Trigger Learning Extraction
163
- ```bash
164
- /process-event "Discovered that all form validations fail when browser language is not English"
165
- ```
166
-
167
- ### Trigger Test Plan Update
168
- ```bash
169
- /process-event "New payment provider integrated - Stripe checkout now available"
170
- ```
171
-
172
- ### Trigger Test Case Creation
173
- ```bash
174
- /process-event "Found undocumented admin features that need test coverage"
175
- ```
176
-
177
- ### Trigger Bug Report
178
- ```bash
179
- /process-event "Critical: Users lose data when session expires during form submission"
180
- ```
181
-
182
- ## Event Metadata
183
-
184
- Events can include optional metadata:
185
- - `priority`: high, medium, low
186
- - `source`: automation, manual, support, monitoring
187
- - `session_id`: For tracking related events
188
- - `user`: Who reported or discovered
189
- - `environment`: staging, production, development
190
- - `tags`: Categories for filtering
191
-
192
- Example with metadata:
193
- ```bash
194
- /process-event --type issue --priority high --source monitoring --environment production --message "Memory leak detected in checkout service"
1
+ # Event Examples Template
2
+
3
+ This template provides examples of different event formats that can be processed by the `/process-event` command. Use these as references when triggering events.
4
+
5
+ ## Natural Language Events
6
+
7
+ ### Test Failures
8
+ ```bash
9
+ /process-event "Login test failed with timeout error on Chrome"
10
+ /process-event "The checkout process is broken - users can't complete payment"
11
+ /process-event "TC-001 failed: Element not found after waiting 10 seconds"
12
+ ```
13
+
14
+ ### Discoveries
15
+ ```bash
16
+ /process-event "Found new admin panel at /admin that's not documented"
17
+ /process-event "Discovered that users can bypass authentication by going directly to /dashboard"
18
+ /process-event "New feature: dark mode toggle in settings menu"
19
+ ```
20
+
21
+ ### User Feedback
22
+ ```bash
23
+ /process-event "Customer complaint: checkout process too complicated, abandoned cart"
24
+ /process-event "Support ticket: users reporting slow page loads on mobile"
25
+ /process-event "User suggestion: add keyboard shortcuts for common actions"
26
+ ```
27
+
28
+ ## Structured Events (Key-Value Pairs)
29
+
30
+ ### Test Event
31
+ ```bash
32
+ /process-event --type test.failed --test-id TC-001 --error "Button not clickable" --browser Chrome
33
+ /process-event --type test.passed --test-id TC-045 --duration 45s --previously-flaky true
34
+ ```
35
+
36
+ ### Bug Report
37
+ ```bash
38
+ /process-event --type bug.found --component auth --severity high --title "Login bypass vulnerability"
39
+ /process-event --type bug.fixed --bug-id BUG-123 --resolution "Updated validation logic"
40
+ ```
41
+
42
+ ### Feature Event
43
+ ```bash
44
+ /process-event --type feature.added --name "Quick Actions" --location "dashboard" --documented false
45
+ /process-event --type requirement.changed --feature "Password Policy" --change "Minimum 12 characters"
46
+ ```
47
+
48
+ ## JSON Format Events
49
+
50
+ ### Complex Test Failure
51
+ ```bash
52
+ /process-event '{
53
+ "type": "test.failed",
54
+ "test_id": "TC-001",
55
+ "title": "Login with valid credentials",
56
+ "error": {
57
+ "message": "Element not found",
58
+ "selector": ".login-button",
59
+ "timeout": 10000
60
+ },
61
+ "environment": {
62
+ "browser": "Chrome 120",
63
+ "os": "macOS",
64
+ "viewport": "1920x1080"
65
+ },
66
+ "timestamp": "2025-01-25T10:30:00Z"
67
+ }'
68
+ ```
69
+
70
+ ### User Feedback with Context
71
+ ```bash
72
+ /process-event '{
73
+ "type": "user.feedback",
74
+ "source": "support",
75
+ "ticket_id": "SUP-456",
76
+ "user_type": "premium",
77
+ "issue": {
78
+ "area": "checkout",
79
+ "description": "Payment method not saving",
80
+ "impact": "Cannot complete purchase",
81
+ "frequency": "Always"
82
+ }
83
+ }'
84
+ ```
85
+
86
+ ### Performance Issue
87
+ ```bash
88
+ /process-event '{
89
+ "type": "performance.issue",
90
+ "page": "/dashboard",
91
+ "metrics": {
92
+ "load_time": 8500,
93
+ "time_to_interactive": 12000,
94
+ "largest_contentful_paint": 6500
95
+ },
96
+ "threshold_exceeded": true
97
+ }'
98
+ ```
99
+
100
+ ## YAML-like Format
101
+
102
+ ### Simple Events
103
+ ```bash
104
+ /process-event "type: test.failed, test: TC-001, browser: Firefox"
105
+ /process-event "type: bug.found, severity: medium, component: search"
106
+ /process-event "type: discovery, feature: API endpoint, path: /api/v2/users"
107
+ ```
108
+
109
+ ## Batch Events
110
+
111
+ ### Multiple Related Issues
112
+ ```bash
113
+ /process-event "Multiple login failures today: TC-001, TC-002, TC-003 all failing with similar timeout errors. Seems to be a systematic issue with the authentication service."
114
+ ```
115
+
116
+ ### Exploratory Testing Results
117
+ ```bash
118
+ /process-event "Exploratory testing session results: Found 3 UI inconsistencies, 1 broken link, new feature in settings, and performance degradation on search page"
119
+ ```
120
+
121
+ ## Event Chains
122
+
123
+ Sometimes events are related and should reference each other:
124
+
125
+ ### Initial Event
126
+ ```bash
127
+ /process-event --type deployment --version 2.1.0 --environment staging
128
+ ```
129
+
130
+ ### Follow-up Event
131
+ ```bash
132
+ /process-event "After deployment 2.1.0: 5 tests failing that were passing before"
133
+ ```
134
+
135
+ ## Special Cases
136
+
137
+ ### Flaky Test Pattern
138
+ ```bash
139
+ /process-event "TC-089 failed 3 times out of 10 runs - appears to be flaky"
140
+ ```
141
+
142
+ ### Environment-Specific
143
+ ```bash
144
+ /process-event "All Safari tests failing but Chrome and Firefox pass"
145
+ ```
146
+
147
+ ### Data-Dependent
148
+ ```bash
149
+ /process-event "Tests pass with test data but fail with production data"
150
+ ```
151
+
152
+ ## Tips for Event Creation
153
+
154
+ 1. **Be Specific**: Include test IDs, error messages, and environment details
155
+ 2. **Add Context**: Mention if issue is new, recurring, or related to recent changes
156
+ 3. **Include Impact**: Describe how the issue affects users or testing
157
+ 4. **Provide Evidence**: Include screenshots paths, logs, or session IDs if available
158
+ 5. **Link Related Items**: Reference bug IDs, test cases, or previous events
159
+
160
+ ## Common Patterns to Trigger
161
+
162
+ ### Trigger Learning Extraction
163
+ ```bash
164
+ /process-event "Discovered that all form validations fail when browser language is not English"
165
+ ```
166
+
167
+ ### Trigger Test Plan Update
168
+ ```bash
169
+ /process-event "New payment provider integrated - Stripe checkout now available"
170
+ ```
171
+
172
+ ### Trigger Test Case Creation
173
+ ```bash
174
+ /process-event "Found undocumented admin features that need test coverage"
175
+ ```
176
+
177
+ ### Trigger Bug Report
178
+ ```bash
179
+ /process-event "Critical: Users lose data when session expires during form submission"
180
+ ```
181
+
182
+ ## Event Metadata
183
+
184
+ Events can include optional metadata:
185
+ - `priority`: high, medium, low
186
+ - `source`: automation, manual, support, monitoring
187
+ - `session_id`: For tracking related events
188
+ - `user`: Who reported or discovered
189
+ - `environment`: staging, production, development
190
+ - `tags`: Categories for filtering
191
+
192
+ Example with metadata:
193
+ ```bash
194
+ /process-event --type issue --priority high --source monitoring --environment production --message "Memory leak detected in checkout service"
195
195
  ```
@@ -1,50 +1,50 @@
1
- ---
2
- version: 1.0.0
3
- created_at: [DATE]
4
- updated_at: [DATE]
5
- status: draft
6
- ---
7
-
8
- # Test Plan: [PROJECT_NAME]
9
-
10
- ## Overview
11
-
12
- [2-3 sentences describing what the application does and the testing focus]
13
-
14
- ## Features to Test
15
-
16
- ### [Feature Area 1]
17
- - [ ] Feature 1.1 - Brief description
18
- - [ ] Feature 1.2 - Brief description
19
-
20
- ### [Feature Area 2]
21
- - [ ] Feature 2.1 - Brief description
22
- - [ ] Feature 2.2 - Brief description
23
-
24
- ### [Feature Area 3]
25
- - [ ] Feature 3.1 - Brief description
26
-
27
- ## Out of Scope
28
-
29
- - Item 1 - Reason (e.g., requires native mobile app)
30
- - Item 2 - Reason (e.g., backend-only, no UI)
31
-
32
- ## Test Environment
33
-
34
- - **URL**: TEST_BASE_URL
35
- - **User Credentials**: TEST_USER_EMAIL / TEST_USER_PASSWORD
36
- - **Admin Credentials**: TEST_ADMIN_EMAIL / TEST_ADMIN_PASSWORD (if applicable)
37
-
38
- ## Automation Priority
39
-
40
- | Priority | Criteria |
41
- |----------|----------|
42
- | High | Critical user flows, smoke tests, frequent regression areas |
43
- | Medium | Important features, moderate user impact |
44
- | Low | Edge cases, rarely used features |
45
-
46
- ## Notes
47
-
48
- - See `./exploration-reports/` for detailed UI element discovery
49
- - See `.bugzy/runtime/knowledge-base.md` for technical patterns
50
- - See `.bugzy/runtime/project-context.md` for SDLC and team info
1
+ ---
2
+ version: 1.0.0
3
+ created_at: [DATE]
4
+ updated_at: [DATE]
5
+ status: draft
6
+ ---
7
+
8
+ # Test Plan: [PROJECT_NAME]
9
+
10
+ ## Overview
11
+
12
+ [2-3 sentences describing what the application does and the testing focus]
13
+
14
+ ## Features to Test
15
+
16
+ ### [Feature Area 1]
17
+ - [ ] Feature 1.1 - Brief description
18
+ - [ ] Feature 1.2 - Brief description
19
+
20
+ ### [Feature Area 2]
21
+ - [ ] Feature 2.1 - Brief description
22
+ - [ ] Feature 2.2 - Brief description
23
+
24
+ ### [Feature Area 3]
25
+ - [ ] Feature 3.1 - Brief description
26
+
27
+ ## Out of Scope
28
+
29
+ - Item 1 - Reason (e.g., requires native mobile app)
30
+ - Item 2 - Reason (e.g., backend-only, no UI)
31
+
32
+ ## Test Environment
33
+
34
+ - **URL**: TEST_BASE_URL
35
+ - **User Credentials**: TEST_USER_EMAIL / TEST_USER_PASSWORD
36
+ - **Admin Credentials**: TEST_ADMIN_EMAIL / TEST_ADMIN_PASSWORD (if applicable)
37
+
38
+ ## Automation Priority
39
+
40
+ | Priority | Criteria |
41
+ |----------|----------|
42
+ | High | Critical user flows, smoke tests, frequent regression areas |
43
+ | Medium | Important features, moderate user impact |
44
+ | Low | Edge cases, rarely used features |
45
+
46
+ ## Notes
47
+
48
+ - See `./exploration-reports/` for detailed UI element discovery
49
+ - See `.bugzy/runtime/knowledge-base.md` for technical patterns
50
+ - See `.bugzy/runtime/project-context.md` for SDLC and team info