@bugzy-ai/bugzy 1.11.4 → 1.12.1

package/dist/index.js

@@ -308,22 +308,9 @@ Read the test plan from \`test-plan.md\` to understand:
 - Identify existing Page Objects in \`./tests/pages/\`
 - Avoid creating overlapping test cases or duplicate automation`
     },
-    // Step 6: Documentation Researcher (conditional inline)
+    // Step 6: Documentation Researcher (conditional library step)
     {
-      inline: true,
-      title: "Gather Product Documentation",
-      content: `{{INVOKE_DOCUMENTATION_RESEARCHER}} to gather comprehensive product documentation:
-
-\`\`\`
-Explore all available product documentation, specifically focusing on:
-- UI elements and workflows
-- User interactions and navigation paths
-- Form fields and validation rules
-- Error messages and edge cases
-- Authentication and authorization flows
-- Business rules and constraints
-- API endpoints for test data setup
-\`\`\``,
+      stepId: "gather-documentation",
       conditionalOnSubagent: "documentation-researcher"
     },
     // Step 7: Exploration Protocol (from library)
@@ -601,33 +588,9 @@ var generateTestPlanTask = {
       title: "Initialize Environment Variables Tracking",
       content: `Create a list to track all TEST_ prefixed environment variables discovered throughout the process.`
     },
-    // Step 8: Documentation Researcher (conditional inline)
+    // Step 8: Documentation Researcher (conditional library step)
     {
-      inline: true,
-      title: "Gather Comprehensive Project Documentation",
-      content: `{{INVOKE_DOCUMENTATION_RESEARCHER}} to explore and gather all available project information and other documentation sources. This ensures the test plan is based on complete and current information.
-
-\`\`\`
-Explore all available project documentation related to: $ARGUMENTS
-
-Specifically gather:
-- Product specifications and requirements
-- User stories and acceptance criteria
-- Technical architecture documentation
-- API documentation and endpoints
-- User roles and permissions
-- Business rules and validations
-- UI/UX specifications
-- Known limitations or constraints
-- Existing test documentation
-- Bug reports or known issues
-\`\`\`
-
-The agent will:
-1. Check its memory for previously discovered documentation
-2. Explore workspace for relevant pages and databases
-3. Build a comprehensive understanding of the product
-4. Return synthesized information about all discovered documentation`,
+      stepId: "gather-documentation",
       conditionalOnSubagent: "documentation-researcher"
     },
     // Step 9: Exploration Protocol (from library)
@@ -1091,6 +1054,7 @@ Based on the event source, load the handler from \`.bugzy/runtime/handlers/\`:
 
 **Step 1: Detect Event Source from Payload:**
 - \`com.jira-server.*\` event type prefix -> \`.bugzy/runtime/handlers/jira.md\`
+- \`com.recall.*\` event type prefix -> \`.bugzy/runtime/handlers/recall.md\`
 - \`github.*\` or GitHub webhook structure -> \`.bugzy/runtime/handlers/github.md\`
 - \`linear.*\` or Linear webhook -> \`.bugzy/runtime/handlers/linear.md\`
 - Other sources -> Check for matching handler file by source name
@@ -1158,19 +1122,9 @@ Based on event type and content, generate 3-5 specific search queries:
 - Find relevant documentation
 - Check for known issues`
     },
-    // Step 9: Documentation Research (conditional inline)
+    // Step 9: Documentation Research (conditional library step)
     {
-      inline: true,
-      title: "Use Documentation Researcher",
-      content: `#### 3.3 Use Documentation Researcher if Needed
-
-{{INVOKE_DOCUMENTATION_RESEARCHER}} to find information about unknown features or components:
-
-For events mentioning unknown features or components, ask the agent to explore project documentation and return:
-- Feature specifications
-- Related test cases
-- Known issues or limitations
-- Component dependencies`,
+      stepId: "gather-documentation",
       conditionalOnSubagent: "documentation-researcher"
     },
     // Step 10: Task Planning (inline)
@@ -1348,7 +1302,7 @@ Create files if they don't exist:
   ],
   requiredSubagents: ["team-communicator"],
   optionalSubagents: ["documentation-researcher", "issue-tracker"],
-  dependentTasks: ["verify-changes"]
+  dependentTasks: ["verify-changes", "generate-test-cases", "run-tests"]
 };
 
 // src/tasks/library/run-tests.ts
@@ -1926,38 +1880,9 @@ Include in the message:
 - Any blocking issues or critical findings`,
       conditionalOnSubagent: "team-communicator"
     },
-    // Step 15: Documentation Research (conditional inline)
+    // Step 15: Documentation Research (conditional library step)
     {
-      inline: true,
-      title: "Understanding the Change (Documentation Research)",
-      content: `{{INVOKE_DOCUMENTATION_RESEARCHER}} to gather comprehensive context about the changed features:
-
-Explore project documentation related to the changes.
-
-Specifically gather:
-- Product specifications for affected features
-- User stories and acceptance criteria
-- Technical architecture documentation
-- API endpoints and contracts
-- User roles and permissions relevant to the change
-- Business rules and validations
-- UI/UX specifications
-- Known limitations or constraints
-- Related bug reports or known issues
-- Existing test documentation for this area
-
-The agent will:
-1. Check its memory for previously discovered documentation
-2. Explore workspace for relevant pages and databases
-3. Build comprehensive understanding of the affected features
-4. Return synthesized information to inform testing strategy
-
-Use this information to:
-- Better understand the change context
-- Identify comprehensive test scenarios
-- Recognize integration points and dependencies
-- Spot potential edge cases or risk areas
-- Enhance manual verification checklist generation`,
+      stepId: "gather-documentation",
       conditionalOnSubagent: "documentation-researcher"
     },
     // Step 16: Report Results (inline)
@@ -2092,6 +2017,10 @@ This command orchestrates the complete test coverage workflow in a single execut
     // Phase 1: Setup
     "load-project-context",
     "read-knowledge-base",
+    {
+      stepId: "gather-documentation",
+      conditionalOnSubagent: "documentation-researcher"
+    },
     // Phase 2: Exploration Protocol
     "exploration-protocol",
     // Execute exploration via test-runner
@@ -6182,6 +6111,39 @@ The \`.env\` file access is blocked by settings.json.`,
   tags: ["security", "required"]
 };
 
+// src/tasks/steps/setup/gather-documentation.ts
+var gatherDocumentationStep = {
+  id: "gather-documentation",
+  title: "Gather Project Documentation",
+  category: "setup",
+  content: `## Gather Project Documentation
+
+{{INVOKE_DOCUMENTATION_RESEARCHER}} to explore and gather all available project information.
+
+Specifically gather:
+- Product specifications and requirements
+- User stories and acceptance criteria
+- Technical architecture documentation
+- API documentation and endpoints
+- User roles and permissions
+- Business rules and validations
+- UI/UX specifications
+- Known limitations or constraints
+- Existing test documentation
+- Bug reports or known issues
+
+The agent will:
+1. Check its memory for previously discovered documentation
+2. Explore workspace for relevant pages and databases
+3. Build comprehensive understanding of the product
+4. Return synthesized information about all discovered documentation
+
+Use this information to inform testing strategy and identify comprehensive scenarios.`,
+  requiresSubagent: "documentation-researcher",
+  invokesSubagents: ["documentation-researcher"],
+  tags: ["setup", "context", "documentation"]
+};
+
 // src/tasks/steps/exploration/exploration-protocol.ts
 var explorationProtocolStep = {
   id: "exploration-protocol",
@@ -6623,24 +6585,22 @@ Run automated Playwright tests and capture results.
 
 **Build Playwright Command** based on selector:
 
+The playwright.config.ts automatically loads environment variables from .env.testdata and .env files.
+Use npm scripts to run tests - no manual env export needed.
+
 **For file pattern or specific file**:
 \`\`\`bash
-npx playwright test [selector]
+npm test -- [selector]
 \`\`\`
 
 **For tag**:
 \`\`\`bash
-npx playwright test --grep "[tag]"
+npm test -- --grep "[tag]"
 \`\`\`
 
 **For all tests**:
 \`\`\`bash
-npx playwright test
-\`\`\`
-
-**Execute Tests via Bash:**
-\`\`\`bash
-npx playwright test [selector]
+npm test
 \`\`\`
 
 Wait for execution to complete. This may take several minutes depending on test count.
@@ -7421,6 +7381,7 @@ var STEP_LIBRARY = {
   "read-knowledge-base": readKnowledgeBaseStep,
   "read-test-strategy": readTestStrategyStep,
   "load-project-context": loadProjectContextStep,
+  "gather-documentation": gatherDocumentationStep,
   // Exploration
   "exploration-protocol": explorationProtocolStep,
   // Clarification